@jingyi0605/codingns4dsh 0.2.1-beta.11 → 0.2.1-beta.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/README.en.md +7 -5
  2. package/README.md +9 -5
  3. package/data/build/dist/bootstrap/dsh-connection-adapter.d.ts +1 -1
  4. package/data/build/dist/bootstrap/index.d.ts +1 -1
  5. package/data/build/dist/client/bundle.js +2280 -1495
  6. package/data/build/dist/client/bundle.js.map +1 -1
  7. package/data/build/dist/client/cli-slots.d.ts +3 -2
  8. package/data/build/dist/client/cli-slots.d.ts.map +1 -1
  9. package/data/build/dist/client/cli-slots.js +29 -5
  10. package/data/build/dist/client/cli-slots.js.map +1 -1
  11. package/data/build/dist/client/client.assistant-configuration-view.js +5 -5
  12. package/data/build/dist/client/client.assistant-configuration-view.js.map +1 -1
  13. package/data/build/dist/client/client.moss-voice-output.js +0 -166
  14. package/data/build/dist/client/client.moss-voice-output.js.map +1 -1
  15. package/data/build/dist/client/client.native-workspace-store.js +4 -4
  16. package/data/build/dist/client/client.native-workspace-store.js.map +1 -1
  17. package/data/build/dist/client/client.react-dom.js +166 -0
  18. package/data/build/dist/client/client.react-dom.js.map +1 -1
  19. package/data/build/dist/client/client.session-translation.js +9 -1
  20. package/data/build/dist/client/client.session-translation.js.map +1 -1
  21. package/data/build/dist/client/client.transport.js +46 -0
  22. package/data/build/dist/client/client.transport.js.map +1 -1
  23. package/data/build/dist/client/conversation-translation-settings.d.ts +10 -0
  24. package/data/build/dist/client/conversation-translation-settings.d.ts.map +1 -0
  25. package/data/build/dist/client/conversation-translation-settings.js +52 -0
  26. package/data/build/dist/client/conversation-translation-settings.js.map +1 -0
  27. package/data/build/dist/client/desktop-assistant.js +512 -439
  28. package/data/build/dist/client/features/cli-adapters.js +1 -1
  29. package/data/build/dist/client/features/cli-adapters.js.map +1 -1
  30. package/data/build/dist/client/features/session-translation.d.ts.map +1 -1
  31. package/data/build/dist/client/features/session-translation.js +7 -1
  32. package/data/build/dist/client/features/session-translation.js.map +1 -1
  33. package/data/build/dist/client/locales/panels.d.ts.map +1 -1
  34. package/data/build/dist/client/locales/panels.js +46 -0
  35. package/data/build/dist/client/locales/panels.js.map +1 -1
  36. package/data/build/dist/client/session-translation-chat.d.ts +9 -3
  37. package/data/build/dist/client/session-translation-chat.d.ts.map +1 -1
  38. package/data/build/dist/client/session-translation-chat.js +146 -48
  39. package/data/build/dist/client/session-translation-chat.js.map +1 -1
  40. package/data/build/dist/client/session-translation-pending-dom.d.ts +1 -1
  41. package/data/build/dist/client/session-translation-pending-dom.d.ts.map +1 -1
  42. package/data/build/dist/client/session-translation-pending-dom.js +4 -4
  43. package/data/build/dist/client/session-translation-pending-dom.js.map +1 -1
  44. package/data/build/dist/client/session-translation-retry.d.ts +16 -0
  45. package/data/build/dist/client/session-translation-retry.d.ts.map +1 -0
  46. package/data/build/dist/client/session-translation-retry.js +66 -0
  47. package/data/build/dist/client/session-translation-retry.js.map +1 -0
  48. package/data/build/dist/client/session-translation-rules.d.ts +13 -0
  49. package/data/build/dist/client/session-translation-rules.d.ts.map +1 -0
  50. package/data/build/dist/client/session-translation-rules.js +58 -0
  51. package/data/build/dist/client/session-translation-rules.js.map +1 -0
  52. package/data/build/dist/client/style.css +276 -276
  53. package/data/build/dist/dsh-capabilities/client/interaction-presentation-adapter.d.ts.map +1 -1
  54. package/data/build/dist/dsh-capabilities/client/interaction-presentation-adapter.js +4 -13
  55. package/data/build/dist/dsh-capabilities/client/interaction-presentation-adapter.js.map +1 -1
  56. package/data/build/dist/dsh-capabilities/client/interaction-text-dom.js +1 -1
  57. package/data/build/dist/dsh-capabilities/client/interaction-text-dom.js.map +1 -1
  58. package/data/build/dist/dsh-capabilities/client/message-presentation-adapter.d.ts +19 -0
  59. package/data/build/dist/dsh-capabilities/client/message-presentation-adapter.d.ts.map +1 -0
  60. package/data/build/dist/dsh-capabilities/client/message-presentation-adapter.js +39 -0
  61. package/data/build/dist/dsh-capabilities/client/message-presentation-adapter.js.map +1 -0
  62. package/data/build/dist/dsh-capabilities/client/slot-presentation-mirror.d.ts +2 -0
  63. package/data/build/dist/dsh-capabilities/client/slot-presentation-mirror.d.ts.map +1 -1
  64. package/data/build/dist/dsh-capabilities/client/slot-presentation-mirror.js +28 -0
  65. package/data/build/dist/dsh-capabilities/client/slot-presentation-mirror.js.map +1 -1
  66. package/data/build/dist/dsh-capabilities/host/connection-peer-adapter.d.ts +10 -0
  67. package/data/build/dist/dsh-capabilities/host/connection-peer-adapter.d.ts.map +1 -0
  68. package/data/build/dist/dsh-capabilities/host/connection-peer-adapter.js +34 -0
  69. package/data/build/dist/dsh-capabilities/host/connection-peer-adapter.js.map +1 -0
  70. package/data/build/dist/dsh-capabilities/host/native-dispatch-adapter.d.ts +21 -0
  71. package/data/build/dist/dsh-capabilities/host/native-dispatch-adapter.d.ts.map +1 -0
  72. package/data/build/dist/dsh-capabilities/host/native-dispatch-adapter.js +11 -0
  73. package/data/build/dist/dsh-capabilities/host/native-dispatch-adapter.js.map +1 -0
  74. package/data/build/dist/dsh-capabilities/host/session-activation-adapter.d.ts +17 -0
  75. package/data/build/dist/dsh-capabilities/host/session-activation-adapter.d.ts.map +1 -0
  76. package/data/build/dist/dsh-capabilities/host/session-activation-adapter.js +37 -0
  77. package/data/build/dist/dsh-capabilities/host/session-activation-adapter.js.map +1 -0
  78. package/data/build/dist/dsh-capabilities/host/session-model-selection-adapter.d.ts +17 -0
  79. package/data/build/dist/dsh-capabilities/host/session-model-selection-adapter.d.ts.map +1 -0
  80. package/data/build/dist/dsh-capabilities/host/session-model-selection-adapter.js +45 -0
  81. package/data/build/dist/dsh-capabilities/host/session-model-selection-adapter.js.map +1 -0
  82. package/data/build/dist/dsh-capabilities/host/session-prompt-adapter.d.ts +28 -0
  83. package/data/build/dist/dsh-capabilities/host/session-prompt-adapter.d.ts.map +1 -0
  84. package/data/build/dist/dsh-capabilities/host/session-prompt-adapter.js +31 -0
  85. package/data/build/dist/dsh-capabilities/host/session-prompt-adapter.js.map +1 -0
  86. package/data/build/dist/dsh-capabilities/matrix.d.ts.map +1 -1
  87. package/data/build/dist/dsh-capabilities/matrix.js +12 -4
  88. package/data/build/dist/dsh-capabilities/matrix.js.map +1 -1
  89. package/data/build/dist/dsh-capabilities/routes.d.ts.map +1 -1
  90. package/data/build/dist/dsh-capabilities/routes.js +25 -5
  91. package/data/build/dist/dsh-capabilities/routes.js.map +1 -1
  92. package/data/build/dist/dsh-capabilities/types.d.ts +1 -1
  93. package/data/build/dist/dsh-capabilities/types.d.ts.map +1 -1
  94. package/data/build/dist/dsh-capabilities/types.js.map +1 -1
  95. package/data/build/dist/host/cli-adapters/antigravity-driver.js +1 -1
  96. package/data/build/dist/host/cli-adapters/antigravity-driver.js.map +1 -1
  97. package/data/build/dist/host/cli-adapters/attachment-utils.d.ts +4 -3
  98. package/data/build/dist/host/cli-adapters/attachment-utils.d.ts.map +1 -1
  99. package/data/build/dist/host/cli-adapters/attachment-utils.js +9 -8
  100. package/data/build/dist/host/cli-adapters/attachment-utils.js.map +1 -1
  101. package/data/build/dist/host/cli-adapters/claude-driver.js +1 -1
  102. package/data/build/dist/host/cli-adapters/claude-driver.js.map +1 -1
  103. package/data/build/dist/host/cli-adapters/command-code-driver.js +1 -1
  104. package/data/build/dist/host/cli-adapters/command-code-driver.js.map +1 -1
  105. package/data/build/dist/host/cli-adapters/driver.d.ts +2 -0
  106. package/data/build/dist/host/cli-adapters/driver.d.ts.map +1 -1
  107. package/data/build/dist/host/cli-adapters/dsh-message-projector.d.ts +2 -0
  108. package/data/build/dist/host/cli-adapters/dsh-message-projector.d.ts.map +1 -1
  109. package/data/build/dist/host/cli-adapters/dsh-message-projector.js +11 -3
  110. package/data/build/dist/host/cli-adapters/dsh-message-projector.js.map +1 -1
  111. package/data/build/dist/host/cli-adapters/feature.d.ts.map +1 -1
  112. package/data/build/dist/host/cli-adapters/feature.js +154 -68
  113. package/data/build/dist/host/cli-adapters/feature.js.map +1 -1
  114. package/data/build/dist/host/cli-adapters/gemini-driver.js +1 -1
  115. package/data/build/dist/host/cli-adapters/gemini-driver.js.map +1 -1
  116. package/data/build/dist/host/cli-adapters/grok-driver.d.ts +1 -0
  117. package/data/build/dist/host/cli-adapters/grok-driver.d.ts.map +1 -1
  118. package/data/build/dist/host/cli-adapters/grok-driver.js +128 -40
  119. package/data/build/dist/host/cli-adapters/grok-driver.js.map +1 -1
  120. package/data/build/dist/host/cli-adapters/kimi-driver.js +2 -2
  121. package/data/build/dist/host/cli-adapters/kimi-driver.js.map +1 -1
  122. package/data/build/dist/host/cli-adapters/mcode-driver.js +1 -1
  123. package/data/build/dist/host/cli-adapters/mcode-driver.js.map +1 -1
  124. package/data/build/dist/host/cli-adapters/native-team-subagent.d.ts.map +1 -1
  125. package/data/build/dist/host/cli-adapters/native-team-subagent.js +2 -1
  126. package/data/build/dist/host/cli-adapters/native-team-subagent.js.map +1 -1
  127. package/data/build/dist/host/cli-adapters/pi-driver.js +1 -1
  128. package/data/build/dist/host/cli-adapters/pi-driver.js.map +1 -1
  129. package/data/build/dist/host/cli-adapters/registry.d.ts.map +1 -1
  130. package/data/build/dist/host/cli-adapters/registry.js +23 -16
  131. package/data/build/dist/host/cli-adapters/registry.js.map +1 -1
  132. package/data/build/dist/host/cli-adapters/zcode-driver.js +1 -1
  133. package/data/build/dist/host/cli-adapters/zcode-driver.js.map +1 -1
  134. package/data/build/dist/host/features/global-voice-rpc.d.ts.map +1 -1
  135. package/data/build/dist/host/features/global-voice-rpc.js +2 -3
  136. package/data/build/dist/host/features/global-voice-rpc.js.map +1 -1
  137. package/data/build/dist/host/features/peer-host.js +6 -6
  138. package/data/build/dist/host/features/peer-host.js.map +1 -1
  139. package/data/build/dist/host/features/session-prompt-translation.d.ts +10 -0
  140. package/data/build/dist/host/features/session-prompt-translation.d.ts.map +1 -0
  141. package/data/build/dist/host/features/session-prompt-translation.js +197 -0
  142. package/data/build/dist/host/features/session-prompt-translation.js.map +1 -0
  143. package/data/build/dist/host/features/session-translation-protection.d.ts +6 -1
  144. package/data/build/dist/host/features/session-translation-protection.d.ts.map +1 -1
  145. package/data/build/dist/host/features/session-translation-protection.js +23 -5
  146. package/data/build/dist/host/features/session-translation-protection.js.map +1 -1
  147. package/data/build/dist/host/features/session-translation-recovery.d.ts +20 -0
  148. package/data/build/dist/host/features/session-translation-recovery.d.ts.map +1 -0
  149. package/data/build/dist/host/features/session-translation-recovery.js +122 -0
  150. package/data/build/dist/host/features/session-translation-recovery.js.map +1 -0
  151. package/data/build/dist/host/features/session-translation-service.d.ts +5 -2
  152. package/data/build/dist/host/features/session-translation-service.d.ts.map +1 -1
  153. package/data/build/dist/host/features/session-translation-service.js +60 -16
  154. package/data/build/dist/host/features/session-translation-service.js.map +1 -1
  155. package/data/build/dist/host/features/session-translation.d.ts.map +1 -1
  156. package/data/build/dist/host/features/session-translation.js +4 -1
  157. package/data/build/dist/host/features/session-translation.js.map +1 -1
  158. package/data/build/dist/host/modules/peer-host/peer-host-native-dispatch.d.ts +2 -2
  159. package/data/build/dist/host/modules/peer-host/peer-host-native-dispatch.d.ts.map +1 -1
  160. package/data/build/dist/host/modules/peer-host/peer-host-native-dispatch.js +10 -9
  161. package/data/build/dist/host/modules/peer-host/peer-host-native-dispatch.js.map +1 -1
  162. package/data/build/dist/host/modules/peer-host/peer-host-native-streams.d.ts +3 -3
  163. package/data/build/dist/host/modules/peer-host/peer-host-native-streams.d.ts.map +1 -1
  164. package/data/build/dist/host/modules/peer-host/peer-host-native-streams.js +26 -14
  165. package/data/build/dist/host/modules/peer-host/peer-host-native-streams.js.map +1 -1
  166. package/data/build/dist/host/native-session-bridge.d.ts +2 -1
  167. package/data/build/dist/host/native-session-bridge.d.ts.map +1 -1
  168. package/data/build/dist/host/native-session-bridge.js +5 -13
  169. package/data/build/dist/host/native-session-bridge.js.map +1 -1
  170. package/data/build/dist/host/rpc.d.ts.map +1 -1
  171. package/data/build/dist/host/rpc.js +14 -8
  172. package/data/build/dist/host/rpc.js.map +1 -1
  173. package/data/build/dist/host/settings.d.ts.map +1 -1
  174. package/data/build/dist/host/settings.js +5 -1
  175. package/data/build/dist/host/settings.js.map +1 -1
  176. package/data/build/dist/shared/attachment-prompts.d.ts +11 -0
  177. package/data/build/dist/shared/attachment-prompts.d.ts.map +1 -0
  178. package/data/build/dist/shared/attachment-prompts.js +17 -0
  179. package/data/build/dist/shared/attachment-prompts.js.map +1 -0
  180. package/data/build/dist/shared/contracts/cli-adapter.d.ts +8 -1
  181. package/data/build/dist/shared/contracts/cli-adapter.d.ts.map +1 -1
  182. package/data/build/dist/shared/contracts/errors.d.ts +2 -2
  183. package/data/build/dist/shared/contracts/session-translation.d.ts +13 -0
  184. package/data/build/dist/shared/contracts/session-translation.d.ts.map +1 -1
  185. package/data/build/dist/shared/contracts/session-translation.js +10 -0
  186. package/data/build/dist/shared/contracts/session-translation.js.map +1 -1
  187. package/data/build/dist/shared/contracts/version.d.ts +4 -4
  188. package/data/build/dist/shared/contracts/version.js +3 -3
  189. package/package.json +35 -34
  190. package/profile/README.md +2 -2
  191. package/profile/package.json +3 -3
  192. package/profile/version.json +3 -3
  193. package/version.json +3 -3
