前言¶
DeepSeek Harness(DSH)里,技能通常通过 SKILL.md 被发现和调用。如果 name 是中文,原链路可能无法完成校验、扫描、斜杠手势和模型侧工具调用。
dsh-chinese-skill-patch 是 FeatherHunter 维护的一个 DSH 插件。它用于让 私家大厨 / 卡路里 / 作息管家 这类中文技能名无需改成英文,即可在 /私 补全、/私家大厨 直达,以及 skill({name:"私家大厨"}) 调用中使用。
这是什么¶
这是一个 DSH 插件,面向已经使用中文 SKILL.md 的使用者。它解决的核心问题是:中文技能名无法被发现、无法通过 / 补全、无法被模型侧 skill() 调用。
按资料,它在不改 DSH 源码、不改 SKILL.md 一个字符的前提下工作,并打通三处链路:
1、dsh-skill 校验。
2、dsh-skill-filesystem 扫描。
3、dsh-tool-skill 手势/工具。
许可证为 MIT。资料说明允许商用,但需保留版权。
核心能力¶
下面列出本次资料中可确认的能力:
1、支持中文 SKILL.md 的 name 被发现和调用,无需改成英文或重命名。
2、支持 /私 补全 私家大厨。
3、支持 /私家大厨 直达并注入技能内容。
4、支持模型侧调用 skill({name:"私家大厨"})。
5、保留目录名、中文 name、中文 description。
6、处理 BOM 导致的 frontmatter 解析失败,并兼容 description: > 折叠语法。
7、提供 _chinese_skill_patch_list 工具,用于查看已加载技能列表和 count。
8、包内自带 cordis.patch.yml,安装后自动写入 dsh.profile.bundles。
资料给出的版本为 0.1.2。npm 包 files 白名单仅包含 lib 和 cordis.patch.yml。
安装与启用¶
先确认本机有 DSH CLI。若没有,先执行:
npm install -g @deepseek-ai/dsh
然后安装到 web profile:
dsh plugin --profile web add dsh-chinese-skill-patch
安装完成后,重启 dsh web 或刷新页面,使插件生效。
典型用法¶
先保留中文技能目录。用户级示例路径:
~/.dsh/skills/私家大厨/SKILL.md
项目级示例路径:
.dsh/skills/私家大厨/SKILL.md
SKILL.md 中保留中文 frontmatter 的 name:
---
name: 私家大厨
---
在 DSH 输入框中按下面步骤操作:
1、输入 /私,下拉列表中应出现 私家大厨。
2、输入 /私家大厨 并回车,命中 CN_GESTURE 分支并注入技能内容。
3、模型侧加载技能时可写:
skill({name:"私家大厨"})
如果不确定技能是否被加载,可以调用:
_chinese_skill_patch_list
该工具用于查看技能列表和 count。
配置与卸载¶
如果希望把指定目录下所有 .dsh/skills 也视为 project,可以使用可选配置 extraAgentsDir,或设置环境变量:
DSH_AGENTS_DIR
DSH_HOME
DSH_AGENTS_HOME
未设置时,按标准 cwd → projectRoot 发现。
卸载命令为:
dsh plugin --profile web remove dsh-chinese-skill-patch
卸载后重启。资料 FAQ 同时说明,磁盘 lib/index.js 的 CN 正则会保留至下次 DSH 升级。
适用场景与注意¶
适合以下情况:
1、已有中文技能目录,不想把目录名或 name 改成英文。
2、希望在 DSH Web 输入框中使用中文斜杠命令。
3、希望模型侧也能通过 skill({name:"私家大厨"}) 调用中文技能。
使用前注意:
1、插件以当前 dsh 进程权限运行,安装前应检查 GitHub 源码与许可证。
2、需要 DSH CLI;package.json 声明 peerDependencies:@deepseek-ai/dsh-tools 与 @deepseek-ai/cordis 的版本范围。
3、在安装或新增技能之前已打开的旧会话中,/ 菜单可能不会刷新,需要新开会话或刷新页面。
4、资料称无 client 构建。
链接¶
本次资料未提供目录页 URL。GitHub 仓库如下:
https://github.com/FeatherHunter/dsh-chinese-skill-patch