pi-skill-evolve 0.1.4 → 0.1.6

package/extensions/skill-evolve/lib/web/render-table.ts

@@ -0,0 +1,126 @@
+/**
+ * 列表的表格与分组：五列（状态 / 时间 / 技能 / 提案 / 操作）+ 同会话多条 run 的 `<details>` 分组。
+ *
+ * 为什么单独一个文件：行数据怎么取（render-rows.ts）与表怎么画是两件事，
+ * 表这部分自己就有三块（单行、分组、组标题摘要），挤在映射文件里会破 300 行。
+ * 这里只认 `ListRow`，不认识任何具体视图的数据结构。
+ */
+import { sessionHref, type SessionRef } from "./run-session.ts";
+import type { ListExtras } from "./list-query.ts";
+import { escapeHtml, formatClock, formatIso } from "./text.ts";
+import type { ListRow } from "./render-rows.ts";
+
+/** 表格骨架：五列固定，列宽由 CSS 管；操作列右对齐，扫行时视线不用来回跳 */
+const TABLE_HEAD = `<thead><tr><th class="status">状态</th><th class="time">时间</th><th class="skill">技能</th><th class="delta">提案</th><th class="ops">操作</th></tr></thead>`;
+
+/** 会话小字：单条会话的 run 不进组，所以会话只在这种行的状态格里出现一次 */
+function sessionLine(session: SessionRef): string {
+  // 老 run.json 可能没有 sessionId：写「会话 —」而不是凭空造一个空链接（点进去只会 404）
+  if (session.sessionId === null) return `<span class="sk-sess">会话 —</span>`;
+  const href = sessionHref(session);
+  const text = escapeHtml(`会话 ${session.sessionId.slice(0, 8)}`);
+  const link = href === null ? text : `<a class="sess" href="${escapeHtml(href)}" title="${escapeHtml(session.sessionId)}">${text}</a>`;
+  return `<span class="sk-sess">${link}</span>`;
+}
+
+function rowHtml(row: ListRow, standalone: boolean, now: number): string {
+  const time = row.at === null ? "—" : formatClock(row.at, now);
+  const skill = row.skill.length === 0 ? `<span class="off">—</span>` : `<code>${escapeHtml(row.skill)}</code>`;
+  const delta =
+    row.delta === null ? `<span class="off">—</span>` : `+${row.delta.added} / -${row.delta.removed}`;
+  const at = row.at === null ? "" : ` title="${escapeHtml(formatIso(row.at))}"`;
+  const badge = `<span class="badge ${row.badge.tone}" title="${escapeHtml(row.badge.title)}">${escapeHtml(row.badge.text)}</span>`;
+  return `<tr>
+<td class="status">${badge}${standalone ? sessionLine(row.session) : ""}</td>
+<td class="time"${at}>${time}</td>
+<td class="skill">${skill}</td>
+<td class="delta">${delta}</td>
+<td class="ops">${row.ops}</td>
+</tr>`;
+}
+
+/** 一张表：表头固定五列，列宽与省略号由 CSS 管 */
+function table(rows: readonly ListRow[], now: number, standalone: boolean): string {
+  return `<table class="rows">
+${TABLE_HEAD}
+<tbody>
+${rows.map((row) => rowHtml(row, standalone, now)).join("\n")}
+</tbody>
+</table>`;
+}
+
+/** 一个渲染块：连续的单条 run 合成一张表；同一会话的多条 run 各成一组 */
+export type RowBlock =
+  | { kind: "rows"; rows: ListRow[] }
+  | { kind: "group"; session: SessionRef; rows: ListRow[] };
+
+/**
+ * 按会话分组：**只有同一 sessionId 出现两次以上才进组**。
+ * 单条会话的 run 包进 `<details>` 只会多一次点击（组里就一行），所以直接平铺。
+ * 组出现在它第一条成员的位置，成员内部按时间倒序。
+ */
+export function groupRows(rows: readonly ListRow[]): RowBlock[] {
+  const counts = new Map<string, number>();
+  for (const row of rows) {
+    const id = row.session.sessionId;
+    if (id !== null) counts.set(id, (counts.get(id) ?? 0) + 1);
+  }
+  const emitted = new Set<string>();
+  const blocks: RowBlock[] = [];
+  for (const row of rows) {
+    const id = row.session.sessionId;
+    if (id !== null && (counts.get(id) ?? 0) > 1) {
+      if (emitted.has(id)) continue;
+      emitted.add(id);
+      const members = rows
+        .filter((item) => item.session.sessionId === id)
+        .sort((a, b) => (b.at ?? 0) - (a.at ?? 0));
+      blocks.push({ kind: "group", session: row.session, rows: members });
+      continue;
+    }
+    const last = blocks.at(-1);
+    if (last !== undefined && last.kind === "rows") last.rows.push(row);
+    else blocks.push({ kind: "rows", rows: [row] });
+  }
+  return blocks;
+}
+
+/**
+ * 组标题一行：`会话 01a1b90f · 9 条 · 最近 19:35 · 1 条需要处理`。
+ * 「最近」用组内最新那条的时间；「需要处理」为 0 时写「无待办」—— 组默认展开，标题就是这一组的摘要。
+ */
+function groupSummary(block: { session: SessionRef; rows: ListRow[] }, now: number): string {
+  const latest = block.rows.reduce<number | null>((acc, row) => {
+    if (row.at === null) return acc;
+    return acc === null ? row.at : Math.max(acc, row.at);
+  }, null);
+  const parts = [`${block.rows.length} 条`];
+  if (latest !== null) parts.push(`最近 ${formatClock(latest, now)}`);
+  const todo = block.rows.filter((row) => row.needsAction).length;
+  parts.push(todo > 0 ? `${todo} 条需要处理` : "无待办");
+  const id = block.session.sessionId ?? "—";
+  const href = sessionHref(block.session);
+  const label =
+    href === null
+      ? escapeHtml(`会话 ${id.slice(0, 8)}`)
+      : `<a class="sess" href="${escapeHtml(href)}" title="${escapeHtml(id)}">${escapeHtml(`会话 ${id.slice(0, 8)}`)}</a>`;
+  return `${label} · ${parts.join(" · ")}`;
+}
+
+/**
+ * 列表正文：块与块之间留空，组默认展开（`open`），由 URL 里的 `open=none` 决定要不要收起来。
+ * 收起状态只能靠 URL 记住 —— 面板零 JS，`<details>` 自己的状态刷新就没了。
+ */
+export function renderRows(rows: readonly ListRow[], extras: ListExtras, now: number): string {
+  const blocks = groupRows(rows);
+  const open = extras.open === "none" ? "" : " open";
+  return blocks
+    .map((block) => {
+      if (block.kind === "rows") return table(block.rows, now, true);
+      return `<details class="grp"${open}>
+<summary>${groupSummary(block, now)}</summary>
+${table(block.rows, now, false)}
+</details>`;
+    })
+    .join("\n");
+}

