插件能力速查（怎么调）

import cn.wujies.common.satoken.utils.LoginHelper;

Long userId = LoginHelper.getUserId();
if (userId == null) {
    // 刻意的：判空让调用方决定怎么呈现，比在服务端硬拦更灵活。
    // 真要强制登录，用 @SaCheckLogin 把意图写在注解上。
    return R.ok(Map.of("loggedIn", false));
}
info.put("username", LoginHelper.getUsername());
info.put("tenantId", LoginHelper.getTenantId());   // 字符串，例如 "000000"

import cn.wujies.common.core.service.ConfigService;
import cn.wujies.common.core.service.OssService;

@RestController
@RequestMapping("/hello/demo/host")
@RequiredArgsConstructor                       // 构造注入：缺哪个宿主能力会在启动期暴露
public class HelloDemoHostController {

    private final ConfigService configService;  // 读 sys_config
    private final OssService ossService;        // sys_oss 行 id → 可访问 URL

    @GetMapping("/config")
    public R<Map<String, String>> readOwnSiteConfig() {
        return R.ok(configService.selectConfigListByCategory("hello").stream()
            .collect(Collectors.toMap(
                r -> r.getConfigKey().substring("hello.".length()),
                ConfigDTO::getConfigValue)));
    }

    @GetMapping("/oss-url")
    public R<String> resolveOssUrl(@RequestParam(required = false) String ossId) {
        if (StringUtils.isBlank(ossId)) {
            return R.ok(null);                  // 配置没填时返回 null，别抛异常打断整个页面
        }
        return R.ok(ossService.selectUrlByIds(ossId));
    }
}

import cn.wujies.common.plugin.sdk.PlatformUserApi;

private final ObjectProvider<PlatformUserApi> platformUserApiProvider;

private PlatformUserApi userApi() {
    return platformUserApiProvider.getIfAvailable();   // 拿不到就是 null，别抛
}

void fillUserInfo(List<XxxVo> rows) {
    PlatformUserApi api = userApi();
    if (api == null) {
        log.warn("宿主未提供 PlatformUserApi，用户信息将不显示（其余功能不受影响）");
        return;
    }
    Map<Long, PlatformUserView> users = api.findByIds(rows.stream().map(XxxVo::getUserId).toList());
    // ...
}

类可见  ≠  bean 可见
  类：PluginClassLoader 按包名委托给拥有它的那个加载器 ⇒ 同一 FQCN 只有一个 Class 对象
bean：每个插件有自己的子上下文 ⇒ 你的上下文里没有兄弟的 bean

import cn.wujies.member.mapper.MemberMapper;   // 需要 pom 里 provided 依赖 wujies-member-plugin

private final MemberMapper memberMapper;       // ⚠️ 你从此隐式依赖 member 的数据表

Member row = memberMapper.selectById(id);

import cn.wujies.common.plugin.sdk.MemberServiceLocator;
import cn.wujies.member.service.IMemberService;

private final MemberServiceLocator memberServiceLocator;

@GetMapping("/service")
public R<Map<String, Object>> readViaLocator(@RequestParam(required = false) Long userId) {
    Map<String, Object> result = new LinkedHashMap<>();

    // ① 先问"装了没"。这一步是可选依赖的全部意义所在。
    boolean available = memberServiceLocator.available(IMemberService.class);
    result.put("memberAppAvailable", available);

    if (!available) {
        // ② 没装：返回 200 + 一句说明。
        //    定位器的 get(...) 会抛「请到应用市场安装 会员管理」——
        //    对"可选依赖"来说那是过度反应，所以这里不调 get。
        result.put("note", "会员应用未安装 —— 到应用市场装上它就自动生效，不需要改代码");
        return R.ok(result);
    }

    // ③ 装了：真去查。查不到就如实报错，不拿 200 + 空 data 糊过去。
    var detail = memberServiceLocator.get(IMemberService.class).queryDetailByUserId(userId);
    if (detail == null) {
        return R.fail("member 表里没有 user_id=" + userId + " 这一行");
    }
    result.put("row", detail);
    return R.ok(result);
}

