@ghyper9023/pi-dev-workflow 0.4.2 → 0.4.3

package/.pi-dev-output/pi-grill/answers/answer-mpfttme1-20260522-0230.md

@@ -0,0 +1,13 @@
+[fix] 修复 当前目录 中的 问题： 1.gitcommit哈希dc0d3fa9d2362f4fb5026378e472510902dacd8e的修改，增加的grill换行修复，现在是(a)左边简短被阶段黑色字体提问   右边灰色字体提问内容，没截断，但也没换行 2.grill拦截左方向键返回上一题功能正常，但是他破坏了那种grill提问自定义输入式的和dev-*输入式的左方向键，输入式的左方向键应该是光标向左，而现在是返回上一题了,原来的ctrl+shift+左是正常的且考虑了避开输入式的左方向键应该是光标向左的冲突
+
+**背景**：
+- 输入：见代码上下文
+- 预期行为：修复： 1.grll提问选项正确实现换行。 2.输入式的ui不能监听向左键，我的建议是grill提问环节的向左返回，统一改成和输入式一样的`ctrl+shift+左`来返回。
+- 当前错误：请描述当前错误
+**任务**：
+1. 不要仅仅消除报错（Suppress），要解决根本原因。
+2. 先读取相关代码和日志，诊断根因（多步推理，不要先给结论）。
+3. 提供至少一种修复方案，并说明为什么这样做。
+4. 编写测试用例复现该 Bug 并确认修复有效。
+**输出**：提供 diff 和两句话的根因分析。
+**约束**：只修 bug，不做重构；最小化改动；不要假设错误是微不足道的。

package/.pi-dev-output/pi-plans/20260522-113000-grill-left-arrow-fix.md

