dsh-task-board

任务看板 · DSH Task Board

> 钉在 DeepSeek Harness 侧边栏上的一张任务看板。把不同工作区的会话排成卡片停在板上——进度写在卡面上，点开是独立浮动窗口，多开互不打扰。

---

实拍：看板按工作区分区，右侧同时开着多张浮动窗口；卡片上直接显示运行状态与最近输出。

它解决的五个问题

用 DSH 同时跑多个任务时，侧边栏会变得很难用。任务看板针对五个具体痛点给出了对应解法。

1️⃣ 左侧栏里「工作区和会话对不上号」→ 关注工作区 + 分区展示

左栏把不同工作区的会话混在一起，想知道某个会话属于哪个目录，得一个个点开看。

• 点「关注工作区」，把工作区排到看板上，一个工作区一列，它名下的会话卡片各归其位；
• 分区可拖拽排序，顺序会记住；工作区多时可切成 1 / 2 / 3 行布局；
• 分区里没有任务才能取消关注，还有任务的分区会被拦住——卡片不会因为取消关注而「凭空消失」；
• 工作区被删了？卡片进入「未绑定工作区」兜底列，永远找得到。

2️⃣ 左侧会话「进度不直观」→ 卡片实时预览 + 一键继续

侧边栏只告诉你「在跑」或「没在跑」，看不出跑到哪了。

• 卡片直接显示它此刻在干什么：⚙ 调用了什么工具（Bash · npm test）、✎ 正在写、思考中并计时；
• 状态栏在非运行状态（已完成 / 已停止 / 故障停止 / 需决策 / 空闲）后面附带上次更新距今时间（刚刚 / 5分钟 / 2天），和左侧会话列表同一套口径，不用打开会话就知道多久没动过；
• 卡片底部是最近一条输出的预览，悬停展开全文；
• 静默检测：运行中超过 60 秒没有任何事件就显示「静默 1:05」，超过 5 分钟标红，卡死一眼可见；
• 失败或停止的卡片右下角有「▶ 继续」——不用打开窗口，直接给该会话补发一条「继续」，让它接着干。

3️⃣ 「一次只能看一个会话」→ 浮窗式多会话查看

• 点开卡片 → 弹出浮动窗口，里面就是这个任务完整的会话（消息流、输入框、待确认提问，和主界面完全一致）；
• 可以同时开多个窗口，拖拽移动、八向缩放（四边 + 四角），互不抢焦点；
• 点 − 或按 Esc 收回当前浮窗（以最后点选或刚打开的窗口为准），会话引用立即释放，卡片回到原来分区的位置；
• 窗口里的任务正在跑时，Esc 仍归 DSH 的「双击中止」所有——先停下，再按 Esc 收回窗口；
• 窗口会自动避开应用标题栏、被拖出屏幕会自动拉回，不会失联。

4️⃣ 「状态不明确、重点不突出」→ 按关注度排序

同一分区内的卡片自动按「需要你处理的程度」排序：

故障停止 → 需决策 → 运行中 → 已停止 → 已完成 → 空闲 → 草稿

扫一眼就知道该先管谁，而不是在十几个会话里翻找。

5️⃣ 「记得聊过，但翻不到」→ 板内搜索 + 定位高亮

板上的任务一多，回头找某句话只能一张张点开翻。

• 顶部「关注工作区」左侧的 🔍 输入关键词，只搜板上已有卡片的会话正文——不把看板变成第二个会话浏览器；
• 范围可选「全部工作区」，或勾选其中几个已关注工作区；草稿卡（还没有会话）自动跳过；
• 点一条结果：打开对应浮窗 → 向前翻到命中位置 → 滚动到那条消息，高亮命中文字；
• 匹配是字面的（不区分大小写，空白宽松），不做分词、同义词或语义检索；
• 不依赖 FTS 索引（走官方 ctx.sessionQuery.filterEvents 的只读扫描），默认配置即可用；代价是每次搜索要读卡片对应的会话日志，所以做了输入防抖与 15 秒结果缓存。

