pi-firecode 0.8.1 → 1.0.0

package/README.md

@@ -1,40 +1,60 @@
 # FireCode
 
-FireCode 是一个模块化 Pi Package，提供终端状态与工具渲染、会话预设、`/fire-review` 对抗审查、`/fire-master` 进程内子代理委派和 `/fire-watch` 观察员。指挥官与观察员的新会话状态由配置决定，裸命令只翻转当前会话；各模块由功能开关独立注册，关闭任一模块不会改变其余模块。
+FireCode 是一个 Pi 扩展包：把会话状态嵌进输入框边框、把每轮过程折叠成一行摘要，并提供对抗审查、多子代理指挥与观察员。各功能独立开关，关掉任一个不影响其余。
 
-## 安装
-
-```bash
-pi install git:github.com/Suge8/firecode@v0.6.1
+```text
+─ ⣾⣿⣷ 处理中 1m3s · ⠹ 审查 第2轮 1/3 · 1 阻断 ──────────── 观察员 指挥官 ─
+ 输入区
+─ 优化插件状态栏和工具展示 ───────────── gpt-6-astra/medium Fast · 42.3%/200k ─
 ```
 
-也可在本地仓库中直接试用：
+## 安装
 
 ```bash
-pi -e .
+pi install npm:pi-firecode
 ```
 
-Pi Package 拥有与 Pi 相同的本机权限；安装前应审阅源码。
+需要 Pi 1.1.0 及以上，升级用 `pi update`。扩展拥有与 Pi 相同的本机权限，安装前请审阅源码。
 
 ## 配置
 
-运行配置不随包分发。将公开模板复制到 Pi Agent 目录后按需启用功能，再重启 Pi：
+配置不随包生效。把推荐模板复制到 Pi Agent 目录，再重启 Pi：
 
 ```bash
 agent_dir="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
 mkdir -p "$agent_dir/extensions/firecode"
-curl -fsSL https://raw.githubusercontent.com/Suge8/firecode/v0.6.1/config.example.jsonc \
-  -o "$agent_dir/extensions/firecode/config.jsonc"
+curl -fsSL https://unpkg.com/pi-firecode/config.example.jsonc -o "$agent_dir/extensions/firecode/config.jsonc"
 ```
 
-公开模板提供维护者当前的完整推荐配置：除 Bark 外功能全开，Master 与 Watcher 在新会话自动激活。Watcher 会在每个主会话回合后调用模型，OpenAI priority 会按供应商规则加价；复制前应确认列出的模型均已认证并接受额外费用。审查与观察员的模型必须显式写入运行配置，否则对应功能拒绝启动。缺少运行配置时，FireCode 会关闭可选功能并在会话启动时警告；配置模板本身不会被运行时读取。
+- 模板里的模型一律写成 `"provider/model/thinking"`，换成你已登录的模型。
+- 审查、指挥官、观察员会真实调用配置里的模型；某一节配错时该功能拒绝启动并提示，不会改用默认模型。
+- 会额外花钱的：观察员每回合调用一次模型（模板里默认不自动开启）；OpenAI 加速档按供应商规则加价。
+- 没有配置文件时，可选功能全部关闭，并在会话启动时提示。
+
+## 功能
+
+| 功能 | 入口 | 做什么 |
+| --- | --- | --- |
+| 输入框状态 | 自动 | 上边框显示进行状态、计时与审查进度，下边框显示会话标题、模型、思考档与上下文占用 |
+| 过程折叠 | 自动；点摘要或 `Ctrl+O` 展开 | 每次输入折成一轮：一行摘要（耗时、均速）、最近 3 条中间回复的首句、最终回复全文 |
+| 预设 | `/preset`、预设里配的快捷键 | 一键切换模型、思考档、工具集与附加指令 |
+| 对抗审查 | `/fire-review` | 多个模型并行审查改动；没过自动修复再审，连续失败请顾问模型裁决 |
+| 指挥官 | `/fire-master`（新会话默认开启） | 按角色表把工作派给子代理并行执行；输入框上方列出子代理，点一行看它的全过程并可直接补话 |
+| 观察员 | `/fire-watch` | 每回合结束后用便宜模型评估新增内容，跑偏或过度工程时插话 |
+| 用量 | `/quota`、`/tokens` | 查 Claude、Codex 订阅剩余额度；统计本地会话的 token 与成本 |
+| 会话名 | `/rename`、`Ctrl+R` | 改当前会话名 |
+| OpenAI 请求层 | `Ctrl+F` 切加速档 | 回答详略、加速档、可选的 OpenAI 原生上下文压缩 |
+| Claude 订阅适配 | 自动 | 请求带 Claude Code 归因；令牌换发导致的 401 自动重试一次 |
+
+在配置的 `features` 里写 `false` 即可关闭对应功能，比如 `"features": { "watcher": false }`。
 
 ## 开发
 
-需要 [Bun](https://bun.sh/) 和一个 pi-mono checkout。开发版 `pi` 在 `PATH` 中时，测试会自动定位它；否则设置 `PI_PACKAGES_DIR` 为 pi-mono 的 `packages/` 目录。
+需要 [Bun](https://bun.sh/) 和一份 pi-mono 源码：开发版 `pi` 在 `PATH` 中时测试会自动定位它，否则把 `PI_PACKAGES_DIR` 设为 pi-mono 的 `packages/` 目录。
 
 ```bash
