StarChen-Cycler/octie-dsh-plugin

octie-dsh-plugin

Status: 项目处于增量维护中（under incremental maintenance） —— 新特性、修复与文档会以小幅增量持续合入（例如 DSH 客户端任务面板、项目活跃度排序、 外部变更实时同步、图物理开关、随插件预置的 Octie 任务图模式、octie 使用技能等）。 功能以「先可用、再迭代」的方式演进。

Octie —— agent 时代的状态导向任务图内核（state-oriented task graph kernel）， 重构为 DeepSeek Harness（DSH）可安装的 bundle 插件。State is derived, not set： 状态只读派生，而非手工设置——the task layer that every agent framework can call。

Octie 是一个面向 agent 时代的持久化任务图状态机：节点 = 原子任务，边 = blocker 依赖， 状态只读派生（ready → in_progress → in_review → completed，唯一手动转移是 approve）， 完成一个任务经 BFS 自动解锁下游；原子校验在创建时拒绝模糊任务；不可变快照（SHA-256） 保证长会话可恢复。

两种使用方式

Octie 同时是两条并行的一等接口，共享同一份任务图存储（.octie/project.json）， 可随时互换使用：

你能得到什么

• 独立 CLI（octie）与 Web UI（octie serve）：不装 DSH 也能用，见下文 「CLI 独立使用」
• 13 个 octie_* 模型工具 + octie Cordis 服务 + octie/* 事件——DSH 会话里 直接规划、执行、追踪任务图
• DSH 客户端任务面板：列表 + 分层 DAG 图视图、项目活跃度排序、实时同步、图物理开关
• 「Octie 任务图模式」agent preset：随插件自动预置，开箱即用的任务图工作模式

CLI 独立使用

要求 Node.js ≥ 20。

# 安装（npm，已发布）
npm install -g octie-cli

# 或从源码构建（开发向，详见 docs/development.md）
git clone https://github.com/StarChen-Cycler/octie-dsh-plugin
cd octie-dsh-plugin/octie && npm install && npm run build:cli

快速上手：

octie init                                   # 初始化项目（创建 .octie/）
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>                            # 审批：BFS 解锁下游
octie serve                                   # 网页界面（默认 3456 端口）

CLI 的完整使用原则（建任务 / 建依赖 / 图操作 / 执行审批 / need_fix）见 docs/cli-usage-principles.md。

安装（DSH）