@deepseek-kanban/plugin

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"

功能特性

• 看板入口：DSH Web 侧边栏底部「任务看板」按钮，点击打开全屏看板面板（4s 轮询实时刷新，页面不可见时自动暂停轮询）；支持 Ctrl+K（macOS 为 Cmd+K）快捷键一键打开/关闭。
• 双视图切换：看板顶部 Tabs 切换「看板」列视图与「路线图」甘特图视图（参考 GitHub Projects Roadmap：左侧任务列表 + 右侧时间轴，按状态分组泳道、周/月刻度自适应、今天竖线、任务条按状态着色，点击任意任务打开详情）。
• 任务状态机：待领取 → 执行中 → 待审查 → 已审核 → 已完成，含 暂停中 兜底状态。支持看板列间拖拽手动流转。
• Agent 输入框：新建任务描述与任务详情评论统一使用 agent-textarea 的 Agent Composer，支持项目文件引用、任意附件、拖放和剪贴板粘贴；附件以二进制流上传并按内容哈希存储。
• 文件引用：在输入框中输入 @ 即弹出当前项目的文件/目录候选，支持 ↑/↓ 选择、Enter/Tab 确认、Esc 关闭；git 项目走 git ls-files（尊重 .gitignore），非 git 项目回退目录扫描。
• agent 自动执行：任务被 agent 领取后自动改码并 git commit，无需人工介入。
• Agent 默认权限：看板任务新建的 Agent 会话默认使用 Full access；恢复已有会话时保留会话当前权限设置。
• git worktree 隔离：每个任务使用独立 git worktree（git worktree add）+ 独立任务分支（kanban/<id前8>），从基础分支签出，不影响主工作区。
• 审核合并：人工「审核通过」后自动 merge --no-ff 回基础分支并删除任务分支与 worktree。
• 单任务单会话：Agent 会话在首次创建后立即绑定到任务；异常暂停后的恢复、待审查评论续跑和冲突处理都复用该会话，不会静默新建会话；若会话仍在正常执行则继续等待，不重复发送 followup。
• 新建任务配置：可选执行模型、定时执行时间；基础分支为下拉选择（从项目 git 分支实时获取）。
• 改动记录：任务详情记录每次 agent 执行后的改动说明（优先取 agent 最终输出全文，回退 git 变更摘要或系统消息），标注来源（agent / git / system）与 commit hash。
• 定时执行恢复：设了定时执行的任务，DSH 重启后自动恢复未来定时器；若停机期间错过执行时间，则在下次启动后立即补跑。
• 虚拟任务工作区：DSH 侧边栏固定显示一个虚拟「看板任务」分组，汇总所有项目的看板 Agent 会话；它不注册真实工作区，也不改变会话实际 cwd。
• 一键更新：GitHub Release 发布新稳定版本时，在 DSH 全局界面提示更新；点击即可安装，systemd 环境会自动重启服务并刷新页面。

与其他 DSH 看板插件对比

调研快照：2026-09-02。下表以各项目当日 GitHub README 和公开实现为依据；— 表示其 README 未将该能力作为功能公开说明，不等同于断言底层绝对无法实现。社区项目迭代很快，选型前请点击仓库链接查看最新文档。

代表性项目

另外还发现了若干侧重点相邻的实现：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 交付流程。

核心能力矩阵

本插件的优势

1. 从任务到代码落地主路径最短：它不是只给任务或 Session 分栏，而是默认执行 创建 → Worktree 隔离 → Agent 改码 → 系统提交 → 人工审核 → 自动合并与清理，无需再拼接 Git 或 Pipeline 插件。
2. 隔离不是可选约定，而是状态机的一部分：每个 Git 任务始终从选定基础分支创建独立任务分支和 Worktree；Agent 不操作分支，提交、合并和清理由主机端统一完成。
3. 审核通过即可完成交付：基础分支正被主工作区使用时通过 --autostash 合并；未被签出时使用临时 Worktree 合并并原子更新引用。冲突会安全回滚、记录文件，再由原 Agent 解决，主仓库不会停在半合并状态。
4. 任务上下文连续：首次执行即绑定唯一 Agent 会话；暂停恢复、审核意见、追加附件和冲突处理都向该会话追加 followup，避免多轮修改散落在不同会话中。
5. 输入材料可直接被 Agent 使用：@ 搜索遵循项目 Git 文件边界；图片以原生内容块发送，普通文件以二进制流进入 SHA-256 内容寻址存储，并挂载到任务 Worktree，适合带设计稿、日志、压缩包或文档下达任务。
6. 交付过程更容易审阅：看板与 Roadmap 双视图同时覆盖状态和时间；详情页统一展示任务描述、Agent 输出、评论、附件、改动摘要和 commit hash。
7. 维护链路内置：稳定 GitHub Release 出现后可在 DSH 内完成版本校验、安装和状态恢复；本地 file: / link: 安装会自动禁用更新，避免覆盖开发源码。