> 定位是尽力而为：平台没有「打开会话并滚到第 N 条」的一等 API，命中在很久以前时可能只打开会话、无法自动翻到；此时不会强行滚动。

细节适配

和 DSH 本体的运行环境磨合后补上的几处：

• 会话完成状态透传：Host 从会话事件里读出每个 Turn 的真实结局（完成 / 失败 / 中止），原样透传到卡片并随卡片持久化——DSH 重启后，失败也不会被误读成「已完成」。
• rewind 联动：浮动窗口嵌入的是标准会话内容，[dsh-rewind](https://github.com/SiriLee/dsh-rewind)（dsh-rewind-plugin，[npm](https://www.npmjs.com/package/dsh-rewind-plugin)）的 /rewind、/undo（回退对话与文件）在窗口里照常可用，回退后卡片照常跟踪状态。
• 蓝色文件标签直达目录：会话里蓝色的文件标签，点一下直接在系统文件管理器打开文件所在目录（Windows 会选中该文件），不再依赖右侧预览栏。
• 独立的置顶会话：钉住（📌）的卡片独立于排序规则，永远置顶并按创建顺序排列——排序是「系统帮你挑」，钉住是「我说了算」。

性能与数据存储优化

• 原子写：临时文件 + 原子重命名，写到一半断电也不会留下坏文件。
• 结局持久化，重启不误判：Turn 结局随卡片落盘，Host 重启、页面重开都不会把失败/中止误判为完成。
• .bak 备份：卡片数变少时先把上一版存为 board.json.bak——看板被意外清空还能找回。
• 八向缩放：四边 + 四角共 8 个方向，最小 340×240，放大缩小都从你抓住的那条边开始。
• 位置记忆：同一张卡再次打开时沿用上次的尺寸与位置（本页面会话内，不写盘）。

还有两件小事

• 峰谷时钟：看板顶部居中的徽标显示此刻 DeepSeek 处于计费峰时还是谷时——工作日 9:00–12:00 / 14:00–18:00（北京时间）为峰，其余时段半价；谷时显示距下一个峰时的倒计时，方便挑便宜的时候跑大任务。
• 中英双语与无障碍：内置 zh / en 文案；卡片支持键盘操作（Tab 聚焦，Enter / 空格打开）；尊重系统「减少动态效果」设置。

安装

前置：已安装 DSH（DeepSeek Harness）并至少有一个 profile（如 web、desktop）。

# 从 GitHub 安装（推荐）
dsh plugin --profile web add git+https://github.com/MWGE22629/dsh-task-board.git

# 或从 GitLink 安装
dsh plugin --profile web add git+https://www.gitlink.org.cn/GeDaamn/dsh-task-board.git

# 或从本地目录安装（开发时）
dsh plugin --profile web add link:D:/path/to/dsh-task-board

然后把包名加入该 profile 的 package.json 中 dsh.profile.bundles 数组：

{
  "dsh": {
    "profile": {
      "bundles": ["…", "@local/dsh-task-board"]
    }
  }
}

重启 DSH，侧边栏出现「任务看板」图标即安装完成。

> 注：本插件包名为 @local/dsh-task-board（历史原因），安装命令与 bundles 都按此名引用。

快速上手

1. 点击侧边栏的任务看板图标。

2. 点右上角「关注工作区」，选一个工作区排到板上（可多选，一次一个）。

3. 在分区右上角点「+」新建一张任务卡，点开卡片，在浮动窗口里写下第一条指令，按 Enter 发送（Shift+Enter 换行）——DSH 会在该工作区创建会话并开始执行。

4. 也可以不新建：把侧边栏里的已有会话拖到看板上，或点会话行上的「加入看板」，它就会变成一张卡片。

5. 卡片跑到「已完成 / 故障停止 / 已停止」时状态一目了然；失败或停止的卡片点「▶ 继续」让 AI 接着干。

6. 想找某句话：点顶部「关注工作区」左侧的 🔍，输入关键词，命中结果点一下就会打开对应浮窗并滚到那条消息。