@@ -0,0 +1,274 @@
+# Grill 左方向键冲突与选项描述显示修复 — 实施计划
+
+## 概述
+
+修复 `dc0d3fa9` 提交引入的两个回归问题：
+
+1. **左方向键破坏 Input 光标左移**：`uiInput` 中将裸 `←` 拦截为"返回"，导致所有 `backable=true` 的输入场景中，左方向键的"光标左移"功能完全失效。
+2. **Grill 选项截断+description 显示混乱**：选项 label 被截断后，完整文本放入 `description` 字段，但 SelectList 的 description 列不换行，导致用户看到"左边简短被截断 + 右边灰色不换行"的混乱显示。
+
+**用户明确要求**：grill 提问环节的向左返回统一改为 `Ctrl+Shift+←`（与输入式一致），输入式的左方向键恢复为光标左移。
+
+## 根因分析
+
+### Bug 1：左方向键冲突
+
+**问题位置**：`extensions/ui-helpers.ts` 第 263-266 行
+
+`dc0d3fa9` 提交在 `uiInput.handleInput` 中添加了：
+
+```typescript
+// 左方向键 → 返回（优先于 Input 的光标左移）
+if (backable && matchesKey(data, Key.left)) {
+    done(BACK_MARKER);
+    return;
+}
+```
+
+这段拦截在 `input.handleInput(data)` 之前执行，Input 组件永远不会收到左方向键事件，导致：
+- Input 内部的 `tui.editor.cursorLeft` 绑定（左方向键）永远不会被触发
+- 用户无法在输入框中左移光标
+- 影响范围：所有 `backable=true` 的 uiInput 调用（grill 自定义输入、dev-* wizard 输入等）
+
+同时，`extensions/grill-me-agent.ts` 第 671-674 行的 `showQuestionTUI.handleInput` 也拦截了左方向键：
+
+```typescript
+// 左方向键 → 返回上一题
+if (backable && currentIndex > 1 && matchesKey(data, Key.left)) {
+    done("__BACK__");
+    return;
+}
+```
+
+两处拦截叠加，用户按 `←` 时：
+- 在 SelectList 中 → 返回上一题（正确，因为 SelectList 不处理 left 键）
+- 在 Input 中 → 返回上一题（错误，期望光标左移）
+
+### Bug 2：选项截断+description 显示混乱
+
+**问题位置**：`extensions/grill-me-agent.ts` 第 602-618 行
+
+```typescript
+const MAX_OPTION_LABEL = 50;
+const truncated = truncateToWidth(label, MAX_OPTION_LABEL, "...");
+return {
+    value: `opt-${i}`,
+    label: truncated,
+    description: truncated !== label ? opt : undefined,
+};
+```
+
+SelectList 的渲染流程：
+1. `renderItem` 对 `label` 使用 `truncateToWidth` 到主列宽度（截断为 50 字符 + "..."）
+2. 如果 `description` 存在，使用两列布局，description 列也被 `truncateToWidth` 到剩余宽度
+
+当终端宽度不足以显示完整的 description 文本时，description 列也会被截断且**不换行**，产生用户看到的"左边截断 + 右边灰色不换行"效果。
+
+## 修复方案
+
+### 方案（根据用户建议）
+
+**核心思路**：统一使用 `Ctrl+Shift+←` 作为返回键，恢复裸 `←` 的光标左移功能。
+
+**详细改动**：
+
+| 位置 | 当前行为（`dc0d3fa9`） | 修复后行为 |
+|------|----------------------|-----------|
+| `grill-me-agent.ts` handleInput | 裸 `←` 拦截为返回 | `Ctrl+Shift+←` 拦截为返回 |
+| `ui-helpers.ts` uiInput handleInput | 裸 `←` 拦截为返回（破坏光标左移） | 移除裸 `←` 拦截 |
+| `ui-helpers.ts` uiInput handleInput | `Ctrl+Shift+←` 返回（保留） | 保留 `Ctrl+Shift+←` |
+| 选项列表（SelectList） | 用户按 `←` → 返回上一题 | 用户按 `Ctrl+Shift+←` → 返回上一题 |
+| 输入框（Input） | 用户按 `←` → 返回上一题 ❌ | 用户按 `←` → 光标左移 ✅ |
+| 输入框（Input） | 用户按 `Ctrl+Shift+←` → 返回上一题 | 保留 |
+
+**Bug 2 修复**：直接移除截断+description 方案，恢复完整 label 显示。
+
+## 文件清单
+
+### 修改文件
+
+| 文件路径 | 改动描述 | 风险等级 |
+|---------|---------|---------|
+| `extensions/ui-helpers.ts` | `uiInput.handleInput` 中移除裸 `←` 拦截（第 263-266 行）；更新 JSDoc 注释 | 低 |
+| `extensions/grill-me-agent.ts` | 1. `showQuestionTUI.handleInput` 中 `Key.left` → `Key.ctrlShift("left")` 2. 更新 hint 文案 3. 移除选项截断+description 方案，恢复完整 label | 低 |
+
+### 无新增/删除文件
+
+## 实施步骤
+
+### 步骤 1：修复 `ui-helpers.ts` — 移除 uiInput 中的裸 ← 拦截
+
+- **前置条件**：无
+- **改动文件**：`extensions/ui-helpers.ts`
+- **改动内容**：
+
+**a) 删除裸 ← 拦截（约第 263-266 行）**
+
+删除以下代码块：
+
+```typescript
+// 左方向键 → 返回（优先于 Input 的光标左移）
+if (backable && matchesKey(data, Key.left)) {
+    done(BACK_MARKER);
+    return;
+}
+```
+
+保留 `Ctrl+Shift+←` 和 `Ctrl+Shift+→` 拦截不受影响。
+
+**b) 更新 JSDoc 注释（约第 220 行）**
+
+将：
+
+```
+ * When backable=true, supports ← for back, Ctrl+Shift+← for back, and Ctrl+Shift+→ for submit+next.
+```
+
+改为：
+
+```
+ * When backable=true, supports Ctrl+Shift+← for back and Ctrl+Shift+→ for submit+next.
+```
+
+- **验证方式**：
+  - 运行 `/dev-feat` → 进入"核心功能描述"输入框 → 按 `←` → 确认光标左移
+  - 按 `Ctrl+Shift+←` → 确认返回上一题
+  - 按 `Ctrl+Shift+→` → 确认跳过并继续
+
+### 步骤 2：修复 `grill-me-agent.ts` — 选项列表 ← 改为 Ctrl+Shift+←
+
+- **前置条件**：步骤 1 完成
+- **改动文件**：`extensions/grill-me-agent.ts`
+- **改动内容**：
+
+**a) 修改 handleInput 中的左方向键拦截（约第 671-674 行）**
+
+当前：
+
+```typescript
+// 左方向键 → 返回上一题（SelectList 不处理 left 键，需自行拦截）
+if (backable && currentIndex > 1 && matchesKey(data, Key.left)) {
+    done("__BACK__");
+    return;
+}
+```
+
+改为：
+
+```typescript
+// Ctrl+Shift+← → 返回上一题（SelectList 不处理该键，需自行拦截）
+if (backable && currentIndex > 1 && matchesKey(data, Key.ctrlShift("left"))) {
+    done("__BACK__");
+    return;
+}
+```
+
+**b) 修改 hint 提示文字（约第 660 行）**
+
+当前：
+
+```typescript
+const hint = backable && currentIndex > 1
+    ? "  ↑↓ 导航 • Enter 选择 • ← 返回上一题 • Esc 取消全部评审"
+    : "  ↑↓ 导航 • Enter 选择 • Esc 取消全部评审";
+```
+
+改为：
+
+```typescript
+const hint = backable && currentIndex > 1
+    ? "  ↑↓ 导航 • Enter 选择 • Ctrl+Shift+← 返回上一题 • Esc 取消全部评审"
+    : "  ↑↓ 导航 • Enter 选择 • Esc 取消全部评审";
+```
+
+- **验证方式**：
+  - 运行 `/dev-fix` → 进入 grill 评审
+  - 在第二个问题按 `←` → 确认**无反应**（正确，SelectList 不处理 left 键）
+  - 按 `Ctrl+Shift+←` → 确认返回到第一个问题
+  - 确认第一个问题选择的答案被保留
+
+### 步骤 3：修复 `grill-me-agent.ts` — 移除选项截断+description 方案
+
+- **前置条件**：步骤 2 完成
+- **改动文件**：`extensions/grill-me-agent.ts`
+- **改动内容**：
+
+**a) 修改选项构建逻辑（约第 602-618 行）**
+
+当前代码（`dc0d3fa9` 引入）：
+
+```typescript
+const MAX_OPTION_LABEL = 50;
+const selectItems: SelectItem[] = q.options.map((opt, i) => {
+    const prefix = `(${String.fromCharCode(97 + i)}) `;
+    const label = opt === previousAnswer
+        ? `${prefix}${opt} - 上次选择`
+        : `${prefix}${opt}`;
+    const truncated = truncateToWidth(label, MAX_OPTION_LABEL, "...");
+    return {
+        value: `opt-${i}`,
+        label: truncated,
+        description: truncated !== label ? opt : undefined,
+    };
+});
+```
+
+恢复为（还原到 `dc0d3fa9` 之前的状态）：
+
+```typescript
+const selectItems: SelectItem[] = q.options.map((opt, i) => ({
+    value: `opt-${i}`,
+    label: opt === previousAnswer
+        ? `(${String.fromCharCode(97 + i)}) ${opt} - 上次选择`
+        : `(${String.fromCharCode(97 + i)}) ${opt}`,
+}));
+```
+
+**b) 清理不再需要的 import（文件顶部约第 21-27 行）**
+
+如果 `truncateToWidth` 在文件其他地方没有使用（经 grep 检查仅在步骤 3a 处使用），则删除 import 中的 `truncateToWidth`：
+
+```typescript
+// 删除: truncateToWidth,
+import {
+    Container,
+    SelectList,
+    Text,
+    Spacer,
+    matchesKey,
+    Key,
+    type SelectItem,
+} from "@earendil-works/pi-tui";
+```
+
+- **验证方式**：
+  - 查看 grill 问题的选项 → 确认显示完整标签文本（而不是截断+description 两列显示）
+  - 当选项文本超宽时，SelectList 会自动截断到可用宽度（这是 SelectList 的内部行为，不需要手动干预）
+
+## 依赖关系
+
+- 步骤 1 和步骤 2、3 无直接依赖，但建议按顺序 1→2→3 执行，以保证逻辑一致性
+- 步骤 3 中需先确认 `truncateToWidth` 是否在其他地方使用，再决定是否清理 import
+
+## 测试策略
+
+手动测试清单：
+
+| 测试场景 | 操作 | 预期结果 |
+|---------|------|---------|
+| 输入框左方向键 | 在 dev-* 输入框中按 `←` | 光标左移 ✅（修复点） |
+| 输入框 Ctrl+Shift+← | 在 dev-* 输入框中按 `Ctrl+Shift+←` | 返回上一题 ✅ |
+| 输入框 Ctrl+Shift+→ | 在 dev-* 输入框中按 `Ctrl+Shift+→` | 跳过并继续 ✅ |
+| Grill 选项列表 ← | 在 grill 第二题按 `←` | 无反应（SelectList 不处理 left 键）✅ |
+| Grill 选项列表 Ctrl+Shift+← | 在 grill 第二题按 `Ctrl+Shift+←` | 返回上一题 ✅（修复点） |
+| Grill 自定义输入 ← | 进入自定义输入框按 `←` | 光标左移 ✅（修复点） |
+| Grill 自定义输入 Ctrl+Shift+← | 在自定义输入框按 `Ctrl+Shift+←` | 返回选项列表 ✅ |
+| Grill 选项完整显示 | 查看长选项文本 | 完整 label 显示 ✅（修复点） |
+| 原有功能 | ↑↓ Enter Esc | 正常导航/选择/取消 ✅ |
+
+## 注意事项
+
+- **最小改动**：仅修改 2 个文件中涉及的 4 个代码位置，总计约 10-15 行
+- **不修改 pi-tui 库**：所有改动在 extensions/ 目录内完成
+- **兼容性**：原有的 `Ctrl+Shift+←` 和 `Ctrl+Shift+→` 功能完全保留，新增的选项列表 `Ctrl+Shift+←` 与输入框保持一致的按键语义
+- **SelectList 的 `← 返回上一题` 选项**：注意 `showQuestionTUI` 中还有一个 `"← 返回上一题"` 的 `SelectItem`（第 637 行），这是通过选择选项来返回，而非通过按键。此功能应保留，因为用户也可以通过 ↑↓ 导航到该选项后按 Enter 返回。但需要确认它与 `Key.left` 拦截的分离——按键拦截在 handleInput 中，选项选择在 SelectList 的 onSelect 回调中，两者互不干扰。保留该选项作为额外导航方式。

