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 預設生效。