dsh-dock 0.9.5 → 0.9.7

package/src/host-core.js

@@ -1,95 +1,98 @@
-// dsh-dock · 宿主共享内核：各功能模块（features/*/host.js）共用的常量与工具。
-// 放在 src/ 而非 features/：不属于任何单个功能；提取功能模块独立成包时按需随包复制。
-import z from '@deepseek-ai/schemastery'
-
-/** dsh-dock 自有 settings 命名空间（插件级配置，如图片理解代理）。 */
-export const DOCK_NS = 'dsh-dock'
-
-/** 自有命名空间的 schema（图片理解代理 + 任务动画配置 + 远程访问账号）。 */
-export const DockConfig = z.object({
-  remoteAuth: z.object({
-    /** 远程访问登录账号（明文用户名；密码只存加盐哈希）。 */
-    username: z.string().default(''),
-    passwordHash: z.string().default(''),
-    salt: z.string().default(''),
-  }).default({}),
-  visionProxy: z.object({
-    enabled: z.boolean().default(false),
-    provider: z.string().default(''),
-    model: z.string().default(''),
-  }).default({}),
-  animation: z.object({
-    // 动画与通知两个独立开关（可只开其一）
-    animationEnabled: z.boolean().default(true),
-    effectMode: z.string().default('flow'),
-    // 桌面伙伴场景缩放（0.85~2.2；浮层右下角也可直接拖动缩放）
-    robotScale: z.number().default(1.35),
-    notifyEnabled: z.boolean().default(true),
-    notifyOnComplete: z.boolean().default(true),
-    notifyOnError: z.boolean().default(true),
-    // 工具等待用户确认/批准时提醒（dsh 会话流 approval/asked → decided）
-    notifyOnConfirm: z.boolean().default(true),
-    // 通知停留毫秒数（0 = 常驻直到手动关闭）
-    notifyStayMs: z.number().default(8000),
-    // 浏览器系统通知（页面后台时推送）
-    systemNotify: z.boolean().default(false),
-    // 任务结束提示音（WebAudio 合成，macOS/Windows 通用，无音频文件依赖）
-    soundNotify: z.boolean().default(true),
-    // 提示音音效（完成场景音名；异常音由音效包内配套）
-    soundEffect: z.string().default('chime'),
-    // 钉钉群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
-    dingtalkEnabled: z.boolean().default(false),
-    dingtalkWebhook: z.string().default(''),
-    // 飞书群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
-    feishuEnabled: z.boolean().default(false),
-    feishuWebhook: z.string().default(''),
-  }).default({}),
-})
-
-/** 任务动画 effectMode 合法值（客户端动画模式）。 */
-export const ANIMATION_MODES = [
-  'flow', 'breathe', 'ring', 'orbit', 'robot', 'matrix', 'stars', 'aurora', 'space',
-  'nebula', 'warp', 'radar', 'constellation', 'fireflies', 'ocean', 'prism', 'circuit', 'gravity', 'lantern',
-]
-
-/** 提示音 soundEffect 合法值（客户端音效库键名）。 */
-export const SOUND_EFFECTS = ['chime', 'ding', 'coin', 'bell', 'pulse', 'arp']
-
-/** 沿 settingsPath 走一层对象（user/base/value 都可用）。 */
-export function walkPath(node, path) {
-  for (const key of path || []) {
-    node = node && typeof node === 'object' ? node[key] : undefined
-  }
-  return node
-}
-
-/** 序列化 JSON 响应。 */
-export function sendJson(res, status, value) {
-  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
-  res.end(JSON.stringify(value))
-}
-
-/** 解析 POST 请求体 JSON（限长 2MB）。 */
-export function readBody(req) {
-  return new Promise((resolve, reject) => {
-    let size = 0
-    const chunks = []
-    req.on('data', (c) => {
-      size += c.length
-      if (size > 2 * 1024 * 1024) {
-        reject(new Error('请求体过大'))
-        req.destroy()
-        return
-      }
-      chunks.push(c)
-    })
-    req.on('end', () => {
-      try {
-        resolve(chunks.length === 0 ? {} : JSON.parse(Buffer.concat(chunks).toString('utf8')))
-      } catch (e) {
-        reject(new Error('请求体不是合法 JSON'))
-      }
-    })
-    req.on('error', reject)
-  })
-}
+// dsh-dock · 宿主共享内核：各功能模块（features/*/host.js）共用的常量与工具。
+// 放在 src/ 而非 features/：不属于任何单个功能；提取功能模块独立成包时按需随包复制。
+import z from '@deepseek-ai/schemastery'
+
+/** dsh-dock 自有 settings 命名空间（插件级配置，如图片理解代理）。 */
+export const DOCK_NS = 'dsh-dock'
+
+/** 自有命名空间的 schema（功能开关 + 图片理解代理 + 任务动画配置 + 远程访问账号）。 */
+export const DockConfig = z.object({
+  // 宿主侧功能开关（id -> boolean）：客户端面板 toggle 即时同步过来，
+  // 重启 dsh 后按此表决定宿主半部 setup 哪些功能（路由注册、事件订阅等）。
+  features: z.dict(z.boolean()).default({}),
+  remoteAuth: z.object({
+    /** 远程访问登录账号（明文用户名；密码只存加盐哈希）。 */
+    username: z.string().default(''),
+    passwordHash: z.string().default(''),
+    salt: z.string().default(''),
+  }).default({}),
+  visionProxy: z.object({
+    enabled: z.boolean().default(false),
+    provider: z.string().default(''),
+    model: z.string().default(''),
+  }).default({}),
+  animation: z.object({
+    // 动画与通知两个独立开关（可只开其一）
+    animationEnabled: z.boolean().default(true),
+    effectMode: z.string().default('flow'),
+    // 桌面伙伴场景缩放（0.85~2.2；浮层右下角也可直接拖动缩放）
+    robotScale: z.number().default(1.35),
+    notifyEnabled: z.boolean().default(true),
+    notifyOnComplete: z.boolean().default(true),
+    notifyOnError: z.boolean().default(true),
+    // 工具等待用户确认/批准时提醒（dsh 会话流 approval/asked → decided）
+    notifyOnConfirm: z.boolean().default(true),
+    // 通知停留毫秒数（0 = 常驻直到手动关闭）
+    notifyStayMs: z.number().default(8000),
+    // 浏览器系统通知（页面后台时推送）
+    systemNotify: z.boolean().default(false),
+    // 任务结束提示音（WebAudio 合成，macOS/Windows 通用，无音频文件依赖）
+    soundNotify: z.boolean().default(true),
+    // 提示音音效（完成场景音名；异常音由音效包内配套）
+    soundEffect: z.string().default('chime'),
+    // 钉钉群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
+    dingtalkEnabled: z.boolean().default(false),
+    dingtalkWebhook: z.string().default(''),
+    // 飞书群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
+    feishuEnabled: z.boolean().default(false),
+    feishuWebhook: z.string().default(''),
+  }).default({}),
+})
+
+/** 任务动画 effectMode 合法值（客户端动画模式）。 */
+export const ANIMATION_MODES = [
+  'flow', 'breathe', 'ring', 'orbit', 'robot', 'matrix', 'stars', 'aurora', 'space',
+  'nebula', 'warp', 'radar', 'constellation', 'fireflies', 'ocean', 'prism', 'circuit', 'gravity', 'lantern',
+]
+
+/** 提示音 soundEffect 合法值（客户端音效库键名）。 */
+export const SOUND_EFFECTS = ['chime', 'ding', 'coin', 'bell', 'pulse', 'arp']
+
+/** 沿 settingsPath 走一层对象（user/base/value 都可用）。 */
+export function walkPath(node, path) {
+  for (const key of path || []) {
+    node = node && typeof node === 'object' ? node[key] : undefined
+  }
+  return node
+}
+
+/** 序列化 JSON 响应。 */
+export function sendJson(res, status, value) {
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
+  res.end(JSON.stringify(value))
+}
+
+/** 解析 POST 请求体 JSON（限长 2MB）。 */
+export function readBody(req) {
+  return new Promise((resolve, reject) => {
+    let size = 0
+    const chunks = []
+    req.on('data', (c) => {
+      size += c.length
+      if (size > 2 * 1024 * 1024) {
+        reject(new Error('请求体过大'))
+        req.destroy()
+        return
+      }
+      chunks.push(c)
+    })
+    req.on('end', () => {
+      try {
+        resolve(chunks.length === 0 ? {} : JSON.parse(Buffer.concat(chunks).toString('utf8')))
+      } catch (e) {
+        reject(new Error('请求体不是合法 JSON'))
+      }
+    })
+    req.on('error', reject)
+  })
+}

