@daweifu/capability-menu 0.1.0 → 0.1.1

package/README.md

@@ -1,45 +1,76 @@
 <h1 align="center">dsh-capability-menu</h1>
 
 <p align="center">
-  <strong>为 DeepSeek Harness 提供统一的能力发现与按需执行。</strong><br>
-  海量tools/skills也不会塞满一次请求, 节省token和上下文<br>
-  所有能力分为exposed/progressive/blocked三级管理暴露程度和执行方式
+  <strong>为 DeepSeek Harness 提供统一的能力菜单管理 Tools 和 Skills 的暴露水平 (上下文占用大小) 和执行方式</strong>
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@daweifu/capability-menu"><img src="https://img.shields.io/npm/v/@daweifu/capability-menu.svg?style=flat-square&color=cb3837&labelColor=161b22&logo=npm&logoColor=white" alt="npm version"/></a>
+  <a href="https://www.npmjs.com/package/@daweifu/capability-menu"><img src="https://img.shields.io/npm/v/@daweifu/capability-menu.svg?style=flat-square&color=0969DA&labelColor=161b22&logo=npm&logoColor=white" alt="npm version"/></a>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-2EA44F?style=flat-square&labelColor=161b22" alt="license"/></a>
   <a href="https://github.com/PKUfudawei/dsh-capability-menu"><img src="https://img.shields.io/github/stars/PKUfudawei/dsh-capability-menu.svg?style=flat-square&color=dbab09&labelColor=161b22&logo=github&logoColor=white" alt="GitHub stars"/></a>
-  <a href="https://github.com/koishijs/cordis"><img src="https://img.shields.io/badge/stack-Cordis%20bundle-58a6ff.svg?style=flat-square&labelColor=161b22&logo=cardano&logoColor=white" alt="Cordis bundle"/></a>
-  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/engine-DeepSeek%20Harness-7c8cff.svg?style=flat-square&labelColor=161b22&logo=deepseek&logoColor=white" alt="DeepSeek Harness"/></a>
+  <a href="https://github.com/cordiverse/cordis"><img src="https://img.shields.io/badge/stack-Cordis%20bundle-7FBDF1.svg?style=flat-square&labelColor=161b22&logo=cardano&logoColor=white" alt="Cordis bundle"/></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.1--rc.1-4D6BFE.svg?style=flat-square&labelColor=161b22&logo=deepseek&logoColor=white" alt="DeepSeek Harness 0.1.1-rc.1"/></a>
   <a href="https://github.com/PKUfudawei/dsh-capability-menu/actions"><img src="https://img.shields.io/github/actions/workflow/status/PKUfudawei/dsh-capability-menu/ci.yml?branch=master&label=CI&style=flat-square&labelColor=161b22&logo=github&logoColor=white" alt="CI"/></a>
 </p>
 
 <br/>
 
