@zhushanwen/pi-ask-user 0.1.0 → 1.0.0

package/src/answer-format.ts

@@ -0,0 +1,51 @@
+// src/answer-format.ts
+// 答案文本格式的唯一权威模块。
+// TUI 路径（submit-view.ts:getAnswerText）和 RPC 路径（index.ts:protoAnswersToResult）
+// 都调 formatAnswer 产出 "label1, label2 — comment" 格式，确保两条路径一致。
+// renderExpandedOptions（index.ts）调 parseAnswerParts 精确反解析选中项。
+import { ANSWER_COMMENT_SEPARATOR } from "./types";
+
+/**
+ * 把答案各部分拼装为最终文本格式："part1, part2 — comment"。
+ * - parts 为空 → 返回 null（未答）
+ * - comment 有值 → 追加 ANSWER_COMMENT_SEPARATOR + comment
+ */
+export function formatAnswer(parts: string[], comment?: string | null): string | null {
+	if (parts.length === 0) return null;
+	const base = parts.join(", ");
+	return comment ? `${base}${ANSWER_COMMENT_SEPARATOR}${comment}` : base;
+}
+
+/**
+ * 从最终答案文本中精确解析出选中的 labels（不依赖子串匹配）。
+ * 用于 renderExpandedOptions 反向判定哪些选项被选中。
+ *
+ * @param answer 最终答案文本（formatAnswer 产出）
+ * @param labels 候选 label 列表（q.options 的 label），精确匹配
+ * @returns selected=命中的 labels（按 answer 中出现顺序），comment=评论文本（如有）
+ */
+export function parseAnswerParts(
+	answer: string,
+	labels: string[],
+): { selected: string[]; comment?: string } {
+	// 先提取 comment（ANSWER_COMMENT_SEPARATOR 之后的部分）
+	let body = answer;
+	let comment: string | undefined;
+	const sepIdx = answer.indexOf(ANSWER_COMMENT_SEPARATOR);
+	if (sepIdx >= 0) {
+		body = answer.slice(0, sepIdx);
+		comment = answer.slice(sepIdx + ANSWER_COMMENT_SEPARATOR.length).trim();
+	}
+
+	// body 形如 "label1, label2" → 精确匹配候选 label
+	const labelSet = new Set(labels);
+	const tokens = body.split(/[,，]/).map((t) => t.trim()).filter(Boolean);
+	const selected: string[] = [];
+	// 剩余 tokens 不匹配任何 label → 是 Other 自由文本（不返回，调用方自行处理）
+	for (const token of tokens) {
+		if (labelSet.has(token)) {
+			selected.push(token);
+		}
+	}
+	return { selected, comment };
+}

package/src/channel-handler.ts

