@xiuda-ai/dsh-taskboard-plugin
DeepSeek Harness 任务看板插件
English · 中文
一个为 DeepSeek Harness 设计的任务看板插件：本地 JSON 存储、六列看板、拖拽排序、任务与会话联动、面向模型的看板工具。逻辑参考 Proma 的任务看板（taskboard-store.ts 与 renderer/components/taskboard/）精简而来——本地文件存储、浮动 sortOrder、乐观锁（version）、identifier 续号、中文看板列与优先级/状态色调。
功能
- 六列看板：待处理 / 处理中 / 受阻 / 待确认 / 已完成 / 已归档（列内卡片过多时独立滚动）
- 多项目：内置全局项目（
local），可新建项目；全局视图聚合所有项目
- 拖拽：拖到列空白（跨列移动 / 追加），拖到某张卡之前（同列排序，浮动
sortOrder）
- 任务编辑器：标题、描述、状态、优先级、标签、指派（用户 / Agent）、起止日期；归档 / 恢复 / 删除
- 任务 ↔ 会话联动：卡片上的「开始对话 / 查看对话」按钮，关联并打开 DSH 会话
- 面向模型的工具：
taskboard_list / taskboard_create / taskboard_update / taskboard_archive，Agent 可直接管理看板
- 本地存储：
~/.dsh/taskboard/{projects.json, tasks.json}，原子写（tmp + rename），无数据库
截图
任务看板
安装
前置条件
- 已安装 DeepSeek Harness（Electron 桌面应用）
- 目标 profile 存在（默认
web）
方式一：npm 安装（发布后推荐）
在目标 profile 目录内安装本包（写入该 profile 的 package.json 依赖）：
cd ~/.dsh/profiles/web
npm install @xiuda-ai/dsh-taskboard-plugin
然后在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: taskboard
name: "@xiuda-ai/dsh-taskboard-plugin"
重启 harness 加载宿主半区；刷新页面加载浏览器半区。
方式二：本地路径（开发 / 尚未发布）
把源码目录链接进 profile 的扁平 node_modules：
ln -sfn /path/to/dsh-taskboard-plugin ~/.dsh/profiles/node_modules/@xiuda-ai/dsh-taskboard-plugin
再按方式一追加 cordis.patch.yml 的 insert 行即可。
从源码构建
npm install
npm run build # 产出 lib/index.js + lib/client.js
npm run dev # 监听 src/ 自动重打包（改完刷新页面）
运行时依赖 @deepseek-ai/cordis / @deepseek-ai/dsh-tools / @deepseek-ai/dsh-home-paths 需能从本包解析。本地开发建议在包内建软链指向 profile 的已安装副本，保持与运行中的 harness 版本一致。
使用
重启后进入任意会话，会话头部右侧会出现「任务面板」胶囊按钮（与「Session log」按钮并排）。点击打开看板：
- 「＋ 新建任务」创建任务
- 拖拽卡片跨列 / 排序
- 卡片上的对话按钮：无关联会话时「开始对话」，有关联时「查看对话」
说明：入口按钮是会话级的，只在进入某个会话后显示；无会话的空白页看不到入口。
卸载
- 删除
~/.dsh/profiles/web/cordis.patch.yml 中的：
- insert:
- id: taskboard
name: "@xiuda-ai/dsh-taskboard-plugin"
- 删除软链：
rm ~/.dsh/profiles/node_modules/@xiuda-ai/dsh-taskboard-plugin
数据目录 ~/.dsh/taskboard/ 默认保留；如需清空数据，删除该目录即可。
目录结构
dsh-taskboard-plugin/
├── package.json # dsh.bundle（组合层）+ dsh.client（浏览器半区）
├── cordis.patch.yml # 把宿主行插入组合的 patch
├── tsconfig.json
├── scripts/build.mjs # esbuild 构建 host + client
├── src/
│ ├── index.ts # Host 插件：存储 + /taskboard API + 模型工具
│ ├── taskboard-store.ts # 存储核心（JSON 原子写 / sortOrder / 乐观锁）
│ ├── types.ts # 共享领域类型
│ └── client/ # 浏览器半区（React 看板）
│ ├── index.ts # 客户端插件：Slot 注册（入口按钮 + 看板弹窗）
│ ├── BoardOverlay.tsx # 看板主体（设置面板式弹窗）
│ ├── Column.tsx # 看板列
│ ├── TaskCard.tsx # 任务卡片
│ ├── TaskEditor.tsx # 任务编辑器
│ ├── SidebarButton.tsx # 会话头部「任务面板」入口
│ ├── labels.ts # 状态 / 优先级 / 色调
│ ├── api.ts / store.ts # 数据访问
│ └── board.css # 样式
└── lib/ # 构建产物（index.js + client.js）
数据存储
~/.dsh/taskboard/
├── projects.json # 项目列表
└── tasks.json # 任务列表（含 sessionId 关联、sortOrder、version 乐观锁）
HTTP API（浏览器半区内部使用）
POST /taskboard/api，body { "op": string, "args": object }：
| op | 说明 |
|---|
state | 返回 { projects, tasks } 全量 |
listProjects / createProject | 项目列表 / 新建 |
listTasks / createTask / updateTask | 任务增改查 |
moveTask | 移动 / 排序（status + 可选 sortOrder） |
archiveTask / restoreTask / deleteTask | 归档 / 恢复 / 删除 |
业务错误返回 { ok:false, error:{ code, message } }，code 可能为 VERSION_CONFLICT（乐观锁冲突）、PROJECT_NOT_FOUND、TASK_NOT_FOUND、INVALID_* 等。
与 Proma 的对应关系
| Proma | 本插件 |
|---|
~/.proma/ 多文件 JSON/JSONL | ~/.dsh/taskboard/ 两个 JSON 文件 |
taskboard-store.ts（浮动 sortOrder、乐观锁、续号） | src/taskboard-store.ts |
taskboard-constants.ts（状态 / 优先级 / 色调） | src/client/labels.ts |
TaskboardView / TaskCard / TaskEditor（Tailwind） | src/client/BoardOverlay.tsx 等（CSS 变量主题） |
main/ipc.ts TASKBOARD 通道 | /taskboard/api JSON 端点 |
| Agent 任务联动 | 模型工具 taskboard_* |
局限
- v1 精简掉了 Proma 的评论、活动时间线、任务关系、附件、重复任务、撤销栈（⌘Z）。
- 同列拖拽用「插入到某张卡之前」的浮动
sortOrder，未做让位动画。
- 客户端样式复用 DSH 主题 CSS 变量，未做独立主题。
- 待立项（
backlog）/ 已取消（canceled）状态仍保留在数据层，但当前 UI 不展示这两列。
