@botharness/ui 1.0.1 → 1.0.2

package/lib/client.js

@@ -2802,11 +2802,11 @@ window.__ModuleLoader__.load({
 		async function sha256Hex(text) {
 			return hex(await crypto.subtle.digest("SHA-256", encoder.encode(text)));
 		}
-		function record$1(value) {
+		function record$3(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 		}
 		function parseChallenge(value) {
-			const source = record$1(value);
+			const source = record$3(value);
 			if (source === void 0 || source["algorithm"] !== "SHA-256") return void 0;
 			const { challenge, maxnumber, salt, signature } = source;
 			if (typeof challenge !== "string" || typeof salt !== "string" || typeof signature !== "string") return;
@@ -2840,11 +2840,11 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region packages/core/src/marketplace/client.ts
-		function record(value) {
+		function record$2(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 		}
 		function parseEntry(value) {
-			const source = record(value);
+			const source = record$2(value);
 			if (source === void 0) return void 0;
 			if (![
 				"id",
@@ -2859,7 +2859,7 @@ window.__ModuleLoader__.load({
 			const description = source["description"];
 			const stars = source["stars"];
 			const topics = source["topics"];
-			const head = record(source["headCommit"]);
+			const head = record$2(source["headCommit"]);
 			if (description !== null && typeof description !== "string") return void 0;
 			if (typeof stars !== "number" || !Array.isArray(topics)) return void 0;
 			const displayName = source["displayName"];
@@ -2885,7 +2885,7 @@ window.__ModuleLoader__.load({
 			};
 		}
 		function parseMarketplacePage(value) {
-			const source = record(value);
+			const source = record$2(value);
 			if (source === void 0 || !Array.isArray(source["bots"])) return void 0;
 			const bots = source["bots"].map(parseEntry);
 			if (!bots.every((bot) => bot !== void 0)) return void 0;
@@ -2896,7 +2896,7 @@ window.__ModuleLoader__.load({
 			} : { bots };
 		}
 		function parseMarketplaceDetail(value) {
-			const source = record(value);
+			const source = record$2(value);
 			const bot = parseEntry(source?.["bot"]);
 			const readme = source?.["readme"];
 			const commitSha = source?.["commitSha"];
@@ -2909,10 +2909,10 @@ window.__ModuleLoader__.load({
 			};
 		}
 		function parseMarketplaceTopics(value) {
-			const topics = record(value)?.["topics"];
+			const topics = record$2(value)?.["topics"];
 			if (!Array.isArray(topics)) return void 0;
 			const parsed = topics.map((item) => {
-				const source = record(item);
+				const source = record$2(item);
 				return typeof source?.["topic"] === "string" && typeof source["count"] === "number" ? {
 					topic: source["topic"],
 					count: source["count"]
@@ -2921,7 +2921,7 @@ window.__ModuleLoader__.load({
 			return parsed.every((item) => item !== void 0) ? parsed : void 0;
 		}
 		function parseMarketplaceSubmission(value) {
-			const bot = parseEntry(record(value)?.["bot"]);
+			const bot = parseEntry(record$2(value)?.["bot"]);
 			return bot === void 0 ? void 0 : { bot };
 		}
 		//#endregion
@@ -8715,6 +8715,503 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region packages/core/src/release/version.ts
+		const RELEASE_VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/u;
+		function parse(version) {
+			const match = RELEASE_VERSION.exec(version);
+			if (match === null) return void 0;
+			return {
+				core: [
+					Number(match[1]),
+					Number(match[2]),
+					Number(match[3])
+				],
+				prerelease: match[4] === void 0 ? [] : match[4].split(".")
+			};
+		}
+		function compareIdentifier(left, right) {
+			const leftNumeric = /^\d+$/u.test(left);
+			const rightNumeric = /^\d+$/u.test(right);
+			if (leftNumeric && rightNumeric) return Math.sign(Number(left) - Number(right));
+			if (leftNumeric) return -1;
+			if (rightNumeric) return 1;
+			return left < right ? -1 : left > right ? 1 : 0;
+		}
+		function isReleaseVersion(version) {
+			const parsed = parse(version);
+			return parsed !== void 0 && parsed.core.some((part) => part > 0);
+		}
+		function compareVersions(left, right) {
+			const a = parse(left);
+			const b = parse(right);
+			if (a === void 0 || b === void 0) return 0;
+			for (let index = 0; index < 3; index += 1) {
+				const difference = a.core[index] - b.core[index];
+				if (difference !== 0) return Math.sign(difference);
+			}
+			if (a.prerelease.length === 0 || b.prerelease.length === 0) return Math.sign(b.prerelease.length - a.prerelease.length);
+			const length = Math.max(a.prerelease.length, b.prerelease.length);
+			for (let index = 0; index < length; index += 1) {
+				const left = a.prerelease[index];
+				const right = b.prerelease[index];
+				if (left === void 0) return -1;
+				if (right === void 0) return 1;
+				const order = compareIdentifier(left, right);
+				if (order !== 0) return order;
+			}
+			return 0;
+		}
+		//#endregion
+		//#region packages/core/src/release/notes.ts
+		function record$1(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+		}
+		function parseText(value) {
+			const source = record$1(value);
+			return typeof source?.["en"] === "string" && typeof source["zh"] === "string" ? {
+				en: source["en"],
+				zh: source["zh"]
+			} : void 0;
+		}
+		function parseSection(value) {
+			const source = record$1(value);
+			if (typeof source?.["name"] !== "string" || !Array.isArray(source["entries"])) return void 0;
+			const entries = source["entries"].map(parseText);
+			return entries.every((entry) => entry !== void 0) ? {
+				name: source["name"],
+				entries
+			} : void 0;
+		}
+		function parseReleaseNotes(value) {
+			if (!Array.isArray(value)) return void 0;
+			const notes = [];
+			for (const item of value) {
+				const source = record$1(item);
+				const summary = parseText(source?.["summary"]);
+				const sections = Array.isArray(source?.["sections"]) ? source["sections"].map(parseSection) : void 0;
+				if (typeof source?.["version"] !== "string" || typeof source["date"] !== "string" || summary === void 0 || sections === void 0 || !sections.every((section) => section !== void 0)) return void 0;
+				notes.push({
+					version: source["version"],
+					date: source["date"],
+					summary,
+					sections
+				});
+			}
+			return notes;
+		}
+		//#endregion
+		//#region packages/client/src/client/release-notes.ts
+		const RELEASE_NOTES_SEEN_KEY = "botharness.releaseNotes.seenVersion";
+		function record(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+		}
+		function parseReleaseInfo(value) {
+			const source = record(value);
+			const releases = parseReleaseNotes(source?.["releases"]);
+			return typeof source?.["version"] === "string" && releases !== void 0 ? {
+				version: source["version"],
+				releases
+			} : void 0;
+		}
+		function parseReleaseUpdate(value) {
+			const source = record(value);
+			const current = source?.["current"];
+			const latest = source?.["latest"];
+			if (typeof current !== "string") return void 0;
+			switch (source?.["status"]) {
+				case "development":
+				case "unavailable": return {
+					status: source["status"],
+					current
+				};
+				case "current": return typeof latest === "string" ? {
+					status: "current",
+					current,
+					latest
+				} : void 0;
+				case "available": {
+					const releases = parseReleaseNotes(source["releases"]);
+					return typeof latest === "string" && releases !== void 0 ? {
+						status: "available",
+						current,
+						latest,
+						releases
+					} : void 0;
+				}
+				default: return;
+			}
+		}
+		function readSeen(storage) {
+			try {
+				const value = storage?.getItem(RELEASE_NOTES_SEEN_KEY);
+				return value !== null && value !== void 0 && isReleaseVersion(value) ? value : void 0;
+			} catch {
+				return;
+			}
+		}
+		var ReleaseNotesController = class {
+			source;
+			call;
+			storage;
+			started;
+			constructor(call, storage) {
+				this.call = call;
+				this.storage = storage;
+				this.source = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
+					version: void 0,
+					announcement: void 0,
+					firstRun: false,
+					viewing: void 0,
+					update: { status: "idle" }
+				});
+			}
+			start() {
+				this.started ??= this.announce().catch((error) => {
+					this.started = void 0;
+					console.warn("botharness: failed to read release notes", error);
+				});
+				return this.started;
+			}
+			dismiss() {
+				const version = this.source.getSnapshot().version;
+				if (version !== void 0 && isReleaseVersion(version)) try {
+					this.storage?.setItem(RELEASE_NOTES_SEEN_KEY, version);
+				} catch {
+					console.warn("botharness: failed to remember the seen release");
+				}
+				this.source.update((draft) => {
+					draft.announcement = void 0;
+				});
+			}
+			view(releases) {
+				this.source.update((draft) => {
+					draft.viewing = releases;
+				});
+			}
+			async checkUpdate(force = false) {
+				const current = this.source.getSnapshot().update.status;
+				if (current === "checking" || !force && current !== "idle") return;
+				this.source.update((draft) => {
+					draft.update = { status: "checking" };
+				});
+				let update;
+				try {
+					const result = await this.call("releaseUpdate", {});
+					update = result.ok ? parseReleaseUpdate(result.value) : void 0;
+				} catch {
+					update = void 0;
+				}
+				this.source.update((draft) => {
+					draft.update = update ?? {
+						status: "unavailable",
+						current: draft.version ?? ""
+					};
+				});
+			}
+			async announce() {
+				const seen = readSeen(this.storage);
+				const result = await this.call("releaseInfo", seen === void 0 ? {} : { since: seen });
+				if (!result.ok) throw new Error(result.error.message);
+				const info = parseReleaseInfo(result.value);
+				if (info === void 0) throw new Error("invalid releaseInfo response");
+				const fresh = isReleaseVersion(info.version) && (seen === void 0 || compareVersions(info.version, seen) > 0);
+				this.source.update((draft) => {
+					draft.version = info.version;
+					draft.announcement = fresh && info.releases.length > 0 ? info.releases : void 0;
+					draft.firstRun = seen === void 0;
+				});
+				if (fresh && info.releases.length === 0) this.dismiss();
+			}
+		};
+		//#endregion
+		//#region packages/client/src/client/modal.ts
+		const Modal = _deepseek_ai_dsh_client_ui_primitives.Modal;
+		//#endregion
+		//#region packages/client/src/client/release-notes-view.tsx
+		const SECTIONS = {
+			"Breaking Changes": {
+				key: "releaseNotes.section.breaking",
+				tone: "danger"
+			},
+			Security: {
+				key: "releaseNotes.section.security",
+				tone: "danger"
+			},
+			Added: {
+				key: "releaseNotes.section.added",
+				tone: "success"
+			},
+			Changed: {
+				key: "releaseNotes.section.changed",
+				tone: "info"
+			},
+			Fixed: {
+				key: "releaseNotes.section.fixed",
+				tone: "warning"
+			},
+			Documentation: {
+				key: "releaseNotes.section.documentation",
+				tone: "neutral"
+			},
+			Deprecated: {
+				key: "releaseNotes.section.deprecated",
+				tone: "warning"
+			},
+			Removed: {
+				key: "releaseNotes.section.removed",
+				tone: "neutral"
+			}
+		};
+		function releaseUpdateCommand(version) {
+			return `dsh plugin --profile web add deepseekbot@${version}`;
+		}
+		function useReleaseNotes(controller) {
+			return (0, react.useSyncExternalStore)(controller.source.subscribe, controller.source.getSnapshot);
+		}
+		function ReleaseNotesList({ releases, badge, t }) {
+			const language = t("releaseNotes.language") === "en" ? "en" : "zh";
+			const labels = (0, react.useMemo)(() => ({
+				code: {
+					copyLabel: t("message.code.copy"),
+					copiedLabel: t("message.code.copied")
+				},
+				footnotes: t("message.footnotes")
+			}), [t]);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "bh-release-notes",
+				"data-release-notes": true,
+				children: releases.map((release, index) => {
+					const entries = release.sections.flatMap((section) => section.entries.map((entry) => ({
+						section: section.name,
+						entry
+					})));
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("details", {
+						className: "bh-release-note",
+						"data-release-version": release.version,
+						open: index === 0,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("summary", {
+							className: "bh-release-note-head",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									className: "bh-release-note-version",
+									children: ["v", release.version]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("time", {
+									dateTime: release.date,
+									children: release.date
+								}),
+								index === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tag, {
+									tone: "info",
+									children: badge
+								}) : null,
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "bh-release-note-rule",
+									"aria-hidden": "true"
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "bh-release-note-count",
+									children: t("releaseNotes.entryCount", { count: entries.length })
+								})
+							]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "bh-release-note-body",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "bh-release-note-summary",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, {
+									text: release.summary[language],
+									labels
+								})
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+								className: "bh-release-note-entries",
+								children: entries.map(({ section, entry }, entryIndex) => {
+									const known = SECTIONS[section];
+									return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+										"data-release-section": section,
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tag, {
+											tone: known?.tone ?? "outline",
+											className: "bh-release-note-chip",
+											children: known === void 0 ? section : t(known.key)
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "bh-release-note-text",
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, {
+												text: entry[language],
+												labels
+											})
+										})]
+									}, entryIndex);
+								})
+							})]
+						})]
+					}, release.version);
+				})
+			});
+		}
+		function openSite(t) {
+			window.open(t("releaseNotes.siteUrl"), "_blank", "noopener,noreferrer");
+		}
+		function ReleaseNotesDialog({ releases, title, badge, description, onClose, t }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Modal, {
+				open: releases !== void 0,
+				onClose,
+				title,
+				closeLabel: t("releaseNotes.close"),
+				...description === void 0 ? {} : { description },
+				className: "bh-release-dialog",
+				footer: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "outline",
+					className: "bh-release-site-button",
+					onClick: () => {
+						openSite(t);
+					},
+					children: t("releaseNotes.site")
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "primary",
+					onClick: onClose,
+					children: t("releaseNotes.done")
+				})] }),
+				children: releases === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ReleaseNotesList, {
+					releases,
+					badge,
+					t
+				})
+			});
+		}
+		function ReleaseNotesAnnouncement({ controller, t }) {
+			const snapshot = useReleaseNotes(controller);
+			const mount = useMountedResource(() => {
+				controller.start();
+			}, [controller]);
+			const version = snapshot.version ?? "";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				ref: mount,
+				hidden: true,
+				"aria-hidden": "true"
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ReleaseNotesDialog, {
+				releases: snapshot.announcement,
+				title: t("releaseNotes.announce.title", { version }),
+				badge: t("releaseNotes.current"),
+				description: t(snapshot.firstRun ? "releaseNotes.announce.firstRun" : "releaseNotes.announce.description"),
+				onClose: () => {
+					controller.dismiss();
+				},
+				t
+			})] });
+		}
+		function statusText(snapshot, t) {
+			const version = snapshot.version;
+			if (version === void 0) return t("release.status.loading");
+			const update = snapshot.update;
+			switch (update.status) {
+				case "development": return t("release.status.development", { version });
+				case "available": return t("release.status.available", {
+					version,
+					latest: update.latest
+				});
+				case "current": return t("release.status.current", { version });
+				case "unavailable": return t("release.status.unavailable", { version });
+				default: return t("release.status.checking", { version });
+			}
+		}
+		function ReleaseSettings({ releaseNotes, t }) {
+			const snapshot = useReleaseNotes(releaseNotes);
+			const [copied, setCopied] = (0, react.useState)(false);
+			const mount = useMountedResource(() => {
+				releaseNotes.start().then(() => releaseNotes.checkUpdate());
+			}, [releaseNotes]);
+			const update = snapshot.update;
+			const command = update.status === "available" ? releaseUpdateCommand(update.latest) : void 0;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "bh-release-settings",
+				ref: mount,
+				"data-release-settings": true,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "bh-settings-row bh-release-row",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "bh-settings-row-text",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "bh-settings-row-title",
+								children: t("release.row.title")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "bh-settings-row-desc",
+								role: "status",
+								"aria-live": "polite",
+								children: statusText(snapshot, t)
+							})]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "bh-release-actions",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								size: "sm",
+								variant: "outline",
+								onClick: () => {
+									openSite(t);
+								},
+								children: t("release.changelog")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								size: "sm",
+								variant: "outline",
+								disabled: update.status === "checking" || update.status === "development",
+								onClick: () => {
+									releaseNotes.checkUpdate(true);
+								},
+								children: t("release.check")
+							})]
+						})]
+					}),
+					update.status === "available" && command !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "bh-release-update",
+						"data-release-update": update.latest,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "bh-release-update-head",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "bh-release-update-title",
+									children: t("release.update.title", { latest: update.latest })
+								}), update.releases.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+									size: "sm",
+									variant: "outline",
+									onClick: () => {
+										releaseNotes.view(update.releases);
+									},
+									children: t("release.update.notes")
+								}) : null]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "bh-settings-row-desc",
+								children: t("release.update.cli")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "bh-release-command",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: command }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+									size: "sm",
+									variant: "outline",
+									onClick: () => {
+										navigator.clipboard?.writeText(command).then(() => {
+											setCopied(true);
+										});
+									},
+									children: t(copied ? "release.update.copied" : "release.update.copy")
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "bh-settings-row-desc",
+								children: t("release.update.desktop", { spec: `deepseekbot@${update.latest}` })
+							})
+						]
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ReleaseNotesDialog, {
+						releases: snapshot.viewing,
+						title: t("release.update.dialog", { latest: update.status === "available" ? update.latest : "" }),
+						badge: t("releaseNotes.latest"),
+						onClose: () => {
+							releaseNotes.view(void 0);
+						},
+						t
+					})
+				]
+			});
+		}
+		//#endregion
 		//#region node_modules/.pnpm/@botharness+botui-core@0.3.0/node_modules/@botharness/botui-core/dist/index.js
 		const TAU$1 = Math.PI * 2;
 		function clamp$1(v, a, b) {
@@ -11297,7 +11794,42 @@ window.__ModuleLoader__.load({
 			"rail.copied": "已复制",
 			"rail.you": "你",
 			"rail.noMessages": "暂无消息",
-			"roster.readOnly": "名册存储不可用，陈列只读"
+			"roster.readOnly": "名册存储不可用，陈列只读",
+			"releaseNotes.language": "zh",
+			"releaseNotes.siteUrl": "https://deepseekbot.botharness.ai/changelog/",
+			"releaseNotes.site": "去官网查看",
+			"releaseNotes.close": "关闭",
+			"releaseNotes.done": "知道了",
+			"releaseNotes.announce.title": "DeepSeekBot {version} 更新内容",
+			"releaseNotes.announce.description": "以下是自你上次查看以来的变化。",
+			"releaseNotes.announce.firstRun": "欢迎使用 DeepSeekBot，这是当前版本带来的内容。",
+			"releaseNotes.latest": "最新",
+			"releaseNotes.current": "当前版本",
+			"releaseNotes.entryCount": "{count} 项",
+			"releaseNotes.section.added": "新增",
+			"releaseNotes.section.changed": "变更",
+			"releaseNotes.section.fixed": "修复",
+			"releaseNotes.section.documentation": "文档",
+			"releaseNotes.section.breaking": "不兼容",
+			"releaseNotes.section.deprecated": "弃用",
+			"releaseNotes.section.removed": "移除",
+			"releaseNotes.section.security": "安全",
+			"release.row.title": "DeepSeekBot 版本",
+			"release.status.loading": "正在读取当前版本…",
+			"release.status.development": "源码构建（{version}），不检查更新",
+			"release.status.checking": "当前版本 {version}，正在检查更新…",
+			"release.status.current": "当前版本 {version}，已是最新版本",
+			"release.status.available": "当前版本 {version}，新版本 {latest} 可用",
+			"release.status.unavailable": "当前版本 {version}，暂时无法连接 npm 检查更新",
+			"release.changelog": "更新日志",
+			"release.check": "检查更新",
+			"release.update.title": "可以更新到 {latest}",
+			"release.update.notes": "查看新版本内容",
+			"release.update.dialog": "DeepSeekBot {latest} 更新内容",
+			"release.update.cli": "在终端运行以下命令更新，完成后重启 DSH：",
+			"release.update.copy": "复制",
+			"release.update.copied": "已复制",
+			"release.update.desktop": "桌面版：打开「插件 → 添加插件」，输入 {spec} 安装，然后重启 DSH。"
 		};
 		function zhTranslate(key, params) {
 			let text = zh[key] ?? key;
@@ -12871,7 +13403,42 @@ My relationship with the Human, established lore and topics to avoid: [fill in].
 			"rail.copied": "Copied",
 			"rail.you": "You",
 			"rail.noMessages": "No messages yet",
-			"roster.readOnly": "Roster storage unavailable; the arrangement is read-only"
+			"roster.readOnly": "Roster storage unavailable; the arrangement is read-only",
+			"releaseNotes.language": "en",
+			"releaseNotes.siteUrl": "https://deepseekbot.botharness.ai/en/changelog/",
+			"releaseNotes.site": "View on website",
+			"releaseNotes.close": "Close",
+			"releaseNotes.done": "Got it",
+			"releaseNotes.announce.title": "What's new in DeepSeekBot {version}",
+			"releaseNotes.announce.description": "Here is what changed since you last looked.",
+			"releaseNotes.announce.firstRun": "Welcome to DeepSeekBot. Here is what this version brings.",
+			"releaseNotes.latest": "Latest",
+			"releaseNotes.current": "Installed",
+			"releaseNotes.entryCount": "{count} changes",
+			"releaseNotes.section.added": "Added",
+			"releaseNotes.section.changed": "Changed",
+			"releaseNotes.section.fixed": "Fixed",
+			"releaseNotes.section.documentation": "Docs",
+			"releaseNotes.section.breaking": "Breaking",
+			"releaseNotes.section.deprecated": "Deprecated",
+			"releaseNotes.section.removed": "Removed",
+			"releaseNotes.section.security": "Security",
+			"release.row.title": "DeepSeekBot version",
+			"release.status.loading": "Reading the installed version…",
+			"release.status.development": "Source build ({version}); updates are not checked",
+			"release.status.checking": "Version {version}, checking for updates…",
+			"release.status.current": "Version {version}, up to date",
+			"release.status.available": "Version {version}, {latest} is available",
+			"release.status.unavailable": "Version {version}, could not reach npm to check for updates",
+			"release.changelog": "Changelog",
+			"release.check": "Check for updates",
+			"release.update.title": "Update to {latest}",
+			"release.update.notes": "See what's new",
+			"release.update.dialog": "What's new in DeepSeekBot {latest}",
+			"release.update.cli": "Run this command in a terminal, then restart DSH:",
+			"release.update.copy": "Copy",
+			"release.update.copied": "Copied",
+			"release.update.desktop": "Desktop app: open Plugins → Add plugin, install {spec}, then restart DSH."
 		};
 		//#endregion
 		//#region node_modules/.pnpm/@botharness+pixel-morph@0.2.0/node_modules/@botharness/pixel-morph/dist/index.js
@@ -15071,9 +15638,6 @@ My relationship with the Human, established lore and topics to avoid: [fill in].
 				}, [])
 			};
 		}