@@ -0,0 +1,215 @@
+// src/channel-handler.ts
+//
+// ask_user channel handler：把 subagent 子进程的 ask_user 请求透传到主进程 UI 渲染。
+//
+// 设计（关键决策）：askUserInteract（@xyz-agent/extension-protocol）只在 RPC 模式可用
+// （内部 isGuiCapable 检查 mode==='rpc'，TUI 下抛错）。所以 handler 按 ctx.mode 分流：
+//   - RPC：转发器——调 askUserInteract(guiCtx, protoQuestions)，复用 select 通道 +
+//     ASK_USER_MARKER 契约，主进程 ctx.ui.select 经 GUI sidecar 渲染（不进 parseSpawnLine，
+//     不循环）。返回 {value: JSON.stringify(answers)} 让子进程 JSON.parse(value) decode。
+//   - TUI：走 ctx.ui.custom + AskUserComponent。三步：(1) protoQuestions → 内部 Question[]，
+//     (2) ctx.ui.custom 渲染拿内部 Result，(3) 内部 Result.answers（key=question 全文，
+//     value="label1, label2 — comment"）→ 重新编码为 proto AskUserAnswers（key=header/question，
+//     单选=value，多选=JSON 数组，Other→__other，comment→__comment），让子进程 decode 一致。
+//
+// handler 收到的 req.channelPayload = {questions: AskUserQuestion[], allowCancel}（proto 格式，
+// 由子进程 askUserInteract 编码、subagent-workflow parseChannel 解析 options[0] JSON 得到）。
+
+import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
+import {
+	type AskUserAnswers,
+	askUserInteract,
+	type AskUserQuestion,
+} from "@xyz-agent/extension-protocol";
+
+import { AskUserComponent } from "./component";
+import { ANSWER_COMMENT_SEPARATOR, type Option, type Question, type Result, type ThemeLike } from "./types";
+
+/**
+ * channel handler 签名——与 subagent-workflow 的 UiChannelRegistry.ChannelHandler 一致
+ *（(req: unknown) => Promise<unknown>）。本文件不静态 import subagent-workflow（它是可选
+ * peerDep，未安装时静态 import 会导致整个 ask-user 加载失败）；注册时通过动态 import 拿
+ * registry，handler 签名用本地等价类型，运行时结构兼容。
+ */
+export type ChannelHandler = (req: unknown) => Promise<unknown>;
+
+/** handler 返回给 subagent-workflow 的 UiResponse 形状（dialog-queue.ts 定义）。
+ *  - {value}: select 的回传值（子进程 JSON.parse(value) 得 answers）
+ *  - {cancelled}: 用户取消 / 子进程 close / handler 抛错 */
+type ChannelResponse = { value: string } | { cancelled: true };
+
+/** handler 收到的 req 形状收窄（ChannelHandler 签名是 unknown，按形状 as 收窄）。
+ *  channelPayload 由 subagent-workflow parseChannel 填充。 */
+interface ChannelRequest {
+	channelPayload?: { questions?: AskUserQuestion[]; allowCancel?: boolean };
+}
+
+/** proto AskUserQuestion → 内部 Question（AskUserComponent 接受内部格式）。
+ *  proto options 可选（无 options=纯自由文本），内部 options 必填——无 options 的 protoQuestion
+ *  这里仍映射出 options（从子进程 ask-user 调用方保证 protoQuestions 总带 options；若缺则返 [] 由调用方判）。 */
+function protoToInternalQuestions(protoQuestions: AskUserQuestion[]): Question[] {
+	return protoQuestions.map((pq: AskUserQuestion): Question => {
+		const opts: Option[] = (pq.options ?? []).map((o: { label: string; description?: string }): Option => ({
+			label: o.label,
+			...(o.description !== undefined ? { description: o.description } : {}),
+		}));
+		return {
+			question: pq.question,
+			...(pq.header !== undefined ? { header: pq.header } : {}),
+			...(pq.context !== undefined ? { context: pq.context } : {}),
+			options: opts,
+			...(pq.multiSelect !== undefined ? { multiSelect: pq.multiSelect } : {}),
+			...(pq.allowComment !== undefined ? { allowComment: pq.allowComment } : {}),
+		};
+	});
+}
+
+/**
+ * 把 TUI 路径产出的内部 Result.answers 重新编码为 proto AskUserAnswers。
+ *
+ * 内部 Result.answers：key = question 全文，value = "label1, label2 — comment"
+ * （Other 自由文本与 selected 标签逗号拼接，comment 用 ANSWER_COMMENT_SEPARATOR 分隔）。
+ *
+ * proto AskUserAnswers 契约（@xyz-agent/extension-protocol）：
+ *   - key = question.header ?? question 全文
+ *   - 单选：value = 选中项 value string
+ *   - 多选：value = JSON.stringify(选中项 value 数组)
+ *   - Other 自由文本：单独 key `${header}__other`
+ *   - comment：单独 key `${header}__comment`
+ *
+ * 解码（无信息丢失）：用 protoQuestion.options 的 label 集合精确匹配 selected；
+ * 不匹配的 token = Other 自由文本；comment 由 ANSWER_COMMENT_SEPARATOR 切出。
+ */
+function encodeTuiResultToProto(
+	protoQuestions: AskUserQuestion[],
+	result: Result,
+): AskUserAnswers {
+	const answers: AskUserAnswers = {};
+	for (const pq of protoQuestions) {
+		const key = pq.header ?? pq.question;
+		const internalText = result.answers[pq.question];
+		if (internalText === undefined) continue; // 该问题未答（protoAnswersToResult 也跳过未答）
+
+		// 已知选项 label 集合（protoQuestion.options 的 label/value 都作候选——value 缺失时用 label）
+		const knownLabels = new Set<string>();
+		for (const o of pq.options ?? []) {
+			knownLabels.add(o.label);
+			if (o.value !== undefined) knownLabels.add(o.value);
+		}
+
+		// 切 body / comment（comment 在 ANSWER_COMMENT_SEPARATOR 之后）
+		const sepIdx = internalText.indexOf(ANSWER_COMMENT_SEPARATOR);
+		const body = sepIdx >= 0 ? internalText.slice(0, sepIdx) : internalText;
+		const comment = sepIdx >= 0
+			? internalText.slice(sepIdx + ANSWER_COMMENT_SEPARATOR.length).trim() || undefined
+			: undefined;
+
+		// body tokens：匹配 knownLabels 的为 selected，其余为 Other 自由文本
+		const tokens = body.split(/[,，]/).map((t: string) => t.trim()).filter((t: string) => t !== "");
+		const selected: string[] = [];
+		const otherTokens: string[] = [];
+		for (const t of tokens) {
+			if (knownLabels.has(t)) {
+				// 回查 proto option 的 value（PR #85 #8）：TUI 渲染用 label，但 RPC 路径
+				// （askUserInteract）回传的是 option.value。value≠label 时若直接 push label，
+				// TUI/RPC 两条路径产出分裂。value 缺失时 fallback label（保持 ask-user 自身
+				// toProtoQuestions 的 value=label 语义，以及历史行为）。
+				const opt = pq.options?.find(o => o.label === t || o.value === t);
+				selected.push(opt?.value ?? t);
+			} else {
+				otherTokens.push(t);
+			}
+		}
+		const otherText = otherTokens.join(", ") || undefined;
+
+		// 主 key：单选 = 首个选中 value；多选 = JSON 数组（即便为空也写入，与 RPC 契约一致）
+		if (pq.multiSelect) {
+			answers[key] = JSON.stringify(selected);
+		} else if (selected.length > 0) {
+			answers[key] = selected[0]!;
+		}
+
+		if (otherText) answers[`${key}__other`] = otherText;
+		if (comment) answers[`${key}__comment`] = comment;
+	}
+	return answers;
+}
+
+/** TUI 路径：ctx.ui.custom + AskUserComponent 渲染，返回 proto answers 或 null（取消）。
+ *
+ *  allowCancel 透传预留（PR #85 #12）：AskUserComponent 构造函数暂未接收 allowCancel，
+ *  Esc 取消始终可用（component.ts 的 escBackOrConfirm / cancel 无条件生效）。待组件升级
+ *  支持禁用 Esc 后，应把 allowCancel 下传给 AskUserComponent 构造函数。当前 allowCancel=false
+ *  时 TUI 与 RPC 路径仍有分裂，但 handler 层已不再吞掉 allowCancel（修复分裂的第一步）。 */
+async function runTuiProtoInteraction(
+	protoQuestions: AskUserQuestion[],
+	ctx: ExtensionContext,
+	allowCancel: boolean,
+): Promise<AskUserAnswers | null> {
+	const questions = protoToInternalQuestions(protoQuestions);
+	// 预留：组件升级后此处改为 new AskUserComponent(questions, tui, theme, done, allowCancel)
+	void allowCancel;
+	const result = await ctx.ui.custom<Result | null>(
+		(tui: unknown, theme: unknown, _kb: unknown, done: (r: Result | null) => void) => {
+			const comp = new AskUserComponent(
+				questions,
+				tui as { requestRender(): void },
+				theme as ThemeLike,
+				done,
+			);
+			return comp;
+		},
+	);
+	if (result === null || result.cancelled) return null;
+	return encodeTuiResultToProto(protoQuestions, result);
+}
+
+/**
+ * 创建 ask_user channel handler。
+ *
+ * @param ctx 主进程 ExtensionContext（session_start 时注入）
+ * @returns ChannelHandler——req.channelPayload = {questions, allowCancel}（proto 格式），
+ *          返回 {value: JSON.stringify(answers)} 或 {cancelled: true}
+ */
+export function createAskUserChannelHandler(ctx: ExtensionContext): ChannelHandler {
+	return async (req: unknown): Promise<unknown> => {
+		// req 正常是 subagent-workflow 构造的 UiRequest 对象；防御性收窄 null/undefined/
+		// 非 object（handler 抛错会被 dialog-queue 兜底为 {cancelled:true}，但这里直接返回更干净）
+		if (req === null || typeof req !== "object") {
+			return { cancelled: true } satisfies ChannelResponse;
+		}
+		const r = req as ChannelRequest;
+		const payload = r.channelPayload;
+		if (!payload || !Array.isArray(payload.questions) || payload.questions.length === 0) {
+			return { cancelled: true } satisfies ChannelResponse;
+		}
+		const { questions, allowCancel } = payload;
+
+		// 按 ctx.mode 分流（PR #85 #13 / #M6）：rpc 走 askUserInteract（select 通道+sidecar），
+		// 其余（tui/json/print/undefined）走 ctx.ui.custom+AskUserComponent。
+		// 用 ctx.mode === "rpc" 二值判定（与 index.ts execute 的 useRpc 判定一致）；
+		// 三值分类不需要——handler 只关心「rpc 转发」vs「TUI 内部渲染」两条路径。
+		const answers =
+			ctx.mode === "rpc"
+				? await runRpcForward(questions, ctx, allowCancel ?? true)
+				: await runTuiProtoInteraction(questions, ctx, allowCancel ?? true);
+
+		if (answers === null) return { cancelled: true } satisfies ChannelResponse;
+		return { value: JSON.stringify(answers) } satisfies ChannelResponse;
+	};
+}
+
+/** RPC 转发器：主进程 ctx.ui.select 经 GUI sidecar 渲染（不进 parseSpawnLine，不循环）。
+ *  完整复用 askUserInteract 的 encode/decode 契约。 */
+async function runRpcForward(
+	questions: AskUserQuestion[],
+	ctx: ExtensionContext,
+	allowCancel: boolean,
+): Promise<AskUserAnswers | null> {
+	const guiCtx = {
+		mode: ctx.mode,
+		hasUI: ctx.hasUI,
+		ui: { select: ctx.ui.select.bind(ctx.ui) },
+	};
+	return askUserInteract(guiCtx, questions, { allowCancel });
+}

