自定义 Agent Preset 的 name/description 无法随界面语言本地化

[zlZayn]

自定义 Agent Preset 的 name/description 无法随界面语言本地化

问题

DSH 的 Web UI 支持中英文切换，内置的四个 Agent Preset（目录名/id 为 standard / code / minimal / cordis，其中 cordis 的显示名为 "Creator mode" / "创造模式"，并非单独存在一个 creator preset）的显示名称和描述会随当前界面语言自动切换。但据当前代码，自定义（trust: 'user'）或未知内置（trust: 'system' 但 id 不在硬编码表里）的 preset，其名称和描述只会显示 preset.yml 里的原始字符串，不会随语言切换。

机制（据当前 master HEAD 复核）

预设名的本地化解析没有走 DSH 可扩展的 ctx.locale 注册表，而是走一个模块私有、硬编码的纯函数。以下是复核到的关键代码位置：

1. 映射表是模块私有常量，仅收四个固定 ID

packages/client/ui-agent-preset/src/client/locales.ts 第 169-174 行：

const BUILT_IN_PRESET_KEYS: Readonly<Partial<Record<string, PresetLocaleKeys>>> = {
  standard: { name: 'presetStandardName', description: 'presetStandardDescription' },
  code:     { name: 'presetCodeName',     description: 'presetCodeDescription' },
  minimal:  { name: 'presetMinimalName',  description: 'presetMinimalDescription' },
  cordis:   { name: 'presetCordisName',   description: 'presetCordisDescription' },
}

• 该常量没有 export，外部无法引用。
• 在仓库内搜索 BUILT_IN_PRESET_KEYS，仅出现在 locales.ts 本身和测试文件中，未发现外部引用点或扩展入口。

2. 解析函数对 trust: 'user' 短路，直接跳过字典

同文件第 182-192 行，presetDisplayText() 是负责解析预设显示文案的函数，被 5 个 React 组件直接 import 调用（AgentPresetSeat / AgentPresetRow / AgentPresetLabel / PresetMenu / AgentPresetSection）：

export function presetDisplayText(
  preset: PresetDisplaySource,
  t: (key: AgentPresetSettingsKey) => string,
): PresetDisplayText {
  const keys = preset.trust === 'system' ? BUILT_IN_PRESET_KEYS[preset.id] : undefined
  //                          ^^^^^^^^^^^^^^^^^^^^^^^^
  //                          user preset 在此被短路，不进字典分支
  if (keys !== undefined) return { name: t(keys.name), description: t(keys.description) }
  // 以下为回退分支：直接用 preset.yml 的原始字符串
  return {
    name: preset.name ?? preset.id,
    ...preset.description === undefined ? {} : { description: preset.description },
  }
}

即便是 trust: 'system' 的 preset，只要 id 不在硬编码表里（例如 deployment-extra），也会回退到文件原文。

3. presetDisplayText 是纯函数，未发现拦截点

该函数接收 (preset, t)，不接收 ctx。t 虽绑定到 settings.agentPreset 命名空间，但函数只查映射表里硬编码的那几个 key。我做了仓库内搜索（关键词覆盖 BUILT_IN_PRESET_KEYS、presetDisplayText、preset.*locale、name_zh/name_en、localiz.*preset 等），未发现任何 slot、event、hook 允许第三方插件介入此解析路径。

需要说明：搜索模式有限，不排除存在我未覆盖到的间接扩展路径。若维护者知晓其他介入方式，欢迎指出。

4. 服务端 preset.yml 也不支持多语言

packages/preset/agent-presets/src/metadata.ts 第 28-39 行，PresetMetadata 接口仅含 name（string）、description（string）、order（number）三个扁平字段，无 name_zh / name_en / i18n 之类字段，服务端也不做 locale 解析。

5. 此行为被测试显式锁定

packages/client/ui-agent-preset/tests/locales.client.spec.ts 第 23-32 行，测试名 "keeps file metadata for user and unknown system presets"：

it('keeps file metadata for user and unknown system presets', () => {
  const fileCopy = { name: '我的标准', description: '团队自己的 preset。' }
  // id 是 standard，但 trust 是 user → 不走字典，用文件原文
  expect(presetDisplayText({ id: 'standard', trust: 'user', ...fileCopy }, translate(en)))
    .toEqual(fileCopy)
  // trust 是 system，但 id 不在表里 → 不走字典，用文件原文
  expect(presetDisplayText({ id: 'deployment-extra', trust: 'system', ...fileCopy }, translate(en)))
    .toEqual(fileCopy)
  // user preset 无 metadata → 用 id
  expect(presetDisplayText({ id: 'bare', trust: 'user' }, translate(en)))
    .toEqual({ name: 'bare' })
})

