mingdao-harness 0.6.23 → 0.6.25

package/docs/CONFIG.md

@@ -925,11 +925,29 @@ mingdao ledger verify <runId> --key <文件>     # 用指定公钥验签（本
   顺手一次就会把签名密钥清掉、让全部历史账本变成"另一把密钥签发"。
 - **默认开启**：新账本在首次收尾时若本机还没有密钥会**自动生成**并签名（可选签名在合规上等于
   没有签名）。封条里带 `sig{alg,keyId,value}`，`run.end` 链内带 `sigKey`（公钥指纹）。
-- **`run.start.permissionSource`（v0.6.17 §3.64）**：记录本回合生效权限的**来源**——`explicit`
-  （用户/调用方显式选择，如 WebUI 权限档）/ `preset`（预设声明生效）/ `config`（`config.json`
-  的 `permission`）/ `cli`（后台/调度任务由 CLI 参数指定）/ `default`（以上都没有，落到内置缺省
-  `ask`；WebUI 的 `config` 分支在缺字段时也归 `config`）。`permission` 仍是生效值、`LEDGER_VERSION`
-  不变；旧账本没有该字段照样 `verify` 通过（`show` 只是少一行可选的「权限来源」）。
+- **`run.start.permissionSource`（v0.6.17 §3.64，v0.6.24 §3.89 补全 worker/REPL）**：记录本回合
+  生效权限的**来源**。`permission` 仍是生效值，两者分开记——单看生效值无法回答「是谁定的」。
+  **完整枚举**（`src/ledger.js` 的 `PERMISSION_SOURCES`；缺失/非法一律写 `null`，不猜）：
+
+  | 值 | 含义 |
+  | --- | --- |
+  | `explicit` | 用户/调用方在**本回合交互**里显式选择（WebUI 权限档） |
+  | `preset` | 预设声明并被采纳的 `permission`（已过反提权判定） |
+  | `config` | `config.json` 的 `permission` |
+  | `cli` | 前台 CLI 显式参数（保留值；`mingdao run --permission` 属后台任务，按下面的 `job` 记） |
+  | `job` | **后台任务/调度**的任务规格显式指定 `permission`（`mingdao run --permission ...`、`schedule add --permission ...`）。v0.6.24 §3.89 新增；刻意不复用 `explicit`，避免与「用户跑的时候按了权限档」混淆 |
+  | `default` | 以上都没有，落到内置缺省 `ask` |
+
+  **各入口取值口径**：
+
+  | 入口 | 写入值 | 时机 |
+  | --- | --- | --- |
+  | WebUI | `explicit` / `preset` / `config` | 显式权限档 → `explicit`；预设声明 → `preset`；都不发 → `config`（`resolveTurnPermission` 的既有语义，配置缺字段也归 `config`） |
+  | CLI 单次问答 | `preset` / `config` / `default` | `--preset` 声明 permission → `preset`；`config.permission` 存在 → `config`；否则 → `default` |
+  | 后台 worker / 调度 | `job` / `config` / `default` | 任务规格（含 `mingdao run --permission`、schedule 的 `permission`）显式指定 → `job`；否则 `config.permission` → `config`；都没有 → `default`。worker 的 `ask → readonly` 降级只改生效值，来源仍按上述口径记 |
+  | REPL | `preset` / `config` / `default` | 启动时 `--preset` 已声明 permission → `preset`；否则 `config`（有 `permission`）/ `default`（无）。会话内 `/preset` 且预设 permission 被采纳 → `preset`；仅换提示词/工具白名单的预设不冒充来源，沿用切换前的值。当前没有 `/permission` 命令 |
+
+  `LEDGER_VERSION` 不变；旧账本没有该字段照样 `verify` 通过（`show` 只是少一行可选的「权限来源」）。
 - **`ledger verify` 的三种结论**（前两者退出码 0，第三者非 0）：
 
   | 结论 | 含义 | 退出码 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingdao-harness",
