@jxgame2020/dsh-token-quota 0.1.39 → 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) {
@@ -276,23 +288,8 @@ function defaultStoragePath() {
 function usageTokens(usage) {
 	return usage.inputTokens + (usage.cacheReadTokens ?? 0) + (usage.cacheWriteTokens ?? 0) + usage.outputTokens;
 }
-/**
-* Daily token-quota service.
-*
-* Mount it beside the other rows (`@jxgame2020/dsh-token-quota`) and write
-* per-model limits through the `token-quota` settings namespace.
-*/
-/**
-* Providers the host can query for account balance, keyed by route key. Each
-* entry names the credential reference (environment-variable name), the
-* balance endpoint base, and the optional `*_BASE_URL` override variable.
-* Directory providers outside this map render as "not integrated for query".
-*/
-const BALANCE_SOURCES = { deepseek: {
-	keyEnv: "DEEPSEEK_API_KEY",
-	baseURL: "https://api.deepseek.com",
-	baseEnv: "DEEPSEEK_BASE_URL"
-} };
+/** DeepSeek's public API host; used to recognise DeepSeek-family providers. */
+const DEEPSEEK_BALANCE_HOST = "api.deepseek.com";
 var TokenQuotaService = class TokenQuotaService extends Service {
 	static Config = z.object({ storagePath: z.string().default("") });
 	storagePath;
@@ -315,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;
@@ -353,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. */
@@ -383,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 [{
@@ -525,7 +531,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 							if (typeof parsed === "object" && parsed !== null && typeof parsed.provider === "string") provider = parsed.provider;
 						}
 					} catch {}
-					(provider !== void 0 && provider in BALANCE_SOURCES ? this.refreshProviderBalance(provider) : this.refreshAllBalances()).finally(() => {
+					(provider !== void 0 ? this.refreshProviderBalance(provider) : this.refreshAllBalances()).finally(() => {
 						const body = JSON.stringify(this.readSnapshot());
 						res.writeHead(200, {
 							"content-type": "application/json",
@@ -536,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",
@@ -619,7 +651,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		return this.upgradeCheck;
 	}
 	async doRefreshUpgrade() {
-		const current = "0.1.39";
+		const current = "0.1.41";
 		let latest;
 		try {
 			const response = await fetch(REGISTRY_LATEST_URL, {
@@ -692,9 +724,46 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		};
 		schedule();
 	}
-	/** Refresh every provider the host knows how to query. */
+	/** Refresh every DeepSeek-family provider found in the model directory. */
 	refreshAllBalances() {
-		return Promise.all(Object.keys(BALANCE_SOURCES).map((provider) => this.refreshProviderBalance(provider))).then(() => void 0);
+		return Promise.all([...this.discoverBalanceSources().values()].map((source) => this.refreshProviderBalance(source.provider, source))).then(() => void 0);
+	}
+	/**
+	* Discover every provider in the model directory that looks like DeepSeek,
+	* together with its own credential reference and endpoint base. This is what
+	* decides which providers are queried: a provider qualifies when its base URL
+	* points at DeepSeek's API host or its credential reference is named with the
+	* `DEEPSEEK` prefix, and it must declare an `apiKeyEnv`.
+	*/
+	discoverBalanceSources() {
+		const found = /* @__PURE__ */ new Map();
+		const llm = this.ctx.get("llm");
+		const settings = this.ctx.get("settings");
+		const fallback = () => ({
+			provider: "deepseek",
+			keyEnv: "DEEPSEEK_API_KEY",
+			baseURL: process.env.DEEPSEEK_BASE_URL ?? `https://${DEEPSEEK_BALANCE_HOST}`
+		});
+		if (llm?.listConfigurableProviders === void 0) {
+			found.set("deepseek", fallback());
+			return found;
+		}
+		for (const entry of llm.listConfigurableProviders()) try {
+			let profile = settings?.get(entry.settingsNs);
+			for (const segment of entry.settingsPath ?? []) profile = profile !== null && typeof profile === "object" ? profile[segment] : void 0;
+			if (profile === null || typeof profile !== "object") continue;
+			const record = profile;
+			const keyEnv = typeof record.apiKeyEnv === "string" && record.apiKeyEnv !== "" ? record.apiKeyEnv : void 0;
+			const baseURL = typeof record.baseURL === "string" && record.baseURL !== "" ? record.baseURL : void 0;
+			if (!(baseURL !== void 0 && baseURL.includes(DEEPSEEK_BALANCE_HOST) || keyEnv !== void 0 && keyEnv.startsWith("DEEPSEEK") || entry.provider.startsWith("deepseek")) || keyEnv === void 0) continue;
+			found.set(entry.provider, {
+				provider: entry.provider,
+				keyEnv,
+				baseURL: baseURL ?? `https://${DEEPSEEK_BALANCE_HOST}`
+			});
+		} catch {}
+		if (found.size === 0) found.set("deepseek", fallback());
+		return found;
 	}
 	/**
 	* Refresh one provider's cached account balance. The API key is resolved
@@ -702,9 +771,9 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 	* environment as a fallback, so the Models page key is used with nothing to
 	* type. A failed fetch keeps the previous value and marks it as an error.
 	*/
-	async refreshProviderBalance(provider) {
-		const source = BALANCE_SOURCES[provider];
-		if (source === void 0) return;
+	async refreshProviderBalance(provider, source) {
+		const resolved = source ?? this.discoverBalanceSources().get(provider);
+		if (resolved === void 0) return;
 		const existing = this.balanceFetches.get(provider);
 		if (existing !== void 0) return existing;
 		const run = async () => {
@@ -712,9 +781,9 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 			const credentials = this.ctx.get("credentials");
 			let key;
 			if (credentials !== void 0) try {
-				key = (await credentials.resolve(source.keyEnv))?.value;
+				key = (await credentials.resolve(resolved.keyEnv))?.value;
 			} catch {}
-			if (key === void 0 || key === "") key = process.env[source.keyEnv];
+			if (key === void 0 || key === "") key = process.env[resolved.keyEnv];
 			if (key === void 0 || key === "") {
 				this.balances.set(provider, {
 					provider,
@@ -726,7 +795,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 				});
 				return;
 			}
-			const base = source.baseEnv !== void 0 ? process.env[source.baseEnv] ?? source.baseURL : source.baseURL;
+			const base = resolved.baseURL;
 			try {
 				const controller = new AbortController();
 				const timer = setTimeout(() => {
@@ -783,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();
@@ -1087,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

@@ -10,7 +10,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * callbacks.
  */
 import { useEffect, useMemo, useRef, useState } from 'react';
-import { TOKEN_QUOTA_BALANCE_PROVIDERS, TOKEN_QUOTA_MAX_NOTES } from '@jxgame2020/dsh-token-quota/types';
+import { TOKEN_QUOTA_MAX_NOTES } from '@jxgame2020/dsh-token-quota/types';
 import { mergeModelRows, reorderKeys } from "./store.js";
 import css from './TokenQuotaPanel.module.css';
 /** Compact a token count for display. */
@@ -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);
@@ -543,9 +544,10 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
             list.push('deepseek');
         return list;
     }, [groups]);
-    // Balance by provider key, built from the snapshot (status ok/error/unconfigured)
-    // plus a client-side "unsupported" sentinel for providers the Host does not
-    // yet know how to query, and "loading" for supported ones not yet returned.
+    // Balance by provider key. The Host returns a balances entry for every
+    // provider it can query (DeepSeek-family), so a directory provider with no
+    // entry is "not integrated for query" — except during the very first fetch,
+    // when the whole list is still empty and reads as "loading" instead.
     const balanceByProvider = useMemo(() => {
         const map = new Map();
         for (const provider of providers) {
@@ -553,7 +555,7 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
             if (bal !== undefined) {
                 map.set(provider, bal);
             }
-            else if (TOKEN_QUOTA_BALANCE_PROVIDERS.includes(provider)) {
+            else if (balances.length === 0) {
                 map.set(provider, 'loading');
             }
             else {
@@ -789,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)
@@ -816,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