@deepseek-kanban/plugin
DeepSeek Harness 任务看板插件（主机状态机 + git 调度 + 浏览器看板 UI）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:callmesoul/deepseek-kanban-plugin#e5bd4f6d1e6aa856cf8e371d9844e166aeaf8325Plugin 以 @deepseek-kanban/plugin 发布，当前版本为 0.7.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）任务看板插件 —— 在 DSH Web 左侧边栏提供「任务看板」，把项目、git 分支、AI agent 串成一条自动化开发流水线：创建任务 → agent 自动领取执行 → 自动提交 → 人工审核 → 自动合并回基础分支。
从 GitHub 直接安装（推荐）：
dsh plugin --profile web add "github:callmesoul/deepseek-kanban-plugin"
如需指定版本 / 分支（Tag 或 commit 后跟 #）：
dsh plugin --profile web add "github:callmesoul/deepseek-kanban-plugin#main"
安装完成后重启 / 重载 DSH 应用，侧边栏底部出现「任务看板」入口即安装成功。
强制刷新安装：
dsh plugin --profile web remove @deepseek-kanban/plugin && dsh plugin --profile web add "github:callmesoul/deepseek-kanban-plugin"
Ctrl+K（macOS 为 Cmd+K）快捷键一键打开/关闭。待领取 → 执行中 → 待审查 → 已审核 → 已完成，含 暂停中 兜底状态。支持看板列间拖拽手动流转。@ 即弹出当前项目的文件/目录候选，支持 ↑/↓ 选择、Enter/Tab 确认、Esc 关闭；git 项目走 git ls-files（尊重 .gitignore），非 git 项目回退目录扫描。git commit，无需人工介入。git worktree add）+ 独立任务分支（kanban/<id前8>），从基础分支签出，不影响主工作区。merge --no-ff 回基础分支并删除任务分支与 worktree。cwd。调研快照：2026-09-02。下表以各项目当日 GitHub README 和公开实现为依据；
—表示其 README 未将该能力作为功能公开说明，不等同于断言底层绝对无法实现。社区项目迭代很快，选型前请点击仓库链接查看最新文档。
| 项目 | 主要定位 | 与本插件的主要差异 |
|---|---|---|
| 本插件 | 面向代码交付的自动化看板 | 创建任务后自动建立 Worktree、运行 Agent、提交改动；人工审核通过后自动合并、清理，冲突可交回同一 Agent 会话处理。 |
| cloader/dsh-taskboard | 人与 Agent 共用的完整任务台账 | Cron、任务模板、DoD 清单、结构化报告、Agent 工具、Diff 和多仓库镜像等管理能力更丰富；Worktree 是可选项且每次执行建立新会话，合并与清理由用户在详情页触发。本插件更强调默认隔离、单任务单会话和审核后的自动收尾。 |
| FuncWei/dsh-kanban | Hermes 全功能看板移植 | 提供 9 列、多看板、依赖关系、批量操作、诊断、WebSocket 和 SQLite，借助 Python/FastAPI sidecar 与 headless worker 执行。本插件不需要额外 sidecar，重点是与项目 Git 分支直接形成提交—审核—合并闭环。 |
| scwlkq/dsh-task-board | DSH 原生、可持久化和可审核的任务板 | 支持验收标准、图片、执行轮次、审核/驳回/重试和 Session 历史；本插件进一步内建每任务 Worktree、系统提交、基础分支合并及冲突恢复。 |
| zhu1090093659/dsh-web / dsh-task-board | Host 权威账本与周期任务 | 强项是 Cron、权限确认门、Preset 固定、重启对账及可选防休眠；每次运行创建独立会话。它适合长期调度，本插件更适合一次开发任务持续迭代并最终落到 Git。 |
| isolat-3k/dsh-kanban | Hermes 风格 Agent 协作看板 | 提供 9 列、多看板、Agent 管理工具、心跳、进度文件与自动派发；本插件采用 DSH Storage Domain 和原生 Agent Remote，更专注自动提交、人工审核、合并和冲突处理。 |
| shengsheng90/DSH-taskboard | SQLite 项目管理与受控验收 | 提供项目、关系、附件、工作流、CLI、Skill 和 Agent 工具，且只允许人工完成验收；本插件的数据模型更轻，换取开箱即用的 Git Worktree 交付流水线。 |
| jcc1997/dsh-plugins / kanban | 可配置 Kanban、门禁和插件化研发流程 | 看板本体支持自定义列、模板、31 个 Agent 工具和可编程门禁；GitHub 分支/MR、Pipeline 与文档审批由配套插件组合。本插件把本地分支隔离、执行、审核和合并收敛在一个插件内，配置更少、流程更固定。 |
| Ericwong5021/dsh-kanban | 现有 DSH Session 的规划与分诊视图 | 卡片本质是 Session，运行/阻塞/完成状态来自实时会话，手工列位置保存在浏览器。本插件拥有独立的 Host 任务状态机，并管理 Session 之外的 Git 生命周期。 |
| alpacachen/dsh-kanban / StruggleYang/dsh-project-kanban |
另外还发现了若干侧重点相邻的实现：ANITOCE/dsh-task-board（浏览器端 Cron 与真实 Session 执行）、raosay/dsh-kanban（精简看板与逐任务模型选择）、maochiy/dsh-taskboard-plugin（通用任务字段、Session 关联与 Agent 工具）以及 SLin-code/dsh-task-notice-board（Workspace → Task → Session 层级和跨 Session 任务记忆）。它们分别更偏向轻量调度、通用任务管理或多会话协作，并非与本插件完全相同的 Git 交付流程。
| 能力 | 本插件 | cloader | FuncWei | scwlkq | dsh-web | Ericwong | tryboard |
|---|---|---|---|---|---|---|---|
| Host 侧权威持久化 | ✅ Storage Domain | ✅ JSON 台账 | ✅ SQLite | ✅ DSH Storage | ✅ JSON 账本 | △ Session 为主，列位置在浏览器 | △ DSH Settings |
| 创建任务后由真实 Agent 执行 | ✅ 自动领取 | ✅ 手动/定时/Agent 认领 | ✅ headless worker | ✅ | ✅ | ✅ | — |
| 每任务独立 Git Worktree | ✅ 默认且必经 | △ 可选、每次执行 | — | — | — | — | — |
| 系统统一提交 Agent 改动 | ✅ | — | — | — | — | — | — |
| 人审后自动合并并清理 | ✅ | △ 手动一键操作 | — | — | — | — | — |
| 合并冲突交回原 Agent 解决 | ✅ | — | — | — | — | — | — |
| 后续评论复用同一 Agent 会话 | ✅ | △ 新执行会话读取交接 | — | ✅ | — | ✅ 卡片即会话 | — |
@ 项目文件引用 + 任意文件上传 | ✅ | — | — | △ 图片 | — | — |
创建 → Worktree 隔离 → Agent 改码 → 系统提交 → 人工审核 → 自动合并与清理，无需再拼接 Git 或 Pipeline 插件。--autostash 合并；未被签出时使用临时 Worktree 合并并原子更新引用。冲突会安全回滚、记录文件，再由原 Agent 解决，主仓库不会停在半合并状态。@ 搜索遵循项目 Git 文件边界；图片以原生内容块发送，普通文件以二进制流进入 SHA-256 内容寻址存储，并挂载到任务 Worktree，适合带设计稿、日志、压缩包或文档下达任务。file: / link: 安装会自动禁用更新，避免覆盖开发源码。cloader/dsh-taskboard 的任务管理面更完整。jcc1997/dsh-plugins 更灵活。SLin-code/dsh-task-notice-board 更贴合该模型。DSH 是「主机平面 cordis 插件 + 客户端插件」双层架构，本插件对应两个部分：
┌───────────────────────────── DSH Web（浏览器） ─────────────────────────────┐
│ lib/client.js（React 外壳） │
│ ├─ sidebar.footer.action → 侧边栏「任务看板」入口 │
│ └─ shell.overlay → 全屏看板面板，挂载 Vue 应用 │
│ └─ src/（Vue 3 + Tailwind v4 + shadcn-vue 看板 UI） │
│ └─ ctx.remote.kanban.*（Typert Remote 远程调用） │
└───────────────────────────────────┬───────────────────────────────────────────┘
│
┌───────────────────────────────────▼───────────────────────────────────────────┐
│ lib/index.js（主机平面 cordis 插件） │
│ KanbanService extends TypertRemoteService（注册为 ctx.kanban） │
│ ├─ 数据：ctx.storageDomain 的 kanban 域（tasks 表）→ ~/.dsh/storages │
│ ├─ 附件：ctx.webServer 二进制路由 → ~/.dsh/attachments/kanban │
│ ├─ 项目：ctx.workspaceRegistry.list()（与 DSH 工作区绑定） │
│ ├─ git：child_process 执行（主机平面，不受沙箱限制） │
│ ├─ agent：ctx.agents.create + followup + whenIdle │
│ └─ 更新：GitHub Release 检查 → 独立 updater 安装 → 重启 dsh-web │
└────────────────────────────────────────────────────────────────────────────────┘
lib/index.js）：状态机、git worktree 调度、agent 执行、数据持久化。src/client.ts + src/ 看板 UI）：入口注册、看板展示与交互。ctx.remote.kanban.<method> 调用主机远程方法；附件上传和读取直接使用同源 HTTP 二进制路由。看板打开期间约 4s 轮询 getBoard()，页面不可见时暂停轮询。.
├── lib/ # 构建产物（也是插件包体）
│ ├── index.js # 主机端服务（KanbanService，手写源文件）
│ ├── client.js # 客户端 bundle（构建生成，ModuleLoader 包装）
│ ├── update.js # 版本比较、安装来源识别和更新状态持久化
│ ├── updater.js # 独立更新进程（安装、校验版本、重启服务）
│ └── client.raw.js # vite 中间产物（被 wrap-client 包装）
├── scripts/
│ ├── wrap-client.mjs # 把 vite CJS 产物包装成 DSH ModuleLoader 格式
│ ├── smoke-host.mjs # 主机端冒烟测试（内存态跑完整任务流转）
│ └── deploy-local.sh # 本地部署脚本（build → 重装插件 → 重建 peer symlink → 重启 → RPC 自检）
├── src/ # 客户端源码（Vue 3 + shadcn-vue）
│ ├── client.ts # React 外壳：挂载 Remote、注册侧边栏入口与 overlay
│ ├── kanban-entry.ts # Vue 应用挂载/卸载
│ ├── remote.ts # Typert Remote 描述符（远程方法声明）
│ ├── App.vue # 看板根组件
│ ├── assets/index.css # 全局样式（含 .markdown-body 排版）
│ ├── components/ # 看板、任务详情、新建任务等 Vue 业务组件
│ │ ├── agent-composer/ # Agent 输入框、附件预览与提交数据格式化
│ │ └── ui/ # shadcn-vue 基础组件
│ ├── composables/useBoard.ts
│ └── lib/ # Remote bridge、类型、Markdown 渲染、项目文件适配
├── docs/ # 设计文档 + 截图
└── package.json
dsh CLI 可用，含 web profile）cd /home/callmesoul/code/deepseek-kanban-plugin
pnpm install
pnpm build # vite build + wrap-client.mjs，生成 lib/client.js
pnpm watch # 开发时增量构建
普通用户 / 快速体验（从 GitHub 安装）：
dsh plugin --profile web add "github:callmesoul/deepseek-kanban-plugin"
本地开发（file: 协议，硬链接实时生效）：
# 方式一：直接安装（推荐）
dsh plugin --profile web add "file:$(pwd)"
# 方式二：完整重建 + 重装
pnpm sync:dsh # 等价于 build + remove + add
⚠️
file:协议路径必须是 WSL 原生路径（/home/callmesoul/...），不要用\\wsl.localhost\...形式的 Windows 路径，否则 pnpm 会报ERR_PNPM_LINKED_PKG_DIR_NOT_FOUND。
安装后重启 / 重载 DSH 应用（或重载插件）生效。之后侧边栏底部出现「任务看板」入口。
pnpm test # 主机任务流 + 插件更新测试
pnpm test:smoke # 内存态验证 创建→评论继续→审核→合并 全流程
pnpm test:update # 验证版本、来源、状态和安装命令安全约束
插件启动后会检查仓库的 GitHub Latest Release。发现高于当前版本的稳定 Release 时，DSH 右上角会显示更新提示，可查看发布详情或点击「立即更新」。
github:callmesoul/deepseek-kanban-plugin 安装的插件支持一键更新。file:、link: 的本地开发安装不会检查或覆盖源码。dsh-web.service 正在运行时，安装完成后自动重启服务；其他启动方式会提示手动重启 DSH。~/.dsh/updates/deepseek-kanban.json，安装或重启失败时会在提示中显示错误。任务描述和待审查任务的评论框使用同一套 Agent Composer：
@ 可搜索并引用当前项目中的文件或目录；使用 ↑/↓ 切换候选，Enter/Tab 确认，Esc 关闭。.kanban-attachments 目录供 Agent 读取。 ┌──────────────────────────────────────────────────────────┐
│ │
▼ │
待领取(todo) ──自动领取──▶ 执行中(running) ──agent完成+commit──▶ 待审查(review)
│ │ │
│ │ git/agent/commit 失败 │ 评论并继续
│ ▼ ▼
│ 暂停中(paused) ◀──── 合并失败 ◀──── 已审核(approved)
│ │ ▲ │
│ 继续执行(resume) │ │ │ 审核通过
└─────────────────────────┘ │ │ (触发合并)
▲ │ ▼
└── 新建非 git / 无 commit ──────────────── │ 已完成(done)
│
审核通过 ──────┘
(非 review 状态拖拽到此也触发合并)
git add -A && git commit，进入待审查。执行中 会触发 agent 执行，拖到 已审核 会触发合并。baseBranch（基础分支）与 taskBranch（kanban/<id前8>）。git worktree add -b <taskBranch> <path> <baseBranch> 创建独立 worktree → agent 在 worktree 中改码 → git add -A && git commit。使用 worktree 而非 checkout，主工作区分支不受影响。git merge --no-ff --autostash <taskBranch>；否则创建临时 worktree 合并后 update-ref 更新目标分支。合并失败会捕获冲突文件并执行 git merge --abort，不会把主仓库留在半合并状态。| 方法 | 说明 |
|---|---|
getPluginUpdateInfo() | 获取当前版本、安装来源、最新 Release 与更新状态 |
startPluginUpdate({ input: { tag } }) | 安装经过校验的最新稳定 Release |
acknowledgePluginUpdate({ input: { targetVersion } }) | 确认并清理已完成/失败的更新状态 |
listProjects() | 列出 DSH 工作区（项目）列表 |
getBoard() | 获取看板全量数据（项目 + 任务 + 状态） |
getTaskImage({ input: { taskId, attachmentId } }) | 兼容旧客户端读取图片（新客户端使用二进制 HTTP 路由） |
listCreateTaskOptions() | 新建任务选项（模型分组 + 默认模型） |
listBranches({ input: { projectId } }) | 获取项目 git 分支列表（含当前分支） |
listProjectPaths({ input: { projectId } }) | 获取项目文件/目录树（供 @ 文件引用使用） |
createTask({ input: { ..., attachments? } }) | 新建任务 |
moveTask({ input: { taskId, to } }) | 移动任务状态（拖拽 / 手动流转） |
approveTask({ input: { taskId } }) | 审核通过（触发合并） |
resumeTask({ input: { taskId } }) | 恢复暂停的任务 |
commentTask({ input: { taskId, comment, attachments? } }) | 评论并继续（恢复 agent 会话追加 followup） |
deleteTask({ input: { taskId } }) | 删除任务 |
调用均返回 { ok: true, value } | { ok: false, error }（见 src/lib/types.ts）。
附件 HTTP 路由：POST /kanban/attachments 接收原始二进制请求体，GET|HEAD /kanban/attachments/:attachmentId?taskId=:taskId 在校验任务归属后返回文件内容。
lib/index.js：在 KanbanService 添加方法，并加入 markRemoteMethods 注册列表。src/remote.ts：添加对应 descriptor（参数名须与主机方法参数名一致）。src/lib/bridge.ts：在 KanbanApi 接口补充签名。pnpm build 生成 client.js，重载 DSH 生效。lib/index.js 为手写源文件，lib/client.js 为构建产物（勿手改）。file: 协议安装后，profile 副本与项目源文件是硬链接：pnpm build 后源文件即生效，无需手动拷贝；但改 package.json 的 files 字段或需要彻底重装时，用 pnpm sync:dsh。package.json 的 files 字段必须包含 cordis.patch.yml（dsh.bundle.patch 依赖它），否则 GitHub 安装后 DSH 启动会因找不到 overlay 报错；profile 的 cordis.patch.yml 中不要再重复 insert kanban，否则报 duplicate loader entry id。CHANGELOG.md、Git Tag 和 GitHub Release。Q：「看板任务」为什么能汇总不同项目的会话？
它是插件在侧边栏提供的虚拟分组，会根据任务记录中的 Agent 会话 ID 汇总展示，不是绑定单一 cwd 的真实 DSH 工作区。插件启动时会迁移会话并清理旧版创建的「{project}看板任务」工作区。
Q：任务详情里改动记录为空？ 改动记录自「记录 agent 最终输出」版本起生效。历史已完成任务是在旧版本执行的，无法回溯补录；新任务执行后即有记录。
Q：为什么改了源码不生效？
确保已执行 pnpm build 且已重载 DSH 应用。若仍未生效，可 pnpm sync:dsh 重装。
详见 CHANGELOG.md。
MIT
| 人与 Agent 共同维护的项目规划板 |
| 强调 Agent 建卡、改卡、自定义列、标签、优先级、搜索等规划体验，不负责自动改码和合并；本插件偏向把已经明确的开发任务直接执行并交付。 |
| nexsjournal/dsh-tryboard-plugin | DSH 内的手工 Trello 看板 | 支持多看板、自定义列和同列排序，数据存入 DSH 设置，但不驱动 Agent。本插件列结构固定，由状态机保障执行与审核语义。 |
| — |
| Host 端定时执行 | ✅ 单次时间 | ✅ Cron | ✅ Scheduled 流程 | — | ✅ Cron | — | — |
| 看板 + Roadmap 甘特图 | ✅ | — | — | — | — | — | — |
| 应用内检查 Release 并一键更新 | ✅ | — | — | — | — | — | — |
| 不依赖额外 sidecar / 数据库 | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ |