@michengai/dsh-skills-manager 0.1.5 → 0.1.7

package/lib/client.js

@@ -9,6 +9,178 @@ window.__ModuleLoader__.load({
     var pickDirectory = null;
     var MUTATION_HEADERS = { "content-type": "application/json", "x-dsh-skills-manager": "1" };
 
+    // 词典命名空间：注册进 DSH locale 服务，渲染机制按该命名空间把 t 注入组件 props。
+    var NS = "skills-manager";
+    // 双语词典：zh 与现有硬编码文案逐字一致，保证中文用户无感知；en 为通顺英文。
+    var DICT = {
+      zh: {
+        "title": "技能",
+        "desc": "DSH 技能可上传、启停和删除；公共 Agent 技能仅供查看。",
+        "btn.refresh": "刷新",
+        "btn.upload": "上传插件",
+        "btn.disable": "停用",
+        "btn.enable": "启用",
+        "btn.repair.enable": "修复并启用",
+        "btn.delete": "删除",
+        "btn.cancel": "取消",
+        "btn.overwrite.upload": "覆盖上传",
+        "btn.delete.confirm": "确认删除",
+        "btn.file.pick": "选择本地文件",
+        "btn.dir.pick": "选择插件文件夹",
+        "btn.uploading": "上传中…",
+        "btn.upload.dsh": "上传到 DSH",
+        "status.enabled": "已启用",
+        "status.disabled": "已停用",
+        "status.invalid": "配置异常",
+        "status.bundle": "目录插件",
+        "status.single": "单文件",
+        "status.selected": "已选择",
+        "summary.total.one": "个插件",
+        "summary.total.other": "个插件",
+        "summary.enabled.one": "个已启用",
+        "summary.enabled.other": "个已启用",
+        "summary.group": "{count} 个",
+        "note.missing": "未提供简介",
+        "empty.dir.uncreated": "目录尚未创建，上传第一个插件后会自动创建。",
+        "empty.dir.missing": "公共目录不存在。",
+        "empty.skills.none": "暂未安装插件。",
+        "loading": "加载中…",
+        "error.action": "操作失败：{error}",
+        // 列表连接符由词典侧决定：zh 用顿号/分号，en 用逗号/分号。
+        "sep.names": "、",
+        "sep.errors": "；",
+        "result.failed": "上传失败：{error}",
+        "result.partial": "部分上传成功：{names}；失败：{errors}",
+        "result.failed.only": "上传失败：{errors}",
+        "result.done": "上传完成：{names}",
+        "result.skipped": "未导入：同名插件已跳过：{names}",
+        "result.none": "未导入任何插件。",
+        "upload.title": "上传插件",
+        "upload.close": "关闭上传弹窗",
+        "upload.drop.title": "拖放 SKILL.md 文件到这里",
+        "upload.drop.copy": "或点击打开系统原生文件选择窗口",
+        "upload.hint": "请选择插件目录中的 SKILL.md；目录内其他文件会一并上传。",
+        "upload.picking.dir": "正在打开系统原生目录选择窗口…",
+        "select.file.invalid": "请选择插件目录中的 SKILL.md 文件。",
+        "select.path.missing": "已选择 SKILL.md，但当前运行环境无法读取文件路径。请点击“选择插件文件夹”继续上传。",
+        "select.failed": "选择失败：{error}",
+        "dir.selected": "已选择插件目录",
+        "dir.service.missing": "当前运行环境无法读取本地文件路径，也未提供原生目录选择服务。",
+        "dir.pick.failed": "选择插件目录失败：{error}",
+        "confirm.overwrite.title": "发现同名插件",
+        "confirm.overwrite.desc": "将覆盖现有插件：{names}",
+        "confirm.delete.title": "删除插件？",
+        "confirm.delete.desc": "“{name}”将从 DSH 技能目录中永久删除，无法恢复。",
+        // Step 2 业务错误码：zh 值保持与 core 原有中文文案逐字一致（{action} 由 action.* 映射后替换）。
+        "error.root.readonly": "公共 Agent 技能目录不允许{action}",
+        "error.skill.notFound": "技能不存在: {name}",
+        "error.skill.noFrontmatter": "技能缺少完整 frontmatter，无法{action}: {name}",
+        "error.source.notFound": "路径不存在: {path}",
+        "error.source.symlink": "不支持包含符号链接的 skill 来源: {path}",
+        "error.source.unrecognized": "无法识别的 skill 来源: {path}",
+        "error.source.tooDeep": "skill 来源目录层级超过 {depth} 层: {path}",
+        "error.import.overlap": "导入来源不能与 DSH 技能目录相同、包含或位于其中",
+        "error.import.emptySource": "目录下未找到任何 skill 条目（需含 SKILL.md 的子目录或 .md 文件）: {path}",
+        "error.import.invalidName": "无法生成合法 kebab-case 名称（原始名: {name}）",
+        "error.import.duplicateName": "批量来源中存在多个同名插件: {name}",
+        "error.import.failed": "导入失败",
+        "error.proto.forbidden": "禁止的修改请求（缺少客户端标记）",
+        "error.proto.contentType": "请求体必须是 application/json",
+        "error.proto.method": "不支持的请求方法",
+        "error.proto.unknownAction": "未知操作",
+        "error.proto.bodyTooLarge": "请求体过大",
+        "error.proto.invalidJson": "请求体不是合法 JSON",
+        "action.enable": "启用",
+        "action.disable": "停用",
+        "action.delete": "删除",
+        "action.toggle": "启用或停用",
+        "root.dsh": "DSH 技能",
+        "root.agents": "公共 Agent 技能"
+      },
+      en: {
+        "title": "Skills",
+        "desc": "DSH skills can be uploaded, enabled or disabled, and deleted; shared Agent skills are view-only.",
+        "btn.refresh": "Refresh",
+        "btn.upload": "Upload",
+        "btn.disable": "Disable",
+        "btn.enable": "Enable",
+        "btn.repair.enable": "Repair & enable",
+        "btn.delete": "Delete",
+        "btn.cancel": "Cancel",
+        "btn.overwrite.upload": "Overwrite & upload",
+        "btn.delete.confirm": "Delete",
+        "btn.file.pick": "Choose local file",
+        "btn.dir.pick": "Choose plugin folder",
+        "btn.uploading": "Uploading…",
+        "btn.upload.dsh": "Upload to DSH",
+        "status.enabled": "Enabled",
+        "status.disabled": "Disabled",
+        "status.invalid": "Invalid config",
+        "status.bundle": "Bundle",
+        "status.single": "Single file",
+        "status.selected": "Selected",
+        "summary.total.one": "skill",
+        "summary.total.other": "skills",
+        "summary.enabled.one": "enabled",
+        "summary.enabled.other": "enabled",
+        "summary.group": "{count} items",
+        "note.missing": "No description provided",
+        "empty.dir.uncreated": "The directory has not been created yet; it will be created automatically after the first upload.",
+        "empty.dir.missing": "The public directory does not exist.",
+        "empty.skills.none": "No plugins installed yet.",
+        "loading": "Loading…",
+        "error.action": "Action failed: {error}",
+        "sep.names": ", ",
+        "sep.errors": "; ",
+        "result.failed": "Upload failed: {error}",
+        "result.partial": "Partially uploaded: {names}; failed: {errors}",
+        "result.failed.only": "Upload failed: {errors}",
+        "result.done": "Upload complete: {names}",
+        "result.skipped": "Not imported: same-name plugins were skipped: {names}",
+        "result.none": "Nothing was imported.",
+        "upload.title": "Upload plugin",
+        "upload.close": "Close upload dialog",
+        "upload.drop.title": "Drop SKILL.md file here",
+        "upload.drop.copy": "or click to open the native file picker",
+        "upload.hint": "Choose a SKILL.md inside the plugin directory; other files in that directory are uploaded too.",
+        "upload.picking.dir": "Opening native directory picker…",
+        "select.file.invalid": "Please choose the SKILL.md file inside the plugin directory.",
+        "select.path.missing": "SKILL.md was selected, but this environment cannot read the file path. Click “Choose plugin folder” to continue uploading.",
+        "select.failed": "Selection failed: {error}",
+        "dir.selected": "Plugin folder selected",
+        "dir.service.missing": "This environment cannot read local file paths and provides no native directory picker.",
+        "dir.pick.failed": "Failed to choose plugin folder: {error}",
+        "confirm.overwrite.title": "Same-name plugin found",
+        "confirm.overwrite.desc": "Will overwrite existing plugin(s): {names}",
+        "confirm.delete.title": "Delete plugin?",
+        "confirm.delete.desc": "“{name}” will be permanently deleted from the DSH skills directory and cannot be recovered.",
+        "error.root.readonly": "The shared Agent skills directory does not allow {action}",
+        "error.skill.notFound": "Skill not found: {name}",
+        "error.skill.noFrontmatter": "Skill lacks complete frontmatter, cannot {action}: {name}",
+        "error.source.notFound": "Path does not exist: {path}",
+        "error.source.symlink": "Skill source containing symbolic links is not supported: {path}",
+        "error.source.unrecognized": "Unrecognized skill source: {path}",
+        "error.source.tooDeep": "Skill source directory depth exceeds the {depth}-level limit: {path}",
+        "error.import.overlap": "Import source cannot be the same as, contain, or be inside the DSH skills directory",
+        "error.import.emptySource": "No skill entries found in the directory (needs SKILL.md subdirectories or .md files): {path}",
+        "error.import.invalidName": "Cannot generate a valid kebab-case name (original name: {name})",
+        "error.import.duplicateName": "Batch source contains multiple plugins with the same name: {name}",
+        "error.import.failed": "Import failed",
+        "error.proto.forbidden": "Forbidden mutation request (missing client marker)",
+        "error.proto.contentType": "Content type must be application/json",
+        "error.proto.method": "Method not allowed",
+        "error.proto.unknownAction": "Unknown action",
+        "error.proto.bodyTooLarge": "Request body too large",
+        "error.proto.invalidJson": "Invalid JSON request body",
+        "action.enable": "enable",
+        "action.disable": "disable",
+        "action.delete": "deleting",
+        "action.toggle": "enabling or disabling",
+        "root.dsh": "DSH skills",
+        "root.agents": "Shared Agent skills"
+      }
+    };
+
     var CSS = `
 .dssm-section{display:flex;min-width:0;flex-direction:column;gap:20px;color:var(--dsw-alias-label-primary)}
 .dssm-toolbar{display:flex;align-items:flex-start;gap:16px;padding-bottom:16px;border-bottom:1px solid var(--dsw-alias-border-l2)}
@@ -27,13 +199,51 @@ window.__ModuleLoader__.load({
     function callApi(path, options) {
       return fetch("/api/dsh-skills-manager" + path, options).then(function (response) {
         return response.json().then(function (payload) {
-          if (!payload.ok) throw new Error(payload.error || ("HTTP " + response.status));
+          if (!payload.ok) {
+            var error = new Error(payload.error || ("HTTP " + response.status));
+            // 透传业务错误码与失败明细，供 translateError 按词典翻译。
+            if (payload.code) error.code = payload.code;
+            if (payload.params) error.params = payload.params;
+            if (payload.failed) error.failed = payload.failed;
+            throw error;
+          }
           return payload.data;
         });
       });
     }
 
-    function SkillManagerSection() {
+    // 翻译业务错误：payload.code 存在则查词典（params 替换占位符），词典 miss 回退原文。
+    // 兼容 { code, params, error }、Error 对象、纯字符串三种形态。
+    function translateError(t, payload) {
+      if (payload && typeof payload === "object") {
+        var code = payload.code;
+        if (typeof code === "string" && code !== "") {
+          var params = payload.params || {};
+          // {action} 占位符按当前语言映射（enable/disable/delete → 启用/停用/删除）。
+          if (params.action !== undefined) {
+            var actionKey = "action." + params.action;
+            var actionText = t(actionKey);
+            if (actionText !== undefined && actionText !== actionKey) params = Object.assign({}, params, { action: actionText });
+          }
+          var translated = t(code, params);
+          // locale miss 时 t 返回 key 本身（或 undefined/null），此时回退原文。
+          if (typeof translated === "string" && translated !== code) return translated;
+        }
+        if (payload.error !== undefined) return translateError(t, payload.error);
+        if (payload.message !== undefined) return String(payload.message);
+      }
+      return String(payload == null ? "" : payload);
+    }
+
+    // 词典命中返回翻译，miss（t 返回 key 本身或 undefined/null）回退 fallback。
+    function translateOrFallback(t, key, fallback) {
+      var value = t(key);
+      return typeof value === "string" && value !== key ? value : fallback;
+    }
+
+    // 渲染机制按 register 的 locale 字段把命名空间绑定的 t 注入组件 props。
+    function SkillManagerSection(props) {
+      var t = props.t;
       var snapshotState = react.useState({ loading: true, error: null, data: null });
       var snapshot = snapshotState[0];
       var setSnapshot = snapshotState[1];
@@ -62,7 +272,7 @@ window.__ModuleLoader__.load({
         callApi("/state").then(function (data) {
           setSnapshot({ loading: false, error: null, data: data });
         }).catch(function (error) {
-          setSnapshot({ loading: false, error: String(error && error.message || error), data: snapshot.data });
+          setSnapshot({ loading: false, error: error, data: snapshot.data });
         });
       }
 
@@ -91,19 +301,19 @@ window.__ModuleLoader__.load({
           refresh();
         }).catch(function (error) {
           setBusy(null);
-          setSnapshot({ loading: false, error: String(error && error.message || error), data: snapshot.data });
+          setSnapshot({ loading: false, error: error, data: snapshot.data });
         });
       }
 
       function selectFile(file) {
         if (!file) return;
         if (file.name.toLowerCase() !== "skill.md") {
-          setImportResult({ error: "请选择插件目录中的 SKILL.md 文件。" });
+          setImportResult({ code: "select.file.invalid" });
           return;
         }
         if (!file.path) {
           setSelected(null);
-          setImportResult({ error: "已选择 SKILL.md，但当前运行环境无法读取文件路径。请点击“选择插件文件夹”继续上传。" });
+          setImportResult({ code: "select.path.missing" });
           return;
         }
         setSelected({ name: file.name, source: file.path });
@@ -112,7 +322,7 @@ window.__ModuleLoader__.load({
 
       function selectDirectory() {
         if (!pickDirectory) {
-          setImportResult({ error: "当前运行环境无法读取本地文件路径，也未提供原生目录选择服务。" });
+          setImportResult({ code: "dir.service.missing" });
           return;
         }
         setImportResult(null);
@@ -120,12 +330,12 @@ window.__ModuleLoader__.load({
         pickDirectory().then(function (path) {
           setBusy(null);
           if (path) {
-            setSelected({ name: "已选择插件目录", source: path });
+            setSelected({ nameKey: "dir.selected", source: path });
             setImportResult(null);
           }
         }).catch(function (error) {
           setBusy(null);
-          setImportResult({ error: "选择插件目录失败：" + String(error && error.message || error) });
+          setImportResult({ code: "dir.pick.failed", params: { error: String(error && error.message || error) } });
         });
       }
 
@@ -144,7 +354,7 @@ window.__ModuleLoader__.load({
           refresh();
         }).catch(function (error) {
           setBusy(null);
-          setImportResult({ error: String(error && error.message || error) });
+          setImportResult({ error: error });
         });
       }
 
@@ -160,7 +370,7 @@ window.__ModuleLoader__.load({
           executeImport(selected.source, "skip");
         }).catch(function (error) {
           setBusy(null);
-          setImportResult({ error: String(error && error.message || error) });
+          setImportResult({ error: error });
         });
       }
 
@@ -172,70 +382,94 @@ window.__ModuleLoader__.load({
           h("div", { className: "dssm-row-main" },
             h("div", { className: "dssm-row-id" },
               h("span", { className: "dssm-row-name" }, skill.name),
-              h("span", { className: "dssm-tag" }, skill.kind === "bundle" ? "目录插件" : "单文件"),
-              h("span", { className: "dssm-tag " + (policyValid && enabled ? "dssm-tag-on" : "dssm-tag-off") }, policyValid ? (enabled ? "已启用" : "已停用") : "配置异常")),
-            h("div", { className: "dssm-note", title: skill.description || "" }, skill.description || "未提供简介")),
-          root.mutable ? h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: function () { action(actionEnabled ? "/disable" : "/enable", { name: skill.name, root: root.key }); } }, actionEnabled ? "停用" : policyValid ? "启用" : "修复并启用") : null,
-          root.mutable ? h("button", { className: "dssm-btn dssm-btn-danger", disabled: !!busy, onClick: function () { setConfirmDelete(skill); } }, "删除") : null);
+              h("span", { className: "dssm-tag" }, skill.kind === "bundle" ? t("status.bundle") : t("status.single")),
+              h("span", { className: "dssm-tag " + (policyValid && enabled ? "dssm-tag-on" : "dssm-tag-off") }, policyValid ? (enabled ? t("status.enabled") : t("status.disabled")) : t("status.invalid"))),
+            h("div", { className: "dssm-note", title: skill.description || "" }, skill.description || t("note.missing"))),
+          root.mutable ? h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: function () { action(actionEnabled ? "/disable" : "/enable", { name: skill.name, root: root.key }); } }, actionEnabled ? t("btn.disable") : policyValid ? t("btn.enable") : t("btn.repair.enable")) : null,
+          root.mutable ? h("button", { className: "dssm-btn dssm-btn-danger", disabled: !!busy, onClick: function () { setConfirmDelete(skill); } }, t("btn.delete")) : null);
       }
 
       var nodes = [h("style", { key: "css" }, CSS)];
-      if (snapshot.error) nodes.push(h("div", { key: "error", className: "dssm-error", role: "alert" }, "操作失败：" + snapshot.error));
+      if (snapshot.error) nodes.push(h("div", { key: "error", className: "dssm-error", role: "alert" }, t("error.action", { error: translateError(t, snapshot.error) })));
       if (snapshot.data) {
         var roots = snapshot.data.roots || [];
         var skills = roots.reduce(function (all, root) { return all.concat(root.skills || []); }, []);
         var enabled = skills.filter(function (skill) { return skill.modelInvocable; }).length;
         nodes.push(h("div", { key: "toolbar", className: "dssm-toolbar" },
-          h("div", null, h("h2", { className: "dssm-title" }, "技能"), h("p", { className: "dssm-desc" }, "DSH 技能可上传、启停和删除；公共 Agent 技能仅供查看。")),
+          h("div", null, h("h2", { className: "dssm-title" }, t("title")), h("p", { className: "dssm-desc" }, t("desc"))),
           h("div", { className: "dssm-actions" },
-            h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: refresh }, "刷新"),
-            h("button", { className: "dssm-btn", disabled: !!busy, onClick: function () { setImportResult(null); setUploadOpen(true); } }, "上传插件"))));
+            h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: refresh }, t("btn.refresh")),
+            h("button", { className: "dssm-btn", disabled: !!busy, onClick: function () { setImportResult(null); setUploadOpen(true); } }, t("btn.upload")))));
+        // 复数按 en 的 one/other 二元规则选择；zh/en 均适用，扩展多复数语言时需改 CLDR 规则。
         nodes.push(h("div", { key: "summary", className: "dssm-summary" },
-          h("span", { className: "dssm-summary-count" }, skills.length), h("span", { className: "dssm-summary-label" }, "个插件"), h("span", { className: "dssm-summary-separator" }), h("span", { className: "dssm-summary-count" }, enabled), h("span", { className: "dssm-summary-label" }, "个已启用")));
+          h("span", { className: "dssm-summary-count" }, skills.length), h("span", { className: "dssm-summary-label" }, t(skills.length === 1 ? "summary.total.one" : "summary.total.other", { count: skills.length })), h("span", { className: "dssm-summary-separator" }), h("span", { className: "dssm-summary-count" }, enabled), h("span", { className: "dssm-summary-label" }, t(enabled === 1 ? "summary.enabled.one" : "summary.enabled.other", { count: enabled }))));
         roots.forEach(function (root) {
           var groupSkills = root.skills || [];
           nodes.push(h("div", { key: root.key, className: "dssm-group" },
-            h("div", { className: "dssm-group-head" }, h("h3", { className: "dssm-group-title" }, root.label), h("span", { className: "dssm-count" }, groupSkills.length + " 个"), h("span", { className: "dssm-path", title: root.path }, root.path)),
-            root.exists === false ? h("div", { className: "dssm-empty" }, root.mutable ? "目录尚未创建，上传第一个插件后会自动创建。" : "公共目录不存在。") : (groupSkills.length ? groupSkills.map(function (skill) { return skillRow(skill, root); }) : h("div", { className: "dssm-empty" }, "暂未安装插件。"))));
+            h("div", { className: "dssm-group-head" }, h("h3", { className: "dssm-group-title" }, translateOrFallback(t, "root." + root.key, root.label)), h("span", { className: "dssm-count" }, t("summary.group", { count: groupSkills.length })), h("span", { className: "dssm-path", title: root.path }, root.path)),
+            root.exists === false ? h("div", { className: "dssm-empty" }, root.mutable ? t("empty.dir.uncreated") : t("empty.dir.missing")) : (groupSkills.length ? groupSkills.map(function (skill) { return skillRow(skill, root); }) : h("div", { className: "dssm-empty" }, t("empty.skills.none")))));
         });
       } else if (snapshot.loading) {
-        nodes.push(h("div", { key: "loading", className: "dssm-note" }, "加载中…"));
+        nodes.push(h("div", { key: "loading", className: "dssm-note" }, t("loading")));
       }
       if (importResult) {
+        var nameSeparator = t("sep.names");
+        var errorSeparator = t("sep.errors");
+        // 错误形态：业务/协议错误带 code，或 host 失败带 error（Error 对象）；结果形态只有 imported/failed/skipped。
+        var isImportError = importResult.code !== undefined || importResult.error !== undefined;
         var importedNames = (importResult.imported || []).map(function (item) { return item.name; });
-        var failedItems = importResult.failed || [];
+        // catch 场景把 core 的失败明细挂在 Error.failed 上，这里一并取用。
+        var failedItems = importResult.failed || (importResult.error && importResult.error.failed) || [];
         var skippedNames = (importResult.skipped || []).map(function (item) { return item.name; });
-        var failedText = failedItems.map(function (item) { return item.error; }).join("；");
-        var resultText = importResult.error ? "上传失败：" + importResult.error : failedItems.length ? (importedNames.length ? "部分上传成功：" + importedNames.join("、") + "；失败：" + failedText : "上传失败：" + failedText) : importedNames.length ? "上传完成：" + importedNames.join("、") : skippedNames.length ? "未导入：同名插件已跳过：" + skippedNames.join("、") : "未导入任何插件。";
-        nodes.push(h("div", { key: "import-result", className: importResult.error || failedItems.length ? "dssm-error" : "dssm-note", role: "status" }, resultText));
+        var failedText = failedItems.map(function (item) { return translateError(t, item); }).join(errorSeparator);
+        var resultText;
+        if (isImportError) {
+          // 顶层聚合错误优先展示已翻译的失败明细；无明细时由 translateError 兜底（含 Error 对象）。
+          resultText = t("result.failed", { error: failedItems.length ? failedText : translateError(t, importResult) });
+        } else if (failedItems.length) {
+          resultText = importedNames.length ? t("result.partial", { names: importedNames.join(nameSeparator), errors: failedText }) : t("result.failed.only", { errors: failedText });
+        } else if (importedNames.length) {
+          resultText = t("result.done", { names: importedNames.join(nameSeparator) });
+        } else if (skippedNames.length) {
+          resultText = t("result.skipped", { names: skippedNames.join(nameSeparator) });
+        } else {
+          resultText = t("result.none");
+        }
+        nodes.push(h("div", { key: "import-result", className: isImportError || failedItems.length ? "dssm-error" : "dssm-note", role: "status" }, resultText));
       }
       if (uploadOpen) {
         nodes.push(h("div", { key: "upload", className: "dssm-mask" }, h("div", { className: "dssm-modal", role: "dialog", "aria-modal": "true", "aria-labelledby": "dssm-upload-title" },
-          h("div", { className: "dssm-modal-head" }, h("h3", { id: "dssm-upload-title", className: "dssm-modal-title" }, "上传插件"), h("button", { className: "dssm-icon-btn", "aria-label": "关闭上传弹窗", onClick: function () { setUploadOpen(false); } }, "×")),
+          h("div", { className: "dssm-modal-head" }, h("h3", { id: "dssm-upload-title", className: "dssm-modal-title" }, t("upload.title")), h("button", { className: "dssm-icon-btn", "aria-label": t("upload.close"), onClick: function () { setUploadOpen(false); } }, "×")),
           h("input", { ref: inputRef, className: "dssm-hidden-input", type: "file", accept: ".md", onChange: function (event) { selectFile(event.target.files && event.target.files[0]); event.target.value = ""; } }),
-          h("div", { className: "dssm-dropzone", tabIndex: 0, onClick: openNativePicker, onKeyDown: function (event) { if (event.key === "Enter" || event.key === " ") { event.preventDefault(); openNativePicker(); } }, onDragOver: function (event) { event.preventDefault(); }, onDrop: function (event) { event.preventDefault(); selectFile(event.dataTransfer.files && event.dataTransfer.files[0]); } }, h("span", { className: "dssm-dropzone-title" }, "拖放 SKILL.md 文件到这里"), h("span", { className: "dssm-dropzone-copy" }, "或点击打开系统原生文件选择窗口")),
-          selected ? h("div", { className: "dssm-file", title: selected.source }, h("span", { className: "dssm-file-name" }, selected.name), h("span", { className: "dssm-tag dssm-tag-on" }, "已选择")) : h("p", { className: "dssm-desc" }, "请选择插件目录中的 SKILL.md；目录内其他文件会一并上传。"),
-          busy === "pick-directory" ? h("div", { className: "dssm-note", role: "status" }, "正在打开系统原生目录选择窗口…") : null,
-          importResult && importResult.error ? h("div", { className: "dssm-error", role: "alert" }, "选择失败：" + importResult.error) : null,
-          h("div", { className: "dssm-modal-actions" }, h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: openNativePicker }, "选择本地文件"), pickDirectory ? h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: selectDirectory }, "选择插件文件夹") : null, h("button", { className: "dssm-btn", disabled: !selected || !!busy, onClick: installSelected }, busy === "import" || busy === "import-check" ? "上传中…" : "上传到 DSH")))));
+          h("div", { className: "dssm-dropzone", tabIndex: 0, onClick: openNativePicker, onKeyDown: function (event) { if (event.key === "Enter" || event.key === " ") { event.preventDefault(); openNativePicker(); } }, onDragOver: function (event) { event.preventDefault(); }, onDrop: function (event) { event.preventDefault(); selectFile(event.dataTransfer.files && event.dataTransfer.files[0]); } }, h("span", { className: "dssm-dropzone-title" }, t("upload.drop.title")), h("span", { className: "dssm-dropzone-copy" }, t("upload.drop.copy"))),
+          selected ? h("div", { className: "dssm-file", title: selected.source }, h("span", { className: "dssm-file-name" }, selected.nameKey ? t(selected.nameKey) : selected.name), h("span", { className: "dssm-tag dssm-tag-on" }, t("status.selected"))) : h("p", { className: "dssm-desc" }, t("upload.hint")),
+          busy === "pick-directory" ? h("div", { className: "dssm-note", role: "status" }, t("upload.picking.dir")) : null,
+          importResult && (importResult.code !== undefined || importResult.error !== undefined) ? h("div", { className: "dssm-error", role: "alert" }, t("select.failed", { error: translateError(t, importResult) })) : null,
+          h("div", { className: "dssm-modal-actions" }, h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: openNativePicker }, t("btn.file.pick")), pickDirectory ? h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: selectDirectory }, t("btn.dir.pick")) : null, h("button", { className: "dssm-btn", disabled: !selected || !!busy, onClick: installSelected }, busy === "import" || busy === "import-check" ? t("btn.uploading") : t("btn.upload.dsh"))))));
       }
       if (confirmImport) {
-        nodes.push(h("div", { key: "import-confirm", className: "dssm-mask" }, h("div", { className: "dssm-modal", role: "dialog", "aria-modal": "true" }, h("div", { className: "dssm-modal-head" }, h("h3", { className: "dssm-modal-title" }, "发现同名插件")), h("p", { className: "dssm-desc" }, "将覆盖现有插件：" + confirmImport.conflicts.map(function (item) { return item.name; }).join("、")), h("div", { className: "dssm-modal-actions" }, h("button", { className: "dssm-btn dssm-btn-secondary", onClick: function () { setConfirmImport(null); } }, "取消"), h("button", { className: "dssm-btn", disabled: !!busy, onClick: function () { executeImport(confirmImport.source, "overwrite"); } }, "覆盖上传")))));
+        nodes.push(h("div", { key: "import-confirm", className: "dssm-mask" }, h("div", { className: "dssm-modal", role: "dialog", "aria-modal": "true" }, h("div", { className: "dssm-modal-head" }, h("h3", { className: "dssm-modal-title" }, t("confirm.overwrite.title"))), h("p", { className: "dssm-desc" }, t("confirm.overwrite.desc", { names: confirmImport.conflicts.map(function (item) { return item.name; }).join(t("sep.names")) })), h("div", { className: "dssm-modal-actions" }, h("button", { className: "dssm-btn dssm-btn-secondary", onClick: function () { setConfirmImport(null); } }, t("btn.cancel")), h("button", { className: "dssm-btn", disabled: !!busy, onClick: function () { executeImport(confirmImport.source, "overwrite"); } }, t("btn.overwrite.upload"))))));
       }
       if (confirmDelete) {
-        nodes.push(h("div", { key: "delete-confirm", className: "dssm-mask" }, h("div", { className: "dssm-modal", role: "dialog", "aria-modal": "true" }, h("div", { className: "dssm-modal-head" }, h("h3", { className: "dssm-modal-title" }, "删除插件？")), h("p", { className: "dssm-desc" }, "“" + confirmDelete.name + "”将从 DSH 技能目录中永久删除，无法恢复。"), h("div", { className: "dssm-modal-actions" }, h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: function () { setConfirmDelete(null); } }, "取消"), h("button", { className: "dssm-btn dssm-btn-danger", disabled: !!busy, onClick: function () { setConfirmDelete(null); action("/delete", { name: confirmDelete.name }); } }, "确认删除")))));
+        nodes.push(h("div", { key: "delete-confirm", className: "dssm-mask" }, h("div", { className: "dssm-modal", role: "dialog", "aria-modal": "true" }, h("div", { className: "dssm-modal-head" }, h("h3", { className: "dssm-modal-title" }, t("confirm.delete.title"))), h("p", { className: "dssm-desc" }, t("confirm.delete.desc", { name: confirmDelete.name })), h("div", { className: "dssm-modal-actions" }, h("button", { className: "dssm-btn dssm-btn-secondary", disabled: !!busy, onClick: function () { setConfirmDelete(null); } }, t("btn.cancel")), h("button", { className: "dssm-btn dssm-btn-danger", disabled: !!busy, onClick: function () { setConfirmDelete(null); action("/delete", { name: confirmDelete.name }); } }, t("btn.delete.confirm"))))));
       }
       return h("section", { className: "dssm-section" }, nodes);
     }
 
     function apply(ctx) {
       pickDirectory = function () { return ctx.workspaces.pickDirectory(); };
+      ctx.effect(function () {
+        return ctx.locale.register(NS, DICT);
+      }, "skills-manager: dictionaries");
       ctx.slots.inject("settings.section", function () {
-        return ctx.slots.register({ name: "settings.section", id: "skills-manager", order: 17, label: "技能" }, SkillManagerSection);
+        return ctx.slots.register({ name: "settings.section", id: "skills-manager", order: 17, label: function () { return ctx.locale.bind(NS)("title"); }, locale: NS }, SkillManagerSection);
       });
     }
     module.exports.apply = apply;
-    module.exports.inject = ["slots", "workspaces"];
+    module.exports.inject = ["slots", "workspaces", "locale"];
+    // 导出词典与翻译函数供零依赖对齐测试读取（宿主只消费 apply/inject，不影响运行时）。
+    module.exports.DICT = DICT;
+    module.exports.translateError = translateError;
     return module.exports;
   }
 });

package/lib/core.js

@@ -5,7 +5,10 @@
 //   - 条目形态：<root>/<name>/SKILL.md（bundle）或 <root>/<name>.md（flat），只扫一层
 //   - 前端展示 name、description 与启停状态，不做格式检查或自动修复
 //
-// 所有函数返回普通结果对象，业务校验失败返回 { ok: false, error }；文件写入错误由路由返回给调用方。
+// 所有函数返回普通结果对象，业务校验失败返回 { ok: false, error, code?, params? }；
+// error 保持中文原文（兼容性红线），code 为点分小写业务错误码，params 供前端词典占位符替换；
+// 系统异常（fs ENOENT 等）透传 String(e.message)，不加 code。
+// 文件写入错误由路由返回给调用方。
 
 import { homedir } from "node:os";
 import { join, basename, dirname, resolve, relative, isAbsolute, sep } from "node:path";
@@ -16,6 +19,23 @@ const KEBAB_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const WINDOWS_DEVICE_NAME_RE = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
 const MAX_SOURCE_DEPTH = 64;
 
+// ── 业务错误码 ────────────────────────────────────────────────────────────────
+
+/** 构造带 code/params 的业务 Error，供导入链路 throw 后透传到失败明细。 */
+function codedError(message, code, params) {
+  const error = new Error(message);
+  error.code = code;
+  error.params = params;
+  return error;
+}
+
+/** 把业务 Error 的 code/params 附加到失败明细；系统异常（ENOENT 等，非 error.* 前缀）保持原文。 */
+function attachCode(item, error) {
+  if (error && typeof error.code === "string" && /^error\./.test(error.code)) item.code = error.code;
+  if (error && error.params) item.params = error.params;
+  return item;
+}
+
 // ── 路径解析 ────────────────────────────────────────────────────────────────
 
 export function resolveDshHome() {
@@ -42,6 +62,16 @@ function dshRootPath() {
   return userRoots().find((root) => root.key === "dsh").path;
 }
 
+/** 公共 Agent 目录的只读拒绝结果；action 为可翻译语义值（toggle/delete）。 */
+function readonlyError(action) {
+  return {
+    ok: false,
+    code: "error.root.readonly",
+    params: { action },
+    error: action === "delete" ? "公共 Agent 技能目录不允许删除" : "公共 Agent 技能目录不允许启用或停用",
+  };
+}
+
 /** 判断 child 是否与 parent 相同或位于其内部。跨盘符时 relative 会返回绝对路径。 */
 function isSameOrDescendant(parent, child) {
   const rel = relative(resolve(parent), resolve(child));
@@ -252,21 +282,21 @@ export async function scanEntries(root) {
 
 /** enabled=true 恢复模型与 / 手动调用；false 同时停用两种调用入口。 */
 export async function setSkillEnabled(root, name, enabled) {
-  if (root !== dshRootPath()) return { ok: false, error: "公共 Agent 技能目录不允许启用或停用" };
+  if (root !== dshRootPath()) return readonlyError("toggle");
   const resolved = await resolveEntry(root, name);
-  if (resolved === null) return { ok: false, error: `技能不存在: ${name}` };
+  if (resolved === null) return { ok: false, error: `技能不存在: ${name}`, code: "error.skill.notFound", params: { name } };
   const source = await fs.readFile(resolved.docPath, "utf8");
   const updated = updateInvocationPolicy(source, enabled);
-  if (updated === null) return { ok: false, error: `技能缺少完整 frontmatter，无法${enabled ? "启用" : "停用"}: ${name}` };
+  if (updated === null) return { ok: false, error: `技能缺少完整 frontmatter，无法${enabled ? "启用" : "停用"}: ${name}`, code: "error.skill.noFrontmatter", params: { name, action: enabled ? "enable" : "disable" } };
   await writeFileAtomically(resolved.docPath, updated);
   return { name, enabled };
 }
 
 /** 删除 DSH 根目录中的单个技能。调用方必须先向用户确认。 */
 export async function deleteSkill(root, name, log) {
-  if (root !== dshRootPath()) return { ok: false, error: "公共 Agent 技能目录不允许删除" };
+  if (root !== dshRootPath()) return readonlyError("delete");
   const resolved = await resolveEntry(root, name);
-  if (resolved === null) return { ok: false, error: `技能不存在: ${name}` };
+  if (resolved === null) return { ok: false, error: `技能不存在: ${name}`, code: "error.skill.notFound", params: { name } };
   await fs.rm(resolved.entryPath, { recursive: resolved.kind === "bundle", force: true });
   if (log) log("delete", `删除 ${resolved.entryPath}`);
   return { name };
@@ -280,9 +310,9 @@ async function analyzeSource(source) {
   try {
     st = await fs.lstat(source);
   } catch {
-    return { kind: "none", error: `路径不存在: ${source}` };
+    return { kind: "none", error: `路径不存在: ${source}`, code: "error.source.notFound", params: { path: source } };
   }
-  if (st.isSymbolicLink()) return { kind: "none", error: `不支持包含符号链接的 skill 来源: ${source}` };
+  if (st.isSymbolicLink()) return { kind: "none", error: `不支持包含符号链接的 skill 来源: ${source}`, code: "error.source.symlink", params: { path: source } };
   if (st.isDirectory()) {
     try {
       const sk = join(source, "SKILL.md");
@@ -301,14 +331,14 @@ async function analyzeSource(source) {
     const rawName = basename(source).slice(0, -3);
     return { kind: "single", rawName, kebab: toKebab(rawName), source, isDir: false, skillFile: source };
   }
-  return { kind: "none", error: `无法识别的 skill 来源: ${source}` };
+  return { kind: "none", error: `无法识别的 skill 来源: ${source}`, code: "error.source.unrecognized", params: { path: source } };
 }
 
 async function collectCandidates(dir) {
   const items = await fs.readdir(dir, { withFileTypes: true });
   const out = [];
   for (const it of items) {
-    if (it.isSymbolicLink()) throw new Error(`不支持包含符号链接的 skill 来源: ${join(dir, it.name)}`);
+    if (it.isSymbolicLink()) throw codedError(`不支持包含符号链接的 skill 来源: ${join(dir, it.name)}`, "error.source.symlink", { path: join(dir, it.name) });
     try {
       if (it.isDirectory()) {
         const sk = join(dir, it.name, "SKILL.md");
@@ -331,14 +361,14 @@ async function assertNoSymbolicLinks(source) {
   const pending = [{ path: source, depth: 0 }];
   while (pending.length) {
     const current = pending.pop();
-    if (current.depth > MAX_SOURCE_DEPTH) throw new Error(`skill 来源目录层级超过 ${MAX_SOURCE_DEPTH} 层: ${source}`);
+    if (current.depth > MAX_SOURCE_DEPTH) throw codedError(`skill 来源目录层级超过 ${MAX_SOURCE_DEPTH} 层: ${source}`, "error.source.tooDeep", { depth: MAX_SOURCE_DEPTH, path: source });
     const st = await fs.lstat(current.path);
-    if (st.isSymbolicLink()) throw new Error(`不支持包含符号链接的 skill 来源: ${current.path}`);
+    if (st.isSymbolicLink()) throw codedError(`不支持包含符号链接的 skill 来源: ${current.path}`, "error.source.symlink", { path: current.path });
     if (!st.isDirectory()) continue;
     const items = await fs.readdir(current.path, { withFileTypes: true });
     for (const item of items) {
       const path = join(current.path, item.name);
-      if (item.isSymbolicLink()) throw new Error(`不支持包含符号链接的 skill 来源: ${path}`);
+      if (item.isSymbolicLink()) throw codedError(`不支持包含符号链接的 skill 来源: ${path}`, "error.source.symlink", { path });
       if (item.isDirectory()) pending.push({ path, depth: current.depth + 1 });
     }
   }
@@ -400,8 +430,8 @@ export async function importSkill(source, log, options = {}) {
   const dryRun = options.dryRun === true;
 
   const analysis = await analyzeSource(source);
-  if (analysis.kind === "none") return { ok: false, error: analysis.error || "无法识别的 skill 来源" };
-  if (pathsOverlap(analysis.source, targetRoot)) return { ok: false, error: "导入来源不能与 DSH 技能目录相同、包含或位于其中" };
+  if (analysis.kind === "none") return { ok: false, error: analysis.error || "无法识别的 skill 来源", code: analysis.code || "error.source.unrecognized", params: analysis.params };
+  if (pathsOverlap(analysis.source, targetRoot)) return { ok: false, error: "导入来源不能与 DSH 技能目录相同、包含或位于其中", code: "error.import.overlap" };
 
   let candidates = [];
   if (analysis.kind === "single") {
@@ -410,9 +440,9 @@ export async function importSkill(source, log, options = {}) {
     try {
       candidates = await collectCandidates(source);
     } catch (error) {
-      return { ok: false, error: String(error && error.message ? error.message : error) };
+      return attachCode({ ok: false, error: String(error && error.message ? error.message : error) }, error);
     }
-    if (candidates.length === 0) return { ok: false, error: `目录下未找到任何 skill 条目（需含 SKILL.md 的子目录或 .md 文件）: ${source}` };
+    if (candidates.length === 0) return { ok: false, error: `目录下未找到任何 skill 条目（需含 SKILL.md 的子目录或 .md 文件）: ${source}`, code: "error.import.emptySource", params: { path: source } };
   }
 
   const pending = [];
@@ -429,7 +459,9 @@ export async function importSkill(source, log, options = {}) {
   function failureResult() {
     return {
       ok: false,
+      // 聚合失败明细的原文；前端优先展示已翻译的 failed 明细，此处仅作兜底。
       error: failed.map((item) => item.error).join("；"),
+      code: "error.import.failed",
       kind: analysis.kind,
       imported,
       skipped,
@@ -439,11 +471,11 @@ export async function importSkill(source, log, options = {}) {
 
   for (const c of candidates) {
     if (!c.kebab || !KEBAB_RE.test(c.kebab)) {
-      failed.push({ source: c.source, error: `无法生成合法 kebab-case 名称（原始名: ${c.rawName || basename(c.source)}）` });
+      failed.push({ source: c.source, error: `无法生成合法 kebab-case 名称（原始名: ${c.rawName || basename(c.source)}）`, code: "error.import.invalidName", params: { name: c.rawName || basename(c.source) } });
       continue;
     }
     if (nameCount.get(c.kebab) > 1) {
-      failed.push({ source: c.source, error: `批量来源中存在多个同名插件: ${c.kebab}` });
+      failed.push({ source: c.source, error: `批量来源中存在多个同名插件: ${c.kebab}`, code: "error.import.duplicateName", params: { name: c.kebab } });
       continue;
     }
     const dest = c.isDir ? join(targetRoot, c.kebab) : join(targetRoot, `${c.kebab}.md`);
@@ -475,7 +507,7 @@ export async function importSkill(source, log, options = {}) {
       imported.push({ name: p.name, overwritten: false, warnings });
       if (log) log("import", `导入 ${p.source} -> ${p.dest}`);
     } catch (e) {
-      failed.push({ source: p.source, error: String(e && e.message ? e.message : e) });
+      failed.push(attachCode({ source: p.source, error: String(e && e.message ? e.message : e) }, e));
     }
   }
 
@@ -487,7 +519,7 @@ export async function importSkill(source, log, options = {}) {
         imported.push({ name: c.name, overwritten: true, warnings });
         if (log) log("import-overwrite", `覆盖导入 ${c.source} -> ${dest}`);
       } catch (e) {
-        failed.push({ source: c.source, error: String(e && e.message ? e.message : e) });
+        failed.push(attachCode({ source: c.source, error: String(e && e.message ? e.message : e) }, e));
       }
     }
   } else {

package/lib/index.js

@@ -47,6 +47,7 @@ function readBody(req, limit = 1 << 20) {
       if (size > limit) {
         const error = new Error("body too large");
         error.statusCode = 413;
+        error.code = "error.proto.bodyTooLarge";
         fail(error);
         req.resume();
         return;
@@ -63,6 +64,7 @@ function readBody(req, limit = 1 << 20) {
       } catch (e) {
         const error = new Error(`invalid JSON body: ${e.message}`);
         error.statusCode = 400;
+        error.code = "error.proto.invalidJson";
         fail(error);
       }
     });
@@ -72,9 +74,9 @@ function readBody(req, limit = 1 << 20) {
 
 /** 自定义请求头使跨站 fetch 必须预检；本地接口不提供 CORS 响应。 */
 function validateMutationRequest(req) {
-  if (req.headers[CLIENT_MARKER_HEADER] !== "1") return { statusCode: 403, error: "forbidden mutation request" };
+  if (req.headers[CLIENT_MARKER_HEADER] !== "1") return { statusCode: 403, code: "error.proto.forbidden", error: "forbidden mutation request" };
   const contentType = String(req.headers["content-type"] || "").split(";", 1)[0].trim().toLowerCase();
-  if (contentType !== "application/json") return { statusCode: 415, error: "content-type must be application/json" };
+  if (contentType !== "application/json") return { statusCode: 415, code: "error.proto.contentType", error: "content-type must be application/json" };
   return null;
 }
 
@@ -134,7 +136,7 @@ function apply(ctx) {
           return;
         }
         if (req.method !== "POST") {
-          json(res, 405, { ok: false, error: `method not allowed: ${req.method}` });
+          json(res, 405, { ok: false, code: "error.proto.method", error: `method not allowed: ${req.method}` });
           return;
         }
         const requestError = validateMutationRequest(req);
@@ -145,11 +147,11 @@ function apply(ctx) {
         const body = await readBody(req);
         switch (path) {
           case "/api/dsh-skills-manager/enable": {
-            run(res, String(body.root || "dsh") === "dsh" ? setSkillEnabled(rootByKey.dsh, String(body.name || ""), true) : Promise.resolve({ ok: false, error: "公共 Agent 技能目录不允许启用或停用" }), invalidateSkills);
+            run(res, setSkillEnabled(rootByKey[String(body.root || "dsh")], String(body.name || ""), true), invalidateSkills);
             return;
           }
           case "/api/dsh-skills-manager/disable": {
-            run(res, String(body.root || "dsh") === "dsh" ? setSkillEnabled(rootByKey.dsh, String(body.name || ""), false) : Promise.resolve({ ok: false, error: "公共 Agent 技能目录不允许启用或停用" }), invalidateSkills);
+            run(res, setSkillEnabled(rootByKey[String(body.root || "dsh")], String(body.name || ""), false), invalidateSkills);
             return;
           }
           case "/api/dsh-skills-manager/delete": {
@@ -163,10 +165,14 @@ function apply(ctx) {
             }), body.dryRun === true ? undefined : invalidateSkills);
             return;
           default:
-            json(res, 404, { ok: false, error: `unknown action: ${path}` });
+            json(res, 404, { ok: false, code: "error.proto.unknownAction", error: `unknown action: ${path}` });
         }
       } catch (e) {
-        json(res, Number.isInteger(e && e.statusCode) ? e.statusCode : 500, { ok: false, error: String(e && e.message ? e.message : e) });
+        json(res, Number.isInteger(e && e.statusCode) ? e.statusCode : 500, {
+          ok: false,
+          ...(e && e.code ? { code: e.code } : {}),
+          error: String(e && e.message ? e.message : e),
+        });
       }
     },
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-skills-manager",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "NPM-installable DSH Web plugin for managing local skills and viewing shared Agent skills safely.",
   "license": "Apache-2.0",
   "repository": {
@@ -31,13 +31,14 @@
       "inject": [
         "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-workspace"
       ],
       "platform": "web"
     }
   },
   "scripts": {
-    "test": "node test/core-test.mjs",
+    "test": "node test/core-test.mjs && node test/locale-test.mjs",
     "pack:check": "npm pack --dry-run --json",
     "prepublishOnly": "npm test"
   },
@@ -49,6 +50,7 @@
     "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",
     "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.0 <0.2.0",
     "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.0 <0.2.0",
     "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.5",
     "@deepseek-ai/dsh-skill": ">=0.1.0-rc.5",
     "@deepseek-ai/dsh-client-ui-workspace": ">=0.1.0-rc.5",