dsh-capability-menu

为 DeepSeek Harness 统一管理 Tools 和 Skills 的暴露水平（上下文占用大小）与执行方式

简体中文 · English

目录

• 能力总览
• 快速安装
• 暴露策略
• 配置文件

能力总览

• 为 DeepSeek Harness 的 tools（包括 MCP 工具和内置工具）与 skills 建立统一能力目录：ctx.capability。
• 提供常驻 / 按需 / 禁用三档策略，管理能力的暴露与调用。
• 按需能力只在需要时提供给 Agent，减少单次请求携带的工具定义，节省 token 和上下文。

能力模型

Capability 是本插件引入的上位概念：Tool / Skill 是不同类型的 capability。

模型获得两个元工具：

能力菜单

安装后，在「设置 / 通用设置」中打开「能力菜单」即可管理 Tools 和 Skills。

档位含义：常驻能力可直接使用；按需能力先通过 meta_search 查找，再通过 meta_invoke 使用；禁用能力不可用。点击后立即生效，停止操作约 1.5 秒后自动保存。

注册 MCP 服务器或 Skill 目录会修改配置文件。MCP 请求头等凭据保存在配置文件中，请妥善保管。

快速安装

前置：Node.js 与 dsh CLI（dsh plugin 内部会转发给 pnpm，不用单独装 pnpm）。

从 npm 安装（推荐）

单包同时提供服务端插件与前端「能力菜单」tab，装完即可在「设置 / 通用设置」下看到：

# 安装
dsh plugin --profile web add @daweifu/capability-menu

# 升级到 npm 的 latest 标签指向的版本（要显式带版本号，避免沿用已安装版本）
dsh plugin --profile web add "@daweifu/capability-menu@$(npm view @daweifu/capability-menu dist-tags.latest)"

# 若要安装 next 等预发布标签，请把 latest 换成对应标签名，例如：
# dsh plugin --profile web add "@daweifu/capability-menu@$(npm view @daweifu/capability-menu dist-tags.next)"

npm view ... dist-tags.latest 只会选择 npm 上已经发布并标记为 latest 的版本；如果 0.1.5 尚未发布或只挂在其他标签下，这条命令不会得到 0.1.5。发布新版本后再运行升级命令。

从源码安装

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

验证安装

cd "${DSH_HOME:-$HOME/.dsh}/profiles/web" && pnpm list @daweifu/capability-menu && dsh --profile web --dump-config | grep -m1 '== @daweifu/capability-menu'

卸载

dsh plugin --profile web remove @daweifu/capability-menu

暴露策略

所有能力（Tool 与 Skill）按 暴露程度（模型在上下文中看到什么）与 执行方式 分为三档：

Tools / Skills 三档暴露与执行对照

覆盖与保留：

• tool 档同时覆盖 mcp__ 编目工具与内置原生工具——原生工具统一以保留的 built-in server 归组，与 MCP 工具一样三档可管。请勿把真实 MCP server 命名为 built-in。
• meta_search/meta_invoke 是本插件的控制面：恒常驻、不可被禁用（在规则里禁用它们会在启动时报错）。run_code 是 Code Mode 保留传输层：不进目录、不在「能力菜单」出现，请勿为它配置三档规则。
• 不建议把高频核心工具设为按需：按需的内置工具会退出模型常驻视野，使用时需要 meta_search → meta_invoke 两跳调用。

配置文件

规则写在本插件 entry（capability-menu-policy）的 config 下，默认落在 home 层的 ~/.dsh/cordis.patch.yml（$DSH_HOME 优先），也可以由任一 profile 的 cordis.patch.yml 用一条按 id 定位的覆盖补丁改写（外层 - insert: / id / name 是 Cordis patch 的挂载样板，与规则无关）。手写和「能力菜单」里点选都可以：点选只改内存（所以响应快），停手约 1.5s 后再自动写回这个 entry——因为写这个文件会让 dsh 热重载本插件并重跑一次能力枚举，所以不能每次点击都写。

config:
  tools:
    resident: # 常驻
      - execute_cmd
      - get_session_context
      - search_kb
      - 'mcp__gongfeng__*'    # 通配：该 server 下全部常驻
    on-demand: # 按需
      - 'mcp__*'              # 通配兜底
      - 'server:km:*'         # 按 server 前缀批量按需
    disabled: # 禁用
      - 'mcp__secret__*'      # 禁用优先级最高，压过常驻
  skills:
    resident: # 常驻
      - debugging
      - coding
    on-demand: # 按需
      - legacy_skill          # 显式按需（未列出即默认常驻）
    disabled: # 禁用
      - forbidden_skill
  metaTools:
    - meta_search             # 恒常驻，不可被禁用
    - meta_invoke

全部配置项

这些配置项分别属于对应的插件 entry，通常都写在同一份 cordis.patch.yml 里，不需要为每项单独建配置文件。catalogFile 是插件自动生成、供模型检索的目录文件；skillsDir 是 Skill 存放目录。

规则优先级（从上到下命中即停；同档内精确规则优先于通配）：

规则优先级：精确规则优先于通配，跨档位也成立。例如，resident: ['mcp__gongfeng__*'] 下，为某个工具设置精确的 on-demand 规则仍会生效；若被其他规则覆盖，界面会提示「分类未生效」。

按需能力目录（catalogFile）

插件会把按需 Tool 和 Skill 写入 catalogFile 指定的 YAML 文件，供模型检索。默认路径为 ~/.dsh/capability-catalog.yaml，设为空字符串可关闭；没有按需能力时，模型不会收到目录提示。目录会在 Tool、Skill 或档位变化后自动更新。

Skill 需要先注册到 ctx.skills 才会出现在目录中。模型可以用 grep / read 搜索目录，或调用 meta_search 查找条目，再通过 meta_invoke 使用对应能力。每个条目包含 id 和 kind，Skill 的 id 使用其名称。

# ~/.dsh/capability-catalog.yaml（自动生成；仅含 On-demand 能力，
# Resident 已常驻、Disabled 不可发现，均不写入；列表以 `-` 每项一行的 block 序列写出）
capabilities:
  - id: mcp__km__search
    kind: tool
    name: mcp__km__search
    description: 搜索知识库
    server: km
  - id: legacy_skill
    kind: skill
    name: legacy_skill
    description: 处理旧工程的低频技能
    whenToUse: 处理旧工程时使用

如果模型侧的 bash / read 沙箱无法访问默认目录，请把 catalogFile 改到沙箱可见的位置。多个 DSH 实例默认共用该文件；需要隔离时，为每个实例设置不同路径。

License

本项目遵循 Apache License 2.0。