是什么

截图来自真实 DSH 桌面端：左侧栏「任务看板」→ 主区域。

一个 DSH 插件（host + client 两半）：

• 左侧栏一个「任务看板」入口，点开在主区域铺满三列：待办 / 进行中 / 已完成
• 卡片支持新建、双击改标题、拖拽换列和排序、两步删除、归档
• 卡片可以带提示词：点「执行」就在一个新会话里把这段提示词发出去，agent 直接开干，卡片自动进「进行中」并留下会话链接
• 跑完自动归档：那个会话的 agent 一结束，卡片自己移到「已完成」（可在 ⚙ 里关掉）
• 多块看板：默认看板之外可以新建多块，随手切换、改名、删除（同一份 board.json，互不干扰）
• 按会话过滤：下拉选一个会话，只看它同步/执行过的卡片
• 和会话打通：agent 每次写 todo_write，插件会把 todo 同步成卡片，状态跟着走
• agent 可读写：6 个 kanban_* 工具，agent 能自己建卡、移卡、改卡、删卡
• 落盘：数据存在 $DSH_HOME/integrations/dsh-kanban/board.json，换窗口、重开会话都不丢

安装

插件装进某个 profile（桌面端就是 desktop）。

用 GitHub 地址

dsh plugin --profile desktop add github:dcchanInSz/dsh-kanban

或者打开 DSH 侧边栏的 插件 页面，在安装框里填 github:dcchanInSz/dsh-kanban。

本地开发（改了立刻生效）

git clone https://github.com/dcchanInSz/dsh-kanban.git
cd dsh-kanban && npm install && npm run build

dsh plugin --profile desktop add link:"$PWD"

link: 会建软链接，改完 lib/client.js / lib/index.js 重启插件即可，不必重装。

卸载

dsh plugin --profile desktop remove dsh-kanban

看板数据不会被删；想一起清掉就删 ~/.dsh/integrations/dsh-kanban/。

使用

操作	说明
点左侧栏「任务看板」	打开主区域看板
每列底部「＋ 添加卡片」	第一行是标题，换行后是备注；⌘↩ 提交、Esc 取消
拖动卡片	换列 / 在同列里排序，松手即保存
双击卡片标题	就地改名，回车保存
卡片右下「×」	点两次删除（防误触）
已完成列右上「清空」	一次清掉所有已完成卡片
卡片上 ✨ 的那行	点一下就地编辑提示词；没有提示词的卡片 hover 时出现「＋提示词」
卡片上「▶ 执行」	新建一个会话，把提示词原文发进去跑起来，卡片自动移到「进行中」
卡片上「打开会话」	跳回上次执行这个任务的会话（列表里也有）
右上「默认看板 ▾」	切换看板、新建、重命名、删除（删除要二次确认）
右上「全部会话 ▾」	按会话过滤卡片，只显示这个会话相关的
右上「⚙」	同步会话 todo / 跑完自动进「已完成」两个开关
右上「同步会话 todo」	关掉后 agent 的 todo 不再自动建卡

关于「同步会话 todo」

规则是刻意做得可预测的：

1. agent 调用 todo_write 后，未完成的 todo 建卡进「待办 / 进行中」，已完成的进「已完成」
2. 同一条 todo（按内容哈希 + 会话 id 识别）只会有一张卡，标题跟着 todo 内容更新
3. 你手动拖动过一张同步来的卡片后，它的列就归你了——后续 todo 状态变化不会再把它挪回去
4. 删掉的同步卡片不会被重建（记了墓碑）
5. 关掉开关后，已有的卡保留，新的 todo 不再同步

卡片右上角会标 会话同步（来自 todo）或 agent（工具创建），自己建的不带标。

提示词与执行

一张卡片可以带一条提示词。点「▶ 执行」时插件会：

1. session/create 新建一个会话（用当前工作区；没有就用默认目录）
2. session/prompt 把提示词原文作为用户消息发进去
3. 给卡片记下 lastRun.sessionId，把它移到「进行中」，并跳到那个会话

