agentworkshop 0.7.51 → 0.7.52

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop-prod",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "type": "module",
   "private": true,
   "dependencies": {

package/README-zh.md

@@ -28,7 +28,7 @@
 
 **[English](./README.md)** · **[在线文档](https://kingdol666.github.io/AgentWorkShop)** · **[版本发布](https://github.com/kingdol666/AgentWorkShop/releases)** · **[更新日志](./changelog.md)** · **[插件 API](./docs/plugins.md)** · **[SDK](./docs/sdk.md)**
 
-<sub><b>v0.7.51</b> · 14 个执行引擎 · 6 种现场协议（5 内置 + 串口插件） · 113 个运行时设置项 · 双语文档（简体中文 / English）</sub>
+<sub><b>v0.7.52</b> · 14 个执行引擎 · 6 种现场协议（5 内置 + 串口插件） · 113 个运行时设置项 · 双语文档（简体中文 / English）</sub>
 
 <br />
 
@@ -386,7 +386,7 @@ aw update --check                      # 只报告，不安装
 npm install -g agentworkshop@latest    # 手动等效
 ```
 
-版本遵循 semver。每次 `aw start` 都会校验配置根，并把 `home` 之前的旧版 `data/` 布局迁移进来（以最新文件为准），因此数据可以跨版本存活。SQLite schema 迁移在服务端启动时执行。当前版本：**v0.7.51**——见[版本发布](https://github.com/kingdol666/AgentWorkShop/releases)。
+版本遵循 semver。每次 `aw start` 都会校验配置根，并把 `home` 之前的旧版 `data/` 布局迁移进来（以最新文件为准），因此数据可以跨版本存活。SQLite schema 迁移在服务端启动时执行。当前版本：**v0.7.52**——见[版本发布](https://github.com/kingdol666/AgentWorkShop/releases)。
 
 ### 第一次「Agent × 产线」会话（约 2 分钟）
 

package/README.md

@@ -28,7 +28,7 @@
 
 **[简体中文](./README-zh.md)** · **[Documentation](https://kingdol666.github.io/AgentWorkShop)** · **[Releases](https://github.com/kingdol666/AgentWorkShop/releases)** · **[Changelog](./changelog.md)** · **[Plugin API](./docs/plugins.md)** · **[SDK](./docs/sdk.md)**
 
-<sub><b>v0.7.51</b> · 14 engines · 6 field protocols (5 built-in + serial plugin) · 113 runtime settings · bilingual docs (简体中文 / English)</sub>
+<sub><b>v0.7.52</b> · 14 engines · 6 field protocols (5 built-in + serial plugin) · 113 runtime settings · bilingual docs (简体中文 / English)</sub>
 
 <br />
 
@@ -377,7 +377,7 @@ aw update --check                      # only report; nothing is installed
 npm install -g agentworkshop@latest    # manual equivalent
 ```
 
-Releases follow semver. `aw start` verifies the config root on every launch and migrates the legacy pre-`home` `data/` layout into it (newest file wins), so data survives upgrades. SQLite schema migrations run server-side at boot. Current version: **v0.7.51** — see [Releases](https://github.com/kingdol666/AgentWorkShop/releases).
+Releases follow semver. `aw start` verifies the config root on every launch and migrates the legacy pre-`home` `data/` layout into it (newest file wins), so data survives upgrades. SQLite schema migrations run server-side at boot. Current version: **v0.7.52** — see [Releases](https://github.com/kingdol666/AgentWorkShop/releases).
 
 ### Your first agent × line session (~2 minutes)
 

package/app/composables/workshop/useWorkshopApi.ts

@@ -213,8 +213,8 @@ export function useWorkshopApi() {
     updateChannelTemplate: (id: string, body: { name?: string, description?: string, scenarioPrompt?: string, workspace?: string, visibility?: 'private' | 'public' }) =>
       http.request<{ data: ChannelTemplateDto }>({ method: 'PATCH', url: `/workshop/channel-templates/${id}`, data: body }),
     deleteChannelTemplate: (id: string) => http.delete<{ data: unknown }>(`/workshop/channel-templates/${id}`),
-    instantiateChannelTemplate: (id: string, name?: string) =>
-      http.post<{ data: { channelId: string, workspace: string, agentCount: number, leadAgentId?: string } }>(`/workshop/channel-templates/${id}/instantiate`, { name }),
+    instantiateChannelTemplate: (id: string, name?: string, options?: { enableKnowledgeBase?: boolean }) =>
+      http.post<{ data: { channelId: string, workspace: string, agentCount: number, leadAgentId?: string } }>(`/workshop/channel-templates/${id}/instantiate`, { name, ...options }),
     /** 从 Channel 模板实例化并挂载到 workspace(替代"挂载已有 Channel") */
     mountChannelTemplate: (wsId: string, tplId: string, name?: string) =>
       http.post<{ data: { channelId: string, workspace: string, agentCount: number, leadAgentId?: string } }>(`/workshop/workspaces/${wsId}/channel-templates/${tplId}`, { name }),
@@ -329,6 +329,8 @@ export interface ChannelTemplateDto {
   isBuiltin: boolean
   ownerUserId: string | null
   ownerName?: string | null
+  /** 模板支持「知识库集成」选项(实例化时可启停 rag-bridge 插件) */
+  knowledgeBaseCapable?: boolean
   createdAt: string
   updatedAt: string
 }

package/app/pages/workshop/channel-templates.vue

@@ -128,12 +128,28 @@ const toggleVisibility = async (t: ChannelTemplateDto, pub: boolean): Promise<vo
   }
 }
 
-/** 实例化(不挂载;工作区内挂载走会话栏) */
+/** 实例化(不挂载;工作区内挂载走会话栏):KB-capable 模板先弹确认,可启停知识库集成 */
 const instantiating = ref<string | null>(null)
-const instantiate = async (t: ChannelTemplateDto): Promise<void> => {
+const instOpen = ref(false)
+const instTarget = ref<ChannelTemplateDto | null>(null)
+const instKb = ref(true)
+const openInstantiate = (t: ChannelTemplateDto): void => {
+  instTarget.value = t
+  instKb.value = true
+  if (!t.knowledgeBaseCapable) {
+    void confirmInstantiate()
+    return
+  }
+  instOpen.value = true
+}
+const confirmInstantiate = async (): Promise<void> => {
+  const t = instTarget.value
+  if (!t) return
   instantiating.value = t.id
+  instOpen.value = false
   try {
-    const res = await api.instantiateChannelTemplate(t.id)
+    const options = t.knowledgeBaseCapable ? { enableKnowledgeBase: instKb.value } : undefined
+    const res = await api.instantiateChannelTemplate(t.id, undefined, options)
     const data = (res as unknown as { data?: { channelId: string, agentCount: number } })?.data
     message.success(tt('ctpl.kefkfnl030', { p0: t.name, p1: data?.agentCount ?? 0 }))
   }
@@ -277,7 +293,7 @@ useHead({ title: () => tt('titles.ctpl') })
               ghost
               :loading="instantiating === t.id"
               :title="$t('ctpl.knjomku002')"
-              @click="instantiate(t)"
+              @click="openInstantiate(t)"
             >
               {{ $t('ctpl.k3mr1fo017') }}
             </a-button>
@@ -348,11 +364,34 @@ useHead({ title: () => tt('titles.ctpl') })
         </a-form-item>
       </a-form>
     </a-modal>
+
+    <a-modal
+      v-model:open="instOpen"
+      :title="tt('ctpl.kbInstTitle', { p0: instTarget?.name ?? '' })"
+      :ok-text="$t('ctpl.k3mr1fo017')"
+      :cancel-text="$t('common.cancel')"
+      :confirm-loading="instantiating === instTarget?.id"
+      @ok="confirmInstantiate"
+    >
+      <a-form layout="vertical">
+        <a-form-item :label="$t('ctpl.kbOption')">
+          <a-switch
+            v-model:checked="instKb"
+            :checked-children="$t('ctpl.kbOn')"
+            :un-checked-children="$t('ctpl.kbOff')"
+          />
+        </a-form-item>
+        <p class="kb-hint">
+          {{ $t('ctpl.kbHint') }}
+        </p>
+      </a-form>
+    </a-modal>
   </div>
 </template>
 
 <style scoped>
 .page { padding: 4px; }
+.kb-hint { margin: 0; font-size: 12px; opacity: 0.6; line-height: 1.6; }
 .head {
   display: flex;
   align-items: center;

package/config.yml

@@ -12,7 +12,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.7.51
+  version: 0.7.52
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/docs/cli.en.md

@@ -62,7 +62,7 @@ pnpm tui             # the terminal workbench
 ### 3. Quick use via npx (no global install)
 
 ```bash
-npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.51 start)
+npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.7.52 start)
 npx agentworkshop doctor           # subcommands work as usual
 npx -p agentworkshop aw doctor     # use -p when you want the name aw
 ```
@@ -79,7 +79,7 @@ npx -p agentworkshop aw doctor     # use -p when you want the name aw
 | Package manager | `pnpm@11.9.0` (`packageManager`, needed only for source development) |
 | Module format | ESM (`type: module`) |
 | License | `PolyForm-Noncommercial-1.0.0` |
-| Current version | `0.7.51` (`package.json`) |
+| Current version | `0.7.52` (`package.json`) |
 
 ## 2. First start (the Claude Code experience)
 

package/docs/cli.md

@@ -60,7 +60,7 @@ pnpm tui             # 终端工作台
 ### 3. npx 快速使用（免全局安装）
 
 ```bash
-npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.51 start)
+npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.7.52 start)
 npx agentworkshop doctor           # 子命令照常可用
 npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 ```
@@ -76,7 +76,7 @@ npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 | 包管理器 | `pnpm@11.9.0`（`packageManager`，仅源码开发需要） |
 | 模块形态 | ESM（`type: module`） |
 | 许可证 | `PolyForm-Noncommercial-1.0.0` |
-| 当前版本 | `0.7.51`（`package.json`） |
+| 当前版本 | `0.7.52`（`package.json`） |
 
 ## 二、首次启动（Claude Code 式）
 

package/docs/plugins.en.md

@@ -9,7 +9,7 @@
 >
 > Applies to: plugin system v2 has been available since **v0.7.29** (frontend component
 > injection / plugin settings / plugin i18n / runtime services surface); this document
-> describes **v0.7.51**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.7.52**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 

package/docs/plugins.md

@@ -6,7 +6,7 @@
 > 本文是唯一权威参考;`docs/site/plugins/` 的分页文档与本文同源。
 >
 > 适用版本:插件系统 v2 自 **v0.7.29** 起可用(前端组件注入 / 插件设置 / 插件 i18n /
-> 运行时服务面);本文档对应当前版本 **v0.7.51**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.7.52**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始
 

package/docs/sdk.en.md

@@ -7,7 +7,7 @@
 
 **SDK version constants**: server-side `SDK_VERSION = '0.3.0'`, browser-side `CLIENT_SDK_VERSION = '0.3.0'`.
 These two constants are the **interface version of the SDK itself** and evolve **independently**
-from the npm package version (the `version` field in `package.json`, currently 0.7.51) —
+from the npm package version (the `version` field in `package.json`, currently 0.7.52) —
 them being out of sync is expected. Never use `SDK_VERSION` to infer the package version, or the reverse.
 **Module format**: ESM only (only `import` / `export`; there is no CJS entry).
 **Types**: `sdk/index.d.mts` and `sdk/client.d.mts` ship with the package, so TypeScript projects

package/docs/sdk.md

@@ -5,7 +5,7 @@
 > 零第三方运行时依赖,Node ≥ 23.4 与现代浏览器双端可用。
 
 **SDK 版本常量**:服务端 `SDK_VERSION = '0.3.0'`,浏览器端 `CLIENT_SDK_VERSION = '0.3.0'`。
-这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.51)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.52)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。

package/i18n/dicts/ctpl.json

@@ -1,32 +1,37 @@
-{
-  "k117jag9001": "删除模板?(已实例化的 Channel 不受影响)",
-  "knjomku002": "按模板新建 Channel(成员自动装配)",
-  "k1f55q76003": "模板名称",
-  "k40gkk004": "描述",
-  "k1ju32o7005": "选择 lead 模板(可空)",
-  "k5uq1js006": "Worker 成员模板(实例化时逐个克隆)",
-  "kqmdkc9007": "选择成员模板(可空)",
-  "k1q87yho008": "作业场景 Prompt(注入全部成员)",
-  "kk4u5cr009": "工作目录(留空 = 实例化时默认)",
-  "k3lrqn0010": "可见性",
-  "k18gglgp011": "场景 + 工作目录 + 团队的组合模板;一键实例化为 Channel(成员自动装配)。模板按用户隔离,公开后全员可用。",
-  "krpx6qa012": "返回工作区",
-  "k1efixrj013": "新建模板",
-  "ka1gpdj014": "admin 视图:可见全部用户的模板与创建者",
-  "k3rx4ps015": "空团队",
-  "k3xakp016": "删除",
-  "k3mr1fo017": "实例化",
-  "k19fglby018": "新建第一个 Channel 模板",
-  "k17jfge3019": "私有(仅本人可见)",
-  "k191u0u5020": "公开(全员可实例化,仅本人可修改)",
-  "k3x23c021": "内置",
-  "k3wv1t022": "公开",
-  "k447jj023": "私有",
-  "k1i0ji0y024": "模板名必填",
-  "kyppebc025": "模板已创建;可在工作区左侧会话栏一键实例化挂载",
-  "kkziya3026": "已公开:全员可实例化",
-  "k1xxabaf027": "已转为私有",
-  "k1oxfuqj028": "已删除模板",
-  "k1f54iqd029": "模板中心",
-  "kefkfnl030": "已实例化:{p0}(成员 {p1} 个),到工作区挂载使用"
-}
+{
+  "k117jag9001": "删除模板?(已实例化的 Channel 不受影响)",
+  "knjomku002": "按模板新建 Channel(成员自动装配)",
+  "k1f55q76003": "模板名称",
+  "k40gkk004": "描述",
+  "k1ju32o7005": "选择 lead 模板(可空)",
+  "k5uq1js006": "Worker 成员模板(实例化时逐个克隆)",
+  "kqmdkc9007": "选择成员模板(可空)",
+  "k1q87yho008": "作业场景 Prompt(注入全部成员)",
+  "kk4u5cr009": "工作目录(留空 = 实例化时默认)",
+  "k3lrqn0010": "可见性",
+  "k18gglgp011": "场景 + 工作目录 + 团队的组合模板;一键实例化为 Channel(成员自动装配)。模板按用户隔离,公开后全员可用。",
+  "krpx6qa012": "返回工作区",
+  "k1efixrj013": "新建模板",
+  "ka1gpdj014": "admin 视图:可见全部用户的模板与创建者",
+  "k3rx4ps015": "空团队",
+  "k3xakp016": "删除",
+  "k3mr1fo017": "实例化",
+  "k19fglby018": "新建第一个 Channel 模板",
+  "k17jfge3019": "私有(仅本人可见)",
+  "k191u0u5020": "公开(全员可实例化,仅本人可修改)",
+  "k3x23c021": "内置",
+  "k3wv1t022": "公开",
+  "k447jj023": "私有",
+  "k1i0ji0y024": "模板名必填",
+  "kyppebc025": "模板已创建;可在工作区左侧会话栏一键实例化挂载",
+  "kkziya3026": "已公开:全员可实例化",
+  "k1xxabaf027": "已转为私有",
+  "k1oxfuqj028": "已删除模板",
+  "k1f54iqd029": "模板中心",
+  "kefkfnl030": "已实例化:{p0}(成员 {p1} 个),到工作区挂载使用",
+  "kbInstTitle": "实例化 {p0}",
+  "kbOption": "知识库集成(rag-bridge)",
+  "kbHint": "开启后本频道加载知识库插件:优化前先检索场景数据分析与物理机理,收口后由 lead 把经验沉淀入知识库;lead 还可用 team_grant_nodes 把自己绑定的节点授权给 worker。",
+  "kbOn": "开启",
+  "kbOff": "关闭"
+}

package/i18n/locales/en.ts

@@ -471,6 +471,11 @@ export default {
     newTplTitle: 'New channel template',
     leadTplLabel: 'Lead template (cloned as the channel lead when instantiated)',
     kefkfnl030: 'Instantiated: {p0} ({p1} members); mount it from the workspace',
+    kbInstTitle: 'Instantiate {p0}',
+    kbOption: 'Knowledge base integration (rag-bridge)',
+    kbHint: 'When on, this channel loads the KB plugin: search scene data-analysis & physics knowledge before optimizing, and the lead sinks experience back after the loop closes; the lead can also grant its own bound nodes to workers via team_grant_nodes.',
+    kbOn: 'On',
+    kbOff: 'Off',
     k1f54iqd029: 'Template Hub',
     k117jag9001: 'Delete template? (Instantiated Channels are not affected)',
     knjomku002: 'Create Channel from template (members auto-assembled)',

package/i18n/locales/zh-CN.ts

@@ -471,6 +471,11 @@ export default {
     newTplTitle: '新建 Channel 模板',
     leadTplLabel: 'Lead 模板(实例化时克隆为 channel lead)',
     kefkfnl030: '已实例化:{p0}(成员 {p1} 个),到工作区挂载使用',
+    kbInstTitle: '实例化 {p0}',
+    kbOption: '知识库集成(rag-bridge)',
+    kbHint: '开启后本频道加载知识库插件:优化前先检索场景数据分析与物理机理,收口后由 lead 把经验沉淀入知识库;lead 还可用 team_grant_nodes 把自己绑定的节点授权给 worker。',
+    kbOn: '开启',
+    kbOff: '关闭',
     k1f54iqd029: '模板中心',
     k117jag9001: '删除模板?(已实例化的 Channel 不受影响)',
     knjomku002: '按模板新建 Channel(成员自动装配)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.51",
+  "version": "0.7.52",
   "type": "module",
   "description": "AgentWorkShop \u8f6f\u4ef6\u5f00\u53d1\u7cfb\u7edf - \u57fa\u4e8e Nuxt 4 \u7684\u914d\u7f6e\u9a71\u52a8\u8fd0\u884c\u8303\u5f0f",
   "license": "PolyForm-Noncommercial-1.0.0",

package/scripts/_audit/kb-team-mock-e2e.mjs

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * scripts/_audit/kb-team-mock-e2e.mjs —— 知识库集成 Channel + lead→worker 节点委派(mock 阶段验收)。
+ *
+ * 覆盖(无 LLM 依赖):
+ *  1) 模板知识库能力面:chtpl-generic-optimize-default / chtpl-aml-optimization-default 标记 knowledgeBaseCapable;
+ *  2) 实例化 enableKnowledgeBase=true → 频道插件开关含 rag-bridge=on,场景提示词含 KB 作业段;
+ *  3) 实例化 enableKnowledgeBase=false → rag-bridge=off;缺省 → 无显式行(平台默认);
+ *  4) 委派 REST:lead 绑定面内节点授予 worker(grantedByAgentId 溯源);
+ *  5) fail-closed:越面授予 403 / 授予 lead 自己 400;
+ *  6) 执行中授予:worker 有在飞任务时仍可被授予新节点;
+ *  7) 撤销:收回授予的节点;非 lead 授予且 lead 不持有的绑定不被误撤。
+ *
+ * 用法:AW_BASE=http://127.0.0.1:3456 node scripts/_audit/kb-team-mock-e2e.mjs
+ * 前置:全新实例(首注册即 admin)。脚本自行注册 admin 账号并搭一条 mock 产线。
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3456'
+const ADMIN = { email: process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local', password: process.env.AW_ADMIN_PASSWORD ?? 'Awshop@123!' }
+
+let pass = 0
+const fails = []
+const ok = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`  PASS  ${name}${detail ? ` — ${detail}` : ''}`) }
+  else { fails.push(name); console.log(`  FAIL  ${name}${detail ? ` — ${detail}` : ''}`) }
+}
+const section = t => console.log(`\n━━━ ${t} ━━━`)
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function api(method, path, { body, token } = {}) {
+  const res = await fetch(BASE + path, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body != null ? JSON.stringify(body) : undefined,
+    signal: AbortSignal.timeout(30000),
+  })
+  const json = await res.json().catch(() => null)
+  return { status: res.status, json }
+}
+
+const TAG = `kbmock-${new Date().toISOString().slice(5, 16).replace(/[-T:]/g, '')}`
+
+async function main() {
+  section('S0 管理员就绪(全新实例首注册即 admin)')
+  const reg = await api('POST', '/api/users/register', { body: { ...ADMIN, name: 'kb-mock-admin' } })
+  const token = reg.json?.data?.token ?? (await api('POST', '/api/users/login', { body: { email: ADMIN.email, password: ADMIN.password } })).json?.data?.token
+  ok('管理员 token 可用', Boolean(token))
+  const auth = { token }
+
+  section('S1 模板知识库能力面')
+  const tplList = (await api('GET', '/api/workshop/channel-templates', auth)).json?.data ?? []
+  const generic = tplList.find(t => t.id === 'chtpl-generic-optimize-default')
+  const optTpl = tplList.find(t => t.id === 'chtpl-aml-optimization-default')
+  ok('内置模板存在「通用闭环优化频道(标准)」', Boolean(generic), generic?.name)
+  ok('通用模板标记 knowledgeBaseCapable', generic?.knowledgeBaseCapable === true)
+  ok('工艺优化通道标记 knowledgeBaseCapable', optTpl?.knowledgeBaseCapable === true)
+  ok('其他模板不带该标记', tplList.find(t => t.id === 'chtpl-default-fullstack')?.knowledgeBaseCapable !== true)
+
+  section('S2 实例化:enableKnowledgeBase=true → rag-bridge 开 + KB 作业段')
+  const inst1 = (await api('POST', '/api/workshop/channel-templates/chtpl-generic-optimize-default/instantiate', { body: { name: `${TAG}-kb-on`, enableKnowledgeBase: true }, ...auth })).json?.data
+  ok('通用频道实例化成功', Boolean(inst1?.channelId), `agents=${inst1?.agentCount}`)
+  const ch1 = (await api('GET', `/api/workshop/channels/${inst1.channelId}`, auth)).json?.data
+  ok('场景提示词含知识库作业段', String(ch1?.scenarioPrompt ?? '').includes('知识库集成') && String(ch1?.scenarioPrompt ?? '').includes('kb_agent'))
+  const plug1 = (await api('GET', `/api/workshop/channels/${inst1.channelId}/plugins`, auth)).json?.data
+  const rb1 = (Array.isArray(plug1?.plugins) ? plug1.plugins : plug1 ?? []).find?.(p => p?.name === 'rag-bridge')
+    ?? (Array.isArray(plug1) ? plug1 : []).find(p => p?.name === 'rag-bridge')
+  ok('频道插件开关含 rag-bridge=on', Boolean(rb1 && rb1.enabled !== false), JSON.stringify(rb1 ?? plug1 ?? {}).slice(0, 120))
+  const members1 = (await api('GET', `/api/workshop/channels/${inst1.channelId}/agents`, auth)).json?.data ?? []
+  ok('频道含 lead + worker', members1.some(m => m.role === 'lead') && members1.filter(m => m.role === 'worker').length >= 2, `members=${members1.length}`)
+
+  section('S3 实例化:enableKnowledgeBase=false 与缺省行为')
+  const inst2 = (await api('POST', '/api/workshop/channel-templates/chtpl-aml-optimization-default/instantiate', { body: { name: `${TAG}-kb-off`, enableKnowledgeBase: false }, ...auth })).json?.data
+  const plug2 = (await api('GET', `/api/workshop/channels/${inst2.channelId}/plugins`, auth)).json?.data
+  const flat2 = Array.isArray(plug2?.plugins) ? plug2.plugins : (Array.isArray(plug2) ? plug2 : [])
+  ok('显式 false → rag-bridge=off', flat2.some(p => p?.name === 'rag-bridge' && p.enabled === false), JSON.stringify(flat2).slice(0, 120))
+  const inst3 = (await api('POST', '/api/workshop/channel-templates/chtpl-aml-optimization-default/instantiate', { body: { name: `${TAG}-kb-default` }, ...auth })).json?.data
+  const plug3 = (await api('GET', `/api/workshop/channels/${inst3.channelId}/plugins`, auth)).json?.data
+  const flat3 = Array.isArray(plug3?.plugins) ? plug3.plugins : (Array.isArray(plug3) ? plug3 : [])
+  const rb3 = flat3.find(p => p?.name === 'rag-bridge')
+  ok('缺省 → rag-bridge 保持平台默认(未被显式停用)', !rb3 || rb3.enabled !== false, JSON.stringify(flat3).slice(0, 120))
+
+  section('S4 搭 mock 产线(建线 + 模板 + 数采/数控节点)')
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `KBMock线-${TAG}`, description: 'kb-team mock e2e' }, ...auth })).json?.data
+  const lineId = line?.line?.id ?? line?.id
+  ok('建线成功', Boolean(lineId), lineId)
+  const dcwTpl = (await api('POST', '/api/workshop/dcw/templates', { body: { name: `kbmock-sp-tpl-${TAG}`, ch: '温度设定', unit: '℃', min: 150, max: 220, decimals: 1 }, ...auth })).json?.data
+  const daqTpl = (await api('POST', '/api/workshop/daq/templates', { body: { name: `kbmock-temp-tpl-${TAG}`, ch: '温度', unit: '℃', min: 0, max: 300, decimals: 1 }, ...auth })).json?.data
+  const dcwTplRef = dcwTpl?.template?.key ?? dcwTpl?.key
+  const daqTplRef = daqTpl?.template?.key ?? daqTpl?.key
+  ok('节点模板创建成功', Boolean(dcwTplRef) && Boolean(daqTplRef), `dcw=${dcwTplRef} daq=${daqTplRef}`)
+  const dcw = (await api('POST', '/api/workshop/dcw', { body: { name: `kbmock-sp-${TAG}`, templateRef: dcwTplRef, driver: 'mock', unit: '℃', min: 150, max: 220, stepLimit: 5, lineId }, ...auth })).json
+  const daq = (await api('POST', '/api/workshop/daq', { body: { name: `kbmock-temp-${TAG}`, templateRef: daqTplRef, driver: 'mock', intervalMs: 1000, publishIntervalMs: 0, lineId }, ...auth })).json
+  const dcwId = dcw?.data?.node?.id
+  const daqId = daq?.data?.node?.id
+  ok('数采/数控节点创建成功', Boolean(daqId) && Boolean(dcwId), `daq=${daqId} dcw=${dcwId}`)
+
+  section('S5 lead 绑定 + 委派核心面')
+  const lead = members1.find(m => m.role === 'lead')
+  const worker = members1.find(m => m.role === 'worker')
+  const b1 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: lead.id, nodeId: dcwId, kind: 'dcw', mode: 'manual' }, ...auth })
+  const b2 = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: lead.id, nodeId: daqId, kind: 'daq', mode: 'auto' }, ...auth })
+  ok('lead 绑定 dcw+daq 成功', b1.status === 200 && b2.status === 200, `dcw=${b1.status} daq=${b2.status}`)
+
+  const grant = await api('POST', '/api/workshop/agent-tools/bindings/grant', { body: { channelId: inst1.channelId, agentId: worker.id, nodeIds: [dcwId, daqId] }, ...auth })
+  ok('委派授予成功(整单)', grant.status === 200, JSON.stringify(grant.json?.data ?? grant.json).slice(0, 120))
+  const granted = grant.json?.data?.granted ?? []
+  ok('授予绑定带 lead 溯源', granted.length === 2 && granted.every(g => g.grantedByAgentId === lead.id), `n=${granted.length}`)
+  ok('dcw 委派缺省随 lead 的 manual 模式', granted.find(g => g.kind === 'dcw')?.mode === 'manual')
+  const workerBindings = (await api('GET', `/api/workshop/agent-tools/bindings?agentId=${worker.id}`, auth)).json?.data
+  const wbFlat = Array.isArray(workerBindings) ? workerBindings : (workerBindings?.bindings ?? [])
+  ok('worker 绑定面已含委派节点', wbFlat.some(b => b.nodeId === dcwId) && wbFlat.some(b => b.nodeId === daqId), `n=${wbFlat.length}`)
+
+  section('S6 fail-closed:越面授予 / 授予 lead 自己')
+  const bad = await api('POST', '/api/workshop/agent-tools/bindings/grant', { body: { channelId: inst1.channelId, agentId: worker.id, nodeIds: [`ghost-${TAG}`] }, ...auth })
+  const badCode = bad.json?.code ?? bad.json?.data?.code
+  ok('越面授予被拒(403 DELEGATION_NOT_OWNED)', bad.status === 403 && badCode === 'DELEGATION_NOT_OWNED', `status=${bad.status} code=${badCode}`)
+  const self = await api('POST', '/api/workshop/agent-tools/bindings/grant', { body: { channelId: inst1.channelId, agentId: lead.id, nodeIds: [dcwId] }, ...auth })
+  ok('授予 lead 自己被拒(400)', self.status === 400, `status=${self.status}`)
+
+  section('S7 执行中授予(worker 有在飞任务时仍可授权)')
+  const task = (await api('POST', `/api/workshop/channels/${inst1.channelId}/tasks`, { body: { title: `巡检-${TAG}`, description: '读取授权节点并汇报(委派执行中授予验证)', assigneeId: worker.id }, ...auth })).json?.data
+  ok('worker 根任务已创建', Boolean(task?.id), task?.id)
+  await sleep(500)
+  const midGrant = await api('POST', '/api/workshop/agent-tools/bindings/grant', { body: { channelId: inst1.channelId, agentId: worker.id, nodeIds: [dcwId], mode: 'auto' }, ...auth })
+  ok('执行中授予成功(模式覆盖 auto)', midGrant.status === 200, JSON.stringify(midGrant.json?.data ?? {}).slice(0, 100))
+  await api('POST', `/api/workshop/channels/${inst1.channelId}/tasks/${task.id}/cancel`, { ...auth }).catch(() => {})
+
+  section('S8 撤销')
+  const revoke = await api('POST', '/api/workshop/agent-tools/bindings/revoke', { body: { channelId: inst1.channelId, agentId: worker.id, nodeIds: [daqId] }, ...auth })
+  const results = revoke.json?.data?.results ?? []
+  ok('撤销 daq 委派成功', revoke.status === 200 && results.every(r => r.revoked), JSON.stringify(results).slice(0, 100))
+  const afterRevoke = (await api('GET', `/api/workshop/agent-tools/bindings?agentId=${worker.id}`, auth)).json?.data
+  const arFlat = Array.isArray(afterRevoke) ? afterRevoke : (afterRevoke?.bindings ?? [])
+  ok('撤销后 worker 不再持有该节点', !arFlat.some(b => b.nodeId === daqId), `剩余=${arFlat.length}`)
+
+  console.log(`\n════ 结果: ${pass} PASS / ${fails.length} FAIL ════`)
+  if (fails.length) {
+    console.log('失败项:')
+    for (const f of fails) console.log(`  - ${f}`)
+    process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error('E2E 致命异常:', err)
+  process.exit(1)
+})