@unifan/pi-unifan-zh 1.0.33 → 1.0.35

package/AGENTS.md

@@ -30,13 +30,19 @@ pi-unifan-zh/
 │   │   │   ├── history-context.md # 历史上下文专家
 │   │   │   └── code-comments.md   # 注释检查专家
 │   │   └── package.json           # 独立子包: @unifan/pi-review-zh
-│   └── commit/                    # ③ 智能 Git 提交助手 (/commit, /commit-push)
-│       ├── index.ts               # 一键提交与推流命令
+│   ├── commit/                    # ③ 智能 Git 提交助手 (/commit, /commit-push)
+│   │   ├── index.ts               # 一键提交与推流命令
+│   │   ├── src/
+│   │   │   ├── git.ts             # Git 执行引擎 (含自动变基 pull --rebase)
+│   │   │   └── prompt.ts          # Conventional Commits 中文提示词
+│   │   └── package.json           # 独立子包: @unifan/pi-commit-zh
+│   └── workflow/                  # ④ 复合工程工作流引擎 (/workflow)
+│       ├── index.ts               # 工具与输出过滤器注册
 │       ├── src/
-│       │   ├── git.ts             # Git 执行引擎 (含自动变基 pull --rebase)
-│       │   └── prompt.ts          # Conventional Commits 中文提示词
-│       └── package.json           # 独立子包: @unifan/pi-commit-zh
-└── skills/                        # 内置专业技能集
+│       │   ├── tools/             # workflow_state, artifact_helper, session_checkpoint
+│       │   └── filters/           # bash_output_filter, read_output_filter
+│       └── package.json           # 独立子包: @unifan/pi-workflow-zh
+└── skills/                        # 内置专业技能集 (00-next ~ 05-learn)
 ```
 
 ---
@@ -128,7 +134,12 @@ cd D:\program\my\pi-unifan-zh\extensions\commit
 npm version patch
 npm publish --access public
 
-# 4. 提交版本号变更到 Git 远端
+# 4. 升级并发布 workflow 子包 (@unifan/pi-workflow-zh)（如有修改）
+cd D:\program\my\pi-unifan-zh\extensions\workflow
+npm version patch
+npm publish --access public
+
+# 5. 提交版本号变更到 Git 远端
 cd D:\program\my\pi-unifan-zh
 git add .
 git commit -m "chore(release): 升级版本号至 vX.Y.Z"

package/README.md

@@ -17,11 +17,18 @@ pi-unifan-zh/
 ├── AGENTS.md                 # Developer and AI agent guidelines
 ├── README.md                 # English Documentation
 ├── README_zh.md              # Chinese Documentation
-├── extensions/               # 📦 Individual Extension Packages
+├── extensions/               # 📦 Extension Packages
 │   ├── sessions/             # 📜 ① Dual-pane session manager with live preview (Chinese)
 │   ├── review/               # 🔍 ② AI multi-agent code review suite (Daily/Lite/Perf/Full)
-│   └── commit/               # 📦 ③ Intelligent Conventional Commits assistant (Chinese)
-└── skills/                   # 🎯 Custom prompt skills library
+│   ├── commit/               # 📦 ③ Intelligent Conventional Commits assistant (Chinese)
+│   └── workflow/             # 🔄 ④ Compound Engineering Workflow engine (State/Checkpoints/Filters)
+└── skills/                   # 🎯 Compound Engineering Skills (00-next ~ 05-learn)
+    ├── 00-next/              # 🚦 Router & orchestrator (inspects repo state, recommends next step)
+    ├── 01-brainstorm/        # 💡 Discovery & flexible interactions (single/multi-select/custom text)
+    ├── 02-plan/              # 📐 TDD architecture planning & Implementation Units
+    ├── 03-work/              # 🛠️ Strict TDD coding execution & checkpoint resume
+    ├── 04-review/            # 🧐 Code review, spec verification & regression testing
+    └── 05-learn/             # 📝 Lightweight solution cards & knowledge compounding
 ```
 
 ---
@@ -49,19 +56,44 @@ pi install D:/program/my/pi-unifan-zh
 
 ### Option B: Install Individual Extensions
 
+Each extension is published as a standalone npm package and can be installed individually:
+
+> 💡 **Note**: Pi CLI's `git:` source only supports cloning the entire repository root. For **installing individual extensions**, use the recommended `npm:` method or local paths.
+
 #### 1. Install `sessions` (Session Manager with TUI Preview):
 ```bash
+# Via npm
 pi install npm:@unifan/pi-sessions-zh
+# Or via local path
+pi install D:/program/my/pi-unifan-zh/extensions/sessions
 ```
 
 #### 2. Install `review` (AI Parallel Code Review Suite):
 ```bash
+# Via npm
 pi install npm:@unifan/pi-review-zh
+# Or via local path
+pi install D:/program/my/pi-unifan-zh/extensions/review
 ```
 
 #### 3. Install `commit` (Intelligent Git Commit Assistant):
 ```bash
+# Via npm
 pi install npm:@unifan/pi-commit-zh
+# Or via local path
+pi install D:/program/my/pi-unifan-zh/extensions/commit
+```
+
+#### 4. Install `workflow` (Compound Engineering Engine & Skills):
+> Includes `/workflow` command, checkpoint persistence, token filters, and all 6 workflow skills (`00-next` ~ `05-learn`).
+```bash
+# Via npm
+pi install npm:@unifan/pi-workflow-zh
+# Or via local path
+pi install D:/program/my/pi-unifan-zh/extensions/workflow
+
+# Recommended peer question UI extension:
+pi install npm:@juicesharp/rpiv-ask-user-question
 ```
 
 ---
