dsh-dock 0.12.0 → 0.14.0

package/features/notify/view.jsx

@@ -10,12 +10,12 @@
 // features/runstate/，本模块只管通知（页内卡片 / 提示音 / 系统通知 / 钉钉飞书群机器人推送）。
 // 模块启停 = 功能坞里的开关（独立菜单项），本页不再有第二个总开关。
 //
-// Host 通信：fetch('/dsh-dock/notify/<method>')（见 features/notify/host.js）。
+// Host 通信：fetch('dsh-dock/notify/<method>')（见 features/notify/host.js）。
 import { useState, useEffect, useRef, useCallback } from "react";
 
 // ---------- Host RPC 桥接 ----------
 function rpcCall(method, args) {
-	return fetch("/dsh-dock/notify/" + method, {
+	return fetch("dsh-dock/notify/" + method, {
 		method: "POST",
 		headers: { "content-type": "application/json" },
 		body: JSON.stringify(args === undefined ? {} : args),

package/features/runstate/view.jsx

@@ -8,12 +8,12 @@
 // 共用同一份实例），本模块不写任何配置——动效在 features/animation/、结束与确认提醒在
 // features/notify/。没有全局浮层，因此只在面板打开时轮询，关闭面板即零开销。
 //
-// Host 通信：fetch('/dsh-dock/runstate/status')（见 features/runstate/host.js）。
+// Host 通信：fetch('dsh-dock/runstate/status')（见 features/runstate/host.js）。
 import { useState, useEffect } from "react";
 
 // ---------- Host RPC 桥接 ----------
 function rpcCall(method, args) {
-	return fetch("/dsh-dock/runstate/" + method, {
+	return fetch("dsh-dock/runstate/" + method, {
 		method: "POST",
 		headers: { "content-type": "application/json" },
 		body: JSON.stringify(args === undefined ? {} : args),

package/features/tokenlog/view.jsx

@@ -8,13 +8,13 @@
 //  - 挂载即扫描历史+按暂存条件查询；挂载期间每 5s 静默自动刷新
 //  - 查询等待动画：点「查询」后按钮转圈扫光 + 数据区顶部「记账小队清点」banner（轮换俏皮文案，
 //    等久了换语气），旧数据压暗禁点；结果到位时闪一次「✓ 数据已更新」并让 KPI 卡回弹
-// Host 通信：fetch('/dsh-dock/tokenlog/<method>')（见 features/tokenlog/host.js）。
+// Host 通信：fetch('dsh-dock/tokenlog/<method>')（见 features/tokenlog/host.js）。
 import react, { useState, useEffect, useCallback, useMemo, useRef } from "react";
 import { openPanel } from "../../src/shared.js";
 
 // ---------- Host RPC 桥接 ----------
 function rpcCall(method, args) {
-	return fetch("/dsh-dock/tokenlog/" + method, {
+	return fetch("dsh-dock/tokenlog/" + method, {
 		method: "POST",
 		headers: { "content-type": "application/json" },
 		body: JSON.stringify(args === undefined ? {} : args),

package/index.js

@@ -15,8 +15,10 @@
 //   - animation   任务动画（v0.5.0）：会话任务追踪 + 动效配置持久化（参照 @wycto/dsh-task-pulse）
 //   - notify      任务通知：完成/异常/需确认通知 + 提示音/系统通知/钉钉飞书推送（从任务动画拆出）
 //   - runstate    运行状态：进行中任务与最近完成一览（从任务动画拆出；只读，无配置段）
-//   - mobile-relay 手机接力（未发布）：扫码反向代理接力 + 局域网电脑直连（0.0.0.0）
-import { DockConfig, sendJson, readBody, migrateNotifyConfig, migrateModelsFeatureId, migrateImportedFeatures, bindDockConfig, readDockRoot, mutateDockSection } from './src/host-core.js'
+//   - mobile      手机适配：窄屏排版/Tab 栏/抽屉/遮罩/键盘（宿主经 tapIndex 注入 index.html）
+//   - mobile-relay 远程访问：账号密码登录的远程入口（网关 + 账号 + 浏览模式目录选择器）
+import { DockConfig, sendJson, readBody, migrateNotifyConfig, migrateModelsFeatureId, migrateImportedFeatures, migrateImportedSections, bindDockConfig, readDockRoot, mutateDockSection } from './src/host-core.js'
+import { injectWelcomeAck } from './src/welcome-ack.js'
 import { feature as fModels } from './features/modelconfig/host.js'
 import { feature as fVisionProxy } from './features/visionproxy/host.js'
 import { feature as fBalance } from './features/balance/host.js'
@@ -25,6 +27,7 @@ import { feature as fAnimation } from './features/animation/host.js'
 import { feature as fNotify } from './features/notify/host.js'
 import { feature as fRunState } from './features/runstate/host.js'
 import { feature as fMobileRelay } from './features/mobile-relay/host.js'
+import { feature as fMobile } from './features/mobile/host.js'
 
 export const name = 'dsh-dock'
 
@@ -66,6 +69,7 @@ export function apply(ctx, config) {
     fNotify,
     fRunState,
     fMobileRelay,
+    fMobile,
   ]
 
   // 绑定 Config 镜像（替代已移除的 settings.get）；volatile 字段热更时重绑。
@@ -132,6 +136,10 @@ export function apply(ctx, config) {
   ctx.inject(['settings'], (sctx) => {
     // 0.1.7-alpha.1 起 settings.register 已移除——不再调用；导出 Config 即注册。
     Promise.resolve()
+      // settings.yaml.imported 整段恢复（账号 remoteAuth / notify / animation /
+      // visionProxy——Config 导出前导入失败停在 imported 文件里的那批）。必须最先跑：
+      // 后面的迁移与功能启用都要读到恢复后的配置（远程访问账号丢了网关就开不起来）。
+      .then(() => migrateImportedSections(sctx))
       // 通知配置从 animation 段搬到 notify 段（【任务通知】独立成模块）。
       // 必须在任何面板保存动作之前跑——animation 模块保存时整段写回，旧字段会被覆盖丢失。
       .then(() => migrateNotifyConfig(sctx))
@@ -166,6 +174,16 @@ export function apply(ctx, config) {
       })
   })
 
+  // 插件级兼容注入（不随功能开关启停）：远程（非回环）浏览器的「预览版说明」自动确认。
+  // 根因与归属见 src/welcome-ack.js 文件头——关掉远程访问、主实例直接绑 0.0.0.0 的
+  // 直连形态同样每次重弹，所以不能挂在【远程访问】名下；回环地址脚本自我短路。
+  {
+    const webServer = ctx.get('webServer')
+    if (webServer && typeof webServer.tapIndex === 'function') {
+      ctx.effect(() => webServer.tapIndex(injectWelcomeAck), 'dsh-dock: welcome-ack index tap')
+    }
+  }
+
   // 功能开关管理路由（无条件注册）：GET 查询各功能宿主侧状态；POST 同步开关——
   // 浏览器面板 toggle 经此写入 settings（跨浏览器/重启保持）并即时 setup/dispose 宿主半部。
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-dock",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计，支持各模型自定义单价、多段分时价与周末/节假日谷价）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景）、任务通知（完成/异常/需确认通知、提示音、系统通知、钉钉/飞书推送）、运行状态（进行中任务与最近完成一览）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
   "type": "module",
   "main": "index.js",
@@ -43,7 +43,7 @@
   "scripts": {
     "build:client": "node scripts/build-client.mjs",
     "test:client": "node scripts/test-client-views.mjs",
-    "test:host": "node scripts/test-task-host.mjs && node scripts/test-tokenlog-host.mjs",
+    "test:host": "node scripts/test-task-host.mjs && node scripts/test-tokenlog-host.mjs && node scripts/test-legacy-import.mjs && node scripts/test-mobile-host.mjs && node scripts/test-mobile-relay-host.mjs && node scripts/test-mobile-relay.mjs && node scripts/test-welcome-ack.mjs",
     "dev:client": "node scripts/watch-client.mjs",
     "dev:link": "node scripts/dev-link-deps.mjs"
   },
@@ -64,5 +64,11 @@
     "@deepseek-ai/dsh-llm": "*",
     "@deepseek-ai/dsh-settings": "*",
     "@deepseek-ai/schemastery": "*"
+  },
+  "allowScripts": {
+    "file:../esbuild@0.28.1/node_modules/esbuild": true,
+    "file:../../esbuild@0.28.1/node_modules/esbuild": true,
+    "file:../../esbuild@0.25.12/node_modules/esbuild": true,
+    "file:../../esbuild@0.21.5/node_modules/esbuild": true
   }
-}
+}

package/src/client.jsx

@@ -28,12 +28,13 @@ import { feature as fNotify } from "../features/notify/view.jsx";
 import { feature as fRunState } from "../features/runstate/view.jsx";
 import { feature as fGames } from "../features/games/view.jsx";
 import { feature as fMobileRelay } from "../features/mobile-relay/view.jsx";
+import { feature as fMobile } from "../features/mobile/view.js";
 
 const name = "dsh-dock";
-const DOCK_VERSION = "0.12.0";
+const DOCK_VERSION = "0.14.0";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
-const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fNotify, fRunState, fGames, fMobileRelay];
+const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fNotify, fRunState, fGames, fMobileRelay, fMobile];
 // 规划占位（路线图）：接入后移除并建 features/<id>/ 模块
 const PLANNED_FEATURES = [];
 const PLANNED_NOTES = {};

package/src/host-core.js

@@ -3,6 +3,7 @@
 import { readFileSync, existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
+import yaml from 'js-yaml'
 import z from '@deepseek-ai/schemastery'
 
 /** dsh-dock 自有 settings 命名空间 = profile 条目 id（cordis.patch.yml 的 id）。 */
@@ -26,6 +27,15 @@ export const DockConfig = z.object({
     passwordHash: z.string().default(''),
     salt: z.string().default(''),
   }).default({}).volatile(),
+  /** 远程访问网关的持久化状态：enabled=上次是否在跑；port=自选端口（0=主端口+1）。
+   *  dsh web 重启后按此自动拉起网关（账号存在才拉），免得每次重启都要进面板点一次。 */
+  remoteGateway: z.object({
+    enabled: z.boolean().default(false),
+    /** 网关端口（0 = 跟随默认的主端口+1）；面板「开启远程访问」时回写。 */
+    port: z.natural().default(0),
+  }).default({}).volatile(),
+  /** settings.yaml.imported 全量恢复（migrateImportedSections）是否已执行过的一次性标记。 */
+  importedRestored: z.boolean().default(false).volatile(),
   visionProxy: z.object({
     enabled: z.boolean().default(false),
     provider: z.string().default(''),
@@ -296,6 +306,125 @@ export async function migrateImportedFeatures(ctx) {
   }
 }
 
+/** 深比较（JSON 化配置快照之间的相等判断）。 */
+function sameValue(a, b) {
+  if (a === b) return true
+  if (Array.isArray(a) && Array.isArray(b)) {
+    return a.length === b.length && a.every((v, i) => sameValue(v, b[i]))
+  }
+  if (a && b && typeof a === 'object' && typeof b === 'object' && !Array.isArray(a) && !Array.isArray(b)) {
+    const ka = Object.keys(a)
+    const kb = Object.keys(b)
+    return ka.length === kb.length && ka.every((k) => Object.hasOwn(b, k) && sameValue(a[k], b[k]))
+  }
+  return false
+}
+
+/** schema 缺省值的普通对象快照（用来判断「现网这一段用户从没写过」）。
+ *  schemastery 没有 parse()：走 Standard Schema validate 取值，volatile 读写器交给 plainify 解开。 */
+function dockDefaults() {
+  try {
+    const standard = DockConfig['~standard'] || DockConfig[Symbol.for('standard.schema')]
+    if (!standard || typeof standard.validate !== 'function') return null
+    const result = standard.validate({})
+    if (!result || result.issues || !result.value) return null
+    return plainifyDockConfig(result.value)
+  } catch {
+    return null
+  }
+}
+
+/** 只保留 schema 认识的顶层键：imported 旧文件可能带已废弃字段（如 animation 段里的
+ *  旧通知字段），整段原样写会被 mutate 校验拒绝——丢字段会让整次恢复失败。
+ *  值原样透传（嵌套结构交 schema 处理），这里只做顶层白名单。 */
+function sanitizeSection(value, template) {
+  if (!template || typeof template !== 'object' || Array.isArray(template)) return value
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return value
+  const out = {}
+  for (const key of Object.keys(template)) {
+    if (Object.hasOwn(value, key)) out[key] = value[key]
+  }
+  return out
+}
+
+/**
+ * 一次性全量恢复：`~/.dsh/settings.yaml` 被 dsh 升级改名为 `settings.yaml.imported`
+ * 并尝试导入 profile 时，dsh-dock 当时还没导出 Config → 整段导入失败，账号
+ * （remoteAuth）、通知、动画、图片代理等配置全部停在 imported 文件里；后来只补迁了
+ * features（见 migrateImportedFeatures），于是「远程访问账号丢失、网关开不起来」。
+ *
+ * 这里把整段补回来，规则保守：
+ * - `features`：逐键补缺（现网已有的键绝不覆盖）；
+ * - 其余 schema 认识的段：仅当现网该段仍等于 schema 缺省值（= 用户从未在此写过）
+ *   才整段恢复，现网有任何改动一律以现网为准（不覆盖新配置）；
+ * - 执行过写入或确认无 imported 文档后置 `importedRestored` 标记，仅跑一次。
+ */
+export async function migrateImportedSections(ctx) {
+  try {
+    const root = readDockRoot(ctx)
+    if (root && root.importedRestored === true) return
+    const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+    const file = join(home, 'settings.yaml.imported')
+    if (!existsSync(file)) return
+    let data = null
+    try {
+      data = yaml.load(readFileSync(file, 'utf8'))
+    } catch (error) {
+      console.warn('[dsh-dock] settings.yaml.imported 不是合法 YAML，跳过恢复:', (error && error.message) || String(error))
+      return
+    }
+    const section = data && typeof data === 'object' && !Array.isArray(data) ? data[DOCK_NS] : null
+    if (!section || typeof section !== 'object' || Array.isArray(section)) {
+      await mutateDockSection(ctx, ['importedRestored'], true)
+      return
+    }
+    const defaults = dockDefaults()
+    const live = root && typeof root === 'object' ? root : {}
+    const writes = []
+    const importedFeatures = section.features && typeof section.features === 'object' ? section.features : null
+    if (importedFeatures) {
+      const merged = live.features && typeof live.features === 'object' ? { ...live.features } : {}
+      let added = 0
+      for (const [key, value] of Object.entries(importedFeatures)) {
+        if (typeof value === 'boolean' && typeof merged[key] !== 'boolean') {
+          merged[key] = value
+          added++
+        }
+      }
+      if (added > 0) writes.push(['features', merged])
+    }
+    if (defaults) {
+      for (const key of Object.keys(section)) {
+        if (key === 'features') continue
+        if (!Object.hasOwn(defaults, key)) continue
+        // 现网缺该段（= 从没写过）或仍等于 schema 缺省 → 恢复；现网有用户改动一律不覆盖。
+        if (live[key] !== undefined && !sameValue(live[key], defaults[key])) continue
+        writes.push([key, sanitizeSection(section[key], defaults[key])])
+      }
+    }
+    // 逐段独立落盘：一个段被拒（schema 不认/写盘瞬时失败）不拖死其余段——
+    // 尤其 remoteAuth 必须尽量恢复，否则远程访问账号一直起不来。
+    const restored = []
+    const failed = []
+    for (const [path, value] of writes) {
+      try {
+        await mutateDockSection(ctx, [path], value)
+        restored.push(path)
+      } catch (error) {
+        failed.push(path)
+        console.warn(`[dsh-dock] 恢复 ${path} 段失败:`, (error && error.message) || String(error))
+      }
+    }
+    // 全部落盘（或本来就无事可做）才置一次性标记；有失败则下次启动重试。
+    if (failed.length === 0) await mutateDockSection(ctx, ['importedRestored'], true)
+    if (restored.length > 0) {
+      console.log('[dsh-dock] restored from settings.yaml.imported:', restored.join(', '))
+    }
+  } catch (e) {
+    console.warn('[dsh-dock] imported section restore skipped:', (e && e.message) || String(e))
+  }
+}
+
 /** 任务动画 effectMode 合法值（客户端动画模式）。 */
 export const ANIMATION_MODES = [
   'flow', 'breathe', 'ring', 'orbit', 'robot', 'matrix', 'stars', 'aurora', 'space',

package/src/shared.js

@@ -68,11 +68,14 @@ export function initFeatureState(defs) {
 	syncFeatureStateFromHost(defs);
 }
 
-/** 从宿主 /dsh-dock/features 拉取持久化开关，覆盖尚未本地表态的功能默认值。
+/** 从宿主 dsh-dock/features 拉取持久化开关，覆盖尚未本地表态的功能默认值。
+ * 路由一律用文档相对路径（不带前导斜杠）：DSH 的 index.html 带 <base href="./">，
+ * 子路径反代（如 /ui/）下自动解析为 /ui/dsh-dock/...，根挂载下即 dsh-dock/...。
+ * 写死前导斜杠会绕过反代挂载前缀，请求被 302 打回应用入口，宿主接口整片失败。
  * 拉取失败（宿主旧版本无此路由）静默降级——沿用本地默认。 */
 function syncFeatureStateFromHost(defs) {
 	if (typeof fetch !== "function") return;
-	fetch("/dsh-dock/features").then(async (res) => {
+	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;
@@ -108,7 +111,7 @@ function syncFeatureStateFromHost(defs) {
  * 开关永远 404 而这里毫无声息，排查了两个版本才发现。） */
 function pushFeatureEnabledToHost(id, enabled) {
 	if (typeof fetch !== "function") return;
-	fetch("/dsh-dock/features", {
+	fetch("dsh-dock/features", {
 		method: "POST",
 		headers: { "content-type": "application/json" },
 		body: JSON.stringify({ id, enabled }),

package/src/welcome-ack.js

@@ -0,0 +1,69 @@
+// dsh-dock · 插件级兼容注入：远程（非回环）浏览器的「预览版说明」自动确认
+//
+// 根因（dsh 0.2.0 ui-settings-models/src/client/welcome-store.ts，文件头注释原文）：
+// 回环浏览器的确认走宿主持久化，一次确认永久生效；**远程（非回环）浏览器的设置 scope
+// 是 memory 模式，确认只存页面进程内存，刷新即丢**——所以从局域网/组网 IP 打开时
+// 「预览版说明」每次刷新都重弹，profile patch 里钉 welcomeNoticeVersion 也救不了
+// （memory 分支根本不读持久值）。
+//
+// 归属：这是「非回环浏览器」这一访问形态的兼容问题，与任何一个功能模块的职责都不重合——
+// 【远程访问】只保留远程入口本身（用户要求），而关掉远程访问、主实例经 patch 层绑 0.0.0.0
+// 的直连形态（公司部署）同样会每次重弹。所以挂在插件级（index.js 注册 tapIndex），
+// 不随任何功能开关启停；回环地址自我短路，让 dsh 原生的一次性持久确认自然工作。
+//
+// 与【远程访问】网关的关系：网关代理的页面由网关对连接 bundle 做回环自判改写，
+// 确认可持久化、弹窗首次确认后不再出现，本脚本找不到弹窗即零副作用；直连形态下
+// 本脚本每次页面加载最多替用户点一次「继续」。dsh 未来若让远程确认可持久化，
+// 弹窗不再出现，本脚本自动空转，无需随版本跟进。
+//
+// 注入点在 <head> 之后，body 尚未解析：观察器一律推迟到 DOMContentLoaded 再挂。
+const WELCOME_ACK_JS = [
+  ';(function(){',
+  'if (window.__dshDockWelcomeAck) return;',
+  'window.__dshDockWelcomeAck = "host";',
+  'var host = (window.location && window.location.hostname) || "";',
+  'if (host === "127.0.0.1" || host === "localhost" || host === "::1" || host.slice(-10) === ".localhost") return;',
+  'if (typeof MutationObserver === "undefined") return;',
+  'var done = false;',
+  'var observer = null;',
+  'function tryDismiss() {',
+  '  if (done || !document.body) return;',
+  '  var dialogs = document.querySelectorAll(\'[role="dialog"]\');',
+  '  for (var i = 0; i < dialogs.length; i++) {',
+  '    if (!/预览版说明|Preview Notice/.test(dialogs[i].textContent || "")) continue;',
+  '    var buttons = dialogs[i].querySelectorAll("button");',
+  '    for (var j = 0; j < buttons.length; j++) {',
+  '      var label = (buttons[j].textContent || "").replace(/^\\s+|\\s+$/g, "");',
+  '      if (label === "继续" || label === "Continue") {',
+  '        done = true;',
+  '        buttons[j].click();',
+  '        if (observer) observer.disconnect();',
+  '        return;',
+  '      }',
+  '    }',
+  '    break;',
+  '  }',
+  '}',
+  'function start() {',
+  '  observer = new MutationObserver(tryDismiss);',
+  '  observer.observe(document.body, { childList: true, subtree: true });',
+  '  tryDismiss();',
+  // 兜底停止：说明若 60 秒内没出现（未来版本改版/被官方移除），观察器自动退场
+  '  setTimeout(function () { if (observer) observer.disconnect(); }, 60000);',
+  '}',
+  'if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", start);',
+  'else start();',
+  '})();',
+].join('\n')
+const WELCOME_ACK_MARKER = 'data-dsh-dock-welcome-ack'
+export { WELCOME_ACK_MARKER }
+
+/** 把「预览版说明」自动确认脚本内联注入 index.html 的 <head> 之后（幂等）。 */
+export function injectWelcomeAck(html) {
+  if (html.includes(WELCOME_ACK_MARKER)) return html
+  const match = /<head(?:\s[^>]*)?>/i.exec(html)
+  const script = `<script ${WELCOME_ACK_MARKER}>${WELCOME_ACK_JS}</script>`
+  if (!match) return script + html
+  const at = match.index + match[0].length
+  return html.slice(0, at) + script + html.slice(at)
+}