@foolsecret/pi-prompt 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 格式参考 Keep a Changelog；版本号遵循 semver，与 `package.json` 一致。
 变更类型：✨新增 / 🐛修复 / 🏗️重构 / 🧹清理 / 🎨样式 / 📄文档。
 
+## v0.4.9 (2026-09-13)
+
+**压缩指令可配置：引导摘要保留“工作状态”**
+
+- ✨ **新增 `compactInstructions`**（config + env `PI_PROMPT_COMPACT_INSTRUCTIONS`）：
+  传给 `ctx.compact({ customInstructions })`，引导 pi 的摘要保留
+  **当前任务 / 已完成到哪 / 下一步 / 阻塞**，避免压缩后丢失工作状态、
+  导致后续回合重新勘测与重复劳动。
+- 📄 **默认内置**（用户可覆盖）：
+  > 摘要时请额外保留：当前正在进行的任务、已完成到哪一步、下一步计划、未解决的阻塞。
+  > 不要只总结历史对话，要保留工作状态。
+
+  显式空串（配置或 env）= 不追加，回到 pi 原生行为。
+- ✨ **设置抽屉**：“上下文”组新增“压缩指令（保留工作状态）”行，
+  submenu 选预设档（内置默认 / 关闭）；自定义文案请改配置文件（长文本无自由输入）。
+- 📄 **勘误**：pi-prompt 本身**不生成**压缩提示词（那是 pi 宿主的），
+  只提供向 `compact()` 追加的**自定义指令**。三轴注入与此无关，一直正常工作。
+- 🧹 测试 93 → **96 全绿**（含“压缩确实带上 customInstructions”端到端）；`tsc` 0 错误。
+
 ## v0.4.8 (2026-09-13)
 
 **设置抽屉改为“草稿 + Ctrl+S” + 轴重命名 + Markdown 只读页 + 删除无参 toggle**

package/README.md

@@ -92,6 +92,7 @@ pi extension add @foolsecret/pi-pricer
   "autoCompactMaxTokens": 400000,
   "autoCompactPercent": 0.6,
   "autoCompactMinTurns": 50,
