callmesoul/deepseek-kanban-plugin ↗★ 4

@deepseek-kanban/plugin

DeepSeek Harness 任务看板插件(主机状态机 + git 调度 + 浏览器看板 UI) 适合需要可视化看板管理DSH工作区任务与Git分支的开发者。

パッケージ
@deepseek-kanban/plugin
互換性
未検証
Harness ピア範囲
^0.1.0-rc.6
Cordis ピア範囲
^4.0.1
バージョン
0.7.1
最終更新
2026/09/04

同名パッケージの別リポジトリ

インストール

$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,安装或重启失败时会在提示中显示错误。

新建任务

  1. 点击看板「新建任务」。
  2. 选择项目(来自 DSH 工作区);选择项目后自动加载该项目 git 分支,作为基础分支下拉选项(默认当前分支)。非 git 仓库的项目创建后直接进入「暂停中」。
  3. 填写标题与描述,可选选择执行模型与执行时间(留空立即执行,未来时间到点由主机端定时器自动领取)。
  4. 创建后任务进入「待领取」,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 继续改码后重新提交;若原会话无法恢复,任务暂停并保留错误,不创建替代会话。