callmesoul/deepseek-kanban-plugin ↗★ 4
@deepseek-kanban/plugin
DeepSeek Harness 任务看板插件(主机状态机 + git 调度 + 浏览器看板 UI) 适合需要可视化看板管理DSH工作区任务与Git分支的开发者。
同名パッケージの別リポジトリ
インストール
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:callmesoul/deepseek-kanban-pluginドキュメント
README 全文を読む ↗使用说明

插件更新
插件启动后会检查仓库的 GitHub Latest Release。发现高于当前版本的稳定 Release 时,DSH 右上角会显示更新提示,可查看发布详情或点击「立即更新」。
- 通过
github:callmesoul/deepseek-kanban-plugin安装的插件支持一键更新。 - 更新器只安装提示中经过主机端校验的最新稳定 Tag,不执行浏览器传入的任意命令。
- 使用
file:、link:的本地开发安装不会检查或覆盖源码。 dsh-web.service正在运行时,安装完成后自动重启服务;其他启动方式会提示手动重启 DSH。- 更新状态保存在
~/.dsh/updates/deepseek-kanban.json,安装或重启失败时会在提示中显示错误。
新建任务
- 点击看板「新建任务」。
- 选择项目(来自 DSH 工作区);选择项目后自动加载该项目 git 分支,作为基础分支下拉选项(默认当前分支)。非 git 仓库的项目创建后直接进入「暂停中」。
- 填写标题与描述,可选选择执行模型与执行时间(留空立即执行,未来时间到点由主机端定时器自动领取)。
- 创建后任务进入「待领取」,agent 自动领取执行。

任务描述与评论
任务描述和待审查任务的评论框使用同一套 Agent Composer:
- 输入
@可搜索并引用当前项目中的文件或目录;使用 ↑/↓ 切换候选,Enter/Tab 确认,Esc 关闭。 - 可通过附件按钮、拖放或剪贴板粘贴添加图片、文档、压缩包、音视频等任意文件,并在提交前预览或移除。单文件上限 50 MiB,每条消息附件总量上限 100 MiB、最多 10 个。
- 附件通过原始二进制请求上传到 SHA-256 内容寻址存储,任务记录只保存引用。图片还会由 DSH 图片服务校验并以原生图片内容块发送给 Agent;其他文件会复制到任务 Worktree 内被 Git 忽略的
.kanban-attachments目录供 Agent 读取。 - 详情页通过受任务归属校验的同源 URL 懒加载图片或下载文件,支持浏览器缓存和 Range 请求,不再通过 JSON RPC 返回 Base64。
- 任务描述中 Enter 用于换行;评论框中 Enter 提交,Shift+Enter 换行。中文输入法组合输入期间不会误提交。
- 文本仍按 Markdown 保存并在任务详情中安全渲染,但输入区域不提供实时预览或 Markdown 语法提示。
- 项目目录由当前项目或任务上下文自动提供,输入框内不重复显示。
状态流转
┌──────────────────────────────────────────────────────────┐
│ │
▼ │
待领取(todo) ──自动领取──▶ 执行中(running) ──agent完成+commit──▶ 待审查(review)
│ │ │
│ │ git/agent/commit 失败 │ 评论并继续
│ ▼ ▼
│ 暂停中(paused) ◀──── 合并失败 ◀──── 已审核(approved)
│ │ ▲ │
│ 继续执行(resume) │ │ │ 审核通过
└─────────────────────────┘ │ │ (触发合并)
▲ │ ▼
└── 新建非 git / 无 commit ──────────────── │ 已完成(done)
│
审核通过 ──────┘
(非 review 状态拖拽到此也触发合并)
- 待领取(todo):新建任务默认状态。agent 自动领取后进入执行中;若项目不是 git 仓库或无 commit,直接进入暂停中。
- 执行中(running):agent 正在独立 worktree 中改码。完成后自动
git add -A && git commit,进入待审查。 - 暂停中(paused):兜底状态。触发条件:项目不是 git 仓库、仓库无 commit、agent 创建/执行失败、提交失败、合并失败。Agent 会话一旦创建便立即绑定;恢复时继续使用该会话。合并冲突会列出冲突文件并安全回滚主仓库;用户可点击「让 Agent 解决冲突」进入恢复流程。
- 待审查(review):等待人工审核。可查看改动记录与评论;「审核通过」后进入已审核并触发自动合并;也可评论让 agent 继续修改(回到执行中)。
- 已审核(approved):agent 正在将任务分支合并回基础分支。合并失败会回退暂停中。
- 已完成(done):任务分支已合并回基础分支,worktree 已删除。
- 手动流转:看板列间拖拽可手动移动任务状态;拖到
执行中会触发 agent 执行,拖到已审核会触发合并。
git 流程
- 新建任务:记录
baseBranch(基础分支)与taskBranch(kanban/)。 - 执行:
git worktree add -b创建独立 worktree → agent 在 worktree 中改码 →git add -A && git commit。使用 worktree 而非 checkout,主工作区分支不受影响。 - 审核通过:若主工作区当前在基础分支上 →
git merge --no-ff --autostash;否则创建临时 worktree 合并后update-ref更新目标分支。合并失败会捕获冲突文件并执行git merge --abort,不会把主仓库留在半合并状态。 - 冲突恢复:在任务 worktree 中把最新基础分支合入任务分支 → 原 Agent 解决冲突 → 系统检查残留冲突标记和未合并索引 → 提交冲突解决结果 → 回到待审查。再次审核通过后才合回基础分支并清理 worktree/任务分支。
- 评论继续:复用已有 worktree 和同一个 Agent 会话,追加 followup 继续改码后重新提交;若原会话无法恢复,任务暂停并保留错误,不创建替代会话。