dsh-openrouter-provider-advisor 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+## [0.1.2] - 2026-08-24
+
+### Added
+
+- Switch history with the provider pair and before/after throughput of each switch, persisted across sessions and offering one-click revert.
+- Recommendation freshness line showing how long ago the ranking data was fetched.
+
+### Changed
+
+- The panel now remembers the last ranking strategy across close, reopen, and reload instead of resetting to Best overall.
+- Applying a provider removes the plugin's own stale `@preset/` entries for the same OpenRouter model, so repeated switching no longer accumulates near-duplicate models. User-authored model entries are left untouched.
+- Neutral panel colors follow the host `--dsw-alias-*` theme tokens, with the previous dark values as fallbacks.
+
+### Fixed
+
+- The provider dialog closes on Escape, traps Tab focus inside itself, and returns focus to the trigger button on close.
+
+### Validation
+
+- 79 automated tests passing.
+- TypeScript typecheck and production build passing.
+- `npm audit --omit=dev` reports zero vulnerabilities.
+
+## [0.1.1] - 2026-08-24
+
+### Added
+
+- Explainable recommendation badges and per-dimension score breakdowns.
+- Explicit input, output, and cache pricing in the provider list.
+- Cache-heavy estimated savings compared with the current provider.
+- One-click switching back to the previous provider.
+
+### Changed
+
+- Renamed the panel to “OpenRouter Provider Recommendations” / “OpenRouter 供应商推荐”.
+- Polished refresh, close, provider-row, loading, success, and failure interactions.
+- Replaced abrupt uptime safety bands with a continuous mild penalty curve, while retaining stronger penalties for genuinely unreliable endpoints.
+- Updated the README provider-panel screenshot.
+
+### Validation
+
+- 75 automated tests passing.
+- TypeScript typecheck and production build passing.
+- `npm audit --omit=dev` reports zero vulnerabilities.
+
+## [0.1.0] - 2026-08-24
+
+- Initial public release.
+
+[0.1.2]: https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor/releases/tag/v0.1.0

package/lib/client.js

@@ -32,7 +32,40 @@ async function responseJson(response) {
 	if (!response.ok) throw new Error(body.error ?? `HTTP ${response.status}`);
 	return body;
 }
