@jxgame2020/dsh-token-quota 0.1.40 → 0.1.41

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.41";
 		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,7 @@ export function apply(ctx) {
         bound?.setMusicVolume(musicSettings.volume);
         bound?.setMusicStyle(musicSettings.style);
         bound?.setMusicOnlyCurrentSession(musicSettings.onlyCurrentSession);
+        bound?.setTranscribeSettings(transcribeDefaults(doc?.transcribe));
         void fetch('/token-quota', { headers: { accept: 'application/json' } }).then((response) => {
             if (!response.ok) {
                 bound?.setError(`quota route: ${String(response.status)}`);
@@ -378,6 +387,29 @@ 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. */
+    const setTranscribeSettings = (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 +546,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 +558,21 @@ 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.
+    ctx.slots.inject('conversation.input.overlay', () => ctx.slots.register({
+        name: 'conversation.input.overlay',
+        id: 'token-quota-mic',
+        order: 100,
+        label: () => t('transcribeTitle'),
+        store,
+        locale: NS,
+        inject: (_sessionId, micActions) => {
+            bound = micActions;
+            return { transcribe, setTranscribeSettings };
+        },
+    }, 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,19 @@
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import { TOKEN_QUOTA_NAMESPACE } from '@jxgame2020/dsh-token-quota/types';
+import type { TokenQuotaTranscribeSettings } from '@jxgame2020/dsh-token-quota/types';
+import type { createTokenQuotaPanelStore } from './store.ts';
+/** Injected business face: transcription send + settings persistence. */
+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;
+}
+/** Full mic component props: runtime + store + locale + injected face. */
+export type TokenQuotaMicComponentProps = PropsRuntime<'conversation.input.overlay'> & PropsStore<ReturnType<typeof createTokenQuotaPanelStore>> & PropsLocale<typeof TOKEN_QUOTA_NAMESPACE> & 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, useStore, transcribe, }: TokenQuotaMicComponentProps): JSX.Element | null;
+//# sourceMappingURL=mic.d.ts.map

package/lib/types/client/mic.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Composer mic button: registered into `conversation.input.overlay` so it sits
+ * inside the chat composer card (top-right corner). A press starts recording
+ * from the microphone; a second press stops it and sends the audio blob to the
+ * Host, which forwards it to the configured OpenAI-compatible transcription
+ * endpoint. The returned text is appended to the composer. The button only
+ * renders while transcription is enabled in the token-quota settings.
+ */
+import { useEffect, useRef, useState } from 'react';
+import css from './mic.module.css';
+/**
+ * Append recognised text to the contentEditable composer. Focuses the editor,
+ * moves the caret to the end, and uses `insertText` so the host editor's own
+ * input handling (undo, model binding) sees it as a typed insertion.
+ */
+function appendToComposer(text) {
+    const editor = document.querySelector('[data-composer-input]');
+    if (editor === null) {
+        // No composer on this page — copy to the clipboard as a fallback.
+        void navigator.clipboard?.writeText(text).catch(() => { });
+        return;
+    }
+    editor.focus();
+    // Move the caret to the end of the editor's text content.
+    const selection = window.getSelection();
+    if (selection !== null) {
+        const range = document.createRange();
+        range.selectNodeContents(editor);
+        range.collapse(false);
+        selection.removeAllRanges();
+        selection.addRange(range);
+    }
+    // execCommand is deprecated but remains the only cross-browser way to trigger
+    // a contentEditable editor's own "typed text" handling (undo stack, lexical
+    // binding). The host composer listens to it.
+    let inserted = false;
+    try {
+        inserted = document.execCommand('insertText', false, text);
+    }
+    catch {
+        // Some engines throw on execCommand; fall through to the manual path.
+    }
+    if (!inserted) {
+        editor.appendChild(document.createTextNode(text));
+    }
+}
+/**
+ * Mic button rendered inside the composer card. Manages its own MediaRecorder
+ * lifecycle; only the button is shown — no floating panel UI.
+ */
+export function TokenQuotaMic({ t, useStore, transcribe, }) {
+    const enabled = useStore(s => s.transcribe.enabled);
+    const [recording, setRecording] = useState(false);
+    const [transcribing, setTranscribing] = useState(false);
+    const [error, setError] = useState(null);
+    const mediaRecorderRef = useRef(null);
+    const chunksRef = useRef([]);
+    const streamRef = useRef(null);
+    const errorTimerRef = useRef(undefined);
+    // Clean up the recorder / stream on unmount so a navigation while recording
+    // stops the mic tracks rather than leaving them open.
+    useEffect(() => {
+        return () => {
+            if (errorTimerRef.current !== undefined)
+                clearTimeout(errorTimerRef.current);
+            cleanupRecording();
+        };
+    }, []);
+    const cleanupRecording = () => {
+        if (streamRef.current !== null) {
+            for (const track of streamRef.current.getTracks())
+                track.stop();
+            streamRef.current = null;
+        }
+        mediaRecorderRef.current = null;
+        chunksRef.current = [];
+    };
+    const showError = (message) => {
+        setError(message);
+        if (errorTimerRef.current !== undefined)
+            clearTimeout(errorTimerRef.current);
+        errorTimerRef.current = setTimeout(() => {
+            setError(null);
+            errorTimerRef.current = undefined;
+        }, 4000);
+    };
+    const startRecording = async () => {
+        let stream;
+        try {
+            stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+        }
+        catch {
+            showError(t('transcribeMicDenied'));
+            return;
+        }
+        streamRef.current = stream;
+        chunksRef.current = [];
+        const mimeType = MediaRecorder.isTypeSupported('audio/webm;codecs=opus')
+            ? 'audio/webm;codecs=opus'
+            : MediaRecorder.isTypeSupported('audio/webm')
+                ? 'audio/webm'
+                : '';
+        const recorder = mimeType !== ''
+            ? new MediaRecorder(stream, { mimeType })
+            : new MediaRecorder(stream);
+        mediaRecorderRef.current = recorder;
+        recorder.ondataavailable = (event) => {
+            if (event.data.size > 0)
+                chunksRef.current.push(event.data);
+        };
+        recorder.onstop = () => {
+            const type = mimeType !== '' ? mimeType : 'audio/webm';
+            const blob = new Blob(chunksRef.current, { type });
+            cleanupRecording();
+            if (blob.size === 0) {
+                showError(t('transcribeEmpty'));
+                return;
+            }
+            setTranscribing(true);
+            void transcribe(blob).then((text) => {
+                setTranscribing(false);
+                if (text.trim() !== '')
+                    appendToComposer(text);
+            }, (err) => {
+                setTranscribing(false);
+                showError(err instanceof Error ? err.message : String(err));
+            });
+        };
+        recorder.start();
+        setRecording(true);
+    };
+    const stopAndTranscribe = () => {
+        const recorder = mediaRecorderRef.current;
+        if (recorder !== null && recorder.state !== 'inactive') {
+            recorder.stop();
+        }
+        else {
+            cleanupRecording();
+        }
+        setRecording(false);
+    };
+    const onToggle = () => {
+        if (transcribing)
+            return;
+        if (recording) {
+            stopAndTranscribe();
+        }
+        else {
+            void startRecording();
+        }
+    };
+    if (!enabled)
+        return null;
+    const state = transcribing ? 'busy' : recording ? 'rec' : 'idle';
+    return (_jsxs("div", { className: css.micWrap, title: error ?? t('transcribeHint'), children: [_jsx("button", { type: "button", className: `${css.micBtn}${state === 'rec' ? ` ${css.micRec}` : ''}${state === 'busy' ? ` ${css.micBusy}` : ''}${error !== null ? ` ${css.micErr}` : ''}`, disabled: transcribing, onClick: (event) => { event.stopPropagation(); onToggle(); }, onPointerDown: (event) => { event.stopPropagation(); }, "aria-pressed": recording, "aria-label": error ?? t('transcribeTitle'), children: transcribing ? '…' : '🎤' }), error !== null && _jsx("span", { className: css.micErrTip, children: error })] }));
+}
+//# sourceMappingURL=mic.js.map