pi-skill-evolve 0.1.5 → 0.1.6

package/extensions/skill-evolve/lib/web/list-query.ts

@@ -0,0 +1,43 @@
+/**
+ * 列表页的三个**显式开关** query：`live`（自动刷新）、`open`（分组是否展开）、`only`（会话页只看对话）。
+ *
+ * 为什么与 filter.ts 分开：筛选决定「哪些条目出现」，这三个开关决定「同一批条目怎么呈现/何时重载」。
+ * 混进 `ListFilter` 会让 `paginate` / `buildViewPage` 每处都得带着两个不相干的字段。
+ *
+ * 为什么全走 URL 而不是 JS：面板零 JS。用户点过「收起分组」就该在这次刷新后仍然收着 ——
+ * 只有 URL 能记住这件事（服务端读它并显式回写链接），localStorage 之类都不在这个面板的可用手段里。
+ */
+import { pageHref, type ListFilter } from "./filter.ts";
+import type { WebView } from "./data.ts";
+
+export interface ListExtras {
+  /** 5 秒整页自动刷新：只在待处理页生效（其它页数据不会自己变，重载只会丢展开态） */
+  live: boolean;
+  /** 分组默认展开；`none` 是用户点了「全部收起」 */
+  open: "all" | "none";
+  /** 会话页只看对话（user 消息 + 助手纯文本），工具调用压成一行 */
+  only: "user" | null;
+}
+
+export const DEFAULT_EXTRAS: ListExtras = { live: false, open: "all", only: null };
+
+/**
+ * 解析三个开关。**按页面白名单放行**：`live=1` 在已采纳页没有意义，
+ * 照单全收会让「?view=done&live=1」也被 5 秒重载一次，用户会以为面板抽风。
+ */
+export function parseListExtras(params: URLSearchParams, view: WebView | "session"): ListExtras {
+  return {
+    live: view === "pending" && params.get("live") === "1",
+    open: params.get("open") === "none" ? "none" : "all",
+    only: view === "session" && params.get("only") === "user" ? "user" : null,
+  };
+}
+
+/** 翻页 / 刷新 / 收起分组共用的链接拼装：筛选参数由 pageHref 负责，这里只追加三个开关 */
+export function listHref(view: WebView, filter: ListFilter, page: number, extras: ListExtras): string {
+  const base = pageHref(view, filter, page);
+  const params = new URLSearchParams(base.slice(base.indexOf("?") + 1));
+  if (extras.live) params.set("live", "1");
+  if (extras.open === "none") params.set("open", "none");
+  return `/?${params.toString()}`;
+}

package/extensions/skill-evolve/lib/web/markdown-lite.ts

