dsh-remote-bridge 2.3.5 → 2.3.7

package/README.en.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-v2.3.5-087f8c">
+  <img alt="Version" src="https://img.shields.io/badge/version-v2.3.6-087f8c">
   <img alt="DSH plugin" src="https://img.shields.io/badge/DeepSeek_Harness-plugin-1f2328">
   <img alt="Platforms" src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-586069">
   <img alt="License" src="https://img.shields.io/badge/license-AGPL--3.0-2da44e">
@@ -34,7 +34,11 @@ The desktop entry lives **inside your DSH settings**: look for the section title
 
 Remote access remains disabled until a local administrator chooses a bind address, port, and initial device permissions.
 
-> This section used to carry two UI screenshots, but both showed the pre-rename interface (titled "DSH 文件工作区"; the remote-access one was still labelled v1.0.0 and showed the file tree and settings as two stacked dialogs). They no longer match the shape described above, so they were removed rather than left to mislead. Re-recording needs a browser environment that can drive the plugin panel, which is not available here.
+![Phone settings — the Roots card, open by default](assets/screenshots/panel-roots.png)
+
+> **About these screenshots.** The four images under `assets/screenshots/` are generated by `scripts/generate-screenshots.ts`, which renders the panel from the same sources the tests use — `ADMIN_TABS`, `WORKSPACE_CSS` and `APP_QR_CODES` out of `src/client/` — so what you see is the shipped markup and stylesheet, not a redrawn mock-up. They show a machine that has just installed the plugin and not yet enabled remote access, which is the honest default state. An earlier revision of this README carried two UI screenshots; both predated the rename and showed the file tree and settings as two stacked dialogs, so they were removed rather than left to mislead.
+>
+> Storefronts pick these up automatically from [`screenshots.json`](./screenshots.json) — no pull request, no waiting on a maintainer. Update the images and push; the next build takes them.
 
 ## About the rename (2.0.4)
 
@@ -73,10 +77,10 @@ dsh plugin --profile web add dsh-remote-bridge
 dsh plugin --profile web add dsh-remote-bridge --registry https://registry.npmmirror.com
 
 # 2. tarball from the GitHub release
-dsh plugin --profile web add https://github.com/westanke/dsh-remote-bridge/releases/download/v2.3.5/dsh-remote-bridge-v2.3.5.tgz
+dsh plugin --profile web add https://github.com/westanke/dsh-remote-bridge/releases/download/v2.3.6/dsh-remote-bridge-v2.3.6.tgz
 
 # 3. tarball from the Gitee release (faster from mainland China)
-dsh plugin --profile web add https://gitee.com/westanke/dsh-remote-bridge/releases/download/v2.3.5/dsh-remote-bridge-v2.3.5.tgz
+dsh plugin --profile web add https://gitee.com/westanke/dsh-remote-bridge/releases/download/v2.3.6/dsh-remote-bridge-v2.3.6.tgz
 
 npx @deepseek-ai/dsh web
 ```
@@ -93,7 +97,7 @@ Restart DSH after installation, then open settings — The section is titled **
 To install a downloaded release archive:
 
 ```sh
-dsh plugin --profile web add ./dsh-remote-bridge-v2.3.5.tgz
+dsh plugin --profile web add ./dsh-remote-bridge-v2.3.6.tgz
 ```
 
 ## First connection
@@ -323,15 +327,15 @@ pnpm check
 pnpm pack
 ```
 
-`pnpm check` covers type-checking, documentation consistency, and tests. It currently passes **19 test files / 113 cases**, plus **3 browser-layer cases** (Playwright measuring real computed styles).
+`pnpm check` covers type-checking, documentation consistency, and tests. It currently passes **30 test files / 226 cases**, plus **4 browser-layer cases** (Playwright measuring real computed styles).
 
-`npm pack` produces roughly a **0.25 MB** archive: 2.2.0 dropped the standalone page and its editor dependencies and turned source maps off, down from 1.72 MB.
+`npm pack` produces roughly a **0.29 MB** archive: 2.2.0 dropped the standalone page and its editor dependencies and turned source maps off, down from 1.72 MB.
 
-v2.3.5 was developed against DSH `master@47f943859bef60e4160492346772ded9b24f765a`. CI covers Windows, Ubuntu, and macOS.
+v2.3.6 was developed against DSH `master@47f943859bef60e4160492346772ded9b24f765a`. CI covers Windows, Ubuntu, and macOS.
 
 ## Project
 