package/.pi-dev-output/pi-review/md/review-20260522-105000.md

@@ -0,0 +1,166 @@
+# 代码审查报告 — Grill 左方向键冲突与选项显示修复
+
+**审查日期**: 2026-05-22 10:50  
+**审查范围**: `dc0d3fa9` 提交引入的两个回归问题的修复方案实现  
+**审查文件**: `extensions/grill-me-agent.ts`, `extensions/ui-helpers.ts`
+
+---
+
+## 审查概述
+
+对 `dc0d3fa9` 提交引入的两个 bug 的修复实现进行审查。当前工作树已部分实施修复方案，但仍存在若干问题。
+
+---
+
+## 严重问题 (Critical)
+
+### CRITICAL-1: `extensions/ui-helpers.ts` 末尾截断，文件损坏
+
+**文件**: `extensions/ui-helpers.ts:849-850`  
+**问题**: 文件末尾被截断，`renderTreeNode` 函数的 `lines.push(...)` 语句不完整：
+
+```typescript
+function renderTreeNode(node: TreeNode, prefix: string, isLast: boolean, lines: string[]): void {
+    const connector = isLast ? "└── " : "├── ";
+    lines.push(`${prefix}${connector}
+```
+
+缺少闭合反引号、分号和函数体的花括号。这导致：
+- `renderTreeNode` 函数不完整
+- `renderChildren` 函数完全丢失
+- `buildTree` 调用、`extractFileChanges` 函数的返回语句全部丢失
+- `sendWorkflowResult` 和 `buildWidgetState` 函数完全丢失
+
+**影响**: 任何使用 `updateWorkflowWidget`（以及间接使用 `sendWorkflowResult`）的代码在运行时可能因为文件末尾语法错误导致模块加载失败。这是**破坏性**的。
+
+**根因**: 前一次修改（非本次 `dc0d3fa9` 相关修改）中文件被截断。这是**独立于本次修复任务**的预存问题，但严重程度高，需要立即修复。
+
+**建议修复**: 从 Git 恢复完整版本（`git checkout dc0d3fa9^ -- extensions/ui-helpers.ts`）然后将本次需要的更改应用回去。
+
+---
+
+## 中等问题 (Medium)
+
+### MEDIUM-1: 初始值未触发预览更新
+
+**文件**: `extensions/ui-helpers.ts:237-239`  
+**问题**: 当 `uiInput` 接收 `initialValue` 时，`input.setValue(initialValue)` 被调用，但预览区域 (`previewText`) 未被更新。用户看到输入框中有初始值，但上方的预览区域为空，直到用户输入第一个字符后预览区域才更新。
+
+```typescript
+const input = new Input(placeholder ?? "", width - 2);
+if (initialValue) {
+    input.setValue(initialValue);  // ← previewText 未同步更新
+}
+```
+
+**影响**: 当 grill 自定义输入有初始值（`previousAnswer`）时，预览区域初始为空白，造成视觉不一致。
+
+**建议修复**: 在 `setValue` 调用后立即同步更新 `previewText`：
+
+```typescript
+if (initialValue) {
+    input.setValue(initialValue);
+    // 同步更新预览
+    const wrapped = wrapTextWithAnsi(initialValue, width - 4);
+    const previewContent = wrapped
+        .map(l => theme.fg("dim", `  ${l}`))
+        .join("\n");
+    previewText.setText(previewContent);
+}
+```
+
+### MEDIUM-2: 实时预览的宽度计算可能不准确
+
+**文件**: `extensions/ui-helpers.ts:281`  
+**问题**: 预览区域的 `wrapTextWithAnsi` 调用使用的宽度为 `width - 4`，但实际预览文本是渲染在 `  ${l}`（2 个空格缩进）下方的，且预览 Text 组件本身不会被容器约束宽度。这意味着当终端宽度变化时，预览可能不会正确地根据可用宽度换行。
+
+```typescript
+const wrapped = wrapTextWithAnsi(val, width - 4);
+```
+
+实际上 `width` 已经是 `process.stdout.columns - 6`（第 223 行），减去 6 后再减 4，实际有效宽度为 `termWidth - 10`，而容器中预览区域的实际可用宽度是 `width`（`termWidth - 6`）左右（考虑边框）。宽度计算存在偏差，可能导致预览内容过早换行。
+
+**影响**: 预览显示可能与实际输入框中的换行效果不一致，但影响较小（预览仅用于视觉辅助）。
+
+**建议修复**: 更新宽度为 `width - 2`（与输入框宽度一致）：
+
+```typescript
+const wrapped = wrapTextWithAnsi(val, width - 2);  // 与 input 宽度一致
+```
+
+### MEDIUM-3: `description` 属性从 `__custom__` 选项中被移除
+
+**文件**: `extensions/grill-me-agent.ts:616`  
+**问题**: `dc0d3fa9` 提交为自定义输入选项添加了 `description: "输入你自己的回答，不受选项限制"`，这在修复时被移除了。虽然这不影响功能，但该 description 提供了重要的用户引导信息，说明自定义输入选项的用途。
+
+```typescript
+// dc0d3fa9 版本：
+{ value: "__custom__", label: customLabel, description: "输入你自己的回答，不受选项限制" }
+
+// 当前版本：
+{ value: "__custom__", label: customLabel }  // description 被移除
+```
+
+**影响**: 用户可能在选择列表中看不到自定义输入选项的说明，降低可用性（尤其是首次使用 grill 的用户）。
+
+**建议修复**: 恢复 description：
+
+```typescript
+selectItems.push({
+    value: "__custom__",
+    label: customLabel,
+    description: "输入你自己的回答，不受选项限制",
+});
+```
+
+---
+
+## 低优先级问题 (Low)
+
+### LOW-1: `truncateToWidth` import 清理不完整
+
+**文件**: `extensions/grill-me-agent.ts`  
+**问题**: `truncateToWidth` 已从 `@earendil-works/pi-tui` 的 import 中移除。但实现计划中提到的检查对 `truncateToWidth` 在文件其他位置的使用情况已确认不存在交叉引用——清理操作正确。无问题。
+
+✅ 此项已正确处理。
+
+### LOW-2: JSDoc 注释已更新但可进一步改进
+
+**文件**: `extensions/ui-helpers.ts:210`  
+**问题**: JSDoc 注释已正确更新为：
+
+```typescript
+ * When backable=true, supports Ctrl+Shift+← for back and Ctrl+Shift+→ for submit+next.
+```
+
+✅ 已正确修复。
+
+### LOW-3: 提示文案同步正确
+
+**文件**: `extensions/grill-me-agent.ts:649-652`  
+**问题**: hint 文案已从 `← 返回上一题` 更新为 `Ctrl+Shift+← 返回上一题`。
+
+✅ 已正确修复。
+
+---
+
+## 修复验证矩阵
+
+| 测试场景 | 预期 | 当前状态 | 结论 |
+|---------|------|---------|------|
+| 输入框按 `←` | 光标左移 | `ui-helpers.ts` 中裸 `←` 拦截已移除 | ✅ |
+| 输入框按 `Ctrl+Shift+←` | 返回上一题 | `Key.ctrlShift("left")` 拦截保留 | ✅ |
+| 输入框按 `Ctrl+Shift+→` | 提交并继续 | 保留 | ✅ |
+| Grill 选项列表按 `←` | 无反应（光标/导航不处理） | `grill-me-agent.ts` 已改为 `Key.ctrlShift("left")` | ✅ |
+| Grill 选项列表按 `Ctrl+Shift+←` | 返回上一题 | 正确拦截 | ✅ |
+| Grill 自定义输入按 `←` | 光标左移 | 依赖 `uiInput` 的裸 `←` 移除 | ✅ |
+| 选项显示 | 完整 label，无截断+description | 截断逻辑已移除 | ✅ |
+| 初始值预览 | 显示初始值预览 | **缺失** ❌ | MEDIUM-1 |
+
+---
+
+## 总结
+
+**主要问题**: `extensions/ui-helpers.ts` 文件末端被截断损坏（CRITICAL-1），这是需要立即解决的独立于本次任务的预存问题。其余与 `dc0d3fa9` 修复直接相关的问题均为 medium 级别，修复方案本身是正确的。
+
+修复方案的三项核心改动（移除 uiInput 中的裸 ← 拦截、将 grill 选项列表的 ← 改为 Ctrl+Shift+←、移除选项截断+description）均已正确实现。`truncateToWidth` 的 import 清理也正确完成（该函数仍在 `boxify` 中使用）。

package/.pi-dev-output/pi-workflow/checkpoint-20260522-113000-grill-left-arrow-fix.json

@@ -0,0 +1,473 @@
+{
+  "version": 2,
+  "createdAt": "2026-05-21T18:41:14.437Z",
+  "updatedAt": "2026-05-21T18:41:14.437Z",
+  "prompt": "[fix] 修复 当前目录 中的 问题： 1.gitcommit哈希dc0d3fa9d2362f4fb5026378e472510902dacd8e的修改，增加的grill换行修复，现在是(a)左边简短被阶段黑色字体提问   右边灰色字体提问内容，没截断，但也没换行 2.grill拦截左方向键返回上一题功能正常，但是他破坏了那种grill提问自定义输入式的和dev-*输入式的左方向键，输入式的左方向键应该是光标向左，而现在是返回上一题了,原来的ctrl+shift+左是正常的且考虑了避开输入式的左方向键应该是光标向左的冲突\n\n**背景**：\n- 输入：见代码上下文\n- 预期行为：修复： 1.grll提问选项正确实现换行。 2.输入式的ui不能监听向左键，我的建议是grill提问环节的向左返回，统一改成和输入式一样的`ctrl+shift+左`来返回。\n- 当前错误：请描述当前错误\n**任务**：\n1. 不要仅仅消除报错（Suppress），要解决根本原因。\n2. 先读取相关代码和日志，诊断根因（多步推理，不要先给结论）。\n3. 提供至少一种修复方案，并说明为什么这样做。\n4. 编写测试用例复现该 Bug 并确认修复有效。\n**输出**：提供 diff 和两句话的根因分析。\n**约束**：只修 bug，不做重构；最小化改动；不要假设错误是微不足道的。",
+  "mode": "full-auto",
+  "steps": [
+    {
+      "status": "done",
+      "durationMs": 119262
+    },
+    {
+      "status": "done",
+      "loopCount": 1,
+      "durationMs": 244192
+    },
+    {
+      "status": "done",
+      "durationMs": 257239
+    }
+  ],
+  "currentStepIndex": 2,
+  "loopCounts": {
+    "worker-reviewer": 1
+  },
+  "planFilePath": ".pi-dev-output/pi-plans/20260522-113000-grill-left-arrow-fix.md",
+  "taskSummary": "fix - 修复 当前目录 中的 问题： 1.gitcommit哈希dc0d3fa9d2362f4fb5026378e472510902dacd8e的修改，增加的grill换行修复，现在是(a)左边简短被阶段黑色字体提问   右边灰色字体提问内容，没截断，但也没换行 2.grill拦截左方向键返回上一题功能正常，但是他破坏了那种grill提问自定义输入式的和dev-*输入式的左方向键，输入式的左方向键应该是光标向左，而现在是返回上一题了,原来的ctrl+shift+左是正常的且考虑了避开输入式的左方向键应该是光标向左的冲突",
+  "workflowType": "快速链式",
+  "fileChanges": [
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "ui-helpers.ts",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "tui.editor.cursorLeft",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "extensions/grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "showQuestionTUI.handleInput",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "extensions/ui-helpers.ts",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "uiInput.handleInput",
+      "timestamp": "2026-05-21T18:32:52.982Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "tui.editor.cursorWordLeft",
+      "timestamp": "2026-05-21T18:32:52.983Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "edit",
+      "filePath": "!this.text",
+      "timestamp": "2026-05-21T18:32:52.983Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "new",
+      "filePath": ".pi-dev-output/pi-plans/20260522-113000-grill-left-arrow-fix.md",
+      "timestamp": "2026-05-21T18:32:53.003Z"
+    },
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "type": "new",
+      "filePath": ".pi-dev-output/pi-workflow/checkpoint.json",
+      "timestamp": "2026-05-21T18:32:53.004Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "src/main.rs\\\\\\\",",
+      "timestamp": "2026-05-21T18:33:23.077Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "new",
+      "filePath": "代码xxx.ts\\n",
+      "timestamp": "2026-05-21T18:33:31.217Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "代码xxx.rs\\n",
+      "timestamp": "2026-05-21T18:33:31.231Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "config.json\\\")",
+      "timestamp": "2026-05-21T18:33:33.257Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "src/main.rs\\\",",
+      "timestamp": "2026-05-21T18:33:33.261Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "new",
+      "filePath": "/delete:",
+      "timestamp": "2026-05-21T18:33:38.655Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "delete",
+      "filePath": "\\\\\\\\s*(.+)/i);\\\\n",
+      "timestamp": "2026-05-21T18:33:40.847Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "new",
+      "filePath": "\\\\\\\\s*(.+)/i);\\\\n",
+      "timestamp": "2026-05-21T18:33:40.898Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "path\\\\\\\",",
+      "timestamp": "2026-05-21T18:33:40.925Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "new",
+      "filePath": "path\\\\\\\",",
+      "timestamp": "2026-05-21T18:33:41.017Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "/new:/delete:",
+      "timestamp": "2026-05-21T18:33:41.233Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "\\\\\\\\s*(.+)/i);\\\\n",
+      "timestamp": "2026-05-21T18:33:41.685Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "delete",
+      "filePath": "path\\\\\\\"\\\\n",
+      "timestamp": "2026-05-21T18:33:41.711Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "delete",
+      "filePath": "path\\\\\\\")\\\\n",
+      "timestamp": "2026-05-21T18:33:41.794Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "new",
+      "filePath": "代码xxx.ts\\\\n",
+      "timestamp": "2026-05-21T18:33:42.360Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "/new:/delet",
+      "timestamp": "2026-05-21T18:33:42.609Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "/new:/delete",
+      "timestamp": "2026-05-21T18:33:42.611Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "/new:/del",
+      "timestamp": "2026-05-21T18:33:42.613Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "extensions/ui-helpers.ts",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "uiInput.handleInput",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "tui.editor.cursorLeft",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "extensions/grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "showQuestionTUI.handleInput",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "ui-helpers.ts",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "Key.left",
+      "timestamp": "2026-05-21T18:34:54.850Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "extensions/ui-helpers.ts",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "uiInput.handleInput",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "tui.editor.cursorLeft",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "extensions/grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "showQuestionTUI.handleInput",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "ui-helpers.ts",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "edit",
+      "filePath": "Key.left",
+      "timestamp": "2026-05-21T18:36:57.169Z"
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "type": "new",
+      "filePath": ".pi-dev-output/pi-review/md/review-20260522-105000.md",
+      "timestamp": "2026-05-21T18:36:57.193Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "extensions/ui-helpers.ts",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "uiInput.handleInput",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "tui.editor.cursorLeft",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "extensions/grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "showQuestionTUI.handleInput",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "grill-me-agent.ts",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "ui-helpers.ts",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "Key.left",
+      "timestamp": "2026-05-21T18:41:14.410Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "tui.editor.cursorWordLeft",
+      "timestamp": "2026-05-21T18:41:14.411Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "!this.text",
+      "timestamp": "2026-05-21T18:41:14.411Z"
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "type": "edit",
+      "filePath": "README.md",
+      "timestamp": "2026-05-21T18:41:14.431Z"
+    }
+  ],
+  "subAgentRuns": 4,
+  "filesModified": 46,
+  "filesCreated": 8,
+  "agentRunHistory": [
+    {
+      "agent": "planner",
+      "stepIndex": 0,
+      "startedAt": "2026-05-21T18:30:53.742Z",
+      "durationMs": 119236,
+      "exitCode": 0,
+      "toolCount": 0
+    },
+    {
+      "agent": "worker",
+      "stepIndex": 1,
+      "startedAt": "2026-05-21T18:32:53.005Z",
+      "durationMs": 121842,
+      "exitCode": 0,
+      "toolCount": 192
+    },
+    {
+      "agent": "reviewer",
+      "stepIndex": 1,
+      "startedAt": "2026-05-21T18:34:54.873Z",
+      "durationMs": 122293,
+      "exitCode": 0,
+      "toolCount": 200
+    },
+    {
+      "agent": "docWriter",
+      "stepIndex": 2,
+      "startedAt": "2026-05-21T18:36:57.198Z",
+      "durationMs": 257209,
+      "exitCode": 0,
+      "toolCount": 209
+    }
+  ],
+  "baseline": [
+    {
+      "path": ".pi-dev-output/pi-grill/answers/answer-mpfttme1-20260522-0230.md",
+      "hash": "4c3eeca3d8d77d1da40cf2ce9abd13e29fe21d70"
+    }
+  ]
+}

package/.version/RELEASE-v0.4.2.md

@@ -0,0 +1,31 @@
+# Release v0.4.2
+
+## 🚀 Features
+
+- **Esc 双击确认停止机制** — 工作流运行期间，首次按 Esc 提示再次确认，3 秒内双击才终止工作流，避免误触中断
+- **Grill 交互增强**
+  - 选项标签超长时自动截断，完整文本显示在 description 中
+  - 输入框上方增加实时换行预览区域
+  - 左方向键支持返回上一题
+  - 优化导航提示文字
+- **独立超时配置** — reviewer 子代理新增 `reviewTimeoutMs` 独立超时，不再与 worker 共用超时时间（trimmer: 20min, worker: 30min, reviewer: 15min）
+- **新主题** — 添加 `oh-my-pi-titanium` 主题
+- **循环计数显示** — loop-group 在工作时正确显示 `第 N 次循环`，时序与执行同步
+
+## 🐛 Bug Fixes
+
+- **Git diff 解析** — 改用简单字符串分割替代正则匹配，避免解析出 `checkpoint-${planId}.json`、`[],\n\t\t\t\toutputs:` 等垃圾条目
+- **循环计数器时序** — 修复循环计数从 planner 进入 loop 时显示错误（0→1→1→2 的问题），现正确为 0→1→2→3
+- **超时显示位置** — 超时时间从 loop 组迁移到具体的子代理步骤上，显示更准确
+- **工作流状态重置** — 修复 sub-step 状态重置函数名错误
+
+## 🔧 Refactor
+
+- UI 循环计数显示重构，子步骤时长/超时信息改进
+- 文件变更检测支持 git 标准状态码（M/A/D）
+
+## 📦 Files Changed
+
+```
+41 files changed, 7351 insertions(+), 62 deletions(-)
+```

package/.version/RELEASE-v0.4.3.md

@@ -0,0 +1,42 @@
+# Release v0.4.3
+
+## 🐛 Bug Fixes
+
+### Grill 选项完整文本不可见（选项不换行）
+选项列表中超长文本会被截断显示 `...`，但完整文本只能通过 `description` 列查看，而该列**单行显示且宽度受限**，导致长文本依旧被截断，用户无法阅读完整选项内容。
+
+**修复方案**：移除 `description` 列，改为**选项预览面板**。
+
+```
+之前: (a) a[推荐] 最终用户...  a[推荐] 最终用户（运维/...   ← 灰色列单行截断
+之后: (a) a[推荐] 最终用户（运维/系统管理员）——需要快...
+      a[推荐] 最终用户（运维/系统管理员）——需要快速部署
+      rksh-server、通过客户端连接远程服务器、使用终端和  ← 预览面板自动换行
+```
+
+- 选项列表下方新增 `Text` 预览面板，展示当前选中选项的完整文本
+- 使用 `wrapTextWithAnsi` 实现自动换行，灰色 `dim` 样式
+- 跟随 `↑↓` 导航实时更新，初始化时默认显示第一个选项
+- 选中 `✏️ 自定义输入` 或 `← 返回上一题` 时预览自动清空
+
+### Grill 左方向键与输入框光标左移冲突
+选项列表中 `←` 键被拦截用于"返回上一题"，导致自定义输入框中 `←` 键无法正常移动光标编辑文本。
+
+**修复方案**：将返回上一题的快捷键从 `←` 改为 `Ctrl+Shift+←`，输入框中 `←`/`→` 恢复为光标移动。
+
+| 场景 | 之前 | 之后 |
+|------|------|------|
+| 选项列表返回 | `←` | `Ctrl+Shift+←` |
+| 输入框返回 | `←`（吃掉键，无法编辑） | `Ctrl+Shift+←` |
+| 输入框光标 | ❌ 左移被拦截 | ✅ `←`/`→` 正常移动 |
+
+## 📦 Files Changed
+
+```
+2 files changed, 65 insertions(+), 15 deletions(-)
+```
+
+### Changed
+
+- `extensions/grill-me-agent.ts` — 预览面板 + 动态截断宽度 + 键位修正
+- `extensions/ui-helpers.ts` — 移除 `Key.left` 拦截，恢复输入框光标左移

package/README.md

@@ -56,7 +56,8 @@ pi-package/
 │   ├── git-commands.ts              # git-sub-agent 命令
 │   ├── grill-me-agent.ts            # Grill + PRD 运行时：设计评审、PRD 生成
 │   ├── sub-agents.ts                # 子代理系统：git-sub-agent + review-sub-agent
-│   └── workflow-engine.ts           # 工作流编排引擎（由 dev-prompts.ts 引入）
+│   ├── workflow-engine.ts           # 工作流编排引擎（由 dev-prompts.ts 引入）
+│   └── ui-helpers.ts                # TUI 组件构建器（Select/Confirm/Input/Widget）
 └── themes/
     └── claude-code-theme.json       # Claude Code CLI 风格主题
 ```
