pi-pstack-native 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,10 +1,18 @@
 # Changelog
 
-## Unreleased
+## 1.0.1 — 2026-11-01
 
+- Show Chinese beside the English text in `/setup-pstack` prompts, options, review rows and notices, in both the direct UI and RPC mode. English option values stay stable, so existing UI integrations keep working.
+- Suggest the first panel seat from the upstream Claude family and the second from the Grok family when Pi exposes them, instead of reusing the parent model.
+- Keep cross-judge selection inside the configured panel pool. When no eligible entry exists, report it and return candidates for the coordinator to compare instead of widening the pool to any available model.
+- Ask the optional verification follow-up to answer in Chinese and English.
+
+## 1.0.0 — 2026-10-30
+
+- Publish `pi-pstack-native@1.0.0` on npm and verify the public `latest` dist-tag.
 - Archive a commit-bound authenticated real-model receipt: three models passed the read-only probe on `5deb723`, and `SEMANTICS.json.evidence.realModel` records `status: "passed"` with that receipt.
 - Validate live GitHub delivery against a disposable repository: create, read, close and merge now have a recorded run. Add an opt-in `--merge` gate to the live tier; it stays closed unless `PSTACK_E2E_LIVE_MERGE=1` is set with an explicit write target.
-- Record the npm registry state: `pi-pstack-native` is unpublished, so `1.0.0` is unclaimed; no npm credentials exist in the validation environment.
+- Record the npm registry state before publication: `pi-pstack-native` was unpublished, so `1.0.0` was unclaimed; no npm credentials existed in the validation environment.
 - Record the maintainer semantic sign-off in `SEMANTICS.json.review` for the 11 core entrypoints and their declared deviations.
 - State the 1.0.0 guarantee scope explicitly in `docs/PUBLISHING.md`, including the exclusion of Windows real-model workflow acceptance and of branch-protection, review, auto-merge and merge-queue behaviour.
 

package/README.md

@@ -52,9 +52,13 @@ In Pi, choose role models and a child reasoning level:
 /poteto-mode Fix the login bug, run relevant tests, and report the evidence.
 ```
 
-Setup starts with a reasoning budget and previews role and task models and suggested panels from the models available to this Pi session. Page through the table, save it, or edit individual choices and panel seats. Existing settings are retained; cancelling before saving leaves the file unchanged. Unavailable models and unsupported reasoning are marked so they can be fixed in the same setup. `inherit-parent` and `auto` use the parent model. Repeated seats are separate sessions, not model diversity.
+Setup provides Chinese and English guidance. It starts with a reasoning budget, then previews roles, task models, and suggested panels using models available to this Pi session. Review the pages and save the settings, or edit individual choices and panel seats. Existing settings are retained; cancelling before saving leaves the file unchanged. Unavailable models and unsupported reasoning are marked so you can fix them before saving. `inherit-parent` and `auto` use the parent session's model.
 
-After saving, setup starts a model turn to inspect real-app and formal verification capabilities and offer to create missing project-local Skills. The agent is instructed to ask before creating a Skill; the follow-up depends on the selected model.
+The four upstream budget presets map to Pi thinking levels: `unlimited` to `max`, `large` to `xhigh`, `medium` to `high`, and `small` to `medium`. Pi also offers its own thinking levels and a fallback policy. Model support varies; setup shows when a choice is unsupported or uses a lower level under the selected fallback policy. Unlike Cursor pstack, Pi sets a thinking level instead of rewriting model slugs.
+
+A Pi role sets a general model for that kind of child agent. A task model overrides that role for a specific workflow and purpose; choosing the role default removes that override. Pi exposes these choices separately, so its list does not match the upstream rule line for line. A panel is an ordered list of model seats. Each runner or reviewer seat starts a separate child session; repeated models do not add model diversity. The Arena cross-judge pool is an ordered preference list for one judge. When the parent model's family is known, the judge must be from a different family. Parent aliases in that pool cannot act as judges.
+
+After saving, if a parent model is selected, setup starts a model turn to inspect real-app and formal verification capabilities and offer to create missing project-local Skills. The agent is instructed to ask before creating a Skill; the follow-up depends on the selected model.
 
 Arena and architect use a cross-judge with confined read-only access to verified candidates when an eligible different-family model is available. Otherwise they return candidates for the coordinator to inspect and select. Interrogate uses isolated adversaries and separate reproduction sessions; the coordinator must inspect actual command evidence. See [model setup and routing](docs/REFERENCE.md#model-setup-and-routing) for usage and limitations.
 

package/README.zh-CN.md

@@ -53,9 +53,13 @@ pi install npm:pi-pstack-native
 /setup-pstack
 ```
 
-命令先询问推理预算，再分页展示角色、任务模型和根据当前 Pi 可用模型建议的面板。可以直接保存，也可以只修改某个角色、任务或面板席位；不可用模型和不支持的推理等级会标出，可在向导中修正。已有自定义设置会保留，保存前取消则不写入。一个面板席位对应一个独立子会话；多个席位使用相同模型不代表模型多样性。`inherit-parent` 和 `auto` 使用父会话模型。
+配置界面提供中文和英文说明。命令先询问推理预算，再分页展示角色、任务模型和根据当前 Pi 可用模型建议的面板。你可以直接保存，也可以只修改某个角色、任务或面板席位。界面会标出不可用的模型和不支持的推理等级。请在保存前修正这些选项。已有设置会保留。保存前取消不会写入文件。`inherit-parent` 和 `auto` 使用父会话的模型。
 
