@unifan/pi-unifan-zh 1.0.5 → 1.0.7

package/extensions/commit/index.ts

@@ -0,0 +1,216 @@
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import {
+	commitWithMsg,
+	getChangedFiles,
+	getStagedDiff,
+	getUnstagedDiff,
+	isGitRepo,
+	pushCurrentBranch,
+	stageAll,
+} from "./src/git.js";
+import { COMMIT_SYSTEM_PROMPT } from "./src/prompt.ts";
+
+interface ParsedCommitArgs {
+	yes: boolean;
+	stageAll: boolean;
+	hint?: string;
+}
+
+function parseArgs(raw: string): ParsedCommitArgs {
+	const tokens = raw.trim().split(/\s+/).filter(Boolean);
+	let yes = false;
+	let shouldStageAll = false;
+	const hintParts: string[] = [];
+
+	for (const t of tokens) {
+		if (t === "-y" || t === "--yes") {
+			yes = true;
+		} else if (t === "-a" || t === "--all") {
+			shouldStageAll = true;
+		} else {
+			hintParts.push(t);
+		}
+	}
+
+	return {
+		yes,
+		stageAll: shouldStageAll,
+		hint: hintParts.join(" ").trim() || undefined,
+	};
+}
+
+async function generateCommitMessage(
+	ctx: ExtensionCommandContext,
+	diff: string,
+	changedFiles: string[],
+	userHint?: string,
+): Promise<string> {
+	const truncatedDiff = diff.length > 30000 ? diff.slice(0, 30000) + "\n\n... (diff已截断)" : diff;
+	const userPrompt = [
+		`## 修改的文件清单 (${changedFiles.length} 个文件):`,
+		changedFiles.map((f) => `- ${f}`).join("\n"),
+		"",
+		userHint ? `## 用户额外补充说明:\n${userHint}\n` : "",
+		"## Git Diff 变动详情:",
+		"```diff",
+		truncatedDiff,
+		"```",
+	]
+		.filter(Boolean)
+		.join("\n");
+
+	if (ctx.model && ctx.modelRegistry) {
+		try {
+			const provider = ctx.modelRegistry.getProvider(ctx.model.provider);
+			if (provider) {
+				const response = await provider
+					.streamSimple(
+						ctx.model,
+						{
+							systemPrompt: COMMIT_SYSTEM_PROMPT,
+							messages: [
+								{
+									role: "user",
+									content: [{ type: "text", text: userPrompt }],
+									timestamp: Date.now(),
+								},
+							],
+						},
+						{ maxTokens: 800 },
+					)
+					.result();
+
+				const text = response.content
+					?.map((c) => (c.type === "text" ? c.text : ""))
+					.join("")
+					.trim();
+
+				if (text) {
+					// Clean any unexpected code blocks
+					return text.replace(/^```[a-zA-Z]*\n?/, "").replace(/\n?```$/, "").trim();
+				}
+			}
+		} catch {
+			/* fallback below */
+		}
+	}
+
+	// Simple heuristic fallback
+	const firstFile = changedFiles[0] ?? "core";
+	const scope = firstFile.split(/[/\\]/)[0] || "core";
+	return `chore(${scope}): 更新代码与相关配置\n\n- 更新了 ${changedFiles.length} 个文件`;
+}
+
+export default function (pi: ExtensionAPI) {
+	const handleCommitCommand = async (args: string, ctx: ExtensionCommandContext, andPush = false) => {
+		const notify = (msg: string, level: "info" | "warning" | "error" = "info") => {
+			if (ctx.hasUI) ctx.ui.notify(msg, level);
+			else console.log(`pi-commit: ${msg}`);
+		};
+
+		if (!(await isGitRepo(ctx.cwd))) {
+			notify("当前目录不是 Git 仓库，无法执行 commit。", "error");
+			return;
+		}
+
+		const parsed = parseArgs(args);
+		let stagedDiff = await getStagedDiff(ctx.cwd);
+		const unstagedDiff = await getUnstagedDiff(ctx.cwd);
+		const changedFiles = await getChangedFiles(ctx.cwd);
+
+		if (!stagedDiff && !unstagedDiff) {
+			notify("当前工作区没有任何修改，无需提交。", "info");
+			return;
+		}
+
+		if (!stagedDiff && unstagedDiff) {
+			notify("未发现暂存区文件，已自动暂存全部修改 (git add -A)...", "info");
+			await stageAll(ctx.cwd);
+			stagedDiff = await getStagedDiff(ctx.cwd);
+		} else if (parsed.stageAll) {
+			await stageAll(ctx.cwd);
+			stagedDiff = await getStagedDiff(ctx.cwd);
+		}
+
+		notify("正在深度分析代码改动并生成中文 Commit Message...", "info");
+		const commitMessage = await generateCommitMessage(ctx, stagedDiff || unstagedDiff, changedFiles, parsed.hint);
+
+		let finalMessage = commitMessage;
+
+		if (!parsed.yes && ctx.hasUI) {
+			const choice = await ctx.ui.select(
+				`✨ AI 生成的提交信息:\n\n${commitMessage}\n\n请选择操作:`,
+				[
+					{ label: "✅ 立即以此信息提交 (Commit)", value: "commit" },
+					{ label: "📝 编辑后再提交 (Edit & Commit)", value: "edit" },
+					{ label: "❌ 取消提交 (Cancel)", value: "cancel" },
+				],
+			);
+
+			if (!choice || choice === "cancel") {
+				notify("已取消本次提交。", "info");
+				return;
+			}
+
+			if (choice === "edit") {
+				const edited = await ctx.ui.editor("编辑 Commit Message", commitMessage);
+				if (!edited || !edited.trim()) {
+					notify("提交信息为空，已取消提交。", "warning");
+					return;
+				}
+				finalMessage = edited.trim();
+			}
+		}
+
+		const commitRes = await commitWithMsg(ctx.cwd, finalMessage);
+		if (!commitRes.ok) {
+			notify(`Git 提交失败: ${commitRes.output}`, "error");
+			return;
+		}
+
+		const firstLine = finalMessage.split("\n")[0];
+		notify(`✅ 成功提交: ${firstLine}`, "info");
+
+		let pushText = "";
+		if (andPush) {
+			notify("正在推送到远端仓库 (git push)...", "info");
+			const pushRes = await pushCurrentBranch(ctx.cwd);
+			if (pushRes.ok) {
+				notify("🚀 成功推送到远端仓库！", "info");
+				pushText = "\n\n🚀 **已自动推送到远端分支**";
+			} else {
+				notify(`⚠️ 推送失败: ${pushRes.output}`, "warning");
+				pushText = `\n\n⚠️ **推送到远端失败**: ${pushRes.output}`;
+			}
+		}
+
+		pi.sendMessage({
+			customType: "pi-commit-result",
+			content: `### 📦 Git 提交完成\n\n\`\`\`text\n${finalMessage}\n\`\`\`${pushText}`,
+			display: true,
+		});
+	};
+
+	pi.registerCommand("commit", {
+		description: "智能 Git 提交助手：自动分析 diff 生成标准中文 Conventional Commit 并提交 (-y 直接提交, -a 暂存全部)",
+		getArgumentCompletions: (prefix: string) => {
+			const options = [
+				{ value: "-y", label: "-y / --yes", description: "直接提交无需二次确认" },
+				{ value: "-a", label: "-a / --all", description: "自动暂存全部修改 (git add -A)" },
+			];
+			const trimmed = prefix.trimStart();
+			if (!trimmed) return options;
+			return options.filter((o) => o.value.startsWith(trimmed));
+		},
+		handler: async (args, ctx) => {
+			await handleCommitCommand(args, ctx, false);
+		},
+	});
+
+	pi.registerCommand("commit-push", {
+		description: "智能 Git 提交并推流：生成标准中文 Commit 后自动执行 git push",
+		handler: async (args, ctx) => {
+			await handleCommitCommand(args, ctx, true);
+		},
+	});
+}

