dsh-workspace-session-filter 1.0.1 → 1.0.3

package/README.md

@@ -4,16 +4,17 @@
 
 给 DSH 侧边栏加两个入口：
 
-1. **侧边栏底部的筛选条** —— 设置按钮上方单独一行，`运行中` 与 `待确认` 两个 chip
-   （各自带命中数）。点一下向上弹出按工作区分组的会话列表，点行直接进会话，是日常主入口；
+1. **侧边栏底部的筛选条** —— 设置按钮上方单独一行，`运行中` / `待确认` / `未读` 三个
+   chip（各自带命中数）。点一下向上弹出按工作区分组的会话列表，点行直接进会话，是日常主入口；
 2. 侧边栏面板列表里的「会话筛选」图标 —— 打开中间栏的完整视图，顶部是
-   `全部 / 运行中 / 等待确认 / 更多` 筛选器，`更多` 里是 `最近一天 / 最近三天 /
+   `全部 / 运行中 / 等待确认 / 未读 / 更多` 筛选器，`更多` 里是 `最近一天 / 最近三天 /
    最近一周 / 最近一个月`（外加 `不限时间`）。
 
 ## 功能
 
-- **按状态筛选**：底部只放 `运行中`（含子智能体仍在跑）与 `待确认`（审批、计划审阅、
-  待回答）两个 chip，各自带当前命中数；完整面板另有 `全部` 用于浏览。
+- **按状态筛选**：底部只放三个 chip —— `运行中`（含子智能体仍在跑）、`待确认`（审批、
+  计划审阅、待回答）、`未读`（跑完但没看，或最近有新内容你没打开过），各自带当前命中数；
+  完整面板另有 `全部` 用于浏览。
 - **就在手边**：点 chip 向上弹出按工作区分组的列表，点行直接进会话，再点同一个 chip 收起；
   侧边栏收成窄条时换成带合计角标的圆形按钮，展开后同样能筛。
 - **单独一行**：筛选条占满侧边栏那一行，不和成本计等其他底部条目挤在一起。
@@ -49,6 +50,9 @@ profile 目录里的 pnpm，装完再读包里的 `dsh.bundle.patch` 自动登
 `dsh.profile.bundles`，因此不用手改 profile 的 `package.json`）：
 
 ```bash
+# 从 npm registry 装（1.0.1 起可用，最省事）
+dsh plugin --profile desktop add dsh-workspace-session-filter
+
 # 从 GitHub 装（pnpm 会锁定解析到的 commit）
 dsh plugin --profile desktop add github:shijiewang/dsh-workspace-session-filter
 
@@ -75,13 +79,14 @@ dsh plugin --profile desktop remove dsh-workspace-session-filter
 
 装好后：
 
-- 侧边栏**底部**（设置按钮上方、单独一行）出现 `运行中 N` / `待确认 N` 筛选条；
+- 侧边栏**底部**（设置按钮上方、单独一行）出现 `运行中 N` / `待确认 N` / `未读 N` 筛选条；
 - 侧边栏面板列表里出现「会话筛选」图标，指向中间栏的完整视图。
 
 卸载：`plugin_manager({ action: "remove_bundle", target: "dsh-workspace-session-filter" })`。
 
-> 包名 `dsh-workspace-session-filter` 与仓库同名，`dsh plugin` 用 git spec、tarball 或
-> 目录路径都能装；发布到 npm registry 后，也可以直接把包名交给 `dsh plugin add`。
+> 包名 `dsh-workspace-session-filter` 与仓库同名。截至 1.0.3，npm registry、
+> GitHub、release tarball、本地目录四种来源都能装；registry 上是 `npm publish` 发出的
+> 正式版本，`repository` 字段指回本仓库。
 
 ## 结构
 
@@ -101,14 +106,19 @@ dsh plugin --profile desktop remove dsh-workspace-session-filter
   上下文之后。
 - **筛选条落位**：注册在 `sidebar.footer.action`（设置按钮上方的一行槽位），整条占满宽度；
   弹层用 `position: fixed` 贴在 chip 上方（`bottom: innerHeight - rect.top + 8`），因为侧边栏
-  容器 `overflow` 会裁掉绝对定位的浮层。宽版渲染两个 chip，窄条（`wide: false`）渲染一个
-  36px 圆按钮。
+  容器 `overflow` 会裁掉绝对定位的浮层。宽版渲染三个 chip，窄条（`wide: false`）渲染一个
+  36px 圆按钮，角标是三个数字之和。
 - **数据来源**：`main` slot 提供的标准 props — `useSessions`（会话快照）、
   `useWorkspaces`（工作区快照）、`useSessionStatus`（状态 Map），全部是
   `SnapshotSelectorHook`，必须传 selector。
 - **样式**：只用 `--dsw-alias-*` / `--dsw-*` 设计令牌，数值对齐内置列表页
   （960px 内容宽、`clamp(24px,4vw,48px)` 内边距、28px chip、32px 行高、菜单 4px 内衬
   + `--dsw-elevation-prominent`），类名前缀 `dwsf-`。
