@jingyi0605/codingns4dsh 0.2.1-rc.5 → 0.2.1-rc.6

package/data/build/dist/client/client.native-workspace-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.native-workspace-store.js","names":["DEFAULT_ASSISTANT_NOTIFICATION_SETTINGS","DEFAULT_ASSISTANT_PROMPTS","DEFAULT_SESSION_TRANSLATION_SETTINGS"],"sources":["../../../../src/shared/contracts/version.ts","../../../../src/shared/contracts/git.ts","../../../../src/shared/contracts/config.ts","../../../../src/client/native-workspace-store.ts"],"sourcesContent":["/** DSH verification target, synchronized with the root version.json. */\nexport const DSH_VERSION = '0.2.1-rc.3' as const\n\n/** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */\nexport const DSH_TESTED_VERSION = DSH_VERSION\n\n/**\n * Supported hosts retain the 0.2.0-rc.2 floor and include 0.2.1-rc.2.\n * Capability adapters preserve earlier subagent, peer and message contracts.\n * Keep an explicit upper bound: a later prerelease requires verification before\n * either installation checks or runtime capability selection may accept it.\n */\nexport const DSH_COMPATIBILITY = '>=0.2.0-rc.2 <=0.2.1-rc.3' as const\n\n/**\n * 兼容范围下界，即插件仍然接受的最低 DSH 版本。\n *\n * 供“宿主没有注入真实版本、但已确认处于现代世代”的保守回退使用：回退值取自\n * 范围本身，因此永远落在兼容范围内。写死某个历史版本会在范围收紧后变成\n * “不支持的 DSH 版本”，把仅仅缺少启动页注入的页面误判为宿主不兼容。\n */\nexport function minimumSupportedDshVersion(): string {\n  const match = /^>=([^ ]+)/u.exec(DSH_COMPATIBILITY)\n  return match?.[1] ?? DSH_VERSION\n}\n\n/** DSH Envelope/Tunnel 协议主版本。 */\nexport const DSH_PROTOCOL_VERSION = 1 as const\n\n/** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */\nexport const CODINGNS_DSH_VERSION_GLOBAL = '__CODINGNS_DSH_VERSION__' as const\n\n/** 识别没有 alpha2 Sidebar 扩展 API 的 DSH 旧版运行时。 */\nexport function isLegacyDshVersion(version: string): boolean {\n  return /^0\\.1\\.5(?:-|$)/u.test(version)\n}\n\n/** Codingns4DSH 插件自身的 npm 版本。 */\nexport const CODINGNS_VERSION = '0.2.1-rc.5' as const\n\ninterface ParsedVersion {\n  readonly major: number\n  readonly minor: number\n  readonly patch: number\n  readonly prerelease: readonly string[]\n}\n\n/** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内；范围省略上界时不校验上限。 */\nexport function isDshVersionCompatible(version: string): boolean {\n  const match = /^>=([^ ]+)(?: <=([^ ]+))?$/u.exec(DSH_COMPATIBILITY)\n  const actual = parseVersion(version)\n  const minimum = parseVersion(match?.[1] ?? '')\n  if (match === null || !actual || !minimum) return version === DSH_VERSION\n  if (match[2] === undefined) return compareVersions(actual, minimum) >= 0\n  const maximum = parseVersion(match[2])\n  if (maximum === undefined) return version === DSH_VERSION\n  return compareVersions(actual, minimum) >= 0 && compareVersions(actual, maximum) <= 0\n}\n\n/** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */\nexport function isDshVersionAtLeast(version: string, minimum: string): boolean {\n  return isVersionAtLeast(version, minimum)\n}\n\n/** 按语义版本比较大小；预发布标识参与排序，构建元数据不影响优先级，非法版本不放行。 */\nexport function isVersionAtLeast(version: string, minimum: string): boolean {\n  const actual = parseVersion(version)\n  const required = parseVersion(minimum)\n  if (!actual || !required) return false\n  return compareVersions(actual, required) >= 0\n}\n\nfunction parseVersion(value: string): ParsedVersion | undefined {\n  const match = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u.exec(value)\n  if (!match) return undefined\n  const core = match.slice(1, 4).map(Number)\n  if (!core.every(Number.isSafeInteger)) return undefined\n  const prerelease = match[4]?.split('.') ?? []\n  // 数字预发布标识不能有前导零；超大数字保留字符串，用长度比较避免精度丢失。\n  if (prerelease.some((part) => /^0\\d+$/u.test(part))) return undefined\n  return {\n    major: Number(match[1]),\n    minor: Number(match[2]),\n    patch: Number(match[3]),\n    prerelease,\n  }\n}\n\nfunction compareVersions(left: ParsedVersion, right: ParsedVersion): number {\n  for (const key of ['major', 'minor', 'patch'] as const) {\n    if (left[key] !== right[key]) return left[key] - right[key]\n  }\n  if (left.prerelease.length === 0 && right.prerelease.length > 0) return 1\n  if (left.prerelease.length > 0 && right.prerelease.length === 0) return -1\n  for (let index = 0; index < Math.max(left.prerelease.length, right.prerelease.length); index += 1) {\n    const leftPart = left.prerelease[index]\n    const rightPart = right.prerelease[index]\n    if (leftPart === undefined) return -1\n    if (rightPart === undefined) return 1\n    if (leftPart === rightPart) continue\n    const leftNumeric = /^\\d+$/u.test(leftPart)\n    const rightNumeric = /^\\d+$/u.test(rightPart)\n    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1\n    if (leftNumeric && leftPart.length !== rightPart.length) return leftPart.length - rightPart.length\n    return leftPart < rightPart ? -1 : 1\n  }\n  return 0\n}\n","/** Git 工作区面板在 Host 与 Client 之间传输的稳定契约。 */\n\nexport interface GitCommitMessageModel {\n  readonly provider: string\n  readonly model: string\n}\n\nexport interface GitManagementSettings {\n  readonly commitMessageEnabled: boolean\n  readonly commitMessageDetail: 'concise' | 'detailed'\n  readonly commitMessageModels: readonly GitCommitMessageModel[]\n  readonly commitMessagePrompt: string\n}\n\nexport const DEFAULT_GIT_MANAGEMENT_SETTINGS: GitManagementSettings = {\n  commitMessageEnabled: true,\n  commitMessageDetail: 'concise',\n  commitMessageModels: [],\n  commitMessagePrompt: '',\n}\n\nexport const MAX_GIT_COMMIT_MESSAGE_CHARS = 10_000\nexport const MAX_GIT_COMMIT_PROMPT_CHARS = 10_000\n\nexport function normalizeGitManagementSettings(value: GitManagementSettings | undefined): GitManagementSettings {\n  const seen = new Set<string>()\n  return {\n    commitMessageEnabled: value?.commitMessageEnabled !== false,\n    commitMessageDetail: value?.commitMessageDetail === 'detailed' ? 'detailed' : 'concise',\n    commitMessagePrompt: typeof value?.commitMessagePrompt === 'string' ? value.commitMessagePrompt : '',\n    commitMessageModels: (value?.commitMessageModels ?? []).flatMap((item) => {\n      const provider = item?.provider?.trim()\n      const model = item?.model?.trim()\n      if (!provider || !model) return []\n      const key = JSON.stringify([provider, model])\n      if (seen.has(key)) return []\n      seen.add(key)\n      return [{ provider, model }]\n    }),\n  }\n}\n\nexport interface GitCommitMessageDraft {\n  readonly message: string\n}\n\nexport interface GitRepoSnapshot {\n  readonly workspaceId: string\n  readonly repoRoot: string\n  /** 当前工作区是否已经初始化为 Git 仓库；旧 Host 未提供时按 true 兼容。 */\n  readonly enabled?: boolean\n  readonly branch: string\n  readonly ahead: number\n  readonly behind: number\n  readonly hasRemote: boolean\n  readonly isDirty: boolean\n  readonly lastFetchedAt: string | null\n}\n\nexport interface GitChangeItem {\n  readonly path: string\n  readonly status: string\n  readonly staged: boolean\n  readonly oldPath: string | null\n  readonly binary: boolean\n  readonly stagedStatus: string | null\n  readonly worktreeStatus: string | null\n}\n\nexport interface GitStatus {\n  readonly snapshot: GitRepoSnapshot\n  readonly changes: readonly GitChangeItem[]\n}\n\nexport interface GitDiff {\n  readonly workspaceId: string\n  readonly path: string\n  readonly staged: boolean\n  readonly binary: boolean\n  readonly truncated: boolean\n  readonly content: string\n}\n\nexport interface GitHistoryItem {\n  readonly commitHash: string\n  readonly authorName: string\n  readonly authoredAt: string\n  readonly subject: string\n  readonly body: string\n  readonly refs: readonly GitHistoryRef[]\n  /** 父提交哈希；旧 Host 未提供时 Client 退化为线性轨道，不绘制分支/合并连线。 */\n  readonly parents?: readonly string[]\n  /** 提交相对当前分支与远程分支的归属；旧 Host 未提供或仓库过大时省略。 */\n  readonly origin?: GitHistoryOrigin\n}\n\nexport interface GitHistoryRef {\n  readonly name: string\n  readonly kind: 'head' | 'local' | 'remote' | 'tag'\n  readonly remoteName: string | null\n}\n\n/** 版本历史的取值范围：仅当前分支，或全部本地分支与远程跟踪分支。 */\nexport type GitHistoryScope = 'head' | 'all'\n\n/**\n * 提交归属：\n * - `local`：只在本机分支上，没有任何远程跟踪分支包含它（未推送）；\n * - `synced`：当前分支与至少一个远程跟踪分支都包含它；\n * - `remote`：只有远程跟踪分支包含它（本地还没有，例如拉取前）；\n * - `branch`：只有其他本地分支包含它，当前分支与远程都没有。\n */\nexport type GitHistoryOrigin = 'local' | 'synced' | 'remote' | 'branch'\n\nexport interface GitHistoryPage {\n  readonly items: readonly GitHistoryItem[]\n  readonly cursor: string | null\n  readonly nextCursor: string | null\n  readonly totalCount: number\n}\n\nexport interface GitBranchItem {\n  readonly name: string\n  readonly current: boolean\n  readonly upstream: string | null\n  readonly remote: boolean\n}\n\nexport interface GitBranchSnapshot {\n  readonly currentBranch: string\n  readonly local: readonly GitBranchItem[]\n  readonly remote: readonly GitBranchItem[]\n}\n\nexport interface GitCommitResult {\n  readonly commitHash: string\n  readonly summary: string\n}\n\nexport interface GitCommitChangedFile {\n  readonly path: string\n  readonly oldPath: string | null\n  readonly status: string\n  readonly binary: boolean\n}\n\nexport interface GitCommitDiff {\n  readonly commitHash: string\n  /** 旧版 Host 未提供时由 Client 从 diff 头部回退解析。 */\n  readonly files?: readonly GitCommitChangedFile[]\n  readonly content: string\n  readonly truncated: boolean\n}\n","import type { FeatureDescriptor } from './feature.js'\nimport type { CodingNsCliSessionRecord } from './cli-adapter.js'\nimport { isDshVersionAtLeast } from './version.js'\nimport type { AssistantAppearanceSettings } from '../assistant-avatar.js'\nimport { DEFAULT_ASSISTANT_PROMPTS, type AssistantPromptSettings } from '../assistant-prompts.js'\nimport type { AssistantTtsSettings } from '../assistant-tts.js'\nimport { DEFAULT_ASSISTANT_NOTIFICATION_SETTINGS, type AssistantNotificationSettings } from '../assistant-notifications.js'\nimport { DEFAULT_SESSION_TRANSLATION_SETTINGS, type SessionTranslationSettings } from './session-translation.js'\nimport { DEFAULT_GIT_MANAGEMENT_SETTINGS, type GitManagementSettings } from './git.js'\n\n/** 适配器最近一次使用的模型、思考强度与服务档位。 */\nexport interface CodingNsCliAdapterPreference {\n  readonly modelId?: string | undefined\n  readonly effortId?: string | undefined\n  /** Provider 服务档位（例如 Codex 官方订阅的 Fast）；`default` 表示标准速度。 */\n  readonly serviceTierId?: string | undefined\n  /** 新建会话模型选择器中的“翻译对话”开关，按 Agent 隔离记忆。 */\n  readonly translationEnabled?: boolean | undefined\n}\n\n/** 全局智能助理设置；默认空范围，必须由用户显式勾选工作区。 */\nexport type AssistantVoiceProvider = 'dsh-speech-to-text' | 'sherpa-onnx'\n\n/** 全局语音助理初始化配置；模型目录由 Host 自动下载并写入。 */\nexport interface AssistantVoiceSettings {\n  initialized: boolean\n  provider: AssistantVoiceProvider\n  /** 已安装的实时模型目录 ID；旧配置没有该字段时按空值兼容。 */\n  modelId?: string\n  asrEncoder: string\n  asrDecoder: string\n  asrJoiner: string\n  asrTokens: string\n  vadModel: string\n  ttsModel: string\n  ttsTokens: string\n  ttsLexicon: string\n}\n\nexport const DEFAULT_ASSISTANT_VOICE_SETTINGS: AssistantVoiceSettings = {\n  initialized: false,\n  provider: 'dsh-speech-to-text',\n  modelId: '',\n  asrEncoder: '',\n  asrDecoder: '',\n  asrJoiner: '',\n  asrTokens: '',\n  vadModel: '',\n  ttsModel: '',\n  ttsTokens: '',\n  ttsLexicon: '',\n}\n\nexport interface AssistantSettings {\n  /** 旧配置缺省全开；展示仍受模块、助理创建和形象开关约束。 */\n  notifications?: AssistantNotificationSettings\n  /** 只有显式 initialized=true 表示已创建；缺省或 false 时旧配置仅预填创建表单。 */\n  profile?: AssistantProfileSettings\n  /** 缺省跟随 DSH 默认模型；固定选择同时用于项目索引与正式对话。 */\n  model?: { readonly provider: string; readonly model: string }\n  /** 允许助理读取和派发的工作区 ID。 */\n  managedWorkspaceIds: string[]\n  /** 语音提供方与本地模型路径；未初始化时点击入口只打开模型选择页。 */\n  voice: AssistantVoiceSettings\n  /** 统一形象配置；旧设置缺失时由展示层补默认值。 */\n  appearance?: AssistantAppearanceSettings\n  /** 索引总结与对话前置提示词；旧配置使用默认口语化提示词。 */\n  prompts?: AssistantPromptSettings\n  /** 独立音色与输出后端；缺省保留浏览器播报以兼容旧配置。 */\n  tts?: AssistantTtsSettings\n}\n\nexport interface AssistantProfileSettings {\n  readonly name: string\n  /** 角色性格与背景，旧档案缺省时不额外限定角色；不作为项目事实。 */\n  readonly personality?: string\n  readonly initialized: boolean\n  readonly createdAt: number | null\n}\n\nexport const DEFAULT_ASSISTANT_SETTINGS: AssistantSettings = {\n  notifications: DEFAULT_ASSISTANT_NOTIFICATION_SETTINGS,\n  managedWorkspaceIds: [],\n  voice: DEFAULT_ASSISTANT_VOICE_SETTINGS,\n  prompts: DEFAULT_ASSISTANT_PROMPTS,\n}\n\n/** Codingns4DSH 在 DSH 设置文档中持久化的用户选项。 */\nexport interface CodingNsSettings {\n  /** Control API 地址不是秘密，可以由 Web 设置页保存到 Host 设置。 */\n  controlBaseUrl: string\n  /** Control API 地址候选列表；列表本身不包含任何凭据。 */\n  controlBaseUrls: string[]\n  /** 局域网访问 DSH 的唯一监听映射及启动策略。 */\n  lanAccessDsh: LanAccessDshSettings\n  /** 插件 Sidebar 终端的默认 profile 与受控外观设置。 */\n  terminalEnhancement: TerminalEnhancementSettings\n  /** 原生工作区会话行的浏览器端增强选项。 */\n  workspaceSessionEnhancement: WorkspaceSessionEnhancementSettings\n  /** DSH 文件管理侧栏的独立增强选项。 */\n  fileManagement: FileManagementSettings\n  /** Shortcut references only; approvals and launch secrets are Host runtime state. */\n  quickApps?: import('./quick-apps.js').QuickApp[]\n  /** 手机/平板窄屏访问时的界面增强选项。 */\n  mobileAccess: MobileAccessSettings\n  /** 用量查询设置：超时控制单次网络查询，间隔控制自动刷新。 */\n  subscriptionUsage: SubscriptionUsageSettings\n  /** 订阅用量页面的显示选项；存在 Host，刷新页面或换设备后都保持一致。 */\n  subscriptionReports?: SubscriptionReportSettings\n  /** 全局智能助理设置；不绑定当前页面会话。 */\n  assistant: AssistantSettings\n  /**\n   * 功能模块启用意图：模块名 -> 是否启用。\n   *\n   * 缺省时回落到模块自己声明的 enabledByDefault，因此设置结构不随模块数量变化。\n  */\n  modules: Record<string, boolean>\n  /** 外部 Agent 启用意图：适配器 id -> 是否启用；缺省时所有已注册 Agent 启用。 */\n  agentAdapters?: Record<string, boolean>\n  /** Host 侧外部 Agent 会话索引；不含凭据和原始消息。 */\n  cliSessions?: CodingNsCliSessionRecord[]\n  /** 适配器级最近选择；新建会话时作为默认模型和思考强度。 */\n  agentAdapterPreferences?: Record<string, CodingNsCliAdapterPreference>\n  /** 外部 CLI 子代理托管：把外部 Agent 自己的子代理调用转为 DSH 原生可续子会话。 */\n  subagentBridge?: SubagentBridgeSettings\n  /** 外部 Agent 会话输入与输出的翻译设置。 */\n  sessionTranslation?: SessionTranslationSettings\n  /** Bounds for the host-side resident DSH session-handle safety net. */\n  sessionHandleEviction: SessionHandleEvictionSettings\n  /** Commit message generation preferences, independent of translation settings. */\n  gitManagement?: GitManagementSettings\n}\n\n/** 外部 CLI 子代理托管设置；关闭时所有驱动保持原样。 */\nexport interface SubagentBridgeSettings {\n  enabled: boolean\n  /**\n   * 同一父会话可同时保留的托管子代理数。\n   *\n   * 外部 CLI（如 Command Code）会在一批里并发开出远超上限的子代理调用；超限\n   * 调用过去直接失败并静默回退到 CLI 内建子代理，父会话与界面都看不出差异。\n   * 与 DSH 自身的 `maxActiveSubagents`（缺省 8）保持同一量级，并允许用户按机器\n   * 负载调整。\n   */\n  maxConcurrentSubagents: number\n}\n\n/** 并发子代理数上限：下限 1 保证至少能派发，上限避免一次性压垮本机。 */\nexport const SUBAGENT_BRIDGE_MAX_CONCURRENT_LIMITS = { min: 1, max: 32 } as const\n\nexport const DEFAULT_SUBAGENT_BRIDGE_SETTINGS: SubagentBridgeSettings = {\n  enabled: false,\n  maxConcurrentSubagents: 8,\n}\n\n/** Host-side bounds for resident DSH JSONL session handles. */\nexport interface SessionHandleEvictionSettings {\n  enabled: boolean\n  idleTtlMs: number\n  maxOpenHandles: number\n}\n\nexport const SESSION_HANDLE_EVICTION_IDLE_TTL_MS_LIMITS = { min: 1_000, max: 86_400_000 } as const\nexport const SESSION_HANDLE_EVICTION_MAX_OPEN_HANDLES_LIMITS = { min: 1, max: 1_024 } as const\nexport const DEFAULT_SESSION_HANDLE_EVICTION_SETTINGS: SessionHandleEvictionSettings = {\n  enabled: true,\n  idleTtlMs: 600_000,\n  maxOpenHandles: 32,\n}\n\n/** 归一化子代理托管设置：只有显式 true 才算开启；并发数按上下限收敛。 */\nexport function normalizeSubagentBridgeSettings(value: unknown): SubagentBridgeSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return {\n    enabled: record.enabled === true,\n    maxConcurrentSubagents: clampSettingsInteger(\n      record.maxConcurrentSubagents,\n      SUBAGENT_BRIDGE_MAX_CONCURRENT_LIMITS,\n      DEFAULT_SUBAGENT_BRIDGE_SETTINGS.maxConcurrentSubagents,\n    ),\n  }\n}\n\n/** 用量查询设置：超时控制单次网络查询，间隔控制自动刷新。 */\nexport interface SubscriptionUsageSettings {\n  /** 单次用量查询的网络超时（秒）。 */\n  timeoutSecs: number\n  /** 自动查询间隔（分钟）；0 表示不自动查询。 */\n  refreshIntervalMins: number\n}\n\nexport const DEFAULT_SUBSCRIPTION_USAGE_SETTINGS: SubscriptionUsageSettings = { timeoutSecs: 10, refreshIntervalMins: 5 }\nexport const SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS = { min: 3, max: 120 } as const\nexport const SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS = { min: 0, max: 1440 } as const\n\n/** 归一化用量查询设置：缺省字段回填默认值，越界值收敛到允许范围。 */\nexport function normalizeSubscriptionUsageSettings(value: unknown): SubscriptionUsageSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return {\n    timeoutSecs: clampSettingsInteger(record.timeoutSecs, SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.timeoutSecs),\n    refreshIntervalMins: clampSettingsInteger(record.refreshIntervalMins, SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.refreshIntervalMins),\n  }\n}\n\n/** 订阅用量卡片上进度条与百分比的口径：已用多少，还是还剩多少。 */\nexport type SubscriptionQuotaView = 'used' | 'remaining'\n\n/**\n * 订阅用量页面的显示选项。\n *\n * 只保存\"看哪个口径\"这类纯展示偏好：它不改变 Host 拉取的数据，也不影响任何\n * 额度计算，因此可以安全地下发给所有客户端并在跨设备时保持一致。\n */\nexport interface SubscriptionReportSettings {\n  /** 订阅卡默认展示已用还是剩余；口径只影响读法，不改变数据来源。 */\n  quotaView: SubscriptionQuotaView\n}\n\nexport const DEFAULT_SUBSCRIPTION_REPORT_SETTINGS: SubscriptionReportSettings = { quotaView: 'remaining' }\n\n/** 归一化订阅用量显示选项：只接受两个已知口径，其余一律回落默认值。 */\nexport function normalizeSubscriptionReportSettings(value: unknown): SubscriptionReportSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return { quotaView: record.quotaView === 'used' || record.quotaView === 'remaining' ? record.quotaView : DEFAULT_SUBSCRIPTION_REPORT_SETTINGS.quotaView }\n}\n\nfunction clampSettingsInteger(value: unknown, limits: { readonly min: number; readonly max: number }, fallback: number): number {\n  const numeric = typeof value === 'number' && Number.isFinite(value) ? Math.round(value) : fallback\n  return Math.min(limits.max, Math.max(limits.min, numeric))\n}\n\n/** 0.1.7 ConfigForm 面向用户的持久化配置；Host-only 会话索引不在其中。 */\nexport type CodingNsConfig = Omit<CodingNsSettings, 'cliSessions'>\n\n/** Host 运行时状态，与可编辑配置分离，避免泄露到 Client 配置表单。 */\nexport interface CodingNsRuntimeState {\n  readonly cliSessions: CodingNsCliSessionRecord[]\n}\n\n/** 跨平台终端 profile；`system` 由 Host 根据平台和已安装 shell 解析。 */\nexport type TerminalProfileId = 'system' | 'zsh' | 'bash' | 'powershell' | 'cmd' | 'git-bash'\n/** 终端持久记录的归属范围；工作区模式允许不同 DSH 会话共享终端。 */\nexport type TerminalBindingScope = 'workspace' | 'session'\n\nexport type TerminalAppearanceTheme = 'inherit' | 'custom'\nexport type TerminalCursorStyle = 'block' | 'bar' | 'underline'\n\n/** 仅保存可映射到 xterm 公开选项的外观字段。 */\nexport interface TerminalAppearanceSettings {\n  theme: TerminalAppearanceTheme\n  background: string | null\n  foreground: string | null\n  cursorColor: string | null\n  fontFamily: string | null\n  fontSize: number | null\n  lineHeight: number | null\n  cursorStyle: TerminalCursorStyle | null\n  cursorBlink: boolean | null\n  scrollback: number | null\n}\n\nexport interface TerminalEnhancementSettings {\n  /** 缺省按工作区归属；旧设置缺少此字段时由 schema 回填。 */\n  bindingScope?: TerminalBindingScope\n  defaultProfile: TerminalProfileId\n  appearance: TerminalAppearanceSettings\n}\n\n/** 工作区会话增强的用户可见设置；每个子能力都可以独立开关。 */\nexport interface WorkspaceSessionEnhancementSettings {\n  showAdapterLogo: boolean\n  /** 是否在每个有归档会话的工作区中显示归档入口。 */\n  showArchivedSessions: boolean\n  /** 是否在工作区菜单提供隐藏与恢复工作区入口。 */\n  showWorkspaceHiding: boolean\n  /** 插件本地隐藏的工作区 ID；不改变 DSH 原生工作区数据。 */\n  hiddenWorkspaceIds: string[]\n  /** 是否在对话底部显示订阅与上游用量检测。 */\n  showSubscriptionUsage: boolean\n  /** 是否在输入工具区显示快捷会话入口。 */\n  showQuickPhrases: boolean\n  /** 是否索引当前会话所选 Agent 的 Skill，并通过指令快速引用。 */\n  showSkillQuickReference: boolean\n  /** 是否优化 DSH 自动标题的语义、长度和失败时的兜底文字。 */\n  optimizeSessionTitles: boolean\n  /** 是否记忆对话窗口与右侧栏的宽度比例；具体比例保存在当前浏览器。 */\n  rememberConversationRightbarRatio: boolean\n  /** 插件本地保存的快捷会话条目。 */\n  quickPhrases: QuickPhrase[]\n  /** 内置快捷会话是否已经完成首次初始化；仅用于兼容旧配置。 */\n  quickPhrasesSeeded: boolean\n  /**\n   * 旧版本曾把手势设置写在这里。保留可选字段只用于读取旧配置，新的设置一律写入\n   * `mobileAccess`，避免升级后把用户主动关闭的手势重新打开。\n   */\n  sidebarGestures?: boolean\n  sidebarGestureMapping?: SidebarGestureMapping\n  sidebarGestureEdge?: SidebarGestureEdgeMode\n  /** 已废弃的像素门槛；只在归一化时用于推导比例，新配置一律写入 `sidebarGestureDistancePercent`。 */\n  sidebarGestureThresholdPx?: number\n}\n\n/** 移动端侧栏横滑设置。 */\nexport interface SidebarGestureSettings {\n  /** 是否在触摸设备上启用横滑开合左右侧栏。 */\n  sidebarGestures: boolean\n  /** 手势方向映射：右滑/左滑分别对应哪一侧栏。 */\n  sidebarGestureMapping: SidebarGestureMapping\n  /** 手势起手区域：是否允许贴上系统边缘热区。 */\n  sidebarGestureEdge: SidebarGestureEdgeMode\n  /**\n   * 触发手势所需的水平位移占视口宽度的百分比。\n   *\n   * 用比例而不是像素：同一个像素值在 360px 手机与 1024px 平板上的手势占比相差\n   * 近三倍，只有比例才能让「灵敏度」这个设置在各类设备上表达同一件事。\n   *\n   * 该值只约束**距离通道**；位移不足时仍可由甩动通道（快速轻甩）触发。\n   */\n  sidebarGestureDistancePercent: number\n}\n\n/** 横滑手势的方向映射。 */\nexport type SidebarGestureMapping = 'swipe-inward' | 'swap'\n\n/** 横滑手势的起手区域。 */\nexport type SidebarGestureEdgeMode = 'avoid' | 'edge'\n\nexport const SIDEBAR_GESTURE_DISTANCE_PERCENT_LIMITS = { min: 15, max: 80 } as const\n/**\n * 默认 25%：配合甩动通道，实测有意手势成功率 100%、误触率 0%。\n *\n * 旧默认 40% 与「距离与速度同时达标」的组合让正常滑动被系统性误杀（实测成功率仅 30%），\n * 用户需要重复滑动才能呼出侧栏。\n */\nexport const DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT = 25\n/**\n * 旧像素门槛换算成比例时使用的参考视口宽度。\n *\n * 旧实现的有效阈值是 `max(像素值, 视口宽度 × 40%)`，像素值只有超过该下限才生效。\n * 取常见手机宽度 390px 作为换算基准，并保证结果不低于新的默认值，让「没生效过的旧值」\n * 迁移后直接落到新默认值，从而真正获得本次灵敏度修复。\n */\nexport const SIDEBAR_GESTURE_LEGACY_THRESHOLD_PX_REFERENCE_WIDTH = 390\n\nexport const DEFAULT_SIDEBAR_GESTURE_SETTINGS: SidebarGestureSettings = {\n  sidebarGestures: true,\n  sidebarGestureMapping: 'swipe-inward',\n  sidebarGestureEdge: 'avoid',\n  sidebarGestureDistancePercent: DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT,\n}\n\n/** 手势设置的归一化输入；保留旧版本写入的像素门槛用于一次性迁移。 */\nexport type SidebarGestureSettingsInput = Partial<SidebarGestureSettings> & {\n  /** 已废弃的像素门槛；只用于推导比例，不再被写回。 */\n  sidebarGestureThresholdPx?: number\n}\n\n/** 归一化手势设置：缺省回填、越界收敛，非法枚举回落到默认值。 */\nexport function normalizeSidebarGestureSettings(\n  value: SidebarGestureSettingsInput | undefined,\n): SidebarGestureSettings {\n  const record = typeof value === 'object' && value !== null ? value as Record<string, unknown> : {}\n  const percent = record.sidebarGestureDistancePercent === undefined\n    ? legacyThresholdPxToPercent(record.sidebarGestureThresholdPx)\n    : record.sidebarGestureDistancePercent\n  return {\n    // 移动端访问增强默认提供横滑入口；桌面端控制器仍会按触摸能力和视口门禁不挂监听。\n    sidebarGestures: record.sidebarGestures === undefined\n      ? DEFAULT_SIDEBAR_GESTURE_SETTINGS.sidebarGestures\n      : record.sidebarGestures === true,\n    sidebarGestureMapping: record.sidebarGestureMapping === 'swap' ? 'swap' : 'swipe-inward',\n    sidebarGestureEdge: record.sidebarGestureEdge === 'edge' ? 'edge' : 'avoid',\n    sidebarGestureDistancePercent: clampSettingsInteger(\n      percent,\n      SIDEBAR_GESTURE_DISTANCE_PERCENT_LIMITS,\n      DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT,\n    ),\n  }\n}\n\n/**\n * 把已废弃的像素门槛换算成视口百分比。\n *\n * 换算结果不低于当前默认值：旧像素值在绝大多数移动视口上本来就低于\n * `视口宽度 × 40%`，属于「从未生效」的设置，用户实际上一直在用默认手感。\n * 让它们落到新默认值，才能获得本次灵敏度修复；只有确实高于下限的旧值\n * 才保留其「更严格」的意图。\n */\nfunction legacyThresholdPxToPercent(value: unknown): number | undefined {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) return undefined\n  const percent = Math.round(value / SIDEBAR_GESTURE_LEGACY_THRESHOLD_PX_REFERENCE_WIDTH * 100)\n  return Math.max(DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT, percent)\n}\n\n/** 文件管理增强的独立能力开关。 */\nexport interface FileManagementSettings {\n  /** 是否为文件和目录显示右键操作菜单。 */\n  menuEnhancement: boolean\n  /** 是否为可编辑文本文件显示编辑器入口。 */\n  fileEditor: boolean\n  /** 是否在当前会话顶部显示“修改文件”视图。 */\n  sessionChangedFiles: boolean\n}\n\nexport const DEFAULT_FILE_MANAGEMENT_SETTINGS: FileManagementSettings = {\n  menuEnhancement: true,\n  fileEditor: true,\n  sessionChangedFiles: true,\n}\n\n/** 移动端访问增强的独立能力开关；全部只作用于浏览器侧界面。 */\nexport interface MobileAccessSettings {\n  /** 窄屏下彻底隐藏左侧边栏，只在原位置保留品牌 logo 作为唤起入口。 */\n  hideSidebarOnMobile: boolean\n  /** 是否启用移动端设置界面布局优化。 */\n  optimizeSettingsOnMobile: boolean\n  /** 判定“移动端/窄屏”的视口宽度上限（像素）。 */\n  mobileViewportMaxPx: number\n  /** 移动端触摸设备上是否启用横滑开合左右侧栏。 */\n  sidebarGestures: boolean\n  /** 手势方向映射：右滑/左滑分别对应哪一侧栏。 */\n  sidebarGestureMapping: SidebarGestureMapping\n  /** 手势起手区域：是否允许贴上系统边缘热区。 */\n  sidebarGestureEdge: SidebarGestureEdgeMode\n  /** 触发手势所需的水平位移占视口宽度的百分比（15–80，默认 25）。 */\n  sidebarGestureDistancePercent: number\n}\n\nexport const MOBILE_VIEWPORT_MAX_PX_LIMITS = { min: 480, max: 1280 } as const\nexport const DEFAULT_MOBILE_VIEWPORT_MAX_PX = 1024\n\nexport const DEFAULT_MOBILE_ACCESS_SETTINGS: MobileAccessSettings = {\n  // 窄屏下 DSH 原生侧栏默认只收起成 56px 图标轨道，仍持续占用横向空间；\n  // 默认开启本模块的隐藏能力，用户可随时在设置里关回原生行为。\n  hideSidebarOnMobile: true,\n  optimizeSettingsOnMobile: true,\n  mobileViewportMaxPx: DEFAULT_MOBILE_VIEWPORT_MAX_PX,\n  ...DEFAULT_SIDEBAR_GESTURE_SETTINGS,\n}\n\n/**\n * 归一化移动端访问设置：缺省回填默认值，越界值收敛到允许范围。\n * 第二个参数只用于读取旧版本写在 workspaceSessionEnhancement 下的手势设置。\n */\nexport function normalizeMobileAccessSettings(value: unknown, legacyGestureValue?: unknown): MobileAccessSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  const legacy = typeof legacyGestureValue === 'object' && legacyGestureValue !== null && !Array.isArray(legacyGestureValue)\n    ? legacyGestureValue as Record<string, unknown>\n    : {}\n  const gestureValue = (key: string): unknown => record[key] ?? legacy[key]\n  const gesture: SidebarGestureSettingsInput = {}\n  const sidebarGestures = gestureValue('sidebarGestures')\n  const sidebarGestureMapping = gestureValue('sidebarGestureMapping')\n  const sidebarGestureEdge = gestureValue('sidebarGestureEdge')\n  const sidebarGestureDistancePercent = gestureValue('sidebarGestureDistancePercent')\n  const sidebarGestureThresholdPx = gestureValue('sidebarGestureThresholdPx')\n  if (sidebarGestures !== undefined) gesture.sidebarGestures = sidebarGestures as boolean\n  if (sidebarGestureMapping !== undefined) gesture.sidebarGestureMapping = sidebarGestureMapping as SidebarGestureMapping\n  if (sidebarGestureEdge !== undefined) gesture.sidebarGestureEdge = sidebarGestureEdge as SidebarGestureEdgeMode\n  if (sidebarGestureDistancePercent !== undefined) gesture.sidebarGestureDistancePercent = sidebarGestureDistancePercent as number\n  // 旧像素门槛只在没有新比例值时参与换算，避免把已经迁移过的配置再次改写。\n  if (sidebarGestureDistancePercent === undefined && sidebarGestureThresholdPx !== undefined) {\n    gesture.sidebarGestureThresholdPx = sidebarGestureThresholdPx as number\n  }\n  return {\n    hideSidebarOnMobile: record.hideSidebarOnMobile === undefined\n      ? DEFAULT_MOBILE_ACCESS_SETTINGS.hideSidebarOnMobile\n      : record.hideSidebarOnMobile === true,\n    optimizeSettingsOnMobile: record.optimizeSettingsOnMobile === undefined\n      ? DEFAULT_MOBILE_ACCESS_SETTINGS.optimizeSettingsOnMobile\n      : record.optimizeSettingsOnMobile === true,\n    mobileViewportMaxPx: clampSettingsInteger(\n      record.mobileViewportMaxPx,\n      MOBILE_VIEWPORT_MAX_PX_LIMITS,\n      DEFAULT_MOBILE_ACCESS_SETTINGS.mobileViewportMaxPx,\n    ),\n    ...normalizeSidebarGestureSettings(gesture),\n  }\n}\n\n/** 可复用的快捷会话文本。 */\nexport interface QuickPhrase {\n  id: string\n  text: string\n}\n\n/** 首次启用快捷会话时提供的内置指令。 */\nexport const DEFAULT_QUICK_PHRASES: QuickPhrase[] = [\n  { id: 'builtin-quick-1', text: '请将本次会话变更的所有代码提交到git暂存区，然后总结一条中文的提交信息' },\n  { id: 'builtin-quick-2', text: '分析本项目模块的代码实现，并分析存在的问题' },\n  { id: 'builtin-quick-3', text: '分析当前项目中的未提交文件，按照功能模块进行分类提交，提交信息格式请参考我最近的提交记录' },\n  { id: 'builtin-quick-4', text: '请给出完整的开发提示词，我将在新的页面中继续开发' },\n]\n\n/** 局域网访问 DSH 的持久化配置；dshPort 为 0 表示启动时自动探测，大于 0 时启动前仍会探测，端口已变化则回写新值。 */\nexport interface LanAccessDshSettings {\n  autoStart: boolean\n  listenHost: string\n  listenPort: number\n  dshPort: number\n  /** PWA 资产与安装引导；只在局域网入口生效，不影响本机与中继入口。 */\n  pwa: LanAccessDshPwaSettings\n}\n\n/** 局域网入口的 PWA 增强档位。 */\nexport interface LanAccessDshPwaSettings {\n  /** 是否由代理提供 manifest、图标等静态资产与启动页元数据。 */\n  enabled: boolean\n  /** 是否合成 `/sw.js` 并在安全上下文里注册；默认关闭，避免驻留。 */\n  serviceWorker: boolean\n  /** 是否注入安装引导（Android 提示按钮 / iOS 指引）。 */\n  installPrompt: boolean\n  /** 通知档位；`push` 需要 Host 侧 VAPID 就绪。 */\n  notifications: LanAccessDshNotificationMode\n}\n\nexport type LanAccessDshNotificationMode = 'off' | 'local' | 'push'\n\nexport const DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS: LanAccessDshPwaSettings = {\n  enabled: true,\n  serviceWorker: false,\n  installPrompt: true,\n  notifications: 'off',\n}\n\n/** 归一化 PWA 设置：缺省回填默认值，非法枚举回落到最保守档位。 */\nexport function normalizeLanAccessDshPwaSettings(value: unknown): LanAccessDshPwaSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return {\n    enabled: record.enabled === undefined ? DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS.enabled : record.enabled === true,\n    serviceWorker: record.serviceWorker === true,\n    installPrompt: record.installPrompt === undefined ? DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS.installPrompt : record.installPrompt === true,\n    notifications: record.notifications === 'local' || record.notifications === 'push' ? record.notifications : 'off',\n  }\n}\n\nexport interface LoginProtectionScopes {\n  /** 局域网网卡入口。 */\n  lan: boolean\n  /** Codingns4DSH 中继入口。 */\n  relay: boolean\n}\n\n/** 登录保护的公开设置；密码哈希仅保存在 Host 私有凭据文件中。 */\nexport interface LanAccessDshLoginSettings {\n  enabled: boolean\n  username: string\n  passwordConfigured: boolean\n  timeoutSeconds: number\n  scopes: LoginProtectionScopes\n}\n\nexport const CODINGNS_SETTINGS_NAMESPACE = 'codingns'\n/** DSH 配置表单可能使用的插件 entry id；scoped 包名是当前 Bundle 的正式 ID。 */\nexport const CODINGNS_SETTINGS_ENTRY_IDS = [\n  '@jingyi0605/codingns4dsh',\n  'codingns4dsh',\n  CODINGNS_SETTINGS_NAMESPACE,\n] as const\n\nexport function isCodingNsSettingsEntryId(value: unknown): value is typeof CODINGNS_SETTINGS_ENTRY_IDS[number] {\n  return typeof value === 'string' && (CODINGNS_SETTINGS_ENTRY_IDS as readonly string[]).includes(value)\n}\n\nexport const CODINGNS_CONTROL_BASE_URL_FIELD = 'controlBaseUrl'\nexport const CODINGNS_CONTROL_BASE_URLS_FIELD = 'controlBaseUrls'\nexport const CODINGNS_MODULES_FIELD = 'modules'\nexport const CODINGNS_LAN_ACCESS_DSH_FIELD = 'lanAccessDsh'\nexport const CODINGNS_TERMINAL_ENHANCEMENT_FIELD = 'terminalEnhancement'\nexport const CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD = 'workspaceSessionEnhancement'\nexport const CODINGNS_FILE_MANAGEMENT_FIELD = 'fileManagement'\nexport const CODINGNS_MOBILE_ACCESS_FIELD = 'mobileAccess'\nexport const CODINGNS_SUBSCRIPTION_USAGE_FIELD = 'subscriptionUsage'\nexport const CODINGNS_SUBSCRIPTION_REPORTS_FIELD = 'subscriptionReports'\nexport const CODINGNS_SESSION_TRANSLATION_FIELD = 'sessionTranslation'\nexport const CODINGNS_GIT_MANAGEMENT_FIELD = 'gitManagement'\nexport const CODINGNS_ASSISTANT_FIELD = 'assistant'\nexport const CODINGNS_SUBAGENT_BRIDGE_FIELD = 'subagentBridge'\nexport const DEFAULT_CODINGNS_CONTROL_BASE_URL = 'https://channel.codingns.com:1443'\nexport const DEFAULT_CODINGNS_CONTROL_BASE_URLS = [DEFAULT_CODINGNS_CONTROL_BASE_URL]\n/** 控制站的网页登录地址，用于注册 Codingns4DSH 账号。 */\nexport const CODINGNS_CONTROL_STATION_URL = 'https://channel.codingns.com:1443'\n/** 独立 H5 登录页面地址；登录控制站后可从设置页复制给其他设备。 */\nexport const CODINGNS_H5_LOGIN_URL = 'https://dsh.codingns.com'\nexport const DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS: TerminalEnhancementSettings = {\n  bindingScope: 'workspace',\n  defaultProfile: 'system',\n  appearance: {\n    theme: 'inherit',\n    background: null,\n    foreground: null,\n    cursorColor: null,\n    fontFamily: null,\n    fontSize: null,\n    lineHeight: null,\n    cursorStyle: null,\n    cursorBlink: null,\n    scrollback: null,\n  },\n}\nexport const DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS: WorkspaceSessionEnhancementSettings = {\n  showAdapterLogo: true,\n  showArchivedSessions: true,\n  showWorkspaceHiding: true,\n  hiddenWorkspaceIds: [],\n  showSubscriptionUsage: true,\n  showQuickPhrases: true,\n  showSkillQuickReference: true,\n  optimizeSessionTitles: false,\n  rememberConversationRightbarRatio: false,\n  quickPhrases: DEFAULT_QUICK_PHRASES.map((phrase) => ({ ...phrase })),\n  quickPhrasesSeeded: true,\n}\nexport const DEFAULT_CODINGNS_SETTINGS: CodingNsSettings = {\n  controlBaseUrl: DEFAULT_CODINGNS_CONTROL_BASE_URL,\n  controlBaseUrls: [...DEFAULT_CODINGNS_CONTROL_BASE_URLS],\n  modules: {},\n  agentAdapters: {},\n  agentAdapterPreferences: {},\n  subagentBridge: DEFAULT_SUBAGENT_BRIDGE_SETTINGS,\n  sessionTranslation: DEFAULT_SESSION_TRANSLATION_SETTINGS,\n  sessionHandleEviction: DEFAULT_SESSION_HANDLE_EVICTION_SETTINGS,\n  gitManagement: DEFAULT_GIT_MANAGEMENT_SETTINGS,\n  terminalEnhancement: DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS,\n  workspaceSessionEnhancement: DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS,\n  fileManagement: DEFAULT_FILE_MANAGEMENT_SETTINGS,\n  mobileAccess: DEFAULT_MOBILE_ACCESS_SETTINGS,\n  subscriptionUsage: DEFAULT_SUBSCRIPTION_USAGE_SETTINGS,\n  subscriptionReports: DEFAULT_SUBSCRIPTION_REPORT_SETTINGS,\n  assistant: DEFAULT_ASSISTANT_SETTINGS,\n  lanAccessDsh: {\n    autoStart: false,\n    listenHost: '0.0.0.0',\n    listenPort: 13080,\n    dshPort: 0,\n    pwa: DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS,\n  },\n}\n\n/** 重启生效模块在当前进程启动时捕获的有效状态。 */\nexport type RestartFeatureStates = Readonly<Record<string, boolean>>\n\nexport function captureRestartFeatureStates(\n  descriptors: readonly FeatureDescriptor[],\n  settings: CodingNsSettings | undefined,\n  dshVersion?: string,\n): Record<string, boolean> {\n  const states: Record<string, boolean> = {}\n  for (const descriptor of descriptors) {\n    if (descriptor.activation === 'restart') {\n      states[descriptor.name] = isFeatureDshVersionCompatible(descriptor, dshVersion)\n        && isFeatureEnabled(descriptor, settings)\n    }\n  }\n  return states\n}\n\n/**\n * 判定一个功能模块当前是否应当启用。\n *\n * 常驻模块（ui.alwaysEnabled）始终启用；其余模块读取设置里的用户意图，\n * 用户没有表达过意图时使用模块自己声明的 enabledByDefault。\n */\nexport function isFeatureEnabled(\n  descriptor: FeatureDescriptor,\n  settings: CodingNsSettings | undefined,\n): boolean {\n  if (descriptor.disabled === true) return false\n  if (descriptor.ui?.alwaysEnabled === true) return true\n  return settings?.modules[descriptor.name] ?? descriptor.enabledByDefault\n}\n\n/** 汇总当前应当启用的模块名，交给 FeatureRegistry.reconcile 对齐状态。 */\nexport function enabledFeatureNames(\n  descriptors: readonly FeatureDescriptor[],\n  settings: CodingNsSettings | undefined,\n  restartStates?: RestartFeatureStates,\n  dshVersion?: string,\n): string[] {\n  const names: string[] = []\n  for (const descriptor of descriptors) {\n    const enabled = descriptor.activation === 'restart' && restartStates !== undefined\n      ? restartStates[descriptor.name] ?? descriptor.enabledByDefault\n      : isFeatureEnabled(descriptor, settings)\n    if (enabled && isFeatureDshVersionCompatible(descriptor, dshVersion)) names.push(descriptor.name)\n  }\n  return names\n}\n\n/** 判断模块是否可以在当前 DSH 版本运行。未提供运行时版本时保留旧调用方行为。 */\nexport function isFeatureDshVersionCompatible(\n  descriptor: FeatureDescriptor,\n  dshVersion?: string,\n): boolean {\n  if (descriptor.minimumDshVersion === undefined || dshVersion === undefined) return true\n  return isDshVersionAtLeast(dshVersion, descriptor.minimumDshVersion)\n}\n","import type { Context } from '@deepseek-ai/cordis'\n\n/** DSH 原生 Workspace 列表 Store；消费方只用到这两条读取通道。 */\nexport interface NativeWorkspaceListStore {\n  getSnapshot: () => unknown\n  subscribe: (listener: () => void) => () => void\n}\n\n/** 原生 Workspace 列表项的最小结构；PeerHost 虚拟工作区也由这份读取提供。 */\nexport interface NativeWorkspaceRecord {\n  readonly workspaceId: string\n  readonly path?: string\n  /** 用于界面展示的真实工作区路径；远程工作区的 `path` 保留为虚拟路由路径。 */\n  readonly workspacePath?: string\n  readonly title: string\n  /** 远程工作区所属的目标 Host；本机工作区没有该字段。 */\n  readonly hostId?: string\n  /** 远程工作区所属 Host 的友好名称；缺失时由界面回退到 hostId。 */\n  readonly hostLabel?: string\n  /** 远程工作区所属 Host 的配置颜色；非法值由显示层回退到稳定推导色。 */\n  readonly hostColor?: string\n  readonly sessionIds: readonly string[]\n}\n\n/** `workspaces.list` 快照的最小结构；归档集合是 Registry 级共享的一份列表。 */\nexport interface NativeWorkspaceSnapshot {\n  readonly items: readonly NativeWorkspaceRecord[]\n  readonly archivedSessionIds: readonly string[]\n}\n\n/**\n * 读取原生 Workspace 列表 Store 对象本身。\n *\n * PeerHost 顺序投影必须就地改写这个对象的方法，归档入口只读它的快照。\n */\nexport function readNativeWorkspaceListStore(uiContext: Context | undefined): NativeWorkspaceListStore | undefined {\n  const store = readNativeService(uiContext, 'workspaces', 'list')\n  if (!isRecord(store) || typeof store.getSnapshot !== 'function' || typeof store.subscribe !== 'function') return undefined\n  return store as unknown as NativeWorkspaceListStore\n}\n\n/** 读取原生 Workspace 快照；形状不符或服务缺失时返回 undefined，调用方退回原生 Remote。 */\nexport function readNativeWorkspaceSnapshot(uiContext: Context | undefined): NativeWorkspaceSnapshot | undefined {\n  const store = readNativeWorkspaceListStore(uiContext)\n  const snapshot = store?.getSnapshot()\n  const record = isRecord(snapshot) ? snapshot : undefined\n  if (record === undefined || !Array.isArray(record.items)) return undefined\n  return {\n    items: record.items.flatMap((item) => {\n      const value = isRecord(item) ? item : undefined\n      const workspaceId = readText(value?.workspaceId)\n      if (workspaceId === undefined) return []\n      const path = readText(value?.path)\n      const workspacePath = readText(value?.workspacePath)\n      const title = readText(value?.title) ?? workspacePath ?? path ?? workspaceId\n      const hostId = readText(value?.hostId)\n      const hostLabel = readText(value?.hostLabel)\n      const hostColor = readText(value?.hostColor)\n      return [{\n        workspaceId,\n        ...(path === undefined ? {} : { path }),\n        ...(workspacePath === undefined ? {} : { workspacePath }),\n        title,\n        ...(hostId === undefined ? {} : { hostId }),\n        ...(hostLabel === undefined ? {} : { hostLabel }),\n        ...(hostColor === undefined ? {} : { hostColor }),\n        sessionIds: readTextList(value?.sessionIds),\n      }]\n    }),\n    archivedSessionIds: readTextList(record.archivedSessionIds),\n  }\n}\n\n/** 只在会话所属工作区变化时通知，避免标题/运行态增量触发昂贵的文件与 Git 查询。 */\nexport function subscribeNativeSessionWorkspace(\n  uiContext: Context | undefined,\n  sessionId: string,\n  listener: () => void,\n): () => void {\n  const readWorkspaceId = (): string | undefined => readNativeWorkspaceSnapshot(uiContext)?.items\n    .find((item) => item.sessionIds.includes(sessionId))?.workspaceId\n  let workspaceId = readWorkspaceId()\n  return readNativeWorkspaceListStore(uiContext)?.subscribe(() => {\n    const next = readWorkspaceId()\n    if (next === workspaceId) return\n    workspaceId = next\n    listener()\n  }) ?? (() => undefined)\n}\n\n/** 读取 DSH 原生服务集合中的字段；非 Web 宿主或版本差异时保持缺失。 */\nexport function readNativeService(uiContext: Context | undefined, name: string, field?: string): unknown {\n  if (uiContext === undefined) return undefined\n  try {\n    const getter = (uiContext as { get?: (service: string) => unknown }).get\n    if (typeof getter !== 'function') return undefined\n    const service = getter.call(uiContext, name)\n    if (field === undefined) return service\n    return isRecord(service) ? service[field] : undefined\n  } catch {\n    // 原生服务不可用（非 Web Client 宿主或版本差异）时保持本机行为。\n    return undefined\n  }\n}\n\nfunction readText(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined\n}\n\nfunction readTextList(value: unknown): string[] {\n  return Array.isArray(value) ? value.flatMap((item) => { const text = readText(item); return text === undefined ? [] : [text] }) : []\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.native-workspace-store.js","names":["DEFAULT_ASSISTANT_NOTIFICATION_SETTINGS","DEFAULT_ASSISTANT_PROMPTS","DEFAULT_SESSION_TRANSLATION_SETTINGS"],"sources":["../../../../src/shared/contracts/version.ts","../../../../src/shared/contracts/git.ts","../../../../src/shared/contracts/config.ts","../../../../src/client/native-workspace-store.ts"],"sourcesContent":["/** DSH verification target, synchronized with the root version.json. */\nexport const DSH_VERSION = '0.2.1-rc.3' as const\n\n/** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */\nexport const DSH_TESTED_VERSION = DSH_VERSION\n\n/**\n * Only the minimum version blocks installation and activation.\n * Hosts newer than DSH_TESTED_VERSION receive an advisory warning.\n */\nexport const DSH_COMPATIBILITY = '>=0.2.0-rc.2' as const\n\n/**\n * 兼容范围下界，即插件仍然接受的最低 DSH 版本。\n *\n * 供“宿主没有注入真实版本、但已确认处于现代世代”的保守回退使用：回退值取自\n * 范围本身，因此永远落在兼容范围内。写死某个历史版本会在范围收紧后变成\n * “不支持的 DSH 版本”，把仅仅缺少启动页注入的页面误判为宿主不兼容。\n */\nexport function minimumSupportedDshVersion(): string {\n  const match = /^>=([^ ]+)/u.exec(DSH_COMPATIBILITY)\n  return match?.[1] ?? DSH_VERSION\n}\n\n/** DSH Envelope/Tunnel 协议主版本。 */\nexport const DSH_PROTOCOL_VERSION = 1 as const\n\n/** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */\nexport const CODINGNS_DSH_VERSION_GLOBAL = '__CODINGNS_DSH_VERSION__' as const\n\n/** 识别没有 alpha2 Sidebar 扩展 API 的 DSH 旧版运行时。 */\nexport function isLegacyDshVersion(version: string): boolean {\n  return /^0\\.1\\.5(?:-|$)/u.test(version)\n}\n\n/** Codingns4DSH 插件自身的 npm 版本。 */\nexport const CODINGNS_VERSION = '0.2.1-rc.6' as const\n\ninterface ParsedVersion {\n  readonly major: number\n  readonly minor: number\n  readonly patch: number\n  readonly prerelease: readonly string[]\n}\n\n/** Accept any valid host version at or above the supported minimum. */\nexport function isDshVersionCompatible(version: string): boolean {\n  return isDshVersionAtLeast(version, minimumSupportedDshVersion())\n}\n\n/** Newer hosts stay enabled; this predicate controls advisory notices only. */\nexport function isDshVersionNewerThanTested(version: string): boolean {\n  const actual = parseVersion(version)\n  const tested = parseVersion(DSH_TESTED_VERSION)\n  return actual !== undefined && tested !== undefined && compareVersions(actual, tested) > 0\n}\n\n/** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */\nexport function isDshVersionAtLeast(version: string, minimum: string): boolean {\n  return isVersionAtLeast(version, minimum)\n}\n\n/** 按语义版本比较大小；预发布标识参与排序，构建元数据不影响优先级，非法版本不放行。 */\nexport function isVersionAtLeast(version: string, minimum: string): boolean {\n  const actual = parseVersion(version)\n  const required = parseVersion(minimum)\n  if (!actual || !required) return false\n  return compareVersions(actual, required) >= 0\n}\n\nfunction parseVersion(value: string): ParsedVersion | undefined {\n  const match = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u.exec(value)\n  if (!match) return undefined\n  const core = match.slice(1, 4).map(Number)\n  if (!core.every(Number.isSafeInteger)) return undefined\n  const prerelease = match[4]?.split('.') ?? []\n  // 数字预发布标识不能有前导零；超大数字保留字符串，用长度比较避免精度丢失。\n  if (prerelease.some((part) => /^0\\d+$/u.test(part))) return undefined\n  return {\n    major: Number(match[1]),\n    minor: Number(match[2]),\n    patch: Number(match[3]),\n    prerelease,\n  }\n}\n\nfunction compareVersions(left: ParsedVersion, right: ParsedVersion): number {\n  for (const key of ['major', 'minor', 'patch'] as const) {\n    if (left[key] !== right[key]) return left[key] - right[key]\n  }\n  if (left.prerelease.length === 0 && right.prerelease.length > 0) return 1\n  if (left.prerelease.length > 0 && right.prerelease.length === 0) return -1\n  for (let index = 0; index < Math.max(left.prerelease.length, right.prerelease.length); index += 1) {\n    const leftPart = left.prerelease[index]\n    const rightPart = right.prerelease[index]\n    if (leftPart === undefined) return -1\n    if (rightPart === undefined) return 1\n    if (leftPart === rightPart) continue\n    const leftNumeric = /^\\d+$/u.test(leftPart)\n    const rightNumeric = /^\\d+$/u.test(rightPart)\n    if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1\n    if (leftNumeric && leftPart.length !== rightPart.length) return leftPart.length - rightPart.length\n    return leftPart < rightPart ? -1 : 1\n  }\n  return 0\n}\n","/** Git 工作区面板在 Host 与 Client 之间传输的稳定契约。 */\n\nexport interface GitCommitMessageModel {\n  readonly provider: string\n  readonly model: string\n}\n\nexport interface GitManagementSettings {\n  readonly commitMessageEnabled: boolean\n  readonly commitMessageDetail: 'concise' | 'detailed'\n  readonly commitMessageModels: readonly GitCommitMessageModel[]\n  readonly commitMessagePrompt: string\n}\n\nexport const DEFAULT_GIT_MANAGEMENT_SETTINGS: GitManagementSettings = {\n  commitMessageEnabled: true,\n  commitMessageDetail: 'concise',\n  commitMessageModels: [],\n  commitMessagePrompt: '',\n}\n\nexport const MAX_GIT_COMMIT_MESSAGE_CHARS = 10_000\nexport const MAX_GIT_COMMIT_PROMPT_CHARS = 10_000\n\nexport function normalizeGitManagementSettings(value: GitManagementSettings | undefined): GitManagementSettings {\n  const seen = new Set<string>()\n  return {\n    commitMessageEnabled: value?.commitMessageEnabled !== false,\n    commitMessageDetail: value?.commitMessageDetail === 'detailed' ? 'detailed' : 'concise',\n    commitMessagePrompt: typeof value?.commitMessagePrompt === 'string' ? value.commitMessagePrompt : '',\n    commitMessageModels: (value?.commitMessageModels ?? []).flatMap((item) => {\n      const provider = item?.provider?.trim()\n      const model = item?.model?.trim()\n      if (!provider || !model) return []\n      const key = JSON.stringify([provider, model])\n      if (seen.has(key)) return []\n      seen.add(key)\n      return [{ provider, model }]\n    }),\n  }\n}\n\nexport interface GitCommitMessageDraft {\n  readonly message: string\n}\n\nexport interface GitRepoSnapshot {\n  readonly workspaceId: string\n  readonly repoRoot: string\n  /** 当前工作区是否已经初始化为 Git 仓库；旧 Host 未提供时按 true 兼容。 */\n  readonly enabled?: boolean\n  readonly branch: string\n  readonly ahead: number\n  readonly behind: number\n  readonly hasRemote: boolean\n  readonly isDirty: boolean\n  readonly lastFetchedAt: string | null\n}\n\nexport interface GitChangeItem {\n  readonly path: string\n  readonly status: string\n  readonly staged: boolean\n  readonly oldPath: string | null\n  readonly binary: boolean\n  readonly stagedStatus: string | null\n  readonly worktreeStatus: string | null\n}\n\nexport interface GitStatus {\n  readonly snapshot: GitRepoSnapshot\n  readonly changes: readonly GitChangeItem[]\n}\n\nexport interface GitDiff {\n  readonly workspaceId: string\n  readonly path: string\n  readonly staged: boolean\n  readonly binary: boolean\n  readonly truncated: boolean\n  readonly content: string\n}\n\nexport interface GitHistoryItem {\n  readonly commitHash: string\n  readonly authorName: string\n  readonly authoredAt: string\n  readonly subject: string\n  readonly body: string\n  readonly refs: readonly GitHistoryRef[]\n  /** 父提交哈希；旧 Host 未提供时 Client 退化为线性轨道，不绘制分支/合并连线。 */\n  readonly parents?: readonly string[]\n  /** 提交相对当前分支与远程分支的归属；旧 Host 未提供或仓库过大时省略。 */\n  readonly origin?: GitHistoryOrigin\n}\n\nexport interface GitHistoryRef {\n  readonly name: string\n  readonly kind: 'head' | 'local' | 'remote' | 'tag'\n  readonly remoteName: string | null\n}\n\n/** 版本历史的取值范围：仅当前分支，或全部本地分支与远程跟踪分支。 */\nexport type GitHistoryScope = 'head' | 'all'\n\n/**\n * 提交归属：\n * - `local`：只在本机分支上，没有任何远程跟踪分支包含它（未推送）；\n * - `synced`：当前分支与至少一个远程跟踪分支都包含它；\n * - `remote`：只有远程跟踪分支包含它（本地还没有，例如拉取前）；\n * - `branch`：只有其他本地分支包含它，当前分支与远程都没有。\n */\nexport type GitHistoryOrigin = 'local' | 'synced' | 'remote' | 'branch'\n\nexport interface GitHistoryPage {\n  readonly items: readonly GitHistoryItem[]\n  readonly cursor: string | null\n  readonly nextCursor: string | null\n  readonly totalCount: number\n}\n\nexport interface GitBranchItem {\n  readonly name: string\n  readonly current: boolean\n  readonly upstream: string | null\n  readonly remote: boolean\n}\n\nexport interface GitBranchSnapshot {\n  readonly currentBranch: string\n  readonly local: readonly GitBranchItem[]\n  readonly remote: readonly GitBranchItem[]\n}\n\nexport interface GitCommitResult {\n  readonly commitHash: string\n  readonly summary: string\n}\n\nexport interface GitCommitChangedFile {\n  readonly path: string\n  readonly oldPath: string | null\n  readonly status: string\n  readonly binary: boolean\n}\n\nexport interface GitCommitDiff {\n  readonly commitHash: string\n  /** 旧版 Host 未提供时由 Client 从 diff 头部回退解析。 */\n  readonly files?: readonly GitCommitChangedFile[]\n  readonly content: string\n  readonly truncated: boolean\n}\n","import type { FeatureDescriptor } from './feature.js'\nimport type { CodingNsCliSessionRecord } from './cli-adapter.js'\nimport { isDshVersionAtLeast } from './version.js'\nimport type { AssistantAppearanceSettings } from '../assistant-avatar.js'\nimport { DEFAULT_ASSISTANT_PROMPTS, type AssistantPromptSettings } from '../assistant-prompts.js'\nimport type { AssistantTtsSettings } from '../assistant-tts.js'\nimport { DEFAULT_ASSISTANT_NOTIFICATION_SETTINGS, type AssistantNotificationSettings } from '../assistant-notifications.js'\nimport { DEFAULT_SESSION_TRANSLATION_SETTINGS, type SessionTranslationSettings } from './session-translation.js'\nimport { DEFAULT_GIT_MANAGEMENT_SETTINGS, type GitManagementSettings } from './git.js'\n\n/** 适配器最近一次使用的模型、思考强度与服务档位。 */\nexport interface CodingNsCliAdapterPreference {\n  readonly modelId?: string | undefined\n  readonly effortId?: string | undefined\n  /** Provider 服务档位（例如 Codex 官方订阅的 Fast）；`default` 表示标准速度。 */\n  readonly serviceTierId?: string | undefined\n  /** 新建会话模型选择器中的“翻译对话”开关，按 Agent 隔离记忆。 */\n  readonly translationEnabled?: boolean | undefined\n}\n\n/** 全局智能助理设置；默认空范围，必须由用户显式勾选工作区。 */\nexport type AssistantVoiceProvider = 'dsh-speech-to-text' | 'sherpa-onnx'\n\n/** 全局语音助理初始化配置；模型目录由 Host 自动下载并写入。 */\nexport interface AssistantVoiceSettings {\n  initialized: boolean\n  provider: AssistantVoiceProvider\n  /** 已安装的实时模型目录 ID；旧配置没有该字段时按空值兼容。 */\n  modelId?: string\n  asrEncoder: string\n  asrDecoder: string\n  asrJoiner: string\n  asrTokens: string\n  vadModel: string\n  ttsModel: string\n  ttsTokens: string\n  ttsLexicon: string\n}\n\nexport const DEFAULT_ASSISTANT_VOICE_SETTINGS: AssistantVoiceSettings = {\n  initialized: false,\n  provider: 'dsh-speech-to-text',\n  modelId: '',\n  asrEncoder: '',\n  asrDecoder: '',\n  asrJoiner: '',\n  asrTokens: '',\n  vadModel: '',\n  ttsModel: '',\n  ttsTokens: '',\n  ttsLexicon: '',\n}\n\nexport interface AssistantSettings {\n  /** 旧配置缺省全开；展示仍受模块、助理创建和形象开关约束。 */\n  notifications?: AssistantNotificationSettings\n  /** 只有显式 initialized=true 表示已创建；缺省或 false 时旧配置仅预填创建表单。 */\n  profile?: AssistantProfileSettings\n  /** 缺省跟随 DSH 默认模型；固定选择同时用于项目索引与正式对话。 */\n  model?: { readonly provider: string; readonly model: string }\n  /** 允许助理读取和派发的工作区 ID。 */\n  managedWorkspaceIds: string[]\n  /** 语音提供方与本地模型路径；未初始化时点击入口只打开模型选择页。 */\n  voice: AssistantVoiceSettings\n  /** 统一形象配置；旧设置缺失时由展示层补默认值。 */\n  appearance?: AssistantAppearanceSettings\n  /** 索引总结与对话前置提示词；旧配置使用默认口语化提示词。 */\n  prompts?: AssistantPromptSettings\n  /** 独立音色与输出后端；缺省保留浏览器播报以兼容旧配置。 */\n  tts?: AssistantTtsSettings\n}\n\nexport interface AssistantProfileSettings {\n  readonly name: string\n  /** 角色性格与背景，旧档案缺省时不额外限定角色；不作为项目事实。 */\n  readonly personality?: string\n  readonly initialized: boolean\n  readonly createdAt: number | null\n}\n\nexport const DEFAULT_ASSISTANT_SETTINGS: AssistantSettings = {\n  notifications: DEFAULT_ASSISTANT_NOTIFICATION_SETTINGS,\n  managedWorkspaceIds: [],\n  voice: DEFAULT_ASSISTANT_VOICE_SETTINGS,\n  prompts: DEFAULT_ASSISTANT_PROMPTS,\n}\n\n/** Codingns4DSH 在 DSH 设置文档中持久化的用户选项。 */\nexport interface CodingNsSettings {\n  /** Control API 地址不是秘密，可以由 Web 设置页保存到 Host 设置。 */\n  controlBaseUrl: string\n  /** Control API 地址候选列表；列表本身不包含任何凭据。 */\n  controlBaseUrls: string[]\n  /** 局域网访问 DSH 的唯一监听映射及启动策略。 */\n  lanAccessDsh: LanAccessDshSettings\n  /** 插件 Sidebar 终端的默认 profile 与受控外观设置。 */\n  terminalEnhancement: TerminalEnhancementSettings\n  /** 原生工作区会话行的浏览器端增强选项。 */\n  workspaceSessionEnhancement: WorkspaceSessionEnhancementSettings\n  /** DSH 文件管理侧栏的独立增强选项。 */\n  fileManagement: FileManagementSettings\n  /** Shortcut references only; approvals and launch secrets are Host runtime state. */\n  quickApps?: import('./quick-apps.js').QuickApp[]\n  /** 手机/平板窄屏访问时的界面增强选项。 */\n  mobileAccess: MobileAccessSettings\n  /** 用量查询设置：超时控制单次网络查询，间隔控制自动刷新。 */\n  subscriptionUsage: SubscriptionUsageSettings\n  /** 订阅用量页面的显示选项；存在 Host，刷新页面或换设备后都保持一致。 */\n  subscriptionReports?: SubscriptionReportSettings\n  /** 全局智能助理设置；不绑定当前页面会话。 */\n  assistant: AssistantSettings\n  /**\n   * 功能模块启用意图：模块名 -> 是否启用。\n   *\n   * 缺省时回落到模块自己声明的 enabledByDefault，因此设置结构不随模块数量变化。\n  */\n  modules: Record<string, boolean>\n  /** 外部 Agent 启用意图：适配器 id -> 是否启用；缺省时所有已注册 Agent 启用。 */\n  agentAdapters?: Record<string, boolean>\n  /** Host 侧外部 Agent 会话索引；不含凭据和原始消息。 */\n  cliSessions?: CodingNsCliSessionRecord[]\n  /** 适配器级最近选择；新建会话时作为默认模型和思考强度。 */\n  agentAdapterPreferences?: Record<string, CodingNsCliAdapterPreference>\n  /** 外部 CLI 子代理托管：把外部 Agent 自己的子代理调用转为 DSH 原生可续子会话。 */\n  subagentBridge?: SubagentBridgeSettings\n  /** 外部 Agent 会话输入与输出的翻译设置。 */\n  sessionTranslation?: SessionTranslationSettings\n  /** Bounds for the host-side resident DSH session-handle safety net. */\n  sessionHandleEviction: SessionHandleEvictionSettings\n  /** Commit message generation preferences, independent of translation settings. */\n  gitManagement?: GitManagementSettings\n}\n\n/** 外部 CLI 子代理托管设置；关闭时所有驱动保持原样。 */\nexport interface SubagentBridgeSettings {\n  enabled: boolean\n  /**\n   * 同一父会话可同时保留的托管子代理数。\n   *\n   * 外部 CLI（如 Command Code）会在一批里并发开出远超上限的子代理调用；超限\n   * 调用过去直接失败并静默回退到 CLI 内建子代理，父会话与界面都看不出差异。\n   * 与 DSH 自身的 `maxActiveSubagents`（缺省 8）保持同一量级，并允许用户按机器\n   * 负载调整。\n   */\n  maxConcurrentSubagents: number\n}\n\n/** 并发子代理数上限：下限 1 保证至少能派发，上限避免一次性压垮本机。 */\nexport const SUBAGENT_BRIDGE_MAX_CONCURRENT_LIMITS = { min: 1, max: 32 } as const\n\nexport const DEFAULT_SUBAGENT_BRIDGE_SETTINGS: SubagentBridgeSettings = {\n  enabled: false,\n  maxConcurrentSubagents: 8,\n}\n\n/** Host-side bounds for resident DSH JSONL session handles. */\nexport interface SessionHandleEvictionSettings {\n  enabled: boolean\n  idleTtlMs: number\n  maxOpenHandles: number\n}\n\nexport const SESSION_HANDLE_EVICTION_IDLE_TTL_MS_LIMITS = { min: 1_000, max: 86_400_000 } as const\nexport const SESSION_HANDLE_EVICTION_MAX_OPEN_HANDLES_LIMITS = { min: 1, max: 1_024 } as const\nexport const DEFAULT_SESSION_HANDLE_EVICTION_SETTINGS: SessionHandleEvictionSettings = {\n  enabled: true,\n  idleTtlMs: 600_000,\n  maxOpenHandles: 32,\n}\n\n/** 归一化子代理托管设置：只有显式 true 才算开启；并发数按上下限收敛。 */\nexport function normalizeSubagentBridgeSettings(value: unknown): SubagentBridgeSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return {\n    enabled: record.enabled === true,\n    maxConcurrentSubagents: clampSettingsInteger(\n      record.maxConcurrentSubagents,\n      SUBAGENT_BRIDGE_MAX_CONCURRENT_LIMITS,\n      DEFAULT_SUBAGENT_BRIDGE_SETTINGS.maxConcurrentSubagents,\n    ),\n  }\n}\n\n/** 用量查询设置：超时控制单次网络查询，间隔控制自动刷新。 */\nexport interface SubscriptionUsageSettings {\n  /** 单次用量查询的网络超时（秒）。 */\n  timeoutSecs: number\n  /** 自动查询间隔（分钟）；0 表示不自动查询。 */\n  refreshIntervalMins: number\n}\n\nexport const DEFAULT_SUBSCRIPTION_USAGE_SETTINGS: SubscriptionUsageSettings = { timeoutSecs: 10, refreshIntervalMins: 5 }\nexport const SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS = { min: 3, max: 120 } as const\nexport const SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS = { min: 0, max: 1440 } as const\n\n/** 归一化用量查询设置：缺省字段回填默认值，越界值收敛到允许范围。 */\nexport function normalizeSubscriptionUsageSettings(value: unknown): SubscriptionUsageSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return {\n    timeoutSecs: clampSettingsInteger(record.timeoutSecs, SUBSCRIPTION_USAGE_TIMEOUT_SECS_LIMITS, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.timeoutSecs),\n    refreshIntervalMins: clampSettingsInteger(record.refreshIntervalMins, SUBSCRIPTION_USAGE_REFRESH_INTERVAL_MINS_LIMITS, DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.refreshIntervalMins),\n  }\n}\n\n/** 订阅用量卡片上进度条与百分比的口径：已用多少，还是还剩多少。 */\nexport type SubscriptionQuotaView = 'used' | 'remaining'\n\n/**\n * 订阅用量页面的显示选项。\n *\n * 只保存\"看哪个口径\"这类纯展示偏好：它不改变 Host 拉取的数据，也不影响任何\n * 额度计算，因此可以安全地下发给所有客户端并在跨设备时保持一致。\n */\nexport interface SubscriptionReportSettings {\n  /** 订阅卡默认展示已用还是剩余；口径只影响读法，不改变数据来源。 */\n  quotaView: SubscriptionQuotaView\n}\n\nexport const DEFAULT_SUBSCRIPTION_REPORT_SETTINGS: SubscriptionReportSettings = { quotaView: 'remaining' }\n\n/** 归一化订阅用量显示选项：只接受两个已知口径，其余一律回落默认值。 */\nexport function normalizeSubscriptionReportSettings(value: unknown): SubscriptionReportSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return { quotaView: record.quotaView === 'used' || record.quotaView === 'remaining' ? record.quotaView : DEFAULT_SUBSCRIPTION_REPORT_SETTINGS.quotaView }\n}\n\nfunction clampSettingsInteger(value: unknown, limits: { readonly min: number; readonly max: number }, fallback: number): number {\n  const numeric = typeof value === 'number' && Number.isFinite(value) ? Math.round(value) : fallback\n  return Math.min(limits.max, Math.max(limits.min, numeric))\n}\n\n/** 0.1.7 ConfigForm 面向用户的持久化配置；Host-only 会话索引不在其中。 */\nexport type CodingNsConfig = Omit<CodingNsSettings, 'cliSessions'>\n\n/** Host 运行时状态，与可编辑配置分离，避免泄露到 Client 配置表单。 */\nexport interface CodingNsRuntimeState {\n  readonly cliSessions: CodingNsCliSessionRecord[]\n}\n\n/** 跨平台终端 profile；`system` 由 Host 根据平台和已安装 shell 解析。 */\nexport type TerminalProfileId = 'system' | 'zsh' | 'bash' | 'powershell' | 'cmd' | 'git-bash'\n/** 终端持久记录的归属范围；工作区模式允许不同 DSH 会话共享终端。 */\nexport type TerminalBindingScope = 'workspace' | 'session'\n\nexport type TerminalAppearanceTheme = 'inherit' | 'custom'\nexport type TerminalCursorStyle = 'block' | 'bar' | 'underline'\n\n/** 仅保存可映射到 xterm 公开选项的外观字段。 */\nexport interface TerminalAppearanceSettings {\n  theme: TerminalAppearanceTheme\n  background: string | null\n  foreground: string | null\n  cursorColor: string | null\n  fontFamily: string | null\n  fontSize: number | null\n  lineHeight: number | null\n  cursorStyle: TerminalCursorStyle | null\n  cursorBlink: boolean | null\n  scrollback: number | null\n}\n\nexport interface TerminalEnhancementSettings {\n  /** 缺省按工作区归属；旧设置缺少此字段时由 schema 回填。 */\n  bindingScope?: TerminalBindingScope\n  defaultProfile: TerminalProfileId\n  appearance: TerminalAppearanceSettings\n}\n\n/** 工作区会话增强的用户可见设置；每个子能力都可以独立开关。 */\nexport interface WorkspaceSessionEnhancementSettings {\n  showAdapterLogo: boolean\n  /** 是否在每个有归档会话的工作区中显示归档入口。 */\n  showArchivedSessions: boolean\n  /** 是否在工作区菜单提供隐藏与恢复工作区入口。 */\n  showWorkspaceHiding: boolean\n  /** 插件本地隐藏的工作区 ID；不改变 DSH 原生工作区数据。 */\n  hiddenWorkspaceIds: string[]\n  /** 是否在对话底部显示订阅与上游用量检测。 */\n  showSubscriptionUsage: boolean\n  /** 是否在输入工具区显示快捷会话入口。 */\n  showQuickPhrases: boolean\n  /** 是否索引当前会话所选 Agent 的 Skill，并通过指令快速引用。 */\n  showSkillQuickReference: boolean\n  /** 是否优化 DSH 自动标题的语义、长度和失败时的兜底文字。 */\n  optimizeSessionTitles: boolean\n  /** 是否记忆对话窗口与右侧栏的宽度比例；具体比例保存在当前浏览器。 */\n  rememberConversationRightbarRatio: boolean\n  /** 插件本地保存的快捷会话条目。 */\n  quickPhrases: QuickPhrase[]\n  /** 内置快捷会话是否已经完成首次初始化；仅用于兼容旧配置。 */\n  quickPhrasesSeeded: boolean\n  /**\n   * 旧版本曾把手势设置写在这里。保留可选字段只用于读取旧配置，新的设置一律写入\n   * `mobileAccess`，避免升级后把用户主动关闭的手势重新打开。\n   */\n  sidebarGestures?: boolean\n  sidebarGestureMapping?: SidebarGestureMapping\n  sidebarGestureEdge?: SidebarGestureEdgeMode\n  /** 已废弃的像素门槛；只在归一化时用于推导比例，新配置一律写入 `sidebarGestureDistancePercent`。 */\n  sidebarGestureThresholdPx?: number\n}\n\n/** 移动端侧栏横滑设置。 */\nexport interface SidebarGestureSettings {\n  /** 是否在触摸设备上启用横滑开合左右侧栏。 */\n  sidebarGestures: boolean\n  /** 手势方向映射：右滑/左滑分别对应哪一侧栏。 */\n  sidebarGestureMapping: SidebarGestureMapping\n  /** 手势起手区域：是否允许贴上系统边缘热区。 */\n  sidebarGestureEdge: SidebarGestureEdgeMode\n  /**\n   * 触发手势所需的水平位移占视口宽度的百分比。\n   *\n   * 用比例而不是像素：同一个像素值在 360px 手机与 1024px 平板上的手势占比相差\n   * 近三倍，只有比例才能让「灵敏度」这个设置在各类设备上表达同一件事。\n   *\n   * 该值只约束**距离通道**；位移不足时仍可由甩动通道（快速轻甩）触发。\n   */\n  sidebarGestureDistancePercent: number\n}\n\n/** 横滑手势的方向映射。 */\nexport type SidebarGestureMapping = 'swipe-inward' | 'swap'\n\n/** 横滑手势的起手区域。 */\nexport type SidebarGestureEdgeMode = 'avoid' | 'edge'\n\nexport const SIDEBAR_GESTURE_DISTANCE_PERCENT_LIMITS = { min: 15, max: 80 } as const\n/**\n * 默认 25%：配合甩动通道，实测有意手势成功率 100%、误触率 0%。\n *\n * 旧默认 40% 与「距离与速度同时达标」的组合让正常滑动被系统性误杀（实测成功率仅 30%），\n * 用户需要重复滑动才能呼出侧栏。\n */\nexport const DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT = 25\n/**\n * 旧像素门槛换算成比例时使用的参考视口宽度。\n *\n * 旧实现的有效阈值是 `max(像素值, 视口宽度 × 40%)`，像素值只有超过该下限才生效。\n * 取常见手机宽度 390px 作为换算基准，并保证结果不低于新的默认值，让「没生效过的旧值」\n * 迁移后直接落到新默认值，从而真正获得本次灵敏度修复。\n */\nexport const SIDEBAR_GESTURE_LEGACY_THRESHOLD_PX_REFERENCE_WIDTH = 390\n\nexport const DEFAULT_SIDEBAR_GESTURE_SETTINGS: SidebarGestureSettings = {\n  sidebarGestures: true,\n  sidebarGestureMapping: 'swipe-inward',\n  sidebarGestureEdge: 'avoid',\n  sidebarGestureDistancePercent: DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT,\n}\n\n/** 手势设置的归一化输入；保留旧版本写入的像素门槛用于一次性迁移。 */\nexport type SidebarGestureSettingsInput = Partial<SidebarGestureSettings> & {\n  /** 已废弃的像素门槛；只用于推导比例，不再被写回。 */\n  sidebarGestureThresholdPx?: number\n}\n\n/** 归一化手势设置：缺省回填、越界收敛，非法枚举回落到默认值。 */\nexport function normalizeSidebarGestureSettings(\n  value: SidebarGestureSettingsInput | undefined,\n): SidebarGestureSettings {\n  const record = typeof value === 'object' && value !== null ? value as Record<string, unknown> : {}\n  const percent = record.sidebarGestureDistancePercent === undefined\n    ? legacyThresholdPxToPercent(record.sidebarGestureThresholdPx)\n    : record.sidebarGestureDistancePercent\n  return {\n    // 移动端访问增强默认提供横滑入口；桌面端控制器仍会按触摸能力和视口门禁不挂监听。\n    sidebarGestures: record.sidebarGestures === undefined\n      ? DEFAULT_SIDEBAR_GESTURE_SETTINGS.sidebarGestures\n      : record.sidebarGestures === true,\n    sidebarGestureMapping: record.sidebarGestureMapping === 'swap' ? 'swap' : 'swipe-inward',\n    sidebarGestureEdge: record.sidebarGestureEdge === 'edge' ? 'edge' : 'avoid',\n    sidebarGestureDistancePercent: clampSettingsInteger(\n      percent,\n      SIDEBAR_GESTURE_DISTANCE_PERCENT_LIMITS,\n      DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT,\n    ),\n  }\n}\n\n/**\n * 把已废弃的像素门槛换算成视口百分比。\n *\n * 换算结果不低于当前默认值：旧像素值在绝大多数移动视口上本来就低于\n * `视口宽度 × 40%`，属于「从未生效」的设置，用户实际上一直在用默认手感。\n * 让它们落到新默认值，才能获得本次灵敏度修复；只有确实高于下限的旧值\n * 才保留其「更严格」的意图。\n */\nfunction legacyThresholdPxToPercent(value: unknown): number | undefined {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) return undefined\n  const percent = Math.round(value / SIDEBAR_GESTURE_LEGACY_THRESHOLD_PX_REFERENCE_WIDTH * 100)\n  return Math.max(DEFAULT_SIDEBAR_GESTURE_DISTANCE_PERCENT, percent)\n}\n\n/** 文件管理增强的独立能力开关。 */\nexport interface FileManagementSettings {\n  /** 是否为文件和目录显示右键操作菜单。 */\n  menuEnhancement: boolean\n  /** 是否为可编辑文本文件显示编辑器入口。 */\n  fileEditor: boolean\n  /** 是否在当前会话顶部显示“修改文件”视图。 */\n  sessionChangedFiles: boolean\n}\n\nexport const DEFAULT_FILE_MANAGEMENT_SETTINGS: FileManagementSettings = {\n  menuEnhancement: true,\n  fileEditor: true,\n  sessionChangedFiles: true,\n}\n\n/** 移动端访问增强的独立能力开关；全部只作用于浏览器侧界面。 */\nexport interface MobileAccessSettings {\n  /** 窄屏下彻底隐藏左侧边栏，只在原位置保留品牌 logo 作为唤起入口。 */\n  hideSidebarOnMobile: boolean\n  /** 是否启用移动端设置界面布局优化。 */\n  optimizeSettingsOnMobile: boolean\n  /** 判定“移动端/窄屏”的视口宽度上限（像素）。 */\n  mobileViewportMaxPx: number\n  /** 移动端触摸设备上是否启用横滑开合左右侧栏。 */\n  sidebarGestures: boolean\n  /** 手势方向映射：右滑/左滑分别对应哪一侧栏。 */\n  sidebarGestureMapping: SidebarGestureMapping\n  /** 手势起手区域：是否允许贴上系统边缘热区。 */\n  sidebarGestureEdge: SidebarGestureEdgeMode\n  /** 触发手势所需的水平位移占视口宽度的百分比（15–80，默认 25）。 */\n  sidebarGestureDistancePercent: number\n}\n\nexport const MOBILE_VIEWPORT_MAX_PX_LIMITS = { min: 480, max: 1280 } as const\nexport const DEFAULT_MOBILE_VIEWPORT_MAX_PX = 1024\n\nexport const DEFAULT_MOBILE_ACCESS_SETTINGS: MobileAccessSettings = {\n  // 窄屏下 DSH 原生侧栏默认只收起成 56px 图标轨道，仍持续占用横向空间；\n  // 默认开启本模块的隐藏能力，用户可随时在设置里关回原生行为。\n  hideSidebarOnMobile: true,\n  optimizeSettingsOnMobile: true,\n  mobileViewportMaxPx: DEFAULT_MOBILE_VIEWPORT_MAX_PX,\n  ...DEFAULT_SIDEBAR_GESTURE_SETTINGS,\n}\n\n/**\n * 归一化移动端访问设置：缺省回填默认值，越界值收敛到允许范围。\n * 第二个参数只用于读取旧版本写在 workspaceSessionEnhancement 下的手势设置。\n */\nexport function normalizeMobileAccessSettings(value: unknown, legacyGestureValue?: unknown): MobileAccessSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  const legacy = typeof legacyGestureValue === 'object' && legacyGestureValue !== null && !Array.isArray(legacyGestureValue)\n    ? legacyGestureValue as Record<string, unknown>\n    : {}\n  const gestureValue = (key: string): unknown => record[key] ?? legacy[key]\n  const gesture: SidebarGestureSettingsInput = {}\n  const sidebarGestures = gestureValue('sidebarGestures')\n  const sidebarGestureMapping = gestureValue('sidebarGestureMapping')\n  const sidebarGestureEdge = gestureValue('sidebarGestureEdge')\n  const sidebarGestureDistancePercent = gestureValue('sidebarGestureDistancePercent')\n  const sidebarGestureThresholdPx = gestureValue('sidebarGestureThresholdPx')\n  if (sidebarGestures !== undefined) gesture.sidebarGestures = sidebarGestures as boolean\n  if (sidebarGestureMapping !== undefined) gesture.sidebarGestureMapping = sidebarGestureMapping as SidebarGestureMapping\n  if (sidebarGestureEdge !== undefined) gesture.sidebarGestureEdge = sidebarGestureEdge as SidebarGestureEdgeMode\n  if (sidebarGestureDistancePercent !== undefined) gesture.sidebarGestureDistancePercent = sidebarGestureDistancePercent as number\n  // 旧像素门槛只在没有新比例值时参与换算，避免把已经迁移过的配置再次改写。\n  if (sidebarGestureDistancePercent === undefined && sidebarGestureThresholdPx !== undefined) {\n    gesture.sidebarGestureThresholdPx = sidebarGestureThresholdPx as number\n  }\n  return {\n    hideSidebarOnMobile: record.hideSidebarOnMobile === undefined\n      ? DEFAULT_MOBILE_ACCESS_SETTINGS.hideSidebarOnMobile\n      : record.hideSidebarOnMobile === true,\n    optimizeSettingsOnMobile: record.optimizeSettingsOnMobile === undefined\n      ? DEFAULT_MOBILE_ACCESS_SETTINGS.optimizeSettingsOnMobile\n      : record.optimizeSettingsOnMobile === true,\n    mobileViewportMaxPx: clampSettingsInteger(\n      record.mobileViewportMaxPx,\n      MOBILE_VIEWPORT_MAX_PX_LIMITS,\n      DEFAULT_MOBILE_ACCESS_SETTINGS.mobileViewportMaxPx,\n    ),\n    ...normalizeSidebarGestureSettings(gesture),\n  }\n}\n\n/** 可复用的快捷会话文本。 */\nexport interface QuickPhrase {\n  id: string\n  text: string\n}\n\n/** 首次启用快捷会话时提供的内置指令。 */\nexport const DEFAULT_QUICK_PHRASES: QuickPhrase[] = [\n  { id: 'builtin-quick-1', text: '请将本次会话变更的所有代码提交到git暂存区，然后总结一条中文的提交信息' },\n  { id: 'builtin-quick-2', text: '分析本项目模块的代码实现，并分析存在的问题' },\n  { id: 'builtin-quick-3', text: '分析当前项目中的未提交文件，按照功能模块进行分类提交，提交信息格式请参考我最近的提交记录' },\n  { id: 'builtin-quick-4', text: '请给出完整的开发提示词，我将在新的页面中继续开发' },\n]\n\n/** 局域网访问 DSH 的持久化配置；dshPort 为 0 表示启动时自动探测，大于 0 时启动前仍会探测，端口已变化则回写新值。 */\nexport interface LanAccessDshSettings {\n  autoStart: boolean\n  listenHost: string\n  listenPort: number\n  dshPort: number\n  /** PWA 资产与安装引导；只在局域网入口生效，不影响本机与中继入口。 */\n  pwa: LanAccessDshPwaSettings\n}\n\n/** 局域网入口的 PWA 增强档位。 */\nexport interface LanAccessDshPwaSettings {\n  /** 是否由代理提供 manifest、图标等静态资产与启动页元数据。 */\n  enabled: boolean\n  /** 是否合成 `/sw.js` 并在安全上下文里注册；默认关闭，避免驻留。 */\n  serviceWorker: boolean\n  /** 是否注入安装引导（Android 提示按钮 / iOS 指引）。 */\n  installPrompt: boolean\n  /** 通知档位；`push` 需要 Host 侧 VAPID 就绪。 */\n  notifications: LanAccessDshNotificationMode\n}\n\nexport type LanAccessDshNotificationMode = 'off' | 'local' | 'push'\n\nexport const DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS: LanAccessDshPwaSettings = {\n  enabled: true,\n  serviceWorker: false,\n  installPrompt: true,\n  notifications: 'off',\n}\n\n/** 归一化 PWA 设置：缺省回填默认值，非法枚举回落到最保守档位。 */\nexport function normalizeLanAccessDshPwaSettings(value: unknown): LanAccessDshPwaSettings {\n  const record = typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  return {\n    enabled: record.enabled === undefined ? DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS.enabled : record.enabled === true,\n    serviceWorker: record.serviceWorker === true,\n    installPrompt: record.installPrompt === undefined ? DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS.installPrompt : record.installPrompt === true,\n    notifications: record.notifications === 'local' || record.notifications === 'push' ? record.notifications : 'off',\n  }\n}\n\nexport interface LoginProtectionScopes {\n  /** 局域网网卡入口。 */\n  lan: boolean\n  /** Codingns4DSH 中继入口。 */\n  relay: boolean\n}\n\n/** 登录保护的公开设置；密码哈希仅保存在 Host 私有凭据文件中。 */\nexport interface LanAccessDshLoginSettings {\n  enabled: boolean\n  username: string\n  passwordConfigured: boolean\n  timeoutSeconds: number\n  scopes: LoginProtectionScopes\n}\n\nexport const CODINGNS_SETTINGS_NAMESPACE = 'codingns'\n/** DSH 配置表单可能使用的插件 entry id；scoped 包名是当前 Bundle 的正式 ID。 */\nexport const CODINGNS_SETTINGS_ENTRY_IDS = [\n  '@jingyi0605/codingns4dsh',\n  'codingns4dsh',\n  CODINGNS_SETTINGS_NAMESPACE,\n] as const\n\nexport function isCodingNsSettingsEntryId(value: unknown): value is typeof CODINGNS_SETTINGS_ENTRY_IDS[number] {\n  return typeof value === 'string' && (CODINGNS_SETTINGS_ENTRY_IDS as readonly string[]).includes(value)\n}\n\nexport const CODINGNS_CONTROL_BASE_URL_FIELD = 'controlBaseUrl'\nexport const CODINGNS_CONTROL_BASE_URLS_FIELD = 'controlBaseUrls'\nexport const CODINGNS_MODULES_FIELD = 'modules'\nexport const CODINGNS_LAN_ACCESS_DSH_FIELD = 'lanAccessDsh'\nexport const CODINGNS_TERMINAL_ENHANCEMENT_FIELD = 'terminalEnhancement'\nexport const CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD = 'workspaceSessionEnhancement'\nexport const CODINGNS_FILE_MANAGEMENT_FIELD = 'fileManagement'\nexport const CODINGNS_MOBILE_ACCESS_FIELD = 'mobileAccess'\nexport const CODINGNS_SUBSCRIPTION_USAGE_FIELD = 'subscriptionUsage'\nexport const CODINGNS_SUBSCRIPTION_REPORTS_FIELD = 'subscriptionReports'\nexport const CODINGNS_SESSION_TRANSLATION_FIELD = 'sessionTranslation'\nexport const CODINGNS_GIT_MANAGEMENT_FIELD = 'gitManagement'\nexport const CODINGNS_ASSISTANT_FIELD = 'assistant'\nexport const CODINGNS_SUBAGENT_BRIDGE_FIELD = 'subagentBridge'\nexport const DEFAULT_CODINGNS_CONTROL_BASE_URL = 'https://channel.codingns.com:1443'\nexport const DEFAULT_CODINGNS_CONTROL_BASE_URLS = [DEFAULT_CODINGNS_CONTROL_BASE_URL]\n/** 控制站的网页登录地址，用于注册 Codingns4DSH 账号。 */\nexport const CODINGNS_CONTROL_STATION_URL = 'https://channel.codingns.com:1443'\n/** 独立 H5 登录页面地址；登录控制站后可从设置页复制给其他设备。 */\nexport const CODINGNS_H5_LOGIN_URL = 'https://dsh.codingns.com'\nexport const DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS: TerminalEnhancementSettings = {\n  bindingScope: 'workspace',\n  defaultProfile: 'system',\n  appearance: {\n    theme: 'inherit',\n    background: null,\n    foreground: null,\n    cursorColor: null,\n    fontFamily: null,\n    fontSize: null,\n    lineHeight: null,\n    cursorStyle: null,\n    cursorBlink: null,\n    scrollback: null,\n  },\n}\nexport const DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS: WorkspaceSessionEnhancementSettings = {\n  showAdapterLogo: true,\n  showArchivedSessions: true,\n  showWorkspaceHiding: true,\n  hiddenWorkspaceIds: [],\n  showSubscriptionUsage: true,\n  showQuickPhrases: true,\n  showSkillQuickReference: true,\n  optimizeSessionTitles: false,\n  rememberConversationRightbarRatio: false,\n  quickPhrases: DEFAULT_QUICK_PHRASES.map((phrase) => ({ ...phrase })),\n  quickPhrasesSeeded: true,\n}\nexport const DEFAULT_CODINGNS_SETTINGS: CodingNsSettings = {\n  controlBaseUrl: DEFAULT_CODINGNS_CONTROL_BASE_URL,\n  controlBaseUrls: [...DEFAULT_CODINGNS_CONTROL_BASE_URLS],\n  modules: {},\n  agentAdapters: {},\n  agentAdapterPreferences: {},\n  subagentBridge: DEFAULT_SUBAGENT_BRIDGE_SETTINGS,\n  sessionTranslation: DEFAULT_SESSION_TRANSLATION_SETTINGS,\n  sessionHandleEviction: DEFAULT_SESSION_HANDLE_EVICTION_SETTINGS,\n  gitManagement: DEFAULT_GIT_MANAGEMENT_SETTINGS,\n  terminalEnhancement: DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS,\n  workspaceSessionEnhancement: DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS,\n  fileManagement: DEFAULT_FILE_MANAGEMENT_SETTINGS,\n  mobileAccess: DEFAULT_MOBILE_ACCESS_SETTINGS,\n  subscriptionUsage: DEFAULT_SUBSCRIPTION_USAGE_SETTINGS,\n  subscriptionReports: DEFAULT_SUBSCRIPTION_REPORT_SETTINGS,\n  assistant: DEFAULT_ASSISTANT_SETTINGS,\n  lanAccessDsh: {\n    autoStart: false,\n    listenHost: '0.0.0.0',\n    listenPort: 13080,\n    dshPort: 0,\n    pwa: DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS,\n  },\n}\n\n/** 重启生效模块在当前进程启动时捕获的有效状态。 */\nexport type RestartFeatureStates = Readonly<Record<string, boolean>>\n\nexport function captureRestartFeatureStates(\n  descriptors: readonly FeatureDescriptor[],\n  settings: CodingNsSettings | undefined,\n  dshVersion?: string,\n): Record<string, boolean> {\n  const states: Record<string, boolean> = {}\n  for (const descriptor of descriptors) {\n    if (descriptor.activation === 'restart') {\n      states[descriptor.name] = isFeatureDshVersionCompatible(descriptor, dshVersion)\n        && isFeatureEnabled(descriptor, settings)\n    }\n  }\n  return states\n}\n\n/**\n * 判定一个功能模块当前是否应当启用。\n *\n * 常驻模块（ui.alwaysEnabled）始终启用；其余模块读取设置里的用户意图，\n * 用户没有表达过意图时使用模块自己声明的 enabledByDefault。\n */\nexport function isFeatureEnabled(\n  descriptor: FeatureDescriptor,\n  settings: CodingNsSettings | undefined,\n): boolean {\n  if (descriptor.disabled === true) return false\n  if (descriptor.ui?.alwaysEnabled === true) return true\n  return settings?.modules[descriptor.name] ?? descriptor.enabledByDefault\n}\n\n/** 汇总当前应当启用的模块名，交给 FeatureRegistry.reconcile 对齐状态。 */\nexport function enabledFeatureNames(\n  descriptors: readonly FeatureDescriptor[],\n  settings: CodingNsSettings | undefined,\n  restartStates?: RestartFeatureStates,\n  dshVersion?: string,\n): string[] {\n  const names: string[] = []\n  for (const descriptor of descriptors) {\n    const enabled = descriptor.activation === 'restart' && restartStates !== undefined\n      ? restartStates[descriptor.name] ?? descriptor.enabledByDefault\n      : isFeatureEnabled(descriptor, settings)\n    if (enabled && isFeatureDshVersionCompatible(descriptor, dshVersion)) names.push(descriptor.name)\n  }\n  return names\n}\n\n/** 判断模块是否可以在当前 DSH 版本运行。未提供运行时版本时保留旧调用方行为。 */\nexport function isFeatureDshVersionCompatible(\n  descriptor: FeatureDescriptor,\n  dshVersion?: string,\n): boolean {\n  if (descriptor.minimumDshVersion === undefined || dshVersion === undefined) return true\n  return isDshVersionAtLeast(dshVersion, descriptor.minimumDshVersion)\n}\n","import type { Context } from '@deepseek-ai/cordis'\n\n/** DSH 原生 Workspace 列表 Store；消费方只用到这两条读取通道。 */\nexport interface NativeWorkspaceListStore {\n  getSnapshot: () => unknown\n  subscribe: (listener: () => void) => () => void\n}\n\n/** 原生 Workspace 列表项的最小结构；PeerHost 虚拟工作区也由这份读取提供。 */\nexport interface NativeWorkspaceRecord {\n  readonly workspaceId: string\n  readonly path?: string\n  /** 用于界面展示的真实工作区路径；远程工作区的 `path` 保留为虚拟路由路径。 */\n  readonly workspacePath?: string\n  readonly title: string\n  /** 远程工作区所属的目标 Host；本机工作区没有该字段。 */\n  readonly hostId?: string\n  /** 远程工作区所属 Host 的友好名称；缺失时由界面回退到 hostId。 */\n  readonly hostLabel?: string\n  /** 远程工作区所属 Host 的配置颜色；非法值由显示层回退到稳定推导色。 */\n  readonly hostColor?: string\n  readonly sessionIds: readonly string[]\n}\n\n/** `workspaces.list` 快照的最小结构；归档集合是 Registry 级共享的一份列表。 */\nexport interface NativeWorkspaceSnapshot {\n  readonly items: readonly NativeWorkspaceRecord[]\n  readonly archivedSessionIds: readonly string[]\n}\n\n/**\n * 读取原生 Workspace 列表 Store 对象本身。\n *\n * PeerHost 顺序投影必须就地改写这个对象的方法，归档入口只读它的快照。\n */\nexport function readNativeWorkspaceListStore(uiContext: Context | undefined): NativeWorkspaceListStore | undefined {\n  const store = readNativeService(uiContext, 'workspaces', 'list')\n  if (!isRecord(store) || typeof store.getSnapshot !== 'function' || typeof store.subscribe !== 'function') return undefined\n  return store as unknown as NativeWorkspaceListStore\n}\n\n/** 读取原生 Workspace 快照；形状不符或服务缺失时返回 undefined，调用方退回原生 Remote。 */\nexport function readNativeWorkspaceSnapshot(uiContext: Context | undefined): NativeWorkspaceSnapshot | undefined {\n  const store = readNativeWorkspaceListStore(uiContext)\n  const snapshot = store?.getSnapshot()\n  const record = isRecord(snapshot) ? snapshot : undefined\n  if (record === undefined || !Array.isArray(record.items)) return undefined\n  return {\n    items: record.items.flatMap((item) => {\n      const value = isRecord(item) ? item : undefined\n      const workspaceId = readText(value?.workspaceId)\n      if (workspaceId === undefined) return []\n      const path = readText(value?.path)\n      const workspacePath = readText(value?.workspacePath)\n      const title = readText(value?.title) ?? workspacePath ?? path ?? workspaceId\n      const hostId = readText(value?.hostId)\n      const hostLabel = readText(value?.hostLabel)\n      const hostColor = readText(value?.hostColor)\n      return [{\n        workspaceId,\n        ...(path === undefined ? {} : { path }),\n        ...(workspacePath === undefined ? {} : { workspacePath }),\n        title,\n        ...(hostId === undefined ? {} : { hostId }),\n        ...(hostLabel === undefined ? {} : { hostLabel }),\n        ...(hostColor === undefined ? {} : { hostColor }),\n        sessionIds: readTextList(value?.sessionIds),\n      }]\n    }),\n    archivedSessionIds: readTextList(record.archivedSessionIds),\n  }\n}\n\n/** 只在会话所属工作区变化时通知，避免标题/运行态增量触发昂贵的文件与 Git 查询。 */\nexport function subscribeNativeSessionWorkspace(\n  uiContext: Context | undefined,\n  sessionId: string,\n  listener: () => void,\n): () => void {\n  const readWorkspaceId = (): string | undefined => readNativeWorkspaceSnapshot(uiContext)?.items\n    .find((item) => item.sessionIds.includes(sessionId))?.workspaceId\n  let workspaceId = readWorkspaceId()\n  return readNativeWorkspaceListStore(uiContext)?.subscribe(() => {\n    const next = readWorkspaceId()\n    if (next === workspaceId) return\n    workspaceId = next\n    listener()\n  }) ?? (() => undefined)\n}\n\n/** 读取 DSH 原生服务集合中的字段；非 Web 宿主或版本差异时保持缺失。 */\nexport function readNativeService(uiContext: Context | undefined, name: string, field?: string): unknown {\n  if (uiContext === undefined) return undefined\n  try {\n    const getter = (uiContext as { get?: (service: string) => unknown }).get\n    if (typeof getter !== 'function') return undefined\n    const service = getter.call(uiContext, name)\n    if (field === undefined) return service\n    return isRecord(service) ? service[field] : undefined\n  } catch {\n    // 原生服务不可用（非 Web Client 宿主或版本差异）时保持本机行为。\n    return undefined\n  }\n}\n\nfunction readText(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined\n}\n\nfunction readTextList(value: unknown): string[] {\n  return Array.isArray(value) ? value.flatMap((item) => { const text = readText(item); return text === undefined ? [] : [text] }) : []\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"mappings":"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"}

package/data/build/dist/client/client.session-translation.js

@@ -116,6 +116,25 @@ window.__ModuleLoader__.load({
 				model
 			};
 		}
+		/** Retain known diagnostics without copying raw provider errors into history or UI. */
+		function readSessionTranslationDiagnostics(value) {
+			const failure = asRecord(asRecord(value)?.failure);
+			if (typeof failure?.retryable !== "boolean") return {};
+			switch (failure.code) {
+				case "timeout":
+				case "cancelled":
+				case "rate-limit":
+				case "network":
+				case "unavailable":
+				case "invalid-response":
+				case "configuration":
+				case "provider": return { failure: {
+					code: failure.code,
+					retryable: failure.retryable
+				} };
+				default: return {};
+			}
+		}
 		/** Preserve available metrics while accepting records saved before metrics existed. */
 		function readSessionTranslationMetrics(value) {
 			const record = asRecord(value);
@@ -148,6 +167,12 @@ window.__ModuleLoader__.load({
 				return normalizeSessionTranslationSettings;
 			}
 		});
+		Object.defineProperty(exports, "readSessionTranslationDiagnostics", {
+			enumerable: true,
+			get: function() {
+				return readSessionTranslationDiagnostics;
+			}
+		});
 		Object.defineProperty(exports, "readSessionTranslationMetrics", {
 			enumerable: true,
 			get: function() {

package/data/build/dist/client/client.session-translation.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.session-translation.js","names":[],"sources":["../../../../src/shared/contracts/session-translation.ts"],"sourcesContent":["/** 会话翻译中间件支持的语言。 */\nexport type SessionTranslationLanguage = 'en' | 'fr' | 'de' | 'ja' | 'zh'\n\n/** 输出内容类别；工具调用、命令和路径不属于可翻译内容。 */\nexport type SessionTranslationOutputKind = 'reasoning' | 'assistant'\n\n/** 翻译请求使用的 DSH 原生模型；不保存密钥，只保存 provider/model 标识。 */\nexport interface SessionTranslationModel {\n  readonly provider: string\n  readonly model: string\n}\n\n/** Message categories saved independently for each agent adapter. */\nexport interface SessionTranslationOptions {\n  readonly inputEnabled?: boolean\n  readonly reasoningEnabled?: boolean\n  readonly assistantEnabled?: boolean\n}\n\n/** Persisted translation settings; top-level message options remain legacy defaults. */\nexport interface SessionTranslationSettings extends SessionTranslationOptions {\n  readonly adapterOptions?: Readonly<Record<string, SessionTranslationOptions>>\n  /** 用户输入送入 Agent 的目的语言。 */\n  readonly inputLanguage: SessionTranslationLanguage\n  /** 输出翻译语言；默认中文。 */\n  readonly outputLanguage: SessionTranslationLanguage\n  /** 是否在 UI 和历史回看中同时保留原文与译文。 */\n  readonly bilingual: boolean\n  /** 翻译模型；缺省时跟随 DSH 当前默认模型。 */\n  readonly translationModel?: SessionTranslationModel\n  /** Models in priority order. An empty pool follows the DSH default; absent pools use the legacy selection. */\n  readonly translationModels?: readonly SessionTranslationModel[]\n  /** Custom prompt instructions that take precedence over the default translation prompts. */\n  readonly translationRules?: readonly string[]\n  /**\n   * DSH 原生会话是否参与翻译；缺省关闭。\n   *\n   * 原生会话的回复由 DSH 自己写入 `assistant/message`，开启输出翻译后正文会变成\n   * 译文、原文只留在块元数据里，因此不能默认改变既有行为。\n   */\n  readonly nativeEnabled?: boolean\n}\n\nexport const SESSION_TRANSLATION_ADAPTER_IDS = [\n  'command-code', 'claude-code', 'kimi', 'gemini', 'pi', 'codex', 'opencode', 'grok',\n  'mcode', 'zcode', 'codebuddy', 'workbuddy', 'cursor-cli', 'kiro-cli', 'qoder', 'qoder-cn',\n  'antigravity', 'doubao',\n] as const\n\n/** DSH 内置 Agent 的适配器标识；它没有外部驱动，但同样支持会话翻译。 */\nexport const DSH_NATIVE_SESSION_ADAPTER_ID = 'dsh' as const\n\nexport const SESSION_TRANSLATION_LANGUAGES = ['en', 'fr', 'de', 'ja', 'zh'] as const\n\nexport const DEFAULT_SESSION_TRANSLATION_SETTINGS: SessionTranslationSettings = {\n  inputEnabled: true,\n  reasoningEnabled: true,\n  assistantEnabled: true,\n  inputLanguage: 'en',\n  outputLanguage: 'zh',\n  bilingual: false,\n  nativeEnabled: false,\n}\n\n/**\n * 外部 Agent 适配器判定。\n *\n * 只表示「会话由插件的外部 CLI 驱动接管」，因此 DSH 原生 Agent 不在其中：该判定\n * 还被用来把外部 Agent 的虚拟 Provider 排除在翻译模型目录之外，混入 `dsh` 会污染\n * 这一语义。会话是否可翻译统一使用 {@link supportsSessionTranslation}。\n */\nexport function isSessionTranslationAdapter(adapterId: string): boolean {\n  return (SESSION_TRANSLATION_ADAPTER_IDS as readonly string[]).includes(adapterId)\n}\n\n/** 外部 Agent 与 DSH 原生 Agent 都支持会话翻译。 */\nexport function supportsSessionTranslation(adapterId: string): boolean {\n  return adapterId === DSH_NATIVE_SESSION_ADAPTER_ID || isSessionTranslationAdapter(adapterId)\n}\n\n/** Preserve existing choices until an adapter overrides them. Missing legacy values default on. */\nexport function resolveSessionTranslationOptions(settings: SessionTranslationSettings | undefined, adapterId: string): Required<SessionTranslationOptions> {\n  const options = settings?.adapterOptions?.[adapterId]\n  return {\n    inputEnabled: (options?.inputEnabled ?? settings?.inputEnabled) !== false,\n    reasoningEnabled: (options?.reasoningEnabled ?? settings?.reasoningEnabled) !== false,\n    assistantEnabled: (options?.assistantEnabled ?? settings?.assistantEnabled) !== false,\n  }\n}\n\n/** 判断任意字符串是否为受支持的翻译语言。 */\nexport function isSessionTranslationLanguage(value: unknown): value is SessionTranslationLanguage {\n  return typeof value === 'string' && (SESSION_TRANSLATION_LANGUAGES as readonly string[]).includes(value)\n}\n\n/**\n * 归一化翻译设置：旧设置快照可能缺少 `nativeEnabled`，非法语言回落到默认值。\n *\n * 与 `session-translation-service.ts` 的内部归一化保持同一语义，供客户端设置页在\n * 写入前补齐字段，避免旧快照把新字段写丢。\n */\nexport function normalizeSessionTranslationSettings(value: SessionTranslationSettings | undefined): SessionTranslationSettings {\n  const fallback = DEFAULT_SESSION_TRANSLATION_SETTINGS\n  if (value === undefined) return fallback\n  const translationModel = normalizeTranslationModel(value.translationModel)\n  const translationModels = Array.isArray(value.translationModels) ? normalizeTranslationModels(value.translationModels) : undefined\n  const translationRules = Array.isArray(value.translationRules)\n    ? value.translationRules.filter((rule): rule is string => typeof rule === 'string').map((rule) => rule.trim()).filter((rule) => rule !== '')\n    : undefined\n  return {\n    inputEnabled: value.inputEnabled !== false,\n    reasoningEnabled: value.reasoningEnabled !== false,\n    assistantEnabled: value.assistantEnabled !== false,\n    inputLanguage: isSessionTranslationLanguage(value.inputLanguage) ? value.inputLanguage : fallback.inputLanguage,\n    outputLanguage: isSessionTranslationLanguage(value.outputLanguage) ? value.outputLanguage : fallback.outputLanguage,\n    bilingual: value.bilingual === true,\n    nativeEnabled: value.nativeEnabled === true,\n    ...(value.adapterOptions === undefined ? {} : {\n      adapterOptions: Object.fromEntries(Object.entries(value.adapterOptions)\n        .filter(([adapterId]) => supportsSessionTranslation(adapterId))\n        .map(([adapterId]) => [adapterId, resolveSessionTranslationOptions(value, adapterId)])),\n    }),\n    ...(translationModel === undefined ? {} : { translationModel }),\n    ...(translationModels === undefined ? {} : { translationModels }),\n    ...(translationRules === undefined ? {} : { translationRules }),\n  }\n}\n\nfunction normalizeTranslationModels(values: readonly SessionTranslationModel[]): readonly SessionTranslationModel[] {\n  const models: SessionTranslationModel[] = []\n  const seen = new Set<string>()\n  for (const value of values) {\n    const model = normalizeTranslationModel(value)\n    if (model === undefined) continue\n    const key = JSON.stringify([model.provider, model.model])\n    if (seen.has(key)) continue\n    seen.add(key)\n    models.push(model)\n  }\n  return models\n}\n\nfunction normalizeTranslationModel(value: SessionTranslationModel | undefined): SessionTranslationModel | undefined {\n  if (value === undefined || value === null || typeof value.provider !== 'string' || typeof value.model !== 'string') return undefined\n  const provider = value.provider.trim()\n  const model = value.model.trim()\n  return provider === '' || model === '' ? undefined : { provider, model }\n}\n\nexport interface SessionTranslationFailure {\n  readonly code: 'timeout' | 'cancelled' | 'rate-limit' | 'network' | 'unavailable' | 'invalid-response' | 'configuration' | 'provider'\n  readonly retryable: boolean\n}\n\nexport interface SessionTranslationMetrics {\n  /** Elapsed translation time, including model selection and fallback attempts. */\n  readonly durationMs?: number\n  /** Reported token consumption across model attempts, including cached input. */\n  readonly totalTokens?: number\n}\n\n/** Preserve available metrics while accepting records saved before metrics existed. */\nexport function readSessionTranslationMetrics(value: unknown): SessionTranslationMetrics {\n  const record = asRecord(value)\n  const durationMs = record?.durationMs\n  const totalTokens = record?.totalTokens\n  return {\n    ...(typeof durationMs === 'number' && Number.isFinite(durationMs) && durationMs >= 0 ? { durationMs } : {}),\n    ...(typeof totalTokens === 'number' && Number.isSafeInteger(totalTokens) && totalTokens >= 0 ? { totalTokens } : {}),\n  }\n}\n\nexport interface SessionTranslationRecord extends SessionTranslationMetrics {\n  readonly original: string\n  readonly translated: string\n  readonly sourceLanguage?: SessionTranslationLanguage\n  readonly targetLanguage: SessionTranslationLanguage\n  /** 回复文本所在的 DSH 内容块类型，供界面将原文入口放回对应内容块。 */\n  readonly outputKind?: SessionTranslationOutputKind\n  readonly bilingual: boolean\n  /** 源语言与目标语言一致，因此未调用翻译模型。 */\n  readonly alreadyTargetLanguage?: boolean\n  /** 实际执行本次翻译的 DSH 原生模型；旧历史可能没有该字段。 */\n  readonly model?: SessionTranslationModel\n  /** 本次尝试失败并回退原文；前端显示警告状态。 */\n  readonly failed?: boolean\n  /** Structured failure details; absent in older translation records. */\n  readonly failure?: SessionTranslationFailure\n}\n\nexport type SessionTranslationRecoveryChoice = 'retry' | 'send' | 'cancel'\n\n/** A failed submission remains on the host until the user makes a choice. */\nexport interface SessionTranslationPendingInput {\n  readonly id: string\n  readonly sessionId: string\n  readonly record: SessionTranslationRecord\n}\n\n/** 用户输入的原文、实际送出的译文和翻译模型，作为 DSH 历史元数据保存。 */\nexport interface SessionTranslationInputRecord extends SessionTranslationMetrics {\n  readonly original: string\n  /** 包含附件提示等不翻译内容的最终 Provider prompt。 */\n  readonly translated: string\n  readonly sourceLanguage?: SessionTranslationLanguage\n  readonly targetLanguage: SessionTranslationLanguage\n  /** 源语言与目标语言一致，因此未调用翻译模型。 */\n  readonly alreadyTargetLanguage?: boolean\n  /** 实际执行本次翻译的 DSH 原生模型；旧历史可能没有该字段。 */\n  readonly model?: SessionTranslationModel\n  /** 翻译失败并回退原文；前端显示警告状态。 */\n  readonly failed?: boolean\n}\n\n/**\n * 从 DSH 原生用户消息的 source 元数据读取输入翻译记录。\n *\n * 该字段由 `agent/pre-step` 写入并随 `user/message` 持久化；未知或不完整的历史\n * 结构一律返回 undefined，调用方按「没有翻译」处理。\n */\nexport function readNativeTranslationRecord(source: unknown): SessionTranslationInputRecord | undefined {\n  const record = asRecord(source)\n  const candidate = asRecord(record?.codingnsTranslationInput)\n  if (candidate === null) return undefined\n  if (typeof candidate.original !== 'string' || typeof candidate.translated !== 'string') return undefined\n  if (candidate.original.trim() === '' || candidate.translated.trim() === '') return undefined\n  const targetLanguage = isSessionTranslationLanguage(candidate.targetLanguage) ? candidate.targetLanguage : undefined\n  if (targetLanguage === undefined) return undefined\n  const model = normalizeTranslationModel(asRecord(candidate.model) as SessionTranslationModel | undefined)\n  const sourceLanguage = isSessionTranslationLanguage(candidate.sourceLanguage) ? candidate.sourceLanguage : undefined\n  return {\n    original: candidate.original,\n    translated: candidate.translated,\n    targetLanguage,\n    ...(sourceLanguage === undefined ? {} : { sourceLanguage }),\n    ...(candidate.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),\n    ...(candidate.failed === true ? { failed: true } : {}),\n    ...(model === undefined ? {} : { model }),\n    ...readSessionTranslationMetrics(candidate),\n  }\n}\n\n/** 输入记录转换为详情弹层使用的通用记录；`outputKind` 缺省表示输入方向。 */\nexport function toSessionTranslationRecord(\n  record: SessionTranslationInputRecord,\n  options: { readonly outputKind?: SessionTranslationOutputKind; readonly bilingual?: boolean } = {},\n): SessionTranslationRecord {\n  return {\n    original: record.original,\n    translated: record.translated,\n    targetLanguage: record.targetLanguage,\n    bilingual: options.bilingual === true,\n    ...(options.outputKind === undefined ? {} : { outputKind: options.outputKind }),\n    ...(record.sourceLanguage === undefined ? {} : { sourceLanguage: record.sourceLanguage }),\n    ...(record.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),\n    ...(record.failed === true ? { failed: true } : {}),\n    ...(record.model === undefined ? {} : { model: record.model }),\n    ...readSessionTranslationMetrics(record),\n  }\n}\n\nfunction asRecord(value: unknown): Record<string, any> | null {\n  return typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, any> : null\n}\n\n/** 外部 Agent 的历史上下文使用实际发送的译文；DSH 用户消息正文保留用户原文。 */\nexport function formatSessionTranslationInput(record: SessionTranslationInputRecord): string {\n  return record.translated\n}\n\n/** Return the output translation; native DSH history keeps the original and the client reads this record. */\nexport function formatSessionTranslationOutput(record: SessionTranslationRecord): string {\n  return record.translated\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.session-translation.js","names":[],"sources":["../../../../src/shared/contracts/session-translation.ts"],"sourcesContent":["/** 会话翻译中间件支持的语言。 */\nexport type SessionTranslationLanguage = 'en' | 'fr' | 'de' | 'ja' | 'zh'\n\n/** 输出内容类别；工具调用、命令和路径不属于可翻译内容。 */\nexport type SessionTranslationOutputKind = 'reasoning' | 'assistant'\n\n/** 翻译请求使用的 DSH 原生模型；不保存密钥，只保存 provider/model 标识。 */\nexport interface SessionTranslationModel {\n  readonly provider: string\n  readonly model: string\n}\n\n/** Message categories saved independently for each agent adapter. */\nexport interface SessionTranslationOptions {\n  readonly inputEnabled?: boolean\n  readonly reasoningEnabled?: boolean\n  readonly assistantEnabled?: boolean\n}\n\n/** Persisted translation settings; top-level message options remain legacy defaults. */\nexport interface SessionTranslationSettings extends SessionTranslationOptions {\n  readonly adapterOptions?: Readonly<Record<string, SessionTranslationOptions>>\n  /** 用户输入送入 Agent 的目的语言。 */\n  readonly inputLanguage: SessionTranslationLanguage\n  /** 输出翻译语言；默认中文。 */\n  readonly outputLanguage: SessionTranslationLanguage\n  /** 是否在 UI 和历史回看中同时保留原文与译文。 */\n  readonly bilingual: boolean\n  /** 翻译模型；缺省时跟随 DSH 当前默认模型。 */\n  readonly translationModel?: SessionTranslationModel\n  /** Models in priority order. An empty pool follows the DSH default; absent pools use the legacy selection. */\n  readonly translationModels?: readonly SessionTranslationModel[]\n  /** Custom prompt instructions that take precedence over the default translation prompts. */\n  readonly translationRules?: readonly string[]\n  /**\n   * DSH 原生会话是否参与翻译；缺省关闭。\n   *\n   * 原生会话的回复由 DSH 自己写入 `assistant/message`，开启输出翻译后正文会变成\n   * 译文、原文只留在块元数据里，因此不能默认改变既有行为。\n   */\n  readonly nativeEnabled?: boolean\n}\n\nexport const SESSION_TRANSLATION_ADAPTER_IDS = [\n  'command-code', 'claude-code', 'kimi', 'gemini', 'pi', 'codex', 'opencode', 'grok',\n  'mcode', 'zcode', 'codebuddy', 'workbuddy', 'cursor-cli', 'kiro-cli', 'qoder', 'qoder-cn',\n  'antigravity', 'doubao',\n] as const\n\n/** DSH 内置 Agent 的适配器标识；它没有外部驱动，但同样支持会话翻译。 */\nexport const DSH_NATIVE_SESSION_ADAPTER_ID = 'dsh' as const\n\nexport const SESSION_TRANSLATION_LANGUAGES = ['en', 'fr', 'de', 'ja', 'zh'] as const\n\nexport const DEFAULT_SESSION_TRANSLATION_SETTINGS: SessionTranslationSettings = {\n  inputEnabled: true,\n  reasoningEnabled: true,\n  assistantEnabled: true,\n  inputLanguage: 'en',\n  outputLanguage: 'zh',\n  bilingual: false,\n  nativeEnabled: false,\n}\n\n/**\n * 外部 Agent 适配器判定。\n *\n * 只表示「会话由插件的外部 CLI 驱动接管」，因此 DSH 原生 Agent 不在其中：该判定\n * 还被用来把外部 Agent 的虚拟 Provider 排除在翻译模型目录之外，混入 `dsh` 会污染\n * 这一语义。会话是否可翻译统一使用 {@link supportsSessionTranslation}。\n */\nexport function isSessionTranslationAdapter(adapterId: string): boolean {\n  return (SESSION_TRANSLATION_ADAPTER_IDS as readonly string[]).includes(adapterId)\n}\n\n/** 外部 Agent 与 DSH 原生 Agent 都支持会话翻译。 */\nexport function supportsSessionTranslation(adapterId: string): boolean {\n  return adapterId === DSH_NATIVE_SESSION_ADAPTER_ID || isSessionTranslationAdapter(adapterId)\n}\n\n/** Preserve existing choices until an adapter overrides them. Missing legacy values default on. */\nexport function resolveSessionTranslationOptions(settings: SessionTranslationSettings | undefined, adapterId: string): Required<SessionTranslationOptions> {\n  const options = settings?.adapterOptions?.[adapterId]\n  return {\n    inputEnabled: (options?.inputEnabled ?? settings?.inputEnabled) !== false,\n    reasoningEnabled: (options?.reasoningEnabled ?? settings?.reasoningEnabled) !== false,\n    assistantEnabled: (options?.assistantEnabled ?? settings?.assistantEnabled) !== false,\n  }\n}\n\n/** 判断任意字符串是否为受支持的翻译语言。 */\nexport function isSessionTranslationLanguage(value: unknown): value is SessionTranslationLanguage {\n  return typeof value === 'string' && (SESSION_TRANSLATION_LANGUAGES as readonly string[]).includes(value)\n}\n\n/**\n * 归一化翻译设置：旧设置快照可能缺少 `nativeEnabled`，非法语言回落到默认值。\n *\n * 与 `session-translation-service.ts` 的内部归一化保持同一语义，供客户端设置页在\n * 写入前补齐字段，避免旧快照把新字段写丢。\n */\nexport function normalizeSessionTranslationSettings(value: SessionTranslationSettings | undefined): SessionTranslationSettings {\n  const fallback = DEFAULT_SESSION_TRANSLATION_SETTINGS\n  if (value === undefined) return fallback\n  const translationModel = normalizeTranslationModel(value.translationModel)\n  const translationModels = Array.isArray(value.translationModels) ? normalizeTranslationModels(value.translationModels) : undefined\n  const translationRules = Array.isArray(value.translationRules)\n    ? value.translationRules.filter((rule): rule is string => typeof rule === 'string').map((rule) => rule.trim()).filter((rule) => rule !== '')\n    : undefined\n  return {\n    inputEnabled: value.inputEnabled !== false,\n    reasoningEnabled: value.reasoningEnabled !== false,\n    assistantEnabled: value.assistantEnabled !== false,\n    inputLanguage: isSessionTranslationLanguage(value.inputLanguage) ? value.inputLanguage : fallback.inputLanguage,\n    outputLanguage: isSessionTranslationLanguage(value.outputLanguage) ? value.outputLanguage : fallback.outputLanguage,\n    bilingual: value.bilingual === true,\n    nativeEnabled: value.nativeEnabled === true,\n    ...(value.adapterOptions === undefined ? {} : {\n      adapterOptions: Object.fromEntries(Object.entries(value.adapterOptions)\n        .filter(([adapterId]) => supportsSessionTranslation(adapterId))\n        .map(([adapterId]) => [adapterId, resolveSessionTranslationOptions(value, adapterId)])),\n    }),\n    ...(translationModel === undefined ? {} : { translationModel }),\n    ...(translationModels === undefined ? {} : { translationModels }),\n    ...(translationRules === undefined ? {} : { translationRules }),\n  }\n}\n\nfunction normalizeTranslationModels(values: readonly SessionTranslationModel[]): readonly SessionTranslationModel[] {\n  const models: SessionTranslationModel[] = []\n  const seen = new Set<string>()\n  for (const value of values) {\n    const model = normalizeTranslationModel(value)\n    if (model === undefined) continue\n    const key = JSON.stringify([model.provider, model.model])\n    if (seen.has(key)) continue\n    seen.add(key)\n    models.push(model)\n  }\n  return models\n}\n\nfunction normalizeTranslationModel(value: SessionTranslationModel | undefined): SessionTranslationModel | undefined {\n  if (value === undefined || value === null || typeof value.provider !== 'string' || typeof value.model !== 'string') return undefined\n  const provider = value.provider.trim()\n  const model = value.model.trim()\n  return provider === '' || model === '' ? undefined : { provider, model }\n}\n\nexport interface SessionTranslationFailure {\n  readonly code: 'timeout' | 'cancelled' | 'rate-limit' | 'network' | 'unavailable' | 'invalid-response' | 'configuration' | 'provider'\n  readonly retryable: boolean\n}\n\n/** Retain known diagnostics without copying raw provider errors into history or UI. */\nexport function readSessionTranslationDiagnostics(value: unknown): Pick<SessionTranslationRecord, 'failure'> {\n  const failure = asRecord(asRecord(value)?.failure)\n  if (typeof failure?.retryable !== 'boolean') return {}\n  switch (failure.code) {\n    case 'timeout': case 'cancelled': case 'rate-limit': case 'network':\n    case 'unavailable': case 'invalid-response': case 'configuration': case 'provider':\n      return { failure: { code: failure.code, retryable: failure.retryable } }\n    default:\n      return {}\n  }\n}\n\nexport interface SessionTranslationMetrics {\n  /** Elapsed translation time, including model selection and fallback attempts. */\n  readonly durationMs?: number\n  /** Reported token consumption across model attempts, including cached input. */\n  readonly totalTokens?: number\n}\n\n/** Preserve available metrics while accepting records saved before metrics existed. */\nexport function readSessionTranslationMetrics(value: unknown): SessionTranslationMetrics {\n  const record = asRecord(value)\n  const durationMs = record?.durationMs\n  const totalTokens = record?.totalTokens\n  return {\n    ...(typeof durationMs === 'number' && Number.isFinite(durationMs) && durationMs >= 0 ? { durationMs } : {}),\n    ...(typeof totalTokens === 'number' && Number.isSafeInteger(totalTokens) && totalTokens >= 0 ? { totalTokens } : {}),\n  }\n}\n\nexport interface SessionTranslationRecord extends SessionTranslationMetrics {\n  readonly original: string\n  readonly translated: string\n  readonly sourceLanguage?: SessionTranslationLanguage\n  readonly targetLanguage: SessionTranslationLanguage\n  /** 回复文本所在的 DSH 内容块类型，供界面将原文入口放回对应内容块。 */\n  readonly outputKind?: SessionTranslationOutputKind\n  readonly bilingual: boolean\n  /** 源语言与目标语言一致，因此未调用翻译模型。 */\n  readonly alreadyTargetLanguage?: boolean\n  /** 实际执行本次翻译的 DSH 原生模型；旧历史可能没有该字段。 */\n  readonly model?: SessionTranslationModel\n  /** 本次尝试失败并回退原文；前端显示警告状态。 */\n  readonly failed?: boolean\n  /** Structured failure details; absent in older translation records. */\n  readonly failure?: SessionTranslationFailure\n}\n\nexport type SessionTranslationRecoveryChoice = 'retry' | 'send' | 'cancel'\n\n/** A failed submission remains on the host until the user makes a choice. */\nexport interface SessionTranslationPendingInput {\n  readonly id: string\n  readonly sessionId: string\n  readonly record: SessionTranslationRecord\n}\n\n/** 用户输入的原文、实际送出的译文和翻译模型，作为 DSH 历史元数据保存。 */\nexport interface SessionTranslationInputRecord extends SessionTranslationMetrics {\n  readonly original: string\n  /** 包含附件提示等不翻译内容的最终 Provider prompt。 */\n  readonly translated: string\n  readonly sourceLanguage?: SessionTranslationLanguage\n  readonly targetLanguage: SessionTranslationLanguage\n  /** 源语言与目标语言一致，因此未调用翻译模型。 */\n  readonly alreadyTargetLanguage?: boolean\n  /** 实际执行本次翻译的 DSH 原生模型；旧历史可能没有该字段。 */\n  readonly model?: SessionTranslationModel\n  /** 翻译失败并回退原文；前端显示警告状态。 */\n  readonly failed?: boolean\n  /** Structured failure details; absent in older translation records. */\n  readonly failure?: SessionTranslationFailure\n}\n\n/**\n * 从 DSH 原生用户消息的 source 元数据读取输入翻译记录。\n *\n * 该字段由 `agent/pre-step` 写入并随 `user/message` 持久化；未知或不完整的历史\n * 结构一律返回 undefined，调用方按「没有翻译」处理。\n */\nexport function readNativeTranslationRecord(source: unknown): SessionTranslationInputRecord | undefined {\n  const record = asRecord(source)\n  const candidate = asRecord(record?.codingnsTranslationInput)\n  if (candidate === null) return undefined\n  if (typeof candidate.original !== 'string' || typeof candidate.translated !== 'string') return undefined\n  if (candidate.original.trim() === '' || candidate.translated.trim() === '') return undefined\n  const targetLanguage = isSessionTranslationLanguage(candidate.targetLanguage) ? candidate.targetLanguage : undefined\n  if (targetLanguage === undefined) return undefined\n  const model = normalizeTranslationModel(asRecord(candidate.model) as SessionTranslationModel | undefined)\n  const sourceLanguage = isSessionTranslationLanguage(candidate.sourceLanguage) ? candidate.sourceLanguage : undefined\n  return {\n    original: candidate.original,\n    translated: candidate.translated,\n    targetLanguage,\n    ...(sourceLanguage === undefined ? {} : { sourceLanguage }),\n    ...(candidate.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),\n    ...(candidate.failed === true ? { failed: true } : {}),\n    ...(model === undefined ? {} : { model }),\n    ...readSessionTranslationDiagnostics(candidate),\n    ...readSessionTranslationMetrics(candidate),\n  }\n}\n\n/** 输入记录转换为详情弹层使用的通用记录；`outputKind` 缺省表示输入方向。 */\nexport function toSessionTranslationRecord(\n  record: SessionTranslationInputRecord,\n  options: { readonly outputKind?: SessionTranslationOutputKind; readonly bilingual?: boolean } = {},\n): SessionTranslationRecord {\n  return {\n    original: record.original,\n    translated: record.translated,\n    targetLanguage: record.targetLanguage,\n    bilingual: options.bilingual === true,\n    ...(options.outputKind === undefined ? {} : { outputKind: options.outputKind }),\n    ...(record.sourceLanguage === undefined ? {} : { sourceLanguage: record.sourceLanguage }),\n    ...(record.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),\n    ...(record.failed === true ? { failed: true } : {}),\n    ...(record.model === undefined ? {} : { model: record.model }),\n    ...readSessionTranslationDiagnostics(record),\n    ...readSessionTranslationMetrics(record),\n  }\n}\n\nfunction asRecord(value: unknown): Record<string, any> | null {\n  return typeof value === 'object' && value !== null && !Array.isArray(value) ? value as Record<string, any> : null\n}\n\n/** 外部 Agent 的历史上下文使用实际发送的译文；DSH 用户消息正文保留用户原文。 */\nexport function formatSessionTranslationInput(record: SessionTranslationInputRecord): string {\n  return record.translated\n}\n\n/** Return the output translation; native DSH history keeps the original and the client reads this record. */\nexport function formatSessionTranslationOutput(record: SessionTranslationRecord): string {\n  return record.translated\n}\n"],"mappings":";;;;;;;EA2CA,MAAa,kCAAkC;GAC7C;GAAgB;GAAe;GAAQ;GAAU;GAAM;GAAS;GAAY;GAC5E;GAAS;GAAS;GAAa;GAAa;GAAc;GAAY;GAAS;GAC/E;GAAe;EACjB;EAKA,MAAa,gCAAgC;GAAC;GAAM;GAAM;GAAM;GAAM;EAAI;EAE1E,MAAa,uCAAmE;GAC9E,cAAc;GACd,kBAAkB;GAClB,kBAAkB;GAClB,eAAe;GACf,gBAAgB;GAChB,WAAW;GACX,eAAe;EACjB;;;;;;;;EASA,SAAgB,4BAA4B,WAA4B;GACtE,OAAQ,gCAAsD,SAAS,SAAS;EAClF;;EAGA,SAAgB,2BAA2B,WAA4B;GACrE,OAAO,cAAA,SAA+C,4BAA4B,SAAS;EAC7F;;EAGA,SAAgB,iCAAiC,UAAkD,WAAwD;GACzJ,MAAM,UAAU,UAAU,iBAAiB;GAC3C,OAAO;IACL,eAAe,SAAS,gBAAgB,UAAU,kBAAkB;IACpE,mBAAmB,SAAS,oBAAoB,UAAU,sBAAsB;IAChF,mBAAmB,SAAS,oBAAoB,UAAU,sBAAsB;GAClF;EACF;;EAGA,SAAgB,6BAA6B,OAAqD;GAChG,OAAO,OAAO,UAAU,YAAa,8BAAoD,SAAS,KAAK;EACzG;;;;;;;EAQA,SAAgB,oCAAoC,OAA2E;GAC7H,MAAM,WAAW;GACjB,IAAI,UAAU,KAAA,GAAW,OAAO;GAChC,MAAM,mBAAmB,0BAA0B,MAAM,gBAAgB;GACzE,MAAM,oBAAoB,MAAM,QAAQ,MAAM,iBAAiB,IAAI,2BAA2B,MAAM,iBAAiB,IAAI,KAAA;GACzH,MAAM,mBAAmB,MAAM,QAAQ,MAAM,gBAAgB,IACzD,MAAM,iBAAiB,QAAQ,SAAyB,OAAO,SAAS,QAAQ,CAAC,CAAC,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,SAAS,SAAS,EAAE,IACzI,KAAA;GACJ,OAAO;IACL,cAAc,MAAM,iBAAiB;IACrC,kBAAkB,MAAM,qBAAqB;IAC7C,kBAAkB,MAAM,qBAAqB;IAC7C,eAAe,6BAA6B,MAAM,aAAa,IAAI,MAAM,gBAAgB,SAAS;IAClG,gBAAgB,6BAA6B,MAAM,cAAc,IAAI,MAAM,iBAAiB,SAAS;IACrG,WAAW,MAAM,cAAc;IAC/B,eAAe,MAAM,kBAAkB;IACvC,GAAI,MAAM,mBAAmB,KAAA,IAAY,CAAC,IAAI,EAC5C,gBAAgB,OAAO,YAAY,OAAO,QAAQ,MAAM,cAAc,CAAC,CACpE,QAAQ,CAAC,eAAe,2BAA2B,SAAS,CAAC,CAAC,CAC9D,KAAK,CAAC,eAAe,CAAC,WAAW,iCAAiC,OAAO,SAAS,CAAC,CAAC,CAAC,EAC1F;IACA,GAAI,qBAAqB,KAAA,IAAY,CAAC,IAAI,EAAE,iBAAiB;IAC7D,GAAI,sBAAsB,KAAA,IAAY,CAAC,IAAI,EAAE,kBAAkB;IAC/D,GAAI,qBAAqB,KAAA,IAAY,CAAC,IAAI,EAAE,iBAAiB;GAC/D;EACF;EAEA,SAAS,2BAA2B,QAAgF;GAClH,MAAM,SAAoC,CAAC;GAC3C,MAAM,uBAAO,IAAI,IAAY;GAC7B,KAAK,MAAM,SAAS,QAAQ;IAC1B,MAAM,QAAQ,0BAA0B,KAAK;IAC7C,IAAI,UAAU,KAAA,GAAW;IACzB,MAAM,MAAM,KAAK,UAAU,CAAC,MAAM,UAAU,MAAM,KAAK,CAAC;IACxD,IAAI,KAAK,IAAI,GAAG,GAAG;IACnB,KAAK,IAAI,GAAG;IACZ,OAAO,KAAK,KAAK;GACnB;GACA,OAAO;EACT;EAEA,SAAS,0BAA0B,OAAiF;GAClH,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,OAAO,MAAM,aAAa,YAAY,OAAO,MAAM,UAAU,UAAU,OAAO,KAAA;GAC3H,MAAM,WAAW,MAAM,SAAS,KAAK;GACrC,MAAM,QAAQ,MAAM,MAAM,KAAK;GAC/B,OAAO,aAAa,MAAM,UAAU,KAAK,KAAA,IAAY;IAAE;IAAU;GAAM;EACzE;;EAQA,SAAgB,kCAAkC,OAA2D;GAC3G,MAAM,UAAU,SAAS,SAAS,KAAK,CAAC,EAAE,OAAO;GACjD,IAAI,OAAO,SAAS,cAAc,WAAW,OAAO,CAAC;GACrD,QAAQ,QAAQ,MAAhB;IACE,KAAK;IAAW,KAAK;IAAa,KAAK;IAAc,KAAK;IAC1D,KAAK;IAAe,KAAK;IAAoB,KAAK;IAAiB,KAAK,YACtE,OAAO,EAAE,SAAS;KAAE,MAAM,QAAQ;KAAM,WAAW,QAAQ;IAAU,EAAE;IACzE,SACE,OAAO,CAAC;GACZ;EACF;;EAUA,SAAgB,8BAA8B,OAA2C;GACvF,MAAM,SAAS,SAAS,KAAK;GAC7B,MAAM,aAAa,QAAQ;GAC3B,MAAM,cAAc,QAAQ;GAC5B,OAAO;IACL,GAAI,OAAO,eAAe,YAAY,OAAO,SAAS,UAAU,KAAK,cAAc,IAAI,EAAE,WAAW,IAAI,CAAC;IACzG,GAAI,OAAO,gBAAgB,YAAY,OAAO,cAAc,WAAW,KAAK,eAAe,IAAI,EAAE,YAAY,IAAI,CAAC;GACpH;EACF;EA+FA,SAAS,SAAS,OAA4C;GAC5D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAAI,QAA+B;EAC/G"}

package/data/build/dist/client/client.transport.js

@@ -1288,6 +1288,15 @@ window.__ModuleLoader__.load({
 			"translation.statusTranslating": "Translating…",
 			"translation.progressHelp": "Preparing and translating your message. The translation result will be available when this finishes.",
 			"translation.statusFailed": "Translation failed; original kept",
+			"translation.failure.timeout": "The translation request timed out.",
+			"translation.failure.cancelled": "The translation request was cancelled.",
+			"translation.failure.rate-limit": "The translation provider rate limit was reached.",
+			"translation.failure.network": "A network error interrupted the translation request.",
+			"translation.failure.unavailable": "The translation provider was temporarily unavailable.",
+			"translation.failure.invalid-response": "The translation response failed format, language, completion, or protected-text validation.",
+			"translation.failure.configuration": "The translation model or provider configuration was rejected or unavailable.",
+			"translation.failure.provider": "The translation provider or runtime reported an unclassified error.",
+			"translation.failure.unknown": "No failure details were saved for this translation.",
 			"translation.retry": "Retry translation",
 			"translation.sendDirectly": "Send directly",
 			"translation.cancelSending": "Cancel sending",
@@ -1389,6 +1398,15 @@ window.__ModuleLoader__.load({
 			"translation.statusTranslating": "正在翻译…",
 			"translation.progressHelp": "正在准备并翻译消息，完成后可查看翻译结果。",
 			"translation.statusFailed": "翻译失败，已保留原文",
+			"translation.failure.timeout": "翻译请求超时。",
+			"translation.failure.cancelled": "翻译请求已取消。",
+			"translation.failure.rate-limit": "翻译服务商的请求频率已达上限。",
+			"translation.failure.network": "网络错误中断了翻译请求。",
+			"translation.failure.unavailable": "翻译服务商暂时不可用。",
+			"translation.failure.invalid-response": "翻译结果未通过格式、语言、完整性或受保护文本校验。",
+			"translation.failure.configuration": "翻译模型或服务商配置被拒绝或不可用。",
+			"translation.failure.provider": "翻译服务商或运行时返回了未分类错误。",
+			"translation.failure.unknown": "此翻译未保存失败详情。",
 			"translation.retry": "重试翻译",
 			"translation.sendDirectly": "直接发送",
 			"translation.cancelSending": "取消发送",
@@ -4225,6 +4243,8 @@ window.__ModuleLoader__.load({
 			"settings.subtitle": "Configure modules without changing DSH global settings.",
 			"settings.version": "Codingns4DSH v{version}",
 			"settings.compatibility": "Compatible with DSH {range}",
+			"settings.testedDshVersion": "Tested with DSH {version}",
+			"settings.untestedDshWarning": "DSH {version} is newer than the latest tested version ({tested}). Compatibility has not been verified; plugin installation and operation remain enabled.",
 			"settings.toggle": "{label} toggle",
 			"settings.legacyFallback": "This DSH version uses compatibility mode; multi-tab and shell-selection extensions are unavailable.",
 			"settings.versionBlocked": "This module is unavailable on DSH {version}; it requires DSH {minimum} or newer.",
@@ -4683,6 +4703,8 @@ window.__ModuleLoader__.load({
 			"settings.subtitle": "按模块配置 Codingns4DSH 功能，不影响 DSH 的全局设置。",
 			"settings.version": "Codingns4DSH v{version}",
 			"settings.compatibility": "兼容 DSH {range}",
+			"settings.testedDshVersion": "已验证 DSH {version}",
+			"settings.untestedDshWarning": "当前 DSH {version} 高于插件最新已验证版本（{tested}），兼容性尚未验证；不影响插件安装和运行。",
 			"settings.toggle": "{label}开关",
 			"settings.legacyFallback": "当前 DSH 版本使用兼容模式；多 Tab 和 Shell 选择扩展不可用。",
 			"settings.versionBlocked": "当前 DSH {version} 不支持此模块；需要 DSH {minimum} 或更高版本。",