pi-web-ui 0.68.1 → 0.69.0

package/dist/server/prompt-composer.js

@@ -17,6 +17,7 @@
  * 本模块是纯函数（不 import SDK / node），浏览器端可复用（SettingsModal 需要
  * DEFAULT_PROMPT_TEMPLATE 与 token 元数据）。
  */
+import { getServerBlock, pick } from "./i18n.js";
 /** 全部来源 token。默认模板顺序即此数组顺序。 */
 export const PROMPT_TOKENS = [
     "soul", // 内置灵魂提示词（persona；有 SYSTEM.md 时其内容）
@@ -31,6 +32,25 @@ export const PROMPT_TOKENS = [
     "skills", // 技能段 <available_skills>
     "cwd", // Current working directory 行
 ];
+/** 只读来源（设置面板只读展示、不提供覆盖输入）：这些 token 的内容由系统/环境
+ *  在每次 run 时动态生成（工具集、项目文件、技能、工作目录、开关状态），用户无法
+ *  在设置里预设其内容。反之 soul / guidelines / append 是用户内容层，可编辑。
+ *  注意：只读是「设置面板 UI」层面；服务端 override 机制（renderPromptTemplate）
+ *  仍保留，以兼容旧配置与编程调用。 */
+export const READONLY_PROMPT_SOURCES = [
+    "tools", // 工具列表（运行时时按已注册工具动态生成）
+    "pi_docs", // Pi 文档指引（指向已安装 pi 包路径，由安装位置决定）
+    "persona", // Windows persona（仅 win32，平台固定）
+    "terminal", // 终端工具使用引导（随「终端工具」开关）
+    "markers", // 内置标记工具引导（随 markers 开关）
+    "context", // 项目上下文（AGENTS.md / CLAUDE.md 收集结果）
+    "skills", // 技能段（来自环境/技能文件）
+    "cwd", // 当前工作目录
+];
+/** 仅当 token 是只读来源时返回 true（设置面板用于判断是否展示覆盖输入框）。 */
+export function isReadonlyPromptSource(token) {
+    return READONLY_PROMPT_SOURCES.includes(token);
+}
 /** 默认模板：全部 token 按自然顺序以空行连接 —— 无覆盖、不改动时渲染结果 ≈
  *  SDK 默认拼装的完整提示词。 */
 export const DEFAULT_PROMPT_TEMPLATE = PROMPT_TOKENS.map((t) => `{{${t}}}`).join("\n\n");
@@ -59,8 +79,25 @@ export function overrideOf(overrides, token) {
 }
 /** 内置默认灵魂段落（buildSystemPrompt 默认分支的开头，与 SDK 同步维护）。 */
 export const BUILTIN_SOUL = "You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.";
+/**
+ * 内置默认灵魂段落的中文版（issue #91）：lang === "zh" 且调用方未自定义
+ * builtinSoul 时 {{soul}} 用它。英文版 BUILTIN_SOUL 保持原样（英文默认）。
+ */
+export const BUILTIN_SOUL_ZH = "你是运行在 pi（一个编码智能体框架）中的专业编码助手。你通过读取文件、执行命令、编辑代码和新建文件来帮助用户。";
 /** Pi documentation 段模板 —— 与 SDK buildSystemPrompt 默认分支一致（路径由调用方注入）。 */
-export function buildPiDocsText(readme, docs, examples) {
+export function buildPiDocsText(readme, docs, examples, lang = "en") {
+    if (lang === "zh") {
+        return [
+            "Pi 文档（仅当用户问及 pi 本身、其 SDK、扩展、主题、技能或 TUI 时阅读）：",
+            `- 主文档：${readme}`,
+            `- 更多文档：${docs}`,
+            `- 示例：${examples}（扩展、自定义工具、SDK）`,
+            "- 阅读 pi 文档或示例时，在「更多文档」下找 docs/...、在「示例」下找 examples/...，不要按当前工作目录解析",
+            "- 被问及以下主题时：扩展（docs/extensions.md、examples/extensions/）、主题（docs/themes.md）、技能（docs/skills.md）、提示词模板（docs/prompt-templates.md）、TUI 组件（docs/tui.md）、快捷键（docs/keybindings.md）、SDK 集成（docs/sdk.md）、自定义服务商（docs/custom-provider.md）、添加模型（docs/models.md）、pi 包（docs/packages.md）、环境变量（docs/environment-variables.md）",
+            "- 处理 pi 相关主题时，先阅读文档和示例，并跟随其中的 .md 交叉引用，再动手实现",
+            "- pi 的 .md 文件务必通读全文，并跟随其中指向相关文档的链接（例如 TUI API 细节见 tui.md）",
+        ].join("\n");
+    }
     return [
         "Pi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):",
         `- Main documentation: ${readme}`,
@@ -75,6 +112,7 @@ export function buildPiDocsText(readme, docs, examples) {
 /** Guidelines 段：文件探索引导 + 工具 promptGuidelines（去重）+ 固定两行。
  *  与 buildSystemPrompt 默认分支的聚合规则一致。 */
 function buildGuidelinesText(inputs) {
+    const lang = inputs.lang ?? "en";
     const selected = new Set(inputs.selectedTools);
     const lines = [];
     const add = (g) => {
@@ -85,14 +123,14 @@ function buildGuidelinesText(inputs) {
     const has = (n) => selected.has(n);
     if ((has("bash") || has("powershell")) && !has("grep") && !has("find") && !has("ls")) {
         add(has("bash") && has("powershell")
-            ? "Use bash or PowerShell for file operations like listing, searching, and finding files"
-            : "Use bash for file operations like ls, rg, find");
+            ? pick(lang, "涉及列出、搜索、查找文件等文件操作时，使用 bash 或 PowerShell", "Use bash or PowerShell for file operations like listing, searching, and finding files", "prompt.guidelines.bash.powershell")
+            : pick(lang, "涉及 ls、rg、find 等文件操作时，使用 bash", "Use bash for file operations like ls, rg, find", "prompt.guidelines.bash.basic"));
     }
     for (const g of inputs.toolGuidelines)
         add(g);
-    add("Be concise in your responses");
-    add("Show file paths clearly when working with files");
-    return `Guidelines:\n${lines.map((l) => `- ${l}`).join("\n")}`;
+    add(pick(lang, "回答要简洁", "Be concise in your responses", "prompt.guidelines.be.concise"));
+    add(pick(lang, "处理文件时清楚地给出文件路径", "Show file paths clearly when working with files", "prompt.guidelines.show.paths"));
+    return `${pick(lang, "指导原则：", "Guidelines:", "prompt.guidelines.title")}\n${lines.map((l) => `- ${l}`).join("\n")}`;
 }
 function escapeXml(s) {
     return s
@@ -103,14 +141,14 @@ function escapeXml(s) {
         .replace(/'/g, "&apos;");
 }
 /** 技能段文本（不含前导空行）。与 SDK formatSkillsForPrompt 一致。 */
-export function buildSkillsText(skills) {
+export function buildSkillsText(skills, lang = "en") {
     const visible = skills.filter((s) => !s.disableModelInvocation);
     if (visible.length === 0)
         return "";
     const lines = [
-        "The following skills provide specialized instructions for specific tasks.",
-        "Use the read tool to load a skill's file when the task matches its description.",
-        "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
+        pick(lang, "以下技能为特定任务提供专门的指令。", "The following skills provide specialized instructions for specific tasks.", "prompt.skills.intro.specialized"),
+        pick(lang, "当任务与某技能的描述相符时，用 read 工具加载该技能文件。", "Use the read tool to load a skill's file when the task matches its description.", "prompt.skills.intro.use.read"),
+        pick(lang, "当技能文件引用相对路径时，以技能目录（SKILL.md 的父目录 / 该路径的 dirname）为基准解析，并在工具命令中使用解析后的绝对路径。", "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.", "prompt.skills.intro.resolve.path"),
         "",
         "<available_skills>",
     ];
@@ -125,13 +163,13 @@ export function buildSkillsText(skills) {
     return lines.join("\n");
 }
 /** 项目上下文块（不含前导空行）。 */
-function buildContextText(files) {
+function buildContextText(files, lang = "en") {
     if (files.length === 0)
         return "";
     return [
         "<project_context>",
         "",
-        "Project-specific instructions and guidelines:",
+        pick(lang, "项目专属指令与规范：", "Project-specific instructions and guidelines:", "prompt.context.title"),
         "",
         ...files.map((f) => `<project_instructions path="${f.path}">\n${f.content}\n</project_instructions>`),
         "",
@@ -147,20 +185,42 @@ function buildToolsText(inputs) {
         "In addition to the tools above, you may have access to other custom tools depending on the project.",
     ].join("\n\n");
 }
+/** 工具 schema 只读文本（设置面板「查看当前完整提示词」里展示发给模型的完整
+ *  工具定义：name + description + parameters JSON Schema）。 */
+export function buildToolsSchemaText(tools) {
+    if (tools.length === 0)
+        return "";
+    return tools
+        .map((t) => {
+        const lines = [`## ${t.name}`];
+        if (t.description && t.description.trim())
+            lines.push(t.description.trim());
+        lines.push("", "Parameters (JSON Schema):", JSON.stringify(t.parameters ?? {}, null, 2));
+        return lines.join("\n");
+    })
+        .join("\n\n");
+}
 /** 计算每个 token 的自动内容（无覆盖时的展开值）。 */
 export function resolveSectionTexts(inputs) {
     const cwd = inputs.cwd.replace(/\\/g, "/");
+    const lang = inputs.lang ?? "en";
+    // soul：用户 SYSTEM.md 优先；无则按 lang 选内置默认（调用方自定义的 builtinSoul 原样保留）。
+    let soul = inputs.systemPromptFile?.trim() ? inputs.systemPromptFile : inputs.builtinSoul;
+    if (lang === "zh" && soul === BUILTIN_SOUL)
+        soul = BUILTIN_SOUL_ZH;
+    else if (soul === BUILTIN_SOUL)
+        soul = getServerBlock(lang, "prompt.soul", BUILTIN_SOUL_ZH.split("\n"), BUILTIN_SOUL.split("\n")).join("\n");
     return {
-        soul: inputs.systemPromptFile?.trim() ? inputs.systemPromptFile : inputs.builtinSoul,
+        soul,
         tools: buildToolsText(inputs),
         guidelines: buildGuidelinesText(inputs),
-        pi_docs: buildPiDocsText(inputs.piReadme, inputs.piDocs, inputs.piExamples),
+        pi_docs: buildPiDocsText(inputs.piReadme, inputs.piDocs, inputs.piExamples, lang),
         append: inputs.appendFiles.join("\n\n"),
         persona: inputs.windowsPersona,
         terminal: inputs.terminalGuidance,
         markers: inputs.markersGuidance,
-        context: buildContextText(inputs.contextFiles),
-        skills: buildSkillsText(inputs.skills),
+        context: buildContextText(inputs.contextFiles, lang),
+        skills: buildSkillsText(inputs.skills, lang),
         cwd: `Current working directory: ${cwd}`,
     };
 }

package/dist/server/protocol-version.js

@@ -8,4 +8,4 @@
  * its own copy in web/src/protocol-version.ts; scripts/check-protocol-sync.mjs
  * verifies the two never drift.
  */
-export const PROTOCOL_VERSION = 12;
+export const PROTOCOL_VERSION = 14;

package/dist/server/scm.js

@@ -8,12 +8,14 @@
  */
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { pick } from "./i18n.js";
 const exec = promisify(execFile);
 /** Per-command timeout / output cap — a stuck repo must not hang the panel. */
 const GIT_TIMEOUT_MS = 15_000;
 const MAX_GIT_OUTPUT = 16 * 1024 * 1024;
 /** Run one git command; throws Error with a readable message on failure. */
-async function git(cwd, args) {
+async function git(cwd, args, lang) {
+    const l = lang?.() ?? "en";
     try {
         const { stdout } = await exec("git", ["-c", "core.quotepath=false", ...args], {
             cwd,
@@ -26,11 +28,11 @@ async function git(cwd, args) {
     catch (err) {
         const e = err;
         if (e.code === "ENOENT")
-            throw new Error("未找到 git 命令——请确认已安装 Git 并在 PATH 中");
+            throw new Error(pick(l, "未找到 git 命令——请确认已安装 Git 并在 PATH 中", "git command not found — make sure Git is installed and on PATH", "scm.git.not.found"));
         if (e.killed)
-            throw new Error("git 命令超时");
+            throw new Error(pick(l, "git 命令超时", "git command timed out", "scm.git.timeout"));
         const detail = (e.stderr ?? e.message ?? "").trim().split("\n")[0];
-        throw new Error(detail || "git 命令失败");
+        throw new Error(detail || pick(l, "git 命令失败", "git command failed", "scm.git.failed"));
     }
 }
 /** Absolute path of the repo's git dir (handles worktrees/submodules), or
@@ -244,16 +246,16 @@ const HISTORY_ARGS = [
 ];
 /** Commit graph for the history tab — fetched lazily so the common
  *  "changes" view never pays for it on huge repos. */
-export async function scmHistory(cwd) {
-    return parseCommitHistory(await git(cwd, HISTORY_ARGS));
+export async function scmHistory(cwd, lang) {
+    return parseCommitHistory(await git(cwd, HISTORY_ARGS, lang));
 }
 /** Status refresh payload (status + branches + numstat) — parallel. */
-export async function scmStatus(cwd) {
+export async function scmStatus(cwd, lang) {
     const [statusText, branchText, statText, cachedStatText] = await Promise.all([
-        git(cwd, ["status", "--porcelain=v1", "-b", "--find-renames"]),
-        git(cwd, ["for-each-ref", "refs/heads", "refs/remotes", "--format=%(refname)%09%(HEAD)"]),
-        git(cwd, ["diff", "--numstat"]),
-        git(cwd, ["diff", "--cached", "--numstat"]),
+        git(cwd, ["status", "--porcelain=v1", "-b", "--find-renames"], lang),
+        git(cwd, ["for-each-ref", "refs/heads", "refs/remotes", "--format=%(refname)%09%(HEAD)"], lang),
+        git(cwd, ["diff", "--numstat"], lang),
+        git(cwd, ["diff", "--cached", "--numstat"], lang),
     ]);
     const header = parseStatusHeader(statusText
         .split("\n")
@@ -282,23 +284,14 @@ export async function scmStatus(cwd) {
     };
 }
 /** Staged + worktree diffs for one file (empty strings when no diff). */
-export async function scmFileDiff(cwd, path) {
+export async function scmFileDiff(cwd, path, lang) {
     const [staged, worktree] = await Promise.all([
-        git(cwd, ["diff", "--cached", "--no-color", "--no-ext-diff", "--", path]).catch(() => ""),
-        git(cwd, ["diff", "--no-color", "--no-ext-diff", "--", path]).catch(() => ""),
+        git(cwd, ["diff", "--cached", "--no-color", "--no-ext-diff", "--", path], lang).catch(() => ""),
+        git(cwd, ["diff", "--no-color", "--no-ext-diff", "--", path], lang).catch(() => ""),
     ]);
     return { staged, worktree };
 }
 /** Full patch of one commit (`git show`). */
-export async function scmCommitDetail(cwd, hash) {
-    return git(cwd, [
-        "show",
-        "--no-color",
-        "--no-ext-diff",
-        "--find-renames",
-        "--format=fuller",
-        "--stat",
-        "--patch",
-        hash,
-    ]);
+export async function scmCommitDetail(cwd, hash, lang) {
+    return git(cwd, ["show", "--no-color", "--no-ext-diff", "--find-renames", "--format=fuller", "--stat", "--patch", hash], lang);
 }

package/dist/server/serialize.js

@@ -166,6 +166,7 @@ export function serializeMessage(m, seq) {
                 role: "compactionSummary",
                 content: [{ type: "text", text, truncated }],
                 timestamp: m.timestamp,
+                tokensBefore: m.tokensBefore,
             };
         }
         default:

package/dist/server/settings-service.js

@@ -8,7 +8,7 @@
  */
 import { existsSync, readdirSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
-import { extensionKey } from "./client-state.js";
+import { extensionKey, normalizeRetryMaxAttempts, } from "./client-state.js";
 import { findVisionModels, SYSTEM_PROMPT } from "./vision-bridge.js";
 import { DEFAULT_TEMPLATES } from "./subagent-templates.js";
 export class SettingsService {
@@ -193,6 +193,8 @@ export class SettingsService {
                 terminalBash: this.settings.terminalBash,
                 terminalBashIdleMs: this.settings.terminalBashIdleMs,
                 editSoftEnabled: this.settings.editSoftEnabled,
+                questionnaireEnabled: this.settings.questionnaireEnabled,
+                goalModeEnabled: this.settings.goalModeEnabled,
                 thinkingWrap: this.settings.thinkingWrap,
                 toolsWrap: this.settings.toolsWrap,
                 visionBridgeEnabled: this.settings.visionBridgeEnabled,
@@ -206,6 +208,8 @@ export class SettingsService {
                 effectiveSystemPrompt: promptSnap.full,
                 // 每个来源未覆盖时的默认（自动）内容（「各来源」行预览用）。
                 promptSourceDefaults: promptSnap.texts,
+                // 发给模型的工具 schema（name/description/parameters）—— 只读预览。
+                toolsSchema: promptSnap.toolsSchema,
                 visionBridgeDefaultPrompt: SYSTEM_PROMPT,
                 visionModels: this.collectVisionModels(),
                 disabledSkills: [...this.settings.disabledSkills],
@@ -224,6 +228,7 @@ export class SettingsService {
                 subagentTemplates: this.templates.list(),
                 subagentDefaultTemplates: DEFAULT_TEMPLATES.map((t) => t.name),
                 subagentDefaultModel: this.settings.subagentDefaultModel ?? null,
+                retryMaxAttempts: this.settings.retryMaxAttempts,
                 subagentModels: this.collectSubagentModels(),
                 quickPhrases: [...this.settings.quickPhrases],
                 quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
@@ -320,6 +325,14 @@ export class SettingsService {
         if (partial.editSoftEnabled !== undefined) {
             this.settings.editSoftEnabled = partial.editSoftEnabled;
         }
+        // 问卷开关：运行时无需重载（bridge 处实时读取）。
+        if (partial.questionnaireEnabled !== undefined) {
+            this.settings.questionnaireEnabled = partial.questionnaireEnabled;
+        }
+        // 目标模式总开关：运行时无需重载（goal bar / 服务端入口实时读取）。
+        if (partial.goalModeEnabled !== undefined) {
+            this.settings.goalModeEnabled = partial.goalModeEnabled;
+        }
         if (partial.thinkingWrap !== undefined) {
             this.settings.thinkingWrap = partial.thinkingWrap;
         }
@@ -349,6 +362,12 @@ export class SettingsService {
             const m = partial.subagentDefaultModel?.trim() ?? "";
             this.settings.subagentDefaultModel = m ? m : null;
         }
+        if (partial.retryMaxAttempts !== undefined) {
+            // 出错重试次数：持久化 + 即时注入各会话（SDK 在每次退避前都重读
+            // getRetrySettings，无需 reload runtime；见宿主 applyRetryOverrides）。
+            this.settings.retryMaxAttempts = normalizeRetryMaxAttempts(partial.retryMaxAttempts);
+            this.host.applyRetryOverrides();
+        }
         if (partial.quickPhrases !== undefined) {
             // 归一化：去空白/空项/重名，单条 ≤200 字，最多 30 条。纯 UI 偏好，不 reload。
             const seen = new Set();
@@ -389,6 +408,7 @@ export class SettingsService {
             terminalBash: this.settings.terminalBash,
             terminalBashIdleMs: this.settings.terminalBashIdleMs,
             editSoftEnabled: this.settings.editSoftEnabled,
+            retryMaxAttempts: this.settings.retryMaxAttempts,
             reviewPrompt: this.settings.reviewPrompt,
             reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
         };
@@ -425,6 +445,12 @@ export class SettingsService {
             terminalBash: p.terminalBash ?? this.settings.terminalBash,
             terminalBashIdleMs: p.terminalBashIdleMs ?? this.settings.terminalBashIdleMs,
             editSoftEnabled: p.editSoftEnabled ?? this.settings.editSoftEnabled,
+            // 重试次数随预设走；旧预设缺字段时保留当前值，应用后即时注入各会话。
+            retryMaxAttempts: p.retryMaxAttempts ?? this.settings.retryMaxAttempts,
+            // 问卷开关不进预设——保留当前值。
+            questionnaireEnabled: this.settings.questionnaireEnabled,
+            // 目标模式总开关不进预设——保留当前值。
+            goalModeEnabled: this.settings.goalModeEnabled,
             reviewPrompt: p.reviewPrompt ?? this.settings.reviewPrompt,
             reviewDisabledSkills: [...(p.reviewDisabledSkills ?? this.settings.reviewDisabledSkills)],
             // 纯 UI 偏好不进预设——保留当前值。
@@ -442,6 +468,8 @@ export class SettingsService {
             quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
         };
         this.host.stateStore.saveSettings(this.host.clientId, this.settings);
+        // 预设可能改了重试次数：即时注入（流式中延迟的 reload 之后还会由调用方重放）。
+        this.host.applyRetryOverrides();
         this.push();
         await this.applyRuntime();
     }

package/dist/server/subagent-templates.js

@@ -11,9 +11,25 @@
  *
  * 与 per-client 的 client-state.json 不同：模板是配置品而非个人偏好，所有浏览器
  * 客户端共用同一份。文件 I/O 一律 best-effort：持久化故障绝不能弄崩 server。
+ *
+ * 双语约定（issue #91）：description/systemPrompt 为中文（zh 用），descriptionEn/
+ * systemPromptEn 为英文（en 用，缺失回落中文）；调用方用 pickTemplateDescription/
+ * pickTemplatePrompt 按语言选用。
  */
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+/** 按语言选模板简介：zh 用 description；en 优先 descriptionEn、缺失回落 description。 */
+export function pickTemplateDescription(t, lang) {
+    if (lang === "zh")
+        return t.description;
+    return t.descriptionEn || t.description;
+}
+/** 按语言选模板提示词：zh 用 systemPrompt；en 优先 systemPromptEn、缺失回落 systemPrompt。 */
+export function pickTemplatePrompt(t, lang) {
+    if (lang === "zh")
+        return t.systemPrompt;
+    return t.systemPromptEn || t.systemPrompt;
+}
 /** 名字去空白折叠后非空且 ≤ 60 字符（工具参数可读，允许中文）。 */
 const NAME_MAX = 60;
 /** 模型 id 上限（"provider/id"，含斜杠与自定义模型目录 id）。 */
@@ -29,6 +45,7 @@ export const DEFAULT_TEMPLATES = [
     {
         name: "review",
         description: "代码 / 计划 / 方案 / PR 审查：有证据的 P0-P2 发现与合并结论",
+        descriptionEn: "Code / plan / proposal / PR review: evidenced P0–P2 findings with a merge verdict",
         promptMode: "replace",
         systemPrompt: "你是一个严格的审查子代理。你的工作是检查、评估并给出有证据的结论。不要猜测；必须从代码、测试、文档或需求中核实。\n\n" +
             "## 审查类型\n" +
@@ -49,6 +66,25 @@ export const DEFAULT_TEMPLATES = [
             "- 发现：P0/P1/P2 + 问题、位置、证据、最小修复方案\n" +
             "- 合并结论：BLOCK / OK / OK with notes\n" +
             "\n只报告由目标改动引起或可达的具体当前问题，并为每条提供源码证明、测试/复现或契约冲突。P0 = 阻止合并；P1 = 发布前应修；P2 = 仅报告。没有符合条件的问题时，明确写「No issues found.」。",
+        systemPromptEn: "You are a strict review subagent. Your job is to inspect, assess, and deliver evidence-backed conclusions. Do not guess; verify against code, tests, docs, or requirements.\n\n" +
+            "## Review types\n" +
+            "1. Code diff (changed files): check the implementation matches intent and requirements; code is correct and consistent and covers edge cases; tests cover the change and still pass; no unintended side effects or regressions; the change is minimal and readable.\n" +
+            "2. Plan: validate feasibility, completeness, missing steps, hidden risks, consistency with existing architecture and constraints, appropriate scope.\n" +
+            "3. Proposal: evaluate correctness and trade-offs, consistency with existing codebase patterns, whether a simpler alternative exists, whether edge cases are missed.\n" +
+            "4. Overall repo state: inspect key files, tests, and structure for architecture drift, tech debt, inconsistent patterns and naming, areas lacking tests/docs, obvious bugs or fragile code, simplification and consolidation opportunities.\n" +
+            "5. Specific PR / issue: understand the context first, then verify the fix targets the root cause, the change is minimal and focused, no regressions, tests and docs updated in sync.\n\n" +
+            "## Working rules\n" +
+            "- Locate via exact source files, symbols, types, methods, and paths first, then read the relevant files; use broad search only when exhaustive verification is needed (call sites, imports, deleted names, absence of a pattern).\n" +
+            "- Never invent issues — only report problems you can prove with evidence; filter findings by evidence, not severity.\n" +
+            "- Cite exact file paths and line numbers when quoting code.\n" +
+            "- If everything looks good, say so. Do not hunt for issues just to have some.\n\n" +
+            "## Output format\n" +
+            "## Review\n" +
+            "- Correct: what is already done well and as expected (with evidence)\n" +
+            "- Fixed: issue, location, and resolution (if you made changes)\n" +
+            "- Findings: P0/P1/P2 + issue, location, evidence, minimal fix\n" +
+            "- Merge verdict: BLOCK / OK / OK with notes\n" +
+            '\nOnly report concrete current issues caused by or reachable from the target change, each with source proof, a test/repro, or a contract conflict. P0 = blocks merge; P1 = fix before release; P2 = report only. When nothing qualifies, state explicitly "No issues found.".',
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
@@ -57,6 +93,7 @@ export const DEFAULT_TEMPLATES = [
     {
         name: "implement",
         description: "实现子代理：窄而正确的代码改动 + 验证与清晰的汇报",
+        descriptionEn: "Implementer: narrow, correct code changes with verification and a clear report",
         promptMode: "replace",
         systemPrompt: "你是 implement 子代理：唯一的写入线程。你的任务是执行分派的任务或已批准的方向，做窄而连贯的修改。主 agent 和用户保留决策权。\n\n" +
             "默认职责：\n" +
@@ -75,6 +112,23 @@ export const DEFAULT_TEMPLATES = [
             "- 若分派的任务期望代码/文件改动而你实际没做改动，不要返回成功摘要——做改动、说明受阻，或明确报告未做改动。\n\n" +
             "最终回复格式：\n" +
             "实现内容：X。\n改动文件：Y。\n验证：Z。\n未决风险/问题：R。\n建议下一步：N。",
+        systemPromptEn: "You are the implement subagent: the single writing thread. Your task is to execute the assigned task or the approved direction with narrow, coherent changes. The main agent and the user keep decision authority.\n\n" +
+            "Default duties:\n" +
+            "- Verify the task or approved direction against the actual code\n" +
+            "- Make the minimal correct change, following existing codebase patterns\n" +
+            "- Verify the result with appropriate checks (tests, typecheck, lint) where possible\n" +
+            "- Report clearly: changes, verification, risks, next steps\n\n" +
+            "Working rules:\n" +
+            "- Prefer narrow, correct changes; no sweeping rewrites.\n" +
+            "- Keep the source discoverable: concrete names, clear types, one spelling per concept, tests named after the source.\n" +
+            "- No speculative scaffolding or future-proofing unless explicitly asked.\n" +
+            "- No placeholder code, TODOs, or silent scope changes.\n" +
+            "- Use terminal commands for checks, verification, and related tests.\n" +
+            "- If context or a plan was provided, read it first.\n" +
+            "- If the implementation reveals an unapproved product or architecture choice, stop and report instead of deciding on your own.\n" +
+            "- If the assigned task expects code/file changes but you made none, do not return a success summary — make the change, explain what blocked you, or explicitly report that nothing was changed.\n\n" +
+            "Final reply format:\n" +
+            "Implemented: X.\nChanged files: Y.\nVerification: Z.\nOpen risks/issues: R.\nSuggested next steps: N.",
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
@@ -83,6 +137,7 @@ export const DEFAULT_TEMPLATES = [
     {
         name: "research",
         description: "网络调研：多角度检索、来源充分的研究简报（Summary/Findings/Sources/Gaps）",
+        descriptionEn: "Web research: multi-angle search with a well-sourced brief (Summary/Findings/Sources/Gaps)",
         promptMode: "replace",
         systemPrompt: "你是一个研究子代理。\n" +
             "给定问题或主题，展开聚焦的研究并产出一份简洁、来源充分的简报。\n\n" +
@@ -99,6 +154,21 @@ export const DEFAULT_TEMPLATES = [
             "## Findings\n带内联来源引用的编号发现。\n" +
             "## Sources\n保留（标题 + URL + 为什么重要）与丢弃（及原因）。\n" +
             "## Gaps\n未能自信回答的部分与建议下一步。",
+        systemPromptEn: "You are a research subagent.\n" +
+            "Given a question or topic, run focused research and produce a concise, well-sourced brief.\n\n" +
+            "Working rules:\n" +
+            "- Break the question into 2–4 distinct research angles.\n" +
+            "- Use the available search/fetch tools; without dedicated tools, use terminal commands to reach public sources.\n" +
+            "- Read search-result summaries first, then fetch full text only for the most promising sources.\n" +
+            "- Prefer primary sources, official docs, specs, benchmarks, and direct evidence over second-hand commentary.\n" +
+            "- Discard outdated, redundant, or SEO-stuffed sources.\n" +
+            "- If the first search round leaves important gaps, run one more round with tighter follow-up queries.\n\n" +
+            "Output format:\n" +
+            "# Research: [topic]\n" +
+            "## Summary\n2–3 sentences with the direct answer.\n" +
+            "## Findings\nNumbered findings with inline source citations.\n" +
+            "## Sources\nKept (title + URL + why it matters) and discarded (with reasons).\n" +
+            "## Gaps\nWhat could not be answered confidently, plus suggested next steps.",
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
@@ -107,6 +177,7 @@ export const DEFAULT_TEMPLATES = [
     {
         name: "scout",
         description: "代码库侦察：快速勘察并返回另一个 agent 行动所需的最小上下文",
+        descriptionEn: "Codebase scout: quick recon returning the minimal context another agent needs to act",
         promptMode: "replace",
         systemPrompt: "你是一个代码库侦察子代理。\n" +
             "快速勘察代码库，返回另一个 agent 行动所需的最小上下文：\n" +
@@ -125,6 +196,23 @@ export const DEFAULT_TEMPLATES = [
             "## Key Code\n关键类型/接口/函数与小段代码。\n" +
             "## Architecture\n各部分如何连接。\n" +
             "## Start Here\n另一个 agent 应最先打开的文件及原因。",
+        systemPromptEn: "You are a codebase scout subagent.\n" +
+            "Quickly reconnoiter the codebase and return the minimal context another agent needs to act:\n" +
+            "- Relevant entry points\n" +
+            "- Key types, interfaces, functions\n" +
+            "- Data flow and dependencies\n" +
+            "- Files most likely to need changes\n" +
+            "- Constraints, risks, and open questions\n\n" +
+            "Working rules:\n" +
+            "- Read the paths and concrete symbols/types/methods/filenames given in the task first; use filesystem commands for path discovery; prefer targeted search and selective reading unless the task explicitly needs broad search.\n" +
+            "- When quoting code, give exact paths and line ranges; keep output concise.\n" +
+            "- When running standalone, briefly summarize what you found in the final reply after the output.\n\n" +
+            "Output format:\n" +
+            "# Code Context\n" +
+            "## Files Retrieved\nExact files with line ranges and why they matter.\n" +
+            "## Key Code\nKey types/interfaces/functions with short snippets.\n" +
+            "## Architecture\nHow the parts connect.\n" +
+            "## Start Here\nWhich files another agent should open first and why.",
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
@@ -133,6 +221,7 @@ export const DEFAULT_TEMPLATES = [
     {
         name: "audit",
         description: "轻量安全审计：密钥泄漏 / 注入 / 权限 / 敏感数据，带路径与修复建议",
+        descriptionEn: "Lightweight security audit: leaked secrets / injection / permissions / sensitive data, with paths and fixes",
         promptMode: "replace",
         systemPrompt: "你是一个轻量级安全审计子代理。被要求审查代码时，扫描：\n" +
             "- 硬编码的密钥或凭据\n" +
@@ -142,6 +231,14 @@ export const DEFAULT_TEMPLATES = [
             "- 敏感数据泄漏（日志、错误响应、客户端代码）\n\n" +
             "对每条发现给出：文件路径 + 问题说明 + 最短修复建议，按严重度排序（P0 阻止合入 / P1 发布前修 / P2 建议）。\n" +
             "只报告能由证据支持的发现，不要臆测。没有发现问题时明确说「未发现安全问题」。保持简洁。",
+        systemPromptEn: "You are a lightweight security-audit subagent. When asked to review code, scan for:\n" +
+            "- Hardcoded secrets or credentials\n" +
+            "- Injection flaws (SQL, command, XSS, etc.)\n" +
+            "- Overly broad permissions or dangerous read/write operations\n" +
+            "- Unsafe dependency usage or outdated protocols (plaintext transport, weak hashes, missing validation)\n" +
+            "- Sensitive data leaks (logs, error responses, client-side code)\n\n" +
+            "For each finding give: file path + issue description + shortest fix suggestion, ordered by severity (P0 blocks merge / P1 fix before release / P2 advisory).\n" +
+            'Only report findings supported by evidence; do not speculate. When nothing is found, state explicitly "No security issues found.". Keep it concise.',
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
@@ -150,12 +247,18 @@ export const DEFAULT_TEMPLATES = [
     {
         name: "delegate",
         description: "通用委派：轻量指令执行，只做范围内的事并如实汇报（append 模式）",
+        descriptionEn: "General delegation: lightweight instruction execution, in-scope only, honest report (append mode)",
         promptMode: "append",
         systemPrompt: "你是主 agent 委派的执行子代理，按照交给你的明确指令完成任务。规则：\n" +
             "- 只处理指令范围内的工作，不要自作主张扩大范围。\n" +
             "- 有疑问先尝试从工作区文件本身找答案；仍不确定则如实报告，不要猜测或编造。\n" +
             "- 汇报时给出：做了什么、结果/证据、遇到的问题、建议的下一步。\n" +
             "- 简洁、具体，引用证据（路径、命令输出、行号）。",
+        systemPromptEn: "You are an execution subagent delegated by the main agent; complete the task per the explicit instructions given to you. Rules:\n" +
+            "- Only handle work within the instructions' scope; do not expand it on your own.\n" +
+            "- When in doubt, first try to find the answer in the workspace files themselves; if still unsure, report honestly instead of guessing or fabricating.\n" +
+            "- When reporting, give: what was done, results/evidence, problems encountered, suggested next steps.\n" +
+            "- Be concise and concrete, citing evidence (paths, command output, line numbers).",
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
@@ -173,8 +276,10 @@ function normalize(raw) {
     return {
         name,
         description: typeof o.description === "string" ? o.description : "",
+        descriptionEn: typeof o.descriptionEn === "string" && o.descriptionEn ? o.descriptionEn : undefined,
         promptMode: o.promptMode === "replace" ? "replace" : "append",
         systemPrompt: typeof o.systemPrompt === "string" ? o.systemPrompt : "",
+        systemPromptEn: typeof o.systemPromptEn === "string" && o.systemPromptEn ? o.systemPromptEn : undefined,
         enabledSkills: Array.isArray(o.enabledSkills)
             ? o.enabledSkills.filter((x) => typeof x === "string")
             : [],