pi-web-ui 0.80.2 → 0.83.0

package/dist/server/mcp-bridge.js

@@ -22,6 +22,8 @@ let rpcSeq = 0;
 /**
  * 单个 MCP 服务器的客户端：管理子进程、请求/响应按 id 关联、握手与工具调用。
  * 线程模型：无需并发控制（MCP 允许乱序 + 我们按请求 id 匹配响应）。
+ * 自愈：子进程意外退出（崩溃/被杀）后不永久失效 —— 下一次工具调用会惰性重启并
+ * 重新握手、重新拉取工具列表；显式 close() 之后才永久停用。
  */
 export class McpClient {
     spec;
@@ -34,17 +36,22 @@ export class McpClient {
     /** 已握手的工具列表（tools/list 结果缓存）。 */
     tools = [];
     shuttingDown = false;
+    /** 进行中的启动/重启（并发调用共享同一次重连）。 */
+    starting = null;
+    /** 已启动次数（含自愈重启；诊断/测试用）。 */
+    startedCount = 0;
     constructor(name, spec, log) {
         this.spec = spec;
         this.name = name;
         this.log = log ?? (() => { });
     }
-    /** 启动子进程 + 握手 + 拉取工具列表。 */
-    async start(_timeoutMs = 8000) {
+    /** 启动子进程 + 握手 + 拉取工具列表。可安全重入：子进程退出后再次调用即全新启动。 */
+    async start(timeoutMs = 8000) {
         if (this.child)
             return;
         const { command, args = [], cwd, env } = this.spec;
         this.log(`[mcp:${this.name}] starting: ${command} ${args.join(" ")}`);
+        this.buffer = "";
         const child = spawn(command, args, {
             cwd: cwd ?? undefined,
             env: { ...process.env, ...env },
@@ -52,36 +59,103 @@ export class McpClient {
             windowsHide: true,
         });
         this.child = child;
+        // 进程退出后向 stdin 写请求会触发 EPIPE —— 静默忽略（send 也会判 child 存活）。
+        child.stdin?.on("error", () => { });
         child.stderr.on("data", (d) => this.log(`[mcp:${this.name}] stderr:`, d.toString().trimEnd()));
         child.on("error", (err) => this.rejectAll(new Error(`[mcp:${this.name}] spawn error: ${err.message}`)));
         child.on("exit", (code, sig) => {
             this.child = null;
-            if (!this.shuttingDown)
+            this.buffer = "";
+            if (!this.shuttingDown) {
+                this.log(`[mcp:${this.name}] 进程退出 (${sig ?? code})，下次调用将自动重启`);
                 this.rejectAll(new Error(`[mcp:${this.name}] 进程退出 (${sig ?? code})`));
+            }
         });
         child.stdout.setEncoding("utf8");
         child.stdout.on("data", (chunk) => this.onData(chunk));
-        // 握手
-        const handshake = await this.request("initialize", {
-            protocolVersion: this.spec.protocolVersion ?? PROTOCOL_VERSION,
-            capabilities: {},
-            clientInfo: { name: "pi-web-ui", version: "0.41.0" },
+        this.startedCount++;
+        try {
+            // 握手
+            const handshake = await this.request("initialize", {
+                protocolVersion: this.spec.protocolVersion ?? PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: "pi-web-ui", version: "0.41.0" },
+            }, timeoutMs);
+            const version = handshake?.protocolVersion ?? this.spec.protocolVersion ?? PROTOCOL_VERSION;
+            // 通知 initialized（无 id 的 notification）
+            this.send({ jsonrpc: "2.0", method: "notifications/initialized" });
+            // 仍以协商协议版本调用 tools（多数服务器对新版本容忍，这里用协商结果）
+            void version;
+            const listed = ((await this.request("tools/list", {}, timeoutMs)) ?? {});
+            this.tools = Array.isArray(listed.tools) ? listed.tools : [];
+            this.log(`[mcp:${this.name}] ready, ${this.tools.length} tools`);
+            // 若重启过程中被显式 close()，趁机回收刚启动的子进程，不留孤儿。
+            if (this.shuttingDown) {
+                try {
+                    child.kill();
+                }
+                catch {
+                    /* 已退出 */
+                }
+                if (this.child === child)
+                    this.child = null;
+            }
+        }
+        catch (err) {
+            // 启动/握手失败：回收本次子进程，避免泄漏；调用方可安全重试（自愈会再试）。
+            try {
+                child.kill();
+            }
+            catch {
+                /* 已退出 */
+            }
+            if (this.child === child)
+                this.child = null;
+            throw err;
+        }
+    }
+    /** 已启动次数（含自愈重启；诊断/测试用）。 */
+    get startCount() {
+        return this.startedCount;
+    }
+    /**
+     * 保活：子进程还活着就直接返回；已意外退出则惰性重启（并发调用共享同一次重连）。
+     * 显式 close() 后抛错，绝不复活。
+     */
+    async ensureStarted(timeoutMs) {
+        if (this.shuttingDown)
+            throw new Error(`[mcp:${this.name}] 客户端已关闭，不会重启`);
+        // 先认「进行中的重连」再认 child：start() 是同步把 child 落位的，握手却还没完 ——
+        // 此时若按 child 判存活就直接返回，并发的第二个调用会抢在 initialize 应答前发出
+        // tools/call（严格实现会回「未初始化」）。共享同一个 promise 才能真正串行化。
+        if (this.starting)
+            return this.starting;
+        if (this.child)
+            return;
+        this.starting = this.start(timeoutMs).finally(() => {
+            this.starting = null;
         });
-        const version = handshake?.protocolVersion ?? this.spec.protocolVersion ?? PROTOCOL_VERSION;
-        // 通知 initialized（无 id 的 notification）
-        this.send({ jsonrpc: "2.0", method: "notifications/initialized" });
-        // 仍以协商协议版本调用 tools（多数服务器对新版本容忍，这里用协商结果）
-        void version;
-        const listed = ((await this.request("tools/list", {})) ?? {});
-        this.tools = Array.isArray(listed.tools) ? listed.tools : [];
-        this.log(`[mcp:${this.name}] ready, ${this.tools.length} tools`);
+        await this.starting;
     }
     /** 已发现工具。 */
     getTools() {
         return this.tools.map((t) => ({ ...t }));
     }
-    /** 调用一个工具，返回结果文本（多 content 拼接为 JSON 字符串保真）。 */
+    /**
+     * 调用一个工具，返回其结果。
+     * 纯文本块拼接成字符串（老形状，向后兼容）；出现非文本块（image/resource/audio 等）时按序透传或退化提示，不再静默丢弃。
+     */
     async call(name, args, timeoutMs = 60000) {
+        if (this.shuttingDown)
+            throw new Error(`[mcp:${this.name}] 客户端已关闭，不会重启`);
+        try {
+            // 自愈：子进程已退出（非主动关闭）→ 先惰性重启再发；重启失败给出明确错误而不是挂 60s 超时。
+            await this.ensureStarted(8000);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            throw new Error(`[mcp:${this.name}] 服务器进程已退出且自动重启失败：${detail}`);
+        }
         const res = (await this.request("tools/call", { name, arguments: args }, timeoutMs));
         if (res?.isError) {
             const msg = (res.content ?? [])
@@ -90,14 +164,49 @@ export class McpClient {
                 .trim() || "MCP 工具错误";
             throw new Error(msg);
         }
-        // 结构化结果优先，其次文本内容。
+        // 结构化结果优先，其次内容块。
         if (res?.structuredContent !== undefined)
             return res.structuredContent;
-        const text = (res.content ?? [])
-            .map((c) => c.text ?? "")
-            .filter((x) => x)
-            .join("\n");
-        return { content: text, isError: !!res.isError };
+        const blocks = [];
+        let hasNonText = false;
+        for (const c of res.content ?? []) {
+            if (c.type === "image" && typeof c.data === "string" && c.data) {
+                // MCP image 块字段（type/data/mimeType）与 SDK 的 ImageContent 完全一致，原样透传；
+                // 超大图由 SDK 的 normalizeToolResultImages 统一缩放（afterToolCall 钩子，默认 autoResize）。
+                blocks.push({ type: "image", data: c.data, mimeType: c.mimeType?.trim() || "image/png" });
+                hasNonText = true;
+                continue;
+            }
+            if (c.type && c.type !== "text") {
+                const r = typeof c.resource === "object" && c.resource !== null ? c.resource : {};
+                // MCP 的 EmbeddedResource 有两种承载：TextResourceContents（resource.text）与
+                // BlobResourceContents（resource.blob）。文本型带真实正文（filesystem 类 MCP 的
+                // read_text_file 就走这条），当文本透传 —— 退化成「已跳过」等于把文件内容吞掉。
+                if (typeof r.text === "string" && r.text) {
+                    blocks.push({ type: "text", text: r.text });
+                    continue;
+                }
+                // resource(blob)/audio 等块在 SDK 内容联合里没有载体（只有 text|image|thinking|toolCall），
+                // 退化为文本提示，让模型至少知道工具返回了什么，而不是看到一个空串。
+                const mime = (c.mimeType ?? r.mimeType ?? "").trim();
+                const blob = typeof r.blob === "string" && r.blob ? r.blob : c.data;
+                const size = typeof blob === "string" && blob ? `，约 ${Math.max(1, Math.round((blob.length * 3) / 4))} 字节` : "";
+                blocks.push({
+                    type: "text",
+                    text: `[MCP 工具返回了非文本内容块（${mime || c.type || "未知类型"}${size}），当前会话无法内联，已跳过。]`,
+                });
+                hasNonText = true;
+                continue;
+            }
+            const text = c.text ?? "";
+            if (text)
+                blocks.push({ type: "text", text });
+        }
+        if (!hasNonText) {
+            // 纯文本结果保持旧形状（拼接字符串），不破坏既有调用方。
+            return { content: blocks.map((b) => (b.type === "text" ? b.text : "")).join("\n"), isError: !!res.isError };
+        }
+        return { content: blocks, isError: !!res.isError };
     }
     /** 关闭：kill 子进程，拒绝所有在途请求。 */
     close() {

package/dist/server/plugins.js

@@ -402,7 +402,17 @@ export class PluginManager {
             return;
         }
         try {
-            handler(req, res);
+            // 异步 handler（`async (req, res) => …`）的 rejection 不会被这里的 try 接住，
+            // 会变成 unhandledRejection 直接杀掉整个服务（插件读文件失败、host.fs 越界
+            // 拒绝、上游超时…都会走到这条路上）——用 Promise.resolve().catch 兜住，
+            // 与同步抛错同样转 500。
+            void Promise.resolve(handler(req, res)).catch((err) => {
+                console.error(`[plugin:${pluginId}] http ${method} ${path} failed:`, err);
+                if (!res.headersSent)
+                    res.status(500).end("internal error");
+                else
+                    res.end();
+            });
         }
         catch (err) {
             console.error(`[plugin:${pluginId}] http ${method} ${path} failed:`, err);
@@ -646,7 +656,13 @@ export class PluginManager {
         }
         return found.map((f) => this.loaded.get(f.id)?.info ?? f);
     }
-    /** 反激活单个插件：deactivate + 注销 AI 工具 + 清缓存。 */
+    /** 反激活单个插件：deactivate + 注销 AI 工具 + 清缓存。
+     *
+     *  注意这里必须把 id 从 attempted 里摘掉：目录一时不在（`pi-web-ui install --force`
+     *  先 rm 再 cp，扫描正好撞上窗口期）只是「暂时看成卸载」，目录回来后还要能重新激活；
+     *  留在 attempted 里 = 本进程内永远不再激活，插件的 HTTP 路由 / AI 工具全没了，
+     *  前端只会看到「代理请求失败 404 <url>」（插件的 /proxy 路由不存在），且 CLI 承诺的
+     *  「刷新浏览器即可加载」失效，必须重启服务才能恢复。 */
     deactivateEntry(id, p) {
         try {
             p.deactivate?.();
@@ -665,6 +681,11 @@ export class PluginManager {
         }
         this.loaded.delete(id);
         this.messageHandlers.delete(id);
+        this.attempted.delete(id);
+        // 重新激活时会 import 磁盘上的 index.mjs：Node 的 ESM 缓存按 URL（含 ?e=）
+        // 命中，epoch 不变就会拿到旧模块（更新插件后还是旧代码）——所以这里也 +1，
+        // 顺带让浏览器端 ?e= 变化、重拉插件的 client bundle。
+        this.epochCounter += 1;
         console.log(`[plugin:${id}] removed`);
     }
     /** 关机时反激活全部插件。 */

package/dist/server/subagent-templates.js

@@ -2,9 +2,12 @@
  * subagent-templates.ts — 子代理模板库（全局共享，<dataDir>/subagent-templates.json）。
  *
  * 模板 = 派生子代理时套用的预设：角色系统提示词（replace/append 同主设置语义）+
- * 技能白名单 + 扩展白名单 + 可选模型。白名单空数组 = 该维度不限定，子代理跟随主会话设置。
+ * 技能白名单 + 扩展白名单 + 可选模型 + 可选思考强度。白名单空数组 = 该维度不限定，
+ * 子代理跟随主会话设置。
  * `model` 为 "provider/id"（与 subagent_spawn 的 model 参数、设置面板子代理默认模型
  * 同格式）；空字符串 = 跟随主对话当前模型。
+ * `thinkingLevel` 为 SDK 的思考强度（off…max，见 THINKING_LEVELS）；空字符串 = 跟随
+ * 主对话当前思考强度（与 model 的「跟随主对话」同语义）。
  * 带 `enabled: false` 的模板停用：设置面板仍可见、可重新启用，但 AI 工具
  * （subagent_templates / subagent_spawn）查询不到它、也不能选择它——「关闭 =
  * 对 AI 不可见」。
@@ -18,6 +21,13 @@
  */
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+/**
+ * 思考强度取值：与 SDK 的 THINKING_LEVEL_OPTIONS（前端 ModelThinking 的 THINKING_VALUES）
+ * 一致。SDK 未从包根导出该常量，这里照抄一份作输入校验（写错的值一律当未配置）。
+ * 注意模型能力收敛（reasoning / thinkingLevelMap）由 SDK 的 setThinkingLevel 负责：
+ * 非推理模型只会得到 "off"，这里不做也不该做模型相关的判断。
+ */
+export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 /** 按语言选模板简介：zh 用 description；en 优先 descriptionEn、缺失回落 description。 */
 export function pickTemplateDescription(t, lang) {
     if (lang === "zh")
@@ -39,7 +49,8 @@ const NAME_MAX = 60;
  * 白名单留空 = 技能/扩展跟随主会话设置，开箱即用。
  */
 export const DEFAULT_TEMPLATES = [
-    // 全部内置模板默认 model 为空字符串 = 跟随主对话模型（面板改模板时可指定专属模型）。
+    // 全部内置模板默认 model / thinkingLevel 为空字符串 = 跟随主对话当前模型与思考强度
+    // （面板改模板时可指定专属模型与强度）。
     {
         name: "review",
         description: "代码 / 计划 / 方案 / PR 审查：有证据的 P0-P2 发现与合并结论",
@@ -86,6 +97,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -130,6 +142,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -170,6 +183,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -214,6 +228,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -240,6 +255,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -260,6 +276,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     // ---- oh-my-pi specialist 系列（移植自 oh-my-pi 内置 agents + persona 包装模板，
@@ -292,6 +309,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -316,6 +334,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -348,6 +367,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -378,6 +398,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -408,6 +429,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -432,6 +454,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
     {
@@ -454,6 +477,7 @@ export const DEFAULT_TEMPLATES = [
         enabledSkills: [],
         enabledExtensions: [],
         model: "",
+        thinkingLevel: "",
         enabled: true,
     },
 ];
@@ -480,6 +504,10 @@ function normalize(raw) {
             : [],
         // 空字符串 = 跟随主对话；其余剥掉首尾空白，超长当脏数据丢弃。
         model: typeof o.model === "string" ? o.model.trim() : "",
+        // 只认 THINKING_LEVELS 里的档位；老文件没有该字段 / 值写错 → 空 = 跟随主对话。
+        thinkingLevel: typeof o.thinkingLevel === "string" && THINKING_LEVELS.includes(o.thinkingLevel.trim())
+            ? o.thinkingLevel.trim()
+            : "",
         enabled: o.enabled !== false,
     };
 }

package/dist/server/subagents.js

@@ -92,15 +92,16 @@ export function makeSubagentTools(host, lang, selfConvId) {
                 "subagent_get_result for results, subagent_steer to redirect mid-run, subagent_stop to stop. " +
                 "Good for: long-running exploration, parallel research, delegating independent subtasks. Optional template " +
                 "param: use a subagent template configured in the settings panel " +
-                "(role system prompt + skills/extensions whitelist + optional model); optional model param: explicitly set " +
+                "(role system prompt + skills/extensions whitelist + optional model + optional thinking level); optional model " +
+                "param: explicitly set " +
                 'the subagent model (provider/id, e.g. "anthropic/claude-opus-4-5"), which overrides the template and panel ' +
-                "default; omit both = follow the main conversation's model.", "在后台启动一个独立的子代理对话，用一个明确的指令去完成一项可独立交付的工作（调研/实现/审查等）。" +
+                "default; omit both = follow the main conversation's model and thinking level.", "在后台启动一个独立的子代理对话，用一个明确的指令去完成一项可独立交付的工作（调研/实现/审查等）。" +
                 "子代理会出现在左栏「运行的对话」列表（带子代理标识），用户可点开查看、补充、中止。主 agent 可并行派发多个：" +
                 "用 subagent_wait_all 一次性等全部完成（不用轮询）、subagent_list 查看运行态、subagent_get_result 取结果、" +
                 "subagent_steer 中途改向、subagent_stop 停止。" +
                 "适合：长耗时探索、并行调研、独立子任务委派。可选 template 参数：使用设置面板配置的子代理模板" +
-                "（角色系统提示词 + 技能/扩展白名单 + 可选模型）；可选 model 参数：显式指定子代理模型（provider/id 格式，" +
-                '如 "anthropic/claude-opus-4-5"），优先级高于模板与设置面板的默认模型；都不传 = 跟随主对话当前模型。'),
+                "（角色系统提示词 + 技能/扩展白名单 + 可选模型 + 可选思考强度）；可选 model 参数：显式指定子代理模型（provider/id 格式，" +
+                '如 "anthropic/claude-opus-4-5"），优先级高于模板与设置面板的默认模型；都不传 = 跟随主对话当前模型与思考强度。'),
             promptSnippet: "spawn an independent background subagent for a deliverable task (parallel work)",
             parameters: Type.Object({
                 prompt: Type.String({
@@ -112,8 +113,8 @@ export function makeSubagentTools(host, lang, selfConvId) {
                 template: Type.Optional(Type.String({
                     description: bilingual("Optional: subagent template name (a preset configured under Settings → Subagent Templates, see the " +
                         "subagent_templates tool). Template = role system prompt + skills/extensions whitelist + optional " +
-                        "model; omit = run with the main session defaults.", "可选：子代理模板名（设置面板「子代理模板」配置的预设，见 subagent_templates 工具）。" +
-                        "模板 = 角色系统提示词 + 技能/扩展白名单 + 可选模型；不传 = 不使用模板，按主会话默认配置运行。"),
+                        "model + optional thinking level; omit = run with the main session defaults.", "可选：子代理模板名（设置面板「子代理模板」配置的预设，见 subagent_templates 工具）。" +
+                        "模板 = 角色系统提示词 + 技能/扩展白名单 + 可选模型 + 可选思考强度；不传 = 不使用模板，按主会话默认配置运行。"),
                 })),
                 model: Type.Optional(Type.String({
                     description: bilingual('Optional: subagent model "provider/id" (e.g. "anthropic/claude-opus-4-5") for this run; overrides the ' +
@@ -311,8 +312,8 @@ export function makeSubagentTools(host, lang, selfConvId) {
             name: "subagent_templates",
             label: "List subagent templates",
             description: bilingual("List the configurable subagent templates (role system prompt + skills/extensions whitelist + optional model " +
-                "presets) for the subagent_spawn template param. Disabled templates never appear here. " +
-                "Empty list = no templates configured; subagents run with defaults.", "列出设置面板「子代理模板」配置的可用模板（角色系统提示词 + 技能/扩展白名单 + 可选模型 的组合预设），" +
+                "and thinking level presets) for the subagent_spawn template param. Disabled templates never appear here. " +
+                "Empty list = no templates configured; subagents run with defaults.", "列出设置面板「子代理模板」配置的可用模板（角色系统提示词 + 技能/扩展白名单 + 可选模型与思考强度 的组合预设），" +
                 "供 subagent_spawn 的 template 参数选用。已停用的模板不会出现在这里。list 为空 = 未配置模板，子代理按默认配置运行。"),
             promptSnippet: "list configurable subagent templates (role prompt + skills/extensions whitelist presets)",
             parameters: Type.Object({}),
@@ -324,14 +325,23 @@ export function makeSubagentTools(host, lang, selfConvId) {
                 }
                 const lines = list.map((t) => {
                     const desc = tLang === "zh" ? t.description : t.descriptionEn || t.description;
+                    // 模型与思考强度分开报：思考强度是模板固定值（空 = 跟主对话当前强度）。
+                    const modelPart = tLang === "zh"
+                        ? t.model
+                            ? `模型：${t.model}`
+                            : "跟随主对话模型"
+                        : t.model
+                            ? `model: ${t.model}`
+                            : "follows the main conversation model";
+                    const thinkingPart = tLang === "zh"
+                        ? t.thinkingLevel
+                            ? `思考强度：${t.thinkingLevel}`
+                            : "跟随主对话思考强度"
+                        : t.thinkingLevel
+                            ? `thinking: ${t.thinkingLevel}`
+                            : "follows the main conversation thinking level";
                     return ((tLang === "zh" ? `- ${t.name}${desc ? `：${desc}` : ""}` : `- ${t.name}${desc ? `: ${desc}` : ""}`) +
-                        (tLang === "zh"
-                            ? t.model
-                                ? `（模型：${t.model}）`
-                                : "（跟随主对话模型）"
-                            : t.model
-                                ? ` (model: ${t.model})`
-                                : " (follows the main conversation model)"));
+                        (tLang === "zh" ? `（${modelPart}，${thinkingPart}）` : ` (${modelPart}, ${thinkingPart})`));
                 });
                 const firstTemplateName = list[0]?.name;
                 const templateLines = lines.join("\n");

package/dist/server/tool-manager.js

@@ -44,9 +44,12 @@ export const ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
 /** 任务列表只读查询工具（定义见 agent-service.ts makeMarkersListTool；只服务 todo）。
  * 曾用名 markers_list（名过其实，已迁移，见 normalizeDisabledAgentTools）。 */
 export const MARKERS_LIST_TOOL_NAME = "todo_list";
+/** 浏览器页面操作工具（定义见 agent-service.ts makeBrowserPageTool）：模型经
+ *  page-picker 浏览器扩展读/操作用户已授权的页面。 */
+export const BROWSER_PAGE_TOOL_NAME = "browser_page";
 /** 旧工具名（持久化迁移用；新代码一律用 MARKERS_LIST_TOOL_NAME）。 */
 export const LEGACY_MARKERS_LIST_TOOL_NAME = "markers_list";
-/** 可开关的 Agent 工具总目录（共 18 个；bash 本体与 SDK 内置 edit/read
+/** 可开关的 Agent 工具总目录（共 19 个；bash 本体与 SDK 内置 edit/read
  *  不进目录——关了 agent 就残了，不给关）。 */
 export const AGENT_TOOL_CATALOG = [
     ...TERMINAL_TOOL_NAMES.map((name) => ({
@@ -65,6 +68,9 @@ export const AGENT_TOOL_CATALOG = [
     { name: DELEGATE_TASK_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
     { name: ASK_USER_QUESTION_TOOL_NAME, group: "other", defaultOn: true, dshVisible: true },
     { name: MARKERS_LIST_TOOL_NAME, group: "other", defaultOn: true, dshVisible: true },
+    // 默认开但 dshVisible=false：DSH 引擎没有页面桥（page_request 由 pi 引擎的
+    // customTool 发出），列在那里只会让用户关一个不存在的工具。
+    { name: BROWSER_PAGE_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
 ];
 const KNOWN_NAMES = new Set(AGENT_TOOL_CATALOG.map((t) => t.name));
 /** 是否为本表登记的可开关工具（未知名一律 false，不抛错）。 */

package/dist/server/webui-context.js

@@ -33,16 +33,34 @@ const mockTui = new Proxy({
 });
 /**
  * Implements the subset of ExtensionUIContext that makes sense for a web UI.
- * TUI-only affordances (select/confirm/input dialogs, terminal input, custom
- * footer) are inert: dialogs resolve to cancellation instead of blocking.
+ * widgets/statuses/notices/dialogs are bridged to the browser (a dialog nobody
+ * answers resolves to cancellation); TUI-only affordances (terminal input,
+ * footer/header, custom components, editor hooks) are inert.
+ *
+ * 两种实例：挂浏览器的（构造时给真 emitter）与 headless 的（`WebUIContext.headless()`，
+ * 子代理会话用——见该方法的说明）。
  */
 export class WebUIContext {
     theme = mockThemeProxy;
     widgets = new Map();
     lastLines = new Map();
     emit;
-    constructor(emit) {
-        this.emit = emit;
+    /** headless 实例没有浏览器面板：输出全部丢弃、弹窗直接按取消返回。 */
+    headless;
+    constructor(emit, options = {}) {
+        this.headless = options.headless === true;
+        this.emit = this.headless ? () => { } : emit;
+    }
+    /** 子代理会话用的上下文：方法面与挂浏览器的那个完全一致（扩展调用任何
+     *  ExtensionUIContext 方法都不会因方法缺失而崩），但没有面板接收输出，因此
+     *
+     *   - widgets/status/notice 一律丢弃（不会与主对话的 widget/status 串台）；
+     *   - widget 组件工厂不调用（没人 dispose 的组件会一直挂着）；
+     *   - select/confirm/input 直接按「取消」resolve —— 关键：这里没有浏览器应答，
+     *     照常挂 Promise 会让扩展永久 await（只有 20 分钟的工具看门狗兜底）。
+     */
+    static headless() {
+        return new WebUIContext(() => { }, { headless: true });
     }
     // -- widgets -------------------------------------------------------------
     /** Register a widget whose lines come from a plain getter, re-evaluated on
@@ -57,6 +75,9 @@ export class WebUIContext {
     /** Matches ExtensionUIContext's overloaded setWidget exactly. */
     setWidget = (key, content, options) => {
         void options;
+        // headless：没有面板可渲染，连组件工厂都不调用。
+        if (this.headless)
+            return;
         if (content === undefined) {
             this.widgets.delete(key);
             this.lastLines.delete(key);
@@ -163,6 +184,9 @@ export class WebUIContext {
     confirm = (title, message) => this.openDialog("confirm", title, [message]);
     input = (title, placeholder) => this.openDialog("input", title, [placeholder ?? ""]);
     openDialog(kind, title, args) {
+        // headless：没人能应答，立刻按「取消」结束（与 cancelPendingDialogs 同值）。
+        if (this.headless)
+            return Promise.resolve(null);
         return new Promise((resolve) => {
             const id = ++this.dialogSeq;
             this.pendingDialogs.set(id, resolve);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.80.2",
+	"version": "0.83.0",
 	"description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
 	"license": "MIT",
 	"author": {
@@ -59,8 +59,10 @@
 		"build:server": "tsc -p tsconfig.server.json",
 		"build:dsh-runtime": "node scripts/copy-dsh-runtime.mjs",
 		"build:mermaid-vendor": "node scripts/build-mermaid-vendor.mjs",
+		"build:extension": "node plugins/page-picker/extension/build.mjs",
+		"pack:extension": "node plugins/page-picker/extension/pack.mjs",
 		"build:runtrace-vendor": "node scripts/build-runtrace-vendor.mjs",
-		"typecheck": "tsc -p tsconfig.server.json --noEmit && tsc -p web/tsconfig.json --noEmit && tsc -p tsconfig.tests.json --noEmit && tsc -p desktop/tsconfig.json --noEmit",
+		"typecheck": "tsc -p tsconfig.server.json --noEmit && tsc -p web/tsconfig.json --noEmit && tsc -p tsconfig.tests.json --noEmit && tsc -p desktop/tsconfig.json --noEmit && tsc -p plugins/page-picker/extension/tsconfig.json --noEmit",
 		"test": "vitest run",
 		"test:unit": "vitest run",
 		"test:smoke": "node tests/run-smoke.mjs",

package/plugins/catalog.json

@@ -52,5 +52,14 @@
 		"descriptionEn": "Legado reader (text book sources): search / explore / info / TOC / content with Android-compatible book source JSON, plus source import and health checking. Ships its own CORS+GBK proxy, local store, and AI tools to diagnose and repair book sources.",
 		"source": "xing-shuyin/pi-web-ui/plugins/legado-web",
 		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/legado-web"
+	},
+	{
+		"id": "image-toolkit",
+		"name": "image-toolkit",
+		"icon": "🖼",
+		"description": "图片处理工作台：压缩（可按目标体积二分逼近）、裁剪、缩放、旋转/翻转、格式转换（PNG/JPEG/WebP/AVIF）、批量导出 ZIP、水印、滤镜调色、图片信息与 EXIF，可直接读写工作区图片；另给 AI 配了 4 个工具，让 agent 自己压缩/裁剪/缩放/加水印工作区里的图。",
+		"descriptionEn": "Image workbench: compress (with target-size binary search), crop, resize, rotate/flip, format conversion (PNG/JPEG/WebP/AVIF), batch ZIP export, watermark, filters, image info + EXIF, and direct workspace read/write. Ships 4 AI tools so the agent can compress/crop/resize/watermark workspace images itself.",
+		"source": "xing-shuyin/pi-web-ui/plugins/image-toolkit",
+		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/image-toolkit"
 	}
 ]

package/themes/cyberpunk.css

@@ -73,6 +73,7 @@
 	--search-active-fg: #1a1d26;
 	--switch-knob: #ffffff;
 	--bg-elev3: rgba(255, 255, 255, 0.06);
+	--sunken-bg: rgba(0, 0, 0, 0.15);
 	--glow-015: rgba(255, 255, 255, 0.015);
 	--glow-025: rgba(255, 255, 255, 0.025);
 	--glow-03: rgba(255, 255, 255, 0.03);

package/themes/dazzle.css

@@ -73,6 +73,7 @@
 	--search-active-fg: #1a1d26;
 	--switch-knob: #ffffff;
 	--bg-elev3: rgba(255, 255, 255, 0.06);
+	--sunken-bg: rgba(0, 0, 0, 0.15);
 	--glow-015: rgba(255, 255, 255, 0.015);
 	--glow-025: rgba(255, 255, 255, 0.025);
 	--glow-03: rgba(255, 255, 255, 0.03);

package/themes/md-preview.css

@@ -73,6 +73,7 @@
 	--search-active-fg: #1a1d26;
 	--switch-knob: #ffffff;
 	--bg-elev3: rgba(255, 255, 255, 0.06);
+	--sunken-bg: rgba(0, 0, 0, 0.15);
 	--glow-015: rgba(255, 255, 255, 0.015);
 	--glow-025: rgba(255, 255, 255, 0.025);
 	--glow-03: rgba(255, 255, 255, 0.03);

package/themes/mist.css

@@ -73,6 +73,7 @@
 	--search-active-fg: #1a1d26;
 	--switch-knob: #ffffff;
 	--bg-elev3: rgba(30, 58, 95, 0.05);
+	--sunken-bg: rgba(30, 58, 95, 0.05);
 	--glow-015: rgba(30, 58, 95, 0.02);
 	--glow-025: rgba(30, 58, 95, 0.02);
 	--glow-03: rgba(30, 58, 95, 0.02);

package/themes/paper.css

@@ -73,6 +73,7 @@
 	--search-active-fg: #1a1d26;
 	--switch-knob: #ffffff;
 	--bg-elev3: rgba(120, 90, 30, 0.06);
+	--sunken-bg: rgba(120, 90, 30, 0.05);
 	--glow-015: rgba(120, 90, 30, 0.02);
 	--glow-025: rgba(120, 90, 30, 0.02);
 	--glow-03: rgba(120, 90, 30, 0.02);