@aibyzero/byz 0.1.6 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+## 0.1.9 - 2026-08-30
+
+### Changed
+
+- Changed the default BYZ terminal footer to show the project name, git branch, remaining context percentage, token usage, cost, extension statuses, and current model.
+- Changed long-running BYZ waits to show a compact non-technical progress card by default, with the fuller work-site card available in details mode.
+- Added persistent BYZ detail-mode preferences through `/details remember` and `/details remember compact`.
+
+## 0.1.7 - 2026-08-29
+
+### Added
+
+- Added same-session routing and collaboration preferences that classify common requests, inject minimal per-turn guidance, and show route details only on demand.
+- Added the default BYZ conversation shell with a goal-first welcome, low-noise progress, on-demand details, and natural-language confirmation input.
+
+### Changed
+
+- Changed the default interactive shell to hide internal resources, tool rows, model metadata, and advanced controls until requested.
+
 ## 0.1.6 - 2026-08-28
 
 ### Added

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import { createConversationExtension } from "./conversation/conversation-extension.js";
 import { createFastSessionController, prepareFastRuntimeArgs, selectFastRuntimeArgs } from "./fast.js";
 import { createPrewalkExtension } from "./prewalk.js";
 import { main } from "./runtime/bundle/index.js";
@@ -25,16 +26,6 @@ try {
 	const fastRuntime = prepareFastRuntimeArgs(args);
 	const parsedWorkflow = parseWorkflowOption(fastRuntime.commandArgs);
 	const commandArgs = parsedWorkflow.forwardedArgs;
-	const isRootHelp = commandArgs.length === 1 && (commandArgs[0] === "--help" || commandArgs[0] === "-h");
-	if (isRootHelp) {
-		console.error("BYZ updates: byz update (npm-managed global installations only)");
-		console.error("BYZ Fast: --fast (thinking=low; optional model: BYZ_FAST_MODEL)");
-		console.error("BYZ Prewalk: /prewalk (one-time handoff after the first successful workspace edit/write)");
-		console.error("BYZ workflows: --workflow <cm|cm-plugin|none> (default: BYZ_WORKFLOW or cm)");
-		console.error(
-			"Commands: byz workflow list | byz workflow status [cm|cm-plugin|none] | byz workflow check <cm|cm-plugin>",
-		);
-	}
 
 	if (await handleWorkflowCommand(commandArgs, { workflowId: parsedWorkflow.workflowId })) {
 		// BYZ-owned command handled without starting the Pi runtime.
@@ -47,12 +38,6 @@ try {
 			stdoutIsTTY: process.stdout.isTTY,
 		});
 		const runtimeArgs = selectFastRuntimeArgs(fastRuntime, { isInteractive, loadWorkflow });
-		if (fastRuntime.enabled && loadWorkflow && isInteractive) {
-			console.error(
-				`BYZ Fast: model=${fastRuntime.model}, thinking=${fastRuntime.thinking}, workflow=${parsedWorkflow.workflowId}`,
-			);
-		}
-
 		if (loadWorkflow && isInteractive) {
 			const parsedRuntimeWorkflow = parseWorkflowOption(runtimeArgs);
 			const resolveResources = (workflowId) =>
@@ -68,7 +53,9 @@ try {
 				initialUseLowThinking: fastRuntime.useLowThinking,
 			});
 			const prewalkExtension = createPrewalkExtension({ fastController });
+			const conversationExtension = createConversationExtension();
 			const byzExtension = (pi) => {
+				conversationExtension(pi);
 				workflowExtension(pi);
 				fastController.extension(pi);
 				prewalkExtension(pi);

package/dist/conversation/conversation-extension.js

@@ -0,0 +1,402 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { createInteractionPolicy, formatDecision, parseConversationControl } from "./interaction-policy.js";
+import { createRoutingPolicy } from "./routing-policy.js";
+
+const WELCOME = "BYZ\n\n你想让我帮你做什么？";
+const DETAIL_MODE_COMPACT = "compact";
+const DETAIL_MODE_DETAILS = "details";
+
+function getByzAgentDir() {
+	return process.env.BYZ_CODING_AGENT_DIR || join(homedir(), ".byz", "agent");
+}
+
+function getConversationConfigPath() {
+	return join(getByzAgentDir(), "conversation.json");
+}
+
+function readConversationConfig() {
+	try {
+		return JSON.parse(readFileSync(getConversationConfigPath(), "utf8"));
+	} catch {
+		return {};
+	}
+}
+
+function getSavedDetailMode() {
+	const mode = readConversationConfig().detailMode;
+	return mode === DETAIL_MODE_DETAILS ? DETAIL_MODE_DETAILS : DETAIL_MODE_COMPACT;
+}
+
+function saveDetailMode(mode) {
+	const configPath = getConversationConfigPath();
+	mkdirSync(dirname(configPath), { recursive: true });
+	writeFileSync(configPath, `${JSON.stringify({ ...readConversationConfig(), detailMode: mode }, null, "\t")}\n`);
+}
+
+function formatTokens(count) {
+	if (count < 1000) return String(count);
+	if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
+	if (count < 1000000) return `${Math.round(count / 1000)}k`;
+	if (count < 10000000) return `${(count / 1000000).toFixed(1)}M`;
+	return `${Math.round(count / 1000000)}M`;
+}
+
+function truncateText(text, width) {
+	if (width <= 0) return "";
+	if (text.length <= width) return text;
+	if (width <= 1) return "…".slice(0, width);
+	return `${text.slice(0, width - 1)}…`;
+}
+
+function findProjectRoot(cwd) {
+	let dir = cwd;
+	while (dir) {
+		if (existsSync(join(dir, ".git"))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return cwd;
+		dir = parent;
+	}
+	return cwd;
+}
+
+function getProjectName(cwd) {
+	return basename(findProjectRoot(cwd)) || basename(cwd) || cwd;
+}
+
+function addUsage(totals, usage) {
+	if (!usage) return;
+	totals.input += usage.input ?? 0;
+	totals.output += usage.output ?? 0;
+	totals.cacheRead += usage.cacheRead ?? 0;
+	totals.cacheWrite += usage.cacheWrite ?? 0;
+	totals.cost += usage.cost?.total ?? 0;
+}
+
+function getUsageTotals(ctx) {
+	const totals = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
+	for (const entry of ctx.sessionManager?.getEntries?.() ?? []) {
+		if (entry.type === "message" && entry.message?.role === "assistant") {
+			addUsage(totals, entry.message.usage);
+		} else if (entry.type === "message" && entry.message?.role === "toolResult") {
+			addUsage(totals, entry.message.usage);
+		} else if ((entry.type === "branch_summary" || entry.type === "compaction") && entry.usage) {
+			addUsage(totals, entry.usage);
+		}
+	}
+	return totals;
+}
+
+function shortModelName(modelId) {
+	if (!modelId) return "no-model";
+	return modelId
+		.replace(/^claude-/, "")
+		.replace(/^gpt-/, "gpt-")
+		.replace(/-20\d{6}$/, "")
+		.replace(/-latest$/, "");
+}
+
+function createByzFooter(ctx, tui, theme, footerData) {
+	const unsubscribe = footerData.onBranchChange?.(() => tui.requestRender?.());
+	return {
+		invalidate() {},
+		dispose() {
+			unsubscribe?.();
+		},
+		render(width) {
+			const safeWidth = Math.max(1, width ?? 80);
+			const cwd = ctx.sessionManager?.getCwd?.() ?? ctx.cwd ?? process.cwd();
+			const parts = [getProjectName(cwd)];
+			const branch = footerData.getGitBranch?.();
+			if (branch) parts.push(branch);
+
+			const contextUsage = ctx.getContextUsage?.();
+			if (contextUsage) {
+				const left = contextUsage.percent === null ? "?" : `${Math.max(0, 100 - contextUsage.percent).toFixed(0)}%`;
+				parts.push(`left ${left}`);
+			}
+
+			const usage = getUsageTotals(ctx);
+			if (usage.input > 0) parts.push(`↑${formatTokens(usage.input)}`);
+			if (usage.output > 0) parts.push(`↓${formatTokens(usage.output)}`);
+			if (usage.cacheRead > 0) parts.push(`R${formatTokens(usage.cacheRead)}`);
+			if (usage.cacheWrite > 0) parts.push(`W${formatTokens(usage.cacheWrite)}`);
+			if (usage.cost > 0) parts.push(`$${usage.cost.toFixed(3)}`);
+
+			const extensionStatuses = footerData.getExtensionStatuses?.();
+			for (const text of extensionStatuses?.values?.() ?? []) {
+				const clean = String(text)
+					.replace(/[\r\n\t]/g, " ")
+					.replace(/ +/g, " ")
+					.trim();
+				if (clean) parts.push(clean);
+			}
+
+			const leftText = parts.join("  ");
+			const modelText = shortModelName(ctx.model?.id);
+			const minGap = 2;
+			let line;
+			if (leftText.length + minGap + modelText.length <= safeWidth) {
+				line = `${leftText}${" ".repeat(safeWidth - leftText.length - modelText.length)}${modelText}`;
+			} else {
+				const modelBudget = Math.min(modelText.length, Math.max(0, safeWidth - minGap - 12));
+				const model = truncateText(modelText, modelBudget);
+				const leftBudget = Math.max(1, safeWidth - minGap - model.length);
+				line = `${truncateText(leftText, leftBudget)}${" ".repeat(Math.max(minGap, safeWidth - leftBudget - model.length))}${model}`;
+			}
+			return [theme.fg?.("dim", line) ?? line];
+		},
+	};
+}
+
+function createProgressState() {
+	return {
+		goal: "当前任务",
+		stage: "确认目标与边界",
+		confirmed: [],
+		judgements: [],
+		nextSteps: ["完成必要检查", "整理结果给你"],
+		safeguards: ["不会提交代码", "不会执行高影响动作"],
+		tools: { inspected: 0, edited: 0, commands: 0 },
+		visible: false,
+	};
+}
+
+function pushUnique(list, value, limit = 3) {
+	if (!value || list.includes(value)) return;
+	list.push(value);
+	if (list.length > limit) list.shift();
+}
+
+function summarizeGoal(prompt) {
+	const clean = String(prompt ?? "")
+		.replace(/[\r\n\t]/g, " ")
+		.replace(/展开细节[，,；;\s]*/g, "")
+		.replace(/ +/g, " ")
+		.trim();
+	if (!clean) return "当前任务";
+	return clean.length > 28 ? `${clean.slice(0, 27)}…` : clean;
+}
+
+function getActivitySummary(state) {
+	const activity = [];
+	if (state.tools.inspected > 0) activity.push(`查看 ${state.tools.inspected} 项`);
+	if (state.tools.edited > 0) activity.push(`修改 ${state.tools.edited} 项`);
+	if (state.tools.commands > 0) activity.push(`命令 ${state.tools.commands} 次`);
+	return activity.join("，");
+}
+
+function renderProgressCard(state, options = {}) {
+	const activity = getActivitySummary(state);
+	if (options.compact) {
+		const progress = activity || state.confirmed.at(-1) || state.stage;
+		const next = state.nextSteps.at(-1) ?? "整理结果给你";
+		const boundary = state.safeguards.at(-1) ?? "不会提交代码";
+		return [`处理中：${state.goal}`, `进展：${progress}`, `下一步：${next}`, `边界：${boundary}`].join("\n");
+	}
+
+	const lines = [`正在处理：${state.goal}`, `当前阶段：${state.stage}`];
+	if (activity) lines.push(`现场进展：${activity}`);
+	if (state.confirmed.length > 0) lines.push(`已确认：${state.confirmed.join("；")}`);
+	if (state.judgements.length > 0) lines.push(`当前判断：${state.judgements.join("；")}`);
+	if (state.nextSteps.length > 0) lines.push(`下一步：${state.nextSteps.join("；")}`);
+	if (state.safeguards.length > 0) lines.push(`不会做：${state.safeguards.join("；")}`);
+	return lines.join("\n");
+}
+
+function stageForTool(toolName) {
+	if (["read", "grep", "find", "ls"].includes(toolName)) return "定位和核对相关材料";
+	if (["edit", "write"].includes(toolName)) return "执行最小必要修改";
+	if (["bash", "powershell"].includes(toolName)) return "运行命令并核对结果";
+	return "处理必要步骤";
+}
+
+function updateProgressFromToolStart(state, toolName) {
+	state.stage = stageForTool(toolName);
+	if (["read", "grep", "find", "ls"].includes(toolName)) {
+		pushUnique(state.nextSteps, "基于证据判断方案");
+	} else if (["edit", "write"].includes(toolName)) {
+		pushUnique(state.judgements, "优先做小改动，避免扩大范围");
+		pushUnique(state.nextSteps, "补充验证");
+	} else if (["bash", "powershell"].includes(toolName)) {
+		pushUnique(state.nextSteps, "根据命令结果决定是否继续");
+	}
+}
+
+function updateProgressFromToolEnd(state, toolName, isError) {
+	if (["read", "grep", "find", "ls"].includes(toolName)) {
+		state.tools.inspected += 1;
+		pushUnique(state.confirmed, "已查看相关项目资料");
+	} else if (["edit", "write"].includes(toolName)) {
+		state.tools.edited += 1;
+		pushUnique(state.confirmed, isError ? "修改步骤需要复核" : "已完成代码层面的变更");
+	} else if (["bash", "powershell"].includes(toolName)) {
+		state.tools.commands += 1;
+		pushUnique(state.confirmed, isError ? "命令结果需要处理" : "已执行验证命令");
+	}
+	if (isError) {
+		state.stage = "处理异常结果";
+		pushUnique(state.judgements, "先解释失败原因，再决定是否调整");
+		return;
+	}
+	state.stage = "继续核对并收敛结果";
+}
+
+export function createConversationExtension(options = {}) {
+	const policy = createInteractionPolicy();
+	const routingPolicy = createRoutingPolicy();
+	const progressCardDelayMs = options.progressCardDelayMs ?? 8_000;
+	let savedDetailMode = getSavedDetailMode();
+
+	return function conversationExtension(pi) {
+		let progressTimer;
+		let progressState = createProgressState();
+		let activeCtx;
+
+		function clearProgressTimer() {
+			if (progressTimer) clearTimeout(progressTimer);
+			progressTimer = undefined;
+		}
+
+		function publishProgress() {
+			if (!activeCtx) return;
+			progressState.visible = true;
+			activeCtx.ui.setWorkingMessage?.(renderProgressCard(progressState, { compact: !policy.isDetailEnabled() }));
+		}
+
+		function updateVisibleProgress() {
+			if (progressState.visible) publishProgress();
+		}
+
+		pi.on("session_start", (_event, ctx) => {
+			routingPolicy.reset();
+			policy.setDetailEnabled(savedDetailMode === DETAIL_MODE_DETAILS);
+			ctx.ui.setTitle?.("BYZ");
+			ctx.ui.setMessagePresenter?.((message) => policy.presentAssistantMessage(message));
+			ctx.ui.setToolExecutionVisible?.(policy.isDetailEnabled());
+			ctx.ui.setFooter?.((tui, theme, footerData) => createByzFooter(ctx, tui, theme, footerData));
+			ctx.ui.setConfirmationPresenter?.(async ({ title, message, confirm }) => {
+				const prompt = formatDecision({
+					impact: message,
+					recommendation: "确认",
+					alternative: "取消",
+					onReject: "不会执行此操作",
+				});
+				const answer = await ctx.ui.input(prompt, `${title}：输入“确认”或“取消”`);
+				const choice = answer ? parseConversationControl(answer) : undefined;
+				if (choice === "accept" || choice === "proceed") return true;
+				if (choice === "reject") return false;
+				return confirm();
+			});
+			ctx.ui.notify(WELCOME, "info");
+		});
+		pi.on("agent_start", (_event, ctx) => {
+			activeCtx = ctx;
+			policy.resetProgress();
+			progressState.visible = false;
+			clearProgressTimer();
+			ctx.ui.setWorkingMessage?.("正在确认目标与边界…");
+			progressTimer = setTimeout(() => {
+				publishProgress();
+			}, progressCardDelayMs);
+		});
+		pi.on("tool_execution_start", (event) => {
+			updateProgressFromToolStart(progressState, event.toolName);
+			updateVisibleProgress();
+		});
+		pi.on("tool_execution_end", (event) => {
+			updateProgressFromToolEnd(progressState, event.toolName, event.isError);
+			updateVisibleProgress();
+		});
+		pi.on("message_update", (event) => {
+			if (event.message?.role !== "assistant") return;
+			progressState.stage = "组织回复";
+			pushUnique(progressState.nextSteps, "给出结论和已做验证");
+			updateVisibleProgress();
+		});
+		pi.on("agent_end", () => {
+			clearProgressTimer();
+			activeCtx?.ui.setWorkingMessage?.();
+			activeCtx = undefined;
+		});
+		pi.on("session_shutdown", () => {
+			routingPolicy.reset();
+			clearProgressTimer();
+			activeCtx?.ui.setWorkingMessage?.();
+			activeCtx = undefined;
+		});
+		function applyDetailMode(ctx, mode, options = {}) {
+			policy.setDetailEnabled(mode === DETAIL_MODE_DETAILS);
+			ctx.ui.setToolExecutionVisible?.(policy.isDetailEnabled());
+			if (options.remember) {
+				saveDetailMode(mode);
+				savedDetailMode = mode;
+			}
+			if (mode === DETAIL_MODE_DETAILS) {
+				const scope = options.remember ? "已设为所有会话默认" : "仅当前会话";
+				ctx.ui.notify(`已展开细节（${scope}）。高级控制：/fast、/prewalk、/workflow。`, "info");
+				return;
+			}
+			const scope = options.remember ? "已设为所有会话默认" : "仅当前会话";
+			ctx.ui.notify(`已切回紧凑模式（${scope}）。`, "info");
+		}
+
+		function handleDetailsCommand(args, ctx) {
+			const action = String(args ?? "")
+				.trim()
+				.toLowerCase();
+			if (!action || action === "on") {
+				applyDetailMode(ctx, DETAIL_MODE_DETAILS);
+				return;
+			}
+			if (["off", "compact"].includes(action)) {
+				applyDetailMode(ctx, DETAIL_MODE_COMPACT);
+				return;
+			}
+			if (["remember", "save", "details"].includes(action)) {
+				applyDetailMode(ctx, DETAIL_MODE_DETAILS, { remember: true });
+				return;
+			}
+			if (["remember compact", "save compact", "compact remember"].includes(action)) {
+				applyDetailMode(ctx, DETAIL_MODE_COMPACT, { remember: true });
+				return;
+			}
+			if (action === "status") {
+				const current = policy.isDetailEnabled() ? DETAIL_MODE_DETAILS : DETAIL_MODE_COMPACT;
+				ctx.ui.notify(`当前：${current}。默认：${savedDetailMode}。`, "info");
+				return;
+			}
+			ctx.ui.notify("用法：/details [on|off|remember|remember compact|status]", "warning");
+		}
+
+		pi.registerCommand("details", {
+			description: "Configure BYZ detail mode",
+			handler: async (args, ctx) => handleDetailsCommand(args, ctx),
+		});
+		pi.on("before_agent_start", async (event, ctx) => {
+			const route = routingPolicy.route(event.prompt);
+			progressState = createProgressState();
+			progressState.goal = summarizeGoal(event.prompt);
+			pushUnique(progressState.confirmed, "已收到目标");
+			if (route.kind !== "general") pushUnique(progressState.judgements, `任务类型：${route.kind}`);
+			if (route.preferences.autonomy === "confirm-key-actions") {
+				pushUnique(progressState.safeguards, "关键动作会先确认");
+			}
+			if (route.details || parseConversationControl(event.prompt) === "detail") {
+				applyDetailMode(ctx, DETAIL_MODE_DETAILS);
+			}
+			if (policy.isDetailEnabled()) {
+				ctx.ui.notify(
+					`当前类别：${route.kind}。当前偏好：主动程度 ${route.preferences.autonomy}，交付 ${route.preferences.delivery}。`,
+					"info",
+				);
+			}
+			return {
+				systemPrompt: `${event.systemPrompt ?? ""}\n\nBYZ collaboration guidance for this turn:\n${route.instructions}`,
+			};
+		});
+	};
+}
+
+export { WELCOME };

package/dist/conversation/interaction-policy.js

@@ -0,0 +1,53 @@
+const INTERNAL_TERMS = /\b(?:model|skill|workflow|fast|prewalk|token|tool|step\s*\d+)\b/gi;
+
+export function createInteractionPolicy() {
+	let progressShown = false;
+	let detailEnabled = false;
+
+	function present(kind, message, { detail = false } = {}) {
+		if (kind === "progress") {
+			if (progressShown) return undefined;
+			progressShown = true;
+			return "正在处理，稍后给你结果。";
+		}
+		if (kind === "advanced-control" && !detailEnabled && !detail) return undefined;
+		if (detail || detailEnabled) return message;
+		return message.replace(INTERNAL_TERMS, "内部设置");
+	}
+
+	function presentAssistantMessage(message) {
+		if (detailEnabled) return message;
+		const content = message.content
+			.filter((part) => part.type === "text")
+			.map((part) => ({ ...part, text: part.text.replace(INTERNAL_TERMS, "内部设置") }));
+		return { ...message, content };
+	}
+
+	return {
+		present,
+		presentAssistantMessage,
+		setDetailEnabled(enabled) {
+			detailEnabled = enabled;
+		},
+		isDetailEnabled() {
+			return detailEnabled;
+		},
+		resetProgress() {
+			progressShown = false;
+		},
+	};
+}
+
+export function parseConversationControl(input) {
+	const value = input.trim();
+	if (/^(展开细节|查看细节|显示细节)$/.test(value)) return "detail";
+	if (/^(少问一点|直接做)$/.test(value)) return "proceed";
+	if (/^(关键动作先问我|先问我)$/.test(value)) return "confirm";
+	if (/^(取消|不要|拒绝)$/.test(value)) return "reject";
+	if (/^(确认|继续|同意|可以)$/.test(value)) return "accept";
+	return undefined;
+}
+
+export function formatDecision({ impact, recommendation, alternative, onReject }) {
+	return `需要你决定\n影响：${impact}\n建议：${recommendation}\n其他选择：${alternative}\n如果拒绝：${onReject}`;
+}

package/dist/conversation/routing-policy.js

@@ -0,0 +1,102 @@
+const DEFAULT_PREFERENCES = Object.freeze({
+	autonomy: "balanced",
+	delivery: "normal",
+});
+
+const CONTROL_PATTERNS = [
+	[/关键动作先问我|先问我/, { autonomy: "confirm-key-actions" }],
+	[/少问一点/, { autonomy: "fewer-questions" }],
+	[/直接做/, { autonomy: "direct" }],
+	[/先给三个方向/, { delivery: "three-directions" }],
+	[/展开细节|查看细节|显示细节/, {}],
+];
+
+const FALLBACKS = Object.freeze({
+	research: {
+		missingInput: "需要可访问链接、正文、关键词或目标来源。",
+		fallback: "可先基于你提供的摘要做初步判断，或请你补充正文、截图、链接。",
+	},
+	"bug-fix": {
+		missingInput: "需要复现步骤、报错信息、相关输入或运行环境。",
+		fallback: "可先根据现象列排查清单，等你补充日志后再定位。",
+	},
+	"project-recovery": {
+		missingInput: "需要当前项目路径、上次进度、任务状态或错误现场。",
+		fallback: "可先读取本地项目状态并汇总可恢复线索。",
+	},
+	general: {
+		missingInput: "需要更明确的目标、输入材料或期望输出。",
+		fallback: "可先给出可选方向或最小可执行下一步。",
+	},
+});
+
+function classify(goal) {
+	if (/https?:\/\/|链接|帖子|查一下|调研|研究/.test(goal)) return "research";
+	if (/三个方向|创意|设计|文案|写作|起个名字/.test(goal)) return "creative";
+	if (/报错|bug|缺陷|无法复现|修复/.test(goal)) return "bug-fix";
+	if (/新功能|实现|开发|增加.*功能|添加.*功能/.test(goal)) return "feature";
+	if (/继续.*项目|恢复.*项目|上次.*停/.test(goal)) return "project-recovery";
+	return "general";
+}
+
+function instructionsFor(kind, preferences) {
+	const collaboration = [
+		preferences.autonomy === "direct" ? "在安全且可逆的范围内直接推进，不要先要求用户选择内部模式。" : undefined,
+		preferences.autonomy === "fewer-questions" ? "仅在缺少会明显改变结果的关键信息时提一个问题。" : undefined,
+		preferences.autonomy === "confirm-key-actions" ? "关键动作前说明影响并请求确认。" : undefined,
+		preferences.delivery === "three-directions" ? "先给出三个可区分的方向，再建议一个推荐方向。" : undefined,
+	].filter(Boolean);
+	const task = {
+		research: "优先说明来源是否可访问；无法取得内容时说明缺失并建议用户提供正文或替代来源。",
+		creative: "先给出可见的创作骨架或方向，避免暴露内部能力名称。",
+		"bug-fix": "先以可复现证据定位；无法复现时说明缺少的环境、输入或日志。",
+		feature: "先确认目标与范围；涉及高影响动作时保持既有确认边界。",
+		"project-recovery": "只在当前会话可见信息足够时恢复上下文；否则说明需要的项目状态。",
+		general: "直接用自然语言处理目标；资料不足时说明未完成部分和可行替代路径。",
+	}[kind];
+	return [...collaboration, task].join("\n");
+}
+
+export function classifyRequest(prompt, preferences = DEFAULT_PREFERENCES) {
+	const kind = classify(prompt.trim());
+	return {
+		fallback: FALLBACKS[kind]?.fallback,
+		instructions: instructionsFor(kind, preferences),
+		kind,
+		missingInput: FALLBACKS[kind]?.missingInput,
+	};
+}
+
+export function parseSessionPreference(input) {
+	const preferences = {};
+	const details = /展开细节|查看细节|显示细节/.test(input);
+	let goal = input;
+	for (const [pattern, changes] of CONTROL_PATTERNS) {
+		if (pattern.test(goal)) Object.assign(preferences, changes);
+		goal = goal.replace(pattern, "");
+	}
+	return { details, goal: goal.replace(/[，,。；;]+/g, " ").trim(), preferences };
+}
+
+export const parseSessionPreferences = parseSessionPreference;
+
+export function createRoutingPolicy() {
+	let preferences = { ...DEFAULT_PREFERENCES };
+
+	return {
+		route(input) {
+			const parsed = parseSessionPreference(input);
+			preferences = { ...preferences, ...parsed.preferences };
+			const route = classifyRequest(parsed.goal, preferences);
+			return {
+				...route,
+				details: parsed.details,
+				goal: parsed.goal,
+				preferences: { ...preferences },
+			};
+		},
+		reset() {
+			preferences = { ...DEFAULT_PREFERENCES };
+		},
+	};
+}