pi-web-ui 0.62.0 → 0.63.0

package/dist/server/attachments.js

@@ -1,6 +1,6 @@
-import { countLines, decodeText, looksLikeText, sniffImageMime, } from "./text-sniff.js";
+import { countLines, decodeText, looksLikeText, sniffImageMime } from "./text-sniff.js";
 import { saveUpload, uploadsRoot } from "./uploads.js";
-import { buildVisionBridgePrompt, findVisionModels, transcribeImages, } from "./vision-bridge.js";
+import { buildVisionBridgePrompt, findVisionModels, transcribeImages } from "./vision-bridge.js";
 /** 跨快照的视觉转写缓存：批次 hash（名称 + base64 头 + 提示词）→ 转写文本。
  *  编辑重问重发相同图片不再重复耗视觉 token。进程级共享即可。 */
 const visionBridgeCache = new Map();
@@ -17,21 +17,13 @@ export async function buildAttachmentMessages(ctx, attachments) {
     if (!attachments || attachments.length === 0)
         return [];
     const fs = await import("node:fs/promises");
-    const { resolve, sep, relative, extname, join, basename } = await import("node:path");
+    const { resolve, sep, relative, extname, basename } = await import("node:path");
     const root = resolve(ctx.cwd);
     const MAX_ATTACHMENT_BYTES = 200 * 1024;
     // Files at or below this size are inlined; larger files are referenced by
     // path only (the model reads them on demand — saves tokens for small edits).
     const MAX_INLINE_BYTES = Number(process.env.PI_WEB_INLINE_FILE_MAX ?? 12 * 1024);
-    const IMAGE_EXT = new Set([
-        ".png",
-        ".jpg",
-        ".jpeg",
-        ".gif",
-        ".webp",
-        ".bmp",
-        ".svg",
-    ]);
+    const IMAGE_EXT = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp", ".svg"]);
     const MIME = {
         ".png": "image/png",
         ".jpg": "image/jpeg",
@@ -113,9 +105,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
     for (const [idx, att] of attachments.entries()) {
         if (att.imageData) {
             const raw = att.imageData.replace(/^data:[^;]*;base64,/, "");
-            const mimeType = att.mimeType?.startsWith("image/")
-                ? att.mimeType
-                : "image/png";
+            const mimeType = att.mimeType?.startsWith("image/") ? att.mimeType : "image/png";
             const bytes = Buffer.byteLength(raw, "base64");
             // Only images that would actually be sent (non-empty, under the cap).
             if (bytes > 0 && bytes <= 2 * 1024 * 1024) {
@@ -162,6 +152,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                 type: "notice",
                 level: "warning",
                 text: `当前模型（${mainModel?.name ?? mainModel?.id ?? "未知"}）不支持识图，且视觉桥已在设置中关闭：图片将原样发送、可能被忽略。`,
+                textEn: `Current model (${mainModel?.name ?? mainModel?.id ?? "unknown"}) cannot see images and the vision bridge is off in settings: images will be sent as-is and may be ignored.`,
             });
         }
         else {
@@ -188,6 +179,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                     type: "notice",
                     level: "warning",
                     text: `当前模型（${mainModel?.name ?? mainModel?.id ?? "未知"}）不支持识图，且未找到可用的视觉模型：图片将原样发送、可能被忽略。在模型配置里添加任意支持图片的模型（如 qwen-vl、GLM-4V、Gemini）即可自动启用视觉桥转写。`,
+                    textEn: `Current model (${mainModel?.name ?? mainModel?.id ?? "unknown"}) cannot see images and no vision model is available: images will be sent as-is and may be ignored. Add any vision-capable model (e.g. qwen-vl, GLM-4V, Gemini) in model settings to enable vision-bridge transcription.`,
                 });
             }
             else {
@@ -196,9 +188,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                 // The active transcription prompt is part of the key: changing
                 // the custom prompt must invalidate cached transcripts made with
                 // the old prompt.
-                const batchHash = bridgedImages
-                    .map((b) => `${b.att.name ?? "img"}:${b.raw.slice(0, 48)}`)
-                    .join("|") +
+                const batchHash = bridgedImages.map((b) => `${b.att.name ?? "img"}:${b.raw.slice(0, 48)}`).join("|") +
                     "::" +
                     buildVisionBridgePrompt(ctx.settings.visionBridgePromptMode, ctx.settings.visionBridgePrompt);
                 let transcript = visionBridgeCache.get(batchHash);
@@ -207,6 +197,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                         type: "notice",
                         level: "info",
                         text: `当前模型不支持识图，正在用视觉桥（${chosen.label}）转写 ${bridgedImages.length} 张图片…`,
+                        textEn: `Current model cannot see images; transcribing ${bridgedImages.length} image(s) via the vision bridge (${chosen.label})…`,
                     });
                     try {
                         const chosenModel = ctx.session.modelRuntime.getModel(chosen.provider, chosen.id);
@@ -223,6 +214,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                             type: "notice",
                             level: "info",
                             text: `✅ 图片已由视觉桥转写完成（${chosen.label}）`,
+                            textEn: `✅ Images transcribed by the vision bridge (${chosen.label})`,
                         });
                     }
                     catch (err) {
@@ -231,6 +223,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                             type: "notice",
                             level: "error",
                             text: `图片转写失败（${chosen.label}）：${err.message}。图片将原样发送、可能被忽略。`,
+                            textEn: `Image transcription failed (${chosen.label}): ${err.message}. Images will be sent as-is and may be ignored.`,
                         });
                     }
                 }