@@ -0,0 +1,95 @@
+/**
+ * Markdown-lite：会话正文里那一小撮「模型天天写、原样输出却很难看」的语法。
+ *
+ * 为什么只做这几个（用户 2026-11-08：「Markdown 原样输出满屏 `**加粗**`」）：
+ * pi 的助手回复几乎每段都带 `**粗体**`、`` `路径` ``、`- ` 列表、``` 代码块、`[文字](url)`，
+ * 直接 `<pre>` 输出等于把符号也念给人听。但面板不需要完整 Markdown 实现
+ * （表格、脚注、嵌套列表一律不做），行数少、行为可预测比「支持得多」重要。
+ *
+ * **XSS 纪律**：先 `escapeHtml` 再替换语法，替换只插自己写的标签，用户文本永远进不了标签内部；
+ * `[文字](url)` 只保留文字、整段丢弃 URL —— 否则 `[x](javascript:alert(1))` 就是一个可点的洞。
+ */
+import { escapeHtml } from "./text.ts";
+
+/** 围栏代码块：开口行可带语言名（不渲染高亮，只要别把它当正文） */
+const FENCE = /```[^\n]*\n([\s\S]*?)```/g;
+
+/** 占位符用的控制字符：正文转义后不可能出现，所以不会被内容伪造 */
+const SLOT = "\u0000";
+
+/** 行内语法：先抠出代码块占位，再处理粗体 / 行内代码 / 链接（顺序不能反，否则代码块里的 `*` 会被当粗体） */
+function inline(escaped: string, blocks: string[]): string {
+  const withSlots = escaped.replace(FENCE, (_all, code: string) => {
+    blocks.push(`<pre class="code"><code>${code.replace(/\n$/, "")}</code></pre>`);
+    return `${SLOT}${blocks.length - 1}${SLOT}`;
+  });
+  return withSlots
+    .replace(/`([^`\n]+)`/g, "<code>$1</code>")
+    .replace(/\*\*([^*\n]+)\*\*/g, "<strong>$1</strong>")
+    .replace(/\[([^\]\n]+)\]\((?:[^()\s]|\([^()\s]*\))*\)/g, "$1");
+}
+
+/** 把段落里残留的代码块占位换回真区块（代码块夹在句子中间时不会独占一段） */
+function restore(text: string, blocks: string[]): string {
+  return text.replace(new RegExp(`${SLOT}(\\d+)${SLOT}`, "g"), (_all, index: string) => blocks[Number(index)] ?? "");
+}
+
+/**
+ * 文字与代码块混在一段：按占位符切开，文字段各自包 `<p>`。
+ * 不能直接把 `<pre>` 塞进 `<p>`（浏览器会把 `<p>` 提前闭合，后面的文字被踢出正文流）。
+ */
+function mixed(lines: string[], blocks: string[]): string {
+  const out: string[] = [];
+  let buffer: string[] = [];
+  const flush = (): void => {
+    const text = buffer.join("\n").trim();
+    if (text.length > 0) out.push(`<p>${text.replace(/\n/g, "<br>")}</p>`);
+    buffer = [];
+  };
+  for (const line of lines) {
+    line.split(new RegExp(`${SLOT}(\\d+)${SLOT}`)).forEach((part, index) => {
+      if (index % 2 === 1) {
+        flush();
+        out.push(blocks[Number(part)] ?? "");
+      } else if (part.length > 0) {
+        buffer.push(part);
+      }
+    });
+  }
+  flush();
+  return out.join("\n");
+}
+
+/** 一个段落：代码块占位 / 标题 / 列表 / 普通段落（普通段落里的换行保留成 `<br>`） */
+function block(text: string, blocks: string[]): string {
+  const slot = new RegExp(`^${SLOT}(\\d+)${SLOT}$`).exec(text);
+  if (slot !== null) return blocks[Number(slot[1])] ?? "";
+  const heading = /^(#{1,2}) (.*)$/.exec(text);
+  if (heading !== null) {
+    const level = heading[1] === "#" ? 3 : 4;
+    return `<h${level} class="md-h">${restore(heading[2], blocks)}</h${level}>`;
+  }
+  const lines = text.split("\n");
+  if (lines.every((line) => line.startsWith("- "))) {
+    return `<ul class="md-ul">${lines.map((line) => `<li>${restore(line.slice(2), blocks)}</li>`).join("")}</ul>`;
+  }
+  if (text.includes(SLOT)) return mixed(lines, blocks);
+  return `<p>${lines.join("<br>")}</p>`;
+}
+
+/**
+ * 正文 → HTML。空文本给空串（调用方据此判断「这条没有正文，别画空块」），
+ * 其余按空行分段，每段单独判定类型。
+ */
+export function renderMarkdownLite(raw: string): string {
+  if (raw.trim().length === 0) return "";
+  const blocks: string[] = [];
+  const text = inline(escapeHtml(raw), blocks);
+  return text
+    .split(/\n{2,}/)
+    .map((part) => part.replace(/^\n+|\n+$/g, ""))
+    .filter((part) => part.length > 0)
+    .map((part) => block(part, blocks))
+    .filter((part) => part.length > 0)
+    .join("\n");
+}

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

@@ -1,13 +1,15 @@
 /**
- * 页面骨架里的四块「管理性质」的东西：顶部控制条、列表筛选、分页、最近操作。
+ * 页面骨架里的四块「管理性质」的东西：顶部控制条、列表筛选、刷新提示、分页、最近操作。
  *
  * 都不依赖列表行，所以与 render-rows.ts 分开。
  *
- * 两条设计取舍：
+ * 三条设计取舍：
  * 1. **控制条只在服务端传了数据时才渲染**：渲染层不自己去读盘（否则 renderPage 会变成「读盘 + 渲染」两件事），
  *    也不在拿不到开关状态时猜一个出来 —— 顶部写「复盘：开」而实际是关的，比不写更糟；
  * 2. **筛选用 `<form method="get">` + hidden view**：零 JS，所以筛选结果能被拷成链接、
- *    能退回上一页、能在刷新后保持；翻页链接由 pageHref 带上全部筛选参数，不保留就等于点下一页即清空筛选。
+ *    能退回上一页、能在刷新后保持；翻页链接由 pageHref 带上全部筛选参数，不保留就等于点下一页即清空筛选；
+ * 3. **默认不自动刷新**：整页重载会丢掉 `<details>` 的展开态与滚动位置（用户 2026-11-08 报「点击展开过一会又被收起」），
+ *    所以默认只给一个「刷新」链接，`&live=1` 才是显式要求的 5 秒自动刷新。
  */
 import type { AuditEntry } from "./audit-log.ts";
 import type { ConfigFlag } from "../config.ts";
@@ -19,15 +21,14 @@ import {
   telemetryOffWhileEnabled,
 } from "../flags.ts";
 import type { WebView } from "./data.ts";
-import { RANGE_KEYS, RANGE_LABEL, STATUS_OPTIONS, pageHref, type ListFilter, type ViewPage } from "./filter.ts";
-import { escapeHtml, formatStamp } from "./text.ts";
+import { RANGE_KEYS, RANGE_LABEL, STATUS_OPTIONS, type ListFilter, type ViewPage } from "./filter.ts";
+import { listHref, type ListExtras } from "./list-query.ts";
+import { escapeHtml, formatStamp, formatTimeSeconds } from "./text.ts";
 import type { WebControls } from "./activity.ts";
 
 export interface ControlBarOptions {
   /** 动作用户在哪一页点的，就回哪一页：技能管理页也要能开关采集（曝光数据就是它采的） */
   view: WebView | "skills";
-  /** 现时（单测注入固定时钟）：决定「最后活动」写成几分钟前 */
-  now: number;
   csrf?: string;
   canWrite?: boolean;
 }
@@ -35,17 +36,17 @@ export interface ControlBarOptions {
 const MINUTE_MS = 60_000;
 
 /**
- * 「最后活动」的人话：只给粗粒度，不给秒 —— 精确到秒反而看不出差别，
+ * 「最后活动」的人话（摘要行尾部）：只给粗粒度，不给秒 —— 精确到秒反而看不出差别，
  * 而「几分钟前 / 几小时前 / 几天前」正好是「这个插件还在动吗」需要的精度。
  */
 export function activityText(at: number | null, now: number): string {
-  if (at === null) return "最后活动：还没有任何记录";
+  if (at === null) return "最后活动 还没有任何记录";
   const minutes = Math.floor(Math.max(0, now - at) / MINUTE_MS);
-  if (minutes < 1) return "最后活动：刚刚";
-  if (minutes < 60) return `最后活动：${minutes} 分钟前`;
+  if (minutes < 1) return "最后活动 刚刚";
+  if (minutes < 60) return `最后活动 ${minutes} 分钟前`;
   const hours = Math.floor(minutes / 60);
-  if (hours < 24) return `最后活动：${hours} 小时前`;
-  return `最后活动：${Math.floor(hours / 24)} 天前`;
+  if (hours < 24) return `最后活动 ${hours} 小时前`;
+  return `最后活动 ${Math.floor(hours / 24)} 天前`;
 }
 
 /** 控制条上的「立即复盘」按钮；只读面板不渲染任何表单 */
@@ -59,15 +60,16 @@ function runForm(ctx: ControlBarOptions): string {
 }
 
 /**
- * 一个独立开关：状态 + 后果说明 + 「点下去会发生什么」的按钮。
+ * 一个独立开关：一个 chip = 状态 + 「点下去会发生什么」的按钮，代价说明塞进 `title`。
  *
  * 四个开关各自 post 到 `/toggle?field=`（带上隐藏的 view，动作完回同一页），**不互相联动**：
  * 想采集但不花钱、想评审但不自动采纳，都是常见中间态；要批量切只有命令 `on|off`。
  * 按钮文案写动作不写状态 —— 状态已经在左边那一段里，按钮再写一遍会让人把「当前值」看成「点了会变的值」。
+ * 代价说明必须留着（「花 token」「改 .pi/skills/」是点之前就该知道的），只是不该占一整行把开关挤成两排。
  */
 function flagSwitch(field: ConfigFlag, on: boolean, ctx: ControlBarOptions): string {
   const state = `<span class="state ${on ? "on" : "off"}">${FLAG_LABEL[field]}：${on ? "开" : "关"}</span>`;
-  const effect = `<span class="hint">${FLAG_EFFECT[field]}</span>`;
+  const title = ` title="${escapeHtml(FLAG_EFFECT[field])}"`;
   const writable = ctx.canWrite === true && (ctx.csrf ?? "").length > 0;
   const form = writable
     ? `<form method="post" action="/toggle?field=${field}">
