@foolsecret/pi-prompt 0.4.0

package/README.md

@@ -0,0 +1,121 @@
+# pi-prompt
+
+**Pi 的输出精简插件：少说废话，省真金白银。**
+
+一句话：把「每次回复都啰嗦一大段、输出 token 悄悄烧钱」的痛，换成「三条正交轴随手调，auto 档按你的真实价格自动选最省钱的那一档」。
+
+---
+
+## 为什么需要它
+
+输出 token 单价远高于输入（DeepSeek 输出 4~8 元/百万 vs 输入 miss 1 元/百万），
+而多数回复里的寒暄、复述、铺垫都可以不要。pi-prompt 用一段**字节稳定的追加
+提示**，让模型按你选的力度输出——不改变模型能力，只砍掉冗余表达。
+
+---
+
+## 开箱你能得到什么
+
+- **三条正交轴，随手调**
+  - `show`：输出风格力度（`normal` / `lite` / `full` / `ultra` / `auto`）
+  - `write`：代码写量（`minimal` / `normal` / `complete`）
+  - `do`：行为力度（`direct` / `normal` / `deep`）
+- **`auto` 档：按成本自动选**。用成本函数
+  `净收益 = µ × 缩减率 × 输出价 − 注入成本 × 输入价` 选最优档，
+  并随校准样本自动收敛；小任务倾向不注入，大任务才上强度。
+- **价格交给你自己管**。auto 与成本估算都读 pi-pricer 的共享价表
+  （`~/.pi/model-pricing.json`）——包括你自定义的峰谷、促销、节假日规则。
+  没装 pi-pricer 也能用（回退内置近似价，并会提示你装）。
+- **渐进式自进化校准**。只采自然样本，零额外花费；想要更快收敛可主动跑
+  `/prompt check --calibrate`（3 轮不注入的对照探针）。
+- **台账与自检**。`/prompt usage` 给你按天×模型聚合 + 会话明细的 token/金额表，
+  并标注节省估算；`/prompt check` 看台账完整性、校准状态与当前价格来源。
+- **恒定注入语义**。注入文案按档位编号、字节稳定，不破坏 prompt 前缀缓存命中。
+
+---
+
+## 快速开始（30 秒）
+
+```bash
+# 1. 安装
+pi extension add @foolsecret/pi-prompt
+
+# 2. （推荐）安装 pi-pricer 并维护你的真实价格
+pi extension add @foolsecret/pi-pricer
+/price                      # 打开价格面板，改成你实际付费的价
+
+# 3. 打开三轴设置抽屉
+/prompt config              # 会话三轴 + 默认三轴，改完即生效
+
+# 4. 看看花了多少、省了多少
+/prompt usage
+```
+
+---
+
+## 命令速查
+
+| 命令 | 干嘛的 |
+|---|---|
+| `/prompt` | 无参 = 全局开关（关停/恢复注入） |
+| `/prompt config` | 三轴设置抽屉（会话档 + 默认档，改完即持久化） |
+| `/prompt status` | 当前三轴状态 |
+| `/prompt usage` | token/金额台账（按天×模型 + 会话明细 + 节省估算） |
+| `/prompt check` | 自检：台账完整性 / 校准状态 / 价格来源；`--calibrate` 跑探针 |
+| `/prompt-review` | 调用 `prompt-review` 技能审计上一条回复的冗余 |
+
+状态栏恒常显示 `PROMPT <show> · <write> · <do>`，`show=auto` 显示本轮实际解析档。
+
+---
+
+## 配置
+
+配置文件 `~/.pi/pi-prompt.json`：
+
+```json
+{
+  "defaultShow": "auto",
+  "defaultWrite": "normal",
+  "defaultDo": "normal",
+  "peakUpgrade": true,
+  "maxTokensCap": null,
+  "autoSample": false
+}
+```
+
+环境变量（优先级高于配置）：`PI_PROMPT_SHOW` / `PI_PROMPT_WRITE` / `PI_PROMPT_DO` /
+`PI_PROMPT_PEAK` / `PI_PROMPT_MAX_TOKENS` / `PI_PROMPT_AUTO_SAMPLE`。
+
+历史数据兼容：旧档名 `off` 读取时自动归一为 `normal`，不影响既有台账。
+
+---
+
+## 价格来源
+
+pi-prompt 自己**不维护价表**。成本估算与 auto 选档都从 pi-pricer 取价：
+
+| 情况 | 行为 |
+|---|---|
+| 装了 pi-pricer | 用你在 `~/.pi/model-pricing.json` 配的真实价格与峰谷规则 |
+| 没装 | 回退内置近似价（会在首次 `/prompt usage` 提示你安装） |
+| 装了但解析失败 | 回退兜底价，并在 `/prompt check` 给出失败原因 |
+
+所以想让账目对得上、让 auto 判断准，推荐同时装
+[`@foolsecret/pi-pricer`](https://www.npmjs.com/package/@foolsecret/pi-pricer)。
+
+---
+
+## 扩展开发者接入
+
+```ts
+import { resolvePricing } from "@foolsecret/pi-pricer/pricing";
+```
+
+pi-prompt 自身是 `@foolsecret/pi-pricer` 的**可选 peer 依赖**：
+未安装时功能完整（回退内置兜底价），不会因缺依赖而加载失败。
+
+---
+
+## License
+
+AGPL-3.0-only。详见 [LICENSE](LICENSE)。

package/extensions/index.ts

@@ -0,0 +1,12 @@
+/**
+ * pi-prompt 扩展入口（薄入口）：主逻辑在 src/prompt-extension.ts。
+ * manifest 显式指向本文件；加载即装配 PromptExtension 到 pi 生命周期。
+ */
+
+import { PromptExtension } from "../src/prompt-extension.ts";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+/** pi 扩展工厂：实例化并挂载输出精简插件 */
+export default function (pi: ExtensionAPI): void {
+	new PromptExtension().mount(pi);
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@foolsecret/pi-prompt",
+	"version": "0.4.0",
+	"description": "为 Pi Agent 打造的输出精简提示插件 — 多档力度压缩输出 token 省钱 | A prompt-verbosity plugin for Pi Agent — tiered output compression to save tokens & cost",
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"prompt",
+		"verbosity",
+		"concise",
+		"token",
+		"savings"
+	],
+	"license": "AGPL-3.0-only",
+	"author": "Titor-Z",
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Titor-Z/pi-prompt.git"
+	},
+	"files": [
+		"src/",
+		"extensions/",
+		"prompts/",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"test": "node --test --test-force-exit test/*.test.mjs",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "npm run typecheck && npm test"
+	},
+	"pi": {
+		"extensions": [
+			"./extensions/index.ts"
+		]
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
+		"@foolsecret/pi-pricer": "^0.12.0"
+	},
+	"peerDependenciesMeta": {
+		"@foolsecret/pi-pricer": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"@types/node": "^22.20.2",
+		"jiti": "^2.4.2",
+		"typescript": "^7.0.2"
+	}
+}