import cn.wujies.common.core.plugin.PluginServiceProvider;

private final ObjectProvider<PluginServiceProvider> pluginServiceProvider;

@Override
public Set<Long> followedUserIds(Long userId, Collection<Long> candidateUserIds) {
    if (userId == null) {
        return Set.of();
    }
    PluginServiceProvider provider = pluginServiceProvider.getIfAvailable();
    if (provider != null && !provider.isPluginLoaded(APP_CODE)) {   // APP_CODE = "social"
        // 社交应用未安装/未启用 → 没有关注关系可言。
        // 不这么判的话，社交被"彻底删除"后这里会去查一张不存在的表，
        // 表现为调用方 500 —— 一个合法状态却炸出看不懂的错误。
        return Set.of();
    }
    // ... 真去查
}

import org.springframework.scheduling.annotation.Scheduled;

@Slf4j
@Component
@RequiredArgsConstructor
public class HelloDemoScheduledTask {

    private final HelloService helloService;

    @Scheduled(cron = "0 */5 * * * ?")        // 6 段式：秒 分 时 日 月 周
    public void demoCleanup() {
        int count = helloService.listAll().size();
        log.info("[hello] 定时任务执行：当前示例数据 {} 条", count);
    }
}

import com.aizuda.snailjob.client.job.core.annotation.JobExecutor;
import com.aizuda.snailjob.client.job.core.dto.JobArgs;
import com.aizuda.snailjob.common.log.SnailJobLog;
import com.aizuda.snailjob.model.dto.ExecuteResult;

@Slf4j
@Component
@RequiredArgsConstructor
@JobExecutor(name = "helloDemoTask")           // 名字要与调度中心建任务时填的执行器名完全一致
public class HelloDemoSnailJobTask {

    private final HelloService helloService;

    public ExecuteResult jobExecute(JobArgs jobArgs) {   // 名字/参数/返回类型都不能变
        int count = helloService.listAll().size();
        // 关键：REMOTE 才能在调度中心的任务日志里看到。普通 log.info 只进本机文件。
        SnailJobLog.REMOTE.info("[hello] SnailJob 任务执行：当前示例数据 {} 条", count);
        return ExecuteResult.success(count);
    }
}

import cn.dev33.satoken.annotation.SaIgnore;

@SaIgnore                                      // ① 类上标：告诉 Sa-Token 这条不要登录态
@Validated
@Slf4j
@RestController
@RequestMapping("/open/hello")                // ② 路径放 /open/<你的 app>/**
@RequiredArgsConstructor
public class HelloDemoOpenController extends BaseController {

    private final HelloService helloService;

    @GetMapping("/greet")                      // ③ 什么都不用注册（宿主自动收进路由清单）
    public R<String> openGreet(@RequestParam(required = false) String name) {
        return R.ok(helloService.greet(name));
    }
}

import cn.wujies.common.mybatis.core.page.PageQuery;
import cn.wujies.common.mybatis.core.page.TableDataInfo;
import cn.wujies.common.core.utils.MapstructUtils;

@Override
public TableDataInfo<MallBrandVo> queryPageList(MallBrandBo bo, PageQuery pageQuery) {
    LambdaQueryWrapper<MallBrand> lqw = buildQueryWrapper(bo);
    Page<MallBrandVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
    return TableDataInfo.build(result);
}

@Override
public Boolean insertByBo(MallBrandBo bo) {
    MallBrand add = MapstructUtils.convert(bo, MallBrand.class);   // BO → 实体
    validEntityBeforeSave(add);
    boolean flag = baseMapper.insert(add) > 0;
    if (flag) {
        bo.setId(add.getId());                                     // 回填主键给前端
    }
    return flag;
}

