前言¶

在 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 中

1. 启动 DSH Web GUI。
2. 打开「任务看板」。
3. 用「+」或输入框创建任务标题。
4. 拖拽卡片在列之间变更状态。
5. 通过卡片上的编辑按钮修改描述、优先级、截止日期等。

通过 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 为准。