pi-web-ui 0.92.0 → 0.93.0

package/dist/server/skill-tool.js

@@ -21,6 +21,7 @@ import { statSync, readFileSync } from "node:fs";
 import { defineTool } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { bilingual, pick } from "./i18n.js";
+import { SKILL_TOOL_NAME } from "./tool-manager.js";
 import { decodeText } from "./text-sniff.js";
 /** 单文件正文上限（与 agent-service fillSkillContents 同口径：8KB）。 */
 export const SKILL_TOOL_FILE_CAP = 8192;
@@ -58,7 +59,7 @@ export function makeSkillTool(host, lang) {
         details,
     });
     return defineTool({
-        name: "skill",
+        name: SKILL_TOOL_NAME,
         label: "Load a skill",
         description: bilingual("Load a skill's full text by its exact name (see the <available_skills> catalog in the system prompt). " +
             "Prefer this over reading the skill file with the read tool — no path guessing needed. " +

package/dist/server/subagents.js

@@ -61,7 +61,7 @@ export function subagentTitle(prompt) {
 export function withSubagentOwner(host, ownerId) {
     return {
         ...host,
-        spawnSubagent: (prompt, type, cwd, templateName, model) => host.spawnSubagent(prompt, type, cwd, templateName, model, ownerId),
+        spawnSubagent: (prompt, type, cwd, templateName, model, _parentId, persist) => host.spawnSubagent(prompt, type, cwd, templateName, model, ownerId, persist),
     };
 }
 /**
@@ -125,6 +125,11 @@ export function makeSubagentTools(host, lang, selfConvId) {
                 cwd: Type.Optional(Type.String({
                     description: bilingual("Subagent working directory (relative/absolute). Defaults to the main session's cwd.", "子代理工作目录（相对/绝对）。默认继承主会话工作目录。"),
                 })),
+                persist: Type.Optional(Type.Boolean({
+                    description: bilingual("Optional: persist this conversation to disk as a regular session (saved in history, resumable). " +
+                        "Default false (lightweight in-memory subagent). Use true for tasks that need long-term retention or human follow-up.", "可选：是否将该对话持久化落盘为普通对话（保存在历史会话中，可随时回顾与继续）。" +
+                        "默认 false（轻量内存子代理）。需要长期留存或后续人工跟进的任务建议设为 true。"),
+                })),
             }),
             execute: async (_id, p, _signal, _onUpdate, ctx) => {
                 if (p.template && !host.isTemplateUsable(p.template)) {
@@ -134,7 +139,7 @@ export function makeSubagentTools(host, lang, selfConvId) {
                 // host 抛错）：转成返回文本而不是直接抛，让 AI 能读到原因并调整重试。
                 let convId;
                 try {
-                    convId = await host.spawnSubagent(p.prompt, p.type ?? "general", p.cwd ?? ctx.cwd, p.template, p.model);
+                    convId = await host.spawnSubagent(p.prompt, p.type ?? "general", p.cwd ?? ctx.cwd, p.template, p.model, undefined, p.persist);
                 }
                 catch (err) {
                     const msg = err instanceof Error ? err.message : String(err);
@@ -151,8 +156,10 @@ export function makeSubagentTools(host, lang, selfConvId) {
                 const templateLineEn = p.template ? `\nTemplate: ${p.template}` : "";
                 const modelLineZh = p.model ? `\n模型：${p.model}` : "";
                 const modelLineEn = p.model ? `\nModel: ${p.model}` : "";
-                return text(pick(getLang(), `子代理已启动（运行列表可见）：${convId}\n类型：${subagentType} · 标题：${subagentTitleText}${templateLineZh}${modelLineZh}` +
-                    `\n用 subagent_wait_all 一次等全部完成（不用轮询），subagent_get_result 取单个结果，subagent_list 看运行态，subagent_steer 改向，subagent_stop 停止。`, `Subagent started (visible in the running list): ${convId}\nType: ${subagentType} · Title: ${subagentTitleText}${templateLineEn}${modelLineEn}` +
+                const kindLabelZh = p.persist ? "普通持久化对话" : "子代理";
+                const kindLabelEn = p.persist ? "Persistent conversation" : "Subagent";
+                return text(pick(getLang(), `${kindLabelZh}已启动（运行列表可见）：${convId}\n类型：${subagentType} · 标题：${subagentTitleText}${templateLineZh}${modelLineZh}` +
+                    `\n用 subagent_wait_all 一次等全部完成（不用轮询），subagent_get_result 取单个结果，subagent_list 看运行态，subagent_steer 改向，subagent_stop 停止。`, `${kindLabelEn} started (visible in the running list): ${convId}\nType: ${subagentType} · Title: ${subagentTitleText}${templateLineEn}${modelLineEn}` +
                     `\nUse subagent_wait_all to wait for all at once (no polling), subagent_get_result for a single result, subagent_list for live status, subagent_steer to redirect, subagent_stop to stop.`, "subagents.spawn.started", {
                     convId: convId,
                     subagentType: subagentType,
@@ -163,7 +170,7 @@ export function makeSubagentTools(host, lang, selfConvId) {
                     templateLineEn: templateLineEn,
                     modelLineZh: modelLineZh,
                     modelLineEn: modelLineEn,
-                }), { convId, template: p.template, model: p.model });
+                }), { convId, template: p.template, model: p.model, persisted: !!p.persist });
             },
         }),
         defineTool({
@@ -220,16 +227,24 @@ export function makeSubagentTools(host, lang, selfConvId) {
         defineTool({
             name: "subagent_list",
             label: "List subagents",
-            description: bilingual("List all subagents and their live status: convId, type, state, title, message count (errors/aborts are marked in the state).", "列出全部子代理的运行态：convId、类型、状态、标题、消息数（报错/中止的会在状态里标出）。"),
+            description: bilingual("List all subagents and managed conversations with their live status: convId, type, state, title, message count (errors/aborts are marked in the state).", "列出全部子代理及受控对话的运行态：convId、类型、状态、标题、消息数（报错/中止的会在状态里标出）。"),
             promptSnippet: "list all subagents and their live status",
-            parameters: Type.Object({}),
-            execute: async () => {
-                const list = host.listSubagents();
+            parameters: Type.Object({
+                kind: Type.Optional(Type.String({
+                    enum: ["all", "subagent", "persistent"],
+                    description: bilingual("Filter: all (default) = all managed tasks; subagent = only ephemeral in-memory subagents; persistent = only persistent conversations.", "过滤类型：all（默认）= 全部受控对话；subagent = 仅临时内存子代理；persistent = 仅持久化普通对话。"),
+                })),
+            }),
+            execute: async (_id, p) => {
+                const list = host.listSubagents(p.kind);
                 if (list.length === 0)
-                    return text(pick(getLang(), "当前没有子代理。", "No subagents running.", "subagents.list.empty"));
+                    return text(pick(getLang(), "当前没有运行中的对话/子代理。", "No managed conversations or subagents running.", "subagents.list.empty"));
                 const tLang = getLang();
-                const lines = list.map((r) => `- ${r.convId} · ${r.type} · ${subagentVerdict(r, tLang)} · ${r.title}` +
-                    (tLang === "zh" ? `（msg: ${r.messageCount}）` : ` (msg: ${r.messageCount})`));
+                const lines = list.map((r) => {
+                    const tag = r.persisted ? (tLang === "zh" ? "持久化" : "persistent") : tLang === "zh" ? "子代理" : "subagent";
+                    return (`- ${r.convId} · ${r.type} · ${subagentVerdict(r, tLang)} · ${r.title}` +
+                        (tLang === "zh" ? `（${tag} · msg: ${r.messageCount}）` : ` (${tag} · msg: ${r.messageCount})`));
+                });
                 return text(lines.join("\n"));
             },
         }),
@@ -374,7 +389,9 @@ export function makeSubagentTools(host, lang, selfConvId) {
                     const emptyLang = getLang();
                     return text(pick(emptyLang, "没有需要等待的子代理（调用者自身与祖先不计入等待；子代理无参时只等自己的后代）。", "No subagents to wait for (the calling session itself and its ancestors are never waited on; a subagent without runIds only waits for its own descendants).", "subagents.wait.empty"));
                 }
-                const timeoutMs = Math.min(Math.max(p.timeoutSeconds ?? 600, 1), Math.floor(WAIT_CAP_MS / 1000)) * 1000;
+                const currentWatchdogMs = host.getWatchdogTimeoutMs?.() ?? WAIT_CAP_MS;
+                const currentWaitCapMs = currentWatchdogMs > 0 ? Math.max(60_000, Math.floor(currentWatchdogMs * 0.8)) : 3600_000;
+                const timeoutMs = Math.min(Math.max(p.timeoutSeconds ?? 600, 1), Math.floor(currentWaitCapMs / 1000)) * 1000;
                 const waitStart = Date.now();
                 const deadline = waitStart + timeoutMs;
                 // 已到终态的、（或已被移出找不到的）直接归位；剩下的阻塞轮询到

package/dist/server/terminals.js

@@ -1295,10 +1295,16 @@ export class TerminalManager {
             w.cb(null);
         entry.exitCode = exitCode;
         this.terms.delete(id);
+        // 进程已退出，立即释放底层的 PTY 句柄（Windows ConPTY / HPCON / sockets 等），
+        // 避免已退出的终端长期占用 ConPTY 与 MSYS2 控制台资源（issue #269）。
+        this.killNative(entry);
         while (this.history.size >= MAX_TERMINAL_HISTORY) {
             const oldest = this.history.keys().next().value;
             if (typeof oldest !== "string")
                 break;
+            const oldEntry = this.history.get(oldest);
+            if (oldEntry)
+                this.killNative(oldEntry);
             this.history.delete(oldest);
         }
         this.history.set(id, entry);
@@ -1339,8 +1345,13 @@ export class TerminalManager {
             this.emitList();
             return;
         }
-        if (this.history.delete(id))
+        const histEntry = this.history.get(id);
+        if (histEntry) {
+            this.killNative(histEntry);
+            this.history.delete(id);
             this.emitList();
+            return;
+        }
     }
     /** Rename a terminal tab (live or retained history). Empty names ignored. */
     rename(id, title) {
@@ -1354,27 +1365,33 @@ export class TerminalManager {
         this.emitList();
     }
     /**
-     * Kill the native PTY (issue #215：Windows ConPTY 关机死锁）。
+     * Kill the native PTY (issue #215：Windows ConPTY 关机死锁；issue #269：MSYS2 控制台耗尽死锁）。
      *
-     * Windows 下 `pty.kill()` 底层走 `ClosePseudoConsole`，管道有未排空数据时会
-     * 内核级同步死锁，直接冻住单线程事件循环（进程内 setTimeout 看门狗与二次
-     * Ctrl+C 全灭）。所以 Windows 先走 Node 原生的 `process.kill(pid)`
-     *（TerminateProcess，从不阻塞）把 shell 干掉：
-     * - 关机（shutdown=true）：到此为止，不再调 `pty.kill()`。进程马上就
-     *   `process.exit`，HPC 句柄由 OS 回收；再调只会自找死锁。
-     * - 日常（tab 关闭/移出对话）：子进程已死、管道见 EOF 后再调 `pty.kill()`
-     *   释放 HPC 句柄，此时不再阻塞（长驻服务必须释放句柄，不能像关机那样一走了之）。
-     * 非 Windows 原样直调 `pty.kill()`。
+     * Windows 下：
+     * 1. 若进程已经退出（entry.exited）：绝不可再调用 Node 的 process.kill(pid)，
+     *    直接调 pty.kill() 释放 HPCON 句柄（子进程已死、管道见 EOF，绝不会死锁）。
+     * 2. 若进程尚未退出（!entry.exited）：
+     *    先尝试优雅关闭（向 PTY 写入 \x03exit\r），让 bash 正常触发清理钩子；
+     *    若仍未退出才以 process.kill(pid)（TerminateProcess）强制兜底。
+     * 3. 关机（shutdown=true）：跳过 pty.kill()，由 OS 回收。
+     * 非 Windows 原样直调 pty.kill()。
      */
     killNative(entry, shutdown = false) {
         if (process.platform === "win32") {
-            const pid = entry.pty.pid;
-            if (typeof pid === "number") {
-                try {
-                    process.kill(pid);
-                }
-                catch {
-                    // already dead
+            if (!entry.exited) {
+                const pid = entry.pty.pid;
+                if (typeof pid === "number") {
+                    try {
+                        // 优雅关闭：先发 Ctrl+C，再发 exit\r
+                        entry.pty.write("\x03exit\r");
+                    }
+                    catch { }
+                    try {
+                        process.kill(pid);
+                    }
+                    catch {
+                        // already dead
+                    }
                 }
             }
             if (shutdown)
@@ -1410,6 +1427,9 @@ export class TerminalManager {
                 w.cb(null);
             entry.watches = [];
         }
+        for (const entry of this.history.values()) {
+            this.killNative(entry, shutdown);
+        }
         this.terms.clear();
         this.history.clear();
         this.emitList();

package/dist/server/themes.js

@@ -23,6 +23,20 @@ const ID_RE = /^[A-Za-z0-9_-]+$/;
 const THEME_NAME_RE = /\/\*\s*theme-name:\s*(.+?)\s*\*\//;
 const THEME_NAME_EN_RE = /\/\*\s*theme-name-en:\s*(.+?)\s*\*\//;
 const THEME_GROUP_RE = /\/\*\s*theme-group:\s*(.+?)\s*\*\//;
+/** 从主题 CSS 头部读取 color-scheme（浅/暗），无法识别时返回 undefined。 */
+const THEME_SCHEME_RE = /color-scheme:\s*(dark|light)/i;
+function readScheme(path) {
+    try {
+        const head = readFileSync(path, "utf8").slice(0, 800);
+        const m = head.match(THEME_SCHEME_RE);
+        if (m && (m[1] === "dark" || m[1] === "light"))
+            return m[1];
+    }
+    catch {
+        // ignore
+    }
+    return undefined;
+}
 function readDisplayName(path, fallback) {
     try {
         const head = readFileSync(path, "utf8").slice(0, 400);
@@ -72,6 +86,7 @@ export function listThemes(builtinDir, userDir) {
                 name,
                 builtin,
                 group,
+                scheme: readScheme(path),
                 ...(nameEn ? { nameEn } : {}),
             };
         });

package/dist/server/tool-info.js

@@ -0,0 +1,89 @@
+/** parameters（JSON Schema）的体积上限：超过就整丢。 */
+export const TOOL_PARAMETERS_CAP = 64_000;
+/** description 的字数上限（SDK 里的工具描述很少超过几百字，这里防的是扩展写疯）。 */
+export const TOOL_DESCRIPTION_CAP = 8_000;
+/** promptGuidelines 合计字数上限（进系统提示词的要点，正常都很短）。 */
+export const TOOL_GUIDELINES_CAP = 8_000;
+function str(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const s = v.trim();
+    return s ? s : undefined;
+}
+/** 超长截断（`…` 结尾，与前端 truncateText 同款标记）。 */
+function cut(s, cap) {
+    return s.length > cap ? `${s.slice(0, cap)}…` : s;
+}
+/** 参数 schema 是否可下发（能序列化且不超上限）。 */
+function parametersWithinCap(params) {
+    if (params === undefined || params === null)
+        return false;
+    try {
+        const text = JSON.stringify(params);
+        return typeof text === "string" && text.length <= TOOL_PARAMETERS_CAP;
+    }
+    catch {
+        // 循环引用 / BigInt 等序列化不了的值：当成「没有 schema」。
+        return false;
+    }
+}
+/**
+ * 归一化一条工具定义 → wire 载荷。
+ *
+ * @param name 请求里的工具名（**永远以它为准**：定义里的 name 缺失时前端仍要能显示标题）。
+ * @param raw  引擎给的定义；undefined/null = 没找到。
+ */
+export function normalizeToolInfo(name, raw) {
+    const toolName = str(name) ?? "";
+    if (!raw || typeof raw !== "object")
+        return { name: toolName, found: false };
+    const payload = { name: toolName, found: true };
+    const label = str(raw.label);
+    if (label)
+        payload.label = cut(label, 200);
+    const description = str(raw.description);
+    if (description)
+        payload.description = cut(description, TOOL_DESCRIPTION_CAP);
+    const snippet = str(raw.promptSnippet);
+    if (snippet)
+        payload.promptSnippet = cut(snippet, TOOL_DESCRIPTION_CAP);
+    if (Array.isArray(raw.promptGuidelines)) {
+        const guidelines = [];
+        let total = 0;
+        for (const g of raw.promptGuidelines) {
+            const text = str(g);
+            if (!text)
+                continue;
+            if (total + text.length > TOOL_GUIDELINES_CAP)
+                break;
+            guidelines.push(text);
+            total += text.length;
+        }
+        if (guidelines.length > 0)
+            payload.promptGuidelines = guidelines;
+    }
+    if (raw.parameters !== undefined && raw.parameters !== null) {
+        if (parametersWithinCap(raw.parameters))
+            payload.parameters = raw.parameters;
+        else
+            payload.parametersDropped = true;
+    }
+    if (raw.active === true)
+        payload.active = true;
+    else if (raw.active === false)
+        payload.active = false;
+    const info = raw.sourceInfo;
+    if (info && typeof info === "object") {
+        const source = str(info.source);
+        if (source)
+            payload.source = source;
+        const scope = str(info.scope);
+        if (scope)
+            payload.scope = scope;
+    }
+    return payload;
+}
+/** 当前引擎不支持枚举工具定义时的应答（前端据此显示「当前引擎不支持」而不是「未找到」）。 */
+export function unsupportedToolInfo(name) {
+    return { name: str(name) ?? "", found: false, unsupported: true };
+}

package/dist/server/tool-manager.js

@@ -61,9 +61,12 @@ export const SCHEDULE_CANCEL_TOOL_NAME = "schedule_cancel";
 /** 展示文件工具（定义见 present-files-tool.ts）：把图片/视频/文本作为预览卡片
  *  推到对话里，卡片带预览/本地打开/在文件夹中显示/下载/复制路径。 */
 export const PRESENT_FILES_TOOL_NAME = "present_files";
+/** 文件认领工具（定义见 claim-files-tool.ts）：声明要改哪些文件，让同项目的
+ *  并行对话绕行（纯建议，不拦编辑）。 */
+export const CLAIM_FILES_TOOL_NAME = "claim_files";
 /** 旧工具名（持久化迁移用；新代码一律用 MARKERS_LIST_TOOL_NAME）。 */
 export const LEGACY_MARKERS_LIST_TOOL_NAME = "markers_list";
-/** 可开关的 Agent 工具总目录（共 25 个；bash 本体与 SDK 内置 edit/read
+/** 可开关的 Agent 工具总目录（共 26 个；bash 本体与 SDK 内置 edit/read
  *  不进目录——关了 agent 就残了，不给关）。 */
 export const AGENT_TOOL_CATALOG = [
     ...TERMINAL_TOOL_NAMES.map((name) => ({
@@ -78,26 +81,116 @@ export const AGENT_TOOL_CATALOG = [
         defaultOn: true,
         dshVisible: false,
     })),
-    { name: EDIT_SOFT_TOOL_NAME, group: "other", defaultOn: false, dshVisible: false },
-    { 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 },
+    {
+        name: EDIT_SOFT_TOOL_NAME,
+        group: "other",
+        defaultOn: false,
+        dshVisible: false,
+        descKey: "editSoftEnabledDesc",
+        offHintKey: "editSoftOffHint",
+    },
+    {
+        name: DELEGATE_TASK_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "delegateTaskEnabledDesc",
+        offHintKey: "delegateTaskOffHint",
+    },
+    {
+        name: ASK_USER_QUESTION_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: true,
+        descKey: "questionnaireEnabledDesc",
+        offHintKey: "questionnaireOffHint",
+    },
     // 默认关（AI 动用户浏览器，opt-in 才开）且 dshVisible=false：DSH 引擎没有页面桥
     // （page_request 由 pi 引擎的 customTool 发出），列在那里只会让用户关一个不存在的工具。
-    { name: BROWSER_PAGE_TOOL_NAME, group: "other", defaultOn: false, dshVisible: false },
+    {
+        name: BROWSER_PAGE_TOOL_NAME,
+        group: "other",
+        defaultOn: false,
+        dshVisible: false,
+        descKey: "browserPageEnabledDesc",
+        offHintKey: "browserPageOffHint",
+    },
     // 只读别的对话（含子代理实时消息与历史转录），默认开；DSH 引擎没有该 customTool。
-    { name: CONVERSATION_READ_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
+    {
+        name: CONVERSATION_READ_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "conversationReadEnabledDesc",
+        offHintKey: "conversationReadOffHint",
+    },
+    // 文件认领（事前打招呼，纯 advisory）：默认开，不打开 AI 不知道能认领；
+    // 关掉只少一路提醒（事后触碰集照常工作）；DSH 引擎没有该 customTool
+    // （走 goal-rpc，无 customTool 注册面），提醒是服务端算的、DSH 照样能看到。
+    {
+        name: CLAIM_FILES_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "claimFilesEnabledDesc",
+        offHintKey: "claimFilesOffHint",
+    },
+    // 展示文件给用户（图片/视频内联、文本开预览弹窗、本地打开按钮）：默认开，
+    // 不打开模型根本不知道能“给用户看”；DSH 引擎没有该 customTool（走 shipped preset）。
+    {
+        name: PRESENT_FILES_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "presentFilesEnabledDesc",
+        offHintKey: "presentFilesOffHint",
+    },
     // 技能全文按名加载（名录仍在 {{skills}} 段），默认开；DSH 引擎没有该 customTool
     // （走 goal-rpc，无 customTool 注册面）。
-    { name: SKILL_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
+    {
+        name: SKILL_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "skillEnabledDesc",
+        offHintKey: "skillOffHint",
+    },
     // 定时/延时唤醒：默认开（不打开 AI 根本不知道能定时；60s 间隔底线＋面板可随时取消），
     // DSH 引擎没有该 customTool（走 goal-rpc，无 customTool 注册面）。
-    { name: SCHEDULE_TASK_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
-    { name: SCHEDULE_LIST_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
-    { name: SCHEDULE_CANCEL_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
-    // 展示文件给用户（图片/视频内联、文本开预览弹窗、本地打开按钮）：默认开，
-    // 不打开模型根本不知道能“给用户看”；DSH 引擎没有该 customTool（走 shipped preset）。
-    { name: PRESENT_FILES_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
+    {
+        name: SCHEDULE_TASK_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "scheduleTaskEnabledDesc",
+        offHintKey: "scheduleTaskOffHint",
+    },
+    {
+        name: SCHEDULE_LIST_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "scheduleTaskEnabledDesc",
+        offHintKey: "scheduleTaskOffHint",
+    },
+    {
+        name: SCHEDULE_CANCEL_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: false,
+        descKey: "scheduleTaskEnabledDesc",
+        offHintKey: "scheduleTaskOffHint",
+    },
+    // todo_list 唯一例外：行不在「其他」组，固定在上面的 markers 分区（设置页循环
+    // 跳过它，见 OTHER_AGENT_TOOLS；文案 key 照给，万一哪天搬家不用补）。
+    {
+        name: MARKERS_LIST_TOOL_NAME,
+        group: "other",
+        defaultOn: true,
+        dshVisible: true,
+        descKey: "todoListEnabledDesc",
+        offHintKey: "todoListOffHint",
+    },
 ];
 const KNOWN_NAMES = new Set(AGENT_TOOL_CATALOG.map((t) => t.name));
 /** 是否为本表登记的可开关工具（未知名一律 false，不抛错）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.92.0",
+	"version": "0.93.0",
 	"description": "Just open your browser to get all your work done — browser cockpit for AI coding agents (chat, code, files, terminal, Git in one tab)",
 	"license": "MIT",
 	"author": {
@@ -84,7 +84,7 @@
 	"dependencies": {
 		"@deepseek-ai/dsh-sdk-jsonrpc-server": "^0.1.1-rc.2",
 		"@deepseek-ai/dsh-sdk-protocol": "^0.1.1-rc.2",
-		"@earendil-works/pi-coding-agent": "^0.85.1",
+		"@earendil-works/pi-coding-agent": ">=0.85.1 <0.87.0",
 		"@xterm/addon-fit": "^0.11.0",
 		"@xterm/xterm": "^6.0.0",
 		"compression": "^1.8.2",

package/plugins/catalog.json

@@ -108,5 +108,15 @@
 		"descriptionEn": "Notes, todos and scheduled reminders in one place: a freely draggable always-on-top panel (position, size and settings all live in it, no separate view tab); reminders fire server-side (survive restarts, delivered on next open), with 5 AI tools and /note /todo /remind quick capture.",
 		"source": "xing-shuyin/pi-web-ui/plugins/notes",
 		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/notes"
+	},
+	{
+		"id": "pi-web-multigit",
+		"name": "multi-git",
+		"icon": "🌿",
+		"iconSvg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><circle cx=\"12\" cy=\"18\" r=\"3\"/><circle cx=\"6\" cy=\"6\" r=\"3\"/><circle cx=\"18\" cy=\"6\" r=\"3\"/><path d=\"M18 9v2c0 .6-.4 1-1 1H7c-.6 0-1-.4-1-1V9\"/><path d=\"M12 12v3\"/></svg>",
+		"description": "多仓库 Git 总览：工作区内每个仓库的变更、差异、历史、分支、贮藏、跨仓搜索与时间线，另有工作区分支聚合、Fetch/Pull 与内置终端（其余只读）。",
+		"descriptionEn": "Multi-repo Git overview: changes, diffs, history, branches, stashes, cross-repo search and a timeline for every repository in the workspace, plus a workspace-wide branch view, Fetch/Pull and an optional terminal.",
+		"source": "EinErste/pi-web-multigit",
+		"homepage": "https://github.com/EinErste/pi-web-multigit"
 	}
 ]

package/themes/ayu-light.css

@@ -0,0 +1,136 @@
+/* theme-name: 浅阑秋 */
+/* theme-name-en: Ayu Light */
+/* theme-group: classic */
+:root {
+	color-scheme: light;
+	--bg: #fcfcfc;
+	--bg-elev: #f8f9fa;
+	--bg-elev2: #f0f1f3;
+	--border: #e0e1e3;
+	--border-soft: #ecedef;
+	--text: #5c6166;
+	--text-dim: #66727f;
+	--text-faint: #6a7582;
+	--accent: #f29718;
+	--accent-soft: rgba(242, 151, 24, 0.14);
+	--green: #86b300;
+	--green-soft: rgba(134, 179, 0, 0.12);
+	--red: #f07171;
+	--red-soft: rgba(240, 113, 113, 0.1);
+	--amber: #e59645;
+	--blue: #3b82f6;
+	--blue-soft: rgba(59, 130, 246, 0.12);
+	--term-bg: #fcfcfc;
+	--term-fg: #5c6166;
+	--term-cursor: #f29718;
+	--term-cursor-accent: #fcfcfc;
+	--term-selection: rgba(242, 151, 24, 0.24);
+	--term-black: #5c6166;
+	--term-red: #f07171;
+	--term-green: #86b300;
+	--term-yellow: #eba400;
+	--term-blue: #22a4e6;
+	--term-magenta: #a37acc;
+	--term-cyan: #4cbf99;
+	--term-white: #f8f9fa;
+	--term-bright-black: #828e9f;
+	--term-bright-red: #f07171;
+	--term-bright-green: #86b300;
+	--term-bright-yellow: #eba400;
+	--term-bright-blue: #22a4e6;
+	--term-bright-magenta: #a37acc;
+	--term-bright-cyan: #4cbf99;
+	--term-bright-white: #ffffff;
+	--mono: "SF Mono", "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
+	--mermaid-font-size: 12px;
+	--tooltip-bg: #f8f9fa;
+	--code-bg: #f0f1f3;
+	--code-text: #5c6166;
+	--code-border: var(--border-soft);
+	--code-pad: 8px 10px;
+	--card-body-pad: 4px 14px 12px;
+	--err-text: #e55a5a;
+	--red-text: #e55a5a;
+	--amber-text: #c77e24;
+	--info-blue: #22a4e6;
+	--link: #22a4e6;
+	--link-hover: #1a8fc4;
+	--link-soft: #22a4e6;
+	--md-strong: #5c6166;
+	--skill-blue: #22a4e6;
+	--plugin-purple: #b58cff;
+	--auth-green: #18a97c;
+	--scroll-thumb: #d8dade;
+	--scroll-thumb-hover: #b9bcc2;
+	--notice-err-bg: #401d23;
+	--notice-warn-bg: #38251f;
+	--notice-info-bg: #1b2544;
+	--notice-err-border: #ef4444;
+	--notice-warn-border: #f59e0b;
+	--notice-info-border: #3b82f6;
+	--send-blue: #f29718;
+	--send-blue-hover: #e08a0d;
+	--stop-red: #ef4444;
+	--stop-red-hover: #dc2626;
+	--brand-grad-a: #f29718;
+	--brand-grad-b: #f07171;
+	--on-amber: #1a1a1a;
+	--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);
+	--glow-04: rgba(255, 255, 255, 0.04);
+	--glow-05: rgba(255, 255, 255, 0.05);
+	--glow-12: rgba(255, 255, 255, 0.12);
+	--glow-18: rgba(255, 255, 255, 0.18);
+	--glow-22: rgba(255, 255, 255, 0.22);
+	--glow-38: rgba(255, 255, 255, 0.38);
+	--control-fg: #6b7d8f;
+	--control-bg: #f0f1f3;
+	--control-border: #e0e1e3;
+	--bg-image: none;
+	--bg-image-dim: 0.78;
+	--bg-image-blur: 0px;
+	--wallpaper-panel-alpha: 100%;
+	--topbar-bg: #f8f9fa;
+	--statusbar-bg: #fcfcfc;
+	--panel-bg: #f8f9fa;
+	--card-bg: #f8f9fa;
+	--chip-bg: #f0f1f3;
+	--msgs-bg: #fcfcfc;
+	--inputbox-bg: #f0f1f3;
+	--menu-bg: var(--bg-elev2);
+}
+
+/* ---- syntax highlighting (Ayu Light) ---- */
+.hljs {
+	color: #5c6166;
+	background: #f0f1f3;
+}
+.hljs-keyword,
+.hljs-meta .hljs-keyword {
+	color: #fa8532;
+	font-weight: 600;
+}
+.hljs-title,
+.hljs-title.function_ {
+	color: #eba400;
+}
+.hljs-number,
+.hljs-literal {
+	color: #a37acc;
+}
+.hljs-string {
+	color: #86b300;
+}
+.hljs-built_in,
+.hljs-type {
+	color: #55b4d4;
+}
+.hljs-comment {
+	color: #6a7582;
+	font-style: italic;
+}

package/themes/catppuccin-latte.css

@@ -18,6 +18,8 @@
 	--red: #d20f39;
 	--red-soft: rgba(210, 15, 57, 0.1);
 	--amber: #df8e1d;
+	--blue: #3b82f6;
+	--blue-soft: rgba(59, 130, 246, 0.12);
 	--term-bg: #eff1f5;
 	--term-fg: #4c4f69;
 	--term-cursor: #dc8a78;
@@ -68,6 +70,8 @@
 	--notice-info-border: #3b82f6;
 	--send-blue: #1e66f5;
 	--send-blue-hover: #7287fd;
+	--stop-red: #ef4444;
+	--stop-red-hover: #dc2626;
 	--brand-grad-a: #1e66f5;
 	--brand-grad-b: #8839ef;
 	--on-amber: #1a1a1a;