dsh-plugin-guide-zh:DeepSeek Harness 插件与技能中文说明

前言

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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye