前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。隨着開發需求的增加，用戶往往需要在 profile 中安裝多個插件來擴展功能。手動逐個管理這些插件不僅繁瑣，還容易在依賴管理上出現衝突。
weibaohui/dsh-fde-tools 是一個聚合型插件，旨在解決上述問題。它將 19 個常用的 DSH 插件打包成一個插件安裝，通過統一的「FDE 工具箱」面板進行批量管理。安裝一次即可獲得 Git 服務器、知識庫、定時任務、Agent 團隊協作等全套能力。
插件概覽¶
- 名稱：
weibaohui/dsh-fde-tools - 定位：DSH 插件全家桶，批量管理 19 個常用插件。
- 維護者：weibaohui
- 許可證：MIT
核心功能¶
安裝本插件後，會在 DSH 設置面板中生成「FDE 工具箱」。該面板列出了全家桶的所有成員及其安裝狀態：
- 登錄門禁 (user-management)：未登錄時彈窗，支持用戶/角色/審計及 TOTP 驗證。
- Git 服務器 (dsh-git-server)：內嵌 ts-gogs，支持 HTTP 克隆推送、網頁端操作及 issue/PR 管理。
- WebDAV 掛載盤 (dsh-webdav-server)：將共享目錄轉爲掛載盤，支持三平臺掛載與令牌認證。
- 團隊知識庫 (dsh-kb)：支持瀏覽、全文檢索，並支持 raw 入料自動蒸餾。
- 定時任務 (dsh-tasks)：通過 cron 表達式設置定時任務，自動開啓新 Agent 會話。
- 自動續跑 (dsh-continue)：會話中斷後自動退避重試，支持切換模型或壓縮上下文。
- 界面微調 (dsh-settings-ui)：調整設置窗口大小、透明度及背景。
- 自動復盤 (hermes-loop)：在對話收尾時自動蒸餾經驗，生成可複用技能。
- 會話工作區文件管理 (dsh-file-share)：提供文件樹、預覽、上傳下載及打包功能，支持
@給 Agent。 - 會話智能標題 (dsh-smart-title)：使用 LLM 自動改寫會話標題。
- Agent 優先的任務看板 (dsh-taskboard)：任務賬本與獨立會話結合。
- 可視化插件市場 (dshmarket)：瀏覽並安裝插件。
- 上下文儀表盤 (dsh-context)：通過
/context命令查看上下文組成。 - IM 渠道接入 (@xmanrui/dsh-im)：接入 11 種 IM 渠道。
- VSCode 式側邊欄 (dsh-better-sidebar)：右側邊欄，按會話隔離資源管理器、編輯器、終端等。
- 本地 QA 工作臺 (dsh-qa)：需求/用例/缺陷全流程管理，支持實時看板與日曆。
- 多代理團隊組建 (@nanmicoder/dsh-agent-teams)：一句話組建多代理團隊，支持持久成員協作與 DAG 面板。
- 執行流程圖 (dsh-flow)：將會話執行過程繪製爲四泳道流程圖。
- 使用量儀表盤 (dsh-dashboard)：統計 token/費用/模型/工具，支持拖拽編排與自定義公式。
安裝與啓用¶
通過以下命令將全家桶插件安裝到指定 profile 中：
dsh plugin --profile web add @weibaohui/dsh-fde-tools
安裝完成後，重啓 DSH。在設置中找到「FDE 工具箱」面板，可以查看成員安裝狀態，點擊「補裝」或「安裝」即可將缺失成員加入。
重啓生效的注意事項：
* 本機直連：如果通過 http://127.0.0.1:3080 訪問，面板會提示「立即重啓」，點擊後 DSH 會自動拉起新進程並刷新頁面。
* 局域網/服務管理器：出於安全考慮，局域網或通過 HTTPS 網關訪問時不顯示重啓按鈕，需在終端手動重啓；如果 DSH 由 launchd 或 systemd 守護，也建議在終端重啓。
工作原理¶
本插件通過引導器在宿主側執行操作，確保依賴與配置的正確性。
-
快照還原機制
pnpm 在 profile 中執行add命令時，有時會清除link:或file:依賴。安裝前，引導器會將依賴和 bundles 快照到<profile>/.fde-tools-install-snapshot.json。安裝完成後，通過 diff 檢查並補回丟失的依賴，防止依賴丟失。 -
構建腳本攔截
部分包（如 better-sqlite3、node-pty）帶有安裝期構建腳本，pnpm 默認會攔截。引導器識別ERR_PNPM_IGNORED_BUILDS錯誤，自動在pnpm-workspace.yaml中添加allowBuilds配置項，重試安裝。 -
成員去重
如果某個成員已經存在於 profile 的依賴中（無論是 npm 包、link 還是 github spec），引導器會自動跳過，不會覆蓋現有的安裝方式。
環境變量¶
可以通過以下環境變量調整安裝行爲：
DSH_FDE_TOOLS_PROFILE：手動指定所屬 profile 的名稱或絕對路徑（默認自動掃描~/.dsh/profiles）。DSH_FDE_TOOLS_PNPM：手動指定 pnpm 可執行文件路徑（默認按 PATH →~/.local/bin/pnpm→ 宿主同前綴的 pnpm.cjs 順序探測）。DSH_HOME：指定 DSH 的主目錄（默認~/.dsh）。
兼容性與注意事項¶
- 版本要求：僅支持 DeepSeek Harness >= 0.1.7-rc.2，需要 Node.js >= 22.5。
- 權限與安全：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
- 生態背景：DSH 及其插件生態與 DeepSeek 或幻方官方無從屬關係，社區目錄（如 SkillHub）爲獨立站點。
總結¶
weibaohui/dsh-fde-tools 通過插件聚合的方式，大幅降低了 DSH 用戶擴展工作流的門檻。無論是基礎的服務搭建、文件管理，還是進階的 Agent 團隊協作與流程可視化，都能在一個面板中一站式管理。