-function createProviderPanelStore(fetchImpl = fetch) {
+const STRATEGY_KEY = "openrouter-providers:strategy";
+const HISTORY_KEY = "openrouter-providers:history";
+const HISTORY_LIMIT = 20;
+const KNOWN_STRATEGIES = new Set([
+	"balanced",
+	"price",
+	"speed",
+	"context"
+]);
+function defaultStorage() {
+	try {
+		return globalThis.localStorage;
+	} catch {
+		return;
+	}
+}
+function readStrategy(storage) {
+	try {
+		const value = storage?.getItem(STRATEGY_KEY);
+		return value !== null && value !== void 0 && KNOWN_STRATEGIES.has(value) ? value : "balanced";
+	} catch {
+		return "balanced";
+	}
+}
+function readHistory(storage) {
+	try {
+		const parsed = JSON.parse(storage?.getItem(HISTORY_KEY) ?? "[]");
+		if (!Array.isArray(parsed)) return [];
+		return parsed.filter((item) => Boolean(item && typeof item === "object" && typeof item.at === "number" && typeof item.model === "string" && typeof item.toTag === "string")).slice(0, HISTORY_LIMIT);
+	} catch {
+		return [];
+	}
+}
+function createProviderPanelStore(fetchImpl = fetch, storage = defaultStorage()) {
 	let snapshot = {
 		open: false,
 		status: "idle",
@@ -40,9 +73,14 @@ function createProviderPanelStore(fetchImpl = fetch) {
 		data: null,
 		models: [],
 		selected: null,
-		strategy: "balanced",
+		strategy: readStrategy(storage),
 		error: null,
-		credential: null
+		credential: null,
+		applyingTag: null,
+		successTag: null,
+		updatedAt: null,
+		previousTag: null,
+		history: readHistory(storage)
 	};
 	const listeners = /* @__PURE__ */ new Set();
 	let generation = 0;
@@ -90,14 +128,16 @@ function createProviderPanelStore(fetchImpl = fetch) {
 			publish({
 				status: "ready",
 				data,
-				error: null
+				error: null,
+				updatedAt: Date.now()
 			});
 		} catch (error) {
 			if (operation.id !== generation || operation.signal.aborted) return;
+			const message = error instanceof Error ? error.message : String(error);
 			publish({
 				status: "error",
-				data: null,
-				error: error instanceof Error ? error.message : String(error)
+				data: refresh ? snapshot.data : null,
+				error: message
 			});
 			throw error;
 		}
@@ -118,12 +158,15 @@ function createProviderPanelStore(fetchImpl = fetch) {
 				open: true,
 				status: "loading",
 				sessionId,
-				strategy: "balanced",
 				data: null,
 				models: [],
 				selected: null,
 				credential: null,
-				error: null
+				error: null,
+				applyingTag: null,
+				successTag: null,
+				updatedAt: null,
+				previousTag: null
 			});
 			try {
 				const catalog = await responseJson(await fetchImpl(`/api/openrouter-providers/models?sessionId=${encodeURIComponent(sessionId)}`, { signal: operation.signal }));
@@ -147,7 +190,7 @@ function createProviderPanelStore(fetchImpl = fetch) {
 					});
 					return;
 				}
-				await load(sessionId, false, selected, "balanced");
+				await load(sessionId, false, selected);
 			} catch (error) {
 				if (operation.id !== generation || operation.signal.aborted) return;
 				publish({
@@ -165,7 +208,6 @@ function createProviderPanelStore(fetchImpl = fetch) {
 			publish({
 				open: false,
 				status: snapshot.data ? "ready" : "idle",
-				strategy: "balanced",
 				error: null
 			});
 		},
@@ -183,16 +225,22 @@ function createProviderPanelStore(fetchImpl = fetch) {
 			await load(sessionId, false, selected);
 		},
 		async setStrategy(sessionId, strategy) {
+			try {
+				storage?.setItem(STRATEGY_KEY, strategy);
+			} catch {}
 			publish({ strategy });
 			await load(sessionId, false, snapshot.selected, strategy);
 		},
 		async apply(sessionId, tag) {
 			const operation = begin();
+			const previousTag = snapshot.data?.currentTag ?? null;
 			publish({
 				open: true,
 				status: "applying",
 				sessionId,
-				error: null
+				error: null,
+				applyingTag: tag,
+				successTag: null
 			});
 			try {
 				await responseJson(await fetchImpl("/api/openrouter-providers/apply", {
@@ -207,13 +255,52 @@ function createProviderPanelStore(fetchImpl = fetch) {
 					signal: operation.signal
 				}));
 				if (operation.id !== generation) return;
-				store.close();
+				const markCurrent = (row) => ({
+					...row,
+					current: row.tag === tag
+				});
+				const data = snapshot.data ? {
+					...snapshot.data,
+					currentTag: tag,
+					recommended: snapshot.data.recommended.map(markCurrent),
+					rest: snapshot.data.rest.map(markCurrent)
+				} : null;
+				let history = snapshot.history;
+				if (snapshot.data && previousTag !== tag) {
+					const rows = [...snapshot.data.recommended, ...snapshot.data.rest];
+					const fromRow = previousTag === null ? void 0 : rows.find((row) => row.tag === previousTag);
+					const toRow = rows.find((row) => row.tag === tag);
+					history = [{
+						at: Date.now(),
+						model: snapshot.data.openrouterModel,
+						fromTag: previousTag,
+						fromName: fromRow?.providerName ?? null,
+						fromTps: fromRow?.tps ?? null,
+						toTag: tag,
+						toName: toRow?.providerName ?? tag,
+						toTps: toRow?.tps ?? null
+					}, ...snapshot.history].slice(0, HISTORY_LIMIT);
+					try {
+						storage?.setItem(HISTORY_KEY, JSON.stringify(history));
+					} catch {}
+				}
+				publish({
+					open: true,
+					status: "ready",
+					data,
+					history,
+					applyingTag: null,
+					successTag: tag,
+					previousTag: previousTag === tag ? snapshot.previousTag : previousTag,
+					error: null
+				});
 			} catch (error) {
 				if (operation.id !== generation || operation.signal.aborted) return;
 				publish({
 					open: true,
 					status: "error",
-					error: error instanceof Error ? error.message : String(error)
+					error: error instanceof Error ? error.message : String(error),
+					applyingTag: null
 				});
 				throw error;
 			}
@@ -232,7 +319,7 @@ function createProviderPanelStore(fetchImpl = fetch) {
 //#region src/client/i18n.ts
 const messages = {
 	"zh-CN": {
-		"panel.title": "OpenRouter 供应商",
+		"panel.title": "OpenRouter 供应商推荐",
 		"panel.currentModelLoading": "正在读取当前模型…",
 		"panel.modelSelect": "选择 DSH 模型",
 		"panel.strategyGroup": "推荐策略",
@@ -244,17 +331,36 @@ const messages = {
 		"panel.group.recommended": "推荐 Top 5",
 		"panel.group.rest": "其他合格供应商",
 		"panel.column.provider": "供应商",
-		"panel.column.details": "规格详情",
+		"panel.column.details": "性能与价格",
 		"panel.column.score": "分数",
 		"panel.current": "当前",
 		"panel.credentialMissing": "未检测到 OpenRouter 凭据“{ref}”。请前往 DSH 设置 → 模型完成配置；推荐、刷新和供应商切换暂不可用。",
 		"panel.switchHint": "点击供应商即可实时切换；当前会话与默认模型会立即更新。",
 		"panel.uptime": "可用率",
-		"panel.uptimeDelayHint": "可用率来自 OpenRouter 近 30 分钟统计，故障与恢复可能存在检测延迟。",
+		"panel.uptimeDelayHint": "可用率来自 OpenRouter 近 30 分钟统计并采用连续温和降权；故障与恢复可能存在检测延迟。",
+		"panel.refreshing": "正在刷新",
+		"panel.switching": "正在切换…",
+		"panel.switched": "已切换",
+		"panel.switchAction": "切换",
+		"panel.insight.quantization": "量化突出",
+		"panel.insight.speed": "速度突出",
+		"panel.insight.price": "价格突出",
+		"panel.insight.context": "上下文突出",
+		"panel.currentModel": "当前模型",
+		"panel.price.input": "输入",
+		"panel.price.output": "输出",
+		"panel.price.cache": "缓存",
+		"panel.savings": "预计节省 {percent}%",
+		"panel.undo": "切回上一个",
+		"panel.switchSuccess": "供应商已切换，可立即切回上一个选择。",
 		"panel.strategy.balanced": "综合最佳",
 		"panel.strategy.price": "价格优先",
 		"panel.strategy.speed": "速度优先",
 		"panel.strategy.context": "上下文优先",
+		"panel.updatedJustNow": "数据刚刚更新",
+		"panel.updatedMinutesAgo": "数据更新于 {minutes} 分钟前",
+		"panel.history.title": "切换历史",
+		"panel.history.revert": "切回",
 		"settings.title": "OpenRouter 供应商",
 		"settings.summary": "推荐数量、综合最佳权重与全局价格模型。",
 		"settings.action.weights": "应用综合权重",
@@ -280,7 +386,7 @@ const messages = {
 		"settings.group.weights.scope": "仅影响“综合最佳”推荐策略；调整一项时，其他未锁定项会按比例联动。",
 		"settings.group.priceBlend.title": "价格计算占比",
 		"settings.group.priceBlend.scope": "所有推荐策略共用。Code Agent 默认按 95% 以上缓存流量优化。",
-		"settings.group.advanced.title": "筛选与可靠性",
+		"settings.group.advanced.title": "筛选与可靠性（阈值以下 5% 区间渐进降权）",
 		"settings.group.strategies.title": "查看其他策略权重",
 		"settings.group.strategies.scope": "以下策略使用内置权重；价格维度仍使用上方全局价格占比。",
 		"settings.dimension.quantization": "量化",
@@ -298,7 +404,7 @@ const messages = {
 		"settings.connection.guide": "请前往 DSH 设置 → 模型，为 OpenRouter provider 配置 API Key。插件不会读取或显示密钥内容。"
 	},
 	"en-US": {
-		"panel.title": "OpenRouter Providers",
+		"panel.title": "OpenRouter Provider Recommendations",
 		"panel.currentModelLoading": "Loading current model…",
 		"panel.modelSelect": "Select DSH model",
 		"panel.strategyGroup": "Ranking strategy",
@@ -310,17 +416,36 @@ const messages = {
 		"panel.group.recommended": "Top 5 Recommendations",
 		"panel.group.rest": "Other Eligible Providers",
 		"panel.column.provider": "Provider",
-		"panel.column.details": "Specs & Performance",
+		"panel.column.details": "Performance & price",
 		"panel.column.score": "Score",
 		"panel.current": "Current",
 		"panel.credentialMissing": "OpenRouter credential “{ref}” is not configured. Configure it in DSH Settings → Models; recommendations, refresh, and provider switching are disabled for now.",
 		"panel.switchHint": "Click a provider to switch immediately; the current session and default model update together.",
 		"panel.uptime": "uptime",
-		"panel.uptimeDelayHint": "Uptime comes from OpenRouter's trailing 30-minute statistics, so failures and recoveries may be detected with a delay.",
+		"panel.uptimeDelayHint": "Uptime uses a continuous mild penalty over OpenRouter's trailing 30-minute statistics; failures and recoveries may be detected with a delay.",
+		"panel.refreshing": "Refreshing",
+		"panel.switching": "Switching…",
+		"panel.switched": "Switched",
+		"panel.switchAction": "Switch",
+		"panel.insight.quantization": "Quality strength",
+		"panel.insight.speed": "Speed strength",
+		"panel.insight.price": "Price strength",
+		"panel.insight.context": "Context strength",
+		"panel.currentModel": "Current model",
+		"panel.price.input": "Input",
+		"panel.price.output": "Output",
+		"panel.price.cache": "Cache",
+		"panel.savings": "Est. {percent}% less",
+		"panel.undo": "Switch back",
+		"panel.switchSuccess": "Provider switched. You can immediately return to the previous choice.",
 		"panel.strategy.balanced": "Best overall",
 		"panel.strategy.price": "Price first",
 		"panel.strategy.speed": "Speed first",
 		"panel.strategy.context": "Context first",
+		"panel.updatedJustNow": "Updated just now",
+		"panel.updatedMinutesAgo": "Updated {minutes} min ago",
+		"panel.history.title": "Switch history",
+		"panel.history.revert": "Revert",
 		"settings.title": "OpenRouter Providers",
 		"settings.summary": "Recommended count, ranking weights, and price blend.",
 		"settings.action.weights": "Apply ranking weights",
@@ -346,7 +471,7 @@ const messages = {
 		"settings.group.weights.scope": "Affects only Best overall. Changing one item proportionally redistributes the other unlocked items.",
 		"settings.group.priceBlend.title": "Price calculation blend",
 		"settings.group.priceBlend.scope": "Shared by all ranking strategies. The Code Agent default is optimized for 95%+ cached traffic.",
-		"settings.group.advanced.title": "Filtering & reliability",
+		"settings.group.advanced.title": "Filtering & reliability (gradual penalty across 5% below threshold)",
 		"settings.group.strategies.title": "View other strategy weights",
 		"settings.group.strategies.scope": "These strategies use built-in weights; their price dimension still uses the global price blend above.",
 		"settings.dimension.quantization": "Quality",
@@ -399,6 +524,67 @@ function useUiI18n() {
 
 //#endregion
 //#region src/client/provider-panel.ts
+const textPrimary = "var(--dsw-alias-label-primary, #f4f4f5)";
+const textSecondary = "var(--dsw-alias-label-secondary, #d4d4d8)";
+const textTertiary = "var(--dsw-alias-label-tertiary, #a1a1aa)";
+const borderL2 = "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.12))";
+const bgLayer1 = "var(--dsw-alias-bg-layer-1, #18181b)";
+const bgLayer2 = "var(--dsw-alias-bg-layer-2, #27272a)";
+const bgLayer3 = "var(--dsw-alias-bg-layer-3, rgba(255,255,255,.05))";
+const actionButtonStyle = {
+	height: 36,
+	padding: "0 12px",
+	borderRadius: 8,
+	border: borderL2,
+	background: bgLayer3,
+	color: textPrimary,
+	cursor: "pointer"
+};
+const iconButtonStyle = {
+	...actionButtonStyle,
+	width: 36,
+	padding: 0,
+	fontSize: 20,
+	lineHeight: 1
+};
+function providerInsight(row, i18n = createI18n("zh-CN")) {
+	const entries = [
+		[
+			"quantization",
+			row.dimensions.quantization,
+			i18n.t("settings.dimension.quantization")
+		],
+		[
+			"speed",
+			row.dimensions.speed,
+			i18n.t("settings.dimension.speed")
+		],
+		[
+			"price",
+			row.dimensions.price,
+			i18n.t("settings.dimension.price")
+		],
+		[
+			"context",
+			row.dimensions.context,
+			i18n.t("settings.dimension.context")
+		]
+	];
+	const strongest = entries.reduce((best, item) => item[1] > best[1] ? item : best);
+	return {
+		badge: i18n.t(`panel.insight.${strongest[0]}`),
+		breakdown: entries.map(([, value, label]) => `${label} ${Math.round(value)}`).join(" · ")
+	};
+}
+function providerPriceLabel(row, i18n = createI18n("zh-CN")) {
+	return `${i18n.t("panel.price.input")} $${row.price.input} · ${i18n.t("panel.price.output")} $${row.price.output} · ${i18n.t("panel.price.cache")} $${row.price.cache} / M tokens`;
+}
+function estimatedSavings(current, candidate) {
+	const cost = (price) => price.input * .02 + price.output * .08 + price.cache * .9;
+	const baseline = cost(current);
+	const saving = baseline > 0 ? Math.round((1 - cost(candidate) / baseline) * 100) : 0;
+	return saving > 0 ? saving : null;
+}
 const STRATEGY_OPTIONS = [
 	{
 		id: "balanced",
@@ -418,14 +604,21 @@ const STRATEGY_OPTIONS = [
 	}
 ];
 function providerRows(data, i18n = createI18n("zh-CN")) {
+	const currentPrice = [...data.recommended, ...data.rest].find((row) => row.current)?.price;
 	const map = (group) => (row) => ({
 		group,
 		tag: row.tag,
 		providerName: row.providerName,
 		current: row.current,
 		score: row.score,
-		detail: `${row.quantization} · ${row.tps} t/s · $${row.price.input}/$${row.price.output} · ${row.contextLength.toLocaleString()} ctx · ${row.uptime === null ? "N/A" : `${row.uptime.toFixed(2)}%`} ${i18n.t("panel.uptime")}`,
-		scoreLabel: row.current ? `${i18n.t("panel.current")} · ${row.score.toFixed(1)}` : row.score.toFixed(1)
+		detail: `${row.quantization} · ${row.tps} t/s · ${row.contextLength.toLocaleString()} ctx · ${row.uptime === null ? "N/A" : `${row.uptime.toFixed(2)}%`} ${i18n.t("panel.uptime")}`,
+		priceLabel: providerPriceLabel(row, i18n),
+		savingsLabel: currentPrice && !row.current ? (() => {
+			const value = estimatedSavings(currentPrice, row.price);
+			return value === null ? null : i18n.t("panel.savings", { percent: value });
+		})() : null,
+		scoreLabel: row.current ? `${i18n.t("panel.current")} · ${row.score.toFixed(1)}` : row.score.toFixed(1),
+		...providerInsight(row, i18n)
 	});
 	return [...data.recommended.map(map(i18n.t("panel.group.recommended"))), ...data.rest.map(map(i18n.t("panel.group.rest")))];
 }
@@ -517,12 +710,17 @@ const panelStyle = {
 	overflow: "hidden",
 	display: "flex",
 	flexDirection: "column",
-	border: "1px solid rgba(255,255,255,.12)",
+	border: borderL2,
 	borderRadius: 16,
-	background: "#18181b",
-	color: "#f4f4f5",
-	boxShadow: "0 24px 80px rgba(0,0,0,.5)"
+	background: bgLayer1,
+	color: textPrimary,
+	boxShadow: "0 24px 80px rgba(0,0,0,.5)",
+	outline: "none"
 };
+function freshnessLabel(updatedAt, now, i18n = createI18n("zh-CN")) {
+	const minutes = Math.max(0, Math.floor((now - updatedAt) / 6e4));
+	return minutes === 0 ? i18n.t("panel.updatedJustNow") : i18n.t("panel.updatedMinutesAgo", { minutes });
+}
 const providerGridColumns = "minmax(110px,1fr) minmax(0,2fr) minmax(54px,auto)";
 function ProviderOverlay(props) {
 	const i18n = useUiI18n();
@@ -533,6 +731,8 @@ function ProviderOverlay(props) {
 		current,
 		currentAddress
 	});
+	const dialogRef = (0, react.useRef)(null);
+	const [now, setNow] = (0, react.useState)(() => Date.now());
 	(0, react.useEffect)(() => {
 		if (!state.open) return;
 		if (!target.sessionId) props.store.close();
@@ -543,7 +743,41 @@ function ProviderOverlay(props) {
 		target.sessionId,
 		props.store
 	]);
+	(0, react.useEffect)(() => {
+		if (!state.open) return;
+		setNow(Date.now());
+		const timer = setInterval(() => setNow(Date.now()), 3e4);
+		return () => clearInterval(timer);
+	}, [state.open, state.updatedAt]);
+	(0, react.useEffect)(() => {
+		if (!state.open) return;
+		const previous = document.activeElement;
+		dialogRef.current?.focus();
+		return () => {
+			if (previous instanceof HTMLElement) previous.focus();
+		};
+	}, [state.open]);
 	if (!state.open) return null;
+	const onKeyDown = (event) => {
+		if (event.key === "Escape") {
+			event.stopPropagation();
+			props.store.close();
+			return;
+		}
+		if (event.key !== "Tab" || !dialogRef.current) return;
+		const focusable = Array.from(dialogRef.current.querySelectorAll("button:not(:disabled), select:not(:disabled), input:not(:disabled), summary, [tabindex]:not([tabindex=\"-1\"])"));
+		if (focusable.length === 0) return;
+		const first = focusable[0];
+		const last = focusable.at(-1);
+		const active = document.activeElement;
+		if (event.shiftKey && (active === first || active === dialogRef.current)) {
+			event.preventDefault();
+			last.focus();
+		} else if (!event.shiftKey && active === last) {
+			event.preventDefault();
+			first.focus();
+		}
+	};
 	const rows = state.data ? providerRows(state.data, i18n) : [];
 	const credentialReady = state.credential?.configured === true;
 	const columns = providerTableColumns(i18n);
@@ -552,39 +786,49 @@ function ProviderOverlay(props) {
 	return (0, react.createElement)("div", {
 		style: backdrop,
 		role: "presentation",
+		onKeyDown,
 		onMouseDown: (event) => {
 			if (event.target === event.currentTarget) props.store.close();
 		}
 	}, (0, react.createElement)("section", {
+		ref: dialogRef,
 		role: "dialog",
 		"aria-modal": true,
 		"aria-label": i18n.t("panel.title"),
+		tabIndex: -1,
 		style: panelStyle
 	}, (0, react.createElement)("header", { style: {
 		display: "flex",
 		alignItems: "start",
 		justifyContent: "space-between",
-		padding: "20px 22px 16px",
-		borderBottom: "1px solid rgba(255,255,255,.1)"
-	} }, (0, react.createElement)("div", null, (0, react.createElement)("h2", { style: {
+		gap: 16,
+		padding: "18px 22px 14px",
+		borderBottom: borderL2
+	} }, (0, react.createElement)("div", { style: {
+		minWidth: 0,
+		flex: 1
+	} }, (0, react.createElement)("h2", { style: {
 		margin: 0,
 		fontSize: 20
-	} }, i18n.t("panel.title")), (0, react.createElement)("p", { style: {
-		margin: "6px 0 10px",
-		color: "#a1a1aa",
-		fontSize: 13
-	} }, state.data ? state.data.openrouterModel : i18n.t("panel.currentModelLoading")), (0, react.createElement)("select", {
+	} }, i18n.t("panel.title")), (0, react.createElement)("label", { style: {
+		display: "block",
+		margin: "10px 0 5px",
+		color: textTertiary,
+		fontSize: 10,
+		fontWeight: 600,
+		letterSpacing: ".06em",
+		textTransform: "uppercase"
+	} }, i18n.t("panel.currentModel")), (0, react.createElement)("select", {
 		"aria-label": i18n.t("panel.modelSelect"),
 		value: selectedValue,
 		disabled: !credentialReady || state.models.length === 0 || state.status === "applying",
 		style: {
-			minWidth: 300,
-			maxWidth: "min(460px, 60vw)",
-			padding: "7px 10px",
+			width: "min(420px, 100%)",
+			padding: "8px 10px",
 			borderRadius: 8,
-			border: "1px solid rgba(255,255,255,.16)",
-			background: "#27272a",
-			color: "#f4f4f5"
+			border: borderL2,
+			background: bgLayer2,
+			color: textPrimary
 		},
 		onChange: (event) => {
 			if (!target.sessionId) return;
@@ -601,12 +845,12 @@ function ProviderOverlay(props) {
 		style: {
 			display: "grid",
 			gridTemplateColumns: "repeat(4, minmax(0, 1fr))",
-			gap: 6,
-			width: "min(560px, 70vw)",
-			marginTop: 12,
-			padding: 4,
-			borderRadius: 10,
-			background: "rgba(255,255,255,.05)"
+			gap: 3,
+			width: "min(520px, 100%)",
+			marginTop: 10,
+			padding: 3,
+			borderRadius: 9,
+			background: bgLayer3
 		}
 	}, ...STRATEGY_OPTIONS.map((option) => {
 		const active = state.strategy === option.id;
@@ -618,14 +862,17 @@ function ProviderOverlay(props) {
 			onClick: () => {
 				if (target.sessionId && !active) consume(props.store.setStrategy(target.sessionId, option.id));
 			},
+			title: i18n.t(option.labelKey),
 			style: {
+				minHeight: 38,
 				border: active ? "1px solid #3b82f6" : "1px solid transparent",
-				borderRadius: 7,
-				padding: "7px 10px",
-				background: active ? "rgba(37,99,235,.2)" : "transparent",
-				color: active ? "#93c5fd" : "#d4d4d8",
+				borderRadius: 6,
+				padding: "5px 8px",
+				background: active ? "rgba(37,99,235,.15)" : "transparent",
+				color: active ? "#93c5fd" : textSecondary,
 				cursor: active ? "default" : "pointer",
-				whiteSpace: "nowrap"
+				whiteSpace: "nowrap",
+				fontSize: 12
 			}
 		}, i18n.t(option.labelKey));
 	}))), (0, react.createElement)("div", { style: {
@@ -633,14 +880,28 @@ function ProviderOverlay(props) {
 		gap: 8
 	} }, (0, react.createElement)("button", {
 		type: "button",
+		title: i18n.t("panel.refresh"),
+		"aria-busy": state.status === "loading",
 		disabled: !credentialReady || !target.sessionId || state.status === "loading" || state.status === "applying",
 		onClick: () => {
 			if (target.sessionId) consume(props.store.refresh(target.sessionId));
+		},
+		style: {
+			...actionButtonStyle,
+			opacity: state.status === "loading" ? .6 : 1
+		}
+	}, (0, react.createElement)("span", {
+		"aria-hidden": true,
+		style: {
+			display: "inline-block",
+			marginRight: 6
 		}
-	}, i18n.t("panel.refresh")), (0, react.createElement)("button", {
+	}, "↻"), state.status === "loading" ? i18n.t("panel.refreshing") : i18n.t("panel.refresh")), (0, react.createElement)("button", {
 		type: "button",
+		title: i18n.t("panel.close"),
 		"aria-label": i18n.t("panel.close"),
-		onClick: () => props.store.close()
+		onClick: () => props.store.close(),
+		style: iconButtonStyle
 	}, "×"))), state.credential !== null && !state.credential.configured ? (0, react.createElement)("p", {
 		role: "status",
 		style: {
@@ -662,20 +923,50 @@ function ProviderOverlay(props) {
 			color: "#fca5a5",
 			background: "rgba(127,29,29,.35)"
 		}
-	}, state.error) : null, state.status === "loading" && rows.length === 0 ? (0, react.createElement)("p", { style: {
+	}, state.error) : null, state.successTag && state.previousTag ? (0, react.createElement)("div", {
+		role: "status",
+		style: {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "space-between",
+			gap: 12,
+			margin: "12px 22px 0",
+			padding: "9px 11px",
+			borderRadius: 8,
+			color: "#bbf7d0",
+			background: "rgba(20,83,45,.24)",
+			border: "1px solid rgba(34,197,94,.22)",
+			fontSize: 12
+		}
+	}, (0, react.createElement)("span", null, i18n.t("panel.switchSuccess")), (0, react.createElement)("button", {
+		type: "button",
+		disabled: state.status === "applying",
+		onClick: () => {
+			if (target.sessionId && state.previousTag) consume(props.store.apply(target.sessionId, state.previousTag));
+		},
+		style: {
+			...actionButtonStyle,
+			height: 30,
+			color: "#bbf7d0",
+			whiteSpace: "nowrap"
+		}
+	}, i18n.t("panel.undo"))) : null, state.status === "loading" && rows.length === 0 ? (0, react.createElement)("p", { style: {
 		padding: 22,
-		color: "#a1a1aa"
+		color: textTertiary
 	} }, i18n.t("panel.loading")) : null, credentialReady && rows.length > 0 ? (0, react.createElement)("div", { style: {
 		display: "grid",
 		gap: 2,
 		margin: "12px 22px 0",
-		color: "#71717a",
+		color: textTertiary,
 		fontSize: 11,
 		lineHeight: 1.5
 	} }, (0, react.createElement)("span", null, i18n.t("panel.switchHint")), (0, react.createElement)("span", { style: {
-		color: "#52525b",
-		fontSize: 10
-	} }, i18n.t("panel.uptimeDelayHint"))) : null, (0, react.createElement)("div", { style: {
+		fontSize: 10,
+		opacity: .8
+	} }, i18n.t("panel.uptimeDelayHint")), state.updatedAt === null ? null : (0, react.createElement)("span", { style: {
+		fontSize: 10,
+		opacity: .8
+	} }, freshnessLabel(state.updatedAt, now, i18n))) : null, (0, react.createElement)("div", { style: {
 		overflowY: "auto",
 		padding: "12px 14px 20px"
 	} }, ...rows.flatMap((row) => {
@@ -686,7 +977,7 @@ function ProviderOverlay(props) {
 				key: `group-${row.group}`,
 				style: {
 					margin: "14px 8px 8px",
-					color: "#a1a1aa",
+					color: textTertiary,
 					fontSize: 12,
 					textTransform: "uppercase",
 					letterSpacing: ".06em"
@@ -699,13 +990,15 @@ function ProviderOverlay(props) {
 					gridTemplateColumns: providerGridColumns,
 					gap: 14,
 					padding: "0 14px 8px",
-					color: "#71717a",
+					color: textTertiary,
 					fontSize: 11,
 					letterSpacing: ".04em",
 					textTransform: "uppercase"
 				}
 			}, (0, react.createElement)("span", null, columns[0]), (0, react.createElement)("span", null, columns[1]), (0, react.createElement)("span", { style: { textAlign: "right" } }, columns[2])));
 		}
+		const switching = state.applyingTag === row.tag;
+		const switched = state.successTag === row.tag;
 		nodes.push((0, react.createElement)("button", {
 			key: row.tag,
 			type: "button",
@@ -713,6 +1006,7 @@ function ProviderOverlay(props) {
 			onClick: () => {
 				if (target.sessionId) consume(props.store.apply(target.sessionId, row.tag));
 			},
+			title: row.current ? i18n.t("panel.current") : i18n.t("panel.switchAction"),
 			style: {
 				width: "100%",
 				display: "grid",
@@ -722,28 +1016,124 @@ function ProviderOverlay(props) {
 				padding: "12px 14px",
 				marginBottom: 6,
 				borderRadius: 10,
-				border: row.current ? "1px solid #3b82f6" : "1px solid rgba(255,255,255,.08)",
-				background: row.current ? "rgba(37,99,235,.14)" : "rgba(255,255,255,.035)",
+				border: row.current ? "1px solid #3b82f6" : borderL2,
+				background: row.current ? "rgba(37,99,235,.14)" : bgLayer3,
 				color: "inherit",
 				textAlign: "left",
-				cursor: row.current ? "default" : "pointer"
+				cursor: row.current ? "default" : "pointer",
+				transition: "background .15s ease,border-color .15s ease,transform .15s ease",
+				opacity: state.status === "applying" && !switching ? .55 : 1
 			}
-		}, (0, react.createElement)("strong", null, row.providerName), (0, react.createElement)("span", {
+		}, (0, react.createElement)("span", { style: {
+			display: "flex",
+			alignItems: "center",
+			gap: 8,
+			minWidth: 0
+		} }, (0, react.createElement)("strong", { style: {
+			overflow: "hidden",
+			textOverflow: "ellipsis"
+		} }, row.providerName), (0, react.createElement)("small", { style: {
+			flex: "0 0 auto",
+			padding: "2px 6px",
+			borderRadius: 999,
+			color: "#a5b4fc",
+			background: "rgba(99,102,241,.13)",
+			fontSize: 9,
+			fontWeight: 600
+		} }, row.badge)), (0, react.createElement)("span", { style: {
+			display: "grid",
+			gap: 3,
+			minWidth: 0
+		} }, (0, react.createElement)("span", {
 			title: row.detail,
 			style: {
-				color: "#a1a1aa",
-				fontSize: 13,
+				color: textTertiary,
+				fontSize: 12,
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap"
+			}
+		}, row.detail), (0, react.createElement)("span", {
+			title: row.priceLabel,
+			style: {
+				color: textSecondary,
+				fontSize: 11,
 				overflow: "hidden",
 				textOverflow: "ellipsis",
 				whiteSpace: "nowrap"
 			}
-		}, row.detail), (0, react.createElement)("span", { style: {
-			color: row.current ? "#60a5fa" : "#d4d4d8",
-			fontSize: 12,
-			textAlign: "right"
-		} }, row.scoreLabel)));
+		}, row.priceLabel), row.savingsLabel ? (0, react.createElement)("small", { style: {
+			color: "#86efac",
+			fontSize: 10,
+			fontWeight: 600
+		} }, row.savingsLabel) : null), (0, react.createElement)("span", {
+			title: row.breakdown,
+			"aria-label": `${row.scoreLabel}; ${row.breakdown}`,
+			style: {
+				color: row.current ? "#60a5fa" : textSecondary,
+				fontSize: 12,
+				textAlign: "right",
+				textDecoration: "underline dotted rgba(161,161,170,.6)",
+				textUnderlineOffset: 3
+			}
+		}, switching ? i18n.t("panel.switching") : switched ? i18n.t("panel.switched") : row.scoreLabel)));
 		return nodes;
-	}))));
+	}), state.history.length === 0 ? null : (0, react.createElement)("details", { style: {
+		margin: "10px 8px 0",
+		padding: "10px 12px",
+		borderRadius: 10,
+		border: borderL2
+	} }, (0, react.createElement)("summary", { style: {
+		cursor: "pointer",
+		color: textTertiary,
+		fontSize: 12,
+		textTransform: "uppercase",
+		letterSpacing: ".06em"
+	} }, i18n.t("panel.history.title")), ...state.history.map((item) => {
+		const revertable = item.fromTag !== null && state.data?.openrouterModel === item.model && state.data.currentTag !== item.fromTag;
+		return (0, react.createElement)("div", {
+			key: `${item.at}-${item.toTag}`,
+			title: item.model,
+			style: {
+				display: "flex",
+				alignItems: "center",
+				gap: 10,
+				padding: "8px 0",
+				borderTop: borderL2,
+				fontSize: 12,
+				marginTop: 8
+			}
+		}, (0, react.createElement)("span", { style: {
+			color: textTertiary,
+			flex: "0 0 auto"
+		} }, new Date(item.at).toLocaleTimeString(i18n.locale, {
+			hour: "2-digit",
+			minute: "2-digit"
+		})), (0, react.createElement)("span", { style: {
+			color: textSecondary,
+			minWidth: 0,
+			overflow: "hidden",
+			textOverflow: "ellipsis",
+			whiteSpace: "nowrap"
+		} }, `${item.fromName ?? item.fromTag ?? "—"} → ${item.toName}`), item.fromTps !== null && item.toTps !== null ? (0, react.createElement)("span", { style: {
+			color: textTertiary,
+			flex: "0 0 auto"
+		} }, `${item.fromTps} → ${item.toTps} t/s`) : null, revertable ? (0, react.createElement)("button", {
+			type: "button",
+			disabled: state.status === "applying",
+			onClick: () => {
+				if (target.sessionId && item.fromTag) consume(props.store.apply(target.sessionId, item.fromTag));
+			},
+			style: {
+				...actionButtonStyle,
+				height: 26,
+				padding: "0 10px",
+				marginLeft: "auto",
+				fontSize: 12,
+				whiteSpace: "nowrap"
+			}
+		}, i18n.t("panel.history.revert")) : null);
+	})))));
 }
 
 //#endregion

package/lib/index.js

@@ -104,8 +104,8 @@ async function applyProvider(deps, input) {
 			reasoningEfforts: effort.declaration,
 			openrouterModel: input.openrouterModel
 		};
-		const index = models.findIndex((model) => model.id === modelId);
-		const next = [...models];
+		const next = models.filter((model) => model.id === modelId || !(model.id.startsWith("@preset/") && model.openrouterModel === input.openrouterModel));
+		const index = next.findIndex((model) => model.id === modelId);
 		if (index >= 0) next[index] = {
 			...next[index],
 			...entry
@@ -275,8 +275,10 @@ function round(value, digits = 2) {
 	return Math.round((value + Number.EPSILON) * factor) / factor;
 }
 function uptimeMultiplier(uptime, config) {
-	const safety = uptime === null ? .7 : uptime >= 99.5 ? 1 : uptime >= 99 ? .85 : uptime >= 97 ? .6 : uptime >= 90 ? .3 : .05;
-	const configured = uptime !== null && uptime < config.uptimePenaltyThreshold ? config.uptimePenaltyFactor : 1;
+	if (uptime === null) return .85;
+	const interpolate = (value, low, high, lowScore, highScore) => lowScore + (highScore - lowScore) * (value - low) / (high - low);
+	const safety = uptime >= 99.5 ? 1 : uptime >= 99 ? interpolate(uptime, 99, 99.5, .97, 1) : uptime >= 98 ? interpolate(uptime, 98, 99, .9, .97) : uptime >= 95 ? interpolate(uptime, 95, 98, .75, .9) : uptime >= 90 ? interpolate(uptime, 90, 95, .5, .75) : interpolate(Math.max(0, uptime), 0, 90, .1, .5);
+	const configured = uptime >= config.uptimePenaltyThreshold ? 1 : interpolate(Math.max(config.uptimePenaltyThreshold - 5, uptime), config.uptimePenaltyThreshold - 5, config.uptimePenaltyThreshold, config.uptimePenaltyFactor, 1);
 	return Math.min(safety, configured);
 }
 function rankEndpoints(endpoints, config, currentTag) {

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

@@ -1,5 +1,5 @@
 export type SupportedLocale = 'zh-CN' | 'en-US';
-export type TranslationKey = 'panel.title' | 'panel.currentModelLoading' | 'panel.modelSelect' | 'panel.strategyGroup' | 'panel.refresh' | 'panel.close' | 'panel.loading' | 'panel.titleTrigger' | 'panel.unavailable' | 'panel.group.recommended' | 'panel.group.rest' | 'panel.column.provider' | 'panel.column.details' | 'panel.column.score' | 'panel.current' | 'panel.credentialMissing' | 'panel.switchHint' | 'panel.uptime' | 'panel.uptimeDelayHint' | 'panel.strategy.balanced' | 'panel.strategy.price' | 'panel.strategy.speed' | 'panel.strategy.context' | 'settings.title' | 'settings.summary' | 'settings.action.weights' | 'settings.action.priceBlend' | 'settings.action.reset' | 'settings.action.lock' | 'settings.action.unlock' | 'settings.expand' | 'settings.collapse' | 'settings.row.minContextTokens' | 'settings.row.recommendedCount' | 'settings.row.cacheTtlMs' | 'settings.row.weights.quantization' | 'settings.row.weights.speed' | 'settings.row.weights.price' | 'settings.row.weights.context' | 'settings.row.priceBlend.input' | 'settings.row.priceBlend.output' | 'settings.row.priceBlend.cache' | 'settings.row.uptimePenaltyThreshold' | 'settings.row.uptimePenaltyFactor' | 'settings.group.weights.title' | 'settings.group.weights.scope' | 'settings.group.priceBlend.title' | 'settings.group.priceBlend.scope' | 'settings.group.advanced.title' | 'settings.group.strategies.title' | 'settings.group.strategies.scope' | 'settings.dimension.quantization' | 'settings.dimension.speed' | 'settings.dimension.price' | 'settings.dimension.context' | 'settings.dimension.input' | 'settings.dimension.output' | 'settings.dimension.cache' | 'settings.connection.title' | 'settings.connection.loading' | 'settings.connection.configured' | 'settings.connection.missing' | 'settings.connection.error' | 'settings.connection.guide';
+export type TranslationKey = 'panel.title' | 'panel.currentModelLoading' | 'panel.modelSelect' | 'panel.strategyGroup' | 'panel.refresh' | 'panel.close' | 'panel.loading' | 'panel.titleTrigger' | 'panel.unavailable' | 'panel.group.recommended' | 'panel.group.rest' | 'panel.column.provider' | 'panel.column.details' | 'panel.column.score' | 'panel.current' | 'panel.credentialMissing' | 'panel.switchHint' | 'panel.uptime' | 'panel.uptimeDelayHint' | 'panel.refreshing' | 'panel.switching' | 'panel.switched' | 'panel.switchAction' | 'panel.insight.quantization' | 'panel.insight.speed' | 'panel.insight.price' | 'panel.insight.context' | 'panel.currentModel' | 'panel.price.input' | 'panel.price.output' | 'panel.price.cache' | 'panel.savings' | 'panel.undo' | 'panel.switchSuccess' | 'panel.strategy.balanced' | 'panel.strategy.price' | 'panel.strategy.speed' | 'panel.strategy.context' | 'panel.updatedJustNow' | 'panel.updatedMinutesAgo' | 'panel.history.title' | 'panel.history.revert' | 'settings.title' | 'settings.summary' | 'settings.action.weights' | 'settings.action.priceBlend' | 'settings.action.reset' | 'settings.action.lock' | 'settings.action.unlock' | 'settings.expand' | 'settings.collapse' | 'settings.row.minContextTokens' | 'settings.row.recommendedCount' | 'settings.row.cacheTtlMs' | 'settings.row.weights.quantization' | 'settings.row.weights.speed' | 'settings.row.weights.price' | 'settings.row.weights.context' | 'settings.row.priceBlend.input' | 'settings.row.priceBlend.output' | 'settings.row.priceBlend.cache' | 'settings.row.uptimePenaltyThreshold' | 'settings.row.uptimePenaltyFactor' | 'settings.group.weights.title' | 'settings.group.weights.scope' | 'settings.group.priceBlend.title' | 'settings.group.priceBlend.scope' | 'settings.group.advanced.title' | 'settings.group.strategies.title' | 'settings.group.strategies.scope' | 'settings.dimension.quantization' | 'settings.dimension.speed' | 'settings.dimension.price' | 'settings.dimension.context' | 'settings.dimension.input' | 'settings.dimension.output' | 'settings.dimension.cache' | 'settings.connection.title' | 'settings.connection.loading' | 'settings.connection.configured' | 'settings.connection.missing' | 'settings.connection.error' | 'settings.connection.guide';
 export declare const zh: Record<TranslationKey, string>;
 export declare const en: Record<TranslationKey, string>;
 export declare const LOCALE_NS = "openrouterProviders";

package/lib/types/client/provider-panel-store.d.ts

@@ -13,11 +13,26 @@ export interface ProviderPanelSnapshot {
     } | null;
     strategy: RankingStrategy;
     error: string | null;
+    applyingTag: string | null;
+    successTag: string | null;
+    updatedAt: number | null;
+    previousTag: string | null;
     credential: {
         configured: boolean;
         ref: string;
         source: 'provider' | 'fallback';
     } | null;
+    history: SwitchHistoryEntry[];
+}
+export interface SwitchHistoryEntry {
+    at: number;
+    model: string;
+    fromTag: string | null;
+    fromName: string | null;
+    fromTps: number | null;
+    toTag: string;
+    toName: string;
+    toTps: number | null;
 }
 export interface ConfiguredProviderModel {
     provider: string;
@@ -38,5 +53,6 @@ export interface ProviderPanelStore {
     apply(sessionId: string, tag: string): Promise<void>;
     dispose(): void;
 }
-export declare function createProviderPanelStore(fetchImpl?: typeof fetch): ProviderPanelStore;
+export type PanelStorage = Pick<Storage, 'getItem' | 'setItem'>;
+export declare function createProviderPanelStore(fetchImpl?: typeof fetch, storage?: PanelStorage | undefined): ProviderPanelStore;
 //# sourceMappingURL=provider-panel-store.d.ts.map

package/lib/types/client/provider-panel.d.ts

@@ -1,5 +1,6 @@
 import { type CSSProperties, type ReactNode } from 'react';
 import type { RecommendationResponse } from '../directory.js';
+import type { RankedProvider } from '../types.js';
 import type { RankingStrategy } from '../config.js';
 import type { ProviderPanelStore } from './provider-panel-store.js';
 interface SessionListLike {
@@ -17,7 +18,23 @@ export interface ProviderRowView {
     detail: string;
     score: number;
     scoreLabel: string;
+    badge: string;
+    breakdown: string;
+    priceLabel: string;
+    savingsLabel: string | null;
 }
+export declare function providerInsight(row: RankedProvider, i18n?: {
+    locale: import("./i18n.js").SupportedLocale;
+    t(key: import("./i18n.js").TranslationKey, params?: Record<string, string | number>): string;
+}): {
+    badge: string;
+    breakdown: string;
+};
+export declare function providerPriceLabel(row: Pick<RankedProvider, 'price'>, i18n?: {
+    locale: import("./i18n.js").SupportedLocale;
+    t(key: import("./i18n.js").TranslationKey, params?: Record<string, string | number>): string;
+}): string;
+export declare function estimatedSavings(current: RankedProvider['price'], candidate: RankedProvider['price']): number | null;
 export declare const STRATEGY_OPTIONS: ReadonlyArray<{
     id: RankingStrategy;
     labelKey: 'panel.strategy.balanced' | 'panel.strategy.price' | 'panel.strategy.speed' | 'panel.strategy.context';
@@ -39,6 +56,10 @@ export declare function ProviderSidebarTrigger(props: GlobalSlotProps & {
     wide: boolean;
     store: ProviderPanelStore;
 }): ReactNode;
+export declare function freshnessLabel(updatedAt: number, now: number, i18n?: {
+    locale: import("./i18n.js").SupportedLocale;
+    t(key: import("./i18n.js").TranslationKey, params?: Record<string, string | number>): string;
+}): string;
 export declare const providerGridColumns = "minmax(110px,1fr) minmax(0,2fr) minmax(54px,auto)";
 export declare function ProviderOverlay(props: GlobalSlotProps & {
     store: ProviderPanelStore;

package/package.json

@@ -1,23 +1,45 @@
 {
   "name": "dsh-openrouter-provider-advisor",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "DSH web plugin that ranks OpenRouter upstream providers by quality, speed, cache-heavy price, context, and uptime, then safely switches the active route.",
-  "keywords": ["deepseek-harness", "dsh", "dsh-plugin", "openrouter", "provider-routing", "typescript"],
-  "repository": { "type": "git", "url": "git+https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor.git" },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "openrouter",
+    "provider-routing",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor.git"
+  },
   "homepage": "https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor#readme",
-  "bugs": { "url": "https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor/issues" },
-  "publishConfig": { "access": "public" },
+  "bugs": {
+    "url": "https://github.com/xuanfengtechx/dsh-openrouter-provider-advisor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
   "exports": {
-    ".": { "types": "./lib/types/index.d.ts", "default": "./lib/index.js" },
-    "./client": { "types": "./lib/types/client/index.d.ts", "default": "./lib/client.js" },
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json"
   },
   "dsh": {
-    "bundle": { "patch": "./cordis.patch.yml" },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
     "client": {
       "platform": "web",
       "inject": [
@@ -71,7 +93,19 @@
     "typescript": "^5.9.2",
     "vitest": "^4.1.8"
   },
-  "engines": { "node": "^22.19.0 || >=24.0.0" },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
   "license": "MIT",
-  "files": ["lib/**/*.js", "lib/types/**/*.d.ts", "cordis.patch.yml", "dsh.plugin.json", "README.md", "README_EN.md", "docs/images/*.png", "LICENSE"]
+  "files": [
+    "lib/**/*.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml",
+    "dsh.plugin.json",
+    "README.md",
+    "README_EN.md",
+    "CHANGELOG.md",
+    "docs/images/*.png",
+    "LICENSE"
+  ]
 }