DeepSeek Harness（DSH）支持插件化扩展，开发者通常会在 ~/.agents/skills 目录下存放自定义技能。当技能数量增多时，在聊天框手动输入 /skillname 并查看长描述会降低效率。DSH 插件 weilantianhai/dsh-command-skill-list 解决了这个问题，它通过聊天指令列出所有可用技能，并将描述自动精简翻译为系统语言。
这是一个 DSH 客户端插件。它通过 / 或 /sk 前缀命令，扫描 ~/.agents/skills 目录，将技能描述自动翻译为中文（≤24字）或英文（≤15词），并支持自定义注释。选中后直接调用技能。
核心功能¶
- 快捷触发：输入
/显示入口，输入/sk、/ski等任意前缀直接弹出完整技能列表。 - 自动翻译：描述自动精简为一句话摘要（中文 ≤ 24 字 / 英文 ≤ 15 词），优先复用 DSH 内置模型（零配置），支持自定义 DeepSeek API Key 作为备用。
- 自定义注释：在设置页为技能添加注释，菜单直接显示注释（跳过翻译）。
- 性能优化：翻译结果磁盘缓存，启动时预热，并行翻译，失败自动回退，不阻塞菜单。
- 即插即用：选中技能后自动插入
/skillname，由 DSH 内建机制加载。
安装¶
使用官方插件安装命令添加该插件：
dsh plugin --profile web add github:weilantianhai/dsh-command-skill-list
配置与使用¶
安装完成后，在 DSH 的设置页会出现「技能翻译」栏目：
- 翻译通道：默认使用 DSH 内置模型，无需配置。也可填入自定义 DeepSeek API Key 作为备用。
- 技能自定义注释：列出已安装技能，每行一个输入框。填写注释后菜单显示注释（灰字），留空则恢复自动翻译。
- 清空缓存：换语言或需强制重翻时使用。
配置文件¶
所有配置存于 ~/.dsh/plugins/command-skill-list/config.json（也可通过设置页修改）：
{
"deepseekApiKey": "sk-xxx",
"notes": {
"tdd": "测试驱动开发：红-绿-重构",
"code-review": "按仓库规范与需求规格双维度审查代码"
}
}
deepseekApiKey：备用翻译通道，也可通过环境变量DEEPSEEK_API_KEY设置。notes：技能名对应自定义注释，有注释的技能不再翻译。
环境依赖与注意事项¶
- 依赖项：依赖 DSH Web (
dsh web) 和 Node.js 18+（Host 端使用fetch）。 - 权限：插件以当前 DSH 进程权限运行，建议安装前检查源码与许可证（MIT）。
- 适用场景：适合拥有大量技能配置、需要快速切换或跨语言阅读技能描述的用户。
该插件通过缓存和并行翻译机制，解决了技能列表浏览与描述阅读的痛点。如需查看更多插件或获取源码，请访问 GitHub 或 社区目录。