package/extensions/commit/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@unifan/pi-commit-zh",
+  "version": "1.0.6",
+  "description": "Pi 智能 Git 提交助手（规范化 Conventional Commits 纯中文版，支持一键提审与推流）",
+  "type": "module",
+  "main": "index.ts",
+  "author": "821869798",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/821869798/pi-unifan-zh.git"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "git",
+    "commit",
+    "conventional-commits",
+    "chinese"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.74.0 <1.0.0",
+    "@earendil-works/pi-coding-agent": ">=0.74.0 <1.0.0"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/extensions/commit/src/git.ts

@@ -0,0 +1,61 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+export async function runGit(cwd: string, args: string[]): Promise<{ stdout: string; stderr: string; ok: boolean }> {
+	try {
+		const res = await execFileAsync("git", args, { cwd, maxBuffer: 10 * 1024 * 1024 });
+		return { stdout: res.stdout, stderr: res.stderr, ok: true };
+	} catch (err: any) {
+		return {
+			stdout: err?.stdout ?? "",
+			stderr: err?.stderr ?? err?.message ?? String(err),
+			ok: false,
+		};
+	}
+}
+
+export async function isGitRepo(cwd: string): Promise<boolean> {
+	const res = await runGit(cwd, ["rev-parse", "--is-inside-work-tree"]);
+	return res.ok && res.stdout.trim() === "true";
+}
+
+export async function getGitStatus(cwd: string): Promise<string> {
+	const res = await runGit(cwd, ["status", "--porcelain"]);
+	return res.ok ? res.stdout.trim() : "";
+}
+
+export async function getStagedDiff(cwd: string): Promise<string> {
+	const res = await runGit(cwd, ["diff", "--cached"]);
+	return res.ok ? res.stdout : "";
+}
+
+export async function getUnstagedDiff(cwd: string): Promise<string> {
+	const res = await runGit(cwd, ["diff"]);
+	return res.ok ? res.stdout : "";
+}
+
+export async function getChangedFiles(cwd: string): Promise<string[]> {
+	const res = await runGit(cwd, ["status", "--porcelain"]);
+	if (!res.ok || !res.stdout.trim()) return [];
+	return res.stdout
+		.split("\n")
+		.map((line) => line.trim().slice(3).trim())
+		.filter(Boolean);
+}
+
+export async function stageAll(cwd: string): Promise<boolean> {
+	const res = await runGit(cwd, ["add", "-A"]);
+	return res.ok;
+}
+
+export async function commitWithMsg(cwd: string, message: string): Promise<{ ok: boolean; output: string }> {
+	const res = await runGit(cwd, ["commit", "-m", message]);
+	return { ok: res.ok, output: res.ok ? res.stdout : res.stderr };
+}
+
+export async function pushCurrentBranch(cwd: string): Promise<{ ok: boolean; output: string }> {
+	const res = await runGit(cwd, ["push"]);
+	return { ok: res.ok, output: res.ok ? res.stdout : res.stderr };
+}

