前言¶
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