English | 简体中文

dsh-taskboard

贡献与 PR：日常功能、修复和文档改动请从 dev 创建开发分支，提交 PR 时将目标分支（base）设为 dev。main 是受保护的稳定发布分支，维护者通过 dev → main 的 PR 集成发布；合入 main 前须通过 CI。

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

• 闭环协作：人建卡 → agent 认领执行 → 结构化报告 → 人验收（✓ 完成 / ✗ 退回附原因）
• 10 个 taskboard_* agent 工具 + 代码级协议闸：agent 永远移不到 done、任务被持有时不可抢、跨项目不可认领
• 执行：手动、一次性定时或 cron 定期执行（host 侧调度，浏览器关了照跑）；定时任务可选择复用当前项目的已有会话；定期任务可选择每轮回到待办，或保留待验收并自动新建下一轮待办卡
• Git Worktree 隔离：每次执行独立 worktree + 任务分支，验收时一键合并；并列多仓库工作区整区镜像隔离（0.6.3）；非 git 项目自动降级
• 验收效率：DoD 验收清单（agent 勾选附证据）、结构化执行报告（摘要/改动文件/自验/产物/风险）、看板内 diff 查看器
• 实时看板：SSE 实时刷新、五列流转、筛选排序持久化、JSON 导入导出、任务模板
• 外部任务同步：禅道按项目或执行/迭代同步缺陷、需求和任务，以及 TAPD 缺陷、需求、任务；按处理人导入，支持定时同步、项目映射和冲突保护。配置说明见下文「外部任务同步」。

零配置：安装即用——无需 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 隔离需要；缺失时自动降级原目录执行

双轨挂载（0.8.0）：dsh ≥ 0.1.7（带官方 slot 系统）时，看板作为一等侧边栏面板注册（sidebar.panellist + main，宿主拥有侧栏行与面板切换，从根本上消除「看板打开后其他面板点不动」这类问题，#31）；旧版 shell 自动回落到原有的 DOM 注入方式，行为与 0.7.x 完全一致。两条路径运行时自动互斥选择，无需配置。

安装

# 一键安装（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（台账数据保留在当前数据目录，见配置与数据）。

官方 @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 工具参考

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

…