也就是说，这更像是当前有意的设计选择，而非疏忽。但 ui-agent-preset/README.md 的 "Known Limitations and Deferred Work"（第 67-71 行）列出的三条限制中，并未提及自定义 preset 无法本地化这一点。

6. locale 注册表本身是可扩展的

packages/client/locale/src/client/index.ts 第 244 行，ctx.locale.register<N>(ns, dicts) 确实允许任何插件注册命名空间字典（通过 LocaleNamespaceMap 声明合并），文档明确说"Registration bumps the revision so mounted outlets pick up late-arriving dictionaries"。ui-agent-preset 自己也在 index.ts:66 注册了 settings.agentPreset 命名空间。

也就是说，注册表层是开放的，但预设名的解析没有走它——这是我判断"可扩展但未接入"的依据。

影响

• 自定义 preset 在切换界面语言后，名称和描述仍只显示 preset.yml 里写的那一种语言。
• 据当前代码，第三方插件开发者无法通过标准扩展机制让自己的 preset 本地化；变通办法是 fork 并替换整个 ui-agent-preset 客户端插件，但这与 DSH "一切皆插件、扩展而非替换"的设计取向不太一致。

上一句是个人观感，仅供参考。

建议方向（供讨论）

将 BUILT_IN_PRESET_KEYS 从模块私有常量改为可注册的运行时映射，让任何插件都能贡献 presetId → localeKey 并注册对应字典条目。

轻量方案

1. export 一个 registerPresetLocaleKeys(id, keys) 函数，内部维护运行时 Map（替代 BUILT_IN_PRESET_KEYS 常量）。
2. 调整第 186 行逻辑：先查注册表，查到则走字典，查不到再回退 preset.yml 原文（去掉对 trust 的硬限制，或改为仅作 fallback 优先级）。
3. 第三方插件在 apply(ctx) 里调用 registerPresetLocaleKeys('my-agent', { name: 'presetMyAgentName', description: 'presetMyAgentDescription' })，再通过 ctx.locale.register('settings.agentPreset', { zh: { presetMyAgentName: '...', presetMyAgentDescription: '...' }, en: { ... } }) 注册翻译。
4. 更新 locales.client.spec.ts：把 "keeps file metadata for user" 的 case 调整为 "未注册则回退"，并新增 "注册后走字典" 的 case。

更彻底的方案（匹配 DSH Capability Seam 模式）

定义 PresetDisplayResolver service definition，让 presetDisplayText 改为查 ctx 上的这个服务（多 provider 按优先级合并），与 ShellService / DirectoryPicker 的设计一致。改动面更大，仅作备选。

复现步骤

1. 创建自定义 preset：复制 standard 到 $DSH_HOME/.agent-presets/my-agent/
2. 写 preset.yml：name: My Agent / description: A custom preset
3. 在 Web UI 切换界面语言为中文
4. 观察：内置 standard 显示为"标准模式"，但 my-agent 仍显示 My Agent

环境信息

• 仓库：deepseek-ai/deepseek-harness
• 分支：master，复核时 HEAD 为 141eb6f（Merge PR Harness的极简模式当前没有记忆处理，是自己添加吗？ #2783，release/dsh-0.1.0-rc.8）
• 涉及文件：
  • packages/client/ui-agent-preset/src/client/locales.ts（第 169-192 行）
  • packages/client/ui-agent-preset/src/client/index.ts（第 66 行，注册 settings.agentPreset 命名空间）
  • packages/preset/agent-presets/src/metadata.ts（第 28-39 行，preset.yml 单语扁平字段）
  • packages/client/locale/src/client/index.ts（第 244 行，ctx.locale.register 签名，本身可扩展）
  • packages/client/ui-agent-preset/tests/locales.client.spec.ts（第 23-32 行，行为被测试锁定）

复核范围与局限

以上结论基于对 master 分支 commit 141eb6f 的全仓库代码搜索和文件通读。搜索关键词覆盖了 BUILT_IN_PRESET_KEYS、presetDisplayText、preset.*locale、name_zh/name_en、localiz.*preset 等，但搜索模式有限，不能完全排除存在我未覆盖的间接扩展路径（例如某个未命中的 patch 机制或运行时注入点）。如维护者知晓其他介入方式，欢迎指正。