@zhushanwen/pi-ask-user 0.0.1 → 0.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-ask-user",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "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();
 	});
@@ -513,9 +513,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 +538,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 +607,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 +642,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 +706,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 +764,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 +776,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 行上限

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;
 		}
-		// Esc / Shift+Tab → 回退到最后一个问题
-		if (matchesKey(data, "escape") || matchesKey(data, "shift+tab")) {
+		if (matchesKey(data, "right")) {
+			this.gotoTab(0);
+			return;
+		}
+		// 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;

package/src/question-view.ts

@@ -107,9 +107,11 @@ function buildOptionLines(
 
 		if (isOther) {
 			if (state.mode === "freeform") {
-				// 原地编辑：与多选普通选项的 [ ] 框视觉对齐（单选无勾选语义则留空）
+				// 原地编辑：与普通选项的 [ ] 框 + 编号视觉对齐（单选无勾选语义则留空）。
+				// lead = "> [ ] N. "，输入文本跟在编号后，与其他选项整体一致。
 				const box = q.multiSelect ? t.fg("dim", "[ ]") : "  ";
-				const lead = `${prefix} ${box} `;
+				const num = i + 1;
+				const lead = `${prefix} ${box} ${t.fg("muted", `${num}. `)}`;
 				const avail = Math.max(1, width - visibleWidth(lead));
 				// 文本 + 末尾光标 █ 整体软换行（空 input 时仅光标，wrapTextWithAnsi("█") 单行）
 				const styled = `${t.fg("text", editorText)}${t.fg("accent", "█")}`;
@@ -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;
 }