@@ -76,11 +78,11 @@ function flagSwitch(field: ConfigFlag, on: boolean, ctx: ControlBarOptions): str
 <button type="submit">${on ? "关闭" : "开启"}${FLAG_LABEL[field]}</button>
 </form>`
     : "";
-  return `<span class="sw">${state}${effect}${form}</span>`;
+  return `<span class="sw"${title}>${state}${form}</span>`;
 }
 
 /**
- * 顶部控制条：四个独立开关（采集 / 复盘 / 评审 / 采纳）+ 立即复盘 + 最后活动。
+ * 顶部控制条：四个独立开关（采集 / 复盘 / 评审 / 采纳）+ 立即复盘，挤在同一行。
  *
  * 四个开关不许合成一个「开启全部」：采集只写本地文件，复盘与评审才花 token，
  * 采纳直接改仓库文件 —— 想采集样本但不想花钱、想评审但不想自动落盘，都是常见的中间状态。
@@ -100,8 +102,7 @@ export function renderControlBar(controls: WebControls, ctx: ControlBarOptions):
   const switches = FLAG_FIELDS.map((field) => flagSwitch(field, controls[field], ctx)).join("\n");
   return `<div class="ctl">
 ${switches}
-${run}<span class="act">${escapeHtml(activityText(controls.lastActivityAt, ctx.now))}</span>
-</div>
+${run}</div>
 ${warn}${backlog}`;
 }
 
@@ -120,32 +121,57 @@ function rangeSelect(current: string): string {
   ).join("");
 }
 
-/** 筛选表单：hidden view 保证 GET 提交后还在同一页；「重置」链回不带筛选的本页 */
-export function renderFilterForm(view: WebView, filter: ListFilter): string {
+/**
+ * 筛选表单：hidden view 保证 GET 提交后还在同一页；「重置」链回不带筛选的本页。
+ * `open` / `live` 也一并带上：筛选不该顺手把「展开分组」「自动刷新」这两个开关清掉。
+ */
+export function renderFilterForm(view: WebView, filter: ListFilter, extras: ListExtras): string {
+  const keep = extraInputs(extras);
   return `<form class="filter" method="get">
 <input type="hidden" name="view" value="${view}">
