前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在 Odoo 開發場景中，一個常見的問題是智能體在缺乏規範或未驗證的情況下直接修改代碼，導致生產環境風險。dsh-odoo-sdd 旨在解決這個問題，它將 DeepSeek Harness 轉化爲一個針對 Odoo 的規範驅動開發 (SDD) 管道。
這是什麼¶
這是一個 DeepSeek Harness 插件，用於 Odoo 的規範驅動開發。由 fhidalgodev 維護，類別爲模型推理。它連接到現有 Odoo 實例（通過 JSON-RPC），編排 5 階段 SDD 工作流，並強制執行 fail-closed 安全門。
核心功能¶
- Spec before code, always：在編寫代碼之前先撰寫規範。沒有經過驗證的
PASSED狀態，DONE是不可達的。 - Closed feedback loop：在真實運行的 Odoo 實例上建立閉環。使用
odoo_module install安裝模塊，使用odoo_errors讀取服務器 traceback 並重試。 - Pipeline safety：使用 fail-closed 門控。每個階段持久化到磁盤，
stop.md會停止所有操作，最多允許 5 次修復迭代。 - No change without a spec：在管道關閉後提出的請求被視爲新的變更，需要新的規範或豁免。
- Credentials are not consent：第一個 socket 需要顯式的人類授權，綁定到
url + db + user。 - Rollback with truth reporting：檢查點快照文件，記錄每次
odoo_execute的 pre-image。恢復時報告在檢查點後創建的文件。 - Documentation generation：生成 OCA 片段、Apps index.html 和 changelog。
- Instance-free static layers：使用
odoo_validate和odoo_security_scan在安裝前檢查結構和安全漏洞（如sudo()、auth="none"）。 - Supervised or autonomous：支持人工回答每個門控或使用代理進行無人值守的輪次。
- Cross-platform support：支持 Linux、macOS 和 Windows。
安裝與啓用¶
該插件以 npm 包形式提供，需要滿足系統環境要求才能運行。
* 系統要求：DSH 版本 >= 0.1.2-rc.1，Node.js 版本 >= 20。
* 安裝方式：通過 npm 安裝包。具體命令需根據項目環境執行 npm install dsh-odoo-sdd 或從源碼構建。
典型用法¶
開發流程遵循 spec → architecture → code → verify 的路徑，並針對真實實例進行驗證。
1. 撰寫規範：編寫 spec.md，列出驗收標準。
2. 架構設計：定義 models、views、security 和測試計劃。
3. 編寫代碼：生成模塊源碼和 OCA 文檔。
4. 驗證與修復：使用 odoo_module install 或 odoo_execute 在實例上執行操作，通過 odoo_errors 讀取錯誤日誌。如果失敗，進入修復循環。
5. 文檔生成：使用 odoo_docs 生成所需的文檔文件。
適用場景與注意¶
- 適用場景：需要嚴格流程控制、希望代碼在真實實例上驗證後再交付的 Odoo 開發者。
- 注意：
- 該插件不是基礎設施編排器、聊天憑證管理器或自動提交器。它不寫入 commit，也不會詢問密碼。
- 需要一個已存在的 Odoo 實例（開發/測試環境）和一個可丟棄的數據庫。
- 項目的首個 socket 連接需要顯式的人工授權。
結尾¶
dsh-odoo-sdd 通過強制規範驅動開發和閉環驗證，降低了 Odoo 開發的試錯成本。它將 DeepSeek Harness 轉化爲一個安全的開發工作臺。
- GitHub：https://github.com/fhidalgodev/dsh-odoo-sdd
- 目錄頁：https://www.skillhub.cn/plugins/fhidalgodev/dsh-odoo-sdd