package/extensions/commit/src/prompt.ts

@@ -0,0 +1,24 @@
+export const COMMIT_SYSTEM_PROMPT = `你是专业的 Git 提交信息生成专家（Conventional Commits 中文版）。
+你的唯一任务是根据提供的 Git Diff 变动和修改文件列表，生成规范、准确、地道的中文 Commit Message。
+
+## 严格遵循的标准（Conventional Commits 1.0.0）：
+1. 格式：<type>(<scope>): <中文描述>
+   - type 必须为标准英文类型之一：
+     • feat: 新增功能/新模块/新特性
+     • fix: 修复Bug/缺陷
+     • perf: 性能优化/降低GC/提高帧率
+     • refactor: 代码重构/结构优化
+     • docs: 文档/注释更新
+     • style: 格式调整/无逻辑影响
+     • test: 单元测试/基准测试
+     • chore: 构建/依赖/配置杂项
+   - scope 为具体修改的业务模块名（如：combat/战斗、session/会话、review/审查、ui/界面、network/网络、core/核心）
+   - 中文描述：50个汉字以内，动词开头，言简意赅，末尾严禁加句号。
+
+2. 若修改较为复杂，可附带简要中文正文列表（Body）：
+   - 核心改动点 1
+   - 核心改动点 2
+
+3. 语言约束：所有标题描述与正文说明必须且只能使用纯正中文，严禁长句英文。
+
+4. 输出格式：直接输出生成的 Commit 信息文本（首行标题，空行后跟正文），不要附加任何额外的 markdown 代码块或寒暄。`;

