前言¶
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
