pi-web-ui 0.62.0 → 0.63.0

package/dist/server/scm.js

@@ -63,16 +63,27 @@ function unquotePath(s) {
     const inner = s.endsWith('"') ? s.slice(1, -1) : s.slice(1);
     return inner.replace(/\\(.)/g, (_m, c) => {
         switch (c) {
-            case "n": return "\n";
-            case "t": return "\t";
-            case "r": return "\r";
-            case "b": return "\b";
-            case "a": return "\a";
-            case "f": return "\f";
-            case "v": return "\v";
-            case "\\": return "\\";
-            case '"': return '"';
-            default: return c;
+            case "n":
+                return "\n";
+            case "t":
+                return "\t";
+            case "r":
+                return "\r";
+            case "b":
+                return "\b";
+            case "a":
+                // eslint-disable-next-line no-useless-escape -- bell escape for git C-style quoting
+                return "\a";
+            case "f":
+                return "\f";
+            case "v":
+                return "\v";
+            case "\\":
+                return "\\";
+            case '"':
+                return '"';
+            default:
+                return c;
         }
     });
 }
@@ -214,10 +225,7 @@ function parseNumStat(text) {
             del = 0;
         const path = unquotePath(line.slice(tab2 + 1).trim());
         const prev = stats[path];
-        stats[path] = [
-            (prev?.[0] ?? 0) + add,
-            (prev?.[1] ?? 0) + del,
-        ];
+        stats[path] = [(prev?.[0] ?? 0) + add, (prev?.[1] ?? 0) + del];
     }
     return stats;
 }
@@ -243,16 +251,14 @@ export async function scmHistory(cwd) {
 export async function scmStatus(cwd) {
     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, ["for-each-ref", "refs/heads", "refs/remotes", "--format=%(refname)%09%(HEAD)"]),
         git(cwd, ["diff", "--numstat"]),
         git(cwd, ["diff", "--cached", "--numstat"]),
     ]);
