@zhushanwen/pi-ask-user 0.0.1 → 0.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-ask-user",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Inline adaptive ask_user tool for Pi — single/multi-question structured input with split-pane preview, inline editor, and optional comments.",
   "type": "module",
   "main": "index.ts",
@@ -25,6 +25,8 @@
     "README.md"
   ],
   "devDependencies": {
+    "@earendil-works/pi-tui": "*",
+    "@sinclair/typebox": "*",
     "@types/node": "^24.0.0",
     "vitest": "^4.1.8"
   },

package/src/__tests__/component.test.ts

@@ -117,21 +117,21 @@ describe("AskUserComponent — multi question tab nav", () => {
 
 	it("C-9: Submit tab blocks when not all confirmed", () => {
 		const { c, result } = make(multiQ);
-		c.handleInput(TAB); // -> Q2
-		c.handleInput(TAB); // -> Q3
-		c.handleInput(TAB); // -> Submit
+		c.handleInput(RIGHT); // -> Q2
+		c.handleInput(RIGHT); // -> Q3
+		c.handleInput(RIGHT); // -> Submit
 		c.handleInput(ENTER); // should NOT submit
 		expect(result.val).toBeUndefined();
 	});
 
-	// C-10 / C-11 已废弃：←/→ 不再切 tab（C-E5/C-E6 覆盖 Tab/Shift+Tab 行为）
+	// C-10 / C-11 已废弃：Tab/Shift+Tab 不再切问题 tab（C-E5/C-E6 覆盖 ←/→ 切问题 tab 行为）
 
 	it("C-16 (AC-16): can re-edit confirmed answer", () => {
 		const { c, result } = make(multiQ);
 		// Q1: select A
 		c.handleInput(ENTER); // → Q2
-		// Go back to Q1
-		c.handleInput("\x1b[Z"); // Q1
+		// Go back to Q1（问题 tab 间用 ← 回退）
+		c.handleInput(LEFT); // Q1
 		// Select B instead
 		c.handleInput(DOWN);
 		c.handleInput(ENTER); // → Q2
@@ -152,7 +152,7 @@ describe("AskUserComponent — multi question tab nav", () => {
 		const { c, result } = make(twoQ);
 		c.handleInput(ENTER); // Q1 select A → Q2
 		c.handleInput(" ");   // Q2 toggle X (no Enter-confirm)
-		c.handleInput(TAB); // → Submit, should auto-confirm Q2
+		c.handleInput(RIGHT); // → Submit, should auto-confirm Q2
 		c.handleInput(ENTER); // Submit (all confirmed)
 		expect(result.val!.answers["Q1"]).toBe("A");
 		expect(result.val!.answers["Q2"]).toBe("X");
@@ -179,7 +179,7 @@ describe("AskUserComponent — multi question tab nav", () => {
 		];
 		const { c, result } = make(twoQMulti);
 		c.handleInput(" "); // Q1 toggle A
-		c.handleInput(TAB); // → Q2，auto-confirm Q1，不进评论
+		c.handleInput(RIGHT); // → Q2，auto-confirm Q1，不进评论
 		// 验证：当前在 Q2（非 Q1 的评论模式）。Q2 选 X → Submit
 		c.handleInput(ENTER); // Q2 select X → Submit
 		c.handleInput(ENTER); // Submit
@@ -201,8 +201,8 @@ describe("AskUserComponent — multi question tab nav", () => {
 		c.handleInput("o");
 		c.handleInput("m");
 		c.handleInput(ENTER); // 保存 freeText → confirmed=true → advance to Q2
-		// 切回 Q1，重进 Other 编辑器，清空后空 Enter
-		c.handleInput("\x1b[Z");  // Shift+Tab → Q1
+		// 切回 Q1，重进 Other 编辑器，清空后空 Enter（问题 tab 间用 ← 回退）
+		c.handleInput(LEFT);  // → Q1
 		c.handleInput(DOWN);  // idempotent: cursor stays on Other
 		c.handleInput(DOWN);
 		c.handleInput(ENTER);   // 重开 freeform，editorText 预填 "custom"
@@ -214,9 +214,9 @@ describe("AskUserComponent — multi question tab nav", () => {
 		c.handleInput(BKSP);
 		c.handleInput(ENTER); // 空 Enter → freeTextValue 清空，confirmed 应重置 false
 		// 导航到 Submit 并尝试提交 → 应被阻塞（Q1 回到未答）
-		c.handleInput(TAB); // → Q2
-		c.handleInput(TAB); // → Q3
-		c.handleInput(TAB); // → Submit
+		c.handleInput(RIGHT); // → Q2
+		c.handleInput(RIGHT); // → Q3
+		c.handleInput(RIGHT); // → Submit
 		c.handleInput(ENTER); // 应被阻塞
 		expect(result.val).toBeUndefined();
 	});
@@ -362,6 +362,83 @@ describe("AskUserComponent — Other free-text editor", () => {
 	});
 });
 
+// ── 5e2. 多字符粘贴（M2/M7：完整保留，过滤控制字符，emoji 不丢）──
+// 回归 MUST_FIX-M2：handleEditorInput 按 code point 迭代粘贴 chunk，去掉了
+// `c.length === 1` 守卫（它误杀 BMP 之外的代理对，如 emoji）。
+describe("AskUserComponent — multi-char paste in editor", () => {
+	it("C-PASTE-1: multi-char chunk pasted at once is fully captured", () => {
+		// 终端把整段粘贴文本作为一个 data chunk 投递。修复前只取首字符。
+		const { c } = make([singleQ]);
+		c.handleInput(DOWN);
+		c.handleInput(DOWN);
+		c.handleInput(ENTER); // 打开 freeform 编辑器
+		c.handleInput("hello world"); // 一次粘贴多字符
+		const lines = c.render(60);
+		const editorLine = lines.find((l) => l.includes("█"));
+		expect(editorLine).toBeDefined();
+		// 完整文本保留（非仅首字符 "h"）
+		expect(editorLine).toContain("hello world");
+	});
+
+	it("C-PASTE-2: paste with emoji (surrogate pair) preserves emoji (M2)", () => {
+		// 修复前：`c.length === 1` 守卫把代理对（🐛 length===2）过滤掉，emoji 被静默丢弃。
+		const { c } = make([singleQ]);
+		c.handleInput(DOWN);
+		c.handleInput(DOWN);
+		c.handleInput(ENTER);
+		c.handleInput("fix the 🐛 bug");
+		const lines = c.render(60);
+		const editorLine = lines.find((l) => l.includes("█"));
+		expect(editorLine).toBeDefined();
+		// emoji 完整保留，不丢失
+		expect(editorLine).toContain("fix the 🐛 bug");
+		expect(editorLine).toContain("🐛");
+	});
+
+	it("C-PASTE-3: multi-char chunk with control chars filters control, keeps printable", () => {
+		// 粘贴 "ab\tcd"：\t（U+0009）< 空格 → 被过滤；a/b/c/d 保留。
+		const { c } = make([singleQ]);
+		c.handleInput(DOWN);
+		c.handleInput(DOWN);
+		c.handleInput(ENTER);
+		c.handleInput("ab\tcd");
+		const lines = c.render(60);
+		const editorLine = lines.find((l) => l.includes("█"));
+		expect(editorLine).toBeDefined();
+		// 可打印字符保留，控制字符 \t 被过滤
+		expect(editorLine).toContain("abcd");
+		expect(editorLine).not.toContain("\t");
+	});
+
+	it("C-PASTE-4: empty string input is a no-op (no side effects)", () => {
+		const { c, result } = make([singleQ]);
+		c.handleInput(DOWN);
+		c.handleInput(DOWN);
+		c.handleInput(ENTER); // 打开编辑器
+		const before = c.render(60);
+		c.handleInput(""); // 空字符串，无副作用
+		const after = c.render(60);
+		// 未解析、未崩溃、视图不变
+		expect(result.val).toBeUndefined();
+		expect(after).toEqual(before);
+		// 编辑器仍在（光标在），editorText 仍为空
+		expect(after.some((l) => l.includes("█"))).toBe(true);
+	});
+
+	it("C-PASTE-5: single printable char still works (backward-compat)", () => {
+		// 回归：修复去掉守卫后单字符行为不变（与 C-27 等价的逐字符输入）。
+		const { c } = make([singleQ]);
+		c.handleInput(DOWN);
+		c.handleInput(DOWN);
+		c.handleInput(ENTER);
+		c.handleInput("x"); // 单字符
+		const lines = c.render(60);
+		const editorLine = lines.find((l) => l.includes("█"));
+		expect(editorLine).toBeDefined();
+		expect(editorLine).toContain("x");
+	});
+});
+
 // ── 5f. 评论流程（FR-4.6 / FR-11 / AC-6/12/17）─────────
 describe("AskUserComponent — comment flow", () => {
 	it("C-33: single-select + allowComment Enter enters comment mode", () => {
@@ -513,9 +590,9 @@ describe("AskUserComponent — render cache", () => {
 describe("AskUserComponent — Submit tab", () => {
 	it("C-47: Submit Esc backs to last question (no longer cancels)", () => {
 		const { c, result } = make(multiQ);
-		c.handleInput(TAB); // Q2
-		c.handleInput(TAB); // Q3
-		c.handleInput(TAB); // Submit
+		c.handleInput(RIGHT); // Q2
+		c.handleInput(RIGHT); // Q3
+		c.handleInput(RIGHT); // Submit
 		c.handleInput(ESC); // 回退到最后一个问题 Q3（不取消）
 		expect(result.val).toBeUndefined();
 		const lines = c.render(80);
@@ -538,17 +615,17 @@ describe("AskUserComponent — Submit tab", () => {
 	});
 
 	it("C-S12: Submit tab Left navigates to last question tab", () => {
-		// S-12 锁定：Submit tab 上按 Left → activeTab = questions.length - 1（最后一个问题）
+		// 锁定：Submit tab 上按 ← → activeTab = questions.length - 1（最后一个问题）
 		const { c } = make(multiQ); // 3 questions → tabs 0,1,2,3=Submit
-		// 导航到 Submit
-		c.handleInput(TAB); // Q1 → Q2
-		c.handleInput(TAB); // Q2 → Q3
-		c.handleInput(TAB); // Q3 → Submit
+		// 导航到 Submit（问题 tab 间用 →）
+		c.handleInput(RIGHT); // Q1 → Q2
+		c.handleInput(RIGHT); // Q2 → Q3
+		c.handleInput(RIGHT); // Q3 → Submit
 		// 确认当前在 Submit（渲染 Submit 视图）
 		let lines = c.render(80);
 		expect(lines.some((l) => l.includes("Ready") || l.includes("Unanswered"))).toBe(true);
-		// 在 Submit 上按 Left → 应回到最后一个问题 Q3
-		c.handleInput("\x1b[Z");
+		// 在 Submit 上按 ← → 应回到最后一个问题 Q3（←/→ 在所有 tab 上都是导航）
+		c.handleInput(LEFT);
 		lines = c.render(80);
 		// Q3 不再是 Submit 视图（无 Ready/Unanswered），且渲染了 Q3 的选项 M
 		expect(lines.some((l) => l.includes("Ready") || l.includes("Unanswered"))).toBe(false);
@@ -607,8 +684,8 @@ describe("AskUserComponent — confirm-checkmark, Esc-back, Tab browsing", () =>
 	it("C-E1: confirmed tab shows green ✓ marker", () => {
 		const { c } = make(multiQ);
 		c.handleInput(ENTER); // Q1 确认 → Q2
-		// 回到 Q1 看 tab 栏：Q1 已确认应有 ✓ 标识
-		c.handleInput("\x1b[Z"); // Q2 → Q1
+		// 回到 Q1 看 tab 栏：Q1 已确认应有 ✓ 标识（问题 tab 间用 ← 回退）
+		c.handleInput(LEFT); // Q2 → Q1
 		const lines = c.render(80);
 		expect(lines.some((l) => l.includes("✓") && l.includes("First"))).toBe(true);
 	});
@@ -642,29 +719,31 @@ describe("AskUserComponent — confirm-checkmark, Esc-back, Tab browsing", () =>
 		expect(c.render(80).some((l) => l.includes("Cancel all"))).toBe(false);
 	});
 
-	it("C-E5: Tab navigates to next tab; Shift+Tab to previous", () => {
+	it("C-E5: ←/→ navigates question tabs (→ next, ← previous)", () => {
 		const { c } = make(multiQ);
-		c.handleInput(TAB); // Q1 → Q2
+		c.handleInput(RIGHT); // Q1 → Q2
 		// 确认在 Q2：渲染含 Q2 的选项 X
 		expect(c.render(80).some((l) => l.includes("X"))).toBe(true);
-		// Shift+Tab（xterm 序列 ESC[Z）回退到 Q1
-		c.handleInput("\x1b[Z");
+		// ← 回退到 Q1
+		c.handleInput(LEFT);
 		expect(c.render(80).some((l) => l.includes("Q1") || l.includes("First"))).toBe(true);
 	});
 
-	it("C-E6: Tab wraps Submit → Q1, Shift+Tab wraps Q1 → Submit", () => {
+	it("C-E6: → at last question enters Submit; ← at first question stays (no wrap)", () => {
 		const { c } = make(multiQ);
 		// 到 Submit：Q1→Q2→Q3→Submit
 		c.handleInput(ENTER); // Q1→Q2
-		c.handleInput(TAB); // Q2→Q3
-		c.handleInput(TAB); // Q3→Submit
+		c.handleInput(RIGHT); // Q2→Q3
+		c.handleInput(RIGHT); // Q3→Submit
 		expect(c.render(80).some((l) => l.includes("Ready") || l.includes("Unanswered"))).toBe(true);
-		// Submit 上 Tab → 环绕到 Q1
-		c.handleInput(TAB);
+		// Submit 上 ← → 回退到 Q3（←/→ 在所有 tab 上都是导航）
+		c.handleInput(LEFT);
+		expect(c.render(80).some((l) => l.includes("M"))).toBe(true);
+		// Q1 上 ← 不环绕（停在首个问题）
+		c.handleInput(LEFT); // Q3→Q2
+		c.handleInput(LEFT); // Q2→Q1
+		c.handleInput(LEFT); // Q1 上 ← → 停留 Q1
 		expect(c.render(80).some((l) => l.includes("Q1") || l.includes("First"))).toBe(true);
-		// Q1 上 Shift+Tab → 环绕回 Submit
-		c.handleInput("\x1b[Z");
-		expect(c.render(80).some((l) => l.includes("Ready") || l.includes("Unanswered"))).toBe(true);
 	});
 });
 
@@ -704,39 +783,39 @@ describe("AskUserComponent — new behavior (post-refactor)", () => {
 		expect(result.val!.answers["Which features?"]).toBe("Auth, redis");
 	});
 
-	it("C-NEW-2: Left/Right on question tab do NOT switch tabs (only Tab/Shift+Tab do)", () => {
+	it("C-NEW-2: ←/→ on question tab switches tabs (→ next, ← previous; ← no wrap at first)", () => {
 		// multiQ: 3 questions → tabs 0,1,2,3=Submit
 		const { c } = make(multiQ);
 		c.render(80);
-		// 1) Q1 上按 Right → 应仍在 Q1（不切 tab）
+		// 1) Q1 上按 Right → 应切到 Q2
 		c.handleInput(RIGHT);
+		expect(c.render(80).some((l) => l.includes("Q2") || l.includes("Second"))).toBe(true);
+		// 2) Left 回到 Q1
+		c.handleInput(LEFT);
 		expect(c.render(80).some((l) => l.includes("Q1") || l.includes("First"))).toBe(true);
-		// 2) Left 也不切
+		// 3) Q1 上 Left 不环绕（仍停 Q1）
 		c.handleInput(LEFT);
 		expect(c.render(80).some((l) => l.includes("Q1") || l.includes("First"))).toBe(true);
-		// 3) Tab 仍然可以切到 Q2
-		c.handleInput(TAB);
-		expect(c.render(80).some((l) => l.includes("Q2") || l.includes("Second"))).toBe(true);
 	});
 
-	it("C-NEW-3: Submit tab Left/Right toggles submitTabFocus (Submit ↔ Cancel)", () => {
+	it("C-NEW-3: Submit tab Tab toggles submitTabFocus (Submit ↔ Cancel)", () => {
 		// multiQ: 3 questions → tabs 0,1,2,3=Submit
 		const { c } = make(multiQ);
-		// 导航到 Submit
-		c.handleInput(TAB); // Q1→Q2
-		c.handleInput(TAB); // Q2→Q3
-		c.handleInput(TAB); // Q3→Submit
+		// 导航到 Submit（问题 tab 间用 →）
+		c.handleInput(RIGHT); // Q1→Q2
+		c.handleInput(RIGHT); // Q2→Q3
+		c.handleInput(RIGHT); // Q3→Submit
 		// Submit tab 默认 focus=Submit。验证渲染中 Submit 高亮（accent）
 		let lines = c.render(80);
 		const focusedLineInitial = lines.find((l) => l.match(/[\[\(]\s*Submit\s*[\]\)]/));
 		expect(focusedLineInitial).toBeDefined();
-		// 按 Right → focus 切到 Cancel
-		c.handleInput(RIGHT);
+		// 按 Tab → focus 切到 Cancel（单键双向循环）
+		c.handleInput(TAB);
 		lines = c.render(80);
 		const focusedLineAfter = lines.find((l) => l.match(/[\[\(]\s*Cancel\s*[\]\)]/));
 		expect(focusedLineAfter).toBeDefined();
-		// 再按 Left → focus 回 Submit
-		c.handleInput(LEFT);
+		// 再按 Tab → focus 回 Submit
+		c.handleInput(TAB);
 		lines = c.render(80);
 		expect(lines.find((l) => l.match(/[\[\(]\s*Submit\s*[\]\)]/))).toBeDefined();
 	});
@@ -762,8 +841,8 @@ describe("AskUserComponent — new behavior (post-refactor)", () => {
 		c.handleInput(ENTER); // Q1 → Q2
 		c.handleInput(ENTER); // Q2 → Q3
 		c.handleInput(ENTER); // Q3 → Submit tab
-		// 切到 Submit 后，按 Right 把 focus 切到 Cancel
-		c.handleInput(RIGHT);
+		// 切到 Submit 后，按 Tab 把 focus 切到 Cancel
+		c.handleInput(TAB);
 		// Enter → 直接 cancel()（Submit tab 上无二次确认）
 		c.handleInput(ENTER);
 		expect(result.val).toBeNull();
@@ -774,9 +853,8 @@ describe("AskUserComponent — new behavior (post-refactor)", () => {
 		// 只答 Q1
 		c.handleInput(ENTER); // Q1 → Q2
 		// 切到 Submit（Q2 还未答）
-		c.handleInput(TAB); // Q2
-		c.handleInput(TAB); // Q3
-		c.handleInput(TAB); // Submit
+		c.handleInput(RIGHT); // Q2 → Q3
+		c.handleInput(RIGHT); // Q3 → Submit
 		// focus=Submit（默认），按 Enter → 不提交（Q2/Q3 未答）
 		c.handleInput(ENTER);
 		expect(result.val).toBeUndefined();

package/src/__tests__/question-view.test.ts

@@ -138,7 +138,7 @@ describe("renderQuestionView — split pane", () => {
 
 // ── Q-15 ~ Q-17: Other 编辑器模式 ───────────────────────
 describe("renderQuestionView — Other editor mode", () => {
-	it("Q-15: freeform mode renders Other row in-place with draft + cursor", () => {
+	it("Q-15: freeform mode renders Other row in-place with draft + cursor + number prefix", () => {
 		const lines = renderQuestionView(
 			singleQ,
 			makeState({ mode: "freeform", cursorIndex: 2 }),
@@ -153,6 +153,32 @@ describe("renderQuestionView — Other editor mode", () => {
 		expect(t).toContain("█");
 		// 不再独立 "Your answer" 提示行
 		expect(t).not.toContain("Your answer");
+		// 需求4：Other 在 freeform 态也有编号前缀（与其他选项一致）。
+		// singleQ 有 2 个选项 → Other 是第 3 项，lead 应含 "3. "
+		expect(t).toContain("3. ");
+	});
+
+	it("Q-15-NUM: multi-select freeform Other row shows [ ] + number prefix", () => {
+		// Auth(1), Search(2), Other(3)，多选 freeform 应渲染 "> [ ] 3. <input>█"
+		const multiQ: Question = {
+			question: "Which features?",
+			multiSelect: true,
+			options: [{ label: "Auth" }, { label: "Search" }],
+		};
+		const lines = renderQuestionView(
+			multiQ,
+			makeState({ mode: "freeform", cursorIndex: 2 }),
+			stubTheme,
+			60,
+			true,
+			"custom",
+		);
+		const t = text(lines);
+		// 多选 box [ ] + 编号 3. 都在编辑行上
+		expect(t).toContain("[ ]");
+		expect(t).toContain("3. ");
+		expect(t).toContain("custom");
+		expect(t).toContain("█");
 	});
 
 	it("Q-16: Other with saved free-text shows checkmark + preview", () => {
@@ -208,6 +234,31 @@ describe("renderQuestionView — Other editor mode", () => {
 		}
 	});
 
+	it("Q-28-WIDE: freeform 模式在宽终端下用全宽渲染（不被分屏左列压窄）", () => {
+		// 回归：freeform/comment 模式忽略分屏，编辑器用全 width。
+		// 修复前：宽终端走 split.left(≈40)，Other 输入被压在左半屏换行频繁。
+		const width = 100;
+		// getSplitPaneWidths(100) 非 null（宽终端会进分屏分支），但 freeform 应绕过它
+		expect(getSplitPaneWidths(width)).not.toBeNull();
+		// 单选 lead visLen=5 → avail = width - 5 = 95。用 60 字符（< 95）应单行装下。
+		// 修复前若用 split.left≈40，avail≈35 → 60 字符会换 2 行。
+		const input = "a".repeat(60);
+		const lines = renderQuestionView(
+			singleQ,
+			makeState({ mode: "freeform", cursorIndex: 2 }),
+			stubTheme,
+			width,
+			true,
+			input,
+		);
+		// 用 █ 定位编辑器行（help 行不含 █），排除 “submit” 含 a 的干扰
+		const editorLines = lines.filter((l) => l.includes("█"));
+		expect(editorLines.length).toBe(1);
+		// 全部 60 个 a 都在这一行（未被换行拆分）
+		const aCount = editorLines[0]!.split("").filter((c) => c === "a").length;
+		expect(aCount).toBe(60);
+	});
+
 	it("Q-29: freeform 输入超 5 行时截断到 5 行并加省略号", () => {
 		const width = 30;
 		// avail=24，200 字符 → 9 行，超过 5 行上限
@@ -220,11 +271,12 @@ describe("renderQuestionView — Other editor mode", () => {
 			true,
 			huge,
 		);
-		// 统计含 'y' 的行数 = input 渲染行数（应被截到 5 行）
-		const yLines = lines.filter((l) => l.includes("y"));
-		expect(yLines.length).toBe(5);
+		// 统计含输入内容的行数 = input 渲染行数（应被截到 5 行）
+		// 编号 "3. " 现在是 styled 内容的一部分，首行包裹段 "3." 不含 'y'
+		const inputLines = lines.filter((l) => l.includes("y") || l.includes("3."));
+		expect(inputLines.length).toBe(5);
 		// 最后一行带省略号（表示还有更多，光标已被省略号取代）
-		expect(yLines[yLines.length - 1]).toContain("…");
+		expect(inputLines[inputLines.length - 1]).toContain("…");
 	});
 
 	it("Q-30: 已保存 freeText 预览超屏宽时多行换行展示", () => {

package/src/component.ts

@@ -221,14 +221,15 @@ export class AskUserComponent implements Component {
 			return;
 		}
 
-		// Tab / Shift+Tab 切换 tab（多问题，options 模式）。←/→ 故意不切 tab——
-		// 把左右键留给 Submit tab 上的 Submit/Cancel 焦点切换，避免在问题列表上意外跳走。
-		if (!this.isSingle && matchesKey(data, "tab")) {
-			this.gotoTab((this.activeTab + 1) % this.totalTabs);
+		// ← / → 切换问题 tab（多问题，options 模式）：末尾 → 进入 Submit tab，
+		// 首个 ← 停在首个问题（不环绕）。Tab/Shift+Tab 不在问题 tab 切 tab——
+		// 留给 Submit tab 上的 Submit/Cancel 焦点切换。
+		if (!this.isSingle && matchesKey(data, "right")) {
+			this.gotoTab(Math.min(this.activeTab + 1, this.questions.length));
 			return;
 		}
-		if (!this.isSingle && matchesKey(data, "shift+tab")) {
-			this.gotoTab((this.activeTab - 1 + this.totalTabs) % this.totalTabs);
+		if (!this.isSingle && matchesKey(data, "left")) {
+			this.gotoTab(Math.max(this.activeTab - 1, 0));
 			return;
 		}
 
@@ -285,33 +286,33 @@ export class AskUserComponent implements Component {
 	}
 
 	/**
-	 * Submit tab 输入路由：
-	 * - ← / → → 切换 submitTabFocus（Submit ↔ Cancel 视觉高亮）
+	 * Submit tab 输入路由（键位语义与问题 tab 全局一致）：
+	 * - ← / → → tab 导航（← 回到最后一个问题；→ 环绕到首个问题）
+	 * - Tab → 在 Submit ↔ Cancel 间循环切焦点（单键双向，不依赖 shift+tab，
+	 *   规避 Pi 全局 app.thinking.cycle 对 shift+tab 的拦截）
 	 * - Enter → 触发当前 focus 项：Submit=allConfirmed 才提交；Cancel=直接取消
-	 * - Tab / → → 环绕到首个问题
-	 * - Esc / Shift+Tab → 回退到最后一个问题
-	 *
-	 * 注意：Submit tab 上 ←/→ 不再切回问题区（与问题 tab 上的"←/→ 不切 tab"对称，
-	 * 避免在 Submit 视图内意外跳走）。
+	 * - Esc → 回退到最后一个问题（与问题 tab 的 Esc-back 语义一致）
 	 */
 	private handleSubmitTabInput(data: string): void {
-		// ← / → 切换 focus（Submit ↔ Cancel）。Tab 单独处理（→ 行为）
-		if (matchesKey(data, "left") || matchesKey(data, "right")) {
-			this.submitTabFocus = this.submitTabFocus === "submit" ? "cancel" : "submit";
-			this.invalidate();
-			this.tui.requestRender();
+		// ← / → → tab 导航（与问题 tab 一致：方向键管 tab 间移动）
+		if (matchesKey(data, "left")) {
+			this.gotoTab(this.questions.length - 1);
+			return;
+		}
+		if (matchesKey(data, "right")) {
+			this.gotoTab(0);
 			return;
 		}
-		// Esc / Shift+Tab → 回退到最后一个问题
-		if (matchesKey(data, "escape") || matchesKey(data, "shift+tab")) {
+		// Esc → 回退到最后一个问题
+		if (matchesKey(data, "escape")) {
 			this.activeTab = this.questions.length - 1;
 			this.invalidate();
 			this.tui.requestRender();
 			return;
 		}
-		// Tab → 环绕到首个问题
+		// Tab → Submit ↔ Cancel 循环切焦点（单键双向）
 		if (matchesKey(data, "tab")) {
-			this.activeTab = 0;
+			this.submitTabFocus = this.submitTabFocus === "submit" ? "cancel" : "submit";
 			this.invalidate();
 			this.tui.requestRender();
 			return;
@@ -381,9 +382,21 @@ export class AskUserComponent implements Component {
 			this.tui.requestRender();
 			return;
 		}
-		// Printable char
-		if (data.length === 1 && data >= " ") {
-			this.editorText += data;
+		// Printable char(s) — handle both single keystrokes and multi-char paste.
+		// Terminals deliver pasted text as a single data chunk; iterating each char
+		// ensures the full paste is captured instead of silently dropping everything
+		// after the first character.
+		// for...of 按 code point 迭代：代理对（如 😀 U+1F600）作为一个 c（length===2）出现，
+		// 因此不能用 `c.length === 1` 守卫——那会把所有 BMP 之外的字符（emoji、部分 CJK 扩展）全过滤。
+		// 只保留 `c >= " "`（code point 比较），过滤控制字符（< 空格 U+0020）。
+		let changed = false;
+		for (const c of data) {
+			if (c >= " ") {
+				this.editorText += c;
+				changed = true;
+			}
+		}
+		if (changed) {
 			this.invalidate();
 			this.tui.requestRender();
 			return;

package/src/question-view.ts

@@ -107,12 +107,14 @@ function buildOptionLines(
 
 		if (isOther) {
 			if (state.mode === "freeform") {
-				// 原地编辑：与多选普通选项的 [ ] 框视觉对齐（单选无勾选语义则留空）
+				// 原地编辑：与普通选项的 [ ] 框视觉对齐（单选无勾选语义则留空）。
+				// lead = "> [ ] "，编号 + 输入文本跟在框后，内容起始列与普通选项一致。
 				const box = q.multiSelect ? t.fg("dim", "[ ]") : "  ";
+				const num = i + 1;
 				const lead = `${prefix} ${box} `;
 				const avail = Math.max(1, width - visibleWidth(lead));
-				// 文本 + 末尾光标 █ 整体软换行（空 input 时仅光标，wrapTextWithAnsi("█") 单行）
-				const styled = `${t.fg("text", editorText)}${t.fg("accent", "█")}`;
+				// 编号 + 文本 + 末尾光标 █ 整体软换行（空 input 时仅编号 + 光标，wrapTextWithAnsi 单行）
+				const styled = `${t.fg("muted", `${num}. `)}${t.fg("text", editorText)}${t.fg("accent", "█")}`;
 				addWrappedInput(add, lead, styled, avail, MAX_EDITOR_LINES);
 			} else {
 				const hasFreeText = state.freeTextValue !== null;
@@ -122,7 +124,7 @@ function buildOptionLines(
 				add(`${prefix} ${check} ${t.fg(labelColor, `${num}. ${opt.label}`)}`);
 				if (hasFreeText) {
 					// 已保存 freeText 预览：软换行展示，最多 MAX_EDITOR_LINES 行（不再单行截断）
-					const lead = "     "; // 5 列缩进，与上方 label 行对齐
+					const lead = "      "; // 6 列缩进，与上方 label 行对齐（prefix1 + sp1 + check1 + sp1 + num2 = 6）
 					const avail = Math.max(1, width - visibleWidth(lead));
 					const styled = t.fg("dim", `"${state.freeTextValue ?? ""}"`);
 					addWrappedInput(add, lead, styled, avail, MAX_EDITOR_LINES);
@@ -135,8 +137,8 @@ function buildOptionLines(
 			const num = i + 1;
 			add(`${prefix} ${box} ${t.fg(labelColor, `${num}. ${opt.label}`)}`);
 			if (opt.description && !hideDescriptions) {
-				const wrapped = wrapTextWithAnsi(t.fg("muted", opt.description), width - 7);
-				for (const line of wrapped) add(`       ${line}`);
+				const wrapped = wrapTextWithAnsi(t.fg("muted", opt.description), width - 10);
+				for (const line of wrapped) add(`          ${line}`);
 			}
 		} else {
 			const isConfirmed = state.selectedIndex === i;
@@ -145,8 +147,8 @@ function buildOptionLines(
 			const num = i + 1;
 			add(`${prefix} ${check} ${t.fg(labelColor, `${num}. ${opt.label}`)}`);
 			if (opt.description && !hideDescriptions) {
-				const wrapped = wrapTextWithAnsi(t.fg("muted", opt.description), width - 5);
-				for (const line of wrapped) add(`     ${line}`);
+				const wrapped = wrapTextWithAnsi(t.fg("muted", opt.description), width - 8);
+				for (const line of wrapped) add(`        ${line}`);
 			}
 		}
 	}
@@ -277,10 +279,12 @@ export function renderQuestionView(
 		divider();
 	}
 
-	// 编辑器/评论模式：选项列表 + 编辑器块（freeform 模式下编辑器块为空，由 buildOptionLines 原地渲染）
+	// 编辑器/评论模式：选项列表 + 编辑器块（freeform 模式下编辑器块为空，由 buildOptionLines 原地渲染）。
+	// 编辑器模式一律用全 width 单列渲染——分屏左列仅约 42% 宽，Other 自由输入会被压窄换行，
+	// 且右侧详情预览在输入自定义内容时无意义。隐藏 descriptions 以避免行数爆炸。
 	if (state.mode === "freeform" || state.mode === "comment") {
 		add("");
-		const optionLines = buildOptionLines(q, state, theme, split ? split.left : width, !!split, editorText);
+		const optionLines = buildOptionLines(q, state, theme, width, false, editorText);
 		for (const line of optionLines) add(line);
 		const editorBlock = buildEditorBlock(theme, width, state.mode, editorText);
 		lines.push(...editorBlock);
@@ -305,7 +309,7 @@ export function renderQuestionView(
 	// 帮助行（上下文相关）
 	const opts = allOptions(q);
 	const onOther = state.cursorIndex === opts.length - 1;
-	const tabHint = isSingle ? "" : " · Tab switch tabs";
+	const tabHint = isSingle ? "" : " · ←/→ switch tabs";
 	const actionHint = onOther
 		? "Enter open editor"
 		: q.multiSelect

package/src/submit-view.ts

@@ -35,8 +35,8 @@ export function getAnswerText(q: Question, s: QuestionState): string | null {
 
 /**
  * 渲染 Submit tab 视图。
- * focus: 当前在 [Submit]/[Cancel] 上的焦点（←/→ 切换）。
- *   渲染内嵌按钮栏高亮 focus；help 行更新为 "←/→ toggle · Enter confirm"。
+ * focus: 当前在 [Submit]/[Cancel] 上的焦点（Tab 切换）。
+ *   渲染内嵌按钮栏高亮 focus；help 行更新为 "←/→ navigate · Tab toggle · Enter confirm"。
  */
 export function renderSubmitView(
 	questions: Question[],
@@ -94,7 +94,7 @@ export function renderSubmitView(
 
 	// Submit tab 帮助行
 	add("");
-	add(t.fg("dim", " ←/→ toggle · Enter confirm · Tab back to first question"));
+	add(t.fg("dim", " ←/→ navigate · Tab toggle Submit/Cancel · Enter confirm · Esc back"));
 
 	return lines;
 }