dsh-knj-workflow

dsh-knj-workflow

开发任务编排插件（DeepSeek Harness）：配置驱动的工作流 + 开发任务管理 + 可视化阶段进度。

📖 详细设计文档见 DESIGN.md（架构、数据模型、Host/Client 设计、编排器、踩坑记录、验证记录）。

功能

• 工作流管理：可新增 N 个工作流，每个工作流由多个阶段组成；阶段行为由 prompt（提示词）+ 可选 skill 定义
• 模板导入/导出：工作流列表与图编辑器均支持把模板导出为 .workflow.json 文件、从文件导入（跨机器移植）；导入后先进入编辑器检查再保存，同 ID 冲突会提示
• 开发任务：创建任务并绑定工作流，自动启动执行
• 可视化进度：右侧栏「开发任务」tab 横向步骤条展示每个阶段状态（待执行/运行中/完成/失败），实时刷新
• 阶段重跑 / 继续：失败的阶段可点击「重跑」，暂停/失败的任务可点击「继续」——基于断点持久化（每阶段结果落盘）
• 斜杠命令：/dev-task new <标题>、/dev-task list、/dev-task status <id>、/dev-task wf
• 定时调度集成（可选）：为 dsh-scheduler 提供进程内 knjWorkflowScheduler 服务；定时触发时按最新保存的流程定义创建并启动任务，历史可直达该任务详情
• UI 融入原生：左侧栏底部「新建任务」入口 + 右侧栏两个 tab（better-sidebar 扩展点），全部使用 DSH 原生设计令牌（--dsw-*）

架构

┌─ Client 端（lib/client.js）───────────────────────────────┐
│  左侧栏 sidebar.footer.action →「➕ 新建任务」              │
│  右侧栏 better-sidebar →「开发任务」「工作流」两个 tab        │
└──────────────┬──────────────────────────────────────────┘
               │ fetch('/devtask/...') 同源 HTTP
┌──────────────▼──────────────────────────────────────────┐
│  Host 端（lib/index.js）                                  │
│  DevTaskStore（JSON 持久化） + HTTP API + /dev-task 命令   │
│  WorkflowBridge：从 parent agent 作用域取 workflowEngine    │
│  （rc.8 起引擎位于 agent preset realm，非 host realm）      │
└──────────────┬──────────────────────────────────────────┘
               │ ctx.workflowEngine（script = lib/orchestrator.js）
┌──────────────▼──────────────────────────────────────────┐
│  编排器（lib/orchestrator.js）支持 resumeFrom / rerunStage │
│  每阶段子 agent 结果落盘 <taskDir>/stages/<stageId>.json   │
└─────────────────────────────────────────────────────────┘

数据目录（默认）：~/.dsh/dev-orchestrator/
  workflows.json                    # N 个工作流定义
  tasks/<taskId>/task.json          # 任务元数据 + 阶段状态
  tasks/<taskId>/stages/<stageId>.json  # 阶段断点产物

安装

dsh plugin --profile web add dsh-knj-workflow

npm 包 dsh-knj-workflow；安装后重启 dsh web 生效。dsh-scheduler 可独立安装；同时安装本插件后，调度器才会显示「KNJ 工作流」任务类型。

配置（可选，在 profile 的 cordis.patch.yml 中按 id knj-workflow 覆盖）：

键	默认	说明
dataRoot	~/.dsh/dev-orchestrator	数据存储目录
httpPrefix	/devtask	HTTP API 前缀

HTTP API

方法	路径	说明
GET	/devtask/health	健康检查
GET/POST/PUT	/devtask/workflows	工作流列表 / 保存
DELETE	/devtask/workflows/:id	删除工作流
GET/POST	/devtask/tasks	任务列表 / 创建（绑定工作流并启动）
GET	/devtask/tasks/:id	任务详情（含阶段状态）
POST	/devtask/tasks/:id/start /cancel /resume	启动 / 取消 / 继续
POST	/devtask/tasks/:id/rerun-stage	重跑指定阶段
GET	/devtask/tasks/:id/stages/:stageId	阶段断点产物

编排器参数

• args.config：工作流定义（{ name, description, stages: [...] }）
• args.task：任务元数据（{ id, title, taskDir }）
• args.resumeFrom：从某阶段继续（之前阶段读缓存）
• args.rerunStage：只重跑某阶段（其余读缓存）