前言¶

在 DeepSeek Harness（DSH）會話裏做智能體開發時，任務狀態如果只散落在對話裏，後續追蹤會比較困難：任務拆成什麼、哪些有依賴、哪些已經完成、哪些還需要審批，都不容易一眼看清。DSH 生態的理念是「一切皆插件」；這裏的社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

下面介紹 octie-dsh-plugin。它是 StarChen-Cycler 維護的一個 DSH bundle 插件，把 octie 的狀態導向任務圖內核包裝成可安裝插件。截至 2026-09-01，項目處於增量維護中。

這是什麼¶

一句話定位：agent 時代的狀態導向任務圖內核，重構爲 DeepSeek Harness（DSH）可安裝的 bundle 插件。

它的核心原則是 State is derived, not set：狀態只讀派生，而非手工設置。任務圖圍繞原子任務組織，任務之間有依賴關係；完成一個任務後經 BFS 自動解鎖下游。創建任務時有原子校驗，用於拒絕模糊任務；不可變快照（SHA-256）用於支持長會話恢復。

它提供兩條接口：

• 獨立 CLI（octie）與 Web UI（octie serve）
• DSH bundle 插件：13 個 octie_* 模型工具、octie Cordis 服務、octie/* 事件、客戶端任務面板、預置 agent preset

兩條接口共享同一份任務圖存儲：

.octie/project.json

核心功能¶

狀態導向任務圖¶

狀態流轉如下：

ready → in_progress → in_review → completed

唯一手動轉移是 approve。完成一個任務後，下游任務會經 BFS 自動解鎖。

這裏的關鍵是狀態不是靠手工維護，而是從任務狀態中派生出來。任務創建時也會做原子校驗，幫助避免模糊任務進入任務圖。

DSH 插件能力¶

安裝後，DSH 會話裏可以使用：

• 13 個 octie_* 模型工具
• octie Cordis 服務
• octie/* 事件

DSH 客戶端任務面板支持：

• 列表視圖
• 分層 DAG 圖視圖
• 項目活躍度排序
• 即時同步
• 圖物理開關

插件還會自動預置「Octie 任務圖模式」agent preset。如果該 preset 已存在，則絕不覆蓋。

獨立 CLI 與 Web UI¶

不依賴 DSH 時，也可以使用獨立 CLI：

octie

以及 Web UI：

octie serve

CLI 和 DSH 插件共享同一份任務圖存儲，可以在終端、腳本管道和 DSH 會話之間切換使用。

安裝與啓用¶

要求 Node.js ≥ 20。

推薦通過 npm 包安裝：

dsh plugin --profile <name> add octie-cli

也可以從 GitHub 安裝：

dsh plugin --profile <name> add github:StarChen-Cycler/octie-dsh-plugin

注意：從 GitHub 安裝時，不含 octie serve 的網頁界面資源；如需使用 Web UI，需要自行構建。

安裝後需要重啓 DSH；Node 側改動必須重啓才生效。

經過上面的步驟後，可以檢查插件掛載情況：

dsh --profile <name> --dump-config | grep -i octie

典型用法¶

獨立 CLI 使用¶

先全局安裝 CLI：

npm install -g octie-cli

初始化項目：

octie init

創建一個任務。下面示例同時給出標題、描述、成功標準和交付物：

octie create --title "Implement login endpoint" --description "POST /api/auth/login：校驗憑據、簽發 JWT。" --success-criterion "Returns 200 with JWT for valid credentials" --deliverable "src/api/auth/login.ts"

查看任務列表：

octie list --format md

維護任務進度：

octie update <id> --complete-criterion <cid>

審批任務。這一步會觸發下游任務解鎖：

octie approve <id>

啓動網頁界面：

octie serve

DSH 會話使用¶

在 DSH 中安裝並重啓後，插件會提供 13 個 octie_* 模型工具、octie Cordis 服務和 octie/* 事件，用於在會話中規劃、執行和追蹤任務圖。

隨插件自動預置的「Octie 任務圖模式」agent preset 可以直接用於任務圖工作模式。

更新與已知注意¶

更新順序是先全局 CLI，再 DSH 插件：

npm update -g octie-cli
dsh plugin --profile <name> update octie-cli

更新後可以檢查掛載形態：

dsh --profile <name> --dump-config | grep -i octie

需要特別注意：

• 全局 octie-cli 若停留在 1.2.0 之前版本，可能導致 DSH 把插件當普通依賴安裝。遇到這類問題時，先更新全局 CLI，再更新 DSH 插件。
• 從 GitHub 安裝時，update 需要使用同一來源：

dsh plugin --profile <name> update github:StarChen-Cycler/octie-dsh-plugin

否則兩條安裝路徑會並存。

• DSH 安裝後需重啓 DSH；Node 側改動必須重啓才生效。

適用場景與注意¶

適合以下場景：

• 希望在 DSH agent 會話中直接規劃、執行、追蹤任務圖
• 希望任務有明確成功標準、交付物和審批門
• 希望 CLI、Web UI 和 DSH 會話共享同一份任務圖
• 長會話需要基於快照恢復任務狀態

使用前需要注意：

• 要求 Node.js ≥ 20
• 插件會以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證；本插件許可證爲 MIT（沿用上游）
• DSH 社區目錄不是官方應用商店；它與 DeepSeek / 幻方無官方從屬關係
• 從 GitHub 安裝時，不含 octie serve 的網頁界面資源
• 預置 agent preset 已存在時不會覆蓋

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/StarChen-Cycler/octie-dsh-plugin
• GitHub：https://github.com/StarChen-Cycler/octie-dsh-plugin