前言¶
DeepSeek Harness（DSH）里的插件通常围绕对话、工具和浏览器界面组合使用。对智能体开发者来说，规划、功能拆解和缺陷跟踪很容易散落在聊天记录或外部文档里。dsh-project-kanban 把看板放进 DSH 内部：agent 在对话中使用 kanban_* 工具写规划卡片，看板按工作区（项目）隔离，数据写入磁盘。
这是什么¶
dsh-project-kanban 是 DeepSeek Harness 内的看板插件，由 StruggleYang 维护，许可证为 MIT。
它解决的是“在 DSH 会话中顺手维护项目卡片”的问题：浏览器会话头部提供“看板”tab，agent 工具端可以写规划卡片，数据落到 kanban-board-<workspaceId>.json。
核心能力¶
下面按常见使用顺序列出已核实的插件能力。
- Agent 规划卡片：Agent 使用
kanban_*工具在规划和功能拆解时直接写卡片。 - 按项目隔离：看板按工作区（项目）隔离。
- 磁盘持久化：数据持久化到
kanban-board-<workspaceId>.json。 - 浏览器入口：浏览器会话头部提供“看板”tab。
- 卡片标签与颜色：支持功能、缺陷、文档、优化等标签和颜色，支持任意
#rrggbb自定义卡片颜色。 - 优先级：支持
high/medium/low优先级及颜色条。 - 排序与复制：支持列内排序和一键复制卡片。
- 筛选搜索：支持关键字、标签、优先级筛选和搜索。
- 截止日期：支持
YYYY-MM-DD截止日期和逾期高亮。 - 回收站：支持删除到回收站、恢复或彻底删除。
- 批量操作：支持多选批量移动、打标或移入回收站。
- 统计：支持按标签、优先级和逾期数量统计。
- 拖拽：支持拖拽卡片插入到其他卡片位置。
- 模板列：支持
default/dev/content模板列预设。 - 撤销：支持 50 步撤销。
- 跨项目：支持跨工作区移动卡片。
- 来源会话：支持记录卡片来源会话并跳回。
安装与启用¶
安装前需要已安装 dsh CLI，并选择目标 profile。默认浏览器 profile 为 web。
从 GitHub 安装¶
推荐从 GitHub 安装：
dsh plugin --profile web add github:StruggleYang/dsh-project-kanban
如果 pnpm ≥ 10 首次安装 git 依赖时拒绝运行 prepare script，需要把 pnpm 输出的 package key 写入目标 profile 的 pnpm-workspace.yaml：
allowBuilds:
dsh-project-kanban: true
然后重新执行 add。allowBuilds 会授予安装时代码执行权限，只应对信任源启用。如果考虑固定 commit，可以使用带 commit 的安装形式，例如将 <commit-sha> 替换为实际 commit：
dsh plugin --profile web add github:StruggleYang/dsh-project-kanban#<commit-sha>
从本地仓库安装¶
也可以先克隆仓库，再按本地路径安装：
git clone https://github.com/StruggleYang/dsh-project-kanban.git
dsh plugin --profile web add ./dsh-project-kanban
使用 npm 包名安装¶
如果通过 npm 包名安装：
dsh plugin --profile web add dsh-project-kanban
验证与启用¶
安装后先验证配置层：
dsh --profile web --dump-config
输出应以 # == dsh-project-kanban layer 结尾。
然后重启 dsh web。重启后，kanban_* 工具会出现，会话头部会出现“看板”tab。
卸载¶
卸载命令：
dsh plugin --profile web remove dsh-project-kanban
这会移除依赖和 layer，但看板数据文件会保留在磁盘。
典型用法¶
安装并重启后，可以在对话和浏览器看板之间配合使用。
1、在 DSH 会话中说明需求，例如“把这个需求拆成规划卡片”或“给这张卡片改优先级”。Agent 会通过 kanban_* 工具写入或更新卡片。
2、打开浏览器会话头部的“看板”tab，按关键字、标签或优先级筛选卡片。
3、用列内排序、拖拽卡片插入到其他卡片位置，或进行批量移动、批量打标、批量移入回收站。
4、设置 YYYY-MM-DD 截止日期，关注逾期高亮；统计信息可按标签、优先级和逾期数量查看。
5、如果误操作，可使用 50 步撤销；卡片删除后也可从回收站恢复，或彻底删除。
6、需要跨项目处理时，可将卡片移动到其他工作区的看板；卡片如果由 Agent 创建，也可跳回来源会话。
适用场景与注意¶
这个插件适合已经在 DSH 中做对话式开发、规划或功能拆解的场景，尤其是希望按项目隔离、不需要额外外部任务系统的轻量使用。
使用前建议注意：
- 该插件作为 dsh 插件运行，安装与运行时应视为具有当前
dsh进程权限；安装前请检查源码、依赖和许可证。 allowBuilds会给安装阶段授予代码执行权限，只应对信任源启用，并可考虑固定 commit。- 卸载不会删除看板数据文件，数据仍保留在磁盘。
- 许可证为 MIT © 2026 StruggleYang。
结尾¶
dsh-project-kanban 的价值在于把 DSH 会话中的规划动作落到一个可按项目隔离、可持久化、可撤销的看板里。项目源码和更多说明见 GitHub：