@@ -342,11 +343,22 @@ Grill（"拷问式评审"）是提交方案前由 AI sub-agent 从多个维度
 ### 交互形式
 
 每道问题在 TUI 中以 SelectList 呈现：
-- 选项列表：`(a) ...` `(b) ...` `(c) ...`
+- 选项列表：`(a) ...` `(b) ...` `(c) ...`（完整显示，不截断）
 - 最末选项：`✏️ 自定义输入` — 可输入自己的回答
-- 导航：↑↓ 选择，Enter 确认，Esc 取消全部评审
+- 导航：↑↓ 选择，Enter 确认
+- 返回：`Ctrl+Shift+←` 返回上一题（输入框中也可用 `Ctrl+Shift+←` 返回上一步）
+- 跳过：`Ctrl+Shift+→` 在输入框中跳过当前输入并继续
+- 取消：Esc 取消全部评审
 - 进度：标题栏显示 `问题 3/18`
 
+### 输入框特性
+
+自定义输入和 `/dev-*` 向导中的输入框支持：
+- **实时换行预览**：输入超长文本时，输入框上方会显示完整的换行预览（灰色文字），实时跟随输入变化
+- **光标操作**：`←` 和 `→` 键可正常移动光标编辑已有内容（不触发返回）
+- **返回上一题**：`Ctrl+Shift+←` 在输入框中返回上一题
+- **跳过输入**：`Ctrl+Shift+→` 提交当前内容（可为空）并继续
+
 ## PRD 文档生成
 
 仅 `/dev-feat` 命令在执行完成后自动触发 PRD 生成。其余 `/dev-*` 命令不包含此阶段。