所以每个任务都是在干净的上下文里跑的，不会污染你正在看的对话；卡片上留「打开会话」，随时能回去看它干到哪了。

自动归档：插件监听 agent/status，看到「这个会话先 running 后 idle」才算一次执行结束，把指向它的卡片移到「已完成」并记下 lastRun.finishedAt。只认这个顺序，所以会话还没真正开跑就 idle 的抖动不会误判。

发给 agent 的只有提示词原文，标题和备注只给人看。执行过的卡片会被标记，之后 todo 同步不会再把它的列改掉。

给 agent 的工具

工具	作用
kanban_list	按列列出所有卡片，附卡片 id
kanban_add	新建卡片（title 必填，可带 note / prompt / column）
kanban_move	移动卡片到指定列
kanban_update	改标题 / 备注 / 提示词
kanban_delete	删除卡片
kanban_sync_todos	立刻把当前会话的 todo 同步一次
kanban_boards	列出所有看板，或新建 / 切换到某块看板

kanban_list / add / move / update / delete 都接受可选的 board（看板名），默认操作当前看板。

对着 agent 说「把这 5 件事排进看板」它就会用 kanban_add 建卡；说「第一件做完了」它会 kanban_move。

数据

$DSH_HOME/integrations/dsh-kanban/board.json（默认 ~/.dsh/integrations/dsh-kanban/board.json）：

{
  "version": 2,
  "revision": 12,
  "activeBoardId": "b_default",
  "boards": [
    {
      "id": "b_default",
      "name": "默认看板",
      "createdAt": 1761400000000,
      "cards": [
    {
      "id": "c_1a2b3c4d",
      "title": "写 README",
      "note": "包含安装说明",
      "column": "doing",
      "createdAt": 1761400000000,
      "updatedAt": 1761400500000,
      "source": { "kind": "todo", "sessionId": "s_abc", "key": "9f2c1e7d3a4b" },
      "todoStatus": "in_progress",
      "prompt": "把 README 的安装章节重写，中文为主",
      "lastRun": { "sessionId": "session-9f2c", "at": 1761400700000, "finishedAt": 1761400900000 },
      "pinned": true
        }
      ]
    }
  ],
  "deleted": [{ "sessionId": "s_abc", "key": "aabbccdd", "at": 1761400600000 }],
  "settings": { "autoSyncTodos": true, "autoCompleteOnRun": true }
}

v1 的旧文件（根上有 cards）会在第一次读取时自动迁移成一块「默认看板」，卡片、提示词、执行记录都保留。

写入是串行的「读-改-写 + 临时文件 + rename」，不会出现半截文件。

结构

lib/index.js         宿主端：board.json 读写、/api/dsh-kanban RPC、kanban_* 工具、todo 同步
lib/client.js        客户端：入口 + 面板（构建产物）
src/client/          面板源码（React + JSX）
  board.jsx            三列看板、拖拽、就地编辑
  index.jsx            注册 main / sidebar.panellist 槽位
  styles.js            样式与主题跟随
  rpc.js               /api 调用封装
  runner.js            「执行」：session/create + session/prompt + 跳转
scripts/build-client.mjs   esbuild 打包（React 走宿主的，不重复打包）
test/host.test.mjs    node:test：存储、RPC、工具、同步语义
dev/harness.html      免安装预览面板
docs/                 截图

开发

npm install
npm run build      # 产出 lib/client.js
npm test           # 11 项宿主测试
npm run build -- --with-harness   # 额外产出 dev/harness.js
open dev/harness.html              # 浏览器里直接调 UI

面板是纯 React，不依赖 DSH 内部的组件库；样式用 CSS 变量，按宿主 color-scheme 自动切亮/暗。

兼容性

• 宿主版本：DSH 0.2.0-rc.2（desktop / web profile）
• 依赖的公开面：slots（main、sidebar.panellist）、connection.fetch.register、connection.rpc.call、tools.register、session/event
• 不 import 任何 @deepseek-ai/* 包：profile 插件只解析自己的 node_modules，硬依赖 DSH 内部包会装出第二份实例

许可

MIT © 2026 dcchanInSz