dsh-mobile-plugin 0.1.71 → 0.1.73

package/lib/client.js

@@ -514,7 +514,7 @@ window.__ModuleLoader__.load({
         webAccessOff: '公网网页管理已关闭',
         webAccessOpen: '开放网页管理 2 小时',
         webAccessClose: '立即关闭网页管理',
-        webAccessHint: '默认关闭；开启后 2 小时自动关闭，访问不会延长时间，也不影响手机 App。只可从本机 DSH 设置页开关。',
+        webAccessHint: '默认关闭；开启后 2 小时自动关闭，访问不会延长时间。关闭后公网不可访问，本机和局域网仍可访问；不影响手机 App。只可从本机 DSH 设置页开关。',
         webAccessUnavailable: '正在读取本机访问状态…',
         webAccessError: '更新网页访问状态失败',
       },
@@ -531,7 +531,7 @@ window.__ModuleLoader__.load({
         webAccessOff: 'Public web management is closed',
         webAccessOpen: 'Open web management for 2 hours',
         webAccessClose: 'Close web management now',
-        webAccessHint: 'Closed by default; opening lasts 2 hours and visits do not extend it. Mobile app access is unaffected. Only this local DSH settings page can toggle it.',
+        webAccessHint: 'Closed by default; opening lasts 2 hours and visits do not extend it. When closed, public access is blocked while this machine and its LAN can still access the page. Mobile app access is unaffected. Only this local DSH settings page can toggle it.',
         webAccessUnavailable: 'Reading local access status…',
         webAccessError: 'Failed to update web access status',
       },

package/lib/mobile/archive-clean.js

@@ -0,0 +1,51 @@
+'use strict';
+
+/**
+ * 移动端「清理所有已归档的对话」：按宿主归档集合确定清理范围，并交由落地函数删除。
+ *
+ * 以 workspace.list 的 archivedSessionIds 为清理范围，不用可能过时的列表状态缩小范围；
+ * 请求必须显式带 confirm: true —— 磁盘删除不可恢复，手机端「少点一次」不值得把它变成滑一下就没了的动作。
+ *
+ * 删除动作不重写：读日志 header.id → 摘归档集合 → 删会话目录 + 投影缓存这套只在 session-cleanup.cjs
+ * 里存在（见地图 A3-17），这里只是把它的触发面从 agent 工具扩到移动端路由。
+ */
+
+const { sendJson, readJsonBody } = require('../shared/http-util');
+const { withIdempotency, requestIdOf } = require('./idempotency.js');
+const { canonicalDeviceKey } = require('./session-cache.js');
+const { invalidateSessionList } = require('./sessions.js');
+const { unwrap } = require('./envelope.js');
+const { deleteSessionData, forgetArchivedSessions } = require('../session-cleanup.cjs');
+
+/**
+ * POST /api/mobile/v1/workspace/clear-archived（token）
+ * body: { confirm: true } → { ok: true, deleted: N }。confirm 不为 true 一律 400。
+ */
+async function handleClearArchived(ctx, req, res) {
+  const body = await readJsonBody(req, 64 * 1024);
+  if (!body || body.confirm !== true) {
+    sendJson(res, 400, { ok: false, error: { code: 'confirm-required', message: '清理已归档会话不可恢复，请求需要带 confirm: true' } });
+    return;
+  }
+  const outcome = await withIdempotency(ctx, canonicalDeviceKey(req), requestIdOf(req, body), async () => {
+    // 归档集合是清理范围的唯一依据；列表摘要里的 running / blank 可能过时，也不应缩小「全部归档」的范围。
+    const workspaceResponse = unwrap(await ctx.apiProxy.workspace.list({ rpcId: 'mobile', method: 'workspace.list', payload: {} }));
+    if (workspaceResponse.error) {
+      return { status: 400, body: { ok: false, error: { ...workspaceResponse.error, message: `workspace.list 失败：${workspaceResponse.error.message || workspaceResponse.error.code || '未知错误'}` } } };
+    }
+    const archivedIds = Array.isArray(workspaceResponse.value?.archivedSessionIds) ? workspaceResponse.value.archivedSessionIds : [];
+    const selected = archivedIds.filter((id) => typeof id === 'string' && id);
+    if (selected.length === 0) return { status: 200, body: { ok: true, deleted: 0, archivedSessionIds: archivedIds } };
+    // 先把它从宿主归档集合里摘掉，再删日志：宿主不会自己修剪那份集合，删完还留着
+    // 那些 id 就是「已归档」里一排点不开的死行。
+    await forgetArchivedSessions(ctx, selected, 'mobile');
+    const removed = await deleteSessionData(selected);
+    // 删的是列表里可见的行：手机端正开着列表，不立刻失效最长 10 秒还能点到死行。
+    invalidateSessionList(ctx);
+    const cleared = new Set(selected);
+    return { status: 200, body: { ok: true, deleted: removed.length, archivedSessionIds: archivedIds.filter((id) => !cleared.has(id)) } };
+  });
+  sendJson(res, outcome.status, outcome.body);
+}
+
+module.exports = { handleClearArchived };

package/lib/mobile/credentials.js

@@ -15,6 +15,13 @@
  * 密钥值只在这条路上出现一次（手机 → 宿主）。宿主从不回传值：describe 只给
  * {configured, source?, writable}，所以这里的响应里也永远不会有 value 字段。
  *
+ * 宿主 describe **回的就是一张平表**：键是引用名、值是上面那个视图
+ * （`dsh-api-settings-controller/lib/types/credentials.js` 的
+ * `Object.fromEntries(branded.map(...))`，0.2.0 的网关与旧 apiProxy 两条路都打到
+ * 同一个 Remote 命名空间）。曾经在这里多拆一层 `value.credentials` —— 那一层从来
+ * 不存在，于是每个引用都落成「未配置」，设置页永远显示「密钥未设置」，而测试假体
+ * 照抄了同一个错形状，绿的。读了宿主源码才看出来。
+ *
  * 「能不能写」由宿主的 credentials 服务说了算：如果某个引用是启动环境变量提供的，
  * 宿主会回 writable:false，set 则回 credential-rejected（"supplied read-only by the
  * launching environment"）。这里不自己判断，一律如实透传，让 App 显示宿主的原话。
@@ -76,9 +83,7 @@ async function handleCredentialsDescribe(ctx, req, res) {
   }));
   if (error) return sendJson(res, 400, { ok: false, error });
 