package/src/channel-registry-register.ts

@@ -0,0 +1,108 @@
+// src/channel-registry-register.ts
+//
+// ask-user 侧的 channel handler 握手注册纯函数。
+//
+// 设计动机（PR #85 #M4 修复）：原实现 ask-user 先 session_start 时会自建简化 Map-based
+// registry 占据 canonical 槽位，劫持 subagent-workflow 后续 getOrCreateChannelRegistry 拿到的
+// 实例（subagent-workflow 的 createUiChannelRegistry 才是 canonical——它带排队、dialog 队列
+// 等完整能力）。修复后的握手协议改为「带 version 的 slot」：
+//   - subagent-workflow session_start 时往 slot 写 {version, registry, pending:[]}
+//   - ask-user session_start 时只读 slot，registry 就绪则调 registry.register，未就绪则 push pending
+//   - ask-user **永不**创建 registry 实例，**永不**写 slot.registry
+//
+// 这是 ask-user 侧的注册入口；canonical registry 由 subagent-workflow 创建。本模块永不创建
+// registry 实例——仅往 slot 写 pending 或调 slot.registry.register。
+
+import type { ChannelHandler } from "./channel-handler";
+
+/**
+ * 进程级 channel registry 握手的 globalThis key（Symbol.for 跨模块共享）。
+ *
+ * ⚠️ 必须与 extensions/subagent-workflow/src/execution/channel-registry-access.ts 的字面量
+ * 完全一致——两边用同一字符串确保拿到同一 slot 实例。改名必须两侧同步。
+ */
+export const CHANNEL_HANDSHAKE_KEY = Symbol.for(
+	"@zhushanwen/pi-subagents.channelHandshake",
+);
+
+/** 握手协议版本号。读写 slot 时校验 version !== 1 视为不兼容（warn + 重建 slot）。 */
+const HANDSHAKE_VERSION = 1;
+
+/** channel 名称（ask-user 固定注册 "ask_user"）。 */
+const ASK_USER_CHANNEL = "ask_user";
+
+/**
+ * channel registry 的本地等价接口（与 subagent-workflow UiChannelRegistry 形状一致）。
+ * 本模块不静态 import subagent-workflow（它是可选 peerDep，未安装时静态 import 会致整个
+ * ask-user 加载失败）；运行时结构兼容即可。
+ */
+interface ChannelRegistry {
+	register(channel: string, handler: ChannelHandler): void;
+	resolve(channel: string): ChannelHandler | undefined;
+	list(): string[];
+}
+
+/** pending 队列元素：channel + handler。subagent-workflow flush 时遍历调用 registry.register。 */
+interface PendingEntry {
+	channel: string;
+	handler: ChannelHandler;
+}
+
+/**
+ * globalThis slot 的形状。
+ *
+ * - `version`：握手协议版本（运行时校验，不兼容则丢弃重建）
+ * - `registry`：canonical 实例，**仅 subagent-workflow 创建**；缺失表示 registry 未就绪，
+ *   ask-user 把 handler 入 pending 队列等待 flush
+ * - `pending`：未消费的注册请求（registry 就绪后由 subagent-workflow 一次性 flush）
+ */
+export interface ChannelRegistryHandshake {
+	version: 1;
+	registry?: ChannelRegistry;
+	pending: PendingEntry[];
+}
+
+/** 从 globalThis 读 slot；version !== 1 视为无 slot（返回 undefined）。 */
+function readSlot(): ChannelRegistryHandshake | undefined {
+	const slot = Reflect.get(globalThis, CHANNEL_HANDSHAKE_KEY) as
+		| ChannelRegistryHandshake
+		| undefined;
+	if (slot === undefined) return undefined;
+	if (slot.version !== HANDSHAKE_VERSION) {
+		console.warn(
+			`[ask-user] channel handshake slot version mismatch: expected ${HANDSHAKE_VERSION}, got ${slot.version}; discarding and rebuilding slot`,
+		);
+		return undefined;
+	}
+	return slot;
+}
+
+/** 在 globalThis 上建一个空 slot（仅 pending，无 registry——ask-user 永不建 registry）。 */
+function ensureSlot(): ChannelRegistryHandshake {
+	const slot: ChannelRegistryHandshake = { version: HANDSHAKE_VERSION, pending: [] };
+	Reflect.set(globalThis, CHANNEL_HANDSHAKE_KEY, slot);
+	return slot;
+}
+
+/**
+ * 注册 ask_user channel handler 到 globalThis 握手 slot。
+ *
+ * 行为：
+ *   1. slot 不存在或 version 不兼容 → 建 slot（仅 pending），handler 入 pending；
+ *      **slot.registry 保持 undefined**（M4 核心：ask-user 不建 registry）
+ *   2. slot 存在但 registry 未就绪 → handler 入 pending
+ *   3. slot 存在且 registry 就绪 → 直接调 registry.register("ask_user", handler)
+ *
+ * 多次调用幂等：registry 就绪时 register 同名覆盖；未就绪时 pending.length 增长
+ * （subagent-workflow flush 时一次性消费所有 pending）。
+ *
+ * @param handler ask_user channel handler（createAskUserChannelHandler 产出）
+ */
+export function registerAskUserChannelHandler(handler: ChannelHandler): void {
+	const slot = readSlot() ?? ensureSlot();
+	if (slot.registry !== undefined) {
+		slot.registry.register(ASK_USER_CHANNEL, handler);
+		return;
+	}
+	slot.pending.push({ channel: ASK_USER_CHANNEL, handler });
+}

