@kmchai/cortico-world-voice 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 0.2.1
+
+- 新增 World 页的「模型」面板:模型与音色在面板里选,不再占系统 Config tab 的字段。
+- 按服务 `/v1/models` 返回的参数元数据渲染字段:开关、枚举、数字与文本;IndexTTS2 的参数带中文名。
+- 模型专属参数存进 `worlds.voice.modelOptions[model]`,请求时作为 `options` 发给服务;空对象删掉该模型的条目。
+- 面板显示当前模型的提示词片段;目录缓存在进程内,服务不可达时保留上一次结果并报错。
+- 新增 `scripts/build-webui.mjs`(esbuild)与 `dist/webui.js` / `dist/webui.css`。
+
 ## 0.2.0
 
 分层:协议、进程托管与 HTTP 网关移到 `@kmchai/cortico-world-service`;语音只保留工具、概率朗读、文本过滤、情绪与标签语义、队列和本机播放,经 HTTP 调服务。

package/README.md

@@ -45,6 +45,10 @@ corepack pnpm add "D:/path/to/cortico-world-voice" --ignore-workspace
 
 `serviceUrl` 默认为 `http://127.0.0.1:9883`。`serviceTokenSecret` 填部署 `.env` 里的变量名,值只在请求时读取;服务监听非回环地址时必须配令牌。后端条目、模型 profile 与上游密钥都配在服务 World 里,见[服务包 README](https://github.com/Kmch-AI/cortico-world-service#readme)。
 
+## 模型面板
+
+World 页的「模型」tab 选模型与音色,并按服务 `/v1/models` 返回的参数元数据渲染字段。保存写进 `worlds.voice.modelOptions[model]`,合成时作为 `options` 发给服务;空参数表删掉该模型的条目。模型专属的文本与情绪写法显示在同页的「模型提示词」折叠区。系统 Config tab 只留服务地址、风格、触发、过滤与输出。
+
 ## 工具
 
 | 工具 | 作用 |
@@ -95,7 +99,7 @@ OpenAI 兼容条目把 `instructions` / `emotion` / `speed` 直接放进请求
 - 情绪来源:工具参数 > 正文里的 `[emotion:开心]` 标记 > `defaultEmotion`。
 - `voice_style` 读写长期风格(情绪、指令、音色、语速),写回 `worlds.voice`。
 - 副语言标签:`[Breathing] [Cough] [Sigh] [Laughter] [Surprise-ah] [Surprise-oh] [Dissatisfaction-hnn] [Uhm] [Confirmation-en] [Question-ei] [Question-ah] [Question-en] [Question-oh] [Question-huh]`。
-  `paralinguistic: auto` 保留标签,由服务里的模型决定演不演;`keep` 一律保留,`strip` 一律删除。表外 `[...]` 会从朗读文本里剥掉,防止被念出来。
+  `paralinguistic: auto` 只在当前模型支持标签(Ming 3.0 系)时保留,IndexTTS2 与通用模型剥掉;`keep` 一律保留,`strip` 一律删除。表外 `[...]` 会从朗读文本里剥掉,防止被念出来。
 
 ## 文本过滤
 
@@ -121,8 +125,8 @@ OpenAI 兼容条目把 `instructions` / `emotion` / `speed` 直接放进请求
 |---|---|
 | `POST /v1/audio/speech` | 合成音频;体 `{model?, input, voice?, response_format, speed?, instructions?, emotion?}`。 |
 | `GET /health` | 探活;World 页的服务灯每 15 秒刷新。 |
-| `GET /v1/models` | 模型下拉。 |
-| `GET /v1/audio/voices?model=` | 音色下拉。 |
+| `GET /v1/models` | 模型、音色与请求参数元数据。 |
+| `GET /v1/audio/voices?model=` | 当前模型的音色表。 |
 
 服务不可达时:模型与音色下拉保留上一次读到的表,服务灯变红,`voice_speak` 回失败。语音 0.2.0 不保留直连后端的回退路径。服务不重试上游,语音也不重试。
 
@@ -149,7 +153,7 @@ pnpm smoke:player out.wav                 # 本机播放器,音量 0
 pnpm smoke:chain http://127.0.0.1:9883    # 触发→过滤→经服务合成→tts.voice 全链路
 ```
 
-装进 Cortico 后应看到:World 页多一张「Kmch AI · 语音」卡,服务灯、队列灯与 `service` / `model` / `voice` 徽标;服务在线时灯亮;让 bot 调 `voice_speak` 能听见;说「念给我听」会绕过概率;`playback: event` 时时间线出现 `tts.voice`。
+装进 Cortico 后应看到:World 页多一张「Kmch AI · 语音」卡,服务灯、队列灯与 `service` / `model` / `voice` 徽标;「模型」tab 能选模型与音色、按服务参数渲染字段并保存;服务在线时灯亮;让 bot 调 `voice_speak` 能听见;说「念给我听」会绕过概率;`playback: event` 时时间线出现 `tts.voice`。
 
 ## 许可
 

package/describe.json

@@ -126,7 +126,7 @@
       "key": "worlds.voice.envPrompt",
       "title": "语音 · 环境提示词",
       "role": "envPrompt",
-      "content": "语音由 Voice 提供:它只把文字变成声音,从对方的扬声器念出来,不负责把回复发到聊天渠道;可见的回复仍然走渠道自己的发送工具。\n\n自动朗读现在是 {{voice.auto}}(音色 {{voice.voice}},情绪 {{voice.emotion}},指令 {{voice.instruct}})。自动朗读开着时,普通回复不必调用语音工具;关着时,想出声就调用 voice_speak。\n\n需要出声的时候:\n- 对方明确要语音、要你念出来、要听你的声音时,调用 voice_speak,把要念的正文放进 text。它会绕过概率,必定出声。\n- 这一句需要特定情绪、语气、音色或语速时,调用 voice_speak 并填对应参数。想让同样的语气之后一直生效,调用 voice_style;它影响之后的自动朗读。\n- 某一句只用于别的渠道(例如语音条),不要在本机播放:voice_speak 带 silent: true,音频随回执交给渠道。\n- 对方让你安静、停下时调用 voice_hush。\n\n文本规则:\n- text 只放真正要念的正文,不要放动作描写、Markdown、代码、网址或解释。\n- 可以在正文里放 [Laughter]、[Sigh]、[Breathing]、[Uhm]、[Question-ei] 这类副语言标签;模型支持时会被演出来,不会被念出字面。不确定模型是否支持时不要加,免得被原样念出来。\n- 不要把控制标记写进可见的回复正文;语音参数只放在工具调用里。\n"
+      "content": "语音由 Voice 提供:它只把文字变成声音,从对方的扬声器念出来,不负责把回复发到聊天渠道;可见的回复仍然走渠道自己的发送工具。\n\n自动朗读现在是 {{voice.auto}}(音色 {{voice.voice}},情绪 {{voice.emotion}},指令 {{voice.instruct}})。自动朗读开着时,普通回复不必调用语音工具;关着时,想出声就调用 voice_speak。\n\n需要出声的时候:\n- 对方明确要语音、要你念出来、要听你的声音时,调用 voice_speak,把要念的正文放进 text。它会绕过概率,必定出声。\n- 这一句需要特定情绪、语气、音色或语速时,调用 voice_speak 并填对应参数。想让同样的语气之后一直生效,调用 voice_style;它影响之后的自动朗读。\n- 某一句只用于别的渠道(例如语音条),不要在本机播放:voice_speak 带 silent: true,音频随回执交给渠道。\n- 对方让你安静、停下时调用 voice_hush。\n\n文本规则:\n- text 只放真正要念的正文,不要放动作描写、Markdown、代码、网址或解释。\n- {{voice.modelPrompt}}\n- 不要把控制标记写进可见的回复正文;语音参数只放在工具调用里。\n"
     }
   ]
 }

package/dist/webui.css

@@ -0,0 +1 @@
+.vx-top{display:flex;flex-wrap:wrap;align-items:end;gap:10px}.vx-pick{display:flex;flex:1 1 160px;min-width:0;flex-direction:column;gap:4px}.vx-pick-label{font:var(--text-detail)/1.2 var(--sans);color:var(--ink-soft)}.vx-pick select.field{width:100%;box-sizing:border-box}.vx-top>.btn{margin-left:auto;align-self:end}.vx-params{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px 18px;margin-top:14px}.vx-params:empty{display:none}.vx-field{display:flex;min-width:0;flex-direction:column;gap:5px}.vx-head{display:flex;align-items:baseline;gap:7px}.vx-label{font:13px/1.3 var(--sans);color:var(--ink)}.vx-name{font:11px/1.3 var(--mono);color:var(--ink-soft)}.vx-field>.field,.vx-field>label.check{width:100%;box-sizing:border-box}.vx-desc{font:12px/1.4 var(--sans);color:var(--ink-soft)}.vx-params+.actions{margin-top:14px}.vx-prompt{margin:0;padding:10px 12px;max-height:260px;overflow:auto;white-space:pre-wrap;overflow-wrap:anywhere;font:12px/1.55 var(--mono);color:var(--ink-soft);background:var(--sheet-2);border:1px solid var(--line);border-radius:8px}

package/dist/webui.js

@@ -0,0 +1 @@
+var W={zh:{title:"\u6A21\u578B",model:"\u6A21\u578B",voice:"\u97F3\u8272",refresh:"\u5237\u65B0",save:"\u4FDD\u5B58",saved:"\u5DF2\u4FDD\u5B58",loading:"\u8BFB\u53D6\u4E2D\u2026",promptTitle:"\u6A21\u578B\u63D0\u793A\u8BCD"},en:{title:"\u6A21\u578B",model:"Model",voice:"Voice",refresh:"Refresh",save:"Save",saved:"Saved",loading:"Loading\u2026",promptTitle:"Model prompt"}};function O(e){return e.toLowerCase().startsWith("zh")?W.zh:W.en}var U={emotion_alpha:"\u60C5\u7EEA\u5F3A\u5EA6",emotion_text:"\u60C5\u7EEA\u63CF\u8FF0",use_emotion_text:"\u4F7F\u7528\u6587\u5B57\u60C5\u7EEA",use_random_emotion:"\u968F\u673A\u60C5\u7EEA",duration_scale:"\u65F6\u957F\u7F29\u653E",interval_silence_ms:"\u5206\u6BB5\u9759\u97F3",do_sample:"\u91C7\u6837",top_p:"top_p",top_k:"top_k",temperature:"\u6E29\u5EA6",length_penalty:"\u957F\u5EA6\u60E9\u7F5A",num_beams:"beam \u6570",repetition_penalty:"\u91CD\u590D\u60E9\u7F5A",max_tokens:"\u6700\u5927 token",seed:"\u79CD\u5B50",text_chunk_size:"\u6587\u672C\u5206\u5757\u5927\u5C0F",text_chunk_mode:"\u5206\u5757\u6A21\u5F0F"};function j(e,t){return Object.prototype.hasOwnProperty.call(t,e.name)?t[e.name]:e.default}function C(e){return e==null?"":Array.isArray(e)?e.map(t=>String(t)).join(", "):String(e)}function H(e){return typeof e=="number"&&Number.isFinite(e)?String(e):typeof e=="string"&&e.trim()&&Number.isFinite(Number(e))?e.trim():""}function I(e,t,s){let i=e.ui,r=i.h("div","vx-field"),m=i.h("div","vx-head"),p=U[t.name];p&&p!==t.name?m.append(i.h("span","vx-label",p),i.h("span","vx-name",t.name)):m.append(i.h("span","vx-label",t.name)),r.append(m);let f=j(t,s),u;switch(t.type){case"bool":{let a=i.checkbox("",{checked:f===!0});r.append(a.el),u=()=>a.checked;break}case"enum":{let a=t.values??[],d=C(f),c=[{value:"",label:"\u2014"},...a.map(k=>({value:k,label:k}))];d&&!a.includes(d)&&c.push({value:d,label:d});let b=i.select({options:c,value:d});r.append(b),u=()=>b.value||void 0;break}case"int":case"float":{let a=i.input({type:"number",value:H(f)});t.min!==void 0&&(a.min=String(t.min)),t.max!==void 0&&(a.max=String(t.max)),a.step=t.type==="int"?"1":"any",r.append(a),u=()=>{let d=a.value.trim();if(!d)return;let c=Number(d);if(Number.isFinite(c))return t.type==="int"?Math.trunc(c):c};break}case"string_list":case"path_list":{let a=i.input({type:"text",value:C(f)});r.append(a),u=()=>{let d=a.value.split(/[,，]/).map(c=>c.trim()).filter(Boolean);return d.length>0?d:void 0};break}default:{let a=i.input({type:"text",value:C(f)});r.append(a),u=()=>a.value.trim()||void 0;break}}return t.description&&r.append(i.h("div","vx-desc",t.description)),{param:t,el:r,read:u}}function X(e){let t=O(e.language),s=e.ui,i=null,r="",m=[],p=!1,f=s.sheet({title:t.title}),u=s.h("div","vx-top"),a=s.select({onChange:()=>B(a.value)}),d=s.select({}),c=s.h("label","vx-pick");c.append(s.h("span","vx-pick-label",t.model),a);let b=s.h("label","vx-pick");b.append(s.h("span","vx-pick-label",t.voice),d);let k=s.button(t.refresh,{size:"sm",onClick:()=>{E("refresh")}});u.append(c,b,k);let y=s.h("div","vx-params"),S=s.button(t.save,{variant:"primary",size:"sm",onClick:()=>{F()}}),w=s.msgline(),T=s.actions();T.append(S),f.body.append(u,y,T,w),e.root.append(f.el);let _=s.foldSheet("voice-model-prompt",{title:t.promptTitle,defaultOpen:!1}),z=s.h("pre","vx-prompt");_.body.append(z),e.root.append(_.el);function x(n,o=n){let l=s.h("option");return l.value=n,l.textContent=o,l}function h(n,o){w.textContent=n,w.classList.toggle("bad",o)}function v(){let n=i!==null&&i.models.length>0;a.disabled=p||!n,d.disabled=p||!n||!r,S.disabled=p||!n||!r,k.disabled=p}function L(){let o=i?.models.find(M=>M.id===r)?.voices??[],l=i?.model===r?i.voice:"",g=[...o];l&&!g.includes(l)&&g.unshift(l);let P=g.map(M=>x(M));l||P.unshift(x("","\u2014")),d.replaceChildren(...P.length>0?P:[x("","\u2014")]),d.value=l}function R(){let n=i?.models.find(l=>l.id===r),o=i&&i.model===r?i.options:{};m=[],y.replaceChildren();for(let l of n?.parameters??[]){let g=I(e,l,o);m.push(g),y.append(g.el)}}function B(n){r=n,L(),R(),v()}function A(n){i=n,r=n.model,N(),R(),z.textContent=n.prompt,_.note.textContent=n.model||"\u2014",v(),h(n.error??"",n.error!==void 0)}function N(){let n=i?.models??[],o=n.map(l=>x(l.id,l.label||l.id));!r&&n.length>0?o.unshift(x("","\u2014")):r&&!n.some(l=>l.id===r)&&o.unshift(x(r,r)),a.replaceChildren(...o),a.value=r,L()}function V(){let n={};for(let o of m){let l=o.read();l!==void 0&&(n[o.param.name]=l)}return n}async function E(n){if(!p){p=!0,v(),h(t.loading,!1);try{let o=await e.invoke(n,[]);e.signal.aborted||A(o)}catch(o){e.signal.aborted||h(o instanceof Error?o.message:String(o),!0)}finally{p=!1,e.signal.aborted||v()}}}async function F(){if(p||!i)return;let n={model:r,voice:d.value,options:V()};p=!0,v(),h("",!1);try{let o=await e.invoke("save",[n]);e.signal.aborted||(A(o),h(t.saved,!1))}catch(o){e.signal.aborted||h(o instanceof Error?o.message:String(o),!0)}finally{p=!1,e.signal.aborted||v()}}v(),E("state")}var q={panels:{model:{mount:X}}},Y=q;export{Y as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmchai/cortico-world-voice",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Cortico World: voice tools, probabilistic reading, emotion and paralinguistic tags, text filtering and local playback; speech is synthesized by the Kmch AI service over HTTP",
   "author": "kmchai",
@@ -49,23 +49,29 @@
       "requires-extension",
       "experimental"
     ],
-    "describe": "describe.json"
+    "describe": "describe.json",
+    "webUiClient": "dist/webui.js",
+    "webUiStyle": "dist/webui.css"
   },
   "files": [
     "src",
+    "dist/webui.js",
+    "dist/webui.css",
     "README.md",
     "CHANGELOG.md",
     "describe.json"
   ],
   "scripts": {
     "test": "vitest run",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.webui.json",
+    "build:webui": "node scripts/build-webui.mjs",
     "smoke:player": "tsx scripts/smoke-player.ts",
     "smoke:chain": "tsx scripts/smoke-chain.ts"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "cortico": "^0.2.12",
+    "esbuild": "^0.28.2",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"

package/src/ENV_PROMPT.md

@@ -10,5 +10,5 @@
 
 文本规则:
 - text 只放真正要念的正文,不要放动作描写、Markdown、代码、网址或解释。
-- 可以在正文里放 [Laughter]、[Sigh]、[Breathing]、[Uhm]、[Question-ei] 这类副语言标签;模型支持时会被演出来,不会被念出字面。不确定模型是否支持时不要加,免得被原样念出来。
+- {{voice.modelPrompt}}
 - 不要把控制标记写进可见的回复正文;语音参数只放在工具调用里。

package/src/config.ts

@@ -4,10 +4,8 @@ import { pick, type Language, type LanguageTable } from 'cortico/core/language.t
 import type { VoiceConfigSection } from './types.ts';
 
 export const VOICE_ID = 'voice';
-/** 配置里 `x-options` 用的动态音色表。 */
-export const VOICE_OPTIONS_KIND = 'voice.voices';
-/** 配置里 `x-options` 用的动态模型表。 */
-export const VOICE_MODELS_KIND = 'voice.models';
+/** World 定义、WebUI 与配置页共用同一个显示名。 */
+export const VOICE_LABEL = 'Kmch AI · 语音';
 
 export const VOICE_DEFAULTS: VoiceConfigSection = {
   enabled: false,
@@ -16,6 +14,7 @@ export const VOICE_DEFAULTS: VoiceConfigSection = {
   serviceTokenSecret: '',
   model: '',
   voice: '',
+  modelOptions: {},
   format: 'wav',
   timeoutMs: 180_000,
 
@@ -52,19 +51,23 @@ export const VOICE_DEFAULTS: VoiceConfigSection = {
 
 const TEXT = {
   zh: {
-    label: '语音',
+    label: 'Kmch AI · 语音',
     envTitle: '语音 · 环境提示词',
     lampService: '语音服务',
     lampQueue: '朗读队列',
     servicePage: '服务设置',
+    modelPanel: '模型',
+    modelSaveShape: '保存失败:参数格式不对。',
+    modelSaveModel: '保存失败:模型 id 不能为空。',
+    modelSaveVoice: '保存失败:音色必须是字符串。',
+    modelSaveOptions: '保存失败:模型参数必须是对象。',
+    modelUnknownMethod: '未知的面板方法。',
     connection: '连接',
     connectionDesc: '语音服务的 HTTP 地址与令牌。',
     serviceUrl: '服务地址',
     serviceUrlDesc: 'Kmch AI · 服务 的网关地址。',
     serviceTokenSecret: '服务令牌变量名',
     serviceTokenSecretDesc: '部署 .env 里的变量名,留空表示服务不校验。',
-    model: '模型',
-    voice: '音色',
     format: '音频格式',
     timeoutMs: '超时(毫秒)',
     style: '音色与情绪',
@@ -75,7 +78,7 @@ const TEXT = {
     defaultInstruct: '默认表演指令',
     speed: '语速',
     paralinguistic: '副语言标签',
-    paralinguisticDesc: 'auto 保留,由服务与模型决定;strip 一律从朗读文本里删掉。',
+    paralinguisticDesc: 'auto 只在当前模型支持标签时保留;keep 一律保留;strip 一律从朗读文本里删掉。',
     triggers: '触发',
     triggersDesc: '',
     autoSpeak: '自动朗读',
@@ -111,19 +114,23 @@ const TEXT = {
     shareAudio: '回执带音频附件',
   },
   en: {
-    label: 'Voice',
+    label: 'Kmch AI · 语音',
     envTitle: 'Voice · environment prompt',
     lampService: 'Speech service',
     lampQueue: 'Speech queue',
     servicePage: 'Service settings',
+    modelPanel: '模型',
+    modelSaveShape: 'Save failed: invalid arguments.',
+    modelSaveModel: 'Save failed: the model id must not be empty.',
+    modelSaveVoice: 'Save failed: voice must be a string.',
+    modelSaveOptions: 'Save failed: model options must be an object.',
+    modelUnknownMethod: 'Unknown panel method.',
     connection: 'Connection',
     connectionDesc: 'Where the speech service is and which token it expects.',
     serviceUrl: 'Service URL',
     serviceUrlDesc: 'Gateway address of Kmch AI · Service.',
     serviceTokenSecret: 'Service token variable',
     serviceTokenSecretDesc: 'Name in the deployment .env; empty means the service does not check.',
-    model: 'Model',
-    voice: 'Voice',
     format: 'Audio format',
     timeoutMs: 'Timeout (ms)',
     style: 'Voice and emotion',
@@ -134,7 +141,7 @@ const TEXT = {
     defaultInstruct: 'Default direction',
     speed: 'Speed',
     paralinguistic: 'Paralinguistic tags',
-    paralinguisticDesc: 'auto keeps them and lets the service and model decide; strip removes them from the spoken text.',
+    paralinguisticDesc: 'auto keeps them only when the current model supports them; keep always keeps; strip removes them from the spoken text.',
     triggers: 'Triggers',
     triggersDesc: '',
     autoSpeak: 'Automatic speech',
@@ -192,8 +199,6 @@ export function voiceConfigGroups(language: Language): ConfigGroup[] {
         properties: {
           [`${p}serviceUrl`]: { type: 'string', title: t.serviceUrl, description: t.serviceUrlDesc, 'x-hot': true },
           [`${p}serviceTokenSecret`]: { type: 'string', title: t.serviceTokenSecret, description: t.serviceTokenSecretDesc, 'x-hot': true },
-          [`${p}model`]: { type: 'string', title: t.model, 'x-options': VOICE_MODELS_KIND, 'x-hot': true },
-          [`${p}voice`]: { type: 'string', title: t.voice, 'x-options': VOICE_OPTIONS_KIND, 'x-hot': true },
           [`${p}format`]: { type: 'string', title: t.format, enum: ['wav', 'mp3'], 'x-hot': true },
           [`${p}timeoutMs`]: { type: 'integer', title: t.timeoutMs, minimum: 1000, maximum: 600_000, 'x-hot': true },
         },

package/src/definition.ts

@@ -1,15 +1,13 @@
 import { describeTools, type WorldDefinition } from 'cortico/world.ts';
-import { VOICE_DEFAULTS, VOICE_ID } from './config.ts';
-import { currentOptions } from './options.ts';
+import { VOICE_DEFAULTS, VOICE_ID, VOICE_LABEL } from './config.ts';
 import { VOICE_TOOL_DECLS } from './tools.ts';
 import type { VoiceConfigSection } from './types.ts';
 import { VoiceWorld } from './world.ts';
 
 export const VOICE: WorldDefinition<VoiceConfigSection> = {
   id: VOICE_ID,
-  label: 'Voice',
-  defaults: () => ({ ...VOICE_DEFAULTS }),
-  configOptions: (kind) => currentOptions(kind),
+  label: VOICE_LABEL,
+  defaults: () => ({ ...VOICE_DEFAULTS, modelOptions: {} }),
   create: (ctx) => new VoiceWorld({
     cfg: ctx.cfg,
     timezone: ctx.timezone,

package/src/models.ts

@@ -0,0 +1,66 @@
+/**
+ * 模型能力与提示词片段。
+ *
+ * 服务返回的模型 id 决定两件事:正文里能不能写副语言标签,以及环境提示词
+ * 该怎么描述文本与情绪。按 id 前缀匹配,大小写不敏感;空模型与未知模型按
+ * 通用 OpenAI 兼容模型处理。
+ */
+
+interface ModelInfo {
+  /** 模型 id 的前缀,小写。 */
+  readonly match: readonly string[];
+  /** 给人看的名字;未知模型为空。 */
+  readonly label: string;
+  /** 是否支持 `[Laughter]` 这类副语言标签。 */
+  readonly tags: boolean;
+  /** 环境提示词里的文本与情绪写法。 */
+  readonly prompt: string;
+}
+
+const MING3: ModelInfo = {
+  match: ['ming3', 'ming-3', 'ming_3'],
+  label: 'Ming 3.0',
+  tags: true,
+  prompt: '支持 [Laughter] [Sigh] [Breathing] [Uhm] [Question-ei] 等副语言标签;情绪可用 instruct/emotion.',
+};
+
+const INDEXTTS2: ModelInfo = {
+  match: ['index-tts2', 'index_tts2', 'index-tts2.5', 'index_tts2_5', '2.5'],
+  label: 'IndexTTS2',
+  tags: false,
+  prompt: '情绪用自然语言(emotion_text),不要写 [Laughter] 这类方括号标签;采样/时长参数在语音模型页配置,不要写进正文.',
+};
+
+const GENERIC: ModelInfo = {
+  match: [],
+  label: '',
+  tags: false,
+  prompt: '用 instructions 描述语气;不要用方括号标签,除非确认模型支持.',
+};
+
+const KNOWN: readonly ModelInfo[] = [MING3, INDEXTTS2];
+
+function normalize(model: string): string {
+  return typeof model === 'string' ? model.trim().toLowerCase() : '';
+}
+
+function profileOf(model: string): ModelInfo | null {
+  const id = normalize(model);
+  if (!id) return null;
+  return KNOWN.find((info) => info.match.some((prefix) => id.startsWith(prefix))) ?? null;
+}
+
+/** 当前模型是否支持副语言标签;未知与空模型按通用模型处理,返回 false。 */
+export function modelSupportsTags(model: string): boolean {
+  return profileOf(model)?.tags ?? GENERIC.tags;
+}
+
+/** 给人看的模型名;未知或空模型返回空串,由调用方退回模型 id。 */
+export function modelLabel(model: string): string {
+  return profileOf(model)?.label ?? '';
+}
+
+/** 环境提示词里的文本与情绪写法;空模型与未知模型用通用片段。 */
+export function modelPrompt(model: string): string {
+  return (profileOf(model) ?? GENERIC).prompt;
+}

package/src/panel.ts

@@ -0,0 +1,34 @@
+/**
+ * 「模型」面板的数据形状。服务端经由 `World.webUi().invoke` 构造,浏览器端只
+ * `import type` 这些声明;面板不接触服务地址与令牌。
+ */
+import type { VoiceModel } from './types.ts';
+
+export interface PanelModelState {
+  /** `worlds.voice.model`。 */
+  model: string;
+  /** `worlds.voice.voice`。 */
+  voice: string;
+  /** 当前模型的环境提示词片段,来自 `models.ts`。 */
+  prompt: string;
+  /** 当前模型已保存的请求参数。 */
+  options: Record<string, unknown>;
+  /** 服务目录;服务不可达时是上一次可用的结果。 */
+  models: VoiceModel[];
+  /** 最近一次读取服务目录失败的原因。 */
+  error?: string;
+}
+
+/** `invoke('model','save', [save])` 的请求体。 */
+export interface PanelModelSave {
+  model: string;
+  voice: string;
+  options: Record<string, unknown>;
+}
+
+/** 只认普通对象:数组、null 与类对象都不算。 */
+export function isPlainObject(value: unknown): value is Record<string, unknown> {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}

package/src/service.ts

@@ -5,7 +5,8 @@
  * 令牌只从 secret() 现读,不写日志、不留副本。
  */
 import type {
-  AudioFormat, ModelOption, ServiceHealth, TtsAudio, TtsRequest, VoiceConfigSection, VoiceOption,
+  AudioFormat, ModelParameter, ModelParameterType, ServiceHealth, TtsAudio, TtsRequest,
+  VoiceConfigSection, VoiceModel, VoiceOption,
 } from './types.ts';
 
 const PROBE_TIMEOUT_MS = 8000;
@@ -37,6 +38,9 @@ export class ServiceClient implements SpeechService {
     };
     const model = cfg.model.trim();
     if (model) body.model = model;
+    // 只带当前模型自己的参数;其他模型的配置不混进这次请求。
+    const options = cfg.modelOptions?.[model];
+    if (options && Object.keys(options).length > 0) body.options = options;
     const voice = (req.voice ?? '').trim() || cfg.voice.trim();
     if (voice) body.voice = voice;
     const instruct = (req.instruct ?? '').trim();
@@ -96,7 +100,7 @@ export class ServiceClient implements SpeechService {
     }
   }
 
-  async models(): Promise<ModelOption[]> {
+  async models(): Promise<VoiceModel[]> {
     const payload = await this.request(
       this.endpoint('/v1/models'),
       { method: 'GET', headers: this.headers() },
@@ -105,9 +109,9 @@ export class ServiceClient implements SpeechService {
       (res) => this.readJson(res),
     ) as { data?: unknown } | unknown[] | null;
     const raw = Array.isArray(payload) ? payload : Array.isArray(payload?.data) ? payload.data : [];
-    return raw.flatMap((item): ModelOption[] => {
-      const option = optionOf(item);
-      return option ? [option] : [];
+    return raw.flatMap((item): VoiceModel[] => {
+      const model = modelOf(item);
+      return model ? [model] : [];
     });
   }
 
@@ -234,6 +238,83 @@ function optionOf(item: unknown): { value: string; label: string } | null {
   return { value, label };
 }
 
+const PARAMETER_TYPES = new Set<ModelParameterType>([
+  'string', 'enum', 'bool', 'int', 'float', 'string_list', 'path', 'path_list',
+]);
+
+function firstString(...values: unknown[]): string {
+  for (const value of values) {
+    if (typeof value === 'string' && value.trim()) return value.trim();
+  }
+  return '';
+}
+
+/** 目录里的音色/取值可能写成字符串,也可能写成对象;只留去重后的字符串。 */
+function stringItems(value: unknown): string[] {
+  if (!Array.isArray(value)) return [];
+  const out: string[] = [];
+  for (const item of value) {
+    const text = typeof item === 'string'
+      ? item.trim()
+      : item && typeof item === 'object' && !Array.isArray(item)
+        ? firstString(
+          (item as Record<string, unknown>).value,
+          (item as Record<string, unknown>).id,
+          (item as Record<string, unknown>).name,
+          (item as Record<string, unknown>).label,
+        )
+        : '';
+    if (text && !out.includes(text)) out.push(text);
+  }
+  return out;
+}
+
+function finiteNumber(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+
+function parameterOf(item: unknown): ModelParameter | null {
+  if (!item || typeof item !== 'object' || Array.isArray(item)) return null;
+  const o = item as Record<string, unknown>;
+  const name = firstString(o.name);
+  const type = firstString(o.type) as ModelParameterType;
+  if (!name || !PARAMETER_TYPES.has(type)) return null;
+  const description = firstString(o.description);
+  const values = stringItems(o.values);
+  const min = finiteNumber(o.min);
+  const max = finiteNumber(o.max);
+  return {
+    name,
+    type,
+    ...(description ? { description } : {}),
+    ...(values.length ? { values } : {}),
+    ...(o.default !== undefined ? { default: o.default } : {}),
+    ...(min !== undefined ? { min } : {}),
+    ...(max !== undefined ? { max } : {}),
+  };
+}
+
+/** 服务目录的一项:模型 id、显示名、音色与请求参数;不认识的字段不带走。 */
+function modelOf(item: unknown): VoiceModel | null {
+  if (!item || typeof item !== 'object' || Array.isArray(item)) return null;
+  const o = item as Record<string, unknown>;
+  const id = firstString(o.id, o.value, o.name);
+  if (!id) return null;
+  const label = firstString(o.display_name, o.displayName, o.label);
+  const parameters = Array.isArray(o.parameters)
+    ? o.parameters.flatMap((entry): ModelParameter[] => {
+      const parameter = parameterOf(entry);
+      return parameter ? [parameter] : [];
+    })
+    : [];
+  return {
+    id,
+    ...(label ? { label } : {}),
+    voices: stringItems(o.voices),
+    ...(parameters.length ? { parameters } : {}),
+  };
+}
+
 /** 音频回应只接受 wav / mpeg;octet-stream 按请求的格式归一。 */
 function normalizeMime(raw: string | null, format: AudioFormat): string | null {
   const type = (raw ?? '').split(';')[0]!.trim().toLowerCase();

package/src/speech/tags.ts

@@ -57,10 +57,15 @@ export function stripUnknownTags(text: string): string {
 }
 
 /**
- * auto 保留标签,由服务里的模型决定演不演;keep 一律保留;strip 一律删掉。
+ * auto 只在当前模型支持标签时保留;keep 一律保留;strip 一律删掉。
  */
-export function keepsParalinguistic(mode: 'auto' | 'keep' | 'strip'): boolean {
-  return mode !== 'strip';
+export function keepsParalinguistic(
+  mode: 'auto' | 'keep' | 'strip',
+  tagsSupported: boolean,
+): boolean {
+  if (mode === 'strip') return false;
+  if (mode === 'keep') return true;
+  return tagsSupported;
 }
 
 const EMOTION_MARKERS: ReadonlyArray<RegExp> = [

package/src/speech/text.ts

@@ -1,4 +1,5 @@
 /** 把一段回复变成能念的正文:取 `<tts>`、去代码/网址/Markdown/动作标记/符号。 */
+import { modelSupportsTags } from '../models.ts';
 import type { VoiceConfigSection } from '../types.ts';
 import {
   canonicalizeTags,
@@ -86,7 +87,9 @@ export function filterSpeech(raw: string, cfg: VoiceConfigSection): FilteredSpee
 
   text = canonicalizeTags(text);
   text = stripUnknownTags(text);
-  if (!keepsParalinguistic(cfg.paralinguistic)) text = stripParalinguisticTags(text);
+  if (!keepsParalinguistic(cfg.paralinguistic, modelSupportsTags(cfg.model))) {
+    text = stripParalinguisticTags(text);
+  }
 
   if (cfg.filterEmoji) text = text.replace(EMOJI_RE, '').replace(SYMBOL_RE, '');
 

package/src/types.ts

@@ -18,6 +18,8 @@ export interface VoiceConfigSection {
   serviceTokenSecret: string;
   model: string;
   voice: string;
+  /** 模型专属的 request 参数,按模型 id 分组;由「模型」面板写回,不进 ConfigGroup。 */
+  modelOptions: Record<string, Record<string, unknown>>;
   format: AudioFormat;
   timeoutMs: number;
 
@@ -90,7 +92,36 @@ export interface SelectOption {
 }
 
 export type VoiceOption = SelectOption;
-export type ModelOption = SelectOption;
+
+/** 服务 `GET /v1/models` 里 `parameters[].type` 的取值。 */
+export type ModelParameterType =
+  | 'string'
+  | 'enum'
+  | 'bool'
+  | 'int'
+  | 'float'
+  | 'string_list'
+  | 'path'
+  | 'path_list';
+
+/** 模型请求参数的元数据;服务按模型给出,面板据此渲染字段。 */
+export interface ModelParameter {
+  name: string;
+  type: ModelParameterType;
+  description?: string;
+  values?: string[];
+  default?: unknown;
+  min?: number;
+  max?: number;
+}
+
+/** 服务目录里的一项模型;音色与请求参数元数据随模型走。 */
+export interface VoiceModel {
+  id: string;
+  label?: string;
+  voices: string[];
+  parameters?: ModelParameter[];
+}
 
 /** `GET /health` 的摘要;`ok` 只表示网关有回应,`ready` 表示至少有一个服务能合成。 */
 export interface ServiceHealth {

package/src/world.ts

@@ -14,11 +14,12 @@ import type {
   Logger, ToolDef, ToolOutcome, World, WorldHost, WorldLamp, WorldWebUiDecl,
 } from 'cortico/core/types.ts';
 import { nullLogger, nowIso } from 'cortico/core/util.ts';
-import { VOICE_DEFAULTS, VOICE_ID, VOICE_MODELS_KIND, 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 { registerOptions, unregisterOptions } from './options.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';
@@ -26,14 +27,13 @@ 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 {
-  ModelOption, ServiceHealth, TtsAudio, TtsRequest, VoiceConfigSection, VoiceOption,
+  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 CATALOG_TTL_MS = 10 * 60_000;
 
 export interface VoiceWorldDeps {
   fetch: typeof fetch;
@@ -130,18 +130,11 @@ export class VoiceWorld implements World {
   private tempSeq = 0;
   private serviceState: ServiceState | null = null;
   private probing = false;
-  private voices: VoiceOption[] = [];
-  private voicesAt = 0;
-  private voicesSignature = '';
-  private voicesLoading = false;
-  private models: ModelOption[] = [];
-  private modelsAt = 0;
-  private modelsSignature = '';
-  private modelsLoading = 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;
-  private readonly modelOptions = (): readonly ModelOption[] => this.models;
-  private readonly voiceOptions = (): readonly VoiceOption[] => this.voices;
 
   constructor(private readonly opts: VoiceWorldOptions) {
     this.log = opts.log ?? nullLogger();
@@ -180,6 +173,7 @@ export class VoiceWorld implements World {
       'voice.voice': cfg.voice || 'default',
       'voice.emotion': cfg.defaultEmotion || 'neutral',
       'voice.instruct': cfg.defaultInstruct || 'none',
+      'voice.modelPrompt': modelPrompt(cfg.model),
     };
   }
 
@@ -224,8 +218,22 @@ export class VoiceWorld implements World {
         { label: 'model', value: cfg.model || '—', tone: 'plain' },
         { label: 'voice', value: cfg.voice || '—', tone: '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,
@@ -237,11 +245,111 @@ export class VoiceWorld implements World {
           { name: 'voice.voice', description: 'Current voice id.' },
           { name: 'voice.emotion', description: 'Standing emotion.' },
           { name: 'voice.instruct', description: 'Standing direction.' },
+          { 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;
@@ -252,7 +360,6 @@ export class VoiceWorld implements World {
   async start(host: WorldHost): Promise<void> {
     this.host = host;
     this.started = true;
-    this.registerCatalogOptions();
     this.log.info('语音 World 启动', {
       service: serviceHost(this.cfg.serviceUrl),
       playback: this.cfg.playback,
@@ -271,7 +378,6 @@ export class VoiceWorld implements World {
 
   async stop(): Promise<void> {
     this.started = false;
-    this.unregisterCatalogOptions();
     if (this.healthTimer) clearInterval(this.healthTimer);
     this.healthTimer = null;
     this.poller?.stop();
@@ -404,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() };
@@ -527,7 +632,7 @@ export class VoiceWorld implements World {
     } catch { /* 只归档,失败就只留日志 */ }
   }
 
-  // ———————— 状态与目录 ————————
+  // ———————— 状态 ————————
 
   private markService(state: Pick<ServiceState, 'ok' | 'detail'>): void {
     const previous = this.serviceState;
@@ -540,8 +645,6 @@ export class VoiceWorld implements World {
 
   private async probe(): Promise<void> {
     if (this.probing) return;
-    // 探活会刷新目录;每次探活都重新登记,停用后重新启用的实例也能接上。
-    this.registerCatalogOptions();
     this.probing = true;
     try {
       const health: ServiceHealth = await this.service.health();
@@ -554,9 +657,6 @@ export class VoiceWorld implements World {
     } finally {
       this.probing = false;
     }
-    // 探活顺带刷新目录;读不到时 refresh 会保留上一次的表。
-    await this.refreshVoices(true);
-    await this.refreshModels(true);
   }
 
   private maybeRefresh(): void {
@@ -565,56 +665,6 @@ export class VoiceWorld implements World {
     if (!this.probing && (this.serviceState === null || now - this.serviceState.at > HEALTH_TTL_MS)) {
       void this.probe();
     }
-    if (now - this.voicesAt > CATALOG_TTL_MS) void this.refreshVoices();
-    if (now - this.modelsAt > CATALOG_TTL_MS) void this.refreshModels();
-  }
-
-  private async refreshVoices(force = false): Promise<void> {
-    const cfg = this.cfg;
-    const signature = `${cfg.serviceUrl.trim()}|${cfg.model.trim()}`;
-    if (this.voicesLoading && !force) return;
-    if (!force && signature === this.voicesSignature && this.deps.now() - this.voicesAt < CATALOG_TTL_MS) return;
-    this.voicesLoading = true;
-    try {
-      const list = await this.service.voices(cfg.model);
-      if (signature !== `${this.cfg.serviceUrl.trim()}|${this.cfg.model.trim()}`) 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 async refreshModels(force = false): Promise<void> {
-    const signature = this.cfg.serviceUrl.trim();
-    if (this.modelsLoading && !force) return;
-    if (!force && signature === this.modelsSignature && this.deps.now() - this.modelsAt < CATALOG_TTL_MS) return;
-    this.modelsLoading = true;
-    try {
-      const list = await this.service.models();
-      if (signature !== this.cfg.serviceUrl.trim()) return;
-      this.models = list;
-      this.modelsSignature = signature;
-      this.modelsAt = this.deps.now();
-    } catch (error) {
-      this.log.debug('模型表读取失败', { err: error instanceof Error ? error.message : String(error) });
-    } finally {
-      this.modelsLoading = false;
-    }
-  }
-
-  /** 下拉读的是缓存表;服务读不到时保留上一次的结果。当前值由框架补入。 */
-  private registerCatalogOptions(): void {
-    registerOptions(VOICE_MODELS_KIND, this.modelOptions);
-    registerOptions(VOICE_OPTIONS_KIND, this.voiceOptions);
-  }
-
-  private unregisterCatalogOptions(): void {
-    unregisterOptions(VOICE_MODELS_KIND, this.modelOptions);
-    unregisterOptions(VOICE_OPTIONS_KIND, this.voiceOptions);
   }
 
   private syncPoller(): void {
@@ -655,4 +705,4 @@ export class VoiceWorld implements World {
   }
 }
 
-export { VOICE_DEFAULTS, VOICE_ID, VOICE_MODELS_KIND, VOICE_OPTIONS_KIND };
+export { VOICE_DEFAULTS, VOICE_ID };

package/src/options.ts

@@ -1,36 +0,0 @@
-/**
- * 配置页的模型与音色下拉要读运行中实例从服务探到的目录,但
- * `WorldDefinition.configOptions` 是静态签名。实例启动或探活时把读取函数注册进来;
- * 只支持 `voice.models` 与 `voice.voices` 两种 kind,未知 kind 返回空。
- * 读的是已经缓存的表,不在配置页里发请求;服务不可达时保留上次的表,没有就是空表。
- * 当前值不在表里时由框架补入,这里不重复做。
- */
-import { VOICE_MODELS_KIND, VOICE_OPTIONS_KIND } from './config.ts';
-import type { SelectOption } from './types.ts';
-
-export const OPTION_KINDS = [VOICE_MODELS_KIND, VOICE_OPTIONS_KIND] as const;
-export type OptionKind = (typeof OPTION_KINDS)[number];
-
-type Provider = () => readonly SelectOption[];
-
-const providers = new Map<OptionKind, Provider>();
-
-function isOptionKind(kind: string): kind is OptionKind {
-  return kind === VOICE_MODELS_KIND || kind === VOICE_OPTIONS_KIND;
-}
-
-/** 实例启动或探活时登记;同一 kind 后登记的覆盖先前的。 */
-export function registerOptions(kind: OptionKind, provider: Provider): void {
-  providers.set(kind, provider);
-}
-
-/** 实例停止时撤销自己登记的那一项;已有更新实例登记时不动它。 */
-export function unregisterOptions(kind: OptionKind, provider: Provider): void {
-  if (providers.get(kind) === provider) providers.delete(kind);
-}
-
-/** 未知 kind 返回空数组,框架继续查询其他 World。 */
-export function currentOptions(kind: string): SelectOption[] {
-  if (!isOptionKind(kind)) return [];
-  return [...(providers.get(kind)?.() ?? [])];
-}