dsh-dock 0.13.0 → 0.15.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/host.js

@@ -20,6 +20,8 @@ export const feature = {
   setup(ctx) {
     const disposers = []
     const dispose = () => {
+      // 撤掉「本宿主注册了 runstate 路由」旗标（见下方注册处的说明）
+      try { if (typeof window !== 'undefined' && window.__dshDockRunstate) delete window.__dshDockRunstate } catch { /* ignore */ }
       while (disposers.length > 0) {
         const fn = disposers.pop()
         try { if (typeof fn === 'function') fn() } catch { /* 停用清理失败不阻断 */ }
@@ -33,6 +35,14 @@ export const feature = {
 
     // ===== RPC 路由 =====
     disposers.push(ctx.inject(['webServer'], (wsCtx) => {
+      // 路由注册成功后打旗标：【手机适配】的汉堡角标据此决定要不要轮询 status。
+      // 没有它的话，功能停用时角标会先打一次必然失败的请求 → 控制台一条 405/404，
+      // 与【用量记录】chip 当年同一个毛病（见 features/tokenlog/view.jsx 的 routeGone 闩锁）。
+      // 旗标与 __dshDockMobileDrawer / __dshDockWelcomeAck 同风格：宿主侧唯一事实，客户端只读。
+      wsCtx.effect(() => {
+        if (typeof window !== 'undefined') window.__dshDockRunstate = true
+        return () => { try { if (typeof window !== 'undefined' && window.__dshDockRunstate) delete window.__dshDockRunstate } catch { /* ignore */ } }
+      })
       wsCtx.effect(() => wsCtx.webServer.register({
         kind: 'prefix',
         path: '/dsh-dock/runstate',

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,27 @@
 //  - 挂载即扫描历史+按暂存条件查询；挂载期间每 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 桥接 ----------
+// 路由不可用（宿主没注册用量路由）的两种成因必须区分开，否则提示会误导人：
+//   - 404/405：宿主进程是旧版本，**或**本功能当前在宿主侧是停用的（多设备开关不一致、
+//     localStorage 与宿主 settings 不同步都会这样）。此时路由就是不存在，**重试无用**。
+//   - 其余状态码：网络/服务端错误，重试有意义。
+// 因此 404/405 会置 routeGone 闩锁：所有调用方据此**停止轮询**，既不再刷控制台报错，
+// 也不会每 10s 打一次无效请求（chip 原本会一直重试到页面关闭）。
+let routeGone = false;
+/** 路由是否已确认不可用（宿主未注册）。一旦为真，本次页面生命周期内不再重试。 */
+export function isTokenlogRouteGone() { return routeGone; }
+/** 把 404/405 的错误翻译成人能看懂、且不误导的提示。 */
+function routeGoneMessage() {
+	return "宿主未启用「用量记录」路由（或宿主进程是旧版本），请在功能坞里启用该功能或重启 dsh web";
+}
 function rpcCall(method, args) {
-	return fetch("/dsh-dock/tokenlog/" + method, {
+	if (routeGone) return Promise.reject(new Error(routeGoneMessage()));
+	return fetch("dsh-dock/tokenlog/" + method, {
 		method: "POST",
 		headers: { "content-type": "application/json" },
 		body: JSON.stringify(args === undefined ? {} : args),
@@ -22,9 +36,13 @@ function rpcCall(method, args) {
 		.then(async (res) => {
 			const data = await res.json().catch(() => ({}));
 			if (res.ok && data && data.ok === true) return data.data;
-			// 旧宿主进程没有用量路由（405/404）：给出可操作提示而非裸状态码
+			// 宿主没注册用量路由（405/404）：置闩锁并给出可操作提示而非裸状态码。
+			// 注意这既可能是「宿主旧版本」，也可能是「功能在宿主侧被停用」——
+			// 实测后者更常见（多设备开关/localStorage 与宿主 settings 不一致），
+			// 所以文案两种都提到，且置闩锁后不再无谓重试。
 			if (res.status === 405 || res.status === 404) {
-				throw new Error("宿主进程是旧版本（没有用量记录路由），重启 dsh web 后重试");
+				routeGone = true;
+				throw new Error(routeGoneMessage());
 			}
 			if (data && data.ok === false) throw new Error((data.error && data.error.message) || ("HTTP " + res.status));
 			throw new Error("HTTP " + res.status + (data && data.error && data.error.message ? ": " + data.error.message : ""));
@@ -1377,27 +1395,39 @@ export function TokenLogChip(props) {
 	useEffect(() => {
 		if (!sid) return;
 		let cancel = false;
-		const load = () => rpcCall("query", { sessionId: sid })
-			.then((d) => { if (!cancel) setSnap({ totals: d && d.totals, rate: (d && d.rateUsdCny) || 7.2, err: "" }); })
-			.catch((e) => { if (!cancel) setSnap((s) => ({ totals: s.totals, rate: s.rate, err: String((e && e.message) || e) })); });
+		let timer = null;
+		const load = () => {
+			// 路由不可用是**终态**（宿主没注册该路由）：直接早退，不再每 10s 打一次
+			// 无效请求、不再刷控制台报错。此前会一直重试到页面关闭（实测控制台连续 405）。
+			if (cancel || isTokenlogRouteGone()) return null;
+			return rpcCall("query", { sessionId: sid })
+				.then((d) => { if (!cancel) setSnap({ totals: d && d.totals, rate: (d && d.rateUsdCny) || 7.2, err: "" }); })
+				.catch((e) => { if (!cancel) setSnap((s) => ({ totals: s.totals, rate: s.rate, err: String((e && e.message) || e) })); });
+		};
 		load();
-		const timer = setInterval(load, 10000);
-		return () => { cancel = true; clearInterval(timer); };
+		timer = setInterval(load, 10000);
+		return () => { cancel = true; if (timer) clearInterval(timer); };
 	}, [sid]);
 	if (!sid) return null;
 	const t = snap.totals;
+	const gone = isTokenlogRouteGone();
 	// chip 文案用紧凑人民币金额（2 位小数），避免撑爆输入卡工具行；
 	// 完整金额在 title 悬浮提示里。
-	const label = snap.err && !t
-		? (snap.err.includes("重启") ? "用量·需重启宿主" : "用量·失败")
+	const label = gone
+		? "用量·未启用"
+		: snap.err && !t
+		? (snap.err.includes("重启") || snap.err.includes("启用") ? "用量·未启用" : "用量·失败")
 		: (t ? "⛁ " + fmtCompact(t.totalTokens) + (t.cost > 0 ? " · " + fmtCostCny(t.cost, snap.rate) : "") : "⛁ …");
-	const title = t
+	const title = gone
+		? routeGoneMessage() + "\n（可在功能坞里启用「用量记录」）"
+		: t
 		? "本会话 " + fmtNum(t.calls) + " 次调用 · " + fmtNum(t.totalTokens) + " Token · " + fmtCostCny(t.cost, snap.rate) + "（估算）\n点击在功能坞查看用量记录"
 		: (snap.err ? snap.err + "\n" : "") + "点击在功能坞查看用量记录";
+	// 路由不可用时不做成报错态（红色），它不是错误，是「这个功能当前没开」。
 	return (
-		<button type="button" className={"dockchip" + (snap.err && !t ? " err" : "")} title={title} aria-label="会话用量"
+		<button type="button" className={"dockchip" + (snap.err && !t && !gone ? " err" : "")} title={title} aria-label="会话用量"
 			onClick={() => openPanel("tokenlog", { sessionId: sid, navAt: Date.now() })}>
-			<span className="dockchip-dot" style={{ background: "var(--dk-warn)" }} />
+			<span className="dockchip-dot" style={{ background: gone ? "var(--dsw-alias-label-tertiary,#8b95ab)" : "var(--dk-warn)" }} />
 			<span>{label}</span>
 		</button>
 	);

package/index.js

@@ -15,8 +15,10 @@
 //   - animation   任务动画（v0.5.0）：会话任务追踪 + 动效配置持久化（参照 @wycto/dsh-task-pulse）
 //   - notify      任务通知：完成/异常/需确认通知 + 提示音/系统通知/钉钉飞书推送（从任务动画拆出）
 //   - runstate    运行状态：进行中任务与最近完成一览（从任务动画拆出；只读，无配置段）
-//   - mobile-relay 手机接力（未发布）：扫码反向代理接力 + 局域网电脑直连（0.0.0.0）
+//   - 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 字段热更时重绑。
@@ -170,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.13.0",
+  "version": "0.15.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 && node scripts/test-legacy-import.mjs && node scripts/test-mobile-relay-host.mjs && node scripts/test-mobile-relay.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

@@ -31,7 +31,7 @@ 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.13.0";
+const DOCK_VERSION = "0.15.0";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
 const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fNotify, fRunState, fGames, fMobileRelay, fMobile];

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)
+}