7 · 业务插件开发（模板）

bus-yyjz-agents/
├── package.json          # 包名 + dsh.bundle.patch + dsh.embed + scripts
├── cordis.patch.yml      # 装配行：宿主按它把插件注入 profile
├── build.mjs             # esbuild 打包 + 拷两个前端产物到 lib/web
├── src/
│   ├── index.ts          # 插件入口：取服务 + 注册路由 + 装配运行时
│   ├── config.ts         # 台账应用名 / 库应用名 / 前缀 / 键名与解析
│   ├── http.ts           # 极简 HTTP 类型与工具（readJson / sendJson / openSse）
│   ├── contract.ts       # 依赖服务的本地契约副本
│   ├── roles.ts          # KTH 角色 code → 业务前端角色 映射
│   ├── assets.ts         # 静态站点托管（web 与 web/admin）
│   ├── db/
│   │   ├── schema.ts     # 逻辑表名 → 实际表名 + 幂等 DDL
│   │   └── store.ts      # 建表 + 启动自检
│   ├── domain/           # 领域层持久化（单向依赖的底）
│   │   ├── shared.ts     # id / 时间戳 / JSON 文本 工具
│   │   ├── models.ts  tools.ts  skills.ts  connectors.ts  plugins.ts
│   │   ├── platform.ts   # 项目 / 子智能体 / 每子智能体配置
│   │   └── business.ts   # 公司 / 会话 / 消息 / 三场景报告
│   ├── runtime/          # 把库里的资源翻译成 DSH 原生能力
│   │   ├── model-adapter.ts  model-registry.ts
│   │   ├── tool-registry.ts  mcp-registry.ts
│   │   ├── skill-store.ts
│   │   └── agent-setup.ts  resolve.ts  run.ts  sse.ts
│   ├── api/              # 接口分发
│   │   ├── core.ts       # 状态 / 登录 / 鉴权守卫
│   │   ├── admin.ts      # 资源注册台 + 子智能体平台（仅管理员）
│   │   └── business.ts   # 业务接口（含 SSE）
│   └── security/crypto.ts
├── web/                  # 业务前台（零构建静态站点：index.html + app.js + styles.css）
├── web/admin/            # 配置后台（零构建静态站点）
├── tools/                # register-ts.mjs / selfcheck.mjs / ts-hooks.mjs
└── docs/plan/            # 决策与理由：数据模型 / 运行时映射 / 配置与资源

export const name = 'kth-bus-yyjz-agents'

/* cordis 插件取未声明的服务会直接抛错，且发生在宿主启动阶段 —— 四个服务本插件都必需 */
export const inject = ['webServer', 'infraConfig', 'auth', 'infraDatabase']

export function apply(ctx: any): void {
  const server = ctx?.webServer                 // 宿主注入的 webServer
  const BASE = '/bus-yyjz-agents'               // 前端与接口的公共前缀（src/config.ts）
  const handler = async (req, res) => { /* 分发 /api/* 与静态资源 */ }
  const dispose = server.register({ kind: 'prefix', path: BASE, handler })
  ctx.effect(() => () => dispose?.(), 'kth-bus-yyjz-agents: routes')
}

-- 建表幂等；重复执行安全
create table if not exists kth_yyjz_agents_model (
  id varchar(40) primary key,
  name varchar(128) not null,
  base_url varchar(512) not null,
  api_key text not null,
  enabled boolean not null default true,
  created_at bigint not null,
  updated_at bigint not null
);

-- 加列也幂等（建表语句不会补列，只能 alter）
alter table kth_yyjz_agents_model add column if not exists max_tokens bigint null;

pnpm install
pnpm run build          # → lib/index.js + lib/web/**（含 admin）
pnpm run check          # node --check lib/index.js

# 离线自检（无第三方依赖，验证动态模型 adapter 的分片翻译与路由/配置解析）
node --import ./tools/register-ts.mjs tools/selfcheck.mjs