dsh-dock 0.11.3 → 0.11.6

package/src/client.jsx

@@ -30,7 +30,7 @@ import { feature as fGames } from "../features/games/view.jsx";
 import { feature as fMobileRelay } from "../features/mobile-relay/view.jsx";
 
 const name = "dsh-dock";
-const DOCK_VERSION = "0.11.3";
+const DOCK_VERSION = "0.11.6";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
 const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fNotify, fRunState, fGames, fMobileRelay];
@@ -238,6 +238,11 @@ function fullDockCss() {
 // 样式全局注入一次（入口按钮与右下角浮层挂在设置页之外，不能依赖页内 <style>）。
 // 这里用 SHELL_CSS 唯一命名，并做防御：注入永不抛错、失败只降级不打断启动；
 // 外部功能注册携带样式时可重算更新（外部样式后到）。
+//
+// ⚠️ 必须同时打 data-plugin="dsh-dock"（官方 claimStyles/removeOwnedStyles 归属协议）：
+// 只有 data-plugin-css 的无主 <style> 会被任意后 materialize 的插件 claim 走，
+// 对方卸载时 removeOwnedStyles 会连带删掉功能坞样式——表现为「开关别的插件后样式坏了、
+// 要手动刷新才正常」。见 packages/client/modules claimStyles。
 function ensureCss() {
 	if (typeof document === "undefined") return;
 	cancelInitialCssSchedule();
@@ -247,19 +252,21 @@ function ensureCss() {
 				dockCssTag = document.querySelector('style[data-plugin-css="dsh-dock"]');
 			} else {
 				dockCssTag = document.createElement("style");
-				dockCssTag.dataset.pluginCss = "dsh-dock";
 				document.head.appendChild(dockCssTag);
 			}
 		}
+		// 归属与标识：缺 data-plugin 的旧标签/被 claim 走的标签一律改回本插件
+		dockCssTag.dataset.plugin = "dsh-dock";
+		dockCssTag.dataset.pluginCss = "dsh-dock";
 		dockCssTag.textContent = fullDockCss();
 	} catch (e) {
 		console.error("[dsh-dock] ensureCss failed:", e && e.message ? e.message : String(e));
 	}
 }