@@ -407,6 +419,12 @@ A: 在 `extensions/grill-me-agent.ts` 中修改对应 AgentDef 的 `systemPrompt
 **Q: 评审结果是否影响原提示词？**
 A: 评审问答以「设计评审记录」区块追加到原提示词末尾，原提示词内容不变。主代理执行时会同时参考原需求 + 评审中确认的决策。
 
+**Q: Grill 中如何返回上一题？**
+A: 使用 `Ctrl+Shift+←` 返回上一题（在选项列表和自定义输入框中均适用）。裸 `←` 键在选项列表中无效果，在输入框中用于光标左移编辑文本。
+
+**Q: 自定义输入框中的键位有哪些？**
+A: `Enter` 确认提交，`Esc` 取消返回选项列表，`Ctrl+Shift+←` 返回上一题，`Ctrl+Shift+→` 跳过输入并继续，方向键 `←`/`→` 用于移动光标编辑已有文本。
+
 **Q: `grill-with-docs` skill 和 `/dev-*` 内置的 Grill 有什么区别？**
 A: `grill-with-docs` 是可独立调用的 skill（`/skill:grill-with-docs`），侧重领域术语统一和文档同步（更新 CONTEXT.md、创建 ADR）。`/dev-*` 内置的 Grill 是任务向导的一部分，侧重方案评审，不涉及文档持久化。
 

package/extensions/grill-me-agent.ts

@@ -24,6 +24,7 @@ import {
 	matchesKey,
 	Key,
 	truncateToWidth,
+	wrapTextWithAnsi,
 	type SelectItem,
 } from "@earendil-works/pi-tui";
 import { uiSelect, uiConfirm, uiInput } from "./ui-helpers";
@@ -592,7 +593,23 @@ export async function runGrillPhase(
 	};
 }
 
-/** Show a single grill question as TUI SelectList + custom input option. */
+/**
+ * Show a single grill question as TUI SelectList with option items and custom input entry.
+ *
+ * Navigation:
+ *   - ↑↓ 选择, Enter 确认, Esc 取消全部评审
+ *   - Ctrl+Shift+← 返回上一题（仅当 backable=true 且 currentIndex > 1 时生效）
+ *   - 选择 "✏️ 自定义输入" 进入文本输入模式
+ *
+ * @param ctx - Extension command context for TUI rendering
+ * @param q - The grill question to display
+ * @param currentIndex - 1-based index of current question
+ * @param totalCount - Total number of questions
+ * @param titlePrefix - Prefix for the question title bar
+ * @param backable - Whether navigating back to previous question is allowed
+ * @param previousAnswer - Previous answer to pre-fill as "上次选择" marker
+ * @returns Selected option text, "__BACK__" for back navigation, or null for cancel
+ */
 async function showQuestionTUI(
 	ctx: ExtensionCommandContext,
 	q: GrillQuestion,
@@ -602,18 +619,19 @@ async function showQuestionTUI(
 	backable = false,
 	previousAnswer?: string,
 ): Promise<string | null> {
-	const MAX_OPTION_LABEL = 50;
+	// 根据终端宽度计算截断宽度
+	const termWidth = process.stdout.columns || 120;
+	const maxOptWidth = Math.min(termWidth - 12, 100);
 	const selectItems: SelectItem[] = q.options.map((opt, i) => {
 		const prefix = `(${String.fromCharCode(97 + i)}) `;
 		const label = opt === previousAnswer
 			? `${prefix}${opt} - 上次选择`
 			: `${prefix}${opt}`;
-		const truncated = truncateToWidth(label, MAX_OPTION_LABEL, "...");
+		const truncated = truncateToWidth(label, maxOptWidth, "...");
 		return {
 			value: `opt-${i}`,
 			label: truncated,
-			// 只有被截断时才提供 description，展示完整文本
-			description: truncated !== label ? opt : undefined,
+			// 完整文本由下方的预览面板展示（支持换行），description 列无法换行故移除
 		};
 	});
 
@@ -650,14 +668,46 @@ async function showQuestionTUI(
 			description: (s) => theme.fg("muted", s),
 			scrollInfo: (s) => theme.fg("dim", s),
 			noMatch: (s) => theme.fg("warning", s),
+		}, {
+			minPrimaryColumnWidth: 30,
+			maxPrimaryColumnWidth: maxOptWidth + 2,
+			truncatePrimary: ({ text, maxWidth }) => truncateToWidth(text, maxWidth, "..."),
 		});
 		selectList.onSelect = (item) => done(item.value);
 		selectList.onCancel = () => done(null);
 		container.addChild(selectList);
 
+		// 完整选项预览面板（支持换行，展示当前选中选项的完整文本）
+		const previewWidth = Math.max(30, termWidth - 8);
+		const previewText = new Text("", 0, 0);
+		container.addChild(new Spacer(1));
+		container.addChild(previewText);
+
+		// 初始化预览为第一个选项
+		if (q.options.length > 0) {
+			const initialWrapped = wrapTextWithAnsi(q.options[0], previewWidth);
+			previewText.setText(
+				initialWrapped.map(l => theme.fg("dim", `  ${l}`)).join("\n")
+			);
+		}
+
+		selectList.onSelectionChange = (item) => {
+			if (item.value.startsWith("opt-")) {
+				const idx = parseInt(item.value.replace("opt-", ""), 10);
+				const fullText = q.options[idx];
+				const wrapped = wrapTextWithAnsi(fullText, previewWidth);
+				previewText.setText(
+					wrapped.map(l => theme.fg("dim", `  ${l}`)).join("\n")
+				);
+			} else {
+				previewText.setText("");
+			}
+			tui.requestRender();
+		};
+
 		container.addChild(new Spacer(1));
 		const hint = backable && currentIndex > 1
-			? "  ↑↓ 导航 • Enter 选择 • ← 返回上一题 • Esc 取消全部评审"
+			? "  ↑↓ 导航 • Enter 选择 • Ctrl+Shift+← 返回上一题 • Esc 取消全部评审"
 			: "  ↑↓ 导航 • Enter 选择 • Esc 取消全部评审";
 		container.addChild(
 			new Text(theme.fg("dim", hint), 0, 0),
@@ -668,8 +718,8 @@ async function showQuestionTUI(
 			render: (w) => container.render(w),
 			invalidate: () => container.invalidate(),
 			handleInput: (data) => {
-				// 左方向键 → 返回上一题（SelectList 不处理 left 键，需自行拦截）
-				if (backable && currentIndex > 1 && matchesKey(data, Key.left)) {
+				// Ctrl+Shift+← → 返回上一题（SelectList 不处理该键，需自行拦截）
+				if (backable && currentIndex > 1 && matchesKey(data, Key.ctrlShift("left"))) {
 					done("__BACK__");
 					return;
 				}

package/extensions/ui-helpers.ts

@@ -205,9 +205,14 @@ export function uiConfirm(
 // ── Input (replaces ctx.ui.input) ────────────────────────────
 
 /**
- * Show an input dialog with proper wrapping.
+ * Show an input dialog with proper wrapping and live preview.
+ *
+ * Features:
+ *   - 实时换行预览：输入框上方显示完整的换行预览（跟随输入实时更新）
+ *   - 方向键 ←/→ 可正常移动光标编辑已有内容
+ *
  * Returns the entered string, or BACK_MARKER on back, or undefined on cancel.
- * When backable=true, supports ← for back, Ctrl+Shift+← for back, and Ctrl+Shift+→ for submit+next.
+ * When backable=true, supports Ctrl+Shift+← for back and Ctrl+Shift+→ for submit+next.
  */
 export function uiInput(
     ctx: ExtensionCommandContext,
@@ -260,11 +265,6 @@ export function uiInput(
             render: (w) => container.render(w),
             invalidate: () => container.invalidate(),
             handleInput: (data) => {
-                // 左方向键 → 返回（优先于 Input 的光标左移）
-                if (backable && matchesKey(data, Key.left)) {
-                    done(BACK_MARKER);
-                    return;
-                }
 
                 // Intercept back/next keys before passing to Input
                 if (backable) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghyper9023/pi-dev-workflow",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "keywords": [
     "pi-package"
   ],