前言¶
DeepSeek Harness(DSH)把能力拆成插件和技能(skills)。设置页和输入框里会出现大量英文包名、dsh-plugin-xxx,以及类似 “Use when writing or changing a model-facing tool definition…” 的技能说明。对习惯中文界面或刚接触 DSH 的开发者来说,很难快速知道「装了什么、各自干什么、从哪里查看」。
下面介绍社区插件 dsh-plugin-guide-zh(维护者 xiaoxiangzima)。它不改动插件的启用状态,而是用中文清单和独立入口,把已装插件与技能讲清楚,并在需要时用当前默认模型补翻缺失词条,结果缓存在本地。
这是什么¶
dsh-plugin-guide-zh 是面向 DeepSeek Harness 的只读说明类插件:在设置里提供「中文说明」标签页,在输入框旁提供「技能」按钮。官方简介为:DeepSeek Harness 的插件与技能中文说明——中文列表、一键插入,模型自动翻译并本地缓存。分类上常归入「模型推理」相关生态条目;源码与问题跟踪在 GitHub 仓库 xiaoxiangzima/dsh-plugin-guide-zh,社区目录页见 SkillHub 条目。许可证为 MIT,package 版本为 1.0.0。
DSH 生态强调「一切皆插件」;SkillHub 等目录是独立社区站点,与 DeepSeek / 幻方无官方从属关系。安装任何 DSH 插件前,建议自行阅读源码与许可证——插件以当前 dsh 进程权限运行。
核心功能¶
中文说明页¶
路径:设置 → 插件 →「中文说明」。
列出当前已安装插件与技能的中文名称、作用说明,以及「在哪看」的指引。支持搜索与刷新。新安装的插件或技能在下次打开时会同步进列表。
技能按钮与一键插入¶
输入框左下角有 「技能」 按钮。点开为中文浮层;选择某条后点 「使用这个技能」,会在当前草稿末尾追加 /技能名(空格),不覆盖已有内容。这是插件除缓存写入外唯一的「写」操作——不会启用、停用或卸载任何插件。
自动翻译与本地缓存¶
没有手写中文词条的条目,会交给 当前默认模型 翻译一次,结果写入插件目录下的 .zh-cache.json。之后同一条目直接读缓存返回。翻译时仅发送 插件/技能的名称和描述,不发送会话内容或文件内容;插件本身不联网收集数据。删除 .zh-cache.json 并刷新页面会触发重新翻译。
一次最多补翻 30 条;若一次安装 40 个以上插件,剩余条目会在下次打开时继续处理。
安装与启用¶
从 GitHub 安装(README 说明尚未依赖 npm 发布也可使用):
dsh plugin add github:xiaoxiangzima/dsh-plugin-guide-zh
npm 发布后的等价命令:
dsh plugin add dsh-plugin-guide-zh
或在界面:设置 → 插件 →「已装管理」,填入上述 spec 之一,安装后刷新页面。
运行环境要求(见 package.json 与 README):
- DeepSeek Harness:
>=0.2.1-rc.3且<0.3.0(Web / 桌面 profile) - Node.js:
>=20
典型用法¶
| 位置 | 作用 |
|---|---|
| 设置 → 插件 →「中文说明」 | 插件 + 技能中文清单,可搜索、可刷新 |
| 输入框左下「技能」 | 中文浮层,点「使用这个技能」向草稿插入 /名字 |
典型流程可以是:先在「中文说明」里查清某个技能用途与查看位置;写提示词时在「技能」浮层里选中条目,让 Harness 按 /技能名 调用对应 skill,而无需死记英文 slug。
适用场景与已知限制¶
适合谁:长期在 DSH 里装多个社区插件、需要中文对照表的人;希望在输入框旁用中文选技能、而不是只靠英文 / 菜单的人。
关于 / 菜单:输入框里按 / 弹出的菜单 仍是英文。文案来自各技能自带的 SKILL.md(随 Harness 版本只读发布)。第三方插件无法安全地逐行替换该菜单,本插件因此提供等价的中文入口,而不是改写系统菜单。
数据与隐私:译文缓存在本地;敏感环境若不希望名称/描述发往模型,可在使用前评估默认模型配置,或避免触发补翻(保留/预置中文词条、不删缓存策略等按团队规范处理)。
结尾¶
dsh-plugin-guide-zh 解决的是「清单可读」和「技能可选用」两件事:中文说明页 + 技能浮层插入 /名字,缺词条时用默认模型翻译并本地缓存,且对插件管理保持只读。需要安装 spec、Issue 或完整说明时,以仓库 README 为准:
- 目录页:https://www.skillhub.cn/plugins/xiaoxiangzima/dsh-plugin-guide-zh
- GitHub:https://github.com/xiaoxiangzima/dsh-plugin-guide-zh