pi-web-ui 0.68.2 → 0.69.0

package/dist/server/markers/builtins/rename.js

@@ -9,6 +9,7 @@
  * 持久化：通过宿主回调直接改对话标题（内存 + 磁盘 transcript session_info），
  *         不需要额外状态。
  */
+import { getServerBlock, pick } from "../../i18n.js";
 export const RENAME_NAMESPACE = "conv";
 function extractTitle(token) {
     // args[0] 是主标题；kwargs 兼容 text/name/title
@@ -18,27 +19,59 @@ function extractTitle(token) {
         return `${fromArgs} ${fromKw}`.trim();
     return fromArgs || fromKw;
 }
+const RENAME_GUIDANCE_ZH = ["- 重命名当前对话：[[conv:rename:<新标题>]]（在了解了用户需求后尽早重命名对话）"];
+const RENAME_GUIDANCE_EN = [
+    "- Rename the current conversation: [[conv:rename:<new title>]] (do it early, once you understand what the user needs)",
+];
+/** 语言感知的 conv guidance（issue #91）：en 用英译、zh 用中文，默认英文。 */
+export function getRenameGuidance(lang = "en") {
+    return getServerBlock(lang, "markers.rename.guidance", RENAME_GUIDANCE_ZH, RENAME_GUIDANCE_EN);
+}
 export const renameMarker = {
     name: "conv",
-    guidance: ["- 重命名当前对话：[[conv:rename:<新标题>]]（在了解了用户需求后尽早重命名对话）"],
-    async apply(token, ctx) {
+    guidance: RENAME_GUIDANCE_ZH,
+    getGuidance: getRenameGuidance,
+    async apply(token, ctx, _state, lang = "en") {
         if (token.op !== "rename") {
-            return { applied: false, error: `conv 未知操作: ${token.op}（当前仅支持 conv:rename）` };
+            return {
+                applied: false,
+                error: pick(lang, `conv 未知操作: ${token.op}（当前仅支持 conv:rename）`, `conv unknown operation: ${token.op} (only conv:rename is supported)`, "markers.rename.unknown.operation", { "token.op": token.op }),
+            };
         }
         const title = extractTitle(token);
         if (!title)
-            return { applied: false, error: "conv:rename 需要一个标题参数 [[conv:rename:<新标题>]]" };
+            return {
+                applied: false,
+                error: pick(lang, "conv:rename 需要一个标题参数 [[conv:rename:<新标题>]]", "conv:rename requires a title argument [[conv:rename:<new title>]]", "markers.rename.requires.title"),
+            };
         if (title.length > 80)
-            return { applied: false, error: "标题过长（最多 80 字）" };
+            return {
+                applied: false,
+                error: pick(lang, "标题过长（最多 80 字）", "Title too long (max 80 characters)", "markers.rename.title.too.long"),
+            };
         if (!ctx.renameConversation)
-            return { applied: false, error: "当前环境不支持重命名" };
+            return {
+                applied: false,
+                error: pick(lang, "当前环境不支持重命名", "Renaming is not supported in this environment", "markers.rename.not.supported"),
+            };
         try {
             ctx.renameConversation(title);
             ctx.notify(`已重命名为：${title}`, "info", `Renamed to: ${title}`);
-            return { applied: true, feedback: `renamed to "${title}"` };
+            return {
+                applied: true,
+                feedback: pick(lang, `已重命名为“${title}”`, `renamed to "${title}"`, "markers.rename.renamed.to", {
+                    title: title,
+                }),
+            };
         }
         catch (e) {
-            return { applied: false, error: `重命名失败: ${e.message ?? String(e)}` };
+            const errMsg = e.message ?? String(e);
+            return {
+                applied: false,
+                error: pick(lang, `重命名失败: ${errMsg}`, `Rename failed: ${errMsg}`, "markers.rename.rename.failed", {
+                    errMsg: errMsg,
+                }),
+            };
         }
     },
     overlay: undefined,

package/dist/server/markers/builtins/todo.js

@@ -1,6 +1,7 @@
 /**
  * builtins/todo.ts — 内置任务标记（复刻 pi-marker-tools）。
  */
+import { getServerBlock, pick } from "../../i18n.js";
 export const TODO_NAMESPACE = "todo";
 export function initTodoState() {
     return { tasks: [], nextId: 1 };
@@ -26,10 +27,10 @@ function formatStatus(s) {
             return s;
     }
 }
-export function describeTodos(state, includeDeleted = false) {
+export function describeTodos(state, includeDeleted = false, lang = "en") {
     const visible = state.tasks.filter((t) => includeDeleted || t.status !== "deleted");
     if (visible.length === 0)
-        return "[todo] (空)";
+        return pick(lang, "[todo] （空）", "[todo] (empty)", "markers.todo.list.empty");
     return visible
         .map((t) => {
         const form = t.status === "in_progress" && t.activeForm ? ` (${t.activeForm})` : "";
@@ -38,82 +39,158 @@ export function describeTodos(state, includeDeleted = false) {
     })
         .join("\n");
 }
+const TODO_GUIDANCE_ZH = [
+    "# 内联标记工具（状态类操作请写在回答正文，不要调用工具）",
+    "- 标记语法：[[todo:new:<主题>]] 新建；[[todo:set:<id>,completed|in_progress|pending]] 状态；[[todo:remove:<id>]] 删除；[[todo:dep:<id>,blocks=<依赖id,逗号分隔>]] 设依赖。",
+    "- 状态变化全部用上面的 [[todo:...]] 内联标记表达，不会中断回答，无需等待返回。",
+    "- 想查看/list 当前任务列表时，才用 `markers_list` 工具（读操作走工具）。",
+    "- 不要编造不存在的任务 id；id 由 [[todo:new:...]] 分配，首次分配是自增整数。",
+];
+const TODO_GUIDANCE_EN = [
+    "# Inline marker tools (express state changes inline in your reply text — never call a tool for them)",
+    "- Marker syntax: [[todo:new:<subject>]] to create; [[todo:set:<id>,completed|in_progress|pending]] for status; [[todo:remove:<id>]] to delete; [[todo:dep:<id>,blocks=<dep ids, comma-separated>]] to set dependencies.",
+    "- Express all status changes with the [[todo:...]] inline markers above; they never interrupt your reply and need no waiting for a result.",
+    "- Only use the `markers_list` tool (the read path goes through the tool) when you want to list the current tasks.",
+    "- Never invent task ids; ids are assigned by [[todo:new:...]], starting from incrementing integers.",
+];
+/** 语言感知的 todo guidance（issue #91）：en 用英译、zh 用中文，默认英文。 */
+export function getTodoGuidance(lang = "en") {
+    return getServerBlock(lang, "markers.todo.guidance", TODO_GUIDANCE_ZH, TODO_GUIDANCE_EN);
+}
 export const todoMarker = {
     name: "todo",
-    guidance: [
-        "# 内联标记工具（状态类操作请写在回答正文，不要调用工具）",
-        "- 标记语法：[[todo:new:<主题>]] 新建；[[todo:set:<id>,completed|in_progress|pending]] 状态；[[todo:remove:<id>]] 删除；[[todo:dep:<id>,blocks=<依赖id,逗号分隔>]] 设依赖。",
-        "- 状态变化全部用上面的 [[todo:...]] 内联标记表达，不会中断回答，无需等待返回。",
-        "- 想查看/list 当前任务列表时，才用 `markers_list` 工具（读操作走工具）。",
-        "- 不要编造不存在的任务 id；id 由 [[todo:new:...]] 分配，首次分配是自增整数。",
-    ],
-    async apply(token, _ctx, _state) {
+    guidance: TODO_GUIDANCE_ZH,
+    getGuidance: getTodoGuidance,
+    async apply(token, _ctx, _state, lang = "en") {
         const state = _state;
         const op = token.op;
         switch (op) {
             case "new": {
                 const subject = token.args[0]?.trim();
                 if (!subject)
-                    return { applied: false, error: "todo:new 需要一个主题参数 [[todo:new:<主题>]]" };
+                    return {
+                        applied: false,
+                        error: pick(lang, "todo:new 需要一个主题参数 [[todo:new:<主题>]]", "todo:new requires a subject argument [[todo:new:<subject>]]", "markers.todo.new.requires.subject"),
+                    };
                 const id = state.nextId++;
                 state.tasks.push({ id, subject, status: "pending", blockedBy: [], createdAt: Date.now() });
-                return { applied: true, feedback: `Created #${id}: ${subject} (pending)` };
+                return {
+                    applied: true,
+                    feedback: pick(lang, `已创建 #${id}：${subject}（pending）`, `Created #${id}: ${subject} (pending)`, "markers.todo.new.created", { id: id, subject: subject }),
+                };
             }
             case "set": {
                 const id = parseId(token.args[0]);
-                if (id === null)
-                    return { applied: false, error: `todo:set 的 id 无效: "${token.args[0] ?? ""}"` };
+                if (id === null) {
+                    const rawId = token.args[0] ?? "";
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:set 的 id 无效: "${rawId}"`, `todo:set has an invalid id: "${rawId}"`, "markers.todo.set.invalid.id", { rawId: rawId }),
+                    };
+                }
                 const status = token.args[1]?.trim();
                 if (!status || !(status === "pending" || status === "in_progress" || status === "completed")) {
-                    return { applied: false, error: `todo:set 状态无效: "${status ?? ""}"，应为 pending|in_progress|completed` };
+                    const statusText = status ?? "";
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:set 状态无效: "${statusText}"，应为 pending|in_progress|completed`, `todo:set has an invalid status: "${statusText}", expected pending|in_progress|completed`, "markers.todo.set.invalid.status", { statusText: statusText }),
+                    };
                 }
                 const task = findTask(state, id);
                 if (!task)
-                    return { applied: false, error: `todo:set 任务 #${id} 不存在` };
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:set 任务 #${id} 不存在`, `todo:set task #${id} does not exist`, "markers.todo.set.task.missing", { id: id }),
+                    };
                 const activeForm = token.kwargs["activeForm"];
                 const from = task.status;
                 if (status === "pending" && from === "completed") {
-                    return { applied: false, error: `任务 #${id} 已完成，不能置回 pending` };
+                    return {
+                        applied: false,
+                        error: pick(lang, `任务 #${id} 已完成，不能置回 pending`, `Task #${id} is completed and cannot be set back to pending`, "markers.todo.set.completed.no.pending", { id: id }),
+                    };
                 }
                 if (status === "in_progress" && from === "completed") {
-                    return { applied: false, error: `任务 #${id} 已完成，不能重新进行中` };
+                    return {
+                        applied: false,
+                        error: pick(lang, `任务 #${id} 已完成，不能重新进行中`, `Task #${id} is completed and cannot be set back to in_progress`, "markers.todo.set.completed.no.inprogress", { id: id }),
+                    };
                 }
                 task.status = status;
                 if (status === "in_progress" && activeForm)
                     task.activeForm = activeForm;
                 const change = from !== status ? ` (${from} → ${status})` : "";
-                return { applied: true, feedback: `Updated #${id}${change}` };
+                return {
+                    applied: true,
+                    feedback: pick(lang, `已更新 #${id}${change}`, `Updated #${id}${change}`, "markers.todo.set.updated", {
+                        id: id,
+                        change: change,
+                    }),
+                };
             }
             case "remove": {
                 const id = parseId(token.args[0]);
-                if (id === null)
-                    return { applied: false, error: `todo:remove 的 id 无效: "${token.args[0] ?? ""}"` };
+                if (id === null) {
+                    const rawId = token.args[0] ?? "";
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:remove 的 id 无效: "${rawId}"`, `todo:remove has an invalid id: "${rawId}"`, "markers.todo.remove.invalid.id", { rawId: rawId }),
+                    };
+                }
                 const task = findTask(state, id);
                 if (!task)
-                    return { applied: false, error: `todo:remove 任务 #${id} 不存在` };
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:remove 任务 #${id} 不存在`, `todo:remove task #${id} does not exist`, "markers.todo.remove.task.missing", { id: id }),
+                    };
                 task.status = "deleted";
-                return { applied: true, feedback: `Deleted #${id}: ${task.subject}` };
+                return {
+                    applied: true,
+                    feedback: pick(lang, `已删除 #${id}：${task.subject}`, `Deleted #${id}: ${task.subject}`, "markers.todo.remove.deleted", { id: id, "task.subject": task.subject }),
+                };
             }
             case "dep": {
                 const id = parseId(token.args[0]);
-                if (id === null)
-                    return { applied: false, error: `todo:dep 的 id 无效: "${token.args[0] ?? ""}"` };
+                if (id === null) {
+                    const rawId = token.args[0] ?? "";
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:dep 的 id 无效: "${rawId}"`, `todo:dep has an invalid id: "${rawId}"`, "markers.todo.dep.invalid.id", { rawId: rawId }),
+                    };
+                }
                 const task = findTask(state, id);
                 if (!task)
-                    return { applied: false, error: `todo:dep 任务 #${id} 不存在` };
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:dep 任务 #${id} 不存在`, `todo:dep task #${id} does not exist`, "markers.todo.dep.task.missing", { id: id }),
+                    };
                 const depRaw = token.kwargs["blocks"] ?? token.args[1] ?? "";
                 const deps = depRaw
                     .split(",")
                     .map((x) => parseId(x.trim()))
                     .filter((x) => x !== null);
                 const bad = deps.filter((d) => d === id || !findTask(state, d));
-                if (bad.length)
-                    return { applied: false, error: `todo:dep 检测到非法依赖 ${bad.join(",")}（不存在或自环）` };
+                if (bad.length) {
+                    const badList = bad.join(",");
+                    return {
+                        applied: false,
+                        error: pick(lang, `todo:dep 检测到非法依赖 ${badList}（不存在或自环）`, `todo:dep detected invalid dependencies ${badList} (missing or self-referencing)`, "markers.todo.dep.invalid.dependencies", { badList: badList }),
+                    };
+                }
                 task.blockedBy = deps;
-                return { applied: true, feedback: `#${id} blocks: ${deps.length ? deps.join(",") : "(none)"}` };
+                const depsText = deps.length ? deps.join(",") : lang === "zh" ? "（无）" : "(none)";
+                return {
+                    applied: true,
+                    feedback: pick(lang, `#${id} 依赖：${depsText}`, `#${id} blocks: ${depsText}`, "markers.todo.dep.blocks.updated", { id: id, depsText: depsText }),
+                };
             }
             default:
-                return { applied: false, error: `todo 未知操作: ${op}` };
+                return {
+                    applied: false,
+                    error: pick(lang, `todo 未知操作: ${op}`, `todo unknown operation: ${op}`, "markers.todo.unknown.operation", {
+                        op: op,
+                    }),
+                };
         }
     },
     overlay(state) {

package/dist/server/markers/registry.js

@@ -14,12 +14,12 @@ export function allMarkers() {
 export function lookupToken(name) {
     return registry.get(name);
 }
-export function collectGuidance(disabled = new Set()) {
+export function collectGuidance(disabled = new Set(), lang = "en") {
     const out = [];
     for (const m of allMarkers()) {
         if (disabled.has(m.name))
             continue;
-        out.push(...m.guidance);
+        out.push(...(m.getGuidance?.(lang) ?? m.guidance));
     }
     return out;
 }

package/dist/server/mcp-bridge.js

@@ -16,6 +16,7 @@
 import { spawn } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+import { bilingual } from "./i18n.js";
 const PROTOCOL_VERSION = "2025-03-26"; // 广泛支持的工具版本
 let rpcSeq = 0;
 /**
@@ -210,7 +211,8 @@ function adaptMcpTool(serverName, mcpTool, client) {
     return {
         name,
         label: `${serverName} · ${mcpTool.name}`,
-        description: mcpTool.description ?? `从 MCP 服务器「${serverName}」提供的工具 ${mcpTool.name}`,
+        description: mcpTool.description ??
+            bilingual(`Tool ${mcpTool.name} provided by MCP server "${serverName}"`, `从 MCP 服务器「${serverName}」提供的工具 ${mcpTool.name}`),
         parameters: mcpTool.inputSchema ?? {},
         execute: async (_toolCallId, params, _signal) => {
             return client.call(mcpTool.name, params ?? {});

package/dist/server/model-admin.js

@@ -13,6 +13,7 @@
  */
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { pick } from "./i18n.js";
 /** Strip // and /* *\/ comments without touching string literals (URLs contain //). */
 function stripJsonComments(src) {
     let out = "";
@@ -853,10 +854,12 @@ export class ModelAdminService {
      *  because the baseUrl is often a LAN/loopback host the browser can't reach
      *  cross-origin) and return the advertised models. reqId is echoed back
      *  in fetch_models_result so the UI can match concurrent requests. */
-    async fetchModelsList(reqId, baseUrl, apiKey, authHeader, api) {
+    async fetchModelsList(reqId, baseUrl, apiKey, authHeader, api, 
+    /** 探测抛错文案语言（默认英文）；调用方可传 () => getLang() 实现跟随。 */
+    lang) {
         const emitError = (error) => this.host.emit({ type: "fetch_models_result", reqId, ok: false, error });
         try {
-            const models = await ModelAdminService.probeModelsEndpoint(baseUrl, apiKey, authHeader, api);
+            const models = await ModelAdminService.probeModelsEndpoint(baseUrl, apiKey, authHeader, api, undefined, lang);
             this.host.emit({ type: "fetch_models_result", reqId, ok: true, models });
         }
         catch (err) {
@@ -869,19 +872,22 @@ export class ModelAdminService {
      * a user-facing message on any failure; returns deduped+sorted entries.
      * Shared by the edit-form "auto fetch" and the saved-provider refresh.
      */
-    static async probeModelsEndpoint(baseUrl, apiKey, authHeader, api, extraHeaders) {
+    static async probeModelsEndpoint(baseUrl, apiKey, authHeader, api, extraHeaders, 
+    /** 抛错文案语言（默认英文）；调用方可传 () => getLang() 实现跟随。 */
+    lang) {
+        const l = lang?.() ?? "en";
         const base = (baseUrl ?? "").trim().replace(/\/+$/, "");
         if (!base)
-            throw new Error("请先填写 baseUrl");
+            throw new Error(pick(l, "请先填写 baseUrl", "Enter the baseUrl first", "models.fetch.baseurl.missing"));
         let url;
         try {
             url = new URL(base);
         }
         catch {
-            throw new Error(`baseUrl 无效：${base}`);
+            throw new Error(pick(l, `baseUrl 无效：${base}`, `Invalid baseUrl: ${base}`, "models.fetch.baseurl.invalid", { base }));
         }
         if (url.protocol !== "http:" && url.protocol !== "https:") {
-            throw new Error("baseUrl 仅支持 http/https");
+            throw new Error(pick(l, "baseUrl 仅支持 http/https", "baseUrl supports http/https only", "models.fetch.baseurl.protocol"));
         }
         const headers = {
             ...extraHeaders,
@@ -912,9 +918,12 @@ export class ModelAdminService {
             }
             catch (err) {
                 if (err.name === "AbortError") {
-                    throw new Error("请求超时（15 秒）");
+                    throw new Error(pick(l, "请求超时（15 秒）", "Request timed out (15s)", "models.fetch.timeout"));
                 }
-                throw new Error(`请求失败：${err.message}`);
+                const errMessage = err.message;
+                throw new Error(pick(l, `请求失败：${errMessage}`, `Request failed: ${errMessage}`, "models.fetch.request.error", {
+                    errMessage,
+                }));
             }
             finally {
                 clearTimeout(timer);
@@ -927,7 +936,7 @@ export class ModelAdminService {
             res = await tryFetch(`${base}/v1/models`);
         }
         if (!res)
-            throw new Error("请求失败");
+            throw new Error(pick(l, "请求失败", "Request failed", "models.fetch.request.failed"));
         if (!res.ok) {
             let detail = "";
             try {
@@ -936,7 +945,9 @@ export class ModelAdminService {
             catch {
                 // response body already consumed / not text — ignore
             }
-            throw new Error(`接口返回 HTTP ${res.status}${detail ? `：${detail}` : ""}`);
+            const detailSuffixZh = detail ? `：${detail}` : "";
+            const detailSuffixEn = detail ? `: ${detail}` : "";
+            throw new Error(pick(l, `接口返回 HTTP ${res.status}${detailSuffixZh}`, `Upstream returned HTTP ${res.status}${detailSuffixEn}`, "models.fetch.upstream.http", { "res.status": res.status, detailSuffixZh, detailSuffixEn }));
         }
         let models = [];
         try {
@@ -952,7 +963,7 @@ export class ModelAdminService {
             }
         }
         catch {
-            throw new Error("响应不是有效的 JSON");
+            throw new Error(pick(l, "响应不是有效的 JSON", "Response is not valid JSON", "models.fetch.invalid.json"));
         }
         // Dedupe by id (keep the first, most complete entry) and sort by id.
         const seen = new Set();
@@ -960,7 +971,7 @@ export class ModelAdminService {
             .filter((m) => (seen.has(m.id) ? false : (seen.add(m.id), true)))
             .sort((a, b) => a.id.localeCompare(b.id));
         if (models.length === 0)
-            throw new Error("接口未返回任何模型");
+            throw new Error(pick(l, "接口未返回任何模型", "The endpoint returned no models", "models.fetch.no.models"));
         return models;
     }
     /**
@@ -970,7 +981,7 @@ export class ModelAdminService {
      * existing ids keep all manually-entered fields and only gain metadata
      * they were missing; brand-new ids are appended. Hot-reloads the runtime.
      */
-    async refreshProviderModels(providerId, reqId) {
+    async refreshProviderModels(providerId, reqId, lang) {
         const done = (ok, extra = {}) => this.host.emit({ type: "refresh_provider_result", reqId, ok, ...extra });
         try {
             const pid = providerId.trim();
@@ -986,7 +997,7 @@ export class ModelAdminService {
                 });
                 return done(false, { error: "provider missing or no baseUrl" });
             }
-            const fetched = await ModelAdminService.probeModelsEndpoint(saved.baseUrl, saved.apiKey, saved.authHeader === true ? true : undefined, saved.api, saved.headers);
+            const fetched = await ModelAdminService.probeModelsEndpoint(saved.baseUrl, saved.apiKey, saved.authHeader === true ? true : undefined, saved.api, saved.headers, lang);
             // Merge: manual values win; fetched fills blanks and appends new ids.
             const prev = new Map((saved.models ?? []).map((m) => [m.id, m]));
             let added = 0;

package/dist/server/plugin-catalog.js

@@ -16,6 +16,7 @@
  */
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { pick } from "./i18n.js";
 /** 合法插件 id（与 server/plugins.ts 的 ID_RE 一致，防路径穿越）。 */
 const ID_RE = /^[A-Za-z0-9_-]+$/;
 /** source 校验：owner/repo 或 owner/repo/子路径[#ref]。宽松校验，实际解析
@@ -121,14 +122,17 @@ export function readCatalog(builtinPath, customPath) {
 }
 /** 把用户填的条目追加进 custom 文件（同 id 覆盖旧条目）；返回规范化后的条目。
  *  非法来源/条目抛 Error。 */
-export function addCustomEntry(customPath, input) {
+export function addCustomEntry(customPath, input, 
+/** 面向用户的抛错文案语言（默认英文）；调用方可传 () => getLang() 实现跟随。 */
+lang) {
+    const l = lang?.() ?? "en";
     const source = String(input?.source ?? "").trim();
     if (!isValidSource(source)) {
-        throw new Error("来源需为 owner/repo 或 owner/repo/子目录（不支持本地路径）");
+        throw new Error(pick(l, "来源需为 owner/repo 或 owner/repo/子目录（不支持本地路径）", "Source must be owner/repo or owner/repo/subdir (local paths are not supported)", "plugincatalog.source.invalid"));
     }
     const id = deriveCatalogId(typeof input?.id === "string" ? input.id.trim() : undefined, source);
     if (!ID_RE.test(id))
-        throw new Error(`非法 id "${id}"（仅限字母数字-_）`);
+        throw new Error(pick(l, `非法 id "${id}"（仅限字母数字-_）`, `Invalid id "${id}" (letters/digits/-/_ only)`, "plugincatalog.id.invalid", { id }));
     const raw = readJsonSafe(customPath, {});
     const entries = Array.isArray(raw.entries) ? raw.entries : [];
     const next = entries.filter((x) => !(x && typeof x === "object" && x.id === id));

package/dist/server/plugin-updater.js

@@ -10,6 +10,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, cpSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { execFile } from "node:child_process";
+import { pick } from "./i18n.js";
 const PLUGIN_ID_RE = /^[A-Za-z0-9_-]+$/;
 /** 保留的备份份数（超出删除最旧的）。 */
 export const BACKUP_KEEP = 3;
@@ -150,7 +151,10 @@ export async function resolveRemoteSha(spec, exec = execGit) {
     return sha ? sha.slice(0, 12) : null;
 }
 /** 扫描全部已装插件，对比本地 sha 与远端 sha，报告更新状态。 */
-export async function checkPluginUpdates(dataDir, exec = execGit) {
+export async function checkPluginUpdates(dataDir, exec = execGit, 
+/** error 字段文案语言（默认英文）；调用方可传 () => getLang() 实现跟随。 */
+lang) {
+    const l = lang?.() ?? "en";
     const pluginsDir = join(dataDir, "plugins");
     let names = [];
     try {
@@ -186,7 +190,7 @@ export async function checkPluginUpdates(dataDir, exec = execGit) {
                 remoteSha = null;
             }
             if (!remoteSha && !error)
-                error = "无法检查（非 git 源或 git 不可用）";
+                error = pick(l, "无法检查（非 git 源或 git 不可用）", "Cannot check (non-git source or git unavailable)", "pluginupdate.cannot.check");
             let name;
             let version;
             try {

package/dist/server/plugins.js

@@ -20,6 +20,7 @@ import { readdir, readFile, stat } from "node:fs/promises";
 import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join, resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
+import { pick } from "./i18n.js";
 import { PluginStorage, PluginSecrets, ensurePluginDeps, WorkspaceFS } from "./plugin-facilities.js";
 import { readCatalog, addCustomEntry, removeCustomEntry } from "./plugin-catalog.js";
 import { createHash } from "node:crypto";
@@ -84,14 +85,22 @@ function storedSettingsValues(dir, schema) {
     return out;
 }
 /** 校验并写回 settings（storage.json 的 settings 键，原子写）；返回错误信息或 null。 */
-function saveSettingsValues(dir, schema, values) {
+function saveSettingsValues(dir, schema, values, 
+/** 错误文案语言（默认英文）；调用方可传 () => getLang() 实现跟随。 */
+lang) {
+    const l = lang?.() ?? "en";
     const clean = {};
     for (const f of schema) {
         const v = values?.[f.key];
         if (f.type === "number") {
             const n = v === undefined ? Number(f.default ?? 0) : Number(v);
             if (!Number.isFinite(n) || (f.min !== undefined && n < f.min) || (f.max !== undefined && n > f.max)) {
-                return { error: `${f.label} 超出范围`, clean };
+                return {
+                    error: pick(l, `${f.label} 超出范围`, `${f.label} out of range`, "plugins.settings.out.of.range", {
+                        "f.label": f.label,
+                    }),
+                    clean,
+                };
             }
             clean[f.key] = n;
         }
@@ -100,7 +109,12 @@ function saveSettingsValues(dir, schema, values) {
         }
         else if (f.type === "select") {
             if (v !== undefined && !f.options?.includes(String(v)))
-                return { error: `${f.label} 值非法`, clean };
+                return {
+                    error: pick(l, `${f.label} 值非法`, `Invalid value for ${f.label}`, "plugins.settings.invalid.value", {
+                        "f.label": f.label,
+                    }),
+                    clean,
+                };
             clean[f.key] = v === undefined ? f.default : String(v);
         }
         else {
@@ -238,15 +252,20 @@ export class PluginManager {
     /** 保存某插件的声明式设置（⚙ 面板 → plugin_settings 消息）：按 schema 校验、
      *  原子写 storage.json 的 settings 键、通知插件 onSettingsChanged、重推清单
      *  让前端回显。返回错误信息或 null（成功）。 */
-    savePluginSettings(pluginId, values) {
+    savePluginSettings(pluginId, values, 
+    /** 错误文案语言（默认英文）；调用方可传 () => getLang() 实现跟随。 */
+    lang) {
+        const l = lang?.() ?? "en";
         if (!ID_RE.test(pluginId))
-            return { error: "非法的插件 id" };
+            return { error: pick(l, "非法的插件 id", "Invalid plugin id", "plugins.id.invalid") };
         const dir = join(this.pluginsDir, pluginId);
         const info = this.loaded.get(pluginId)?.info;
         const schema = info?.settingsSchema ?? [];
         if (!schema.length)
-            return { error: "该插件没有声明式设置（manifest 未声明 settings）" };
-        const { error, clean } = saveSettingsValues(dir, schema, values);
+            return {
+                error: pick(l, "该插件没有声明式设置（manifest 未声明 settings）", "This plugin has no declarative settings (manifest declares no settings)", "plugins.settings.no.declarative"),
+            };
+        const { error, clean } = saveSettingsValues(dir, schema, values, lang);
         if (error)
             return { error };
         // 通知插件（异常隔离）
@@ -284,9 +303,9 @@ export class PluginManager {
     }
     /** 往用户自定义列表加一条（同 id 覆盖）；返回错误信息或 null（成功）。
      *  成功后 epoch+1 并重推列表。 */
-    addCatalogEntry(input) {
+    addCatalogEntry(input, lang) {
         try {
-            addCustomEntry(this.customCatalogPath, input);
+            addCustomEntry(this.customCatalogPath, input, lang);
             this.catalogEpoch += 1;
             void this.pushCatalog();
             return {};
@@ -296,11 +315,14 @@ export class PluginManager {
         }
     }
     /** 移除一条用户自定义条目（builtin 不可经此删除）；返回错误信息或 null。 */
-    removeCatalogEntry(id) {
+    removeCatalogEntry(id, lang) {
+        const l = lang?.() ?? "en";
         try {
             const ok = removeCustomEntry(this.customCatalogPath, id);
             if (!ok)
-                return { error: "未找到该条目，或它是内置条目（不可移除）" };
+                return {
+                    error: pick(l, "未找到该条目，或它是内置条目（不可移除）", "Entry not found, or it is a built-in entry (cannot be removed)", "plugins.catalog.entry.cannot.remove"),
+                };
             this.catalogEpoch += 1;
             void this.pushCatalog();
             return {};
@@ -418,11 +440,11 @@ export class PluginManager {
     /** 服务端热重载：反激活全部 → 清缓存 → 重扫重激活 → epoch+1。
      *  返回新目录清单（含激活结果）。重激活后的插件实例是新模块，
      *  内存状态为初始值——逐个客户端触发 onAttach 让它们重推自身状态。 */
-    async reload() {
+    async reload(lang) {
         this.dispose();
         this.attempted.clear();
         this.epochCounter += 1;
-        const list = await this.ensureLoaded();
+        const list = await this.ensureLoaded(lang);
         for (const s of this.senders) {
             const cid = s.cid();
             if (cid)
@@ -606,14 +628,14 @@ export class PluginManager {
      * attach 时调用：重扫目录 + 激活尚未加载的新插件。
      * 返回给浏览器的目录（含激活失败的条目，前端显示为不可用）。
      */
-    async ensureLoaded() {
+    async ensureLoaded(lang) {
         const found = await this.scan();
         for (const info of found) {
             if (this.loaded.has(info.id) || this.attempted.has(info.id))
                 continue;
             if (!existsSync(join(this.pluginsDir, info.id, "index.mjs")))
                 continue; // 纯前端插件
-            await this.activate(info);
+            await this.activate(info, lang);
         }
         // 已被删除的插件：调用 deactivate 并移出缓存
         // eslint-disable-next-line unicorn/no-useless-spread -- snapshot: handlers may unsubscribe mid-emit
@@ -735,7 +757,8 @@ export class PluginManager {
         }
         return out;
     }
-    async activate(info) {
+    async activate(info, lang) {
+        const l = lang?.() ?? "en";
         this.attempted.add(info.id);
         const dir = join(this.pluginsDir, info.id);
         const handlers = new Set();
@@ -758,7 +781,7 @@ export class PluginManager {
         }
         catch { }
         if (apiVersion > PLUGIN_API_VERSION) {
-            const msg = `插件要求宿主 API v${apiVersion}，当前宿主 v${PLUGIN_API_VERSION} —— 请升级 pi-web-ui`;
+            const msg = pick(l, `插件要求宿主 API v${apiVersion}，当前宿主 v${PLUGIN_API_VERSION} —— 请升级 pi-web-ui`, `Plugin requires host API v${apiVersion} but the host is v${PLUGIN_API_VERSION} — please upgrade pi-web-ui`, "plugins.host.api.mismatch", { apiVersion, PLUGIN_API_VERSION });
             console.error(`[plugin:${info.id}] ${msg}`);
             this.loaded.set(info.id, {
                 info: { ...info, error: msg },