@foolsecret/pi-prompt 0.4.0 → 0.4.8

package/src/prompt-extension.ts

@@ -13,7 +13,7 @@
  */
 
 import { parsePromptCommand, type AxisName } from "./command.ts";
-import { PromptConfigManager } from "./config.ts";
+import { PromptConfigManager, type PromptConfigFile } from "./config.ts";
 import { CalibrationManager, pricingFor } from "./calibration.ts";
 import { AutoTierChooser, beijingDate, estimateMuFromInput, taskBinForInput } from "./auto.ts";
 import { clampMaxTokens } from "./request.ts";
@@ -29,9 +29,14 @@ import {
 	type ShowMode,
 	type WriteMode,
 } from "./modes.ts";
-import { PromptRegistry } from "./prompts.ts";
-import { REDUCTION_BY_SHOW, UsageLedger, estimateSaved, ensurePricingResolver, getPricingSource, summarizeUsage, showLabel } from "./stats.ts";
+import { PromptRegistry, prefixHash } from "./prompts.ts";
+import { REDUCTION_BY_SHOW, UsageLedger, USAGE_SCHEMA_VERSION, cacheHitRate, currentPluginVersion, estimateSaved, ensurePricingResolver, getPricingSource, summarizeUsage, showLabel } from "./stats.ts";
 import { formatTokens } from "./format.ts";