@@ -1 +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/config.ts","../../../../src/client/native-workspace-store.ts"],"sourcesContent":["/** 当前经过完整验证的 DSH 版本;源文件由根目录 version.json 同步。 */\nexport const DSH_VERSION = '0.2.1-alpha.2' as const\n\n/** DSH 测试版本别名,供新代码表达语义,保留 DSH_VERSION 兼容旧调用方。 */\nexport const DSH_TESTED_VERSION = DSH_VERSION\n\n/**\n * 插件正式验证的 DSH 版本范围,覆盖 rc.2 到当前验证的 alpha.2。\n *\n * 0.2.0-rc.2、0.2.1-alpha.1 与 0.2.1-alpha.2 属于同一 API 世代:插件直接消费的\n * 20 个宿主包中 18 个接口面未变,会话格式仍为 v4。唯一的服务级破坏性变化是\n * alpha.2 用 `subagents.startActivation()` 取代 `startContinuable()`,由\n * `subagent.activation` / `subagent.continuable` 两条能力路由分别探测,业务侧\n * 经 `startNativeSubagent()` 归一化调用,因此同一个版本范围仍然成立。\n *\n * 这里保留明确上界,是为了让 npm/DSH 安装期也能识别 0.2.1-alpha.2 这个跨 patch\n * 预发布版本;出现新的 API 世代或结构变化时,应重新验证并更新范围与能力路由。\n */\nexport const DSH_COMPATIBILITY = '>=0.2.0-rc.2 <=0.2.1-alpha.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-beta.11' 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","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'\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 /** 手机/平板窄屏访问时的界面增强选项。 */\n mobileAccess: MobileAccessSettings\n /** 用量查询设置:超时控制单次网络查询,间隔控制自动刷新。 */\n subscriptionUsage: SubscriptionUsageSettings\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}\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\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 表示启动时自动探测。 */\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_SESSION_TRANSLATION_FIELD = 'sessionTranslation'\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 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 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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"}
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/config.ts","../../../../src/client/native-workspace-store.ts"],"sourcesContent":["/** 当前经过完整验证的 DSH 版本;源文件由根目录 version.json 同步。 */\nexport const DSH_VERSION = '0.2.1-alpha.3' as const\n\n/** DSH 测试版本别名,供新代码表达语义,保留 DSH_VERSION 兼容旧调用方。 */\nexport const DSH_TESTED_VERSION = DSH_VERSION\n\n/**\n * 插件正式验证的 DSH 版本范围,覆盖 rc.2 到当前验证的 alpha.2。\n *\n * 0.2.0-rc.2、0.2.1-alpha.1 与 0.2.1-alpha.2 属于同一 API 世代:插件直接消费的\n * 20 个宿主包中 18 个接口面未变,会话格式仍为 v4。唯一的服务级破坏性变化是\n * alpha.2 用 `subagents.startActivation()` 取代 `startContinuable()`,由\n * `subagent.activation` / `subagent.continuable` 两条能力路由分别探测,业务侧\n * 经 `startNativeSubagent()` 归一化调用,因此同一个版本范围仍然成立。\n *\n * 这里保留明确上界,是为了让 npm/DSH 安装期也能识别 0.2.1-alpha.2 这个跨 patch\n * 预发布版本;出现新的 API 世代或结构变化时,应重新验证并更新范围与能力路由。\n */\nexport const DSH_COMPATIBILITY = '>=0.2.0-rc.2 <=0.2.1-alpha.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-beta.12' 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","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'\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 /** 手机/平板窄屏访问时的界面增强选项。 */\n mobileAccess: MobileAccessSettings\n /** 用量查询设置:超时控制单次网络查询,间隔控制自动刷新。 */\n subscriptionUsage: SubscriptionUsageSettings\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}\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\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 表示启动时自动探测。 */\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_SESSION_TRANSLATION_FIELD = 'sessionTranslation'\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 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 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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"}
@@ -5,6 +5,148 @@ window.__ModuleLoader__.load({
5
5
  var module = { exports: {} };
6
6
  var exports = module.exports;
7
7
  const require_rolldown_runtime = require("@jingyi0605/codingns4dsh/client.rolldown-runtime.js");
8
+ const require_theme = require("@jingyi0605/codingns4dsh/client.theme.js");
9
+ let react = require("react");
10
+ //#region src/client/settings-controls.ts
11
+ const settingsControlClass = {
12
+ switch: "codingns4dsh-settings-switch",
13
+ track: "codingns4dsh-settings-switch-track",
14
+ thumb: "codingns4dsh-settings-switch-thumb",
15
+ iconButton: "codingns4dsh-settings-icon-button"
16
+ };
17
+ /** 模块使用主开关,子设置使用更小、更轻的开关;保留 checkbox 的标签与键盘语义。 */
18
+ function SettingsSwitch(props) {
19
+ (0, react.useEffect)(() => retainSettingsControlStyles(), []);
20
+ const { variant = "setting", ...inputProps } = props;
21
+ const width = variant === "module" ? 36 : 28;
22
+ return (0, react.createElement)("span", {
23
+ className: settingsControlClass.switch,
24
+ "data-variant": variant,
25
+ style: {
26
+ position: "relative",
27
+ display: "inline-flex",
28
+ alignItems: "center",
29
+ flex: `0 0 ${width}px`,
30
+ width,
31
+ height: 28,
32
+ marginLeft: "auto"
33
+ }
34
+ }, (0, react.createElement)("input", {
35
+ type: "checkbox",
36
+ role: "switch",
37
+ ...inputProps,
38
+ style: {
39
+ position: "absolute",
40
+ inset: 0,
41
+ width: "100%",
42
+ height: "100%",
43
+ margin: 0,
44
+ opacity: 0,
45
+ cursor: props.disabled ? "not-allowed" : "pointer",
46
+ zIndex: 1
47
+ }
48
+ }), (0, react.createElement)("span", {
49
+ className: settingsControlClass.track,
50
+ "aria-hidden": true
51
+ }, (0, react.createElement)("span", { className: settingsControlClass.thumb })));
52
+ }
53
+ /** 文案占据剩余宽度;右侧操作不收缩,长说明和窄屏都不会移动开关。 */
54
+ function SettingsToggleRow({ label, description, checked, disabled, onChange, actions, style }) {
55
+ const id = (0, react.useId)();
56
+ return (0, react.createElement)("div", { style: {
57
+ ...require_theme.dshSettingsListRowStyle,
58
+ ...style
59
+ } }, (0, react.createElement)("label", {
60
+ htmlFor: id,
61
+ style: {
62
+ flex: "1 1 auto",
63
+ minWidth: 0,
64
+ cursor: disabled ? "not-allowed" : "pointer",
65
+ overflowWrap: "anywhere"
66
+ }
67
+ }, (0, react.createElement)("span", { style: {
68
+ display: "block",
69
+ fontSize: require_theme.uiFontSize(13),
70
+ fontWeight: 500,
71
+ lineHeight: 1.4
72
+ } }, label), description === void 0 ? null : (0, react.createElement)("span", { style: {
73
+ display: "block",
74
+ marginTop: 3,
75
+ ...require_theme.dshSettingsHelpStyle
76
+ } }, description)), (0, react.createElement)("span", { style: {
77
+ display: "inline-flex",
78
+ alignItems: "center",
79
+ gap: 10,
80
+ flex: "0 0 auto",
81
+ marginLeft: "auto"
82
+ } }, actions, (0, react.createElement)(SettingsSwitch, {
83
+ id,
84
+ "aria-label": label,
85
+ checked,
86
+ disabled,
87
+ onChange: (event) => onChange(event.currentTarget.checked)
88
+ })));
89
+ }
90
+ /** 图标按钮采用 DSH 的紧凑中性表面,交互态由共享样式表提供。 */
91
+ const settingsIconButtonStyle = {
92
+ display: "inline-flex",
93
+ alignItems: "center",
94
+ justifyContent: "center",
95
+ flex: "0 0 32px",
96
+ width: 32,
97
+ height: 32,
98
+ padding: 0,
99
+ boxSizing: "border-box",
100
+ border: 0,
101
+ borderRadius: "var(--dsw-radius-sm, 6px)",
102
+ color: require_theme.dshThemeColor.labelSecondary,
103
+ background: "transparent",
104
+ cursor: "pointer"
105
+ };
106
+ /** 各独立面板共享一份样式,最后一个开关卸载时释放,兼容 React 严格模式的重复挂载。 */
107
+ const retainedStyles = /* @__PURE__ */ new WeakMap();
108
+ function retainSettingsControlStyles() {
109
+ if (typeof document === "undefined") return () => void 0;
110
+ const dom = document;
111
+ let state = retainedStyles.get(dom);
112
+ if (state === void 0) {
113
+ const element = dom.createElement("style");
114
+ element.dataset.plugin = "codingns4dsh";
115
+ element.dataset.pluginCss = "codingns4dsh-settings-controls";
116
+ element.textContent = settingsControlCss;
117
+ dom.head.appendChild(element);
118
+ state = {
119
+ element,
120
+ users: 0
121
+ };
122
+ retainedStyles.set(dom, state);
123
+ }
124
+ const retained = state;
125
+ retained.users += 1;
126
+ return () => {
127
+ retained.users -= 1;
128
+ if (retained.users > 0) return;
129
+ retained.element.remove();
130
+ retainedStyles.delete(dom);
131
+ };
132
+ }
133
+ const settingsControlCss = `
134
+ .${settingsControlClass.switch}{--codingns-switch-height:16px;--codingns-switch-thumb:12px;--codingns-switch-travel:12px;--codingns-switch-active:var(--dsw-alias-button-info-fill);--codingns-switch-active-thumb:var(--dsw-static-neutral-00)}
135
+ .${settingsControlClass.switch}[data-variant="module"]{--codingns-switch-height:20px;--codingns-switch-thumb:16px;--codingns-switch-travel:16px;--codingns-switch-active:var(--dsw-alias-brand-primary);--codingns-switch-active-thumb:var(--dsw-alias-label-primary-foreground)}
136
+ .${settingsControlClass.track}{box-sizing:border-box;display:block;width:100%;height:var(--codingns-switch-height);padding:2px;border:0;border-radius:999px;corner-shape:round;background:var(--dsw-alias-border-l3);pointer-events:none;transition:background 120ms ease}
137
+ .${settingsControlClass.thumb}{display:block;width:var(--codingns-switch-thumb);height:var(--codingns-switch-thumb);border-radius:50%;corner-shape:round;background:var(--dsw-alias-switch-thumb);transition:transform 120ms ease,background 120ms ease}
138
+ .${settingsControlClass.switch}>input:checked+.${settingsControlClass.track}{background:var(--codingns-switch-active)}
139
+ .${settingsControlClass.switch}>input:checked+.${settingsControlClass.track}>.${settingsControlClass.thumb}{background:var(--codingns-switch-active-thumb);transform:translateX(var(--codingns-switch-travel))}
140
+ .${settingsControlClass.switch}>input:disabled+.${settingsControlClass.track}{opacity:.5}
141
+ .${settingsControlClass.switch}>input:disabled{cursor:not-allowed!important}
142
+ .${settingsControlClass.switch}>input:focus-visible+.${settingsControlClass.track}{outline:${require_theme.dshThemeColor.focusRing};outline-offset:3px}
143
+ .${settingsControlClass.iconButton}:hover:not(:disabled){color:${require_theme.dshThemeColor.labelPrimary};background:${require_theme.dshThemeColor.hoverBackground}}
144
+ .${settingsControlClass.iconButton}:active:not(:disabled){background:${require_theme.dshThemeColor.activeBackground}}
145
+ .${settingsControlClass.iconButton}:focus-visible{outline:${require_theme.dshThemeColor.focusRing};outline-offset:2px}
146
+ .${settingsControlClass.iconButton}:disabled{opacity:.5;cursor:not-allowed}
147
+ @media (prefers-reduced-motion:reduce){.${settingsControlClass.track},.${settingsControlClass.thumb}{transition:none}}
148
+ `;
149
+ //#endregion
8
150
  //#region node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/cjs/scheduler.production.min.js
9
151
  /**
10
152
  * @license React
@@ -6953,12 +7095,36 @@ window.__ModuleLoader__.load({
6953
7095
  module.exports = require_react_dom_production_min();
6954
7096
  }));
6955
7097
  //#endregion
7098
+ Object.defineProperty(exports, "SettingsSwitch", {
7099
+ enumerable: true,
7100
+ get: function() {
7101
+ return SettingsSwitch;
7102
+ }
7103
+ });
7104
+ Object.defineProperty(exports, "SettingsToggleRow", {
7105
+ enumerable: true,
7106
+ get: function() {
7107
+ return SettingsToggleRow;
7108
+ }
7109
+ });
6956
7110
  Object.defineProperty(exports, "require_react_dom", {
6957
7111
  enumerable: true,
6958
7112
  get: function() {
6959
7113
  return require_react_dom;
6960
7114
  }
6961
7115
  });
7116
+ Object.defineProperty(exports, "settingsControlClass", {
7117
+ enumerable: true,
7118
+ get: function() {
7119
+ return settingsControlClass;
7120
+ }
7121
+ });
7122
+ Object.defineProperty(exports, "settingsIconButtonStyle", {
7123
+ enumerable: true,
7124
+ get: function() {
7125
+ return settingsIconButtonStyle;
7126
+ }
7127
+ });
6962
7128
  return module.exports;
6963
7129
  }
6964
7130
  });