-// 刷新页时宿主内容优先绘制：功能坞样式很大，首帧同步解析会让整页短暂停顿。
-// 首次注入延后到浏览器空闲期；之后的外部模块注册仍走 ensureCss() 立即更新。
+// 首次注入延后到浏览器空闲期：功能坞样式很大，首帧同步解析会让整页短暂停顿。
+// 之后的外部模块注册仍走 ensureCss() 立即更新；apply() 另有同步一击（见下）。
 function scheduleInitialCss() {
-	if (typeof document === "undefined" || initialCssSchedule || (dockCssTag && dockCssTag.isConnected)) return;
+	if (typeof document === "undefined" || initialCssSchedule || (dockCssTag && dockCssTag.isConnected && dockCssTag.dataset.plugin === "dsh-dock")) return;
 	const run = () => {
 		initialCssSchedule = null;
 		ensureCss();
@@ -649,7 +656,10 @@ const ctxRef = { current: null };
 
 export function apply(ctx) {
 	ctxRef.current = ctx;
-	scheduleInitialCss();
+	// 同步注入归属完整的样式：插件开关/HMR 重进 apply 时若只靠 idle，
+	// 窗口期内其它插件 materialize 会 claim 走无主标签（或标签已被对方删掉）。
+	// 首屏成本可接受（textContent 写入），换「开合插件样式不坏」。
+	ensureCss();
 	initFeatureState(BUILTIN_FEATURES.concat(PLANNED_FEATURES));
 	const slots = ctx.get("slots");
 	if (slots === undefined) return;

package/src/host-core.js

@@ -1,27 +1,36 @@
 // dsh-dock · 宿主共享内核：各功能模块（features/*/host.js）共用的常量与工具。
 // 放在 src/ 而非 features/：不属于任何单个功能；提取功能模块独立成包时按需随包复制。
+import { readFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
 import z from '@deepseek-ai/schemastery'
 
-/** dsh-dock 自有 settings 命名空间（插件级配置，如图片理解代理）。 */
+/** dsh-dock 自有 settings 命名空间 = profile 条目 id（cordis.patch.yml 的 id）。 */
 export const DOCK_NS = 'dsh-dock'
 
 /** 自有命名空间的 schema（功能开关 + 图片理解代理 + 任务动画/任务通知配置 + 远程访问账号）。
- *  运行状态模块只读共享追踪、不写配置，因此没有自己的段。 */
+ *  运行状态模块只读共享追踪、不写配置，因此没有自己的段。
+ *
+ *  dsh ≥ 0.1.7-alpha.1：settings 服务改为 SettingsForms——
+ *  ① 插件必须导出同名 Config（否则 mutate 报 No configurable plugin entry）；
+ *  ② ns 是 profile 条目 id（此处 DOCK_NS=cordis.patch.yml 的 id）；
+ *  ③ 活编辑路径必须落在 .volatile() 字段上，否则 write 抛 not volatile。
+ *  每个顶层段整体 volatile：段内任意 path 可被面板 mutate，无需逐字段标记。 */
 export const DockConfig = z.object({
   // 宿主侧功能开关（id -> boolean）：客户端面板 toggle 即时同步过来，
   // 重启 dsh 后按此表决定宿主半部 setup 哪些功能（路由注册、事件订阅等）。
-  features: z.dict(z.boolean()).default({}),
+  features: z.dict(z.boolean()).default({}).volatile(),
   remoteAuth: z.object({
     /** 远程访问登录账号（明文用户名；密码只存加盐哈希）。 */
     username: z.string().default(''),
     passwordHash: z.string().default(''),
     salt: z.string().default(''),
-  }).default({}),
+  }).default({}).volatile(),
   visionProxy: z.object({
     enabled: z.boolean().default(false),
     provider: z.string().default(''),
     model: z.string().default(''),
-  }).default({}),
+  }).default({}).volatile(),
   // 【用量记录】模块的单价配置：官网抓取的刊例价常与实际计费不符（第三方/中转、
   // 折扣、自建端点等），这里保存用户自填单价并优先用于费用估算。
   // 详见 features/tokenlog/host.js 的 resolvePricing（优先级：自定义 > 官网 > 内置 > 兜底）。
@@ -59,7 +68,7 @@ export const DockConfig = z.object({
       cacheRead: z.number().default(0.43),
       cacheWrite: z.number().default(4.32),
     }).default({}),
-  }).default({}),
+  }).default({}).volatile(),
   // 【任务动画】模块：只放动画本身（动效开关/模式/桌面伙伴大小）。
   // 通知相关的字段已全部迁往下面的 notify 段（见 migrateNotifyConfig）；
   // 旧值不在 schema 里也会被 schemastery 原样保留，迁移读得到。
@@ -68,7 +77,7 @@ export const DockConfig = z.object({
     effectMode: z.string().default('flow'),
     // 桌面伙伴场景缩放（0.85~2.2；浮层右下角也可直接拖动缩放）
     robotScale: z.number().default(1.35),
-  }).default({}),
+  }).default({}).volatile(),
   // 【任务通知】模块：页内卡片 / 提示音 / 浏览器系统通知 / 群机器人推送。
   // 模块自身的启停由 features.notify 开关负责（独立菜单项），这里只放通知行为配置。
   notify: z.object({
@@ -92,9 +101,99 @@ export const DockConfig = z.object({
     feishuWebhook: z.string().default(''),
     // 一次性迁移标记：animation 段的旧通知配置已搬到本段（搬完置 true，避免每次启动重复写）
     migratedFromAnimation: z.boolean().default(false),
-  }).default({}),
+  }).default({}).volatile(),
 })
 
