前言¶
在 DeepSeek Harness（DSH）里跑智能体或长会话时，任务往往散落在对话记录、临时笔记或外部工具里，换机器或重启后也不一定能对齐状态。DSH 社区采用「一切皆插件」的扩展方式；dsh-kanban 是维护者 15217814598 发布的工作流类插件，把任务管理嵌进 DSH Web GUI，用看板列表示进度，并把数据落到本地 SQLite，而不是单独再开一套项目管理 SaaS。
下面介绍插件定位、已文档化的能力、安装步骤和典型用法。社区目录页（SkillHub）与 GitHub 仓库相互独立索引，均不与 DeepSeek / 幻方构成官方应用商店关系。
这是什么¶
dsh-kanban（npm 包名 dsh-kanban-plugin，当前版本 1.1.0）是 DeepSeek Harness Web GUI 的热插拔任务看板插件：任务管理、拖拽排序、状态跟踪与持久化存储。许可证为 MIT，仓库地址 https://github.com/15217814598/dsh-kanban，目录页 https://www.skillhub.cn/plugins/15217814598/dsh-kanban。
插件在 Cordis 侧通过 cordis.patch.yml 注册为 kanban 服务，客户端面向 web 平台注入 DSH 客户端运行时，在侧边栏或顶部导航提供「任务看板」入口。
核心功能¶
README 中明确列出的能力如下。
看板与交互
- 三列布局：待办、进行中、已完成（列标题与颜色可在配置中覆盖）。
- 任务在列之间拖拽移动；支持低 / 中 / 高 / 紧急四档优先级、截止日期与详细描述。
- 数据持久化到本地，不依赖浏览器临时存储 alone。
HTTP API
插件暴露 REST 风格端点，前缀为 /api/dsh-kanban/tasks，支持列表、单条查询、创建、更新、按列移动与删除。创建与移动任务的 JSON 字段在 README 中有示例（如 priority、tags、dueDate，移动时使用 status 与 order）。
存储与迁移
- 使用 Node 内置
node:sqlite（DatabaseSync），库文件路径为$DSH_HOME/dsh-kanban.db；DSH_HOME缺省为~/.dsh。 - 日志模式为 WAL，
synchronous=NORMAL；卸载插件时会 checkpoint 并关闭数据库。 - 自动任务与飞书相关配置保存在同库的
settings表，重启后加载；首次启动会尝试从旧的dsh-kanban.json以及 auto-task / feishu 旧配置文件导入，原文件改名为.bak保留。
README 未展开自动任务调度规则、kanban_* 原生工具调用方式或飞书同步协议细节；若你需要这些能力，应以仓库内 skills 目录及后续文档为准，安装前建议通读源码。
环境与依赖¶
- DeepSeek Harness ≥ 0.2.1-rc.3（依赖 sessionController 投递、session/event 钩子与原生工具注册）。
- Node ^22.13.0 或 ≥24.0.0（见
package.json的engines）。
安装与启用¶
在已安装 DSH CLI 的机器上，从 GitHub 源安装（README 推荐方式）：
dsh plugin --profile web add github:15217814598/dsh-kanban
本地开发时可指向目录：
dsh plugin --profile web add link:/path/to/dsh-kanban
安装完成后启动 DSH Web GUI，在界面中找到任务看板入口即可使用。
可选配置写入 cordis.patch.yml 的 insert 段（与仓库示例一致），例如启用插件、任务上限与列定义：
- insert:
- id: kanban
name: 'dsh-kanban'
config:
enabled: true
maxTasks: 1000
columns:
- id: todo
title: '待办'
color: '#6b7280'
- id: in-progress
title: '进行中'
color: '#3b82f6'
- id: done
title: '已完成'
color: '#22c55e'
典型用法¶
在 Web GUI 中
- 启动 DSH Web GUI。
- 打开「任务看板」。
- 用「+」或输入框创建任务标题。
- 拖拽卡片在列之间变更状态。
- 通过卡片上的编辑按钮修改描述、优先级、截止日期等。
通过 API
创建任务示例（路径与方法以 README 为准）：
POST /api/dsh-kanban/tasks
{
"title": "完成项目文档",
"description": "编写 README 和 API 文档",
"priority": "high",
"tags": ["文档", "项目"],
"dueDate": "2026-09-01"
}
将任务移入「进行中」并列首：
PATCH /api/dsh-kanban/tasks/:id/move
{
"status": "in-progress",
"order": 0
}
自动化脚本或同一 DSH 进程内的其他插件，可按上表 HTTP 方法与路径对接，无需重复实现看板 UI。
适用场景与注意¶
适合谁
- 已在 DSH Web GUI 中工作、希望任务状态与 Harness 会话同屏管理的开发者。
- 需要本地 SQLite 持久化、并可能从旧版 JSON / auto-task / feishu 配置迁移的用户。
使用前请注意
- 插件以当前 DSH 进程权限读写
~/.dsh（或你设置的DSH_HOME）下的数据库与备份文件；安装前应检查源码与 MIT 许可证，确认可接受的数据落盘范围。 - 目录页简介可能概括「自动任务、原生工具、飞书同步」等方向；README 正文对 UI、API 与存储描述最完整，扩展能力以仓库实际代码为准。
- 自行从源码构建时需 Node 22.13+ / 24+，执行
npm install与npm run build（分步为build:server/build:client）。
结尾¶
dsh-kanban 把三列看板、拖拽与 REST 任务 API 收进 DSH Web 插件体系，并用 SQLite 统一任务与部分 settings 配置。若你要评估或安装，可从目录页 https://www.skillhub.cn/plugins/15217814598/dsh-kanban 进入，详细命令与 API 以 GitHub https://github.com/15217814598/dsh-kanban README 为准。