package/extensions/review/agents/perf-review.md

@@ -1,56 +1,81 @@
 ---
 name: perf-review
 package: pi-review
-description: 性能与基准测试审查专家：专项排查内存泄漏、高频GC分配、算法复杂度退化、锁竞争，并主动探测执行基准测试(Benchmark)。
+description: 通用性能与基准测试审查专家：跨语言排查热路径堆分配、算法复杂度、锁竞争、I/O放大与资源泄漏，并主动探测执行基准测试(Benchmark)。
 tools: read, grep, bash
 systemPromptMode: replace
 inheritProjectContext: false
 inheritSkills: false
 ---
-你是**性能与基准测试审查专家（Performance & Benchmark Reviewer）**。你的任务是专项深度排查本次代码改动中的性能瓶颈、内存分配压力与并发隐患，并主动寻找和执行基准测试（Benchmark）。
+你是**通用性能与基准测试审查专家（Universal Performance & Benchmark Reviewer）**。你的职责是从计算机底层与系统架构视角，专项排查代码改动中的性能退化、内存与资源开销、计算瓶颈、并发竞争与 I/O 放大问题，并主动探索和执行基准测试。
 
-## 核心审查维度（跨语言与全栈）
+## 🎯 核心审查维度（通用跨语言体系）
 
-1. **内存与 GC 分配（Memory & Allocation Pressure）**：
-   - **高频循环堆分配**：检查循环（Update / Tick / 帧循环 / 高频事件处理器）中是否存在 `new` 对象、隐式闭包分配、Lambda 捕获外部变量、LINQ、装箱/拆箱。
-   - **集合与缓冲区**：集合未预设初始容量导致的频繁扩容与重分配、频繁的数组拷贝、低效字符串拼接（应使用 StringBuilder / Span）。
-   - **内存泄漏**：未注销的事件监听（Event）、未释放的非托管资源/句柄/流/GPU 纹理、长生命周期单例持有大对象强引用。
+### 1. 内存与资源分配（Memory & Allocation Overhead）
+* **热路径频繁堆分配（Heap Churn）**：
+  * 在高频热点（紧密循环、请求处理流水线、事件分发循环）中反复创建临时对象或申请动态内存。
+  * 隐式装箱/闭包捕获/低效字符串拼接导致的高频堆内存分配与垃圾回收（GC）暂停。
+* **低效扩容与多余拷贝（Unnecessary Copies & Growth）**：
+  * 动态数组/切片/集合未预分配容量导致的反复重分配与内存搬移。
+  * 传值未利用引用/指针/切片/视图（如 Span/string_view/byte-slice/borrowing）导致的大数据结构全量深拷贝。
+* **资源与内存泄漏（Resource Leaks）**：
+  * 未正确释放的系统句柄、网络连接、数据库会话、文件流或未解绑的长生命周期监听器。
 
-2. **CPU 与算法复杂度（CPU & Complexity）**：
-   - **复杂度退化**：高频热点中 $O(N^2)$ 或更高复杂度的嵌套循环与线性查找（应替换为 Dictionary/HashMap/HashSet 索引）。
-   - **昂贵反射与深拷贝**：热点路径中频繁反射（Reflection）、动态解析、低效序列化。
-   - **主线程阻塞**：UI 线程或渲染主线程中执行同步大文件读取或阻塞性 I/O。
+### 2. 计算与算法时间复杂度（Compute & Complexity）
+* **时间复杂度退化**：
+  * 热点路径中出现 O(N²) 或更高复杂度的嵌套循环。
+  * 在大规模数据集上使用线性遍历（O(N)），未合理构建或使用哈希表、树或索引（O(1) / O(log N)）。
+* **热路径昂贵操作（Expensive Operations in Hot-Paths）**：
+  * 循环或高频方法中调用昂贵的运行时反射、动态类型解析、重复的正则编译或重复序列化/反序列化。
+  * 重复计算未缓存：在不变的数据集上反复执行高开销的解析或过滤。
+* **执行线程阻塞（Thread / Event-Loop Blocking）**：
+  * 在单线程事件循环（如 Node.js/UI 主线程）或有限工作线程中执行耗时的同步阻塞 I/O 或 CPU 密集计算。
 
