agentworkshop 0.7.66 → 0.7.70

package/docs/full-test-plan.md

@@ -147,7 +147,7 @@
 
 ## Phase 7 浏览器目视验收（Puppeteer 截图逐页过目）
 
-覆盖页：登录/仪表盘/产线管理/数采列表+详情（趋势图在动）/数控/数字孪生（帧推进+无黑屏）/设置（分组渲染+折叠+来源徽标）/插件/运维日志 /logs/AML/AgentTeam。
+覆盖页：登录/仪表盘/产线管理/数采列表+详情（趋势图在动）/数控/数字孪生（帧推进+无黑屏）/设置（分组渲染+折叠+来源徽标）/插件/产线日志 /logs/AML/AgentTeam。
 工具：`scripts/ui-screenshot.mjs`、`scripts/ui/audit-layout.mjs`、`scripts/_sweep-button-contrast.mjs`（双主题全路由按钮对比度+空按钮扫描）。截图存 `.e2e-shots/` 逐张目视；破版/白屏/控制台报错即红项。
 
 ---

package/docs/mcp.md

@@ -1,108 +1,122 @@
-# aw 工业 MCP 服务(mcp/)
-
-> 面向外部 skill / MCP 客户端 / 工程师工作台的集成入口:把平台关键 REST 方法暴露为
-> 一等 MCP 工具,并**自动发现本机运行实例的端口**——挂上就能用,不要求手填端口。
-
-## 一、它解决什么
-
-平台已有两个 MCP 面,分工如下:
-
-| MCP 面 | 位置 | 面向 | 鉴权 |
-| --- | --- | --- | --- |
-| **aw 工业 MCP**(本文) | `mcp/aw-mcp-server.mjs`(stdio) | 外部 skill、桌面 MCP 客户端、CI 脚本 | 用户 token(AW_TOKEN 或 AW_EMAIL/AW_PASSWORD) |
-| host tools 回程桥 | `server/harness/aw-mcp-bridge.mjs`(stdio) | 频道内 harness 引擎(codex/dsh/opencode…) | agent 实例 token |
-| Workshop MCP(Streamable HTTP) | `POST /api/mcp/workshop` | 平台侧任务/消息/设备孪生 | Bearer token |
-
-工业 MCP 暴露的是**工程操作面**(产线/节点绑定/参数映射/配方/优化闭环频道/插件),
-与频道内 agent 的 host tool 面(`.AgentWorkShop/prompts/host-tools.json`)互补。
-
-## 二、快速开始
-
-```bash
-aw mcp --doctor        # 诊断:自动发现过程 → 健康 → 鉴权,一次讲清
-aw mcp --print-config  # 打印 MCP 客户端配置 JSON
-aw mcp                 # 启动 stdio 服务(由 MCP 客户端作为子进程拉起)
-```
-
-客户端配置(claude_desktop_config.json / codex config.toml 通用形态):
-
-```json
-{ "mcpServers": { "aw": { "command": "node", "args": ["<仓库>/mcp/aw-mcp-server.mjs"], "env": {} } } }
-```
-
-## 三、端口自动发现(核心机制)
-
-发现优先级(逐级 `GET /api/health` 探活,`data.status==='ok'` 才算命中;全失败才报错):
-
-1. `AW_BASE_URL` —— 显式平台地址
-2. `AW_PORT` —— 多实例并存时钉住端口
-3. 锁文件 `<configRoot>/.runtime/aw.lock`(`{pid,port,mode}`,`aw start` 端口顺延后回写,
-   是实例真实端口的唯一权威记录):
-   - 显式 `AW_HOME` 时:先 `AW_HOME/.runtime/aw.lock` 与 `AW_HOME/.AgentWorkShop/.runtime/aw.lock`,
-     再 cwd 向上找 repo 锁(**显式 AW_HOME 压过隐式发现,且不回落全局 home 锁**——多实例隔离语义)
-   - 未设 `AW_HOME` 时:cwd 向上找 `.AgentWorkShop/.runtime/aw.lock`,再 `~/.AgentWorkShop/.runtime/aw.lock`
-4. `PORT` / `NUXT_PORT`(启动惯例变量)
-5. `config.yml` 的 `server.dev.port` / `server.prod.port`(零依赖轻量解析)
-6. 默认端口 3000(dev)/ 3001(prod)
-
-**确保连接**:会话内缓存发现结果;任何工具调用遇到网络层失败,自动作废缓存重发现一次再重试
-(实例顺延换端口后下一发即自愈)。401 时作废 token 懒重登录一次。
-登录失败(凭据错误)不触发重发现,直接报错。
-
-## 四、鉴权
-
-- `AW_TOKEN`:直接携带(优先)。
-- `AW_EMAIL` + `AW_PASSWORD`:首次鉴权调用时懒登录 `POST /api/users/login`,token 会话内缓存。
-- 都没有:工具返回带补救指引的错误;客户端也可在会话里调 `aw_login` 工具显式登录。
-- 实例从未初始化管理员:先走 Web `/setup` 注册(首注册即 admin),MCP 不代注册。
-
-## 四点五、集成开关(系统设置)
-
-- 设置项:`系统设置 → MCP 集成 → 启动 MCP 集成`(`mcp.enabled`,live 键,默认**停用**)。
-  也可用环境变量 `AW_MCP_ENABLED=true` 覆盖(CI/无人值守场景)。
-- 语义:停用期间,除 `aw_status`(自诊断)外的**所有 MCP 工具调用被拒绝**,返回指引文本;
-  平台 REST 与频道内 agent 的 host tools 不受影响。切换 ≤3s 传导到 MCP 服务,无需重启。
-- 三个项目 skill(`skills/`)的前置步骤 0 都会检查该开关(`aw_status` 的 `mcpEnabled` 字段)。
-- 注意:设置页出现「MCP 集成」分组需要实例运行带该描述符的构建(`shared/config/schema.json`,
-  2026-09-27 加入);文件路径(写 `<configRoot>/runtime-settings.json`)与 env 路径不依赖构建。
-
-## 五、工具面(35 个)
-
-| 分组 | 工具 |
-| --- | --- |
-| 连接 | `aw_status`(发现+健康+鉴权状态)、`aw_login` |
-| 产线/产品/配方 | `aw_line_list/create/start/stop`、`aw_product_create`、`aw_recipe_create` |
-| DCW 节点与参数映射 | `aw_dcw_snapshot/create/write/read`、`aw_param_list/write/read` |
-| DAQ 数采 | `aw_daq_create`、`aw_daq_controller`、`aw_daq_samples` |
-| 优化闭环频道 | `aw_channel_list/create`、`aw_channel_template_list/instantiate`、`aw_team_provision`(组合:建 agent→team→成员→deploy)、`aw_agent_tool_bind/invoke`、`aw_twin_profile_get/patch`、`aw_task_create/list`、`aw_model_list/promote`、`aw_optimization_judge` |
-| 插件 | `aw_plugin_list`、`aw_plugin_toggle` |
-| 逃生舱 | `aw_request`(通用 REST,path 必须以 `/api/` 开头) |
-
-`aw_agent_tool_invoke` 可调用频道成员实例的全部宿主工具面
-(`optimization_explore` / `mpc_optimize` / `twin_*` / `dcw_control` / `param_control` / `daq_query` 等),
-是探索/寻优闭环的执行通道。
-
-## 六、与 skills 的集成
-
-三个项目级 skill 以本服务为执行底座(`skills/` 目录):
-
-- `skills/aw-node-bind/` —— 真实场景节点参数绑定(建线→绑执行点→参数映射→配方开跑→回环验收)
-- `skills/aw-opt-channel/` —— 场景优化闭环频道(模板实例化→剧组→探索→AML 门禁→绑定→投用)
-- `skills/aw-plugin-dev/` —— 插件开发(脚手架→setup(ctx)→热重载验证→发布清单)
-
-规范校验:`npm run test:skills`(含"skill 引用的工具必须真实存在于 MCP 工具面"的一致性检查)。
-
-## 七、测试
-
-```bash
-npm run test:mcp        # 单测(12 断言组):锁解析/发现优先级/RPC 面/懒登录/断线重发现/逃生舱守卫
-npm run test:mcp-live   # 真实实例 e2e(34 断言):隔离 home 实例 + 零端口提示自发现 + 全链业务
-```
-
-live e2e 的隔离纪律:临时 `AW_HOME` + 端口 3461,结束 `taskkill //T` 清场,不碰真实库。
-
-## 八、已知边界(有意为之)
-
-- `GET /api/workshop/plugins` 等少数端点是裸 `defineEventHandler`(无统一信封),服务端已做信封嗅探兼容。
-- MCP 不代理模拟器 REST(presets/export);skill 流程里对模拟器的访问走直连(默认 `http://127.0.0.1:4010`)。
-- `aw_request` 限制 method 白名单与 `/api/` 前缀,不代理任意外网。
+# aw 工业 MCP 服务(mcp/)
+
+> 面向外部 skill / MCP 客户端 / 工程师工作台的集成入口:把平台关键 REST 方法暴露为
+> 一等 MCP 工具,并**自动发现本机运行实例的端口**——挂上就能用,不要求手填端口。
+
+## 一、它解决什么
+
+平台已有两个 MCP 面,分工如下:
+
+| MCP 面 | 位置 | 面向 | 鉴权 |
+| --- | --- | --- | --- |
+| **aw 工业 MCP**(本文) | `mcp/aw-mcp-server.mjs`(stdio) | 外部 skill、桌面 MCP 客户端、CI 脚本 | 用户 token(AW_TOKEN 或 AW_EMAIL/AW_PASSWORD) |
+| host tools 回程桥 | `server/harness/aw-mcp-bridge.mjs`(stdio) | 频道内 harness 引擎(codex/dsh/opencode…) | agent 实例 token |
+| Workshop MCP(Streamable HTTP) | `POST /api/mcp/workshop` | 平台侧任务/消息/设备孪生 | Bearer token |
+
+工业 MCP 暴露的是**工程操作面**(产线/节点绑定/参数映射/配方/优化闭环频道/插件),
+与频道内 agent 的 host tool 面(`.AgentWorkShop/prompts/host-tools.json`)互补。
+
+## 二、快速开始
+
+```bash
+aw mcp --doctor        # 诊断:自动发现过程 → 健康 → 鉴权,一次讲清
+aw mcp --print-config  # 打印 MCP 客户端配置 JSON
+aw mcp                 # 启动 stdio 服务(由 MCP 客户端作为子进程拉起)
+```
+
+客户端配置(claude_desktop_config.json / codex config.toml 通用形态):
+
+```json
+{ "mcpServers": { "aw": { "command": "node", "args": ["<仓库>/mcp/aw-mcp-server.mjs"], "env": {} } } }
+```
+
+## 三、端口自动发现(核心机制)
+
+发现优先级(逐级 `GET /api/health` 探活,`data.status==='ok'` 才算命中;全失败才报错):
+
+1. `AW_BASE_URL` —— 显式平台地址
+2. `AW_PORT` —— 多实例并存时钉住端口
+3. 锁文件 `<configRoot>/.runtime/aw.lock`(`{pid,port,mode}`,`aw start` 端口顺延后回写,
+   是实例真实端口的唯一权威记录):
+   - 显式 `AW_HOME` 时:先 `AW_HOME/.runtime/aw.lock` 与 `AW_HOME/.AgentWorkShop/.runtime/aw.lock`,
+     再 cwd 向上找 repo 锁(**显式 AW_HOME 压过隐式发现,且不回落全局 home 锁**——多实例隔离语义)
+   - 未设 `AW_HOME` 时:cwd 向上找 `.AgentWorkShop/.runtime/aw.lock`,再 `~/.AgentWorkShop/.runtime/aw.lock`
+4. `PORT` / `NUXT_PORT`(启动惯例变量)
+5. `config.yml` 的 `server.dev.port` / `server.prod.port`(零依赖轻量解析)
+6. 默认端口 3000(dev)/ 3001(prod)
+
+**确保连接**:会话内缓存发现结果;任何工具调用遇到网络层失败,自动作废缓存重发现一次再重试
+(实例顺延换端口后下一发即自愈)。401 时作废 token 懒重登录一次。
+登录失败(凭据错误)不触发重发现,直接报错。
+
+## 四、鉴权
+
+- `AW_TOKEN`:直接携带(优先)。
+- `AW_EMAIL` + `AW_PASSWORD`:首次鉴权调用时懒登录 `POST /api/users/login`,token 会话内缓存。
+- 都没有:工具返回带补救指引的错误;客户端也可在会话里调 `aw_login` 工具显式登录。
+- 实例从未初始化管理员:先走 Web `/setup` 注册(首注册即 admin),MCP 不代注册。
+
+## 四点五、集成开关(系统设置)
+
+- 设置项:`系统设置 → MCP 集成 → 启动 MCP 集成`(`mcp.enabled`,live 键,默认**停用**)。
+  也可用环境变量 `AW_MCP_ENABLED=true` 覆盖(CI/无人值守场景)。
+- 语义:停用期间,除 `aw_status`(自诊断)外的**所有 MCP 工具调用被拒绝**,返回指引文本;
+  平台 REST 与频道内 agent 的 host tools 不受影响。切换 ≤3s 传导到 MCP 服务,无需重启。
+- 三个项目 skill(`skills/`)的前置步骤 0 都会检查该开关(`aw_status` 的 `mcpEnabled` 字段)。
+- 注意:设置页出现「MCP 集成」分组需要实例运行带该描述符的构建(`shared/config/schema.json`,
+  2026-09-27 加入);文件路径(写 `<configRoot>/runtime-settings.json`)与 env 路径不依赖构建。
+
+## 五、工具面(35 个)
+
+| 分组 | 工具 |
+| --- | --- |
+| 连接 | `aw_status`(发现+健康+鉴权状态)、`aw_login` |
+| 产线/产品/配方 | `aw_line_list/create/start/stop`、`aw_product_create`、`aw_recipe_create` |
+| DCW 节点与参数映射 | `aw_dcw_snapshot/create/write/read`、`aw_param_list/write/read` |
+| DAQ 数采 | `aw_daq_create`、`aw_daq_controller`、`aw_daq_samples` |
+| 优化闭环频道 | `aw_channel_list/create`、`aw_channel_template_list/instantiate`、`aw_team_provision`(组合:建 agent→team→成员→deploy)、`aw_agent_tool_bind/invoke`、`aw_twin_profile_get/patch`、`aw_task_create/list`、`aw_model_list/promote`、`aw_optimization_judge` |
+| 插件 | `aw_plugin_list`、`aw_plugin_toggle` |
+| 逃生舱 | `aw_request`(通用 REST,path 必须以 `/api/` 开头) |
+
+`aw_agent_tool_invoke` 可调用频道成员实例的全部宿主工具面
+(`optimization_explore` / `mpc_optimize` / `twin_*` / `dcw_control` / `param_control` / `daq_query` 等),
+是探索/寻优闭环的执行通道。
+
+### host tools 目录与 Channel 工具治理
+
+- 内置工具与插件 `ctx.omp.registerTool` 注册的工具都会投影到 `tool_registry`(SQLite);
+  `GET /api/workshop/tools`(admin)可查看来源、插件、参数 Schema、可用性与被哪些 Channel 停用。
+- `aw-mcp-bridge.mjs` 的 `tools/list` 仍从 `/api/workshop/agent-tools/list` 实时拉取(10s 缓存),
+  并声明 `tools.listChanged=true`;每 10s 对比名称/描述,变化时向客户端发
+  `notifications/tools/list_changed`。引擎不响应通知时,下一次 `tools/list`/新会话仍会拿到新清单。
+- 每个 Channel 可在「设置 → 工具」按 `all`(默认全开)或 `selected`(仅勾选)选择工具;
+  `GET|PUT /api/workshop/channels/:id/tools` 是同一数据源。
+- **执行面复核**:`aw-mcp-bridge` 的 `tools/call` 回程到 `manager.invokeHostTool` 后,
+  会再检查该 Channel 是否停用该工具;即使引擎缓存了旧工具列表,直调被停用工具也返回 `isError`。
+- 硬规则(角色/profile/写守卫/插件总开关)不可被 Channel 选择绕过;插件被卸载后
+  其工具在目录中标记 `available=0`,MCP 列表与直调同时失效。
+
+## 六、与 skills 的集成
+
+三个项目级 skill 以本服务为执行底座(`skills/` 目录):
+
+- `skills/aw-node-bind/` —— 真实场景节点参数绑定(建线→绑执行点→参数映射→配方开跑→回环验收)
+- `skills/aw-opt-channel/` —— 场景优化闭环频道(模板实例化→剧组→探索→AML 门禁→绑定→投用)
+- `skills/aw-plugin-dev/` —— 插件开发(脚手架→setup(ctx)→热重载验证→发布清单)
+
+规范校验:`npm run test:skills`(含"skill 引用的工具必须真实存在于 MCP 工具面"的一致性检查)。
+
+## 七、测试
+
+```bash
+npm run test:mcp        # 单测(12 断言组):锁解析/发现优先级/RPC 面/懒登录/断线重发现/逃生舱守卫
+npm run test:mcp-live   # 真实实例 e2e(34 断言):隔离 home 实例 + 零端口提示自发现 + 全链业务
+```
+
+live e2e 的隔离纪律:临时 `AW_HOME` + 端口 3461,结束 `taskkill //T` 清场,不碰真实库。
+
+## 八、已知边界(有意为之)
+
+- `GET /api/workshop/plugins` 等少数端点是裸 `defineEventHandler`(无统一信封),服务端已做信封嗅探兼容。
+- MCP 不代理模拟器 REST(presets/export);skill 流程里对模拟器的访问走直连(默认 `http://127.0.0.1:4010`)。
+- `aw_request` 限制 method 白名单与 `/api/` 前缀,不代理任意外网。

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.66**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.7.70**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 
@@ -38,7 +38,7 @@ The host scans `builtin` → `project` → `user` and keeps the **first** match
 
 | Scope | Entry path | Notes |
 |---|---|---|
