前言¶
在 DeepSeek Harness（DSH Desktop）里用技能，常见路径是输入 / 打开命令面板，从一长串条目里挑一个。列表里往往只有技能名和一段英文描述；技能一多，很难快速判断「这个技能具体做什么、当前对话该不该用」。
dsh-skill-pilot 是面向客户端（Composer 输入区）的 DSH 插件：在输入框一侧提供可搜索的中文技能面板，并在你打字时根据草稿内容给出最多三条推荐。下面介绍它的定位、能力、安装方式与使用要点。资料来源为插件 GitHub README 与 package.json（当前版本 1.1.5，MIT 许可证，维护者 ITxuezhe / 杨靖）。
这是什么¶
dsh-skill-pilot（npm 包名 dsh-skill-pilot）自称「技能领航员」：装好后，输入框左侧会出现带技能数量角标的「技能」入口；点开展开面板，或在输入框内输入时于上边框看到推荐条。
插件归属社区仓库 ITxuezhe/dsh-skill-pilot，在 SkillHub 等目录中归类为客户端插件。它不改变 DSH 的技能执行机制，只改善发现与插入 /技能名 的体验。
它解决什么问题¶
README 归纳了两点：
- 中文一句话说明：每个技能用一行中文用途展示，并按类别分组，支持搜索。
- 跟着草稿推荐：在输入框里打字，停顿约 260ms（防抖，兼顾中文输入法）后，输入区上边框浮出最多 3 个推荐技能；点选即将
/技能名插入输入框。
相对仅靠 / 面板浏览英文名与长英文描述，更适合中文环境下快速选型。
核心功能¶
以下能力均来自官方 README，安装前可自行对照源码核实。
技能面板¶
- 左侧分类栏：竖排分类（如代码开发、办公文档、图像设计、数据图表、论文科研、测试排查、版本发布、写作润色、检索抓取、集成接入、笔记知识库等），右侧为技能列表，两栏各自滚动。
- 中英混合搜索：技能名、中文说明、英文描述、分类均可作为检索条件。
- 重读：面板底部「重读」会重新扫描技能目录，新安装的技能可尽快出现在列表中。
输入即推荐¶
草稿停顿 260ms 后排序推荐，最多 3 条；可忽略推荐条，不会自动执行技能。
中文说明如何生成¶
README 写明：全部本地生成——中文说明由本地规则与技能文件中的中文原句合成，不联网、不调模型、不外传内容。
单条说明优先取各技能 SKILL.md frontmatter 的 description；若已含中文则直接采用，否则用内置关键词表合成一行中文类别提示。
技能扫描来源¶
按优先级扫描（同名技能先命中者胜）：
| 来源 | 路径 |
|---|---|
| DSH 用户技能 | $DSH_HOME/skills |
| Agent 技能 | ~/.agents/skills |
| CodeBuddy | ~/.codebuddy/skills |
| WorkBuddy | ~/.workbuddy/skills |
| Claude | ~/.claude/skills |
| 内置 / 插件 | DSH 技能服务注册的条目 |
技术结构（便于排查问题）¶
- host（
lib/index.js）：注册只读 HTTP 路由 GET /api/skill-pilot/index— 技能目录（30 秒缓存）GET /api/skill-pilot/rebuild— 强制重扫- client（
lib/client.js）：注入conversation.input.left插槽，渲染按钮、面板与推荐条。
基于 webServer 与 skills 核心服务；README 称纯 JS，无 onnxruntime、sharp 等需编译的原生依赖。package.json 要求 DSH 引擎 >=0.2.0-rc.2。
安装与启用¶
官方推荐命令如下（须与资料原文一致，勿自行拼接 GitHub 前缀）：
dsh plugin add dsh-skill-pilot
也可在 DSH 插件市场搜索 skill-pilot。安装后完全退出并重启 DeepSeek Harness，角标与面板才会稳定出现。
手动安装时，在 profile 目录（通常为 ~/.dsh/profiles/desktop）执行：
pnpm add -w --save-exact dsh-skill-pilot
并在该 profile 的 package.json 里把包名加入 dsh.profile.bundles 数组末尾，例如：
"bundles": [ "...", "dsh-skill-pilot" ]
典型用法¶
- 点输入框左侧「技能」→ 打开面板；未搜索时按类别分组，输入关键词后变为扁平结果。
- 点列表中任一行 → 自动向输入框插入
/技能名，继续补全你的问题即可。 - 直接在输入框打字 → 停顿后出现推荐条（最多 3 个），点一下同样插入
/技能名。 - 不需要某条推荐时忽略即可；插件不拦截输入，也不会自动触发技能执行。
适用场景与注意¶
适合谁：本机技能较多、经常靠 / 切换工作流的用户；希望用中文分类和搜索缩小范围，或希望在写长 prompt 时被轻量推荐引导到合适技能的场景。
权限与安全：插件以当前 DSH 进程权限运行，会读取本机技能目录与 SKILL.md 并通过本地 HTTP 提供目录接口。安装前建议阅读 仓库源码 与 MIT 许可证，确认符合你的合规要求。
生态说明：DSH 社区插件目录（如 SkillHub 上的 dsh-skill-pilot 页）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文不将其描述为官方应用商店。
结尾¶
dsh-skill-pilot 把「看懂技能」和「此刻该用哪个」拆成面板浏览与草稿推荐两条路径，并在本地完成中文说明与索引，适合作为 DSH Desktop Composer 的日常辅助。进一步细节与 Issue 见 GitHub：https://github.com/ITxuezhe/dsh-skill-pilot；目录页：https://www.skillhub.cn/plugins/ITxuezhe/dsh-skill-pilot。
