pi-web-ui 0.62.0 → 0.63.0

package/dist/server/model-admin.js

@@ -11,8 +11,8 @@
  * 经 ModelAdminHost 与 ClientSession 解耦（同 settings/goal/slash 服务模式）。
  * UI 文案直接中文（服务端 notice 约定）。apiKey/headers 绝不下发浏览器。
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 /** Strip // and /* *\/ comments without touching string literals (URLs contain //). */
 function stripJsonComments(src) {
     let out = "";
@@ -64,9 +64,7 @@ function boolMeta(v) {
     return typeof v === "boolean" ? v : undefined;
 }
 function strArrMeta(v) {
-    return Array.isArray(v)
-        ? v.filter((x) => typeof x === "string")
-        : undefined;
+    return Array.isArray(v) ? v.filter((x) => typeof x === "string") : undefined;
 }
 /** Best-effort extraction of model metadata from an OpenAI-compatible
  *  /models `data[]` item. Most endpoints only return `{ id }` — the extra
@@ -77,11 +75,8 @@ function parseOpenAiModel(m) {
     const r = (m ?? {});
     const id = typeof r.id === "string" ? r.id : "";
     const name = (typeof r.name === "string" && r.name.trim() ? r.name : undefined) ??
-        (typeof r.display_name === "string" && r.display_name.trim()
-            ? r.display_name
-            : undefined);
-    const modalities = strArrMeta(r.modalities) ??
-        strArrMeta(r.input_modalities);
+        (typeof r.display_name === "string" && r.display_name.trim() ? r.display_name : undefined);
+    const modalities = strArrMeta(r.modalities) ?? strArrMeta(r.input_modalities);
     const vision = modalities?.includes("image") === true ||
         boolMeta(r.supports_vision) === true ||
         boolMeta(r.vision) === true ||
@@ -89,13 +84,8 @@ function parseOpenAiModel(m) {
     const reasoning = boolMeta(r.reasoning) === true ||
         boolMeta(r.supports_reasoning) === true ||
         modalities?.includes("reasoning") === true;
-    const contextWindow = numMeta(r.context_window) ??
-        numMeta(r.context_length) ??
-        numMeta(r.max_model_len) ??
-        numMeta(r.max_context_length);
-    const maxTokens = numMeta(r.max_tokens) ??
-        numMeta(r.max_output_tokens) ??
-        numMeta(r.max_completion_tokens);
+    const contextWindow = numMeta(r.context_window) ?? numMeta(r.context_length) ?? numMeta(r.max_model_len) ?? numMeta(r.max_context_length);
+    const maxTokens = numMeta(r.max_tokens) ?? numMeta(r.max_output_tokens) ?? numMeta(r.max_completion_tokens);
     return {
         id,
         ...(name ? { name } : {}),
@@ -116,12 +106,8 @@ function parseGoogleModel(m) {
     return {
         id,
         ...(displayName && displayName !== id ? { name: displayName } : {}),
-        ...(numMeta(r.inputTokenLimit)
-            ? { contextWindow: numMeta(r.inputTokenLimit) }
-            : {}),
-        ...(numMeta(r.outputTokenLimit)
-            ? { maxTokens: numMeta(r.outputTokenLimit) }
-            : {}),
+        ...(numMeta(r.inputTokenLimit) ? { contextWindow: numMeta(r.inputTokenLimit) } : {}),
+        ...(numMeta(r.outputTokenLimit) ? { maxTokens: numMeta(r.outputTokenLimit) } : {}),
     };
 }
 export class ModelAdminService {
@@ -146,14 +132,10 @@ export class ModelAdminService {
             const parsed = JSON.parse(readFileSync(this.providerKeysPath(), "utf8"));
             const out = {};
             for (const [pid, entry] of Object.entries(parsed)) {
-                const keys = Array.isArray(entry?.keys)
-                    ? entry.keys.filter((k) => k?.name && k?.apiKey)
-                    : [];
+                const keys = Array.isArray(entry?.keys) ? entry.keys.filter((k) => k?.name && k?.apiKey) : [];
                 if (!pid || keys.length === 0)
                     continue;
-                const activeKeyName = entry.activeKeyName && keys.some((k) => k.name === entry.activeKeyName)
-                    ? entry.activeKeyName
-                    : keys[0].name;
+                const activeKeyName = entry.activeKeyName && keys.some((k) => k.name === entry.activeKeyName) ? entry.activeKeyName : keys[0].name;
                 out[pid] = { activeKeyName, keys };
             }
             return out;
@@ -267,11 +249,11 @@ export class ModelAdminService {
         const pid = provider.trim();
         const key = apiKey.trim();
         if (!pid) {
-            this.host.emit({ type: "notice", level: "error", text: "请填写服务商 ID" });
+            this.host.emit({ type: "notice", level: "error", text: "请填写服务商 ID", textEn: "Enter a provider ID" });
             return;
         }
         if (!key) {
-            this.host.emit({ type: "notice", level: "error", text: "请填写 API 密钥" });
+            this.host.emit({ type: "notice", level: "error", text: "请填写 API 密钥", textEn: "Enter an API key" });
             return;
         }
         try {
@@ -301,6 +283,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "info",
                 text: `✅ 已保存 ${pid} 的密钥「${name}」并刷新模型列表`,
+                textEn: `✅ Saved key "${name}" for ${pid} and refreshed the model list`,
             });
             await this.host.pushModels();
             await this.listProviders();
@@ -311,6 +294,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `保存 API 密钥失败：${err.message}`,
+                textEn: `Failed to save API key: ${err.message}`,
             });
         }
         this.host.flushSnapshot();
@@ -323,11 +307,11 @@ export class ModelAdminService {
         const pid = provider.trim();
         const key = apiKey.trim();
         if (!pid) {
-            this.host.emit({ type: "notice", level: "error", text: "请填写服务商 ID" });
+            this.host.emit({ type: "notice", level: "error", text: "请填写服务商 ID", textEn: "Enter a provider ID" });
             return;
         }
         if (!key) {
-            this.host.emit({ type: "notice", level: "error", text: "请填写 API 密钥" });
+            this.host.emit({ type: "notice", level: "error", text: "请填写 API 密钥", textEn: "Enter an API key" });
             return;
         }
         try {
@@ -345,6 +329,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "info",
                     text: `${pid} 已存在该密钥`,
+                    textEn: `${pid} already has this key`,
                 });
                 return;
             }
@@ -361,6 +346,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "info",
                     text: `🔑 已添加 ${pid} 的密钥「${keyName}」并设为当前`,
+                    textEn: `🔑 Added key "${keyName}" for ${pid} and set it active`,
                 });
             }
             else {
@@ -368,6 +354,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "info",
                     text: `🔑 已添加 ${pid} 的密钥「${keyName}」，点击模型时可切换使用`,
+                    textEn: `🔑 Added key "${keyName}" for ${pid}; click a model to switch to it`,
                 });
             }
             await this.host.pushModels();
@@ -379,6 +366,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `添加密钥失败：${err.message}`,
+                textEn: `Failed to add key: ${err.message}`,
             });
         }
         this.host.flushSnapshot();
@@ -393,11 +381,21 @@ export class ModelAdminService {
             const entry = data[pid];
             const target = entry?.keys.find((k) => k.name === targetName);
             if (!target) {
-                this.host.emit({ type: "notice", level: "error", text: `${pid} 的密钥「${targetName}」不存在` });
+                this.host.emit({
+                    type: "notice",
+                    level: "error",
+                    text: `${pid} 的密钥「${targetName}」不存在`,
+                    textEn: `Key "${targetName}" for ${pid} does not exist`,
+                });
                 return;
             }
             if (entry.activeKeyName === targetName) {
-                this.host.emit({ type: "notice", level: "info", text: `「${targetName}」已是当前密钥` });
+                this.host.emit({
+                    type: "notice",
+                    level: "info",
+                    text: `「${targetName}」已是当前密钥`,
+                    textEn: `"${targetName}" is already the active key`,
+                });
                 return;
             }
             entry.activeKeyName = targetName;
@@ -407,6 +405,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "info",
                 text: `⚡ 已切换到 ${pid} 的「${targetName}」`,
+                textEn: `⚡ Switched to "${targetName}" for ${pid}`,
             });
             await this.host.pushModels();
             await this.listProviders();
@@ -417,6 +416,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `切换密钥失败：${err.message}`,
+                textEn: `Failed to switch key: ${err.message}`,
             });
         }
         this.host.flushSnapshot();
@@ -430,7 +430,12 @@ export class ModelAdminService {
             const data = this.readProviderKeys();
             const entry = data[pid];
             if (!entry || !entry.keys.some((k) => k.name === targetName)) {
-                this.host.emit({ type: "notice", level: "error", text: `${pid} 的密钥「${targetName}」不存在` });
+                this.host.emit({
+                    type: "notice",
+                    level: "error",
+                    text: `${pid} 的密钥「${targetName}」不存在`,
+                    textEn: `Key "${targetName}" for ${pid} does not exist`,
+                });
                 return;
             }
             const wasActive = entry.activeKeyName === targetName;
@@ -458,6 +463,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "info",
                     text: `🗑  已移除 ${pid} 的密钥「${targetName}」，该服务商回到未配置状态`,
+                    textEn: `🗑  Removed key "${targetName}" for ${pid}; provider is now unconfigured`,
                 });
             }
             else {
@@ -475,6 +481,9 @@ export class ModelAdminService {
                     text: wasActive
                         ? `🗑  已移除「${targetName}」，已切换到 ${entry.keys[0].name}`
                         : `🗑  已移除 ${pid} 的密钥「${targetName}」`,
+                    textEn: wasActive
+                        ? `🗑  Removed "${targetName}", switched to ${entry.keys[0].name}`
+                        : `🗑  Removed key "${targetName}" for ${pid}`,
                 });
             }
             await this.host.pushModels();
@@ -486,6 +495,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `移除密钥失败：${err.message}`,
+                textEn: `Failed to remove key: ${err.message}`,
             });
         }
         this.host.flushSnapshot();
@@ -500,7 +510,7 @@ export class ModelAdminService {
     async clearProviderApiKey(provider) {
         const pid = provider.trim();
         if (!pid) {
-            this.host.emit({ type: "notice", level: "error", text: "请填写服务商 ID" });
+            this.host.emit({ type: "notice", level: "error", text: "请填写服务商 ID", textEn: "Enter a provider ID" });
             return;
         }
         try {
@@ -520,6 +530,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "info",
                     text: `${pid} 没有已保存的密钥`,
+                    textEn: `${pid} has no saved key`,
                 });
                 return;
             }
@@ -538,6 +549,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "info",
                 text: `🗑  已清除 ${pid} 的密钥，该服务商回到未配置状态`,
+                textEn: `🗑  Cleared keys for ${pid}; provider is now unconfigured`,
             });
             await this.host.pushModels();
             await this.listProviders();
@@ -548,6 +560,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `清除密钥失败：${err.message}`,
+                textEn: `Failed to clear key: ${err.message}`,
             });
         }
         this.host.flushSnapshot();
@@ -588,9 +601,7 @@ export class ModelAdminService {
                             id: m.id,
                             ...(m.name && m.name !== m.id ? { name: m.name } : {}),
                             ...(m.reasoning ? { reasoning: true } : {}),
-                            ...(m.input?.includes("image")
-                                ? { input: ["text", "image"] }
-                                : {}),
+                            ...(m.input?.includes("image") ? { input: ["text", "image"] } : {}),
                             ...(m.contextWindow ? { contextWindow: m.contextWindow } : {}),
                             ...(m.maxTokens ? { maxTokens: m.maxTokens } : {}),
                         },
@@ -623,10 +634,7 @@ export class ModelAdminService {
                 if (!keptMap.has(m.entry.id))
                     keptMap.set(m.entry.id, m.entry);
             const kept = [...keptMap.values()].sort((a, b) => a.id.localeCompare(b.id));
-            const taken = new Set([
-                ...Object.keys(this.readModelsConfig().providers),
-                ...mr.getRegisteredProviderIds(),
-            ]);
+            const taken = new Set([...Object.keys(this.readModelsConfig().providers), ...mr.getRegisteredProviderIds()]);
             let newId = `${pid}-2`;
             for (let n = 2; taken.has(newId); n++)
                 newId = `${pid}-${n}`;
@@ -678,6 +686,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `获取服务商列表失败：${err.message}`,
+                textEn: `Failed to fetch provider list: ${err.message}`,
             });
             return;
         }
@@ -686,6 +695,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "warning",
                 text: "服务商列表为空——pi 运行时未注册任何提供商",
+                textEn: "Provider list is empty — the pi runtime registered no providers",
             });
         }
         this.host.emit({ type: "providers_status", providers });
@@ -787,9 +797,7 @@ export class ModelAdminService {
         return typeof v === "boolean" ? v : undefined;
     }
     static strArrMeta(v) {
-        return Array.isArray(v)
-            ? v.filter((x) => typeof x === "string")
-            : undefined;
+        return Array.isArray(v) ? v.filter((x) => typeof x === "string") : undefined;
     }
     /** Best-effort extraction of model metadata from an OpenAI-compatible
      *  /models `data[]` item. Most endpoints only return `{ id }` — the extra
@@ -800,11 +808,8 @@ export class ModelAdminService {
         const r = (m ?? {});
         const id = typeof r.id === "string" ? r.id : "";
         const name = (typeof r.name === "string" && r.name.trim() ? r.name : undefined) ??
-            (typeof r.display_name === "string" && r.display_name.trim()
-                ? r.display_name
-                : undefined);
-        const modalities = strArrMeta(r.modalities) ??
-            strArrMeta(r.input_modalities);
+            (typeof r.display_name === "string" && r.display_name.trim() ? r.display_name : undefined);
+        const modalities = strArrMeta(r.modalities) ?? strArrMeta(r.input_modalities);
         const vision = modalities?.includes("image") === true ||
             boolMeta(r.supports_vision) === true ||
             boolMeta(r.vision) === true ||
@@ -816,9 +821,7 @@ export class ModelAdminService {
             numMeta(r.context_length) ??
             numMeta(r.max_model_len) ??
             numMeta(r.max_context_length);
-        const maxTokens = numMeta(r.max_tokens) ??
-            numMeta(r.max_output_tokens) ??
-            numMeta(r.max_completion_tokens);
+        const maxTokens = numMeta(r.max_tokens) ?? numMeta(r.max_output_tokens) ?? numMeta(r.max_completion_tokens);
         return {
             id,
             ...(name ? { name } : {}),
@@ -839,12 +842,8 @@ export class ModelAdminService {
         return {
             id,
             ...(displayName && displayName !== id ? { name: displayName } : {}),
-            ...(numMeta(r.inputTokenLimit)
-                ? { contextWindow: numMeta(r.inputTokenLimit) }
-                : {}),
-            ...(numMeta(r.outputTokenLimit)
-                ? { maxTokens: numMeta(r.outputTokenLimit) }
-                : {}),
+            ...(numMeta(r.inputTokenLimit) ? { contextWindow: numMeta(r.inputTokenLimit) } : {}),
+            ...(numMeta(r.outputTokenLimit) ? { maxTokens: numMeta(r.outputTokenLimit) } : {}),
         };
     }
     /** Probe a custom provider's OpenAI-compatible /models endpoint (server-side
@@ -882,7 +881,7 @@ export class ModelAdminService {
             throw new Error("baseUrl 仅支持 http/https");
         }
         const headers = {
-            ...(extraHeaders ?? {}),
+            ...extraHeaders,
         };
         // Per-api auth conventions (mirror pi's built-in provider configs):
         //   openai-*:      Authorization: Bearer <key>
@@ -942,15 +941,11 @@ export class ModelAdminService {
             const data = Array.isArray(json.data) ? json.data : null;
             if (data) {
                 // OpenAI-compatible: { data: [{ id, context_window, modalities, … }] }
-                models = data
-                    .map((m) => parseOpenAiModel(m))
-                    .filter((m) => m.id);
+                models = data.map((m) => parseOpenAiModel(m)).filter((m) => m.id);
             }
             else if (Array.isArray(json.models)) {
                 // Google: { models: [{ name: "models/…", displayName, … }] }
-                models = json.models
-                    .map((m) => parseGoogleModel(m))
-                    .filter((m) => m.id);
+                models = json.models.map((m) => parseGoogleModel(m)).filter((m) => m.id);
             }
         }
         catch {
@@ -984,6 +979,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "warning",
                     text: `服务商 ${pid} 不存在或未配置 baseUrl，无法刷新`,
+                    textEn: `Provider ${pid} does not exist or has no baseUrl; cannot refresh`,
                 });
                 return done(false, { error: "provider missing or no baseUrl" });
             }
@@ -1027,6 +1023,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `刷新模型列表失败：${err.message}`,
+                textEn: `Failed to refresh model list: ${err.message}`,
             });
             return done(false, { error: err.message });
         }
@@ -1039,6 +1036,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: "服务商 ID 无效（仅字母/数字/._-）",
+                textEn: "Invalid provider ID (letters/digits/._- only)",
             });
             return;
         }
@@ -1053,7 +1051,12 @@ export class ModelAdminService {
             ...(m.maxTokens ? { maxTokens: Number(m.maxTokens) } : {}),
         }));
         if (models.length === 0) {
-            this.host.emit({ type: "notice", level: "error", text: "至少需要一个模型" });
+            this.host.emit({
+                type: "notice",
+                level: "error",
+                text: "至少需要一个模型",
+                textEn: "At least one model is required",
+            });
             return;
         }
         try {
@@ -1067,9 +1070,7 @@ export class ModelAdminService {
                 ...(config.baseUrl?.trim() ? { baseUrl: config.baseUrl.trim() } : {}),
                 ...(config.apiKey?.trim() ? { apiKey: config.apiKey.trim() } : {}),
                 ...(config.authHeader ? { authHeader: true } : {}),
-                ...(prevHeaders && Object.keys(prevHeaders).length > 0
-                    ? { headers: prevHeaders }
-                    : {}),
+                ...(prevHeaders && Object.keys(prevHeaders).length > 0 ? { headers: prevHeaders } : {}),
                 models,
             };
             mkdirSync(this.host.agentDir, { recursive: true });
@@ -1101,6 +1102,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "info",
                 text: `✅ 已保存服务商 ${pid}（${models.length} 个模型）并刷新模型列表`,
+                textEn: `✅ Saved provider ${pid} (${models.length} models) and refreshed the model list`,
             });
         }
         catch (err) {
@@ -1108,6 +1110,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `保存模型配置失败：${err.message}`,
+                textEn: `Failed to save model config: ${err.message}`,
             });
         }
         this.host.flushSnapshot();
@@ -1121,6 +1124,7 @@ export class ModelAdminService {
                     type: "notice",
                     level: "info",
                     text: `服务商 ${providerId} 不存在`,
+                    textEn: `Provider ${providerId} does not exist`,
                 });
                 return;
             }
@@ -1134,6 +1138,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "info",
                 text: `🗑  已删除服务商 ${providerId}`,
+                textEn: `🗑  Deleted provider ${providerId}`,
             });
         }
         catch (err) {
@@ -1141,6 +1146,7 @@ export class ModelAdminService {
                 type: "notice",
                 level: "error",
                 text: `删除模型配置失败：${err.message}`,
+                textEn: `Failed to delete model config: ${err.message}`,
             });
         }
         this.host.flushSnapshot();

package/dist/server/plugin-facilities.js

@@ -17,7 +17,7 @@
  */
 import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
 import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { readFile as fspReadFile, readdir as fspReaddir, rm as fspRm, mkdir as fspMkdir, writeFile as fspWriteFile } from "node:fs/promises";
+import { readFile as fspReadFile, readdir as fspReaddir, rm as fspRm, mkdir as fspMkdir, writeFile as fspWriteFile, } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { createRequire } from "node:module";
 import { spawnSync } from "node:child_process";
@@ -136,9 +136,7 @@ export class PluginSecrets {
         try {
             const parsed = JSON.parse(readFileSync(this.file, "utf8"));
             this.store =
-                parsed && parsed.v === 1 && parsed.items && typeof parsed.items === "object"
-                    ? parsed
-                    : { v: 1, items: {} };
+                parsed && parsed.v === 1 && parsed.items && typeof parsed.items === "object" ? parsed : { v: 1, items: {} };
         }
         catch {
             this.store = { v: 1, items: {} };

package/dist/server/plugin-updater.js

@@ -146,7 +146,7 @@ export async function resolveRemoteSha(spec, exec = execGit) {
     if (!res.ok)
         return null;
     // 行格式: <sha>\tHEAD（可能多行——取第一行）
-    const sha = (res.stdout.match(/^([0-9a-f]{40,64})\s+HEAD/m)?.[1]) ?? null;
+    const sha = res.stdout.match(/^([0-9a-f]{40,64})\s+HEAD/m)?.[1] ?? null;
     return sha ? sha.slice(0, 12) : null;
 }
 /** 扫描全部已装插件，对比本地 sha 与远端 sha，报告更新状态。 */

package/dist/server/plugins.js

@@ -56,9 +56,7 @@ function parseSettingsSchema(raw) {
             ...(o.default !== undefined ? { default: o.default } : {}),
             ...(typeof o.min === "number" ? { min: o.min } : {}),
             ...(typeof o.max === "number" ? { max: o.max } : {}),
-            ...(Array.isArray(o.options)
-                ? { options: o.options.filter((x) => typeof x === "string") }
-                : {}),
+            ...(Array.isArray(o.options) ? { options: o.options.filter((x) => typeof x === "string") } : {}),
             ...(typeof o.hint === "string" ? { hint: o.hint } : {}),
         };
         out.push(field);
@@ -369,7 +367,7 @@ export class PluginManager {
     }
     /** 服务端热重载：反激活全部 → 清缓存 → 重扫重激活 → epoch+1。
      *  返回新目录清单（含激活结果）。重激活后的插件实例是新模块，
-         *  内存状态为初始值——逐个客户端触发 onAttach 让它们重推自身状态。 */
+     *  内存状态为初始值——逐个客户端触发 onAttach 让它们重推自身状态。 */
     async reload() {
         this.dispose();
         this.attempted.clear();
@@ -524,6 +522,7 @@ export class PluginManager {
             await this.activate(info);
         }
         // 已被删除的插件：调用 deactivate 并移出缓存
+        // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
         for (const [id, p] of [...this.loaded]) {
             if (!found.some((f) => f.id === id)) {
                 this.deactivateEntry(id, p);
@@ -539,6 +538,7 @@ export class PluginManager {
         catch (err) {
             console.error(`[plugin:${id}] deactivate failed:`, err);
         }
+        // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
         for (const off of [...(p.agentToolUnsubscribers ?? [])]) {
             try {
                 off();
@@ -658,7 +658,14 @@ export class PluginManager {
         if (apiVersion > PLUGIN_API_VERSION) {
             const msg = `插件要求宿主 API v${apiVersion}，当前宿主 v${PLUGIN_API_VERSION} —— 请升级 pi-web-ui`;
             console.error(`[plugin:${info.id}] ${msg}`);
-            this.loaded.set(info.id, { info: { ...info, error: msg }, toolHandlers, attachHandlers, cwdHandlers, httpRoutes, settingsHandlers: new Set() });
+            this.loaded.set(info.id, {
+                info: { ...info, error: msg },
+                toolHandlers,
+                attachHandlers,
+                cwdHandlers,
+                httpRoutes,
+                settingsHandlers: new Set(),
+            });
             return;
         }
         // 能力声明：写了 permissions → 严格模式（受控宿主 API 按声明族强制执行）；
@@ -666,7 +673,15 @@ export class PluginManager {
         const permsDeclared = (info.permissions ?? []).slice();
         const strict = permsDeclared.length > 0 || apiVersion >= 2;
         const permFamilies = new Set(permsDeclared.map((x) => x.split(":")[0]));
-        const p = { info, toolHandlers, attachHandlers, cwdHandlers, commandUnsubscribers: unregisterCommands, httpRoutes, settingsHandlers };
+        const p = {
+            info,
+            toolHandlers,
+            attachHandlers,
+            cwdHandlers,
+            commandUnsubscribers: unregisterCommands,
+            httpRoutes,
+            settingsHandlers,
+        };
         p.permsDeclared = permsDeclared;
         p.permFamilies = permFamilies;
         p.legacyWarned = false;
@@ -690,7 +705,7 @@ export class PluginManager {
             console.error(`[plugin:${info.id}] 缺少能力声明 "${family}"（manifest.permissions）——请求被拒`);
             return false;
         };
-        const self = this; // 对象字面量 getter 里不能用插件宿主的 this
+        const self = this; // 对象字面量 getter 里不能用插件宿主的 this (oxlint no-this-alias: 誤報, getter closure 需要 host)
         const host = {
             broadcast: (payload) => this.broadcast(info.id, payload),
             notify: (level, text) => this.notifyAll(level, text),
@@ -728,7 +743,10 @@ export class PluginManager {
                 if (!can("http"))
                     return () => { };
                 const m = String(method ?? "GET").toUpperCase();
-                if (!["GET", "POST", "PUT", "DELETE"].includes(m) || typeof path !== "string" || !path.startsWith("/") || typeof handler !== "function") {
+                if (!["GET", "POST", "PUT", "DELETE"].includes(m) ||
+                    typeof path !== "string" ||
+                    !path.startsWith("/") ||
+                    typeof handler !== "function") {
                     console.error(`[plugin:${info.id}] route: 非法参数（method=${method} path=${path}），忽略`);
                     return () => { };
                 }

package/dist/server/process-utils.js

@@ -13,7 +13,7 @@ export async function snapshotListeningPorts() {
     try {
         const { execFile } = await import("node:child_process");
         if (process.platform === "win32") {
-            const out = await new Promise((resolve, reject) => execFile("netstat", ["-ano", "-p", "tcp"], { windowsHide: true, timeout: 8000 }, (err, stdout) => (err ? reject(err) : resolve(stdout))));
+            const out = await new Promise((resolve, reject) => execFile("netstat", ["-ano", "-p", "tcp"], { windowsHide: true, timeout: 8000 }, (err, stdout) => err ? reject(err) : resolve(stdout)));
             for (const line of out.split(/\r?\n/)) {
                 const p = line.trim().split(/\s+/);
                 // TCP 0.0.0.0:5173 0.0.0.0:0 LISTENING 12345
@@ -26,7 +26,7 @@ export async function snapshotListeningPorts() {
             }
         }
         else {
-            const out = await new Promise((resolve, reject) => execFile("lsof", ["-iTCP", "-sTCP:LISTEN", "-P", "-n"], { timeout: 8000 }, (err, stdout) => (err ? reject(err) : resolve(stdout))));
+            const out = await new Promise((resolve, reject) => execFile("lsof", ["-iTCP", "-sTCP:LISTEN", "-P", "-n"], { timeout: 8000 }, (err, stdout) => err ? reject(err) : resolve(stdout)));
             for (const line of out.split(/\r?\n/).slice(1)) {
                 const p = line.trim().split(/\s+/);
                 if (p.length >= 9) {
@@ -83,7 +83,7 @@ export async function lookupProcessCommandLine(pid) {
             const line = out.trim();
             return line || undefined;
         }
-        const out = await new Promise((resolve, reject) => execFile("ps", ["-o", "command=", "-p", String(pid)], { timeout: 4000 }, (err, stdout) => (err ? reject(err) : resolve(stdout))));
+        const out = await new Promise((resolve, reject) => execFile("ps", ["-o", "command=", "-p", String(pid)], { timeout: 4000 }, (err, stdout) => err ? reject(err) : resolve(stdout)));
         const line = out.trim();
         return line || undefined;
     }
@@ -102,7 +102,7 @@ export async function lookupProcessName(pid) {
             const m = out.match(/"([^"]+)"/);
             return m ? m[1] : undefined;
         }
-        const out = await new Promise((resolve, reject) => execFile("ps", ["-o", "comm=", "-p", String(pid)], { timeout: 4000 }, (err, stdout) => (err ? reject(err) : resolve(stdout))));
+        const out = await new Promise((resolve, reject) => execFile("ps", ["-o", "comm=", "-p", String(pid)], { timeout: 4000 }, (err, stdout) => err ? reject(err) : resolve(stdout)));
         const name = out.trim();
         return name || undefined;
     }

package/dist/server/protocol-version.js

@@ -8,4 +8,4 @@
  * its own copy in web/src/protocol-version.ts; scripts/check-protocol-sync.mjs
  * verifies the two never drift.
  */
-export const PROTOCOL_VERSION = 10;
+export const PROTOCOL_VERSION = 11;