🈶 dsh-chinese-skill-patch

🌐 中文 · English

让 DeepSeek Harness 原生支持中文技能名：私家大厨 / 卡路里 / 作息管家 无需改英文，/私 即补全，/私家大厨 直达，skill({name:"私家大厨"}) 亦可。

为什么需要这个

DSH 内置 dsh-skill 对 SKILL.md 的 name 字段只认

const SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/

name: 私家大厨 会在发现阶段被 warn skipped，skill-catalog 永远 complete: false，中文技能永远加载不到，输入框 /私 不补全、 /私家大厨 强行回车也不触发、模型 skill({name:"私家大厨"}) 抛 invalid skill name。

本插件在不改 DSH 源码、不改你 SKILL.md 一个字符的前提下，用 ^[\p{L}0-9]+(?:-[\p{L}0-9]+)*$/u（Unicode 字母+数字+中划线）打通三处硬编码：dsh-skill 校验、dsh-skill-filesystem 扫描、dsh-tool-skill 手势/工具。卸载即回退。

一条命令安装

需要 DSH CLI：

npm install -g @deepseek-ai/dsh

装进你的 profile（web 为默认桌面 profile）：

dsh plugin --profile web add dsh-chinese-skill-patch

零配置：包内自带 cordis.patch.yml，dsh plugin add 自动写入 dsh.profile.bundles；dsh plugin remove dsh-chinese-skill-patch 干净卸载。重启 dsh web（或刷新页面）即生效。

源码注入（开发）：

git clone https://github.com/FeatherHunter/dsh-chinese-skill-patch
cd dsh-chinese-skill-patch && npm install && npm run build
dev_inject_plugin file:$(pwd)   # 或 dsh-super-injector 的 dev_inject_plugin

它为你修了什么

输入	修复前	修复后
/私	无补全	下拉出现 私家大厨（startsWith("私")）
/私家大厨 回车	无匹配，SKILL_GESTURE 仅 a-z0-9	命中 CN_GESTURE，agent/pre-step 注入 <skill_content>
skill({name:"私家大厨"})	invalid skill name	正常加载，content 返回

已处理 BOM（\uFEFF）导致的 --- 解析失败，兼容 description: > 折叠语法。

使用示例

在 D:\3DeepSeekHarness\agents\xiaoshan\.dsh\skills\私家大厨\SKILL.md（或任意 ~/.dsh/skills/私家大厨/SKILL.md）：

---
name: 私家大厨
description: 你的私家菜谱本。录菜、查菜、做菜、采购清单、烹饪历史一站管理。
whenToUse: 当用户说 私家大厨、录菜、做菜 时加载
---
# 私家大厨
...

目录名、中文 name、中文 description 完整保留。_chinese_skill_patch_list 工具可验证：

> 调用 _chinese_skill_patch_list
→ {count: 73, skills: [{name:"私家大厨", provider:"chinese-skill-patch"}]}

工作原理

• SkillRegistry 原型补丁：get/register/listLayerCandidates 换成 CN 校验，validateCandidateCN 对非法候选中仅 warn跳过 而非让整层失败。
• CN 感知 provider chinese-skill-patch：复刻 dsh-skill-filesystem 的 roots（findProjectRoot + ~/.dsh/skills + ~/.agents/skills）与 parseSkillFileCN（优先 yaml 库，失败回退手写，BOM 已处理），rank 与原 filesystem 一致。
• 手势/工具：agent/pre-step 新增 CN_GESTURE 分支（中文走新分支，英文走原分支）；全局注册 skill 工具的 CN 版，使模型侧亦可调用。
• 持久化：require.resolve 动态定位 dsh-skill/dsh-skill-filesystem/dsh-tool-skill 的 lib/index.js，字符串替换为 CN 正则，幂等保护（已含 /u 则跳过），重启后即便不注入亦生效（下次 DSH 升级被覆盖时插件会重打）。

设计取舍：不再硬编码 D:\3DeepSeekHarness\agents；需全局可见请显式 set DSH_AGENTS_DIR=D:\3DeepSeekHarness\agents 或插件配置 extraAgentsDir，否则按标准 cwd → projectRoot 发现（xiaoshan 会话内 /私 自然可见）。

配置

// cordis 插件配置（可选）
{
  extraAgentsDir: "D:\\3DeepSeekHarness\\agents" // 把该目录下所有 .dsh/skills 也视为 project
}

或环境变量 DSH_AGENTS_DIR、DSH_HOME、DSH_AGENTS_HOME。

常见问题

Q: 装了仍不补全？
_chinese_skill_patch_list 看 count 是否含中文；dsh web 是否已重启；SKILL.md 首行是否为 ---（无 BOM 外多余空行）；name 是否完全匹配目录内 SKILL.md 的 name。

Q: 别人装能用吗？
能。npm i dsh-chinese-skill-patch 后 dsh plugin add dsh-chinese-skill-patch，无本机硬编码，require.resolve 自动适配各机器 agent 路径。private 已去，files 白名单仅 lib + cordis.patch.yml。

Q: 卸载？
dsh plugin --profile web remove dsh-chinese-skill-patch 并重启；磁盘 lib/index.js 的 CN 正则会保留至下次 DSH 升级（不影响）。

开发

npm run typecheck  # tsc --noEmit
npm run build      # tsc → lib/

源码 src/index.ts（@ts-nocheck，含 SKILL_NAME 复刻校验与 provider/pre-step/skill 三补丁）。无 client 构建。

相关

• DSH 源码：@deepseek-ai/dsh-skill、@deepseek-ai/dsh-skill-filesystem、@deepseek-ai/dsh-tool-skill
• 上游：https://github.com/deepseek-ai/deepseek-harness
• 同作者：dsh-prompt（Prompt 工具箱）、dsh-opencode-palette（主题）

许可

MIT — 与 dsh-prompt 一致。允许商用，需保留版权。