dsh-dock 0.11.2 → 0.11.5

package/src/shared.js

@@ -1,192 +1,192 @@
-// dsh-dock · 客户端共享工具（外壳与功能模块共用；提取功能模块独立成包时随包复制）
-import react from "react";
-
-/**
- * 功能视图错误边界：视图渲染抛错时降级为一行错误提示，不拖垮整块面板 UI。
- *
- * ⚠️ 内置视图也必须包（v0.9.9 起）：宿主把每个插槽条目包在 SlotErrorBoundary 里，
- * 条目内任何渲染抛错都会被宿主换成空 div——表现为「点开功能坞界面整个没了」而侧栏
- * 入口按钮仍是选中态。v0.9.3~0.9.8 的 animation 视图就是这样被一个 ReferenceError 打没的。
- * label 用于提示里点明是哪个功能；调用处应带 key（切换功能时重建，否则错误态会跟着串页）。
- */
-export class FeatureBoundary extends react.Component {
-	constructor(props) {
-		super(props);
-		this.state = { error: null };
-	}
-	static getDerivedStateFromError(error) {
-		return { error: error };
-	}
-	componentDidCatch(error) {
-		console.error("[dsh-dock] 功能视图渲染出错：", error);
-	}
-	render() {
-		if (this.state.error) {
-			const msg = this.state.error && this.state.error.message ? this.state.error.message : String(this.state.error);
-			const who = this.props && this.props.label ? "「" + this.props.label + "」" : "功能视图";
-			return react.createElement("div", { className: "dockm-note dockm-err" },
-				who + "渲染出错：" + msg + "（已隔离，不影响面板其他功能；详情见浏览器控制台）");
-		}
-		return this.props.children;
-	}
-}
-
-// ---- 功能开关状态（外壳面板与会话区 chips 共用；每功能开关 localStorage 持久化，重启后保持） ----
-const featureState = new Map();
-const stateListeners = new Set();
-function notifyState() {
-	for (const fn of stateListeners) fn();
-}
-// 开关持久化（dsh-dock/features/v1）：id -> boolean；未记录过的功能用模块默认值
-const FEATURE_STORE_KEY = "dsh-dock/features/v1";
-const featurePersist = { map: {} };
-try {
-	if (typeof localStorage !== "undefined") {
-		const raw = localStorage.getItem(FEATURE_STORE_KEY);
-		const obj = raw ? JSON.parse(raw) : null;
-		if (obj && typeof obj === "object") featurePersist.map = obj;
-	}
-} catch { /* localStorage 不可用时用默认值 */ }
-function persistFeatureEnabled() {
-	try {
-		if (typeof localStorage !== "undefined") localStorage.setItem(FEATURE_STORE_KEY, JSON.stringify(featurePersist.map));
-	} catch { /* 持久化失败静默 */ }
-}
-/** 外壳 apply 时初始化内置功能的默认开关（持久化过的值优先于模块默认）。
- * 默认全部停用、按需开启：仅当模块显式声明 defaultEnabled: true 才默认启用。 */
-export function initFeatureState(defs) {
-	for (const f of defs) {
-		if (featureState.has(f.id)) continue;
-		let enabled = !f.planned && f.defaultEnabled === true;
-		const saved = featurePersist.map[f.id];
-		if (typeof saved === "boolean") enabled = saved;
-		featureState.set(f.id, { enabled, error: null });
-	}
-	// 宿主侧持久化开关（settings，跨浏览器/重启）优先：拉过来覆盖本地默认值。
-	// localStorage 里已有记录的 id 视为用户在这台浏览器已表态，保持本地值；
-	// 若宿主从未收到过该功能的开关，则把本浏览器的选择补推一次（见 syncFeatureStateFromHost）。
-	syncFeatureStateFromHost(defs);
-}
-
-/** 从宿主 /dsh-dock/features 拉取持久化开关，覆盖尚未本地表态的功能默认值。
- * 拉取失败（宿主旧版本无此路由）静默降级——沿用本地默认。 */
-function syncFeatureStateFromHost(defs) {
-	if (typeof fetch !== "function") return;
-	fetch("/dsh-dock/features").then(async (res) => {
-		if (!res.ok) return;
-		const data = await res.json().catch(() => null);
-		const persisted = data && data.ok && data.data && data.data.persisted;
-		if (!persisted || typeof persisted !== "object") return;
-		let changed = false;
-		for (const f of defs) {
-			const local = featurePersist.map[f.id];
-			const host = persisted[f.id];
-			if (local === undefined) {
-				// 本浏览器没表态：跟随宿主持久化值
-				if (typeof host === "boolean") {
-					const st = stateOf(f.id);
-					if (st.enabled !== host) { st.enabled = host; changed = true; }
-				}
-				continue;
-			}
-			// 本浏览器已表态，但宿主从未收到过这个功能的开关（persisted 里根本没有它）：
-			// 补推一次本浏览器的选择。否则会出现「面板显示已启用、宿主侧却从未 setup」——
-			// 该功能的路由整片 404，面板还会误报「宿主进程是旧版本」。宿主刚升级、
-			// 或新功能刚拆出来时最容易踩（「任务通知」拆分时就是这样：点开关时宿主
-			// 还是旧进程 → POST 404 → 开关只留在浏览器本地，重启后宿主永远不知道）。
-			// 注意只在「宿主没有记录」时补推：宿主已显式记过 false 说明是别处关掉的，
-			// 不能拿本浏览器的旧值去覆盖（多设备场景）。
-			if (typeof host !== "boolean") pushFeatureEnabledToHost(f.id, local);
-		}
-		if (changed) notifyState();
-	}).catch(() => { /* 宿主不可达时用本地默认 */ });
-}
-
-/** 把开关同步到宿主（settings 持久化 + 宿主半部即时 setup/dispose）。失败只 warn 不打断：
- * 宿主侧开关只影响路由注册等 Host 能力，本地 UI 状态仍然即时生效。
- * （注意 fetch 对 404 这类 HTTP 错误是正常 resolve，必须查 res.ok——曾因 id 不一致
- * 开关永远 404 而这里毫无声息，排查了两个版本才发现。） */
-function pushFeatureEnabledToHost(id, enabled) {
-	if (typeof fetch !== "function") return;
-	fetch("/dsh-dock/features", {
-		method: "POST",
-		headers: { "content-type": "application/json" },
-		body: JSON.stringify({ id, enabled }),
-	}).then((res) => {
-		if (!res.ok) console.warn(`[dsh-dock] 功能开关同步宿主失败：${id}=${enabled} → HTTP ${res.status}（宿主不认识该 id 或插件未就绪）`);
-	}).catch(() => { /* 宿主旧版本或不可达：本地开关仍生效（仅本浏览器） */ });
-}
-export function toggleFeature(id) {
-	const st = stateOf(id);
-	st.enabled = !st.enabled;
-	featurePersist.map[id] = st.enabled;
-	persistFeatureEnabled();
-	pushFeatureEnabledToHost(id, st.enabled);
-	notifyState();
-}
-/** 取功能开关（外部功能默认启用；未登记的 id 惰性建项）。 */
-export function stateOf(id) {
-	let st = featureState.get(id);
-	if (!st) { st = { enabled: true, error: null }; featureState.set(id, st); }
-	return st;
-}
-export function subscribeFeatureState(fn) {
-	stateListeners.add(fn);
-	return () => { stateListeners.delete(fn); };
-}
-
-// ---- 会话页 chips 显示开关（每功能；localStorage 持久化，缺省显示） ----
-// 与功能启用正交：功能启用决定面板页与宿主功能，本开关只控制会话输入区的随身小控件。
-const CHIP_STORE_KEY = "dsh-dock/chips/v1";
-const chipVisible = { map: {} };
-try {
-	if (typeof localStorage !== "undefined") {
-		const raw = localStorage.getItem(CHIP_STORE_KEY);
-		const obj = raw ? JSON.parse(raw) : null;
-		if (obj && typeof obj === "object") chipVisible.map = obj;
-	}
-} catch { /* localStorage 不可用时用默认值 */ }
-function persistChipVisible() {
-	try {
-		if (typeof localStorage !== "undefined") localStorage.setItem(CHIP_STORE_KEY, JSON.stringify(chipVisible.map));
-	} catch { /* 持久化失败静默 */ }
-}
-/** 功能的会话页 chip 是否显示（未记录过的功能默认显示）。 */
-export function chipShown(id) {
-	return chipVisible.map[id] !== false;
-}
-/** 设置功能的会话页 chip 显示开关（立即生效并持久化）。 */
-export function setChipShown(id, value) {
-	chipVisible.map[id] = value !== false;
-	persistChipVisible();
-	notifyState();
-}
-
-// ---- 面板导航总线：功能坞外任何位置（会话区 chips 等）可请求打开面板并跳到某功能 ----
-// openPanel("balance", { provider })   → 打开功能坞并定位到模型余额页，高亮指定 Provider
-// openPanel("tokenlog", { sessionId }) → 打开功能坞并定位到用量记录页，按会话筛选
-export const panelNav = { open: false, active: "home", params: null };
-const navListeners = new Set();
-function notifyNav() {
-	for (const fn of navListeners) fn();
-}
-export function openPanel(active, params) {
-	panelNav.open = true;
-	panelNav.active = typeof active === "string" && active ? active : "home";
-	panelNav.params = params && typeof params === "object" ? params : null;
-	notifyNav();
-}
-export function setPanelOpen(value) {
-	panelNav.open = !!value;
-	if (!value) panelNav.params = null;
-	notifyNav();
-}
-/** 面板内切换功能页（不携带参数）。 */
-export function navigatePanel(active) {
-	panelNav.active = typeof active === "string" && active ? active : "home";
-	notifyNav();
-}
-export function subscribePanel(fn) {
-	navListeners.add(fn);
-	return () => { navListeners.delete(fn); };
-}
+// dsh-dock · 客户端共享工具（外壳与功能模块共用；提取功能模块独立成包时随包复制）
+import react from "react";
+
+/**
+ * 功能视图错误边界：视图渲染抛错时降级为一行错误提示，不拖垮整块面板 UI。
+ *
+ * ⚠️ 内置视图也必须包（v0.9.9 起）：宿主把每个插槽条目包在 SlotErrorBoundary 里，
+ * 条目内任何渲染抛错都会被宿主换成空 div——表现为「点开功能坞界面整个没了」而侧栏
+ * 入口按钮仍是选中态。v0.9.3~0.9.8 的 animation 视图就是这样被一个 ReferenceError 打没的。
+ * label 用于提示里点明是哪个功能；调用处应带 key（切换功能时重建，否则错误态会跟着串页）。
+ */
+export class FeatureBoundary extends react.Component {
+	constructor(props) {
+		super(props);
+		this.state = { error: null };
+	}
+	static getDerivedStateFromError(error) {
+		return { error: error };
+	}
+	componentDidCatch(error) {
+		console.error("[dsh-dock] 功能视图渲染出错：", error);
+	}
+	render() {
+		if (this.state.error) {
+			const msg = this.state.error && this.state.error.message ? this.state.error.message : String(this.state.error);
+			const who = this.props && this.props.label ? "「" + this.props.label + "」" : "功能视图";
+			return react.createElement("div", { className: "dockm-note dockm-err" },
+				who + "渲染出错：" + msg + "（已隔离，不影响面板其他功能；详情见浏览器控制台）");
+		}
+		return this.props.children;
+	}
+}
+
+// ---- 功能开关状态（外壳面板与会话区 chips 共用；每功能开关 localStorage 持久化，重启后保持） ----
+const featureState = new Map();
+const stateListeners = new Set();
+function notifyState() {
+	for (const fn of stateListeners) fn();
+}
+// 开关持久化（dsh-dock/features/v1）：id -> boolean；未记录过的功能用模块默认值
+const FEATURE_STORE_KEY = "dsh-dock/features/v1";
+const featurePersist = { map: {} };
+try {
+	if (typeof localStorage !== "undefined") {
+		const raw = localStorage.getItem(FEATURE_STORE_KEY);
+		const obj = raw ? JSON.parse(raw) : null;
+		if (obj && typeof obj === "object") featurePersist.map = obj;
+	}
+} catch { /* localStorage 不可用时用默认值 */ }
+function persistFeatureEnabled() {
+	try {
+		if (typeof localStorage !== "undefined") localStorage.setItem(FEATURE_STORE_KEY, JSON.stringify(featurePersist.map));
+	} catch { /* 持久化失败静默 */ }
+}
+/** 外壳 apply 时初始化内置功能的默认开关（持久化过的值优先于模块默认）。
+ * 默认全部停用、按需开启：仅当模块显式声明 defaultEnabled: true 才默认启用。 */
+export function initFeatureState(defs) {
+	for (const f of defs) {
+		if (featureState.has(f.id)) continue;
+		let enabled = !f.planned && f.defaultEnabled === true;
+		const saved = featurePersist.map[f.id];
+		if (typeof saved === "boolean") enabled = saved;
+		featureState.set(f.id, { enabled, error: null });
+	}
+	// 宿主侧持久化开关（settings，跨浏览器/重启）优先：拉过来覆盖本地默认值。
+	// localStorage 里已有记录的 id 视为用户在这台浏览器已表态，保持本地值；
+	// 若宿主从未收到过该功能的开关，则把本浏览器的选择补推一次（见 syncFeatureStateFromHost）。
+	syncFeatureStateFromHost(defs);
+}
+
+/** 从宿主 /dsh-dock/features 拉取持久化开关，覆盖尚未本地表态的功能默认值。
+ * 拉取失败（宿主旧版本无此路由）静默降级——沿用本地默认。 */
+function syncFeatureStateFromHost(defs) {
+	if (typeof fetch !== "function") return;
+	fetch("/dsh-dock/features").then(async (res) => {
+		if (!res.ok) return;
+		const data = await res.json().catch(() => null);
+		const persisted = data && data.ok && data.data && data.data.persisted;
+		if (!persisted || typeof persisted !== "object") return;
+		let changed = false;
+		for (const f of defs) {
+			const local = featurePersist.map[f.id];
+			const host = persisted[f.id];
+			if (local === undefined) {
+				// 本浏览器没表态：跟随宿主持久化值
+				if (typeof host === "boolean") {
+					const st = stateOf(f.id);
+					if (st.enabled !== host) { st.enabled = host; changed = true; }
+				}
+				continue;
+			}
+			// 本浏览器已表态，但宿主从未收到过这个功能的开关（persisted 里根本没有它）：
+			// 补推一次本浏览器的选择。否则会出现「面板显示已启用、宿主侧却从未 setup」——
+			// 该功能的路由整片 404，面板还会误报「宿主进程是旧版本」。宿主刚升级、
+			// 或新功能刚拆出来时最容易踩（「任务通知」拆分时就是这样：点开关时宿主
+			// 还是旧进程 → POST 404 → 开关只留在浏览器本地，重启后宿主永远不知道）。
+			// 注意只在「宿主没有记录」时补推：宿主已显式记过 false 说明是别处关掉的，
+			// 不能拿本浏览器的旧值去覆盖（多设备场景）。
+			if (typeof host !== "boolean") pushFeatureEnabledToHost(f.id, local);
+		}
+		if (changed) notifyState();
+	}).catch(() => { /* 宿主不可达时用本地默认 */ });
+}
+
+/** 把开关同步到宿主（settings 持久化 + 宿主半部即时 setup/dispose）。失败只 warn 不打断：
+ * 宿主侧开关只影响路由注册等 Host 能力，本地 UI 状态仍然即时生效。
+ * （注意 fetch 对 404 这类 HTTP 错误是正常 resolve，必须查 res.ok——曾因 id 不一致
+ * 开关永远 404 而这里毫无声息，排查了两个版本才发现。） */
+function pushFeatureEnabledToHost(id, enabled) {
+	if (typeof fetch !== "function") return;
+	fetch("/dsh-dock/features", {
+		method: "POST",
+		headers: { "content-type": "application/json" },
+		body: JSON.stringify({ id, enabled }),
+	}).then((res) => {
+		if (!res.ok) console.warn(`[dsh-dock] 功能开关同步宿主失败：${id}=${enabled} → HTTP ${res.status}（宿主不认识该 id 或插件未就绪）`);
+	}).catch(() => { /* 宿主旧版本或不可达：本地开关仍生效（仅本浏览器） */ });
+}
+export function toggleFeature(id) {
+	const st = stateOf(id);
+	st.enabled = !st.enabled;
+	featurePersist.map[id] = st.enabled;
+	persistFeatureEnabled();
+	pushFeatureEnabledToHost(id, st.enabled);
+	notifyState();
+}
+/** 取功能开关（外部功能默认启用；未登记的 id 惰性建项）。 */
+export function stateOf(id) {
+	let st = featureState.get(id);
+	if (!st) { st = { enabled: true, error: null }; featureState.set(id, st); }
+	return st;
+}
+export function subscribeFeatureState(fn) {
+	stateListeners.add(fn);
+	return () => { stateListeners.delete(fn); };
+}
+
+// ---- 会话页 chips 显示开关（每功能；localStorage 持久化，缺省显示） ----
+// 与功能启用正交：功能启用决定面板页与宿主功能，本开关只控制会话输入区的随身小控件。
+const CHIP_STORE_KEY = "dsh-dock/chips/v1";
+const chipVisible = { map: {} };
+try {
+	if (typeof localStorage !== "undefined") {
+		const raw = localStorage.getItem(CHIP_STORE_KEY);
+		const obj = raw ? JSON.parse(raw) : null;
+		if (obj && typeof obj === "object") chipVisible.map = obj;
+	}
+} catch { /* localStorage 不可用时用默认值 */ }
+function persistChipVisible() {
+	try {
+		if (typeof localStorage !== "undefined") localStorage.setItem(CHIP_STORE_KEY, JSON.stringify(chipVisible.map));
+	} catch { /* 持久化失败静默 */ }
+}
+/** 功能的会话页 chip 是否显示（未记录过的功能默认显示）。 */
+export function chipShown(id) {
+	return chipVisible.map[id] !== false;
+}
+/** 设置功能的会话页 chip 显示开关（立即生效并持久化）。 */
+export function setChipShown(id, value) {
+	chipVisible.map[id] = value !== false;
+	persistChipVisible();
+	notifyState();
+}
+
+// ---- 面板导航总线：功能坞外任何位置（会话区 chips 等）可请求打开面板并跳到某功能 ----
+// openPanel("balance", { provider })   → 打开功能坞并定位到模型余额页，高亮指定 Provider
+// openPanel("tokenlog", { sessionId }) → 打开功能坞并定位到用量记录页，按会话筛选
+export const panelNav = { open: false, active: "home", params: null };
+const navListeners = new Set();
+function notifyNav() {
+	for (const fn of navListeners) fn();
+}
+export function openPanel(active, params) {
+	panelNav.open = true;
+	panelNav.active = typeof active === "string" && active ? active : "home";
+	panelNav.params = params && typeof params === "object" ? params : null;
+	notifyNav();
+}
+export function setPanelOpen(value) {
+	panelNav.open = !!value;
+	if (!value) panelNav.params = null;
+	notifyNav();
+}
+/** 面板内切换功能页（不携带参数）。 */
+export function navigatePanel(active) {
+	panelNav.active = typeof active === "string" && active ? active : "home";
+	notifyNav();
+}
+export function subscribePanel(fn) {
+	navListeners.add(fn);
+	return () => { navListeners.delete(fn); };
+}