前言¶
在 DeepSeek Harness（DSH）里装 Skill 和 MCP 越多，Agent 每一轮要读进的清单就越长：用户级 Skill 目录里可能堆着大量条目，但真正帮到当前任务的只有几个；每个 MCP server 还会把全部工具塞进模型的工具表，哪怕这一轮一个都用不上。写代码的工程与写文章的工作区，往往也不是同一套能力组合。官方默认是「装上即全局可见」，没有按工程裁剪的开关。代价很实在——固定 Token 开销变大、候选工具过多时模型更容易选错、上下文被无关能力污染，工程之间还会互相占用位置。下面介绍社区插件 dsh-skill-scope（维护者 dotdance，npm 包 @dotdance/dsh-skill-scope），它把「模型能调用哪些 Skill 与 MCP」做成看得见、点得动的开关，并按全局与本工作区两个粒度分别管理。
这是什么¶
dsh-skill-scope 是 DSH 的 Web 客户端插件，定位是 Skill 与 MCP 的可见性与启停管理：全局面板设定默认哪些能力参与自动调用，单个工作区可以逐项覆盖。简介原文为「A Skill and MCP control panel for DSH」；在 SkillHub 目录中归类为客户端插件。许可证为 MIT，当前 npm 版本为 0.3.1（以仓库 package.json 为准）。
核心功能¶
全局面板：默认收掉所有工程都不需要的能力¶
侧栏点「全局 Skills」，打开原生主界面页面，列出全局层的全部 Skill 与 MCP server。在这里关掉的项默认对所有工作区生效；某个工程确实需要时，可在本工程面板里单独打开。
- 顶部为视图切换（全部 / 已启用 / 已禁用），只筛列表，不改开关。
- 搜索框同时过滤 Skill 与 MCP 两段。
- 列表按来源分组折叠。
官方 Skill 默认不列：@deepseek-ai 包自带的 Skill（如 cordis-* 预设、office-* 等）默认不出现在面板上，模型仍可自动调用。需要查看或关闭时，打开视图条右端的「显示官方 Skill」。该开关为单机级，配置写在 $DSH_HOME/skill-scope/global.json，全局面板与工作区面板共用同一值。
本工程面板：只给当前项目留要用的能力¶
在新会话输入框右下角点「工作区 Skills」，打开本工程弹层。
- 列表与全局面板同源：全局关掉的项也会出现（开关为关），可直接在本工程打开。
- 与全局设置不同的行带红色标记「与全局不同」。
- 视图条多一项「与全局不同」，便于在长清单里只看本工程改过的项。
- 改动只对本工程的新会话生效，不影响其他项目。
全局默认值与工程覆盖¶
逻辑可以概括为：磁盘上的全部 Skill 与 MCP → 全局层（默认值）→ 工程层（可逐项跟随 / 打开 / 关闭）→ 本轮模型真正可见的集合。
| 状态 | 含义 | 界面上如何识别 |
|---|---|---|
| 跟随全局 | 本工程对这项没有单独主张 | 开关与全局一致，无红标 |
| 本工程打开 | 全局关着，这个工程要用 | 开关开 + 红标 |
| 本工程关闭 | 全局开着，这个工程不要 | 开关关 + 红标 |
改回「跟随全局」：把开关拨回与全局一致，红标消失，该条覆盖记录删除。
关掉不等于删除¶
关闭某个 Skill 只关闭模型自动调用；会话里仍可手敲 /名字 手动调用。
安装与启用¶
宿主要求 DSH ≥0.2.0-rc.2 且 <0.3.0（更早版本不认 engines.dsh，会被判为不兼容）。Node 需满足 ^22.19.0 || >=24.0.0。
先做插件安装（--profile web 换成你实际使用的 profile 名）：
dsh plugin --profile web add @dotdance/dsh-skill-scope
安装完成后，在 Web 客户端侧栏与输入框右下角即可看到「全局 Skills」「工作区 Skills」入口。
典型用法¶
- 减负全局上下文：在「全局 Skills」里关掉长期不用、所有工程都不需要的 MCP 与 Skill，降低每轮固定 Token 与工具表体积。
- 按工程定制：在 A 工程的工作区面板打开仅 A 需要的 MCP；在 B 工程把全局已开但本工程不需要的项关掉，用红标与「与全局不同」视图核对差异。
- 调试官方 Skill：需要限制
cordis-*等官方 Skill 的自动暴露时，打开「显示官方 Skill」，再逐项关闭。 - 仍要临时用某 Skill：面板里关掉自动调用后，在对话里用
/技能名手动触发。
经过上面的步骤，新会话会按「全局默认 + 本工程覆盖」计算可见集合；改的是启停与可见性，不会从磁盘卸载 Skill 或 MCP 包本身。
适用场景与注意¶
适合已经在 DSH 里安装较多 Skill 或 MCP、希望按全局与工作区控制「自动进上下文」范围的开发者。不适合把插件当成 Skill/MCP 的安装器——它只管可见与启停，不负责 dsh plugin add 那类安装流程。
使用前请注意：
- 插件随当前 dsh 进程权限运行，安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
- DSH 版本需落在 README 声明的
0.2.x兼容区间内；大版本升级宿主时需重新核对engines.dsh。 - 「显示官方 Skill」等选项写入
$DSH_HOME/skill-scope/global.json，备份或迁移 DSH 环境时一并考虑。
结尾¶
dsh-skill-scope 用两个入口把 Skill 与 MCP 从「全量进上下文」改成「默认 + 工程覆盖」的可控集合，直接针对 Token、工具选择与上下文干净度这几类实际问题。目录与文档入口：
- SkillHub 插件页：https://www.skillhub.cn/plugins/dotdance/dsh-skill-scope
- GitHub：https://github.com/dotdance/dsh-skill-scope
社区目录 SkillHub 与 DeepSeek、幻方无官方从属关系；插件来自社区维护者 dotdance，按自身需求安装与审计即可。
