@jingyi0605/codingns4dsh 0.2.1-beta.9 → 0.2.1-rc.2

package/data/build/dist/client/client.moss-voice-output.js

@@ -0,0 +1,415 @@
+window.__ModuleLoader__.load({
+	id: "@jingyi0605/codingns4dsh",
+	chunk: "client.moss-voice-output.js",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		const require_manager = require("@jingyi0605/codingns4dsh/client.manager.js");
+		const require_primitives_adapter = require("@jingyi0605/codingns4dsh/client.primitives-adapter.js");
+		//#region src/client/peer-host-color.ts
+		/**
+		* 工作区标签配色的推导与缓存。
+		*
+		* 用户在 PeerHost 管理里显式配置的颜色优先；没有配置时按 Host 名称推导一个稳定
+		* 颜色，保证同一台机器在多次刷新、多个工作区之间颜色一致——颜色本身是识别手段，
+		* 随机色会让标签失去意义。
+		*/
+		/** 无显式配色时使用的候选色板；与 PEER_HOST_COLOR_PRESETS 保持同一组观感。 */
+		const FALLBACK_PALETTE = [
+			"#1677ff",
+			"#722ed1",
+			"#13c2c2",
+			"#52c41a",
+			"#fa8c16",
+			"#eb2f96",
+			"#f5222d",
+			"#8c8c8c"
+		];
+		const derivedCache = /* @__PURE__ */ new Map();
+		/**
+		* 解析某台 Host 的工作区标签颜色。
+		*
+		* @param explicit - 用户在 PeerHost 配置里保存的颜色；非法或缺省时走推导。
+		* @param seed - 推导种子，通常用 PeerHost 名称；同一名称始终得到同一颜色。
+		* @returns `#rrggbb` 形式的小写颜色。
+		*/
+		function resolvePeerHostColor(explicit, seed) {
+			const configured = require_primitives_adapter.normalizePeerHostColor(explicit);
+			if (configured !== null) return configured;
+			const key = seed.trim() === "" ? "peer-host" : seed.trim();
+			const cached = derivedCache.get(key);
+			if (cached !== void 0) return cached;
+			const color = FALLBACK_PALETTE[hashString(key) % FALLBACK_PALETTE.length];
+			derivedCache.set(key, color);
+			return color;
+		}
+		/** FNV-1a 32 位哈希；只用于选色，不需要密码学强度。 */
+		function hashString(value) {
+			let hash = 2166136261;
+			for (let index = 0; index < value.length; index += 1) {
+				hash ^= value.charCodeAt(index);
+				hash = Math.imul(hash, 16777619) >>> 0;
+			}
+			return hash >>> 0;
+		}
+		/** 标签胶囊的底色：与归档面板 Agent 徽标保持同一种 `color-mix` 写法。 */
+		function peerHostTagBackground(color) {
+			return `color-mix(in srgb, ${color} 16%, transparent)`;
+		}
+		/** 标签文字色；直接使用配置色，保证明暗主题下都有足够对比。 */
+		function peerHostTagForeground(color) {
+			return color;
+		}
+		/** 工作区列表与关联项目表共用的 Host 胶囊标签基础样式。 */
+		function peerHostTagStyle(color) {
+			return {
+				boxSizing: "border-box",
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap",
+				padding: "1px 6px",
+				borderRadius: "999px",
+				fontSize: "10px",
+				lineHeight: "1.5",
+				pointerEvents: "none",
+				color: peerHostTagForeground(color),
+				background: peerHostTagBackground(color)
+			};
+		}
+		//#endregion
+		//#region src/shared/voice-diagnostics.ts
+		const allowedFields = new Set(`ownerId clientId callId requestId diagnosticId epoch sequence firstSequence lastSequence
+  action state phase backend provider model code errorName status durationMs waitMs firstAudioMs firstTextMs
+  firstSentenceMs firstPlaybackMs queueMs gapMs intervalMs maxIntervalMs processMs maxProcessMs decodeMs
+  maxDecodeMs audioMs bytes pendingBytes pending frames chunks samples sampleRate inputRate threads tokens
+  textLength systemLength messageCount toolCount count dropped stale aborted completed continuation muted
+  sourceCount contextState processor cpuPercent rssMb heapMb eventLoopMeanMs eventLoopMaxMs eventLoopP99Ms
+  realTimeFactor generationMs codecMs transportMs segment generationFrames fileIndex
+  pcmBytes headerBytes pendingAudioMs inFlightMs endpointSilenceMs cached streaming
+  webSearchAvailable searchRegistration`.split(/\s+/u));
+		function sanitizeVoiceDiagnosticFields(value) {
+			if (value === null || typeof value !== "object" || Array.isArray(value)) return {};
+			const fields = {};
+			for (const key of allowedFields) {
+				const item = value[key];
+				if (typeof item === "number" && Number.isFinite(item) || typeof item === "boolean" || item === null) fields[key] = item;
+				else if (typeof item === "string") fields[key] = item.slice(0, 160);
+			}
+			return fields;
+		}
+		function voiceDiagnosticId() {
+			return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+		}
+		function voiceDiagnosticError(error) {
+			return error instanceof Error ? error.name : "UnknownError";
+		}
+		//#endregion
+		//#region src/client/moss-voice-output.ts
+		/** 可取消的 PCM 播放器；同一轮的各段串行生成，生成与播放并行。 */
+		var MossVoiceOutput = class {
+			options;
+			context;
+			abort;
+			sources = /* @__PURE__ */ new Set();
+			sequence = 0;
+			outputDeviceId = "";
+			nextStart = 0;
+			gain;
+			muted = false;
+			volume = 1;
+			constructor(options = {}) {
+				this.options = options;
+			}
+			get outputDeviceSupported() {
+				return typeof (globalThis.AudioContext?.prototype)?.setSinkId === "function";
+			}
+			/** 在点击开始或试听时调用，保留浏览器要求的用户手势。 */
+			async prepare() {
+				if (this.context === void 0 || this.context.state === "closed") this.context = this.options.context?.() ?? new AudioContext();
+				if (this.gain === void 0) {
+					this.gain = this.context.createGain();
+					this.gain.gain.value = this.muted ? 0 : this.volume;
+					this.gain.connect(this.context.destination);
+				}
+				if (this.context.state === "suspended") await this.context.resume();
+				if (this.outputDeviceId !== "" && typeof this.context.setSinkId === "function") await this.context.setSinkId(this.outputDeviceId);
+			}
+			async setOutputDevice(id) {
+				if (!this.outputDeviceSupported) throw new Error("当前浏览器不支持 MOSS 播放设备选择");
+				if (this.context !== void 0) await this.context.setSinkId(id);
+				this.outputDeviceId = id;
+			}
+			/** 输出静音不中断推理或时间线，恢复后继续听当前播报。 */
+			setMuted(muted) {
+				this.muted = muted;
+				if (this.gain !== void 0) this.gain.gain.value = muted ? 0 : this.volume;
+			}
+			async speak(text, voiceId, onStart, parameters) {
+				this.cancel();
+				const sequence = this.sequence;
+				if (!await this.append(text, voiceId, onStart, parameters) || sequence !== this.sequence) return false;
+				return this.finish();
+			}
+			/** 由文本队列串行调用；收到生成结束即可提交下一段，不取消仍在播放的前一段。 */
+			async append(text, voiceId, onStart, parameters) {
+				const started = performance.now();
+				const diagnosticId = voiceDiagnosticId();
+				const fields = {
+					...this.options.traceContext?.(),
+					diagnosticId,
+					textLength: text.length
+				};
+				const trace = (event, metrics) => this.options.trace?.(`client.tts.${event}`, {
+					...fields,
+					...metrics
+				});
+				let chunks = 0;
+				let audioMs = 0;
+				let lastChunkAt = started;
+				const playback = require_manager.readAssistantTtsParameters(parameters);
+				const sequence = this.sequence;
+				const continuation = this.abort !== void 0;
+				const abort = this.abort ?? new AbortController();
+				this.abort = abort;
+				const readerSignal = abort.signal;
+				trace("start", { continuation });
+				try {
+					await this.prepare();
+					if (readerSignal.aborted) return false;
+					const queueStarted = performance.now();
+					await this.waitUntil(() => this.sources.size === 0 || this.nextStart - this.context.currentTime <= 5, readerSignal);
+					if (readerSignal.aborted) return false;
+					trace("queue_ready", {
+						waitMs: performance.now() - queueStarted,
+						queueMs: Math.max(0, this.nextStart - this.context.currentTime) * 1e3
+					});
+					this.volume = playback.volume;
+					this.gain.gain.value = this.muted ? 0 : this.volume;
+					const response = await (this.options.fetch ?? globalThis.fetch)(new URL(require_manager.ASSISTANT_TTS_PATH, globalThis.location?.origin ?? "http://localhost"), {
+						method: "POST",
+						credentials: "same-origin",
+						signal: readerSignal,
+						headers: {
+							"content-type": "application/json",
+							accept: "application/x-ndjson"
+						},
+						body: JSON.stringify({
+							text,
+							parameters: playback,
+							diagnosticId,
+							...voiceId === void 0 ? {} : { voiceId },
+							...fields.requestId === void 0 ? {} : { requestId: fields.requestId },
+							...fields.ownerId === void 0 ? {} : { ownerId: fields.ownerId }
+						})
+					});
+					trace("headers", {
+						status: response.status,
+						durationMs: performance.now() - started
+					});
+					if (!response.ok) {
+						const value = await response.json().catch(() => ({}));
+						throw new Error(typeof value.error === "string" ? value.error : `Host TTS 请求失败（${response.status}）`);
+					}
+					if (response.body === null) throw new Error("Host TTS 响应缺少音频流");
+					const reader = response.body.getReader();
+					const decoder = new TextDecoder();
+					let buffer = "";
+					let completed = false;
+					let played = false;
+					try {
+						while (true) {
+							const next = await reader.read();
+							if (readerSignal.aborted) return false;
+							if (next.done) break;
+							buffer += decoder.decode(next.value, { stream: true });
+							if (buffer.length > 2097152) throw new Error("Host TTS 音频事件过大");
+							let boundary = buffer.indexOf("\n");
+							while (boundary >= 0) {
+								const line = buffer.slice(0, boundary).trim();
+								buffer = buffer.slice(boundary + 1);
+								if (line !== "") {
+									const event = JSON.parse(line);
+									if (completed) throw new Error("Host TTS 在完成后继续返回音频");
+									if (event.type === "error") throw new Error(String(event.message));
+									if (event.type === "done") completed = true;
+									else if (event.type === "audio") {
+										const arrived = performance.now();
+										if (chunks === 0) trace("first_audio", { firstAudioMs: arrived - started });
+										const samples = decodeMossPcm(event);
+										const decodeMs = performance.now() - arrived;
+										chunks++;
+										audioMs += samples.length / Number(event.sampleRate) * 1e3;
+										trace("chunk", {
+											chunks,
+											decodeMs,
+											samples: samples.length,
+											audioMs: samples.length / Number(event.sampleRate) * 1e3,
+											intervalMs: arrived - lastChunkAt,
+											queueMs: Math.max(0, this.nextStart - this.context.currentTime) * 1e3
+										});
+										lastChunkAt = arrived;
+										if (!played && continuation) this.nextStart += playback.segmentPauseMs / 1e3;
+										await this.waitUntil(() => this.sources.size === 0 || this.nextStart - this.context.currentTime <= 5, readerSignal);
+										if (readerSignal.aborted) return false;
+										this.enqueue(samples, Number(event.sampleRate), playback.rate, trace, chunks === 1 && !continuation);
+										if (!played) {
+											played = true;
+											onStart?.();
+										}
+									} else throw new Error("Host TTS 返回未知事件");
+								}
+								boundary = buffer.indexOf("\n");
+							}
+						}
+					} finally {
+						await reader.cancel().catch(() => void 0);
+						reader.releaseLock();
+					}
+					if (!completed || !played || buffer.trim() !== "") throw new Error("Host TTS 音频流未完整结束");
+					trace("generated", {
+						durationMs: performance.now() - started,
+						chunks,
+						audioMs,
+						realTimeFactor: audioMs > 0 ? (performance.now() - started) / audioMs : 0
+					});
+					return !readerSignal.aborted && sequence === this.sequence;
+				} catch (error) {
+					trace("error", {
+						aborted: readerSignal.aborted,
+						durationMs: performance.now() - started,
+						errorName: voiceDiagnosticError(error)
+					});
+					if (readerSignal.aborted || sequence !== this.sequence) return false;
+					this.cancel();
+					throw error;
+				}
+			}
+			/** 文本队列耗尽后再等音频播完；取消旧轮次不会误清理新轮次的请求。 */
+			async finish() {
+				const abort = this.abort;
+				if (abort === void 0) return true;
+				const sequence = this.sequence;
+				await this.waitUntil(() => this.sources.size === 0, abort.signal);
+				if (this.abort === abort) this.abort = void 0;
+				return !abort.signal.aborted && sequence === this.sequence;
+			}
+			cancel() {
+				this.sequence++;
+				this.abort?.abort();
+				this.abort = void 0;
+				for (const source of this.sources) {
+					source.onended = null;
+					try {
+						source.stop();
+					} catch {}
+					source.disconnect();
+				}
+				this.sources.clear();
+				this.nextStart = 0;
+			}
+			dispose() {
+				this.cancel();
+				this.gain?.disconnect();
+				this.gain = void 0;
+				const context = this.context;
+				this.context = void 0;
+				context?.close().catch(() => void 0);
+			}
+			enqueue(samples, sampleRate, rate, trace, first) {
+				const context = this.context;
+				if (this.nextStart - context.currentTime > 30) throw new Error("MOSS 播放队列过长，请缩短文本");
+				const buffer = context.createBuffer(1, samples.length, sampleRate);
+				buffer.copyToChannel(samples, 0);
+				const source = context.createBufferSource();
+				source.buffer = buffer;
+				source.playbackRate.value = rate;
+				source.connect(this.gain);
+				source.onended = () => {
+					this.sources.delete(source);
+					source.disconnect();
+				};
+				this.sources.add(source);
+				const start = Math.max(context.currentTime + .02, this.nextStart);
+				trace("playback_scheduled", {
+					gapMs: this.nextStart > 0 ? Math.max(0, context.currentTime - this.nextStart) * 1e3 : 0,
+					queueMs: (start - context.currentTime) * 1e3,
+					sourceCount: this.sources.size,
+					contextState: context.state,
+					muted: this.muted
+				});
+				if (first) trace("first_playback_scheduled", { queueMs: (start - context.currentTime) * 1e3 });
+				source.start(start);
+				this.nextStart = start + buffer.duration / rate;
+			}
+			async waitUntil(ready, signal) {
+				if (ready() || signal.aborted) return;
+				await new Promise((resolve) => {
+					let timer;
+					const finish = () => {
+						if (timer !== void 0) clearTimeout(timer);
+						signal.removeEventListener("abort", finish);
+						resolve();
+					};
+					const check = () => {
+						if (signal.aborted || ready()) finish();
+						else timer = setTimeout(check, 30);
+					};
+					signal.addEventListener("abort", finish, { once: true });
+					check();
+				});
+			}
+		};
+		/** PCM 固定为 48kHz、单声道、16 位小端，与 Host 工作进程协议一致。 */
+		function decodeMossPcm(event) {
+			if (event.sampleRate !== 48e3 || typeof event.data !== "string" || event.data.length > 1048576) throw new Error("Host TTS PCM 格式无效");
+			const raw = atob(event.data);
+			if (raw.length === 0 || raw.length % 2 !== 0) throw new Error("Host TTS PCM 长度无效");
+			const samples = new Float32Array(raw.length / 2);
+			for (let index = 0; index < samples.length; index++) {
+				const value = raw.charCodeAt(index * 2) | raw.charCodeAt(index * 2 + 1) << 8;
+				samples[index] = (value >= 32768 ? value - 65536 : value) / 32768;
+			}
+			return samples;
+		}
+		//#endregion
+		Object.defineProperty(exports, "MossVoiceOutput", {
+			enumerable: true,
+			get: function() {
+				return MossVoiceOutput;
+			}
+		});
+		Object.defineProperty(exports, "peerHostTagStyle", {
+			enumerable: true,
+			get: function() {
+				return peerHostTagStyle;
+			}
+		});
+		Object.defineProperty(exports, "resolvePeerHostColor", {
+			enumerable: true,
+			get: function() {
+				return resolvePeerHostColor;
+			}
+		});
+		Object.defineProperty(exports, "sanitizeVoiceDiagnosticFields", {
+			enumerable: true,
+			get: function() {
+				return sanitizeVoiceDiagnosticFields;
+			}
+		});
+		Object.defineProperty(exports, "voiceDiagnosticError", {
+			enumerable: true,
+			get: function() {
+				return voiceDiagnosticError;
+			}
+		});
+		Object.defineProperty(exports, "voiceDiagnosticId", {
+			enumerable: true,
+			get: function() {
+				return voiceDiagnosticId;
+			}
+		});
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.moss-voice-output.js.map

package/data/build/dist/client/client.moss-voice-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.moss-voice-output.js","names":["normalizePeerHostColor","readAssistantTtsParameters","ASSISTANT_TTS_PATH"],"sources":["../../../../src/client/peer-host-color.ts","../../../../src/shared/voice-diagnostics.ts","../../../../src/client/moss-voice-output.ts"],"sourcesContent":["import { normalizePeerHostColor } from '../shared/contracts/peer-host.js'\nimport type { CSSProperties } from 'react'\n\n/**\n * 工作区标签配色的推导与缓存。\n *\n * 用户在 PeerHost 管理里显式配置的颜色优先；没有配置时按 Host 名称推导一个稳定\n * 颜色，保证同一台机器在多次刷新、多个工作区之间颜色一致——颜色本身是识别手段，\n * 随机色会让标签失去意义。\n */\n\n/** 无显式配色时使用的候选色板；与 PEER_HOST_COLOR_PRESETS 保持同一组观感。 */\nconst FALLBACK_PALETTE = [\n  '#1677ff',\n  '#722ed1',\n  '#13c2c2',\n  '#52c41a',\n  '#fa8c16',\n  '#eb2f96',\n  '#f5222d',\n  '#8c8c8c',\n] as const\n\nconst derivedCache = new Map<string, string>()\n\n/**\n * 解析某台 Host 的工作区标签颜色。\n *\n * @param explicit - 用户在 PeerHost 配置里保存的颜色；非法或缺省时走推导。\n * @param seed - 推导种子，通常用 PeerHost 名称；同一名称始终得到同一颜色。\n * @returns `#rrggbb` 形式的小写颜色。\n */\nexport function resolvePeerHostColor(explicit: string | null | undefined, seed: string): string {\n  const configured = normalizePeerHostColor(explicit)\n  if (configured !== null) return configured\n  const key = seed.trim() === '' ? 'peer-host' : seed.trim()\n  const cached = derivedCache.get(key)\n  if (cached !== undefined) return cached\n  const color = FALLBACK_PALETTE[hashString(key) % FALLBACK_PALETTE.length]!\n  derivedCache.set(key, color)\n  return color\n}\n\n/** FNV-1a 32 位哈希；只用于选色，不需要密码学强度。 */\nfunction hashString(value: string): number {\n  let hash = 0x811c9dc5\n  for (let index = 0; index < value.length; index += 1) {\n    hash ^= value.charCodeAt(index)\n    hash = Math.imul(hash, 0x01000193) >>> 0\n  }\n  return hash >>> 0\n}\n\n/** 标签胶囊的底色：与归档面板 Agent 徽标保持同一种 `color-mix` 写法。 */\nexport function peerHostTagBackground(color: string): string {\n  return `color-mix(in srgb, ${color} 16%, transparent)`\n}\n\n/** 标签文字色；直接使用配置色，保证明暗主题下都有足够对比。 */\nexport function peerHostTagForeground(color: string): string {\n  return color\n}\n\n/** 工作区列表与关联项目表共用的 Host 胶囊标签基础样式。 */\nexport function peerHostTagStyle(color: string): CSSProperties {\n  return {\n    boxSizing: 'border-box',\n    overflow: 'hidden',\n    textOverflow: 'ellipsis',\n    whiteSpace: 'nowrap',\n    padding: '1px 6px',\n    borderRadius: '999px',\n    fontSize: '10px',\n    lineHeight: '1.5',\n    pointerEvents: 'none',\n    color: peerHostTagForeground(color),\n    background: peerHostTagBackground(color),\n  }\n}\n","/** 诊断只接收标量指标，禁止把音频、正文、提示词和认证信息写入日志。 */\nexport type VoiceDiagnosticFields = Readonly<Record<string, string | number | boolean | null | undefined>>\nexport type VoiceDiagnosticTrace = (event: string, fields?: VoiceDiagnosticFields) => void\nexport interface VoiceDiagnosticRecord {\n  readonly timestamp: number\n  readonly event: string\n  readonly fields: VoiceDiagnosticFields\n}\n\nconst sinks = new Set<(record: VoiceDiagnosticRecord) => void>()\nconst allowedFields = new Set(`ownerId clientId callId requestId diagnosticId epoch sequence firstSequence lastSequence\n  action state phase backend provider model code errorName status durationMs waitMs firstAudioMs firstTextMs\n  firstSentenceMs firstPlaybackMs queueMs gapMs intervalMs maxIntervalMs processMs maxProcessMs decodeMs\n  maxDecodeMs audioMs bytes pendingBytes pending frames chunks samples sampleRate inputRate threads tokens\n  textLength systemLength messageCount toolCount count dropped stale aborted completed continuation muted\n  sourceCount contextState processor cpuPercent rssMb heapMb eventLoopMeanMs eventLoopMaxMs eventLoopP99Ms\n  realTimeFactor generationMs codecMs transportMs segment generationFrames fileIndex\n  pcmBytes headerBytes pendingAudioMs inFlightMs endpointSilenceMs cached streaming\n  webSearchAvailable searchRegistration`.split(/\\s+/u))\n\nexport function sanitizeVoiceDiagnosticFields(value: unknown): VoiceDiagnosticFields {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return {}\n  const fields: Record<string, string | number | boolean | null> = {}\n  for (const key of allowedFields) {\n    const item = (value as Record<string, unknown>)[key]\n    if (typeof item === 'number' && Number.isFinite(item) || typeof item === 'boolean' || item === null) fields[key] = item as number | boolean | null\n    else if (typeof item === 'string') fields[key] = item.slice(0, 160)\n  }\n  return fields\n}\n\n/** 订阅函数异常不能进入语音业务链；未安装诊断时调用只做一次空集合检查。 */\nexport const traceVoice: VoiceDiagnosticTrace = (event, fields = {}) => {\n  if (sinks.size === 0) return\n  const record = { timestamp: Date.now(), event, fields: sanitizeVoiceDiagnosticFields(fields) }\n  for (const sink of sinks) { try { sink(record) } catch { /* 诊断失败不影响通话 */ } }\n}\n\nexport function subscribeVoiceDiagnostics(sink: (record: VoiceDiagnosticRecord) => void): () => void {\n  sinks.add(sink)\n  return () => { sinks.delete(sink) }\n}\n\nexport function voiceDiagnosticsEnabled(): boolean { return sinks.size > 0 }\n\nexport function voiceDiagnosticId(): string { return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}` }\nexport function voiceDiagnosticError(error: unknown): string { return error instanceof Error ? error.name : 'UnknownError' }\n\n/** 单调时钟计时，系统时间校准不会造成负耗时。 */\nexport async function measureVoice<T>(event: string, fields: VoiceDiagnosticFields, operation: () => Promise<T>): Promise<T> {\n  const started = performance.now()\n  traceVoice(`${event}.start`, fields)\n  try {\n    const result = await operation()\n    traceVoice(`${event}.done`, { ...fields, durationMs: performance.now() - started })\n    return result\n  } catch (error) {\n    traceVoice(`${event}.error`, { ...fields, durationMs: performance.now() - started, errorName: voiceDiagnosticError(error) })\n    throw error\n  }\n}\n","import { ASSISTANT_TTS_PATH, readAssistantTtsParameters, type AssistantTtsParameters } from '../shared/assistant-tts.js'\nimport { voiceDiagnosticId, voiceDiagnosticError, type VoiceDiagnosticTrace, type VoiceDiagnosticFields } from '../shared/voice-diagnostics.js'\n\ntype SinkAudioContext = AudioContext & { setSinkId?: (id: string) => Promise<void> }\n\n/** 可取消的 PCM 播放器；同一轮的各段串行生成，生成与播放并行。 */\nexport class MossVoiceOutput {\n  private context: SinkAudioContext | undefined\n  private abort: AbortController | undefined\n  private readonly sources = new Set<AudioBufferSourceNode>()\n  private sequence = 0\n  private outputDeviceId = ''\n  private nextStart = 0\n  private gain: GainNode | undefined\n  private muted = false\n  private volume = 1\n\n  constructor(private readonly options: { fetch?: typeof fetch; context?: () => AudioContext; trace?: VoiceDiagnosticTrace; traceContext?: () => VoiceDiagnosticFields } = {}) {}\n\n  get outputDeviceSupported(): boolean { return typeof (globalThis.AudioContext?.prototype as SinkAudioContext | undefined)?.setSinkId === 'function' }\n\n  /** 在点击开始或试听时调用，保留浏览器要求的用户手势。 */\n  async prepare(): Promise<void> {\n    if (this.context === undefined || this.context.state === 'closed') this.context = (this.options.context?.() ?? new AudioContext()) as SinkAudioContext\n    if (this.gain === undefined) { this.gain = this.context.createGain(); this.gain.gain.value = this.muted ? 0 : this.volume; this.gain.connect(this.context.destination) }\n    if (this.context.state === 'suspended') await this.context.resume()\n    if (this.outputDeviceId !== '' && typeof this.context.setSinkId === 'function') await this.context.setSinkId(this.outputDeviceId)\n  }\n\n  async setOutputDevice(id: string): Promise<void> {\n    if (!this.outputDeviceSupported) throw new Error('当前浏览器不支持 MOSS 播放设备选择')\n    if (this.context !== undefined) await this.context.setSinkId!(id)\n    this.outputDeviceId = id\n  }\n\n  /** 输出静音不中断推理或时间线，恢复后继续听当前播报。 */\n  setMuted(muted: boolean): void { this.muted = muted; if (this.gain !== undefined) this.gain.gain.value = muted ? 0 : this.volume }\n\n  async speak(text: string, voiceId?: string, onStart?: () => void, parameters?: Partial<AssistantTtsParameters>): Promise<boolean> {\n    this.cancel()\n    const sequence = this.sequence\n    if (!await this.append(text, voiceId, onStart, parameters) || sequence !== this.sequence) return false\n    return this.finish()\n  }\n\n  /** 由文本队列串行调用；收到生成结束即可提交下一段，不取消仍在播放的前一段。 */\n  async append(text: string, voiceId?: string, onStart?: () => void, parameters?: Partial<AssistantTtsParameters>): Promise<boolean> {\n    const started = performance.now()\n    const diagnosticId = voiceDiagnosticId()\n    const fields: VoiceDiagnosticFields = { ...this.options.traceContext?.(), diagnosticId, textLength: text.length }\n    const trace: VoiceDiagnosticTrace = (event, metrics) => this.options.trace?.(`client.tts.${event}`, { ...fields, ...metrics })\n    let chunks = 0; let audioMs = 0; let lastChunkAt = started\n    const playback = readAssistantTtsParameters(parameters)\n    const sequence = this.sequence\n    const continuation = this.abort !== undefined\n    const abort = this.abort ?? new AbortController(); this.abort = abort\n    const readerSignal = abort.signal\n    trace('start', { continuation })\n    try {\n      await this.prepare()\n      if (readerSignal.aborted) return false\n      const queueStarted = performance.now()\n      // 只提前准备有限音频；继续播放时逐步放行，仍只使用一个 Host 推理进程。\n      await this.waitUntil(() => this.sources.size === 0 || this.nextStart - this.context!.currentTime <= 5, readerSignal)\n      if (readerSignal.aborted) return false\n      trace('queue_ready', { waitMs: performance.now() - queueStarted, queueMs: Math.max(0, this.nextStart - this.context!.currentTime) * 1000 })\n      this.volume = playback.volume\n      this.gain!.gain.value = this.muted ? 0 : this.volume\n      const response = await (this.options.fetch ?? globalThis.fetch)(new URL(ASSISTANT_TTS_PATH, globalThis.location?.origin ?? 'http://localhost'), {\n        method: 'POST', credentials: 'same-origin', signal: readerSignal,\n        headers: { 'content-type': 'application/json', accept: 'application/x-ndjson' },\n        body: JSON.stringify({ text, parameters: playback, diagnosticId, ...(voiceId === undefined ? {} : { voiceId }), ...(fields.requestId === undefined ? {} : { requestId: fields.requestId }), ...(fields.ownerId === undefined ? {} : { ownerId: fields.ownerId }) }),\n      })\n      trace('headers', { status: response.status, durationMs: performance.now() - started })\n      if (!response.ok) {\n        const value = await response.json().catch(() => ({})) as { error?: unknown }\n        throw new Error(typeof value.error === 'string' ? value.error : `Host TTS 请求失败（${response.status}）`)\n      }\n      if (response.body === null) throw new Error('Host TTS 响应缺少音频流')\n      const reader = response.body.getReader(); const decoder = new TextDecoder()\n      let buffer = ''; let completed = false; let played = false\n      try {\n        while (true) {\n          const next = await reader.read()\n          if (readerSignal.aborted) return false\n          if (next.done) break\n          buffer += decoder.decode(next.value, { stream: true })\n          if (buffer.length > 2 * 1024 * 1024) throw new Error('Host TTS 音频事件过大')\n          let boundary = buffer.indexOf('\\n')\n          while (boundary >= 0) {\n            const line = buffer.slice(0, boundary).trim(); buffer = buffer.slice(boundary + 1)\n            if (line !== '') {\n              const event = JSON.parse(line) as Record<string, unknown>\n              if (completed) throw new Error('Host TTS 在完成后继续返回音频')\n              if (event.type === 'error') throw new Error(String(event.message))\n              if (event.type === 'done') completed = true\n              else if (event.type === 'audio') {\n                const arrived = performance.now()\n                if (chunks === 0) trace('first_audio', { firstAudioMs: arrived - started })\n                const samples = decodeMossPcm(event)\n                const decodeMs = performance.now() - arrived\n                chunks++; audioMs += samples.length / Number(event.sampleRate) * 1000\n                trace('chunk', { chunks, decodeMs, samples: samples.length, audioMs: samples.length / Number(event.sampleRate) * 1000, intervalMs: arrived - lastChunkAt, queueMs: Math.max(0, this.nextStart - this.context!.currentTime) * 1000 })\n                lastChunkAt = arrived\n                if (!played && continuation) this.nextStart += playback.segmentPauseMs / 1000\n                await this.waitUntil(() => this.sources.size === 0 || this.nextStart - this.context!.currentTime <= 5, readerSignal)\n                if (readerSignal.aborted) return false\n                this.enqueue(samples, Number(event.sampleRate), playback.rate, trace, chunks === 1 && !continuation)\n                if (!played) { played = true; onStart?.() }\n              } else throw new Error('Host TTS 返回未知事件')\n            }\n            boundary = buffer.indexOf('\\n')\n          }\n        }\n      } finally { await reader.cancel().catch(() => undefined); reader.releaseLock() }\n      if (!completed || !played || buffer.trim() !== '') throw new Error('Host TTS 音频流未完整结束')\n      trace('generated', { durationMs: performance.now() - started, chunks, audioMs, realTimeFactor: audioMs > 0 ? (performance.now() - started) / audioMs : 0 })\n      return !readerSignal.aborted && sequence === this.sequence\n    } catch (error) {\n      trace('error', { aborted: readerSignal.aborted, durationMs: performance.now() - started, errorName: voiceDiagnosticError(error) })\n      if (readerSignal.aborted || sequence !== this.sequence) return false\n      this.cancel()\n      throw error\n    }\n  }\n\n  /** 文本队列耗尽后再等音频播完；取消旧轮次不会误清理新轮次的请求。 */\n  async finish(): Promise<boolean> {\n    const abort = this.abort\n    if (abort === undefined) return true\n    const sequence = this.sequence\n    await this.waitUntil(() => this.sources.size === 0, abort.signal)\n    if (this.abort === abort) this.abort = undefined\n    return !abort.signal.aborted && sequence === this.sequence\n  }\n\n  cancel(): void {\n    this.sequence++; this.abort?.abort(); this.abort = undefined\n    for (const source of this.sources) { source.onended = null; try { source.stop() } catch { /* 已经播放完 */ } source.disconnect() }\n    this.sources.clear(); this.nextStart = 0\n  }\n\n  dispose(): void { this.cancel(); this.gain?.disconnect(); this.gain = undefined; const context = this.context; this.context = undefined; void context?.close().catch(() => undefined) }\n\n  private enqueue(samples: Float32Array, sampleRate: number, rate: number, trace: VoiceDiagnosticTrace, first: boolean): void {\n    const context = this.context!\n    // 最多保留 30 秒待播音频，让异常快速生成也不能无限积压浏览器内存。\n    if (this.nextStart - context.currentTime > 30) throw new Error('MOSS 播放队列过长，请缩短文本')\n    const buffer = context.createBuffer(1, samples.length, sampleRate)\n    buffer.copyToChannel(samples as Float32Array<ArrayBuffer>, 0)\n    const source = context.createBufferSource(); source.buffer = buffer; source.playbackRate.value = rate; source.connect(this.gain!)\n    source.onended = () => { this.sources.delete(source); source.disconnect() }\n    this.sources.add(source)\n    const start = Math.max(context.currentTime + 0.02, this.nextStart)\n    const gapMs = this.nextStart > 0 ? Math.max(0, context.currentTime - this.nextStart) * 1000 : 0\n    trace('playback_scheduled', { gapMs, queueMs: (start - context.currentTime) * 1000, sourceCount: this.sources.size, contextState: context.state, muted: this.muted })\n    if (first) trace('first_playback_scheduled', { queueMs: (start - context.currentTime) * 1000 })\n    // 后一块按实际变速后的时长接续，避免调快时留空隙、调慢时相互重叠。\n    source.start(start); this.nextStart = start + buffer.duration / rate\n  }\n\n  private async waitUntil(ready: () => boolean, signal: AbortSignal): Promise<void> {\n    if (ready() || signal.aborted) return\n    await new Promise<void>((resolve) => {\n      let timer: ReturnType<typeof setTimeout> | undefined\n      const finish = (): void => { if (timer !== undefined) clearTimeout(timer); signal.removeEventListener('abort', finish); resolve() }\n      const check = (): void => { if (signal.aborted || ready()) finish(); else timer = setTimeout(check, 30) }\n      signal.addEventListener('abort', finish, { once: true }); check()\n    })\n  }\n}\n\n/** PCM 固定为 48kHz、单声道、16 位小端，与 Host 工作进程协议一致。 */\nexport function decodeMossPcm(event: Record<string, unknown>): Float32Array {\n  if (event.sampleRate !== 48_000 || typeof event.data !== 'string' || event.data.length > 1024 * 1024) throw new Error('Host TTS PCM 格式无效')\n  const raw = atob(event.data)\n  if (raw.length === 0 || raw.length % 2 !== 0) throw new Error('Host TTS PCM 长度无效')\n  const samples = new Float32Array(raw.length / 2)\n  for (let index = 0; index < samples.length; index++) {\n    const value = raw.charCodeAt(index * 2) | raw.charCodeAt(index * 2 + 1) << 8\n    samples[index] = (value >= 32768 ? value - 65536 : value) / 32768\n  }\n  return samples\n}\n"],"mappings":"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"}

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

@@ -7,21 +7,15 @@ window.__ModuleLoader__.load({
 		const require_assistant_notifications = require("@jingyi0605/codingns4dsh/client.assistant-notifications.js");
 		const require_session_translation = require("@jingyi0605/codingns4dsh/client.session-translation.js");
 		//#region src/shared/contracts/version.ts
-		/** 当前经过完整验证的 DSH 版本；源文件由根目录 version.json 同步。 */
-		const DSH_VERSION = "0.2.1-alpha.2";
+		/** DSH verification target, synchronized with the root version.json. */
+		const DSH_VERSION = "0.2.1-rc.2";
 		/**
-		* 插件正式验证的 DSH 版本范围，覆盖 rc.2 到当前验证的 alpha.2。
-		*
-		* 0.2.0-rc.2、0.2.1-alpha.1 与 0.2.1-alpha.2 属于同一 API 世代：插件直接消费的
-		* 20 个宿主包中 18 个接口面未变，会话格式仍为 v4。唯一的服务级破坏性变化是
-		* alpha.2 用 `subagents.startActivation()` 取代 `startContinuable()`，由
-		* `subagent.activation` / `subagent.continuable` 两条能力路由分别探测，业务侧
-		* 经 `startNativeSubagent()` 归一化调用，因此同一个版本范围仍然成立。
-		*
-		* 这里保留明确上界，是为了让 npm/DSH 安装期也能识别 0.2.1-alpha.2 这个跨 patch
-		* 预发布版本；出现新的 API 世代或结构变化时，应重新验证并更新范围与能力路由。
+		* Supported hosts retain the 0.2.0-rc.2 floor and include 0.2.1-rc.2.
+		* Capability adapters preserve earlier subagent, peer and message contracts.
+		* Keep an explicit upper bound: a later prerelease requires verification before
+		* either installation checks or runtime capability selection may accept it.
 		*/
-		const DSH_COMPATIBILITY = ">=0.2.0-rc.2 <=0.2.1-alpha.2";
+		const DSH_COMPATIBILITY = ">=0.2.0-rc.2 <=0.2.1-rc.2";
 		/**
 		* 兼容范围下界，即插件仍然接受的最低 DSH 版本。
 		*
@@ -30,7 +24,7 @@ window.__ModuleLoader__.load({
 		* “不支持的 DSH 版本”，把仅仅缺少启动页注入的页面误判为宿主不兼容。
 		*/
 		function minimumSupportedDshVersion() {
-			return /^>=([^ ]+)/u.exec(">=0.2.0-rc.2 <=0.2.1-alpha.2")?.[1] ?? "0.2.1-alpha.2";
+			return /^>=([^ ]+)/u.exec(">=0.2.0-rc.2 <=0.2.1-rc.2")?.[1] ?? "0.2.1-rc.2";
 		}
 		/** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
 		const CODINGNS_DSH_VERSION_GLOBAL = "__CODINGNS_DSH_VERSION__";
@@ -39,7 +33,7 @@ window.__ModuleLoader__.load({
 			return /^0\.1\.5(?:-|$)/u.test(version);
 		}
 		/** Codingns4DSH 插件自身的 npm 版本。 */
-		const CODINGNS_VERSION = "0.2.1-beta.9";
+		const CODINGNS_VERSION = "0.2.1-rc.2";
 		/** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内；范围省略上界时不校验上限。 */
 		function isDshVersionCompatible(version) {
 			const match = /^>=([^ ]+)(?: <=([^ ]+))?$/u.exec(DSH_COMPATIBILITY);
@@ -97,6 +91,36 @@ window.__ModuleLoader__.load({
 			return 0;
 		}
 		//#endregion
+		//#region src/shared/contracts/git.ts
+		const DEFAULT_GIT_MANAGEMENT_SETTINGS = {
+			commitMessageEnabled: true,
+			commitMessageDetail: "concise",
+			commitMessageModels: [],
+			commitMessagePrompt: ""
+		};
+		const MAX_GIT_COMMIT_MESSAGE_CHARS = 1e4;
+		const MAX_GIT_COMMIT_PROMPT_CHARS = 1e4;
+		function normalizeGitManagementSettings(value) {
+			const seen = /* @__PURE__ */ new Set();
+			return {
+				commitMessageEnabled: value?.commitMessageEnabled !== false,
+				commitMessageDetail: value?.commitMessageDetail === "detailed" ? "detailed" : "concise",
+				commitMessagePrompt: typeof value?.commitMessagePrompt === "string" ? value.commitMessagePrompt : "",
+				commitMessageModels: (value?.commitMessageModels ?? []).flatMap((item) => {
+					const provider = item?.provider?.trim();
+					const model = item?.model?.trim();
+					if (!provider || !model) return [];
+					const key = JSON.stringify([provider, model]);
+					if (seen.has(key)) return [];
+					seen.add(key);
+					return [{
+						provider,
+						model
+					}];
+				})
+			};
+		}
+		//#endregion
 		//#region src/shared/contracts/config.ts
 		const DEFAULT_ASSISTANT_VOICE_SETTINGS = {
 			initialized: false,
@@ -285,6 +309,7 @@ window.__ModuleLoader__.load({
 		const CODINGNS_MOBILE_ACCESS_FIELD = "mobileAccess";
 		const CODINGNS_SUBSCRIPTION_USAGE_FIELD = "subscriptionUsage";
 		const CODINGNS_SESSION_TRANSLATION_FIELD = "sessionTranslation";
+		const CODINGNS_GIT_MANAGEMENT_FIELD = "gitManagement";
 		const CODINGNS_ASSISTANT_FIELD = "assistant";
 		const DEFAULT_CODINGNS_CONTROL_BASE_URL = "https://channel.codingns.com:1443";
 		const DEFAULT_CODINGNS_CONTROL_BASE_URLS = [DEFAULT_CODINGNS_CONTROL_BASE_URL];
@@ -329,6 +354,7 @@ window.__ModuleLoader__.load({
 			agentAdapterPreferences: {},
 			subagentBridge: DEFAULT_SUBAGENT_BRIDGE_SETTINGS,
 			sessionTranslation: require_session_translation.DEFAULT_SESSION_TRANSLATION_SETTINGS,
+			gitManagement: DEFAULT_GIT_MANAGEMENT_SETTINGS,
 			terminalEnhancement: DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS,
 			workspaceSessionEnhancement: DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS,
 			fileManagement: DEFAULT_FILE_MANAGEMENT_SETTINGS,
@@ -485,6 +511,12 @@ window.__ModuleLoader__.load({
 				return CODINGNS_FILE_MANAGEMENT_FIELD;
 			}
 		});
+		Object.defineProperty(exports, "CODINGNS_GIT_MANAGEMENT_FIELD", {
+			enumerable: true,
+			get: function() {
+				return CODINGNS_GIT_MANAGEMENT_FIELD;
+			}
+		});
 		Object.defineProperty(exports, "CODINGNS_H5_LOGIN_URL", {
 			enumerable: true,
 			get: function() {
@@ -629,6 +661,18 @@ window.__ModuleLoader__.load({
 				return DSH_VERSION;
 			}
 		});
+		Object.defineProperty(exports, "MAX_GIT_COMMIT_MESSAGE_CHARS", {
+			enumerable: true,
+			get: function() {
+				return MAX_GIT_COMMIT_MESSAGE_CHARS;
+			}
+		});
+		Object.defineProperty(exports, "MAX_GIT_COMMIT_PROMPT_CHARS", {
+			enumerable: true,
+			get: function() {
+				return MAX_GIT_COMMIT_PROMPT_CHARS;
+			}
+		});
 		Object.defineProperty(exports, "MOBILE_VIEWPORT_MAX_PX_LIMITS", {
 			enumerable: true,
 			get: function() {
@@ -701,6 +745,12 @@ window.__ModuleLoader__.load({
 				return minimumSupportedDshVersion;
 			}
 		});
+		Object.defineProperty(exports, "normalizeGitManagementSettings", {
+			enumerable: true,
+			get: function() {
+				return normalizeGitManagementSettings;
+			}
+		});
 		Object.defineProperty(exports, "normalizeLanAccessDshPwaSettings", {
 			enumerable: true,
 			get: function() {