@jxgame2020/dsh-token-quota 0.1.40 → 0.1.42

package/lib/index.js

@@ -27,6 +27,12 @@ const TOKEN_QUOTA_DEFAULT_BALANCE = {
 	enabled: true,
 	pollMinutes: 5
 };
+const TOKEN_QUOTA_DEFAULT_TRANSCRIBE = {
+	enabled: false,
+	baseURL: "https://api.siliconflow.cn/v1",
+	apiKeyEnv: "SILICONFLOW_API_KEY",
+	model: "XingChenAGI/XingChenASR-V3.2-Ultra"
+};
 /** Default music settings: silent until the user flips the panel switch. */
 const TOKEN_QUOTA_DEFAULT_MUSIC = {
 	enabled: false,
@@ -244,7 +250,13 @@ const TOKEN_QUOTA_SETTINGS_SCHEMA = z.object({
 	balance: z.object({
 		enabled: z.boolean().default(TOKEN_QUOTA_DEFAULT_BALANCE.enabled),
 		pollMinutes: z.number().min(1).max(120).default(TOKEN_QUOTA_DEFAULT_BALANCE.pollMinutes)
-	}).default({ ...TOKEN_QUOTA_DEFAULT_BALANCE })
+	}).default({ ...TOKEN_QUOTA_DEFAULT_BALANCE }),
+	transcribe: z.object({
+		enabled: z.boolean().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.enabled),
+		baseURL: z.string().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.baseURL),
+		apiKeyEnv: z.string().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.apiKeyEnv),
+		model: z.string().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.model)
+	}).default({ ...TOKEN_QUOTA_DEFAULT_TRANSCRIBE })
 });
 /** Two-digit zero-pad helper. */
 function pad2(value) {
@@ -300,7 +312,8 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		music: { ...TOKEN_QUOTA_DEFAULT_MUSIC },
 		order: [],
 		notes: [],
-		balance: { ...TOKEN_QUOTA_DEFAULT_BALANCE }
+		balance: { ...TOKEN_QUOTA_DEFAULT_BALANCE },
+		transcribe: { ...TOKEN_QUOTA_DEFAULT_TRANSCRIBE }
 	});
 	/** Whether update checks are enabled (mirrors the settings document). */
 	checkUpdates = true;
@@ -338,6 +351,8 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 	disposeRouteClear;
 	/** Disposer for the optional balance-refresh route (`POST /token-quota/refresh-balance`). */
 	disposeRouteBalance;
+	/** Disposer for the voice transcription route (`POST /token-quota/transcribe`). */
+	disposeRouteTranscribe;
 	/** Disposer for the optional music-event route (`GET /token-quota/events`, SSE). */
 	disposeRouteEvents;
 	/** Live SSE subscribers receiving streamed music actions. */
@@ -368,6 +383,12 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 								enabled: doc.balance?.enabled ?? TOKEN_QUOTA_DEFAULT_BALANCE.enabled,
 								pollMinutes: typeof doc.balance?.pollMinutes === "number" ? Math.max(1, Math.min(120, Math.round(doc.balance.pollMinutes))) : TOKEN_QUOTA_DEFAULT_BALANCE.pollMinutes
 							},
+							transcribe: {
+								enabled: doc.transcribe?.enabled ?? TOKEN_QUOTA_DEFAULT_TRANSCRIBE.enabled,
+								baseURL: typeof doc.transcribe?.baseURL === "string" && doc.transcribe.baseURL !== "" ? doc.transcribe.baseURL.replace(/\/+$/, "") : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.baseURL,
+								apiKeyEnv: typeof doc.transcribe?.apiKeyEnv === "string" && doc.transcribe.apiKeyEnv !== "" ? doc.transcribe.apiKeyEnv : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.apiKeyEnv,
+								model: typeof doc.transcribe?.model === "string" && doc.transcribe.model !== "" ? doc.transcribe.model : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.model
+							},
 							notes: Array.isArray(doc.notes) ? doc.notes.slice(0, 5).flatMap((note) => {
 								if (typeof note.id !== "string") return [];
 								return [{
@@ -521,6 +542,32 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 				});
 			}
 		});