-- Version: `v2.3.5`
+- Version: `v2.3.6`
 - Author: upstream [Hakunm](https://github.com/Hakunm); this fork maintained by [westanke](https://github.com/westanke)
 - Repository: [GitHub](https://github.com/westanke/dsh-remote-bridge) · [Gitee](https://gitee.com/westanke/dsh-remote-bridge)
 - npm: [`dsh-remote-bridge`](https://www.npmjs.com/package/dsh-remote-bridge) ([mainland-China mirror](https://registry.npmmirror.com/dsh-remote-bridge))

package/README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-v2.3.5-087f8c">
+  <img alt="Version" src="https://img.shields.io/badge/version-v2.3.6-087f8c">
   <img alt="DSH plugin" src="https://img.shields.io/badge/DeepSeek_Harness-plugin-1f2328">
   <img alt="Platforms" src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-586069">
   <img alt="License" src="https://img.shields.io/badge/license-AGPL--3.0-2da44e">
@@ -32,6 +32,12 @@
 
 远程访问默认关闭。管理员可在本机 WebUI 中设置绑定 IP、端口和新设备的初始权限。
 
+![手机设置 —— 默认展开的「根目录」卡片](assets/screenshots/panel-roots.png)
+
+> **关于这几张截图。** `assets/screenshots/` 下的四张图由 `scripts/generate-screenshots.ts` 生成，它用与测试同一份产出来源渲染面板 —— `ADMIN_TABS`、`WORKSPACE_CSS`、`APP_QR_CODES` 全部取自 `src/client/`，所以你看到的是**发布包里的标记与样式表**，不是另画的示意图。图中呈现的是一台刚装好插件、尚未启用远程访问的机器，这是最诚实的默认状态。本 README 早前曾放过两张界面截图，但都摄于改名之前（标题还是「DSH 文件工作区」，远程访问那张还标着 v1.0.0，且把文件树与设置显示成上下两个弹窗），与上文描述的形态已不符，于是撤掉而不是留着误导。
+>
+> 市场会从 [`screenshots.json`](./screenshots.json) 自动取用这些图 —— 不必再来提 PR、不必等维护者。换了图直接推自己的仓库即可，下一次构建自动生效。
+
 
 ## 关于改名（2.0.4）
 
@@ -70,10 +76,10 @@ dsh plugin --profile web add dsh-remote-bridge
 dsh plugin --profile web add dsh-remote-bridge --registry https://registry.npmmirror.com
 
 # ② GitHub Release 的 tarball
-dsh plugin --profile web add https://github.com/westanke/dsh-remote-bridge/releases/download/v2.3.5/dsh-remote-bridge-v2.3.5.tgz
+dsh plugin --profile web add https://github.com/westanke/dsh-remote-bridge/releases/download/v2.3.6/dsh-remote-bridge-v2.3.6.tgz
 
 # ③ Gitee Release 的 tarball（国内访问更快）
-dsh plugin --profile web add https://gitee.com/westanke/dsh-remote-bridge/releases/download/v2.3.5/dsh-remote-bridge-v2.3.5.tgz
+dsh plugin --profile web add https://gitee.com/westanke/dsh-remote-bridge/releases/download/v2.3.6/dsh-remote-bridge-v2.3.6.tgz
 
 npx @deepseek-ai/dsh web
 ```
@@ -89,7 +95,7 @@ npx @deepseek-ai/dsh web
 从 GitHub Release 下载离线安装包时，可直接安装 tarball：
 
 ```sh
-dsh plugin --profile web add ./dsh-remote-bridge-v2.3.5.tgz
+dsh plugin --profile web add ./dsh-remote-bridge-v2.3.6.tgz
 ```
 
 ## 第一次使用
@@ -315,15 +321,15 @@ pnpm check
 pnpm pack
 ```
 
-`pnpm check` 覆盖类型检查、文档一致性与测试；当前 **19 个测试文件 / 113 个用例**，外加 **3 个浏览器层用例**（Playwright 实测量出的计算样式），全部通过。
+`pnpm check` 覆盖类型检查、文档一致性与测试；当前 **30 个测试文件 / 226 个用例**，外加 **4 个浏览器层用例**（Playwright 实测量出的计算样式），全部通过。
 
-`npm pack` 的产物约 **0.25 MB**：2.2.0 删除独立页及其编辑器依赖、并关闭 source map 之后，从 1.72 MB 降下来。
+`npm pack` 的产物约 **0.29 MB**：2.2.0 删除独立页及其编辑器依赖、并关闭 source map 之后，从 1.72 MB 降下来。
 
-v2.3.5 基于 DSH `master@47f943859bef60e4160492346772ded9b24f765a` 开发，CI 覆盖 Windows、Ubuntu 和 macOS。
+v2.3.6 基于 DSH `master@47f943859bef60e4160492346772ded9b24f765a` 开发，CI 覆盖 Windows、Ubuntu 和 macOS。
 
 ## 项目信息
 
-- 当前版本：`v2.3.5`
+- 当前版本：`v2.3.6`
 - 作者：上游 [Hakunm](https://github.com/Hakunm)，本 fork 维护 [westanke](https://github.com/westanke)
 - 仓库：[GitHub](https://github.com/westanke/dsh-remote-bridge) · [Gitee](https://gitee.com/westanke/dsh-remote-bridge)
 - npm：[`dsh-remote-bridge`](https://www.npmjs.com/package/dsh-remote-bridge)（[国内镜像](https://registry.npmmirror.com/dsh-remote-bridge)）

package/docs/api/asyncapi.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.0.0
 info:
   title: DeepSeek Harness Mobile Events
-  version: 2.3.5
+  version: 2.3.7
   description: |
     Live file and authorized DSH chat events. Reconnect clients must refresh
     REST state; unbounded replay is not provided.

package/docs/api/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: DeepSeek Harness Mobile API
-  version: 2.3.5
+  version: 2.3.7
   description: Versioned file and chat BFF for mobile and third-party DSH clients. HTTP and HTTPS are both supported.
 servers:
   - url: http://127.0.0.1:3090/api/v1
@@ -24,7 +24,7 @@ paths:
                 properties:
                   ok: { type: boolean, const: true }
                   version: { type: string, const: v1 }
-                  pluginVersion: { type: string, const: 2.3.5 }
+                  pluginVersion: { type: string, const: 2.3.7 }
   /pairings/exchange:
     post:
       security: []

package/kotlin-sdk/build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = "ai.deepseek.dsh"
-version = "2.3.5"
+version = "2.3.7"
 
 repositories { mavenCentral() }
 

package/lib/index.d.ts

@@ -626,6 +626,15 @@ interface WorkspaceRegistryLike {
     updatedAt: string;
     sessionIds?: readonly string[];
   }[];
+  /**
+   * 注册表级（registry-global）归档集合：被归档、应从**所有**分组界面隐藏的会话 id。
+   *
+   * 内核 `dsh-workspace` 的 `WorkspaceRegistry` 用 getter 暴露它
+   * （`lib/types/index.d.ts` 的 `get archivedSessionIds(): readonly SessionId[]`），
+   * 且 `ctx.workspaceRegistry` 就是这个实体。声明成可选：老内核或测试替身可能没有，
+   * 读不到时退化成空集合，只是过滤失效，不该让整条列表读崩掉。
+   */
+  readonly archivedSessionIds?: readonly string[];
 }
 interface SettingsControllerLike {
   describe(): {
@@ -707,8 +716,15 @@ interface Dsh02HostServices {
    * Cordis event bus of the host context. Used for the two facts the old
    * `apiProxy` event streams carried that no controller returns: session
    * registry changes and the approval answerer waterfall.
+   *
+   * `options.prepend` 是 Cordis `EventsService.on` 的原生选项（cordis 4.0.2
+   * `src/events.ts:143`、`:255`：`const method = options.prepend ? 'unshift' : 'push'`）。
+   * 审批与提问两个钩子**必须**传 `{ prepend: true }` —— 原因见
+   * `ApprovalBridge.attach` 与 `QuestionBridge.attach` 的注释。
    */
-  on(event: string, listener: (...args: any[]) => unknown): () => void;
+  on(event: string, listener: (...args: any[]) => unknown, options?: {
+    prepend?: boolean;
+  }): () => void;
 }
 /**
  * 需要交接时，把每个 `image` 部件换成**两行文本**；否则原样返回。

package/lib/index.js

@@ -1995,7 +1995,7 @@ var ApprovalBridge = class {
 			});
 			if (outcome === "delegate") return next();
 			return outcome;
-		});
+		}, { prepend: true });
 	}
 	async respond(message) {
 		const entry = this.pending.get(message.rpcId);
@@ -2115,7 +2115,7 @@ var QuestionBridge = class {
 				rpcId
 			});
 			return await delegate;
-		});
+		}, { prepend: true });
 	}
 	/**
 	* 回答一条**正挂在前台等待**的提问（App 通过 `POST …/answer` 打进来）。
@@ -2182,12 +2182,30 @@ function isUserQuestionAnswerLike(value) {
 		return Array.isArray(entry.selected) && entry.selected.every((label) => typeof label === "string");
 	});
 }
-/** Best-effort projection of an Agent identity to its session id. */
+/**
+* Best-effort projection of an Agent identity to its session id.
+*
+* 内核侧有两个真相来源，顺序不能反：
+* - `Agent.id` **就是** `SessionId`（`dsh-agent/lib/types/types.d.ts:11-14` 的
+*   `readonly id: SessionId`，运行时由 `dsh-agent-loop/lib/index.js:773` 的
+*   `this.id = id` 赋值）。这是直给的那个，必须第一个查；
+* - `agent.session` 是 `dsh-session` 的 **class** `Session`，它**没有** `id` 属性 ——
+*   session id 挂在 `header.id`（`SessionHeader.id`）。只查 `session.id` 永远落空。
+*
+* 这两条都曾经被漏掉，代价极大：审批与提问两个 waterfall 监听都以
+* 「`sessionId === undefined` → 原样交给下游」收场，于是**电脑端一切正常、手机端
+* 一张卡都没有** —— 而且失败是静默的，两侧日志都不会说一句话。
+*/
 function sessionIdOfAgent(agent) {
 	if (!agent || typeof agent !== "object") return void 0;
 	const candidate = agent;
 	if (typeof candidate.sessionId === "string") return candidate.sessionId;
-	if (candidate.session && typeof candidate.session === "object" && typeof candidate.session.id === "string") return candidate.session.id;
+	if (typeof candidate.id === "string") return candidate.id;
+	const session = candidate.session;
+	if (session && typeof session === "object") {
+		if (typeof session.id === "string") return session.id;
+		if (session.header && typeof session.header.id === "string") return session.header.id;
+	}
 }
 /** Best-effort projection of a session view to its session id. */
 function sessionIdOf(summary) {
@@ -2380,6 +2398,21 @@ async function handoffImagesForTextOnlyModel(host, roots, fallbackDir, subdir, l
 	}
 }
 /**
+* 读注册表级归档集合，读不到就返回空数组。
+*
+* 让 `workspace.list` 把内核的归档状态透传给上层（chat-adapter 靠它把已归档会话
+* 从列表里滤掉）。getter 缺失（老内核、测试替身）时退化成空集合：过滤失效，
+* 但列表本身照常可读 —— 比抛错更接近旧的可用行为。
+*
+* @param registry - 内核工作区注册表（`ctx.workspaceRegistry`）。
+* @returns 归档的会话 id；字段缺失或不是字符串数组时为空数组。
+*/
+function readArchivedSessionIds(registry) {
+	const value = registry.archivedSessionIds;
+	if (!Array.isArray(value)) return [];
+	return value.filter((item) => typeof item === "string");
+}
+/**
 * Build the `apiProxy` replacement out of 0.2.x host services.
 *
 * Every method keeps the old `{ rpcId, payload }` request shape and the old
@@ -2387,7 +2420,6 @@ async function handoffImagesForTextOnlyModel(host, roots, fallbackDir, subdir, l
 * `chat-adapter.ts` and `settings-adapter.ts` are written against.
 *
 * @param host - host services resolved from the plugin context.
-* @param host - host services resolved from the plugin context.
 * @returns a `SettingsApiProxy` (i.e. `DshApiProxy` plus the settings surfaces).
 */
 function createDsh02ApiProxy(host, options = {}) {
@@ -2589,7 +2621,7 @@ function createDsh02ApiProxy(host, options = {}) {
 						createdAt: row.createdAt,
 						updatedAt: row.updatedAt
 					})),
-					archivedSessionIds: []
+					archivedSessionIds: readArchivedSessionIds(host.workspaceRegistry)
 				};
 			}),
 			create: (request) => call(() => host.workspaceController.create(request.payload)),
@@ -3682,7 +3714,7 @@ async function inspectResolvedPath(root, wirePath) {
 }
 //#endregion
 //#region src/shared/version.ts
-const PLUGIN_VERSION = "2.3.5";
+const PLUGIN_VERSION = "2.3.7";
 //#endregion
 //#region src/host/router.ts
 var ApiRouter = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-bridge",
-  "version": "2.3.5",
+  "version": "2.3.7",
   "description": "Versioned REST bridge for DeepSeek Harness: remote access for trusted clients (chat, files, devices) plus a Phone-settings panel inside the DSH WebUI.",
   "type": "module",
   "packageManager": "pnpm@11.19.0",
@@ -29,6 +29,7 @@
     "kotlin-sdk/src/**",
     "kotlin-sdk/README.md",
     "cordis.patch.yml",
+    "screenshots.json",
     "README.md",
     "README.en.md",
     "LICENSE"

package/screenshots.json

@@ -0,0 +1,6 @@
+[
+  "assets/screenshots/panel-roots.png",
+  "assets/screenshots/panel-remote.png",
+  "assets/screenshots/panel-devices.png",
+  "assets/screenshots/panel-app-download.png"
+]