// src/api/mall/brand/index.ts
import request from '@/utils/request';
import { AxiosPromise } from 'axios';
import { BrandVO, BrandForm, BrandQuery } from '@/api/mall/brand/types';

export const listBrand = (query?: BrandQuery): AxiosPromise<BrandVO[]> =>
  request({ url: '/mall/brand/list', method: 'get', params: query });

export const addBrand = (data: BrandForm) =>
  request({ url: '/mall/brand', method: 'post', data });

export const delBrand = (id: string | number) =>
  request({ url: '/mall/brand/' + id, method: 'delete' });

import { getRemoteRuntime } from '../runtime';

const runtime = getRemoteRuntime();

// 宿主 axios 实例
const res: any = await runtime.request({ url: '/captchaConfig', method: 'get' });

// 版本信息，用于兼容降级判断
const vueVersion = runtime.vue.version;
const epVersion = runtime.elementPlus.version;
const platform = runtime.platformVersion;

// 证明拿到的是真实 router 实例
typeof runtime.routerInstance?.addRoute;

export function getRemoteRuntime(): any {
  if (!remoteRuntime) {
    throw new Error('[hello] 宿主运行时尚未注入，请确认应用通过 install(runtime) 装载');
  }
  return remoteRuntime;
}

<KPlainButton v-hasPermi="['mall:brand:add']" :icon="Plus" type="primary" @click="handleAdd">
  新增品牌
</KPlainButton>
<el-button v-hasPermi="['mall:brand:edit']" link type="primary" @click="handleUpdate(row)">编辑</el-button>

import { computed, getCurrentInstance, reactive, ref, toRefs } from 'vue';

const { proxy } = getCurrentInstance() as ComponentInternalInstance;
const { sys_normal_disable } = toRefs<any>(proxy?.useDict('sys_normal_disable'));

<template #status="{ row }">
  <KDictTag :options="sys_normal_disable" :value="row.status" />
</template>

<el-radio-group v-model="form.status">
  <el-radio v-for="dict in sys_normal_disable" :key="dict.value" :label="dict.value">{{ dict.label }}</el-radio>
</el-radio-group>

proxy?.$modal.msgSuccess('保存成功');
await proxy?.$modal.confirm(`是否确认删除品牌编号为“${currentIds}”的数据项？`);

const handleExport = () => {
  proxy?.download(
    'mall/brand/export',
    { ...queryParams.value },
    `brand_${new Date().getTime()}.xlsx`
  );
};

import { globalHeaders } from '@/utils/request';

const elLoading = runtime?.elementPlus?.ElLoadingDirective;
if (elLoading) {
  runtime.app.directive('loading', elLoading);   // 只有 app 实例能注册指令
}

import DemoAbout from './views/DemoAbout.vue';
import DemoHome from './views/DemoHome.vue';
import { setRemoteRuntime } from './runtime';

const manifest = {
  code: 'hello',
  name: '示例远程应用',
  version: '0.1.0',
  routes: [
    { path: '/remote-demo', name: 'RemoteDemoHome', view: 'demo/home',
      meta: { title: '示例远程应用', icon: 'ri:apps-2-line' } }
  ]
};

export default function install(runtime: any) {
  setRemoteRuntime(runtime);
  return {
    manifest,
    views: {
      // 约定：加载器返回 { default: Component }
      'demo/home': () => ({ default: DemoHome }),
      'demo/about': () => ({ default: DemoAbout })
    }
  };
}

前端  views:  { 'demo/home': () => ({ default: DemoHome }) }
                    └──────┬──────┘
后端  app.json:  "component": "remote:hello/demo/home"
                                     └─┬─┘ └───┬───┘
                                    appCode   视图键

npm run check:globals     # 产物里有没有"宿主自动导入宇宙"里未绑定的标识符
npm run check:remote      # 组件白名单 + process.env 残留 + manifest.styles 是否存在
npm run check:runtime     # 产物真正 import 的名字与运行时垫片导出对账