-| `builtin` | `<packageRoot>/server/plugins-builtin/<name>/index.mjs` | shipped with the package, always present; the current release ships `diag-bridge` and `rag-bridge` |
+| `builtin` | `<packageRoot>/server/plugins-builtin/<name>/index.mjs` | shipped with the package, always present; the current release ships `diag-bridge`, `rag-bridge`, `serial-bridge` and `twin-injection-default` |
 | `project` | `<repo>/.AgentWorkShop/plugins/<name>/index.mjs` | travels with the checkout, can be versioned in git |
 | `user` | `$AW_HOME/plugins/<name>/index.mjs` (default `~/.AgentWorkShop/plugins`) | user-level, shared across projects |
 
@@ -510,6 +510,26 @@ Beyond the global switch, every team (channel) keeps its own plugin switch set b
 - **Semantics**: no explicit rows = unconfigured → every enabled plugin is visible to that team (backward compatible); once rows exist they filter — **a disabled plugin's tools are not injected into that team's agents and dispatch rejects them at the source**;
 - **UI**: the workshop teams page (creation checkboxes + team dialog).
 
+### Tool registry and per-channel tool selection (2026-10-20)
+
+Plugin tools no longer live only in a process-local registry: startup, registration and unload project them into `tool_registry` (SQLite) with source, plugin name, scope, label, description, parameter schema, roles, definition hash and availability. Execution code stays in the plugin process; the database is only the catalog and governance source of truth.
+
+- **Global visibility**: admins open `/tools` (or `GET /api/workshop/tools`) to see built-in and plugin tools, parameter schemas and which channels disabled them; `POST /api/workshop/tools/sync` re-syncs manually.
+- **Per-channel selection**: `GET|PUT /api/workshop/channels/:id/tools`, `POST .../tools/reset`;
+  - `mode='all'` (default): every eligible tool is enabled; only unchecked tools are stored (deny-list);
+  - `mode='selected'`: only checked tools are enabled (allow-list); new tools stay disabled until selected;
+  - hard rules (role / channel profile / write guard / plugin master switch) win; a channel cannot open a tool excluded by a hard rule, and explicitly selecting one in `selected` mode returns `409 TOOL_NOT_ELIGIBLE`.
+- **Same injection source**: omp `set_host_tools`, pi `AW_PI_TOOLS_FILE` and the MCP `tools/list` used by other harnesses all go through `hostToolsForRole`; the execution layer re-checks in `dispatchHostTool` / `invokeHostTool`, so a disabled tool cannot be called even if an engine cached an old list.
+- **UI**: the Channel settings dialog has a Tools section with search, source/state filters, select all/none/reset, and reason badges for hard-rule blocks.
+
+### Install a local plugin
+
+```bash
+aw plugin install <source-dir> [--global|-g] [--name <name>] [--force|-f] [--no-enable]
+```
+
+Installation only accepts a **local directory** containing `index.mjs`: symlinks and out-of-scope paths are rejected and the target must be a project/user scope; `--force` backs up the old directory first. Installation rewrites `plugins-state.json` to trigger hot reload, and the plugin's tools automatically enter the tool catalog and MCP tool surface. No remote URL or marketplace download.
+
 ## 11. Complete example
 
 ```js

package/docs/plugins.md

@@ -6,7 +6,7 @@
 > 本文是唯一权威参考;`docs/site/plugins/` 的分页文档与本文同源。
 >
 > 适用版本:插件系统 v2 自 **v0.7.29** 起可用(前端组件注入 / 插件设置 / 插件 i18n /
-> 运行时服务面);本文档对应当前版本 **v0.7.66**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.7.70**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始
 
@@ -35,7 +35,7 @@ aw plugin enable my-plugin          # 重新启用
 
 | 作用域 | 入口路径 | 说明 |
 |---|---|---|
-| `builtin` | `<包根>/server/plugins-builtin/<name>/index.mjs` | 随包发布,永远存在;当前发行内置 `diag-bridge`、`rag-bridge` |
+| `builtin` | `<包根>/server/plugins-builtin/<name>/index.mjs` | 随包发布,永远存在;当前发行内置 `diag-bridge`、`rag-bridge`、`serial-bridge`、`twin-injection-default` |
 | `project` | `<repo>/.AgentWorkShop/plugins/<name>/index.mjs` | 随检出分发,可 git 版本化 |
 | `user` | `$AW_HOME/plugins/<name>/index.mjs`(默认 `~/.AgentWorkShop/plugins`) | 用户级,跨项目生效 |
 
@@ -499,6 +499,26 @@ ctx.omp.registerTool({
 - **语义**:无显式行 = 未配置 → 全部启用插件对该团队可见(向后兼容);写入显式行后按行过滤 —— **被关闭插件的工具不注入该团队的 Agent,dispatch 同源拒绝**;
 - **前端**:workshop teams 页(创建勾选 + 团队弹层)。
 
+### 工具目录与 Channel 级工具选择(2026-10-20)
+
+插件工具不再只存在于进程内注册表:启动/注册/卸载时同步投影到 `tool_registry`(SQLite),记录来源、插件名、作用域、label、description、参数 Schema、角色、定义哈希与可用状态。执行代码仍在插件进程里,数据库只做目录与治理事实源。
+
+- **全局透明化**:admin 打开 `/tools`(或 `GET /api/workshop/tools`)可看到内置 + 插件工具、参数 Schema、被哪些 Channel 停用;`POST /api/workshop/tools/sync` 可手动重同步。
+- **Channel 级选择**:`GET|PUT /api/workshop/channels/:id/tools`、`POST .../tools/reset`;
+  - `mode='all'`(默认):全部合格工具启用,只记录被取消勾选的工具(deny-list);
+  - `mode='selected'`:只启用勾选工具(allow-list),新工具默认不启用;
+  - 硬规则(角色 / Channel profile / 写守卫 / 插件总开关)优先,Channel 开关不能把被硬规则排除的工具打开;`selected` 模式显式启用这类工具返回 `409 TOOL_NOT_ELIGIBLE`。
+- **注入面同源**:omp 的 `set_host_tools`、pi 的 `AW_PI_TOOLS_FILE`、其余 harness 的 MCP `tools/list` 全部经 `hostToolsForRole`;执行面在 `dispatchHostTool` / `invokeHostTool` 再复核一次,引擎缓存旧列表也无法直调被停用工具。
+- **前端**:Channel 设置弹窗的「工具」区可搜索、按来源/状态过滤、全选/全不选/恢复默认;硬规则阻止的工具置灰并显示原因。
+
+### 安装本地插件
+
+```bash
+aw plugin install <source-dir> [--global|-g] [--name <name>] [--force|-f] [--no-enable]
+```
+
+安装只接受包含 `index.mjs` 的**本地目录**:拒绝符号链接与越界路径,目标必须是 project/user 作用域;`--force` 先备份旧目录。安装完成后重写 `plugins-state.json` 触发热重载,插件注册的工具会自动进入工具目录与 MCP 工具面。不做远程 URL/市场下载。
+
 ## 十一、完整示例
 
 ```js

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.66) —
+from the npm package version (the `version` field in `package.json`, currently 0.7.70) —
 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.66)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.7.70)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。