-<label>技能 <input type="text" name="skill" value="${escapeHtml(filter.skill)}" placeholder="全部技能" size="16"></label>
+${keep}<label>技能 <input type="text" name="skill" value="${escapeHtml(filter.skill)}" placeholder="全部技能" size="16"></label>
 <label>状态 <select name="status">${statusSelect(filter.status)}</select></label>
 <label>时间 <select name="range">${rangeSelect(filter.range)}</select></label>
 <button type="submit">筛选</button>
-<a class="btn" href="/?view=${view}">重置</a>
+<a class="btn" href="${escapeHtml(listHref(view, filter, 1, extras))}">重置</a>
 </form>`;
 }
 
+/** 把非筛选的显式开关写成 hidden：表单提交只带这几个，不带的字段自然回落默认值 */
+function extraInputs(extras: ListExtras): string {
+  const parts: string[] = [];
+  if (extras.live) parts.push(`<input type="hidden" name="live" value="1">`);
+  if (extras.open === "none") parts.push(`<input type="hidden" name="open" value="none">`);
+  return parts.length === 0 ? "" : `${parts.join("")}\n`;
+}
+
+/**
+ * 「更新于 21:57:03 · 刷新」：默认的手动刷新入口。
+ * 时间精确到秒：这是「我看到的就是这一刻的数据」的凭证，只到分钟会让人反复点刷新。
+ */
+export function renderUpdatedAt(now: number, href: string): string {
+  return `更新于 ${formatTimeSeconds(now)} · <a href="${escapeHtml(href)}">刷新</a>`;
+}
+
+/**
+ * `&live=1` 时的头部提示：明说「展开态会重置」。
+ * 整页重载必然丢展开态与滚动位置，与其让人以为面板在帮他收起，不如提前讲清代价并给一个关掉的链接。
+ */
+export function renderLiveNote(offHref: string): string {
+  return `<p class="warn">自动刷新中（每 5 秒整页重载，展开态会重置）· <a href="${escapeHtml(offHref)}">关掉</a></p>`;
+}
+
 /**
- * 分页条：`第 X / Y 页，共 N 条` 永远显示（空列表也显示「第 1 / 1 页，共 0 条」——
+ * 分页条：`第 X / Y 页 · 共 N 条 · 上一页 / 下一页` 永远显示（空列表也显示「第 1 / 1 页 · 共 0 条」——
  * 页脚消失了人只会以为筛选坏了），只有到底时才把箭头换成灰字。
  */
-export function renderPagination(view: WebView, page: ViewPage, filter: ListFilter): string {
+export function renderPagination(view: WebView, page: ViewPage, filter: ListFilter, extras: ListExtras): string {
+  const href = (target: number) => escapeHtml(listHref(view, filter, target, extras));
   const prev =
-    page.page > 1
-      ? `<a href="${escapeHtml(pageHref(view, filter, page.page - 1))}">← 上一页</a>`
-      : `<span class="off">← 上一页</span>`;
+    page.page > 1 ? `<a href="${href(page.page - 1)}">← 上一页</a>` : `<span class="off">← 上一页</span>`;
   const next =
-    page.page < page.pages
-      ? `<a href="${escapeHtml(pageHref(view, filter, page.page + 1))}">下一页 →</a>`
-      : `<span class="off">下一页 →</span>`;
-  return `<p class="page">${prev} <span class="count">第 ${page.page} / ${page.pages} 页，共 ${page.total} 条</span> ${next}</p>`;
+    page.page < page.pages ? `<a href="${href(page.page + 1)}">下一页 →</a>` : `<span class="off">下一页 →</span>`;
+  return `<p class="page">${prev} <span class="count">第 ${page.page} / ${page.pages} 页 · 共 ${page.total} 条</span> ${next}</p>`;
 }
 
 /** 「最近操作」：时间 + 动作 + runId + 结果；结果里的 error 前缀单独染色，扫一眼就知道有没有出事 */