-保存后，命令会启动一次模型对话，要求代理检查项目是否已有真实应用验证和形式化验证能力，并在缺少时询问是否创建项目本地 Skill。代理被要求在创建前等待同意；后续行为取决于所选模型。
+原版的 4 档预算对应 Pi 的推理等级：`unlimited` 对应 `max`，`large` 对应 `xhigh`，`medium` 对应 `high`，`small` 对应 `medium`。Pi 还提供其他推理等级和回退策略。回退策略决定模型不支持所选等级时是否允许使用较低等级。不同模型支持的等级不同。界面会显示不支持的选项和实际使用的较低等级。Cursor 原版通过更改模型名称设置等级。Pi 使用独立的推理等级设置。
+
+Pi 的角色模型为一类子代理设置通用模型。任务模型为指定工作流和用途覆盖该角色的模型。选择角色默认值会删除该任务覆盖。Pi 分开显示这些设置，因此列表与原版规则不逐行相同。面板是按顺序排列的模型席位列表。每个执行者或评审席位启动一个独立子会话。多个席位使用相同模型不会增加模型多样性。Arena 交叉裁判池按顺序选择一个裁判。父模型的家族已知时，裁判必须来自不同的家族。池中的父会话别名不能担任裁判。
+
+保存后，如果已选择父会话模型，命令会启动一次模型对话。代理会检查项目是否已有真实应用验证和形式化验证能力。缺少时，代理会询问是否创建项目本地 Skill。代理被要求在创建前等待同意；后续行为取决于所选模型。
 
 Arena 和 Architect 在有可用异家族模型时使用交叉裁判；否则返回候选，由协调者选择和整合。Interrogate 在隔离工作区执行对抗调查，并由独立会话复跑；协调者仍须核对实际命令证据。详见[模型配置与路由](docs/REFERENCE.md#model-setup-and-routing)。
 

package/REVIEW.md

@@ -1,4 +1,4 @@
-# v1.0.0 review & validation
+# v1.0.1 review & validation
 
 ## Verified by the default local check
 

package/SEMANTICS.json

@@ -2348,7 +2348,7 @@
     "src/extension.ts": "4f3743957540d722956a4eb501c1b7b9600d246ea55c3cf1ec46f5db51ec494b",
     "src/agent/profiles.ts": "8c845fa35a3db95319202ba9be73162c21323525d106eebddd9a5d72a49596ae",
     "src/agent/host.ts": "bdc2b76f56c1c533ad2367da6e2016bf53d6b3739b424021735a84e25fbd8416",
-    "src/models/router.ts": "45b5c042b063cd1e6c43c1f5db2404d72bad1a10086252ae9906553d7978344a",
+    "src/models/router.ts": "1e8913355c2400741deaeecc3389c8fabd2b82a79a688fd358bcae87b201083e",
     "src/runtime/config.ts": "fd9178d910169de0bef7eb91f5fc80000fb3b96ecd7d65cd022b33780aed89b8",
     "src/runtime/lock.ts": "f7b68acb71d1e46d208f1720716143102ac2373beaee05c4ed8e2899c9e5af83",
     "src/contracts/brief.ts": "56241c23f75109eee0d9ad74f7d4f9743e0ce0dab7c1dcdf38345ba7c880a759",
@@ -2375,8 +2375,8 @@
     "test/verification.test.ts": "0b5490574f15768e72b15e08113960416ea7ef9b730bd4d373515b36a6bc0882",
     "test/latest-upstream.test.ts": "a66f9c6ec5e1991247570a7acb3394905fbe57b0a68c3ceb3a6abb0a9e69b370",
     "test/statechart.test.ts": "ef48f8de33f769e30b1091e92f0b23742b014fb844eceaf1221005ac6f9a5757",
-    "test/model-router.test.ts": "e2117cc4ab2e8b917267a0c3c05914a252f11cd7b3c15f9db6f1a29c557cc97a",
-    "test/setup-command.test.ts": "bda5f617a4058d7e08b4dd329ca4df8a2e040449078c3d11a3fb7b756ee1690d",
+    "test/model-router.test.ts": "24234556f342d16274aa376f4f866950eedd1bc4f388c70ced98467945f0014c",
+    "test/setup-command.test.ts": "6a85ab091e9871b696c6bd9e7d895d4f82e5edb22bdf42a7cfbab2e78dd398f4",
     "test/transaction.test.ts": "8d6b429ab0418f21237c99aa701fd3b8bd55c93c10adb3bd766787c33182693e",
     "test/benchmark.test.ts": "c8b40b94ec8778dabfd73b9282932e0c5e575e4964bcc50576fbb7c854e964f0",
     "scripts/check-statechart.mjs": "3e6fbf7cc00b623298a2d2ad0728b9762eae950f1fd2435d14a4c3ac6d38b2f1",
@@ -2384,7 +2384,7 @@
     "src/tools/workflow.ts": "942da3e7229938716660efd013b21218fd127305de38e030cc46325a1b8ac191",
     "src/agent/candidates.ts": "c8f3ef5f83fe44203894d8c370e5dea0f520c24e1c20dbf9d8add2ac682bb1ce",
     "src/worktree/snapshot.ts": "3e2691076b095b143a42bddf6bc38cd9a89ac3dcc91dbc90dadc820ba8acd799",
-    "test/model-panels.test.ts": "b4506fdfd05ffd0ea91e9736ae42a6694534fb53c4b976a2f7a35f8922b87b70",
+    "test/model-panels.test.ts": "c7ba8dc9820935eb2eeabac43d203599b85d403899c39c3442dfb094994cce4d",
     "test/review-snapshot.test.ts": "cc93d43a402ed7a327ebc3ae734861e1fafc95968a6482e6810657705c57c937",
     "test/swarm-race.test.ts": "00447c4342ffd809f91cf37f3b0dfda8a88aa97e767e36de0f6ad365f02e2d69",
     "test/e2e/harness.ts": "9363a5beb9b41cbf4b74e6912544968dfecf4e5f0a5ab4829d30d78f13111618",
@@ -2392,8 +2392,8 @@
     "scripts/check-e2e.mjs": "f8a3332d01fe09fd18215a54da569f37e7955c39c5e4fbacb606c64df30e7c95",
     "scripts/build.mjs": "4c1ef7c3a43cdb0cf76be0440d06885770b1d38bd7f77a056cd6439de6bc15ac",
     "scripts/build-statechart.mjs": "4c30f6b1cb106d0c7d4031412331ad5473d947846cc4868bbac1fe6f14807c16",
-    "src/setup/command.ts": "3f97bab59272eb9ac7781ecc98bd98e62b0bb585b9178267ad599eee88dfe08e",
-    "test/setup-rpc.test.ts": "aa939cdd5b9d05976298fae3e99d93049e10909818ec841cbafd53ae2110164e"
+    "src/setup/command.ts": "d2adc2c097c43758da6a3b780ede0bfa4c356da4e45c3cb9b23ef59d169e4e90",
+    "test/setup-rpc.test.ts": "799722896e8102d7ba685b92b6b150beaf40abdd9ba66f370c4ea3ab2c6ff27d"
   },
   "driftReviews": [],
   "evidence": {
@@ -2524,6 +2524,10 @@
         {
           "file": "test/model-panels.test.ts",
           "name": "candidate inspection rejects workspace escapes and stale verified artifacts"
+        },
+        {
+          "file": "test/model-panels.test.ts",
+          "name": "judge selection respects the configured pool even when other families are available"
         }
       ]
     },

package/dist/models/router.js

@@ -80,11 +80,6 @@ export function selectJudgeFromPool(ctx, pool) {
     };
     for (const selector of pool)
         resolve(selector);
-    if (!choices.some(eligible) && typeof ctx.modelRegistry.getAvailable === 'function') {
-        for (const selector of availableModelSelectors(ctx))
-            if (!pool.includes(selector))
-                resolve(selector);
-    }
     const selected = choices.find(eligible);
     if (!parentFamily)
         notes.push('The parent model family is unknown; judge family independence cannot be established.');
