dsh-plugin-skill2cn: DSH 技能描述一鍵漢化與還原

前言¶

在 DeepSeek Harness (DSH) 的使用過程中，安裝的技能往往附帶英文描述，導致閱讀體驗割裂。手動翻譯既耗時又難以維護。dsh-plugin-skill2cn 插件旨在解決這一痛點，它通過 LLM 將技能的 description 字段翻譯爲簡體中文，並提供一鍵還原功能，無需重啓 DSH 即可生效。

插件簡介¶

名稱: dsh-plugin-skill2cn
作者: kaluosifa
分類: 聯網工具
許可: MIT
核心價值: 讀取 SKILL.md 的 description，翻譯後直接寫回磁盤，同時維護一份 manifest.json 作爲狀態備份。

核心功能¶

插件在 DSH 設置界面中增加了一個「技能漢化」頁面，包含三個標籤頁：

未翻譯標籤頁¶

按來源（工作區 / 全局 / 插件包）分組技能。每個技能行包含「翻譯」按鈕，頂部提供「翻譯全部」的批量操作。

已翻譯標籤頁¶

顯示已翻譯的技能列表。支持單項「還原」、查看原文的開關，以及「還原全部」的批量操作。

批量任務管理¶

批量翻譯採用異步任務，併發限制爲 3。任務提供實時進度、成功與失敗的摘要。如果翻譯失敗，條目會停留在面板上，並提供「重試」按鈕。

新技能提示¶

當檢測到新技能時，右下角會彈出 shell.overlay 卡片詢問是否翻譯。已廢棄的技能不會被重複詢問。

模型設置¶

提供三種路由方式：
1. 跟隨會話路由: 使用當前會話的 LLM 配置。
2. 配置的提供商/模型: 從 DSH 已配置的模型列表中選擇。
3. 自定義端點: 支持 OpenAI 或 Anthropic 兼容協議，需填寫 Base URL、API Key 和模型名。Base URL 必須包含版本段（如 /v1）。

升級與同步¶

打開面板時，如果技能被插件包升級覆蓋，條目會被靜默清除或標記爲過期，可重新翻譯。

CJK 啓發式檢測¶

在批量運行前，插件會掃描描述。如果描述已經是中文，會被標記爲「無需翻譯」並跳過。

安裝與啓用¶

插件通過官方註冊表安裝。安裝後，重啓 DSH 以加載宿主端。

dsh plugin --profile web add dsh-plugin-skill2cn

開發與調試¶

如果你需要修改插件源碼或從源碼構建：

克隆倉庫並安裝依賴（需 Node ≥ 22.13 和 pnpm 11）：

    git clone https://github.com/kaluosifa/dsh-plugin-skill2cn.git
    cd dsh-plugin-skill2cn
    pnpm install

修改代碼後運行構建：

    pnpm build

構建過程會先生成 `lib-tsc` 目錄（處理 TypeScript 裝飾器），然後打包爲 `lib/index.js` 和 `lib/client.js`。

安裝本地構建的插件：

    dsh plugin --profile web add .

修改 src/service.ts（宿主端）或 src/client/**（客戶端）後，需重新構建並重啓 DSH 或刷新瀏覽器。

卸載與注意事項¶

卸載前，請務必先在「已翻譯」標籤頁點擊「還原全部」，因爲插件的翻譯結果直接寫入磁盤，卸載不會自動回滾這些文件。

dsh plugin --profile <profile> remove dsh-plugin-skill2cn

重要說明：
* 工作區邏輯: 「工作區」分組遵循會話的 session.header.cwd。這意味着它指的是 DSH 當前打開的項目目錄，而不是 DSH 進程啓動的目錄。如果在某個代碼檢出目錄內啓動 DSH，該目錄本身的項目技能不會成爲翻譯目標。
* 枚舉邏輯: 技能列表基於 ctx.skills 註冊表的贏家集合（winner set）進行枚舉。

結語¶

dsh-plugin-skill2cn 通過寫回磁盤和狀態備份機制，實現了 DSH 技能描述的自動化漢化與還原。對於需要管理大量本地技能的用戶，這是一個實用的工具。

查看插件目錄
 訪問 GitHub 倉庫