-		//#endregion
-		//#region packages/client/src/client/modal.ts
-		const Modal = _deepseek_ai_dsh_client_ui_primitives.Modal;
 		function hiddenChannelSequence(channels, hiddenIds) {
 			const byId = new Map(channels.map((channel) => [channel.id, channel]));
 			const seen = /* @__PURE__ */ new Set();
@@ -40291,25 +40855,32 @@ My relationship with the Human, established lore and topics to avoid: [fill in].
 				t
 			}, `${scopeKey}:${state.conversation.channel?.id ?? ""}`);
 		}
-		function BotPanel({ actions, nativeSessions, channelSidebar, profileCards, nativeChatT, t }) {
+		function BotPanel({ actions, nativeSessions, channelSidebar, profileCards, nativeChatT, releaseNotes, t }) {
 			const modeMount = useMountedResource(() => {
 				store.setMode("bot");
 				return () => {
 					store.setMode("dsh");
 				};
 			}, []);
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				ref: modeMount,
-				hidden: true,
-				"aria-hidden": "true"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BotMain, {
-				actions,
-				nativeSessions,
-				channelSidebar,
-				profileCards,
-				nativeChatT,
-				t
-			})] });
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					ref: modeMount,
+					hidden: true,
+					"aria-hidden": "true"
+				}),
+				releaseNotes === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ReleaseNotesAnnouncement, {
+					controller: releaseNotes,
+					t
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(BotMain, {
+					actions,
+					nativeSessions,
+					channelSidebar,
+					profileCards,
+					nativeChatT,
+					t
+				})
+			] });
 		}
 		//#endregion
 		//#region packages/client/src/client/memory-git-lanes.ts
