前言¶
DeepSeek Harness (DSH) 生態以插件化爲核心，允許擴展各類工具。dsh-plugin-ide-hub 是一個工作流類插件，旨在解決多 IDE 環境下的管理痛點。當用戶在 Claude Code、Codex、ZCode、Trae、Qoder、CatPaw 等多個編碼 IDE 之間切換時，每個工具都會將會話、用量統計和規則文件獨立存儲在本地磁盤。本插件不調用廠商 API，而是直接讀取這些磁盤上的本地狀態，提供一個統一的入口來盤點、管理和導出這些信息。
核心功能¶
插件提供以下命令，覆蓋從配置到使用的全流程：
-
/ide-hub
盤點已安裝的適配器（共 8 個）與規則文件。它會檢查每個工具的規則文件是否存在，並反饋安裝狀態。 -
/hub-init [目錄]
生成規則本體與 8 個工具的指針。該命令會在指定目錄下創建規則文件，並將指針寫入各工具的項目規則文件中。寫入遵循“不覆蓋現有正文”的原則，僅在文件末尾追加帶標記的指針段。 -
/hub-usage
統計各工具的用量。對於 ZCode，走本地 SQLite 庫統計總量、輪數、緩存命中率等；對於 Claude 和 Codex，走轉錄統計。 -
/hub-sessions
列出最近會話並提供一鍵恢復命令。支持對 Claude Code、Codex、ZCode 和 DSH 本身的會話進行恢復操作。 -
/today
基於阻塞情況、預算和任務優先級對今日事項進行排序，輔助判斷當前應該優先處理哪項工作。 -
/hub-migrate
制定配額遷移計劃。根據配置的剩餘配額和優先級，計算各工具的耗盡倒計時，並給出配額遷移建議。 -
/hub-export
將盤點結果與規則文件導出爲 Obsidian 筆記，生成IDE-Hub/子樹結構。
安裝與啓用¶
安裝過程包含三個步驟：
- 安裝插件包。
- 重啓 dsh。
- 驗證配置是否生效。
# 1. 安裝插件
dsh plugin --profile web add github:121212165/dsh-plugin-ide-hub
# 2. 重啓 dsh
# 3. 驗證掛載
dsh --profile web --dump-config | grep dsh-plugin-ide-hub
安裝完成後，插件會自動掛載。/hub-init 與 /today 等核心命令可直接使用。
典型用法¶
安裝並重啓 dsh 後，可通過以下命令進行操作：
# 查看適配器與規則文件盤點
/ide-hub
# 初始化或更新規則文件（指定項目目錄）
/hub-init [項目目錄]
# 查看今日優先級排序
/today
已知邊界¶
由於插件僅讀取磁盤文件，且不同廠商的實現差異，存在以下限制：
- Trae 會話不可見：Trae 的會話目前無法在
/hub-sessions中顯示，僅能通過/ide-hub盤點出其已安裝狀態。 - Trae 聊天讀取限制：v0.4 版本中，Trae 聊天讀取功能未在運行中的 dsh 裏進行 live mount 複驗。
- 路徑依賴：CatPaw、Qoder 等國產 IDE 的存儲路徑隨版本變化，插件無法預知所有版本的具體路徑，讀不到時會在盤點中顯示爲“不在裝”。
- 讀寫安全：插件僅往指定項目目錄寫入規則指針，不覆蓋現有正文；卸載時僅刪除自身添加的指針段，不會破壞原有文件。
生態鏈接¶
- GitHub 倉庫：https://github.com/121212165/dsh-plugin-ide-hub
- 社區目錄：https://www.skillhub.cn/plugins/121212165/dsh-plugin-ide-hub
