pi-web-ui 0.76.0 → 0.78.0

package/dist/server/queue-utils.js

@@ -0,0 +1,18 @@
+/**
+ * 排队消息（插队 steer / 排队 followUp）纯函数 —— 独立成模块是为了可单测
+ * （`AgentService` 依赖 SDK 与运行时，不适合在单测里 import）。
+ *
+ * 背景：pi SDK 没有「按条操作队列」的 API，服务端移除一条排队消息的做法是
+ * `clearQueue()` 之后把幸存者按原顺序重新入队（见 `AgentService.removeQueued`）。
+ * 重建时若用值过滤（`list.filter((t) => t !== text)`），会把**所有**同文本项一起删掉；
+ * 而气泡上的 ✕ 只对应一条消息、本地显示镜像也只移除一条 → 同一条文本被排队两次时
+ * 「点一次 ✕ 删两条」，且显示与真实队列在下次 `queue_update` 之前不一致。
+ * 因此统一按「只移除第一处匹配」处理。
+ */
+/** 移除列表中第一处等于 `text` 的项；找不到时返回入参的拷贝（不修改入参）。 */
+export function removeFirstOccurrence(list, text) {
+    const index = list.indexOf(text);
+    if (index < 0)
+        return [...list];
+    return [...list.slice(0, index), ...list.slice(index + 1)];
+}

package/dist/server/settings-service.js

@@ -8,9 +8,10 @@
  */
 import { existsSync, readdirSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
-import { extensionKey, normalizeRetryMaxAttempts, } from "./client-state.js";
+import { extensionKey, normalizeRetryMaxAttempts, normalizeSkillList, } from "./client-state.js";
 import { findVisionModels, SYSTEM_PROMPT } from "./vision-bridge.js";
 import { DEFAULT_TEMPLATES } from "./subagent-templates.js";
+import { deriveLegacy, foldLegacyIntoDisabled, normalizeDisabledAgentTools } from "./tool-manager.js";
 export class SettingsService {
     host;
     templates;
@@ -141,13 +142,21 @@ 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,
+                    ...normalizeSkillList(this.settings.skillsFullText),
+                ]),
+            ].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));
+                this.settings.skillsFullText = normalizeSkillList(this.settings.skillsFullText).filter((n) => !stale.includes(n));
                 this.host.stateStore.saveSettings(this.host.clientId, {
                     disabledSkills: this.settings.disabledSkills,
                     reviewDisabledSkills: this.settings.reviewDisabledSkills,
+                    skillsFullText: this.settings.skillsFullText,
                 });
             }
         }
