🈶 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
当前最新版本：0.1.2（npm 徽章与更新日志同步）。
零配置：包内自带 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；最后一个常见原因：在安装插件/新增技能之前已打开的旧会话里，/ 菜单不会刷新（DSH Web 按会话缓存技能目录，这是 DSH 自身行为，对所有技能含英文名一致）——新开会话或刷新页面（连接重置会清缓存）即可。注意：对话侧技能目录（system-reminder / _chinese_skill_patch_list）每轮都会刷新，不受旧会话影响。
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 构建。
相关
更新日志
- 0.1.2（2026-08-22）：
#9 排查结论落地 — ① peerDependencies 范围修正（@deepseek-ai/dsh-tools 显式带 prerelease 分支，消除 rc 版本 ERESOLVE）；② README FAQ 补充「旧会话菜单不刷新（DSH 会话级技能目录缓存）」说明；③ 新增 scripts/test_rc2_dryrun.mjs 回归测试（钉住磁盘补丁配方 vs 官方 npm rc.2 源码）；④ 新增相关插件导流与 ISSUE 引导。
- 0.1.1（2026-08-20）：修复
#1 — 左斜杠中文技能双次注入（seq11/12 identical）。以原生持久化 CN_GESTURE 为单一来源，插件仅在原生未支持时兜底，并对 decision 已有注入幂等去重，兼容 inner/outer 双顺序；新增 session.jsonl 集成回归与 5 场景去重测试。
- 0.1.0：首发 — Unicode
[\p{L}0-9] 打通 dsh-skill/filesystem/tool-skill，BOM/> 兼容，_chinese_skill_patch_list 验证。
许可
MIT — 与 dsh-prompt 一致。允许商用，需保留版权。
反馈与联系
🐞 欢迎大家提交 ISSUE：遇到问题、有改进建议、想聊聊插件开发，都欢迎！
也可扫码通过飞书联系作者交流（提交 Issue 前建议先看常见问题）。
作者飞书二维码
相关插件（作者出品）
均已（或即将）收录于 awesome-dsh-plugin 官方策展，欢迎一键安装体验。