package/extensions/skill-evolve/lib/web/render.ts

@@ -1,31 +1,42 @@
 /**
  * Web 面板的服务端渲染：纯字符串拼 HTML，不引模板库、不发任何外部请求、不依赖 JS。
  *
- * 这一版只负责**列表页**：控制条 → 横幅 → 导航 → 筛选 → 列表 → 分页 → 最近操作 → 页脚。
+ * 这一版只负责**列表页**：粘性头部（摘要 + tabs + 控制条）→ 横幅 → 筛选 → 表格 → 分页 → 最近操作 → 页脚。
  * 页面骨架（`<head>` / 状态栏 / 六个 tab / 页脚）在 ./shell.ts；
- * 列表行在 ./render-rows.ts，控制条/筛选/分页/最近操作在 ./render-controls.ts，
- * 技能管理页在 ./render-skills.ts，run 详情页在 ./render-run.ts ——
- * 拆开是因为合在一起必然破 300 行，而拆开之后每段都能单独看。
+ * 列表行与分组在 ./render-rows.ts，控制条/筛选/分页/刷新提示/最近操作在 ./render-controls.ts，
+ * 技能管理页在 ./render-skills.ts，run 详情页在 ./render-run.ts —— 拆开是因为合在一起必然破 300 行。
  *
  * 渲染层不读盘：`controls`（开关与最后活动）与 `audit`（最近操作）都由服务端读好传进来。
  * 拿不到开关状态时**不渲染控制条**，而不是猜一个「已开」——顶部写错状态比不写更糟。
  *
- * 展开交互交给 `<details>`：零 JS，刷新即最新，坏处只是不能记住展开状态 —— 面板不需要。
+ * 刷新策略（用户 2026-11-08 报「待处理一直帮我收起，点开过一会又被收起」）：
+ * 默认**不**自动刷新，只给「更新于 …· 刷新」；`&live=1` 才是用户显式要的 5 秒重载，
+ * 且那时页头会写清「展开态会重置」。整页重载必然丢 `<details>` 展开态，这代价只该由要求它的人承担。
  */
 import type { AuditEntry } from "./audit-log.ts";
 import type { WebControls } from "./activity.ts";
 import type { WebState, WebView } from "./data.ts";
