前言¶
DeepSeek Harness(DSH)採用插件化架構,開發者可以通過安裝插件擴展系統能力。dsh-devforge 是一個面向 DSH 的規範驅動服務工廠與本機智能體工作臺插件。它由 andyfan1094 維護,旨在解決智能體開發中缺乏統一規範、服務構建流程繁瑣以及多模型接入與運維管理複雜的問題。
該插件提供 Host 能力(路由、工具、憑據、持久化)與 Web 面板(操作檯、配置、可視化),將版本化開發規範、一鍵服務生成、模型接入管理及遠程運維整合到一個工作流中。
核心能力¶
開發工廠¶
- 版本化開發規範:規範存放於
standards/目錄,通過系統提示和devforge_standards工具提供給 Agent,創建服務時按模板注入子代理。 - 一鍵生成服務:使用
devforge_jobs工具創建獨立子代理。默認掛載用戶預設cordis-250k(用於 1M 上下文模型的 250k 請求包自動壓縮),缺失時會回退至官方cordis。 - 代碼分層與規範:後端服務默認注入 Api、Bll/BAL、Dal、Model、Utility/Utils 分層,要求中文註釋與結構化日誌。
模型接入與用量¶
- 多模型支持:接入智譜 GLM、火山方舟、OpenAI 兼容中轉站。
- 智譜 Coding Plan:複用 DSH 受管憑據
ZAI_CODING_CN_API_KEY,一鍵補齊 GLM-5.3 與 GLM-5.3-Flash。支持自定義命名的 Key 池,官方調用在 401/403/429 時自動切換下一把 Key,用量獨立展示。 - 火山方舟 Agent Plan:使用 Plan Key 調用官方套餐模型,同步推理檔位,並查詢 5 小時、周、月額度。
- OpenAI 兼容中轉:配置中轉站地址和受管 API Key,註冊爲
openai-gateway聊天路由,支持內聯展示生圖結果。
運維與代碼託管¶
- 遠程運維:支持 SSH 與 WinRM,具備批量執行、PTY/SFTP、端口隧道及 Windows 進程管理能力。
- 代碼託管:支持 CNB 與 GitHub 的賬號、倉庫管理,提供 Clone/Pull/Status/Commit/Push 功能。
- 直播側欄:提供抖音直播間連接,支持彈幕、禮物、點贊等消息篩選與語音播報。
可見自動化與協作¶
- 可見自動化:利用前臺 Chrome 保存持久登錄檔案,支持多標籤頁操作、頁面快照與圖片上傳,閒魚/小紅書的發佈與回覆使用獨立標籤頁互不覆蓋。
- 協作與備份:集成飛書長連接,支持獨立會話與完成通知;支持 CNB 加密備份與跨機同步。
維護與外觀¶
- 插件更新:操作檯提供插件更新頁籤,對比官網版本清單,支持一鍵升級(官網渠道強制 SHA256 校驗)。
- 主題換膚:內置 14 套主題(7 淺 7 深,含多種紫色系),支持 8 色強調色與本地/網絡壁紙配置,支持深淺色聯動。
安裝與啓用¶
安裝後需重啓 DSH Web Host 才能使 Host 半邊生效。
通過官網安裝(推薦)
官網提供預構建包,無需本地構建:
dsh plugin --profile web add https://modagentai.com/downloads/dsh-devforge-latest.tgz
通過 GitHub 源碼安裝
dsh plugin --profile web add github:andyfan1094/dsh-devforge#main
安裝後進入操作檯的“插件更新”頁籤可檢查官網清單。
典型用法¶
一鍵生成服務與配置¶
使用 devforge_jobs 工具一鍵生成服務與 250k 壓縮配置。操作檯“教程”頁提供一鍵配置功能,寫入 cordis-250k 用戶預設(窗口 25% 觸發、保留 32k 近期原文),並可選設爲全局默認。
接入中轉站¶
在 Coding Plan 頁配置中轉站地址和受管 API Key,通過 GET /v1/models 獲取模型並註冊爲 openai-gateway 聊天路由。
本體重啓¶
需要重啓 DSH 時,使用操作檯“重啓 DSH”按鈕或 devforge_restart 工具。
注意事項¶
- 安全與權限:Key 不進入瀏覽器、日誌或普通配置,明文不會被讀取或複製。多個會話共用一個瀏覽器進程,不復制 Cookie。
- 重啓限制:重啓接口要求 loopback 與同源請求,啓動日誌寫入
$DSH_HOME/logs/dsh-web-restart.log。 - 版本校驗:官網渠道強制 SHA256 校驗。
- 生產環境:舊版派生槽位
_2…_6中已配置的 Key 升級時自動併入池。生產實例不要直接試驗。
結語¶
dsh-devforge 將開發規範、服務生成、模型管理、運維操作與協作工具整合進 DSH 生態。對於需要規範化開發流程、統一管理多模型 Key 以及進行復雜運維操作的開發者,該插件提供了從規範到落地的完整路徑。
更多詳情與源碼請訪問:GitHub