dsh-armory 2.2.0 → 2.2.1

package/lib/client.js

@@ -46,15 +46,54 @@ const { useState, useEffect, useCallback, useMemo, useRef } = React2;
 // 将来加新语言可改走 require.async 外部字典文件。
 const i18nMessages = {};
 const setI18nMessages = (table) => { Object.assign(i18nMessages, table || {}); };
-// OPT-14 · 1.1 locale 判定：localStorage 偏好 → navigator.language → zh-CN 回落。
-// 所有失败路径（存储不可用、无 navigator）都静默回落，绝不抛错影响面板加载。
-const I18N_LOCALE = (() => {
+const resetI18nMessages = () => { for (const key of Object.keys(i18nMessages)) delete i18nMessages[key]; };
+// OPT-14 · 1.1 / OPT-25 locale 判定（首个命中即返回）：
+//   ① localStorage['dsh-armory.locale'] —— 显式覆盖（测试与高级用户）
+//   ② DSH 宿主 locale.active —— 设置 → 通用里的语言，用户真正看到的 UI 语言
+//   ③ navigator.language —— 宿主 locale 不可用时的浏览器回落
+//   ④ zh-CN —— 源语言兜底
+// 只读 navigator 是 2.2.0 及以前的做法：中文系统 + DSH 设英文时 navigator 仍是
+// zh-CN，英文表永远不装载（issue #1 的根因）。宿主服务用 ctx.get('locale') 取，
+// **不写进 inject**——老版本 DSH 没有该服务时仍能照常加载。
+// 所有失败路径（存储不可用、无 navigator、宿主快照抛错）都静默回落，绝不抛错。
+const readStoredI18nLocale = () => {
   try {
-    const stored = localStorage['dsh-armory.locale'];
-    if (stored) return stored;
-  } catch { /* 存储不可用时跳过偏好，继续往下回落 */ }
-  return typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'zh-CN';
-})();
+    return localStorage['dsh-armory.locale'] || null;
+  } catch { return null; }
+};
+const hostActiveLocale = (localeService) => {
+  try {
+    const snapshot = localeService && typeof localeService.getSnapshot === 'function' ? localeService.getSnapshot() : null;
+    return snapshot && typeof snapshot.active === 'string' && snapshot.active ? snapshot.active : null;
+  } catch { return null; }
+};
+const initialI18nLocale = readStoredI18nLocale()
+  || (typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'zh-CN');
+let I18N_LOCALE = initialI18nLocale;
+const resolveI18nLocale = (localeService) => readStoredI18nLocale()
+  || hostActiveLocale(localeService)
+  || initialI18nLocale
+  || 'zh-CN';
+// 切换语言时必须先清空旧字典：中文（源语言）要求空表才能恒等直出，
+// 否则从 en 切回 zh 会残留英文译文。
+// P1：源语言是中文、唯一译文是英文，所以按「zh* → 中文，其余 → 英文」判定。
+// 非 zh 的非英文语言（ja / de / fr…）宁可给英文，也不把中文丢给看不懂的用户；
+// en* 之外的显式覆盖同理。新增第三种语言时才需要把这里改成精确查表。
+const isChineseLocale = (locale = I18N_LOCALE) => String(locale || '').toLowerCase().startsWith('zh');
+const usesEnglish = (locale = I18N_LOCALE) => !isChineseLocale(locale);
+const applyI18nLocale = (locale) => {
+  I18N_LOCALE = locale || initialI18nLocale || 'zh-CN';
+  resetI18nMessages();
+  if (usesEnglish()) setI18nMessages(EN_US_MESSAGES);
+  return I18N_LOCALE;
+};
+// 宿主 locale 订阅：包一层 try/catch，服务没实现 subscribe 或抛错都不影响面板。
+const subscribeI18nLocale = (localeService, listener) => {
+  try {
+    if (localeService && typeof localeService.subscribe === 'function') return localeService.subscribe(listener);
+  } catch { /* 订阅失败：保留启动时判定的语言 */ }
+  return null;
+};
 const EN_US_MESSAGES = {
  " + 捆绑技能": " + bundled skills",
  " · {0} 个失败": " · {0} failed",
@@ -967,9 +1006,10 @@ const EN_US_MESSAGES = {
 
   "：": ": ",
 };
-// OPT-14 · 1.1：仅当判定为英文 locale 时装载 en-US 表；zh-CN（源语言）保持空字典
-// 恒等直出，其他语言缺键也原样回落，不出现 key 名。
-if (I18N_LOCALE && I18N_LOCALE.toLowerCase().startsWith('en')) setI18nMessages(EN_US_MESSAGES);
+// 模块加载时先用 ①/③ 判定的 locale 装载一次；apply() 拿到宿主 locale 后会再按
+// ② 重算（见 applyI18nLocale）。zh-CN（源语言）保持空字典恒等直出，其他语言
+// 缺键也原样回落，不出现 key 名。
+applyI18nLocale(I18N_LOCALE);
 const t = (s, vars) => {
   let text = i18nMessages[s] || s;
   if (vars && vars.length) {
@@ -977,6 +1017,59 @@ const t = (s, vars) => {
   }
   return text;
 };
+// OPT-25：宿主切换语言后通知已挂载的界面重渲染。模块级文案表已改为 getter /
+// 函数（见 ENTRY_LABELS / SKILL_CATS 等），重渲染时就会读到新字典，不需要重载页面。
+// 订阅者失败隔离：一个组件抛错不影响其它组件更新。
+const i18nChangeListeners = new Set();
+const emitI18nChange = () => {
+  for (const listener of [...i18nChangeListeners]) {
+    try { listener(); } catch { /* 单个订阅者失败不影响其它订阅者 */ }
+  }
+};
+const onI18nChange = (listener) => {
+  i18nChangeListeners.add(listener);
+  return () => { i18nChangeListeners.delete(listener); };
+};
+// 顶层槽位组件调用一次即可：locale 变化时强制自身重渲染。
+const useI18nRevision = () => {
+  const [, setRevision] = useState(0);
+  useEffect(() => onI18nChange(() => setRevision((value) => value + 1)), []);
+};
+
+// ── P1：数据型英文覆盖（更新日志 / 内置 MCP 目录）───────────────────────────
+// 这两类文案不是 UI 字面量，而是宿主随 RPC 送来的数据：更新日志在 whats-new.js，
+// 目录在生成的 mcp-catalog.js。它们不能走 t() 字典（键集合由那两个文件决定，硬抄
+// 进字典会让 i18n-coverage 的「死键」断言永久变红），所以由宿主同时送中文与英文
+// 字段，客户端按当前 locale 选择。英文缺失时逐条回落中文，绝不渲染 undefined。
+//
+// 两个 helper 的 `english` 参数只用于测试时显式指定；运行时用当前 locale 判定。
+const localizeWhatsNewEntries = (entries, english = usesEnglish()) => {
+  if (!english || !Array.isArray(entries)) return entries;
+  return entries.map((entry) => ({
+    ...entry,
+    items: Array.isArray(entry.items)
+      ? entry.items.map((item) => ({
+          ...item,
+          text: item.textEn || item.text,
+          ...(item.whereEn ? { where: item.whereEn } : {}),
+        }))
+      : [],
+  }));
+};
+const localizeBuiltinItem = (item, english = usesEnglish()) => {
+  if (!english || !item) return item;
+  const authNote = item.authNoteEn || item.authNote;
+  // 只在英文字段真的存在时才覆盖：缺译文时保留原键（连 undefined 键都不新增），
+  // 面板据此区分「没有说明」与「说明是空的」。
+  return {
+    ...item,
+    ...(item.labelEn ? { label: item.labelEn } : {}),
+    ...(item.summaryEn ? { summary: item.summaryEn } : {}),
+    ...(item.accessEn ? { access: item.accessEn } : {}),
+    ...(authNote ? { authNote } : {}),
+    ...(item.categoryLabelEn ? { categoryLabel: item.categoryLabelEn } : {}),
+  };
+};
 
 // ── 旧插件名 → 新插件名的 localStorage 键迁移 ──────────────────────────────
 // 1.9.0 起本插件由 dsh-skill-mcp-board 更名为 dsh-armory（package.json 与
@@ -2661,10 +2754,16 @@ const useFocusTrap = (ref, active) => {
 
 const MAX_TIMER_DELAY_MS = 2147483647;
 const REDACTED_VALUE = '__DSH_MCP_REDACTED__';
-const PRESERVED_VALUE_LABEL = t('••••••（保留原值）');
+// 屏蔽值在表单里需要**稳定哨兵**：locale 切换后译文会变，但已填进 state 的旧
+// 字符串不能随译文一起变，否则 toFormValue/fromFormValue 的相等判定会失配。
+// 因此内部只存 ASCII 哨兵，展示层再映射成当前语言的文案。
+const PRESERVED_VALUE_TOKEN = '__DSH_MCP_PRESERVED__';
+const preservedValueLabel = () => t('••••••（保留原值）');
 const MASKED_VALUE = '••••••';
-const toFormValue = (value) => value === REDACTED_VALUE ? PRESERVED_VALUE_LABEL : String(value || '');
-const fromFormValue = (value) => value === PRESERVED_VALUE_LABEL ? REDACTED_VALUE : value;
+const toFormValue = (value) => value === REDACTED_VALUE ? PRESERVED_VALUE_TOKEN : String(value || '');
+const fromFormValue = (value) => value === PRESERVED_VALUE_TOKEN ? REDACTED_VALUE : value;
+// args 是「每行一个」的多行串，哨兵可能夹在中间，所以按 token 全量替换而不是只比整串。
+const displayFormValue = (value) => String(value ?? '').split(PRESERVED_VALUE_TOKEN).join(preservedValueLabel());
 const displayValue = (value) => value === REDACTED_VALUE ? MASKED_VALUE : value;
 function setOwn(target, key, value) {
   Object.defineProperty(target, key, { value, enumerable: true, configurable: true, writable: true });
@@ -3242,8 +3341,9 @@ const Pager = ({ page, pageCount, total, onPage, disabled }) => {
 // oauth-or-pat）+ 有则挂 authNote。**这与市场连接器 tab 的 authMode 不是一回事**：
 // authMode 是上游 connectors 清单里的自由文本，只能原样显示；auth 是枚举，可以映射
 // 成人能读的标签。未知枚举值原样显示，绝不猜。
-const AUTH_KIND_LABELS = { none: t('免认证'), apiKey: 'API Key', oauth: 'OAuth', 'oauth-or-pat': 'OAuth / PAT' };
-const authKindLabel = (kind) => AUTH_KIND_LABELS[kind] || kind;
+const AUTH_KIND_LABELS = { apiKey: 'API Key', oauth: 'OAuth', 'oauth-or-pat': 'OAuth / PAT' };
+// 惰性求值：模块加载时宿主 locale 还没接进来，只有 none 需要翻译。
+const authKindLabel = (kind) => (kind === 'none' ? t('免认证') : AUTH_KIND_LABELS[kind] || kind);
 // 色语沿用 §1.3：oauth 系装完还得去浏览器授权，属「还需注意」→ 橙；apiKey 有既有
 // 「需密钥」徽章兜住，这里只作信息性标注，用默认灰。
 const authBadgeCls = (kind) => (kind === 'oauth' || kind === 'oauth-or-pat' ? 's-warn' : '');
@@ -3778,7 +3878,7 @@ const AddEditModal = ({ open, onClose, onSubmit, busy, initial, onRevealValue, r
   const kv = (rows, setRows, i, field, v) => {
     const next = rows.slice();
     const row = { ...next[i], [field]: v };
-    if (field === 'k' && row.v === PRESERVED_VALUE_LABEL && v !== row.originalKey) row.v = '';
+    if (field === 'k' && row.v === PRESERVED_VALUE_TOKEN && v !== row.originalKey) row.v = '';
     next[i] = row;
     setRows(next);
   };
@@ -3790,7 +3890,7 @@ const AddEditModal = ({ open, onClose, onSubmit, busy, initial, onRevealValue, r
     : value && typeof value === 'object'
       ? Object.entries(value).map(([key, item]) => `${key}=${typeof item === 'object' ? JSON.stringify(item) : String(item)}`).join('\n')
       : String(value ?? '');
-  const visibleEditValue = (field, key, fallback) => Object.hasOwn(editRevealed, editRevealId(field, key)) ? editRevealed[editRevealId(field, key)] : fallback;
+  const visibleEditValue = (field, key, fallback) => Object.hasOwn(editRevealed, editRevealId(field, key)) ? editRevealed[editRevealId(field, key)] : displayFormValue(fallback);
   const hideEditReveal = (field, key) => setEditRevealed((prev) => {
     const next = { ...prev };
     delete next[editRevealId(field, key)];
@@ -3882,7 +3982,7 @@ const AddEditModal = ({ open, onClose, onSubmit, busy, initial, onRevealValue, r
             h('label', null, 'URL'),
             h('div', { className: 'dsh-mcp-input-action' },
               h('input', { value: visibleEditValue('url', undefined, url), onChange: (e) => { hideEditReveal('url'); setUrl(e.target.value); }, placeholder: 'https://example.com/mcp' }),
-              editing && url === PRESERVED_VALUE_LABEL ? revealIcon('url', 'URL', () => toggleEditReveal('url')) : null,
+              editing && url === PRESERVED_VALUE_TOKEN ? revealIcon('url', 'URL', () => toggleEditReveal('url')) : null,
             ),
           )
         : h('div', null,
@@ -3891,7 +3991,7 @@ const AddEditModal = ({ open, onClose, onSubmit, busy, initial, onRevealValue, r
               h('label', null, t('参数（每行一个，原样传给进程）')),
               h('div', { className: 'dsh-mcp-input-action' },
                 h('textarea', { rows: 4, value: visibleEditValue('args', undefined, args), onChange: (e) => { hideEditReveal('args'); setArgs(e.target.value); }, placeholder: '-y\nmcp-server@latest' }),
-                editing && args === PRESERVED_VALUE_LABEL ? revealIcon('args', t('参数'), () => toggleEditReveal('args')) : null,
+                editing && args === PRESERVED_VALUE_TOKEN ? revealIcon('args', t('参数'), () => toggleEditReveal('args')) : null,
               ),
             ),
             h('div', { className: 'dsh-mcp-field' }, h('label', null, t('工作目录 cwd（可选）')), h('input', { value: cwd, onChange: (e) => setCwd(e.target.value), placeholder: 'C:\\path\\to\\workspace' })),
@@ -3906,7 +4006,7 @@ const AddEditModal = ({ open, onClose, onSubmit, busy, initial, onRevealValue, r
             h('input', { placeholder: transport === 'http' ? 'Authorization' : 'API_KEY', value: row.k, onChange: (e) => { hideEditReveal(field, originalKey); kv(kvRows, setKvRows, i, 'k', e.target.value); } }),
             h('input', { placeholder: transport === 'http' ? t('Bearer … 或 !!js process.env.KEY') : 'value', value: visibleEditValue(field, originalKey, row.v), onChange: (e) => { hideEditReveal(field, originalKey); kv(kvRows, setKvRows, i, 'v', e.target.value); } }),
             h('div', { className: 'dsh-mcp-kv-row-actions' },
-              editing && row.v === PRESERVED_VALUE_LABEL ? revealIcon(id, row.k, () => toggleEditReveal(field, originalKey)) : null,
+              editing && row.v === PRESERVED_VALUE_TOKEN ? revealIcon(id, row.k, () => toggleEditReveal(field, originalKey)) : null,
               h('button', { type: 'button', className: 'dsh-mcp-kv-del', onClick: () => delRow(kvRows, setKvRows, i), title: t('删除此项'), 'aria-label': t('删除 ') + (row.k || t('配置项')) }, '✕'),
             ),
           );
@@ -4869,12 +4969,14 @@ const ENTRY_VISIBILITY = {
   sidebar: { panel: false, fab: false, sidebar: true },
   all: { panel: true, fab: true, sidebar: true },
 };
+// getter 而不是模块加载时求值：apply() 拿到宿主 locale 后文案才正确，
+// 且切语言后重渲染能直接读到新译文。
 const ENTRY_LABELS = {
-  both: t('全局面板 + 悬浮按钮（推荐）'),
-  panel: t('仅全局面板（左上角，"插件"旁）'),
-  fab: t('仅悬浮按钮'),
-  sidebar: t('仅侧栏底部入口'),
-  all: t('三个入口全开'),
+  get both() { return t('全局面板 + 悬浮按钮（推荐）'); },
+  get panel() { return t('仅全局面板（左上角，"插件"旁）'); },
+  get fab() { return t('仅悬浮按钮'); },
+  get sidebar() { return t('仅侧栏底部入口'); },
+  get all() { return t('三个入口全开'); },
 };
 const ENTRY_DEFAULT = 'both';
 const ENTRY_MODES = Object.keys(ENTRY_VISIBILITY);
@@ -4946,22 +5048,24 @@ const PANEL_ID = 'mcp-manager';
 // 入口排序：插件管理器用 0，定时任务用 10；取 5 让本入口正好落在「插件」旁边。
 const PANEL_ORDER = 5;
 // 看板五分类（MCP / Skill / 专家 / 工具裁缝 / 市场）随名称一并示人。
-const PANEL_LABEL = t('技能 · MCP · 专家');
-// 左上角侧栏入口（sidebar.panellist）单独命名，与 PANEL_LABEL 解耦：
+// 函数而非常量：槽位注册发生在 apply() 里，那时才拿到宿主 locale。
+const panelLabel = () => t('技能 · MCP · 专家');
+// 左上角侧栏入口（sidebar.panellist）单独命名，与 panelLabel() 解耦：
 // 该行的 label 同时是可见文字、无障碍名称和折叠提示，改动不牵动输入框快捷菜单、
 // 会话头专家徽章、悬浮按钮和侧栏底部入口的文案。
-const SIDEBAR_ENTRY_LABEL = t('大肥鱼军械库');
+const sidebarEntryLabel = () => t('大肥鱼军械库');
 
 // skill 的 source 取值域来自官方 dsh-skill-filesystem 的 roots()（rank 顺序即优先级），
 // 与 skill-registry 的 runtime。这里只做展示文案，不参与判定。
+// getter 保证每次读取都按当前 locale 翻译（切语言后重渲染即生效）。
 const SKILL_SOURCE_LABELS = {
-  'project-dsh': t('项目 .dsh/skills'),
-  'project-agents': t('项目 .agents/skills'),
-  custom: t('自定义目录'),
-  'user-dsh': t('用户 ~/.dsh/skills'),
-  'user-agents': t('用户 ~/.agents/skills'),
-  bundled: t('随 DSH 分发'),
-  runtime: t('运行时注册'),
+  get 'project-dsh'() { return t('项目 .dsh/skills'); },
+  get 'project-agents'() { return t('项目 .agents/skills'); },
+  get custom() { return t('自定义目录'); },
+  get 'user-dsh'() { return t('用户 ~/.dsh/skills'); },
+  get 'user-agents'() { return t('用户 ~/.agents/skills'); },
+  get bundled() { return t('随 DSH 分发'); },
+  get runtime() { return t('运行时注册'); },
 };
 const skillSourceLabel = (source) => SKILL_SOURCE_LABELS[source] || (source || t('未知来源'));
 
@@ -4977,24 +5081,24 @@ const skillRemovable = (source) => SKILL_REMOVABLE_SOURCES.has(String(source ||
 // （跨类污染最小者优先），未命中再扫弱特征词，仍未命中落「未分类」——保证不丢条目。
 // 匹配对象 = name + ' ' + description 的小写串；首个命中即定类。关键词表允许实现方微调。
 const SKILL_CATS = [
-  { key: 'all', name: t('全部'), color: 'var(--mcp-cat-all)' },
-  { key: 'dev', name: t('编程开发'), color: 'var(--mcp-cat-dev)',
+  { key: 'all', get name() { return t('全部'); }, color: 'var(--mcp-cat-all)' },
+  { key: 'dev', get name() { return t('编程开发'); }, color: 'var(--mcp-cat-dev)',
     strong: ['skill p8', 'arkts', 'arkui', '微信小程序', '小程序', '后端', '数据库', 'mysql', 'mariadb', 'api 设计', 'api设计', 'bug 诊断', 'bug诊断', '代码审查', '代码生成', '代码可读', '重构', '测试用例', '全栈', 'karpathy', 'spec 驱动', 'image-to-code', 'mcp server', 'sdk', 'monorepo', '源码'],
     weak: ['code', 'coding', 'developer', 'typescript', 'javascript', 'python', 'rust', 'sql', '编程', '开发'] },
-  { key: 'design', name: t('设计与创作'), color: 'var(--mcp-cat-design)',
+  { key: 'design', get name() { return t('设计与创作'); }, color: 'var(--mcp-cat-design)',
     strong: ['imagegen', '品牌', 'brandkit', 'logo', '海报', 'stitch', 'mockup', '图标', '插画', '视频生成', '视频编辑', '视频翻译', '素材分析', '内容生产', '内容合成', '设计稿', '设计系统', 'landing page', '配图', '设计'],
     weak: ['design', '创作', 'image', 'video', '视觉', '前端', 'frontend', '页面'] },
-  { key: 'office', name: t('文档办公'), color: 'var(--mcp-cat-office)',
+  { key: 'office', get name() { return t('文档办公'); }, color: 'var(--mcp-cat-office)',
     strong: ['docx', 'xlsx', 'pptx', 'pdf', 'word 文档', 'excel', 'powerpoint', '文档', '公文', '报告', '表格', '幻灯', '公式缓存', 'libreoffice'],
     weak: ['office', '写作', 'markdown', '笔记'] },
-  { key: 'auto', name: t('效率与自动化'), color: 'var(--mcp-cat-auto)',
+  { key: 'auto', get name() { return t('效率与自动化'); }, color: 'var(--mcp-cat-auto)',
     strong: ['browser', '浏览器', '定时', 'schedule', 'workflow', '工作流', '自动化', '批量', '表单填写', '数据提取', '提醒'],
     weak: ['自动', '效率', '抓取', '搜索'] },
-  { key: 'ops', name: t('开发运维'), color: 'var(--mcp-cat-ops)',
+  { key: 'ops', get name() { return t('开发运维'); }, color: 'var(--mcp-cat-ops)',
     strong: ['sandbox', '沙箱', 'acl', '运维', '部署', 'deploy', 'release', '发布', '排查', '诊断', '环境', '崩溃', '代理下载', '签名', '供应链'],
     weak: ['debug', 'windows', '安装', '升级', '更新'] },
 ];
-const SKILL_UNCAT = { key: 'uncat', name: t('未分类'), color: 'var(--mcp-cat-uncat)' };
+const SKILL_UNCAT = { key: 'uncat', get name() { return t('未分类'); }, color: 'var(--mcp-cat-uncat)' };
 // skillcat hash 值合法性校验用。
 const SKILL_CAT_KEYS = new Set(SKILL_CATS.map((c) => c.key));
 const skillCatByKey = (key) => SKILL_CATS.find((c) => c.key === key) || null;
@@ -5026,10 +5130,10 @@ const skillScopeArg = (scope) => (scope === 'global' ? {} : { cwd: scope });
 // OPT-16 · 3.2：专家详情弹层 persona 预览截断阈值（展开全文后渲染完整原文）。
 const PERSONA_PREVIEW_MAX = 4000;
 const TAILOR_WINDOWS = [
-  { key: '1', label: t('今日'), days: 1 }, // OPT-24b · 4.1：今日档，回答「刚配置完它到底被调了几次」
-  { key: '7', label: t('近 7 天'), days: 7 },
-  { key: '30', label: t('近 30 天'), days: 30 },
-  { key: '90', label: t('近 90 天'), days: 90 },
+  { key: '1', get label() { return t('今日'); }, days: 1 }, // OPT-24b · 4.1：今日档，回答「刚配置完它到底被调了几次」
+  { key: '7', get label() { return t('近 7 天'); }, days: 7 },
+  { key: '30', get label() { return t('近 30 天'); }, days: 30 },
+  { key: '90', get label() { return t('近 90 天'); }, days: 90 },
 ];
 const fmtInt = (n) => (typeof n === 'number' ? n.toLocaleString(I18N_LOCALE || 'zh-CN') : '—'); // OPT-14 · 1.2：跟随 locale 回落
 // OPT-18 · 4.2 零值显性化：zstd 不可用时所有调用计数恒为 0（解不出帧），这个 0 是「测不到」
@@ -5380,19 +5484,19 @@ const ToolTailor = ({ call, timer, report: reportProp, onReport, seedPending })
 const BOARD_CATEGORIES = [
   { key: 'mcp', label: 'MCP', icon: 'plug' },
   { key: 'skill', label: 'Skill', icon: 'skill' },
-  { key: 'expert', label: t('专家'), icon: 'expert' },
-  { key: 'tailor', label: t('工具裁缝'), icon: 'scissors' },
-  { key: 'wb', label: t('市场'), icon: 'store' },
+  { key: 'expert', get label() { return t('专家'); }, icon: 'expert' },
+  { key: 'tailor', get label() { return t('工具裁缝'); }, icon: 'scissors' },
+  { key: 'wb', get label() { return t('市场'); }, icon: 'store' },
 ];
 // 分类摘要文案表：把「这一页到底有什么」压成一句话 + 两三行事实。
 // 拆成纯数据而不是写在渲染里，是因为它同时被 hover 浮层和键盘焦点复用，
 // 且后面加分类时只要补一条，不必改渲染逻辑。
 const CATEGORY_BLURB = {
-  mcp: t('按服务器看工具清单、连接状态与参数；可增删、重连、导入。'),
-  skill: t('本地 Skill 清单：来源、是否启用、是否可被模型调用。'),
-  expert: t('已召唤的专家：人设、捆绑技能、当前在场状态，可送还。'),
-  tailor: t('工具使用账本：谁在被调用、谁在白缴上下文税。'),
-  wb: t('市场：连接器、内置 MCP、SkillHub 技能与专家召唤。'),
+  get mcp() { return t('按服务器看工具清单、连接状态与参数；可增删、重连、导入。'); },
+  get skill() { return t('本地 Skill 清单：来源、是否启用、是否可被模型调用。'); },
+  get expert() { return t('已召唤的专家：人设、捆绑技能、当前在场状态，可送还。'); },
+  get tailor() { return t('工具使用账本：谁在被调用、谁在白缴上下文税。'); },
+  get wb() { return t('市场：连接器、内置 MCP、SkillHub 技能与专家召唤。'); },
 };
 // §1.1 分类 hover 摘要。定位由父层算好（left），这里只负责内容与外观。
 // 只用 pointer-events:none 的只读浮层：不承载交互，因此不需要焦点陷阱，
@@ -6587,32 +6691,32 @@ const connectorMatchesVisibleIn = (rowVisibleTags, selectedTags) => {
   return rowVisibleTags.some((tag) => selectedTags.includes(tag));
 };
 const WB_SKILLHUB_SORTS = [
-  { key: 'downloads', label: t('下载量（本页排序）') },
-  { key: 'installs', label: t('最多安装') },
-  { key: 'stars', label: t('最多星标') },
-  { key: 'score', label: t('综合评分') },
+  { key: 'downloads', get label() { return t('下载量（本页排序）'); } },
+  { key: 'installs', get label() { return t('最多安装'); } },
+  { key: 'stars', get label() { return t('最多星标'); } },
+  { key: 'score', get label() { return t('综合评分'); } },
 ];
 // T05/R10：连接器排序（全量本地排序，不受分页影响）。
 // 目录自带 skillCount（捆绑技能数）与 visibleIn（适用环境标签数），够做有意义的排序；
 // upstream 无下载量/评分字段，不臆造。
 const WB_CONNECTOR_SORTS = [
-  { key: 'default', label: t('目录默认顺序') },
-  { key: 'skills', label: t('技能数由多到少') },
-  { key: 'name', label: t('名称 A→Z') },
+  { key: 'default', get label() { return t('目录默认顺序'); } },
+  { key: 'skills', get label() { return t('技能数由多到少'); } },
+  { key: 'name', get label() { return t('名称 A→Z'); } },
 ];
 // T06/Awesome：DSH 社区目录排序（全量本地排序，不受分页影响）。
 // upstream 自带 stars 与 lastVerified，无下载量/评分字段，不臆造。
 const AWESOME_SORTS = [
-  { key: 'stars', label: t('最多星标') },
-  { key: 'recent', label: t('最新收录') },
-  { key: 'name', label: t('名称 A→Z') },
+  { key: 'stars', get label() { return t('最多星标'); } },
+  { key: 'recent', get label() { return t('最新收录'); } },
+  { key: 'name', get label() { return t('名称 A→Z'); } },
 ];
 const AWESOME_CATEGORIES = [
-  { key: 'all', label: t('全部') },
-  { key: 'plugin', label: t('插件') },
-  { key: 'skill', label: t('技能') },
-  { key: 'bundle', label: t('套件') },
-  { key: 'tool', label: t('工具') },
+  { key: 'all', get label() { return t('全部'); } },
+  { key: 'plugin', get label() { return t('插件'); } },
+  { key: 'skill', get label() { return t('技能'); } },
+  { key: 'bundle', get label() { return t('套件'); } },
+  { key: 'tool', get label() { return t('工具'); } },
 ];
 const AWESOME_TAGS = ['ui', 'terminal', 'agents', 'memory', 'models', 'vision', 'capabilities', 'channels', 'notifications', 'usage', 'observability', 'marketplace', 'devtools', 'safety', 'knowledge', 'interop', 'fun'];
 const AWESOME_PAGE_SIZE = 50;
@@ -7295,15 +7399,18 @@ const expertCardActions = ({ summoned, expertType, personaText }) => ({
 // 也不要让一条读不出来的旧行悄悄用坏人设开新会话）。
 const personaTextOf = (rows, plugin) => (Array.isArray(rows) ? rows.find((row) => row?.plugin === plugin)?.personaText : '') || '';
 const QUICK_MENU_KINDS = [
-  { key: 'skill', label: t('技能'), icon: 'skill', hint: t('技能按需触发：选择后以 /技能名 插入输入框') },
-  { key: 'mcp', label: 'MCP', icon: 'plug', hint: t('MCP 工具按 server 生效：选择后点名 mcp__服务__* 工具') },
-  { key: 'expert', label: t('专家'), icon: 'expert', hint: t('专家随时挂/换/摘：点一个即接管本会话，再点别的直接换，点 chip 的 × 取消') },
+  { key: 'skill', get label() { return t('技能'); }, icon: 'skill', get hint() { return t('技能按需触发：选择后以 /技能名 插入输入框'); } },
+  { key: 'mcp', label: 'MCP', icon: 'plug', get hint() { return t('MCP 工具按 server 生效：选择后点名 mcp__服务__* 工具'); } },
+  { key: 'expert', get label() { return t('专家'); }, icon: 'expert', get hint() { return t('专家随时挂/换/摘：点一个即接管本会话，再点别的直接换，点 chip 的 × 取消'); } },
 ];
 // 子菜单列表每屏固定 6 行（6 × 28px），更多条目在 .dsh-mcp-quick-list 里纵向滚动；
 // 「最近」徽章只标最近池里的前 6 名（首屏可见的那批），避免整列都是徽章。
 // 专家预设显示名前缀：召唤时写死的 `WorkBuddy 专家 · <显示名>`（见 expert-market.js
 // buildExpertPresetRow），宿主的会话头预设标签原样显示它——用来识别「那条会过期的标签」。
-const EXPERT_PRESET_LABEL_PREFIX = t('WorkBuddy 专家 · ');
+// 这是**匹配用**前缀，不是展示文案：宿主 expert-market.js 写入预设定名时永远用
+// 中文 `WorkBuddy 专家 · `（见 buildExpertPresetRow），这里必须逐字相同。
+// 不能包 t()——英文环境下翻译成 "WorkBuddy Expert · " 会永远匹配不上宿主标签。
+const EXPERT_PRESET_LABEL_PREFIX = 'WorkBuddy 专家 · ';
 // 专家挂载状态的最小事件总线：快速菜单挂/换/摘专家后立刻通知会话头徽章与菜单 chip，
 // 三处显示同一帧内对齐（不再各自等重挂载）。低频轮询只作兜底，覆盖「别的入口挂的专家」。
 const expertChangeListeners = new Set();
@@ -7333,6 +7440,7 @@ const quickMentionText = (kind, item) => {
   return /^[\w-]+$/.test(token) ? `/${token} ` : t('{0}：', [token]);
 };
 const SummonQuickMenu = ({ call, inputActions, sessionId: sessionIdProp }) => {
+  useI18nRevision(); // 宿主切语言后重渲染，模块级 getter 文案即时更新
   const [open, setOpen] = useState(false);
   const [hoverKind, setHoverKind] = useState(null);
   const [recent, setRecent] = useState(null); // { skill: [], mcp: [], expert: [] }
@@ -7784,6 +7892,7 @@ const SummonQuickMenu = ({ call, inputActions, sessionId: sessionIdProp }) => {
 // 宿主标签在 540px 以下隐藏，本徽章跟随同一断点（container query 无法跨包复用，
 // 用媒体查询近似窄窗行为）。
 const SessionExpertBadge = ({ call, sessionId }) => {
+  useI18nRevision(); // 宿主切语言后重渲染，模块级 getter 文案即时更新
   const [attached, setAttached] = useState(null);
   const [ready, setReady] = useState(false);
   const badgeRef = useRef(null);
@@ -8325,16 +8434,19 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
   const builtinNeedsConfig = (item) => Array.isArray(item.configKeys) && item.configKeys.length > 0;
   const builtinNeedsArgs = (item) => Array.isArray(item.placeholders) && item.placeholders.length > 0;
   const builtinReady = (item) => !builtinNeedsKey(item) && !builtinNeedsConfig(item) && !builtinNeedsArgs(item);
-  const builtinCategories = useMemo(() => {
+  // P1：目录随 RPC 同时送中英字段，这里按当前 locale 投影一次。只在 47 条上跑，
+  // 不做 useMemo——locale 变化时 useI18nRevision 已强制重渲染，缓存反而会留下旧语言。
+  const localizedBuiltins = builtins.map((item) => localizeBuiltinItem(item));
+  const builtinCategories = (() => {
     const counts = new Map();
-    for (const item of builtins) {
+    for (const item of localizedBuiltins) {
       const key = item.category || 'other';
       const entry = counts.get(key) || { label: item.categoryLabel || key, count: 0 };
       entry.count += 1;
       counts.set(key, entry);
     }
     return [...counts.entries()].map(([key, entry]) => ({ key, ...entry }));
-  }, [builtins]);
+  })();
   const builtinQueryKey = builtinQuery.trim().toLowerCase();
   // ── T03/R5：codebuddy 插件市场 ──
   // 目录一次全量（官方 zip 里的 external_plugins 清单，无分页概念），本地过滤。
@@ -8588,7 +8700,7 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
   const awesomePageCount = Math.max(1, Math.ceil(sortedAwesome.length / AWESOME_PAGE_SIZE));
   const safeAwesomePage = Math.min(awesomePage, awesomePageCount);
   const visibleAwesome = sortedAwesome.slice((safeAwesomePage - 1) * AWESOME_PAGE_SIZE, safeAwesomePage * AWESOME_PAGE_SIZE);
-  const filteredBuiltins = builtins.filter((item) => {
+  const filteredBuiltins = localizedBuiltins.filter((item) => {
     if (builtinCategory !== 'all' && (item.category || 'other') !== builtinCategory) return false;
     if (builtinOnlyReady && !builtinReady(item)) return false;
     if (!builtinQueryKey) return true;
@@ -9403,6 +9515,7 @@ const EntryMenu = () => {
 // 左侧栏底部入口（sidebar.footer.action，DSH 0.1.5 起提供）：官方标准的发现入口。
 // 点击打开的是同一个浮层面板——不切换主面板、不打断正在进行的会话。
 const McpFooterAction = ({ wide }) => {
+  useI18nRevision(); // 宿主切语言后重渲染，模块级 getter 文案即时更新
   const mode = useEntryMode();
   // 「仅悬浮按钮」模式：返回 null 就够了，不需要注销注册。list 型 slot 的每个条目直接渲染
   // 进侧栏的 .footerActions（display:flex、无 gap/padding），外层 outlet 锚点又是
@@ -9820,6 +9933,7 @@ function openBoardCategory(key) {
 }
 const McpBoardPage = (props) => {
   const { call, timer, pluginManager } = props;
+  useI18nRevision(); // 宿主切语言后整块看板重渲染，模块级 getter 文案即时更新
   // §1.2 URL 记忆：分类写进 hash，刷新 / 从别处退回 / 分享链接都能回到同一页。
   // 初值只在首帧读一次（useState 惰性初始化），之后由 effect 单向写出，
   // 不做 hash→state 的反向监听：宿主可能在任意时刻改 hash，双向同步必然互相打架。
@@ -10151,6 +10265,7 @@ function whatsNewFor(current, lastSeen, entries) {
 // 自带 RPC 与状态：面板只管「在这儿渲染一个」。它挂在面板里，就自然随面板挂载/卸载——
 // 这正是「升级后第一次打开面板时弹一次」的触发点，不需要另外判开合。
 const WhatsNewModal = ({ call }) => {
+  useI18nRevision(); // P1：宿主切语言后条目按新 locale 重新选择
   const [notice, setNotice] = useState(null);
   const boxRef = useRef(null);
   const confirmRef = useRef(null);
@@ -10214,6 +10329,8 @@ const WhatsNewModal = ({ call }) => {
   useFocusTrap(boxRef, !!notice);
 
   if (!notice) return null;
+  // 在渲染期按当前 locale 选择，而不是在 RPC 回包时固化：弹窗开着时切语言也能即时变。
+  const localizedEntries = localizeWhatsNewEntries(notice.entries);
   return h(
     'div',
     { className: 'dsh-mcp-overlay', onClick: (e) => e.target === e.currentTarget && dismiss() },
@@ -10227,10 +10344,10 @@ const WhatsNewModal = ({ call }) => {
         h('span', null, t('这些变化你可能想知道')),
       ),
       h('div', { className: 'dsh-mcp-whatsnew-body' },
-        notice.entries.map((entry) =>
+        localizedEntries.map((entry) =>
           h('div', { key: entry.version, className: 'dsh-mcp-whatsnew-entry' },
             // 一次跳多个版本时每条自带版本号；只报一条时标题里的版本号就够了。
-            notice.entries.length > 1 ? h('div', { className: 'dsh-mcp-whatsnew-ver' }, 'v' + entry.version) : null,
+            localizedEntries.length > 1 ? h('div', { className: 'dsh-mcp-whatsnew-ver' }, 'v' + entry.version) : null,
             entry.items.map((item, position) =>
               h('div', { key: position, className: 'dsh-mcp-whatsnew-item' },
                 h('span', { className: 'dsh-mcp-whatsnew-dot', 'aria-hidden': true }, '·'),
@@ -10252,6 +10369,7 @@ const WhatsNewModal = ({ call }) => {
 
 // ── 悬浮按钮宿主（shell.overlay）：只剩这一个席位 ────────────────────────────────
 const McpOverlay = () => {
+  useI18nRevision(); // 宿主切语言后重渲染，模块级 getter 文案即时更新
   const mode = useEntryMode();
   const seats = overlaySeats(mode);
   const [pos, setPos] = useState(() => readFabPos() || defaultFabPos());
@@ -10492,19 +10610,34 @@ const MCP_CONTRIBUTION = {
 };
 // ── 插件入口：挂 RPC、注入样式、注册六个界面槽位 ──────────────────────────────
 async function apply(ctx) {
+  // OPT-25：先接宿主 locale（设置 → 通用里的语言），再注册槽位——槽位 label 是
+  // 注册时求值的字符串，必须等这里算完。ctx.get 是可选读取，不写进 inject：
+  // 老版本 DSH 没有 locale 服务时返回 undefined，自动回落 navigator/zh-CN。
+  const readHostLocale = () => {
+    try { return typeof ctx.get === 'function' ? ctx.get('locale') : null; } catch { return null; }
+  };
+  let hostLocaleService = readHostLocale();
+  applyI18nLocale(resolveI18nLocale(hostLocaleService));
   const disposeMount = await ctx.remote.$mount(MCP_CONTRIBUTION);
   let disposeCss;
   let timer;
   let cleanupPromise;
+  let disposeLocaleSub = null;
+  let disposeServiceWatch = null;
   const cleanup = () => {
     cleanupPromise ??= (async () => {
       try {
-        timer?.dispose();
+        try { disposeLocaleSub?.(); } catch { /* 宿主订阅已失效 */ }
+        try { disposeServiceWatch?.(); } catch { /* 宿主事件监听已失效 */ }
       } finally {
         try {
-          disposeCss?.();
+          timer?.dispose();
         } finally {
-          await disposeMount();
+          try {
+            disposeCss?.();
+          } finally {
+            await disposeMount();
+          }
         }
       }
     })();
@@ -10533,7 +10666,7 @@ async function apply(ctx) {
     // 直接 register：它声明感知，会等 ui-layout 把 main slot 声明出来（插件加载顺序不保证
     // 晚于布局）。
     ctx.slots.inject('main', () =>
-      ctx.slots.register({ name: 'main', key: PANEL_ID, label: PANEL_LABEL, inject: () => ({ call, timer, pluginManager }) }, McpBoardPage),
+      ctx.slots.register({ name: 'main', key: PANEL_ID, label: panelLabel(), inject: () => ({ call, timer, pluginManager }) }, McpBoardPage),
     );
     // 输入框召唤菜单（conversation.input.right，list 型 slot）：权限/模型座位右侧的小图标，
     // 点开 = 技能/MCP/专家三分类 + 悬停最近使用子菜单。声明感知注入（会话 slot 由 conversation
@@ -10541,13 +10674,13 @@ async function apply(ctx) {
     // sessionId 由 slot 渲染作为 prop 显式传入（session 座位约定：id 只走 props，不走 summary 投影），
     // 「挂专家」的人设通道 RPC 用它寻址当前会话。
     ctx.slots.inject('conversation.input.right', () =>
-      ctx.slots.register({ name: 'conversation.input.right', id: PANEL_ID + '-quick', order: 40, label: PANEL_LABEL, inject: (sessionId) => ({ call, sessionId }) }, SummonQuickMenu),
+      ctx.slots.register({ name: 'conversation.input.right', id: PANEL_ID + '-quick', order: 40, label: panelLabel(), inject: (sessionId) => ({ call, sessionId }) }, SummonQuickMenu),
     );
     // 会话头「当前生效专家」徽章（conversation.session.header.actions，list 型 slot）：
     // 与宿主 AgentPresetLabel 同列——但显示的是人设通道真正生效的专家（expertActive），
     // 修复「换专家后顶栏仍显示第一次预设名」的显示/实效分叉。
     ctx.slots.inject('conversation.session.header.actions', () =>
-      ctx.slots.register({ name: 'conversation.session.header.actions', id: PANEL_ID + '-head-expert', order: -5, label: PANEL_LABEL, inject: (sessionId) => ({ call, sessionId }) }, SessionExpertBadge),
+      ctx.slots.register({ name: 'conversation.session.header.actions', id: PANEL_ID + '-head-expert', order: -5, label: panelLabel(), inject: (sessionId) => ({ call, sessionId }) }, SessionExpertBadge),
     );
     // 左上角全局面板行（sidebar.panellist）：「插件」旁边，主入口。行点击由宿主承担——
     // layout.selectPanel(PANEL_ID) 要求 main slot 里存在同 key 条目，上面的注册保证了这点。
@@ -10557,20 +10690,52 @@ async function apply(ctx) {
     const syncPanelEntry = () => {
       const want = ENTRY_VISIBILITY[entryMode.get()].panel;
       if (want && !disposePanelEntry) disposePanelEntry = ctx.slots.register(
-        { name: 'sidebar.panellist', id: PANEL_ID, order: PANEL_ORDER, label: SIDEBAR_ENTRY_LABEL }, McpPanelIcon,
+        { name: 'sidebar.panellist', id: PANEL_ID, order: PANEL_ORDER, label: sidebarEntryLabel() }, McpPanelIcon,
       );
       if (!want && disposePanelEntry) { disposePanelEntry(); disposePanelEntry = null; }
     };
     ctx.slots.inject('sidebar.panellist', () => { syncPanelEntry(); });
     entryMode.subscribe(syncPanelEntry);
+    // OPT-25：宿主切换语言后重算字典并刷新槽位文案。
+    // sidebar.panellist 的 label 来自注册参数而不是组件，只能 dispose + 重新注册；
+    // 面板/菜单等内容组件通过 useI18nRevision 强制重渲染，getter 文案即时生效。
+    const applyHostLocale = () => {
+      const next = resolveI18nLocale(hostLocaleService);
+      if (next === I18N_LOCALE) return;
+      applyI18nLocale(next);
+      // 只在入口已经注册过时重注册：否则可能在 sidebar.panellist 声明前直接
+      // 调用 register（inject 的声明感知就白用了）。没注册过就没有旧文案可刷新，
+      // 之后的 syncPanelEntry 会用新 locale 取 label。
+      if (disposePanelEntry) {
+        disposePanelEntry();
+        disposePanelEntry = null;
+        syncPanelEntry();
+      }
+      emitI18nChange();
+    };
+    const bindHostLocale = () => {
+      const service = readHostLocale();
+      if (!service) return;
+      hostLocaleService = service;
+      applyHostLocale();
+      if (!disposeLocaleSub) disposeLocaleSub = subscribeI18nLocale(service, applyHostLocale);
+    };
+    bindHostLocale();
+    // locale 插件可能晚于本插件完成 apply：服务注册时再绑一次（Cordis 内置事件）。
+    // 老宿主没有该事件也无妨，启动时的 ctx.get 已经覆盖绝大多数加载顺序。
+    if (typeof ctx.on === 'function') {
+      disposeServiceWatch = ctx.on('internal/service', (name) => {
+        if (name === 'locale') bindHostLocale();
+      });
+    }
     // 右下角悬浮按钮：保留既有能力，点击同样切到看板页。
     ctx.slots.inject('shell.overlay', () =>
-      ctx.slots.register({ name: 'shell.overlay', id: 'mcp-fab', order: 1000, label: PANEL_LABEL, inject: () => ({ call, timer, pluginManager }) }, McpOverlay),
+      ctx.slots.register({ name: 'shell.overlay', id: 'mcp-fab', order: 1000, label: panelLabel(), inject: () => ({ call, timer, pluginManager }) }, McpOverlay),
     );
     // 左侧栏底部入口（sidebar.footer.action，0.1.5 起声明）：兼容入口，行为与面板行一致。
     // 用 inject 而不是直接 register：它声明感知，会等侧边栏把 slot 声明出来。
     ctx.slots.inject('sidebar.footer.action', () =>
-      ctx.slots.register({ name: 'sidebar.footer.action', id: 'mcp-manager', order: 100, label: PANEL_LABEL }, McpFooterAction),
+      ctx.slots.register({ name: 'sidebar.footer.action', id: 'mcp-manager', order: 100, label: panelLabel() }, McpFooterAction),
     );
     return cleanup;
   } catch (error) {