+- **未读的判定**：两个来源叠加 —— ① 状态 Map 里的 `completionUnread`（内置列表画完成点的
+  同一个信号，覆盖"跑完没看"）；② 本插件自己记的"最后查看时间表"，存 `localStorage`
+  （key `dsh-workspace-session-filter:seen.v1`），会话 `updatedAt` 比它新就算有新内容。
+  维护方式：当前打开的会话每次渲染都刷新时间戳，点任意行也算读过，首次见到的会话先建基线
+  （所以新装不会满屏未读）。`未读` 与 `运行中`/`待确认` 互斥计数，行右侧会多出 `未读` 文案。
 - **容错**：面板与左下筛选条各包一层错误边界（`PanelBoundary` / `FooterBoundary`），
   渲染异常时分别退化成空状态 / 什么都不渲染，不会让中间栏变白或拖坏侧边栏；
   标准 hooks 缺失时先打日志再降级。

package/client.js

@@ -30,6 +30,7 @@ window.__ModuleLoader__.load({
       'filter.running': '运行中',
       'filter.awaiting': '等待确认',
       'filter.awaitingShort': '待确认',
+      'filter.unread': '未读',
       'filter.more': '更多',
       'filter.reset': '清除筛选',
       'filter.aria': '会话筛选条件',
@@ -68,6 +69,7 @@ window.__ModuleLoader__.load({
       'filter.running': 'Running',
       'filter.awaiting': 'Awaiting confirmation',
       'filter.awaitingShort': 'Awaiting',
+      'filter.unread': 'Unread',
       'filter.more': 'More',
       'filter.reset': 'Clear filters',
       'filter.aria': 'Session filters',
@@ -208,11 +210,79 @@ window.__ModuleLoader__.load({
       return parts.length > 0 ? parts[parts.length - 1] : ''
     }
 
+    /* ------------------------------------------------------------------ *
+     * Last-seen stamps
+     *
+     * The shipped status map only flags a turn that finished while the session
+     * was not on screen (`completionUnread`). Everything else that bumps a
+     * session — queued work, a subagent settling, an edit made elsewhere —
+     * leaves `updatedAt` moving without any flag, so the "unread" dimension
+     * remembers when this panel last saw a session and counts newer activity.
+     * The map lives in localStorage so it survives reloads; an unknown session
+     * is baselined on first sight, which keeps a fresh install quiet.
+     * ------------------------------------------------------------------ */
+    const SEEN_KEY = 'dsh-workspace-session-filter:seen.v1'
+    const seenCache = { loaded: false, map: {}, timer: null }
+
+    function seenStorage() {
+      try {
+        return typeof localStorage === 'undefined' ? null : localStorage
+      } catch (error) {
+        return null
+      }
+    }
+
+    function loadSeen() {
+      if (seenCache.loaded) return seenCache.map
+      seenCache.loaded = true
+      const store = seenStorage()
+      if (!store) return seenCache.map
+      try {
+        const parsed = JSON.parse(store.getItem(SEEN_KEY) || 'null')
+        if (parsed && typeof parsed === 'object') seenCache.map = parsed
+      } catch (error) {
+        seenCache.map = {}
+      }
+      return seenCache.map
+    }
+
+    function flushSeen() {
+      const store = seenStorage()
+      if (!store) return
+      try {
+        const ids = Object.keys(seenCache.map)
+        if (ids.length > 400) {
+          ids.sort((left, right) => (seenCache.map[right] || 0) - (seenCache.map[left] || 0))
+          for (const id of ids.slice(400)) delete seenCache.map[id]
+        }
+        store.setItem(SEEN_KEY, JSON.stringify(seenCache.map))
+      } catch (error) {
+        /* quota or private mode: the bookkeeping is best effort */
+      }
+    }
+
+    function markSeen(sessionId, stamp) {
+      if (!(stamp > 0)) return
+      const map = loadSeen()
+      const previous = map[sessionId]
+      if (previous !== undefined && previous >= stamp) return
+      map[sessionId] = stamp
+      if (seenCache.timer === null && typeof setTimeout === 'function') {
+        seenCache.timer = setTimeout(() => { seenCache.timer = null; flushSeen() }, 400)
+      }
+    }
+
     /** One flat row model, mirroring the shipped sidebar's status precedence. */
-    function buildRow(summary, status, subagents, t) {
+    function buildRow(summary, status, subagents, t, lastSeen) {
       const kind = pendingKindOf(status)
       const running = status && status.running !== undefined ? status.running === true : Boolean(summary.running)
       const completed = Boolean(status && status.completionUnread === true)
+      const activityNew = completed !== true
+        && kind === undefined
+        && running !== true
+        && subagents === 0
+        && lastSeen !== undefined
+        && (Number(summary.updatedAt) || 0) > lastSeen
       let dot = 'idle'
       let label = ''
       if (kind !== undefined) {
@@ -228,6 +298,9 @@ window.__ModuleLoader__.load({
         label = t('status.subagentsRunning', { n: subagents })
       } else if (completed) {
         dot = 'done'
+        label = t('filter.unread')
+      } else if (activityNew) {
+        label = t('filter.unread')
       }
       return {
         id: summary.id,
@@ -238,6 +311,7 @@ window.__ModuleLoader__.load({
         label,
         awaiting: kind !== undefined,
         running: running || subagents > 0,
+        unread: completed || activityNew,
       }
     }
 
@@ -266,17 +340,27 @@ window.__ModuleLoader__.load({
         if (archived.has(summary.id)) continue
         if (cutoff && !(summary.updatedAt >= cutoff)) continue
         const status = statuses ? statuses.get(summary.id) : undefined
-        const row = buildRow(summary, status, runningSubagents(list, summary.id, statuses || new Map()), t)
+        const stamp = Number(summary.updatedAt) || 0
+        const seen = loadSeen()
+        let lastSeen = seen[summary.id]
+        if (summary.id === currentId || lastSeen === undefined) {
+          markSeen(summary.id, stamp)
+          if (lastSeen === undefined) lastSeen = stamp
+        }
+        const row = buildRow(summary, status, runningSubagents(list, summary.id, statuses || new Map()), t, lastSeen)
         rows.set(summary.id, row)
         base.push(row)
       }
 
       const matches = (row) => statusFilter === 'all'
-        || (statusFilter === 'running' ? row.running : row.awaiting)
+        || (statusFilter === 'running' ? row.running
+          : statusFilter === 'awaiting' ? row.awaiting
+            : row.unread)
       const counts = {
         all: base.length,
         running: base.filter((row) => row.running).length,
         awaiting: base.filter((row) => row.awaiting).length,
+        unread: base.filter((row) => row.unread).length,
       }
 
       const groups = []
@@ -502,7 +586,10 @@ window.__ModuleLoader__.load({
 
       const now = Date.now()
       const view = deriveView(props, statusFilter, range, now)
-      const onOpen = props.onOpen
+      const onOpen = (sessionId) => {
+        markSeen(sessionId, Date.now())
+        props.onOpen(sessionId)
+      }
       const filtered = statusFilter !== 'all' || range !== null
 
       return h('div', { className: 'dwsf-page' },
@@ -526,6 +613,10 @@ window.__ModuleLoader__.load({
                 label: t('filter.awaiting'), count: view.counts.awaiting, active: statusFilter === 'awaiting',
                 onClick: () => setStatusFilter(statusFilter === 'awaiting' ? 'all' : 'awaiting'),
               }),
+              h(FilterTab, {
+                label: t('filter.unread'), count: view.counts.unread, active: statusFilter === 'unread',
+                onClick: () => setStatusFilter(statusFilter === 'unread' ? 'all' : 'unread'),
+              }),
               filtered
                 ? h('button', {
                     type: 'button',
@@ -653,6 +744,7 @@ window.__ModuleLoader__.load({
       const now = Date.now()
       const view = deriveView(props, mode, null, now)
       const onOpen = (sessionId) => {
+        markSeen(sessionId, Date.now())
         setOpen(false)
         props.onOpen(sessionId)
       }
@@ -671,7 +763,8 @@ window.__ModuleLoader__.load({
 
       const filters = h('div', { className: 'dwsf-footChips', role: 'group', 'aria-label': t('filter.aria') },
         chip('running', t('filter.running'), view.counts.running),
-        chip('awaiting', t('filter.awaitingShort'), view.counts.awaiting)
+        chip('awaiting', t('filter.awaitingShort'), view.counts.awaiting),
+        chip('unread', t('filter.unread'), view.counts.unread)
       )
 
       const popover = open && anchor !== undefined
@@ -696,7 +789,7 @@ window.__ModuleLoader__.load({
         : null
 
       if (!wide) {
-        const waiting = view.counts.running + view.counts.awaiting
+        const waiting = view.counts.running + view.counts.awaiting + view.counts.unread
         return h('div', { ref: rootRef, className: 'dwsf-footRail' },
           popover,
           h('button', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-workspace-session-filter",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Workspace session filter panel with status and recency filters.",
   "type": "module",
   "exports": {