-3. **并发与锁竞争（Concurrency & Contention）**：
-   - 锁粒度过大、在锁内执行耗时 I/O、无界队列、死锁与假共享（False Sharing）。
+### 3. 并发、锁与 I/O 放大（Concurrency & I/O Overhead）
+* **锁竞争与并发隐患（Lock Contention & Starvation）**：
+  * 锁粒度过大、在持有互斥锁期间执行慢速 I/O 操作、锁争用导致的线程频繁挂起与上下文切换。
+* **I/O 放大与缺少批处理（I/O Amplification）**：
+  * 经典的 N+1 查询/请求反模式：在循环中发起独立的数据库查询或 RPC 调用（未做批量化 Batching / Pipeline）。
+  * 缺少流式处理：一次性将数 GB 的全量数据读取到内存中，而不是使用迭代器/流式分块处理。
 
-4. **基准测试探索与执行（Benchmark Runner）**：
-   - **自动探测**：主动检查工作区是否存在基准测试套件（如 `BenchmarkDotNet`、`go test -bench`、`cargo bench`、`pytest-benchmark`、`vitest bench` 等）。
-   - **有条件执行**：若存在现成的基准测试且安全可运行，使用 `bash` 运行一次并提取关键指标（单次耗时、单次分配字节数）。
-   - **基准代码生成**：若当前改动属于核心热点但缺乏 Benchmark，在报告中给出一段针对该场景的标准基准测试代码建议。
+---
+
+### 4. ⏱️ 自动化基准测试探针（Benchmark Discovery & Execution）
+* **智能探测**：检查工作区是否配置了基准测试工具：
+  * **Go**：`go test -bench=. -benchmem`
+  * **Rust**：`cargo bench` / `criterion`
+  * **C# / .NET**：`BenchmarkDotNet` / 性能测试工程
+  * **Python**：`pytest-benchmark` / `timeit`
+  * **C/C++**：`Google Benchmark`
+  * **Node.js / TS**：`vitest bench` / `mitata` / `tinybench`
+  * **CLI**：`hyperfine`
+* **有条件执行**：若工作区存在轻量安全的基准测试，可尝试执行一次并提取纳秒级耗时（ns/op）与分配指标（B/op, allocs/op）。
+* **Benchmark 代码生成**：若当前改动属于高风险核心热点但**缺少基准测试**，在报告中给出一段针对该场景的轻量 Benchmark 代码模板，方便开发者直接压测。
 
-## 执行步骤
+---
+
+## 📋 执行流程
 1. 读取任务中的 diff 文件与 manifest 清单。
-2. 重点分析改动中涉及性能与资源管理的关键代码，必要时读取上下文文件。
+2. 重点排查改动中涉及热点循环、数据结构选型、内存申请与并发/IO 的代码。
 3. 检查并运行基准测试（如适用）。
-4. 输出格式规范的 Markdown 报告并在最末尾附带 JSON 块。
+4. 输出结构化的 Markdown 性能报告，并在末尾输出供机器读取的 JSON 块。
 
-## 输出格式（必须使用中文撰写总结与描述）
+---
 
-请以 Markdown 格式输出最终回复：
+## 📄 输出格式（必须使用纯正中文撰写）
 
 ## Summary
-一句话中文性能总结（评定本次修改的性能影响：优秀 / 无明显影响 / 存在性能隐患 / 严重性能退化）。
+一句话中文性能总结（评定性能等级：性能提升 / 优秀无影响 / 存在低效瓶颈 / 严重性能退化）。
 
 ## Findings
-每个发现一行：`- [SEVERITY|category|confidence] 文件路径:行号 — 中文问题描述、分配分析与优化建议`。无问题写 `No findings.`。
+每个发现一行：`- [SEVERITY|category|confidence] 文件路径:行号 — 中文问题描述、复杂度/分配分析与优化方案`。无明显性能问题写 `No findings.`。
 
 ## Benchmark Analysis
