前言¶

DSH 生態強調「一切皆插件」。社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，也不是官方應用商店。

對使用 DSH 的開發者來說，插件裝完並不是運維工作的結束。安全重啓、版本升級、健康檢查、備份恢復、供應商額度查詢、Linux 文件權限維護，這些問題都需要一個能反覆操作、能留痕、能避免誤操作的入口。下面介紹 gehennawu/dsh-service，它是面向 DSH Web 的運維面板。

這是什麼¶

• 插件名：gehennawu/dsh-service
• 維護者：gehennawu
• 許可證：MIT
• 定位：DSH Web 運維面板：安全重啓、健康監控、備份和 Linux 權限維護。
• 環境要求：Node.js >=22

簡單說，它把 DSH Web 日常運維中高頻發生的操作集中到一個面板裏：先看狀態，再執行重啓、備份、額度查詢、技能與子代理配置，最後處理會話與插件健康。

核心功能¶

安全重啓¶

dsh-service 提供安全重啓能力。重啓前會檢查當前是否存在活躍 Agent、後臺任務或終端類工作；如果檢測到運行中工作，會自動拒絕重啓。

也可以在對話中直接輸入 /restart 觸發安全重啓：

/restart

這個動作不是簡單結束進程，而是把「現在能不能重啓」作爲前置判斷。

版本管理與一鍵升級¶

版本與更新部分會檢查 npm 的 latest 和 next 雙 tag：

latest
next

當檢測到新版本時，會行內展開版本對比；執行一鍵升級後會自動重啓。

健康診斷¶

健康診斷用於查看當前 DSH 的運行狀態，包括：

• 運行時間
• 內存
• 會話數
• 活躍 Agent
• 後臺任務

此外，還可以執行文件權限深檢與修復。如果當前環境疑似手動啓動，健康診斷會提示重啓無保障；退出後不會自動拉起。

額度查詢¶

額度查詢用於查看供應商窗口使用情況，包括：

• 供應商窗口百分比
• 獨立進度條
• 重置時間
• 強制刷新

查詢結果會緩存 60 秒。失敗時按 30 秒 ×2 指數退避，封頂 15 分鐘。未適配供應商不會發起請求。

憑據寫入 DSH 憑據庫：

$DSH_HOME/.credentials.yaml

API key 只在宿主進程內解析，瀏覽器僅收到歸一化窗口數據。

備份管理¶

備份管理支持創建 .tar.gz 歸檔，並進行導出下載、導入上傳、刪除操作。

導入或恢復前會執行完整性檢查：

• 校驗 gzip/tar
• 校驗路徑
• 校驗條目類型

只接受：

sessions
三份允許配置
profiles/<name>/package.json

並拒絕：

• 越界路徑
• 鏈接
• 特殊文件
• 未知內容
• 損壞歸檔
• 非法 profile 清單

恢復預檢還會校驗歸檔 SHA-256 與當前目標指紋。如果發生漂移，會拒絕執行。

技能管理¶

技能管理按三檔狀態組織本地技能：

• 自動加載
• 僅手動調用
• 完全停用

雙開關可以直接改寫 SKILL.md frontmatter，用於調整技能調用方式。

子代理模型¶

子代理模型支持三種模式：

• 初始
• 跟隨主模型
• 自定義

還可以配置回退模型與思考等級。

路由配置寫入：

$DSH_HOME/dsh-service-subagent-route.json

寫入時使用原子寫入，並設置 0600 權限。配置完成後可以一鍵重置。

任務通知¶

任務通知用於在關鍵事件發生時提醒使用者，包括：

• 總開關
• 任務完成
• 授權與提問
• 輸入框鈴鐺顯隱

會話管理¶

會話管理支持在以下視圖之間篩選：

• 全部
• 僅歸檔
• 已刪除

可以批量選擇會話，並執行：

• 導出
• 歸檔
• 刪除

插件健康檢查與兼容性掃描¶

插件健康檢查會檢查插件異常狀態。手動停用的插件一律不算異常。

插件兼容性掃描爲純本地掃描，結果緩存，零網絡。

移動端適配與探活¶

dsh-service 提供移動端適配，並提供 /healthz 探活能力：

/healthz

安裝與啓用¶

先檢查本機 Node 版本：

node --version

要求滿足：

>=22

已覈實資料未提供官方安裝命令，因此本文不拼接安裝命令。安裝前請查看 GitHub 倉庫當前說明，並確認本機 DSH 插件機制。

安裝或啓用後，可以在插件配置中開啓需要的能力。關閉對應插件配置開關時，會隱藏界面、停止輪詢，並讓宿主拒絕對應能力；概覽與重啓固定保留。

典型用法¶

1、觸發安全重啓¶

在對話中輸入：

/restart

如果檢測到運行中工作，會自動拒絕。

2、檢查版本並升級¶

進入版本與更新區域，檢查 npm 的 latest 和 next tag。有新版本時，行內展開對比，確認後執行一鍵升級，升級後自動重啓。

3、執行健康診斷¶

進入健康診斷，查看運行時間、內存、會話數、活躍 Agent 與後臺任務。需要時執行文件權限深檢與修復。

4、查詢供應商額度¶

進入額度查詢，查看供應商窗口百分比、獨立進度條和重置時間。需要時點擊強制刷新。

5、創建備份¶

進入備份管理，創建 .tar.gz 歸檔。可以導出下載、導入上傳或刪除備份。恢復前會執行完整性檢查與恢復預檢。

6、管理技能¶

進入技能管理，將本地技能設置爲自動加載、僅手動調用或完全停用。雙開關直接改寫 SKILL.md frontmatter。

7、配置子代理模型¶

進入子代理模型，選擇初始、跟隨主模型或自定義模式。需要時配置回退模型與思考等級。

8、處理會話¶

進入會話管理，在全部、僅歸檔、已刪除之間篩選，批量選擇後執行導出、歸檔或刪除。

適用場景與注意¶

適合以下場景：

• 需要經常重啓 DSH Web 服務
• 需要查看服務健康狀態
• 需要管理備份與恢復
• 需要查詢供應商額度
• 需要維護 Linux 文件權限
• 需要管理技能、子代理與會話

需要注意的是，dsh-service 會操作本機 DSH 狀態，包括憑據、備份、配置、權限和插件健康。插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

鏈接¶

• GitHub：https://github.com/gehennawu/dsh-service
• 目錄頁線索（已覈實資料中標註爲線索，未出現在已抓取資料中）：https://www.skillhub.cn/plugins/gehennawu/dsh-service