前言¶
在 DeepSeek Harness(DSH)裏,技能和斜槓命令多以英文名稱出現在「/」菜單和「+」面板中。技能一多,靠英文名檢索和辨認成本高;命令與技能的默認順序也未必貼合個人習慣。社區裏也有用瀏覽器插件或改官方文件的做法,升級成本高、回滾麻煩。
dsh-cn-menu-kit 是一類純客戶端 DSH 插件:不改官方文件,通過注入客戶端 UI 實現中文標題、中文搜索、懸浮詳情,以及命令與技能的可拖拽排序。下面介紹它的定位、能力與安裝用法。
這是什麼¶
- 名稱:
dsh-cn-menu-kit(npm 包名同名) - 維護者:xiao-xiao-bai-ya(package.json 中作者爲「小小白」)
- 分類:客戶端(
dsh.client.platform爲web,通過cordis.patch.yml注入若干@deepseek-ai/dsh-client-ui-*模塊) - 版本:1.0.0(以倉庫
package.json爲準) - 許可證:MIT
插件自述爲「DeepSeek Harness 技能與命令的中文增強」:讓 / 菜單與「+」面板裏的技能帶上中文標題,支持中文搜索與懸浮詳情,命令與技能順序可自由拖拽,常用項可固定在上方。卸載後即恢復官方默認 UI。
核心功能¶
以下能力均來自項目 README 與 package.json 說明,安裝前可在 GitHub 倉庫 自行覈對源碼與許可。
- 技能中文列表:標題展示爲「中文標題(英文名)」;頂部搜索框支持中文即時過濾(例如輸入「面試」篩選相關技能)。
- 懸浮詳情:懸停技能行彈出完整簡介面板,適配深/淺色主題,README 稱不會遮擋菜單內容。
- 菜單內拖拽:懸停命令或技能行時出現 ⋮⋮ 把手,可在菜單內直接換位。
- 排序面板:「+」面板增加「技能排序」「命令排序」入口,結構鏡像菜單的添加/指令兩區,分區內拖拽。
- 順序持久化:順序保存在本機,重啓保留;「+」菜單與
/菜單共用同一份順序。 - 中文標題來源:在技能
SKILL.md的description中使用中文標題——描述約定(見下文);無此前綴時回退顯示英文名,不影響選用技能。
安裝與啓用¶
環境要求:DSH >= 0.2.2-rc.1(見 package.json 中 dsh.engines.dsh)。
任選一種方式安裝:
方式一:DSH Market(README 推薦)
在 DSH Market 中搜索 dsh-cn-menu-kit 安裝。
方式二:應用內插件頁
側邊欄打開 插件 → 安裝插件,輸入包名 dsh-cn-menu-kit,重啓 DSH。
方式三:命令行(Web profile)
dsh plugin --profile web add dsh-cn-menu-kit
README 註明:桌面端應在應用內插件頁安裝,桌面 profile 由應用託管。
插件在當前 DSH 進程對應的客戶端環境中運行(與官方 UI 同權限域)。安裝前建議閱讀倉庫源碼與 MIT 許可條款,確認是否符合你的安全策略。
典型用法¶
| 入口 | 操作 |
|---|---|
| 「+」→「技能」 | 中文技能彈層:搜索、懸停看詳情、點選插入引用 |
| 「+」→「技能排序」 / 「命令排序」 | 打開拖拽排序面板(分區內拖拽,即時保存) |
/ 菜單「技能(中文)」分組 |
同款中文列表,選中後插入 /英文名 引用 |
/ 菜單內懸停命令行 |
左側浮現 ⋮⋮ 把手,拖動換位 |
選中技能後,輸入框會出現 /英文名 引用;README 說明藍色表示已被系統識別,發送即加載技能。
讓技能顯示中文標題¶
在技能的 SKILL.md front matter 中,將 description 開頭寫成 中文標題—— 形式,插件取 —— 之前的內容作爲菜單中的中文標題:
---
name: agent-dev
description: Agent 開發方法論——構建 agent 系統的完整方法論:任務-模型匹配判定、五段式 pipeline 架構……
---
沒有該前綴的技能仍顯示英文名,功能不受影響。約定與 Agent Skills 生態中的常見寫法一致(README 鳴謝部分有說明)。
調試與已知限制¶
需要排查菜單加載或拖拽行爲時,可在瀏覽器 DevTools Console 執行:
localStorage.setItem('dsh-cn-skill-picker:debug', '1')
重啓 DSH 後可查看菜單檢測、目錄加載、拖拽事件等診斷日誌。
README 列出的限制包括:
- 菜單行由官方 React 組件渲染,拖拽後的順序依賴插件在渲染後恢復;官方大版本若改動菜單 DOM,可能需要插件適配。
- 添加/指令兩區的歸屬由官方固定名單決定,跨分區拖拽不生效(屬官方語義,非插件 bug)。
適用場景與注意¶
適合長期在 DSH Web 客戶端使用大量技能與斜槓命令、希望用中文檢索和自定義排序的開發者。不適合期望改服務端行爲或離線批處理技能清單的場景——本插件只增強客戶端菜單。
DSH 生態理念是「一切皆插件」;SkillHub 目錄頁 等爲社區站點,與 DeepSeek / 幻方無 README 中所述的官方從屬關係,安裝來源以 Market、應用內插件頁或上述命令行爲準。
結尾¶
dsh-cn-menu-kit 把中文可讀性、搜索與排序收斂到零侵入的客戶端插件裏,並與 SKILL.md 的 description 約定對齊,便於團隊統一技能命名習慣。進一步說明與截圖見 GitHub README,目錄索引見 SkillHub 插件頁。