@@ -91,6 +123,7 @@ pi install npm:@unifan/pi-commit-zh
   - **Dual Execution Engine**:
     - ① **Single-Model Native Review (Default & Recommended)**: 0 subagent dependencies, 0 network dropouts, ultra-fast & 100% reliable.
     - ② **Multi-Subagent Concurrent Review**: Freely configure **2, 3, 4, 5, or 6** concurrent expert subagents (Bugbot, Security, Perf, Compliance, Comments, History).
+  - **Session Model & Thinking Level Inheritance**: Single-model review and final synthesis run directly in the current session. Multi-expert review launches through one asynchronous workflow and explicitly passes the current session's `provider/model:thinking-level` to every expert, preventing subagent defaults from overriding the session settings.
 - **Commands**:
   - **`/review`** 🔍: Launches interactive Chinese TUI menu with 6 review modes + settings:
     - ① `Review uncommitted changes` (staged + unstaged working tree, smart default)
@@ -117,7 +150,7 @@ pi install npm:@unifan/pi-commit-zh
 
 ### 3. 📦 `commit` (Intelligent Conventional Commits Assistant)
 - **Commands**:
-  - **`/commit`**: Analyzes `git diff`, generates standardized Conventional Commits in fluent Chinese, and commits in 1 second.
+  - **`/commit`**: Analyzes staged and working-tree changes (`git diff`), uses the current session's model and thinking level through the provider's unified parameter handling, and generates a Chinese Conventional Commit message from the actual staged changes before committing. Authentication, request, empty-response, or output-validation failures display the reason and stop the commit and push, preserving staged changes without substituting a generic fallback message.
   - **`/commit-push`** 🚀: Generates Chinese commit and automatically executes `git push` to remote.
 - **Usage & Flags**:
   - `/commit`: Smart commit (commits staged changes if staged, or auto-stages all if unstaged).
@@ -133,6 +166,51 @@ pi install npm:@unifan/pi-commit-zh
 
 ---
 
