前言¶
在 DeepSeek Harness（DSH）里跑智能体时，MCP 服务器和技能往往分散在 profile 的 patch、项目目录下的 SKILL.md，以及各处的 @deepseek-ai/dsh-mcp-client 配置里。改一个服务的启停、查工具是否连上、切换技能是「仅手动」还是「仅模型」，通常要手改 YAML 或 frontmatter，缺少一个和 IDE 设置页类似的集中入口。
dsh-mcp-skills-board 是社区插件，由 Storm-Starlight 维护，在 DSH Web 侧提供侧栏「MCP 与技能」和插件配置区，界面参考 Codex 的 MCP 设置：搜索、技能与 MCP 两个分页、状态灯、行级开关和可展开详情，并支持按表单添加 MCP 服务器。下面介绍它的定位、能力与安装用法。
这是什么¶
一句话：DeepSeek Harness 的 MCP 服务器与技能管理面板。
插件包名 dsh-mcp-skills-board，当前版本 0.1.0（见仓库 package.json），许可证 MIT。分类上属于工作流类插件；在 SkillHub 目录页 与 GitHub 仓库 均可查看说明与源码。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
入口与界面¶
装好后刷新一次 Web 页面即可，无需重启 DSH。常用入口有两处：
- 侧栏「MCP 与技能」。
- 插件 → 已安装插件 → dsh-mcp-skills-board，使用其中的配置区。
页面布局对标 Codex：搜索框、技能和 MCP 服务两个分页、每行状态灯与开关、可展开行详情；添加服务器表单字段对齐 [mcp_servers.*] 的常用项（命令、参数、环境变量、工作目录或 HTTP URL、请求头等）。
核心功能¶
技能¶
扫描 .dsh/skills、.agents/skills 以及可配置的自定义根目录，按来源目录分组展示，当前项目排在前面。每个技能可在四种策略间切换：启用、仅手动、仅模型、停用。
开关会改写对应 SKILL.md frontmatter 中的两个键；文件监视器会在后续步骤重新发布目录。Agent 预设自带的技能在「预设技能」区域只读列出，文件位于安装包内，页面不能改内容。
MCP 服务器¶
列出当前 profile 组合里所有 @deepseek-ai/dsh-mcp-client 行，显示状态灯、工具数量与工具名，每行一个启停开关。
添加与编辑支持：
- stdio：命令、参数、环境变量、工作目录；可设工具超时、创建后是否启用。
- Streamable HTTP：URL、请求头。
删除仅针对本面板添加的服务器，需两次确认；在别处声明的 MCP 行不会被本页改写定义，启停时只追加按 id 定向的 disabled: 覆盖。
MCP 相关改动写入 profile 的 patch 文件；当 profile 配置了 patchReload: live 时可就地生效，否则下次启动才生效，页面会提示。
与 Codex 设置的对应关系¶
若你熟悉 Codex，可按下表理解本插件落盘与 UI 的映射（细节见仓库 README）：
| Codex | 本插件 |
|---|---|
config.toml 的 [mcp_servers.*] |
mcp-skills.json 加生成的 patch 块 |
| Settings → MCP servers | MCP 服务分页 |
| Add server 表单 | 添加服务器表单 |
/mcp |
行状态灯、工具数、详情 |
enabled = false |
行开关，定义保留 |
[[skills.config]] enabled = false |
四态选择器，改写 frontmatter |
不支持 Codex 的 codex mcp login：DSH 的 MCP 客户端没有 OAuth；需要 OAuth 的服务器会被桥接拒绝，错误显示在行详情里。
安装与启用¶
DSH 版本需满足 peerDependencies：>= 0.2.0-rc.2 且 < 0.3.0，插件管理器会做兼容性检查。插件本身要求 Node >= 22.19。
在 desktop profile 下安装：
dsh plugin --profile desktop add dsh-mcp-skills-board
也可以在 DSH 界面「插件 → 添加插件」中填写包名 dsh-mcp-skills-board。
本地开发可使用 link 安装（路径换成你的绝对路径）：
dsh plugin --profile desktop add link:/absolute/path/to/dsh-mcp-skills-board
卸载：
dsh plugin --profile desktop remove dsh-mcp-skills-board
安装或卸载后刷新 Web 页面。插件以当前 dsh 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证，并知悉密钥与 env 可能写入本地配置（见下文「数据位置与限制」）。
典型用法¶
在面板里启停 MCP¶
- 打开侧栏「MCP 与技能」，切到 MCP 服务分页。
- 查看每行状态灯与工具数；展开详情可看工具名与错误信息。
- 用行开关启停服务；定义保留，停用时通过 patch 中的
disabled覆盖生效。
添加 stdio 型 MCP 服务器¶
- 在 MCP 分页使用「添加服务器」表单，选择 stdio 传输。
- 填写 command、args、env、工作目录等；按需设置
toolCallTimeoutMs与创建后启用。 - 保存后，服务器定义进入
mcp-skills.json，并由插件写入cordis.patch.yml中带围栏的管理块。
示例块结构（仓库 README 摘录，块外内容不会被插件改写）：
# >>> dsh-mcp-skills-board (managed — edit MCP servers from Settings → MCP & Skills)
- insert:
- id: "mcp-github"
name: "@deepseek-ai/dsh-mcp-client"
config:
serverName: "github"
transport: "stdio"
command: "npx"
args:
- "-y"
- "@modelcontextprotocol/server-github"
env:
GITHUB_TOKEN: "..."
toolCallTimeoutMs: 60000
failOnStartupError: false
disabled: false
# <<< dsh-mcp-skills-board
若不希望把 token 明文写在 patch 里，可在 shell 中导出环境变量，并将配置行改为引用 !!js process.env.X；页面会将其视为外部行，仅保留启停操作。
管理项目技能策略¶
- 在技能分页查看扫描结果（含自定义根与预设只读区）。
- 对单个技能选择启用 / 仅手动 / 仅模型 / 停用。
- 等待文件监视器重新发布目录后，智能体侧即可按新策略加载。
数据位置¶
$DSH_HOME/mcp-skills.json（默认~/.dsh/mcp-skills.json，权限0600）：本面板添加的服务器定义。$DSH_HOME/profiles/<profile>/cordis.patch.yml：插件维护的 fenced 块，插入或更新@deepseek-ai/dsh-mcp-client行。
适用场景与注意¶
适合谁： 经常在 DSH desktop Web 里调试 MCP 连通性、需要快速切换多目录技能策略、又希望 UI 接近 Codex MCP 设置页的开发者。
需要注意：
- 无 OAuth 登录；OAuth 类 MCP 不适用。
- 环境变量与 HTTP 请求头会明文写入 patch（文件权限
0600）；敏感信息优先用进程环境变量加外部行方式。 - 预设技能只读；删除仅影响本页添加的服务器。
- profile 未开启
patchReload: live时，MCP 改动需重启后生效。
结尾¶
dsh-mcp-skills-board 把 MCP 列表、添加表单和技能四态开关收进 DSH 侧栏与插件页，减少手改 patch 和 SKILL.md 的频率，并与 Codex 的 MCP 设置心智对齐。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
