yangyizhu8/dsh-unread-mark

dsh-unread-mark — 会话行「标记未读 / 取消标记」

在 dsh Web 会话行的 "..." 菜单追加两项，用用户主动的红点钉住「还没处理完」的会话，
与系统绿点（跑完未点开）区分。需求对齐定稿：2026-09-12。

功能

| 会话状态 | 圆点 | 标记未读 | 取消标记 |
|---|---|---|---|
| 绿点（系统「跑完未点开」） | 绿点 | 置灰 | 置灰 |
| 无标记 | — | 可点 | 置灰 |
| 红点（用户主动标记） | 红点 | 置灰 | 可点 |

- 红点语义：会话标题前 8px 红色圆点（#D64545），与系统绿点 slot 同位异色。
- 红点不随刷新/点开消失——这是它与绿点的本质区别：只有手动「取消标记」才消失。
- 绿点存在时两项都禁用（用户明确要求）；置灰为菜单项半透明 + aria-disabled + 原生 disabled。

原理（合同依据，dsh 0.1.1-rc.2 实证）

- 绿点判定：SessionSummary.completed === true 且非运行中、无待交互
（ui-workspace/tree.ts:30 注释原文："Finished running while not selected and not yet opened
(the green 'done' reminder dot)"）。从 ctx.sessions.list.getSnapshot().byId[id] 读取，无需 DOM 探测。
- 菜单注入：轮询 [role=menu] + 语义锚（归档会话/分叉会话）→ 克隆末项 wrapper 追加两项
（沿用 dsh-session-handoff 的 MenuInjector 模式；锚点不匹配即 fail-soft 缺席）。
- 会话身份：React fiber 精确路径（fiberSessionIdOf）→ aria 标题匹配兜底。
- 持久化：host 半 loopback RPC（channel /dsh-unread-mark）+ ~/.dsh/dsh-unread-mark-state.json
（原子写：临时文件 + rename）。端点 list / set / clear。
- 红点渲染：每 1.2s 巡检会话行（div[role=treeitem]）→ 按 host 集合增删红点（幂等）。
拉取失败时本轮不动红点，避免「读失败 = 清空红点」的误删。

安装 / 卸载

安装（开发期热注入；正式转正走 bundles 需停机窗口，同 dsh-session-handoff 工艺）
dsh plugin --profile web add "D:\deepseek-harness\plugins\dsh-unread-mark"

卸载
dsh plugin --profile web remove @dsh-external/dsh-unread-mark
状态文件（如需清空标记）：删除 ~/.dsh/dsh-unread-mark-state.json

准入自检：node scripts/check-plugin-ready.mjs plugins/dsh-unread-mark 全 PASS。

验收证据（2026-09-12，无头 CDP 实测）

- 红点：dotCount=1，位于被标记会话行，background=rgb(214,69,69)、width=8px。
- 菜单注入：六项 = 重命名 / 分叉会话 / 归档会话 / 标记未读 / 取消标记 / 移交会话。
- 状态机（未标记会话）：标记未读可点、取消标记置灰 → 点「标记未读」→ host 集合新增该 id、
页面红点 1→2 → 再开菜单：标记未读置灰、取消标记可点 → 点「取消标记」→ 集合移除、红点 2→1。
- 状态机（已标记会话）：标记未读置灰、取消标记可点。
- 持久化：~/.dsh/dsh-unread-mark-state.json 内容随 set/clear 实时更新；list 端点回读一致。
- 回归：页面 Console 零报错（client 轮询 RPC 全程无 transport 失败）。

已知边界

- 绿点分支未在本机实测（验收时无 completed=true 的会话）：逻辑为 isGreen() 读
SessionSummary.completed（剔除运行中/待交互），与官方 tree.ts 的绿点条件一致；
遇到绿点会话时应表现「两项都置灰」。
- 注入锚点依赖宿主菜单语义（归档会话/分叉会话）与行结构（div[role=treeitem] + fiber
node.id）；宿主升级改结构时 fail-soft 降级为「菜单项缺席 / 红点不渲染」，不抛错、不拖死宿主。
- 红点是浏览器可见态，不写入会话日志；多浏览器/多设备共享同一 host 状态文件（同 ~/.dsh）。