# @dotdance/dsh-skill-scope 中文文档 规范地址：https://npmcn.com/package/%40dotdance/dsh-skill-scope/ 版本：0\.4\.0 npm 元数据更新时间：2026-11-12T07:16:24.129Z 中文译文更新时间：2026-11-13T00:06:25.623Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dotdance/dsh-skill-scope 原文对照：https://npmcn.com/package/%40dotdance/dsh-skill-scope/?lang=original 项目主页：https://github.com/dotdance/dsh-skill-scope#readme 源码仓库：https://github.com/dotdance/dsh-skill-scope ## 关键信息（来自 npm 元数据） - 包体积（解压后）：331 kB，8 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：^22\.19\.0 \|\| \>=24\.0\.0 - 运行依赖：3 个 - peer 依赖：react ^18\.2\.0，@deepseek-ai/cordis 4\.0\.6-alpha\.1 \|\| 4\.1\.0，@deepseek-ai/dsh-agent \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-skill \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-tools \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-host-webserver \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-client-connection \>=0\.2\.2-rc\.1 \<0\.2\.3-0 - 首次发布：2026-10-16T03:05:13.267Z - 最新版本发布：2026-11-12T07:16:23.550Z - 近 30 天下载量：2773（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：10（近 12 个月 10 个） ## 中文简介 DeepSeek Harness的Skill和MCP能见度管理器:全局层设置了默认,每个工作空间可以双向覆盖任意名称,同时设置一个侧边栏面板和输入卡条目. ## 安装 ```sh npm install @dotdance/dsh-skill-scope ``` 也可以使用：`pnpm add @dotdance/dsh-skill-scope`、`yarn add @dotdance/dsh-skill-scope`、`bun add @dotdance/dsh-skill-scope` ## README # dsh-skill-scope: DSH Skill 与 MCP 管控面板 [![许可证：MIT](https://img.shields.io/badge/%E8%AE%B8%E5%8F%AF%E8%AF%81-MIT-blue.svg)](https://npmcn.com/package/%40dotdance/dsh-skill-scope/LICENSE) [![npm package](https://img.shields.io/npm/v/%40dotdance%2Fdsh-skill-scope.svg?label=npm%20package)](https://www.npmjs.com/package/@dotdance/dsh-skill-scope) [![npm 下载量](https://img.shields.io/npm/dt/%40dotdance%2Fdsh-skill-scope.svg?label=npm%20%E4%B8%8B%E8%BD%BD%E9%87%8F)](https://www.npmjs.com/package/@dotdance/dsh-skill-scope) [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/dotdance/dsh-skill-scope) [![DSH 0.2.2 系列](https://img.shields.io/badge/DSH-0.2.2%20%E7%B3%BB%E5%88%97-2563eb.svg)](https://npmcn.com/package/%40dotdance/dsh-skill-scope/#readme-%E5%AE%89%E8%A3%85) ![node](https://img.shields.io/badge/node-%5E22.19.0%20%7C%7C%20%3E%3D24-3c873a.svg) **给你的 Agent 减负：Skill 与 MCP 一键启停，让上下文只装这一轮真正要用的能力。关掉的 skill / MCP 不再进入模型上下文，更干净，更省 token。** [English](https://npmcn.com/package/%40dotdance/dsh-skill-scope/README.en.md) · **简体中文** * * * ## 安装 ```sh dsh plugin --profile web add @dotdance/dsh-skill-scope ``` `--profile web` 换成你自己的 profile 名即可。 ## 它解决什么问题 你在 DSH 里装得越多，Agent 每一轮要读的清单就越长。 - 用户级 Skill 目录里堆了 **N+ Skill**，其中能帮到当前这个任务的只有几个。 - 每个 MCP server 都会把它的**全部工具**塞进模型的工具表，哪怕这一轮一个都用不上。 - 写代码的工程和写文章的工作区，需要的 Skill 和 MCP **根本不是同一套**。 - 你想「这个项目就用这几个能力」，但官方没有给任何开关——Skill 装上就是全局可见。 后果不是"不好看"，而是实打实的成本： | 代价 | 说明 | | --- | --- | | **烧 Token** | Skill 目录与 MCP 工具表每一轮都要重新进上下文，装的越多，每一轮固定开销越大 | | **注意力被稀释** | 候选太多，模型更容易选错工具、漏掉真正相关的那个 | | **上下文不干净** | 无关能力混进提示词，结果更难预测，调试更难 | | **工程之间互相污染** | A 项目的专用能力，在 B 项目里也一直占着位置 | **dsh-skill-scope 就是为这件事做的**：把「模型能调用哪些 Skill 与 MCP」变成一组 看得见、点得动的开关，并按**全局**和**本工作区**两个粒度分别管理。 * * * ## 它能做什么 ### 1\. 全局面板——一次收掉所有工程都不需要的能力 点左侧栏的「**全局 Skills**」，打开一个原生主界面页面，列出**全局层**的全部 Skill 与 MCP server。 在这里关掉的名字**默认对所有工作区生效**；某个工程确实需要时，可以在本工程里单独把它打开（见下文第 3 条）。 ![两个入口：侧栏的 Global Skills 与输入框右侧的 Workspace Skills](https://npmcn.com/package/%40dotdance/dsh-skill-scope/assets/panel-global.png) 上图红圈标出两个入口：左侧栏的 **Global Skills**，和输入框右下角的 **Workspace Skills**。 - 顶部一排是**视图切换**（全部 / 已启用 / 已禁用）——它只筛列表，不改任何开关。 - 搜索框**同时筛 Skill 与 MCP 两段**，输入即过滤。 - 列表按来源分组折叠，长清单也能快速定位。 **官方 Skill 默认不列**：`@deepseek-ai` 官方包自带的 Skill（`cordis-*` 预设、`office-*` 等） 默认不出现在面板上，模型仍可自动调用它们。想看见、想关掉它们时，打开视图条右端的 「**显示官方 Skill**」开关：这些行会回到清单，与普通行一样可以逐项关闭。 这个开关是**单机级**的（存在 `$DSH_HOME/skill-scope/global.json`），全局与本工程两个面板 都展示它、值永远一致；在工作区面板里打开它，效果同样对所有工程生效。 ### 2\. 本工程面板——只给这一个项目留要用的能力 在**新会话**的输入框右下角点「**工作区 Skills**」，打开本工程弹层（浮动在当前界面之上）： ![本工程面板](https://npmcn.com/package/%40dotdance/dsh-skill-scope/assets/panel-project.png) 图中列表标题写明「只影响 default-workspace」，下半部分按来源分组：本例里 `.agents` 目录贡献 35 项。 - 列表与全局面板**同一份清单**：全局关掉的项也在里面（开关是关的），你可以直接在这里把它打开。 - 与全局设置不同的行带一个红色标记「**与全局不同**」，一眼看出这个工程动过什么。 - 视图条除「全部 / 已启用 / 已禁用」外多一个「**与全局不同**」：点它只剩本工程改过的项（清单长时好用）。 - 改动**只对本工程的新会话生效**，不影响别的项目。 ### 3\. 关键规则：全局给默认值，工程可以逐项改 ```text 磁盘上的全部 Skill 与 MCP │ ▼ ┌─────────────────────┐ │ 全局层（默认值） │ 关掉 = 默认任何工程都用不了 └─────────────────────┘ │ 逐项：跟随 / 打开 / 关闭 ▼ ┌─────────────────────┐ │ 工程层（可覆盖） │ 全局关的能打开，全局开的也能关掉 └─────────────────────┘ │ ▼ 这一轮模型真正看得见的集合 ``` 每一项在本工程里有三种状态。界面上只有开关一种动作，因为「跟随全局」用**不记这条**来表达： | 状态 | 含义 | 界面上怎么看出来 | | --- | --- | --- | | 跟随全局 | 本工程对这项没有主张 | 开关位置与全局一致，没有红标 | | 本工程打开 | 全局关着，这个工程要用 | 开关是开的 + 红标「与全局不同」 | | 本工程关闭 | 全局开着，这个工程不要 | 开关是关的 + 红标「与全局不同」 | 想改回「跟随全局」：把开关拨回全局的样子即可，红标消失，这条决定也随之删除。 ### 关掉 ≠ 删掉：手动调用永远还在 关掉一个 Skill 只把它的**模型自动调用**关掉。你仍然可以在会话里手敲 `/名字` 调用它。 * * * ## 常见问题 ### @dotdance/dsh-skill-scope 是什么？ DeepSeek Harness的Skill和MCP能见度管理器:全局层设置了默认,每个工作空间可以双向覆盖任意名称,同时设置一个侧边栏面板和输入卡条目\. ### 如何安装 @dotdance/dsh-skill-scope？ 在项目目录运行 npm install @dotdance/dsh-skill-scope，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）、@deepseek-ai/cordis（4\.0\.6-alpha\.1 \|\| 4\.1\.0）、@deepseek-ai/dsh-agent（\>=0\.2\.2-rc\.1 \<0\.2\.3-0）、@deepseek-ai/dsh-skill（\>=0\.2\.2-rc\.1 \<0\.2\.3-0）、@deepseek-ai/dsh-tools（\>=0\.2\.2-rc\.1 \<0\.2\.3-0）、@deepseek-ai/dsh-host-webserver（\>=0\.2\.2-rc\.1 \<0\.2\.3-0）、@deepseek-ai/dsh-client-connection（\>=0\.2\.2-rc\.1 \<0\.2\.3-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @dotdance/dsh-skill-scope 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dotdance\_\_dsh-skill-scope 是否存在。 ### @dotdance/dsh-skill-scope 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @dotdance/dsh-skill-scope 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js ^22\.19\.0 \|\| \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @dotdance/dsh-skill-scope 可以商用吗？ @dotdance/dsh-skill-scope 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @dotdance/dsh-skill-scope 的下载量有多少？ 根据 npm 官方下载统计，@dotdance/dsh-skill-scope 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,773 次，日均约 92 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dotdance/dsh-skill-scope 还在维护吗？ 最新版本 0\.4\.0 发布于 2026/11/12（1 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。