dsh-mobile-plugin 0.2.1 → 0.3.1

package/lib/read-receipt.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 /**
- * 「已读回执」台账：手机端读过哪个会话，桌面端据此清掉自己的未读绿点。
+ * 「已读回执」台账：哪个会话在什么时候被读过，桌面端据此清掉自己的未读绿点。
  *
  * 背景：两端侧边栏的绿点来自**两份互不相干**的状态。
  *   - 手机端绿点 = 宿主按设备维度维护的完成提醒（lib/mobile/completion.js），
@@ -10,11 +10,16 @@
  *     （@deepseek-ai/dsh-client-ui-session），既不落盘也不过服务端。
  * 所以手机上点开一个会话，桌面那份完全不知情，绿点照旧。
  *
- * 这里补的就是这条缺失的通道：手机端每点开一个会话，宿主除了清自己那份提醒，
- * 还往本模块记一条 `sessionId → readAt` 水位；插件的客户端半边
- * （lib/client.js 的 startReadReceiptSync）每 2 秒拉一次 `GET /api/relay/read-receipt`，
- * 对水位前进过的会话做一次瞬时 `sessions.retain(id, { source: 'mainView' })` +
- * `release()`，借桌面自己的 `reconcileStatus()` 把 `completionUnread` 摘掉。
+ * 这里补的就是这条缺失的通道：只要有人在某一端读过，宿主就往本模块记一条
+ * `sessionId → readAt` 水位；插件的客户端半边（lib/client.js 的 startReadReceiptSync）
+ * 每 2 秒拉一次 `GET /api/relay/read-receipt`，对水位前进过的会话做一次瞬时
+ * `sessions.retain(id, { source: 'mainView' })` + `release()`，借桌面自己的
+ * `reconcileStatus()` 把 `completionUnread` 摘掉。
+ *
+ * 这本台账还有第二个读者：宿主自己。手机侧栏的绿点由 App 拿「上一轮什么时候结束」和
+ * 本机已读水位算出来，那一份水位（lib/mobile/session-last-turn.js 的事实地表）是进程内的，
+ * 重启就空 —— 所以 `readAtOf` 让它在重启后从这盘上补回来。两头都写同一本账，
+ * 「读过」这件事才不会随进程消失。
  *
  * 为什么存 readAt 而不是一个「已读」布尔：冲突策略是 last-write-wins。
  * 桌面点开 → 客户端半边把该会话 POST 回 `/api/relay/desktop-read` → 宿主清掉
@@ -97,6 +102,21 @@ function persist(readAt) {
   loaded = true;
 }
 
+/**
+ * 这条会话最近一次被读的时刻；台账里没有就是 0。
+ *
+ * 宿主自己也读这份台账：`lib/mobile/session-last-turn.js` 在进程重启后靠它把设备无关的
+ * 已读水位补回内存（那张表按 ctx 隔离、进程一换就空）。所以这本台账记的必须是「谁读过
+ * 都算」—— 手机点开与桌面点开两条路都要走到 `recordRead`。
+ */
+function readAtOf(sessionId) {
+  const id = typeof sessionId === 'string' ? sessionId.trim() : '';
+  if (!id) return 0;
+  const current = load();
+  const value = current ? current.readAt[id] : undefined;
+  return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+
 /**
  * 记一条已读：`sessionId` 在 `now` 被读过。返回 `{ sessionId, readAt, changed }`。
  *
@@ -121,4 +141,4 @@ function recordRead(sessionId, now = Date.now()) {
   return { sessionId: id, readAt: at, changed: true };
 }
 
-module.exports = { stateFile, snapshot, recordRead };
+module.exports = { stateFile, snapshot, recordRead, readAtOf };

package/lib/routes/mobile-api.js

@@ -32,6 +32,7 @@ const events = require('../mobile/events.js');
 const questions = require('../mobile/questions.js');
 const approvals = require('../mobile/approvals.js');
 const workspaces = require('../mobile/workspaces.js');
+const directoryListing = require('../mobile/directory-listing.js');
 const archiveClean = require('../mobile/archive-clean.js');
 const sessionLog = require('../mobile/session-log.js');
 const hostSettings = require('../mobile/host-settings.js');
@@ -277,6 +278,10 @@ function registerMobileRoutes(deps) {
   // 「宿主最近收到的快照」；从未收到过时返回 view: null，App 按桌面的折叠缺省处理。
   route('/api/mobile/v1/desktop-view', async (_ctx, _req, res) => sendJson(res, 200, { ok: true, view: desktopView.snapshot() }))
   route('/api/mobile/v1/directory/list', workspaces.handleListDirectory)
+  // 右栏文件浏览器要的那一份：文件与文件夹都列、带类型/大小/修改时间，见
+  // mobile/directory-listing.js。与上面那条**并存**：那条是「挑工作区目录」用的，只列
+  // 能进去的目录，行为不变。
+  route('/api/mobile/v1/directory/listing', directoryListing.handleDirectoryListing)
   route('/api/mobile/v1/directory/create', workspaces.handleCreateDirectory)
   route('/api/mobile/v1/workspace/create', workspaces.handleCreateWorkspace)
   route('/api/mobile/v1/workspace/delete', workspaces.handleDeleteWorkspace)

package/lib/shared/device-headers.js

@@ -0,0 +1,64 @@
+'use strict';
+
+/**
+ * 手机每次请求顺带上来的身份：设备名、平台、系统版本、App 版本。
+ *
+ * ## 为什么要有这几个头
+ *
+ * 这几格以前**只在配对那一刻写一次**（见 `dsh-mobile-credentials/lib/credentials.js` 的
+ * `deviceMeta`），之后谁都不碰。后果是三件事一起出现（2026-10-26 用户报的就是它们）：
+ *
+ *  1. **App 升级之后面板还报配对时的旧版本** —— 那一格永远不变；
+ *  2. **旧会话升级进来的记录没有名字** —— 面板只能画「未知设备」；
+ *  3. 面板把「加密」读成「已是最新」，其实那只说明这枚凭据带设备密钥。
+ *
+ * 身份属于「每一次请求都顺手知道」的信息，不该是一张一次性的照片。现在手机在统一的鉴权头
+ * 里带上这四样，宿主在鉴权通过那一刻（`lib/impl.js` 的 `onAuthorized`）把它们写回凭据记录。
+ *
+ * ## 口径
+ *
+ *  - **缺一个就少写一个**：老版本 App 根本不带这些头，那时必须保持记录里原来的值，
+ *    绝不能把已经有的名字冲成空串（那会把一个好好的设备变成「未知设备」）。
+ *  - 头的值是手机自报的，长度交给凭据库的 `truncate` 截断，这里不重复做校验。
+ *  - 名字是**用户自己起的**，不参与任何判断，只用于显示。
+ */
+
+/** 手机自报身份用的四个头（App 侧在 `app/src/services/viewmodels/authHeaders.ts` 里写）。 */
+const DEVICE_NAME_HEADER = 'x-dsh-device-name';
+const PLATFORM_HEADER = 'x-dsh-platform';
+const OS_VERSION_HEADER = 'x-dsh-os-version';
+const APP_VERSION_HEADER = 'x-dsh-app-version';
+
+/** 一个头拿成字符串（重复头会是数组，只认第一个）。 */
+function headerText(headers, name) {
+  const value = headers && headers[name];
+  if (typeof value === 'string') return value.trim();
+  if (Array.isArray(value) && typeof value[0] === 'string') return value[0].trim();
+  return '';
+}
+
+/**
+ * 这次请求带上来的身份。**没带的格子不出现在返回对象里**（不是空串）——
+ * 凭据库那边按「有哪几格就写哪几格」合并，空串会变成「把名字清掉」。
+ */
+function deviceMetaFromHeaders(req) {
+  const headers = req?.headers || {};
+  const meta = {};
+  const name = headerText(headers, DEVICE_NAME_HEADER);
+  if (name) meta.name = name;
+  const platform = headerText(headers, PLATFORM_HEADER);
+  if (platform) meta.platform = platform;
+  const osVersion = headerText(headers, OS_VERSION_HEADER);
+  if (osVersion) meta.osVersion = osVersion;
+  const appVersion = headerText(headers, APP_VERSION_HEADER);
+  if (appVersion) meta.appVersion = appVersion;
+  return meta;
+}
+
+module.exports = {
+  APP_VERSION_HEADER,
+  DEVICE_NAME_HEADER,
+  OS_VERSION_HEADER,
+  PLATFORM_HEADER,
+  deviceMetaFromHeaders,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (0.2.0-rc.2 compatible, peers resolved by the host)",
   "license": "MIT",
   "type": "module",