package/src/component.ts

@@ -1,16 +1,23 @@
 // src/component.ts
 import { type Component, matchesKey, parseKey, truncateToWidth } from "@mariozechner/pi-tui";
 
+import {
+	deleteCharBeforeCursor,
+	handleEditorPaste,
+	insertAtCursor,
+	moveCursorEnd,
+	moveCursorHome,
+	moveCursorLeft,
+	moveCursorRight,
+} from "./editor-ops";
 import { allOptions, renderQuestionView } from "./question-view";
 import { buildResult, renderButtonBar, renderSubmitView } from "./submit-view";
 import {
 	createQuestionState,
 	HEADER_MAX_CHARS,
-	isHighSurrogate,
 	type Question,
 	type QuestionState,
 	type Result,
-	SURROGATE_PAIR_LEN,
 	type ThemeLike,
 } from "./types";
 
@@ -76,6 +83,13 @@ export class AskUserComponent implements Component {
 		this.cachedLines = undefined;
 	}
 
+	/** 状态变更后的标准后续：失效缓存 + 请求重绘。
+	 *  消除散弹式修改——每个 mutation 方法末尾不再需要手写 invalidate + requestRender 两行。 */
+	private rerender(): void {
+		this.invalidate();
+		this.tui.requestRender();
+	}
+
 	// ── 渲染 ──
 	render(width: number): string[] {
 		if (this.cachedWidth === width && this.cachedLines) {
@@ -108,7 +122,7 @@ export class AskUserComponent implements Component {
 		} else {
 			const q = this.questions[this.activeTab]!;
 			const state = this.states[this.activeTab]!;
-			for (const line of renderQuestionView(q, state, t, innerWidth, this.isSingle, state.draftText)) {
+			for (const line of renderQuestionView({ question: q, state, theme: t, width: innerWidth, isSingle: this.isSingle })) {
 				add(line);
 			}
 		}
@@ -173,8 +187,7 @@ export class AskUserComponent implements Component {
 				this.cancel();
 			} else {
 				this.pendingCancel = false;
-				this.invalidate();
-				this.tui.requestRender();
+				this.rerender();
 			}
 			return;
 		}
@@ -221,15 +234,13 @@ export class AskUserComponent implements Component {
 
 		if (matchesKey(data, "up")) {
 			state.cursorIndex = Math.max(0, state.cursorIndex - 1);
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		if (matchesKey(data, "down")) {
 			const max = allOptions(q).length - 1;
 			state.cursorIndex = Math.min(max, state.cursorIndex + 1);
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 
@@ -242,8 +253,7 @@ export class AskUserComponent implements Component {
 			state.mode = "freeform";
 			state.draftText = state.freeTextValue ?? state.freeDraft ?? "";
 			state.cursorIndex = state.draftText.length;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 
@@ -288,15 +298,13 @@ export class AskUserComponent implements Component {
 		// Esc → 回退到最后一个问题
 		if (matchesKey(data, "escape")) {
 			this.activeTab = this.questions.length - 1;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		// Tab → Submit ↔ Cancel 循环切焦点（单键双向）
 		if (matchesKey(data, "tab")) {
 			this.submitTabFocus = this.submitTabFocus === "submit" ? "cancel" : "submit";
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		// Enter → 触发当前 focus
@@ -318,7 +326,7 @@ export class AskUserComponent implements Component {
 			this.handleEditorKey(data, keyId, state, q);
 			return;
 		}
-		this.handleEditorPaste(data, state);
+		if (handleEditorPaste(state, data)) this.rerender();
 	}
 
 	/** parseKey 命中的键：escape/enter/backspace/光标移动/space/printable 各有语义，
@@ -333,18 +341,24 @@ export class AskUserComponent implements Component {
 			return;
 		}
 		if (matchesKey(data, "backspace")) {
-			this.deleteCharBeforeCursor(state);
+			if (deleteCharBeforeCursor(state)) this.rerender();
 			return;
 		}
-		if (this.moveCursor(data, state)) return;
+		// 光标移动（4 方向 + home/end）
+		if (matchesKey(data, "left")) { moveCursorLeft(state); this.rerender(); return; }
+		if (matchesKey(data, "right")) { moveCursorRight(state); this.rerender(); return; }
+		if (matchesKey(data, "home")) { moveCursorHome(state); this.rerender(); return; }
+		if (matchesKey(data, "end")) { moveCursorEnd(state); this.rerender(); return; }
 		// 空格特判：parseKey(" ") 返回 "space"（非单字符），需显式插入
 		if (matchesKey(data, "space")) {
-			this.insertAtCursor(state, " ");
+			insertAtCursor(state, " ");
+			this.rerender();
 			return;
 		}
 		// 单字符 printable：parseKey("a") 返回 "a"（code 32-126），在光标处插入
 		if (keyId.length === 1 && keyId >= " " && keyId <= "~") {
-			this.insertAtCursor(state, keyId);
+			insertAtCursor(state, keyId);
+			this.rerender();
 			return;
 		}
 		// 其他 special key（功能键/modifier 组合）→ no-op（不泄漏）
@@ -366,8 +380,7 @@ export class AskUserComponent implements Component {
 		state.mode = "options";
 		state.draftText = "";
 		state.cursorIndex = state.savedOptionsCursorIndex;
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	/** Enter：freeform 有文本→提交，空文本→回退；comment→保存评论并 advance。 */
@@ -389,8 +402,7 @@ export class AskUserComponent implements Component {
 				if (q.multiSelect ? state.selectedIndices.size === 0 : state.selectedIndex === null) {
 					state.confirmed = false;
 				}
-				this.invalidate();
-				this.tui.requestRender();
+				this.rerender();
 			}
 			return;
 		}
@@ -401,79 +413,13 @@ export class AskUserComponent implements Component {
 		this.advance();
 	}
 
-	/** 在光标处插入文本，光标前移 text.length。 */
-	private insertAtCursor(state: QuestionState, text: string): void {
-		state.draftText = state.draftText.slice(0, state.cursorIndex) + text + state.draftText.slice(state.cursorIndex);
-		state.cursorIndex += text.length;
-		this.invalidate();
-		this.tui.requestRender();
-	}
-
-	/** 删除光标前一个 code point（surrogate pair 时删整个 code point）。 */
-	private deleteCharBeforeCursor(state: QuestionState): void {
-		if (state.cursorIndex <= 0) return;
-		const deleteCount = state.cursorIndex >= SURROGATE_PAIR_LEN && isHighSurrogate(state.draftText, state.cursorIndex - SURROGATE_PAIR_LEN) ? SURROGATE_PAIR_LEN : 1;
-		state.draftText = state.draftText.slice(0, state.cursorIndex - deleteCount) + state.draftText.slice(state.cursorIndex);
-		state.cursorIndex -= deleteCount;
-		this.invalidate();
-		this.tui.requestRender();
-	}
-
-	/** 光标移动（left/right/home/end），surrogate pair 安全跳过代理中间位。
-	 *  返回 true 表示命中了移动键；false 表示非移动键，交由上层处理。 */
-	private moveCursor(data: string, state: QuestionState): boolean {
-		if (matchesKey(data, "left")) {
-			const newLeft = state.cursorIndex - 1;
-			state.cursorIndex = newLeft > 0 && isHighSurrogate(state.draftText, newLeft - 1)
-				? newLeft - 1
-				: Math.max(0, newLeft);
-		} else if (matchesKey(data, "right")) {
-			state.cursorIndex = isHighSurrogate(state.draftText, state.cursorIndex)
-				? Math.min(state.draftText.length, state.cursorIndex + SURROGATE_PAIR_LEN)
-				: Math.min(state.draftText.length, state.cursorIndex + 1);
-		} else if (matchesKey(data, "home")) {
-			state.cursorIndex = 0;
-		} else if (matchesKey(data, "end")) {
-			state.cursorIndex = state.draftText.length;
-		} else {
-			return false;
-		}
-		this.invalidate();
-		this.tui.requestRender();
-		return true;
-	}
-
-	/** 多字符粘贴 chunk → printable 提取（BC-1/BC-2/BC-3 保持）。
-	 *  未识别控制序列（OSC/DA/DCS/APC/unknown CSI）整体丢弃，不提取可见残渣。
-	 *  排除 bracketed paste 标记防 C-PASTE 退化。依赖 StdinBuffer 序列拆分保证 data 整体性。 */
-	private handleEditorPaste(data: string, state: QuestionState): void {
-		if (data.startsWith("\x1b") && !data.includes("\x1b[200~") && !data.includes("\x1b[201~")) {
-			return;
-		}
-		const cleaned = data.replace(/\x1b\[200~|\x1b\[201~/g, "");
-		let changed = false;
-		// 用 Array.from 正确拆分 emoji/surrogate pairs
-		for (const c of Array.from(cleaned)) {
-			if (c >= " ") {
-				state.draftText = state.draftText.slice(0, state.cursorIndex) + c + state.draftText.slice(state.cursorIndex);
-				state.cursorIndex += c.length;
-				changed = true;
-			}
-		}
-		if (changed) {
-			this.invalidate();
-			this.tui.requestRender();
-		}
-	}
-
 	private toggleIndex(state: QuestionState, index: number): void {
 		if (state.selectedIndices.has(index)) state.selectedIndices.delete(index);
 		else state.selectedIndices.add(index);
 		if (state.selectedIndices.size === 0 && state.freeTextValue === null) {
 			state.confirmed = false;
 		}
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	private autoConfirmIfAnswered(): void {
@@ -490,21 +436,18 @@ export class AskUserComponent implements Component {
 	private gotoTab(target: number): void {
 		this.autoConfirmIfAnswered();
 		this.activeTab = target;
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	/** Esc 语义：有上一个 tab 则回退；已在首个（或单问题）则进入确认取消覆盖层。 */
 	private escBackOrConfirm(): void {
 		if (this.activeTab > 0) {
 			this.activeTab--;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		this.pendingCancel = true;
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	/** 选中确认后的处理：若 allowComment，进入评论模式（可重入编辑/清除已有评论）；否则前进。 */
@@ -515,8 +458,7 @@ export class AskUserComponent implements Component {
 			state.mode = "comment";
 			state.draftText = state.commentValue ?? "";
 			state.cursorIndex = state.draftText.length;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		this.advance();
@@ -532,8 +474,7 @@ export class AskUserComponent implements Component {
 		} else {
 			this.activeTab = this.questions.length;
 		}
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	private submit(): void {