@bittersmilezzz/dsh-asr-voice 0.3.3 → 0.4.1

package/cordis.patch.yml

@@ -13,15 +13,16 @@
 #   host 实时通道（realtime.provider 选 'builtin' 假 provider 或真云端预置）。
 # - 提示词优化：本地启发式（zh/en 清洗）或可选 LLM 重写（optimize.mode 默认
 #   llm，走 DSH 当前所选模型的官方 LLM 通道，host 代理）。
-# - 设置页卡片：「设置 → 插件 → 配置」→「语音输入」（settings.plugin.item,
-#   key: asr-voice；host 注册同名 settings namespace 让配置 tab 枚举到卡片）。
+# - 设置页卡片：「设置 → 插件 → 配置」→「语音输入」（plugins.bundle.config,
+#   key: asr-voice；配置 schema 是入口模块顶层导出的 Config，DSH 0.1.7 起
+#   profile-backed forms，entry id 即 namespace）。
 # - API key 只进 **DSH 凭据服务**（预置引用名与官方 LLM 凭据同名），settings 与浏览器
 #   都不持有密钥；音频与转写请求经 /api/asr-voice/* 私有 JSON 代理。纯 Node HTTP 实现，
 #   macOS / Windows 双平台。
 #
-# host inject 只列硬依赖（webServer/llm）；settings 走 scoped inject（可选，
-# 缺失时仅云端 ASR 无 key、不影响挂载），agentDefaultModel 在优化路由内
-# ctx.get 可选读取。client 侧 settingsScope / locale / slots 是硬依赖（设置卡与
+# host inject 只列硬依赖（webServer/llm）；配置经函数插件第二参注入（DSH 0.1.7
+# Config 契约），无需 inject settings；agentDefaultModel 在优化路由内
+# ctx.get 可选读取。client 侧 configForms / locale / slots 是硬依赖（设置卡与
 # 按钮座位必需），connection / sessions / remote.credentials 是可选 ctx.inject
 # （缺失只让对应能力退化：密钥读写 / 回合打断，不影响挂载）。
 # 注意：inject 项是 Cordis 服务名（非 entry id）。

package/lib/client.js