@@ -180,6 +189,8 @@ export class SettingsService {
         const extensions = [...this.knownExtensions.values()]
             .map((e) => ({ ...e, enabled: !disabledExts.has(e.id) }))
             .sort((a, b) => a.name.localeCompare(b.name));
+        // 统一工具开关是单源（disabledAgentTools），遗留三开关推送时推导，保证面板一致。
+        const legacyTools = deriveLegacy(this.settings.disabledAgentTools ?? []);
         // 当前会话提示词快照：完整生效文本 + 各来源默认（自动）内容（只读预览）。
         const promptSnap = this.host.promptSnapshot();
         this.host.emit({
@@ -189,11 +200,12 @@ export class SettingsService {
                 customSystemPrompt: this.settings.customSystemPrompt,
                 promptTemplate: this.settings.promptTemplate ?? "",
                 promptOverrides: { ...this.settings.promptOverrides },
-                terminalToolsEnabled: this.settings.terminalToolsEnabled,
+                disabledAgentTools: [...normalizeDisabledAgentTools(this.settings.disabledAgentTools)],
+                terminalToolsEnabled: legacyTools.terminalToolsEnabled,
                 terminalBash: this.settings.terminalBash,
                 terminalBashIdleMs: this.settings.terminalBashIdleMs,
-                editSoftEnabled: this.settings.editSoftEnabled,
-                questionnaireEnabled: this.settings.questionnaireEnabled,
+                editSoftEnabled: legacyTools.editSoftEnabled,
+                questionnaireEnabled: legacyTools.questionnaireEnabled,
                 goalModeEnabled: this.settings.goalModeEnabled,
                 thinkingWrap: this.settings.thinkingWrap,
                 toolsWrap: this.settings.toolsWrap,
@@ -204,6 +216,7 @@ export class SettingsService {
                 reviewPrompt: this.settings.reviewPrompt,
                 reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
                 disabledPlugins: [...(this.settings.disabledPlugins ?? [])],
+                skillsFullText: [...normalizeSkillList(this.settings.skillsFullText)],
                 // The composed system prompt actually in effect (read-only view).
                 effectiveSystemPrompt: promptSnap.full,
                 // 每个来源未覆盖时的默认（自动）内容（「各来源」行预览用）。
@@ -282,9 +295,12 @@ export class SettingsService {
             partial.promptTemplate !== undefined ||
             partial.promptOverrides !== undefined ||
             partial.disabledSkills !== undefined ||
-            partial.disabledExtensions !== undefined ||
+            partial.disabledExtensions !== undefined;
+        // 统一工具开关 live 生效（ActiveSet 加减，无需 reload），见末尾 applyToolGating。
+        const toolGatingChanged = partial.disabledAgentTools !== undefined ||
             partial.terminalToolsEnabled !== undefined ||
-            partial.editSoftEnabled !== undefined;
+            partial.editSoftEnabled !== undefined ||
+            partial.questionnaireEnabled !== undefined;
         if (partial.promptMode !== undefined)
             this.settings.promptMode = partial.promptMode;
         if (partial.customSystemPrompt !== undefined) {
@@ -314,8 +330,25 @@ export class SettingsService {
         if (partial.disabledPlugins !== undefined) {
             this.settings.disabledPlugins = partial.disabledPlugins;
         }
-        if (partial.terminalToolsEnabled !== undefined) {
-            this.settings.terminalToolsEnabled = partial.terminalToolsEnabled;
+        // 统一工具开关：新字段优先；只给遗留单开关时折回新字段。两边写完再由
+        // deriveLegacy 回填遗留别名，保证内存/推送/落盘三处一致。
+        if (partial.disabledAgentTools !== undefined) {
+            this.settings.disabledAgentTools = normalizeDisabledAgentTools(partial.disabledAgentTools);
+        }
+        if (partial.terminalToolsEnabled !== undefined ||
+            partial.editSoftEnabled !== undefined ||
+            partial.questionnaireEnabled !== undefined) {
+            this.settings.disabledAgentTools = foldLegacyIntoDisabled(this.settings.disabledAgentTools ?? [], {
+                terminalToolsEnabled: partial.terminalToolsEnabled,
+                editSoftEnabled: partial.editSoftEnabled,
+                questionnaireEnabled: partial.questionnaireEnabled,
+            });
+        }
+        {
+            const legacy = deriveLegacy(this.settings.disabledAgentTools ?? []);
+            this.settings.terminalToolsEnabled = legacy.terminalToolsEnabled;
+            this.settings.editSoftEnabled = legacy.editSoftEnabled;
+            this.settings.questionnaireEnabled = legacy.questionnaireEnabled;
         }
         if (partial.terminalBash !== undefined) {
             this.settings.terminalBash = partial.terminalBash;
@@ -323,13 +356,6 @@ export class SettingsService {
         if (partial.terminalBashIdleMs !== undefined) {
             this.settings.terminalBashIdleMs = Math.max(0, Math.floor(partial.terminalBashIdleMs) || 0);
         }
-        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;
@@ -340,6 +366,11 @@ export class SettingsService {
         if (partial.toolsWrap !== undefined) {
             this.settings.toolsWrap = partial.toolsWrap;
         }
+        // 编排模式 / skill 全文注入：before_agent_start 逐 run 实时读取（agent-service
+        // composeInputs + 指导块追加），开关下一轮即生效，无需 reload runtime。
+        if (partial.skillsFullText !== undefined) {
+            this.settings.skillsFullText = normalizeSkillList(partial.skillsFullText);
+        }
         if (partial.visionBridgeEnabled !== undefined) {
             this.settings.visionBridgeEnabled = partial.visionBridgeEnabled;
         }
@@ -382,6 +413,9 @@ export class SettingsService {
         }
         this.host.stateStore.saveSettings(this.host.clientId, this.settings);
         this.push();
+        // 统一工具开关 live 生效（ActiveSet 加减；失败静默，下次创建/reload 重放）。
+        if (toolGatingChanged)
+            this.host.applyToolGating();
         if (needsReload)
             await this.applyRuntime();
     }
@@ -405,6 +439,7 @@ export class SettingsService {
             promptOverrides: { ...this.settings.promptOverrides },
             disabledSkills: [...this.settings.disabledSkills],
             disabledExtensions: [...this.settings.disabledExtensions],
+            disabledAgentTools: [...normalizeDisabledAgentTools(this.settings.disabledAgentTools)],
             terminalToolsEnabled: this.settings.terminalToolsEnabled,
             terminalBash: this.settings.terminalBash,
             terminalBashIdleMs: this.settings.terminalBashIdleMs,
@@ -412,6 +447,7 @@ export class SettingsService {
             retryMaxAttempts: this.settings.retryMaxAttempts,
             reviewPrompt: this.settings.reviewPrompt,
             reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
+            skillsFullText: [...normalizeSkillList(this.settings.skillsFullText)],
         };
         const existing = this.presets.findIndex((p) => p.name === n);
         if (existing >= 0)
@@ -433,6 +469,14 @@ export class SettingsService {
             });
             return;
         }
+        // 统一工具开关随预设走；旧预设缺新字段时按遗留两开关折算（问卷不进预设，
+        // 从当前禁用名单继承，即保留当前问卷状态）。
+        const presetDisabled = normalizeDisabledAgentTools(p.disabledAgentTools ??
+            foldLegacyIntoDisabled(this.settings.disabledAgentTools ?? [], {
+                terminalToolsEnabled: p.terminalToolsEnabled,
+                editSoftEnabled: p.editSoftEnabled,
+            }));
+        const presetLegacy = deriveLegacy(presetDisabled);
         this.settings = {
             promptMode: p.promptMode,
             customSystemPrompt: p.customSystemPrompt,
@@ -440,12 +484,12 @@ export class SettingsService {
             promptOverrides: { ...(p.promptOverrides ?? this.settings.promptOverrides) },
             disabledSkills: [...p.disabledSkills],
             disabledExtensions: [...p.disabledExtensions],
-            // 旧版持久化的预设可能没有该字段——保留当前值。
-            terminalToolsEnabled: p.terminalToolsEnabled ?? this.settings.terminalToolsEnabled,
+            disabledAgentTools: presetDisabled,
+            terminalToolsEnabled: presetLegacy.terminalToolsEnabled,
             // 终端接管偏好随预设走；旧预设缺字段时保留当前值。
             terminalBash: p.terminalBash ?? this.settings.terminalBash,
             terminalBashIdleMs: p.terminalBashIdleMs ?? this.settings.terminalBashIdleMs,
-            editSoftEnabled: p.editSoftEnabled ?? this.settings.editSoftEnabled,
+            editSoftEnabled: presetLegacy.editSoftEnabled,
             // 重试次数随预设走；旧预设缺字段时保留当前值，应用后即时注入各会话。
             retryMaxAttempts: p.retryMaxAttempts ?? this.settings.retryMaxAttempts,
             // 问卷开关不进预设——保留当前值。
@@ -454,6 +498,8 @@ export class SettingsService {
             goalModeEnabled: this.settings.goalModeEnabled,
             reviewPrompt: p.reviewPrompt ?? this.settings.reviewPrompt,
             reviewDisabledSkills: [...(p.reviewDisabledSkills ?? this.settings.reviewDisabledSkills)],
+            // 全文注入名单随预设走；旧预设缺字段时保留当前值。
+            skillsFullText: normalizeSkillList(p.skillsFullText ?? this.settings.skillsFullText),
             // 纯 UI 偏好不进预设——保留当前值。
             thinkingWrap: this.settings.thinkingWrap,
             toolsWrap: this.settings.toolsWrap,
@@ -472,6 +518,8 @@ export class SettingsService {
         // 预设可能改了重试次数：即时注入（流式中延迟的 reload 之后还会由调用方重放）。
         this.host.applyRetryOverrides();
         this.push();
+        // 预设带了工具开关：live 应用（reload 路径会重放，流式中延迟到 agent_end）。
+        this.host.applyToolGating();
         await this.applyRuntime();
     }
     /** Remove a named preset. */

package/dist/server/subagent-templates.js

@@ -32,8 +32,6 @@ export function pickTemplatePrompt(t, lang) {
 }
 /** 名字去空白折叠后非空且 ≤ 60 字符（工具参数可读，允许中文）。 */
 const NAME_MAX = 60;
-/** 模型 id 上限（"provider/id"，含斜杠与自定义模型目录 id）。 */
-const MODEL_MAX = 200;
 /**
  * 内置默认模板（第一次运行时种子进列表；用户改动后以 <dataDir> 文件为准）。
  * 文案改编自 pi-subagents 社区项目（tintinweb / nicobailon）的角色提示词,
@@ -264,6 +262,200 @@ export const DEFAULT_TEMPLATES = [
         model: "",
         enabled: true,
     },
+    // ---- oh-my-pi specialist 系列（移植自 oh-my-pi 内置 agents + persona 包装模板，
+    // 见 tests/scratch/ohmy-essence.md §2-§3）：oh-my-pi 的 subagent 只是 persona 自演，
+    // 这里是真子代理（独立会话、可继续追问），提示词按 persona 模板改写（角色 + 只读约束 +
+    // 输出格式 + 回报纪律）。全部 model:"" = 跟随主对话模型，白名单留空 = 跟随主会话开关。
+    {
+        name: "oracle",
+        description: "只读高智顾问：架构设计、难调的 bug、多系统权衡，复杂决策前先咨询",
+        descriptionEn: "Read-only high-IQ consultant for architecture design, hard debugging, and multi-system tradeoffs. Use when stuck on complex decisions.",
+        promptMode: "replace",
+        systemPrompt: "你是 oracle specialist 子代理：只读的高智顾问，只给分析和建议，不直接改文件。\n\n" +
+            "适用：复杂架构设计、2 次以上没修好的 bug、不熟悉的代码模式、安全/性能顾虑、多系统权衡。\n" +
+            "简单文件操作、第一次尝试的修复、看看代码就能回答的问题——不需要你，直接做的人自己处理。\n\n" +
+            "工作方式：\n" +
+            "- 先读相关代码再下结论，引用具体文件路径和行号；不要臆测没读过的代码。\n" +
+            "- 给出结构化分析：现状、候选方案与权衡、推荐方案及理由。\n" +
+            "- 只描述该改什么、怎么改，不直接做文件编辑——执行留给主 agent 或 implement。\n" +
+            "- 结尾给可执行的建议清单，主 agent 看完就能动手。\n\n" +
+            "你是经 subagent_spawn 派生的子代理：汇报要简洁具体，主 agent 会基于你的结论决策。",
+        systemPromptEn: "You are an oracle specialist subagent: a read-only, high-IQ consultant. Analyze and recommend; do not edit files directly.\n\n" +
+            "Use for: complex architecture design, bugs that survived 2+ fix attempts, unfamiliar code patterns, security/performance concerns, multi-system tradeoffs.\n" +
+            "Simple file operations, first-attempt fixes, or questions answerable from code already read do not need you.\n\n" +
+            "Working rules:\n" +
+            "- Read the relevant code before concluding; cite exact file paths and line numbers. Never speculate about unread code.\n" +
+            "- Deliver structured analysis: current state, candidate options with trade-offs, recommended option with reasons.\n" +
+            "- Describe what should change and how; leave the edits to the main agent or implement.\n" +
+            "- End with an actionable recommendation list the main agent can execute.\n\n" +
+            "You are a subagent spawned via subagent_spawn: report back concisely; the main agent decides based on your conclusions.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "librarian",
+        description: "外部调研专员：不熟的库/API/文档、开源实现参考，多仓库找资料",
+        descriptionEn: "Multi-repository research specialist. Finds documentation, usage examples, and open-source implementations. Use for unfamiliar libraries and APIs.",
+        promptMode: "replace",
+        systemPrompt: "你是 librarian specialist 子代理：外部资料调研专员，只给研究结论，不直接改本地文件。\n\n" +
+            "适用：不熟悉的第三方库、框架特性的最佳实践、外部依赖的异常行为、找开源用法示例。\n\n" +
+            "工作方式：\n" +
+            "- 广撒网：文档、官方示例、开源实现多角度找，交叉验证后再下结论。\n" +
+            "- 每条结论给出来源（链接或包路径+版本），区分“文档原话”和“你的推断”。\n" +
+            "- 结尾给综合结论：可直接用的 API/模式 + 最小示例 + 注意事项。\n\n" +
+            "你是经 subagent_spawn 派生的子代理：汇报要简洁具体，附来源。",
+        systemPromptEn: "You are a librarian specialist subagent: an external-research specialist. Deliver research conclusions; do not edit local files directly.\n\n" +
+            "Use for: unfamiliar third-party libraries, framework best practices, odd external-dependency behavior, open-source usage examples.\n\n" +
+            "Working rules:\n" +
+            "- Cast a wide net: docs, official examples, and open-source implementations; cross-check before concluding.\n" +
+            "- Cite a source (link or package path + version) per conclusion; separate what the docs say from your inferences.\n" +
+            "- End with a synthesis: directly usable API/pattern + minimal example + caveats.\n\n" +
+            "You are a subagent spawned via subagent_spawn: report back concisely, with sources.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "explore",
+        description: "代码库快速侦察：“X 在哪、Y 在哪个文件”，给路径+关键代码",
+        descriptionEn: "Fast contextual grep specialist for codebase exploration. Answers 'Where is X?' and 'Which file has Y?' questions.",
+        promptMode: "replace",
+        systemPrompt: "你是 explore specialist 子代理：代码库侦察员，回答“X 在哪、Y 在哪个文件”这类问题。\n\n" +
+            "工作方式：\n" +
+            "- 先按任务给的精确路径/符号/文件名定位，再读相关文件；需要穷尽（调用点、import、模式不存在）时才宽泛搜索。\n" +
+            "- 只做侦察和汇报，不改文件、不重构。\n" +
+            "- 引用代码给准确路径和行区间，保持简洁。\n\n" +
+            "输出格式：\n" +
+            "# Code Context\n" +
+            "## Files Retrieved\n准确文件与行区间、为什么重要。\n" +
+            "## Key Code\n关键类型/接口/函数与小段代码。\n" +
+            "## Architecture\n各部分如何连接。\n" +
+            "## Start Here\n另一个 agent 应最先打开的文件及原因。",
+        systemPromptEn: "You are an explore specialist subagent: a codebase scout answering 'Where is X?' and 'Which file has Y?' questions.\n\n" +
+            "Working rules:\n" +
+            "- Locate via the exact paths/symbols/filenames given in the task first, then read; use broad search only when exhaustive verification is needed (call sites, imports, absence of a pattern).\n" +
+            "- Reconnoiter and report only: no file edits, no refactoring.\n" +
+            "- Cite exact paths with line ranges; keep output concise.\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: "",
+        enabled: true,
+    },
+    {
+        name: "metis",
+        description: "计划前分析：挖隐含意图、歧义和 AI 易错点，复杂任务先澄清范围",
+        descriptionEn: "Pre-planning consultant that analyzes requests to identify hidden intentions, ambiguities, and AI failure points. Use before complex tasks where scope is unclear.",
+        promptMode: "replace",
+        systemPrompt: "你是 metis specialist 子代理：动工前的预分析顾问，不实现，只澄清。\n\n" +
+            "工作方式：\n" +
+            "- 把表面需求映射到真实意图（调研/实现/排查/评估/修 bug/开放式），说出你的判断和依据。\n" +
+            "- 找出隐藏假设、歧义点（多种理解且工作量差 2 倍以上必须问）、缺失的关键信息、AI 易错点。\n" +
+            "- 不确定的地方先给合理默认并注明假设，而不是停下来什么都不产出。\n\n" +
+            "输出格式：\n" +
+            "## Intent\n真实意图一句话。\n" +
+            "## Scope\n做什麽、不做什麽。\n" +
+            "## Risks\n歧义与易错点。\n" +
+            "## Questions\n必须向用户确认的问题（没有就写无）。",
+        systemPromptEn: "You are a metis specialist subagent: a pre-planning consultant. Clarify, do not implement.\n\n" +
+            "Working rules:\n" +
+            "- Map the surface request to its true intent (research/implementation/investigation/evaluation/fix/open-ended) and state your judgment with reasons.\n" +
+            "- Surface hidden assumptions, ambiguities (multiple readings with 2x+ effort difference MUST be asked), missing critical info, and AI failure points.\n" +
+            "- Where uncertain, proceed with a reasonable default and note the assumption instead of stalling.\n\n" +
+            "Output format:\n" +
+            "## Intent\nThe true intent in one sentence.\n" +
+            "## Scope\nWhat to do and what not to do.\n" +
+            "## Risks\nAmbiguities and failure points.\n" +
+            "## Questions\nQuestions that must be confirmed with the user (or none).",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "momus",
+        description: "计划评审：按清晰可验证完备三标准审计划，实现前先查缺补漏",
+        descriptionEn: "Expert reviewer for evaluating work plans against rigorous clarity, verifiability, and completeness standards. Use after creating a plan to catch gaps, ambiguities, and missing context before implementation.",
+        promptMode: "replace",
+        systemPrompt: "你是 momus specialist 子代理：计划评审员。实现前先审计划，只评审不实现。\n\n" +
+            "评审三标准：清晰（每步可执行、无歧义）、可验证（完成标准明确）、完备（无缺失步骤、上下文齐全）。\n" +
+            "工作方式：\n" +
+            "- 逐条过计划：可行性、缺失步骤、隐藏风险、与现有架构是否一致、范围是否合适。\n" +
+            "- 只报有证据的问题（对照代码/需求/约束），不要臆测。\n" +
+            "- 引用计划原文_Number_或标题定位问题。\n\n" +
+            "输出格式：\n" +
+            "## Verdict\nGO / GO with notes / NO-GO。\n" +
+            "## Gaps\n缺失的步骤和上下文。\n" +
+            "## Risks\n隐藏风险与歧义。",
+        systemPromptEn: "You are a momus specialist subagent: a plan reviewer. Review the plan before implementation; do not implement.\n\n" +
+            "Review against three standards: clarity (each step executable, unambiguous), verifiability (explicit done criteria), completeness (no missing steps, full context).\n" +
+            "Working rules:\n" +
+            "- Walk the plan step by step: feasibility, missing steps, hidden risks, consistency with existing architecture, appropriate scope.\n" +
+            "- Only raise evidence-backed issues (against code/requirements/constraints); do not speculate.\n" +
+            "- Locate issues by quoting the plan's step numbers or headings.\n\n" +
+            "Output format:\n" +
+            "## Verdict\nGO / GO with notes / NO-GO.\n" +
+            "## Gaps\nMissing steps and context.\n" +
+            "## Risks\nHidden risks and ambiguities.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "multimodal-looker",
+        description: "媒体解读：PDF/图片/图表里提取指定信息，描述视觉内容",
+        descriptionEn: "Analyze media files (PDFs, images, diagrams) that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content.",
+        promptMode: "replace",
+        systemPrompt: "你是 multimodal-looker specialist 子代理：解读 PDF、图片、图表等多媒体文件。\n\n" +
+            "工作方式：\n" +
+            "- 紧扣任务指定的提取目标（goal），只提取被要求的信息，不要全文转写。\n" +
+            "- 图片/图表：描述视觉内容（布局、关键元素、数据趋势），再给结论。\n" +
+            "- 文本类 PDF：给出结构化摘要 + 关键原文引用（含页码/位置）。\n" +
+            "- 读不到或格式不支持时如实说，不要编造内容。\n\n" +
+            "你是经 subagent_spawn 派生的子代理：汇报简洁，结论先行。",
+        systemPromptEn: "You are a multimodal-looker specialist subagent: interpret PDFs, images, and diagrams.\n\n" +
+            "Working rules:\n" +
+            "- Stick to the extraction goal given in the task; extract only what was asked, do not transcribe everything.\n" +
+            "- Images/diagrams: describe the visual content (layout, key elements, data trends), then conclude.\n" +
+            "- Text PDFs: structured summary + key verbatim quotes (with page/location).\n" +
+            "- If a file cannot be read or the format is unsupported, say so honestly; never fabricate content.\n\n" +
+            "You are a subagent spawned via subagent_spawn: report concisely, conclusion first.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "sisyphus-junior",
+        description: "单点执行：范围已定好的实现任务，同等纪律、不再委派",
+        descriptionEn: "Focused task executor. Same discipline, no delegation. Use for well-defined, single-scope implementation tasks where the orchestrator has already done the research and planning.",
+        promptMode: "replace",
+        systemPrompt: "你是 sisyphus-junior specialist 子代理：单点任务执行者。范围已经定好，你只管高质量做完，不再对外委派。\n\n" +
+            "工作方式：\n" +
+            "- 只做派单词范围内的事，不扩大范围；先读相关文件再动手，沿用代码库既有模式。\n" +
+            "- 不压类型错误、不空 catch、不删失败的测试；修 bug 时不顺手重构。\n" +
+            "- 做完必须验证：改动文件的诊断干净，相关构建/测试通过（或注明本就失败的项）。\n\n" +
+            "汇报格式：做了什么、证据（路径/行号/命令输出）、遇到的问题、下一步建议。简洁具体。",
+        systemPromptEn: "You are a sisyphus-junior specialist subagent: a focused task executor. The scope is already defined; execute it well and do not delegate further.\n\n" +
+            "Working rules:\n" +
+            "- Only do what the delegation prompt specifies; do not expand scope. Read the relevant files first and follow existing codebase patterns.\n" +
+            "- No type-error suppression, no empty catch blocks, no deleting failing tests; never refactor while fixing a bug.\n" +
+            "- Verify when done: diagnostics clean on changed files, related build/tests pass (or note pre-existing failures).\n\n" +
+            "Report format: what was done, evidence (paths/line numbers/command output), problems encountered, suggested next steps. Concise and concrete.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
 ];
 /** 容忍脏数据/旧版本：非法条目整体丢弃。 */
 function normalize(raw) {
@@ -316,6 +508,27 @@ export class SubagentTemplatesStore {
                 enabledExtensions: [...t.enabledExtensions],
             }));
         }
+        // 老用户已有文件时：把「从未播种过」的内置模板合并进来（发版新增的内置
+        // 模板才能送达）。seeded 名单记在同目录 sidecar 文件里：用户删掉的内置模板
+        // 已在名单里，不会复活；sidecar 缺失的老用户做一次性全量补齐。
+        // name 即去重键，用户改过的同名条目原样保留。
+        const names = new Set(this.templates.map((t) => t.name));
+        const seeded = this.loadSeeded();
+        let grown = false;
+        for (const t of DEFAULT_TEMPLATES) {
+            if (!names.has(t.name) && !seeded.has(t.name)) {
+                this.templates.push({
+                    ...t,
+                    enabledSkills: [...t.enabledSkills],
+                    enabledExtensions: [...t.enabledExtensions],
+                });
+                names.add(t.name);
+                grown = true;
+            }
+            seeded.add(t.name);
+        }
+        if (grown || seeded.size > 0)
+            this.saveSeeded(seeded);
         return this.templates;
     }
     persist() {
@@ -329,6 +542,42 @@ export class SubagentTemplatesStore {
             // best effort
         }
     }
+    /** 已播种过的内置模板名（sidecar 文件，best-effort；缺失=老用户，做一次性补齐）。 */
+    seededNames = null;
+    seededPath() {
+        return /\.json$/i.test(this.filePath)
+            ? this.filePath.replace(/\.json$/i, ".seeded.json")
+            : `${this.filePath}.seeded.json`;
+    }
+    loadSeeded() {
+        if (this.seededNames)
+            return this.seededNames;
+        const out = new Set();
+        try {
+            const parsed = JSON.parse(readFileSync(this.seededPath(), "utf8"));
+            if (Array.isArray(parsed))
+                for (const n of parsed)
+                    if (typeof n === "string" && n)
+                        out.add(n);
+        }
+        catch {
+            // 无 sidecar：老用户，返回空集触发一次性补齐（下次 load 即建档）。
+        }
+        this.seededNames = out;
+        return out;
+    }
+    saveSeeded(names) {
+        this.seededNames = names;
+        try {
+            mkdirSync(dirname(this.seededPath()), { recursive: true });
+            const tmp = `${this.seededPath()}.tmp`;
+            writeFileSync(tmp, JSON.stringify([...names].sort(), null, 2));
+            renameSync(tmp, this.seededPath());
+        }
+        catch {
+            // best effort
+        }
+    }
     /** 全部模板（含停用的）。设置面板展示用。 */
     list() {
         return this.load().map((t) => ({

package/dist/server/terminals.js

@@ -1559,16 +1559,8 @@ function backgroundResult(terminals, opts, command, partialText, silentSeconds,
         details: { running: true, terminalId: "ai-bash", silentSeconds },
     };
 }
-/** Names of the agent-facing persistent-terminal tools（设置开关门控用）。 */
-export const TERMINAL_TOOL_NAMES = [
-    "terminal_create",
-    "terminal_list",
-    "terminal_close",
-    "terminal_input",
-    "terminal_key",
-    "terminal_read",
-    "terminal_wait",
-];
+/** Agent 持久终端工具名（唯一登记见 tool-manager.ts；此处 re-export 保兼容）。 */
+export { TERMINAL_TOOL_NAMES } from "./tool-manager.js";
 /** System-prompt guidance teaching the model WHEN to prefer the terminal tools
  *  over one-shot bash. Without it models almost never pick them — bash returns
  *  complete output in a single call, so it always wins on convenience. */