READMESource: main@ceda7a37
DPH 任务看板(@dph/taskboard)— DeepSeek Harness 客户端插件
在 Harness 侧边栏「工作区」搜索图标左侧提供任务看板入口(与搜索按钮同款样式)。
完全会话化:看板上的每一张卡片就是一个真实会话(harness session),卡片 = 会话, 拖拽归类 = 给会话打状态标记,新建卡片 = 真正新建一个会话。

功能
- 侧边栏入口:工作区搜索图标左侧的看板按钮(wide / 窄栏 rail 两种形态)
- 四列状态看板:待办 / 进行中 / 评审中 / 已完成,拖拽归类,彩色状态标识
- 会话总览列:未归类会话集中显示,点击卡片进入会话
- 完全会话化:
- 卡片 = 会话;看板显示与侧边栏一致(隐藏子代理 / 归档 / 空白会话)
- 新建会话:命名 + 选模型 + 推理强度 + 开始消息 + 选择分组(跟随当前 / 已有分组 / 新建分组)
- 删除会话 → 进回收站(可恢复,恢复后回到原列)
- 运行状态点:正在处理的会话卡片右上角有呼吸闪烁的「处理中」标记
- 备注:每个会话可附加描述 / 优先级(低中高紧急)/ 标签,存浏览器 localStorage
- 搜索:按会话标题 / 备注 / 标签过滤
- 导出 / 导入:打勾自由选择会话,导出 JSON 备份(含归类、备注、新会话标记),导入前有覆盖确认
- Agent 可读快照:宿主侧把看板状态落盘
~/.dsh/storages/taskboard.json, 模型(Agent)可用文件工具读取分析
数据保存在浏览器 localStorage(key: dph.taskboard.v1)。
插件形态
插件不是安装包,而是一个标准文件夹 + harness 配置里的一行注册:
dph-taskboard/
├── package.json # @dph/taskboard;dsh.client 声明(platform: web + 服务注入)
├── lib/index.js # 宿主侧:快照落盘 + 会话恢复(unarchive)
├── lib/client.js # 浏览器端代码(构建产物,由 src/client/index.js 生成)
├── src/client/index.js # 客户端源码(改代码改这里)
├── scripts/
│ ├── build.mjs # src/client → lib/client.js
│ ├── deploy.mjs # 一键安装:构建 + 复制到 harness 模块区 + 写注册行
│ ├── mount-ui-workspace.mjs # ui-workspace 挂载点补丁(幂等;--revert 回滚)
│ └── restart-harness.sh # 一键重启 harness(按端口精确停止/启动/验证)
├── smoke-test.mjs # 冒烟测试(自动先构建)
├── INSTALL.md # 详细安装指南
└── README.md # 本文件
安装后出现在 harness 模块区:~/.dsh/profiles/node_modules/@dph/taskboard/
安装
前置条件:本机装有 DeepSeek Harness(dsh web 可用)、Node.js 18+。
# 1) 获取插件
git clone <你的仓库地址> dph-taskboard
cd dph-taskboard
# 2) 一键安装(自动:构建 → 复制到 harness 模块区 → 写入注册行)
node scripts/deploy.mjs
# 3) 重启 harness 生效(重启会中断当前会话;看板数据在浏览器 localStorage 不丢)
node scripts/restart-harness.sh
# 或手动:dsh --profile web
# 4) 浏览器打开 harness,刷新页面
# 侧边栏工作区搜索图标左侧出现任务看板按钮
若
dsh命令不在 PATH:用完整路径/Users/<你的用户名>/.local/bin/dsh --profile web, 或先export PATH="$HOME/.local/bin:$PATH"。
注意:若 harness 从 npx 缓存运行(启动命令含
~/.npm/_npx/...), ui-workspace 挂载补丁需要打到对应副本:node scripts/mount-ui-workspace.mjs --target=<npx副本的 dsh-client-ui-workspace/lib/client.js 路径>
验证安装
curl -s "http://127.0.0.1:3080/plugins/@dph/taskboard/client.js" -o /dev/null -w "%{http_code}\n" # 应为 200
# 或看 harness 启动日志 / 浏览器 F12 Console 是否有 [dph-taskboard] 输出
开发 / 迭代
node scripts/build.mjs # 改完 src/client/index.js 后重新构建
node scripts/deploy.mjs # 重新部署(客户端 HMR 热载,刷新页面即可)
node smoke-test.mjs # 冒烟测试
卸载
node scripts/mount-ui-workspace.mjs --revert # 移除 ui-workspace 挂载点
rm -rf ~/.dsh/profiles/node_modules/@dph/taskboard # 删除插件文件
# 从 ~/.dsh/profiles/web/cordis.patch.yml 删除 taskboard 注册段
# 重启 harness
许可
MIT License
No comments yet. Be the first to write one.