DSH 插件倉庫 (dsh-plugins)

前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。DSH 中的動態插件通常在會話中通過 cordis_define 定義，並在 cordis_run 時運行。這類插件的生命週期僅限於當前進程，一旦進程重啓，插件定義即失效。因此，需要一個外部倉庫來持久化保存這些插件的源碼，以便在需要時重新加載。

koji-xiaoer/dsh-plugins 倉庫正是爲此設計。它作爲 DSH 插件集合，不僅用於存儲動態插件源碼，還提供了一系列增強功能，並通過一鍵安裝腳本簡化了部署流程。

定位¶

本倉庫是 koji-xiaoer 維護的 DSH 插件倉庫。它主要解決以下問題：
* 持久化存儲：存放 DSH 會話中由 AI 助手創建的動態 Cordis 插件源碼。
* 功能增強：提供費用預估、賬單明細、Token 統計、餘額查詢、圖片轉文字等實用功能。
* 快速部署：提供一鍵安裝腳本，支持靜態化常駐包的自動加載。

核心功能¶

倉庫包含以下已覈實功能：
* 費用與賬單：費用預估與賬單明細 (cost-6)，支持自定義模型價格與多幣種切換。
* 會話管理：會話完成提醒 (sntf-5)，支持音色、音量與自定義音頻。
* 數據統計：Token 用量統計 (tokm-1)，顯示輪次、時長與消耗。
* 賬戶查詢：賬戶餘額查詢 (baln-4)。
* 多模態支持：粘貼圖片轉文字 (imgr-3)。
* 界面增強：增強主頁/界面，包含靜態化常駐包 (dsh-mods-enhanced)，隨 dsh web 啓動自動加載。

安裝與啓用¶

倉庫支持通過 DSH Profile Bundle 機制一鍵安裝。安裝前請確保環境已安裝 pnpm (Node.js >= 20)。

執行以下命令添加插件：

    dsh plugin --profile web add github:koji-xiaoer/dsh-plugins

該命令會將 `dsh-mods-enhanced` 插件插入 web profile，重啓 `dsh web` 後生效。

若需同時應用對安裝文件的文本補丁（如 UI 界面增強），需使用傳統腳本：

    git clone git@github.com:koji-xiaoer/dsh-plugins.git
    cd dsh-plugins
    bash scripts/install.sh

該腳本會自動完成依賴安裝、補丁應用（鎖定 DSH 版本至 0.1.1-rc.1）及配置工作。

典型用法¶

倉庫支持兩種插件形態的使用方式：

動態插件：在 DSH 會話中，通過 cordis_define 創建或更新插件。使用 cordis_inspect_self(pluginId, packageId) 取出最新 Package 源碼，保存到本倉庫對應目錄結構中，以便後續複用。
靜態化常駐包：通過上述一鍵安裝命令，dsh-mods-enhanced 靜態包會隨 dsh web 啓動自動加載，無需手動運行。

適用場景與注意¶

密鑰安全：倉庫是公開倉庫。任何密鑰一旦提交即視爲泄露，必須立即到 GitHub 設置頁面吊銷對應令牌。插件源碼不得硬編碼任何密鑰/token，一律使用佔位符。
版本鎖定：使用補丁機制時，會將 DSH 版本鎖定至 0.1.1-rc.1。
運行機制：動態插件不隨進程重啓保留，需通過 cordis_run 重新創建；靜態化常駐包則隨 dsh web 啓動自動加載。
適用對象：適合需要持久化管理 DSH 會話中生成的插件代碼，並希望快速接入費用監控、多模態識別等增強功能的 DSH 用戶。

短結尾¶

koji-xiaoer/dsh-plugins 爲 DSH 用戶提供了一個標準化的插件存儲與分發方案。通過將動態插件源碼集中管理，並利用靜態化常駐包實現功能增強，它降低了 DSH 插件的維護成本，提高了會話管理的效率。

倉庫地址：github.com/koji-xiaoer/dsh-plugins