前言¶
DSH(DeepSeek Harness)作爲智能體開發平臺,面對複雜的 ERP 系統時,往往缺乏對界面菜單、字段和業務流程的上下文認知。手動爲每個頁面編寫規則既繁瑣又難以維護。guomonth/dsh-erp 插件通過讓 DSH 直接通過瀏覽器接口觀察系統,將獲取的知識固化在本地,使智能體能夠複用這些經驗。
這是什麼¶
這是一個 DeepSeek Harness 插件,由 GuoMonth 維護。它的核心作用是“學習你的 ERP”,即通過瀏覽器交互觀察 ERP 的菜單、頁面、字段和業務數據,並在本地構建知識圖譜,最終將經驗導出爲可複用的技能。
核心功能¶
- 瀏覽器學習:通過瀏覽器接口學習可訪問的菜單、頁面、字段和業務數據。
- 本地構建:將觀察到的知識保存在本地,不依賴遠程服務器。
- 技能導出與導入:支持將當前 ERP 的經驗導出爲原生技能(SKILL.md),並導入到其他用戶的配置中。
- 配置與狀態檢查:通過
cordis.patch.yml進行配置,並支持檢查erp_system_status和erp_native_status。 - 多模式支持:支持原生 DSH 瀏覽器使用,並可選計算機使用。
安裝與啓用¶
在安裝前請確保環境滿足要求:
* Node.js: >=24.18.0 <25
* DSH: 0.2.0-rc.2
* 桌面環境: Linux x64,需要圖形會話和 Chromium 系統庫(Windows/macOS 桌面支持待定)
安裝插件¶
使用 npm 執行安裝命令:
npm exec --yes --package=pnpm@11.7.0 -- dsh plugin --profile web add @guosheng_047/dsh-erp@latest
如果環境僅安裝了 Node.js,可以使用以下命令:
npm exec --yes --package=@deepseek-ai/dsh@0.2.0-rc.2 --package=pnpm@11.7.0 -- dsh plugin --profile web add @guosheng_047/dsh-erp@latest
配置¶
停止 DSH,編輯配置文件 ~/.dsh/profiles/web/cordis.patch.yml(或 $DSH_HOME/profiles/web/cordis.patch.yml)。
在文件中添加或修改 id: erp 配置項。文件中若包含註釋和 [],請替換爲以下塊:
- id: erp
config:
system:
url: "https://erp.example.com/app/#/login"
name: "My ERP"
account: "my-work-account"
# tenant: "my-company"
# role: "purchasing"
url 是必填項。名稱默認爲主機名,賬號默認爲 default。使用不同的賬號別名可以隔離知識,但它們不是憑證。
啓動 DSH:
dsh --profile web
首次啓動時,需要確認預覽通知,選擇工作區並配置模型。然後請求 erp_system_status 和 erp_native_status,通過原生瀏覽器工具打開配置的 ERP 並手動登錄。
典型用法¶
-
映射與探索
請求 DSH 先映射可訪問的菜單,然後探索頁面、字段和業務領域。操作前檢查保存的知識,獲取當前的觀察和批准,並在事後驗證結果。 -
技能導出
將此 ERP 的經驗導出爲可分享的技能。使用erp_experience_export命令,它會創建一個包含 JSON 引用的SKILL.md目錄。 -
技能導入
將技能的引用/知識導入到我的配置 ERP 中。使用erp_experience_import,它會將知識重新綁定到本地範圍,並註冊原生技能。導入不會複製登錄憑據或原始證據。
適用場景與注意¶
- 適用場景:需要智能體理解特定 ERP 業務流程,且該 ERP 沒有公開 API 或難以編寫 API 腳本時。
- 權限與安全:原生瀏覽器和計算機調用需要單獨的 DSH 批准。導入的經驗不會授予操作權限,僅包含知識引用。
- 兼容性:不依賴特定的 ERP 供應商或 API 路徑,但兼容性取決於站點界面和身份驗證。
- 注意事項:
- Linux x64 桌面需要圖形會話和 Chromium 系統庫。
- 用戶知識、瀏覽器登錄數據、測試數據不包含在 npm 發佈中。
- 不提供無人值守的事務引擎或多 ERP 自動路由。
- 導入不會複製登錄憑據或原始證據,僅複製知識/引用。
結尾¶
guomonth/dsh-erp 解決了 DSH 在處理複雜企業系統時的知識缺失問題。它將瀏覽器交互轉化爲本地可複用的知識資產,適合需要私有化、本地化知識管理的場景。更多信息請查看 GitHub 或 SkillHub 目錄。