@@ -254,6 +247,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                     type: "notice",
                     level: "error",
                     text: `图片数据为空，已跳过`,
+                    textEn: `Image data is empty, skipped`,
                 });
                 continue;
             }
@@ -262,6 +256,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                     type: "notice",
                     level: "warning",
                     text: `图片过大已跳过（>2MB）：${att.name ?? "粘贴图片"}`,
+                    textEn: `Image too large, skipped (>2MB): ${att.name ?? "pasted image"}`,
                 });
                 continue;
             }
@@ -321,6 +316,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                     type: "notice",
                     level: "error",
                     text: `文件数据为空，已跳过`,
+                    textEn: `File data is empty, skipped`,
                 });
                 continue;
             }
@@ -329,6 +325,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                     type: "notice",
                     level: "warning",
                     text: `文件过大已跳过（>20MB）：${att.name ?? "上传文件"}`,
+                    textEn: `File too large, skipped (>20MB): ${att.name ?? "uploaded file"}`,
                 });
                 continue;
             }
@@ -356,13 +353,13 @@ export async function buildAttachmentMessages(ctx, attachments) {
             const relToRoot = relative(rootDir, abs);
             const inClientDir = !relToRoot.startsWith("..") &&
                 !relToRoot.includes(`${sep}..`) &&
-                (relToRoot === ctx.clientId ||
-                    relToRoot.startsWith(`${ctx.clientId}${sep}`));
+                (relToRoot === ctx.clientId || relToRoot.startsWith(`${ctx.clientId}${sep}`));
             if (!inClientDir) {
                 ctx.emit({
                     type: "notice",
                     level: "warning",
                     text: `无法恢复已上传文件（路径不在本客户端上传目录）：${att.name ?? att.uploadPath}`,
+                    textEn: `Cannot restore uploaded file (outside this client upload dir): ${att.name ?? att.uploadPath}`,
                 });
                 continue;
             }
@@ -375,6 +372,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                     type: "notice",
                     level: "warning",
                     text: `无法恢复已上传文件（已被清理或不可读）：${att.name ?? att.uploadPath}`,
+                    textEn: `Cannot restore uploaded file (cleaned up or unreadable): ${att.name ?? att.uploadPath}`,
                 });
                 continue;
             }
@@ -390,6 +388,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                 type: "notice",
                 level: "warning",
                 text: `附件路径超出工作区：${att.path}`,
+                textEn: `Attachment path is outside the workspace: ${att.path}`,
             });
             continue;
         }
@@ -405,6 +404,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                 type: "notice",
                 level: "error",
                 text: `附件不存在：${att.path}`,
+                textEn: `Attachment does not exist: ${att.path}`,
             });
             continue;
         }
@@ -432,6 +432,7 @@ export async function buildAttachmentMessages(ctx, attachments) {
                 type: "notice",
                 level: "warning",
                 text: `跳过非文件附件：${att.path}`,
+                textEn: `Skipped non-file attachment: ${att.path}`,
             });
             continue;
         }