-说明工作区中基准测试探测结果与运行数据。若无基准测试，可针对改动热点提供一段简短的 Benchmark 编写建议。
+说明工作区中的基准测试探测情况与运行数据。若无基准测试且改动涉及热点，提供一段建议编写的 Benchmark 代码。
 
 ## Coverage
 - Files checked: 检查的文件
-- Commands run: 执行的基准测试或检查命令
+- Commands run: 执行的基准测试或排查命令
 - Limitations: 局限说明
 
 然后在最末尾严格输出一个被 ```json 代码块包裹的 JSON：
@@ -59,9 +84,9 @@ inheritSkills: false
 {
   "status": "ok",
   "issues": [
-    { "file": "src/Manager.cs", "line": 42, "category": "perf", "severity": "major", "confidence": 9, "evidence": "Update 循环中存在 new GC 堆分配，且高频调用 LINQ 查询", "fingerprint": "src/Manager.cs:42:perf:a1b2c3" }
+    { "file": "path/to/file", "line": 100, "category": "perf", "severity": "major", "confidence": 9, "evidence": "在热点循环内存在高频堆分配与 O(N^2) 线性查找，建议改为预分配并在外部构建哈希索引", "fingerprint": "path/to/file:100:perf:a1b2c3" }
   ],
   "summary": "中文一句话性能总结",
-  "coverage": { "filesChecked": ["src/Manager.cs"], "commandsRun": [], "limitations": [] }
+  "coverage": { "filesChecked": ["path/to/file"], "commandsRun": [], "limitations": [] }
 }
 ```

package/extensions/review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifan/pi-review-zh",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Pi AI 并发代码审查扩展（多专家子代理并发 + 门禁裁判系统，中文增强版）",
   "type": "module",
   "license": "MIT",

package/extensions/review/src/config.ts

@@ -24,7 +24,7 @@ import type { PiReviewConfig, ReviewerSpec, RoutingMode, VerdictPolicy } from ".
  * reviewers stay on "inherit" to follow the parent session's stronger model.
  * Override via config.json (`gate.model`) or `--gate-model`.
  */
-export const DEFAULT_GATE_MODEL = "anthropic/claude-haiku-4-5";
+export const DEFAULT_GATE_MODEL = "inherit";
 
 /** Default reviewer and gate config shipped with the package (v0.7). */
 export const DEFAULT_CONFIG: PiReviewConfig = {

package/extensions/review/src/directive.ts

@@ -340,7 +340,12 @@ export function buildWorkflowScript(input: {
 		lines.push(`    agent: ${JSON.stringify(LEAN_GATE_AGENT)},`);
 		lines.push("    task: gateTask,");
 		lines.push(`    cwd: ${JSON.stringify(workspacePath)},`);
-		lines.push(`    model: ${JSON.stringify(gateModelWithThinking)},`);
+		if (gateModel && gateModel !== "inherit") {
+			lines.push(`    model: ${JSON.stringify(gateModelWithThinking)},`);
+		}
+		if (gateThinking && gateThinking !== "off" && gateThinking !== "false") {
+			lines.push(`    thinking: ${JSON.stringify(gateThinking)},`);
+		}
 		lines.push(`    toolBudget: { soft: ${budgets.gateToolBudget.soft}, hard: ${budgets.gateToolBudget.hard} },`);
 		lines.push(`    turnBudget: { maxTurns: ${budgets.gateTurnBudget.maxTurns}, graceTurns: ${budgets.gateTurnBudget.graceTurns} },`);
 		lines.push("  });");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifan/pi-unifan-zh",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Pi Coding Agent 中文扩展全家桶与独立插件集",
   "type": "module",
   "main": "extensions/sessions/index.ts",
@@ -11,7 +11,8 @@
   "pi": {
     "extensions": [
       "./extensions/sessions/index.ts",
-      "./extensions/review/index.ts"
+      "./extensions/review/index.ts",
+      "./extensions/commit/index.ts"
     ],
     "subagents": {
       "agents": [