-    const header = parseStatusHeader(statusText.split("\n").find((l) => l.startsWith("## "))?.slice(3) ?? "");
+    const header = parseStatusHeader(statusText
+        .split("\n")
+        .find((l) => l.startsWith("## "))
+        ?.slice(3) ?? "");
     // Worktree + staged line counts, merged per path.
     const merged = {};
     for (const [path, pair] of Object.entries(parseNumStat(statText))) {

package/dist/server/serialize.js

@@ -80,9 +80,7 @@ export function serializeMessage(m, seq) {
                 errorMessage: m.errorMessage,
             };
         case "toolResult": {
-            const raw = m.content
-                .map((c) => (c.type === "text" ? c.text : "[image result]"))
-                .join("\n");
+            const raw = m.content.map((c) => (c.type === "text" ? c.text : "[image result]")).join("\n");
             const { text, truncated } = truncate(raw, TOOL_OUTPUT_CAP);
             return {
                 id: `t-${m.toolCallId}`,

package/dist/server/settings-service.js

@@ -10,16 +10,21 @@ import { existsSync, readdirSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { extensionKey } from "./client-state.js";
 import { findVisionModels, SYSTEM_PROMPT } from "./vision-bridge.js";
+import { DEFAULT_TEMPLATES } from "./subagent-templates.js";
 export class SettingsService {
     host;
+    templates;
     settings;
     presets;
     knownSkills = new Map();
     knownExtensions = new Map();
     /** 流式中改了需要 reload 的设置 → agent_end 后延迟应用（防拆毁运行中 run）。 */
     pendingReload = false;
-    constructor(host) {
+    constructor(host, 
+    /** 全局子代理模板库（所有客户端共享；模板改动无需 reload runtime）。 */
+    templates) {
         this.host = host;
+        this.templates = templates;
         this.settings = host.stateStore.getSettings(host.clientId);
         this.presets = host.stateStore.getPresets(host.clientId);
     }
@@ -59,10 +64,7 @@ export class SettingsService {
                 return true;
         }
         // ④ npm 包内 skills（agent 级 + 项目级，含 @scope 两级子包）
-        for (const npmRoot of [
-            join(agentDir, "npm", "node_modules"),
-            join(cwd, ".pi", "npm", "node_modules"),
-        ]) {
+        for (const npmRoot of [join(agentDir, "npm", "node_modules"), join(cwd, ".pi", "npm", "node_modules")]) {
             try {
                 for (const entry of readdirSync(npmRoot, { withFileTypes: true })) {
                     if (!entry.isDirectory())
@@ -98,18 +100,17 @@ export class SettingsService {
             // Prune entries that no longer exist on disk AND aren't disabled
             // (e.g. a skill/extension file was deleted). Disabled entries are
             // kept so they can be re-enabled even when filtered out of the loader.
-            const keepSkills = new Set([
-                ...loadedSkills.map((s) => s.name),
-                ...this.settings.disabledSkills,
-            ]);
+            const keepSkills = new Set([...loadedSkills.map((s) => s.name), ...this.settings.disabledSkills]);
             const keepExts = new Set([
                 ...loadedExts.map((e) => extensionKey(e)),
                 ...this.settings.disabledExtensions,
             ]);
+            // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
             for (const name of [...this.knownSkills.keys()]) {
                 if (!keepSkills.has(name))
                     this.knownSkills.delete(name);
             }
+            // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
             for (const id of [...this.knownExtensions.keys()]) {
                 if (!keepExts.has(id))
                     this.knownExtensions.delete(id);
@@ -126,9 +127,7 @@ export class SettingsService {
                 const p = e.sourceInfo?.path ?? e.path;
                 this.knownExtensions.set(id, {
                     id,
-                    name: e.sourceInfo?.origin === "package" && e.sourceInfo.source
-                        ? e.sourceInfo.source
-                        : basename(p),
+                    name: e.sourceInfo?.origin === "package" && e.sourceInfo.source ? e.sourceInfo.source : basename(p),
                     path: p,
                     enabled: true,
                 });
@@ -142,9 +141,7 @@ export class SettingsService {
         // 推送都会把已删除的 skill 以灰条形式永恒地补回面板（“关闭过的
         // skill 被一直记录”）。session 未就绪时保守跳过。
         if (loadedSkillNames !== null) {
-            const stale = [
-                ...new Set([...this.settings.disabledSkills, ...this.settings.reviewDisabledSkills]),
-            ].filter((name) => !loadedSkillNames.has(name) && !this.skillStillOnDisk(name));
+            const stale = [...new Set([...this.settings.disabledSkills, ...this.settings.reviewDisabledSkills])].filter((name) => !loadedSkillNames.has(name) && !this.skillStillOnDisk(name));
             if (stale.length > 0) {
                 this.settings.disabledSkills = this.settings.disabledSkills.filter((n) => !stale.includes(n));
                 this.settings.reviewDisabledSkills = this.settings.reviewDisabledSkills.filter((n) => !stale.includes(n));
@@ -213,6 +210,8 @@ export class SettingsService {
                 reviewSkills,
                 extensions,
                 presets: this.presets.map((p) => ({ ...p })),
+                subagentTemplates: this.templates.list(),
+                subagentDefaultTemplates: DEFAULT_TEMPLATES.map((t) => t.name),
             },
         });
     }
@@ -294,7 +293,12 @@ export class SettingsService {
     async savePreset(name) {
         const n = name.trim();
         if (!n) {
-            this.host.emit({ type: "notice", level: "error", text: "预设名称不能为空" });
+            this.host.emit({
+                type: "notice",
+                level: "error",
+                text: "预设名称不能为空",
+                textEn: "Preset name cannot be empty",
+            });
             return;
         }
         const preset = {
@@ -321,7 +325,12 @@ export class SettingsService {
     async applyPreset(name) {
         const p = this.presets.find((x) => x.name === name);
         if (!p) {
-            this.host.emit({ type: "notice", level: "error", text: `预设不存在：${name}` });
+            this.host.emit({
+                type: "notice",
+                level: "error",
+                text: `预设不存在：${name}`,
+                textEn: `Preset does not exist: ${name}`,
+            });
             return;
         }
         this.settings = {
@@ -335,9 +344,7 @@ export class SettingsService {
             terminalBash: p.terminalBash ?? this.settings.terminalBash,
             terminalBashIdleMs: p.terminalBashIdleMs ?? this.settings.terminalBashIdleMs,
             reviewPrompt: p.reviewPrompt ?? this.settings.reviewPrompt,
-            reviewDisabledSkills: [
-                ...(p.reviewDisabledSkills ?? this.settings.reviewDisabledSkills),
-            ],
+            reviewDisabledSkills: [...(p.reviewDisabledSkills ?? this.settings.reviewDisabledSkills)],
             // 纯 UI 偏好不进预设——保留当前值。
             thinkingWrap: this.settings.thinkingWrap,
             toolsWrap: this.settings.toolsWrap,
@@ -357,6 +364,39 @@ export class SettingsService {
         this.host.stateStore.savePresets(this.host.clientId, this.presets);
         this.push();
     }
+    /** Upsert 一个子代理模板（全局共享）。模板只影响未来派生的子代理，
+     *  不需要 reload runtime —— 直接推送新设置状态即可。 */
+    async saveTemplate(template) {
+        const err = this.templates.upsert(template);
+        if (err) {
+            this.host.emit({
+                type: "notice",
+                level: "error",
+                text: `子代理模板保存失败：${err}`,
+                textEn: `Failed to save subagent template: ${err}`,
+            });
+            return;
+        }
+        this.push();
+        const n = template?.name?.trim() ?? "";
+        this.host.emit({
+            type: "notice",
+            level: "info",
+            text: `子代理模板已保存：${n}`,
+            textEn: `Subagent template saved: ${n}`,
+        });
+    }
+    /** 删除一个子代理模板。 */
+    async deleteTemplate(name) {
+        this.templates.remove(name);
+        this.push();
+        this.host.emit({
+            type: "notice",
+            level: "info",
+            text: `子代理模板已删除：${name}`,
+            textEn: `Subagent template deleted: ${name}`,
+        });
+    }
     /**
      * Make settings changes effective in the running runtime. The resource-loader
      * overrides read this.settings at call time, so a reload re-applies them.
@@ -371,6 +411,7 @@ export class SettingsService {
                 type: "notice",
                 level: "info",
                 text: "当前回复进行中，设置将在回复结束后自动应用",
+                textEn: "A reply is in progress; settings will apply when it finishes",
             });
             return;
         }
@@ -382,13 +423,14 @@ export class SettingsService {
             await this.host.reloadSession();
             this.push();
             this.host.flushSnapshot();
-            this.host.emit({ type: "notice", level: "info", text: "设置已应用" });
+            this.host.emit({ type: "notice", level: "info", text: "设置已应用", textEn: "Settings applied" });
         }
         catch (err) {
             this.host.emit({
                 type: "notice",
                 level: "error",
                 text: `设置应用失败：${err.message}`,
+                textEn: `Failed to apply settings: ${err.message}`,
             });
         }
     }

package/dist/server/slash-commands.js

@@ -4,9 +4,27 @@
  * sync with exec(). */
 export const NATIVE_COMMANDS = [
     { name: "new", description: "新建对话", descriptionEn: "New chat" },
-    { name: "model", description: "切换模型", descriptionEn: "Switch model", argumentHint: "[名称]", argumentHintEn: "[name]" },
-    { name: "compact", description: "压缩上下文", descriptionEn: "Compact context", argumentHint: "[说明]", argumentHintEn: "[instructions]" },
-    { name: "cwd", description: "切换工作目录", descriptionEn: "Switch workspace", argumentHint: "<路径>", argumentHintEn: "<path>" },
+    {
+        name: "model",
+        description: "切换模型",
+        descriptionEn: "Switch model",
+        argumentHint: "[名称]",
+        argumentHintEn: "[name]",
+    },
+    {
+        name: "compact",
+        description: "压缩上下文",
+        descriptionEn: "Compact context",
+        argumentHint: "[说明]",
+        argumentHintEn: "[instructions]",
+    },
+    {
+        name: "cwd",
+        description: "切换工作目录",
+        descriptionEn: "Switch workspace",
+        argumentHint: "<路径>",
+        argumentHintEn: "<path>",
+    },
     {
         name: "thinking",
         description: "设置思考强度",
@@ -139,6 +157,7 @@ export class SlashCommandsService {
                         type: "notice",
                         level: "error",
                         text: `没有匹配到模型：${args}（可用模型见顶栏模型列表）`,
+                        textEn: `No matching model: ${args} (see the model list in the top bar)`,
                     });
                     return true;
                 }
@@ -148,6 +167,7 @@ export class SlashCommandsService {
                         type: "notice",
                         level: "warning",
                         text: `找到 ${matches.length} 个匹配模型，已选用：${pick.name}（精确匹配请用 provider/id）`,
+                        textEn: `Found ${matches.length} matching models, using: ${pick.name} (use provider/id for an exact match)`,
                     });
                 }
                 await this.host.setModel(`${pick.provider}/${pick.id}`);
@@ -169,6 +189,7 @@ export class SlashCommandsService {
                         type: "notice",
                         level: "info",
                         text: `当前工作目录：${this.host.cwd()}。用法：/cwd <路径>`,
+                        textEn: `Current directory: ${this.host.cwd()}. Usage: /cwd <path>`,
                     });
                 }
                 else {
@@ -198,6 +219,7 @@ export class SlashCommandsService {
                         type: "notice",
                         level: "error",
                         text: `无效的思考强度：${args || "（空）"}。可用：off / minimal / low / medium / high / xhigh / max`,
+                        textEn: `Invalid thinking level: ${args || "(empty)"}. Available: off / minimal / low / medium / high / xhigh / max`,
                     });
                     return true;
                 }
@@ -210,6 +232,7 @@ export class SlashCommandsService {
                     type: "notice",
                     level: "info",
                     text: "会话列表已刷新，请在左侧「历史对话」中选择",
+                    textEn: "Session list refreshed — pick one under History on the left",
                 });
                 return true;
             case "reload":
@@ -224,6 +247,7 @@ export class SlashCommandsService {
                         type: "notice",
                         level: "info",
                         text: "已重新加载扩展、技能与提示模板",
+                        textEn: "Reloaded extensions, skills and prompt templates",
                     });
                 }
                 catch (err) {
@@ -231,6 +255,7 @@ export class SlashCommandsService {
                         type: "notice",
                         level: "error",
                         text: `重新加载失败：${err.message}`,
+                        textEn: `Reload failed: ${err.message}`,
                     });
                 }
                 return true;
@@ -239,6 +264,7 @@ export class SlashCommandsService {
                     type: "notice",
                     level: "info",
                     text: "正在退出 pi-web-ui… supervisor 将自动重启服务",
+                    textEn: "Quitting pi-web-ui… the supervisor will restart the service",
                 });
                 setTimeout(() => {
                     const didSchedule = this.host.onQuit?.() ?? false;

package/dist/server/subagent-templates.js

@@ -0,0 +1,249 @@
+/**
+ * subagent-templates.ts — 子代理模板库（全局共享，<dataDir>/subagent-templates.json）。
+ *
+ * 模板 = 派生子代理时套用的预设：角色系统提示词（replace/append 同主设置语义）+
+ * 技能白名单 + 扩展白名单。白名单空数组 = 该维度不限定，子代理跟随主会话设置。
+ * 带 `enabled: false` 的模板停用：设置面板仍可见、可重新启用，但 AI 工具
+ * （subagent_templates / subagent_spawn）查询不到它、也不能选择它——「关闭 =
+ * 对 AI 不可见」。
+ *
+ * 与 per-client 的 client-state.json 不同：模板是配置品而非个人偏好，所有浏览器
+ * 客户端共用同一份。文件 I/O 一律 best-effort：持久化故障绝不能弄崩 server。
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/** 名字去空白折叠后非空且 ≤ 60 字符（工具参数可读，允许中文）。 */
+const NAME_MAX = 60;
+/**
+ * 内置默认模板（第一次运行时种子进列表；用户改动后以 <dataDir> 文件为准）。
+ * 文案改编自 pi-subagents 社区项目（tintinweb / nicobailon）的角色提示词,
+ * 剔除了本项目没有的专有工具引用（contact_supervisor / web_search / workflow…）。
+ * 白名单留空 = 技能/扩展跟随主会话设置，开箱即用。
+ */
+export const DEFAULT_TEMPLATES = [
+    {
+        name: "review",
+        description: "代码 / 计划 / 方案 / PR 审查：有证据的 P0-P2 发现与合并结论",
+        promptMode: "replace",
+        systemPrompt: "你是一个严格的审查子代理。你的工作是检查、评估并给出有证据的结论。不要猜测；必须从代码、测试、文档或需求中核实。\n\n" +
+            "## 审查类型\n" +
+            "1. 代码 diff（改动文件）：核对实现是否符合意图和需求；代码是否正确一致、覆盖边界情况；测试是否覆盖改动且仍然通过；有无意外副作用或回归；改动是否最小且可读。\n" +
+            "2. 计划：验证可行性、完整性、缺失步骤、隐藏风险、与现有架构和约束是否一致、范围是否适当。\n" +
+            "3. 方案：评估正确性与权衡、与代码库现有模式是否一致、是否存在更简单的替代、是否漏掉边界情况。\n" +
+            "4. 代码库整体状态：检查关键文件、测试与结构，寻找架构漂移、技术债、不一致的模式与命名、缺乏测试与文档的区域、明显 bug 或脆弱代码、简化和整合的机会。\n" +
+            "5. 特定 PR / issue：先理解上下文，再验证修复是否针对根因、改动是否最小聚焦、有无回归、测试与文档是否同步更新。\n\n" +
+            "## 工作规则\n" +
+            "- 先用精确的源文件、符号、类型、方法、路径定位，再阅读相关文件；仅在需要穷尽验证（调用点、import、已删除名字、模式不存在）时才用宽泛搜索。\n" +
+            "- 不要凭空捏造问题——只报告你能用证据证明的问题，按证据而非严重度过滤发现。\n" +
+            "- 引用代码时给出准确的文件路径和行号。\n" +
+            "- 如果一切正常，直说。不要为了找问题而找问题。\n\n" +
+            "## 输出格式\n" +
+            "## Review\n" +
+            "- 正确：已经做得好且符合预期的部分（附证据）\n" +
+            "- 修复：问题、位置和解决方法（若你做了修改）\n" +
+            "- 发现：P0/P1/P2 + 问题、位置、证据、最小修复方案\n" +
+            "- 合并结论：BLOCK / OK / OK with notes\n" +
+            "\n只报告由目标改动引起或可达的具体当前问题，并为每条提供源码证明、测试/复现或契约冲突。P0 = 阻止合并；P1 = 发布前应修；P2 = 仅报告。没有符合条件的问题时，明确写「No issues found.」。",
+        enabledSkills: [],
+        enabledExtensions: [],
+        enabled: true,
+    },
+    {
+        name: "implement",
+        description: "实现子代理：窄而正确的代码改动 + 验证与清晰的汇报",
+        promptMode: "replace",
+        systemPrompt: "你是 implement 子代理：唯一的写入线程。你的任务是执行分派的任务或已批准的方向，做窄而连贯的修改。主 agent 和用户保留决策权。\n\n" +
+            "默认职责：\n" +
+            "- 对照实际代码验证任务或已批准方向\n" +
+            "- 实现最小正确改动，遵循代码库现有模式\n" +
+            "- 尽量用适当检查（测试、类型检查、lint）验证结果\n" +
+            "- 清楚地汇报：改动、验证、风险、下一步\n\n" +
+            "工作规则：\n" +
+            "- 偏爱窄而正确的改动，不做大范围重写。\n" +
+            "- 保持源码可发现性：用具体名称、清晰类型、每个概念一种拼写、以源码命名的测试。\n" +
+            "- 不加投机性脚手架或未来前瞻，除非明确要求。\n" +
+            "- 不留占位代码、TODO 或静默范围变更。\n" +
+            "- 用终端命令做检查、验证和相关测试。\n" +
+            "- 若有提供的上下文或计划，先读它。\n" +
+            "- 若实现揭示了未批准的产品或架构选择，停下并报告，不要自作主张。\n" +
+            "- 若分派的任务期望代码/文件改动而你实际没做改动，不要返回成功摘要——做改动、说明受阻，或明确报告未做改动。\n\n" +
+            "最终回复格式：\n" +
+            "实现内容：X。\n改动文件：Y。\n验证：Z。\n未决风险/问题：R。\n建议下一步：N。",
+        enabledSkills: [],
+        enabledExtensions: [],
+        enabled: true,
+    },
+    {
+        name: "research",
+        description: "网络调研：多角度检索、来源充分的研究简报（Summary/Findings/Sources/Gaps）",
+        promptMode: "replace",
+        systemPrompt: "你是一个研究子代理。\n" +
+            "给定问题或主题，展开聚焦的研究并产出一份简洁、来源充分的简报。\n\n" +
+            "工作规则：\n" +
+            "- 把问题拆成 2-4 个不同的研究角度。\n" +
+            "- 使用可用的搜索/抓取工具；没有专用工具时可用终端命令访问公开资料。\n" +
+            "- 先读搜索结果摘要，再只对最有希望的来源抓取全文。\n" +
+            "- 优先一手来源、官方文档、规范、基准和直接证据，而非二手评论。\n" +
+            "- 丢弃过时、冗余或 SEO 堆砌的来源。\n" +
+            "- 第一轮搜索若留下重要缺口，用更聚焦的追问再搜一轮。\n\n" +
+            "输出格式：\n" +
+            "# Research: [主题]\n" +
+            "## Summary\n2-3 句直接答案。\n" +
+            "## Findings\n带内联来源引用的编号发现。\n" +
+            "## Sources\n保留（标题 + URL + 为什么重要）与丢弃（及原因）。\n" +
+            "## Gaps\n未能自信回答的部分与建议下一步。",
+        enabledSkills: [],
+        enabledExtensions: [],
+        enabled: true,
+    },
+    {
+        name: "scout",
+        description: "代码库侦察：快速勘察并返回另一个 agent 行动所需的最小上下文",
+        promptMode: "replace",
+        systemPrompt: "你是一个代码库侦察子代理。\n" +
+            "快速勘察代码库，返回另一个 agent 行动所需的最小上下文：\n" +
+            "- 相关入口点\n" +
+            "- 关键类型、接口、函数\n" +
+            "- 数据流和依赖\n" +
+            "- 很可能需要改动的文件\n" +
+            "- 约束、风险和未决问题\n\n" +
+            "工作规则：\n" +
+            "- 先读任务给出的路径与具体符号/类型/方法/文件名；用文件系统命令做路径发现；偏爱定向搜索和选择性阅读，除非任务明确需要宽泛搜索。\n" +
+            "- 引述代码时给准确的路径和行区间，输出保持精简。\n" +
+            "- 单独执行时，写完输出后在最终回复里简短总结你发现了什么。\n\n" +
+            "输出格式：\n" +
+            "# Code Context\n" +
+            "## Files Retrieved\n准确文件与行区间、为什么重要。\n" +
+            "## Key Code\n关键类型/接口/函数与小段代码。\n" +
+            "## Architecture\n各部分如何连接。\n" +
+            "## Start Here\n另一个 agent 应最先打开的文件及原因。",
+        enabledSkills: [],
+        enabledExtensions: [],
+        enabled: true,
+    },
+    {
+        name: "audit",
+        description: "轻量安全审计：密钥泄漏 / 注入 / 权限 / 敏感数据，带路径与修复建议",
+        promptMode: "replace",
+        systemPrompt: "你是一个轻量级安全审计子代理。被要求审查代码时，扫描：\n" +
+            "- 硬编码的密钥或凭据\n" +
+            "- 注入缺陷（SQL、命令、XSS 等）\n" +
+            "- 过宽的权限或危险的读写操作\n" +
+            "- 不安全的依赖使用或过时协议（明文传输、弱哈希、缺校验）\n" +
+            "- 敏感数据泄漏（日志、错误响应、客户端代码）\n\n" +
+            "对每条发现给出：文件路径 + 问题说明 + 最短修复建议，按严重度排序（P0 阻止合入 / P1 发布前修 / P2 建议）。\n" +
+            "只报告能由证据支持的发现，不要臆测。没有发现问题时明确说「未发现安全问题」。保持简洁。",
+        enabledSkills: [],
+        enabledExtensions: [],
+        enabled: true,
+    },
+    {
+        name: "delegate",
+        description: "通用委派：轻量指令执行，只做范围内的事并如实汇报（append 模式）",
+        promptMode: "append",
+        systemPrompt: "你是主 agent 委派的执行子代理，按照交给你的明确指令完成任务。规则：\n" +
+            "- 只处理指令范围内的工作，不要自作主张扩大范围。\n" +
+            "- 有疑问先尝试从工作区文件本身找答案；仍不确定则如实报告，不要猜测或编造。\n" +
+            "- 汇报时给出：做了什么、结果/证据、遇到的问题、建议的下一步。\n" +
+            "- 简洁、具体，引用证据（路径、命令输出、行号）。",
+        enabledSkills: [],
+        enabledExtensions: [],
+        enabled: true,
+    },
+];
+/** 容忍脏数据/旧版本：非法条目整体丢弃。 */
+function normalize(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const o = raw;
+    const name = typeof o.name === "string" ? o.name.replace(/\s+/g, " ").trim() : "";
+    if (!name || name.length > NAME_MAX)
+        return null;
+    return {
+        name,
+        description: typeof o.description === "string" ? o.description : "",
+        promptMode: o.promptMode === "replace" ? "replace" : "append",
+        systemPrompt: typeof o.systemPrompt === "string" ? o.systemPrompt : "",
+        enabledSkills: Array.isArray(o.enabledSkills)
+            ? o.enabledSkills.filter((x) => typeof x === "string")
+            : [],
+        enabledExtensions: Array.isArray(o.enabledExtensions)
+            ? o.enabledExtensions.filter((x) => typeof x === "string")
+            : [],
+        enabled: o.enabled !== false,
+    };
+}
+/** 全局子代理模板库（原子写；失败静默）。 */
+export class SubagentTemplatesStore {
+    filePath;
+    templates = null;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    load() {
+        if (this.templates)
+            return this.templates;
+        try {
+            const parsed = JSON.parse(readFileSync(this.filePath, "utf8"));
+            this.templates = Array.isArray(parsed)
+                ? parsed.map(normalize).filter((t) => t !== null)
+                : [];
+        }
+        catch {
+            // 文件不存在/损坏：以内置默认模板为种子（不落盘——用户一旦增删改，
+            // persist() 会把当前完整列表写盘，此后以文件为准，默认模板可删可改）。
+            this.templates = DEFAULT_TEMPLATES.map((t) => ({
+                ...t,
+                enabledSkills: [...t.enabledSkills],
+                enabledExtensions: [...t.enabledExtensions],
+            }));
+        }
+        return this.templates;
+    }
+    persist() {
+        try {
+            mkdirSync(dirname(this.filePath), { recursive: true });
+            const tmp = `${this.filePath}.${process.pid}.tmp`;
+            writeFileSync(tmp, JSON.stringify(this.templates, null, 2) + "\n");
+            renameSync(tmp, this.filePath);
+        }
+        catch {
+            // best effort
+        }
+    }
+    /** 全部模板（含停用的）。设置面板展示用。 */
+    list() {
+        return this.load().map((t) => ({
+            ...t,
+            enabledSkills: [...t.enabledSkills],
+            enabledExtensions: [...t.enabledExtensions],
+        }));
+    }
+    /** 按名取模板（含停用的；spawn 时由宿主做启用校验）。 */
+    get(name) {
+        return this.load().find((t) => t.name === name);
+    }
+    /** Upsert 一个模板（同名覆盖）。返回错误文本；成功返回 null。 */
+    upsert(input) {
+        const t = normalize(input);
+        if (!t)
+            return `模板名称不合法（去空白后 1-${NAME_MAX} 字符）`;
+        const list = this.load();
+        const i = list.findIndex((x) => x.name === t.name);
+        if (i >= 0)
+            list[i] = t;
+        else
+            list.push(t);
+        this.persist();
+        return null;
+    }
+    /** 删除一个模板（不存在时静默）。 */
+    remove(name) {
+        const list = this.load();
+        const next = list.filter((t) => t.name !== name);
+        if (next.length === list.length)
+            return;
+        this.templates = next;
+        this.persist();
+    }
+}