package/src/shared.js

@@ -1,130 +1,167 @@
-// dsh-dock · 客户端共享工具（外壳与功能模块共用；提取功能模块独立成包时随包复制）
-import react from "react";
-
-/**
- * 功能视图错误边界：外部功能包注册进来的视图渲染抛错时降级为错误提示，
- * 不拖垮整个功能坞面板（内置视图不包——它们与外壳同包发布、同生命周期）。
- */
-export class FeatureBoundary extends react.Component {
-	constructor(props) {
-		super(props);
-		this.state = { error: null };
-	}
-	static getDerivedStateFromError(error) {
-		return { error: error };
-	}
-	render() {
-		if (this.state.error) {
-			const msg = this.state.error && this.state.error.message ? this.state.error.message : String(this.state.error);
-			return react.createElement("div", { className: "dockm-note dockm-err" },
-				"功能视图渲染出错：" + 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 });
-	}
-}
-/** 取功能开关（外部功能默认启用；未登记的 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 toggleFeature(id) {
-	const st = stateOf(id);
-	st.enabled = !st.enabled;
-	featurePersist.map[id] = st.enabled;
-	persistFeatureEnabled();
-	notifyState();
-}
-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";
+
+/**
+ * 功能视图错误边界：外部功能包注册进来的视图渲染抛错时降级为错误提示，
+ * 不拖垮整个功能坞面板（内置视图不包——它们与外壳同包发布、同生命周期）。
+ */
+export class FeatureBoundary extends react.Component {
+	constructor(props) {
+		super(props);
+		this.state = { error: null };
+	}
+	static getDerivedStateFromError(error) {
+		return { error: error };
+	}
+	render() {
+		if (this.state.error) {
+			const msg = this.state.error && this.state.error.message ? this.state.error.message : String(this.state.error);
+			return react.createElement("div", { className: "dockm-note dockm-err" },
+				"功能视图渲染出错：" + 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(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) {
+			if (featurePersist.map[f.id] !== undefined) continue;
+			const v = persisted[f.id];
+			if (typeof v === "boolean") {
+				const st = stateOf(f.id);
+				if (st.enabled !== v) { st.enabled = v; changed = true; }
+			}
+		}
+		if (changed) notifyState();
+	}).catch(() => { /* 宿主不可达时用本地默认 */ });
+}
+
+/** 把开关同步到宿主（settings 持久化 + 宿主半部即时 setup/dispose）。失败静默：
+ * 宿主侧开关只影响路由注册等 Host 能力，本地 UI 状态仍然即时生效。 */
+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 }),
+	}).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); };
+}