dsh-session-curator 0.1.0 → 0.1.1

package/lib/index.js

@@ -2,9 +2,11 @@
  * dsh-session-curator — host 半区。
  *
  * 提供三块能力：
- *   1. 会话软删除：把 `<DSH_HOME>/sessions/<slug>/<sessionId>/` 整个搬到
- *      `<DSH_HOME>/storages/session-manager/trash/<sessionId>/`，并从工作区记账里
- *      摘掉（`Workspace.detachSession`）。可完整恢复。
+ *   1. 会话软删除：先把会话**藏起来**（进 registry-global 的归档集合 —— DSH 里唯一能让它
+ *      从侧边栏所有分组面消失的机制，否则它会以"未分组"的幽灵行留在那里），再把它从
+ *      工作区记账里摘掉（`Workspace.detachSession`），最后把
+ *      `<DSH_HOME>/sessions/<slug>/<sessionId>/` 整个搬到
+ *      `<DSH_HOME>/storages/session-manager/trash/<sessionId>/`。可完整恢复。
  *      ⚠️ 目录名 `session-manager` 是**故意保留的旧名**（见下面 TRASH_SUBPATH 的注释）。
  *   2. 回收站管理：列出 / 恢复 / 永久删除。
  *   3. 归档会话管理：列出全部归档会话（标题、目录、体积），支持批量取消归档、置顶，
@@ -14,7 +16,7 @@
  * `ctx.connection.fetch.register`）：信任检查与会话鉴权由 Connection 的 `/api`
  * 前缀路由先做完，所以插件自己不需要任何鉴权代码。
  */
