术语表
2026/10/26大约 3 分钟
术语表
按字母/拼音序，收录文档高频词。定义以代码为准。
| 术语 | 含义 |
|---|---|
| 基座（框架） | am-serve 后端 + am-web 管理前端构成的系统主体。遵循"框架做窄、插件做宽"，系统名 atrman，表前缀 am_，默认端口 8787。 |
| 插件（plugin） | 放在 am-serve/plugin/{name}/ 的可插拔业务扩展，标识须匹配 /^am_[a-z][a-z0-9_]*$/ 且后缀 ≥5 字符、非保留名、全局唯一。 |
| sid | 统一身份标识，Hashids 编码，带类型前缀：sys_（人）、grp_（群）、bot_（机器人）、app_（应用）。出口白名单字段：sid/type/name/avatar/status/account_type。 |
| Registry 家族 | 基座扩展内核：EventRegistry（事件）、ServiceRegistry（服务接管）、AdapterRegistry（存储适配器）、MiddlewareRegistry（中间件）、TaskRegistry（定时任务）、ChannelAuthRegistry（推送通道鉴权）。插件在 boot() 注册、卸载按 owner 反清（forgetByOwner）。 |
| PluginRegistrar | 把插件的菜单/路由/能力登记进基座的装配器。禁用保留前缀 app:entry:（入口菜单专用）。 |
| BasePlugin | 插件生命周期基类，Plugin.php 继承它。boot() 是唯一每 worker 进程重复执行的钩子，静态注册都写这里。 |
| 双入口 | entry /app/{name}（前台，可直访、无 Bridge、可无登录态）+ manage_entry /app/{name}/manage（管理，基座 qiankun 免登加载）。显式空串表示纯插件；open_mode 取 micro/iframe。 |
| Bridge | 基座注入给 qiankun 子应用的能力网关（amBridge/hostBridge）。方法含 auth.*、data.getDict/getConfig/getRemoteOptions、picker.*、form.*、navigation.*、ui.*、theme.get + subscribeTheme。DEV 放开全部并跳过同域校验；生产按 manifest.bridge.scopes 授权。 |
SDK（@/sdk） | 插件前端脚手架里的运行时封装：bridge、http、entry（resolveEntryMode，默认 front）、user、theme、auto-login。 |
| qiankun | 微前端框架。基座 views/plugin/app/index.vue 用 loadMicroApp 加载子应用，注入 plugin/pluginName/entryType/hostBridge/onMessage，开启 experimentalStyleIsolation，入口按 name 解析（去 ID 化）。 |
| 免登双通道 | 后端 consume（换 sid+identity，三方 type=3 另需 client_secret）；前端 exchange（换主 JWT，拒绝 type=3、校验 aud）。同域会话契约 atrman:session。 |
| 免登票据（Ticket） | TicketService：HMAC-SHA256，绑定 sid+app+entry，默认 60s，Redis jti 原子核销保证一次性。端点 /oauth/ticket/{issue,consume,exchange}。 |
| 远程小部件 | 基座用 vue3-sfc-loader 运行时编译插件的远程 .vue（RemoteVueComponentMeta）。两层缓存（源+组件，默认 TTL 5min，键 plugin:name:version/hash）；共享 moduleCache；URL 白名单（仅 http/https、同域/代理、路径前缀 /app/）。 |
| 特性开关 | config/plugin_extend.php：event/service/task/queue/push/composer 默认 true，middleware 默认 false。关闭时对应注册被忽略。 |
| 响应体 | {code, msg, total, data, page}，由 success()/warning()/error()/ret() 生成。code：200 成功、400 业务错、401 未登录、403 无权限、500 服务器错。详见响应与接口前缀。 |
| RBAC / Permission | 角色-权限模型。接口用 #[Permission(title, slug)] 声明，slug 形如 system:user:index。is_admin 仅便捷标记，权威判定查库。 |
| 脚手架 | am_plugin（Vue3+TS+Vite+Element Plus+qiankun），am_frontends/create-plugin.mjs 装配到 am_frontends/{name}/，构建产物回写插件 public/assets。Node ≥20.19、pnpm ≥8.8。 |
| owner | 注册时传入的归属标识（用插件名），供 forgetByOwner 卸载反清。漏传会造成卸载残留。 |
| ReflectionCache | Webman 的注解/路由/反射缓存（app/cache/ReflectionCache.php）。改控制器注解、$noNeedLogin、路由或特性开关后需清缓存或重启 worker 才生效。 |