+import { NO_FILTER, buildViewPage, parseView, type ListFilter, type ViewPage } from "./filter.ts";
+import { DEFAULT_EXTRAS, listHref, type ListExtras } from "./list-query.ts";
 import {
-  NO_FILTER,
-  buildViewPage,
-  isDefaultFilter,
-  pageHref,
-  parseView,
-  type ListFilter,
-  type ViewPage,
-} from "./filter.ts";
-import { appliedRows, approvalRows, doneRows, pendingRows, reportRows, type RowContext } from "./render-rows.ts";
-import { renderAudit, renderControlBar, renderFilterForm, renderPagination } from "./render-controls.ts";
+  appliedRows,
+  approvalRows,
+  doneRows,
+  pendingRows,
+  reportRows,
+  type ListRow,
+  type RowContext,
+} from "./render-rows.ts";
+import { groupRows, renderRows } from "./render-table.ts";
+import {
+  activityText,
+  renderAudit,
+  renderControlBar,
+  renderFilterForm,
+  renderLiveNote,
+  renderPagination,
+  renderUpdatedAt,
+} from "./render-controls.ts";
 import { VIEW_LABEL, shellPage } from "./shell.ts";
 import { escapeHtml } from "./text.ts";
 
@@ -33,13 +44,31 @@ import { escapeHtml } from "./text.ts";
 export { escapeHtml, formatStamp, shortRunId } from "./text.ts";
 export { parseView } from "./filter.ts";
 
-/** 每个列表页的空态文案：写清「为什么空」与「空在这里意味着什么」，不是一句「暂无数据」 */
-export const EMPTY: Record<WebView, string> = {
-  pending: "暂无待处理：所有复盘都已完成，也没有待人批的改动。",
-  approvals: "没有待批：auto 级不需要人批，approval 级的会出现在这里。",
-  applied: "还没有已采纳的提案：采纳过的会连 diff 一起留在这里。",
-  done: "暂无已处理记录：还没有回滚、失败或被否决的提案。",
-  reports: "暂无复盘报告：还没有 run 写过 01-findings.json。",
+/**
+ * 每个列表页的空态：一句话说「为什么空」+ 一句下一步。
+ * 只写「暂无数据」等于把「接下来该敲什么」留给人自己猜，而这里每个空态都对应一个具体动作。
+ */
+export const EMPTY: Record<WebView, { text: string; next: string }> = {
+  pending: {
+    text: "暂无待处理：所有复盘都已完成，也没有待人批的改动。",
+    next: "下一批提案来自真实会话：确认 <code>/skill-evolve telemetry on</code> 与 <code>/skill-evolve dispatch on</code>。",
+  },
+  approvals: {
+    text: "没有待批：auto 级不需要人批，approval 级的会出现在这里。",
+    next: "想让提案先来这儿：<code>/skill-evolve level approval</code>。",
+  },
+  applied: {
+    text: "还没有已采纳的提案：采纳过的会连 diff 一起留在这里。",
+    next: "先 <code>/skill-evolve dispatch on</code>，让真实会话自动出提案。",
+  },
+  done: {
+    text: "暂无已处理记录：还没有回滚、失败或被否决的提案。",
+    next: "只有走完终态的 run 才进这里；在跑的 run 看「待处理」。",
+  },
+  reports: {
+    text: "暂无复盘报告：还没有 run 写过 01-findings.json。",
+    next: "先 <code>/skill-evolve run</code> 手动跑一次复盘。",
+  },
 };
 
 /** 页脚按视图分：只有待审批页能点，其它页要把「去哪批」写清楚 */
@@ -51,31 +80,58 @@ function footer(view: WebView, canWrite: boolean): string {
     }
     return `点「批准」= 在 TUI 敲 <code>/skill-evolve approve &lt;runId&gt;</code>，走同一套五道闸；「拒绝」只改队列状态，不动任何技能文件。${api}`;
   }