@@ -141,9 +136,13 @@ export function availableModelSelectors(ctx) {
 export function suggestedPanels(ctx) {
     const available = availableModelSelectors(ctx);
     const parent = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined;
-    const first = parent && available.includes(parent) ? parent : available[0] ?? 'inherit-parent';
+    // Upstream starts its panels with a judgment model and a code model.
+    // Use only models Pi exposes, and prefer the upstream families when present.
+    const first = available.find(item => modelFamily(item) === 'claude')
+        ?? (parent && available.includes(parent) ? parent : available[0]) ?? 'inherit-parent';
     const family = modelFamily(first);
-    const second = available.find(item => item !== first && family && modelFamily(item) && modelFamily(item) !== family)
+    const second = available.find(item => item !== first && modelFamily(item) === 'grok' && family !== 'grok')
+        ?? available.find(item => item !== first && family && modelFamily(item) && modelFamily(item) !== family)
         ?? available.find(item => item !== first) ?? first;
     const runners = [first, second];
     // A judge pool is ordered by preference, not a copy of the entire registry.

package/dist/setup/command.js

@@ -1,5 +1,5 @@
 import { readFileSync } from "node:fs";
-import { availableModelSelectors, lowerSupportedThinking, supportsThinking, suggestedPanels } from "../models/router.js";
+import { availableModelSelectors, lowerSupportedThinking, modelFamily, supportsThinking, suggestedPanels } from "../models/router.js";
 import { loadModels, saveModels } from "../runtime/config.js";
 import { modelConfigPath } from "../runtime/home.js";
 const ROLE_DESCRIPTIONS = {
@@ -39,6 +39,156 @@ const BUDGETS = [
     { value: "minimal", label: "minimal — least reasoning effort" },
     { value: "low", label: "low — lower reasoning effort" },
 ];
+// Keep the English text stable for integrations while showing Chinese beside it.
+const ZH_OPTIONS = {
+    "Next page →": "下一页 →", "← Previous page": "← 上一页",
+    "Cancel setup": "取消配置", "Back to review": "返回检查", "Back": "返回",
+    "Save settings": "保存设置", "Edit a role": "编辑通用角色", "Edit a task model": "编辑任务模型",
+    "Edit a panel": "编辑模型面板", "Change budget": "修改推理预算", "Change fallback": "修改回退策略",
+    "Done editing panel": "完成面板编辑", "Add a seat": "添加席位", "Change model": "更换模型",
+    "Remove seat": "删除席位", "Move up": "上移", "Move down": "下移", "Back to panel": "返回面板",
+    "Use role default": "使用角色默认模型",
+    "inherit-parent — parent model": "inherit-parent — 使用父会话模型", "auto — parent model": "auto — 使用父会话模型",
+    "unlimited — max reasoning": "不限 — max 推理", "large — xhigh reasoning": "大 — xhigh 推理",
+    "medium — high reasoning": "中 — high 推理", "small — medium reasoning": "小 — medium 推理",
+    "inherit-parent — use the parent session's reasoning level": "inherit-parent — 使用父会话的推理级别",
+    "off — disable reasoning": "off — 关闭推理", "minimal — least reasoning effort": "minimal — 最低推理强度",
+    "low — lower reasoning effort": "low — 较低推理强度",
+    "disabled — block unsupported reasoning": "disabled — 禁止不支持的推理级别",
+    "same-family — allow reported lower reasoning and model fallback": "same-family — 允许降低推理级别并回退模型",
+};
+const ZH_NAMES = {
+    worker: "执行开发", architect: "设计和开发", reviewer: "只读审查", scout: "只读探索",
+    verifier: "只读验证", synthesizer: "汇总结果", integrator: "合并工作",
+    "poteto-agent": "执行 Poteto 委派任务", "comment-sicko": "审查注释和变通方案",
+    feature: "功能开发", refactoring: "代码重构", "bug-fix": "修复错误", "performance issue": "性能问题",
+    hillclimb: "迭代改进", "how explorer": "探索实现方式", "how explainer": "解释实现方式",
+    "why investigators": "调查原因", "why synthesizer": "汇总原因", "swarm workers": "并行执行任务",
+    "reflect tooling": "反思：工具分析", "reflect judgment": "反思：判断", "reflect divergent": "反思：发散分析",
+    "reflect synthesizer": "反思：汇总", "arena runners": "arena 方案执行", "arena cross-judge pool": "arena 交叉评委池",
+    "architect runners": "architect 方案执行", "interrogate reviewers": "interrogate 审查",
+};
+function chineseName(name) {
+    return ZH_NAMES[name] ? `${name}（${ZH_NAMES[name]}）` : name;
+}
+function optionChinese(option) {
+    if (ZH_OPTIONS[option])
+        return ZH_OPTIONS[option];
+    const seat = /^Seat (\d+): (.+)$/.exec(option);
+    if (seat)
+        return `席位 ${seat[1]}：${seat[2]}`;
+    const count = /^(.+) — (\d+) seats$/.exec(option);
+    if (count)
+        return `${chineseName(count[1])} — ${count[2]} 个席位`;
+    const role = /^(.+) — (.+)$/.exec(option);
+    if (role)
+        return `${chineseName(role[1])} — 当前模型：${role[2] === "role default" ? "角色默认模型" : role[2]}`;
+    return undefined;
+}
+function titleChinese(title) {
+    if (title.startsWith("Child reasoning budget"))
+        return "子代理推理预算。large 对应原版默认值；current 表示当前值。";
+    if (title.startsWith("Review pstack settings"))
+        return "检查 pstack 设置。need attention 表示需要处理。通用角色提供默认模型；任务模型覆盖对应任务的默认模型。";
+    if (title.startsWith("Choose role"))
+        return "选择要编辑的通用角色。任务模型没有单独设置时，使用对应角色的模型。";
+    if (title.startsWith("Choose task model"))
+        return "选择要编辑的任务模型。任务设置会覆盖对应角色的默认模型。";
+    if (title.startsWith("Choose panel"))
+        return "选择要编辑的模型面板。执行和审查面板的每个席位运行一个子代理。arena 评委池只选一名评委。父模型家族已知时，评委必须来自不同家族；父模型别名不担任评委。";
+    if (title.startsWith("Model fallback policy"))
+        return "模型回退策略";
+    if (title.startsWith("Add seat to "))
+        return "为面板添加席位。评委池按顺序选择一名评委。其他面板的每个席位运行一个子代理。";
+    if (title.startsWith("Model for "))
+        return `选择模型：${chineseName(title.slice("Model for ".length))}`;
+    if (title.startsWith("Seat "))
+        return "编辑席位";
+    if (/\(\d+ seats; \d+–16 allowed\)/.test(title))
+        return `编辑面板：${chineseName(title.slice(0, title.indexOf(" (")))}。评委池按顺序选择一名评委。其他面板的每个席位运行一个子代理。席位数量必须在显示的范围内。`;
+    return undefined;
+}
+async function selectBilingual(ctx, title, options) {
+    const chinese = titleChinese(title);
+    const lines = title.split("\n").map((line, index) => {
+        if (index === 0)
+            return line;
+        const translation = reviewRowChinese(line);
+        return translation ? `${line} / ${translation}` : line;
+    });
+    const labels = options.map(option => {
+        const translation = optionChinese(option);
+        return translation ? `${option} / ${translation}` : option;
+    });
+    const selected = await ctx.ui.select(chinese ? `${lines.join("\n")}\n${chinese}` : lines.join("\n"), labels);
+    const index = labels.indexOf(selected ?? "");
+    // Accept the English value as well for existing UI integrations.
+    return index >= 0 ? options[index] : selected;
+}
+function reviewRowChinese(row) {
+    if (row.startsWith("Budget:"))
+        return "推理预算与回退策略";
+    const label = /^([^:]+):/.exec(row)?.[1];
+    const role = label?.startsWith("Role ") ? label.slice(5) : undefined;
+    const name = role ?? label?.replace(/ \d+$/, "");
+    const description = name && ZH_NAMES[name] ? `${role ? "通用角色：" : ""}${ZH_NAMES[name]}` : undefined;
+    let status;
+    if (row.includes("not available; choose a model"))
+        status = "模型不可用，请重新选择模型";
+    else {
+        const unsupported = /does not support (\S+) reasoning/.exec(row);
+        const fallback = /uses (\S+) reasoning \(fallback\)/.exec(row);
+        const seatCount = /: (\d+) seats \[needs (\d+–16)\]/.exec(row);
+        if (unsupported)
+            status = `模型不支持 ${unsupported[1]} 推理，请选择其他模型或调整推理预算`;
+        else if (row.includes("[needs choice:"))
+            status = "需要重新选择模型或调整推理预算";
+        else if (row.includes("parent model not selected yet"))
+            status = "尚未选择父模型";
+        else if (fallback)
+            status = `回退到 ${fallback[1]} 推理级别`;
+        else if (row.includes("Pi maps "))
+            status = "Pi 会将推理级别映射到显示的级别";
+        else if (row.includes("role default"))
+            status = "使用角色默认模型";
+        else if (seatCount)
+            status = `当前 ${seatCount[1]} 个席位，需要 ${seatCount[2]} 个席位`;
+        else if (row.includes("repeated model seats"))
+            status = "重复模型不会增加模型多样性";
+        else if (row.includes("parent aliases do not judge"))
+            status = "父模型别名不担任评委";
+    }
+    return [description, status].filter(Boolean).join("；") || undefined;
+}
+function notifyBilingual(ctx, message, type) {
+    let chinese;
+    if (message.startsWith("Invalid selection"))
+        chinese = "选择无效，请重试。";
+    else if (message.startsWith("Setup cancelled"))
+        chinese = "配置已取消，未写入文件。";
+    else if (message.startsWith("/setup-pstack requires"))
+        chinese = "/setup-pstack 需要交互界面。";
+    else if (message.startsWith("No available Pi models"))
+        chinese = "未检测到可用的 Pi 模型。仍可选择父模型别名；配置 Pi 模型后可重新运行。";
+    else if (message.startsWith("A panel can have"))
+        chinese = "一个面板最多有 16 个席位。";
+    else if (message.startsWith("Cannot save yet")) {
+        const count = /Cannot save yet: (.+) needs (\d+–16) seats/.exec(message);
+        const details = count ? `${chineseName(count[1])} 需要 ${count[2]} 个席位` : reviewRowChinese(message);
+        chinese = `暂时无法保存。${details ?? "请修改相关选项或推理预算"}。`;
+    }
+    else if (message.startsWith("models.json changed"))
+        chinese = "models.json 在配置期间发生变化。未写入文件，请重新运行配置。";
+    else if (message.startsWith("Could not save"))
+        chinese = "无法保存 pstack 设置。";
+    else if (message.startsWith("Saved pstack settings"))
+        chinese = `已保存 pstack 设置。${message.includes("Repeated seats") ? "重复模型不会增加模型多样性。" : ""}${message.includes("Checking optional") ? "接下来检查可选的项目验证。" : "请选择父模型，再按需使用验证技能。"}`;
+    else if (message.startsWith("Cannot read"))
+        chinese = "无法读取配置文件。请先修复无效的 JSON。";
+    else if (message.startsWith("Cannot safely edit"))
+        chinese = "无法安全编辑配置文件。请先修复无效的模型配置。";
+    ctx.ui.notify(chinese ? `${message}\n${chinese}` : message, type);
+}
 // Pi's standard selector renders every option, without scrolling. Page long lists
 // so they remain usable for users with a large model registry and in RPC mode.
 async function pick(ctx, title, items, backLabel) {
@@ -53,7 +203,7 @@ async function pick(ctx, title, items, backLabel) {
         if (page > 0)
             options.push("← Previous page");
         options.push(backLabel);
-        const selected = await ctx.ui.select(`${title}${pages > 1 ? ` (${page + 1}/${pages})` : ""}`, options);
+        const selected = await selectBilingual(ctx, `${title}${pages > 1 ? ` (${page + 1}/${pages})` : ""}`, options);
         if (selected === undefined)
             return { kind: "cancel" };
         if (selected === "Next page →") {
@@ -69,7 +219,7 @@ async function pick(ctx, title, items, backLabel) {
         const item = visible.find(candidate => candidate.label === selected);
         if (item)
             return { kind: "choice", value: item.value };
-        ctx.ui.notify("Invalid selection; try again.", "error");
+        notifyBilingual(ctx, "Invalid selection; try again.", "error");
     }
 }
 function snapshot() {
@@ -204,7 +354,7 @@ async function editPanel(ctx, config, name, available) {
         }
         if (chosen.value === "add") {
             if (seats.length >= 16) {
-                ctx.ui.notify("A panel can have at most 16 seats.", "error");
+                notifyBilingual(ctx, "A panel can have at most 16 seats.", "error");
                 continue;
             }
             const model = await chooseModel(ctx, available, `Add seat to ${info.label}`);
@@ -215,7 +365,7 @@ async function editPanel(ctx, config, name, available) {
             continue;
         }
         const index = Number(chosen.value);
-        const action = await ctx.ui.select(`Seat ${index + 1}: ${seats[index]}`, ["Change model", "Remove seat", "Move up", "Move down", "Back to panel"]);
+        const action = await selectBilingual(ctx, `Seat ${index + 1}: ${seats[index]}`, ["Change model", "Remove seat", "Move up", "Move down", "Back to panel"]);
         if (action === undefined)
             return false;
         if (action === "Remove seat")
@@ -239,10 +389,11 @@ const VERIFICATION_FOLLOWUP = [
     "If neither exists, offer once to create a project-local verification skill using /skill:create-verification-skill; ask and wait for the user's answer before creating anything.",
     "Separately check for a project-local skill that runs a model checker, proof, or other formal verifier against the code. If none exists, offer once to create one using /skill:create-formal-verification-skill; ask and wait for the user's answer.",
     "Do not count the bundled create-* instructions as existing project verification. Respect a no or cancellation, and do not claim a skill ran unless it was actually invoked. If a requested skill is unavailable, say so.",
+    "When speaking to the user, provide both Chinese and English.",
 ].join(" ");
 export async function runSetup(pi, ctx) {
     if (!ctx.hasUI) {
-        ctx.ui.notify("/setup-pstack requires an interactive UI.", "error");
+        notifyBilingual(ctx, "/setup-pstack requires an interactive UI.", "error");
         return;
     }
     let original, config, raw;
@@ -252,12 +403,12 @@ export async function runSetup(pi, ctx) {
         config = loadModels();
     }
     catch (error) {
-        ctx.ui.notify(error instanceof Error ? error.message : String(error), "error");
+        notifyBilingual(ctx, error instanceof Error ? error.message : String(error), "error");
         return;
     }
     let available = availableModelSelectors(ctx);
     if (!available.length)
-        ctx.ui.notify("No available Pi models detected. Parent aliases are still selectable; configure Pi models and rerun setup to choose explicit models.", "warning");
+        notifyBilingual(ctx, "No available Pi models detected. Parent aliases are still selectable; configure Pi models and rerun setup to choose explicit models.", "warning");
     const next = {
         ...raw, ...config, roles: { ...config.roles },
         panels: Object.fromEntries(Object.entries(config.panels ?? {}).map(([name, seats]) => [name, [...seats]])),
@@ -266,9 +417,9 @@ export async function runSetup(pi, ctx) {
     for (const [name, seats] of Object.entries(suggestedPanels(ctx)))
         next.panels[name] ??= seats;
     if (original === undefined && available.length) {
-        const code = available.find(model => /(?:grok|composer)/i.test(model)) ?? available[0];
+        const code = available.find(model => modelFamily(model) === "grok") ?? available[0];
         const parent = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "";
-        const judgment = available.find(model => /claude/i.test(model)) ?? (available.includes(parent) ? parent : available[0]);
+        const judgment = available.find(model => modelFamily(model) === "claude") ?? (available.includes(parent) ? parent : available[0]);
         next.roles.worker = code;
         for (const role of ["architect", "reviewer", "verifier", "synthesizer", "integrator", "poteto-agent", "comment-sicko"])
             next.roles[role] = judgment;
@@ -277,7 +428,7 @@ export async function runSetup(pi, ctx) {
     }
     const first = await chooseBudget(ctx, original === undefined ? "xhigh" : next.thinkingLevel, original === undefined, true);
     if (first.kind !== "choice") {
-        ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+        notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
         return;
     }
     next.thinkingLevel = first.value;
@@ -294,9 +445,9 @@ export async function runSetup(pi, ctx) {
             actions.push("Next page →");
         if (page > 0)
             actions.push("← Previous page");
-        const action = await ctx.ui.select(title, actions);
+        const action = await selectBilingual(ctx, title, actions);
         if (action === undefined) {
-            ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+            notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
             return;
         }
         if (action === "Next page →") {
@@ -310,7 +461,7 @@ export async function runSetup(pi, ctx) {
         if (action === "Change budget") {
             const selected = await chooseBudget(ctx, next.thinkingLevel, false);
             if (selected.kind === "cancel") {
-                ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                 return;
             }
             if (selected.kind === "choice")
@@ -325,7 +476,7 @@ export async function runSetup(pi, ctx) {
             policies.sort((a, b) => Number(b.value === next.fallbackPolicy) - Number(a.value === next.fallbackPolicy));
             const selected = await pick(ctx, "Model fallback policy", policies, "Back to review");
             if (selected.kind === "cancel") {
-                ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                 return;
             }
             if (selected.kind === "choice")
@@ -335,13 +486,13 @@ export async function runSetup(pi, ctx) {
         if (action === "Edit a role") {
             const selected = await pick(ctx, "Choose role to edit", roleKeys(next).map(value => ({ value, label: `${value} — ${next.roles[value] ?? "inherit-parent"}` })), "Back to review");
             if (selected.kind === "cancel") {
-                ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                 return;
             }
             if (selected.kind === "choice") {
                 const model = await chooseModel(ctx, available, `Model for ${selected.value}`, next.roles[selected.value]);
                 if (model.kind === "cancel") {
-                    ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                    notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                     return;
                 }
                 if (model.kind === "choice" && model.value)
@@ -352,14 +503,14 @@ export async function runSetup(pi, ctx) {
         if (action === "Edit a task model") {
             const selected = await pick(ctx, "Choose task model to edit", taskRoles(next).map(value => ({ value, label: `${value.label} — ${next.workflows[value.name]?.[value.role] ?? "role default"}` })), "Back to review");
             if (selected.kind === "cancel") {
-                ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                 return;
             }
             if (selected.kind === "choice") {
                 const task = selected.value;
                 const model = await chooseModel(ctx, available, `Model for ${task.label}`, next.workflows[task.name]?.[task.role], true);
                 if (model.kind === "cancel") {
-                    ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                    notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                     return;
                 }
                 if (model.kind === "choice") {
@@ -379,17 +530,17 @@ export async function runSetup(pi, ctx) {
         if (action === "Edit a panel") {
             const selected = await pick(ctx, "Choose panel to edit", panelKeys(next).map(value => ({ value, label: `${PANEL_INFO[value]?.label ?? value} — ${(next.panels[value] ?? []).length} seats` })), "Back to review");
             if (selected.kind === "cancel") {
-                ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                 return;
             }
             if (selected.kind === "choice" && !await editPanel(ctx, next, selected.value, available)) {
-                ctx.ui.notify("Setup cancelled; nothing was written.", "info");
+                notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info");
                 return;
             }
             continue;
         }
         if (action !== "Save settings") {
-            ctx.ui.notify("Invalid selection; try again.", "error");
+            notifyBilingual(ctx, "Invalid selection; try again.", "error");
             continue;
         }
         // Registry/auth state may change while a dialog is open; recheck just before saving.
@@ -397,25 +548,25 @@ export async function runSetup(pi, ctx) {
         const finalInvalid = finalRows.filter(row => row.error);
         if (finalInvalid.length) {
             page = Math.floor(finalRows.findIndex(row => row.error) / size);
-            ctx.ui.notify(`Cannot save yet: ${finalInvalid[0].error}. Edit the affected choice or change the budget.`, "error");
+            notifyBilingual(ctx, `Cannot save yet: ${finalInvalid[0].error}. Edit the affected choice or change the budget.`, "error");
             continue;
         }
         try {
             if (snapshot() !== original) {
-                ctx.ui.notify("models.json changed during setup; nothing was written. Rerun setup to review the current settings.", "error");
+                notifyBilingual(ctx, "models.json changed during setup; nothing was written. Rerun setup to review the current settings.", "error");
                 return;
             }
             saveModels(next);
         }
         catch (error) {
-            ctx.ui.notify(`Could not save pstack settings: ${error instanceof Error ? error.message : String(error)}`, "error");
+            notifyBilingual(ctx, `Could not save pstack settings: ${error instanceof Error ? error.message : String(error)}`, "error");
             return;
         }
         const duplicates = panelKeys(next).filter(name => name !== "arena-judges" && (() => {
             const values = (next.panels[name] ?? []).map(value => value === "auto" || value === "inherit-parent" ? ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "parent" : value);
             return new Set(values).size < values.length;
         })());
-        ctx.ui.notify(`Saved pstack settings to ${modelConfigPath()}.${duplicates.length ? ` Repeated seats do not add model diversity: ${duplicates.join(", ")}.` : ""}${ctx.model ? " Checking optional project verification next." : " Select a parent model and use /skill:create-verification-skill or /skill:create-formal-verification-skill if needed."}`, "info");
+        notifyBilingual(ctx, `Saved pstack settings to ${modelConfigPath()}.${duplicates.length ? ` Repeated seats do not add model diversity: ${duplicates.join(", ")}.` : ""}${ctx.model ? " Checking optional project verification next." : " Select a parent model and use /skill:create-verification-skill or /skill:create-formal-verification-skill if needed."}`, "info");
         if (ctx.model)
             pi.sendUserMessage(VERIFICATION_FOLLOWUP, ctx.isIdle() ? { expandPromptTemplates: true } : { expandPromptTemplates: true, deliverAs: "followUp" });
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-pstack-native",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "pi-pstack-native: pstack semantics rebuilt on Pi's official AgentSession APIs with native durable workflows, worktree isolation, model routing, and scheduling.",
   "type": "module",
   "license": "MIT",

package/src/models/router.ts

@@ -79,9 +79,6 @@ export function selectJudgeFromPool(ctx: ExtensionContext, pool: string[]): { mo
     } catch (error) { notes.push(`Judge pool entry ${selector} unavailable: ${error instanceof Error ? error.message : String(error)}`); }
   };
   for (const selector of pool) resolve(selector);
-  if (!choices.some(eligible) && typeof ctx.modelRegistry.getAvailable === 'function') {
-    for (const selector of availableModelSelectors(ctx)) if (!pool.includes(selector)) resolve(selector);
-  }
   const selected = choices.find(eligible);
   if (!parentFamily) notes.push('The parent model family is unknown; judge family independence cannot be established.');
   if (!selected) notes.push('No eligible cross-judge is available; the coordinator must compare and select the base.');
@@ -134,9 +131,13 @@ export function availableModelSelectors(ctx: ExtensionContext): string[] {
 export function suggestedPanels(ctx: ExtensionContext): Record<string, string[]> {
   const available = availableModelSelectors(ctx);
   const parent = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined;
-  const first = parent && available.includes(parent) ? parent : available[0] ?? 'inherit-parent';
+  // Upstream starts its panels with a judgment model and a code model.
+  // Use only models Pi exposes, and prefer the upstream families when present.
+  const first = available.find(item => modelFamily(item) === 'claude')
+    ?? (parent && available.includes(parent) ? parent : available[0]) ?? 'inherit-parent';
   const family = modelFamily(first);
-  const second = available.find(item => item !== first && family && modelFamily(item) && modelFamily(item) !== family)
+  const second = available.find(item => item !== first && modelFamily(item) === 'grok' && family !== 'grok')
+    ?? available.find(item => item !== first && family && modelFamily(item) && modelFamily(item) !== family)
     ?? available.find(item => item !== first) ?? first;
   const runners = [first, second];
   // A judge pool is ordered by preference, not a copy of the entire registry.

package/src/setup/command.ts

@@ -1,6 +1,6 @@
 import { readFileSync } from "node:fs";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { availableModelSelectors, lowerSupportedThinking, supportsThinking, suggestedPanels } from "../models/router.ts";
+import { availableModelSelectors, lowerSupportedThinking, modelFamily, supportsThinking, suggestedPanels } from "../models/router.ts";
 import { loadModels, saveModels } from "../runtime/config.ts";
 import { modelConfigPath } from "../runtime/home.ts";
 import type { ModelConfig } from "../runtime/types.ts";
@@ -49,6 +49,128 @@ const BUDGETS: Item<ModelConfig["thinkingLevel"]>[] = [
   { value: "low", label: "low — lower reasoning effort" },
 ];
 
+// Keep the English text stable for integrations while showing Chinese beside it.
+const ZH_OPTIONS: Record<string, string> = {
+  "Next page →": "下一页 →", "← Previous page": "← 上一页",
+  "Cancel setup": "取消配置", "Back to review": "返回检查", "Back": "返回",
+  "Save settings": "保存设置", "Edit a role": "编辑通用角色", "Edit a task model": "编辑任务模型",
+  "Edit a panel": "编辑模型面板", "Change budget": "修改推理预算", "Change fallback": "修改回退策略",
+  "Done editing panel": "完成面板编辑", "Add a seat": "添加席位", "Change model": "更换模型",
+  "Remove seat": "删除席位", "Move up": "上移", "Move down": "下移", "Back to panel": "返回面板",
+  "Use role default": "使用角色默认模型",
+  "inherit-parent — parent model": "inherit-parent — 使用父会话模型", "auto — parent model": "auto — 使用父会话模型",
+  "unlimited — max reasoning": "不限 — max 推理", "large — xhigh reasoning": "大 — xhigh 推理",
+  "medium — high reasoning": "中 — high 推理", "small — medium reasoning": "小 — medium 推理",
+  "inherit-parent — use the parent session's reasoning level": "inherit-parent — 使用父会话的推理级别",
+  "off — disable reasoning": "off — 关闭推理", "minimal — least reasoning effort": "minimal — 最低推理强度",
+  "low — lower reasoning effort": "low — 较低推理强度",
+  "disabled — block unsupported reasoning": "disabled — 禁止不支持的推理级别",
+  "same-family — allow reported lower reasoning and model fallback": "same-family — 允许降低推理级别并回退模型",
+};
+
+const ZH_NAMES: Record<string, string> = {
+  worker: "执行开发", architect: "设计和开发", reviewer: "只读审查", scout: "只读探索",
+  verifier: "只读验证", synthesizer: "汇总结果", integrator: "合并工作",
+  "poteto-agent": "执行 Poteto 委派任务", "comment-sicko": "审查注释和变通方案",
+  feature: "功能开发", refactoring: "代码重构", "bug-fix": "修复错误", "performance issue": "性能问题",
+  hillclimb: "迭代改进", "how explorer": "探索实现方式", "how explainer": "解释实现方式",
+  "why investigators": "调查原因", "why synthesizer": "汇总原因", "swarm workers": "并行执行任务",
+  "reflect tooling": "反思：工具分析", "reflect judgment": "反思：判断", "reflect divergent": "反思：发散分析",
+  "reflect synthesizer": "反思：汇总", "arena runners": "arena 方案执行", "arena cross-judge pool": "arena 交叉评委池",
+  "architect runners": "architect 方案执行", "interrogate reviewers": "interrogate 审查",
+};
+
+function chineseName(name: string): string {
+  return ZH_NAMES[name] ? `${name}（${ZH_NAMES[name]}）` : name;
+}
+
+function optionChinese(option: string): string | undefined {
+  if (ZH_OPTIONS[option]) return ZH_OPTIONS[option];
+  const seat = /^Seat (\d+): (.+)$/.exec(option);
+  if (seat) return `席位 ${seat[1]}：${seat[2]}`;
+  const count = /^(.+) — (\d+) seats$/.exec(option);
+  if (count) return `${chineseName(count[1]!)} — ${count[2]} 个席位`;
+  const role = /^(.+) — (.+)$/.exec(option);
+  if (role) return `${chineseName(role[1]!)} — 当前模型：${role[2] === "role default" ? "角色默认模型" : role[2]}`;
+  return undefined;
+}
+
+function titleChinese(title: string): string | undefined {
+  if (title.startsWith("Child reasoning budget")) return "子代理推理预算。large 对应原版默认值；current 表示当前值。";
+  if (title.startsWith("Review pstack settings")) return "检查 pstack 设置。need attention 表示需要处理。通用角色提供默认模型；任务模型覆盖对应任务的默认模型。";
+  if (title.startsWith("Choose role")) return "选择要编辑的通用角色。任务模型没有单独设置时，使用对应角色的模型。";
+  if (title.startsWith("Choose task model")) return "选择要编辑的任务模型。任务设置会覆盖对应角色的默认模型。";
+  if (title.startsWith("Choose panel")) return "选择要编辑的模型面板。执行和审查面板的每个席位运行一个子代理。arena 评委池只选一名评委。父模型家族已知时，评委必须来自不同家族；父模型别名不担任评委。";
+  if (title.startsWith("Model fallback policy")) return "模型回退策略";
+  if (title.startsWith("Add seat to ")) return "为面板添加席位。评委池按顺序选择一名评委。其他面板的每个席位运行一个子代理。";
+  if (title.startsWith("Model for ")) return `选择模型：${chineseName(title.slice("Model for ".length))}`;
+  if (title.startsWith("Seat ")) return "编辑席位";
+  if (/\(\d+ seats; \d+–16 allowed\)/.test(title)) return `编辑面板：${chineseName(title.slice(0, title.indexOf(" (")))}。评委池按顺序选择一名评委。其他面板的每个席位运行一个子代理。席位数量必须在显示的范围内。`;
+  return undefined;
+}
+
+async function selectBilingual(ctx: ExtensionContext, title: string, options: string[]): Promise<string | undefined> {
+  const chinese = titleChinese(title);
+  const lines = title.split("\n").map((line, index) => {
+    if (index === 0) return line;
+    const translation = reviewRowChinese(line);
+    return translation ? `${line} / ${translation}` : line;
+  });
+  const labels = options.map(option => {
+    const translation = optionChinese(option);
+    return translation ? `${option} / ${translation}` : option;
+  });
+  const selected = await ctx.ui.select(chinese ? `${lines.join("\n")}\n${chinese}` : lines.join("\n"), labels);
+  const index = labels.indexOf(selected ?? "");
+  // Accept the English value as well for existing UI integrations.
+  return index >= 0 ? options[index] : selected;
+}
+
+function reviewRowChinese(row: string): string | undefined {
+  if (row.startsWith("Budget:")) return "推理预算与回退策略";
+  const label = /^([^:]+):/.exec(row)?.[1];
+  const role = label?.startsWith("Role ") ? label.slice(5) : undefined;
+  const name = role ?? label?.replace(/ \d+$/, "");
+  const description = name && ZH_NAMES[name] ? `${role ? "通用角色：" : ""}${ZH_NAMES[name]}` : undefined;
+  let status: string | undefined;
+  if (row.includes("not available; choose a model")) status = "模型不可用，请重新选择模型";
+  else {
+    const unsupported = /does not support (\S+) reasoning/.exec(row);
+    const fallback = /uses (\S+) reasoning \(fallback\)/.exec(row);
+    const seatCount = /: (\d+) seats \[needs (\d+–16)\]/.exec(row);
+    if (unsupported) status = `模型不支持 ${unsupported[1]} 推理，请选择其他模型或调整推理预算`;
+    else if (row.includes("[needs choice:")) status = "需要重新选择模型或调整推理预算";
+    else if (row.includes("parent model not selected yet")) status = "尚未选择父模型";
+    else if (fallback) status = `回退到 ${fallback[1]} 推理级别`;
+    else if (row.includes("Pi maps ")) status = "Pi 会将推理级别映射到显示的级别";
+    else if (row.includes("role default")) status = "使用角色默认模型";
+    else if (seatCount) status = `当前 ${seatCount[1]} 个席位，需要 ${seatCount[2]} 个席位`;
+    else if (row.includes("repeated model seats")) status = "重复模型不会增加模型多样性";
+    else if (row.includes("parent aliases do not judge")) status = "父模型别名不担任评委";
+  }
+  return [description, status].filter(Boolean).join("；") || undefined;
+}
+
+function notifyBilingual(ctx: ExtensionContext, message: string, type: "info" | "warning" | "error"): void {
+  let chinese: string | undefined;
+  if (message.startsWith("Invalid selection")) chinese = "选择无效，请重试。";
+  else if (message.startsWith("Setup cancelled")) chinese = "配置已取消，未写入文件。";
+  else if (message.startsWith("/setup-pstack requires")) chinese = "/setup-pstack 需要交互界面。";
+  else if (message.startsWith("No available Pi models")) chinese = "未检测到可用的 Pi 模型。仍可选择父模型别名；配置 Pi 模型后可重新运行。";
+  else if (message.startsWith("A panel can have")) chinese = "一个面板最多有 16 个席位。";
+  else if (message.startsWith("Cannot save yet")) {
+    const count = /Cannot save yet: (.+) needs (\d+–16) seats/.exec(message);
+    const details = count ? `${chineseName(count[1]!)} 需要 ${count[2]} 个席位` : reviewRowChinese(message);
+    chinese = `暂时无法保存。${details ?? "请修改相关选项或推理预算"}。`;
+  }
+  else if (message.startsWith("models.json changed")) chinese = "models.json 在配置期间发生变化。未写入文件，请重新运行配置。";
+  else if (message.startsWith("Could not save")) chinese = "无法保存 pstack 设置。";
+  else if (message.startsWith("Saved pstack settings")) chinese = `已保存 pstack 设置。${message.includes("Repeated seats") ? "重复模型不会增加模型多样性。" : ""}${message.includes("Checking optional") ? "接下来检查可选的项目验证。" : "请选择父模型，再按需使用验证技能。"}`;
+  else if (message.startsWith("Cannot read")) chinese = "无法读取配置文件。请先修复无效的 JSON。";
+  else if (message.startsWith("Cannot safely edit")) chinese = "无法安全编辑配置文件。请先修复无效的模型配置。";
+  ctx.ui.notify(chinese ? `${message}\n${chinese}` : message, type);
+}
+
 // Pi's standard selector renders every option, without scrolling. Page long lists
 // so they remain usable for users with a large model registry and in RPC mode.
 async function pick<T>(ctx: ExtensionContext, title: string, items: Item<T>[], backLabel: string): Promise<Pick<T>> {
@@ -61,14 +183,14 @@ async function pick<T>(ctx: ExtensionContext, title: string, items: Item<T>[], b
     if (page + 1 < pages) options.push("Next page →");
     if (page > 0) options.push("← Previous page");
     options.push(backLabel);
-    const selected = await ctx.ui.select(`${title}${pages > 1 ? ` (${page + 1}/${pages})` : ""}`, options);
+    const selected = await selectBilingual(ctx, `${title}${pages > 1 ? ` (${page + 1}/${pages})` : ""}`, options);
     if (selected === undefined) return { kind: "cancel" };
     if (selected === "Next page →") { page++; continue; }
     if (selected === "← Previous page") { page--; continue; }
     if (selected === backLabel) return { kind: "back" };
     const item = visible.find(candidate => candidate.label === selected);
     if (item) return { kind: "choice", value: item.value };
-    ctx.ui.notify("Invalid selection; try again.", "error");
+    notifyBilingual(ctx, "Invalid selection; try again.", "error");
   }
 }
 
@@ -191,14 +313,14 @@ async function editPanel(ctx: ExtensionContext, config: Draft, name: string, ava
     if (chosen.kind === "back") return true;
     if (chosen.value === "done") { config.panels[name] = seats; return true; }
     if (chosen.value === "add") {
-      if (seats.length >= 16) { ctx.ui.notify("A panel can have at most 16 seats.", "error"); continue; }
+      if (seats.length >= 16) { notifyBilingual(ctx, "A panel can have at most 16 seats.", "error"); continue; }
       const model = await chooseModel(ctx, available, `Add seat to ${info.label}`);
       if (model.kind === "cancel") return false;
       if (model.kind === "choice" && model.value) seats.push(model.value);
       continue;
     }
     const index = Number(chosen.value);
-    const action = await ctx.ui.select(`Seat ${index + 1}: ${seats[index]}`, ["Change model", "Remove seat", "Move up", "Move down", "Back to panel"]);
+    const action = await selectBilingual(ctx, `Seat ${index + 1}: ${seats[index]}`, ["Change model", "Remove seat", "Move up", "Move down", "Back to panel"]);
     if (action === undefined) return false;
     if (action === "Remove seat") seats.splice(index, 1);
     else if (action === "Move up" && index > 0) [seats[index - 1], seats[index]] = [seats[index]!, seats[index - 1]!];
@@ -217,15 +339,16 @@ const VERIFICATION_FOLLOWUP = [
   "If neither exists, offer once to create a project-local verification skill using /skill:create-verification-skill; ask and wait for the user's answer before creating anything.",
   "Separately check for a project-local skill that runs a model checker, proof, or other formal verifier against the code. If none exists, offer once to create one using /skill:create-formal-verification-skill; ask and wait for the user's answer.",
   "Do not count the bundled create-* instructions as existing project verification. Respect a no or cancellation, and do not claim a skill ran unless it was actually invoked. If a requested skill is unavailable, say so.",
+  "When speaking to the user, provide both Chinese and English.",
 ].join(" ");
 
 export async function runSetup(pi: ExtensionAPI, ctx: ExtensionContext): Promise<void> {
-  if (!ctx.hasUI) { ctx.ui.notify("/setup-pstack requires an interactive UI.", "error"); return; }
+  if (!ctx.hasUI) { notifyBilingual(ctx, "/setup-pstack requires an interactive UI.", "error"); return; }
   let original: string | undefined, config: ModelConfig, raw: Record<string, unknown>;
   try { original = snapshot(); raw = parseExisting(original); config = loadModels(); }
-  catch (error) { ctx.ui.notify(error instanceof Error ? error.message : String(error), "error"); return; }
+  catch (error) { notifyBilingual(ctx, error instanceof Error ? error.message : String(error), "error"); return; }
   let available = availableModelSelectors(ctx);
-  if (!available.length) ctx.ui.notify("No available Pi models detected. Parent aliases are still selectable; configure Pi models and rerun setup to choose explicit models.", "warning");
+  if (!available.length) notifyBilingual(ctx, "No available Pi models detected. Parent aliases are still selectable; configure Pi models and rerun setup to choose explicit models.", "warning");
   const next: Draft = {
     ...raw, ...config, roles: { ...config.roles },
     panels: Object.fromEntries(Object.entries(config.panels ?? {}).map(([name, seats]) => [name, [...seats]])),
@@ -233,16 +356,16 @@ export async function runSetup(pi: ExtensionAPI, ctx: ExtensionContext): Promise
   };
   for (const [name, seats] of Object.entries(suggestedPanels(ctx))) next.panels[name] ??= seats;
   if (original === undefined && available.length) {
-    const code = available.find(model => /(?:grok|composer)/i.test(model)) ?? available[0]!;
+    const code = available.find(model => modelFamily(model) === "grok") ?? available[0]!;
     const parent = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "";
-    const judgment = available.find(model => /claude/i.test(model)) ?? (available.includes(parent) ? parent : available[0]!);
+    const judgment = available.find(model => modelFamily(model) === "claude") ?? (available.includes(parent) ? parent : available[0]!);
     next.roles.worker = code;
     for (const role of ["architect", "reviewer", "verifier", "synthesizer", "integrator", "poteto-agent", "comment-sicko"]) next.roles[role] = judgment;
     next.roles.scout = code;
     next.workflows.reflect = { tooling: code, judgment, divergent: judgment, synthesizer: judgment };
   }
   const first = await chooseBudget(ctx, original === undefined ? "xhigh" : next.thinkingLevel, original === undefined, true);
-  if (first.kind !== "choice") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+  if (first.kind !== "choice") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
   next.thinkingLevel = first.value;
   let page = 0;
   for (;;) {
@@ -255,13 +378,13 @@ export async function runSetup(pi: ExtensionAPI, ctx: ExtensionContext): Promise
     const actions = ["Save settings", "Edit a role", "Edit a task model", "Edit a panel", "Change budget", "Change fallback"];
     if (page + 1 < pages) actions.push("Next page →");
     if (page > 0) actions.push("← Previous page");
-    const action = await ctx.ui.select(title, actions);
-    if (action === undefined) { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+    const action = await selectBilingual(ctx, title, actions);
+    if (action === undefined) { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
     if (action === "Next page →") { page++; continue; }
     if (action === "← Previous page") { page--; continue; }
     if (action === "Change budget") {
       const selected = await chooseBudget(ctx, next.thinkingLevel, false);
-      if (selected.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+      if (selected.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
       if (selected.kind === "choice") next.thinkingLevel = selected.value;
       continue;
     }
@@ -272,27 +395,27 @@ export async function runSetup(pi: ExtensionAPI, ctx: ExtensionContext): Promise
       ];
       policies.sort((a, b) => Number(b.value === next.fallbackPolicy) - Number(a.value === next.fallbackPolicy));
       const selected = await pick(ctx, "Model fallback policy", policies, "Back to review");
-      if (selected.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+      if (selected.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
       if (selected.kind === "choice") next.fallbackPolicy = selected.value;
       continue;
     }
     if (action === "Edit a role") {
       const selected = await pick(ctx, "Choose role to edit", roleKeys(next).map(value => ({ value, label: `${value} — ${next.roles[value] ?? "inherit-parent"}` })), "Back to review");
-      if (selected.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+      if (selected.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
       if (selected.kind === "choice") {
         const model = await chooseModel(ctx, available, `Model for ${selected.value}`, next.roles[selected.value]);
-        if (model.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+        if (model.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
         if (model.kind === "choice" && model.value) next.roles[selected.value] = model.value;
       }
       continue;
     }
     if (action === "Edit a task model") {
       const selected = await pick(ctx, "Choose task model to edit", taskRoles(next).map(value => ({ value, label: `${value.label} — ${next.workflows[value.name]?.[value.role] ?? "role default"}` })), "Back to review");
-      if (selected.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+      if (selected.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
       if (selected.kind === "choice") {
         const task = selected.value;
         const model = await chooseModel(ctx, available, `Model for ${task.label}`, next.workflows[task.name]?.[task.role], true);
-        if (model.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+        if (model.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
         if (model.kind === "choice") {
           const values = { ...next.workflows[task.name] };
           if (model.value) values[task.role] = model.value; else delete values[task.role];
@@ -303,28 +426,28 @@ export async function runSetup(pi: ExtensionAPI, ctx: ExtensionContext): Promise
     }
     if (action === "Edit a panel") {
       const selected = await pick(ctx, "Choose panel to edit", panelKeys(next).map(value => ({ value, label: `${PANEL_INFO[value]?.label ?? value} — ${(next.panels[value] ?? []).length} seats` })), "Back to review");
-      if (selected.kind === "cancel") { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
-      if (selected.kind === "choice" && !await editPanel(ctx, next, selected.value, available)) { ctx.ui.notify("Setup cancelled; nothing was written.", "info"); return; }
+      if (selected.kind === "cancel") { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
+      if (selected.kind === "choice" && !await editPanel(ctx, next, selected.value, available)) { notifyBilingual(ctx, "Setup cancelled; nothing was written.", "info"); return; }
       continue;
     }
-    if (action !== "Save settings") { ctx.ui.notify("Invalid selection; try again.", "error"); continue; }
+    if (action !== "Save settings") { notifyBilingual(ctx, "Invalid selection; try again.", "error"); continue; }
     // Registry/auth state may change while a dialog is open; recheck just before saving.
     const finalRows = reviewRows(ctx, new Set(availableModelSelectors(ctx)), next);
     const finalInvalid = finalRows.filter(row => row.error);
     if (finalInvalid.length) {
       page = Math.floor(finalRows.findIndex(row => row.error) / size);
-      ctx.ui.notify(`Cannot save yet: ${finalInvalid[0]!.error}. Edit the affected choice or change the budget.`, "error");
+      notifyBilingual(ctx, `Cannot save yet: ${finalInvalid[0]!.error}. Edit the affected choice or change the budget.`, "error");
       continue;
     }
     try {
-      if (snapshot() !== original) { ctx.ui.notify("models.json changed during setup; nothing was written. Rerun setup to review the current settings.", "error"); return; }
+      if (snapshot() !== original) { notifyBilingual(ctx, "models.json changed during setup; nothing was written. Rerun setup to review the current settings.", "error"); return; }
       saveModels(next);
-    } catch (error) { ctx.ui.notify(`Could not save pstack settings: ${error instanceof Error ? error.message : String(error)}`, "error"); return; }
+    } catch (error) { notifyBilingual(ctx, `Could not save pstack settings: ${error instanceof Error ? error.message : String(error)}`, "error"); return; }
     const duplicates = panelKeys(next).filter(name => name !== "arena-judges" && (() => {
       const values = (next.panels[name] ?? []).map(value => value === "auto" || value === "inherit-parent" ? ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "parent" : value);
       return new Set(values).size < values.length;
     })());
-    ctx.ui.notify(`Saved pstack settings to ${modelConfigPath()}.${duplicates.length ? ` Repeated seats do not add model diversity: ${duplicates.join(", ")}.` : ""}${ctx.model ? " Checking optional project verification next." : " Select a parent model and use /skill:create-verification-skill or /skill:create-formal-verification-skill if needed."}`, "info");
+    notifyBilingual(ctx, `Saved pstack settings to ${modelConfigPath()}.${duplicates.length ? ` Repeated seats do not add model diversity: ${duplicates.join(", ")}.` : ""}${ctx.model ? " Checking optional project verification next." : " Select a parent model and use /skill:create-verification-skill or /skill:create-formal-verification-skill if needed."}`, "info");
     if (ctx.model) pi.sendUserMessage(VERIFICATION_FOLLOWUP, ctx.isIdle() ? { expandPromptTemplates: true } : { expandPromptTemplates: true, deliverAs: "followUp" });
     return;
   }

package/test/model-panels.test.ts

@@ -13,10 +13,36 @@ import { buildTemplate } from '../src/templates/build.ts';
 import { planArtifacts } from '../src/workflow/artifacts.ts';
 import { registerWorkflowTool } from '../src/tools/workflow.ts';
 import { registerAgentTool } from '../src/tools/agents.ts';
+import { selectJudgeFromPool, suggestedPanels } from '../src/models/router.ts';
 import { WorkflowEngine } from '../src/workflow/engine.ts';
 import { verify } from '../src/verification/runner.ts';
 import type { TaskBrief } from '../src/contracts/types.ts';
 
+test('suggested panels prefer upstream model families over an unrelated parent', () => {
+  const models = [
+    { provider: 'openai', id: 'gpt-5' },
+    { provider: 'anthropic', id: 'claude-opus-4' },
+    { provider: 'xai', id: 'grok-4' },
+  ];
+  const ctx: any = { model: models[0], scopedModels: [], modelRegistry: { getAvailable: () => models } };
+  const panels = suggestedPanels(ctx);
+  assert.deepEqual(panels.arena, ['anthropic/claude-opus-4', 'xai/grok-4']);
+  assert.deepEqual(panels['arena-judges'], panels.arena);
+  assert.deepEqual(panels.architect, panels.arena);
+  assert.deepEqual(panels.interrogate, panels.arena);
+});
+
+test('judge selection respects the configured pool even when other families are available', () => {
+  const parent = { provider: 'p', id: 'claude-opus', reasoning: true };
+  const other = { provider: 'p', id: 'grok-4', reasoning: true };
+  const ctx: any = { model: parent, scopedModels: [], modelRegistry: {
+    getAvailable: () => [parent, other], find: (_provider: string, id: string) => [parent, other].find(model => model.id === id),
+  } };
+  const result = selectJudgeFromPool(ctx, ['inherit-parent', 'p/claude-opus']);
+  assert.equal(result.model, undefined);
+  assert(result.notes.some(note => note.includes('coordinator must compare')));
+});
+
 test('configured review panels resolve models, plan, and dispatch one reviewer per seat', async () => {
   const root = mkdtempSync(join(tmpdir(), 'pstack-panels-'));
   const old = process.env.PSTACK_NATIVE_HOME;

package/test/model-router.test.ts

@@ -112,12 +112,11 @@ test("judge pool prefers a recognized family different from the parent and repor
   assert(selected.notes.some(note => note.includes('not-registered') && note.includes('unavailable')));
 }));
 
-test('judge pool skips the known parent family and falls back to another available family', () => {
+test('judge pool skips the parent family and uses only configured entries', () => {
   const parent: any = { provider: 'p', id: 'claude-opus', reasoning: true };
   const other: any = { provider: 'p', id: 'grok-4', reasoning: true };
   const ctx: any = { model: parent, thinkingLevel: 'off', scopedModels: [], modelRegistry: { find: (provider: string, id: string) => [parent, other].find(m => m.provider === provider && m.id === id), getAvailable: () => [parent, other] } };
-  assert.equal(selectJudgeFromPool(ctx, ['inherit-parent', 'p/claude-opus']).model, 'p/grok-4');
-  ctx.modelRegistry.getAvailable = () => [parent];
+  assert.equal(selectJudgeFromPool(ctx, ['inherit-parent', 'p/claude-opus', 'p/grok-4']).model, 'p/grok-4');
   const skipped = selectJudgeFromPool(ctx, ['auto', 'p/claude-opus']);
   assert.equal(skipped.model, undefined);
   assert(skipped.notes.some(note => note.includes('coordinator')));

package/test/setup-command.test.ts

@@ -18,7 +18,14 @@ async function setup(choose: Choose, models: any[] = [claude, grok], parent: any
   const ctx = {
     hasUI: true, model: parent, scopedModels, isIdle: () => true,
     modelRegistry: { getAvailable: () => models, find: (provider: string, id: string) => registryModels.find(m => m.provider === provider && m.id === id) },
-    ui: { select: (title: string, options: string[]) => { titles.push(title); optionLists.push(options); assert(titles.length < 100, 'wizard must make progress'); return choose(title, options, titles.length); }, notify: (message: string) => notices.push(message) },
+    ui: { select: (title: string, options: string[]) => {
+      titles.push(title); optionLists.push(options); assert(titles.length < 100, 'wizard must make progress');
+      // Drive the real displayed option while keeping the existing English-based scenarios readable.
+      const english = options.map(option => option.replace(/ \/ [\u4e00-\u9fff].*$/, ''));
+      const selected = choose(title, english, titles.length);
+      const index = english.indexOf(selected ?? '');
+      return index < 0 ? selected : options[index];
+    }, notify: (message: string) => notices.push(message) },
   };
   await commands.get('setup-pstack').handler('', ctx);
   return { notices, titles, optionLists, messages };
@@ -39,6 +46,9 @@ test('fresh setup defaults to the upstream large budget, previews all mappings i
   for (const text of ['Role worker: xai/grok-4', 'feature: role default (xai/grok-4)', 'how explainer:', 'swarm workers:', 'arena runners 1:', 'arena cross-judge pool 1:', 'architect runners 2:', 'interrogate reviewers 2:']) assert(all.includes(text), text);
   assert(all.includes('Pi maps xhigh to high'));
   assert(optionLists.every(options => options.length <= 8));
+  assert(titles.some(title => /[\u4e00-\u9fff]/.test(title)), 'setup should show Chinese in its prompts');
+  assert(optionLists.flat().some(option => option.includes('Save settings') && option.includes('保存设置')));
+  assert(optionLists.flat().some(option => option.includes('Cancel setup') && option.includes('取消配置')));
   const config = loadModels();
   assert.equal(config.thinkingLevel, 'xhigh');
   assert.equal(config.roles.worker, grokId);
@@ -49,6 +59,7 @@ test('fresh setup defaults to the upstream large budget, previews all mappings i
   assert.match(messages[0]!.text, /existing harness.*not merely unit tests/);
   assert.match(messages[0]!.text, /ask and wait for the user's answer/);
   assert.match(messages[0]!.text, /create-formal-verification-skill/);
+  assert.match(messages[0]!.text, /provide both Chinese and English/);
   assert.equal(messages[0]!.options.expandPromptTemplates, true);
 }));
 
@@ -106,7 +117,7 @@ test('unsupported reasoning can be corrected without discarding model choices',
 test('edit one panel seat and preserve the rest and the feature/refactoring overrides', async () => withHome(async () => {
   saveModels({ version: 1, thinkingLevel: 'inherit-parent', roles: {}, workflows: { feature: { worker: claudeId }, refactoring: { worker: grokId } }, panels: { arena: [claudeId, grokId], extra: [grokId] } });
   let step = 0;
-  await setup((title, options) => {
+  const result = await setup((title, options) => {
     if (title.startsWith('Child reasoning')) return options[0];
     if (title.startsWith('Review pstack')) return step++ === 0 ? 'Edit a panel' : 'Save settings';
     if (title.startsWith('Choose panel')) return options.find(x => x.startsWith('arena runners'));
@@ -120,6 +131,33 @@ test('edit one panel seat and preserve the rest and the feature/refactoring over
   assert.deepEqual(config.panels?.extra, [grokId]);
   assert.equal(config.workflows?.feature.worker, claudeId);
   assert.equal(config.workflows?.refactoring.worker, grokId);
+  assert(result.optionLists.flat().some(option => option.includes('Change model') && /[\u4e00-\u9fff]/.test(option)));
+}));
+
+test('a panel below its minimum cannot be saved and can be repaired without restarting setup', async () => withHome(async () => {
+  saveModels({ version: 1, thinkingLevel: 'inherit-parent', roles: {}, panels: { arena: [claudeId, grokId] } });
+  let review = 0, panelEdit = 0;
+  const result = await setup((title, options) => {
+    if (title.startsWith('Child reasoning')) return options[0];
+    if (title.startsWith('Review pstack')) {
+      review++;
+      return review === 2 ? 'Save settings' : review === 4 ? 'Save settings' : 'Edit a panel';
+    }
+    if (title.startsWith('Choose panel')) return options.find(option => option.startsWith('arena runners'));
+    if (title.startsWith('arena runners')) {
+      if (panelEdit === 0) { panelEdit++; return options.find(option => option.startsWith('Seat 2:')); }
+      if (panelEdit === 1) { panelEdit++; return 'Done editing panel'; }
+      if (panelEdit === 2) { panelEdit++; return 'Add a seat'; }
+      return 'Done editing panel';
+    }
+    if (title.startsWith('Seat 2:')) return 'Remove seat';
+    if (title.startsWith('Add seat to arena runners')) return options.find(option => option === grokId);
+    return undefined;
+  });
+  assert(result.notices.some(notice => /Cannot save yet.*arena runners needs 2–16 seats/.test(notice)));
+  assert(result.notices.some(notice => /arena 方案执行.*需要 2–16 个席位/.test(notice)));
+  assert.deepEqual(loadModels().panels?.arena, [claudeId, grokId]);
+  assert.equal(result.messages.length, 1);
 }));
 
 test('long model registries are paginated and the suggested judge pool is bounded', async () => withHome(async () => {

package/test/setup-rpc.test.ts

@@ -42,8 +42,10 @@ test('real Pi RPC runs setup and dispatches the optional verification follow-up'
           if (event.type === 'extension_ui_request' && event.method === 'select') {
             titles.push(event.title);
             const value = event.title.startsWith('Child reasoning') ? event.options.find((option: string) => option.startsWith('inherit-parent'))
-              : event.title.startsWith('Review pstack') ? 'Save settings' : undefined;
+              : event.title.startsWith('Review pstack') ? event.options.find((option: string) => option.startsWith('Save settings')) : undefined;
             if (!value) { clearTimeout(timer); reject(new Error(`Unexpected setup dialog: ${event.title}`)); return; }
+            assert.match(event.title, /[\u4e00-\u9fff]/, 'setup prompts should include Chinese in RPC mode');
+            assert(event.options.some((option: string) => /[\u4e00-\u9fff]/.test(option)), 'setup options should include Chinese in RPC mode');
             send({ type: 'extension_ui_response', id: event.id, value });
           }
           if (event.type === 'extension_ui_request' && event.method === 'notify' && event.message.startsWith('Saved pstack settings')) saved = true;