+// ── 本地配置镜像（替代已移除的 settings.get） ─────────────────────────────
+// apply(ctx, config) 绑定带 volatile 引用的 Config；每次操作前 plainify 一次取快照。
+// settings.mutate 成功后由调用方/ volatile-update 刷新。测试桩可用 seedDockConfig 注入。
+
+/** @type {null | Record<string, unknown>} */
+let dockConfigBound = null
+
+/** 是否为 cosmokit Volatile 引用（跨副本用 Symbol 协议识别，不依赖包导入）。 */
+function isVolatileRef(value) {
+  return typeof value === 'object' && value !== null && Symbol.for('cosmokit.volatile.write') in value
+}
+
+/** 递归解开 volatile 引用 → 可 JSON 化的普通对象。 */
+export function plainifyDockConfig(value) {
+  if (isVolatileRef(value)) return plainifyDockConfig(value.get())
+  if (Array.isArray(value)) return value.map(plainifyDockConfig)
+  if (value !== null && typeof value === 'object') {
+    const out = {}
+    for (const [k, v] of Object.entries(value)) out[k] = plainifyDockConfig(v)
+    return out
+  }
+  return value
+}
+
+/** 由 index.js apply 挂载/刷新：持有 Config 引用并在 loader/volatile-update 后重读。 */
+export function bindDockConfig(config) {
+  dockConfigBound = config === undefined || config === null ? null : plainifyDockConfig(config)
+  return dockConfigBound
+}
+
+/** 测试/本地桩：直接写入镜像（绕过宿主 settings）。 */
+export function seedDockConfig(value) {
+  dockConfigBound = value === undefined || value === null ? null : plainifyDockConfig(value)
+}
+
+/**
+ * 读自有命名空间根对象。优先级：
+ * 1) apply 绑定的 Config 镜像（新宿主活值）
+ * 2) 测试/旧宿主的 settings.get（若仍存在）
+ * 3) settings.describe 里 ns=DOCK_NS 的 value（SettingsForms 读路径）
+ * 4) null（调用方回退默认）
+ */
+export function readDockRoot(ctx) {
+  if (dockConfigBound) return dockConfigBound
+  try {
+    const settings = ctx && typeof ctx.get === 'function' ? ctx.get('settings') : null
+    if (settings) {
+      if (typeof settings.get === 'function') {
+        const v = settings.get(DOCK_NS)
+        if (v && typeof v === 'object') return v
+      }
+      if (typeof settings.describe === 'function') {
+        const views = settings.describe({ redactSecrets: false }) || []
+        const hit = views.find((d) => d && d.ns === DOCK_NS && d.value && typeof d.value === 'object')
+        if (hit) return hit.value
+      }
+    }
+  } catch { /* settings 未挂载 */ }
+  return null
+}
+
+/**
+ * 写自有命名空间一段（走 SettingsForms.mutate；成功后同步本地镜像）。
+ * @param {object} ctx Cordis context
+ * @param {string[]} path 段路径（如 ['animation']）
+ * @param {unknown} value 整段值
+ * @param {number} [expectedRevision] describe 的 revision（乐观锁，可选）
+ */
+export async function mutateDockSection(ctx, path, value, expectedRevision) {
+  const settings = ctx && typeof ctx.get === 'function' ? ctx.get('settings') : null
+  if (!settings || typeof settings.mutate !== 'function') {
+    throw new Error('settings 服务不可用，配置无法持久化')
+  }
+  await settings.mutate(DOCK_NS, [{ op: 'set', path, value }], expectedRevision)
+  if (dockConfigBound) {
+    const next = { ...dockConfigBound }
+    let node = next
+    for (let i = 0; i < path.length - 1; i++) {
+      const key = path[i]
+      const child = node[key] && typeof node[key] === 'object' && !Array.isArray(node[key]) ? { ...node[key] } : {}
+      node[key] = child
+      node = child
+    }
+    if (path.length > 0) next[path[path.length - 1]] = value
+    else Object.assign(next, value)
+    dockConfigBound = next
+  }
+  return value
+}
+
 /** 通知配置字段清单（schema、迁移、客户端默认值三处共用同一份键名）。 */
 export const NOTIFY_FIELDS = [
   'notifyOnComplete', 'notifyOnError', 'notifyOnConfirm', 'notifyStayMs',
@@ -112,9 +211,7 @@ export const NOTIFY_FIELDS = [
  */
 export async function migrateNotifyConfig(ctx) {
   try {
-    const settings = ctx.get('settings')
-    if (!settings || typeof settings.get !== 'function' || typeof settings.mutate !== 'function') return
-    const root = settings.get(DOCK_NS)
+    const root = readDockRoot(ctx)
     const notify = root && typeof root === 'object' && root.notify && typeof root.notify === 'object' ? root.notify : null
     if (notify && notify.migratedFromAnimation === true) return
     const animation = root && typeof root === 'object' && root.animation && typeof root.animation === 'object' ? root.animation : null
@@ -127,7 +224,7 @@ export async function migrateNotifyConfig(ctx) {
     // 避免 settings 命名空间尚未生效时误把「空迁移」当完成（那会丢掉旧配置）。
     if (copied === 0) return
     const next = Object.assign({}, notify || {}, legacy, { migratedFromAnimation: true })
-    await settings.mutate(DOCK_NS, [{ op: 'set', path: ['notify'], value: next }])
+    await mutateDockSection(ctx, ['notify'], next)
     console.log('[dsh-dock] notify config migrated from animation section; fields copied:', copied)
   } catch (e) {
     console.warn('[dsh-dock] notify config migration skipped:', (e && e.message) || String(e))
@@ -144,20 +241,55 @@ export async function migrateNotifyConfig(ctx) {
  */
 export async function migrateModelsFeatureId(ctx) {
   try {
-    const settings = ctx.get('settings')
-    if (!settings || typeof settings.get !== 'function' || typeof settings.mutate !== 'function') return
-    const root = settings.get(DOCK_NS)
+    const root = readDockRoot(ctx)
     const features = root && typeof root === 'object' && root.features && typeof root.features === 'object' ? root.features : null
     if (!features || typeof features.models !== 'boolean' || typeof features.modelconfig === 'boolean') return
     const next = Object.assign({}, features, { modelconfig: features.models })
     delete next.models
-    await settings.mutate(DOCK_NS, [{ op: 'set', path: ['features'], value: next }])
+    await mutateDockSection(ctx, ['features'], next)
     console.log('[dsh-dock] feature id migrated: features.models -> features.modelconfig =', features.models)
   } catch (e) {
     console.warn('[dsh-dock] models feature id migration skipped:', (e && e.message) || String(e))
   }
 }
 
+/**
+ * 一次性迁移：旧 settings.yaml 已被宿主改名为 settings.yaml.imported；
+ * 当时 dsh-dock 尚未导出 Config，importLegacyDocument 对本段 update 会失败，
+ * 功能开关表停在 imported 文件里。配置可写后把 features 补写进 profile。
+ */
+export async function migrateImportedFeatures(ctx) {
+  try {
+    const root = readDockRoot(ctx)
+    const features = root && typeof root === 'object' && root.features && typeof root.features === 'object' ? root.features : null
+    if (features && Object.keys(features).length > 0) return
+    const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+    const file = join(home, 'settings.yaml.imported')
+    if (!existsSync(file)) return
+    const text = readFileSync(file, 'utf8')
+    // 极简 YAML：仅取 dsh-dock.features 下的 `key: true|false` 行（避免引入完整解析器）
+    const lines = text.split(/\r?\n/)
+    let inDock = false
+    let inFeatures = false
+    const imported = {}
+    for (const line of lines) {
+      if (/^dsh-dock:\s*$/.test(line)) { inDock = true; inFeatures = false; continue }
+      if (inDock && /^\S/.test(line) && !/^dsh-dock:/.test(line)) { inDock = false; inFeatures = false }
+      if (inDock && /^\s{2}features:\s*$/.test(line)) { inFeatures = true; continue }
+      if (inDock && inFeatures && /^\s{2}\S/.test(line)) { inFeatures = false }
+      if (inDock && inFeatures) {
+        const m = /^\s{4}([A-Za-z0-9_-]+):\s*(true|false)\s*$/.exec(line)
+        if (m) imported[m[1]] = m[2] === 'true'
+      }
+    }
+    if (Object.keys(imported).length === 0) return
+    await mutateDockSection(ctx, ['features'], imported)
+    console.log('[dsh-dock] features imported from settings.yaml.imported:', imported)
+  } catch (e) {
+    console.warn('[dsh-dock] imported features migration skipped:', (e && e.message) || String(e))
+  }
+}
+
 /** 任务动画 effectMode 合法值（客户端动画模式）。 */
 export const ANIMATION_MODES = [
   'flow', 'breathe', 'ring', 'orbit', 'robot', 'matrix', 'stars', 'aurora', 'space',