前言¶
在 DSH 里跑 agent，任务往往散在对话里的 todo、口头安排和临时笔记之间，缺少一块固定界面去排期、跟踪进度。单独开 Trello 或 Notion 又要和当前工作区、会话上下文脱节。下面介绍社区插件 dsh-kanban（维护者 dcchanInSz）：在 DSH 左侧栏增加「任务看板」，用待办 / 进行中 / 已完成三列管理卡片，并与 agent 的 todo_write、以及 6 个 kanban_* 工具联动；数据落在本地 board.json，换窗口重开也不丢。
这是什么¶
dsh-kanban 是 DeepSeek Harness 的 profile 插件（host + client），分类属于工作流。宿主端负责 board.json 读写、RPC、kanban_* 工具注册和 todo 同步；客户端在主区域渲染三列看板，支持拖拽与就地编辑。兼容 DSH 0.2.0-rc.2（desktop / web profile），许可证 MIT，当前 package 版本 0.3.1（以仓库 package.json 为准）。
核心功能¶
看板与卡片¶
- 左侧栏入口「任务看板」，主区域默认三列：待办 / 进行中 / 已完成。
- 卡片可新建、双击改标题、拖拽换列与排序、两步删除；已完成列可一键清空。
- 支持多块看板：除默认看板外可新建、切换、重命名、删除（同一份
board.json，互不干扰）。 - 右上可按会话过滤，只显示该会话同步或执行过的卡片。
提示词与执行¶
卡片可附带一条提示词（标题、备注仅给人看，执行时只发提示词原文）。点「▶ 执行」时插件会新建会话、把提示词作为用户消息发出，卡片移到「进行中」并记录会话 id；会话里 agent 从 running 到 idle 后，可在设置中开启跑完自动进「已完成」（监听 agent/status，避免未开跑就 idle 的误判）。
与会话 todo 同步¶
agent 调用 todo_write 后，未完成 todo 对应卡片进待办或进行中，已完成进已完成列。规则在 README 里写得很具体：同一条 todo（内容哈希 + 会话 id）只对应一张卡；手动拖过列的同步卡后续不再被 todo 状态拉回；删掉的同步卡有墓碑，不会重建。右上 ⚙ 可关「同步会话 todo」，已有卡保留、新 todo 不再同步。卡片角标区分「会话同步」「agent 创建」与手动创建。
Agent 工具¶
| 工具 | 作用 |
|---|---|
kanban_list |
按列列出卡片（含 id） |
kanban_add |
新建（title 必填，可选 note / prompt / column） |
kanban_move |
移到指定列 |
kanban_update |
改标题 / 备注 / 提示词 |
kanban_delete |
删除 |
kanban_sync_todos |
立刻同步当前会话 todo |
kanban_boards |
列出 / 新建 / 切换看板 |
上述读写类工具可选 board 参数，默认当前看板。
数据落盘¶
路径：$DSH_HOME/integrations/dsh-kanban/board.json（默认 ~/.dsh/integrations/dsh-kanban/board.json）。写入采用读-改-写、临时文件再 rename；v1 旧格式会在首次读取时迁移到「默认看板」。卸载插件不会删数据，需手动删上述目录。
安装与启用¶
插件装进某个 profile；桌面端一般为 desktop。
先用官方 README 里的 GitHub 安装方式：
dsh plugin --profile desktop add github:dcchanInSz/dsh-kanban
也可以在 DSH 侧边栏 插件 页的安装框填写 github:dcchanInSz/dsh-kanban。
卸载：
dsh plugin --profile desktop remove dsh-kanban
安装前建议浏览 GitHub 仓库 源码与 MIT 许可证。插件以当前 DSH 进程权限运行，能读写其配置的数据目录，请自行评估是否适合你的环境。
典型用法¶
- 安装后点左侧栏「任务看板」，在列底「＋ 添加卡片」写标题（换行可写备注），拖动卡片排期。
- 给任务加提示词，点「▶ 执行」在新会话里跑 agent，用「打开会话」回到执行现场。
- 在对话里让 agent「把这 5 件事排进看板」或「第一件做完了」——它会调用
kanban_add/kanban_move等工具。 - 依赖 todo 同步时保持 ⚙ 里「同步会话 todo」开启；若你更想完全手动画板，可关闭同步，避免新 todo 自动建卡。
常用界面操作（节选）：
| 操作 | 说明 |
|---|---|
| 拖动卡片 | 换列或同列排序，松手即保存 |
| 卡片「×」 | 连点两次删除 |
| 默认看板 ▾ | 切换 / 新建 / 重命名 / 删除看板 |
| 全部会话 ▾ | 按会话过滤卡片 |
本地改插件源码时，README 提供 link: 软链安装方式（需自行 npm install && npm run build）；本文不展开 clone 步骤，见仓库 安装 → 本地开发 小节。
适用场景与注意¶
- 适合：在 DSH 内统一管理 agent 任务、希望 todo 与可视化看板一致、或希望 agent 自主维护看板的开发者。
- 注意：执行任务总是新开会话，不污染当前对话；与 todo 同步冲突时，手动拖拽过的卡以你为准。
- 生态：DSH 社区插件目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系；星标等元数据以目录页为准（当前线索为 0 star）。
结尾¶
dsh-kanban 把列式看板、提示词一键执行、todo 同步和 kanban_* 工具收进 DSH 一侧栏，适合把工作流留在 harness 里闭环。目录页：https://www.skillhub.cn/plugins/dcchanInSz/dsh-kanban；源码与完整说明：https://github.com/dcchanInSz/dsh-kanban。