-import { promises as fsp, existsSync } from "node:fs";
+import { promises as fsp, existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 
@@ -60,6 +62,82 @@ const TRASH_SUBPATH = ["storages", "session-manager", "trash"];
 const META_FILE = "__trash.json";
 const PROJ_FILE = "__projcache.json";
 
+// ── 版本与更新检查 ───────────────────────────────────────────────────────
+/**
+ * 本地版本：`lib/index.js` 的上一级就是包根（无论插件是装在 `node_modules` 里还是被
+ * junction 指过来，`import.meta.url` 都指向真实文件），所以直接读自己的 manifest。
+ */
+const LOCAL_VERSION = readLocalVersion();
+
+function readLocalVersion() {
+    try {
+        const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        return typeof manifest.version === "string" && manifest.version !== "" ? manifest.version : null;
+    } catch {
+        return null;
+    }
+}
+
+/**
+ * 更新检查：问 npm registry 的 `latest` 标签。
+ *
+ * 为什么放在**宿主**而不是客户端直接 fetch：客户端那侧要过 CORS / 可能的 CSP 和桌面端网络
+ * 策略，宿主本来就是普通 Node，顺便还能做超时与缓存。只读 GET，没有任何副作用。
+ */
+const UPDATE_REGISTRY = "https://registry.npmjs.org";
+/** 10 分钟内复用上次结果：打开配置页不该每次都打 registry。 */
+const UPDATE_TTL_MS = 10 * 60 * 1000;
+const UPDATE_TIMEOUT_MS = 5000;
+let updateCache = null;
+
+/**
+ * 宽松 semver 比较：只按数字段比，带 prerelease 后缀的算更低
+ * （`0.1.1` > `0.1.1-rc.1`，`0.2.0` > `0.1.9`）。够判断"有没有新版"，不引依赖。
+ * 导出是为了让 `scripts/smoke.mjs` 直接单测它（浏览器里用不到）。
+ */
+export function compareVersions(left, right) {
+    const parse = (value) => {
+        const [core, ...rest] = String(value).replace(/^v/, "").split("-");
+        return { parts: core.split(".").map((part) => Number.parseInt(part, 10) || 0), prerelease: rest.length > 0 };
+    };
+    const a = parse(left);
+    const b = parse(right);
+    for (let index = 0; index < Math.max(a.parts.length, b.parts.length); index += 1) {
+        const difference = (a.parts[index] ?? 0) - (b.parts[index] ?? 0);
+        if (difference !== 0) return difference > 0 ? 1 : -1;
+    }
+    if (a.prerelease === b.prerelease) return 0;
+    return a.prerelease ? -1 : 1;
+}
+
+async function checkForUpdate(force) {
+    const now = Date.now();
+    if (force !== true && updateCache !== null && now - updateCache.at < UPDATE_TTL_MS) return updateCache.value;
+    const base = { current: LOCAL_VERSION, latest: null, outdated: false, checkedAt: now };
+    let value;
+    try {
+        const response = await fetch(`${UPDATE_REGISTRY}/${name}/latest`, {
+            headers: { accept: "application/json" },
+            signal: AbortSignal.timeout(UPDATE_TIMEOUT_MS)
+        });
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        const body = await response.json();
+        const latest = typeof body?.version === "string" && body.version !== "" ? body.version : null;
+        if (latest === null) throw new Error("registry 没有返回 version 字段");
+        value = {
+            ...base,
+            latest,
+            outdated: LOCAL_VERSION !== null && compareVersions(latest, LOCAL_VERSION) > 0,
+            checkedAt: Date.now()
+        };
+    } catch (error) {
+        // 离线 / 超时 / 代理不通都走这里：界面照常显示版本号，只是没有更新提示。
+        value = { ...base, error: messageOf(error) };
+    }
+    updateCache = { at: Date.now(), value };
+    return value;
+}
+
 // ── 文件系统小工具 ───────────────────────────────────────────────────────
 function trashRoot() {
     return dshHomePath(...TRASH_SUBPATH);
@@ -236,21 +314,31 @@ class SessionManager {
     async buildSnapshot() {
         const registry = this.registry;
         const dirs = await this.scanSessionDirs();
+        const trashed = await this.listTrash();
+        // 回收站条目**只**归回收站页签。删除时我们故意让 id 留在归档集合里（那是 DSH
+        // 唯一"从所有分组面消失"的机制，见 trash()），所以这里必须把交集滤掉：
+        // 否则同一个会话会同时出现在"已归档"和"回收站"，而"已归档"那条还是没有目录的幽灵行。
+        const inTrash = new Set(trashed.map((row) => row.sessionId));
         const archived = [];
         for (const sessionId of registry.archivedSessionIds) {
+            // 顺带把"目录已经不在了"的 id 也滤掉：`archivedSessionIds` 是**只增不减**的记账
+            //（DSH 自己的注释：目录没了的条目照样留在集合里），而 DSH 的侧边栏只从会话清单里
+            // 取行 —— 这种 id 在它那边本来就不显示。列出来只会得到一条 0 B、点不动的幽灵行。
+            if (inTrash.has(sessionId) || !dirs.has(sessionId)) continue;
             archived.push(await this.describeSession(sessionId, dirs));
         }
         const pinned = [];
         for (const sessionId of registry.pinnedSessionIds) {
+            if (inTrash.has(sessionId) || !dirs.has(sessionId)) continue;
             pinned.push(await this.describeSession(sessionId, dirs));
         }
-        const trashed = await this.listTrash();
         let archivedBytes = 0;
         for (const row of archived) archivedBytes += row.bytes;
         let trashBytes = 0;
         for (const row of trashed) trashBytes += row.bytes;
         return {
             dshHome: dshHomePath(),
+            version: LOCAL_VERSION,
             trashDir: trashRoot(),
             sessionsDir: sessionsRoot(),
             archived,
@@ -313,8 +401,20 @@ class SessionManager {
     }
 
     /**
-     * 软删除：移出工作区记账 + 搬到回收站（含投影缓存）。
-     * 归档中的会话先取消归档，这样恢复后它能回到原来的位置。
+     * 软删除：把会话**藏起来**（进归档集合）+ 移出工作区记账 + 搬到回收站（含投影缓存）。
+     *
+     * 为什么是"归档"而不是"取消归档"：DSH 里**唯一**能让一个会话从所有分组面
+     *（侧边栏的工作区分组、**未分组**、置顶）消失的机制，就是 `archivedSessionIds`
+     * 这个 registry-global 集合 —— 它的注释原话是 "sessions hidden from every grouping
+     * surface"，而且归档**不动工作区记账**，槽位留着，所以恢复时位置不变。
+     *
+     * 反过来做（先 `unarchiveSession`）必然出幽灵行：取消归档会把会话重新暴露给
+     * 客户端那份会话列表（`ctx.sessions.list`），而它的目录虽然已经被我们搬走，
+     * 客户端 list 里那条还在 —— 侧边栏 `groupByWorkspace()` 的判定是
+     * "在 list 里 && 不属于任何工作区 && 不在归档集合里" → 落进**未分组**。
+     * 同时归档集合里已经没有它，等于谁也管不住这条幽灵行了。
+     *
+     * 原来是否归档记在 `__trash.json` 的 `wasArchived` 里，恢复时照原样还原。
      */
     async trash(ids) {
         await fsp.mkdir(trashRoot(), { recursive: true });
@@ -329,9 +429,17 @@ class SessionManager {
             const info = dirs.get(sessionId);
             if (!info) throw new Error("找不到会话日志目录（可能已被删除）");
 
-            if (this.registry.archivedSessionIds.includes(sessionId)) {
-                await this.registry.unarchiveSession(sessionId);
-                steps.push("unarchive");
+            // 必须**趁目录还在**归档：`archiveSession` 要先通过 `sessionKnown()`
+            //（live 会话 / 头部索引 / 持久化清单），搬走之后三者都查不到了。
+            const wasArchived = this.registry.archivedSessionIds.includes(sessionId);
+            if (!wasArchived) {
+                try {
+                    await this.registry.archiveSession(sessionId);
+                    steps.push("archive");
+                } catch (error) {
+                    // 藏不住不该阻止删除：会话可能继续留在侧边栏，但数据照样进回收站。
+                    steps.push(`archive-failed:${messageOf(error)}`);
+                }
             }
             // 置顶的会话也要先取消置顶：否则它的 id 还留在 pinnedSessionIds 里，
             // 搬进回收站之后会同时出现在"已置顶"和"回收站"两个页签。
@@ -375,6 +483,9 @@ class SessionManager {
                         cwd: projection.cwd,
                         workspaceId: workspace ? String(workspace.id) : null,
                         workspaceTitle: workspace ? workspace.title : null,
+                        // 删除前是否已经归档 —— 恢复时要照原样还原（老条目没有这个字段，
+                        // 一律按"没归档过"处理，也就是恢复成普通会话）。
+                        wasArchived,
                         deletedAt: Date.now()
                     },
                     null,
@@ -386,7 +497,14 @@ class SessionManager {
         });
     }
 
-    /** 从回收站恢复；尽力把会话重新挂回原工作区。 */
+    /**
+     * 从回收站恢复；尽力把会话重新挂回原工作区，并把归档状态还原成删除前的样子。
+     *
+     * `trash()` 会把会话塞进归档集合（藏起来），所以这里必须配对处理：
+     *   - 删除前**已经归档**（`wasArchived: true`）→ 保持归档，它就回到"已归档"页签；
+     *   - 其余（含老版本写下的、没有这个字段的条目）→ 取消归档，恢复成普通会话。
+     * 不还原的话，恢复出来的会话会莫名其妙地"还在已归档里"。
+     */
     async restore(ids) {
         const dirs = await this.scanSessionDirs();
         return this.each(ids, async (sessionId) => {
@@ -423,6 +541,12 @@ class SessionManager {
                 // 元数据残留无害
             }
 
+            // 归档状态先还原，再挂回工作区：attachSession 要读得到会话头（目录已经回来了）。
+            if (meta.wasArchived !== true && this.registry.archivedSessionIds.includes(sessionId)) {
+                await this.registry.unarchiveSession(sessionId);
+                steps.push("unarchive");
+            }
+
             if (typeof meta.cwd === "string" && meta.cwd !== "") {
                 try {
                     const workspace = await this.registry.resolveByPath(meta.cwd);
@@ -438,14 +562,32 @@ class SessionManager {
         });
     }
 
-    /** 永久删除（不可恢复）。 */
+    /**
+     * 永久删除（不可恢复）。
+     *
+     * 先取消归档：`trash()` 为了让会话从侧边栏消失而把它放进了归档集合，永久删除之后
+     * 再没人会去动这条 id —— 留在集合里就是一条**永久幽灵**（DSH 自身会一直以为它归档着，
+     * 界面上又找不到它）。
+     */
     async purge(ids) {
         return this.each(ids, async (sessionId) => {
             const target = join(trashRoot(), sessionId);
             if (!existsSync(target)) throw new Error("回收站里没有这个会话");
+            const steps = [];
+            if (this.registry.archivedSessionIds.includes(sessionId)) {
+                await this.registry.unarchiveSession(sessionId);
+                steps.push("unarchive");
+            }
             await fsp.rm(target, { recursive: true, force: true });
+            steps.push("purge");
+            return steps;
         });
     }
+
+    /** 更新检查：只读，结果在模块级缓存（见 checkForUpdate）。 */
+    checkUpdate(force) {
+        return checkForUpdate(force);
+    }
 }
 
 // ── 传输 / 分发 ──────────────────────────────────────────────────────────
@@ -480,7 +622,8 @@ const ENDPOINTS = {
     unpin: (manager, payload) => manager.unpin(payload.ids),
     trash: (manager, payload) => manager.trash(payload.ids),
     restore: (manager, payload) => manager.restore(payload.ids),
-    purge: (manager, payload) => manager.purge(payload.ids)
+    purge: (manager, payload) => manager.purge(payload.ids),
+    "check-update": (manager, payload) => manager.checkUpdate(payload.force === true)
 };
 
 /** 只接受字符串数组；其余一律忽略，避免把宿主路径当 id 传来的越权尝试。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-curator",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DeepSeek Harness plugin: soft-delete sessions to a recoverable trash and manage archived/pinned ones, grouped by their original workspace folder. | DSH 插件：会话软删除到可恢复的回收站，并按原来的工作区文件夹管理已归档 / 已置顶会话。",
   "type": "module",
   "main": "lib/index.js",

package/scripts/activation.mjs

@@ -115,7 +115,7 @@ function assertFetchRoute(route) {
 	if (new Set(route.methods).size !== route.methods.length) throw new Error(`connection: exact Fetch route ${JSON.stringify(route.path)} repeats a method`);
 }
 
-const ENDPOINTS = ["snapshot", "archive", "unarchive", "pin", "unpin", "trash", "restore", "purge"];
+const ENDPOINTS = ["snapshot", "archive", "unarchive", "pin", "unpin", "trash", "restore", "purge", "check-update"];
 const CHANNEL = "/api";
 const PREFIX = "session-curator";
 const ROUTE_PREFIX = `${CHANNEL}/${PREFIX}`;

package/scripts/client.mjs

@@ -24,6 +24,17 @@ globalThis.window = {
 		}
 	}
 };
+/** 内存版 localStorage：设置持久化走的就是它（浏览器里是 window.localStorage）。 */
+const fakeStorage = new Map();
+globalThis.localStorage = {
+	getItem: (key) => (fakeStorage.has(key) ? fakeStorage.get(key) : null),
+	setItem: (key, value) => {
+		fakeStorage.set(key, String(value));
+	},
+	removeItem: (key) => {
+		fakeStorage.delete(key);
+	}
+};
 
 // ── 迷你 React：够跑一次挂载 + 若干次重渲染 ──────────────────────────────
 const runtime = { index: 0, values: [], callbacks: [], records: [], pending: [], dirty: false };
@@ -103,6 +114,8 @@ const PRIMITIVE_NAMES = [
 	"Menu",
 	"MenuItemButton",
 	"Modal",
+	"SegmentedControl",
+	"Switch",
 	"IconChevronDownOutlineRegular",
 	"IconChevronRightOutlineRegular",
 	"IconEllipsisOutlineRegular",
@@ -243,6 +256,7 @@ check("the ⋯ trigger is dimmed like the sidebar's row actions", rowMenuElement
 // ── B. 整块面板：假 ctx 调 apply()，拿到真正注册的面板组件后渲染 ─────────
 const SNAPSHOT = {
 	dshHome: "C:\\Users\\Motues\\.dsh",
+	version: "0.1.0",
 	trashDir: "C:\\Users\\Motues\\.dsh\\storages\\session-manager\\trash",
 	sessionsDir: "C:\\Users\\Motues\\.dsh\\sessions",
 	archived: [
@@ -258,12 +272,18 @@ const SNAPSHOT = {
 const slots = [];
 let dictionaries = null;
 const hostCalls = [];
+/** 更新检查的假回答；置 null 表示这次让宿主失败（测错误分支）。 */
+let updateResponse = { current: "0.1.0", latest: "0.1.1", outdated: true, checkedAt: 0 };
 const fakeCtx = {
 	get: (name) => (name === "connection"
 		? {
 			rpc: {
 				call: async (channel, endpoint, payload) => {
 					hostCalls.push({ channel, endpoint, payload });
+					if (endpoint.endsWith("check-update")) {
+						if (updateResponse === null) return { ok: false, error: { code: "session-curator/error", message: "registry 不通" } };
+						return { ok: true, value: updateResponse };
+					}
 					return { ok: true, value: SNAPSHOT };
 				}
 			}
@@ -297,6 +317,9 @@ const tPanel = (key, params) => {
 	return value;
 };
 
+/** 官方侧边栏的视图存储：预置成"显示已归档"，用来验证配置页那个开关读的是同一份设置。 */
+globalThis.localStorage.setItem("dsh.workspace.view.v5", JSON.stringify({ groupBy: "flat", orderBy: "updated", archivedFilter: "show" }));
+
 let tree = await render(section.component, { t: tPanel });
 const nodesOf = (current, type) => collect(current, []).filter((node) => node.type === type);
 const headers = () => nodesOf(tree, client.GroupHeader);
@@ -389,6 +412,134 @@ check("trash tab groups by the recorded workspace folder too", headers().length
 check("trash rows offer restore + permanent delete", menuOfRow("s-9").props.items.map((item) => item.id).join(",") === "restore,purge", menuOfRow("s-9").props.items.map((item) => item.label).join(" · "));
 check("trash rows keep the same single-⋯ shape", draw(rowsSeen()[0]).children[2].children.length === 1);
 
+// ── 配置页：动作在右上、基础设置、版本号与升级提示 ───────────────────────
+// 面板根节点的第 1 个子节点就是顶部条：左边页签组，右边动作组。
+const headerOf = () => tree.children[0];
+const tabBarOf = () => headerOf().children[0];
+const actionsOf = () => headerOf().children[1];
+/** 页签那一组是 `tabs.map(...)` 的结果，迷你渲染器把它当**一个**子节点存着，所以要递归收集。 */
+const tabButtons = () => collect(tabBarOf(), []).filter((node) => node.type === "Button");
+const tabLabels = () => tabButtons().map((node) => node.children[0]).join(" | ");
+const actionButtons = () => (actionsOf() === null ? [] : actionsOf().children.filter(Boolean));
+const switchNodes = () => nodesOf(tree, "Switch");
+/** 按 label（面板传的就是本地化过的名字）找控件，比按下标稳。 */
+const switchByLabel = (label) => switchNodes().find((node) => node.props.label === label);
+const segmentedNodes = () => nodesOf(tree, "SegmentedControl");
+const spanWith = (prefix) => collect(tree, []).find((node) => node.type === "span" && typeof node.children?.[0] === "string" && node.children[0].startsWith(prefix));
+
+check(
+	"the three data tabs stay on the top-left, with 配置 appended",
+	tabButtons().length === 4 && tabLabels() === "已归档 (3) | 已置顶 (1) | 回收站 (1) | 配置",
+	tabLabels()
+);
+check(
+	"分组 and 刷新 moved to the top-right actions group",
+	actionsOf() !== null && actionsOf().props.style.marginInlineStart === "auto" && actionButtons().length === 2
+		&& actionButtons()[0].children[0].startsWith("分组") && actionButtons()[1].children[0] === "刷新",
+	`marginInlineStart=${actionsOf()?.props.style.marginInlineStart} buttons=${actionButtons().map((node) => node.children[0]).join(", ")}`
+);
+check("both right-hand buttons carry a visible border (outline variant)", actionButtons().every((node) => node.props.variant === "outline"), actionButtons().map((node) => node.props.variant).join(", "));
+check("the tab buttons stay in the left group (not among the actions)", tabButtons().every((node) => node.props.variant !== "outline"), tabButtons().map((node) => node.props.variant).join(", "));
+
+// 打开配置页。
+buttonByLabel("配置").props.onClick();
+tree = await render(section.component, { t: tPanel });
+check("the config tab drops the list-only actions from the right", headerOf().children[1] === null && tabLabels().endsWith("配置"), tabLabels());
+check("the config page renders 4 switches and 2 segmented controls", switchNodes().length === 4 && segmentedNodes().length === 2, `${switchNodes().length} switch(es), ${segmentedNodes().length} segmented`);
+check(
+	"the default-tab control offers exactly the three data tabs (never 配置 itself)",
+	segmentedNodes()[0].props.options.map((option) => option.value).join(",") === "archived,pinned,trash",
+	segmentedNodes()[0].props.options.map((option) => option.label).join(", ")
+);
+check(
+	"the about block shows the version in small light text",
+	spanWith("版本") !== undefined && spanWith("版本").children[0] === "版本 v0.1.0"
+		&& spanWith("版本").props.style.fontSize === "11px" && spanWith("版本").props.style.color === "var(--dsw-alias-label-tertiary)",
+	spanWith("版本")?.children?.[0]
+);
+check(
+	"an outdated version renders the notice plus the exact upgrade command",
+	JSON.stringify(tree).includes("有新版本 0.1.1（当前 0.1.0）")
+		&& JSON.stringify(tree).includes("升级步骤")
+		&& JSON.stringify(tree).includes("dsh plugin --profile desktop add dsh-session-curator@latest"),
+	String(spanWith("有新版本")?.children?.[0])
+);
+check("opening the config tab really asked the host for updates", hostCalls.some((entry) => entry.endpoint.endsWith("check-update")), hostCalls.map((entry) => entry.endpoint).join(", "));
+
+// ── 侧边栏"显示已归档"：读写的必须是官方那份设置（dsh.workspace.view.v5） ──
+const SIDEBAR_SWITCH = "侧边栏显示已归档会话";
+check(
+	"the sidebar-archived switch mirrors the official setting (seeded to show archived)",
+	switchByLabel(SIDEBAR_SWITCH) !== undefined && switchByLabel(SIDEBAR_SWITCH).props.checked === true,
+	String(switchByLabel(SIDEBAR_SWITCH)?.props.checked)
+);
+check("no refresh hint before the sidebar value is touched", !JSON.stringify(tree).includes("已写入官方设置"));
+
+switchByLabel(SIDEBAR_SWITCH).props.onChange(false);
+tree = await render(section.component, { t: tPanel });
+const sidebarView = JSON.parse(globalThis.localStorage.getItem("dsh.workspace.view.v5"));
+check(
+	"turning it off writes only archivedFilter into the official key",
+	sidebarView.archivedFilter === "default" && sidebarView.groupBy === "flat" && sidebarView.orderBy === "updated",
+	JSON.stringify(sidebarView)
+);
+check(
+	"the plugin's own settings key is not polluted by it",
+	JSON.parse(globalThis.localStorage.getItem("dsh-session-curator.settings")).archivedFilter === undefined,
+	globalThis.localStorage.getItem("dsh-session-curator.settings")
+);
+check(
+	"a refresh hint appears, because the official store only reads that key when it is created",
+	JSON.stringify(tree).includes("已写入官方设置")
+		&& collect(tree, []).some((node) => node.type === "Button" && node.children?.[0] === "刷新页面"),
+	JSON.stringify(collect(tree, []).filter((node) => node.type === "Button").map((node) => node.children?.[0]))
+);
+
+// 设置真的生效：关掉"行内显示体积与文件数"，回已归档页签看行。
+switchByLabel("行内显示体积与文件数").props.onChange(false);
+tree = await render(section.component, { t: tPanel });
+check(
+	"a switch writes the setting through to localStorage",
+	JSON.parse(globalThis.localStorage.getItem("dsh-session-curator.settings")).showMeta === false,
+	globalThis.localStorage.getItem("dsh-session-curator.settings")
+);
+buttonByLabel("已归档").props.onClick();
+tree = await render(section.component, { t: tPanel });
+const slimMeta = rowsSeen().map((node) => metaOf(draw(node)));
+check(
+	"showMeta = false drops size and file count from every row",
+	slimMeta.length === 3 && slimMeta.every((meta) => !meta.includes(" B") && !meta.includes("个文件")),
+	JSON.stringify(slimMeta)
+);
+
+// 排序：按体积降序（组内），组间照旧按文件夹名。
+buttonByLabel("配置").props.onClick();
+tree = await render(section.component, { t: tPanel });
+segmentedNodes()[1].props.onChange("bytes");
+tree = await render(section.component, { t: tPanel });
+buttonByLabel("已归档").props.onClick();
+tree = await render(section.component, { t: tPanel });
+check(
+	"order = bytes sorts rows inside each group",
+	rowsSeen().map((node) => node.props.row.sessionId).join(",") === "s-3,s-2,s-1",
+	rowsSeen().map((node) => node.props.row.sessionId).join(",")
+);
+
+// 检查失败：显示原因，不谎报"已是最新"。
+buttonByLabel("配置").props.onClick();
+tree = await render(section.component, { t: tPanel });
+updateResponse = null;
+const recheck = collect(tree, []).find((node) => node.type === "Button" && node.children?.[0] === "检查更新");
+recheck.props.onClick();
+tree = await render(section.component, { t: tPanel });
+check(
+	"a failed check shows the reason instead of claiming to be current",
+	JSON.stringify(tree).includes("检查更新失败") && !JSON.stringify(tree).includes("已是最新版本")
+		&& collect(tree, []).some((node) => node.props.style?.color === "var(--dsw-alias-state-error-primary)"),
+	String(spanWith("检查更新失败")?.children?.[0])
+);
+updateResponse = { current: "0.1.0", latest: "0.1.1", outdated: true, checkedAt: 0 };
+
 // ── 设置页 id：导航栏图标是「按 id 查表」的（外壳的 navIcon()） ──────────
 check('with an empty ledger the section borrows the "archived-sessions" id (archive glyph in the nav)', sectionIdWith(() => []) === "archived-sessions");