-  return `只读面板：只绑 127.0.0.1、无鉴权、不能在这里点批准 ——
-采纳请回 TUI 跑 <code>/skill-evolve approve &lt;runId&gt;</code>，或去<a href="/?view=approvals">待审批页</a>直接批。${api}`;
+  return `本机面板 · 只绑 127.0.0.1 · 无鉴权 · 机器可读副本见 <a href="/api/state">/api/state</a>。`;
+}
+
+/** 五个视图各自的「条目 → 行」映射；字段差异都在各自函数里消化，渲染层只认 ListRow */
+function rowsOf(page: ViewPage, ctx: RowContext): ListRow[] {
+  switch (page.view) {
+    case "pending":
+      return pendingRows(page.rows, ctx);
+    case "approvals":
+      return approvalRows(page.rows, ctx);
+    case "applied":
+      return appliedRows(page.rows);
+    case "done":
+      return doneRows(page.rows);
+    default:
+      return reportRows(page.rows, ctx);
+  }
 }
 
 /**
- * 列表区：筛选表单 + 列表 + 分页。待审批页不给筛选也不分页 ——
+ * 分组开关：只在真的出现了组（同会话 ≥2 条）时给链接 —— 没有组的页面给「收起分组」等于给一个点了没反应的开关。
+ * 两个显式链接（`open=all` / `open=none`）优先于默认值，靠 URL 记住，不用 JS。
+ */
+function groupToggle(view: WebView, filter: ListFilter, extras: ListExtras, hasGroup: boolean): string {
+  if (!hasGroup) return "";
+  const collapsed = extras.open === "none";
+  const target = { ...extras, open: collapsed ? ("all" as const) : ("none" as const) };
+  const text = collapsed ? "展开全部分组" : "收起全部分组";
+  return `<p class="hint"><a href="${escapeHtml(listHref(view, filter, 1, target))}">${text}</a></p>\n`;
+}
+
+/**
+ * 列表区：筛选表单 + 表格（或空态）+ 分页。待审批页不给筛选也不分页 ——
  * 它必须在一屏里看全（每个都等着人点），筛掉一部分只会制造「怎么还有没批的」。
  */