@@ -49716,6 +50287,146 @@ button:has(.bh-panel-glyph):is(:hover, :focus-within) ~ .bh-panel-activity[data-
 .bh-overview-usage .bh-profile-pin:hover {background:var(--bh-hover);color:var(--bh-text);}
 .bh-overview-usage .bh-profile-pin:disabled {cursor:default;opacity:0.5;}
 .bh-statistics-content > header h3 {font-size:var(--bh-overview-font);margin:0;}
+.bh-release-dialog {
+  width: min(680px, calc(100vw - 32px));
+}
+.bh-release-notes {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  max-height: min(60vh, 560px);
+  overflow-y: auto;
+  min-width: 0;
+}
+.bh-release-note {
+  min-width: 0;
+}
+.bh-release-note-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 0;
+  cursor: pointer;
+  list-style: none;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+  line-height: 20px;
+}
+.bh-release-note-head::-webkit-details-marker {
+  display: none;
+}
+.bh-release-note-head::before {
+  content: '';
+  flex: none;
+  width: 6px;
+  height: 6px;
+  margin: 0 2px;
+  border-right: 1.5px solid currentColor;
+  border-bottom: 1.5px solid currentColor;
+  transform: rotate(-45deg);
+  transition: transform 0.15s ease;
+}
+.bh-release-note[open] > .bh-release-note-head::before {
+  transform: rotate(45deg);
+}
+.bh-release-note-head:hover .bh-release-note-version {
+  color: var(--bh-accent, var(--dsw-alias-state-business-primary));
+}
+.bh-release-note-version {
+  font-size: 15px;
+  font-weight: 600;
+  line-height: 22px;
+  color: var(--dsw-alias-label-primary);
+}
+.bh-release-note-rule {
+  flex: 1;
+  min-width: 16px;
+  height: 1px;
+  background: var(--dsw-alias-border-l2);
+}
+.bh-release-note-count {
+  flex: none;
+  font-variant-numeric: tabular-nums;
+}
+.bh-release-note-body {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 2px 0 12px 18px;
+}
+.bh-release-note-summary {
+  color: var(--dsw-alias-label-secondary);
+  font-size: 13px;
+}
+.bh-release-note-entries {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: start;
+  gap: 8px 10px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.bh-release-note-entries > li {
+  display: contents;
+}
+.bh-release-note-chip {
+  justify-self: stretch;
+  justify-content: center;
+  margin-top: 2px;
+  white-space: nowrap;
+}
+.bh-release-note-text {
+  min-width: 0;
+  font-size: 13px;
+  color: var(--dsw-alias-label-primary);
+}
+.bh-release-site-button {
+  margin-right: auto;
+}
+.bh-release-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex: none;
+}
+.bh-release-update {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  margin: 12px 0 4px;
+  padding: 12px 14px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 10px;
+}
+.bh-release-update-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+.bh-release-update-title {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--dsw-alias-label-primary);
+}
+.bh-release-command {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+.bh-release-command code {
+  flex: 1;
+  min-width: 0;
+  overflow-x: auto;
+  padding: 6px 10px;
+  border-radius: 6px;
+  background: var(--dsw-alias-bg-module-platform);
+  font-family: var(--dsw-font-family-mono, monospace);
+  font-size: 12px;
+  white-space: nowrap;
+}
 `;
 		//#endregion
 		//#region packages/client/src/client/index.ts
@@ -49775,6 +50486,7 @@ button:has(.bh-panel-glyph):is(:hover, :focus-within) ~ .bh-panel-activity[data-
 				}
 			});
 			const prefs = new BotModePrefs(storage);
+			const releaseNotes = new ReleaseNotesController(call, storage);
 			const lastView = typeof window === "undefined" ? void 0 : consumeLastView(window, storage);
 			let restoreBotMode = hmrView === void 0 && lastView?.mode === "bot";
 			const nativeSessions = {
@@ -49893,6 +50605,13 @@ button:has(.bh-panel-glyph):is(:hover, :focus-within) ~ .bh-panel-activity[data-
 						};
 					}
 				});
+				settingsCtx.slots.inject("botharness.settings.item", () => settingsCtx.slots.register({
+					name: "botharness.settings.item",
+					id: "release",
+					order: -20,
+					locale: LOCALE_NS,
+					inject: () => ({ releaseNotes })
+				}, ReleaseSettings));
 				settingsCtx.slots.inject("botharness.settings.item", () => settingsCtx.slots.register({
 					name: "botharness.settings.item",
 					id: "human-name",
@@ -49960,7 +50679,8 @@ button:has(.bh-panel-glyph):is(:hover, :focus-within) ~ .bh-panel-activity[data-
 						channelSidebar,
 						profileCards,
 						nativeChatT,
-						nativeSessions
+						nativeSessions,
+						releaseNotes
 					})
 				}, BotPanel);
 				if (restoreBotMode) {