dsh-cn-menu-kit:DSH 技能與命令的中文菜單增強

前言

在 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 倉庫 自行覈對源碼與許可。

  1. 技能中文列表:標題展示爲「中文標題(英文名)」;頂部搜索框支持中文即時過濾(例如輸入「面試」篩選相關技能)。
  2. 懸浮詳情:懸停技能行彈出完整簡介面板,適配深/淺色主題,README 稱不會遮擋菜單內容。
  3. 菜單內拖拽:懸停命令或技能行時出現 ⋮⋮ 把手,可在菜單內直接換位。
  4. 排序面板:「+」面板增加「技能排序」「命令排序」入口,結構鏡像菜單的添加/指令兩區,分區內拖拽。
  5. 順序持久化:順序保存在本機,重啓保留;「+」菜單與 / 菜單共用同一份順序。
  6. 中文標題來源:在技能 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 插件頁。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