package/prompts/prompt-review.skill.md

@@ -0,0 +1,28 @@
+---
+name: prompt-review
+description: Audit the assistant's previous reply for unnecessary verbosity and, when the latest reply is verbose, rewrite it once in a concise form. Use after turning on pi-prompt review mode or whenever the user asks to trim a reply.
+---
+
+# prompt-review
+
+审计上一条回复：找出明显冗余，并在必要时用精炼版重写一次。
+
+## 判定标准（符合任一再重写）
+
+- 头/尾有与问题无关的寒暄、铺垫或"下面我将…"式预告
+- 复述了用户已经给出的事实或上下文
+- 有重复的结论、冗余的过渡词、客套句（如"随时问我 / 希望对你有帮助"）
+- 散文解释长度超过代码本身（代码场景）
+
+## 重写规则
+
+- 只输出被审回复的核心结论：结论先行、列表优先、每句删到不可再删
+- 保留用户明确要求的信息、错误处理细节、路径/报错原文
+- 不新增信息、不改变建议、不改结论
+- 重写后追加一行审计结果：`[prompt-review] 原 N 行/约 M 词 → 新 N 行/约 M 词`（粗略估算即可）
+- 原回复已足够精炼时，只输出一行结果，不再重写
+
+## 边界
+
+- 永远不删除：错误处理、安全提示、用户点名要求的信息
+- 审计对象是"怎么说"，不是"写什么"——不要建议删功能/删代码

