@zzs-fun/current-question 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # current-question
 
-[English](./README.md) | [简体中文](./README.zh-CN.md)
+[English](./README.md) | [Chinese (Simplified)](./README.zh-CN.md)
 
 > A [pi coding agent](https://pi.dev) extension that pins your recent questions above the editor — navigate, expand, copy, and reply with context.
 
@@ -10,7 +10,7 @@
 
 - Shows the last N user questions (default 5; set with `/current-question <number>`)
 - One line per question; long lines are truncated with `...` (correctly handles double-width CJK characters)
-- Title carries the round counter: `❯ 当前问题(N)` where N is the current question round
+- Title carries the round counter: `❯ Current Questions (N)` where N is the current question round
 - Collapsed by default; `Ctrl+Alt+L` expands the selected entry to show the full question + its answer, `Ctrl+Alt+H` collapses
 - Collapsed: `Ctrl+Alt+H` hides the widget; hidden: `Ctrl+Alt+L` shows it again
 - Expanded: `Ctrl+Alt+J/K` scrolls the answer; collapsed: `Ctrl+Alt+J/K` switches entries
@@ -26,7 +26,11 @@
 ## Install
 
 ```bash
+# Install globally
 pi install npm:@zzs-fun/current-question
+
+# Or install for the current project only
+pi install -l npm:@zzs-fun/current-question
 ```
 
 ## Shortcuts

package/README.zh-CN.md

@@ -10,7 +10,7 @@ pi coding agent 扩展，在编辑器上方固定显示「最近 n 条用户问
 
 - 显示最近 N 条用户问题（默认 5 条，`/current-question <数字>` 设置）
 - 每条只展示一行，超长自动截断并加 `...`（正确处理中文等双宽字符）
-- 标题带「第 N 轮」计数：`❯ 当前问题(N)`，N 为当前提问轮数
+- 标题带「第 N 轮」计数：`❯ Current Questions (N)`，N 为当前提问轮数
 - 默认收起；选中条可 `Ctrl+Alt+L` 展开看问题全文 + 该轮回答，`Ctrl+Alt+H` 收起
 - 收起态 `Ctrl+Alt+H` 隐藏当前问题；隐藏态 `Ctrl+Alt+L` 重新显示
 - 展开态 `Ctrl+Alt+J/K` 滚动回答内容；收起态 `Ctrl+Alt+J/K` 切换问题条目
@@ -26,7 +26,11 @@ pi coding agent 扩展，在编辑器上方固定显示「最近 n 条用户问
 ## 安装
 
 ```bash
+# 全局安装
 pi install npm:@zzs-fun/current-question
+
+# 或仅安装到当前项目
+pi install -l npm:@zzs-fun/current-question
 ```
 
 ## 快捷键

package/index.ts

@@ -47,9 +47,9 @@ const MAX_QUESTION_LINES = 6;
 const WIDGET_HEIGHT_RESERVED = 10;
 
 /** 外部编辑器分节标记（行首严格匹配） */
-const MARKER_QUESTION = ">> 问题";
-const MARKER_ANSWER = ">> 回答";
-const MARKER_REPLY = ">> 回复";
+const MARKER_QUESTION = ">> Question";
+const MARKER_ANSWER = ">> Answer";
+const MARKER_REPLY = ">> Reply";
 
 /** 缓存的 TUI 实例句柄，供外部编辑器流程暂停/恢复终端 */
 interface TuiHandle {
@@ -75,7 +75,7 @@ const NVIM_LOCK_SCRIPT = [
 	'" —— 2. 找到最后一个 “>> 回复” 标记行 ——',
 	'let g:pi_ctx_locked_end = 0',
 	'for s:i in range(1, line(\'$\'))',
-	'  if getline(s:i) =~# \'^>>\\s*回复\\s*$\'',
+	'  if getline(s:i) =~# \'^>>\\s*Reply\\s*$\'',
 	'    let g:pi_ctx_locked_end = s:i',
 	'  endif',
 	'endfor',
@@ -89,7 +89,7 @@ const NVIM_LOCK_SCRIPT = [
 	'function! PiCtxGuardInsert() abort',
 	'  if line(\'.\') <= g:pi_ctx_locked_end',
 	'    call feedkeys("\\<Esc>", \'n\')',
-	'    echohl WarningMsg | echo "历史问答区只读，请在 \'>> 回复\' 下方编辑" | echohl None',
+	'    echohl WarningMsg | echo "The question and answer history is read-only. Edit below \'>> Reply\'." | echohl None',
 	'  endif',
 	'endfunction',
 	'autocmd InsertEnter <buffer> call PiCtxGuardInsert()',
@@ -100,7 +100,7 @@ const NVIM_LOCK_SCRIPT = [
 	'    let g:pi_ctx_restoring = 1',
 	'    undo',
 	'    unlet g:pi_ctx_restoring',
-	'    echohl WarningMsg | echo "已恢复被改动的历史问答区" | echohl None',
+	'    echohl WarningMsg | echo "Restored the modified question and answer history." | echohl None',
 	'  endif',
 	'endfunction',
 	'autocmd TextChanged,TextChangedI <buffer> call PiCtxCheckLocked()',
@@ -135,7 +135,7 @@ function extractText(content: unknown): string {
 	}
 	const text = parts.join("").trim();
 	if (text) return text;
-	return hasImage ? "[图片]" : "";
+	return hasImage ? "[Image]" : "";
 }
 
 /**
@@ -220,7 +220,7 @@ function resolveEditorCommand(): { command: string; args: string[] } {
  * 回复区放当前编辑器文本，前两节作为只读参考。
  */
 function buildContextFileContent(q: { text: string; answer: string }, replyText: string): string {
-	const answer = q.answer?.trim() || "(暂无回答)";
+	const answer = q.answer?.trim() || "(No answer yet)";
 	return `${MARKER_QUESTION}\n\n${q.text}\n\n${MARKER_ANSWER}\n\n${answer}\n\n${MARKER_REPLY}\n\n${replyText}\n`;
 }
 
@@ -238,7 +238,7 @@ function parseReplyFromContent(content: string): { reply: string; markerFound: b
 	const lines = content.replace(/\r\n/g, "\n").split("\n");
 	let markerIdx = -1;
 	for (let i = lines.length - 1; i >= 0; i--) {
-		if (/^>>\s*回复\s*$/.test(lines[i]!)) {
+		if (/^>>\s*Reply\s*$/.test(lines[i]!)) {
 			markerIdx = i;
 			break;
 		}
@@ -322,17 +322,17 @@ export default function (pi: ExtensionAPI) {
 	const copyQuestionAndAnswer = async (ctx: ExtensionContext) => {
 		const q = getSelectedQuestion();
 		if (!q) {
-			ctx.ui.notify("暂无历史问题可复制", "warning");
+			ctx.ui.notify("No question history to copy", "warning");
 			return;
 		}
 
-		const text = `>> 问题\n\n${q.text}\n\n>> 回答\n\n${q.answer || "(暂无回答)"}`;
+		const text = `>> Question\n\n${q.text}\n\n>> Answer\n\n${q.answer || "(No answer yet)"}`;
 		try {
 			await copyToClipboard(text);
-			ctx.ui.notify(`已复制第 ${q.round} 轮问题与回答`, "info");
+			ctx.ui.notify(`Copied question and answer from round ${q.round}`, "info");
 		} catch (error) {
-			console.error("[current-question] 复制到剪贴板失败", error);
-			ctx.ui.notify(`复制失败：${error instanceof Error ? error.message : String(error)}`, "error");
+			console.error("[current-question] Failed to copy to clipboard", error);
+			ctx.ui.notify(`Copy failed: ${error instanceof Error ? error.message : String(error)}`, "error");
 		}
 	};
 
@@ -406,12 +406,12 @@ export default function (pi: ExtensionAPI) {
 				const indentWidth = visibleWidth(indent);
 				const n = recentQuestions.length;
 				const out: string[] = [];
-				out.push(theme.fg("accent", theme.bold(`❯ 当前问题(${currentRound})`)));
+				out.push(theme.fg("accent", theme.bold(`❯ Current Questions (${currentRound})`)));
 
 				// 顶部指示：窗口上方还有更新的问题
 				const newerCount = n - (windowStart + maxLines);
 				if (newerCount > 0) {
-					out.push(`${theme.fg("dim", indent)}${theme.fg("dim", `↑ 还有 ${newerCount} 条更新`)}`);
+					out.push(`${theme.fg("dim", indent)}${theme.fg("dim", `↑ ${newerCount} newer`)}`);
 				}
 
 				// 可见窗口 [windowStart, windowStart+maxLines)，反转使最新在上
@@ -445,9 +445,9 @@ export default function (pi: ExtensionAPI) {
 								}
 							});
 							if (qTruncated) {
-								out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", `… 问题共 ${rawQLines.length} 行，已截断前 ${MAX_QUESTION_LINES} 行（Ctrl+Alt+B 复制全文）`)}`);
+								out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", `… Question has ${rawQLines.length} lines; showing first ${MAX_QUESTION_LINES} (Ctrl+Alt+B copies all)`)}`);
 							}
-							out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("accent", "─ 回答 ─")}`);
+							out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("accent", "─ Answer ─")}`);
 							if (q.answer) {
 								// 全部分行并缓存，供滚动 handler 做边界判断
 								cachedAnswerLines = wrapText(q.answer, bodyWidth);
@@ -471,7 +471,7 @@ export default function (pi: ExtensionAPI) {
 								const viewEnd = Math.min(total, answerScroll + answerView);
 								// 回答上方滚动提示
 								if (answerScroll > 0) {
-									out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", `↑ 还有 ${answerScroll} 行(Ctrl+Alt+K 上滚)`)}`);
+									out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", `↑ ${answerScroll} lines above (Ctrl+Alt+K)`)}`);
 								}
 								for (const ln of cachedAnswerLines.slice(answerScroll, viewEnd)) {
 									out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("muted", ln)}`);
@@ -479,10 +479,10 @@ export default function (pi: ExtensionAPI) {
 								// 回答下方滚动提示
 								const remain = total - viewEnd;
 								if (remain > 0) {
-									out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", `↓ 还有 ${remain} 行(Ctrl+Alt+J 下滚)`)}`);
+									out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", `↓ ${remain} lines below (Ctrl+Alt+J)`)}`);
 								}
 							} else {
-								out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", "(暂无回答)")}`);
+								out.push(`${theme.fg("dim", bodyIndent)}${theme.fg("dim", "(No answer yet)")}`);
 							}
 						}
 					} else {
@@ -496,14 +496,14 @@ export default function (pi: ExtensionAPI) {
 				// 底部指示：窗口下方还有更早的问题
 				const olderCount = windowStart;
 				if (olderCount > 0) {
-					out.push(`${theme.fg("dim", indent)}${theme.fg("dim", `↓ 还有 ${olderCount} 条更早`)}`);
+					out.push(`${theme.fg("dim", indent)}${theme.fg("dim", `↓ ${olderCount} older`)}`);
 				}
 				// 兜底：极端配置或小终端下，若 widget 总行数仍超上限，从底部截断并提示，
 				// 确保不触碰终端顶部引发流式抖动。
 				if (out.length > maxWidgetRows) {
 					const overflow = out.length - maxWidgetRows;
 					out.length = maxWidgetRows;
-					out.push(`${theme.fg("dim", indent)}${theme.fg("dim", `↓ 因终端高度隐藏 ${overflow} 行`)}`);
+					out.push(`${theme.fg("dim", indent)}${theme.fg("dim", `↓ ${overflow} lines hidden due to terminal height`)}`);
 				}
 				cachedOutput = out;
 				return cachedOutput;
@@ -571,7 +571,7 @@ export default function (pi: ExtensionAPI) {
 
 	// Ctrl+Alt+J：收起态=选更早问题；展开态=回答下滚
 	pi.registerShortcut("ctrl+alt+j", {
-		description: "当前问题：收起时选更早问题 / 展开时回答下滚",
+		description: "Current Questions: select an older question when collapsed / scroll the answer down when expanded",
 		handler: async (ctx) => {
 			if (recentQuestions.length === 0 || !enabled) return;
 			if (expanded) {
@@ -592,7 +592,7 @@ export default function (pi: ExtensionAPI) {
 
 	// Ctrl+Alt+K：收起态=选更新问题；展开态=回答上滚
 	pi.registerShortcut("ctrl+alt+k", {
-		description: "当前问题：收起时选更新问题 / 展开时回答上滚",
+		description: "Current Questions: select a newer question when collapsed / scroll the answer up when expanded",
 		handler: async (ctx) => {
 			if (recentQuestions.length === 0 || !enabled) return;
 			if (expanded) {
@@ -611,7 +611,7 @@ export default function (pi: ExtensionAPI) {
 
 	// Ctrl+Alt+C：同时复制当前选中条的完整问题与回答
 	pi.registerShortcut("ctrl+alt+b", {
-		description: "当前问题：复制选中条完整问题与回答",
+		description: "Current Questions: copy the selected question and answer",
 		handler: async (ctx) => {
 			await copyQuestionAndAnswer(ctx);
 		},
@@ -619,7 +619,7 @@ export default function (pi: ExtensionAPI) {
 
 	// Ctrl+Alt+L：隐藏态=重新显示；显示态=展开当前选中条（重置回答滚动到顶部）
 	pi.registerShortcut("ctrl+alt+l", {
-		description: "当前问题：隐藏时重新显示 / 显示时展开选中条（显示问题全文 + 回答）",
+		description: "Current Questions: show when hidden / expand the selected question and answer when visible",
 		handler: async (ctx) => {
 			if (recentQuestions.length === 0) return;
 			if (!enabled) {
@@ -637,7 +637,7 @@ export default function (pi: ExtensionAPI) {
 
 	// Ctrl+Alt+H：展开态=收起当前选中条；收起态=隐藏当前问题
 	pi.registerShortcut("ctrl+alt+h", {
-		description: "当前问题：展开时收起选中条 / 收起时隐藏当前问题",
+		description: "Current Questions: collapse the selected item when expanded / hide the widget when collapsed",
 		handler: async (ctx) => {
 			if (expanded) {
 				expanded = false;
@@ -654,20 +654,20 @@ export default function (pi: ExtensionAPI) {
 	// 终端管理复用 pi 内置 openExternalEditor 的方式：tui.stop() 释放终端、异步 spawn 编辑器、
 	// 退出后 tui.start() 恢复。用异步 spawn 而非 spawnSync，避免 Windows 上 console input 抢占。
 	pi.registerShortcut("ctrl+alt+g", {
-		description: "当前问题：带选中问答上下文打开外部编辑器编辑回复",
+		description: "Current Questions: open an external editor with selected question-and-answer context",
 		handler: async (ctx) => {
 			if (!enabled || recentQuestions.length === 0) {
-				ctx.ui.notify("暂无历史问题，无法带上下文编辑", "warning");
+				ctx.ui.notify("No question history available for context-aware editing", "warning");
 				return;
 			}
 			const q = getSelectedQuestion();
 			if (!q) {
-				ctx.ui.notify("未选中历史问题", "warning");
+				ctx.ui.notify("No history item is selected", "warning");
 				return;
 			}
 			const tui = tuiRef;
 			if (!tui?.stop || !tui?.start) {
-				ctx.ui.notify("当前环境不支持外部编辑器流程", "error");
+				ctx.ui.notify("External editor workflow is unavailable in this environment", "error");
 				return;
 			}
 
@@ -686,7 +686,7 @@ export default function (pi: ExtensionAPI) {
 			try {
 				fs.writeFileSync(tmpFile, fileContent, "utf8");
 			} catch (e) {
-				ctx.ui.notify(`写临时文件失败：${e instanceof Error ? e.message : String(e)}`, "error");
+				ctx.ui.notify(`Failed to write temporary file: ${e instanceof Error ? e.message : String(e)}`, "error");
 				return;
 			}
 
@@ -711,7 +711,7 @@ export default function (pi: ExtensionAPI) {
 			}
 
 			// stop 前直接写 stdout 提示（TUI 停止后 notify 不可见）
-			process.stdout.write(`打开外部编辑器编辑第 ${q.round} 轮问答（${command}）…\nPi 将在编辑器退出后恢复。\n`);
+			process.stdout.write(`Opening ${command} to edit the reply with context from round ${q.round}…\nPi will resume when the editor exits.\n`);
 
 			let status: number | null = null;
 			let spawnErr: Error | null = null;
@@ -734,13 +734,13 @@ export default function (pi: ExtensionAPI) {
 			}
 
 			if (spawnErr) {
-				ctx.ui.notify(`启动编辑器失败：${spawnErr.message}`, "error");
+				ctx.ui.notify(`Failed to launch editor: ${spawnErr.message}`, "error");
 				cleanupTemp();
 				return;
 			}
 			if (status !== 0) {
 				// 非正常退出：保留原输入框内容不变
-				ctx.ui.notify(`编辑器退出码 ${status}，未修改输入框`, "warning");
+				ctx.ui.notify(`Editor exited with code ${status}; editor contents were not changed`, "warning");
 				cleanupTemp();
 				return;
 			}
@@ -750,7 +750,7 @@ export default function (pi: ExtensionAPI) {
 			try {
 				newContent = fs.readFileSync(tmpFile, "utf8");
 			} catch (e) {
-				ctx.ui.notify(`读取临时文件失败：${e instanceof Error ? e.message : String(e)}`, "error");
+				ctx.ui.notify(`Failed to read temporary file: ${e instanceof Error ? e.message : String(e)}`, "error");
 				cleanupTemp();
 				return;
 			}
@@ -759,16 +759,16 @@ export default function (pi: ExtensionAPI) {
 			const { reply, markerFound } = parseReplyFromContent(newContent);
 			ctx.ui.setEditorText(reply);
 			if (!markerFound) {
-				ctx.ui.notify("⚠️ 未找到 '>> 回复' 标记（可能被删除/改写），已将全部内容作为回复", "warning");
+				ctx.ui.notify("⚠️ Could not find the '>> Reply' marker; used the entire file as the reply", "warning");
 			} else {
-				ctx.ui.notify(`已更新输入框（参考第 ${q.round} 轮问答）`, "info");
+				ctx.ui.notify(`Updated the editor with context from round ${q.round}`, "info");
 			}
 		},
 	});
 
 	// /current-question [on|off|toggle|<数字>]
 	pi.registerCommand("current-question", {
-		description: "当前问题置顶：on/off/toggle 切换开关，或传数字设置显示条数（默认 5）",
+		description: "Current Questions: use on/off/toggle to change visibility, or a number to set the displayed count (default: 5)",
 		handler: async (args, ctx) => {
 			const arg = args.trim().toLowerCase();
 			if (arg === "on") {
@@ -783,11 +783,11 @@ export default function (pi: ExtensionAPI) {
 				enabled = true;
 				ensureVisible();
 			} else {
-				ctx.ui.notify("用法: /current-question [on|off|toggle|<数字>]", "warning");
+				ctx.ui.notify("Usage: /current-question [on|off|toggle|<number>]", "warning");
 				return;
 			}
 			refresh(ctx);
-			ctx.ui.notify(`当前问题置顶：${enabled ? "开" : "关"}，显示 ${maxLines} 条`, "info");
+			ctx.ui.notify(`Current Questions: ${enabled ? "on" : "off"}; displaying ${maxLines} item(s)`, "info");
 		},
 	});
 }

package/package.json

@@ -1,25 +1,34 @@
 {
   "name": "@zzs-fun/current-question",
-  "version": "0.1.0",
-  "description": "pi 扩展：在编辑器上方置顶显示最近 N 条用户问题，支持切换/展开/复制/带上下文的外部编辑器回复",
-  "keywords": ["pi-package"],
+  "version": "0.1.2",
+  "description": "pi extension that pins your recent questions above the editor — navigate, expand, copy, and reply with context.",
+  "keywords": [
+    "pi-package"
+  ],
   "author": "jenson",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/wszzs110/current-question.git"
+    "url": "git+https://github.com/wszzs110/current-question.git"
   },
   "homepage": "https://github.com/wszzs110/current-question#readme",
   "bugs": {
     "url": "https://github.com/wszzs110/current-question/issues"
   },
-  "files": ["index.ts", "README.md", "README.zh-CN.md", "LICENSE"],
+  "files": [
+    "index.ts",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
   "pi": {
-    "extensions": ["./index.ts"]
+    "extensions": [
+      "./index.ts"
+    ]
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
   }
-}
+}