-  const source = value && typeof value.credentials === 'object' && value.credentials !== null && !Array.isArray(value.credentials)
-    ? value.credentials
-    : {};
+  const source = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
   const credentials = {};
   for (const ref of refs) {
     const view = normalizeCredentialView(source[ref]);

package/lib/mobile/host-bridge/endpoints.js

@@ -83,6 +83,7 @@ const ENDPOINTS = {
   'workspace.unarchiveSession': inv('workspace', 'unarchiveSession'),
   'workspace.pinSession': inv('workspace', 'pinSession'),
   'workspace.unpinSession': inv('workspace', 'unpinSession'),
+  'workspace.insertBefore': inv('workspace', 'insertBefore'),
   'workspace.insertSessionBefore': inv('workspace', 'insertSessionBefore'),
 
   // host.* → directoryPicker.*（宿主服务 browse 时），否则回落到插件自带的 browse 原语。

package/lib/mobile/sessions.js

@@ -151,7 +151,16 @@ async function handleSessions(ctx, req, res) {
   // 是同一批会话的**另一个子集**，不能与默认视图共用这份 10 秒缓存——否则 App 点完
   // 「筛选已归档会话」后，最长 10 秒内拿到的还是那份不含归档行的默认列表。
   // 与 fresh 的区别：它只绕开这层缓存，不需要作废在途构建，也不 bump 朝代号（没有写入）。
-  const archivedOnly = new URL(req.url, 'http://x').searchParams.get('archived') === '1';
+  const url = new URL(req.url, 'http://x');
+  const archivedOnly = url.searchParams.get('archived') === '1';
+  // 只有新客户端显式带分页参数时才切片；旧客户端不带参数仍拿到完整归档列表。
+  const hasPaging = archivedOnly && (url.searchParams.has('offset') || url.searchParams.has('limit'));
+  const parsedOffset = Number(url.searchParams.get('offset') ?? 0);
+  const parsedLimit = Number(url.searchParams.get('limit') ?? 50);
+  const page = hasPaging ? {
+    offset: Number.isFinite(parsedOffset) ? Math.max(0, Math.floor(parsedOffset)) : 0,
+    limit: Number.isFinite(parsedLimit) ? Math.max(1, Math.min(200, Math.floor(parsedLimit))) : 50,
+  } : null;
   const bypassCache = wantFresh || archivedOnly;
   if (wantFresh) {
     // 顺手作废更早发起的构建：它们手里的数据是写入之前的，若在新结果之后才落地会把旧列表又写回缓存。
@@ -172,7 +181,7 @@ async function handleSessions(ctx, req, res) {
   // 但「丢掉」挡不住**已经在飞**的那次构建：它手里是变更之前的数据，落地后会在缓存里
   // 再活 10 秒。用缓存自带的朝代号兜住（见 session-cache.js 的 dropSessionListCache）。
   const epoch = cache.droppedAt || 0;
-  const promise = buildSessionsResponse(ctx, deviceKey, generation, wantFresh, archivedOnly);
+  const promise = buildSessionsResponse(ctx, deviceKey, generation, wantFresh, archivedOnly, page);
   cache.promise = promise;
   try {
     const response = await promise;
@@ -194,7 +203,7 @@ async function handleSessions(ctx, req, res) {
   }
 }
 
-async function buildSessionsResponse(ctx, deviceKey = 'legacy', generation = completionGenerationOf(ctx, deviceKey), fresh = false, archivedOnly = false) {
+async function buildSessionsResponse(ctx, deviceKey = 'legacy', generation = completionGenerationOf(ctx, deviceKey), fresh = false, archivedOnly = false, page = null) {
   const { value, error } = unwrap(await callSessions(ctx, 'list', {}, 'mobile', undefined, { fresh }));
   if (error) return { status: 400, body: { ok: false, error } };
   // 形状不对 = 没取到，不是「你一个会话都没有」。旧实现 `(value.items || [])` 把
@@ -255,9 +264,11 @@ async function buildSessionsResponse(ctx, deviceKey = 'legacy', generation = com
     };
     return { summary: s, base };
   });
+  // 有分页时只为当前页补预览，避免每翻一页都给不可见会话重复读历史。
+  const pageRows = page ? rows.slice(page.offset, page.offset + page.limit) : rows;
   // 预览子集：运行中优先（完成边沿确认不能缺），其次最近活跃；数量受
   // SESSIONS_PREVIEW_LIMIT 限制，避免会话多时每次列表请求都全量读历史日志。
-  const previewCandidates = rows
+  const previewCandidates = pageRows
     .slice()
     .sort((a, b) =>
       (b.summary.running ? 1 : 0) - (a.summary.running ? 1 : 0)
@@ -285,22 +296,24 @@ async function buildSessionsResponse(ctx, deviceKey = 'legacy', generation = com
       // 预览失败不影响标题与行数据。
     }
   }));
-  const items = rows.map((r) => r.base);
+  const allItems = rows.map((r) => r.base);
+  const items = page ? allItems.slice(page.offset, page.offset + page.limit) : allItems;
   const generatedAt = Date.now();
   return {
     status: 200,
     body: {
       ok: true,
       items,
+      hasMore: page ? page.offset + items.length < allItems.length : false,
       // 数据新鲜度：App 把这两个字段连同快照一起存下来，就能把「这份数据是谁在什么
       // 时候给的」显示给用户，而不是只给一个「刚刚同步过」的客户端时间。revision 是
       // 内容指纹（跨插件重启稳定），App 也用它判断一次变更信号是否真的带来了新内容。
       generatedAt,
-      revision: listRevision(items),
+      revision: listRevision(allItems),
       // 显式空态：形状降级在上面的 500 分支里已被挡掉，能走到这里说明宿主回了一份
       // 合法清单 —— 「空」在这一点上是可断言的契约，不再需要 App 连续两次空去猜。
       // 下游（空清单守卫 / 中转缓存 / App 的空态判定）据此放行真实的「清空」。
-      emptyConfirmed: items.length === 0,
+      emptyConfirmed: allItems.length === 0,
     },
   };
 }

package/lib/mobile/workspaces.js

@@ -145,6 +145,17 @@ async function handleDeleteWorkspace(ctx, req, res) {
  * POST /api/mobile/v1/workspace/move-session（token）{ workspaceId, sessionId, beforeSessionId? }
  * 透传宿主 workspace.insertSessionBefore，使移动端和桌面端共享工作区排序。
  */
+async function handleMoveWorkspace(ctx, req, res) {
+  const body = await readJsonBody(req, 64 * 1024);
+  const workspaceId = body && typeof body.workspaceId === 'string' ? body.workspaceId.trim() : '';
+  const beforeWorkspaceId = body && typeof body.beforeWorkspaceId === 'string' ? body.beforeWorkspaceId.trim() : '';
+  if (!workspaceId) return sendJson(res, 400, { ok: false, error: { code: 'bad-request', message: '需要 workspaceId' } });
+  const payload = { workspaceId, ...(beforeWorkspaceId ? { beforeWorkspaceId } : {}) };
+  const { value, error } = unwrap(await callWorkspace(ctx, 'insertBefore', payload));
+  if (error) return sendJson(res, 400, { ok: false, error });
+  sendJson(res, 200, { ok: true, workspaceIds: value && value.workspaceIds });
+}
+
 async function handleMoveSession(ctx, req, res) {
   const body = await readJsonBody(req, 64 * 1024);
   const workspaceId = body && typeof body.workspaceId === 'string' ? body.workspaceId.trim() : '';
@@ -255,6 +266,7 @@ async function handleUnpinSession(ctx, req, res) {
 
 module.exports = {
   buildWorkspacesBody,
+  handleMoveWorkspace,
   handleWorkspaces,
   handleListDirectory,
   handleCreateDirectory,