@jingyi0605/codingns4dsh 0.2.1-rc.3 → 0.2.1-rc.4

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

@@ -33,7 +33,7 @@ window.__ModuleLoader__.load({
 			return /^0\.1\.5(?:-|$)/u.test(version);
 		}
 		/** Codingns4DSH 插件自身的 npm 版本。 */
-		const CODINGNS_VERSION = "0.2.1-rc.3";
+		const CODINGNS_VERSION = "0.2.1-rc.4";
 		/** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内；范围省略上界时不校验上限。 */
 		function isDshVersionCompatible(version) {
 			const match = /^>=([^ ]+)(?: <=([^ ]+))?$/u.exec(DSH_COMPATIBILITY);

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.3' 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  /** 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/** 归一化子代理托管设置：只有显式 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  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 * 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.4' 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  /** 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/** 归一化子代理托管设置：只有显式 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  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.transport.js

@@ -3389,6 +3389,8 @@ window.__ModuleLoader__.load({
 			"magpie.routing": "Routing",
 			"magpie.statTokens": "Tokens",
 			"magpie.statCalls": "Requests",
+			"magpie.statTurns": "Turns",
+			"magpie.statSteps": "Steps",
 			"magpie.statWriteDown": "Output",
 			"magpie.statSessions": "Sessions",
 			"magpie.statReasoning": "Reasoning",
@@ -3556,6 +3558,11 @@ window.__ModuleLoader__.load({
 			"magpie.management.modelCountUnknown": "Model count not reported",
 			"magpie.management.modelCounts": "{exposed} exposed / {total} available models",
 			"magpie.management.providerName": "Provider name",
+			"magpie.management.providerId": "Provider ID",
+			"magpie.management.providerIdHint": "Lower-case letters, digits and dashes, as model IDs spell it ({id}/model). Renaming carries the routing groups and Agent configs that name its models along.",
+			"magpie.management.providerIdLocked": "Magpie stores this provider under an ID it will not write again, so it cannot be renamed here.",
+			"magpie.management.providerIdInvalid": "An ID needs at least one letter or digit.",
+			"magpie.management.providerIdPreview": "Saved as {id}; the current one stays a remembered alias.",
 			"magpie.management.endpointType": "Endpoint type",
 			"magpie.management.endpointUrl": "Endpoint URL",
 			"magpie.management.exposedModels": "Exposed models",
@@ -3619,6 +3626,8 @@ window.__ModuleLoader__.load({
 			"magpie.management.reviewProvider": "Review provider changes",
 			"magpie.management.reviewGroup": "Review routing-group changes",
 			"magpie.management.reviewName": "Name: {value}",
+			"magpie.management.reviewProviderId": "ID: {from} → {to}",
+			"magpie.management.providerIdRenameHint": "Magpie saves the other changes under the current ID first, then moves the provider: the routing groups and Agent configs naming its models follow, and the current ID stays an alias of the new one.",
 			"magpie.management.reviewEndpoint": "{field} endpoint: {value}",
 			"magpie.management.reviewModels": "Model list: {count} entries",
 			"magpie.management.reviewRouting": "Routing: {value}",
@@ -3652,6 +3661,8 @@ window.__ModuleLoader__.load({
 			"magpie.previous": "Previous",
 			"magpie.next": "Next",
 			"magpie.pageOf": "Page {page}",
+			"magpie.loadMore": "Load more",
+			"magpie.loadedCount": "Loaded {count}",
 			"magpie.quotaHistory": "Allowance history",
 			"magpie.quotaHistoryNote": "Remaining allowance values recorded by Magpie; units follow each provider.",
 			"magpie.dailyUsage": "Daily usage",
@@ -3680,13 +3691,13 @@ window.__ModuleLoader__.load({
 			"magpie.install.reason.launch": "The entry {command} exists but Magpie could not run. Check the installation and try again.",
 			"magpie.install.reason.timeout": "The entry {command} did not answer in time. Check the installation and try again.",
 			"magpie.install.reason.version": "The entry {command} ran but did not report a recognizable Magpie version.",
-			"magpie.install.command": "npm i -g magpie && magpie --version",
-			"magpie.install.installHelp.macos": "Install with npm or pnpm, then reopen DSH. The Host reads the login shell PATH and the Homebrew, /usr/local, ~/.local/bin, and ~/.bun/bin directories, so a version manager install is enough.",
-			"magpie.install.installHelp.windows": "Install with npm or pnpm (a magpie.cmd shim is found), or use the Magpie installer. The Host searches PATH, then the npm, pnpm, Volta, Bun, Scoop, and WinGet directories under your user profile. Reopen DSH after installing so it picks up the new PATH.",
-			"magpie.install.installHelp.linux": "Install with npm or pnpm, then reopen DSH. The Host reads the login shell PATH plus /usr/local/bin and ~/.local/bin.",
+			"magpie.install.command": "magpie --version",
+			"magpie.install.installHelp.macos": "Install Magpie with the official GitHub release or installation script, then reopen DSH. The Host reads the login shell PATH and common standalone binary directories such as Homebrew and ~/.local/bin.",
+			"magpie.install.installHelp.windows": "Install Magpie from the official GitHub release or installation script. The Host reads the Windows registry PATH and checks the installer's %USERPROFILE%\\.local\\bin location plus other common standalone binary directories. Reopen DSH after installing so it picks up the new PATH.",
+			"magpie.install.installHelp.linux": "Install Magpie with the official GitHub release or installation script, then reopen DSH. The Host reads the login shell PATH plus /usr/local/bin and ~/.local/bin.",
 			"magpie.install.customToggle": "Specify the Magpie path",
 			"magpie.install.customLabel": "Absolute path to the Magpie executable",
-			"magpie.install.customPlaceholder": "/opt/homebrew/bin/magpie or C:\\Users\\you\\AppData\\Roaming\\npm\\magpie.cmd",
+			"magpie.install.customPlaceholder": "/opt/homebrew/bin/magpie or C:\\Users\\you\\.local\\bin\\magpie.exe",
 			"magpie.install.customHelp": "Only an absolute path to a file is accepted; arguments are not allowed. The path is used for this session only.",
 			"magpie.install.customApply": "Detect this path",
 			"magpie.install.disabledNote": "Magpie management stays off until a working Magpie CLI is detected."
@@ -3699,6 +3710,8 @@ window.__ModuleLoader__.load({
 			"magpie.routing": "路由",
 			"magpie.statTokens": "Token",
 			"magpie.statCalls": "请求",
+			"magpie.statTurns": "回合",
+			"magpie.statSteps": "步骤",
 			"magpie.statWriteDown": "输出",
 			"magpie.statSessions": "会话数",
 			"magpie.statReasoning": "推理",
@@ -3866,6 +3879,11 @@ window.__ModuleLoader__.load({
 			"magpie.management.modelCountUnknown": "未报告模型数量",
 			"magpie.management.modelCounts": "已公开 {exposed} / 可用 {total} 个模型",
 			"magpie.management.providerName": "提供商名称",
+			"magpie.management.providerId": "提供商 ID",
+			"magpie.management.providerIdHint": "只能使用小写字母、数字和短横线，模型 ID 以它开头（{id}/模型）。改名时会一并迁移引用其模型的路由组与 Agent 配置。",
+			"magpie.management.providerIdLocked": "Magpie 以这个不会再写入的 ID 保存该提供商，因此此处不能改名。",
+			"magpie.management.providerIdInvalid": "ID 至少需要一个字母或数字。",
+			"magpie.management.providerIdPreview": "将保存为 {id}；原 ID 仍会作为别名保留。",
 			"magpie.management.endpointType": "端点类型",
 			"magpie.management.endpointUrl": "端点 URL",
 			"magpie.management.exposedModels": "已公开模型",
@@ -3929,6 +3947,8 @@ window.__ModuleLoader__.load({
 			"magpie.management.reviewProvider": "确认提供商变更",
 			"magpie.management.reviewGroup": "确认路由组变更",
 			"magpie.management.reviewName": "名称：{value}",
+			"magpie.management.reviewProviderId": "ID：{from} → {to}",
+			"magpie.management.providerIdRenameHint": "Magpie 会先在当前 ID 下保存其他变更，再迁移该提供商：引用其模型的路由组与 Agent 配置会随之迁移，当前 ID 会保留为新 ID 的别名。",
 			"magpie.management.reviewEndpoint": "{field} 端点：{value}",
 			"magpie.management.reviewModels": "模型列表：{count} 项",
 			"magpie.management.reviewRouting": "路由：{value}",
@@ -3962,6 +3982,8 @@ window.__ModuleLoader__.load({
 			"magpie.previous": "上一页",
 			"magpie.next": "下一页",
 			"magpie.pageOf": "第 {page} 页",
+			"magpie.loadMore": "加载更多",
+			"magpie.loadedCount": "已加载 {count} 条",
 			"magpie.quotaHistory": "额度历史",
 			"magpie.quotaHistoryNote": "Magpie 记录的剩余额度；单位以各提供商报告为准。",
 			"magpie.dailyUsage": "每日用量",
@@ -3990,13 +4012,13 @@ window.__ModuleLoader__.load({
 			"magpie.install.reason.launch": "入口 {command} 存在，但 Magpie 无法运行；请检查安装后重试。",
 			"magpie.install.reason.timeout": "入口 {command} 未在限定时间内响应；请检查安装后重试。",
 			"magpie.install.reason.version": "入口 {command} 已运行，但没有输出可识别的 Magpie 版本。",
-			"magpie.install.command": "npm i -g magpie && magpie --version",
-			"magpie.install.installHelp.macos": "使用 npm 或 pnpm 安装后重新打开 DSH。Host 会读取登录 Shell 的 PATH，以及 Homebrew、/usr/local、~/.local/bin、~/.bun/bin 目录，因此通过版本管理器安装也能识别。",
-			"magpie.install.installHelp.windows": "使用 npm 或 pnpm 安装（可识别 magpie.cmd），或使用 Magpie 安装包。Host 先查 PATH，再查用户目录下的 npm、pnpm、Volta、Bun、Scoop 和 WinGet 目录。安装后请重新打开 DSH，以读取新的 PATH。",
-			"magpie.install.installHelp.linux": "使用 npm 或 pnpm 安装后重新打开 DSH。Host 会读取登录 Shell 的 PATH、/usr/local/bin 和 ~/.local/bin。",
+			"magpie.install.command": "magpie --version",
+			"magpie.install.installHelp.macos": "请使用官方 GitHub Release 或安装脚本安装 Magpie，然后重新打开 DSH。Host 会读取登录 Shell 的 PATH，以及 Homebrew、/usr/local/bin、~/.local/bin 等常见独立程序目录。",
+			"magpie.install.installHelp.windows": "请使用官方 GitHub Release 或安装脚本安装 Magpie。Host 会读取 Windows 注册表中的 PATH，并检查安装脚本使用的 %USERPROFILE%\\.local\\bin 以及其他常见独立程序目录。安装后请重新打开 DSH，以读取新的 PATH。",
+			"magpie.install.installHelp.linux": "请使用官方 GitHub Release 或安装脚本安装 Magpie，然后重新打开 DSH。Host 会读取登录 Shell 的 PATH、/usr/local/bin 和 ~/.local/bin。",
 			"magpie.install.customToggle": "手动指定 Magpie 路径",
 			"magpie.install.customLabel": "Magpie 可执行文件的绝对路径",
-			"magpie.install.customPlaceholder": "/opt/homebrew/bin/magpie 或 C:\\Users\\你\\AppData\\Roaming\\npm\\magpie.cmd",
+			"magpie.install.customPlaceholder": "/opt/homebrew/bin/magpie 或 C:\\Users\\你\\.local\\bin\\magpie.exe",
 			"magpie.install.customHelp": "只接受文件绝对路径，不允许附加参数；该路径只在本次会话生效。",
 			"magpie.install.customApply": "检测此路径",
 			"magpie.install.disabledNote": "检测到可用的 Magpie CLI 前，Magpie 管理保持关闭。"