DeepSeek Harness 插件介绍：dsh-plugin-oh-my-engine

前言¶

在 DeepSeek Harness (DSH) 的生态理念中，一切能力皆通过插件扩展。对于需要进行严谨工程化交付的场景，直接与 Agent 对话往往缺乏结构化的流程约束。dsh-plugin-oh-my-engine 是一个为此设计的插件，它引入了带有批准门控的 OME 工程交付模式，将 Oh My Engine (OME) 的工程化流程集成到 DSH 的 Web 和 Desktop 配置文件中。

这是什么¶

dsh-plugin-oh-my-engine 由 oh-my-engine 维护，是一个针对 DeepSeek Harness 的批准门控 OME 工程交付代理预设。该插件为 DSH 的 Web 和 Desktop 配置文件添加了隔离的 ome-engineer 预设。它保持 OME 平台的中立性，通过 OME 的公共生命周期 API 消费服务，并将运行时状态仅存储在活动的 DSH 会话事件日志中。

核心功能¶

插件主要提供以下能力：
* 文件系统：支持对工程文件的操作。
* Shell：支持在沙箱环境中执行命令。
* 会话事件：管理 Session 状态和生命周期事件。
* 工作流：定义并执行完整的工程交付流程。

安装与启用¶

该插件不依赖 Git 或 GitHub SSH，直接下载预构建包即可安装。需要分别安装 Web 和 Desktop Profile。

安装 Web Profile 插件：

    dsh plugin --profile web add https://github.com/oh-my-engine/dsh-plugin-oh-my-engine/releases/download/v0.1.6/dsh-plugin-oh-my-engine-0.1.6.tgz

安装 Desktop Profile 插件：

    dsh plugin --profile desktop add https://github.com/oh-my-engine/dsh-plugin-oh-my-engine/releases/download/v0.1.6/dsh-plugin-oh-my-engine-0.1.6.tgz

安装 OME 预设（需在 Desktop Profile 下执行）：

    dsh plugin --profile desktop exec dsh-ome preset install

安装完成后，重启 Profile 主程序，选择 OME 工程化模式 即可使用。

典型用法¶

该插件提供了一套专门的 CLI 命令和工具来管理工程交付流程：

初始化与状态管理
- /ome-init：初始化 OME，不强制或隐式覆盖。
- /ome-status：读取当前 Session 的状态。
- /ome-cancel [reason]：取消当前正在运行的流程。
审批流程
- /ome-approve：这是唯一被接受的计划批准来源。
诊断与维护
- dsh plugin --profile web exec dsh-ome doctor：诊断 Web Profile 的运行状态。
- dsh plugin --profile desktop exec dsh-ome preset update：更新预设（该操作会创建完整备份，且拒绝未管理的预设目录）。

适用场景与注意事项¶

适用场景：
该插件适用于需要严格阶段门禁和用户审批的工程交付模式。它适合希望在 DSH 中复用 OME 标准化流程的开发团队。

注意事项：
1. CLI 限制：插件的 CLI 工具仅限 Profile-local 使用，且故意未添加到系统 PATH 中。必须通过安装该插件的 Profile 来运行。
2. 端口占用：如果在启动 DSH Web 时遇到 EADDRINUSE 127.0.0.1:3080 错误，这表示另一个 DSH Web 进程已占用默认端口，并非插件安装失败。可以通过 dsh plugin --profile web exec dsh-ome doctor 诊断，或使用 dsh web --port 0 --no-open 让系统选择空闲端口。
3. 上下文继承：子代理会继承上下文，但仅能调用 ome_status。
4. 证据要求：测试证据必须引用同一会话中成功的先前工具调用。
5. 兼容性检查：升级 DeepSeek Harness 前必须重新运行 Profile 和 Session 兼容性检查。
6. 许可证：插件基于 MIT 许可证开源。

总结¶

dsh-plugin-oh-my-engine 为 DeepSeek Harness 提供了一套结构化的工程交付方案，通过 /ome-* 命令和会话事件日志，实现了从定义到学习的完整生命周期管理。该插件不修改 Standard、Code、Minimal 等其他预设，仅对选定的 OME 预设生效。