package/src/auto.ts

@@ -0,0 +1,146 @@
+/**
+ * auto 选档器（纯函数核心 + 类封装）。
+ *
+ * 数学内核（与用户讨论的函数关系，见 AGENTS.md 讨论记录）：
+ *   net(mode) = estMu × r(mode) × P_输出 − inj(mode) × P_输入(缓存状态)
+ * 净收益最高的档 = argmax；在"平局阈值"内选更保守的档（normal<lite<full<ultra），
+ * 阈值随台账样本量收缩 —— 数据多了自然收敛到纯数学最优（自进化）。
+ */
+
+import type { RuntimeShowMode } from "./modes.ts";
+import { INJECTION_TOKENS_BY_SHOW, type TaskBin } from "./stats.ts";
+import { beijingDate, isDeepSeekPeakHours } from "./time.ts";
+
+// isDeepSeekPeakHours / beijingDate 已下沉到 time.ts（供 stats 兜底价复用，
+// 避免 auto ↔ stats 循环依赖）；此处重导出以保持既有调用点与测试不变。
+export { beijingDate, isDeepSeekPeakHours };
+
+/** 选档所需全部数学输入（纯函数参数，方便单测） */
+export interface TierMathInput {
+	/** 该任务不注入时的预期输出 token（µ） */
+	estMu: number;
+	/** 输出单价（¥/百万 token） */
+	outputPrice: number;
+	/** 输入未命中单价（¥/百万 token） */
+	inputMissPrice: number;
+	/** 输入缓存命中单价（¥/百万 token） */
+	inputHitPrice: number;
+	/** 本回合前缀是否大概率已缓存 */
+	cached: boolean;
+	/** 各档缩减率先验或校准拟合值 */
+	reduction: (mode: RuntimeShowMode) => number;
+	/** 各档注入 token（成本项） */
+	injectionTokens: (mode: RuntimeShowMode) => number;
+	/** 同类样本量（平局阈值收缩依据） */
+	sampleCount: number;
+}
+
+/** 平局阈值的基准比例（相对最优净收益）：净收益差距小于该比例视为"差不多" */
+export const BASE_TIE_FRACTION: number = 0.05;
+
+/** 校准样本量 → 平局阈值收缩（数据多了逼近纯数学最优） */
+export function tieFraction(sampleCount: number): number {
+	if (sampleCount >= 800) return 0.005;
+	if (sampleCount >= 200) return 0.02;
+	return BASE_TIE_FRACTION;
+}
+
+/** 保守度排序：normal < lite < full < ultra（数值越小越保守） */
+const CONSERVATISM: readonly RuntimeShowMode[] = ["normal", "lite", "full", "ultra"];
+
+/**
+ * 核心选档（纯函数）：
+ *   1. 对 4 档算 net(mode)；
+ *   2. 取净收益最高的档；
+ *   3. 在 {最优 × (1 − 平局比例)} 范围内选最保守的一档。
+ * 注意平局阈值必须是相对比例（绝对 ¥ 在微元量级上会把一切判成平局）。
+ */
+export function chooseAuto(input: TierMathInput): RuntimeShowMode {
+	const priceIn = input.cached ? input.inputHitPrice : input.inputMissPrice;
+	const nets = new Map<RuntimeShowMode, number>();
+	let bestNet = Number.NEGATIVE_INFINITY;
+	for (const mode of CONSERVATISM) {
+		const net =
+			(input.estMu * input.reduction(mode) * input.outputPrice -
+				input.injectionTokens(mode) * priceIn) /
+			1_000_000;
+		nets.set(mode, net);
+		if (net > bestNet) bestNet = net;
+	}
+	const tie = Math.abs(bestNet) * tieFraction(input.sampleCount);
+	for (const mode of CONSERVATISM) {
+		// 升序遍历：第一个进入平局带的档 = 最保守的接近最优
+		if ((nets.get(mode) ?? Number.NEGATIVE_INFINITY) >= bestNet - tie) return mode;
+	}
+	return "normal";
+}
+
+/** 请求规模 → 预期输出 µ 的粗糙分桶（先验；可被校准的 normal 基线中位数覆盖） */
+export function estimateMuFromInput(inputTokens: number): number {
+	if (inputTokens <= 80) return 30;
+	if (inputTokens <= 400) return 120;
+	if (inputTokens <= 1500) return 350;
+	if (inputTokens <= 5000) return 800;
+	return 1500;
+}
+
+/** 请求规模 → 任务分桶（校准分组键） */
+export function taskBinForInput(inputTokens: number): TaskBin {
+	if (inputTokens <= 80) return "tiny";
+	if (inputTokens <= 400) return "short";
+	if (inputTokens <= 1500) return "mid";
+	if (inputTokens <= 5000) return "long";
+	return "xlong";
+}
+
+/** 价格表读取接口（各厂商单价来源，供注入测试） */
+export interface ProviderPricing {
+	output: number;
+	miss: number;
+	hit: number;
+	/** 命中峰谷（由价格源判定：pi-pricer 按用户 schedule，兜底按 DeepSeek 固定时段） */
+	isPeak?: boolean;
+}
+
+/**
+ * auto 档选择器类：把价格源/校准缩减率/样本量封装成一次选档调用。
+ * 依赖注入：价格、缩减率、样本量全部可替换，测试用假数据。
+ */
+export class AutoTierChooser {
+	constructor(
+		private readonly priceFor: (provider: string, model: string, ts: number) => ProviderPricing,
+		private readonly reductionFor: (provider: string, bin: TaskBin, mode: RuntimeShowMode) => number,
+		private readonly sampleCountFor: (provider: string, bin: TaskBin) => number,
+	) {}
+
+	/**
+	 * 给定厂商/模型/任务桶/µ 估计/缓存状态/时刻，选出注入档。
+	 * 峰谷不再由调用方按硬编码时段推算，而是取价格源返回的 isPeak —— 这样用户在
+	 * pi-pricer 配置里改了峰时段，auto 立即跟随（兜底价格源才退回 DeepSeek 固定时段）。
+	 * peakUpgrade=false 时忽略 isPeak（关闭高峰升档，保持基线定价）。
+	 */
+	choose(
+		provider: string,
+		model: string,
+		bin: TaskBin,
+		estMu: number,
+		cached: boolean,
+		ts: number,
+		peakUpgrade: boolean = true,
+	): RuntimeShowMode {
+		const prices = this.priceFor(provider, model, ts);
+		const sampleCount = this.sampleCountFor(provider, bin);
+		const peak = peakUpgrade && prices.isPeak === true;
+		const outputPrice = peak ? prices.output * 2 : prices.output;
+		return chooseAuto({
+			estMu,
+			outputPrice,
+			inputMissPrice: prices.miss,
+			inputHitPrice: prices.hit,
+			cached,
+			reduction: (mode) => this.reductionFor(provider, bin, mode),
+			injectionTokens: (mode) => INJECTION_TOKENS_BY_SHOW[mode],
+			sampleCount,
+		});
+	}
+}