+  "compactInstructions": "摘要时请额外保留：当前正在进行的任务、已完成到哪一步、下一步计划、未解决的阻塞。不要只总结历史对话，要保留工作状态。",
   "toolOutput": {
     "enabled": false,
     "grep": 8192,
@@ -107,7 +108,7 @@ pi extension add @foolsecret/pi-pricer
 `PI_PROMPT_HYSTERESIS` / `PI_PROMPT_AUTO_COMPACT` / `PI_PROMPT_AUTO_COMPACT_MAX_TOKENS` /
 `PI_PROMPT_AUTO_COMPACT_PERCENT` / `PI_PROMPT_AUTO_COMPACT_MIN_TURNS` /
 `PI_PROMPT_TOOL_OUTPUT` / `PI_PROMPT_TOOL_CAP_GREP` / `PI_PROMPT_TOOL_CAP_READ` /
-`PI_PROMPT_TOOL_CAP_BASH` / `PI_PROMPT_TOOL_CAP_DEFAULT`。
+`PI_PROMPT_TOOL_CAP_BASH` / `PI_PROMPT_TOOL_CAP_DEFAULT` / `PI_PROMPT_COMPACT_INSTRUCTIONS`。
 
 以上配置项**均可在 `/prompt config` 抽屉里修改**（根层 4 分类钻取：
 提示词 / 工具 / 上下文 / 其他），无需手改 JSON。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foolsecret/pi-prompt",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "为 Pi Agent 打造的输出精简提示插件 — 多档力度压缩输出 token 省钱 | A prompt-verbosity plugin for Pi Agent — tiered output compression to save tokens & cost",
   "keywords": [
     "pi-package",

package/src/config.ts

@@ -65,6 +65,11 @@ export interface PromptConfigFile {
 	autoCompactPercent?: number;
 	/** 会话至少跑多少轮才允许自动压（缺省 50；短会话压不划算） */
 	autoCompactMinTurns?: number;
+	/**
+	 * 追加给 pi 压缩的指令（引导摘要保留“工作状态”）。
+	 * 空串 = 不追加（回到 pi 原生行为）。
+	 */
+	compactInstructions?: string;
 	/** 工具输出截断（默认关；对象形式开启并分层） */
 	toolOutput?: ToolOutputConfig;
 	perProvider?: Record<string, string | ProviderAxes>;
@@ -82,6 +87,14 @@ export interface ToolOutputConfig {
 	bash?: number;
 }
 
+/**
+ * 内置压缩指令（用户可用配置/env 覆盖，显式空串=不追加）。
+ * 为何需要：pi 的摘要器倾向“总结历史对话”，压缩后会丢失“当前在干什么”，
+ * 导致后续回合重新勘测、重复劳动。这条指令引导它保留工作状态。
+ */
+export const DEFAULT_COMPACT_INSTRUCTIONS =
+	"摘要时请额外保留：当前正在进行的任务、已完成到哪一步、下一步计划、未解决的阻塞。不要只总结历史对话，要保留工作状态。";
+
 /** env 布尔开关解析：值存在且非空/0/false/no 视为真；未设置返回 undefined */
 function envTruthy(env: NodeJS.ProcessEnv | undefined, name: string): boolean | undefined {
 	const value = env?.[name];
@@ -321,6 +334,19 @@ export class PromptConfigManager {
 		return typeof v === "number" && v >= 0 ? v : 50;
 	}
 
+	/**
+	 * 追加给 pi 压缩的指令（引导摘要保留“工作状态”）。
+	 * 优先级：env PI_PROMPT_COMPACT_INSTRUCTIONS > 配置 compactInstructions > 内置默认。
+	 * 显式空串（env/配置）= 不追加，回到 pi 原生行为。
+	 */
+	compactInstructions(): string {
+		const envRaw = this.env?.PI_PROMPT_COMPACT_INSTRUCTIONS;
+		if (envRaw !== undefined) return envRaw.trim();
+		const v = this.load().compactInstructions;
+		if (typeof v === "string") return v.trim();
+		return DEFAULT_COMPACT_INSTRUCTIONS;
+	}
+
 	/**
 	 * 工具输出截断是否开启（默认 **关**）。
 	 * 为何默认关：pi 自己已把工具输出截到 50KB（read/grep/bash/find）。

package/src/draft.ts

@@ -154,6 +154,17 @@ export class PromptDraft {
 		return true;
 	}
 
+	/**
+	 * 设置压缩指令（marker："default" = 回内置默认，"off" = 显式空串不追加）。
+	 * 存**标记结果**而非文案：用户自定义文案在配置文件里，UI 只切“用哪一档”。
+	 */
+	setCompactInstructionsMode(marker: string): boolean {
+		if (marker !== "default" && marker !== "off") return false;
+		this.config = { ...this.config, compactInstructions: marker === "off" ? "" : undefined };
+		this.mark("上下文");
+		return true;
+	}
+
 	// ── 提交 / 放弃 ──────────────────────────────────────────────────────
 
 	/**

package/src/prompt-extension.ts

@@ -196,6 +196,7 @@ export class PromptExtension {
 							default: dc.toolOutput?.default ?? 8192,
 						},
 						toolOutputEnabled: dc.toolOutput?.enabled === true,
+						compactInstructions: dc.compactInstructions === undefined ? this.config.compactInstructions() : dc.compactInstructions,
 					};
 				}
 				return {
@@ -228,6 +229,7 @@ export class PromptExtension {
 						default: this.config.toolOutputCap("default"),
 					},
 					toolOutputEnabled: this.config.isToolOutputCap(),
+					compactInstructions: this.config.compactInstructions(),
 				};
 			},
 			{
@@ -237,6 +239,7 @@ export class PromptExtension {
 				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,
+				onCompactInstructionsChange: (marker) => this.draft?.setCompactInstructionsMode(marker) ?? false,
 				onSave: () => this.draft?.save() ?? { ok: false, reason: "无草稿" },
 				onReset: () => {
 					this.draft?.reset(this.currentConfigSnapshot(), this.currentAxesSnapshot());
@@ -667,7 +670,10 @@ export class PromptExtension {
 		if (!decision.should) return;
 		this.lastCompactTurn = this.turnCount;
 		const before = usage.tokens ?? 0;
+		// 追加压缩指令（引导摘要保留工作状态）；空串则不传，回到 pi 原生行为
+		const instructions = this.config.compactInstructions();
 		ctx.compact({
+			...(instructions ? { customInstructions: instructions } : {}),
 			onComplete: () => {
 				this.compactCount += 1;
 				ctx.ui.notify(

package/src/ui.ts

@@ -41,6 +41,8 @@ export interface PromptConfigDrawerState {
 	toolCaps: { grep: number; read: number; bash: number; default: number };
 	/** 工具输出截断总开关 */
 	toolOutputEnabled: boolean;
+	/** 压缩追加指令（当前值；空串 = 不追加） */
+	compactInstructions: string;
 }
 
 /** 抽屉各行的值域（show 含 auto 元档位，放第一项便于循环命中"自动"） */
@@ -56,6 +58,8 @@ const DEFAULT_PREFIX = "default-";
 const FLAG_PREFIX = "flag-";
 const NUM_PREFIX = "num-";
 const CAP_PREFIX = "cap-";
+/** 压缩指令行的 id（值域为预设档的“标记”，非真实文案） */
+const INSTR_PREFIX = "compactInstructions";
 
 /** 分类 id（根层的 4 个钻取入口） */
 export const GROUP_IDS = ["prompt", "tool", "context", "other"] as const;
@@ -172,7 +176,7 @@ const GROUP_DESC: Record<GroupId, string> = {
 export const GROUP_MEMBERS: Record<GroupId, readonly string[]> = {
 	prompt: ["show", "write", "do", "default-show", "default-write", "default-do"],
 	tool: ["flag-peakUpgrade", "num-maxTokensCap", "flag-toolOutput", "cap-grep", "cap-read", "cap-bash", "cap-default"],
-	context: ["flag-autoCompact", "num-autoCompactMaxTokens", "num-autoCompactPercent", "num-autoCompactMinTurns", "num-hysteresis"],
+	context: ["flag-autoCompact", "num-autoCompactMaxTokens", "num-autoCompactPercent", "num-autoCompactMinTurns", "compactInstructions", "num-hysteresis"],
 	other: ["flag-autoSample", "num-autoSampleInterval", "num-autoSampleMaxPerDay", "flag-quietStartup", "flag-hideStatus"],
 };
 
@@ -263,6 +267,46 @@ function capItem(tool: "grep" | "read" | "bash" | "default", state: PromptConfig
 	};
 }
 
+/**
+ * 压缩指令行：用 submenu 选预设档（SettingItem 无自由文本输入）。
+ * 值域用**标记字符串**（"default"/"off"/"custom"）而非真实文案，
+ * 因为真实文案很长且用户可在配置文件里自定义；这里只负责“用哪一档”。
+ */
+function compactInstructionsItem(state: PromptConfigDrawerState, onPick: (marker: string) => void): SettingItem {
+	const current = state.compactInstructions === "" ? "off" : "default";
+	const choices: Array<{ marker: string; label: string }> = [
+		{ marker: "default", label: "内置默认（保留工作状态）" },
+		{ marker: "off", label: "关闭（回到 pi 原生摘要）" },
+	];
+	return {
+		id: INSTR_PREFIX,
+		label: "压缩指令（保留工作状态）",
+		currentValue: current === "off" ? "off" : "默认",
+		description:
+			"引导 pi 摘要时保留“当前任务/进度/下一步/阻塞”，避免压缩后丢失工作状态。自定义文案请改配置文件 compactInstructions。",
+		submenu: (_v, done) => {
+			const sub: SettingItem[] = choices.map((c) => ({
+				id: `${INSTR_PREFIX}#${c.marker}`,
+				label: c.label,
+				currentValue: c.marker === current ? "← 当前" : "",
+			}));
+			return new SettingsList(
+				sub,
+				Math.min(sub.length + 4, 12),
+				getSettingsListTheme(),
+				(id) => {
+					const marker = String(id).split("#")[1];
+					if (!marker) return;
+					onPick(marker);
+					done(marker);
+				},
+				() => done(undefined),
+				{ enableSearch: true },
+			);
+		},
+	};
+}
+
 /**
  * 根层 4 个分类项（每项 Enter 钻入子层）。
  * currentValue 为分类摘要（如 "show=auto"），便于不钻入也能看到关键状态。
@@ -291,10 +335,12 @@ export function buildGroupItems(
 	group: GroupId,
 	state: PromptConfigDrawerState,
 	onNumPick: (name: string, value: number) => void = () => {},
+	onInstrPick: (marker: string) => void = () => {},
 ): SettingItem[] {
 	return GROUP_MEMBERS[group].map((id) => {
 		if (id === "show" || id === "write" || id === "do") return axisItem(id, "", state);
 		if (id.startsWith(DEFAULT_PREFIX)) return axisItem(id.slice(DEFAULT_PREFIX.length) as AxisName, DEFAULT_PREFIX, state);
+		if (id === INSTR_PREFIX) return compactInstructionsItem(state, onInstrPick);
 		if (id.startsWith(FLAG_PREFIX)) return flagItem(id.slice(FLAG_PREFIX.length), state);
 		if (id.startsWith(NUM_PREFIX)) return numItem(id.slice(NUM_PREFIX.length), state, onNumPick);
 		if (id.startsWith(CAP_PREFIX)) return capItem(id.slice(CAP_PREFIX.length) as "grep" | "read" | "bash" | "default", state);
@@ -313,9 +359,11 @@ export type SettingTarget =
 	| { kind: "default-axis"; axis: AxisName }
 	| { kind: "flag"; name: string }
 	| { kind: "number"; name: string }
-	| { kind: "cap"; tool: "grep" | "read" | "bash" | "default" };
+	| { kind: "cap"; tool: "grep" | "read" | "bash" | "default" }
+	| { kind: "compact-instructions" };
 
 export function resolveSettingId(id: string): SettingTarget | null {
+	if (id === INSTR_PREFIX) return { kind: "compact-instructions" };
 	if (SESSION_IDS.includes(id as AxisName)) return { kind: "session-axis", axis: id as AxisName };
 	if (id.startsWith(DEFAULT_PREFIX)) {
 		const axis = id.slice(DEFAULT_PREFIX.length) as AxisName;
@@ -345,6 +393,8 @@ export interface PromptConfigDrawerCallbacks {
 	onSave: () => { ok: boolean; reason: string };
 	/** Ctrl+R：丢弃未保存改动 */
 	onReset: () => void;
+	/** 压缩指令预设档选择（marker："default" | "off"） */
+	onCompactInstructionsChange: (marker: string) => boolean;
 }
 
 /** 抽屉主题形参（与 pi-pricer 对齐） */
@@ -521,7 +571,12 @@ export class PromptConfigDrawer {
 			);
 		}
 		const group = this.activeGroup;
-		const items = buildGroupItems(group, this.readState());
+		const items = buildGroupItems(
+			group,
+			this.readState(),
+			(name, value) => this.callbacks.onNumberChange(name, value),
+			(marker) => this.callbacks.onCompactInstructionsChange(marker),
+		);
 		return new SettingsList(
 			items,
 			Math.min(items.length + 4, 16),
@@ -570,6 +625,9 @@ export class PromptConfigDrawer {
 				ok = this.callbacks.onCapChange(target.tool, n);
 				break;
 			}
+			case "compact-instructions":
+				ok = this.callbacks.onCompactInstructionsChange(value);
+				break;
 		}
 		if (!ok) return;
 		const rebuilt = this.buildLevel(ctx);