dsh-mobile-plugin 0.5.20 → 0.5.21

package/lib/routes/control-plane.js

@@ -509,6 +509,7 @@ function registerControlPlaneRoutes(deps) {
   //   /api/relay/panel            看宿主记的「配没配过」，自己决定先走引导还是直接进主页
   //   /api/relay/panel/setup      强制走引导（想再看一遍流程时用）
   //   /api/relay/panel/settings   强制进主页（演示 / 排查时跳过引导）
+  //   /api/relay/panel/debug      强制进调试页（桌面端那颗手机图标点开的就是它）
   // 整页 HTML 不需要 token，但这几条仍然走 localOnly —— 它读的是本机运维界面，
   // 而局域网与中转那两条链路本来就不该看到它（它们带 dsh_pair/dsh_lan 凭据，会被挡掉）。
   const servePanel = (res) => {
@@ -527,6 +528,13 @@ function registerControlPlaneRoutes(deps) {
   registerRoute({ kind: 'exact', path: '/api/relay/panel', handler: localOnly('GET', async (_req, res) => servePanel(res), { allowDocumentNavigation: true }) })
   registerRoute({ kind: 'exact', path: '/api/relay/panel/setup', handler: localOnly('GET', async (_req, res) => servePanel(res), { allowDocumentNavigation: true }) })
   registerRoute({ kind: 'exact', path: '/api/relay/panel/settings', handler: localOnly('GET', async (_req, res) => servePanel(res), { allowDocumentNavigation: true }) })
+  // 调试页与上面几条吐同一份 HTML，分流同样在 React 侧（`React/src/Root.tsx` 认 `/debug`）。
+  //
+  // 为什么它也放开 `allowDocumentNavigation`：这一页唯一的入口是桌面端那颗手机图标弹的窗
+  // （同源 iframe），而社区桌面壳会把接住的链接原地打开、从自定义协议页跳过来必带
+  // `sec-fetch-site: cross-site` —— 与面板页同一条理由。页面本身仍是只读 HTML，
+  // 里面的 fetch 照样被 localOnly 与两小时窗口挡着。
+  registerRoute({ kind: 'exact', path: '/api/relay/panel/debug', handler: localOnly('GET', async (_req, res) => servePanel(res), { allowDocumentNavigation: true }) })
   // 桌面端画布页：整页吐同一份内联 HTML，并在 `</head>` 前补一句「这是桌面端」的标记 ——
   // 画布据此把路由从 BrowserRouter 换成 HashRouter（它被挂在 `/api/relay/canvas` 这种非根
   // 路径下，BrowserRouter 的 `/` 匹配不上会 404）。手机 WebView 那份不带这个标记，一个字不改。
@@ -1076,6 +1084,7 @@ const WEB_ACCESS_ROUTES = new Set([
   '/api/relay/panel',
   '/api/relay/panel/setup',
   '/api/relay/panel/settings',
+  '/api/relay/panel/debug',
   '/api/relay/faults',
   // 配对二维码：里面是能派生整条链路密钥的一次性票据，所以它只在两小时窗口开着时给网页看
   // ——窗口由本机设置页亲手开，服务器部署没有「本机屏幕」可看，这条是它唯一的出口。

package/lib/session-cleanup.cjs

@@ -316,7 +316,7 @@ function restoreQueuedArchivedClearIds(ctx) {
   return queued
 }
 
-async function pruneOrphanedArchivedSessions(ctx) {
+async function pruneOrphanedArchivedSessions(ctx, skip) {
   const workspaceList = ctx && ctx.apiProxy && ctx.apiProxy.workspace ? ctx.apiProxy.workspace.list : undefined
   if (typeof workspaceList !== 'function') return 0
   const rpcId = 'dsh-mobile-plugin-archive-prune'
@@ -325,7 +325,8 @@ async function pruneOrphanedArchivedSessions(ctx) {
   const archived = value && Array.isArray(value.archivedSessionIds)
     ? value.archivedSessionIds.filter((id) => typeof id === 'string' && id)
     : []
-  const orphans = await archivedIdsWithoutLogs(archived)
+  const skipped = skip instanceof Set ? skip : new Set(Array.isArray(skip) ? skip : [])
+  const orphans = (await archivedIdsWithoutLogs(archived)).filter((id) => !skipped.has(id))
   if (orphans.length === 0) return 0
   const failed = await forgetArchivedSessions(ctx, orphans, rpcId)
   return orphans.length - failed.length
@@ -339,10 +340,12 @@ async function pruneOrphanedArchivedSessions(ctx) {
  *    就是一次未捕获的 ENOENT，宿主直接退出。
  *  - **擦归档集合**：桌面端的会话列表是「连上宿主时拉的一份快照 + 之后的事件增量」，
  *    进程活着的时候擦集合，宿主会把「归档集合变了」广播给桌面端，桌面端就把它快照里
- *    那些其实已经没有日志、本来被归档藏着的行放回正常列表 —— 用户报的正是「清理后
- *    它们又回来了，重启 DSH 才真的消失」。启动时快照本来就从磁盘重新拉，擦掉不会放出
- *    任何行。留在集合里的死 id 不显示在任何地方：「已归档」取的是会话列表与归档集合
- *    的交集，没有日志就没有那一行。
+ *    那些其实已经没有日志、本来被归档藏着的行放回正常列表。所以只在启动时擦，而且**本次
+ *    刚删掉日志的 id 这一轮也先不擦**：宿主启动和删日志是并发的，桌面端的快照完全可能
+ *    在删完之前就取走、把这些行带在身上；这时擦集合照样会把它们放回正常列表（一次重启
+ *    之后它们又出现，再重启才消失）。留到下一次启动再擦，那时它们早已没有日志，任何新
+ *    快照里都不会再有这些行。留在集合里的死 id 依然不显示：「已归档」取的是会话列表与
+ *    归档集合的交集，没有日志就没有那一行。
  *
  * 用进程级标记而不是模块变量：代际热替换会重跑 apply，而桌面端那条快照挂在同一个进程上。
  */
@@ -352,9 +355,21 @@ const PRUNE_RETRY_MS = 500
 async function pruneOrphanedArchivedSessionsOnce(ctx, log) {
   if (globalThis[PRUNE_ONCE]) return
   globalThis[PRUNE_ONCE] = true
+  // 本次启动前盘上就已经没有数据的 id：它们早就不在任何新快照里，这一轮可以直接擦。
+  const alreadyDataLess = new Set(sessionIdsWithoutAnyData(readPendingArchivedClearIds()))
+  let skip = []
   // 删日志不碰宿主，先做：越早越好，别等宿主把 workspace 服务挂齐（那时桌面端可能已经连上）。
   try {
     const { deleted, kept } = await deleteQueuedArchivedSessions(log, ctx)
+    // 本次刚删掉日志的 id，这一轮先别擦归档集合，留到下一次启动再擦。
+    //
+    // 桌面端的会话列表是「启动时拉的一份快照 + 之后的事件增量」，宿主没有删除会话的接口，
+    // 插件在磁盘上删日志它看不见 —— 它快照里还留着这些行，本来靠「已归档」藏着。这时一擦
+    // 集合，宿主就广播「归档集合变了」，桌面端把这些其实已经没有日志的行放回正常列表，用户
+    // 看到的就是「重启一次它们又回来了」。留到下一次启动：那时它们早就没有日志，任何新快照
+    // 里都不会再有这些行，擦集合的广播也就放不出东西来。代价是这些空 id 在归档集合里多留
+    // 一次启动（「已归档」取会话列表与归档集合的交集，没有日志就看不见它）。
+    skip = deleted.filter((id) => !alreadyDataLess.has(id))
     if (deleted.length > 0) log?.(`archived clear queue: deleted ${deleted.length} session logs`)
     if (kept.length > 0) log?.(`archived clear queue: ${kept.length} session logs kept for the next start`)
   } catch (error) {
@@ -365,7 +380,7 @@ async function pruneOrphanedArchivedSessionsOnce(ctx, log) {
   // 的死 id 一直没人清（实测宿主重启过一次，315 个没有日志的 id 原样挂着）。
   for (let attempt = 1; attempt <= PRUNE_ATTEMPTS; attempt += 1) {
     try {
-      const pruned = await pruneOrphanedArchivedSessions(ctx)
+      const pruned = await pruneOrphanedArchivedSessions(ctx, skip)
       if (pruned > 0) log?.(`archived session prune: dropped ${pruned} deleted session ids`)
       return
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.5.20",
+  "version": "0.5.21",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (dsh 0.2.x, peers resolved by the host)",
   "license": "MIT",
   "icon": "./icon.png",