dsh-taskboard

DeepSeek Harness 的任务看板插件：人建卡、agent 认领执行、人验收。任务挂项目（workspace）、可指定模型与 preset、支持手动与定时执行，全流程双向协作。

• 闭环协作：人建卡 → agent 认领执行 → 结构化报告 → 人验收（✓ 完成 / ✗ 退回附原因）
• 10 个 taskboard_* agent 工具 + 代码级协议闸：agent 永远移不到 done、任务被持有时不可抢、跨项目不可认领
• 执行：手动或 cron 定时（host 侧调度，浏览器关了照跑）；每次执行在任务项目内开全新会话，可指定模型与 preset
• Git Worktree 隔离：每次执行独立 worktree + 任务分支，验收时一键合并；非 git 项目自动降级
• 验收效率：DoD 验收清单（agent 勾选附证据）、结构化执行报告（摘要/改动文件/自验/产物/风险）、看板内 diff 查看器
• 实时看板：SSE 实时刷新、五列流转、筛选排序持久化、JSON 导入导出、任务模板

零配置：安装即用——无需 Token、无需 API Key、无需额外服务或数据库。

界面

<p align="center"><img src="https://raw.githubusercontent.com/cloader/dsh-taskboard/main/img/board.png" alt="任务看板" width="880"></p> <p align="center"><img src="https://raw.githubusercontent.com/cloader/dsh-taskboard/main/img/modal.png" alt="新建任务" width="440"></p>

目录

• 环境要求
• 安装
• 快速开始
• Agent 工具参考
• 功能特性
• 安全
• 配置与数据
• 常见问题
• 开发
• 升级日志

环境要求

依赖	要求	说明
DeepSeek Harness	≥ 0.1.1	需要 dsh plugin 子命令与 web profile
Node.js	≥ 20	仅 GitHub 源安装构建时需要
git	可选	Worktree 隔离需要；缺失时自动降级原目录执行

安装

# 一键安装（npm，预构建、免构建授权 —— 推荐）
dsh plugin --profile web add dsh-taskboard

# 或从 GitHub 源安装
dsh plugin --profile web add github:cloader/dsh-taskboard

安装后重启 dsh web 并刷新页面：侧边栏出现「任务看板」入口即成功。无需任何后续配置。

GitHub 源安装卡在 prepare / allowBuilds？

git 源插件安装时经 prepare 脚本构建，pnpm 会先阻止——按报错提示把精确 key 加进 profile 目录 pnpm-workspace.yaml 的 allowBuilds 后重跑即可。npm 源是预构建产物，无此步骤。

开发模式安装（改代码即生效）

git clone https://github.com/cloader/dsh-taskboard.git
cd dsh-taskboard
npm install && npm run build
dsh plugin --profile web add "link:/path/to/dsh-taskboard"

link 安装后，仓库里 npm run build 重建、刷新页面即生效；改完宿主侧代码需重启 dsh web。

卸载：dsh plugin --profile web remove dsh-taskboard（台账数据保留在 DSH 主目录，见配置与数据）。

官方 @deepseek-ai/dsh-* 包只写进 profile 的 bundles 列表，不要 plugin add 进 dependencies（避免 SDK 双实例遮蔽）。

快速开始

第 1 步 · 建卡：看板右上「+ 新建任务」——选项目、紧急度、执行方式（认领/定时+cron）、模型与 preset、Git 隔离开关、验收清单；可勾「⚡ 立即执行」。

第 2 步 · agent 执行：三种触发方式任选——

1. GUI「立即执行」/「↻ 续跑」（详情页或表单）
2. cron 定时（host 侧调度，无需开浏览器）
3. 任意会话里让 agent 用 taskboard_* 工具认领：按看板上的任务 t-xxxxx 执行

第 3 步 · 人验收：待验收列「✓ 完成」一键验收；「✗ 退回」退回待办并附原因（agent 下轮开工前会读）。

一次完整的 agent 工作流（协议由插件在执行开场自动下达）：

你：执行看板任务 t-ab12cd
agent：
  taskboard_list                # 查板：项目内 todo 任务
  taskboard_get t-ab12cd        # 读需求、评论、验收清单
  taskboard_move → in_progress  # 认领（代码闸：被持有/跨项目会被拒绝）
  ……编码 / 测试……
  taskboard_checklist check     # 逐项勾验收清单，附证据 note
  taskboard_execution_report    # 结构化报告：摘要/改动文件/自验/产物/风险
  taskboard_comment_add         # 交接说明
  taskboard_move → in_review    # 移待验收
你：看板待验收列 ✓ 完成   # done 永远只属于人——agent 调用会被代码闸拒绝

Agent 工具参考

任何会话可用；项目边界：只有属于任务所在项目的会话才能认领或执行。

工具	作用
taskboard_list	查板（按项目/状态/紧急度过滤，紧凑摘要）
taskboard_get	读单卡全文：描述、prompt、评论流、清单、执行记录
taskboard_comments	列出任务评论（视为最新需求，先读后动）
taskboard_create	建卡（workspaceId、紧急度、清单、preset、隔离、定时）
taskboard_update	改标题/描述/prompt/紧急度/清单（model/execution 只读）
taskboard_move	移卡：todo→in_progress→in_review（到不了 done）
taskboard_comment_add	追加评论（交接、风险、进展）
taskboard_delete	软删除（可 purge；执行中不可删）
taskboard_checklist	验收清单 add / check（附证据）/ uncheck
taskboard_execution_report	提交结构化执行报告，自动挂到当前执行

功能特性

…