+### 4. 🔄 `workflow` & Compound Engineering Workflow Suite
+Turn your AI coding agent into a disciplined software engineer through an iterative stage-gated pipeline:
+
+```text
+00-next  ──>  01-brainstorm  ──>  02-plan  ──>  03-work  ──>  04-review  ──>  05-learn
+ (Router)        (Discovery)      (TDD Plan)    (Execution)      (Review)      (Compounding)
+```
+
+- **Commands & Tools**:
+  - **`/workflow`**: Inspect current project stage, artifact counts, active autonomous driving loop progress, and recommended next skill.
+  - **`workflow_state` tool**: Automatically scans `docs/` and `.context/checkpoints/` state.
+  - **`artifact_helper` tool**: Resolves standardized artifact paths for requirements, plans, and solutions.
+  - **`session_checkpoint` tool**: Saves and restores execution breakpoints at the Implementation Unit level — resume right from where you left off.
+- **6 Built-in Pipeline Skills**:
+  - **`00-next` (Router & Orchestrator)**: Say `continue` or type `/skill:00-next`, and it automatically guides you to the right next step.
+  - **`01-brainstorm` (Requirements Discovery)**: Clarifies scope and architecture decisions. **Pairs with `@juicesharp/rpiv-ask-user-question`** for flexible interactions: single-select (1-9 hotkeys) for mutually exclusive choices, multi-select checkboxes for feature lists, and custom text inputs.
+  - **`02-plan` (Architecture Planning)**: Decomposes requirements into TDD Implementation Units following The Ladder minimalism principles.
+  - **`03-work` (Autonomous Loop TDD Coding)** 🚀: **Built-in autonomous continuation engine similar to `goal`**. Directly invoking `/skill:03-work` starts a background cross-turn driver that sequentially executes Implementation Units with red-green-refactor, **never stopping until all planned units are 100% completed**! Supports checkpoint resumption and strict Stop-The-Line policy. Type `pause`, `stop`, or press `Esc` to pause anytime.
+  - **`04-review` (Quality & Spec Review)**: Verifies git diff, checks Spec contract compliance, and ensures clean regression tests.
+  - **`05-learn` (Knowledge Compounding)**: Lightweight, pragmatic pitfall compounding into `docs/solutions/` — zero noise, only non-trivial insights.
+- **Context Optimizers (Token Savers)**:
+  - **`bash` smart filter**: Automatically summarizes verbose command outputs (`npm install`, verbose logs), saving 80%+ context tokens.
+  - **`read` smart filter**: Compresses oversized lockfiles (e.g. `package-lock.json`) and long logs into compact structural summaries.
+
+### 🔄 How 03-work Autonomous Loop Works
+
+Traditional AI coding tools stop after each turn, asking for user confirmation before doing the next step. `03-work` natively integrates the `WorkLoopDriver` engine:
+1. **Lifecycle Event Hook**: Binds to Pi's `agent_settled` event to verify execution state immediately after each turn finishes.
+2. **Bi-directional Checkpoint Sync**: Re-reads `.context/checkpoints/` and the active plan to ensure in-memory and disk states match.
+3. **Autonomous Continuation**: If units remain, dispatches a follow-up turn (`deliverAs: "followUp"`), driving red-green-refactor cycles autonomously across turns until all units pass.
+4. **Safety Valves**:
+   - **Stop-The-Line**: Automatically pauses upon 3 consecutive failures on the same unit, preserving exact error context.
+   - **50-Turn Safety Threshold**: Prevents runaway looping.
+   - **Interactive Pause**: Hit `Esc` or type `pause` / `stop` anytime to safely suspend.
+5. **Auto-Handover**: Automatically cascades into `/skill:04-review` once all units are verified green.
+
+---
+
+## 💡 Acknowledgments & References
+
+The Compound Engineering workflow pipeline in this repository draws deep architectural inspiration and reference from:
+- **[`@leing2021/super-pi`](https://github.com/leing2021/super-pi)**: Special thanks to `super-pi` for its pioneering design of Pi-native Compound Engineering pipelines, checkpoint resumes, and artifact management patterns. In this project, we re-architected the terminal interaction to unlock multi-select capabilities, introduced the **`00-next` router**, streamlined **`05-learn`**, and fully integrated **`@juicesharp/rpiv-ask-user-question`** for rich terminal UI dialogs.
+
+---
+
 ## 📄 License
 
 MIT License.

package/README_zh.md

@@ -15,11 +15,18 @@ pi-unifan-zh/
 ├── AGENTS.md                 # 开发者与智能体规范指南
 ├── README.md                 # English Documentation
 ├── README_zh.md              # 中文说明文档
-├── extensions/               # 📦 独立插件集
+├── extensions/               # 📦 扩展插件集
 │   ├── sessions/             # 📜 ① 历史会话管理器（双栏实时预览与恢复·中文增强版）
 │   ├── review/               # 🔍 ② AI 代码审查套件（日常3专家 / 极速单兵 / 性能探针 / 全量会诊）
-│   └── commit/               # 📦 ③ 智能 Git 提交助手（Conventional Commits 纯中文规范版）
-└── skills/                   # 🎯 自定义技能库
+│   ├── commit/               # 📦 ③ 智能 Git 提交助手（Conventional Commits 纯中文规范版）
+│   └── workflow/             # 🔄 ④ 复合工程工作流引擎（状态感知 / 断点续跑 / 输出压缩）
+└── skills/                   # 🎯 复合工程流程技能库 (00-next ~ 05-learn)
+    ├── 00-next/              # 🚦 流程导航调度器（自动分析仓库产物并推荐下一步）
+    ├── 01-brainstorm/        # 💡 需求发现与交互对齐（单选/多选复选框/开放问答）
+    ├── 02-plan/              # 📐 TDD 架构规划与 Implementation Units 拆解
+    ├── 03-work/              # 🛠️ 严格 TDD 编码执行与断点持久化
+    ├── 04-review/            # 🧐 代码审查与回归测试闭环
+    └── 05-learn/             # 📝 极简避坑指南与经验复利沉淀
 ```
 
 ---
@@ -47,19 +54,44 @@ pi install D:/program/my/pi-unifan-zh
 
 ### 模式 B：按需单独安装单个插件
 
+每个插件均已独立打包并发布至 npm，可根据需要挑选单独安装（互不依赖，开箱即用）：
+
+> 💡 **提示**：Pi CLI 的 `git:` 方式仅支持安装整个仓库根目录；若需**按模块单独安装**，请使用推荐的 `npm:` 方式或本地绝对路径。
+
 #### 1. 仅安装 `sessions`（历史会话管理器·中文版）：
 ```bash
+# npm 在线单独安装
 pi install npm:@unifan/pi-sessions-zh
+# 或本地路径安装
+pi install D:/program/my/pi-unifan-zh/extensions/sessions
 ```
 
 #### 2. 仅安装 `review`（AI 代码审查系统·中文版）：
 ```bash
+# npm 在线单独安装
 pi install npm:@unifan/pi-review-zh
+# 或本地路径安装
+pi install D:/program/my/pi-unifan-zh/extensions/review
 ```
 
 #### 3. 仅安装 `commit`（智能 Git 提交助手·中文版）：
 ```bash
+# npm 在线单独安装
 pi install npm:@unifan/pi-commit-zh
+# 或本地路径安装
+pi install D:/program/my/pi-unifan-zh/extensions/commit
+```
+
+#### 4. 仅安装 `workflow`（复合工程工作流引擎与全套技能·中文版）：
+> 包含 `/workflow` 命令、断点续跑、Token压缩器以及完整的 6 大流程技能 (`00-next` ~ `05-learn`)。
+```bash
+# npm 在线单独安装
+pi install npm:@unifan/pi-workflow-zh
+# 或本地路径安装
+pi install D:/program/my/pi-unifan-zh/extensions/workflow
+
+# 推荐搭配安装交互提问工具（支持现代终端多选复选框与单选）：
+pi install npm:@juicesharp/rpiv-ask-user-question
 ```
 
 ---
@@ -90,6 +122,7 @@ pi install npm:@unifan/pi-commit-zh
   - **双执行引擎自由切换**：
     - ① **单模型深度审查（默认推荐）**：0 子代理依赖，0 网络断流，极速且 100% 稳定。
     - ② **多 Subagent 并发审查**：支持自由配置并发启动 **2、3、4、5、6** 个专家子代理协同会诊（Bug猎手、安全专家、性能探针、规范合规、注释质量、历史脉络）。
+  - **会话模型与思考档位继承**：单模型审查和主审汇总直接使用当前会话；多专家审查通过一个异步工作流启动，在每个专家请求中显式传入当前会话的 `提供方/模型:思考档位`，避免被子代理默认配置覆盖。
 - **核心审查命令**：
   - **`/review`** 🔍 **（交互式全功能审查）**：唤起全中文 TUI 选择弹窗，支持 6 种审查模式与配置中心：
     - ① `审查未提交改动` (工作区已暂存 + 未暂存代码，智能默认推荐)
@@ -122,7 +155,7 @@ pi install npm:@unifan/pi-commit-zh
 
 ### 3. 📦 `commit`（智能 Git 提交助手·中文版）
 - **命令**：
-  - **`/commit`**：自动分析暂存区/工作区代码变动（`git diff`），使用当前会话模型，根据实际暂存内容生成标准的 Conventional Commits 纯中文提交信息后提交。模型认证、请求、空结果或输出校验失败时会显示原因并停止提交与推送，保留暂存内容，不再使用固定兜底文案。
+  - **`/commit`**：自动分析暂存区/工作区代码变动（`git diff`），使用当前会话模型与思考档位，由提供方统一转换模型参数，根据实际暂存内容生成标准的 Conventional Commits 纯中文提交信息后提交。模型认证、请求、空结果或输出校验失败时会显示原因并停止提交与推送，保留暂存内容，不再使用固定兜底文案。
   - **`/commit-push`** 🚀：自动生成中文 Commit 提交，并**自动执行 `git push` 推送**到远端分支。
 - **常用参数与用法**：
   - `/commit`：智能提交（有暂存只提暂存，无暂存自动暂存全量）。
@@ -138,6 +171,51 @@ pi install npm:@unifan/pi-commit-zh
 
 ---
 
+### 4. 🔄 `workflow` 与复合工程流 (Compound Engineering)
+本套件内嵌完整的 **Pi 原生复合工程流体系**，将 AI 辅助编程从“随性写代码”升级为“严格的工程流水线”：
+
+```text
+00-next  ──>  01-brainstorm  ──>  02-plan  ──>  03-work  ──>  04-review  ──>  05-learn
+ (智能调度)       (需求澄清)       (TDD计划)      (断点编码)      (质量审查)     (极简复盘)
+```
+
+- **核心命令与工具**：
+  - **`/workflow`**：快速在终端查看当前项目工作流阶段、各产物数量、当前自主循环进度与下一步推荐技能。
+  - **`workflow_state`** 工具：自动扫描 `docs/` 与 `.context/checkpoints/` 状态。
+  - **`artifact_helper`** 工具：规范化解析和建立需求、计划与避坑文档。
+  - **`session_checkpoint`** 工具：以 Implementation Unit 为粒度记录执行断点，**写一半中断后再次启动自动从断点续跑，绝不重头重来**。
+- **6 大内置流程技能**：
+  - **`00-next`（智能路标）**：用户随口说 `continue`、`下一步` 或输入 `/skill:00-next`，自动探查当前进度并无缝引导至下一个环节。
+  - **`01-brainstorm`（需求发现）**：引导需求澄清，**灵活调用 `@juicesharp/rpiv-ask-user-question`**：互斥方案用单选（1-9直选）、模块清单用多选复选框、开放问题自由输入，自然对齐技术方案。
+  - **`02-plan`（计划拆解）**：将需求拆解为包含验证命令与改动清单的 Implementation Units，坚持极简阶梯（The Ladder）原则。
+  - **`03-work`（跨回合自主循环驱动编码）** 🚀：**原生内置类似 `goal` 的连续自动驱动引擎**。直接使用 `/skill:03-work`（或要求执行计划）启动后，后台引擎按计划中的 Implementation Units 逐单元跨回合自主推进“红-绿-重构”，**不做完规划任务绝不停机**！支持断点续跑与遇错即停（Stop-the-line）硬门禁；如需暂停，输入 `暂停`、`pause` 或按 `Esc` 即可。
+  - **`04-review`（审查闭环）**：全量代码审查、Spec 需求符合度核验、回归测试绿灯检查。
+  - **`05-learn`（极简知识复盘）**：价值门禁驱动，仅沉淀非平凡的疑难避坑卡片至 `docs/solutions/`，坚决不制造文档噪音。
+- **内置上下文优化黑科技 (Token Saver)**：
+  - **`bash` 输出智能过滤器**：自动压缩长终端命令输出（如 `npm install`、长日志），保留首尾关键行，节省 80%+ 上下文 Token！
+  - **`read` 输出智能过滤器**：智能压缩 `package-lock.json` 等超大文件，只保留版本和依赖概览。
+
+### 🔄 03-work 跨回合自主循环工作原理
+
+传统 AI 编程助手往往在单个回合输出后便停下等待用户确认，导致长流程编码被频繁打断。`03-work` 原生集成了 `WorkLoopDriver` 跨回合自主驱动引擎：
+1. **事件级生命周期监听**：挂载 Pi 的 `agent_settled` 事件，在每回合执行完毕且环境就绪时自动触发状态核验。
+2. **磁盘断点双向校验**：实时扫描 `.context/checkpoints/` 与规划文件中的 Implementation Units，确保内存与磁盘状态强一致。
+3. **自主连续推进**：若存在剩余未完成单元，驱动器防抖调度后续消息（`deliverAs: "followUp"`），实现跨回合无人值守自主编码与单测验证，**不做完计划绝不停机**。
+4. **多重安全防护阀**：
+   - **Stop-The-Line 遇错即停**：同一单元若连续 3 次排查修复失败，强制停机并完整记录错误现场，杜绝无效死循环与 Token 浪费。
+   - **50 轮安全轮次上限**：防止异常任务无休止推进。
+   - **随时安全打断**：按下 `Esc` 或输入 `暂停` / `pause`，随时安全挂起循环。
+5. **闭环自动流转**：全量单元绿灯通过后，自动交接调度 `/skill:04-review` 进行代码审查与回归验证。
+
+---
+
+## 💡 致谢与参考 (Acknowledgments)
+
+本扩展库中的复合工程工作流（Compound Engineering）模块深度参考并借鉴了以下优秀开源项目的架构思想：
+- **[`@leing2021/super-pi`](https://github.com/leing2021/super-pi)**：特别致谢 `super-pi` 项目对复合工程流流水线、断点续传（Checkpoints）与产物治理模式的探索与启发。本项目在汲取其精髓的基础上，全面重构了终端交互体验，解除了只能单选的限制，引入了 **`00-next` 智能调度导航**、**极简避坑复盘 `05-learn`**，并深度打通了 **`@juicesharp/rpiv-ask-user-question`** 的现代多选复选框终端交互体系。
+
+---
+
 ## 📄 开源许可证
 
 本项目基于 [MIT License](./LICENSE) 协议开源。

package/extensions/commit/index.ts

@@ -40,6 +40,7 @@ export async function generateCommitMessage(
 	diff: string,
 	changedFiles: string[],
 	userHint?: string,
+	thinkingLevel = ctx.thinkingLevel,
 ): Promise<string> {
 	const truncatedDiff = diff.length > 30000 ? diff.slice(0, 30000) + "\n\n... (diff已截断)" : diff;
 	const userPrompt = [
@@ -56,16 +57,29 @@ export async function generateCommitMessage(
 		.join("\n");
 
 	if (!ctx.model) throw new Error("当前未选择模型，请先使用 /model 选择模型。");
-	if (typeof ctx.modelRegistry?.complete !== "function")
+	if (typeof ctx.modelRegistry?.getProvider !== "function" || typeof ctx.modelRegistry?.getProviderAuth !== "function")
 		throw new Error("当前 Pi 不支持统一模型调用接口，请更新 Pi 后重试。");
-
-	// 由宿主统一解析认证、代理地址及提供方环境，避免手动调用遗漏配置。
-	const response = await ctx.modelRegistry.complete(ctx.model, {
+	const modelLabel = `${ctx.model.provider}/${ctx.model.id}`;
+	const provider = ctx.modelRegistry.getProvider(ctx.model.provider);
+	if (!provider) throw new Error(`模型 ${modelLabel} 的提供方不可用，请重新选择模型。`);
+	const resolved = await ctx.modelRegistry.getProviderAuth(ctx.model.provider);
+	if (!resolved) throw new Error(`模型 ${modelLabel} 的认证未配置，请先完成登录或配置认证。`);
+
+	// 宿主解析认证、代理地址和环境；统一接口按模型能力转换会话思考档位，避免底层调用默认发送 none。
+	const model = resolved.auth.baseUrl ? { ...ctx.model, baseUrl: resolved.auth.baseUrl } : ctx.model;
+	const response = await provider.streamSimple(model, {
 		systemPrompt: COMMIT_SYSTEM_PROMPT,
 		messages: [{ role: "user", content: [{ type: "text", text: userPrompt }], timestamp: Date.now() }],
-	}, { maxTokens: 4096, signal: ctx.signal });
+	}, {
+		maxTokens: 4096,
+		signal: ctx.signal,
+		reasoning: thinkingLevel === "off" ? undefined : thinkingLevel,
+		apiKey: resolved.auth.apiKey,
+		headers: resolved.auth.headers,
+		env: resolved.env,
+	}).result();
 	if (response.stopReason !== "stop")
-		throw new Error(`模型未正常完成生成（${response.stopReason}）：${response.errorMessage || "请检查模型状态后重试。"}`);
+		throw new Error(`模型 ${modelLabel} 未正常完成生成（${response.stopReason}）：${response.errorMessage || "请检查模型状态后重试。"}`);
 
 	const text = response.content.map((c) => c.type === "text" ? c.text : "").join("").trim()
 		.replace(/^```[a-zA-Z]*\r?\n?/, "").replace(/\r?\n?```$/, "").trim();
@@ -143,7 +157,9 @@ export default function (pi: ExtensionAPI) {
 		try {
 			if (!stagedDiff.trim()) throw new Error("暂存区没有可用于生成提交信息的差异。");
 			const changedFiles = await getStagedFiles(ctx.cwd);
-			commitMessage = await generateCommitMessage(ctx, stagedDiff, changedFiles, parsed.hint);
+			commitMessage = await generateCommitMessage(
+				ctx, stagedDiff, changedFiles, parsed.hint, ctx.thinkingLevel ?? pi.getThinkingLevel(),
+			);
 		} catch (error) {
 			// 生成失败必须停止，禁止用固定文案继续提交或推送。
 			const reason = error instanceof Error ? error.message : String(error);

package/extensions/commit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifan/pi-commit-zh",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "Pi 智能 Git 提交助手（规范化 Conventional Commits 纯中文版，支持一键提审与推流）",
   "type": "module",
   "main": "index.ts",

package/extensions/commit/tests/commit.test.mjs

@@ -6,6 +6,7 @@ import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { execFileSync } from 'node:child_process';
 import ts from 'typescript';
+import { stream, streamSimple } from '@earendil-works/pi-ai/api/openai-responses';
 
 // 在临时目录编译并运行真实命令，不访问开发仓库的提交记录。
 const root = await mkdtemp(join(tmpdir(), 'pi-commit-test-'));
@@ -20,7 +21,17 @@ for (const name of ['index', 'src/git', 'src/prompt']) {
 const { default: register, generateCommitMessage } = await import(pathToFileURL(join(root, 'index.js')));
 const { getStagedFiles } = await import(pathToFileURL(join(root, 'src/git.js')));
 const model = { id: '当前模型', provider: '当前提供方' };
-function context(complete) { return { model, modelRegistry: { complete } }; }
+function context(complete) {
+  const provider = { streamSimple: (...args) => ({ result: () => complete(...args) }) };
+  return {
+    model,
+    thinkingLevel: 'high',
+    modelRegistry: {
+      getProvider: () => provider,
+      getProviderAuth: async () => ({ auth: { apiKey: '测试凭据' } }),
+    },
+  };
+}
 function response(text, stopReason = 'stop') { return { content: [{ type: 'text', text }], stopReason }; }
 
 test('通过宿主统一接口继承当前模型并返回业务日志', async () => {
@@ -28,11 +39,67 @@ test('通过宿主统一接口继承当前模型并返回业务日志', async ()
     assert.equal(actualModel, model);
     assert.match(prompt.messages[0].content[0].text, /修复冲线残留/);
     assert.equal(options.maxTokens, 4096);
+    assert.equal(options.reasoning, 'high');
     return response('```text\nfix(racing): 清理冲线特效残留\n```');
   });
   assert.equal(await generateCommitMessage(ctx, '+ 清理特效', ['角色.cs'], '修复冲线残留'), 'fix(racing): 清理冲线特效残留');
 });
 
+test('继承全部会话思考档位及宿主认证、代理与环境，不修改原模型', async () => {
+  for (const level of ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']) {
+    const signal = new AbortController().signal;
+    const auth = { apiKey: '测试凭据', baseUrl: 'https://proxy.example.invalid/v1', headers: { 'x-test': '测试头' } };
+    const env = { TEST_PROVIDER_REGION: '测试区域' };
+    const ctx = context(async (actualModel, _prompt, options) => {
+      assert.equal(actualModel.id, model.id);
+      assert.equal(actualModel.baseUrl, auth.baseUrl);
+      assert.equal(model.baseUrl, undefined);
+      assert.equal(options.reasoning, level === 'off' ? undefined : level);
+      assert.equal(options.apiKey, auth.apiKey);
+      assert.equal(options.headers, auth.headers);
+      assert.equal(options.env, env);
+      assert.equal(options.signal, signal);
+      return response('fix: 修复思考档位继承');
+    });
+    ctx.thinkingLevel = level;
+    ctx.signal = signal;
+    ctx.modelRegistry.getProviderAuth = async () => ({ auth, env });
+    await generateCommitMessage(ctx, 'diff', ['index.ts']);
+  }
+});
+
+test('真实 OpenAI 适配器复现默认 none，并验证会话档位写入请求体', async () => {
+  const actualModel = {
+    ...model, id: 'gpt-6-astra', api: 'openai-responses', baseUrl: 'https://example.invalid/v1',
+    reasoning: true, input: ['text'], contextWindow: 128000, maxTokens: 16384,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    thinkingLevelMap: { xhigh: 'xhigh', max: 'max' },
+  };
+  let payload;
+  const onPayload = value => { payload = value; throw new Error('已捕获请求，禁止联网'); };
+  const oldResponse = await stream(actualModel, { messages: [] }, { apiKey: '测试凭据', onPayload }).result();
+  assert.match(oldResponse.errorMessage, /已捕获请求/);
+  assert.equal(payload.reasoning.effort, 'none');
+  for (const thinking of ['low', 'medium', 'high', 'xhigh', 'max']) {
+    const ctx = context();
+    ctx.model = actualModel;
+    ctx.thinkingLevel = thinking;
+    ctx.modelRegistry.getProvider = () => ({
+      streamSimple: (requestModel, prompt, options) => streamSimple(requestModel, prompt, { ...options, onPayload }),
+    });
+    await assert.rejects(generateCommitMessage(ctx, 'diff', ['index.ts']), /已捕获请求/);
+    assert.equal(payload.reasoning.effort, thinking);
+  }
+});
+
+test('提供方或认证缺失时停止生成', async () => {
+  const ctx = context(() => { assert.fail('不应请求模型'); });
+  ctx.modelRegistry.getProviderAuth = async () => undefined;
+  await assert.rejects(generateCommitMessage(ctx, 'diff', []), /认证未配置/);
+  ctx.modelRegistry.getProvider = () => undefined;
+  await assert.rejects(generateCommitMessage(ctx, 'diff', []), /提供方不可用/);
+});
+
 test('拒绝空结果、异常完成、截断、非法格式和通用文案', async () => {
   for (const result of [response(''), response('fix: 修复残留', 'error'), response('fix: 修复残留', 'length'), response('说明文字'), response('chore(GameClient): 更新代码与相关配置')]) {
     await assert.rejects(generateCommitMessage(context(async () => result), 'diff', ['角色.cs']));
@@ -59,14 +126,23 @@ test('生成失败不提交或推送，文件清单仅包含暂存区', async ()
   assert.deepEqual(await getStagedFiles(repo), ['角色 文件.cs']);
   const commands = new Map();
   const messages = [];
-  register({ registerCommand: (name, command) => commands.set(name, command), sendMessage: message => messages.push(message) });
+  register({
+    registerCommand: (name, command) => commands.set(name, command),
+    sendMessage: message => messages.push(message),
+    getThinkingLevel: () => 'max',
+  });
   const ctx = { ...context(async () => { throw new Error('认证失败'); }), cwd: repo, hasUI: true, ui: { notify() {} } };
   await commands.get('commit-push').handler('', ctx);
   assert.equal(git('rev-parse', 'HEAD'), head);
   assert.match(messages.at(-1).content, /未执行提交或推送/);
   assert.match(messages.at(-1).content, /认证失败/);
   assert.deepEqual(await getStagedFiles(repo), ['角色 文件.cs']);
-  ctx.modelRegistry.complete = async () => response('fix: 修复角色表现');
+  // 兼容尚未提供 ctx.thinkingLevel 的宿主，从公开会话接口获取实际档位。
+  delete ctx.thinkingLevel;
+  ctx.modelRegistry = context(async (_model, _prompt, options) => {
+    assert.equal(options.reasoning, 'max');
+    return response('fix: 修复角色表现');
+  }).modelRegistry;
   await commands.get('commit').handler('', ctx);
   assert.equal(git('log', '-1', '--format=%B'), 'fix: 修复角色表现');
   assert.notEqual(git('rev-parse', 'HEAD'), head);

package/extensions/review/index.ts

@@ -26,6 +26,7 @@ import { Container, type SelectItem, SelectList, Text } from "@earendil-works/pi
 import path from "node:path";
 import os from "node:os";
 import { promises as fs } from "node:fs";
+import { buildSubagentOrchestrationPrompt } from "./src/orchestration.js";
 
 // 跟踪审查会话来源分支节点（保证单次仅一个活跃审查会话）
 let reviewOriginId: string | undefined = undefined;
@@ -77,89 +78,6 @@ async function saveSettings(settings: ReviewSettings): Promise<void> {
 	}
 }
 
-interface ReviewExpert {
-	id: string;
-	label: string;
-	desc: string;
-	task: string;
-}
-
-const ALL_EXPERTS: ReviewExpert[] = [
-	{
-		id: "pi-review.bugbot",
-		label: "Bug 猎手 (Bugbot)",
-		desc: "逻辑缺陷、空指针、边界溢出、死锁与运行时崩溃",
-		task: "深入排查本次代码改动中的业务逻辑缺陷、空指针、边界异常、并发竞态与未捕获的运行时异常",
-	},
-	{
-		id: "pi-review.security-review",
-		label: "安全专家 (Security)",
-		desc: "输入参数合法性校验、跨目录边界防护与权限隔离",
-		task: "深入排查本次代码改动中的防御性编码缺陷、外部输入未做类型/范围校验、边界防护不足等健壮性隐患",
-	},
-	{
-		id: "pi-review.perf-review",
-		label: "性能探针 (Perf)",
-		desc: "循环内GC内存分配、CPU热点消耗、算法复杂度与资源泄露",
-		task: "深入排查本次代码改动中的性能退化、高频循环内无谓内存分配 (GC压力) 与算法复杂度",
-	},
-	{
-		id: "pi-review.claude-md-compliance",
-		label: "契约合规 (Compliance)",
-		desc: "架构契约、设计模式、模块边界与规范遵循",
-		task: "排查本次代码改动是否违反项目既有架构契约、模块封装规范与规范指南",
-	},
-	{
-		id: "pi-review.code-comments",
-		label: "注释与可读性 (Comments)",
-		desc: "注释与代码逻辑倒挂、误导性命名与维护性隐患",
-		task: "排查本次代码改动中的可读性隐患、注释与逻辑不符、误导性命名与维护风险",
-	},
-	{
-		id: "pi-review.history-context",
-		label: "历史脉络 (History)",
-		desc: "结合 Git 历史演进判断意图，防止历史问题回归",
-		task: "结合代码演变历史，排查本次改动是否破坏既有历史契约或重现已知缺陷",
-	},
-];
-
-function buildSubagentOrchestrationPrompt(
-	concurrency: number,
-	gateEnabled: boolean,
-	targetInstruction: string,
-): string {
-	const count = Math.min(6, Math.max(2, concurrency));
-	const selected = ALL_EXPERTS.slice(0, count);
-
-	const listText = selected.map((exp, idx) => `${idx + 1}. **${exp.label}** (\`${exp.id}\`)：${exp.desc}`).join("\n");
-	const callsExample = selected
-		.map((exp) => {
-			const fullTask = `${targetInstruction}\n\n【专项排查分工】：${exp.task}`;
-			return `subagent({ agent: ${JSON.stringify(exp.id)}, task: ${JSON.stringify(fullTask)} });`;
-		})
-		.join("\n");
-
-	const maxBackticks = (callsExample.match(/`+/g) || []).reduce((max, m) => Math.max(max, m.length), 2);
-	const fence = "`".repeat(maxBackticks + 1);
-
-	return `## 🚀 执行方式：多 Subagent 并发专家审查 (当前配置并发数: ${count} 个专家)
-
-当前已配置并行启动以下 ${count} 个专家子代理进行分工审查：
-
-${listText}
-
-### 协作审查执行规范：
-1. **并发调用子代理**：请在当前回合使用 \`subagent\` 工具**同时并行唤起**上述 ${count} 个专家子代理（单回合发起 ${count} 个并发 tool_call，严禁串行逐个调用）：
-${fence}js
-${callsExample}
-${fence}
-2. **主审裁判长汇总整理**：当所有专家子代理执行完毕返回发现后，请你作为主审裁判长${gateEnabled ? "（门禁裁决）" : ""}：
-   - 全面综合各专家的审查意见，对相同问题进行去重，剔除误报和低置信度内容（注意：项目中合法的内部 GM / Debug 调试工具在确保与正式生产环境隔离的前提下免检）。
-   - 严格按照《核心代码审查准则》的 **[P0~P3]** 等级标准排布审查清单。
-   - 给出最终综合裁决与一句话中文总评。
-3. **语言强制要求**：所有任务入参、思考分析过程、综合汇报与最终报告必须 100% 为纯正中文，严禁出现任何英文段落或未翻译小标题！`;
-}
-
 function setReviewWidget(ctx: ExtensionContext, active: boolean) {
 	if (!ctx.hasUI) return;
 	if (!active) {
@@ -1062,6 +980,13 @@ export default function reviewExtension(pi: ExtensionAPI) {
 			...runtimeSettings,
 		};
 
+		const sessionModel = ctx.model;
+		const thinkingLevel = ctx.thinkingLevel ?? pi.getThinkingLevel();
+		if (settings.mode === "subagents" && !sessionModel) {
+			ctx.ui.notify("当前未选择模型，请先使用 /model 选择模型。", "error");
+			return;
+		}
+
 		let effectiveFreshSession = useFreshSession;
 
 		if (effectiveFreshSession) {
@@ -1110,8 +1035,10 @@ export default function reviewExtension(pi: ExtensionAPI) {
 
 		let fullPrompt = REVIEW_RUBRIC;
 
-		if (settings.mode === "subagents") {
-			fullPrompt += `\n\n---\n\n${buildSubagentOrchestrationPrompt(settings.concurrency, settings.gateEnabled, prompt)}`;
+		if (settings.mode === "subagents" && sessionModel) {
+			fullPrompt += `\n\n---\n\n${buildSubagentOrchestrationPrompt(
+				settings.concurrency, settings.gateEnabled, prompt, sessionModel, thinkingLevel,
+			)}`;
 		}
 
 		fullPrompt += `\n\n---\n\n## 本次审查任务指示\n\n${prompt}`;

package/extensions/review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifan/pi-review-zh",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "description": "Pi 交互式 AI 代码审查扩展（支持单模型与多 Subagent 并发 2~6 专家自由切换，Codex 经典架构）",
   "type": "module",
   "license": "MIT",