+import { compareInjection, renderCompare } from "./compare.ts";
+import { decideCompact } from "./context.ts";
+import { PromptDraft, type SessionAxes } from "./draft.ts";
+import { InfoPage, type DrawerTheme } from "./info-page.ts";
+import { truncateToolOutput } from "./tool-output.ts";
 import type {
 	ExtensionAPI,
 	ExtensionCommandContext,
@@ -94,8 +99,28 @@ export class PromptExtension {
 	private cacheState = false;
 	/** 价格来源提醒是否已发过（每会话一次，避免刷屏） */
 	private pricingHintShown = false;
+	/** 缓存友好提示是否已发过（每会话一次） */
+	private cacheHintShown = false;
 	/** 最近一次 before_agent_start 的实际解析结果（台账记录用） */
 	private lastResolved: { show: RuntimeShowMode; write: WriteMode; do: DoMode; taskBin: TaskBin; decision: string } | null = null;
+	/** 上一轮 auto 实际生效档（迟滞用；避免换档连带失效前缀缓存） */
+	private lastAutoShow: RuntimeShowMode | undefined = undefined;
+	/** 上一轮 prompt 总 token（换档缓存失效成本估算用） */
+	private prevPromptTokens = 0;
+	/** 本会话已跑轮数（自动压缩的“会话够长”判定） */
+	private turnCount = 0;
+	/** 上次自动压缩时的轮数（冷却用）；-1 = 从未 */
+	private lastCompactTurn = -1;
+	/** 本会话自动压缩次数（/prompt check 展示） */
+	private compactCount = 0;
+	/** 本会话工具输出截断省下的字节数 */
+	private toolTruncatedBytes = 0;
+	/** 本会话工具输出截断次数 */
+	private toolTruncatedCount = 0;
+	/** 抽屉打开期间的内存草稿（关闭即释放） */
+	private draft: PromptDraft | null = null;
+	/** 最近一次实际注入的完整文本（/prompt check 前缀哈希用） */
+	private lastInjectedText: string | undefined = undefined;
 	/** 剩余探针回合数（>0 时本轮不注入，采集对照组） */
 	private probeTurnsLeft = 0;
 	/** 探针采集完成后待重拟合标记 */
@@ -141,6 +166,38 @@ export class PromptExtension {
 		this.drawer = new PromptConfigDrawer(
 			() => {
 				const provider = this.lastCtx?.model?.provider;
+				// 有草稿时以草稿为准（否则看不到未保存的编辑）
+				const draft = this.draft;
+				if (draft) {
+					const { config: dc, axes: da } = draft.snapshot();
+					return {
+						session: { show: da.show, write: da.write, do: da.do },
+						defaults: { show: (dc.defaultShow ?? "auto") as never, write: (dc.defaultWrite ?? "normal") as never, do: (dc.defaultDo ?? "normal") as never },
+						flags: {
+							peakUpgrade: dc.peakUpgrade !== false,
+							quietStartup: dc.quietStartup === true,
+							hideStatus: dc.hideStatus === true,
+							autoSample: dc.autoSample === true,
+							autoCompact: dc.autoCompact === true,
+						},
+						numbers: {
+							maxTokensCap: dc.maxTokensCap ?? 0,
+							hysteresis: dc.hysteresis ?? 0.5,
+							autoCompactMaxTokens: dc.autoCompactMaxTokens ?? 400000,
+							autoCompactPercent: dc.autoCompactPercent ?? 0.6,
+							autoCompactMinTurns: dc.autoCompactMinTurns ?? 50,
+							autoSampleInterval: dc.autoSampleInterval ?? 50,
+							autoSampleMaxPerDay: dc.autoSampleMaxPerDay ?? 3,
+						},
+						toolCaps: {
+							grep: dc.toolOutput?.grep ?? dc.toolOutput?.default ?? 8192,
+							read: dc.toolOutput?.read ?? 16384,
+							bash: dc.toolOutput?.bash ?? dc.toolOutput?.default ?? 8192,
+							default: dc.toolOutput?.default ?? 8192,
+						},
+						toolOutputEnabled: dc.toolOutput?.enabled === true,
+					};
+				}
 				return {
 					session: {
 						show: this.effectiveShow(provider),
@@ -148,27 +205,81 @@ export class PromptExtension {
 						do: this.effectiveDo(provider),
 					},
 					defaults: this.config.getDefaults(),
+					flags: {
+						peakUpgrade: this.config.isPeakUpgrade(),
+						quietStartup: this.config.isQuietStartup(),
+						hideStatus: this.config.isHideStatus(),
+						autoSample: this.config.isAutoSample(),
+						autoCompact: this.config.isAutoCompact(),
+					},
+					numbers: {
+						maxTokensCap: this.config.maxTokensCap() ?? 0,
+						hysteresis: this.config.hysteresis(),
+						autoCompactMaxTokens: this.config.autoCompactMaxTokens(),
+						autoCompactPercent: this.config.autoCompactPercent(),
+						autoCompactMinTurns: this.config.autoCompactMinTurns(),
+						autoSampleInterval: this.config.autoSampleInterval(),
+						autoSampleMaxPerDay: this.config.autoSampleMaxPerDay(),
+					},
+					toolCaps: {
+						grep: this.config.toolOutputCap("grep"),
+						read: this.config.toolOutputCap("read"),
+						bash: this.config.toolOutputCap("bash"),
+						default: this.config.toolOutputCap("default"),
+					},
+					toolOutputEnabled: this.config.isToolOutputCap(),
 				};
 			},
 			{
-				onSessionAxisChange: (axis, value) => {
-					if (this.lastCtx) this.applyAxis(axis, value as ShowMode | WriteMode | DoMode, this.lastCtx);
-				},
-				onDefaultAxisChange: (axis, value) => {
-					const ok = this.config.writeDefaultAxis(axis, value);
-					if (this.lastCtx) {
-						this.lastCtx.ui.notify(ok ? `默认 ${axis}=${value} 已持久化` : `默认 ${axis}#${value} 写入失败`, ok ? "info" : "error");
-						this.syncStatus(this.lastCtx);
-					}
+				// 所有编辑只改草稿（Ctrl+S 才落盘）；返回 boolean = 是否变更成功
+				onSessionAxisChange: (axis, value) => this.draft?.setAxis(axis, value) ?? false,
+				onDefaultAxisChange: (axis, value) => this.draft?.setDefaultAxis(axis, value) ?? false,
+				onFlagChange: (name, value) => this.draft?.setFlag(name as Parameters<PromptDraft["setFlag"]>[0], value) ?? false,
+				onNumberChange: (name, value) => this.draft?.setNumber(name as Parameters<PromptDraft["setNumber"]>[0], value) ?? false,
+				onCapChange: (tool, value) => this.draft?.setToolCap(tool, value) ?? false,
+				onSave: () => this.draft?.save() ?? { ok: false, reason: "无草稿" },
+				onReset: () => {
+					this.draft?.reset(this.currentConfigSnapshot(), this.currentAxesSnapshot());
 				},
 			},
 			(context) => {
 				// 无 TUI（非交互模式）：回退为文字状态
 				this.showStatus(context as AnyContext);
 			},
+			{
+				isDirty: () => this.draft?.isDirty ?? false,
+				changedAreas: () => this.draft?.changedAreas ?? [],
+			},
 		);
 	}
 
+	/** 当前磁盘配置快照（草稿 reset 用） */
+	private currentConfigSnapshot(): PromptConfigFile {
+		return this.config.rawSnapshot();
+	}
+
+	/** 当前会话三轴快照（草稿 reset 用） */
+	private currentAxesSnapshot(): SessionAxes {
+		const d = this.config.getDefaults();
+		return {
+			show: (this.sessionAxes?.show ?? d.show) as SessionAxes["show"],
+			write: (this.sessionAxes?.write ?? d.write) as SessionAxes["write"],
+			do: (this.sessionAxes?.do ?? d.do) as SessionAxes["do"],
+		};
+	}
+
+	/** 打开抽屉前创建草稿（编辑隔离在内存，Ctrl+S 才落盘） */
+	private createDraft(): void {
+		this.draft = new PromptDraft(this.currentConfigSnapshot(), this.currentAxesSnapshot(), {
+			writeConfig: (patch) => this.config.persistMerged(patch),
+			writeSessionAxes: (axes) => {
+				this.sessionAxes = { show: axes.show, write: axes.write, do: axes.do };
+				this.pi?.appendEntry("prompt-axes", { show: axes.show, write: axes.write, do: axes.do });
+				if (this.lastCtx) this.syncStatus(this.lastCtx);
+			},
+		});
+	}
+
 	// ── 档位解析 ────────────────────────────────────────────────────────
 
 	/** show 轴生效档位（会话显式 > perProvider/env/默认；可为 auto） */
@@ -214,15 +325,6 @@ export class PromptExtension {
 		return legacyShow !== null ? { show: legacyShow } : null;
 	}
 
-	/** 当前三轴是否等价于"全局关闭"（show normal + 其余 normal） */
-	private isGloballyOff(provider: string | undefined): boolean {
-		return (
-			this.effectiveShow(provider) === "normal" &&
-			this.effectiveWrite(provider) === "normal" &&
-			this.effectiveDo(provider) === "normal"
-		);
-	}
-
 	// ── 运行时解析（auto → 具体档） ──────────────────────────────────────
 
 	/**
@@ -272,13 +374,26 @@ export class PromptExtension {
 		const peakUpgrade = this.config.isPeakUpgrade();
 		const now = Date.now();
 		const modelId = model ?? "unknown";
-		const chosen = this.chooser.choose(provider ?? "unknown", modelId, bin, estMu, this.cacheState, now, peakUpgrade);
+		const detailed = this.chooser.chooseDetailed(
+			provider ?? "unknown",
+			modelId,
+			bin,
+			estMu,
+			this.cacheState,
+			now,
+			peakUpgrade,
+			this.lastAutoShow,
+			this.config.hysteresis(),
+			this.prevPromptTokens,
+		);
+		const chosen = detailed.mode;
 		const isPeak = peakUpgrade && pricingFor(provider ?? "unknown", modelId, now).isPeak;
+		this.lastAutoShow = chosen;
 		return {
 			show: chosen,
 			write,
 			do: doMode,
-			decision: `auto: µ=${estMu},${this.cacheState ? "cached" : "cold"}${isPeak ? ",peak" : ""}→${chosen}`,
+			decision: `auto: µ=${estMu},${this.cacheState ? "cached" : "cold"}${isPeak ? ",peak" : ""}${detailed.held ? ",hold" : ""}→${chosen}`,
 		};
 	}
 
@@ -286,12 +401,14 @@ export class PromptExtension {
 
 	/**
 	 * 渲染状态栏文本（v0.2.2 footer 风格）：三轴全显、纯文字、去掉 ●/○ 与档位图标。
-	 * show=auto 时显示本轮实际解析档；尚无解析的首帧回退显示 auto。
-	 * 恒常显示（不做"全局关停即隐藏"）——用户拍板"一直显示"。
+	 * show=auto 时显示"auto→本轮实际档"（如 `auto→normal`）—— 只显示解析后的档会让
+	 * 用户误以为 auto 设置丢了（v0.4.2 修：footer 显示 normal 但设置是 auto 的困惑）。
+	 * 尚未解析的首帧显示裸 `auto`。恒常显示（不做"全局关停即隐藏"）。
 	 */
 	private statusText(provider: string | undefined): string {
 		const preferred = this.effectiveShow(provider);
-		const show = preferred === "auto" ? (this.lastResolved?.show ?? "auto") : preferred;
+		const resolved = this.lastResolved?.show;
+		const show = preferred === "auto" ? (resolved !== undefined ? `auto→${resolved}` : "auto") : preferred;
 		return `PROMPT ${show} · ${this.effectiveWrite(provider)} · ${this.effectiveDo(provider)}`;
 	}
 
@@ -330,33 +447,49 @@ export class PromptExtension {
 
 	// ── 展示 ─────────────────────────────────────────────────────────────
 
+	/**
+	 * 在 TUI 下用 InfoPage（Markdown + 滚动）展示长内容；无 TUI 回退纯文本 notify。
+	 * @param markdown Markdown 版（TUI 用）
+	 * @param plain 纯文本版（headless 用）
+	 */
+	private openInfoPage(ctx: AnyContext, markdown: string, plain: string, rootTitle: string): void {
+		const ui = (ctx as { ui?: { custom?: unknown; notify: (m: string, t?: string) => void } }).ui;
+		if (typeof ui?.custom !== "function") {
+			ui?.notify(plain, "info");
+			return;
+		}
+		void (ui.custom as (f: unknown) => Promise<unknown>)((tui: unknown, theme: DrawerTheme, _kb: unknown, done: (r?: undefined) => void) => {
+			void tui;
+			return new InfoPage(markdown, theme, () => done(undefined), [rootTitle]);
+		});
+	}
+
 	/** /prompt status：三轴现状/默认/厂商映射/台账估算 */
 	private showStatus(ctx: AnyContext): void {
 		const provider = ctx.model?.provider;
 		const showCfg = this.effectiveShow(provider);
-		const lines: string[] = ["pi-prompt 状态"];
-		lines.push(
-			`  show: ${showCfg === "auto" ? "🔄 AUTO" : showLabel(showCfg)}${this.sessionAxes?.show !== undefined ? "（会话显式）" : "（自动）"}${this.lastResolved ? ` ·本轮→${showLabel(this.lastResolved.show)}` : ""}`,
-		);
-		lines.push(`  write: ${String(this.effectiveWrite(provider))}${this.sessionAxes?.write !== undefined ? "（会话显式）" : "（自动）"}`);
-		lines.push(`  do: ${String(this.effectiveDo(provider))}${this.sessionAxes?.do !== undefined ? "（会话显式）" : "（自动）"}`);
+		const axisNote = (explicit: boolean) => (explicit ? "（会话显式）" : "（自动）");
+		const md: string[] = ["## pi-prompt 状态"];
+		md.push("## 当前档位");
+		md.push(`- **风格（show）**: \`${showCfg === "auto" ? "auto" : showLabel(showCfg)}\` ${axisNote(this.sessionAxes?.show !== undefined)}${this.lastResolved ? ` · 本轮 → \`${showLabel(this.lastResolved.show)}\`` : ""}`);
+		md.push(`- **代码（write）**: \`${String(this.effectiveWrite(provider))}\` ${axisNote(this.sessionAxes?.write !== undefined)}`);
+		md.push(`- **行动（do）**: \`${String(this.effectiveDo(provider))}\` ${axisNote(this.sessionAxes?.do !== undefined)}`);
 		const defaults = this.config.getDefaults();
-		lines.push(`  默认: show=${String(defaults.show)} / write=${String(defaults.write)} / do=${String(defaults.do)}`);
-		const perProvider = this.config.perProviderConfig();
-		const mapped = Object.entries(perProvider);
-		lines.push(
-			mapped.length === 0
-				? "  厂商映射: 无"
-				: `  厂商映射: ${mapped.map(([providerId, axes]) => `${providerId}→show:${axes.show ?? "-"} write:${axes.write ?? "-"} do:${axes.do ?? "-"}`).join(" | ")}`,
-		);
+		md.push("## 新会话默认");
+		md.push(`- 风格 \`${String(defaults.show)}\` · 代码 \`${String(defaults.write)}\` · 行动 \`${String(defaults.do)}\``);
+		const mapped = Object.entries(this.config.perProviderConfig());
+		md.push("## 厂商映射");
+		md.push(mapped.length === 0 ? "- 无" : mapped.map(([p, a]) => `- ${p} → 风格 ${a.show ?? "-"} · 代码 ${a.write ?? "-"} · 行动 ${a.do ?? "-"}`).join("\n"));
 		const records = this.ledger.readAll();
+		md.push("## 台账估算");
 		if (records.length > 0) {
 			const est = estimateSaved(records);
-			lines.push(`  台账估算: 输出 ${formatTokens(est.outputTokens)}，估省 ${formatTokens(est.savedOutputTokens)} ≈ ¥${est.savedCNY.toFixed(4)}（保守假设）`);
+			md.push(`- 输出 ${formatTokens(est.outputTokens)}，估省 ${formatTokens(est.savedOutputTokens)} ≈ ¥${est.savedCNY.toFixed(4)}（保守假设）`);
 		} else {
-			lines.push("  台账: 暂无记录");
+			md.push("- 暂无记录");
 		}
-		ctx.ui.notify(lines.join("\n"), "info");
+		const plain = md.join("\n");
+		this.openInfoPage(ctx, md.join("\n"), plain, "Esc 返回");
 	}
 
 	/** /prompt usage：DeepSeek 风格的 token/金额台账表 */
@@ -367,19 +500,38 @@ export class PromptExtension {
 			return;
 		}
 		const summary = summarizeUsage(records);
-		const lines: string[] = ["pi-prompt 台账（估算口径，权威计价在 pi-usager）"];
-		lines.push(`价格来源: ${this.describePricingSource()}`);
-		lines.push(`总览: ${summary.total.turns} 回合 · 输入 ${formatTokens(summary.total.input)} · 缓存命中 ${formatTokens(summary.total.cacheRead)} · 输出 ${formatTokens(summary.total.output)} · 估算 ¥${summary.total.costCNY.toFixed(4)}`);
+		const md: string[] = ["## pi-prompt 台账", "", `> 估算口径；权威计价在 pi-usager。价格来源: \`${this.describePricingSource()}\``, ""];
+		md.push("## 总览");
+		md.push(`- ${summary.total.turns} 回合 · 输入 ${formatTokens(summary.total.input)} · 缓存命中 ${formatTokens(summary.total.cacheRead)} · 输出 ${formatTokens(summary.total.output)}`);
+		md.push(`- 估算 ¥${summary.total.costCNY.toFixed(4)} · 缓存命中率 **${summary.total.hitRate.toFixed(1)}%**（累计；单轮会波动）`);
+		md.push("## 按天/模型");
 		for (const row of summary.rows) {
-			lines.push(`  ${row.day} ${row.model} — ${row.turns}回合 入${formatTokens(row.input)} 缓存${formatTokens(row.cacheRead)} 出${formatTokens(row.output)} ≈¥${row.costCNY.toFixed(4)} 估省¥${row.savedCNY.toFixed(4)}`);
+			md.push(`- \`${row.day}\` ${row.model} — ${row.turns} 回合 · 入 ${formatTokens(row.input)} · 缓存 ${formatTokens(row.cacheRead)} · 出 ${formatTokens(row.output)} · 命中 ${cacheHitRate(row.input, row.cacheRead).toFixed(0)}% · ≈¥${row.costCNY.toFixed(4)}（估省 ¥${row.savedCNY.toFixed(4)}）`);
 		}
 		if (summary.sessions.length > 0) {
-			lines.push("按会话:");
+			md.push("## 按会话（最近 8 个）");
 			for (const sess of summary.sessions.slice(-8)) {
-				lines.push(`  ${sess.session} — ${sess.turns}回合 入${formatTokens(sess.input)} 出${formatTokens(sess.output)} ≈¥${sess.costCNY.toFixed(4)} 估省¥${sess.savedCNY.toFixed(4)}`);
+				md.push(`- \`${sess.session}\` — ${sess.turns} 回合 · 入 ${formatTokens(sess.input)} · 出 ${formatTokens(sess.output)} · 命中 ${sess.hitRate.toFixed(0)}% · ≈¥${sess.costCNY.toFixed(4)}（估省 ¥${sess.savedCNY.toFixed(4)}）`);
 			}
 		}
-		ctx.ui.notify(lines.join("\n"), "info");
+		this.openInfoPage(ctx, md.join("\n"), md.join("\n"), "Esc 返回");
+	}
+
+	/**
+	 * 启动时提示"缓存友好状态"（每会话一次）：让用户知道当前配置是否会主动保前缀缓存。
+	 * 只报一次关键信息——auto 是否带迟滞、迟滞多大；不做说教。
+	 */
+	private notifyCacheFriendlyOnce(ctx: AnyContext): void {
+		if (this.cacheHintShown) return;
+		this.cacheHintShown = true;
+		const provider = ctx.model?.provider;
+		if (this.effectiveShow(provider) !== "auto") return; // 固定档位本就不换档，天然缓存友好
+		const hyst = this.config.hysteresis();
+		if (hyst <= 0) {
+			ctx.ui.notify("pi-prompt：换档迟滞已关闭，auto 可能频繁换档（会反复清前缀缓存）。设 hysteresis>0 可保护缓存。", "warning");
+			return;
+		}
+		ctx.ui.notify(`pi-prompt：auto 换档迟滞已启用（${hyst}），换档会先扣掉缓存失效成本——长会话下更省输入费。`, "info");
 	}
 
 	/**
@@ -430,16 +582,44 @@ export class PromptExtension {
 				if (binFit.mu !== undefined) fitted.push(`${provider}#${bin}(µ${binFit.mu}, ctl${binFit.normal?.n ?? binFit.off?.n ?? 0})`);
 			}
 		}
-		const lines: string[] = ["pi-prompt 自检"];
-		lines.push(`  台账: ${integrity.validLines}/${integrity.totalLines} 合法行${integrity.damagedLines > 0 ? `，损坏 ${integrity.damagedLines} 行（将跳过）` : ""} @ ${integrity.filePath}`);
-		lines.push(`  价格来源: ${this.describePricingSource()}`);
-		lines.push(`  校准: ${calFile.updatedAt === 0 ? "无拟合数据（auto 用先验）" : `已拟合 ${fitted.join(", ") || "(空)"}（更新于 ${new Date(calFile.updatedAt).toISOString().slice(0, 10)}）`}`);
-		lines.push("  --calibrate 将跑 3 轮对照组探针（本轮不注入地采集基线）并重拟合");
+		const md: string[] = ["## pi-prompt 自检", "", "## 台账与价格"];
+		md.push(`- 台账: ${integrity.validLines}/${integrity.totalLines} 合法行${integrity.damagedLines > 0 ? `，损坏 ${integrity.damagedLines} 行（将跳过）` : ""}`);
+		md.push(`- 路径: \`${integrity.filePath}\``);
+		md.push(`- 价格来源: \`${this.describePricingSource()}\``);
+		const records = this.ledger.readAll();
+		md.push("", "## 缓存与换档");
+		if (records.length > 0) {
+			const summary = summarizeUsage(records);
+			md.push(`- 缓存命中率: **${summary.total.hitRate.toFixed(1)}%**（累计 ${summary.total.turns} 回合 · 输入 ${formatTokens(summary.total.input)} / 命中 ${formatTokens(summary.total.cacheRead)}）`);
+		}
+		md.push(`- 注入前缀哈希: \`${prefixHash(this.lastInjectedText)}\`（变了 = 换档/改档，前缀缓存失效）`);
+		md.push(`- 换档迟滞: \`${this.config.hysteresis()}\`（0=关闭；越大越不易换档、越保住缓存）`);
+		const usage = ctx.getContextUsage?.();
+		md.push("", "## 上下文与压缩");
+		if (usage) {
+			const pct = usage.percent === null ? "?" : `${(usage.percent * 100).toFixed(1)}%`;
+			const tokensStr = usage.tokens === null ? "未知" : formatTokens(usage.tokens);
+			const autoT = Math.min(this.config.autoCompactMaxTokens(), this.config.autoCompactPercent() * usage.contextWindow);
+			md.push(`- 用量: ${tokensStr} / 窗口 ${formatTokens(usage.contextWindow)}（${pct}）· 本会话已压 ${this.compactCount} 次`);
+			md.push(`- 自动压缩: **${this.config.isAutoCompact() ? "开" : "关"}**（阈值 min(${formatTokens(this.config.autoCompactMaxTokens())}, ${(this.config.autoCompactPercent() * 100).toFixed(0)}% 窗口) = ${formatTokens(autoT)}；pi 自带阈值 ${formatTokens(usage.contextWindow - 16384)}）`);
+		}
+		md.push("", "## 工具输出");
+		if (this.config.isToolOutputCap()) {
+			const caps = (["grep", "read", "bash"] as const).map((k) => `${k}=${formatTokens(this.config.toolOutputCap(k))}`).join(" · ");
+			md.push(`- 截断: **开**（${caps} · 兜底 ${formatTokens(this.config.toolOutputCap("default"))}）`);
+			md.push(`- 本会话省: ${formatTokens(Math.round(this.toolTruncatedBytes / 4))} token（${this.toolTruncatedCount} 次）`);
+		} else {
+			md.push("- 截断: 关（pi 自带 50KB 上限仍生效）");
+		}
+		md.push("", "## 校准");
+		md.push(`- ${calFile.updatedAt === 0 ? "无拟合数据（auto 用先验）" : `已拟合 ${fitted.join(", ") || "(空)"}（更新于 ${new Date(calFile.updatedAt).toISOString().slice(0, 10)}）`}`);
+		md.push("- \`--calibrate\` 将跑 3 轮对照组探针并重拟合");
 		if (calibrate) {
-			lines.push("  已排队 3 轮探针…");
+			md.push("- 已排队 3 轮探针…");
 			this.queueProbes(ctx);
 		}
-		ctx.ui.notify(lines.join("\n"), "info");
+		this.openInfoPage(ctx, md.join("\n"), md.join("\n"), "Esc 返回");
+
 	}
 
 	/** 排队校准探针：剩余探针回合 + 依次发送固定题（仅 idle 才发，否则 followUp） */
@@ -462,11 +642,61 @@ export class PromptExtension {
 
 	// ── 台账 ─────────────────────────────────────────────────────────────
 
+	/**
+	 * 自动上下文压缩检查（turn_end 后）。默认关（config autoCompact）。
+	 * 理念（见 context.ts）：压缩是“投资”——DeepSeek 缓存读极便宜，
+	 * 短会话压缩纯亏；需三重条件（绝对阈值 + 会话够长 + 成本划算）。
+	 * 为何不用 pi 自带压缩：1M 窗口下 pi 阈值 ≈98 万，正常使用永不触发。
+	 */
+	private maybeAutoCompact(ctx: AnyContext): void {
+		if (!this.config.isAutoCompact()) return;
+		const usage = ctx.getContextUsage?.();
+		if (!usage) return;
+		const price = this.resolverForCompact();
+		const decision = decideCompact({
+			tokens: usage.tokens,
+			contextWindow: usage.contextWindow,
+			turns: this.turnCount,
+			inputMissPrice: price.miss,
+			inputHitPrice: price.hit,
+			maxTokens: this.config.autoCompactMaxTokens(),
+			percent: this.config.autoCompactPercent(),
+			minTurns: this.config.autoCompactMinTurns(),
+			turnsSinceLastCompact: this.lastCompactTurn < 0 ? Number.POSITIVE_INFINITY : this.turnCount - this.lastCompactTurn,
+		});
+		if (!decision.should) return;
+		this.lastCompactTurn = this.turnCount;
+		const before = usage.tokens ?? 0;
+		ctx.compact({
+			onComplete: () => {
+				this.compactCount += 1;
+				ctx.ui.notify(
+					`pi-prompt: 上下文达 ${formatTokens(before)} token，已自动压缩（预计省 ¥${decision.netSavingCNY.toFixed(4)}）`,
+					"info",
+				);
+			},
+			onError: (error: Error) => {
+				// 压缩失败不回滚计数（避免反复重试烧钱），仅提示
+				ctx.ui.notify(`pi-prompt: 自动压缩失败（${error.message}），下轮再试`, "warning");
+			},
+		});
+	}
+
+	/** 取当前价（供压缩成本判断；与 auto 同源） */
+	private resolverForCompact(): { miss: number; hit: number } {
+		const provider = this.lastCtx?.model?.provider ?? "unknown";
+		const model = this.lastCtx?.model?.id ?? "unknown";
+		const p = pricingFor(provider, model, Date.now());
+		return { miss: p.miss, hit: p.hit };
+	}
+
 	/** turn_end：采集用量追加台账；探针采集完触发重拟合 */
 	private recordUsage(raw: RawUsage | undefined, provider: string | undefined, model: string | undefined, ctx: AnyContext): void {
 		const resolved = this.lastResolved;
 		if (raw && resolved) {
 			this.ledger.append({
+				v: USAGE_SCHEMA_VERSION,
+				pv: currentPluginVersion(),
 				ts: Date.now(),
 				provider: provider ?? "unknown",
 				model: model ?? "unknown",
@@ -483,6 +713,8 @@ export class PromptExtension {
 			});
 			// 缓存状态滚动更新（auto 的成本项输入）
 			this.cacheState = (raw.cacheRead ?? 0) > 0;
+			// 上一轮 prompt 总量（换档失效成本估算：input + cacheRead + cacheWrite）
+			this.prevPromptTokens = (raw.input ?? 0) + (raw.cacheRead ?? 0) + (raw.cacheWrite ?? 0);
 		}
 		if (this.pendingRecalibrate) {
 			this.pendingRecalibrate = false;
@@ -509,23 +741,26 @@ export class PromptExtension {
 				{ value: "config", label: "config", description: "打开三轴设置抽屉（会话档 + 默认档）" },
 				{ value: "status", label: "status", description: "显示三轴现状与台账估算" },
 				{ value: "usage", label: "usage", description: "token/金额台账表" },
+				{ value: "compare", label: "compare", description: "对比注入 vs 不注入的成本（估算 + 实测）" },
 				{ value: "check", label: "check", description: "自检（--calibrate 触发探针校准）" },
 			],
 			handler: async (args, ctx) => {
 				this.lastCtx = ctx;
 				const cmd = parsePromptCommand(args);
 				switch (cmd.type) {
-					case "toggle": {
-						if (this.isGloballyOff(ctx.model?.provider)) {
-							this.resetToDefaults(ctx);
-							return;
-						}
-						// 全局关闭 = 三轴全部不注入（show normal + write/do normal）
-						this.applyAxis("show", "normal", ctx);
-						this.applyAxis("write", "normal", ctx);
-						this.applyAxis("do", "normal", ctx);
+					case "help":
+						ctx.ui.notify(
+							[
+								"pi-prompt 命令：",
+								"  /prompt config            打开设置抽屉（风格/代码/行动 · 工具 · 上下文 · 其他）",
+								"  /prompt status            查看当前档位与台账估算",
+								"  /prompt usage             查看 token/金额台账",
+								"  /prompt compare           对比注入 vs 不注入的成本",
+								"  /prompt check             健康自检（--calibrate 触发探针校准）",
+							].join("\n"),
+							"info",
+						);
 						return;
-					}
 					case "status":
 						this.showStatus(ctx);
 						return;
@@ -535,14 +770,26 @@ export class PromptExtension {
 						this.notifyPricingFallbackOnce(ctx);
 						this.showUsage(ctx);
 						return;
+					case "compare": {
+						await ensurePricingResolver();
+						this.notifyPricingFallbackOnce(ctx);
+						const result = compareInjection(this.ledger.readAll());
+						ctx.ui.notify(renderCompare(result), "info");
+						return;
+					}
 					case "check":
 						this.showCheck(ctx, cmd.calibrate);
 						return;
 					case "config":
-						await this.drawer.open(ctx);
+						this.createDraft();
+						try {
+							await this.drawer.open(ctx);
+						} finally {
+							this.draft = null;
+						}
 						return;
 					case "invalid":
-						ctx.ui.notify(`未知参数 "${cmd.arg}"\n用法: /prompt [config | status | usage | check [--calibrate]]（无参=全局开关）`, "warning");
+						ctx.ui.notify(`未知参数 "${cmd.arg}"\n用法: /prompt [help | config | status | usage | compare | check [--calibrate]]`, "warning");
 						return;
 				}
 			},
@@ -583,6 +830,7 @@ export class PromptExtension {
 			if (!this.config.isQuietStartup()) {
 				const show = this.effectiveShow(ctx.model?.provider);
 				ctx.ui.notify(`pi-prompt loaded: show=${show === "auto" ? "🔄 AUTO" : showLabel(show)}, write=${String(this.effectiveWrite(ctx.model?.provider))}, do=${String(this.effectiveDo(ctx.model?.provider))}`, "info");
+				this.notifyCacheFriendlyOnce(ctx);
 			}
 		});
 
@@ -609,15 +857,41 @@ export class PromptExtension {
 			// footer 状态同步为"本轮实际档"（show=auto 时）
 			this.syncStatus(ctx);
 			const text = this.registry.compose(resolved.show, resolved.write, resolved.do);
+			this.lastInjectedText = text;
 			if (!text) return;
 			const base = event?.systemPrompt ? `${event.systemPrompt}\n\n` : "";
 			return { systemPrompt: `${base}${text}` };
 		});
 
-		// turn_end：采集真实 token 用量 → 台账 + 探针后重拟合
+		// turn_end：采集真实 token 用量 → 台账 + 探针后重拟合 + 自动压缩检查
 		pi.on("turn_end", (event, ctx) => {
 			const raw = (event.message as { usage?: RawUsage }).usage;
+			this.turnCount += 1;
 			this.recordUsage(raw, ctx.model?.provider, ctx.model?.id, ctx);
+			this.maybeAutoCompact(ctx);
+		});
+		// tool_result：工具输出截断（创建时一次，此后字节不变 → 缓存友好）
+		pi.on("tool_result", (event) => {
+			if (!this.config.isToolOutputCap()) return undefined;
+			// 错误结果不截（错误信息必须完整）
+			if (event.isError) return undefined;
+			const tool = event.toolName;
+			const key = tool === "grep" || tool === "read" || tool === "bash" ? tool : "default";
+			const cap = this.config.toolOutputCap(key);
+			if (!cap) return undefined;
+			// 仅处理文本内容；图片/其他类型原样保留
+			let changed = false;
+			const content = (event.content ?? []).map((part) => {
+				if (part.type !== "text" || typeof part.text !== "string") return part;
+				const r = truncateToolOutput(part.text, tool, cap);
+				if (!r.truncated) return part;
+				changed = true;
+				this.toolTruncatedBytes += r.savedBytes;
+				this.toolTruncatedCount += 1;
+				return { ...part, text: r.text };
+			});
+			if (!changed) return undefined;
+			return { content };
 		});
 	}
 }