-bun test
+bun test   # 测试
+pi -e .    # 在本地仓库直接试用
 ```
 
-模块边界、状态机约束和领域术语见 `AGENTS.md`、各模块的 `AGENTS.md` 与 `CONTEXT.md`。
+模块边界、状态机约束与术语见 `AGENTS.md`、各模块的 `AGENTS.md` 与 `WORDS.md`。

package/activity.ts

@@ -0,0 +1,92 @@
+/**
+ * 活动行：输入框上方子代理活动列表（master/activity-list.ts）的一行布局。
+ * 标记 名字  角色 · 当前动作 · 提醒 …… 耗时。宽度不够时的退让顺序：先缩名字列（整表一致，名字截短带 …）、
+ * 再丢角色（整表一致），最后截动作文字。卡住行的提醒比动作重要：先保提醒（放不下全写法换短写法），
+ * 动作截到看不出是哪条命令（不足 COMFORT_ACTION_WIDTH）就整段不显示，不留“操作 …”这种没信息的残片。
+ */
+import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { clip } from "./format.js";
+import { HEAT_COLORS, paint } from "./flame.js";
+
+/** 动作文字至少留这么宽才值得显示（一个字加省略号）。 */
+const MIN_ACTION_WIDTH = 4;
+/** 动作文字想要的最小宽度：保得住它才保名字全长与角色（约“操作 $ bun t…”）。 */
+const COMFORT_ACTION_WIDTH = 12;
+/** 名字列再窄就认不出是谁了。 */
+const MIN_NAME_WIDTH = 9;
+const SEP = " · ";
+
+export interface ActivityRow {
+	/** 已着色的单格标记：火苗、◈、‖、◌、✓、✗。 */
+	mark: string;
+	name: string;
+	role: string;
+	/** 当前动作；为空时只显示角色（如空闲行）。 */
+	action: string;
+	/** 当前动作的语气：审查金色，失败红色，被中断黄色。 */
+	tone?: "review" | "failed" | "warning";
+	/** 动作后追加的黄色提醒（卡住行的“无输出”）：比动作重要，宽度不够先换短写法，动作没信息就整段不显示。 */
+	note?: { full: string; short: string };
+	elapsed: string;
+	/** 已落定的行文字退为暗色，只有标记保留颜色。 */
+	settled?: boolean;
+}
+
+const pad = (text: string, width: number) => text + " ".repeat(Math.max(0, width - visibleWidth(text)));
+
+/** 缩进、标记、名字列与耗时之外留给“角色 · 动作 · 提醒”的宽度。 */
+function middleRoom(row: ActivityRow, width: number, nameWidth: number): number {
+	return width - (2 + 1 + 1 + nameWidth + 2 + visibleWidth(row.elapsed) + 1) - 1;
+}
+
+/** 一行至少要给动作和提醒留多少：动作想要的宽度加提醒的短写法。 */
+function wanted(row: ActivityRow): number {
+	return (row.action ? COMFORT_ACTION_WIDTH : 0) + (row.note ? visibleWidth(row.note.short) : 0);
+}
+
+/** 名字列按剩余空间分配：每行都给动作留够了还有余，名字就不截；不够才缩到下限。 */
+export function nameWidthFor(rows: readonly ActivityRow[], width: number): number {
+	const longest = Math.max(0, ...rows.map((row) => visibleWidth(row.name)));
+	const room = Math.min(...rows.map((row) => middleRoom(row, width, longest) - wanted(row)));
+	return room >= 0 ? longest : Math.min(longest, Math.max(MIN_NAME_WIDTH, longest + room));
+}
+
+/** 这一行在给定宽度下是否值得保留角色；列表据此整表决定，列才对得齐。 */
+export function roleFits(row: ActivityRow, width: number, nameWidth: number): boolean {
+	return middleRoom(row, width, nameWidth) - visibleWidth(row.role) - SEP.length - wanted(row) >= 0;
+}
+
+export function renderActivityRow(
+	row: ActivityRow,
+	width: number,
+	nameWidth: number,
+	theme: Theme,
+	showRole = roleFits(row, width, nameWidth),
+): string {
+	const color = (base: ThemeColor) => (row.settled ? "dim" : base);
+	const head = `  ${row.mark} ${theme.fg(color("text"), pad(clip(row.name, nameWidth), nameWidth))}`;
+	const room = middleRoom(row, width, nameWidth);
+	if (room < 0) return clip(head, width, "end", "");
+	const paintAction = (text: string) =>
+		row.tone === "review" ? paint(HEAT_COLORS.gold, text)
+			: row.tone === "failed" ? theme.fg("error", text)
+				: row.tone === "warning" ? theme.fg("warning", text)
+					: theme.fg(color("muted"), text);
+	const actionRoom = showRole ? room - visibleWidth(row.role) - SEP.length : room;
+	const action = row.note ? withNote(row, actionRoom, paintAction, theme) : (
+		row.action && actionRoom >= MIN_ACTION_WIDTH ? paintAction(clip(row.action, actionRoom)) : "");
+	const role = theme.fg(color("muted"), row.role);
+	const middle = showRole ? (action ? `${role}${theme.fg("dim", SEP)}${action}` : role) : action;
+	return `${head}  ${pad(middle, room + 1)}${theme.fg(color("muted"), row.elapsed)} `;
+}
+
+/** “动作 · 提醒”：提醒优先；剩下的位置装得下整条动作或至少能认出命令才带上动作。 */
+function withNote(row: ActivityRow, room: number, paintAction: (text: string) => string, theme: Theme): string {
+	const { full, short } = row.note!;
+	const note = visibleWidth(full) <= room ? full : clip(short, room);
+	const actionRoom = room - visibleWidth(note) - SEP.length;
+	const fits = visibleWidth(row.action) <= actionRoom || actionRoom >= COMFORT_ACTION_WIDTH;
+	if (!row.action || !fits) return theme.fg("warning", note);
+	return `${paintAction(clip(row.action, actionRoom))}${theme.fg("warning", `${SEP}${note}`)}`;
+}

package/busy.ts

@@ -0,0 +1,188 @@
+/**
+ * “会话进行中”的单一事实：指挥官回合在跑 || 有子代理在飞（定义见 master/outbox.ts）|| 主会话 /fire-review 进行中（review 的占用频道）。
+ * 指挥官回合结束不等于歇下：回合结束后仍有子代理在飞、审查在跑，会话照旧进行中。
+ * Master 是在飞子代理数的唯一发布者；轮记录器、上边框、本轮摘要与轮次时钟都经 watchBusy 读同一个事实并消费同一个歇下边沿。
+ * 本段进行中的起点也只在这里记：首次变忙那一刻起，中途的人类输入与结果唤醒都不重置，歇下边沿报告整段事实：时长、终态、均速。
+ * 频道名与 payload 只在本文件定义。
+ */
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { formatDuration } from "./format.js";
+import { OCCUPANCY_CHANNEL, type OccupancyPayload } from "./review/occupancy.js";
+
+/** 进程内事件总线：在飞子代理数变化时发布 `{ inFlight }`，激活/停用同步。 */
+export const WORKERS_CHANNEL = "firecode:workers";
+export interface WorkersPayload {
+	inFlight: number;
+	/** Master 停用遗弃在飞子代理：归零只结束本段，不是歇下。 */
+	teardown?: true;
+}
+
+/**
+ * herdr 通用“进行中”频道，与 herdr:blocked 同构：消费者按 active 的 true/false 做计数配对。
+ * Master 只在在飞数 0↔正数跃迁时发布，保证配对；指挥官自己的回合 herdr 已由 agent_start/settled 得知。
+ */
+export const HERDR_WORKING_CHANNEL = "herdr:working";
+export interface HerdrWorkingPayload {
+	active: boolean;
+	label?: string;
+}
+export const HERDR_WORKING_LABEL = "子代理进行中";
+
+export interface BusyView {
+	agentRunning: boolean;
+	inFlight: number;
+	/** 主会话 /fire-review 进行中（含修复与总结回合之间的等待）：算会话进行中，审查时长计入这一段。 */
+	review: boolean;
+	/** 会话进行中 = 指挥官回合在跑 || 有子代理在飞 || 主会话审查进行中。 */
+	busy: boolean;
+	/** 本段进行中的起点（Date.now）；当且仅当 busy 时存在。 */
+	since?: number;
+}
+export const IDLE: BusyView = { agentRunning: false, inFlight: 0, review: false, busy: false };
+
+/**
+ * 本段最后一个指挥官回合的终态：宿主的回合中断信号（ctx.signal.aborted）为真即“已中断”——工具执行中被 Esc 时
+ * 宿主给的终态是 error（“The operation was aborted.”），不能只看 stopReason；其余按最后一条助手消息的 stopReason。
+ */
+export type Outcome = "complete" | "aborted" | "error";
+export interface SettledRound {
+	elapsed: number;
+	outcome: Outcome;
+	/**
+	 * 均速（token/s）：指挥官各回合的输出 token 之和除以模型请求墙钟之和，等子代理与跑工具不算分母。
+	 * 任一请求失败、中断、未配对或压缩失败则整段不给，不出半截的数。
+	 */
+	tps?: number;
+}
+
+/** 终态字样；完成不写字。 */
+export const OUTCOME_TEXT: Record<Outcome, string> = { complete: "", aborted: "已中断", error: "请求失败" };
+const RATE_FORMAT = new Intl.NumberFormat("en-US", { maximumSignificantDigits: 3, useGrouping: false });
+
+/** 落定记录的展示片段（未着色）：耗时，有均速再跟一段。上边框与摘要行共用。 */
+export function roundTexts(round: SettledRound): string[] {
+	return [formatDuration(round.elapsed), ...(round.tps ? [`${RATE_FORMAT.format(round.tps)} tps`] : [])];
+}
+
+/** 本段的模型请求计时；requestMs 为 undefined 表示本段已无法给出均速。 */
+interface Requests {
+	startedAt?: number;
+	requestMs?: number;
+	outputTokens: number;
+}
+const FRESH: Requests = { requestMs: 0, outputTokens: 0 };
+/** 输出 token 少于这个数时均速没有意义（1 个 token 的快答算出来的 tps 只是噪声）。 */
+const MIN_RATE_TOKENS = 20;
+
+function settledRound(elapsed: number, outcome: Outcome, { startedAt, requestMs, outputTokens }: Requests): SettledRound {
+	const valid = outcome === "complete" && startedAt === undefined && requestMs && outputTokens >= MIN_RATE_TOKENS;
+	return { elapsed, outcome, ...(valid ? { tps: (outputTokens * 1_000) / requestMs } : {}) };
+}
+
+export interface BusyHandlers {
+	/** 任一来源变化后调用（含歇下那一次，先于 onSettled）。 */
+	onChange?(view: BusyView, ctx: ExtensionContext | undefined): void;
+	/** 会话歇下边沿：busy 由真变假时触发一次，带本段进行中的总时长与终态。两个来源——agent_settled 时在飞数为 0，或在飞数归零时指挥官已空闲。 */
+	onSettled?(ctx: ExtensionContext | undefined, round: SettledRound): void;
+}
+
+function outcomeOf(messages: readonly { role: string; stopReason?: string }[]): Outcome {
+	const stop = messages.findLast((message) => message.role === "assistant")?.stopReason;
+	return stop === "aborted" || stop === "error" ? stop : "complete";
+}
+
+const HUBS = Symbol.for("firecode.busy");
+
+/**
+ * 会话进行中的唯一判定与歇下边沿：上边框与轮次时钟都只订阅这里，不各自拼装。
+ * 每个 pi 只有一份状态机，首个订阅者安装宿主事件，之后只追加订阅；登记挂在 globalThis 上，
+ * 宿主按文件加载模块副本时同一个 pi 仍只命中一份。
+ * 指挥官回合以 agent_start → agent_settled（且 ctx.isIdle()）为界。在飞数归零与回合落定先后不定
+ * （闲时前门投递在宿主记录这条消息后才算送达，见 deliver.ts），歇下必须在两个来源都满足的那一刻触发。
+ * 拆会话（session_shutdown）与 Master 停用遗弃子代理只结束本段，不发歇下边沿。
+ */
+export function watchBusy(pi: ExtensionAPI, handlers: BusyHandlers): void {
+	const hubs = ((globalThis as Record<symbol, unknown>)[HUBS] ??= new WeakMap()) as WeakMap<ExtensionAPI, BusyHandlers[]>;
+	const subscribers = hubs.get(pi);
+	if (subscribers) {
+		subscribers.push(handlers);
+		return;
+	}
+	const list = [handlers];
+	hubs.set(pi, list);
+	installBusy(pi, list);
+}
+
+function installBusy(pi: ExtensionAPI, subscribers: readonly BusyHandlers[]): void {
+	let agentRunning = false;
+	let inFlight = 0;
+	let review = false;
+	/** 本段起点；有值即进行中。 */
+	let since: number | undefined;
+	let outcome: Outcome = "complete";
+	let requests = FRESH;
+	let ctx: ExtensionContext | undefined;
+	let closed = false;
+	const update = (teardown = false) => {
+		if (closed) return;
+		const now = Date.now();
+		const busy = agentRunning || inFlight > 0 || review;
+		if (busy && since === undefined) {
+			since = now;
+			requests = FRESH;
+		}
+		const started = since;
+		if (!busy) since = undefined;
+		const view: BusyView = { agentRunning, inFlight, review, busy, since };
+		for (const subscriber of subscribers) subscriber.onChange?.(view, ctx);
+		if (busy || started === undefined || teardown) return;
+		const round = settledRound(now - started, outcome, requests);
+		for (const subscriber of subscribers) subscriber.onSettled?.(ctx, round);
+	};
+	pi.on("session_shutdown", () => {
+		closed = true;
+	});
+	pi.on("agent_end", (event, context) => {
+		outcome = context.signal?.aborted ? "aborted" : outcomeOf(event.messages);
+	});
+	pi.on("before_provider_request", () => {
+		// 上一次请求没有等到助手 message_end 就又发起：起止无法配对。
+		requests = { ...requests, startedAt: Date.now(), requestMs: requests.startedAt === undefined ? requests.requestMs : undefined };
+	});
+	pi.on("message_end", ({ message }) => {
+		if (message.role !== "assistant") return;
+		const duration = requests.startedAt === undefined ? 0 : Date.now() - requests.startedAt;
+		const output = message.usage.output;
+		const valid = requests.requestMs !== undefined && duration > 0 && Number.isFinite(output) && output > 0
+			&& (message.stopReason === "stop" || message.stopReason === "toolUse");
+		requests = valid
+			? { requestMs: requests.requestMs! + duration, outputTokens: requests.outputTokens + output }
+			: { requestMs: undefined, outputTokens: requests.outputTokens };
+	});
+	// 压缩的模型调用没有助手 message_end，不把它的起点借给下一条回复；压缩失败则本段不给均速。
+	const clearRequest = () => { requests = { ...requests, startedAt: undefined }; };
+	pi.on("session_before_compact", clearRequest);
+	pi.on("session_compact", clearRequest);
+	pi.on("session_compact_failed", () => { requests = { requestMs: undefined, outputTokens: requests.outputTokens }; });
+	pi.on("agent_start", (_event, context) => {
+		ctx = context;
+		agentRunning = true;
+		update();
+	});
+	pi.on("agent_settled", (_event, context) => {
+		ctx = context;
+		// 宿主在 agent_settled 期间可能已有排队/延后的动作（isIdle 为 false），紧接着会再 agent_start：不算回合结束。
+		agentRunning = context.isIdle() !== true;
+		update();
+	});
+	// 主会话审查算会话进行中：审查与修复、总结回合同属这一段，审查时长计入轮记录。
+	pi.events.on(OCCUPANCY_CHANNEL, (data) => {
+		review = (data as OccupancyPayload).active;
+		update();
+	});
+	pi.events.on(WORKERS_CHANNEL, (data) => {
+		const payload = data as WorkersPayload;
+		inFlight = payload.inFlight;
+		update(payload.teardown === true);
+	});
+}

package/config.example.jsonc

@@ -1,6 +1,7 @@
 {
-	// 公开推荐配置：除 Bark 外功能全开。复制后重启 Pi。
-	// Watcher 默认在每个主会话回合后调用模型；OpenAI priority 会按供应商规则加价。
+	// 公开推荐配置：功能全开。复制后重启 Pi。
+	// Watcher 新会话不自动激活，需要时 /fire-watch 翻转当前会话。
+	// 凡是指定模型的位置都写同一个模型原子："provider/model/thinking"，思考档取最后一段。
 	"features": {
 		"header": true,
 		"statusbar": true,
@@ -10,8 +11,6 @@
 		"stats": true,
 		"claudeSub": true,
 		"openaiNative": true,
-		"workingFlame": true,
-		"bark": false,
 		"review": true,
 		"master": true,
 		"watcher": true
@@ -19,82 +18,74 @@
 
 	"keys": {
 		"rename": "ctrl+r",
-		"cyclePreset": "ctrl+shift+u",
 		"fast": "ctrl+f"
 	},
 
-	// nativeCompaction 使用 OpenAI 原生上下文压缩；priority 加钱换更快出字。
+	// nativeCompaction 使用 OpenAI 原生上下文压缩；priority 加钱换更快出字，默认关。
 	"openai": {
 		"nativeCompaction": true,
 		"providers": {
-			"openai-codex": { "textVerbosity": "low", "priority": true },
-			"xai": { "priority": true }
+			"openai-codex": { "textVerbosity": "low", "priority": false }
 		}
 	},
 
-	// 每个主会话回合后评估新增内容，会产生额外模型调用；需要开口时当场插话。
-	"watcher": {
-		"enabled": true,
-		"model": "openai-codex/gpt-5.6-sol",
-		"thinking": "low",
-		"context": "minimal"
-	},
-
-	// 新会话默认激活指挥官；每个模型原子必须是 provider/model/thinking。
+	// 新会话默认激活指挥官。
 	"master": {
 		"autoActivate": true,
 		"workerExcludeExtensions": [],
 		"roles": {
 			"调研员": {
-				"model": "openai-codex/gpt-5.6-luna/xhigh",
-				"use": "大规模并行调研，便宜，不承担实现"
+				"model": "anthropic/claude-haiku-5-5/low",
+				"use": "只读不改：联网搜索、查文档与版本、读日志、按线索定位代码与核对资料",
+				"fallback": ["openai-codex/gpt-6-luna/medium"]
 			},
 			"工程师": {
-				"model": "openai-codex/gpt-5.6-sol/medium",
-				"use": "常规实现与调试，速度快",
-				"fallback": ["anthropic/claude-opus-5/medium"]
-			},
-			"全栈": {
-				"model": "anthropic/claude-opus-5/medium",
-				"use": "前后端综合实现与调试",
-				"fallback": ["openai-codex/gpt-5.6-sol/medium"]
+				"model": "anthropic/claude-sonnet-5-5/high",
+				"use": "要改代码：实现、调试；需要深读代码找缺陷的审计也派它（只读）",
+				"fallback": ["openai-codex/gpt-6.1-sol/high"]
 			},
-			"架构师": {
-				"model": "anthropic/claude-fable-5/high",
-				"use": "高级架构顾问；费用高，启用前必须先征求用户确认"
+			"批量工": {
+				"model": "anthropic/claude-haiku-5-5/medium",
+				"use": "规格明确、靠测试或类型检查就能验收的批量改动：按模式迁移、改名、补样板；量大时按文件划界并行多派",
+				"fallback": ["openai-codex/gpt-6.1-sol/medium"]
 			},
 			"设计师": {
-				"model": "kimi-coding/k3-256k/high",
-				"use": "纯视觉设计；已有固定组件和设计方案时不适用"
+				"model": "anthropic/claude-opus-5-5/medium",
+				"use": "视觉、前端",
+				"fallback": ["openai-codex/gpt-6.1-sol/high"]
 			},
 			"哨兵": {
-				"model": "openai-codex/gpt-5.6-luna/low",
-				"use": "盯守 CI、部署与长测试等等待过程"
+				"model": "anthropic/claude-haiku-5-5/low",
+				"use": "CI、部署、长测试等待",
+				"fallback": ["anthropic/claude-sonnet-5-5/low"]
 			}
 		}
 	},
 
 	"presets": {
-		"fable": { "provider": "anthropic", "model": "claude-fable-5", "thinkingLevel": "high", "key": "alt+1" },
-		"opus5": { "provider": "anthropic", "model": "claude-opus-5", "thinkingLevel": "medium", "key": "alt+2" },
-		"sol": { "provider": "openai-codex", "model": "gpt-5.6-sol", "thinkingLevel": "medium", "key": "alt+3" },
-		"gemini": { "provider": "antigravity", "model": "gemini-3.7-flash", "thinkingLevel": "high", "key": "alt+4" },
-		"ds": { "provider": "deepseek", "model": "deepseek-v4-flash", "thinkingLevel": "high", "key": "alt+5" },
-		"k3-256": { "provider": "kimi-coding", "model": "k3-256k", "thinkingLevel": "high", "key": "alt+6" },
-		"xai": { "provider": "xai", "model": "grok-4.6", "thinkingLevel": "high", "key": "alt+7" }
+		"sonnet": { "model": "anthropic/claude-sonnet-5-5/high", "key": "alt+1" },
+		"opus": { "model": "anthropic/claude-opus-5-5/high", "key": "alt+2" },
+		"fable": { "model": "anthropic/claude-fable-5-1/medium", "key": "alt+3" },
+		"astra": { "model": "openai-codex/gpt-6-astra/medium", "key": "alt+4" },
+		"sol": { "model": "openai-codex/gpt-6.1-sol/medium", "key": "alt+5" },
+		"ds": { "model": "deepseek/deepseek-flash/high", "key": "alt+6" }
 	},
 
 	// 审查只在用户或指挥官发起时调用模型。
 	"review": {
-		"advisor": { "model": "anthropic/claude-fable-5", "thinking": "high" },
-		"reviewers": [
-			{ "model": "anthropic/claude-sonnet-5", "thinking": "medium" },
-			{ "model": "anthropic/claude-opus-5", "thinking": "medium" }
-		],
+		"advisor": "anthropic/claude-fable-5-1/high",
+		"reviewers": ["anthropic/claude-opus-5-5/low", "openai-codex/gpt-6.1-sol/low"],
 		"maxRounds": 5,
 		"advisorAfterFailures": 2,
-		"timeoutMinutes": 20,
+		"timeoutMinutes": 40,
 		"tools": ["read", "grep", "find", "ls", "bash"],
 		"language": "zh"
+	},
+
+	// 激活后每个主会话回合评估新增内容，会产生额外模型调用；需要开口时当场插话。
+	"watcher": {
+		"enabled": false,
+		"model": "openai-codex/gpt-6.1-sol/medium",
+		"context": "minimal"
 	}
 }