@dsh-workbench/core 1.0.0 → 1.1.0

package/scripts/share-data-root.mjs

@@ -10,6 +10,7 @@ import {
   statSync,
   writeFileSync,
 } from 'node:fs';
+import { randomUUID } from 'node:crypto';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -78,6 +79,58 @@ function unionList(left, right) {
   return [...new Set([...(Array.isArray(left) ? left : []), ...(Array.isArray(right) ? right : [])])];
 }
 
+function sessionIdsOf(entry) {
+  return Array.isArray(entry?.sessionIds) ? entry.sessionIds : [];
+}
+
+function orderedIds(global, table) {
+  const seen = new Set();
+  const ids = [];
+  for (const id of Array.isArray(global?.workspaceIds) ? global.workspaceIds : []) {
+    if (table[id] === undefined || seen.has(id)) continue;
+    ids.push(id);
+    seen.add(id);
+  }
+  for (const id of Object.keys(table)) {
+    if (seen.has(id)) continue;
+    ids.push(id);
+    seen.add(id);
+  }
+  return ids;
+}
+
+function repairWorkspaceOrder(targetFile) {
+  let target;
+  try {
+    target = JSON.parse(readFileSync(targetFile, 'utf8'));
+  } catch {
+    return false;
+  }
+  if (target?.unit?.name !== 'workspace') return false;
+  const table = target.tables?.workspaces ?? {};
+  const global = target.global ?? {};
+  if (global.pendingMutation !== undefined) return false;
+  const before = Array.isArray(global.workspaceIds) ? global.workspaceIds : [];
+  const seen = new Set();
+  const order = [];
+  for (const id of before) {
+    if (table[id] === undefined || seen.has(id)) continue;
+    order.push(id);
+    seen.add(id);
+  }
+  if (global.initialized === true) {
+    for (const id of Object.keys(table)) {
+      if (seen.has(id)) continue;
+      order.push(id);
+      seen.add(id);
+    }
+  }
+  if (order.length === before.length && order.every((id, index) => id === before[index])) return false;
+  target.global = { ...global, workspaceIds: order };
+  writeAtomic(targetFile, `${JSON.stringify(target, null, 2)}\n`);
+  return true;
+}
+
 function mergeWorkspaceList(sourceFile, targetFile) {
   let source;
   try {
@@ -95,67 +148,249 @@ function mergeWorkspaceList(sourceFile, targetFile) {
   try {
     target = JSON.parse(readFileSync(targetFile, 'utf8'));
   } catch {
-    warn(`${targetFile} 读不出来，这次没并项目列表。`);
-    return 0;
+    warn(`${targetFile} 读不出来，这次没并项目列表，下次启动再试。`);
+    return null;
   }
   if (target?.unit?.name !== 'workspace') return 0;
   const sourceTable = source.tables?.workspaces ?? {};
   const targetTable = target.tables?.workspaces ?? {};
-  const byPath = new Map();
-  for (const entry of Object.values(targetTable)) {
-    if (typeof entry?.path === 'string') byPath.set(entry.path, entry);
+  const sourceGlobal = source.global ?? {};
+  const targetGlobal = target.global ?? {};
+  if (targetGlobal.pendingMutation !== undefined) {
+    warn(`${targetFile} 里有一次没做完的项目操作，这次先不并项目列表，下次启动再试。`);
+    return null;
+  }
+  const idByPath = new Map();
+  const accounted = new Map();
+  for (const [id, entry] of Object.entries(targetTable)) {
+    if (typeof entry?.path === 'string') idByPath.set(entry.path, id);
+    for (const sessionId of sessionIdsOf(entry)) {
+      if (!accounted.has(sessionId)) accounted.set(sessionId, id);
+    }
   }
+  const order = orderedIds(targetGlobal, targetTable);
+  const idMap = new Map();
   let added = 0;
-  for (const [id, entry] of Object.entries(sourceTable)) {
+  for (const sourceId of orderedIds(sourceGlobal, sourceTable)) {
+    const entry = sourceTable[sourceId];
     if (typeof entry?.path !== 'string') continue;
-    const hit = byPath.get(entry.path);
-    if (hit === undefined) {
-      targetTable[id] = entry;
-      byPath.set(entry.path, entry);
-      added += 1;
+    const hitId = idByPath.get(entry.path);
+    if (hitId !== undefined) {
+      const hit = targetTable[hitId];
+      const incoming = sessionIdsOf(entry).filter((sessionId) => {
+        const holder = accounted.get(sessionId);
+        return holder === undefined || holder === hitId;
+      });
+      hit.sessionIds = unionList(sessionIdsOf(hit), incoming);
+      for (const sessionId of hit.sessionIds) {
+        if (!accounted.has(sessionId)) accounted.set(sessionId, hitId);
+      }
+      if (typeof entry.updatedAt === 'string' && (typeof hit.updatedAt !== 'string' || entry.updatedAt > hit.updatedAt)) {
+        hit.updatedAt = entry.updatedAt;
+      }
+      idMap.set(sourceId, hitId);
       continue;
     }
-    hit.sessionIds = unionList(hit.sessionIds, entry.sessionIds);
-    if (typeof entry.updatedAt === 'string' && (typeof hit.updatedAt !== 'string' || entry.updatedAt > hit.updatedAt)) {
-      hit.updatedAt = entry.updatedAt;
+    let newId = sourceId;
+    if (targetTable[newId] !== undefined) newId = randomUUID();
+    const sessionIds = [];
+    for (const sessionId of sessionIdsOf(entry)) {
+      if (accounted.has(sessionId)) continue;
+      accounted.set(sessionId, newId);
+      sessionIds.push(sessionId);
     }
+    targetTable[newId] = { ...entry, sessionIds };
+    idByPath.set(entry.path, newId);
+    order.push(newId);
+    added += 1;
   }
+  const preferred = targetGlobal.defaultWorkspaceId;
+  const fromSource = idMap.get(sourceGlobal.defaultWorkspaceId) ?? sourceGlobal.defaultWorkspaceId;
+  const defaultWorkspaceId =
+    typeof preferred === 'string' && targetTable[preferred] !== undefined
+      ? preferred
+      : typeof fromSource === 'string' && targetTable[fromSource] !== undefined
+        ? fromSource
+        : undefined;
   target.tables = { ...(target.tables ?? {}), workspaces: targetTable };
-  const global = target.global ?? {};
-  const sourceGlobal = source.global ?? {};
-  const known = new Set(Array.isArray(global.workspaceIds) ? global.workspaceIds : []);
-  for (const id of Array.isArray(sourceGlobal.workspaceIds) ? sourceGlobal.workspaceIds : []) known.add(id);
   target.global = {
-    ...global,
-    workspaceIds: [...known],
-    archivedSessionIds: unionList(global.archivedSessionIds, sourceGlobal.archivedSessionIds),
-    pinnedSessionIds: unionList(global.pinnedSessionIds, sourceGlobal.pinnedSessionIds),
+    ...targetGlobal,
+    workspaceIds: order,
+    archivedSessionIds: unionList(targetGlobal.archivedSessionIds, sourceGlobal.archivedSessionIds),
+    pinnedSessionIds: unionList(targetGlobal.pinnedSessionIds, sourceGlobal.pinnedSessionIds),
   };
+  if (defaultWorkspaceId === undefined) delete target.global.defaultWorkspaceId;
+  else target.global.defaultWorkspaceId = defaultWorkspaceId;
   writeAtomic(targetFile, `${JSON.stringify(target, null, 2)}\n`);
   return added;
 }
 
+function repairTarget(targetFile) {
+  if (repairWorkspaceOrder(targetFile)) say(`项目顺序里有对不上的条目，已按实际项目重排（${targetFile}）。`);
+}
+
+function hasEntries(dir) {
+  try {
+    return readdirSync(dir).some((name) => name !== '.DS_Store');
+  } catch {
+    return false;
+  }
+}
+
+function legacyDataExists() {
+  if (resolve(RUNTIME_ROOT) === resolve(HOME)) return false;
+  return (
+    existsSync(join(RUNTIME_ROOT, 'storages', 'workspace.json')) ||
+    hasEntries(join(RUNTIME_ROOT, 'sessions')) ||
+    hasEntries(join(RUNTIME_ROOT, 'attachments'))
+  );
+}
+
+function missingWorkspacePaths() {
+  const sourceFile = join(RUNTIME_ROOT, 'storages', 'workspace.json');
+  const targetFile = join(HOME, 'storages', 'workspace.json');
+  if (!existsSync(sourceFile) || !existsSync(targetFile)) return [];
+  let source;
+  let target;
+  try {
+    source = JSON.parse(readFileSync(sourceFile, 'utf8'));
+    target = JSON.parse(readFileSync(targetFile, 'utf8'));
+  } catch {
+    return [];
+  }
+  if (source?.unit?.name !== 'workspace' || target?.unit?.name !== 'workspace') return [];
+  const have = new Set();
+  for (const entry of Object.values(target.tables?.workspaces ?? {})) {
+    if (typeof entry?.path === 'string') have.add(entry.path);
+  }
+  const missing = [];
+  for (const entry of Object.values(source.tables?.workspaces ?? {})) {
+    if (typeof entry?.path !== 'string' || have.has(entry.path)) continue;
+    missing.push(typeof entry.title === 'string' && entry.title !== '' ? entry.title : entry.path);
+  }
+  return missing;
+}
+
 function mergeDataRoot() {
-  if (resolve(RUNTIME_ROOT) === resolve(HOME)) return;
-  if (existsSync(MARKER)) return;
+  if (resolve(RUNTIME_ROOT) === resolve(HOME)) return { added: 0, files: 0 };
+  const targetWorkspace = join(HOME, 'storages', 'workspace.json');
   const sourceStorages = join(RUNTIME_ROOT, 'storages');
-  let count = 0;
+  let added;
+  let files = 0;
   try {
-    count += mergeWorkspaceList(join(sourceStorages, 'workspace.json'), join(HOME, 'storages', 'workspace.json'));
-    count += mergeTree(join(RUNTIME_ROOT, 'sessions'), join(HOME, 'sessions'));
-    count += mergeTree(join(RUNTIME_ROOT, 'attachments'), join(HOME, 'attachments'));
-    count += mergeTree(sourceStorages, join(HOME, 'storages'), new Set(['workspace.json']));
+    added = mergeWorkspaceList(join(sourceStorages, 'workspace.json'), targetWorkspace);
+    if (added === null) return null;
+    files += mergeTree(join(RUNTIME_ROOT, 'sessions'), join(HOME, 'sessions'));
+    files += mergeTree(join(RUNTIME_ROOT, 'attachments'), join(HOME, 'attachments'));
+    files += mergeTree(sourceStorages, join(HOME, 'storages'), new Set(['workspace.json']));
   } catch (error) {
-    warn(`并回 ${HOME} 时出错，下次启动再试：${error instanceof Error ? error.message : String(error)}`);
-    return;
+    warn(`并回 ${HOME} 时出错：${error instanceof Error ? error.message : String(error)}`);
+    return null;
   }
+  repairTarget(targetWorkspace);
+  return { added, files };
+}
+
+function writeMarker() {
   mkdirSync(dirname(MARKER), { recursive: true });
   writeFileSync(
     MARKER,
     `${JSON.stringify({ at: new Date().toISOString(), from: RUNTIME_ROOT, to: HOME }, null, 2)}\n`,
     'utf8',
   );
-  if (count > 0) say(`已把 ${RUNTIME_ROOT} 里的会话 / 项目 / 附件并回 ${HOME}（${count} 个文件，旧目录保留）。`);
+}
+
+function inspectProfile() {
+  const patch = readText(PATCH_PATH);
+  if (patch === null) return null;
+  const legacy = parseBlocks(patch).filter((block) => DATA_ROOT_IDS.has(block.id));
+  return {
+    patch,
+    ours: legacy.filter((block) => OWN_ROOT.test(block.body)),
+    custom: legacy.filter((block) => !OWN_ROOT.test(block.body)),
+  };
+}
+
+function customRootMessage(state) {
+  return `${PROFILE} 的会话 / 存储根是你自己改过的（${state.custom.map((block) => block.id).join(' / ')}）—— 这次不动它，也不并数据。`;
+}
+
+function applySharedConfig(state) {
+  if (state.custom.length > 0) {
+    warn(customRootMessage(state));
+    return false;
+  }
+  let patch = state.patch;
+  if (state.ours.length > 0) {
+    const first = Math.min(...state.ours.map((block) => block.lineStart));
+    patch = stripIsolationHeader(patch, first);
+    patch = removeBlocks(patch, (block) => DATA_ROOT_IDS.has(block.id) && OWN_ROOT.test(block.body));
+    writeAtomic(PATCH_PATH, patch);
+    say(`数据根改回共用：从 ${PROFILE} 的 profile 里去掉 ${state.ours.map((block) => block.id).join(' / ')}。`);
+  }
+  const hasSandbox = parseBlocks(patch).some((block) => block.id === 'sandbox-policy');
+  if (!hasSandbox) {
+    const sandbox = readText(SANDBOX_PATCH);
+    const row = sandbox === null ? undefined : parseBlocks(sandbox).find((block) => block.id === 'sandbox-policy');
+    if (row !== undefined) {
+      patch = appendBlocks(patch, row.body);
+      writeAtomic(PATCH_PATH, patch);
+    }
+  }
+  repairTarget(join(HOME, 'storages', 'workspace.json'));
+  return true;
+}
+
+function configureDefault() {
+  const state = inspectProfile();
+  if (state === null) return;
+  if (state.custom.length > 0) {
+    warn(customRootMessage(state));
+    return;
+  }
+  if (legacyDataExists() && !existsSync(MARKER)) {
+    warn(`检测到 ${RUNTIME_ROOT} 里还有旧会话 / 项目 / 附件，这次没有自动并。`);
+    warn('要切到共用数据根，先退出所有 dsh，再运行: dsh-workbench migrate');
+    return;
+  }
+  applySharedConfig(state);
+}
+
+function migrate() {
+  const state = inspectProfile();
+  if (state === null) {
+    warn(`找不到 ${PATCH_PATH}，先运行 dsh-workbench setup。`);
+    return 1;
+  }
+  if (state.custom.length > 0) {
+    warn(customRootMessage(state));
+    return 1;
+  }
+  if (!legacyDataExists()) {
+    applySharedConfig(state);
+    say(`没有发现 ${RUNTIME_ROOT} 里的旧数据，数据根已经是共用的。`);
+    return 0;
+  }
+  if (existsSync(MARKER) && !FORCE) {
+    const missing = missingWorkspacePaths();
+    if (missing.length > 0) {
+      say(`已经迁过一次；旧目录里还有 ${missing.length} 个项目不在共用根：${missing.join('、')}。要补并加 --force（这次 profile 保持原样）。`);
+      return 0;
+    }
+    applySharedConfig(state);
+    say('已经迁过一次；要再并一次加 --force。');
+    return 0;
+  }
+  warn('迁移前先退出所有 dsh（:3080 / :3081）；否则正在运行的实例可能覆盖刚并好的数据。');
+  const result = mergeDataRoot();
+  if (result === null) {
+    warn('这次没有迁移；profile 和旧数据都保持原样。');
+    return 1;
+  }
+  writeMarker();
+  applySharedConfig(state);
+  say(`迁移完成：新增 ${result.added} 个项目，补了 ${result.files} 个文件；旧目录保留。`);
+  return 0;
 }
 
 function stripIsolationHeader(text, blockStart) {
@@ -174,38 +409,11 @@ function stripIsolationHeader(text, blockStart) {
   return lines.join('\n');
 }
 
+const MIGRATE = process.argv.includes('--migrate') || process.argv.includes('migrate');
+const FORCE = process.argv.includes('--force');
+
 const profileManifest = join(PROFILE_DIR, 'package.json');
 if (!existsSync(profileManifest)) process.exit(0);
 
-let patch = readText(PATCH_PATH);
-if (patch === null) process.exit(0);
-
-const legacy = parseBlocks(patch).filter((block) => DATA_ROOT_IDS.has(block.id));
-const ours = legacy.filter((block) => OWN_ROOT.test(block.body));
-const custom = legacy.filter((block) => !OWN_ROOT.test(block.body));
-if (ours.length > 0) {
-  const first = Math.min(...ours.map((block) => block.lineStart));
-  patch = stripIsolationHeader(patch, first);
-  patch = removeBlocks(patch, (block) => DATA_ROOT_IDS.has(block.id) && OWN_ROOT.test(block.body));
-  writeAtomic(PATCH_PATH, patch);
-  say(`数据根改回共用：从 ${PROFILE} 的 profile 里去掉 ${ours.map((block) => block.id).join(' / ')}。`);
-}
-
-const hasSandbox = parseBlocks(patch).some((block) => block.id === 'sandbox-policy');
-if (!hasSandbox) {
-  const sandbox = readText(SANDBOX_PATCH);
-  const row = sandbox === null ? undefined : parseBlocks(sandbox).find((block) => block.id === 'sandbox-policy');
-  if (row !== undefined) {
-    patch = appendBlocks(patch, row.body);
-    writeAtomic(PATCH_PATH, patch);
-  }
-}
-
-if (custom.length > 0) {
-  warn(
-    `${PROFILE} 的会话 / 存储根是你自己改过的（${custom.map((block) => block.id).join(' / ')}）—— 这次不动它，也不并数据。`,
-  );
-  process.exit(0);
-}
-
-mergeDataRoot();
+if (MIGRATE) process.exit(migrate());
+configureDefault();

package/skills/workbench-module-diy/FAMILY.md

@@ -46,5 +46,5 @@
 ## 4 发布
 
 只在用户明确说「帮我发布」后调；先 `_changelog` 把这一版写进 `CHANGELOG.md`。
-出口、署名、标题、安装命令由工具与审批屏处理，不用问、不用补。
+出口、署名、标题、安装命令由工具与审批屏处理，不用问、不用补；没写作者时审批屏显示推断的署名（市集里上次的 / 同工坊的 / 本机 git 身份），用户觉得不对就拒绝后再说，他点名了才传 `author=…`。
 需要用户接管时返回 `needsUser: { step, text, command? }`：把 `text` 说给用户，等「好了」再跑；不向用户要 token。

package/skills/workbench-module-diy/REVIEW.md

@@ -5,12 +5,12 @@
 | 判据 | 检查 | 修法 |
 |---|---|---|
 | `contracts` | 清单 ↔ 代码 ↔ `design.json` 漂移；dsh 组合期不校验清单 | 按报错改：`unit` 重名换名；`dsh.workbenchFaces` 两个源码入口；六个脚本；`private: true`。`dsh.workbench.tools` 与 `registerTools()` 一致；`design.json` 对键名；生成物过期跑 `sync` |
-| `protocol` | `dsh.workbench` 版本 / 形状 / 多余键（外壳静默忽略生字段） | 补 `"apiVersion": 2`；`unit` / `card` / `tools` / `host` 写全（无卡片 `null`、无工具 `[]`）；删协议外键（`faces` 在 `dsh.workbenchFaces`；不写 `scope`） |
+| `protocol` | `dsh.workbench` 版本 / 形状 / 多余键（外壳静默忽略生字段） | 补 `"apiVersion": 3`；`unit` / `title` / `card` / `tools` / `host` 写全（名字是 `{ zh, en }` 字面量；无卡片 `null`、无工具 `[]`）；删协议外键（`faces` 在 `dsh.workbenchFaces`；不写 `scope`） |
 | `bundles` | 运行时互串：浏览器产物含 node 内置 / 宿主产物含 DOM、react | 不 import 对方那侧 |
 | `source` | 非种子 `@deepseek-ai/*`；宿主碰 dsh 浏览器包；`@/` 指外壳；根入口取运行值；客户端引 `/host`；**手写进程 / PATH / 文件锁 / 状态原子写**（import 首选库放行） | 宿主只用 Node 侧；种子词仅在 client 可达文件；`@/` 只指自己 `src/`；运行值：浏览器 `kit`、宿主 `shared/host`；进程/锁/状态写交给外壳 |
 | `primitives` | 声明 `external` 但产物无物证（原语被内联） | `dsh.client.external` 声明；devDependency 精确版对齐；产物中为 `require(...)` |
 | `kit` | 用了 peer 下限外壳没有的成员（首帧 `Element type is invalid`） | 只用 peer 范围内成员；下限抬到实际使用版 |
-| `cards` | 七种外壳侧输入 × `zh` / `en` 下崩溃 / 空白 / 脏值 | 五态可画；外层 `Card`；`titleKey` 与卡片用到的键双语齐。不断言具体态（归 `plugin.test.ts`） |
+| `cards` | 七种外壳侧输入 × `zh` / `en` 下崩溃 / 空白 / 脏值 | 五态可画；外层 `Card`；卡片自己用到的文案键双语齐（名字走清单 `title`，不再是卡片键）。不断言具体态（归 `plugin.test.ts`） |
 | `standalone` | 依赖工作台源码才能构建 | 不引用工作台源码；`tsconfig.paths` 用相对路径 |
 | `markers` | 私有源 / 私网地址 / 内网域名进入公开包 | 不进包；配置落到模块配置面；组织特有的词表由 `DSH_WB_INTERNAL_MARKERS` 提供 |
 | `alias` | `@/` 指向工作台源码 | `@/` 只指自己 `src/` |

package/skills/workbench-module-diy/SKILL.md

@@ -47,6 +47,7 @@ description: 在工作台里把当前面板调明白，或者给它造一块新
    审批项标注「要你真用一次」，不打勾。结论只报：已装、在面板哪一格。
 8. **发布** —— 只在用户说「帮我发布」之后：`workbench_diy_changelog`（`note=…`）记这一版 → `workbench_diy_publish`（`unit=…`）。
    不手改 `package.json`、不补标题/署名、不问出口：工具与审批屏已经处理；他明确点名安装包 / 公开 / git 才传 target。
+   他说要换作者才传 `author="姓名 <邮箱>"`，别自己编一个；没写作者时审批屏显示推断的署名，他拒绝后再说。
    验收没过先 `design accept`；`needsUser` 照 `text` 转述。细节见 [WIRING.md](WIRING.md) §5。
 
 ## 索引

package/skills/workbench-module-diy/TOOLS.md

@@ -118,7 +118,7 @@
   未知 `kind` 或 `source.kind` 判红；need 里未知字段只警告，`x-` 前缀忽略。
 - 未装好文案由模块写：`libInstallCommand({ need, source })`（`@dsh-workbench/shared/host`）拼好源与缓存目录，
   原样输出；放进失败态。
-- `contracts` 判据：`apiVersion` 必须是 2；`needs` 走同一份 `NEED_KINDS` 注册表校验（`purpose` 必填、
+- `contracts` 判据：`apiVersion` 必须是 3；`needs` 走同一份 `NEED_KINDS` 注册表校验（`purpose` 必填、
   `bin`/`env` 不许带 `sources`、`lib` 只认 npm 源）；声明了 `lib` 必须用 `libInstallCommand`。
   未知 `runtime` 不判红：探针会给「这个运行时工作台还不认识」的 `unchecked`，等运行时 provider 补上。
 

package/skills/workbench-module-diy/WIRING.md

@@ -65,5 +65,7 @@ DIY 族仅在选了 DIY 模式的会话出现（按模式，不按工作区）
 
 1. 先把这一版写进 `CHANGELOG.md`（`workbench_diy_changelog`，`note=…`），真卡片验收过（`design accept`）。
    出口、署名、标题、安装命令都由工具与审批屏处理：不用问、不用补；用户没点名出口就不传 target。
+   用户要换署名（或在审批屏上说作者不对）：传 `author="姓名 <邮箱>"`（或只给姓名），别手改 `package.json`，也别自己编。
+   没写作者时审批屏显示推断的署名；他拒绝后说换成谁，再用 `author` 重发。
 2. 工具回 `needsUser` 时照 `text` 转述，不在对话里要 token / OTP；`otp` 交接后 `verify=true` 只核不发。
-3. 只改市集元数据（标题 / 作者 / 说明）不升版本：`refresh=true`。
+3. 只改市集元数据（标题 / 作者 / 说明）不升版本：`refresh=true`（换作者时同时传 `author`）。

package/skills/workbench-module-diy/WRITES.md

@@ -23,7 +23,7 @@
 
 3. **无现成命令 → 让用户录一次**（你准备，用户执行）：
 
-   - `workbench_diy_record_prepare({ unit, url, doing })`：开窗置前（**需审批一次**：站点、录哪一下、落点、
+   - `workbench_diy_record_prepare({ unit, url, doing })`：开窗置前（**需审批一次**：站点、录哪一下、保存到、
      录完不切回），装浮条。用户：① 开始录制 ② 做一次动作 ③ 结束录制。不要让用户点第二次。
      `url` 必须与模块读源同域（`design.json` 声明过读源时跨域当场拒）。
    - 表填好、提交前，请用户按浮条「截图」：不额外审批；产出整页图 + 页面快照（控件 `name` / `id`、