@ai-zen/cli 1.0.0-alpha.2 → 1.0.0-alpha.22

package/dist/tui/config-wizard/fields.js

@@ -1,38 +1,78 @@
 import { agentKindLabel, agentList } from "../../agents-store.js";
-import { findEndpoint, findModel, formatAgentPermission, formatArgs, getAgentPrompt, kvSummary, maskApiKey, mcpServerIdTaken, parseArgs, parsePermission, PERMISSION_DIMENSIONS, renameMcpServer, setAgentPermission, summarizePermissions, updateAgentDefinition, updateAgentFunction, updateEndpoint, updateImageModel, updateMcpServer, updateModel } from "../../config-editor.js";
+import { findEndpoint, findModel, formatAgentPermission, formatArgs, getAgentPrompt, kvSummary, maskApiKey, mcpServerIdTaken, mergeTokenThresholds, parseArgs, parsePermission, PERMISSION_DIMENSIONS, renameMcpServer, setAgentPermission, summarizePermissions, updateAgentDefinition, updateAgentFunction, updateEndpoint, updateImageModel, updateMcpServer, updateModel } from "../../config-editor.js";
+import { t } from "../../i18n/index.js";
 import { scopeLabel } from "./mcp-helpers.js";
+/**
+ * 权限四维的显示名。
+ *
+ * 维度名（`tools` / `skills` / …）是配置里的键，直接上屏等于把内部标识暴露给用户；
+ * 这里映射到词条，`Record<PermissionDimension, …>` 保证四个维度都有对应文案。
+ */
+const PERMISSION_DIMENSION_LABEL_KEY = {
+    tools: "perm.tools",
+    skills: "perm.skills",
+    mcps: "perm.mcps",
+    subagents: "perm.subagents",
+};
 // 由 src/tui/config-wizard.tsx 拆分而来 —— 详情屏字段构造器（工厂）
 /** 多行文本在详情屏的**单行摘要**（避免换行撑破吸底布局）；内容一律走外部编辑器编辑 */
 function summarizeMultiline(text) {
     const body = text.replace(/\r\n/g, "\n").trim();
     if (!body)
-        return "（空）· Enter 打开编辑器";
+        return t("common.emptyWithEditor");
     const lines = body.split("\n");
-    return lines.length > 1 ? `${lines.length} 行 · Enter 打开编辑器` : `${body} · Enter 打开编辑器`;
+    return lines.length > 1
+        ? t("common.linesWithEditor", { n: lines.length })
+        : t("common.bodyWithEditor", { text: body });
 }
 export function createFieldBuilders(context) {
-    const { config, mcp, store, persist, persistMcp, saveAgent, removeAgentQuiet, go } = context;
-    // ---------- 字段构造器 ----------
+    const { config, mcp, store, reasoningPresets, persist, persistMcp, saveAgent, removeAgentQuiet, go } = context;
+    // ---------- 共享字段 ----------
+    /**
+     * 「名称」字段：端点 / 模型 / 图片模型三处的形状逐字相同，只有写回目标不同。
+     * 空名称一律拦下 —— 名称会进提示语与列表，写空等于把这一条「弄丢」。
+     */
+    const nameField = (current, save) => ({
+        key: "name",
+        label: t("field.name"),
+        kind: "text",
+        value: current.name || current.id,
+        initial: current.name,
+        commit: (raw) => (raw.trim() ? save({ name: raw.trim() }, t("field.name")) : t("err.nameRequired")),
+    });
+    /** 「绑定端点」字段：模型 / 图片模型共用，选项是全局端点表 */
+    const endpointIdField = (currentEndpointId, save) => ({
+        key: "endpointId",
+        label: t("field.endpoint"),
+        kind: "enum",
+        value: findEndpoint(config, currentEndpointId)?.name ?? currentEndpointId,
+        options: config.endpoints.map((endpoint) => ({ label: endpoint.name || endpoint.id, value: endpoint.id })),
+        // 选回原端点不算改动：否则会白白写盘一次
+        commit: (raw) => (raw === currentEndpointId ? null : save({ endpointId: raw }, t("field.endpoint"))),
+    });
+    /**
+     * 出厂托管条目的改动标记。
+     *
+     * 托管条目由 SDK 同步维护，**任何本地改动都必须打成 `custom: true`**，否则下次
+     * 同步会把改动覆盖掉。提示语后缀同步告知用户这一后果。
+     */
+    const customPatch = (entity, patch) => entity.custom ? patch : { ...patch, custom: true };
+    /** 同上，用于「整份定义」写回（如 Agent 定义）：返回完整对象 */
+    const markCustom = (entity) => entity.custom ? entity : { ...entity, custom: true };
+    const customNote = (managed) => (managed ? t("common.customOnlyNote") : "");
     /** 端点详情字段（editable：名称 / Base URL / API Key / 描述） */
     const endpointFields = (endpoint) => {
         const name = endpoint.name || endpoint.id;
-        const save = (patch, label) => persist(updateEndpoint(config, endpoint.id, patch), `端点 ${name} 的 ${label} 已更新`, [endpoint.id]);
+        const save = (patch, label) => persist(updateEndpoint(config, endpoint.id, patch), t("wiz.endpointUpdated", { name, label }), [endpoint.id]);
         return [
-            {
-                key: "name",
-                label: "名称",
-                kind: "text",
-                value: name,
-                initial: endpoint.name,
-                commit: (raw) => (raw.trim() ? save({ name: raw.trim() }, "名称") : Promise.resolve("名称不能为空")),
-            },
+            nameField(endpoint, save),
             {
                 key: "baseUrl",
                 label: "Base URL",
                 kind: "text",
                 value: endpoint.baseUrl,
                 initial: endpoint.baseUrl,
-                commit: (raw) => /^https?:\/\//i.test(raw) ? save({ baseUrl: raw }, "Base URL") : Promise.resolve("Base URL 需以 http:// 或 https:// 开头"),
+                commit: (raw) => /^https?:\/\//i.test(raw) ? save({ baseUrl: raw }, "Base URL") : t("err.baseUrlScheme"),
             },
             {
                 key: "apiKey",
@@ -40,165 +80,189 @@ export function createFieldBuilders(context) {
                 kind: "secret",
                 value: maskApiKey(endpoint.apiKey),
                 initial: endpoint.apiKey ?? "",
-                commit: (raw) => (raw ? save({ apiKey: raw }, "API Key") : Promise.resolve("API Key 不能为空")),
+                commit: (raw) => (raw ? save({ apiKey: raw }, "API Key") : t("err.apiKeyRequired")),
             },
             {
                 key: "description",
-                label: "描述",
+                label: t("field.description"),
                 kind: "text",
-                value: endpoint.description ?? "（空）",
+                value: endpoint.description ?? t("common.empty"),
                 initial: endpoint.description ?? "",
-                commit: (raw) => save({ description: raw || undefined }, "描述"),
+                commit: (raw) => save({ description: raw || undefined }, t("field.description")),
             },
         ];
     };
+    /** 模型详情页「思考策略」的展示文案：附上该策略的档位，免得用户还得去翻 JSON */
+    const describePreset = (name) => {
+        if (!name)
+            return t("common.notAdjustable");
+        const preset = Object.prototype.hasOwnProperty.call(reasoningPresets, name)
+            ? reasoningPresets[name]
+            : undefined;
+        const levels = Object.keys(preset?.levels ?? {});
+        return levels.length
+            ? t("wiz.presetLevels", { name, levels: levels.join(" / ") })
+            : t("wiz.presetMissingName", { name });
+    };
     /** 模型详情字段；编辑「出厂托管」模型时自动标记 `custom: true`（否则改动会被 SDK 同步覆盖） */
     const modelFields = (model) => {
         const managed = !model.custom;
-        const save = (patch, label) => {
-            const next = updateModel(config, model.id, managed ? { ...patch, custom: true } : patch);
-            const suffix = managed ? "（已标记为自定义，改动才会保留）" : "";
-            return persist(next, `模型 ${model.name || model.id} 的 ${label} 已更新${suffix}`, [model.endpointId]);
-        };
+        const save = (patch, label) => persist(updateModel(config, model.id, customPatch(model, patch)), t("wiz.modelUpdated", { name: model.name || model.id, label, suffix: customNote(managed) }), [model.endpointId]);
         return [
+            nameField(model, save),
+            endpointIdField(model.endpointId, save),
             {
-                key: "name",
-                label: "名称",
+                key: "modelName",
+                label: t("field.modelName"),
                 kind: "text",
-                value: model.name || model.id,
-                initial: model.name,
-                commit: (raw) => (raw.trim() ? save({ name: raw.trim() }, "名称") : Promise.resolve("名称不能为空")),
+                value: model.modelName ?? t("common.sameAsId"),
+                initial: model.modelName ?? "",
+                commit: (raw) => save({ modelName: raw || undefined }, t("field.modelName")),
             },
             {
-                key: "endpointId",
-                label: "端点",
-                kind: "enum",
-                value: findEndpoint(config, model.endpointId)?.name ?? model.endpointId,
-                options: config.endpoints.map((endpoint) => ({ label: endpoint.name || endpoint.id, value: endpoint.id })),
-                commit: (raw) => (raw === model.endpointId ? Promise.resolve(null) : save({ endpointId: raw }, "端点")),
+                key: "reasoningPreset",
+                label: t("field.reasoningPreset"),
+                kind: "text",
+                value: describePreset(model.reasoningPreset),
+                initial: model.reasoningPreset ?? "",
+                commit: (raw) => {
+                    const name = raw.trim();
+                    if (!name)
+                        return save({ reasoningPreset: undefined }, t("field.reasoningPreset"));
+                    // 名字写错等于静默失去调档能力，当场拦住
+                    if (!Object.prototype.hasOwnProperty.call(reasoningPresets, name)) {
+                        const available = Object.keys(reasoningPresets);
+                        return available.length
+                            ? t("err.presetNotFound", { name, options: available.join(" / ") })
+                            : t("err.presetTableEmpty", { name });
+                    }
+                    return save({ reasoningPreset: name }, t("field.reasoningPreset"));
+                },
             },
             {
-                key: "modelName",
-                label: "模型名",
-                kind: "text",
-                value: model.modelName ?? "（同 id）",
-                initial: model.modelName ?? "",
-                commit: (raw) => save({ modelName: raw || undefined }, "模型名"),
+                key: "handoffTokens",
+                label: t("field.handoffThreshold"),
+                kind: "number",
+                value: String(model.tokenThresholds?.handoff ?? 0),
+                initial: String(model.tokenThresholds?.handoff ?? 0),
+                commit: (raw) => {
+                    const n = Number(raw.trim());
+                    if (!Number.isFinite(n) || n <= 0)
+                        return t("err.handoffPositive");
+                    const guard = model.tokenThresholds?.guard ?? 0;
+                    // 软线不得越过硬线，否则一启动就被阻断
+                    if (guard > 0 && Math.floor(n) >= guard)
+                        return t("err.handoffLessThanGuard");
+                    return save({ tokenThresholds: mergeTokenThresholds(model.tokenThresholds, { handoff: Math.floor(n) }) }, t("field.handoffThreshold"));
+                },
             },
             {
-                key: "maxContextTokens",
-                label: "迁移阈值",
+                key: "guardTokens",
+                label: t("field.guardThreshold"),
                 kind: "number",
-                value: String(model.maxContextTokens ?? 0),
-                initial: String(model.maxContextTokens ?? 0),
+                value: String(model.tokenThresholds?.guard ?? 0),
+                initial: String(model.tokenThresholds?.guard ?? 0),
                 commit: (raw) => {
                     const n = Number(raw.trim());
-                    return Number.isFinite(n) && n > 0 ? save({ maxContextTokens: Math.floor(n) }, "迁移阈值") : Promise.resolve("迁移阈值需为正整数");
+                    if (!Number.isFinite(n) || n <= 0)
+                        return t("err.guardPositive");
+                    const handoff = model.tokenThresholds?.handoff ?? 0;
+                    if (Math.floor(n) <= handoff)
+                        return t("err.guardGreaterThanHandoff");
+                    return save({ tokenThresholds: mergeTokenThresholds(model.tokenThresholds, { guard: Math.floor(n) }) }, t("field.guardThreshold"));
                 },
             },
             {
                 key: "vision",
-                label: "视觉",
+                label: t("field.vision"),
                 kind: "bool",
-                value: model.vision ? "是" : "否",
-                toggle: () => save({ vision: !model.vision }, "视觉"),
+                value: model.vision ? t("common.yes") : t("common.no"),
+                toggle: () => save({ vision: !model.vision }, t("field.vision")),
             },
             {
                 key: "description",
-                label: "描述",
+                label: t("field.description"),
                 kind: "text",
-                value: model.description ?? "（空）",
+                value: model.description ?? t("common.empty"),
                 initial: model.description ?? "",
-                commit: (raw) => save({ description: raw || undefined }, "描述"),
+                commit: (raw) => save({ description: raw || undefined }, t("field.description")),
             },
             {
                 key: "custom",
-                label: "自定义",
+                label: t("field.custom"),
                 kind: "bool",
-                value: model.custom ? "是" : "否（出厂托管）",
-                toggle: () => persist(updateModel(config, model.id, { custom: !model.custom }), `模型 ${model.name || model.id} 的「自定义」已设为 ${!model.custom ? "是" : "否"}`, [model.endpointId]),
+                value: model.custom ? t("common.yes") : t("common.factoryManaged"),
+                toggle: () => persist(updateModel(config, model.id, { custom: !model.custom }), t("wiz.modelCustomSet", {
+                    name: model.name || model.id,
+                    value: !model.custom ? t("common.yes") : t("common.no"),
+                }), [model.endpointId]),
             },
         ];
     };
     /** 图片模型详情字段（同样对托管条目自动标记 `custom: true`） */
     const imageModelFields = (model) => {
         const managed = !model.custom;
-        const save = (patch, label) => {
-            const next = updateImageModel(config, model.id, managed ? { ...patch, custom: true } : patch);
-            const suffix = managed ? "（已标记为自定义，改动才会保留）" : "";
-            return persist(next, `图片模型 ${model.name || model.id} 的 ${label} 已更新${suffix}`, [model.endpointId]);
-        };
+        const save = (patch, label) => persist(updateImageModel(config, model.id, customPatch(model, patch)), t("wiz.imageModelUpdated", { name: model.name || model.id, label, suffix: customNote(managed) }), [model.endpointId]);
         return [
-            {
-                key: "name",
-                label: "名称",
-                kind: "text",
-                value: model.name || model.id,
-                initial: model.name,
-                commit: (raw) => (raw.trim() ? save({ name: raw.trim() }, "名称") : Promise.resolve("名称不能为空")),
-            },
-            {
-                key: "endpointId",
-                label: "端点",
-                kind: "enum",
-                value: findEndpoint(config, model.endpointId)?.name ?? model.endpointId,
-                options: config.endpoints.map((endpoint) => ({ label: endpoint.name || endpoint.id, value: endpoint.id })),
-                commit: (raw) => (raw === model.endpointId ? Promise.resolve(null) : save({ endpointId: raw }, "端点")),
-            },
+            nameField(model, save),
+            endpointIdField(model.endpointId, save),
             {
                 key: "modelName",
-                label: "模型名",
+                label: t("field.modelName"),
                 kind: "text",
                 value: model.modelName,
                 initial: model.modelName,
-                commit: (raw) => (raw.trim() ? save({ modelName: raw.trim() }, "模型名") : Promise.resolve("模型名不能为空")),
+                commit: (raw) => (raw.trim() ? save({ modelName: raw.trim() }, t("field.modelName")) : t("err.modelNameRequired")),
             },
             {
                 key: "defaultSize",
-                label: "尺寸",
+                label: t("field.size"),
                 kind: "text",
-                value: model.defaultSize ?? "（默认）",
+                value: model.defaultSize ?? t("common.defaultInParens"),
                 initial: model.defaultSize ?? "",
-                commit: (raw) => save({ defaultSize: raw || undefined }, "尺寸"),
+                commit: (raw) => save({ defaultSize: raw || undefined }, t("field.size")),
             },
             {
                 key: "defaultQuality",
-                label: "质量",
+                label: t("field.quality"),
                 kind: "text",
-                value: model.defaultQuality ?? "（默认）",
+                value: model.defaultQuality ?? t("common.defaultInParens"),
                 initial: model.defaultQuality ?? "",
-                commit: (raw) => save({ defaultQuality: raw || undefined }, "质量"),
+                commit: (raw) => save({ defaultQuality: raw || undefined }, t("field.quality")),
             },
             {
                 key: "custom",
-                label: "自定义",
+                label: t("field.custom"),
                 kind: "bool",
-                value: model.custom ? "是" : "否（出厂托管）",
-                toggle: () => persist(updateImageModel(config, model.id, { custom: !model.custom }), `图片模型 ${model.name || model.id} 的「自定义」已设为 ${!model.custom ? "是" : "否"}`, [model.endpointId]),
+                value: model.custom ? t("common.yes") : t("common.factoryManaged"),
+                toggle: () => persist(updateImageModel(config, model.id, { custom: !model.custom }), t("wiz.imageModelCustomSet", {
+                    name: model.name || model.id,
+                    value: !model.custom ? t("common.yes") : t("common.no"),
+                }), [model.endpointId]),
             },
         ];
     };
     /** MCP 服务器详情字段（依 transport 呈现 stdio 或 http/sse 字段） */
     const mcpServerFields = (scope, id, entry) => {
         const scopeName = scopeLabel(scope);
-        const save = (patch, label) => persistMcp(scope, updateMcpServer(mcp[scope], id, patch), `MCP ${id} 的${label}已更新（${scopeName}）`);
+        const save = (patch, label) => persistMcp(scope, updateMcpServer(mcp[scope], id, patch), t("wiz.mcpFieldUpdated", { id, label, scope: scopeName }));
         const type = entry.type ?? "stdio";
         const fields = [
             {
                 key: "id",
-                label: "名称",
+                label: t("field.name"),
                 kind: "text",
                 value: id,
                 initial: id,
                 commit: (raw) => {
                     const name = raw.trim();
                     if (!name)
-                        return Promise.resolve("名称不能为空");
+                        return t("err.nameRequired");
                     if (name === id)
-                        return Promise.resolve(null);
+                        return null;
                     if (mcpServerIdTaken(mcp[scope], name, id))
-                        return Promise.resolve(`已存在名为 ${name} 的服务器`);
-                    return persistMcp(scope, renameMcpServer(mcp[scope], id, name), `MCP ${id} 已重命名为 ${name}（${scopeName}）`).then((failure) => {
+                        return t("err.mcpNameTaken", { name });
+                    return persistMcp(scope, renameMcpServer(mcp[scope], id, name), t("wiz.mcpRenamed", { id, name, scope: scopeName })).then((failure) => {
                         if (!failure)
                             go({ kind: "mcp-server", scope, serverId: name });
                         return failure;
@@ -207,54 +271,54 @@ export function createFieldBuilders(context) {
             },
             {
                 key: "type",
-                label: "传输",
+                label: t("field.transport"),
                 kind: "enum",
                 value: type,
                 options: [
-                    { label: "stdio（本地子进程）", value: "stdio" },
-                    { label: "http（Streamable HTTP）", value: "http" },
-                    { label: "sse（Server-Sent Events）", value: "sse" },
+                    { label: t("common.transportStdio"), value: "stdio" },
+                    { label: t("common.transportHttp"), value: "http" },
+                    { label: t("common.transportSse"), value: "sse" },
                 ],
-                commit: (raw) => raw === type ? Promise.resolve(null) : save({ type: raw }, "传输方式"),
+                commit: (raw) => raw === type ? null : save({ type: raw }, t("common.transportMode")),
             },
             {
                 key: "enabled",
-                label: "启用",
+                label: t("field.enabled"),
                 kind: "bool",
-                value: entry.disabled === true ? "否（已禁用）" : "是",
-                toggle: () => save({ disabled: entry.disabled === true ? undefined : true }, "启用状态"),
+                value: entry.disabled === true ? t("common.disabledInParens") : t("common.yes"),
+                toggle: () => save({ disabled: entry.disabled === true ? undefined : true }, t("common.enabledState")),
             },
             {
                 key: "description",
-                label: "描述",
+                label: t("field.description"),
                 kind: "text",
-                value: entry.description ?? "（空）",
+                value: entry.description ?? t("common.empty"),
                 initial: entry.description ?? "",
-                commit: (raw) => save({ description: raw.trim() || undefined }, "描述"),
+                commit: (raw) => save({ description: raw.trim() || undefined }, t("field.description")),
             },
         ];
         if (type === "stdio") {
             fields.push({
                 key: "command",
-                label: "命令",
+                label: t("field.command"),
                 kind: "text",
-                value: entry.command ?? "（空）",
+                value: entry.command ?? t("common.empty"),
                 initial: entry.command ?? "",
-                commit: (raw) => save({ command: raw.trim() || undefined }, "命令"),
+                commit: (raw) => save({ command: raw.trim() || undefined }, t("field.command")),
             }, {
                 key: "args",
-                label: "参数",
+                label: t("field.args"),
                 kind: "text",
-                value: formatArgs(entry.args) || "（空）",
+                value: formatArgs(entry.args) || t("common.empty"),
                 initial: formatArgs(entry.args),
                 commit: (raw) => {
                     const args = parseArgs(raw.trim());
-                    return save({ args: args.length ? args : undefined }, "参数");
+                    return save({ args: args.length ? args : undefined }, t("field.args"));
                 },
             }, {
                 key: "env",
-                label: "环境变量",
-                kind: "map",
+                label: t("field.env"),
+                kind: "open",
                 value: kvSummary(entry.env),
                 open: () => go({ kind: "mcp-kv", scope, serverId: id, field: "env" }),
             });
@@ -264,13 +328,13 @@ export function createFieldBuilders(context) {
                 key: "url",
                 label: "URL",
                 kind: "text",
-                value: entry.url ?? "（空）",
+                value: entry.url ?? t("common.empty"),
                 initial: entry.url ?? "",
                 commit: (raw) => save({ url: raw.trim() || undefined }, "URL"),
             }, {
                 key: "headers",
-                label: "请求头",
-                kind: "map",
+                label: t("field.headers"),
+                kind: "open",
                 value: kvSummary(entry.headers),
                 open: () => go({ kind: "mcp-kv", scope, serverId: id, field: "headers" }),
             });
@@ -282,37 +346,37 @@ export function createFieldBuilders(context) {
         const kindName = agentKindLabel(kind);
         const managed = kind === "agent" && !def.custom;
         const save = (nextDef, label) => {
-            const marked = managed ? { ...nextDef, custom: true } : nextDef;
-            const suffix = managed ? "（已标记为自定义，改动才会保留）" : "";
-            return saveAgent(kind, marked, `${kindName} ${def.id} 的 ${label} 已更新${suffix}`);
+            const marked = markCustom(nextDef);
+            const suffix = customNote(managed);
+            return saveAgent(kind, marked, t("wiz.agentFieldUpdated", { kind: kindName, id: def.id, label, suffix }));
         };
         const fields = [
             {
                 key: "name",
-                label: "名称",
+                label: t("field.name"),
                 kind: "text",
                 value: def.name || def.id,
                 initial: def.name,
                 commit: (raw) => raw.trim()
-                    ? save(updateAgentDefinition(def, { name: raw.trim() }), "名称")
-                    : Promise.resolve("名称不能为空"),
+                    ? save(updateAgentDefinition(def, { name: raw.trim() }), t("field.name"))
+                    : t("err.nameRequired"),
             },
             {
                 key: "id",
-                label: "标识",
+                label: t("field.id"),
                 kind: "text",
                 value: def.id,
                 initial: def.id,
                 commit: (raw) => {
                     const name = raw.trim();
                     if (!name)
-                        return Promise.resolve("标识不能为空");
+                        return t("err.idRequired");
                     if (name === def.id)
-                        return Promise.resolve(null);
+                        return null;
                     if (agentList(store, kind).some((item) => item.id === name))
-                        return Promise.resolve(`已存在标识 ${name} 的定义`);
+                        return t("err.agentIdTaken", { name });
                     return (async () => {
-                        const failure = await saveAgent(kind, { ...def, id: name }, `${kindName} ${def.id} 已重命名为 ${name}`);
+                        const failure = await saveAgent(kind, { ...def, id: name }, t("wiz.agentRenamed", { kind: kindName, id: def.id, name }));
                         if (failure)
                             return failure;
                         await removeAgentQuiet(kind, def.id);
@@ -323,34 +387,34 @@ export function createFieldBuilders(context) {
             },
             {
                 key: "description",
-                label: "描述",
+                label: t("field.description"),
                 kind: "text",
-                value: def.description ?? "（空）",
+                value: def.description ?? t("common.empty"),
                 initial: def.description ?? "",
-                commit: (raw) => save(updateAgentDefinition(def, { description: raw.trim() || undefined }), "描述"),
+                commit: (raw) => save(updateAgentDefinition(def, { description: raw.trim() || undefined }), t("field.description")),
             },
             {
                 key: "modelId",
-                label: "模型",
+                label: t("field.model"),
                 kind: "enum",
-                value: findModel(config, def.modelId)?.name ?? def.modelId ?? "（未设置）",
+                value: findModel(config, def.modelId)?.name ?? def.modelId ?? t("common.unset"),
                 options: [
                     ...config.models.map((model) => ({ label: model.name || model.id, value: model.id })),
-                    { label: "（未设置）", value: "" },
+                    { label: t("common.unset"), value: "" },
                 ],
-                commit: (raw) => save(updateAgentDefinition(def, { modelId: raw || undefined }), "模型"),
+                commit: (raw) => save(updateAgentDefinition(def, { modelId: raw || undefined }), t("field.model")),
             },
             {
                 key: "prompt",
-                label: "提示词",
-                kind: "map",
+                label: t("field.prompt"),
+                kind: "open",
                 value: summarizeMultiline(getAgentPrompt(def)),
                 open: () => go({ kind: "agent-text", agentKind: kind, agentId: def.id, field: "prompt" }),
             },
             {
                 key: "permissions",
-                label: "权限",
-                kind: "map",
+                label: t("field.permissions"),
+                kind: "open",
                 value: summarizePermissions(def.permissions),
                 open: () => go({ kind: "agent-perms", agentKind: kind, agentId: def.id }),
             },
@@ -358,32 +422,32 @@ export function createFieldBuilders(context) {
         if (kind === "agent") {
             fields.push({
                 key: "custom",
-                label: "自定义",
+                label: t("field.custom"),
                 kind: "bool",
-                value: def.custom ? "是" : "否（出厂托管）",
-                toggle: () => save(updateAgentDefinition(def, { custom: !def.custom }), "「自定义」"),
+                value: def.custom ? t("common.yes") : t("common.factoryManaged"),
+                toggle: () => save(updateAgentDefinition(def, { custom: !def.custom }), t("common.customQuoted")),
             });
         }
         else {
             fields.push({
                 key: "fnName",
-                label: "函数名",
+                label: t("field.functionName"),
                 kind: "text",
-                value: def.function?.name ?? "（空）",
+                value: def.function?.name ?? t("common.empty"),
                 initial: def.function?.name ?? "",
                 commit: (raw) => raw.trim()
-                    ? save(updateAgentFunction(def, { name: raw.trim() }), "函数名")
-                    : Promise.resolve("函数名不能为空"),
+                    ? save(updateAgentFunction(def, { name: raw.trim() }), t("field.functionName"))
+                    : t("err.functionNameRequired"),
             }, {
                 key: "fnDesc",
-                label: "函数说明",
-                kind: "map",
+                label: t("field.functionDescription"),
+                kind: "open",
                 value: summarizeMultiline(def.function?.description ?? ""),
                 open: () => go({ kind: "agent-text", agentKind: kind, agentId: def.id, field: "fnDesc" }),
             }, {
                 key: "fnParams",
-                label: "参数 schema",
-                kind: "map",
+                label: t("field.paramsSchema"),
+                kind: "open",
                 value: summarizeMultiline(JSON.stringify(def.function?.parameters ?? {}, null, 2)),
                 open: () => go({ kind: "agent-text", agentKind: kind, agentId: def.id, field: "fnParams" }),
             });
@@ -393,17 +457,17 @@ export function createFieldBuilders(context) {
     /** 四维权限子屏字段（`allow: a, b` / `deny: x`；留空清除该维） */
     const agentPermFields = (kind, def) => PERMISSION_DIMENSIONS.map((dim) => ({
         key: dim,
-        label: dim,
+        label: t(PERMISSION_DIMENSION_LABEL_KEY[dim]),
         kind: "text",
-        value: formatAgentPermission(def.permissions, dim) || "（未设置）",
+        value: formatAgentPermission(def.permissions, dim) || t("common.unset"),
         initial: formatAgentPermission(def.permissions, dim),
         commit: (raw) => {
             const parsed = parsePermission(raw);
             if (typeof parsed === "string")
-                return Promise.resolve(parsed);
+                return parsed;
             const managed = kind === "agent" && !def.custom;
             const next = setAgentPermission(managed ? { ...def, custom: true } : def, dim, parsed);
-            return saveAgent(kind, next, `${agentKindLabel(kind)} ${def.id} 的 ${dim} 权限已更新`);
+            return saveAgent(kind, next, t("wiz.agentPermissionUpdated", { kind: agentKindLabel(kind), id: def.id, dim }));
         },
     }));
     return { endpointFields, modelFields, imageModelFields, mcpServerFields, agentFields, agentPermFields };