dsh-ws-recency 0.7.1 → 0.7.3

package/README.md

@@ -1,6 +1,6 @@
 # dsh-ws-recency
 
-DSH 侧栏的两件事：**工作区分组按最近活跃排序**、**折叠时只显示 N 条会话**。
+DSH 侧栏的三件事：**工作区分组按最近活跃排序**、**过期历史自动折叠**、**运行中/未读/需跟进三色标记**。单独装上就有效，不依赖其它插件。
 
 ## 一、分组排序
 
@@ -8,8 +8,6 @@ DSH 已经把**组内**会话按 `updatedAt` 倒序排好了（排序方式 =
 
 做法：从 Client store 读每个工作区自己的会话，取组内最大的 `updatedAt`；空工作区回落到该工作区的 `createdAt`；把结果写成各分组元素的 flex `order`。不碰会话行、不碰原生置顶、不碰归档、不改 store。
 
-与 `dsh-plugin-busy-workspace` 共存：busy 会在同一批分组元素上写 `data-busy-rank`（紧急度档位），本插件把它作为**主键**，只负责档位**内部**按活跃度排序。没装 busy 时就是纯最近活跃排序。
-
 ## 二、历史折叠
 
 会话超过 `foldDays`（默认 **3 天**）没有更新就折叠起来；整个工作区都过期时，它只剩一行工作区标题——需要翻历史时点开就行。
@@ -34,8 +32,8 @@ DSH 已经把**组内**会话按 `updatedAt` 倒序排好了（排序方式 =
 
 - 标记存在 Client store 的 `followUps`（随 `dsh.ws-recency.prefs.v1` 持久化），重启后还在；
 - 琥珀圆点渲染在宿主自己的 `sidebar.session.row.leading` 槽里，**不往行里塞子元素**——塞进去会让后面的行整体下移一格；点圆点即取消标记；
-- 标记后该会话**又有新活动**（`updatedAt` 前进）→ 自动视为已跟进，标记消失；
-- 不受 20 秒、不受打开时长影响——你标记就一直是琥珀，直到你取消或它又有新活动。
+- **标记只有你手动取消才会消失**：运行中/完成未读期间它只是被更强的状态盖住显示，跑完、读完（没有新未读）之后琥珀自己回来；
+- 不受打开时长、会话是否继续对话影响——继续对话恰恰常常是还欠一次跟进的原因。
 
 ## 设置
 
@@ -52,25 +50,26 @@ DSH 已经把**组内**会话按 `updatedAt` 倒序排好了（排序方式 =
 - 折叠只能作用于宿主**已经渲染**的行；更早的行仍在宿主自己的「展开其余」之后。
 - “未分组”桶永远排在真实工作区之后。
 - 只在按工作区分组（含工作区树顶层）时生效。
+- **可选互操作**：如果你另外装着 `dsh-plugin-busy-workspace`，本插件会尊重它写在分组上的 `data-busy-rank`，把它的紧急度当主键、档位内部再按活跃度排。没装就是纯最近活跃排序——本插件不依赖它。
 
 ## 安装
 
-从 GitHub：
+npm（推荐，升级最简单）：
 
 ```powershell
-dsh plugin --profile <profile> add github:chyxhtc/dsh-ws-recency
+dsh plugin --profile <profile> add dsh-ws-recency
 ```
 
-或从 Release 的预构建包（版本固定，不会跟着分支漂）：
+或从 GitHub 直装：
 
 ```powershell
-dsh plugin --profile <profile> add https://github.com/chyxhtc/dsh-ws-recency/releases/download/v0.7.1/dsh-ws-recency-0.7.1.tgz
+dsh plugin --profile <profile> add github:chyxhtc/dsh-ws-recency
 ```
 
-发布到 npm 后也可以：
+或固定版本的预构建包：
 
 ```powershell
-dsh plugin --profile <profile> add dsh-ws-recency
+dsh plugin --profile <profile> add https://github.com/chyxhtc/dsh-ws-recency/releases/download/v0.7.3/dsh-ws-recency-0.7.3.tgz
 ```
 
 装完把 `dsh-ws-recency` 加进 `~/.hypers-work/profiles/<profile>/package.json` 的 `dsh.profile.bundles`，重启应用。

package/client.js

@@ -8,9 +8,10 @@
  *      workspace registry order (creation order). This plugin ranks every group
  *      by the freshest `updatedAt` among its own sessions and writes a flex
  *      `order` onto it. Native pins, archive state and the store are untouched.
- *      When dsh-plugin-busy-workspace is installed it writes `data-busy-rank`
- *      (its urgency band) on the same elements; that band is kept as the primary
- *      key and recency only decides the order inside one band.
+ *      OPTIONAL interop: when dsh-plugin-busy-workspace happens to be installed
+ *      it writes `data-busy-rank` (its urgency band) on the same elements; that
+ *      band is then kept as the primary key and recency only decides the order
+ *      inside one band. This plugin never depends on it.
  *
  *   2. HISTORY FOLD - a session that has not been updated for `foldDays` (default
  *      3) is folded away, and a workspace whose own freshest session is older than
@@ -512,8 +513,8 @@
         /**
          * Color the rows: running (blue), finished-unopened (green), and the manual
          * "needs follow-up" flag (amber). The flag is the user's own judgement - it
-         * is never inferred, and it is dropped automatically once the session has
-         * produced newer activity than the moment it was flagged.
+         * is never inferred, and only an explicit clear removes it. Running and
+         * unread outrank it on screen; once they pass, amber comes back.
          */
         function decorateRows(entries, sessions, statuses, settings) {
           var flags = settings.followUps;
@@ -528,13 +529,13 @@
             var status = statusOf(statuses, id);
             var running = status !== null ? status.running === true : session.running === true;
             var unread = status !== null ? status.completionUnread === true : session.completed === true;
-            var flaggedAt = flags[id];
-            if (typeof flaggedAt === "number" && typeof session.updatedAt === "number" && session.updatedAt > flaggedAt) {
-              /* The session moved on after the mark: the follow-up happened. */
-              if (data.actions !== null && typeof data.actions.clearFollowUp === "function") data.actions.clearFollowUp(id);
-              flaggedAt = undefined;
-            }
-            states[id] = running ? "running" : unread ? "unread" : flaggedAt !== undefined ? "followup" : null;
+            /* The mark is the user's own judgement and survives everything except
+               an explicit clear: running / unread only outrank it on screen, and
+               once those pass it comes back. It is never dropped just because the
+               conversation moved on - continuing a conversation is often the very
+               reason a follow-up is still owed. */
+            var flagged = flags[id] !== undefined;
+            states[id] = running ? "running" : unread ? "unread" : flagged ? "followup" : null;
           }
 
           for (var i = 0; i < entries.length; i += 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ws-recency",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Sidebar session management for DeepSeek Harness: workspace groups sorted by latest activity, stale history folded, manual follow-up marks.",
   "license": "MIT",
   "author": "chyxhtc",