什么时候更适合选择其他项目

• 需要自定义列、多看板、父子依赖、批量操作或复杂任务字段：优先考察 FuncWei、shengsheng90、nexsjournal 或 alpacachen 的实现。
• 需要重复 Cron、模板、验收清单、Agent 自助认领、结构化报告或多仓库镜像：cloader/dsh-taskboard 的任务管理面更完整。
• 需要自定义门禁、GitHub MR、可编排 Pipeline 和多插件组合：jcc1997/dsh-plugins 更灵活。
• 需要一个任务承载多个 Session，并在 Session 间沉淀受控长期记忆：SLin-code/dsh-task-notice-board 更贴合该模型。
• 只想整理现有 Session 或手工规划，不希望插件自动改动仓库：Ericwong、nexsjournal、alpacachen 或 StruggleYang 的方案更轻量。

架构概览

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

快速开始

环境要求

• Node.js ≥ 22.12（pnpm 管理依赖）
• 已安装 DSH（dsh CLI 可用，含 web profile）
• 项目基于 WSL（Ubuntu），以下命令在 WSL 内执行

安装依赖

cd /home/callmesoul/code/deepseek-kanban-plugin
pnpm install

构建

pnpm build        # vite build + wrap-client.mjs，生成 lib/client.js
pnpm watch        # 开发时增量构建

安装到 DSH

普通用户 / 快速体验（从 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 安装的插件支持一键更新。
• 更新器只安装提示中经过主机端校验的最新稳定 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/<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，不会把主仓库留在半合并状态。
• 冲突恢复：在任务 worktree 中把最新基础分支合入任务分支 → 原 Agent 解决冲突 → 系统检查残留冲突标记和未合并索引 → 提交冲突解决结果 → 回到待审查。再次审核通过后才合回基础分支并清理 worktree/任务分支。
• 评论继续：复用已有 worktree 和同一个 Agent 会话，追加 followup 继续改码后重新提交；若原会话无法恢复，任务暂停并保留错误，不创建替代会话。

远程 API（ctx.remote.kanban.*）

调用均返回 { ok: true, value } | { ok: false, error }（见 src/lib/types.ts）。

附件 HTTP 路由：POST /kanban/attachments 接收原始二进制请求体，GET|HEAD /kanban/attachments/:attachmentId?taskId=:taskId 在校验任务归属后返回文件内容。

开发指南

新增一个远程方法

1. lib/index.js：在 KanbanService 添加方法，并加入 markRemoteMethods 注册列表。
2. src/remote.ts：添加对应 descriptor（参数名须与主机方法参数名一致）。
3. src/lib/bridge.ts：在 KanbanApi 接口补充签名。
4. 重新 pnpm build 生成 client.js，重载 DSH 生效。

构建与安装注意

• lib/index.js 为手写源文件，lib/client.js 为构建产物（勿手改）。
• 通过 pnpm 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。
• 改 host 端或客户端代码后，都需要重载 DSH 应用/插件才生效。
• 自动更新以 GitHub Release 为唯一稳定通道；发布时需要同步更新版本号、CHANGELOG.md、Git Tag 和 GitHub Release。

常见问题

Q：「看板任务」为什么能汇总不同项目的会话？ 它是插件在侧边栏提供的虚拟分组，会根据任务记录中的 Agent 会话 ID 汇总展示，不是绑定单一 cwd 的真实 DSH 工作区。插件启动时会迁移会话并清理旧版创建的「{project}看板任务」工作区。

Q：任务详情里改动记录为空？ 改动记录自「记录 agent 最终输出」版本起生效。历史已完成任务是在旧版本执行的，无法回溯补录；新任务执行后即有记录。

Q：为什么改了源码不生效？ 确保已执行 pnpm build 且已重载 DSH 应用。若仍未生效，可 pnpm sync:dsh 重装。

变更记录

详见 CHANGELOG.md。

License

MIT