package/src/calibration.ts

@@ -0,0 +1,205 @@
+/**
+ * 校准管理器（渐进式自进化）：用本地台账拟合各厂商×任务桶的
+ * show 轴缩减率 r(mode) 与 normal 基线 µ，写 ~/.pi/pi-prompt-calibration.json。
+ *
+ * 诚实口径：真实验证缩减率需要"同类任务不注入"的对照组（counterfactual）。
+ * 数据来源三路：
+ *   1. 自然样本 —— 用户手动跑 normal（不注入）的回合（对照组）与各档回合；
+ *   2. 用户主动校准 —— /prompt check --calibrate 才跑成对探针（eg. N 轮）；
+ *   3. 样本不足时不动系数（惰性更新），auto 继续用先验（REDUCTION_BY_SHOW）。
+ * 自进化 = "数据够才改"，不对用户偷偷产生 API 花费。
+ *
+ * v0.2.2：show 轴旧档名 off → normal；历史校准文件里的 off 键读取时按同语义
+ * 合并（对照组 = normal 基线），写盘一律用新键名。
+ */
+
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { normalizeRuntimeShow, type RuntimeShowMode } from "./modes.ts";
+import { getActiveResolver, type PricingResolver, type UsageRecord } from "./stats.ts";
+
+/** 校准文件路径（~/.pi/pi-prompt-calibration.json） */
+export const CALIBRATION_PATH: string = join(homedir(), ".pi", "pi-prompt-calibration.json");
+
+/** 触发拟合的最低样本量：对照组 ≥ 此数、目标档 ≥ 此数才写系数 */
+export const MIN_CONTROL_SAMPLES: number = 5;
+export const MIN_MODE_SAMPLES: number = 3;
+
+/** 单档拟合结果 */
+export interface ModeFit {
+	r: number;
+	n: number;
+}
+
+/** 单任务桶拟合：normal 基线 µ + 各档 r */
+export interface BinFit {
+	normal?: { n: number };
+	/** normal 基线 µ（对照组中位数），auto 的 µ 估计覆盖用 */
+	mu?: number;
+	lite?: ModeFit;
+	full?: ModeFit;
+	ultra?: ModeFit;
+	/** v0.2.2 前的旧文件名：off 基线样本数（读取兼容，写盘并入 normal） */
+	off?: { n: number };
+}
+
+/** 对照组样本数（normal 优先；兼容旧文件 off 键） */
+function controlCount(fit: BinFit | undefined): number {
+	return fit?.normal?.n ?? fit?.off?.n ?? 0;
+}
+
+/** 单厂商拟合 */
+export interface ProviderFit {
+	byBin: Record<string, BinFit>;
+}
+
+/** 校准文件结构 */
+export interface CalibrationFile {
+	version: 1;
+	updatedAt: number;
+	byProvider: Record<string, ProviderFit>;
+}
+
+/** 空校准文件（无数据时的默认态） */
+function emptyCalibration(): CalibrationFile {
+	return { version: 1, updatedAt: 0, byProvider: {} };
+}
+
+/** 奇数个取中位近似：升序排列取中值（n≥1 才调用） */
+function median(values: number[]): number {
+	const sorted = [...values].sort((a, b) => a - b);
+	return sorted[Math.floor(sorted.length / 2)];
+}
+
+/**
+ * 校准管理器类：读档 / 查询拟合值 / 用台账重拟合。
+ * 样本不足查询返回 null —— 调用方（auto）回落到先验。
+ */
+export class CalibrationManager {
+	constructor(private readonly filePath: string = CALIBRATION_PATH) {}
+
+	/** 惰性读档；不存在/损坏 → 空校准（无副作用写盘） */
+	load(): CalibrationFile {
+		try {
+			const raw = readFileSync(this.filePath, "utf8").replace(/^\uFEFF/, "");
+			const parsed = JSON.parse(raw) as Partial<CalibrationFile>;
+			if (parsed?.version !== 1 || typeof parsed.byProvider !== "object") return emptyCalibration();
+			return { version: 1, updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0, byProvider: parsed.byProvider };
+		} catch {
+			return emptyCalibration();
+		}
+	}
+
+	/** 冷读磁盘上的校准文件（每次调用都读盘，供 /prompt check 展示最新） */
+	refresh(): CalibrationFile {
+		return this.load();
+	}
+
+	/** 某厂商×桶的 normal 基线 µ（拟合存在才返回，否则 null） */
+	muFor(provider: string, bin: string): number | null {
+		const mu = this.load().byProvider[provider]?.byBin[bin]?.mu;
+		return typeof mu === "number" ? mu : null;
+	}
+
+	/** 某厂商×桶的缩减率拟合值（样本足才返回，否则 null → 用先验；normal 无 r 语义） */
+	reductionFor(provider: string, bin: string, mode: RuntimeShowMode): number | null {
+		const binFit = this.load().byProvider[provider]?.byBin[bin];
+		if (!binFit || mode === "normal") return null;
+		const fit = binFit[mode];
+		if (!fit || typeof fit.r !== "number" || fit.n < MIN_MODE_SAMPLES) return null;
+		return Math.min(Math.max(fit.r, 0), 0.95);
+	}
+
+	/** 某厂商×桶已收集的样本量（auto 平局阈值收缩依据；含兼容旧 off 键） */
+	sampleCountFor(provider: string, bin: string): number {
+		const binFit = this.load().byProvider[provider]?.byBin[bin];
+		if (!binFit) return 0;
+		const count = controlCount(binFit) + (binFit.lite?.n ?? 0) + (binFit.full?.n ?? 0) + (binFit.ultra?.n ?? 0);
+		return count;
+	}
+
+	/**
+	 * 用台账重拟合：按 (厂商, 桶, show) 分组，对照组 = show=normal 的输出中位数
+	 * （历史记录里的 off 已由台账读取归一为 normal），
+	 * r(mode) = 1 − median(mode)/median(normal)，截断到 [0, 0.95]。
+	 * 只有样本足够的桶才更新；有变化才写盘返回 changed=true。
+	 */
+	recalibrate(records: readonly UsageRecord[]): { changed: boolean; file: CalibrationFile } {
+		const file = this.load();
+		let changed = false;
+		const now = Date.now();
+
+		// 分组：provider → bin → mode → outputs[]（record.show 统一归一，防手工写 off）
+		const groups = new Map<string, Map<string, Map<RuntimeShowMode, number[]>>>();
+		for (const record of records) {
+			let byBin = groups.get(record.provider);
+			if (!byBin) {
+				byBin = new Map();
+				groups.set(record.provider, byBin);
+			}
+			let byMode = byBin.get(record.taskBin);
+			if (!byMode) {
+				byMode = new Map();
+				byBin.set(record.taskBin, byMode);
+			}
+			const mode = normalizeRuntimeShow(record.show) ?? "normal";
+			const outputs = byMode.get(mode) ?? [];
+			outputs.push(record.output);
+			byMode.set(mode, outputs);
+		}
+
+		for (const [provider, byBin] of groups) {
+			const providerFit = file.byProvider[provider] ?? { byBin: {} };
+			for (const [bin, byMode] of byBin) {
+				const controlOutputs = byMode.get("normal") ?? [];
+				if (controlOutputs.length < MIN_CONTROL_SAMPLES) continue;
+				const controlMedian = median(controlOutputs);
+				const binFit = providerFit.byBin[bin] ?? {};
+				const mu = typeof binFit.mu === "number" ? binFit.mu : controlMedian;
+				// 与旧值比对，有变化才标记（避免无意义落盘）；旧 off 键由 normal 取代
+				const updated = { ...binFit, normal: { n: controlOutputs.length }, mu, off: undefined } as BinFit;
+				for (const mode of ["lite", "full", "ultra"] as const) {
+					const outputs = byMode.get(mode) ?? [];
+					if (outputs.length < MIN_MODE_SAMPLES) continue;
+					const r = Math.min(Math.max(1 - median(outputs) / controlMedian, 0), 0.95);
+					updated[mode] = { r, n: outputs.length };
+				}
+				const before = JSON.stringify(providerFit.byBin[bin] ?? {});
+				providerFit.byBin[bin] = updated;
+				if (JSON.stringify(updated) !== before) changed = true;
+			}
+			file.byProvider[provider] = providerFit;
+		}
+
+		if (changed) {
+			file.updatedAt = now;
+			try {
+				mkdirSync(dirname(this.filePath), { recursive: true });
+				writeFileSync(this.filePath, JSON.stringify(file, null, 2), "utf8");
+			} catch {
+				// 写校准失败不阻断：本次拟合作废，下次再试
+				return { changed: false, file };
+			}
+		}
+		return { changed, file };
+	}
+}
+
+/**
+ * 厂商单价（calibration/auto 共用）。
+ *
+ * **价格来源**：默认走 stats.ts 的 activeResolver —— 装了 pi-pricer 就是用户
+ * 在 ~/.pi/model-pricing.json 里配置的权威价（含峰谷）；未装则退回内置近似价。
+ * 峰谷不再由调用方按硬编码时段推算，而是随价格一并返回（isPeak），
+ * 这样用户改峰时段即影响 auto 选档。
+ */
+export function pricingFor(
+	provider: string,
+	model: string,
+	ts: number,
+	resolver: PricingResolver = getActiveResolver(),
+): { output: number; miss: number; hit: number; isPeak: boolean } {
+	const price = resolver(model, provider, ts);
+	return { output: price.output, miss: price.inputMiss, hit: price.inputHit, isPeak: price.isPeak === true };
+}