package/i18n/dicts/channelTools.json

@@ -0,0 +1,39 @@
+{
+  "channelTools.sectionTitle": "工具（本 Channel 独立选择）",
+  "channelTools.description": "硬规则排除的工具不能通过 Channel 开关打开；保存后按行生效，在跑 Agent 会刷新工具清单。",
+  "channelTools.refresh": "刷新",
+  "channelTools.modeAll": "全部可用工具（默认）",
+  "channelTools.modeSelected": "仅启用勾选的工具",
+  "channelTools.modeAllHint": "新安装的工具默认启用；取消勾选即停用。",
+  "channelTools.modeSelectedHint": "只有勾选的工具会注入 Agent；新工具默认不启用。",
+  "channelTools.stats": "共 {total} 个 · 生效 lead {lead} / worker {worker} · 本 Channel 停用 {disabled}",
+  "channelTools.searchPlaceholder": "搜索工具名 / 说明 / 插件",
+  "channelTools.sourceAll": "全部来源",
+  "channelTools.sourceBuiltin": "内置",
+  "channelTools.sourcePlugin": "插件",
+  "channelTools.filterAll": "全部状态",
+  "channelTools.filterEffective": "已生效",
+  "channelTools.filterDisabled": "本 Channel 停用",
+  "channelTools.filterBlocked": "硬规则阻止",
+  "channelTools.selectAll": "全选",
+  "channelTools.selectNone": "全不选",
+  "channelTools.dirty": "有未保存的工具选择",
+  "channelTools.coreWarning": "核心协作工具被停用，任务进度/完成回执可能无法回收。",
+  "channelTools.leadOnly": "仅 lead",
+  "channelTools.unavailable": "未注册",
+  "channelTools.noTools": "没有匹配的工具",
+  "channelTools.undo": "撤销",
+  "channelTools.resetConfirm": "清除本 Channel 的工具策略，恢复默认全部合格工具启用？",
+  "channelTools.reset": "恢复默认",
+  "channelTools.save": "保存工具选择",
+  "channelTools.saved": "工具选择已保存；在跑 Agent 将刷新工具清单",
+  "channelTools.resetDone": "已恢复默认（全部合格工具启用）",
+  "channelTools.resetFail": "工具策略重置失败",
+  "channelTools.saveFail": "工具选择保存失败",
+  "channelTools.loadFail": "工具列表加载失败",
+  "channelTools.reasonRole": "角色不允许",
+  "channelTools.reasonProfile": "Channel 档位不开放",
+  "channelTools.reasonWrite": "写守卫阻止",
+  "channelTools.reasonPlugin": "插件未启用",
+  "channelTools.reasonChannelPlugin": "本 Channel 关闭了插件"
+}

