dsh-orchestrator-ericjian

<div align="right">

English · 中文

</div>

<!-- AUTO-GENERATED -->

<h1 align="center">dsh-orchestrator</h1> <p align="center"> <strong>DeepSeek Harness 的本地优先 issue 编排插件：每个仓库一块看板、每个 issue 一个独立会话、调度器自己从待办里捞活干</strong> <br /> <em>Cordis 插件 · 按工作区划分看板 · 每 issue 独立会话 · 自动拉取调度器 · 两道人工审批关口</em> </p>

<p align="center"> <a href="#quick-start"><img src="https://img.shields.io/badge/快速开始-4CAF50?style=for-the-badge" alt="Quick Start" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-D97706?style=for-the-badge" alt="License" /></a> </p>

<p align="center"> <img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat&logo=typescript&logoColor=white" alt="TypeScript" /> <img src="https://img.shields.io/badge/Node.js-339933?style=flat&logo=node.js&logoColor=white" alt="Node.js" /> <img src="https://img.shields.io/badge/React-20232A?style=flat&logo=react&logoColor=61DAFB" alt="React" /> <img src="https://img.shields.io/badge/Zod-3068B7?style=flat&logo=zod&logoColor=white" alt="Zod" /> <img src="https://img.shields.io/badge/esbuild-FFCF00?style=flat&logo=esbuild&logoColor=black" alt="esbuild" /> <img src="https://img.shields.io/badge/Cordis-2D2D2D?style=flat" alt="Cordis" /> </p>

---

功能特性

---

截图

看板使用示例数据渲染——不包含任何真实部署的项目细节。

看板视图：按工作区划分的看板，包含审批队列、调度器控制条（自动拉取开关、并行度、实时 running/waiting 计数），以及进行中 issue 上的会话标识：


Issue 详情，从卡片展开，显示统一验收控件——Accept（验收通过），或填写理由 Send back（打回，理由会落成一条评论）：


---

快速开始

前置条件

• Node.js 22.5+
• 一个正在运行的 DeepSeek Harness profile

从源码安装（推荐）

克隆、构建，并把 checkout 链接进 profile。在 checkout 目录内执行 dsh plugin add . 会注册这份本地构建，之后重新 npm run build 即可生效，无需重装：

git clone https://github.com/EricJiang0423/dsh-orchestrator.git
cd dsh-orchestrator
npm install && npm run build
dsh plugin --profile web add .

lib/ 是被 gitignore 的构建产物。npm test 会在它缺失时自动先构建（pretest 钩子会先跑 npm run build），因此干净 clone 里 npm install 之后无需手动构建就能直接跑测试。一旦 lib/ 已存在，npm test 会跳过重建以保持快速——想测最新源码改动时请显式执行 npm run build。

从 npm 安装（registry）

> ⚠️ registry 上不带 scope 的 dsh-orchestrator 属于另一个无关项目（zibo/dsh-agent-mesh）。本项目以带 scope 的名字发布：

dsh plugin --profile web add @ericjiang0423/dsh-orchestrator

运行

dsh --profile web

---

用法

不离开聊天直接记一个 issue

/task 修复那个偶发的 checkout 测试

从别的插件读写看板

import type {} from '@ericjiang0423/dsh-orchestrator'

export const inject = ['taskboard']

export function apply(ctx: Context) {
  const open = ctx.taskboard.listTasks({ status: 'todo' })
}

调用 RPC 端点

const res = await fetch('/_dsh/taskboard/rpc', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    method: 'task.update',
    params: { id, patch: { status: 'in_review' }, expectedVersion: 3 },
  }),
})

配置调度器与规划循环

- id: taskboard
  config:
    scheduler:
      concurrency: 2
      autoPull: true
    plan:
      maxRounds: 16
      maxHandoffChars: 8192

---

架构

%%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px'}}}%%
graph LR
    UI[Board View<br/>React] -->|RPC + SSE| SVC[Taskboard Service<br/>Cordis Plugin]
    TOOLS[taskboard_* Tools<br/>Model-facing] --> SVC
    PLAN[taskboard_plan<br/>Workflow Engine] -->|fresh subagents| TOOLS
    SVC --> DB[(Storage Domain)]
    SVC --> WS[Workspace Registry<br/>cwd → workspace]
    SCHED[Scheduler<br/>session-link] -->|agents.create| ISS[Per-Issue Sessions<br/>ctx.agents]
    SVC --> SCHED
    ISS --> SVC

    classDef client fill:#3B82F6,stroke:#2563EB,color:#fff,stroke-width:2px
    classDef service fill:#10B981,stroke:#059669,color:#fff,stroke-width:2px
    classDef data fill:#8B5CF6,stroke:#7C3AED,color:#fff,stroke-width:2px

    class UI client
    class SVC,TOOLS,PLAN,SCHED,ISS service
    class DB,WS data

浏览器端从不直接读写存储。所有读写都经过 ctx.taskboard——无论调用方是看板自己的 RPC 路由、模型工具、规划循环还是调度器——所以两道人工关口（不许自批、不许自验）只存在于一处，对每个调用方生效。调度器是唯一会自动开工的东西，而且它只从 todo 里取——todo 只有真人才能放进去。

---

配置

---

API

浏览器端与宿主端通过一个端点通信：POST /_dsh/taskboard/rpc，请求体为 { method, params }，而不是每个资源一条 REST 路径。DeepSeek Harness 的类型化 RPC 层需要构建期代码生成，而本插件的构建不跑这一步，所以路由刻意保持显式——原因见 [docs/spike-findings.md](docs/spike-findings.md)。

变更通知通过 GET /_dsh/taskboard/events 以 Server-Sent Events 推送。

---

目录结构

src/
├── client/              # 浏览器端
│   ├── board.tsx         # BoardView：列、卡片、调度器控制条、审批与验收控件
│   ├── index.tsx          # 客户端插件入口、slot 注册
│   ├── rpc.ts              # 基于 fetch() 的 RPC 客户端 + SSE 订阅
│   └── styles.ts            # 仅布局的 CSS；所有颜色都是主题 token
├── domain.ts             # Zod schema 与状态机
├── service.ts            # ctx.taskboard：读写、版本 CAS
├── rpc.ts                 # 宿主 RPC 路由 + SSE 变更流
├── tools.ts                # 面向模型的 taskboard_* 工具
├── command.ts               # /task 人工命令
├── plan-loop.ts               # taskboard_plan：固定规划循环
├── session-link.ts              # 工作区解析、每 issue 独立会话、调度器
├── skill.ts                      # 注册 manage-taskboard skill
├── actors.ts                      # 参与者身份
├── wire.ts                         # 浏览器与宿主共享的 RPC 类型
└── index.ts                        # 插件入口：挂载所有面
test/                    # node:test 测试套件
skills/manage-taskboard/  # 内置的工作约定 skill
docs/                     # 扩展点调研笔记

---

技术栈

运行时

构建与测试

---

贡献

1. Fork 本仓库 2. 创建功能分支（git checkout -b feature/amazing） 3. 提交改动（git commit -m 'feat: add amazing feature'） 4. 推送分支（git push origin feature/amazing） 5. 发起 Pull Request

---

许可证

[Apache-2.0](LICENSE)。领域模型与 issue 流转规则源自 dashi-taskboard——见 [NOTICE](NOTICE)。