@kmchai/cortico-world-voice 0.1.0 → 0.2.1

package/src/world.ts

@@ -2,8 +2,8 @@
  * 语音 World:把回复念出来。
  *
  * 触发层从主 session 输出流与事件库认出要念的话;文本层过滤与切句;
- * 合成层按配置的协议适配器取音频;出口层本机播放、发事件或只返回附件。
- * 这一层不 import 任何具体 TTS 包,也不 import 唱歌插件。
+ * 合成层经 HTTP 调 Kmch AI · 服务;出口层本机播放、发事件或只返回附件。
+ * 这一层不解析任何 TTS 方言,也不监听端口。
  */
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
@@ -14,24 +14,26 @@ import type {
   Logger, ToolDef, ToolOutcome, World, WorldHost, WorldLamp, WorldWebUiDecl,
 } from 'cortico/core/types.ts';
 import { nullLogger, nowIso } from 'cortico/core/util.ts';
-import { backendOf } from './backends/index.ts';
-import { VOICE_DEFAULTS, VOICE_ID, VOICE_OPTIONS_KIND, voiceConfigGroups, voiceText } from './config.ts';
+import { VOICE_DEFAULTS, VOICE_ID, voiceConfigGroups, voiceText } from './config.ts';
 import type { AudioPlayer } from './audio/player.ts';
 import { createPlayer } from './audio/player.ts';
 import { SpeechQueue, type SpeechJob } from './audio/queue.ts';
-import { startVoiceHttp, type VoiceHttpHandle } from './http.ts';
-import { registerVoiceOptions } from './options.ts';
-import { singHealth, singRemote, singRequestOf } from './sing.ts';
+import { modelPrompt } from './models.ts';
+import { isPlainObject, type PanelModelState } from './panel.ts';
+import { ServiceClient, type SpeechService } from './service.ts';
 import { splitSpeech, truncateSpeech } from './speech/chunk.ts';
+import { buildInstruct, resolveStyle } from './speech/style.ts';
 import { filterSpeech } from './speech/text.ts';
 import { EventPoller, eventTypes, hasKeyword, latestUserText, splitList, VoiceTap } from './triggers.ts';
 import { VOICE_TOOL_DECLS } from './tools.ts';
-import type { BackendHealth, TtsAudio, TtsBackend, TtsRequest, VoiceConfigSection, VoiceOption } from './types.ts';
+import type {
+  ServiceHealth, TtsAudio, TtsRequest, VoiceConfigSection, VoiceModel,
+} from './types.ts';
 
 const ENV_PROMPT_FILE = fileURLToPath(new URL('./ENV_PROMPT.md', import.meta.url));
 const DEDUPE_WINDOW_MS = 5000;
+const HEALTH_INTERVAL_MS = 15_000;
 const HEALTH_TTL_MS = 15_000;