package/i18n/dicts/toolsPage.json

@@ -0,0 +1,34 @@
+{
+  "toolsPage.title": "工具管理",
+  "toolsPage.subtitle": "内置工具与插件注册工具的统一目录：来源、角色、可用性、参数 Schema，以及被哪些 Channel 停用。",
+  "toolsPage.refresh": "刷新",
+  "toolsPage.sync": "重新同步",
+  "toolsPage.total": "工具总数",
+  "toolsPage.builtin": "内置",
+  "toolsPage.plugin": "插件",
+  "toolsPage.available": "当前可用",
+  "toolsPage.disabledByChannels": "Channel 停用项",
+  "toolsPage.lastSync": "最后同步",
+  "toolsPage.search": "搜索工具名 / 说明 / 插件",
+  "toolsPage.sourceAll": "全部来源",
+  "toolsPage.sourceBuiltin": "内置",
+  "toolsPage.sourcePlugin": "插件",
+  "toolsPage.availableOnly": "仅显示可用",
+  "toolsPage.name": "工具",
+  "toolsPage.source": "来源",
+  "toolsPage.pluginCol": "插件",
+  "toolsPage.roles": "角色",
+  "toolsPage.availableCol": "可用",
+  "toolsPage.yes": "是",
+  "toolsPage.no": "否",
+  "toolsPage.channels": "停用 Channel",
+  "toolsPage.firstSeen": "首次发现",
+  "toolsPage.updated": "定义更新",
+  "toolsPage.parameters": "参数 Schema",
+  "toolsPage.disabledChannels": "停用该工具的 Channel",
+  "toolsPage.noDisabledChannels": "没有 Channel 停用该工具（或均使用默认全启用）。",
+  "toolsPage.loadFail": "工具目录加载失败",
+  "toolsPage.syncDone": "同步完成：共 {total} 个，插件 {plugin} 个，新增不可用 {unavailable} 个",
+  "toolsPage.syncFail": "工具目录同步失败",
+  "toolsPage.pluginAll": "全部插件"
+}