@@ -448,17 +449,19 @@ export async function buildAttachmentMessages(ctx, attachments) {
                         content: [
                             {
                                 type: "text",
-                                text: `
-<vision-bridge>
-${transcript}
+                                text: `
+<vision-bridge>
+${transcript}
 </vision-bridge>`,
                             },
                             ...(pathImg
-                                ? ([{
+                                ? [
+                                    {
                                         type: "image",
                                         data: pathImg.raw,
                                         mimeType: pathImg.mimeType,
-                                    }])
+                                    },
+                                ]
                                 : []),
                         ],
                         display: true,
@@ -498,6 +501,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `图片附件过大已跳过（>200KB）：${att.path}`,
+                    textEn: `Image attachment too large, skipped (>200KB): ${att.path}`,
                 });
                 continue;
             }
@@ -505,9 +509,7 @@ ${transcript}
             out.push({
                 message: {
                     customType: "file",
-                    content: [
-                        { type: "image", data, mimeType: MIME[ext] ?? "image/png" },
-                    ],
+                    content: [{ type: "image", data, mimeType: MIME[ext] ?? "image/png" }],
                     display: true,
                     details: { name, path: rel, mode: "image", size: stat.size },
                 },
@@ -564,6 +566,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `行范围无效，已改为仅引用：${att.path}`,
+                    textEn: `Invalid line range, switched to reference-only: ${att.path}`,
                 });
                 out.push(makeReference());
                 continue;
@@ -573,6 +576,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `文件过大，已改为仅引用：${att.path}`,
+                    textEn: `File too large, switched to reference-only: ${att.path}`,
                 });
                 out.push(makeReference());
                 continue;
@@ -583,6 +587,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `二进制文件已改为仅引用：${att.path}`,
+                    textEn: `Binary file, switched to reference-only: ${att.path}`,
                 });
                 out.push(makeReference());
                 continue;
@@ -599,6 +604,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `选中行超出文件范围，已改为仅引用：${att.path}`,
+                    textEn: `Selected lines out of range, switched to reference-only: ${att.path}`,
                 });
                 out.push(makeReference());
                 continue;
@@ -634,6 +640,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `文件过大，已改为仅引用：${att.path}`,
+                    textEn: `File too large, switched to reference-only: ${att.path}`,
                 });
                 out.push(makeReference());
                 continue;
@@ -644,6 +651,7 @@ ${transcript}
                     type: "notice",
                     level: "warning",
                     text: `二进制文件已改为仅引用：${att.path}`,
+                    textEn: `Binary file, switched to reference-only: ${att.path}`,
                 });
                 out.push(makeReference());
                 continue;
@@ -662,6 +670,7 @@ ${transcript}
                 type: "notice",
                 level: "warning",
                 text: `二进制文件已跳过（仅引用路径）：${att.path}`,
+                textEn: `Binary file skipped (path referenced only): ${att.path}`,
             });
             out.push(makeReference());
             continue;

package/dist/server/bg-servers.js

@@ -1,4 +1,4 @@
-import { killPidTree, lookupProcessName, lookupProcessCommandLine, snapshotListeningPorts, } from "./process-utils.js";
+import { killPidTree, lookupProcessName, lookupProcessCommandLine, snapshotListeningPorts } from "./process-utils.js";
 const BG_REFRESH_INTERVAL_MS = 30_000;
 /** bash 结束后等这么久再拍「后」快照——给后台服务绑定端口的时间。 */
 const BG_BIND_WAIT_MS = 1500;
@@ -63,6 +63,7 @@ export class BgServerTracker {
                     type: "notice",
                     level: "info",
                     text: `检测到 AI 启动的后台服务：端口 ${port}（pid ${pid}）——可在顶栏「后台任务」里单独停止或全部关闭`,
+                    textEn: `Detected an AI-started background service: port ${port} (pid ${pid}) — stop it individually or all at once under Background tasks in the top bar`,
                 });
             }
         }
@@ -97,6 +98,7 @@ export class BgServerTracker {
             return;
         const now = await snapshotListeningPorts();
         let changed = false;
+        // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
         for (const [port, v] of [...this.servers]) {
             if (now.get(port) !== v.pid) {
                 this.servers.delete(port);
@@ -119,6 +121,7 @@ export class BgServerTracker {
                 type: "notice",
                 level: "info",
                 text: `端口 ${port} 不在后台任务列表中`,
+                textEn: `Port ${port} is not in the background task list`,
             });
             this.opts.flushSnapshot();
             return false;
@@ -130,6 +133,7 @@ export class BgServerTracker {
             type: "notice",
             level: "info",
             text: `已停止后台任务：端口 ${port}（pid ${entry.pid}）`,
+            textEn: `Stopped background task: port ${port} (pid ${entry.pid})`,
         });
         this.opts.flushSnapshot();
         return true;
@@ -139,6 +143,7 @@ export class BgServerTracker {
         if (this.servers.size === 0)
             return [];
         const killed = [];
+        // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
         for (const [port, { pid }] of [...this.servers]) {
             killPidTree(pid);
             killed.push(String(port));

package/dist/server/client-state.js

@@ -46,6 +46,15 @@ export function isExtensionDisabled(e, disabled) {
     const keys = extensionKeyCandidates(e);
     return disabled.some((d) => keys.includes(d));
 }
+/** Whether an extension is covered by an ENABLED whitelist (any identity
+ *  match). Empty whitelist = not whitelisting = everything allowed. Used by
+ *  subagent templates（白名单语义：模板勾选 = 子代理只加载这些扩展）。 */
+export function isExtensionEnabled(e, enabled) {
+    if (enabled.length === 0)
+        return true;
+    const keys = extensionKeyCandidates(e);
+    return enabled.some((d) => keys.includes(d));
+}
 /**
  * Persists which workspace each browser client last used + which workspaces it
  * has opened, so a server restart / page reload restores the same project and
@@ -58,6 +67,10 @@ export class ClientStateStore {
     constructor(filePath) {
         this.filePath = filePath;
     }
+    /** <dataDir>（client-state.json 的上一级）——共享配置（子代理模板库等）落在这里。 */
+    get dataDir() {
+        return dirname(this.filePath);
+    }
     load() {
         if (this.cache)
             return this.cache;
@@ -93,10 +106,7 @@ export class ClientStateStore {
         const state = (all[clientId] ??= { projects: [] });
         state.lastCwd = cwd;
         const now = Date.now();
-        state.projects = [
-            { path: cwd, lastUsed: now },
-            ...state.projects.filter((p) => p.path !== cwd),
-        ].slice(0, 30);
+        state.projects = [{ path: cwd, lastUsed: now }, ...state.projects.filter((p) => p.path !== cwd)].slice(0, 30);
         // Opening the workspace again clears its removal tombstone.
         if (state.removedProjects?.length) {
             state.removedProjects = state.removedProjects.filter((p) => p !== cwd);
@@ -205,9 +215,7 @@ export class ClientStateStore {
             toolsWrap: settings.toolsWrap ?? cur.toolsWrap ?? true,
             visionBridgeEnabled: settings.visionBridgeEnabled ?? cur.visionBridgeEnabled ?? true,
             visionBridgeModel: settings.visionBridgeModel ?? cur.visionBridgeModel ?? null,
-            visionBridgePromptMode: settings.visionBridgePromptMode ??
-                cur.visionBridgePromptMode ??
-                "append",
+            visionBridgePromptMode: settings.visionBridgePromptMode ?? cur.visionBridgePromptMode ?? "append",
             visionBridgePrompt: settings.visionBridgePrompt ?? cur.visionBridgePrompt ?? "",
             reviewPrompt: settings.reviewPrompt ?? cur.reviewPrompt ?? "",
             reviewDisabledSkills: settings.reviewDisabledSkills ?? cur.reviewDisabledSkills ?? [],

package/dist/server/control-socket.js

@@ -25,16 +25,13 @@ const CONTROL_IDLE_TIMEOUT_MS = 5_000;
 const CONTROL_CLIENT_TIMEOUT_MS = 3_000;
 /** Socket path (POSIX) or pipe name (Windows). */
 export function controlPath(dataDir, port) {
-    return process.platform === "win32"
-        ? `\\\\.\\pipe\\pi-web-ui-${port}`
-        : join(dataDir, "pi-web-ui.sock");
+    return process.platform === "win32" ? `\\\\.\\pipe\\pi-web-ui-${port}` : join(dataDir, "pi-web-ui.sock");
 }
 /** Start the control socket; returns a stop function. */
 export function startControlServer(opts) {
     const { service, dataDir, port } = opts;
     const path = controlPath(dataDir, port);
     let server;
-    let stop = false;
     if (process.platform === "win32") {
         server = createServer(handleConnection);
     }
@@ -126,7 +123,6 @@ export function startControlServer(opts) {
         });
     }
     return () => {
-        stop = true;
         server.close();
         try {
             if (process.platform !== "win32" && existsSync(path))