前言¶
用 DeepSeek Harness（DSH）跑帶流水線的會話時，工作區裏往往會有一份 .superworker/ 記錄：指令、節點、依賴關係、問題池等。這些數據若只留在磁盤上，人在瀏覽器裏很難對照查看，智能體側也需要一種穩定方式按記錄裏的「話語」作答。
dsh-superworker 是 DSH 的客戶端類插件：宿主側讀取當前會話工作區裏的 .superworker/ 記錄並經網關提供給前端，瀏覽器側在側欄繪製 Superworker 工作面板；會話內還可通過面向智能體的 superworker 工具就地響應流水線內容。下面按定位、能力、安裝與使用說明。
這是什麼¶
- 名稱：
dsh-superworker（npm 包名同爲dsh-superworker） - 維護者：infraredsqy（作者 Infrareds，倉庫 github.com/infraredsqy/dsh-superworker）
- 分類：DSH 插件目錄中的「客戶端」——在 Web UI 注入側欄面板，並與宿主邏輯配合讀寫同一份
.superworker/記錄 - 許可證：MIT
- 狀態：README 標明處於早期階段，與 DSH 開發者預覽綁定；
.superworker/記錄結構仍在快速演進，可能出現破壞性變更
插件不單獨提供命令行工具安裝到 PATH；面板的寫操作由宿主側（引擎自身的 words 層）就地處理。
核心功能¶
根據倉庫 README，安裝並選中帶有 .superworker/ 記錄的工作區會話後，你會得到：
-
Web UI 側欄 Superworker 面板
界面上的指令、節點詳情、「誰欠誰」關係圖、問題池等，均來自當前會話工作區的.superworker/記錄；面板中的寫入也會寫回同一位置。 -
會話內的
superworker工具
若工作區已有.superworker/記錄，從會話第一步起即可使用該工具，就地回答流水線中的話語。其他工作區則需先加載某個sw-*skill 後纔會出現；在此之前，該會話的請求頭與未裝此插件時一致。 -
DSH 設置中的 Superworker 選項
例如是否顯示已歸檔指令、是否顯示已關閉 issue（具體項以設置頁爲準）。 -
安裝校驗
可用dsh --profile <name> --dump-config查看配置，確認存在# == dsh-superworker段。
版本與兼容性¶
package.json 中當前版本爲 0.1.1-rc.1。manifest 聲明 engines.dsh 範圍：在 DSH 仍處 0.2.x 的 rc 線內可安裝；超出範圍時 DSH 會拒絕安裝或啓動（incompatible-version，另有可選豁免命令）。DSH 進入 0.3 時該範圍會隨之上調。安裝前請對照本機 DSH 版本與插件 Release 說明。
安裝與啓用¶
前提：已安裝 DSH 並具備可寫入的 profile；實際使用面板時需有已選中的會話，且該會話工作區包含 .superworker/ 流水線記錄。未選中會話時，面板會提示無會話。
插件爲預構建包，安裝過程不執行構建步驟。從倉庫 Releases 下載 .tgz 後執行：
dsh plugin --profile <name> add ./dsh-superworker-<version>.tgz
dsh plugin --profile <name> add dsh-superworker # 同上產物，按 npm 包名安裝
若使用 pnpm 時出現若干 missing peer 警告，README 說明相關 peer 由 DSH 本身在運行時提供，一般可忽略。更多發佈與從 git 安裝的說明見倉庫 docs/publish.md（本文不展開 git 安裝路徑）。
社區目錄頁：skillhub.cn/plugins/infraredsqy/dsh-superworker。目錄站點爲社區獨立站點，與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
- 在目標工作區準備好符合當前形態的
.superworker/記錄（結構可能隨插件迭代變化，以倉庫文檔爲準）。 - 按上文命令將插件加入指定 profile，並用
--dump-config確認dsh-superworker段已出現。 - 在 DSH Web UI 中打開對應該工作區的會話，在側欄進入 Superworker，查看地圖、指令、問題池等視圖；按需修改會寫回
.superworker/。 - 在同一會話中，讓智能體調用
superworker工具處理流水線中的文本（工作區無記錄時需先滿足sw-*skill 加載條件）。
未選中會話時面板無法綁定工作區；請先選定會話再操作面板。
適用場景與注意¶
適合：已在 DSH 中使用 Superworker 流水線、需要在瀏覽器裏對照 .superworker/ 記錄並回寫，同時希望會話內通過 superworker 工具與記錄互動的開發者。
注意：
- 插件以當前 DSH 進程權限訪問工作區文件；安裝前應閱讀源碼與 MIT 許可證，確認記錄路徑與敏感內容暴露範圍。
- 插件與 DSH 開發者預覽、0.2.x rc 線強相關，生產環境升級 DSH 或插件前請覈對
engines.dsh與 Release 說明。 .superworker/數據模型仍可能 breaking change，升級插件後宜對照倉庫變更說明檢查既有記錄。- 問題與功能請求可走 GitHub Issues；運行與商務諮詢見 README 中的聯繫郵箱。
結尾¶
dsh-superworker 把 .superworker/ 從「僅存在於工作區目錄」變成 DSH 側欄裏可操作的工作面板，並在會話內提供 superworker 工具，使人與智能體圍繞同一份流水線記錄協作。更多信息見 目錄頁 與 GitHub 倉庫。