-function listSection(view: WebView, page: ViewPage, filter: ListFilter, ctx: RowContext): string {
+function listSection(
+  view: WebView,
+  page: ViewPage,
+  filter: ListFilter,
+  extras: ListExtras,
+  ctx: RowContext,
+): string {
+  const rows = rowsOf(page, ctx);
   const body =
-    page.view === "pending"
-      ? pendingRows(page.rows, ctx)
-      : page.view === "approvals"
-        ? approvalRows(page.rows, ctx)
-        : page.view === "applied"
-          ? appliedRows(page.rows)
-          : page.view === "done"
-            ? doneRows(page.rows)
-            : reportRows(page.rows, ctx);
-  const list = body.length === 0 ? `<p class="empty">${EMPTY[view]}</p>` : `<ul>\n${body}\n</ul>`;
-  if (view === "approvals") return `<main>\n${list}\n</main>`;
+    rows.length === 0
+      ? `<p class="empty">${EMPTY[view].text}</p>\n<p class="next">${EMPTY[view].next}</p>`
+      : `${groupToggle(view, filter, extras, groupRows(rows).some((block) => block.kind === "group"))}${renderRows(rows, extras, ctx.now)}`;
+  if (view === "approvals") return `<main>\n${body}\n</main>`;
   return `<main>
-${renderFilterForm(view, filter)}
-${list}
-${renderPagination(view, page, filter)}
+${renderFilterForm(view, filter, extras)}
+${body}
+${renderPagination(view, page, filter, extras)}
 </main>`;
 }
 
@@ -92,6 +148,8 @@ export interface RenderOptions {
   audit?: readonly AuditEntry[] | null;
   /** 列表筛选；不传按默认（全部技能 / 全部状态 / 最近 7 天 / 第 1 页） */
   filter?: ListFilter;
+  /** 三个显式开关（自动刷新 / 分组展开）；不传就是默认（不刷新、展开） */
+  extras?: ListExtras;
   /** 现时（单测注入固定时钟） */
   now?: number;
 }
@@ -102,23 +160,24 @@ export function renderPage(state: WebState, view: WebView, options: RenderOption
   const now = options.now ?? Date.now();
   // 渲染层不自带筛选：不传就是「全部、第 1 页」；产品默认的 7 天由 HTTP 层（parseListQuery）给
   const filter = options.filter ?? NO_FILTER;
+  const extras = options.extras ?? DEFAULT_EXTRAS;
+  // `live` 只在待处理页有意义：别的页数据不会自己变，给了也忽略（与 parseListExtras 同一口径）
+  const live = extras.live && view === "pending";
   const page = buildViewPage(state, view, filter, now);
-  const ctx: RowContext = { csrf, writable, view };
-  // 只给「待处理」加 5 秒自刷新：等待时人会停留，看档案 / 历史时刷新只会把页面跳回去；
-  // 待审批页有按钮，刷新会打断正在点的动作，同样不加。
-  // 带筛选时刷新必须带上同样的筛选参数，否则挑完技能看着看着就被弹回全部 —— 没筛时保持最短 URL。
-  // 渲染层不传 filter（= 全量、第 1 页）与默认筛选（7d、第 1 页且没挑技能/状态）都用最短 URL
-  const plainRefresh = options.filter === undefined || isDefaultFilter(filter);
-  const refresh =
-    view === "pending"
-      ? `<meta http-equiv="refresh" content="5; url=${plainRefresh ? "?view=pending" : escapeHtml(pageHref(view, filter, page.page))}">\n`
-      : "";
+  const ctx: RowContext = { csrf, writable, view, now };
+  const here = listHref(view, filter, page.page, extras);
+  // 只有 `&live=1` 的待处理页才 5 秒重载：别的页数据不会自己变，重载只会丢展开态与滚动位置
+  const refresh = live ? `<meta http-equiv="refresh" content="5; url=${escapeHtml(here)}">\n` : "";
+  const liveNote = live
+    ? renderLiveNote(listHref(view, filter, page.page, { ...extras, live: false }))
+    : "";
   const notice = options.notice
-    ? `<p class="notice${options.notice.kind === "err" ? " err" : ""}">${escapeHtml(options.notice.text)}</p>\n`
+    ? `<p class="notice${options.notice.kind === "err" ? " err" : ""}">${escapeHtml(options.notice.text)}</p>`
     : "";
   const top = [
-    options.controls ? renderControlBar(options.controls, { view, now, csrf, canWrite: writable }) : "",
-    notice.trimEnd(),
+    options.controls ? renderControlBar(options.controls, { view, csrf, canWrite: writable }) : "",
+    liveNote,
+    notice,
   ]
     .filter((part) => part.length > 0)
     .map((part) => `${part}\n`)
@@ -129,8 +188,11 @@ export function renderPage(state: WebState, view: WebView, options: RenderOption
     title: VIEW_LABEL[view],
     active: view,
     head: refresh,
+    meta: options.controls
+      ? `${renderUpdatedAt(now, here)} · ${escapeHtml(activityText(options.controls.lastActivityAt, now))}`
+      : renderUpdatedAt(now, here),
     top,
-    body: listSection(view, page, filter, ctx),
+    body: listSection(view, page, filter, extras, ctx),
     foot: `${audit}${footer(view, writable)}`,
   });
 }