-const VOICES_TTL_MS = 10 * 60_000;
 
 export interface VoiceWorldDeps {
   fetch: typeof fetch;
@@ -39,8 +41,8 @@ export interface VoiceWorldDeps {
   rng(): number;
   now(): number;
   sleep(ms: number): Promise<void>;
-  /** 测试用:替换协议适配器。 */
-  backend?: TtsBackend;
+  /** 测试用:替换服务客户端。 */
+  service?: SpeechService;
 }
 
 export interface VoiceWorldOptions {
@@ -61,8 +63,12 @@ interface EnqueueOptions {
   voice?: string;
   speed?: number;
   silent?: boolean;
-  /** 不切块:唱歌与要交出去的附件要一整段。 */
-  single?: boolean;
+}
+
+interface ServiceState {
+  ok: boolean;
+  detail?: string;
+  at: number;
 }
 
 function defaultDeps(): VoiceWorldDeps {
@@ -84,6 +90,17 @@ function asNumber(value: unknown): number | undefined {
   return Number.isFinite(n) ? n : undefined;
 }
 
+/** 徽标只显示主机与端口;地址不合法时退回原串。 */
+function serviceHost(raw: string): string {
+  const value = raw.trim();
+  if (!value) return '—';
+  try {
+    return new URL(value).host || '—';
+  } catch {
+    return value;
+  }
+}
+
 /** 等一个 promise;超时返回 'timeout',不取消原任务。 */
 async function within<T>(promise: Promise<T>, ms: number): Promise<T | 'timeout'> {
   let timer: NodeJS.Timeout | undefined;
@@ -104,27 +121,29 @@ export class VoiceWorld implements World {
   private readonly player: AudioPlayer | null;
   private readonly queue: SpeechQueue;
   private readonly tap: VoiceTap;
+  private readonly service: SpeechService;
   private host: WorldHost | null = null;
-  private http: VoiceHttpHandle | null = null;
-  private httpError = '';
   private poller: EventPoller | null = null;
   private healthTimer: NodeJS.Timeout | null = null;
   private started = false;
   private tempDir = '';
   private tempSeq = 0;
-  private backendState: { ok: boolean; detail?: string; at: number } | null = null;
+  private serviceState: ServiceState | null = null;
   private probing = false;
-  private singReady = false;
-  private voices: VoiceOption[] = [];
-  private voicesAt = 0;
-  private voicesSignature = '';
-  private voicesLoading = false;
+  private catalog: VoiceModel[] | null = null;
+  private catalogError: string | undefined;
+  private catalogLoad: Promise<void> | null = null;
   private readonly lastSpoken = new Map<string, number>();
   private lastFailureAt = 0;
 
   constructor(private readonly opts: VoiceWorldOptions) {
     this.log = opts.log ?? nullLogger();
     this.deps = { ...defaultDeps(), ...opts.deps };
+    this.service = this.deps.service ?? new ServiceClient({
+      fetch: this.deps.fetch,
+      secret: (name) => this.opts.secret(name),
+      cfg: () => this.cfg,
+    });
     this.player = this.deps.createPlayer(this.log);
     this.queue = new SpeechQueue({
       player: this.player,
@@ -141,7 +160,6 @@ export class VoiceWorld implements World {
       onText: (text, source) => this.consider(text, source),
       onAbort: () => this.queue.hush(),
     });
-    registerVoiceOptions(() => this.voiceOptions());
   }
 
   private get cfg(): VoiceConfigSection {
@@ -152,11 +170,10 @@ export class VoiceWorld implements World {
     const cfg = this.cfg;
     return {
       'voice.auto': cfg.autoSpeak ? `${Math.round(cfg.autoProbability * 100)}%` : 'off',
-      'voice.backend': cfg.backend,
       'voice.voice': cfg.voice || 'default',
       'voice.emotion': cfg.defaultEmotion || 'neutral',
       'voice.instruct': cfg.defaultInstruct || 'none',
-      'voice.sing': cfg.singUrl ? 'available' : 'not configured',
+      'voice.modelPrompt': modelPrompt(cfg.model),
     };
   }
 
@@ -168,7 +185,6 @@ export class VoiceWorld implements World {
     });
     return [
       tool('voice_speak', (args) => this.handleSpeak(args)),
-      tool('voice_sing', (args) => this.handleSing(args)),
       tool('voice_hush', async () => {
         this.queue.hush();
         return 'Voice stopped; queued lines were dropped.';
@@ -182,30 +198,42 @@ export class VoiceWorld implements World {
     this.maybeRefresh();
     const cfg = this.cfg;
     const stats = this.queue.stats();
-    const backendLamp: WorldLamp = this.backendState === null
-      ? { label: t.lampBackend, state: this.started ? 'loading' : 'offline' }
-      : this.backendState.ok
-        ? { label: t.lampBackend, state: 'online', ...(this.backendState.detail ? { hint: this.backendState.detail } : {}) }
-        : { label: t.lampBackend, state: 'error', ...(this.backendState.detail ? { hint: this.backendState.detail } : {}) };
-    const apiLamp: WorldLamp = !cfg.httpApi
-      ? { label: t.lampApi, state: 'offline' }
-      : this.http
-        ? { label: t.lampApi, state: 'online', hint: `127.0.0.1:${this.http.port}` }
-        : { label: t.lampApi, state: 'error', ...(this.httpError ? { hint: this.httpError } : {}) };
+    const serviceLamp: WorldLamp = this.serviceState === null
+      ? { label: t.lampService, state: this.started ? 'loading' : 'offline' }
+      : this.serviceState.ok
+        ? { label: t.lampService, state: 'online', ...(this.serviceState.detail ? { hint: this.serviceState.detail } : {}) }
+        : { label: t.lampService, state: 'error', ...(this.serviceState.detail ? { hint: this.serviceState.detail } : {}) };
     return {
       label: t.label,
       lamps: [
-        backendLamp,
-        { label: t.lampQueue, state: stats.speaking ? 'loading' : 'online', hint: `${stats.queued}` },
-        apiLamp,
-        { label: t.lampSinger, state: cfg.singUrl ? (this.singReady ? 'online' : 'offline') : 'offline' },
+        serviceLamp,
+        {
+          label: t.lampQueue,
+          state: !this.started ? 'offline' : stats.speaking ? 'loading' : 'online',
+          hint: `${stats.queued}`,
+        },
       ],
       badges: [
+        { label: 'service', value: serviceHost(cfg.serviceUrl), tone: 'plain' },
+        { label: 'model', value: cfg.model || '—', tone: 'plain' },
         { label: 'voice', value: cfg.voice || '—', tone: 'plain' },
-        { label: 'emotion', value: cfg.defaultEmotion || '—', tone: 'plain' },
-        { label: 'queue', value: stats.queued, tone: stats.queued ? 'on' : 'plain' },
       ],
+      panels: [{ id: 'model', title: t.modelPanel, getMethods: ['state'] }],
       config: voiceConfigGroups(language),
+      links: [{ label: t.servicePage, href: '#/provider/world:service' }],
+      invoke: async (panel, method, args) => {
+        if (panel !== 'model') throw new Error(t.modelUnknownMethod);
+        switch (method) {
+          case 'state':
+            return this.modelPanelState();
+          case 'refresh':
+            return this.refreshModelPanel();
+          case 'save':
+            return this.saveModelPanel(language, args);
+          default:
+            throw new Error(t.modelUnknownMethod);
+        }
+      },
       promptDocs: [{
         key: 'worlds.voice.envPrompt',
         title: t.envTitle,
@@ -214,16 +242,114 @@ export class VoiceWorld implements World {
         role: 'envPrompt',
         vars: [
           { name: 'voice.auto', description: 'Automatic reading probability, or off.' },
-          { name: 'voice.backend', description: 'Active protocol id.' },
           { name: 'voice.voice', description: 'Current voice id.' },
           { name: 'voice.emotion', description: 'Standing emotion.' },
           { name: 'voice.instruct', description: 'Standing direction.' },
-          { name: 'voice.sing', description: 'Whether a singing service is configured.' },
+          { name: 'voice.modelPrompt', description: 'How to write text and emotion for the current model.' },
         ],
       }],
     };
   }
 
+  // ———————— 模型面板 ————————
+
+  /**
+   * 第一次读面板时拉一次目录;之后直接回缓存。刷新失败保留上一次可用的目录,
+   * 只把错误一起交回面板。
+   */
+  private async modelPanelState(): Promise<PanelModelState> {
+    if (!this.catalog) await this.loadCatalog(this.cfg.model);
+    return this.panelSnapshot();
+  }
+
+  private async refreshModelPanel(): Promise<PanelModelState> {
+    if (this.catalogLoad) await this.catalogLoad;
+    await this.loadCatalog(this.cfg.model);
+    return this.panelSnapshot();
+  }
+
+  private panelSnapshot(): PanelModelState {
+    const cfg = this.cfg;
+    const saved = cfg.modelOptions?.[cfg.model];
+    return {
+      model: cfg.model,
+      voice: cfg.voice,
+      prompt: modelPrompt(cfg.model),
+      options: isPlainObject(saved) ? { ...saved } : {},
+      models: this.catalog ?? [],
+      ...(this.catalogError ? { error: this.catalogError } : {}),
+    };
+  }
+
+  private loadCatalog(selected: string): Promise<void> {
+    if (this.catalogLoad) return this.catalogLoad;
+    this.catalogLoad = this.fetchCatalog(selected).finally(() => {
+      this.catalogLoad = null;
+    });
+    return this.catalogLoad;
+  }
+
+  /**
+   * 先取模型表,再尽力为当前模型补一次更细的音色表。模型表是权威来源,已经带
+   * 音色与参数;补音色失败只损失一次补全,不能让整份目录跟着作废。
+   */
+  private async fetchCatalog(selected: string): Promise<void> {
+    let models: VoiceModel[];
+    try {
+      models = await this.service.models();
+    } catch (error) {
+      this.catalogError = this.catalogFailure(error);
+      this.markService({ ok: false, detail: this.catalogError });
+      return;
+    }
+
+    const id = selected.trim() || this.cfg.model.trim() || models[0]?.id || '';
+    let catalog = models;
+    if (id) {
+      try {
+        const voices = await this.service.voices(id);
+        const names = [...new Set(voices.map((voice) => voice.value.trim()).filter(Boolean))];
+        if (names.length > 0) {
+          catalog = models.map((model) => (model.id === id ? { ...model, voices: names } : model));
+        }
+      } catch (error) {
+        this.log.debug('音色表读取失败,保留模型表里的音色', {
+          err: error instanceof Error ? error.message : String(error),
+        });
+      }
+    }
+
+    this.catalog = catalog;
+    this.catalogError = undefined;
+    this.markService({ ok: true });
+  }
+
+  /** 错误要回面板,但不能把配置里的服务地址(可能带令牌)一起带出去。 */
+  private catalogFailure(error: unknown): string {
+    const message = error instanceof Error ? error.message : String(error);
+    const url = this.cfg.serviceUrl.trim();
+    return url && message.includes(url) ? message.split(url).join('[service]') : message;
+  }
+
+  private saveModelPanel(language: Language, args: unknown[]): PanelModelState {
+    const t = voiceText(language);
+    const raw = args[0];
+    if (!isPlainObject(raw)) throw new Error(t.modelSaveShape);
+    const model = typeof raw.model === 'string' ? raw.model.trim() : '';
+    if (!model) throw new Error(t.modelSaveModel);
+    if (typeof raw.voice !== 'string') throw new Error(t.modelSaveVoice);
+    if (!isPlainObject(raw.options)) throw new Error(t.modelSaveOptions);
+
+    const next: VoiceConfigSection['modelOptions'] = { ...(this.cfg.modelOptions ?? {}) };
+    // 空对象表示删掉这个模型的条目,回到服务的默认参数。
+    if (Object.keys(raw.options).length === 0) delete next[model];
+    else next[model] = { ...raw.options };
+    // 配置层对对象做深合并,删掉的键不会随 patch 传播;先让活引用指向新对象再写盘。
+    this.cfg.modelOptions = next;
+    this.opts.persist({ model, voice: raw.voice.trim(), modelOptions: next });
+    return this.panelSnapshot();
+  }
+
   outputTap() {
     const cfg = this.cfg;
     if (!cfg.autoSpeak) return undefined;
@@ -235,7 +361,7 @@ export class VoiceWorld implements World {
     this.host = host;
     this.started = true;
     this.log.info('语音 World 启动', {
-      backend: this.cfg.backend,
+      service: serviceHost(this.cfg.serviceUrl),
       playback: this.cfg.playback,
       auto: this.cfg.autoSpeak ? this.cfg.autoProbability : 'off',
     });
@@ -244,10 +370,9 @@ export class VoiceWorld implements World {
         this.log.warn('播放器预热失败', { err: error instanceof Error ? error.message : String(error) });
       });
     }
-    if (this.cfg.httpApi) await this.startHttp();
     this.syncPoller();
     void this.probe();
-    this.healthTimer = setInterval(() => { void this.probe(); }, HEALTH_TTL_MS * 2);
+    this.healthTimer = setInterval(() => { void this.probe(); }, HEALTH_INTERVAL_MS);
     this.healthTimer.unref?.();
   }
 
@@ -257,9 +382,6 @@ export class VoiceWorld implements World {
     this.healthTimer = null;
     this.poller?.stop();
     this.poller = null;
-    const http = this.http;
-    this.http = null;
-    if (http) await http.close().catch(() => {});
     await this.queue.close();
     if (this.tempDir) {
       try { rmSync(this.tempDir, { recursive: true, force: true }); } catch { /* 临时目录 */ }
@@ -286,13 +408,6 @@ export class VoiceWorld implements World {
     const cfg = this.cfg;
     if (!cfg.autoSpeak) return;
 
-    // 唱歌标记是显式的,不掷概率。没配唱歌服务时按普通文本念。
-    const sing = singRequestOf(raw);
-    if (sing.marked && cfg.singUrl.trim()) {
-      if (sing.lyrics && this.fresh(sing.lyrics)) this.enqueueSing(sing.lyrics, source);
-      return;
-    }
-
     const filtered = filterSpeech(raw, cfg);
     if (!filtered.text) return;
 
@@ -310,31 +425,11 @@ export class VoiceWorld implements World {
     this.log.debug('自动朗读', { source, explicit, chars: [...filtered.text].length });
   }
 
-  private enqueueSing(lyrics: string, source: string): void {
-    const cfg = this.cfg;
-    if (!cfg.singUrl.trim()) return;
-    this.queue.enqueue({
-      text: lyrics,
-      chunks: [lyrics],
-      silent: cfg.playback === 'none',
-      source,
-      produce: (chunk, signal) => singRemote({
-        url: cfg.singUrl,
-        token: cfg.singToken,
-        lyrics: chunk,
-        timeoutMs: Math.max(cfg.timeoutMs, 180_000),
-        fetch: this.deps.fetch,
-        signal,
-      }),
-    });
-    this.log.info('自动唱歌', { source, chars: [...lyrics].length });
-  }
-
   private enqueue(text: string, opts: EnqueueOptions): ReturnType<SpeechQueue['enqueue']> | null {
     const cfg = this.cfg;
     const clipped = truncateSpeech(text, cfg.maxChars);
     if ([...clipped].length < Math.max(1, cfg.minChars)) return null;
-    const chunks = opts.single ? [clipped] : splitSpeech(clipped, cfg.chunkMax);
+    const chunks = splitSpeech(clipped, cfg.chunkMax);
     if (chunks.length === 0) return null;
     const job: SpeechJob = {
       text: clipped,
@@ -403,73 +498,6 @@ export class VoiceWorld implements World {
     return this.spokenOutcome(undefined, 0, false);
   }
 
-  private async handleSing(args: Record<string, unknown>): Promise<ToolOutcome> {
-    const { lyrics } = singRequestOf(asString(args.lyrics));
-    if (!lyrics) return { text: 'voice_sing failed: there are no lyrics to sing.', failed: true };
-    if (!this.cfg.singUrl.trim()) {
-      return { text: 'voice_sing failed: no singing service is configured (worlds.voice.singUrl).', failed: true };
-    }
-    const silent = this.cfg.playback === 'none';
-    const share = this.cfg.shareAudio;
-    const timeoutMs = Math.max(this.cfg.timeoutMs, 180_000);
-    const produce = (text: string, signal: AbortSignal) => singRemote({
-      url: this.cfg.singUrl,
-      token: this.cfg.singToken,
-      lyrics: text,
-      timeoutMs,
-      fetch: this.deps.fetch,
-      signal,
-    });
-
-    // 要交附件:合成完整一首就回执,播放交给队列,不等播完。
-    if (share) {
-      const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(new Error('timeout')), timeoutMs);
-      try {
-        const audio = await produce(lyrics, controller.signal);
-        if (!silent) {
-          this.queue.enqueue({
-            text: lyrics,
-            chunks: [lyrics],
-            silent: false,
-            source: 'tool:voice_sing',
-            produce: async () => audio,
-          });
-        }
-        const outcome = this.spokenOutcome(audio, audio.seconds ?? 0, silent);
-        return { ...outcome, text: outcome.text.replace('one line', 'one sung line') };
-      } catch (error) {
-        return { text: `voice_sing failed: ${error instanceof Error ? error.message : String(error)}`, failed: true };
-      } finally {
-        clearTimeout(timer);
-      }
-    }
-
-    const job: SpeechJob = {
-      text: lyrics,
-      chunks: [lyrics],
-      silent,
-      source: 'tool:voice_sing',
-      produce,
-    };
-    const enqueued = this.queue.enqueue(job);
-    if (!silent) {
-      const first = await within(Promise.race([
-        enqueued.started.then(() => 'started' as const),
-        enqueued.done.then((r) => r),
-      ]), timeoutMs);
-      if (first === 'timeout') return { text: 'The singing service is still working; the song will play when ready.' };
-      if (first !== 'started' && !first.ok) {
-        return { text: `voice_sing failed: ${first.error ?? 'cancelled'}`, failed: true };
-      }
-      return { text: 'Singing now.' };
-    }
-    const result = await within(enqueued.done, timeoutMs + 60_000);
-    if (result === 'timeout') return { text: 'voice_sing failed: the singing service timed out.', failed: true };
-    if (!result.ok) return { text: `voice_sing failed: ${result.error ?? 'cancelled'}`, failed: true };
-    return { text: 'Sang one line without playing.' };
-  }
-
   private async handleStyle(args: Record<string, unknown>): Promise<ToolOutcome> {
     const has = (key: string): boolean => Object.prototype.hasOwnProperty.call(args, key);
     const patch: Partial<VoiceConfigSection> = {};
@@ -482,7 +510,6 @@ export class VoiceWorld implements World {
     }
     if (Object.keys(patch).length > 0) {
       this.opts.persist(patch);
-      if (patch.voice !== undefined) void this.refreshVoices(true);
       return { text: `Voice style updated. ${this.styleSummary()}` };
     }
     return { text: this.styleSummary() };
@@ -492,8 +519,7 @@ export class VoiceWorld implements World {
     const cfg = this.cfg;
     return `Voice: ${cfg.voice || 'default'}; emotion: ${cfg.defaultEmotion || 'neutral'}; `
       + `direction: ${cfg.defaultInstruct || 'none'}; speed: ${cfg.speed}; `
-      + `automatic: ${cfg.autoSpeak ? `${Math.round(cfg.autoProbability * 100)}%` : 'off'}; `
-      + `singing: ${cfg.singUrl ? 'configured' : 'not configured'}.`;
+      + `automatic: ${cfg.autoSpeak ? `${Math.round(cfg.autoProbability * 100)}%` : 'off'}.`;
   }
 
   private spokenOutcome(audio: TtsAudio | undefined, seconds: number, silent: boolean): ToolOutcome {
@@ -518,26 +544,45 @@ export class VoiceWorld implements World {
 
   // ———————— 合成与出口 ————————
 
-  private backendContext() {
-    return {
-      cfg: this.cfg,
-      secret: (name: string) => (name ? this.opts.secret(name) : ''),
-      fetch: this.deps.fetch,
-      log: this.log,
-    };
-  }
-
-  private async synthesize(text: string, style: { emotion?: string; instruct?: string; voice?: string; speed?: number }, signal: AbortSignal): Promise<TtsAudio> {
+  /**
+   * 语义字段按 emotionMode 只发一种:instruct 发指令,categorical 发情绪,
+   * basic 发语速,tags/none 不发;voice/model/format 每次都带。
+   */
+  private async synthesize(
+    text: string,
+    style: { emotion?: string; instruct?: string; voice?: string; speed?: number },
+    signal: AbortSignal,
+  ): Promise<TtsAudio> {
     const cfg = this.cfg;
-    const backend = this.deps.backend ?? backendOf(cfg.backend);
-    const request: TtsRequest = { text, format: cfg.format, signal, ...style };
+    const resolved = resolveStyle(cfg, style);
+    const request: TtsRequest = {
+      text,
+      format: cfg.format,
+      signal,
+      ...(style.voice ? { voice: style.voice } : {}),
+    };
+    switch (cfg.emotionMode) {
+      case 'instruct': {
+        const instruct = buildInstruct(resolved);
+        if (instruct) request.instruct = instruct;
+        break;
+      }
+      case 'categorical':
+        request.emotion = resolved.emotion || '平静';
+        break;
+      case 'basic':
+        request.speed = resolved.speed;
+        break;
+      default:
+        break;
+    }
     try {
-      const audio = await backend.synthesize(request, this.backendContext());
-      this.markBackend({ ok: true });
+      const audio = await this.service.synthesize(request, signal);
+      this.markService({ ok: true });
       return audio;
     } catch (error) {
       const detail = error instanceof Error ? error.message : String(error);
-      this.markBackend({ ok: false, detail });
+      this.markService({ ok: false, detail });
       void this.pushFailure(detail, { source: 'synthesize', chars: [...text].length });
       throw error;
     }
@@ -570,7 +615,7 @@ export class VoiceWorld implements World {
   private async pushFailure(detail: string, meta: Record<string, unknown>): Promise<void> {
     const host = this.host;
     if (!host) return;
-    // 后端长时间不可用时,自动朗读会每句都失败;事件留一条,日志照常。
+    // 服务长时间不可用时,自动朗读会每句都失败;事件留一条,日志照常。
     const now = this.deps.now();
     if (now - this.lastFailureAt < 30_000) return;
     this.lastFailureAt = now;
@@ -587,11 +632,11 @@ export class VoiceWorld implements World {
     } catch { /* 只归档,失败就只留日志 */ }
   }
 
-  // ———————— 状态、HTTP 与音色 ————————
+  // ———————— 状态 ————————
 
-  private markBackend(state: BackendHealth): void {
-    const previous = this.backendState;
-    this.backendState = { ...state, at: this.deps.now() };
+  private markService(state: Pick<ServiceState, 'ok' | 'detail'>): void {
+    const previous = this.serviceState;
+    this.serviceState = { ...state, at: this.deps.now() };
     if (previous?.ok !== state.ok) {
       if (state.ok) this.log.info('语音服务可用');
       else this.log.warn('语音服务不可用', { detail: state.detail ?? '' });
@@ -602,18 +647,13 @@ export class VoiceWorld implements World {
     if (this.probing) return;
     this.probing = true;
     try {
-      const backend = this.deps.backend ?? backendOf(this.cfg.backend);
-      const state = await backend.health(this.backendContext());
-      this.markBackend(state);
-      if (this.cfg.singUrl.trim()) this.singReady = await singHealth({
-        url: this.cfg.singUrl,
-        token: this.cfg.singToken || undefined,
-        fetch: this.deps.fetch,
+      const health: ServiceHealth = await this.service.health();
+      this.markService({
+        ok: health.ok && health.ready,
+        detail: health.detail ?? health.status,
       });
-      else this.singReady = false;
-      await this.refreshVoices();
     } catch (error) {
-      this.markBackend({ ok: false, detail: error instanceof Error ? error.message : String(error) });
+      this.markService({ ok: false, detail: error instanceof Error ? error.message : String(error) });
     } finally {
       this.probing = false;
     }
@@ -622,97 +662,9 @@ export class VoiceWorld implements World {
   private maybeRefresh(): void {
     if (!this.started) return;
     const now = this.deps.now();
-    if (!this.probing && (this.backendState === null || now - this.backendState.at > HEALTH_TTL_MS)) {
+    if (!this.probing && (this.serviceState === null || now - this.serviceState.at > HEALTH_TTL_MS)) {
       void this.probe();
     }
-    if (!this.voicesLoading && now - this.voicesAt > VOICES_TTL_MS) void this.refreshVoices();
-  }
-
-  private async refreshVoices(force = false): Promise<void> {
-    const cfg = this.cfg;
-    const signature = `${cfg.backend}|${cfg.baseUrl}|${cfg.model}`;
-    if (this.voicesLoading && !force) return;
-    if (!force && signature === this.voicesSignature && this.deps.now() - this.voicesAt < VOICES_TTL_MS) return;
-    this.voicesLoading = true;
-    try {
-      const backend = this.deps.backend ?? backendOf(cfg.backend);
-      const list = await backend.listVoices(this.backendContext());
-      if (signature !== `${this.cfg.backend}|${this.cfg.baseUrl}|${this.cfg.model}`) return;
-      this.voices = list;
-      this.voicesSignature = signature;
-      this.voicesAt = this.deps.now();
-    } catch (error) {
-      this.log.debug('音色表读取失败', { err: error instanceof Error ? error.message : String(error) });
-    } finally {
-      this.voicesLoading = false;
-    }
-  }
-
-  private voiceOptions(): VoiceOption[] {
-    const current = this.cfg.voice.trim();
-    const out = [...this.voices];
-    if (current && !out.some((v) => v.value === current)) out.unshift({ value: current, label: current });
-    return out;
-  }
-
-  private async startHttp(): Promise<void> {
-    if (this.http) return;
-    try {
-      this.http = await startVoiceHttp({
-        port: this.cfg.httpPort,
-        deps: {
-          token: () => this.cfg.httpToken,
-          status: () => ({
-            ready: this.backendState?.ok === true,
-            state: this.backendState?.detail ?? (this.backendState?.ok ? 'ready' : 'unknown'),
-            backend: backendOf(this.cfg.backend).label,
-            model: this.cfg.model,
-            voice: this.cfg.voice,
-            queue: this.queue.stats().queued,
-            sing: !!this.cfg.singUrl.trim(),
-          }),
-          synthesize: async ({ request, play }, signal) => {
-            const audio = await this.synthesize(request.text, {
-              ...(request.emotion ? { emotion: request.emotion } : {}),
-              ...(request.instruct ? { instruct: request.instruct } : {}),
-              ...(request.voice ? { voice: request.voice } : {}),
-              ...(request.speed !== undefined ? { speed: request.speed } : {}),
-            }, signal);
-            if (play || this.cfg.httpPlay) {
-              this.queue.enqueue({
-                text: request.text,
-                chunks: [request.text],
-                silent: false,
-                source: 'http',
-                produce: async () => audio,
-              });
-            }
-            return audio;
-          },
-          sing: async (lyrics, signal) => {
-            if (!this.cfg.singUrl.trim()) throw new Error('no singing service configured');
-            return singRemote({
-              url: this.cfg.singUrl,
-              token: this.cfg.singToken,
-              lyrics,
-              timeoutMs: Math.max(this.cfg.timeoutMs, 180_000),
-              fetch: this.deps.fetch,
-              signal,
-            });
-          },
-          voices: async () => {
-            await this.refreshVoices(true);
-            return this.voiceOptions();
-          },
-          log: this.log,
-        },
-      });
-      this.httpError = '';
-      this.log.info('本地语音接口已就绪', { port: this.http.port });
-    } catch (error) {
-      this.httpError = error instanceof Error ? error.message : String(error);
-      this.log.error('本地语音接口启动失败', { err: this.httpError });
-    }
   }
 
   private syncPoller(): void {
@@ -753,4 +705,4 @@ export class VoiceWorld implements World {
   }
 }
 
-export { VOICE_DEFAULTS, VOICE_ID, VOICE_OPTIONS_KIND };
+export { VOICE_DEFAULTS, VOICE_ID };