dsh-dock 0.14.0 → 0.16.0

package/features/tokenlog/host.js

@@ -28,7 +28,7 @@
 // 分时段价支持多段（start>end 跨零点、start=end 全天、小数小时表示半点）；旧单段 peak 自动归一。
 // 每段可带 days=all|workday|nonworkday：workday=非周末且非 holidays；nonworkday=周末或节假日。
 // 费用在查询/导出时按当前单价即时重算，因此改价无需重扫历史。
-import { sendJson, readBody, readDockRoot, mutateDockSection } from '../../src/host-core.js'
+import { sendJson, readBody, rejectUntrustedRequest, readDockRoot, mutateDockSection } from '../../src/host-core.js'
 
 export const feature = {
   id: 'tokenlog',
@@ -866,6 +866,7 @@ export const feature = {
         kind: 'prefix',
         path: '/dsh-dock/tokenlog',
         async handler(req, res) {
+          if (rejectUntrustedRequest(ctx, req, res)) return
           try {
             const url = new URL(req.url || '/', 'http://dsh.internal')
             const method = url.pathname.replace(/^\/dsh-dock\/tokenlog\/?/, '').split('/')[0] || ''

package/features/tokenlog/view.jsx

@@ -13,7 +13,21 @@ 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) {
+	if (routeGone) return Promise.reject(new Error(routeGoneMessage()));
 	return fetch("dsh-dock/tokenlog/" + method, {
 		method: "POST",
 		headers: { "content-type": "application/json" },
@@ -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/features/tts/host.js

@@ -0,0 +1,164 @@
+// dsh-dock · 功能模块【语音朗读】· 宿主半部
+//
+// 职责：只做**配置持久化**。朗读本身发生在浏览器——Web Speech API 的
+// speechSynthesis 是宿主页面（浏览器）的能力，声音从用户那台设备的扬声器出来；
+// Node 侧既没有 speechSynthesis，也不该把会话正文搬到服务端绕一圈。
+//
+// RPC（webServer HTTP 路由，前缀 /dsh-dock/tts/）：
+//   POST /status —— 当前朗读配置 + 会话级任务追踪快照（客户端据此触发自动朗读）
+//   POST /config —— 增量更新配置字段并持久化到 settings（dsh-dock 命名空间 tts 段）
+//
+// 配置模型（schema 见 src/host-core.js DockConfig.tts）：
+//   autoPlay / autoPlayOnFinish / interruptOnNew / rate / pitch / volume /
+//   voiceURI / lang / skipCode / skipTables / maxChars / maxSentences
+//
+// ⚠️ voiceURI 是**设备相关**的：同一份配置在另一台机器上可能没有那个音色。
+//    客户端使用前会用本机 getVoices() 校验，取不到就按语言回落（见 features/tts/view.jsx），
+//    所以这里只负责原样存取，不做存在性校验（宿主也拿不到浏览器的音色表）。
+import { sendJson, readBody, rejectUntrustedRequest, readDockRoot, mutateDockSection } from '../../src/host-core.js'
+import { acquireTaskTracker } from '../../src/task-track.js'
+
+/** 朗读配置字段清单（schema、默认值、增量合并三处共用同一份键名）。 */
+export const TTS_FIELDS = [
+  'autoPlay', 'autoPlayOnFinish', 'interruptOnNew',
+  'rate', 'pitch', 'volume', 'voiceURI', 'lang',
+  'skipCode', 'skipTables', 'maxChars', 'maxSentences',
+]
+
+/** 数值字段的合法区间（越界钳制，不拒绝：面板滑块与手工 POST 都可能给到边界值）。 */
+const NUMERIC_RANGE = {
+  rate: [0.1, 10], // 规范区间是 0.1~10，面板只开放 0.5~2
+  pitch: [0, 2],
+  volume: [0, 1],
+  maxChars: [0, 200000],
+  maxSentences: [0, 200],
+}
+
+const BOOLEAN_FIELDS = [
+  'autoPlay', 'autoPlayOnFinish', 'interruptOnNew', 'skipCode', 'skipTables',
+]
+
+const STRING_FIELDS = ['voiceURI', 'lang']
+
+function defaultConfig() {
+  return {
+    autoPlay: false,
+    autoPlayOnFinish: true,
+    interruptOnNew: true,
+    rate: 1,
+    pitch: 1,
+    volume: 1,
+    voiceURI: '',
+    lang: '',
+    skipCode: true,
+    skipTables: true,
+    maxChars: 0,
+    maxSentences: 0,
+  }
+}
+
+/** 读本地 Config 镜像里的 tts 配置（schema 默认值已含在 resolved 里），异常回退默认。 */
+export function readTtsConfig(ctx) {
+  const cfg = defaultConfig()
+  try {
+    const v = readDockRoot(ctx)
+    const t = v && typeof v === 'object' && v.tts && typeof v.tts === 'object' ? v.tts : null
+    if (t) {
+      for (const key of Object.keys(cfg)) {
+        if (t[key] !== undefined) cfg[key] = t[key]
+      }
+    }
+  } catch { /* settings 未挂载，用默认 */ }
+  return cfg
+}
+
+/**
+ * 增量合并请求体到配置：只接受白名单字段，类型不符忽略，数值越界钳制。
+ * 非法 JSON 由 readBody 抛错（400），未知字段静默忽略（面板与宿主版本可能不同步）。
+ */
+export function mergeTtsConfig(cfg, patch) {
+  const p = patch && typeof patch === 'object' ? patch : {}
+  for (const key of BOOLEAN_FIELDS) {
+    if (typeof p[key] === 'boolean') cfg[key] = p[key]
+  }
+  for (const key of Object.keys(NUMERIC_RANGE)) {
+    if (typeof p[key] === 'number' && Number.isFinite(p[key])) {
+      const [lo, hi] = NUMERIC_RANGE[key]
+      cfg[key] = Math.min(hi, Math.max(lo, key === 'maxSentences' || key === 'maxChars' ? Math.round(p[key]) : p[key]))
+    }
+  }
+  for (const key of STRING_FIELDS) {
+    if (typeof p[key] === 'string') {
+      // voiceURI/lang 是浏览器给的标识串，限长即可；不解析、不访问网络
+      cfg[key] = p[key].trim().slice(0, 200)
+    }
+  }
+  return cfg
+}
+
+export const feature = {
+  id: 'tts',
+  name: '语音朗读',
+  description: '把会话回复读出来（浏览器语音合成 TTS）：回合结束在会话下方点喇叭播放，也可设置自动朗读',
+  defaultEnabled: false,
+  setup(ctx) {
+    const disposers = []
+    const dispose = () => {
+      while (disposers.length > 0) {
+        const fn = disposers.pop()
+        try { if (typeof fn === 'function') fn() } catch { /* 停用清理失败不阻断 */ }
+      }
+    }
+
+    // 会话级任务追踪（与【任务动画】【任务通知】【运行状态】共享一份）：
+    // 自动朗读的触发源——浏览器侧轮询 /status，看到新出现的结束记录（带 lastText）就读。
+    const lease = acquireTaskTracker(ctx)
+    disposers.push(() => lease.release())
+    const tracker = lease.tracker
+
+    disposers.push(ctx.inject(['webServer'], (wsCtx) => {
+      wsCtx.effect(() => wsCtx.webServer.register({
+        kind: 'prefix',
+        path: '/dsh-dock/tts',
+        async handler(req, res) {
+          if (rejectUntrustedRequest(ctx, req, res)) return
+          try {
+            const url = new URL(req.url || '/', 'http://dsh.internal')
+            const method = url.pathname.replace(/^\/dsh-dock\/tts\/?/, '').split('/')[0] || ''
+            const payload = await readBody(req)
+
+            if (method === 'status') {
+              return sendJson(res, 200, {
+                ok: true,
+                data: Object.assign({}, tracker.snapshot(Date.now()), { config: readTtsConfig(ctx) }),
+              })
+            }
+
+            if (method === 'config') {
+              const cfg = mergeTtsConfig(readTtsConfig(ctx), payload)
+              try {
+                await mutateDockSection(ctx, ['tts'], cfg)
+              } catch (e) {
+                const err = new Error('保存配置被拒绝：' + ((e && e.message) || String(e)))
+                err.statusCode = 400
+                throw err
+              }
+              return sendJson(res, 200, { ok: true, data: { config: cfg, savedAt: Date.now() } })
+            }
+
+            return sendJson(res, 404, { ok: false, error: { code: 'method-not-found', message: 'unknown method: ' + method } })
+          } catch (e) {
+            const status = e && e.statusCode ? e.statusCode : 500
+            console.error('[dsh-dock] tts HTTP error:', status, e && e.message)
+            return sendJson(res, status, {
+              ok: false,
+              error: { code: status >= 500 ? 'internal' : 'bad-request', message: (e && e.message) || String(e) },
+            })
+          }
+        },
+      }), 'dsh-dock tts: /dsh-dock/tts HTTP route')
+    }))
+
+    return dispose
+  },
+}