+		this.disposeRouteTranscribe = server.register({
+			kind: "exact",
+			path: "/token-quota/transcribe",
+			handler: (req, res) => {
+				if (req.method !== "POST") {
+					res.writeHead(405);
+					res.end();
+					return;
+				}
+				this.handleTranscribe(req).then((result) => {
+					if (result.ok) {
+						res.writeHead(200, {
+							"content-type": "application/json",
+							"cache-control": "no-store"
+						});
+						res.end(JSON.stringify({ text: result.text }));
+					} else {
+						res.writeHead(result.status);
+						res.end(result.message);
+					}
+				}, (error) => {
+					res.writeHead(500);
+					res.end(error instanceof Error ? error.message : String(error));
+				});
+			}
+		});
 		this.disposeRouteClear = server.register({
 			kind: "exact",
 			path: "/token-quota/clear-log",
@@ -604,7 +651,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		return this.upgradeCheck;
 	}
 	async doRefreshUpgrade() {
-		const current = "0.1.40";
+		const current = "0.1.42";
 		let latest;
 		try {
 			const response = await fetch(REGISTRY_LATEST_URL, {
@@ -805,6 +852,91 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		this.balanceFetches.set(provider, promise);
 		return promise;
 	}
+	/**
+	* Forward a recorded audio blob to the configured OpenAI-compatible
+	* `/audio/transcriptions` endpoint and return the recognised text. The API
+	* key resolves through the credential seam (Models page) with an environment
+	* fallback; the request body is the raw audio and the content type carries
+	* the filename for the multipart form.
+	*/
+	async handleTranscribe(req) {
+		const settings = this.settingsSource().transcribe;
+		if (!settings.enabled) return {
+			ok: false,
+			status: 403,
+			message: "transcription is disabled"
+		};
+		const chunks = [];
+		for await (const chunk of req) chunks.push(Buffer.from(chunk));
+		const audio = Buffer.concat(chunks);
+		if (audio.length === 0) return {
+			ok: false,
+			status: 400,
+			message: "empty audio payload"
+		};
+		const credentials = this.ctx.get("credentials");
+		let key;
+		if (credentials !== void 0) try {
+			key = (await credentials.resolve(settings.apiKeyEnv))?.value;
+		} catch {}
+		if (key === void 0 || key === "") key = process.env[settings.apiKeyEnv];
+		if (key === void 0 || key === "") return {
+			ok: false,
+			status: 400,
+			message: `no API key for credential reference "${settings.apiKeyEnv}"`
+		};
+		const contentType = req.headers["content-type"] ?? "application/octet-stream";
+		const disposition = typeof req.headers["content-disposition"] === "string" ? req.headers["content-disposition"] : "";
+		const filename = /filename="([^"]+)"/.exec(disposition)?.[1] ?? "recording.webm";
+		const form = new FormData();
+		form.append("model", settings.model);
+		form.append("file", new Blob([new Uint8Array(audio)], { type: contentType }), filename);
+		try {
+			const controller = new AbortController();
+			const timer = setTimeout(() => {
+				controller.abort();
+			}, 6e4);
+			let res;
+			try {
+				res = await fetch(`${settings.baseURL}/audio/transcriptions`, {
+					method: "POST",
+					headers: {
+						authorization: `Bearer ${key}`,
+						accept: "application/json"
+					},
+					body: form,
+					signal: controller.signal
+				});
+			} finally {
+				clearTimeout(timer);
+			}
+			if (!res.ok) {
+				const detail = await res.text().catch(() => "");
+				return {
+					ok: false,
+					status: res.status,
+					message: `transcription endpoint HTTP ${res.status}${detail !== "" ? `: ${detail.slice(0, 300)}` : ""}`
+				};
+			}
+			const data = await res.json();
+			const text = typeof data?.text === "string" ? data.text : "";
+			if (text === "") return {
+				ok: false,
+				status: 502,
+				message: "transcription endpoint returned no text"
+			};
+			return {
+				ok: true,
+				text
+			};
+		} catch (error) {
+			return {
+				ok: false,
+				status: 502,
+				message: error instanceof Error ? error.message : String(error)
+			};
+		}
+	}
 	/** Read the full per-cycle usage history (log dialog data). */
 	readLog() {
 		this.rollCycleIfNeeded();
@@ -1109,6 +1241,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		if (this.disposeRouteCheck !== void 0) this.disposeRouteCheck();
 		if (this.disposeRouteClear !== void 0) this.disposeRouteClear();
 		if (this.disposeRouteBalance !== void 0) this.disposeRouteBalance();
+		if (this.disposeRouteTranscribe !== void 0) this.disposeRouteTranscribe();
 		if (this.balanceTimer !== void 0) {
 			clearTimeout(this.balanceTimer);
 			this.balanceTimer = void 0;

package/lib/types/client/TokenQuotaPanel.d.ts

@@ -1,6 +1,6 @@
 import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { TokenQuotaFullAction, TokenQuotaMusicStyle, TokenQuotaNote, TokenQuotaReset } from '@jxgame2020/dsh-token-quota/types';
+import type { TokenQuotaFullAction, TokenQuotaMusicStyle, TokenQuotaNote, TokenQuotaReset, TokenQuotaTranscribeSettings } from '@jxgame2020/dsh-token-quota/types';
 import type { createTokenQuotaPanelStore } from './store.ts';
 /** Injected business face: data loading and mutations wired in `apply`. */
 export interface TokenQuotaPanelInjected {
@@ -36,6 +36,8 @@ export interface TokenQuotaPanelInjected {
     setMusicStyle: (style: TokenQuotaMusicStyle) => void;
     /** Toggle whether the soundtrack follows only the current session. */
     setMusicOnlyCurrentSession: (only: boolean) => void;
+    /** Persist the voice transcription settings (endpoint, key ref, model). */
+    setTranscribeSettings: (settings: TokenQuotaTranscribeSettings) => void;
     /** Ask the Host to check the registry right now, then refresh the snapshot. */
     checkUpdatesNow: () => void;
     /** Ask the Host to clear log entries before a date, then refresh the log. */
@@ -48,5 +50,5 @@ export type TokenQuotaPanelComponentProps = PropsRuntime<'shell.overlay'> & Prop
  * @param props - composed slot props.
  * @returns the panel element tree.
  */
-export declare function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle, setModelOrder, saveNotes, setBalanceSettings, refreshBalance, setMusicEnabled, setMusicVolume, setMusicStyle, setMusicOnlyCurrentSession, useStore, actions, useSessions, }: TokenQuotaPanelComponentProps): import("react").JSX.Element;
+export declare function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle, setModelOrder, saveNotes, setBalanceSettings, refreshBalance, setMusicEnabled, setMusicVolume, setMusicStyle, setMusicOnlyCurrentSession, setTranscribeSettings, useStore, actions, useSessions, }: TokenQuotaPanelComponentProps): import("react").JSX.Element;
 //# sourceMappingURL=TokenQuotaPanel.d.ts.map

package/lib/types/client/TokenQuotaPanel.js

@@ -149,7 +149,7 @@ function loadPanelPos() {
  * @param props - composed slot props.
  * @returns the panel element tree.
  */
-export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle, setModelOrder, saveNotes, setBalanceSettings, refreshBalance, setMusicEnabled, setMusicVolume, setMusicStyle, setMusicOnlyCurrentSession, useStore, actions, useSessions, }) {
+export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle, setModelOrder, saveNotes, setBalanceSettings, refreshBalance, setMusicEnabled, setMusicVolume, setMusicStyle, setMusicOnlyCurrentSession, setTranscribeSettings, useStore, actions, useSessions, }) {
     const [collapsed, setCollapsed] = useState(false);
     const [drafts, setDrafts] = useState({});
     const [editingKey, setEditingKey] = useState(null);
@@ -357,6 +357,7 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
     const musicVolume = useStore(s => s.musicVolume);
     const musicStyle = useStore(s => s.musicStyle);
     const musicOnlyCurrentSession = useStore(s => s.musicOnlyCurrentSession);
+    const transcribe = useStore(s => s.transcribe);
     const upgrade = useStore(s => s.upgrade);
     const upgradeDismissed = useStore(s => s.upgradeDismissed);
     const checkingUpdates = useStore(s => s.checkingUpdates);
@@ -790,7 +791,7 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
                                                                 : _jsx(_Fragment, { children: quotaText(row) });
                                                         })(), _jsx("button", { type: "button", className: css.gearBtn, title: t('setLimitHint'), onClick: () => { setEditingKey(editing ? null : row.key); }, children: "\u2699" })] })] }), _jsx("div", { className: css.bar, children: _jsx("div", { className: barClass, style: { width: `${pct}%` } }) }), editing && (_jsxs("div", { className: css.controls, children: [_jsx("input", { className: css.input, type: "number", min: 0, step: 10000, placeholder: t('limitPlaceholder'), value: drafts[row.key] ?? '', onChange: (event) => { setDrafts(prev => ({ ...prev, [row.key]: event.target.value })); }, onKeyDown: (event) => { if (event.key === 'Enter')
                                                         commitLimit(row); } }), _jsx("button", { type: "button", className: css.save, onClick: () => { commitLimit(row); }, children: t('save') })] }))] }, row.key));