@@ -818,6 +818,9 @@ window.__ModuleLoader__.load({
 }
 .dshav-card:hover { border-color: var(--dsw-alias-label-dimmed); }
 .dshav-card.dshav-card-open { background: var(--dsw-alias-bg-layer-2); border-color: var(--dsw-alias-label-dimmed);}
+/* 插件详情页（view: 'page'）：官方页面已画标题/外壳，卡片容器透明化、body 无分隔线。 */
+.dshav-card.dshav-card-page { border: 0; background: none; }
+.dshav-card.dshav-card-page:hover { border-color: transparent; }
 .dshav-header {
   width: 100%;
   appearance: none;
@@ -846,6 +849,7 @@ window.__ModuleLoader__.load({
 .dshav-chevron { flex: none; color: var(--dsw-alias-label-tertiary); transition: transform .16s;}
 .dshav-chevron.dshav-open { transform: rotate(180deg); }
 .dshav-body { border-top: 1px solid var(--dsw-alias-border-l2); margin: 0 16px; padding-bottom: 8px;}
+.dshav-body.dshav-body-page { border-top: 0; margin: 0; padding-top: 0; }
 .dshav-group { display: flex; flex-direction: column; }
 /* 分组之间用与字段一致的分割线（官方 border-l2）。 */
 .dshav-group + .dshav-group { border-top: 1px solid var(--dsw-alias-border-l2); }
@@ -1108,7 +1112,7 @@ window.__ModuleLoader__.load({
 			label: "内置模拟（开发）",
 			wssUrl: "",
 			defaultModel: "",
-			keyPreset: "openai",
+			keyPreset: "",
 			hint: "I3/I4 开发态：host 用能量 VAD 假 provider 驱动整条管道，不花配额"
 		}, {
 			id: "dashscope-realtime",
@@ -1215,8 +1219,23 @@ window.__ModuleLoader__.load({
 				listeners.delete(fn);
 			};
 		}
-		/** settings namespace（host schema 注册与 client 绑定共用同一个名字）。 */
-		const ASR_VOICE_NS = "asr-voice";
+		/**
+		* settings namespace = host 半区 `cordis.patch.yml` 的 entry `id`（DSH 0.1.7 起
+		* `SettingsForms.update/describe` 与 `ConfigForms.get` 都用这个字符串定位 entry，
+		* 官方实现是 `entries().find(row => row.options.id === ns)`）。
+		*
+		* ⚠ 它**不是** npm 包名（本插件 npm 包名是 `@bittersmilezzz/dsh-asr-voice`），也不
+		* 是文件里其它地方的插件短名。拿错字符串不会抛错：host 侧 update 抛
+		* `No configurable plugin entry`（migrateLegacyKeys 只落一句 warn），client 侧
+		* configForms.get 拿到 unavailable 快照 → 设置卡能渲染但**所有读写静默失效**。
+		* 一致性由 test/entry-id-parity.test.mjs 钉住（读 cordis.patch.yml 的 id，并与
+		* host 侧 `src/settings.ts` 的 `ASR_VOICE_SETTINGS_NAMESPACE` 三方比对）。
+		*
+		* 这里刻意**不再 import** host 侧的常量：client bundle 由 tsdown 打包，把
+		* `src/settings.ts`（整棵 schemastery schema）拖进浏览器产物没有意义；用一个字面量
+		* 加一条三方比对测试守住等价性，比共享导入更轻。
+		*/
+		const ASR_VOICE_NS = "dsh-asr-voice";
 		/** 把旧版凭据通道适配成新版形状（alpha.3 前的老运行时仍暴露旧面时兜底）。 */
 		function adaptLegacyCredentials(legacy) {
 			if (legacy === void 0) return void 0;
@@ -1315,10 +1334,13 @@ window.__ModuleLoader__.load({
 			}
 			return false;
 		}
-		/** 绑定 host settings scope 并订阅：首次读取当前值，之后 scope 变化回写本地快照并广播。 @param binder - settingsScope 服务的 binder（SettingsScopeBinder）。 @returns 订阅 disposer（随 fiber 清理）。 */
-		/** 绑定 host settings scope 并订阅：首次读取当前值，之后 scope 变化回写本地快照并广播。 @param binder - settingsScope 服务（官方 SettingsScopeBinder，随 fiber 注入）。 @returns 订阅 disposer（随 fiber 清理）。 */
-		function bindConfigScope(binder) {
-			const scope = binder.bind({ namespace: ASR_VOICE_NS });
+		/**
+		* 绑定 host Config form 并订阅：首次读取当前值，之后 form 变化回写本地快照并广播。
+		* @param forms - configForms 服务（DSH 0.1.7 官方 ConfigForms，随 fiber 注入）。
+		* @returns 订阅 disposer（随 fiber 清理）。
+		*/
+		function bindConfigScope(forms) {
+			const scope = forms.get(ASR_VOICE_NS);
 			voiceScope = scope;
 			const applySnapshot = () => {
 				const value = scope.getSnapshot().value;
@@ -1372,7 +1394,7 @@ window.__ModuleLoader__.load({
 				tts,
 				ttsVoice,
 				hotkey,
-				bargeIn,
+				bargeIn: engine === "segmented" && bargeIn,
 				maxSessionMs,
 				language: source.language,
 				settleMs: turn.settleMs,
@@ -1502,6 +1524,10 @@ window.__ModuleLoader__.load({
 		/** 保存草稿：只把真正改过的顶层段写回 host，然后**读回校验**。
 		* `SettingsScope.set` 会把失败吞掉并重载宿主状态（promise 成功不代表落盘），所以
 		* 判定标准只能是写完之后宿主那边到底剩什么——这也正是官方设置卡的做法。
+		*
+		* 两道防线：① `set` 返回 `false` = 宿主拒写/跳过，直接计入失败集合并提前返回段名，
+		* 不等读回——因为拒写时宿主刚触发过一次状态重载，重载值恰好等于草稿时读回会算出
+		* 「零变更」→ 静默报成功；② 读回校验兜住「set 说成功但宿主没留住」这一类。
 		* @returns 未落盘的段名，undefined 表示全部落定。
 		*/
 		async function writeDraft(draft) {
@@ -1519,7 +1545,17 @@ window.__ModuleLoader__.load({
 				announce();
 				return;
 			}
-			for (const key of changed) await scope.set(key, draft[key]);
+			const refused = [];
+			for (const key of changed) {
+				let accepted = false;
+				try {
+					accepted = await scope.set(key, draft[key]);
+				} catch {
+					accepted = false;
+				}
+				if (!accepted) refused.push(key);
+			}
+			if (refused.length > 0) return refused[0];
 			mergeHostValue(draft);
 			announce();
 			const resolved = scope.getSnapshot().value;
@@ -2108,8 +2144,8 @@ window.__ModuleLoader__.load({
 			behavior: "groupBehavior",
 			realtime: "groupRealtime"
 		};
-		/** 设置卡片：外层折叠与其他插件卡一致（header + chevron + 条件 body）。 */
-		function VoiceSettingsCard({ t }) {
+		/** 设置卡片：插件详情页按 view 渲染（summary 一行 / page 表单），兜底路径自绘折叠外壳。 */
+		function VoiceSettingsCard({ t, view }) {
 			const version = useConfigVersion();
 			const [open, setOpen] = react.useState(false);
 			const [showAdvanced, setShowAdvanced] = react.useState(false);
@@ -2283,9 +2319,11 @@ window.__ModuleLoader__.load({
 			];
 			const needKey = keyState !== null && !keyState.configured && keyState.failure === null;
 			const keyNameMissing = presetById(provider.preset) === void 0 && provider.name.trim() === "";
+			const pageView = view === "page";
+			if (view === "summary") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: t("cardCopy") });
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
-				className: "dshav-card" + (open ? " dshav-card-open" : ""),
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+				className: "dshav-card" + (open || pageView ? " dshav-card-open" : "") + (pageView ? " dshav-card-page" : ""),
+				children: [pageView ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 					type: "button",
 					className: "dshav-header",
 					"aria-expanded": open,
@@ -2314,8 +2352,8 @@ window.__ModuleLoader__.load({
 							strokeLinejoin: "round"
 						})
 					})]
-				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "dshav-body",
+				}), open || pageView ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dshav-body" + (pageView ? " dshav-body-page" : ""),
 					children: [
 						!writable ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 							className: "dshav-field-hint",
@@ -2399,7 +2437,7 @@ window.__ModuleLoader__.load({
 											placeholder: keyState?.configured === true ? t("keyKeepPlaceholder") : t("keyPastePlaceholder"),
 											spellCheck: false,
 											autoComplete: "off",
-											disabled: !writable || keyState?.writable === false,
+											disabled: !writable || keyState === null || keyState?.writable === false,
 											onChange: (e) => setKeyInput(e.target.value)
 										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 											type: "button",
@@ -4894,6 +4932,7 @@ window.__ModuleLoader__.load({
 						headers: { accept: "text/event-stream" },
 						signal: controller.signal
 					});
+					if (res.status === 409) return;
 					if (!res.ok || res.body === null) {
 						if (!disposed) onEvent({
 							type: "error",
@@ -6707,7 +6746,8 @@ window.__ModuleLoader__.load({
 			const sys = systemDict();
 			const title = chat.active ? chat.title : busy ? state === "recording" ? sys.recordingTitle : state === "transcribing" ? sys.transcribingTitle : sys.optimizingTitle : chat.enabled ? sys.micTitleHoldChat : sys.micTitle;
 			const ariaLabel = chat.active ? chat.ariaLabel : busy ? state === "recording" ? t("recordingTitle") : state === "transcribing" ? t("transcribingTitle") : t("optimizingTitle") : chat.enabled ? t("micTitleHoldChat") : t("micTitle");
-			const shortcut = chat.enabled && config.realtime.hotkey !== "" ? config.realtime.hotkey.replace(/\bCtrl\b/gi, "Control").replace(/\bCmd\b/gi, "Meta") : void 0;
+			const ariaKeyName = (spec) => spec.replace(/\bCtrl\b/gi, "Control").replace(/\bCmd\b/gi, "Meta").replace(/\bAlt\b/gi, "Alt");
+			const shortcut = chat.enabled && config.realtime.hotkey !== "" ? ariaKeyName(config.realtime.hotkey) : config.behavior.hotkey !== "" ? ariaKeyName(config.behavior.hotkey) : void 0;
 			const chatStatus = chat.active || !busy && error === null && notice === null ? chat.status : null;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 				className: "dshav-mic-wrap",
@@ -6848,6 +6888,20 @@ window.__ModuleLoader__.load({
 					if (e.key === "Escape") {
 						e.stopPropagation();
 						closePreview();
+						return;
+					}
+					if (e.key !== "Tab") return;
+					const focusables = e.currentTarget.querySelectorAll("button");
+					if (focusables.length === 0) return;
+					const first = focusables[0];
+					const last = focusables[focusables.length - 1];
+					const active = document.activeElement;
+					if (e.shiftKey && (active === first || !e.currentTarget.contains(active))) {
+						e.preventDefault();
+						last.focus();
+					} else if (!e.shiftKey && (active === last || !e.currentTarget.contains(active))) {
+						e.preventDefault();
+						first.focus();
 					}
 				},
 				children: [
@@ -6903,12 +6957,15 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/index.ts
 		const NS = "asr-voice";
-		/** 硬依赖：设置卡/配置读写必须的顶层服务（与兄弟插件同款：settingsScope 必须硬依赖，
-		* 否则卡片包在 scoped inject 里会因某服务不可注入而永不注册——这正是此前设置卡消失的根因）。 */
+		/** 包名（`plugins.bundle.config` 的 key：bundle 的 package name）。 */
+		const PACKAGE_NAME = "@bittersmilezzz/dsh-asr-voice";
+		/** 硬依赖：设置卡/配置读写必须的顶层服务（DSH 0.1.7 起 configForms 取代
+		* settingsScope；必须硬依赖，否则卡片包在 scoped inject 里会因服务不可注入而
+		* 永不注册——这正是此前设置卡消失的根因）。 */
 		const inject = [
 			"slots",
 			"locale",
-			"settingsScope"
+			"configForms"
 		];
 		/** 快捷键处理（按住说话 / 点击切换 / 实时对话进出），随 fiber 生命周期注册。 */
 		function applyHotkey() {
@@ -7022,19 +7079,21 @@ window.__ModuleLoader__.load({
 				const sessions = raw.sessions;
 				cancelTurn = (sessionId) => {
 					try {
-						((sessions?.scope(sessionId))?.get("conversation"))?.cancel?.()?.catch?.(() => {});
+						((sessions?.scope(sessionId))?.get("conversation"))?.cancel?.().catch(() => {});
 					} catch {}
 				};
 			});
 			ctx.effect(applyHotkey, "asr-voice: hotkey");
-			ctx.effect(() => bindConfigScope(ctx.settingsScope), "asr-voice: settings scope sync");
-			ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
-				name: "settings.plugin.item",
-				key: "asr-voice",
+			ctx.effect(() => bindConfigScope(ctx.configForms), "asr-voice: config form sync");
+			ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
+				name: "plugins.bundle.config",
+				key: PACKAGE_NAME,
 				locale: NS
-			}, () => react_jsx_runtime.jsx(VoiceSettingsCard, { t })));
+			}, (props) => react_jsx_runtime.jsx(VoiceSettingsCard, {
+				t,
+				view: props?.view
+			})));
 			ctx.inject([
-				"settingsScope",
 				"connection",
 				"remote",
 				"remote.credentials"