package/extensions/skill-evolve/lib/web/reports.ts

@@ -8,6 +8,7 @@ import { readVerify } from "../apply.ts";
 import type { RunSummary } from "../runs.ts";
 import { readRunError } from "../stale.ts";
 import { asNumber, asRecord, asText, readJson, reasonLabel } from "./json-read.ts";
+import { sessionFromRecord, type SessionRef } from "./run-session.ts";
 
 /** 单条报告里最多列几个技能：全量列会把 details 撑成第二份 findings */
 export const MAX_FINDING_ROWS = 5;
@@ -22,6 +23,8 @@ export interface RunReport {
   runId: string;
   status: string;
   trigger: string;
+  /** 这条 run 是哪个会话跑出来的：行上「会话」列要用（缺 = NO_SESSION） */
+  session: SessionRef;
   startedAt: number | null;
   findings: { total: number; rows: FindingRow[] };
   proposal: { type: string; skill: string; added: number; removed: number } | null;
@@ -84,10 +87,10 @@ function readVerifyGates(runDir: string): RunReport["verify"] {
   };
 }
 
-/** 触发者只在 run.json 里（listRuns 的摘要不带它）：单独读一次，坏记录当 unknown */
-function readTrigger(runDir: string): string {
+/** 触发者与会话只在 run.json 里（listRuns 的摘要不带 trigger）：一次读出两样，坏记录当 unknown / 空 */
+function readRunMeta(runDir: string): { trigger: string; session: SessionRef } {
   const raw = readJson<Record<string, unknown>>(path.join(runDir, "run.json"));
-  return asText(raw?.trigger, "unknown");
+  return { trigger: asText(raw?.trigger, "unknown"), session: sessionFromRecord(raw) };
 }
 
 /** runs/ 下的目录名（不看 run.json，坏掉的目录也要能被 reports 的真实判据「有没有 01-findings」筛） */
@@ -117,6 +120,7 @@ export function buildReports(evolutionDir: string, runs: readonly RunSummary[]):
   const summaries = new Map(runs.map((run) => [run.runId, run]));
   const reports: RunReport[] = [];
   for (const { runId, runDir } of runDirs(evolutionDir)) {
+    const meta = readRunMeta(runDir);
     const findings = readFindings(runDir);
     if (!findings) {
       // 失败也要有一行档案：每条 run 都能在报告里找到，不能因为没产出就从历史里消失
@@ -129,7 +133,8 @@ export function buildReports(evolutionDir: string, runs: readonly RunSummary[]):
       reports.push({
         runId,
         status: "stale",
-        trigger: readTrigger(runDir),
+        trigger: meta.trigger,
+        session: meta.session,
         startedAt: summary?.dispatchedAt ?? asNumber(raw?.dispatchedAt),
         findings: { total: 0, rows: [] },
         proposal: null,
@@ -147,7 +152,8 @@ export function buildReports(evolutionDir: string, runs: readonly RunSummary[]):
     reports.push({
       runId,
       status: summaries.get(runId)?.status ?? "unknown",
-      trigger: readTrigger(runDir),
+      trigger: meta.trigger,
+      session: meta.session,
       startedAt: summaries.get(runId)?.dispatchedAt ?? null,
       findings,
       proposal: proposal ? { type: proposal.type, skill: proposal.skill, added: proposal.added, removed: proposal.removed } : null,

package/extensions/skill-evolve/lib/web/run-detail.ts

@@ -53,6 +53,10 @@ export interface RunDetail {
   runId: string;
   status: string;
   trigger: string;
+  /** pi sessionId（这轮复盘是哪个会话跑出来的）；老 run.json 可能没有 = null */
+  sessionId: string | null;
+  /** 会话原文 .jsonl 的绝对路径；没有 = null */
+  sessionFile: string | null;
   /** 提案目标技能；没有提案时为空串 */
   skill: string;
   startedAt: number | null;
@@ -201,6 +205,8 @@ export function readRunDetail(evolutionDir: string, runId: string): RunDetail |
     runId,
     status: asText(record?.status, "（无 run.json）"),
     trigger: asText(record?.trigger, "—"),
+    sessionId: asText(record?.sessionId) || null,
+    sessionFile: asText(record?.sessionFile) || null,
     skill,
     startedAt: asNumber(record?.dispatchedAt),
     endedAt: stamps.length === 0 ? null : Math.max(...stamps),

package/extensions/skill-evolve/lib/web/run-session.ts

@@ -0,0 +1,62 @@
+/**
+ * run ↔ 会话的对应关系：面板每一行都要能回答「这条复盘是哪个会话跑出来的」。
+ *
+ * 为什么需要（用户 2026-11-08：「面板展示的也应该是 pi sessionId 否则我都不知道怎么看对应会话」）：
+ * 原来行上只有 `runId`（会话哈希8 + 时间戳），对着 TUI 里的 sessionId 完全对不上号，
+ * 想回去看那段对话只能自己到 `~/.pi/agent/sessions/` 里翻。
+ *
+ * 纪律与 data.ts 一致：只读、坏记录当空（`sessionId` 缺失就当 null，绝不因为缺字段让整页 500）。
+ * 本文件只管**数据**，链接与列渲染在 render-rows.ts（渲染层）。
+ */
+import * as path from "node:path";
+import type { RunSummary } from "../runs.ts";
+import { asText, readJson } from "./json-read.ts";
+
+export interface SessionRef {
+  /** pi 的 sessionId（UUID），缺失 = null */
+  sessionId: string | null;
+  /** 会话原文 .jsonl 的绝对路径（pi 写 run.json 时就带上了），缺失 = null */
+  sessionFile: string | null;
+}
+
+export const NO_SESSION: SessionRef = { sessionId: null, sessionFile: null };
+
+/** 从已解析的 run.json 里取会话信息（空白串当缺失：不能让它变成一个空链接） */
+export function sessionFromRecord(raw: unknown): SessionRef {
+  if (typeof raw !== "object" || raw === null) return NO_SESSION;
+  const record = raw as Record<string, unknown>;
+  const sessionId = asText(record.sessionId).trim();
+  const sessionFile = asText(record.sessionFile).trim();
+  return {
+    sessionId: sessionId.length > 0 ? sessionId : null,
+    sessionFile: sessionFile.length > 0 ? sessionFile : null,
+  };
+}
+
+/** 读一条 run 的会话信息；run.json 读不到 / 坏掉都返回 NO_SESSION */
+export function readRunSession(runDir: string): SessionRef {
+  return sessionFromRecord(readJson<Record<string, unknown>>(path.join(runDir, "run.json")));
+}
+
+/** RunSummary → 会话信息（列表页「会话」列的数据源） */
+export function sessionOfRun(run: Pick<RunSummary, "sessionId" | "sessionFile">): SessionRef {
+  return { sessionId: run.sessionId.length > 0 ? run.sessionId : null, sessionFile: run.sessionFile };
+}
+
+/** runId → 会话信息：队列条目没有会话字段，只能按 runId 回推到 runs 里查 */
+export function sessionIndex(runs: readonly Pick<RunSummary, "runId" | "sessionId" | "sessionFile">[]): Map<string, SessionRef> {
+  return new Map(runs.map((run) => [run.runId, sessionOfRun(run)]));
+}
+
+/** 队列条目 → 会话信息；索引里没有它就现读一次 run.json（读不到 = NO_SESSION，链接不渲染） */
+export function sessionForRun(runId: string, index: Map<string, SessionRef>, evolutionDir: string): SessionRef {
+  return index.get(runId) ?? readRunSession(path.join(evolutionDir, "runs", runId));
+}
+
+/** `?view=session` 页的链接：sessionId 必有，文件路径可缺（缺了由服务端反查） */
+export function sessionHref(session: SessionRef): string | null {
+  if (session.sessionId === null) return null;
+  const query = new URLSearchParams({ view: "session", sessionId: session.sessionId });
+  if (session.sessionFile !== null) query.set("file", session.sessionFile);
+  return `/?${query.toString()}`;
+}

package/extensions/skill-evolve/lib/web/server.ts

@@ -22,12 +22,15 @@ import { collectControls } from "./activity.ts";
 import { readAudit } from "./audit-log.ts";
 import { collectWebState } from "./data.ts";
 import { parseListQuery, parsePanelView } from "./filter.ts";
+import { parseListExtras } from "./list-query.ts";
 import { HTML_TYPE, MAX_BODY_BYTES, TEXT_TYPE, sendText } from "./http.ts";
 import { clearWebPid, isAlive, readWebPid, writeWebPid } from "./panel-pid.ts";
 import { renderPage } from "./render.ts";
 import { renderRunPage } from "./render-run.ts";
+import { renderSessionPage } from "./render-session.ts";
 import { renderSkillPage, renderSkillsPage } from "./render-skills.ts";
 import { handleDiff, readRunDetail } from "./run-detail.ts";
+import { readSessionSource } from "./session-file.ts";
 import { parseDays, readSkillDetail, readSkills } from "./skills.ts";
 
 /** 默认端口：7788 是面板约定值（TUI 提示与文档里都写这个），改它得同时改文档 */
@@ -77,8 +80,9 @@ interface GetResult {
 /**
  * 读盘渲染：控制条、最近操作、筛选都在这里一次性读好传给渲染层（渲染层不碰磁盘）。
  *
- * 四类页面：`?view=run&runId=`（run 详情）/ `?view=skills`（技能管理）/ `?view=skill&name=`（技能详情）/ 五个列表页。
+ * 四类页面：`?view=run&runId=`（run 详情）/ `?view=session&sessionId=`（会话详情）/ `?view=skills`（技能管理）/ `?view=skill&name=`（技能详情）/ 五个列表页。
  * 详情页的 runId 不合法或目录不存在一律 404 —— 靠 resolveRunDir 的目录校验，不靠字符串过滤。
+ * 会话页不走 404：会话文件可能已不在本机，那种情况页面要说人话（见 render-session.ts）。
  */
 function renderGet(ctx: RouteContext, url: URL): GetResult {
   const err = url.searchParams.get("err");
@@ -88,6 +92,20 @@ function renderGet(ctx: RouteContext, url: URL): GetResult {
   const state = collectWebState({ evolutionDir: ctx.evolutionDir });
   const view = parsePanelView(url.searchParams.get("view"));
   const days = parseDays(url.searchParams.get("days"));
+  if (view === "session") {
+    const sessionId = url.searchParams.get("sessionId") ?? "";
+    const source = readSessionSource({
+      evolutionDir: ctx.evolutionDir,
+      sessionId,
+      ...(url.searchParams.get("file") !== null ? { file: url.searchParams.get("file") } : {}),
+    });
+    // `only=user` 在服务端过滤（面板零 JS）：列表只渲染用户消息与助手纯文本，工具调用压成一行
+    return {
+      status: 200,
+      body: renderSessionPage(source, { state, onlyUser: url.searchParams.get("only") === "user" }),
+      type: HTML_TYPE,
+    };
+  }
   if (view === "run") {
     const runId = url.searchParams.get("runId") ?? "";
     const detail = readRunDetail(ctx.evolutionDir, runId);
@@ -126,6 +144,8 @@ function renderGet(ctx: RouteContext, url: URL): GetResult {
       controls,
       audit: readAudit(ctx.evolutionDir, RECENT_ACTIONS),
       filter: parseListQuery(url.searchParams),
+      // 三个显式开关（自动刷新 / 分组展开 / 只看对话的前两个）：`live` 按页面白名单放行，仅待处理页生效
+      extras: parseListExtras(url.searchParams, view),
     }),
     type: HTML_TYPE,
   };