-dsh-capability-menu 是一个可独立安装的 Cordis 插件（`@daweifu/capability-menu`），为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供统一的能力目录（`ctx.meta`）、两个元工具（`meta_search` / `meta_invoke`）、以及 Exposed / Progressive / Blocked 三档能力策略（含 server 侧能力管理面）。它不修改上游源码，完全通过 Cordis 插件机制与 Harness 组合进同一个运行时。
+## 目录
+
+- [能力菜单](#能力菜单)
+- [快速安装](#快速安装)
+- [能力模型](#能力模型)
+- [暴露策略](#暴露策略)
+- [配置文件](#配置文件)
+
+---
+
+dsh-capability-menu 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的一个 Cordis 插件，为海量 MCP tools / skills 建立统一能力目录（`ctx.capability`），并以**常驻 / 按需 / 禁用**三档管理暴露程度和执行方式——随时调整 agent 的能力边界，避免海量 tools/skills 塞满一次请求、节省 token 和上下文：
+
+- **统一能力目录**：编目所有 MCP 工具与 Skill，模型经 `meta_search` 检索、`meta_invoke` 执行。
+- **三档能力策略**：常驻 = 高频能力随叫随到；按需 = 低频能力归档进目录、用到才翻出来；禁用 = 明确禁止。这是你配置的驻留策略，不是按使用次数自动统计的标签。
+- **可视化配置**：「能力菜单」设置 tab（MCP tools / Skills 两栏，分类可点击循环切换），调整即时生效。
+- **零侵入**：不改上游源码，经 Cordis 插件机制与 Harness 组合进同一运行时。
+
+## 能力菜单
+
+<p align="center">
+  <img src="assets/screenshot-mcp-tools.png" alt="MCP tools tab" width="45%"/>
+  <img src="assets/screenshot-skills.png" alt="Skills tab" width="45%"/>
+</p>
+
+安装后，「设置 / 通用设置」下出现「能力菜单」tab（位于「模型」与「插件」之间），用于可视化查看和调整暴露策略，改动即时生效、无需重启：
+
+- **两栏**：MCP 工具（按 server 分组、可折叠）与 Skills。
+- **三态圆点 + 统计**：每个能力带一个分类圆点（实心 = 常驻、半实心 = 按需、空心 = 禁用），栏顶部显示各档数量统计。
+- **点击循环切换**：点击能力旁的圆点或分类计数即可循环切换分类；MCP 工具还可以点击整行查看模型侧工具定义（name / description / parameters）。
+- **Skills 目录浏览**：展开某个 skill 可浏览其文件目录，点击文件预览 SKILL.md 等正文内容。
 
 ## 快速安装
 
-先构建并打包（源码仓库，`lib/` 需先产出）：
+前置：已安装 Node.js 与 dsh CLI（`dsh plugin` 内部会转发给 pnpm）。
 
-```bash
-cd dsh-capability-menu
-npm run build        # tsc 产出 lib/（registry/search/invoke/policy/invariant/index）
-pnpm pack            # 生成 daweifu-capability-menu-0.1.0.tgz
-```
+### 从 npm 安装（推荐）
 
-把 `.tgz` 交给对方安装：
+单包同时提供服务端插件与前端「能力菜单」tab，装完即可在「设置 / 通用设置」下看到：
 
-```bash
-dsh plugin --profile web add ./daweifu-capability-menu-0.1.0.tgz
+```sh
+dsh plugin --profile web add @daweifu/capability-menu
 ```
 
-> `dsh plugin add` 一个**目录**会以 `link:` 方式安装，`lib/` 需要已构建，本地自测请用 `.tgz`。
+### 从源码安装
+
+```sh
+git clone https://github.com/PKUfudawei/dsh-capability-menu.git
+cd dsh-capability-menu
+pnpm install                   # prepare 脚本自动构建 lib/（服务端）与 lib/client.js（前端）
+
+dsh plugin --profile web add ./dsh-capability-menu
+```
 
-验证（应看到本包自己的 patch 层）：
+### 验证安装
 
-```bash
+```sh
 dsh --profile web --dump-config | grep -E 'capability-menu'
 ```
 
@@ -53,25 +84,25 @@ dsh --profile web --dump-config | grep -E 'capability-menu'
   name: '@daweifu/capability-menu/invoke'
 - id: capability-menu-policy
   name: '@daweifu/capability-menu/policy'
+- id: capability-menu
+  name: '@daweifu/capability-menu'
 ```
 
-卸载：
+### 卸载
 
-```bash
+```sh
 dsh plugin --profile web remove @daweifu/capability-menu
 ```
 
 ## 能力模型
 
-Capability 是上位概念，Tool / Skill 是不同类型的 capability，不是「两种工具」：
+Capability 是本插件引入的上位概念：Tool / Skill 是不同类型的 capability。
 
 | kind | 对 Agent 提供 | action | 备注 |
 | --- | --- | --- | --- |
 | `tool` | 执行一个动作（MCP 工具） | `execute` | 由 `ctx.tools` 索引 |
 | `skill` | 某类任务的方法/流程/知识 | `load` | 由 `ctx.skills` 索引 |
 
-> `execute` / `load` 是 capability 对外声明的**规范 action**（`CapabilityAction = 'execute' | 'load'`）。tool 的 `execute` 在底层由 `ctx.tools.execute` 走完整工具管线执行；skill 的 `load` 加载方法/流程正文。当前版本（`0.1.0`）只有这两种 kind 与两种 action。
-
 模型获得两个元工具：
 
 | 工具 | 作用 | 对应 entry |
@@ -79,11 +110,7 @@ Capability 是上位概念，Tool / Skill 是不同类型的 capability，不是
 | `meta_search` | 检索能力目录（Tool / Skill），list/detail 双模式 | `@daweifu/capability-menu/search` |
 | `meta_invoke` | 统一执行面：Tool 真执行（走完整 `ctx.tools` 管线）+ Skill 加载 | `@daweifu/capability-menu/invoke` |
 
-> 边界：Command / Prompt / Memory 不是可发现可调用的能力，不进 registry。需要查知识/文档时直接用底层检索类 MCP 工具（如 `mcp__km__search`），它们和其他 MCP 工具一样被 `meta_search` 编目、被 `meta_invoke` 转发。
->
-> 边界：非 `mcp__` 前缀的原生工具（`bash` / `read` / `write` / `edit` / `read_image` / `glob` / `grep` 等）**不进 registry**——不被 `meta_search` 编目、不被 `meta_invoke` 派发、也不在能力管理（`classifyAll`）枚举中。它们只受投影链（`system-prompt/assemble` 对 `assembly.tools` 的裁剪）影响可见性；且因不可 `meta_invoke`，一旦被投影掉就真的不可调用，所以请保留在 `tools.exposed` 保活（见下方配置示例；默认即 Exposed，但若被 `progressive`/`blocked` 通配规则覆盖则不可调用）。
-
-## 核心：Exposed / Progressive / Blocked 三档能力策略
+## 暴露策略
 
 所有能力（Tool 与 Skill）按 **暴露程度**（模型在上下文中看到什么）与 **执行方式** 分为三档：
 
@@ -91,116 +118,55 @@ Capability 是上位概念，Tool / Skill 是不同类型的 capability，不是
 
 | 档位 | 能力 | 暴露方式（模型视野） | 发现 | 执行方式 |
 | --- | --- | --- | --- | --- |
-| **Exposed** | tool | 完整 schema 进 `assembly.tools` → 模型请求 `tools` payload，每步可见 | 无需发现（已常驻） | 模型直接调用，运行时走完整 `ctx.tools` 管线 |
+| **常驻** | tool | 完整 schema 进 `assembly.tools` → 模型请求 `tools` payload，每步可见 | 无需发现（已常驻） | 模型直接调用，运行时走完整 `ctx.tools` 管线 |
 | | skill | 名字+描述进 `<available_skills>` 目录（正文不在目录） | 无需发现（已常驻） | `skill` 工具按需加载正文（渐进加载） |
-| **Progressive** | tool | 不进 payload（零上下文成本） | `meta_search` list 返回 name+summary | `meta_invoke` 执行（走 `ctx.tools.execute`，管线完整）；或 detail 拿 schema 后直接调 |
+| **按需** | tool | 不进 payload（零上下文成本） | `meta_search` list 返回 name+summary | `meta_invoke` 执行（走 `ctx.tools.execute`，管线完整）；或 detail 拿 schema 后直接调 |
 | | skill | 不进 `<available_skills>` 目录 | `meta_search` 检索（`progressiveSkillCatalog` 条目） | `meta_invoke` 按 `path` 加载 SKILL.md 正文 |
-| **Blocked** | tool | 不进 payload | `meta_search` 不返回 | `meta_invoke` 拒绝，直接调用被投影排除 |
+| **禁用** | tool | 不进 payload | `meta_search` 不返回 | `meta_invoke` 拒绝，直接调用被投影排除 |
 | | skill | 不进目录 | `meta_search` 不返回 | `meta_invoke` 拒绝 |
 
-> **Exposed / Progressive 就是「高频 vs 低频」的具象化。** Exposed = 常驻、随叫随到的高频能力（拿 payload/目录体积换单跳可靠）；Progressive = 归档进目录、用到才翻出来的低频能力（省 token、按需取用）；Blocked = 明确禁止使用。它是**由你配置的驻留策略**（`tools.exposed`/`tools.progressive`/`tools.blocked` 规则），而不是按使用次数自动统计的标签。
->
-> 上表的 tool 档位均指 `mcp__` 编目工具；原生工具不参与三档管理，只能以 `tools.exposed` 保活可见性（见"能力模型"边界说明）。
+> 上表的 tool 档位均指 `mcp__` 编目工具；原生工具不参与三档管理，只能以 `tools.exposed` 保活可见性（见下方配置文件示例）。
+
+## 配置文件
 
-## 配置（在 `@daweifu/capability-menu/policy` 上）
+规则写在 profile 的 `cordis.patch.yml` 里 `capability-menu-policy` 插件 entry 的 `config` 下（外层 `- insert:` / `id` / `name` 是 Cordis patch 的挂载样板，与规则无关）：
 
 ```yaml
-- insert:
-    - id: capability-menu-policy
-      name: '@daweifu/capability-menu/policy'
-      config:
-        tools:
-          exposed:
-            - execute_cmd
-            - get_session_context
-            - search_kb
-            - 'mcp__gongfeng__*'   # 通配：该 server 下全部 Exposed
-          progressive:
-            - 'mcp__*'             # 该规则覆盖所有未显式列出的 MCP 工具
-            - 'server:km:*'        # 按 server 前缀批量 Progressive
-          blocked:
-            - 'mcp__secret__*'     # 明确禁用（优先级最高，压过 Exposed）
-        skills:
-          exposed:
-            - debugging
-            - coding
-          progressive:
-            - legacy_skill         # 显式 Progressive（未列出即默认 Exposed）
-          blocked:
-            - forbidden_skill
-        metaTools:
-          - meta_search            # 恒 Exposed，不可被 Blocked
-          - meta_invoke
-        progressiveSkillCatalog: ~/.dsh/progressive-skills.yaml  # Progressive skill 的 name+description+path 目录
+config:
+  tools:
+    exposed: [execute_cmd, get_session_context, search_kb, 'mcp__gongfeng__*']   # 通配：该 server 下全部常驻
+    progressive: ['mcp__*', 'server:km:*']                                        # 通配兜底 + 按 server 前缀批量按需
+    blocked: ['mcp__secret__*']                                                   # 禁用优先级最高，压过常驻
+  skills:
+    exposed: [debugging, coding]
+    progressive: [legacy_skill]          # 显式按需（未列出即默认常驻）
+    blocked: [forbidden_skill]
+  metaTools: [meta_search, meta_invoke]  # 恒常驻，不可被禁用
+  progressiveSkillCatalog: ~/.dsh/progressive-skills.yaml
 ```
 
-**规则优先级**（命中即停）：`blocked` 精确 > `blocked` 通配 > `exposed` 精确 > `exposed` 通配 > `progressive` 精确 > `progressive` 通配 > 默认 Exposed。**blocked 压过 exposed**（控制语义）。meta 工具（`meta_search`/`meta_invoke`）恒为 Exposed，出现在 `blocked` 里会 fail loud。
-
-> `tools.exposed` 里列原生工具名（`execute_cmd` 等）是**保活**语义：原生工具不进能力管理编目（`classifyAll` 列表里看不到它们），但投影链会裁剪其可见性，列在这里保持模型直接可见可调。不要因为"它不在能力管理里"就把它从 exposed 移除——一旦被 `progressive`/`blocked` 规则覆盖，模型既看不到也调不到。
-
-### 默认（不配置 policy）
-
-- 不挂 `capability-menu-policy` → 全部工具/技能照旧可见（不投影）。
-- 挂了 policy 但没有任何规则 → 全部能力默认 Exposed（`classify` 兜底），不投影、不隐藏。需要把低频能力归档进目录时，显式配置 `progressive`（或 `blocked`）规则把它们从模型视野中移出。
-
-### Progressive skill
-
-Progressive skill 的 name + description + path 汇总进独立 YAML（`progressiveSkillCatalog`），由 registry 索引、`meta_search` 检索；完整 SKILL.md 由 `meta_invoke` 按需加载（`ctx.skills` 未注册时按 YAML 的 `path` 读取）。Progressive skill 不进固定上下文。
-
-> 关于 `<available_skills>`：Exposed skill 走渐进加载（名字表 → load）；Progressive/Blocked skill 不进入 `dsh-tool-skill` 注入的目录。目录级裁剪需要上游 `dsh-tool-skill` 提供 filter 钩子（超出本 bundle 范围）；当前 Exposed skill = 会话 registry 中所有 model-invocable skill，Progressive skill = `progressiveSkillCatalog` 条目。
-
-## 机制设计
-
-**核心第一性原则**：模型可见性（投影）与能力注册（registry 索引 + 执行能力）**必须解耦**。`ctx.tools.restrict` 会把工具从 `view.visible` 移除、连 `execute` 一起挡住（`UNKNOWN_TOOL`），因此本策略**不用 restrict 隐藏 Progressive**，而是在投影链 `system-prompt/assemble` 裁剪 `assembly.tools`，让 Progressive 工具保持全局注册、可检索、可执行。
-
-Progressive 的**发现层（catalog）与执行层（`ctx.tools` 管线）分离**：catalog 只存元数据（name + description），完整 schema 从 `ctx.tools` 实时解析；无论哪一档，工具执行都落在 `ctx.tools` 管线上——审批/guard/沙箱/会话日志/取消齐全，不绕过。skill 无"执行"，只有正文加载。Blocked 能力保留在 catalog 中（供管理面展示），但 `meta_search` 不返回、`meta_invoke` 拒绝。
-
-## 能力管理（server 侧 `ctx.capabilityPolicy`）
+**规则优先级**（命中即停，同级内精确匹配先于通配）：`blocked` > `exposed` > `progressive`，未命中任何规则默认 Exposed；`blocked` 是最硬的控制（压过 `exposed`），meta 工具（`meta_search`/`meta_invoke`）恒为 Exposed 且不可被 blocked。`tools.exposed` 里列原生工具名（`execute_cmd` 等）是**保活**：原生工具不进能力编目、只受投影链裁剪可见性，列在这里保持模型可见可调——一旦被 progressive/blocked 覆盖，模型就看不到也调不到。
 
-> 后端能力管理面，前端「能力菜单」tab 正是消费它。前端 React 包 `@daweifu/capability-menu-web`（本仓库 `web/`）的浏览器 bundle 与 host Typert 网关由 `web/` 的构建产出（见 `web/README.md`）；`capabilityPolicy/*` remote 由网关托管，浏览器端 `ctx.remote.capabilityPolicy` 消费。
+> 「能力菜单」tab 的改动只写入运行时内存、不落盘；要持久化（随 profile 生效、可版本管理/批量声明），编辑 profile 的 `cordis.patch.yml` 即可——这就是持久化入口，无需额外的导入/导出按钮。
 
-`@daweifu/capability-menu/policy` 注册 `ctx.capabilityPolicy` 服务，同时支撑运行期投影与前端管理：
+### 渐进技能目录（`progressiveSkillCatalog`）
 
-| 方法 | 用途 |
-| --- | --- |
-| `getConfig()` / `updateConfig(partial)` | 读取/热更新策略配置（`tools`/`skills`/`metaTools` 等），改动立即重编译规则、无需重启。 |
-| `classifyAll()` | 枚举 `ctx.meta` 目录中每个能力及其当前分类，返回 `{ id, kind, name, server?, class: 'exposed'\|'progressive'\|'blocked', classLabel, mandatory }`；`classLabel` 为「Exposed · 常驻（直接调用）/ Progressive · 按需（目录渐进加载）/ Blocked · 禁用」，供前端只读分类列表展示。 |
-| `classifyTool`/`classifySkill`/`classifyCapability` | 单个能力的分类判定。 |
-| `isExposedTool`/`isExposedSkill`/`isBlockedCapability`/`metaTools`/`toolRules`/`skillRules` | 投影链与执行面消费的判定与规则视图。 |
+按需（Progressive）技能不进固定上下文，也可能根本没注册进 `ctx.skills`。为了让它们仍可被发现，用一份独立 YAML 存 name + description + path，由 registry 索引、`meta_search` 检索；完整 SKILL.md 由 `meta_invoke` 按需加载（`ctx.skills` 未注册时按 YAML 的 `path` 读取）：
 
-这些方法全部是纯 server 方法（可单测），前端通过 harness 的 remote/RPC 层调用。
-
-## 仓库结构
-
-```
-dsh-capability-menu/           # 单包 = @daweifu/capability-menu
-├── package.json               # exports 子路径 + dsh.bundle → ./cordis.patch.yml
-├── cordis.patch.yml           # insert registry/search/invoke/policy 四个子路径 entry
-├── tsconfig.json / vitest.config.ts
-├── src/
-│   ├── registry.ts            # （P0）能力目录 + ctx.meta 服务（不注册工具）
-│   ├── search.ts              # （P1）注册 meta_search
-│   ├── invoke.ts              # （P2）注册 meta_invoke
-│   ├── policy.ts              # （P3）Exposed/Progressive/Blocked 投影策略 + ctx.capabilityPolicy 能力管理
-│   ├── invariant.ts
-│   └── index.ts               # re-export 全部
-├── tests/                     # registry / search / invoke / policy 四套用例
-└── web/                       # 前端「能力菜单」tab（client bundle + host Typert 网关，见 web/README.md）
+```yaml
+# ~/.dsh/progressive-skills.yaml
+skills:
+  - name: legacy_skill            # 对应 skills.progressive 里的规则名
+    description: 旧版迁移技能，低频使用
+    whenToUse: 处理旧工程时使用
+    path: /path/to/legacy_skill   # 含 SKILL.md 的目录
 ```
 
-## 开发
-
-- `src/` 为 TypeScript 源码，`lib/` 为预构建产物（`npm run build` 产出，本仓库直接分发 `lib/`）。`package.json` 的 `exports` 声明 `/registry` `/search` `/invoke` `/policy` `/invariant` 五个子路径，`cordis.patch.yml` 挂载前四个为 entry。
-- `@deepseek-ai/*` 依赖为 peer 依赖（运行时从 dsh 安装闭包解析）；`@deepseek-ai/schemastery` 与 `js-yaml` 为运行时依赖（后者解析 `progressiveSkillCatalog`）。
-- 安装时自动构建：本包 `prepare` 脚本会在支持 lifecycle 的安装路径（git / 打包安装）下自动执行 `npm run build` 产出 `lib/`；前端包 `web/` 的 `prepare` 同样自动执行 `npm run bundle` 产出客户端 bundle（需 dsh-client 环境）。
-- 测试：`pnpm install && npx vitest run`（33 个用例，覆盖 registry / search / invoke / policy，含能力管理面用例）。
-
-## 环境前置
+### 默认（不配置 policy）
 
-- 已安装 dsh CLI 和 pnpm（`dsh plugin` 内部会转发给 pnpm）。
+- 不挂 `capability-menu-policy` → 全部工具/技能照旧可见（不投影）。
+- 挂了 policy 但没有任何规则 → 全部能力默认 Exposed（`classify` 兜底），不投影、不隐藏。需要把低频能力归档进目录时，显式配置 `progressive`（或 `blocked`）规则把它们从模型视野中移出。
 
 ## License
 
 本项目遵循 [Apache License 2.0](LICENSE)。
-
-> 一个可独立安装的 Cordis 插件，为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供能力发现、按需执行与 Exposed/Progressive/Blocked 投影策略。核心的智能体、模型、工具、会话、Web UI 与插件生态都来自上游项目。

package/cordis.patch.yml

@@ -1,9 +1,11 @@
 # dsh-capability-menu aggregate bundle patch: mounts the meta plugins in one
 # layer, from a single installable package.
 #
-# One package, four plugin entries — each mounts a subpath of
+# One package, five plugin entries — four mount a subpath of
 # `@daweifu/capability-menu` (the loader resolves package subpath exports; see
-# `@deepseek-ai/dsh-web-app/startup` for the same pattern in the harness):
+# `@deepseek-ai/dsh-web-app/startup` for the same pattern in the harness), and
+# the root entry loads the package main to mount the browser-facing gateway
+# (and thereby registers the package itself as a `dsh.client` loader entry):
 #
 #   - id: capability-menu-registry
 #     name: '@daweifu/capability-menu/registry'
@@ -34,7 +36,7 @@
 #         progressiveSkillCatalog: ~/.dsh/progressive-skills.yaml
 #
 # - `capability-menu-registry` (P0): builds/indexes the capability catalog and
-#   exposes the `ctx.meta` service (search/get/getDetail/refresh). It registers
+#   exposes the `ctx.capability` service (search/get/getDetail/refresh). It registers
 #   no model-facing tool itself. Indexes the GLOBAL registry (no visibility
 #   filter) and additionally indexes Progressive skills from
 #   `progressiveSkillCatalog` (§7.2).
@@ -85,3 +87,9 @@
             - read_image
             - glob
             - grep
+    # Root entry: loads the package main, which mounts the Typert gateway that
+    # exposes ctx.capabilityPolicy to the browser. Makes this package a loader
+    # entry itself so @deepseek-ai/dsh-client-modules discovers its `dsh.client`
+    # declaration and serves the 能力菜单 browser bundle (`./client`).
+    - id: capability-menu
+      name: '@daweifu/capability-menu'

package/lib/client.d.ts

@@ -0,0 +1,156 @@
+window.__ModuleLoader__.load({ id: "@daweifu/capability-menu", factory: (require) => {
+var module = { exports: {} };
+var exports = module.exports;
+
+import { ClientContext } from "@deepseek-ai/dsh-client-runtime/client";
+//#region src/client/store.d.ts
+/**
+ * ⚠️ VERIFIED AGAINST REAL rc.8 CLIENT API.
+ *
+ * Types + small helpers for the 能力菜单 (Capability Menu) settings
+ * section. The component reads/writes the Host `ctx.capabilityPolicy` through
+ * the generated `remote.capabilityPolicy` face (see `./remote.ts`), mirroring
+ * how `dsh-client-ui-settings-plugin-inventory` consumes
+ * `ctx.remote.pluginInventory`.
+ */
+/** One capability's Exposed/Progressive/Blocked row, as surfaced by the server. */
+interface CapabilityRow {
+  readonly id: string;
+  readonly kind: 'tool' | 'skill';
+  readonly name: string;
+  readonly server?: string;
+  readonly class: 'exposed' | 'progressive' | 'blocked';
+  /** Human-friendly display: `Exposed · 常驻（直接调用）` / `Progressive · 按需（目录渐进加载）` / `Blocked · 禁用`. */
+  readonly classLabel?: string;
+  readonly mandatory: boolean;
+}
+/** Snapshot of the management surface. */
+interface CapabilitySnapshot {
+  readonly rows: readonly CapabilityRow[];
+}
+/** One direct child in a skill directory listing. */
+interface SkillFileEntry {
+  readonly name: string;
+  readonly type: 'file' | 'directory';
+}
+/** Full detail projection of one capability (schema, description, stats). */
+interface ToolDetail {
+  readonly id: string;
+  readonly kind: 'tool' | 'skill';
+  readonly actions: readonly string[];
+  readonly name: string;
+  readonly description: string;
+  readonly whenToUse?: string;
+  readonly parameters: Record<string, unknown>;
+  readonly output?: Record<string, unknown>;
+  readonly origin: {
+    readonly provider: string;
+    readonly serverName?: string;
+    readonly path?: string;
+  };
+  readonly tags: readonly string[];
+  readonly stats: {
+    readonly uses: number;
+    readonly successes: number;
+    readonly failures: number;
+    readonly totalMs: number;
+    readonly lastUsedAt?: number;
+  };
+}
+/** The Host `capabilityPolicy` remote face (generated contribution). */
+interface CapabilityPolicyRemote {
+  getConfig(): Promise<{
+    ok: true;
+    value: Record<string, unknown>;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  updateConfig(partial: Record<string, unknown>): Promise<{
+    ok: true;
+    value: void;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  classifyAll(): Promise<{
+    ok: true;
+    value: CapabilityRow[];
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  listSkillDir(id: string, relPath?: string): Promise<{
+    ok: true;
+    value: SkillFileEntry[] | undefined;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  readSkillFile(id: string, relPath: string): Promise<{
+    ok: true;
+    value: string | undefined;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  getDetail(id: string): Promise<{
+    ok: true;
+    value: ToolDetail | undefined;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+}
+//#endregion
+//#region src/client/CapabilitySection.d.ts
+/** Props injected by the settings.section registration (see index.ts). */
+interface CapabilitySectionInjected {
+  remote: CapabilityPolicyRemote;
+  t(key: CapabilityKey, params?: Record<string, unknown>): string;
+  /** Diagnostic: `$mount` failure surfaced instead of crashing the section. */
+  mountError?: string;
+  /** Diagnostic: namespace methods actually installed on `ctx.remote.capabilityPolicy`. */
+  remoteKeys?: string;
+}
+type CapabilitySectionProps = CapabilitySectionInjected;
+type CapabilityKey = 'nav' | 'title' | 'desc' | 'exposed' | 'progressive' | 'blocked' | 'kind' | 'class' | 'tool' | 'skill' | 'mandatory' | 'rules' | 'toolsGroup' | 'skillsGroup' | 'emptyTools' | 'emptySkills' | 'toolCount' | 'exposedShort' | 'progressiveShort' | 'blockedShort' | 'cycleHint' | 'notPreviewable' | 'previewClose' | 'detailNotFound';
+//#endregion
+//#region src/client/index.d.ts
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** 能力菜单 tab copy. */
+    'settings.capability': Record<CapabilityKey, string>;
+  }
+}
+/** Required services (cordis fiber inject). `remote.capabilityPolicy` is NOT
+ *  injected: we mount it in `apply`, so declaring it would deadlock the boot
+ *  ("waiting for service"). Access it via `ctx.get('remote.capabilityPolicy')`,
+ *  which resolves the mounted namespace service without the inject gate. */
+declare const inject: string[];
+/** Register the 能力菜单 section once `settings.section` is on the ledger. */
+declare function apply(ctx: ClientContext): Promise<() => void>;
+//#endregion
+export { type CapabilityKey, type CapabilityPolicyRemote, type CapabilityRow, type CapabilitySectionInjected, type CapabilitySectionProps, type CapabilitySnapshot, apply, inject };
+
+return module.exports;
+}});
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client/store.ts","../src/client/CapabilitySection.tsx","../src/client/index.ts"],"mappings":";;;;;;;;;;;;;;;;UAWiB;WACN;WACA;WACA;WACA;WACA;;WAEA;WACA;;;UAIM;WACN,eAAe;;;UAIT;WACN;WACA;;;UAIM;WACN;WACA;WACA;WACA;WACA;WACA;WACA,YAAY;WACZ,SAAS;WACT;aAAmB;aAA2B;aAA8B;;WAC5E;WACA;aACE;aACA;aACA;aACA;aACA;;;;UAKI;EACf,aAAa;IAAU;IAAU,OAAO;;IAA8B;IAAW;MAAS;MAAc;;;EACxG,aAAa,SAAS,0BAA0B;IAAU;IAAU;;IAAkB;IAAW;MAAS;MAAc;;;EACxH,eAAe;IAAU;IAAU,OAAO;;IAAsB;IAAW;MAAS;MAAc;;;EAClG,aAAa,YAAY,mBAAmB;IAAU;IAAU,OAAO;;IAAmC;IAAW;MAAS;MAAc;;;EAC5I,cAAc,YAAY,kBAAkB;IAAU;IAAU;;IAAgC;IAAW;MAAS;MAAc;;;EAClI,UAAU,aAAa;IAAU;IAAU,OAAO;;IAA6B;IAAW;MAAS;MAAc;;;;;;;UCtClG;EACf,QAAQ;EACR,EAAE,KAAK,eAAe,SAAS;;EAE/B;;EAEA;;KAGU,yBAAyB;KAEzB;;;;YCVA;;IAER,uBAAuB,OAAO;;;;;;;cAQrB;;iBAGS,MAAM,KAAK,gBAAgB"}