capability-menu

<h1 align="center">dsh-capability-menu</h1>

<strong>统一管理 DeepSeek Harness 工具与技能，高效检索、按需调用，节省上下文</strong>

<strong>简体中文</strong> · <a href="./README.en.md">English</a>

目录

• 能力总览
  • 能力模型
  • 能力菜单
• 安装与卸载
  • 从 npm 安装（推荐）
  • 从源码安装
  • 验证安装
  • 卸载
• 策略与目录
  • 能力暴露规则
  • 按需检索目录

---

能力总览

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

能力模型

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

kind	对 Agent 提供	action	备注
tool	执行一个动作（MCP 工具或内置原生工具）	execute	由 ctx.tools 索引
skill	某类任务的方法/流程/知识	load	由 ctx.skills 索引

模型获得两个元工具：

工具	作用	对应 entry
meta_search	搜索当前会话可用的按需能力；列表返回匹配总数、已返回数及是否截断，详情返回说明和工具参数 schema	@daweifu/capability-menu/search
meta_invoke	统一执行面：Tool 真执行（走完整 ctx.tools 管线）+ Skill 加载；force: true 可重载已更新的 Skill	@daweifu/capability-menu/invoke

能力菜单

安装后，在「设置」导航中选择「能力菜单」，即可管理 Tools 和 Skills。

操作	用法
更改档位	点击能力旁的圆点；也可以点击顶部档位计数，批量切换该组能力
查找能力	使用页签下方的过滤框搜索名称或分组；支持正则表达式，不区分大小写
查看能力详情	点击 Tool 查看定义；点击 Skill 展开文件列表并预览文件，内容按 Markdown 渲染
注册能力	点击右上角「注册能力」，添加 MCP 服务器或 Skill 目录；Skill 支持本机目录或公开 GitHub 链接
编辑或移除	在 Tools 的服务器分组或 Skills 的技能项中点击「编辑」
查看规则和按需目录	点击页头右侧的「策略与目录」，查看生效规则及按需能力摘要；可在按需检索目录中调整描述上限
编辑检索描述	将 Tool 或 Skill 设为「按需」后，点击旁边的「检索描述」，在来源描述的简短版本上修改

备注：

• MCP 名称：分组内省略 mcp__服务器名__ 前缀；悬停可看全名，检索和调用仍用完整 ID。
• 注册位置：MCP 写入 patch 配置（自动创建缺失的文件和目录）；请求头等凭据也保存在其中，请妥善保管。Skill 在所选技能根目录创建链接或导入目录。
• GitHub Skill：支持公开仓库的默认分支根目录（含 SKILL.md）、指定分支根目录 .../tree/{branch} 或其下的技能目录 .../tree/{branch}/{skill-directory}；也支持本机目录。导入需在运行 dsh 的机器上安装 Git；插件会校验 SKILL.md，只复制所选目录。

安装与卸载

前置：Node.js 与 dsh CLI。从 npm 安装无需单独安装 pnpm；从源码安装需要 pnpm。

依赖范围接受 DSH 0.2.x 稳定版及 0.2.1-rc.3 起的同版本预发布版；当前验证版本为 0.2.1-rc.3。npm 暂无 DSH 0.2.0 稳定版可供实测。

从 npm 安装（推荐）

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

从源码安装

git clone https://github.com/PKUfudawei/dsh-capability-menu.git
cd dsh-capability-menu
pnpm install

dsh plugin --profile web add .

验证安装

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）按 暴露程度（模型在上下文中看到什么）与 执行方式 分为三档：

档位	能力	模型能看到什么	如何找到	如何使用
常驻	tool	工具定义始终随请求提供	无需查找	直接调用；运行时经过完整 ctx.tools 管线
	skill	名称和简介显示在 <available_skills> 中	无需查找	skill 工具按需加载正文
按需	tool	不随请求提供工具定义	用 meta_search 搜索候选项	按精确 ID 查看参数后，用 meta_invoke 调用
	skill	不显示在 <available_skills> 中	用 meta_search 搜索	用 meta_invoke 加载 SKILL.md
禁用	tool	不随请求提供工具定义	meta_search 中不可见	调用会被拒绝
	skill	不显示在 <available_skills> 中	meta_search 中不可见	加载会被拒绝

适用范围与例外：

…