-                            })] })] }), dialogOpen && (_jsxs("div", { ref: settingsRef, className: `${css.dialog} ${css.settingsDialog}`, style: settingsPos !== null ? { left: settingsPos.x, top: settingsPos.y, transform: 'none' } : undefined, children: [_jsxs("div", { className: css.dialogHeader, onPointerDown: (event) => { beginDrag(event, settingsRef.current, setSettingsPos); }, children: [_jsx("div", { className: css.dialogTitle, children: t('settingsTitle') }), _jsx("button", { type: "button", className: css.dialogClose, title: t('close'), onClick: () => { actions.setDialogOpen(false); }, onPointerDown: (event) => { event.stopPropagation(); }, children: "\u00D7" })] }), _jsxs("div", { className: css.dialogTabs, role: "tablist", children: [_jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'quota', className: `${css.dialogTab}${settingsTab === 'quota' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('quota'); }, children: t('settingsTabQuota') }), _jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'music', className: `${css.dialogTab}${settingsTab === 'music' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('music'); }, children: t('settingsTabMusic') }), _jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'other', className: `${css.dialogTab}${settingsTab === 'other' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('other'); }, children: t('settingsTabOther') })] }), settingsTab === 'quota' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsx("div", { className: css.dialogLabel, children: t('monitorLabel') }), _jsx("div", { className: css.monitorHint, children: t('monitorHint') }), _jsx("div", { className: css.monitorList, children: allModels.map(model => (_jsxs("label", { className: css.monitorRow, children: [_jsx("input", { type: "checkbox", checked: monitored === null || monitored.includes(model.key), onChange: (event) => {
+                            })] })] }), dialogOpen && (_jsxs("div", { ref: settingsRef, className: `${css.dialog} ${css.settingsDialog}`, style: settingsPos !== null ? { left: settingsPos.x, top: settingsPos.y, transform: 'none' } : undefined, children: [_jsxs("div", { className: css.dialogHeader, onPointerDown: (event) => { beginDrag(event, settingsRef.current, setSettingsPos); }, children: [_jsx("div", { className: css.dialogTitle, children: t('settingsTitle') }), _jsx("button", { type: "button", className: css.dialogClose, title: t('close'), onClick: () => { actions.setDialogOpen(false); }, onPointerDown: (event) => { event.stopPropagation(); }, children: "\u00D7" })] }), _jsxs("div", { className: css.dialogTabs, role: "tablist", children: [_jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'quota', className: `${css.dialogTab}${settingsTab === 'quota' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('quota'); }, children: t('settingsTabQuota') }), _jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'music', className: `${css.dialogTab}${settingsTab === 'music' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('music'); }, children: t('settingsTabMusic') }), _jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'transcribe', className: `${css.dialogTab}${settingsTab === 'transcribe' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('transcribe'); }, children: t('settingsTabTranscribe') }), _jsx("button", { type: "button", role: "tab", "aria-selected": settingsTab === 'other', className: `${css.dialogTab}${settingsTab === 'other' ? ` ${css.dialogTabActive}` : ''}`, onClick: () => { setSettingsTab('other'); }, children: t('settingsTabOther') })] }), settingsTab === 'quota' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsx("div", { className: css.dialogLabel, children: t('monitorLabel') }), _jsx("div", { className: css.monitorHint, children: t('monitorHint') }), _jsx("div", { className: css.monitorList, children: allModels.map(model => (_jsxs("label", { className: css.monitorRow, children: [_jsx("input", { type: "checkbox", checked: monitored === null || monitored.includes(model.key), onChange: (event) => {
                                                         const base = monitored === null ? allModels.map(m => m.key) : monitored;
                                                         const next = new Set(base);
                                                         if (event.target.checked)
@@ -817,7 +818,7 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
                                                         hour: reset?.hour ?? 0,
                                                         minute: Number(event.target.value),
                                                     });
-                                                }, children: Array.from({ length: 12 }, (_, i) => i * 5).map(minute => (_jsxs("option", { value: minute, children: [String(minute).padStart(2, '0'), " \u5206"] }, minute))) })] })] }), _jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: dimWhenIdle, onChange: (event) => { setDimWhenIdle(event.target.checked); } }), _jsx("span", { children: t('dimWhenIdleLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('dimWhenIdleHint') })] })] })), settingsTab === 'music' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: musicEnabled, onChange: (event) => { setMusicEnabled(event.target.checked); } }), _jsx("span", { children: t('musicLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('musicHint') })] }), musicEnabled && (_jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('musicVolume') }), _jsx("input", { type: "range", min: 0, max: 1, step: 0.05, value: musicVolume, onChange: (event) => { setMusicVolume(Number(event.target.value)); } })] }), _jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('musicStyle') }), _jsxs("select", { value: musicStyle, onChange: (event) => { setMusicStyle(event.target.value); }, children: [_jsx("option", { value: "major", children: t('musicStyleMajor') }), _jsx("option", { value: "minor", children: t('musicStyleMinor') }), _jsx("option", { value: "pentatonic", children: t('musicStylePentatonic') })] })] }), _jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: musicOnlyCurrentSession, onChange: (event) => { setMusicOnlyCurrentSession(event.target.checked); } }), _jsx("span", { children: t('musicOnlyCurrentSessionLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('musicOnlyCurrentSessionHint') })] }))] })), settingsTab === 'other' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsxs("div", { className: css.checkUpdatesRow, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: checkUpdates, onChange: (event) => { setCheckUpdates(event.target.checked); } }), _jsx("span", { children: t('checkUpdatesLabel') })] }), _jsx("button", { type: "button", className: css.checkBtn, disabled: checkingUpdates, onClick: checkUpdatesNow, children: checkingUpdates
+                                                }, children: Array.from({ length: 12 }, (_, i) => i * 5).map(minute => (_jsxs("option", { value: minute, children: [String(minute).padStart(2, '0'), " \u5206"] }, minute))) })] })] }), _jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: dimWhenIdle, onChange: (event) => { setDimWhenIdle(event.target.checked); } }), _jsx("span", { children: t('dimWhenIdleLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('dimWhenIdleHint') })] })] })), settingsTab === 'music' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: musicEnabled, onChange: (event) => { setMusicEnabled(event.target.checked); } }), _jsx("span", { children: t('musicLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('musicHint') })] }), musicEnabled && (_jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('musicVolume') }), _jsx("input", { type: "range", min: 0, max: 1, step: 0.05, value: musicVolume, onChange: (event) => { setMusicVolume(Number(event.target.value)); } })] }), _jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('musicStyle') }), _jsxs("select", { value: musicStyle, onChange: (event) => { setMusicStyle(event.target.value); }, children: [_jsx("option", { value: "major", children: t('musicStyleMajor') }), _jsx("option", { value: "minor", children: t('musicStyleMinor') }), _jsx("option", { value: "pentatonic", children: t('musicStylePentatonic') })] })] }), _jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: musicOnlyCurrentSession, onChange: (event) => { setMusicOnlyCurrentSession(event.target.checked); } }), _jsx("span", { children: t('musicOnlyCurrentSessionLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('musicOnlyCurrentSessionHint') })] }))] })), settingsTab === 'transcribe' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: transcribe.enabled, onChange: (event) => { setTranscribeSettings({ ...transcribe, enabled: event.target.checked }); } }), _jsx("span", { children: t('transcribeEnabledLabel') })] }), _jsx("div", { className: css.dialogHint, children: t('transcribeEnabledHint') })] }), transcribe.enabled && (_jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('transcribeBaseURLLabel') }), _jsx("input", { className: css.resetSelect, type: "text", value: transcribe.baseURL, onChange: (event) => { setTranscribeSettings({ ...transcribe, baseURL: event.target.value }); } })] }), _jsx("div", { className: css.dialogHint, children: t('transcribeBaseURLHint') }), _jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('transcribeApiKeyEnvLabel') }), _jsx("input", { className: css.resetSelect, type: "text", value: transcribe.apiKeyEnv, onChange: (event) => { setTranscribeSettings({ ...transcribe, apiKeyEnv: event.target.value }); } })] }), _jsx("div", { className: css.dialogHint, children: t('transcribeApiKeyEnvHint') }), _jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("span", { children: t('transcribeModelLabel') }), _jsx("input", { className: css.resetSelect, type: "text", value: transcribe.model, onChange: (event) => { setTranscribeSettings({ ...transcribe, model: event.target.value }); } })] }), _jsx("div", { className: css.dialogHint, children: t('transcribeModelHint') })] }))] })), settingsTab === 'other' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.dialogSection, children: [_jsxs("div", { className: css.checkUpdatesRow, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: checkUpdates, onChange: (event) => { setCheckUpdates(event.target.checked); } }), _jsx("span", { children: t('checkUpdatesLabel') })] }), _jsx("button", { type: "button", className: css.checkBtn, disabled: checkingUpdates, onClick: checkUpdatesNow, children: checkingUpdates
                                                     ? t('checkingUpdates')
                                                     : lastCheckResult === 'up-to-date'
                                                         ? t('checkUpToDate')

package/lib/types/client/index.d.ts

@@ -15,6 +15,7 @@
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type TokenQuotaKey } from './locales.ts';
 export type { TokenQuotaPanelInjected } from './TokenQuotaPanel.tsx';
+export type { TokenQuotaMicInjected } from './mic.tsx';
 export type { ModelQuotaRow, TokenQuotaPanelState } from './store.ts';
 export { mergeModelRows } from './store.ts';
 export type { TokenQuotaKey } from './locales.ts';

package/lib/types/client/index.js

@@ -1,7 +1,8 @@
-import { TOKEN_QUOTA_MAX_NOTES } from '@jxgame2020/dsh-token-quota/types';
+import { TOKEN_QUOTA_MAX_NOTES, TOKEN_QUOTA_DEFAULT_TRANSCRIBE } from '@jxgame2020/dsh-token-quota/types';
 import { createTokenQuotaPanelStore } from "./store.js";
 import { TokenQuotaPanel } from "./TokenQuotaPanel.js";
 import { TokenQuotaMusic } from "./music.js";
+import { TokenQuotaMic } from "./mic.js";
 import { en, zh } from "./locales.js";
 export { mergeModelRows } from "./store.js";
 /** Dictionary namespace owning the panel copy. */
@@ -121,6 +122,13 @@ export function apply(ctx) {
         style: raw?.style ?? 'pentatonic',
         onlyCurrentSession: raw?.onlyCurrentSession ?? true,
     });
+    /** Build a writable transcription-settings clone with defaults applied. */
+    const transcribeDefaults = (raw) => ({
+        enabled: raw?.enabled ?? TOKEN_QUOTA_DEFAULT_TRANSCRIBE.enabled,
+        baseURL: typeof raw?.baseURL === 'string' && raw.baseURL !== '' ? raw.baseURL : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.baseURL,
+        apiKeyEnv: typeof raw?.apiKeyEnv === 'string' && raw.apiKeyEnv !== '' ? raw.apiKeyEnv : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.apiKeyEnv,
+        model: typeof raw?.model === 'string' && raw.model !== '' ? raw.model : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.model,
+    });
     const keyOf = (selection) => {
         if (selection === null)
             return undefined;
@@ -291,6 +299,10 @@ export function apply(ctx) {
         bound?.setMusicVolume(musicSettings.volume);
         bound?.setMusicStyle(musicSettings.style);
         bound?.setMusicOnlyCurrentSession(musicSettings.onlyCurrentSession);
+        const transcribeRaw = doc?.transcribe;
+        const resolvedTranscribe = transcribeDefaults(transcribeRaw);
+        applyTranscribe(resolvedTranscribe);
+        bound?.setTranscribeSettings(resolvedTranscribe);
         void fetch('/token-quota', { headers: { accept: 'application/json' } }).then((response) => {
             if (!response.ok) {
                 bound?.setError(`quota route: ${String(response.status)}`);
@@ -378,6 +390,52 @@ export function apply(ctx) {
         bound?.setBalanceSettings(enabled, pollMinutes);
         void scope.set('balance', { enabled, pollMinutes });
     };
+    /** Persist the voice transcription settings and mirror them into the store. */
+    // --- Transcription settings source (independent of the panel store, so the
+    //     mic entry — mounted in the session-scoped conversation.input.overlay
+    //     slot — can subscribe without sharing the panel's root-scoped store
+    //     instance (which would fork state across scopes). ---
+    let currentTranscribe = TOKEN_QUOTA_DEFAULT_TRANSCRIBE;
+    const transcribeSubscribers = new Set();
+    const emitTranscribe = () => { for (const fn of transcribeSubscribers)
+        fn(); };
+    const subscribeTranscribe = (cb) => {
+        transcribeSubscribers.add(cb);
+        return () => { transcribeSubscribers.delete(cb); };
+    };
+    const getTranscribe = () => currentTranscribe;
+    const applyTranscribe = (settings) => {
+        if (settings.enabled === currentTranscribe.enabled
+            && settings.baseURL === currentTranscribe.baseURL
+            && settings.apiKeyEnv === currentTranscribe.apiKeyEnv
+            && settings.model === currentTranscribe.model)
+            return;
+        currentTranscribe = settings;
+        emitTranscribe();
+    };
+    const setTranscribeSettings = (settings) => {
+        applyTranscribe(settings);
+        bound?.setTranscribeSettings(settings);
+        void scope.set('transcribe', settings);
+    };
+    /**
+     * Send a recorded audio blob to the Host, which forwards it to the
+     * configured OpenAI-compatible transcription endpoint. Resolves with the
+     * recognised text.
+     */
+    const transcribe = async (blob) => {
+        const res = await fetch('/token-quota/transcribe', {
+            method: 'POST',
+            headers: { 'content-type': blob.type !== '' ? blob.type : 'application/octet-stream' },
+            body: blob,
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(detail !== '' ? detail : `transcription HTTP ${res.status}`);
+        }
+        const data = await res.json();
+        return typeof data.text === 'string' ? data.text : '';
+    };
     /**
      * Ask the Host to refresh account balances now and adopt the result.
      * With a provider key only that provider is refreshed; otherwise all of
@@ -514,6 +572,7 @@ export function apply(ctx) {
             setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle,
             setMusicEnabled, setMusicVolume, setMusicStyle, setMusicOnlyCurrentSession,
             setModelOrder, saveNotes, setBalanceSettings, refreshBalance,
+            setTranscribeSettings,
         };
     };
     ctx.slots.inject('shell.overlay', () => ctx.slots.register({
@@ -525,5 +584,26 @@ export function apply(ctx) {
         locale: NS,
         inject: injected,
     }, TokenQuotaPanel));
+    // Mic button inside the chat composer (top-right corner). Only renders when
+    // transcription is enabled in settings; a press starts recording, a second
+    // press stops and sends the audio to the Host for transcription, then the
+    // recognised text is appended to the composer.
+    // NOTE: This entry is scoped to a session (not root), so it cannot share the
+    // panel's root-scoped store handle without forking a separate per-session
+    // instance. Instead it subscribes to a tiny transcribe-only observable and
+    // receives the locale-bound `t` function through injection.
+    ctx.slots.inject('conversation.input.overlay', () => ctx.slots.register({
+        name: 'conversation.input.overlay',
+        id: 'token-quota-mic',
+        order: 100,
+        label: () => t('transcribeTitle'),
+        inject: (_sessionId) => ({
+            transcribe,
+            setTranscribeSettings,
+            subscribeTranscribe,
+            getTranscribe,
+            t: t,
+        }),
+    }, TokenQuotaMic));
 }
 //# sourceMappingURL=index.js.map

package/lib/types/client/locales.d.ts

@@ -27,7 +27,20 @@ export declare const zh: {
     settingsTitle: string;
     settingsTabQuota: string;
     settingsTabMusic: string;
+    settingsTabTranscribe: string;
     settingsTabOther: string;
+    transcribeTitle: string;
+    transcribeHint: string;
+    transcribeMicDenied: string;
+    transcribeEmpty: string;
+    transcribeEnabledLabel: string;
+    transcribeEnabledHint: string;
+    transcribeBaseURLLabel: string;
+    transcribeBaseURLHint: string;
+    transcribeApiKeyEnvLabel: string;
+    transcribeApiKeyEnvHint: string;
+    transcribeModelLabel: string;
+    transcribeModelHint: string;
     reorderHint: string;
     balanceLabel: string;
     balanceUnconfigured: string;
@@ -145,7 +158,20 @@ export declare const en: {
     settingsTitle: string;
     settingsTabQuota: string;
     settingsTabMusic: string;
+    settingsTabTranscribe: string;
     settingsTabOther: string;
+    transcribeTitle: string;
+    transcribeHint: string;
+    transcribeMicDenied: string;
+    transcribeEmpty: string;
+    transcribeEnabledLabel: string;
+    transcribeEnabledHint: string;
+    transcribeBaseURLLabel: string;
+    transcribeBaseURLHint: string;
+    transcribeApiKeyEnvLabel: string;
+    transcribeApiKeyEnvHint: string;
+    transcribeModelLabel: string;
+    transcribeModelHint: string;
     reorderHint: string;
     balanceLabel: string;
     balanceUnconfigured: string;

package/lib/types/client/locales.js

@@ -27,7 +27,20 @@ export const zh = {
     settingsTitle: '设置',
     settingsTabQuota: '限额设置',
     settingsTabMusic: '音乐设置',
+    settingsTabTranscribe: '转录',
     settingsTabOther: '其它',
+    transcribeTitle: '语音转录',
+    transcribeHint: '按下麦克风录音，再按一次停止并转录为文字',
+    transcribeMicDenied: '未获得麦克风权限',
+    transcribeEmpty: '录音为空',
+    transcribeEnabledLabel: '启用语音转录',
+    transcribeEnabledHint: '在对话框右上角显示麦克风按钮',
+    transcribeBaseURLLabel: '接口地址',
+    transcribeBaseURLHint: 'OpenAI 兼容的转录接口 base URL',
+    transcribeApiKeyEnvLabel: 'API Key 环境变量',
+    transcribeApiKeyEnvHint: '存有 API Key 的凭证变量名（在 Models 页或 credentials 配置）',
+    transcribeModelLabel: '模型',
+    transcribeModelHint: '语音转文本模型名',
     reorderHint: '拖动排序',
     balanceLabel: '余额',
     balanceUnconfigured: '未配置 DeepSeek API Key',
@@ -143,7 +156,20 @@ export const en = {
     settingsTitle: 'Settings',
     settingsTabQuota: 'Quota',
     settingsTabMusic: 'Music',
+    settingsTabTranscribe: 'Transcribe',
     settingsTabOther: 'Other',
+    transcribeTitle: 'Voice transcription',
+    transcribeHint: 'Press the mic to record; press again to stop and transcribe to text',
+    transcribeMicDenied: 'Microphone access denied',
+    transcribeEmpty: 'Recording was empty',
+    transcribeEnabledLabel: 'Enable voice transcription',
+    transcribeEnabledHint: 'Show a mic button in the top-right of the composer',
+    transcribeBaseURLLabel: 'Base URL',
+    transcribeBaseURLHint: 'OpenAI-compatible transcription endpoint base URL',
+    transcribeApiKeyEnvLabel: 'API key env var',
+    transcribeApiKeyEnvHint: 'Credential variable name holding the API key (Models page or credentials)',
+    transcribeModelLabel: 'Model',
+    transcribeModelHint: 'Speech-to-text model name',
     reorderHint: 'Drag to reorder',
     balanceLabel: 'Balance',
     balanceUnconfigured: 'No DeepSeek API key',

package/lib/types/client/mic.d.ts

@@ -0,0 +1,23 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { TokenQuotaTranscribeSettings } from '@jxgame2020/dsh-token-quota/types';
+/** Injected business face: transcription send + settings subscription. */
+export interface TokenQuotaMicInjected {
+    /** Send a recorded audio blob to the Host for transcription. */
+    transcribe: (blob: Blob) => Promise<string>;
+    /** Persist the transcription settings (the panel owns the settings UI). */
+    setTranscribeSettings: (settings: TokenQuotaTranscribeSettings) => void;
+    /** Subscribe to transcribe settings changes (returns an unsubscribe). */
+    subscribeTranscribe: (cb: () => void) => () => void;
+    /** Read the current transcribe settings snapshot. */
+    getTranscribe: () => TokenQuotaTranscribeSettings;
+    /** Locale-bound translate function. */
+    t: (key: string) => string;
+}
+/** Full mic component props: runtime + injected face (no store/locale shares). */
+export type TokenQuotaMicComponentProps = PropsRuntime<'conversation.input.overlay'> & TokenQuotaMicInjected;
+/**
+ * Mic button rendered inside the composer card. Manages its own MediaRecorder
+ * lifecycle; only the button is shown — no floating panel UI.
+ */
+export declare function TokenQuotaMic({ t, transcribe, subscribeTranscribe, getTranscribe, }: TokenQuotaMicComponentProps): JSX.Element | null;
+//# sourceMappingURL=mic.d.ts.map