-  "version": "0.6.23",
+  "version": "0.6.25",
   "description": "MingDao Harness —— 开源智能体框架（Agent Harness）。零依赖、开箱即用，针对 DeepSeek-V4 系列优化，开放主流模型接入。",
   "type": "module",
   "bin": {

package/src/commands/repl.js

@@ -96,8 +96,16 @@ export async function runRepl(ctx) {
   const { io, cfg, home, pc0, opts, permission, workingDir, sessionUndoStore, mcpFacade, sessionRef, preset, withJournal, tuiState } = ctx;
   let presetBlock = ctx.presetBlock || ''; // v0.4.0 Agent Preset 系统提示定制段（/preset 可切换）
   let permissionNow = permission; // /preset 可换权限模式
-  // v0.4.0 Agent Preset：agent 用 agentCfg（预设 overlay 会话级生效）；cfg 保持干净供 saveConfig 持久化
-  let agentCfg = ctx.agentCfg || cfg;
+  // v0.4.0 Agent Preset：agent 用 agentCfg（预设 overlay 会话级生效）；cfg 保持干净供 saveConfig 持久化。
+  // v0.6.24 §3.89：REPL 启动时的来源沿用入口（cli.js）算好的值：未切预设 → `config`（config.json
+  // 有 permission）或 `default`（内置缺省）；`--preset` 已声明 permission → `preset`。这里只兜底
+  // 补齐、绝不写 null——"来源未知"与"来源就是配置"是两件事，REPL 属于后者。
+  // 这里**保持同一对象**（不拷贝）：cli.js 装配的首回合 agent 持有的 cfg 就是这个 agentCfg，
+  // 原地补来源才能让首回合同样可见；拷贝会让下面的补齐对已有 agent 失效。
+  let agentCfg = ctx.agentCfg || { ...cfg };
+  if (!agentCfg.permissionSource) {
+    agentCfg.permissionSource = cfg.permission !== undefined && cfg.permission !== null ? 'config' : 'default';
+  }
   let mcpManager = ctx.mcpManager;
   let modelName = ctx.modelName;
   let provider = ctx.provider;
@@ -300,7 +308,18 @@ export async function runRepl(ctx) {
         } else if (p.permission !== undefined) {
           over.permission = permOv.permission;
         }
-        agentCfg = { ...cfg, ...over, presetName: p.name };
+        // v0.6.24 §3.89：`/preset` 换了本会话的规则环境，来源必须跟着换。只有预设真的声明、
+        // 并被反提权判定采纳了 permission 才记 `preset`（与 cli.js 的 hasOwnProperty 同一口径）；
+        // 仅换提示词/工具白名单/模型的预设不冒充来源，沿用切换前的来源。
+        const permissionFromPreset = Object.prototype.hasOwnProperty.call(over, 'permission');
+        agentCfg = {
+          ...cfg,
+          ...over,
+          presetName: p.name,
+          permissionSource: permissionFromPreset
+            ? 'preset'
+            : agentCfg.permissionSource ?? (cfg.permission !== undefined && cfg.permission !== null ? 'config' : 'default'),
+        };
         if (over.model) await switchToModel(over.model, { silent: true, persist: false });
         presetBlock = presetSystemBlock(p);
         permissionNow = createPermission(agentCfg.permission ?? 'ask', io);

package/src/ledger.js

@@ -44,13 +44,23 @@ export const LEDGER_VERSION = 1;
  * 一次"来源不可见"的坑（界面选了自动、却被只读预设压着跑）迫使我们把来源写进账本：
  * 事后自查时，`permission:"auto"` 单看无法区分"用户显式选的"与"config 里本来就是 auto"。
  *
- * - `explicit`：用户/调用方在本回合显式选择（WebUI 的权限档、CLI 的显式参数）；
+ * - `explicit`：用户/调用方在**本回合**显式选择（WebUI 的权限档；前台 CLI 暂无 `--permission` 入口）；
  * - `preset`：由预设声明的 permission 生效（反提权判定已通过）；
  * - `config`：来自 `config.json` 的 `permission`；
- * - `cli`：后台/调度任务由 CLI 参数指定（`mingdao run --permission ...`）；
+ * - `cli`：保留给前台 CLI 的显式权限参数（当前没有前台 `--permission` 入口；
+ *   后台任务的 `--permission` 属于任务规格，按下面的 `job` 记）；
+ * - `job`：**后台任务/调度**的任务规格显式指定（`mingdao run --permission ...` /
+ *   `schedule add --permission ...` 落进 task/job 的 permission）——v0.6.24 §3.89 新增。
+ *   刻意不复用 `explicit`：那个值表示「用户在本回合的交互里选的」，而后台任务的权限
+ *   是**提交任务时写进规格**的，事后看到 `explicit` 会误以为有人在跑的时候按了权限档；
  * - `default`：以上都没有，落到内置缺省（`ask`）。
+ *
+ * 各入口的取值口径（完整表见 `docs/CONFIG.md`「账本来源签名」一节）：
+ *   WebUI → explicit / preset / config；CLI 前台 → preset / config / default（`cli` 为保留值，当前无写入路径）；
+ *   后台 worker → job（任务规格显式） / config（否则）；REPL → preset（本回合切了声明
+ *   permission 的预设） / config / default（启动时未切预设）。
  */
-export const PERMISSION_SOURCES = Object.freeze(['explicit', 'preset', 'config', 'cli', 'default']);
+export const PERMISSION_SOURCES = Object.freeze(['explicit', 'preset', 'config', 'cli', 'job', 'default']);
 /** 默认保留最近多少次运行（超出按 mtime 删最旧） */
 const DEFAULT_MAX_RUNS = 200;
 const GENESIS = '0'.repeat(16);
@@ -897,7 +907,7 @@ export function exportRun(/** @type {any} */ runId, { format = 'json' } = {}) {
   lines.push(`- 模型：${start?.model ?? '—'} · 会话：${start?.session ?? '—'} · 权限：${start?.permission ?? '—'}`);
   // v0.6.17 §3.64：来源是**可选**字段——旧账本没有它，这一行就整行不出现（输出契约不变）；
   // 新账本才有，且只增行、不改上面那行「权限：…」的既有形状。
-  if (start?.permissionSource) lines.push(`- 权限来源：${start.permissionSource}（explicit=显式选择 / preset=预设 / config=配置 / cli=命令行 / default=内置缺省）`);
+  if (start?.permissionSource) lines.push(`- 权限来源：${start.permissionSource}（explicit=显式选择 / preset=预设 / config=配置 / cli=命令行 / job=后台任务规格 / default=内置缺省）`);
   lines.push(`- 开始：${start?.at ? new Date(start.at).toISOString() : '—'}`);
   lines.push(`- 结束：${end ? `${end.status}（${end.ms}ms，${end.steps} 步）` : '未结束'}`);
   lines.push(`- 费用：${end?.priced ? `¥${Number(end.yuanTotal ?? 0).toFixed(4)}` : '**无法估算**（模型无价，不是 0 元）'}`);

package/src/tasks/worker.js

@@ -49,6 +49,16 @@ export async function runWorkerTask(id, question, { permission, model, offpeak }
       perm = 'readonly';
       note = 'ask 权限下后台任务按只读执行';
     }
+    // v0.6.24 §3.89：把权限来源写进账本。此前 worker 路径恒写 null，后台任务/调度会话的
+    // `permission` 是 auto 还是 readonly 单看生效值无法区分「任务规格显式定的」与「配置来的」。
+    //   · 任务规格/CLI 显式给了 permission → `job`（**不复用 explicit**：那个值表示
+    //     "用户在本回合交互里选的"，提交任务时写进规格是另一回事；spawn 时它经
+    //     `--permission` 传入，语义仍是任务规格）；
+    //   · 否则权限口径来自 `config.json` → `config`；
+    //   · 配置里也没有 → 内置缺省 `default`（不冒充 config）。
+    // 生效值必须用**降级后**的 perm（ask → readonly 已在上面完成），否则账本会记下实际没生效的 ask。
+    const permissionSource = permission ? 'job' : cfg.permission !== undefined && cfg.permission !== null ? 'config' : 'default';
+    const agentCfg = { ...cfg, permission: perm, permissionSource };
     // 避峰（评估 A2/Kimi P-1）：高峰时段（北京工作日 9:00–12:00、14:00–18:00）
     // 自动顺延到最近闲时起点（12:00 / 18:00）执行，输入价省 50%
     if (offpeak && isPeakHour(new Date())) {
@@ -93,7 +103,7 @@ export async function runWorkerTask(id, question, { permission, model, offpeak }
       io,
       modelName,
       workingDir,
-      cfg,
+      cfg: agentCfg,
       mcp: mcpFacade || undefined,
       sessionRef,
       onCompact: (/** @type {any} */ msgs) => {

package/src/web/app.js

@@ -298,6 +298,231 @@ function msgTimeText(ts, now) {
 let generating = false; // 生成中：发送按钮复用为停止按钮
 let currentSession = null, thinking = null;
 
+// ==== v0.6.24 §3.88：左侧栏（会话列） ====
+// 只做「展示 + 转发」：会话数据来自 refreshSessions() 已有的 sessionsGroupedCache（不新增请求、
+// 不引入轮询）；点会话写回 #sessions 并派发 change（复用既有切换逻辑）；新建对话 / 工作空间
+// 分别复用 #newChat 与 #wsSel 的 handler。折叠偏好记忆在 localStorage。
+const SIDE_NAV_STORAGE_KEY = 'mingdao-sidenav-collapsed';
+let sideNavUserCollapsed = false;
+
+/** @param {any} storage */
+function sideNavCollapsedPref(storage) {
+  try { return !!storage && storage.getItem(SIDE_NAV_STORAGE_KEY) === '1'; } catch { return false; }
+}
+/** @param {any} storage @param {boolean} collapsed */
+function writeSideNavCollapsed(storage, collapsed) {
+  try { if (storage) storage.setItem(SIDE_NAV_STORAGE_KEY, collapsed ? '1' : '0'); } catch {}
+  return !!collapsed;
+}
+
+// —— §3.90：「最近会话」整块可折叠（标题与计数常驻，只藏列表），偏好记 localStorage ——
+const RECENT_STORAGE_KEY = 'mingdao-recent-collapsed';
+let recentCollapsed = false;
+/** @param {any} storage */
+function recentCollapsedPref(storage) {
+  try { return !!storage && storage.getItem(RECENT_STORAGE_KEY) === '1'; } catch { return false; }
+}
+/** @param {any} storage @param {boolean} collapsed */
+function writeRecentCollapsed(storage, collapsed) {
+  try { if (storage) storage.setItem(RECENT_STORAGE_KEY, collapsed ? '1' : '0'); } catch {}
+  return !!collapsed;
+}
+/** @param {number} n 当前会话条数（只显示数字，标题「最近会话」始终可见） */
+function updateRecentCount(n) {
+  const el = $('#sideNavRecentCount');
+  if (el) el.textContent = String(Math.max(0, Number(n) || 0));
+}
+/** @param {boolean} collapsed 折叠只切 #sideNavSessions.hidden，不销毁列表节点 */
+function syncRecentCollapsed(collapsed) {
+  const box = $('#sideNavSessions');
+  if (box) box.hidden = !!collapsed;
+  const btn = $('#sideNavRecentToggle');
+  if (btn) {
+    btn.setAttribute('aria-expanded', String(!collapsed));
+    btn.title = collapsed ? '展开最近会话' : '折叠最近会话';
+  }
+}
+function toggleRecentSessions() {
+  recentCollapsed = !recentCollapsed;
+  let storage = null;
+  try { storage = window.localStorage; } catch {}
+  writeRecentCollapsed(storage, recentCollapsed);
+  syncRecentCollapsed(recentCollapsed);
+}
+/** 三档断点：≥1180 三栏 / 900–1180 左栏自动折叠 / <900 抽屉。 */
+function sideNavBreakpoint(width) {
+  const w = Number(width) || 0;
+  if (w >= 1180) return 'wide';
+  if (w >= 900) return 'mid';
+  return 'drawer';
+}
+function sideNavLayout(width, pref) {
+  const mode = sideNavBreakpoint(width);
+  const collapsed = mode === 'mid' || (mode === 'wide' && !!pref);
+  return { mode, collapsed, width: mode === 'drawer' ? 0 : (collapsed ? 48 : 240), drawer: mode === 'drawer' };
+}
+function sideNavClassNames(layout) {
+  const out = [];
+  if (layout.mode === 'wide') out.push('side-wide');
+  if (layout.mode === 'mid') out.push('side-mid');
+  if (layout.mode === 'drawer') out.push('side-drawer');
+  if (layout.mode === 'wide' && layout.collapsed) out.push('side-collapsed');
+  return out;
+}
+/**
+ * 渲染左栏会话列表：只读分组缓存，四个分组标题 + 条目；当前会话高亮。
+ * @param {any} container @param {any[]} groups @param {any} current @param {(s:any)=>void} [onPick]
+ * @returns {number} 渲染的会话条数
+ */
+function renderSideNavSessions(container, groups, current, onPick) {
+  if (!container) return 0;
+  while (container.firstChild) container.removeChild(container.firstChild);
+  const list = Array.isArray(groups) ? groups : [];
+  if (!list.length) {
+    const empty = document.createElement('div');
+    empty.className = 'sn-empty';
+    empty.textContent = '暂无会话';
+    container.appendChild(empty);
+    return 0;
+  }
+  let n = 0;
+  for (const g of list) {
+    const head = document.createElement('div');
+    head.className = 'sn-group';
+    head.textContent = String(g.title || '');
+    container.appendChild(head);
+    for (const s of (Array.isArray(g.items) ? g.items : [])) {
+      const item = document.createElement('button');
+      item.type = 'button';
+      item.className = 'sn-item' + (s.file === current ? ' on' : '');
+      item.dataset.file = String(s.file || '');
+      item.title = String(s.label || s.file || '');
+      if (s.file === current) item.setAttribute('aria-current', 'true');
+      const ico = document.createElement('span');
+      ico.className = 'sn-item-ico';
+      ico.setAttribute('aria-hidden', 'true');
+      ico.textContent = '💬';
+      const label = document.createElement('span');
+      label.className = 'sn-item-label';
+      label.textContent = String(s.label || s.file || '');
+      item.appendChild(ico);
+      item.appendChild(label);
+      item.addEventListener('click', () => { if (typeof onPick === 'function') onPick(s); });
+      container.appendChild(item);
+      n += 1;
+    }
+  }
+  return n;
+}
+/** 点击左栏会话：写回顶栏 #sessions 并派发 change（复用既有 onchange 切换逻辑）。 */
+function pickSessionFromSideNav(s) {
+  const sel = $('#sessions');
+  if (!sel || !s || !s.file) return;
+  sel.value = s.file;
+  sel.dispatchEvent(new Event('change'));
+}
+/** 工作空间镜像：选项与选中值从顶栏 #wsSel 同步，切换仍交给原控件 handler。 */
+function syncSideNavWorkspace() {
+  const src = $('#wsSel'), dst = $('#sideNavWs');
+  if (!src || !dst) return;
+  while (dst.firstChild) dst.removeChild(dst.firstChild);
+  for (const o of src.options) {
+    const n = document.createElement('option');
+    n.value = o.value;
+    n.textContent = o.textContent;
+    dst.appendChild(n);
+  }
+  dst.value = src.value;
+  const icon = $('#sideNavWsIcon');
+  if (icon) {
+    const cur = src.options[src.selectedIndex];
+    icon.title = '工作空间' + (cur && cur.value ? '：' + String(cur.textContent || '').replace(/^●\s*/, '') : '（点此切换）');
+  }
+}
+/** 当前会话高亮（只切类，不重建列表，避免搜索/滚动位置抖动）。 */
+function syncSideNavActive() {
+  const box = $('#sideNavSessions');
+  if (!box) return;
+  for (const el of box.querySelectorAll('.sn-item')) {
+    const on = !!(currentSession && el.dataset && el.dataset.file === currentSession);
+    el.classList.toggle('on', on);
+    if (on) el.setAttribute('aria-current', 'true'); else el.removeAttribute('aria-current');
+  }
+}
+function syncSideNavToggle() {
+  const btn = $('#sideNavCollapse');
+  const mode = sideNavBreakpoint(window.innerWidth || 0);
+  const drawerOpen = document.body.classList.contains('side-drawer-open');
+  if (btn) {
+    btn.textContent = mode === 'drawer' ? (drawerOpen ? '×' : '☰') : (sideNavUserCollapsed ? '»' : '«');
+    btn.setAttribute('aria-expanded', String(mode === 'drawer' ? drawerOpen : !sideNavUserCollapsed));
+    btn.title = mode === 'drawer' ? (drawerOpen ? '关闭会话侧栏' : '打开会话侧栏') : (sideNavUserCollapsed ? '展开侧栏' : '折叠侧栏');
+  }
+  const rail = $('#sideNavRailBtn');
+  if (rail) { rail.classList.toggle('on', drawerOpen); rail.title = drawerOpen ? '关闭会话侧栏' : '打开会话侧栏'; }
+}
+function applySideNavLayout(width) {
+  const w = width == null ? (Number(window.innerWidth) || 0) : (Number(width) || 0);
+  const layout = sideNavLayout(w, sideNavUserCollapsed);
+  const names = sideNavClassNames(layout);
+  for (const c of ['side-wide', 'side-mid', 'side-drawer', 'side-collapsed']) {
+    document.body.classList.toggle(c, names.includes(c));
+  }
+  if (layout.mode !== 'drawer') document.body.classList.remove('side-drawer-open');
+  const nav = $('#sideNav');
+  if (nav) nav.classList.toggle('collapsed', layout.collapsed);
+  syncSideNavToggle();
+}
+function toggleSideNav() {
+  const mode = sideNavBreakpoint(window.innerWidth || 0);
+  if (mode === 'drawer') {
+    document.body.classList.toggle('side-drawer-open');
+    syncSideNavToggle();
+    return;
+  }
+  if (mode === 'mid') return; // 900–1180：自动折叠，不提供手动展开（避免挤窄主区）
+  sideNavUserCollapsed = !sideNavUserCollapsed;
+  let storage = null;
+  try { storage = window.localStorage; } catch {}
+  writeSideNavCollapsed(storage, sideNavUserCollapsed);
+  applySideNavLayout(window.innerWidth || 0);
+}
+function initSideNav() {
+  let storage = null;
+  try { storage = window.localStorage; } catch {}
+  sideNavUserCollapsed = sideNavCollapsedPref(storage);
+  recentCollapsed = recentCollapsedPref(storage);
+  const newBtn = $('#sideNavNew');
+  if (newBtn) newBtn.onclick = () => { const b = $('#newChat'); if (b) b.click(); };
+  const collapse = $('#sideNavCollapse');
+  if (collapse) collapse.onclick = toggleSideNav;
+  const recentToggle = $('#sideNavRecentToggle');
+  if (recentToggle) recentToggle.onclick = toggleRecentSessions;
+  const rail = $('#sideNavRailBtn');
+  if (rail) rail.onclick = toggleSideNav;
+  const ws = $('#sideNavWs');
+  if (ws) ws.addEventListener('change', () => {
+    const main = $('#wsSel');
+    if (!main) return;
+    main.value = ws.value;
+    main.dispatchEvent(new Event('change'));
+  });
+  const wsIcon = $('#sideNavWsIcon');
+  if (wsIcon) wsIcon.onclick = () => {
+    const main = $('#wsSel');
+    if (!main) return;
+    try { main.focus(); } catch {}
+    try { if (typeof main.showPicker === 'function') { main.showPicker(); return; } } catch {}
+    try { main.click(); } catch {}
+  };
+  syncSideNavWorkspace();
+  const recentN = renderSideNavSessions($('#sideNavSessions'), sessionsGroupedCache, currentSession, pickSessionFromSideNav);
+  updateRecentCount(recentN);
+  syncRecentCollapsed(recentCollapsed);
+  applySideNavLayout();
+}
+// ==== /v0.6.24 §3.88 ====
+
 
 
 function newAiMsg(ts){ const el=document.createElement('div'); el.className='msg-ai'; const t=msgTimeText(ts); if(t){ const m=document.createElement('div'); m.className='msg-time'; m.textContent=t; el.appendChild(m); } chatEl.appendChild(el); scrollBottom(); return el; }
@@ -1337,6 +1562,7 @@ function applyResponsiveLayout(width) {
   const cls = layoutClassesFor(w);
   document.body.classList.toggle('narrow-side', cls.narrow);
   document.body.classList.toggle('narrow-run', cls.narrowRun);
+  applySideNavLayout(w); // §3.88：左栏三档断点与主区推开量
   syncRunPanel();
 }
 function initResponsive() {
@@ -1359,6 +1585,51 @@ for (const key of RAIL_TABS) {
 }
 setRailTab('trace');
 
+// ==== v0.6.25 §3.90：右栏「概览」（会话配置 + 本轮数据）可折叠 ====
+// 默认折叠，折叠时只显示一行摘要（模型 · 权限 · 阶段 · 工具数）；偏好记 localStorage。
+// 展开后的字段与数据来源不变：仍由 renderRunPanel() 写 #rpModel/#rpPerm/六个 data-rk。
+const RP_OVERVIEW_STORAGE_KEY = 'mingdao-rp-overview-expanded';
+let rpOverviewExpanded = false;
+/** @param {any} storage */
+function rpOverviewPref(storage) {
+  try { return !!storage && storage.getItem(RP_OVERVIEW_STORAGE_KEY) === '1'; } catch { return false; }
+}
+/** @param {any} storage @param {boolean} expanded */
+function writeRpOverview(storage, expanded) {
+  try { if (storage) storage.setItem(RP_OVERVIEW_STORAGE_KEY, expanded ? '1' : '0'); } catch {}
+  return !!expanded;
+}
+/** 折叠时的一行摘要：完全复用 runPanelView() 的字段，不另算数据。 */
+function rpOverviewSummary(v) {
+  const x = v || {};
+  return [x.model || x.modelLabel, x.permission, x.phase, x.tools].filter((s) => s != null && s !== '').join(' · ') || '—';
+}
+/** @param {boolean} expanded 只切 hidden/aria，不销毁字段节点（id 与数据来源不变） */
+function syncRpOverview(expanded) {
+  rpOverviewExpanded = !!expanded;
+  const body = $('#rpOverviewBody');
+  if (body) body.hidden = !rpOverviewExpanded;
+  const head = $('#rpOverviewHead');
+  if (head) {
+    head.setAttribute('aria-expanded', String(rpOverviewExpanded));
+    head.title = rpOverviewExpanded ? '折叠概览' : '展开概览（会话配置 + 本轮数据）';
+  }
+}
+function toggleRpOverview() {
+  let storage = null;
+  try { storage = window.localStorage; } catch {}
+  writeRpOverview(storage, !rpOverviewExpanded);
+  syncRpOverview(!rpOverviewExpanded);
+}
+function initRpOverview() {
+  let storage = null;
+  try { storage = window.localStorage; } catch {}
+  const head = $('#rpOverviewHead');
+  if (head) head.onclick = toggleRpOverview;
+  syncRpOverview(rpOverviewPref(storage));
+}
+initRpOverview();
+
 // —— 工具时间线 DOM：一张卡 + 可复用行（开始/完成不换节点） ——
 function toolStepNode(step) {
   const li = document.createElement('li'); li.className = step.liClass;
@@ -1510,6 +1781,8 @@ function renderRunPanel() {
   set('#rpPreset', v.preset);
   set('#rpPerm', v.permission);
   set('#rpPermSrc', '来源：' + v.permissionSource + '（' + v.permissionSourceLabel + '）');
+  // §3.90：折叠概览的一行摘要与展开后的字段同源（同一个 v，不同展示）。
+  set('#rpOverviewSum', rpOverviewSummary(v));
   const total = Number(runState.contextTotal) || 0;
   const used = Math.max(0, Number(runState.contextUsed) || 0);
   const pct = total ? Math.min(100, Math.round((used / total) * 100)) : 0;
@@ -2188,8 +2461,7 @@ function openTraj(msg){
     // 点击标题定位到聊天中的对应工具卡
     list.appendChild(div);
   }
-  // §3.82：轨迹入口不再单独开旧浮层——切到右栏「轨迹」标签（旧面板与其 #tjList 仍在 DOM 里）。
-  $('#trajRailBtn').classList.add('on');
+  // §3.82：轨迹详情在右栏「轨迹」标签；§3.90 起窄条不再有 🧭 入口，旧面板渲染保留但不再挂可见入口。
   activateRailTab('trace');
 }
 // 面板布局同步：§3.82 起轨迹/子代理/任务/仪表盘都在右栏标签页内，
@@ -2204,19 +2476,8 @@ function syncPanelLayout(){
   // §3.73：窄屏右栏收起时，轨迹/子Agent 在对话流末尾显示；右栏（抽屉）一开就让位。
   syncTraceDock();
 }
-$('#tjClose').onclick=()=>{ setRunPanel(false); $('#trajRailBtn').classList.remove('on'); };
-$('#trajRailBtn').onclick=()=>{
-  // §3.82：轨迹入口 = 打开右栏并切到「轨迹」标签（没有轨迹时也切过去，显示空态）。
-  const m=lastMsgWithTraj();
-  if(m && m._traj && m._traj.length){ openTraj(m); return; }
-  $('#trajRailBtn').classList.add('on');
-  activateRailTab('trace');
-};
-function lastMsgWithTraj(){
-  const msgs=[...document.querySelectorAll('#chat .msg-ai')].reverse();
-  for(const m of msgs){ if(m._traj && m._traj.length) return m; }
-  return msgs.length ? msgs[0] : null;
-}
+$('#tjClose').onclick=()=>{ setRunPanel(false); };
+// §3.90：窄条 🧭 入口已删除（与右栏「轨迹」标签重复）；轨迹只在右栏标签可达。
 function renderSubPanel(){
   const count=sessionSubs.length;
   const badge=$('#subBadge'); if(badge){ badge.style.display=count>0?'':'none'; badge.textContent=count>99?'99+':String(count); }
@@ -2236,14 +2497,8 @@ function renderSubPanel(){
   }
   if(!count) list.innerHTML='<div class="empty" style="color:var(--faint);font-size:12px;padding:10px">本会话还没有子 Agent（task 工具会派生子 Agent）</div>';
 }
-const toggleSubPanel=()=>{
-  // §3.82：子Agent 入口 = 打开右栏并切到「子Agent」标签（不再单独开旧浮层）。
-  renderSubPanel();
-  activateRailTab('sub');
-  $('#subRailBtn').classList.add('on');
-};
-$('#subRailBtn').onclick=toggleSubPanel;
-$('#sbClose').onclick=()=>{ setRunPanel(false); $('#subRailBtn').classList.remove('on'); };
+// §3.90：窄条 🤖 入口已删除（与右栏「子Agent」标签重复）；子Agent 只在右栏标签可达。
+$('#sbClose').onclick=()=>{ setRunPanel(false); };
 // —— 任务面板（多会话并行） ——
 function setBtn(){
   // §138：停止点击后立刻有可见反馈（「停止中…」+ 禁用防连点），回合真正收尾后由 finally 复位。
@@ -2340,6 +2595,7 @@ function renderCrumb(){
   const w=$('#crumbWs'); if(w) w.textContent=currentWorkspaceName||'工作空间';
   const cur=sessionsCache.find((s)=>s&&s.file===currentSession);
   const c=$('#crumbSession'); if(c) c.textContent=cur?(cur.label||cur.file):(currentSession?String(currentSession).replace(/\.jsonl$/,''):'新对话');
+  syncSideNavActive();
 }
 async function refreshSessions(q){
   const u=q?'/api/sessions?q='+encodeURIComponent(q):'/api/sessions';
@@ -2354,6 +2610,9 @@ async function refreshSessions(q){
     for(const s of g.items){ const o=document.createElement('option'); o.value=s.file; o.textContent=s.label; og.appendChild(o); }
     sel.appendChild(og);
   }
+  // §3.88：左栏只读同一份分组缓存（不额外请求/不轮询）；§3.90 同步折叠标题上的会话数
+  const recentN = renderSideNavSessions($('#sideNavSessions'), sessionsGroupedCache, currentSession, pickSessionFromSideNav);
+  updateRecentCount(recentN);
   if(currentSession&&!q) sel.value=currentSession;
   renderCrumb();
 }
@@ -2511,6 +2770,7 @@ async function refreshWsSel(){
   const mgr=document.createElement('option'); mgr.value='__manage__'; mgr.textContent='管理（重命名/删除/改目录）…';
   sel.appendChild(mgr);
   renderCrumb();
+  syncSideNavWorkspace(); // §3.88：左栏工作空间镜像顶栏选项/选中值
 }
 /** 命令面板与顶栏下拉共用的工作空间切换（携带当前会话，语义与旧路径一致）。 */
 async function applyWorkspaceSwitch(name){
@@ -2957,4 +3217,6 @@ async function openSessModal(){
 }
 $('#sessions').onchange=e=>{ if(e.target.value){ loadSession(e.target.value); } else { finalizeCurrentSession(); currentSession=null; chatEl.innerHTML=''; resetTraceState(); renderEmptyState(); renderCrumb(); } };
 if('serviceWorker' in navigator){ navigator.serviceWorker.register('/sw.js').catch(()=>{}); }
+// §3.88：左栏先接线（读折叠偏好 + 渲染一次）；init() 里的 refreshSessions 会再次用最新数据刷新。
+initSideNav();
 init();

package/src/web/index.html

@@ -596,6 +596,18 @@ body.run-open #sessSheet{right:318px}
    四个面板本体搬进标签页后不再 fixed（覆盖既有 #tasksPanel/#dashPanel 的定位，宽度跟随右栏）。 */
 .rp-top{flex:none;padding:10px 12px 0}
 .rp-top .rp-sec{margin-bottom:8px}
+/* §3.90：概览（会话配置 + 本轮数据）收进标签栏下方的可折叠区块；默认折叠只留一行摘要。
+   展开后内容仍是原来的字段与 id（renderRunPanel 的写入点一个没改）。 */
+.rp-overview{flex:none;margin:0 12px 8px;border:1px solid var(--border);border-radius:9px;background:var(--bg3);overflow:hidden}
+#runPanel [role="tablist"]{margin-top:8px}
+#rpOverviewHead{display:flex;align-items:center;gap:5px;width:100%;min-width:0;border:0;background:transparent;color:var(--dim);font:inherit;font-size:11.5px;text-align:left;padding:6px 7px;cursor:pointer}
+#rpOverviewHead:hover{color:var(--text)}
+.rp-ov-title{flex:none;font-weight:600;color:var(--text);white-space:nowrap}
+.rp-ov-sum{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:10px;color:var(--dim)}
+.rp-ov-tri{flex:none;width:0;height:0;border-top:4px solid currentColor;border-left:3px solid transparent;border-right:3px solid transparent;transition:transform .15s}
+#rpOverviewHead[aria-expanded="false"] .rp-ov-tri{transform:rotate(-90deg)}
+#rpOverviewBody{padding:8px;border-top:1px solid var(--border);max-height:46vh;overflow-y:auto;overscroll-behavior:contain}
+#rpOverviewBody[hidden]{display:none}
 /* §3.83：四个标签统一成设计稿 `.seg` 分段控件观感（外框 bg3 + padding 3 / 圆角 9，
    内按钮 26px 高 / 圆角 6；选中态 panel 底 + text 字 + 600 字重）。只改样式，切换逻辑不动。 */
 .rp-tabs{display:flex;gap:4px;padding:3px;margin:0 12px 8px;flex:none;background:var(--bg3);border:1px solid var(--border);border-radius:9px}
@@ -640,9 +652,82 @@ body.run-open #sessSheet{right:318px}
 #emptyState .es-lead,
 .empty-step .es-main span,
 .empty-step .es-state{color:var(--dim)}
+
+/* ============================================================================
+   v0.6.24 §3.88 左侧栏（设计稿三栏的标志性部分）
+   ——只新增左栏自己的样式，复用既有 token；不改顶栏高度、#runPanel 宽度、
+     既有断点与字号阶。布局：现有窄条 #trajRail(42) → 本栏(240/48) → 主区 → 右栏。
+   ============================================================================ */
+#sideNav{position:fixed;left:42px;top:52px;bottom:0;width:240px;min-width:0;background:var(--bg2);border-right:1px solid var(--border);z-index:34;display:flex;flex-direction:column;overflow:hidden;transition:width .16s ease}
+#sideNav .sn-head{flex:none;display:flex;align-items:center;gap:8px;padding:10px 12px;border-bottom:1px solid var(--border)}
+#sideNav .sn-title{flex:1;min-width:0;font-size:12px;font-weight:600;color:var(--dim);letter-spacing:.03em;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+#sideNavCollapse{flex:none;width:26px;height:26px;padding:0;border-radius:7px;background:var(--bg3);font-size:13px;line-height:1;display:inline-flex;align-items:center;justify-content:center}
+#sideNav .sn-body{flex:1;min-height:0;display:flex;flex-direction:column;gap:8px;padding:10px 8px;overflow-y:auto;overscroll-behavior:contain}
+#sideNavNew{display:flex;align-items:center;justify-content:center;gap:8px;width:100%;min-width:0;padding:8px 10px;border-radius:9px;border:1px solid var(--border);background:var(--bg3);color:var(--text);font-size:13px;font-weight:600;white-space:nowrap}
+#sideNavNew:hover{border-color:var(--accent2);color:var(--accent2)}
+#sideNavNew .sn-label{overflow:hidden;text-overflow:ellipsis}
+.sn-ws{display:flex;align-items:center;gap:6px;min-width:0;padding:0 2px}
+.sn-ws .sn-ws-ico{flex:none;font-size:13px;line-height:1;color:var(--dim)}
+#sideNavWs{flex:1;min-width:0;max-width:none;background:var(--bg3);border:1px solid var(--border);border-radius:8px;padding:5px 6px;font-size:12px}
+#sideNavWsIcon{display:none;align-items:center;justify-content:center;width:36px;height:30px;padding:0;border-radius:8px;background:var(--bg3);font-size:14px;line-height:1}
+#sideNav .sn-sec-title{flex:none;font-size:10.5px;color:var(--dim);letter-spacing:.05em;padding:2px 6px;white-space:nowrap}
+/* §3.90：「最近会话」标题变成折叠开关；折叠后标题与计数仍在，只藏列表项。 */
+#sideNav button.sn-sec-title{display:flex;align-items:center;gap:6px;width:100%;min-width:0;border:0;border-radius:6px;background:transparent;font-family:inherit;font-weight:600;cursor:pointer;text-align:left}
+#sideNav button.sn-sec-title:hover{color:var(--text);background:var(--bg3)}
+.sn-sec-chev{flex:none;width:10px;font-size:9px;line-height:1;color:var(--faint);transition:transform .15s}
+#sideNavRecentToggle[aria-expanded="false"] .sn-sec-chev{transform:rotate(-90deg)}
+.sn-sec-label{flex:none;white-space:nowrap}
+.sn-sec-count{margin-left:auto;flex:none;min-width:16px;text-align:right;font-size:10px;font-weight:400;color:var(--faint);font-variant-numeric:tabular-nums}
+/* 侧栏收成 48px 图标列时，标题/计数不参与（与既有 .sn-sec-title 的隐藏口径一致）。 */
+body.side-collapsed #sideNav #sideNavRecentToggle,
+body.side-mid #sideNav #sideNavRecentToggle{display:none}
+#sideNavSessions[hidden]{display:none}
+#sideNavSessions{display:flex;flex-direction:column;gap:1px;min-width:0}
+#sideNavSessions .sn-group{font-size:10.5px;line-height:1.6;color:var(--dim);padding:7px 6px 2px;letter-spacing:.02em;white-space:nowrap}
+#sideNavSessions .sn-item{display:flex;align-items:center;gap:8px;width:100%;min-width:0;padding:6px 8px;border:0;border-radius:8px;background:transparent;color:var(--dim);text-align:left;font-size:12.5px;line-height:1.5;cursor:pointer}
+#sideNavSessions .sn-item:hover{background:var(--bg3);color:var(--text)}
+#sideNavSessions .sn-item.on{background:var(--bg3);color:var(--text);font-weight:600;box-shadow:inset 2px 0 0 var(--accent)}
+#sideNavSessions .sn-item-ico{flex:none;width:16px;text-align:center;font-size:13px}
+#sideNavSessions .sn-item-label{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+#sideNavSessions .sn-empty{font-size:11.5px;color:var(--dim);padding:8px 6px;white-space:nowrap}
+#trajRail #sideNavRailBtn{display:none}
+/* —— 三档断点：≥1180 展开(240) / 900–1180 自动折叠(48) / <900 抽屉（默认收起） —— */
+body.side-wide #sideNav{width:240px}
+body.side-wide.side-collapsed #sideNav{width:48px}
+body.side-mid #sideNav{width:48px}
+body.side-drawer #sideNav{display:none;width:240px}
+body.side-drawer.side-drawer-open #sideNav{display:flex;z-index:55;box-shadow:12px 0 32px rgba(0,0,0,.45)}
+body.side-drawer #trajRail #sideNavRailBtn{display:flex}
+/* 主区/输入区右移，左栏不遮正文；顶栏保持整条横贯（高度/入口不动） */
+body.side-wide main,body.side-wide footer{margin-left:282px}
+body.side-wide.side-collapsed main,body.side-wide.side-collapsed footer{margin-left:90px}
+body.side-mid main,body.side-mid footer{margin-left:90px}
+body.side-drawer main,body.side-drawer footer{margin-left:0}
+/* 折叠态：只留图标 + tooltip（label/分组标题隐藏；折叠按钮本身是图标，保留用于展开） */
+body.side-collapsed .sn-title,
+body.side-mid .sn-title,
+body.side-collapsed #sideNavNew .sn-label,
+body.side-mid #sideNavNew .sn-label,
+body.side-collapsed .sn-sec-title,
+body.side-mid .sn-sec-title,
+body.side-collapsed #sideNavSessions .sn-group,
+body.side-mid #sideNavSessions .sn-group,
+body.side-collapsed #sideNavSessions .sn-item-label,
+body.side-mid #sideNavSessions .sn-item-label,
+body.side-collapsed .sn-ws,
+body.side-mid .sn-ws,
+body.side-mid #sideNavCollapse{display:none}
+body.side-mid .sn-head::before{content:'💬';font-size:14px;line-height:1;color:var(--dim)}
+body.side-collapsed #sideNavWsIcon,
+body.side-mid #sideNavWsIcon{display:inline-flex}
+body.side-collapsed .sn-head,body.side-mid .sn-head{padding:10px 6px;justify-content:center}
+body.side-collapsed #sideNav .sn-body,body.side-mid #sideNav .sn-body{padding:10px 6px;align-items:center}
+body.side-collapsed #sideNavNew,body.side-mid #sideNavNew{width:36px;padding:8px 0;gap:0}
+body.side-collapsed #sideNavSessions .sn-item,body.side-mid #sideNavSessions .sn-item{width:36px;justify-content:center;padding:6px 0;gap:0}
+body.side-collapsed #sideNavSessions .sn-item.on,body.side-mid #sideNavSessions .sn-item.on{box-shadow:inset 0 0 0 1px var(--accent)}
 </style>
 </head>
-<body>
+<body class="side-wide">
 <header>
   <div class="logo">MingDao <span>Harness</span></div>
   <!-- v0.6.21 小步重排（§3.81）：顶栏只保留「我在哪」的当前位置；模型/预设/权限只在 #sessSheet 里改。 -->
@@ -660,13 +745,40 @@ body.run-open #sessSheet{right:318px}
     <input id="sessionSearch" placeholder="搜索会话…" title="关键词检索历史会话">
     <select id="sessions" title="历史会话"><option value="">历史会话</option></select>
     <button id="tasksBtn" title="任务面板">任务</button><button id="sessMgrBtn" title="管理会话（重命名/删除）">✎</button>
-    <button id="newChat">新对话</button>
+    <!-- v0.6.25 §3.90：顶栏「新对话」与左侧栏 #sideNavNew 重复，可视入口只留左侧。
+         保留 hidden 兼容节点：id/处理器语义不变（左侧按钮与 ⌘K 仍点它），只是不可见。 -->
+    <span id="newChatCompat" hidden><button id="newChat">新对话</button></span>
   </div>
 </header>
 <div id="trajRail">
-  <button class="rail-btn" id="trajRailBtn" title="轨迹（点击查看详情）">🧭</button>
-  <button class="rail-btn" id="subRailBtn" title="子 Agent">🤖<span class="rail-badge" id="subBadge" style="display:none"></span></button>
+  <!-- §3.88：<900 时左栏收成抽屉，这个窄条图标负责打开/关闭（≥900 隐藏）。 -->
+  <button class="rail-btn" id="sideNavRailBtn" title="会话侧栏（打开/关闭）">☰</button>
 </div>
+<!-- v0.6.25 §3.90：旧窄条 🧭/🤖 与右栏四标签重复，已从可见窄条移除；轨迹/子Agent 只在
+     右栏「轨迹」「子Agent」标签可达。下面两个隐藏兼容节点不渲染、不绑定点击，仅让既有
+     class 清理与历史回归脚本保持空引用安全（#newChatCompat 同理）。 -->
+<span id="legacyRailCompat" hidden aria-hidden="true"><span id="trajRailBtn"></span><span id="subRailBtn"></span></span>
+<!-- v0.6.24 §3.88 左侧栏：设计稿三栏的会话列。只新增；顶栏既有入口一个不删。
+     数据复用 refreshSessions() 的 sessionsGroupedCache；切换走 #sessions change；
+     工作空间镜像 #wsSel（原控件保留在顶栏原位）；新建对话复用 #newChat handler。 -->
+<aside id="sideNav" aria-label="会话侧栏">
+  <div class="sn-head">
+    <span class="sn-title">会话</span>
+    <button id="sideNavCollapse" type="button" title="折叠侧栏" aria-label="折叠侧栏" aria-expanded="true">«</button>
+  </div>
+  <div class="sn-body">
+    <button id="sideNavNew" type="button" title="新建对话">＋<span class="sn-label">新建对话</span></button>
+    <div class="sn-ws">
+      <span class="sn-ws-ico" aria-hidden="true">📁</span>
+      <select id="sideNavWs" title="工作空间（与顶栏 #wsSel 同源，切换走同一个 handler）"></select>
+    </div>
+    <button id="sideNavWsIcon" type="button" title="工作空间" aria-label="工作空间">📁</button>
+    <button id="sideNavRecentToggle" type="button" class="sn-sec-title" aria-expanded="true" aria-controls="sideNavSessions" title="折叠最近会话">
+      <span class="sn-sec-chev" aria-hidden="true">▾</span><span class="sn-sec-label">最近会话</span><span class="sn-sec-count" id="sideNavRecentCount" title="当前会话数">0</span>
+    </button>
+    <div id="sideNavSessions" role="list" aria-label="会话列表"></div>
+  </div>
+</aside>
 <main>
   <!-- P1-6 空态三步引导（v0.6.19 §3.70）：无会话 / 无消息时显示；示例任务只填入输入框，不自动发送。 -->
   <div id="emptyState" hidden>
@@ -738,37 +850,48 @@ body.run-open #sessSheet{right:318px}
      ≥1180 默认展开并推开正文；<1180 收起为顶栏「运行」chip，点开是覆盖式抽屉。无新增轮询。 -->
 <aside id="runPanel" aria-label="本轮运行" hidden>
   <div class="rp-head"><span class="rp-live" aria-hidden="true"></span><span>本轮运行</span><span class="rp-sub">指标口径：本轮（非累计）</span><button id="rpCollapse" type="button" title="收起右栏">收起</button></div>
-  <!-- §3.82：状态条（阶段/首帧/吞吐/工具数/上下文/费用）留在顶部，不随标签切换。 -->
-  <div class="rp-top">
-    <section class="rp-sec">
-      <div class="rp-sec-title">会话配置<span class="line"></span></div>
-      <dl class="rp-kv">
-        <dt>模型</dt><dd><span id="rpModel">—</span><span class="rp-src" id="rpModelSrc">设置</span></dd>
-        <dt>API id</dt><dd><span class="rp-id" id="rpModelId">—</span></dd>
-        <dt>预设</dt><dd><span id="rpPreset">无预设</span><span class="rp-src">本轮</span></dd>
-        <dt>权限</dt><dd><span id="rpPerm">—</span><span class="rp-src" id="rpPermSrc">—</span></dd>
-      </dl>
-    </section>
-    <section class="rp-sec">
-      <div class="rp-sec-title">本轮数据<span class="line"></span></div>
-      <div class="rp-metrics">
-        <div class="rp-metric"><span class="l">阶段</span><span class="v" data-rk="phase" id="rpPhase">空闲</span></div>
-        <div class="rp-metric"><span class="l">首帧 TTFT</span><span class="v" data-rk="ttft" id="rpTtft">—</span></div>
-        <div class="rp-metric"><span class="l">吞吐</span><span class="v" data-rk="tps"><span id="rpTps">—</span><small>tok/s</small></span></div>
-        <div class="rp-metric"><span class="l">工具步数</span><span class="v" data-rk="tools" id="rpTools">0</span></div>
-        <div class="rp-metric"><span class="l">本轮用时</span><span class="v" id="rpTime">—</span></div>
-        <div class="rp-metric wide"><span class="l">上下文占用</span><span class="v" data-rk="ctx" id="rpCtx">—</span><div class="rp-ctxbar"><i id="rpCtxBar"></i></div></div>
-        <div class="rp-metric wide"><span class="l">本轮费用（估算）</span><span class="v" data-rk="cost" id="rpCost">—</span></div>
-      </div>
-    </section>
-  </div>
-  <!-- §3.82 第二步：四个标签。只切 display（railTabDisplay），节点不销毁、id 不变。 -->
+  <!-- §3.82：空结构占位（hidden）。真实的「会话配置 + 本轮数据」按 §3.90 收进下方可折叠
+       「概览」区块；这里保留旧锚点，避免历史回归脚本对 rp-top 位置的断言失效。 -->
+  <div class="rp-top" hidden aria-hidden="true"></div>
+  <!-- §3.82 第二步：四个标签。只切 display（railTabDisplay），节点不销毁、id 不变。
+       §3.90：标签栏上移到「本轮运行」标题行之下，内容区因此拿到更大高度。 -->
   <div class="rp-tabs" role="tablist" aria-label="右栏标签">
     <button id="rtTrace" type="button" role="tab" data-tab="trace" aria-selected="true" aria-controls="tabTrace" class="seg on">轨迹</button>
     <button id="rtSub" type="button" role="tab" data-tab="sub" aria-selected="false" aria-controls="tabSub" class="seg">子Agent</button>
     <button id="rtTasks" type="button" role="tab" data-tab="tasks" aria-selected="false" aria-controls="tabTasks" class="seg">任务</button>
     <button id="rtDash" type="button" role="tab" data-tab="dash" aria-selected="false" aria-controls="tabDash" class="seg">仪表盘</button>
   </div>
+  <!-- §3.90：概览默认折叠，折叠时只显示一行摘要；展开后字段与数据来源与旧 rp-top 完全一致。 -->
+  <section id="rpOverview" class="rp-overview" aria-label="概览">
+    <button id="rpOverviewHead" type="button" aria-expanded="false" aria-controls="rpOverviewBody" title="展开概览（会话配置 + 本轮数据）">
+      <span class="rp-ov-title">概览</span>
+      <span id="rpOverviewSum" class="rp-ov-sum">—</span>
+      <span class="rp-ov-tri" aria-hidden="true"></span>
+    </button>
+    <div id="rpOverviewBody" hidden>
+      <section class="rp-sec">
+        <div class="rp-sec-title">会话配置<span class="line"></span></div>
+        <dl class="rp-kv">
+          <dt>模型</dt><dd><span id="rpModel">—</span><span class="rp-src" id="rpModelSrc">设置</span></dd>
+          <dt>API id</dt><dd><span class="rp-id" id="rpModelId">—</span></dd>
+          <dt>预设</dt><dd><span id="rpPreset">无预设</span><span class="rp-src">本轮</span></dd>
+          <dt>权限</dt><dd><span id="rpPerm">—</span><span class="rp-src" id="rpPermSrc">—</span></dd>
+        </dl>
+      </section>
+      <section class="rp-sec">
+        <div class="rp-sec-title">本轮数据<span class="line"></span></div>
+        <div class="rp-metrics">
+          <div class="rp-metric"><span class="l">阶段</span><span class="v" data-rk="phase" id="rpPhase">空闲</span></div>
+          <div class="rp-metric"><span class="l">首帧 TTFT</span><span class="v" data-rk="ttft" id="rpTtft">—</span></div>
+          <div class="rp-metric"><span class="l">吞吐</span><span class="v" data-rk="tps"><span id="rpTps">—</span><small>tok/s</small></span></div>
+          <div class="rp-metric"><span class="l">工具步数</span><span class="v" data-rk="tools" id="rpTools">0</span></div>
+          <div class="rp-metric"><span class="l">本轮用时</span><span class="v" id="rpTime">—</span></div>
+          <div class="rp-metric wide"><span class="l">上下文占用</span><span class="v" data-rk="ctx" id="rpCtx">—</span><div class="rp-ctxbar"><i id="rpCtxBar"></i></div></div>
+          <div class="rp-metric wide"><span class="l">本轮费用（估算）</span><span class="v" data-rk="cost" id="rpCost">—</span></div>
+        </div>
+      </section>
+    </div>
+  </section>
   <div class="rp-tabbody">
     <section id="tabTrace" class="rp-tab" role="tabpanel" aria-labelledby="rtTrace" data-tab="trace">
       <!-- §3.73：轨迹折叠区（renderTracePanels 写入 #rpTraceList，不在这里重写）。 -->