package/src/command.ts

@@ -0,0 +1,54 @@
+/**
+ * /prompt 命令解析器（纯函数，方便单测）。
+ *
+ * 语法（v0.2.1 起，设置统一进 config 抽屉，不再提供 show/write/do/default 子命令）：
+ *   /prompt                   无参: 全局 master 开关（全轴 normal ↔ 默认）
+ *   /prompt config            打开三轴设置抽屉（复刻 /settings：会话档 + 默认档）
+ *   /prompt status            显示三轴现状与台账估算
+ *   /prompt usage             显示 token/金额台账（DeepSeek 风格表）
+ *   /prompt check [--calibrate] 健康自检；--calibrate 才跑成对探针并重拟合
+ *   其余输入一律判非法（提示用 /prompt config）。
+ *   review 不再作为档位，请用 /prompt-review 技能
+ */
+
+import { normalizeShowMode } from "./modes.ts";
+
+/** 三轴名（config 抽屉行 id 也按此约束） */
+export type AxisName = "show" | "write" | "do";
+
+/** 解析结果的判别联合 */
+export type PromptCommand =
+	| { type: "toggle" }
+	| { type: "config" }
+	| { type: "status" }
+	| { type: "usage" }
+	| { type: "check"; calibrate: boolean }
+	| { type: "invalid"; arg: string };
+
+/**
+ * 解析 /prompt 参数文本。
+ * 首个 token 决定分支；斜杠前缀（/full 之类）容忍掉。
+ */
+export function parsePromptCommand(args: string): PromptCommand {
+	const parts = String(args ?? "").trim().split(/\s+/).filter(Boolean);
+	const primary = (parts[0] ?? "").replace(/^\/+/, "").toLowerCase();
+
+	switch (primary) {
+		case "":
+			return { type: "toggle" };
+		case "config":
+			return { type: "config" };
+		case "status":
+			return { type: "status" };
+		case "usage":
+			return { type: "usage" };
+		case "check":
+			return { type: "check", calibrate: parts.includes("--calibrate") };
+		default:
+			// v0.1/v0.2 的裸档位（off/lite/full/ultra/auto）与 show|write|do 子命令
+			// 已被 config 抽屉取代：给出明确引导而非静默失败
+			return normalizeShowMode(primary) !== null
+				? { type: "invalid", arg: "请用 /prompt config 打开抽屉设置档位" }
+				: { type: "invalid", arg: parts[0] ?? "" };
+	}
+}