dsh-dock 0.17.0 → 0.19.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-dock",
-  "version": "0.17.0",
-  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计，支持各模型自定义单价、多段分时价与周末/节假日谷价）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景）、任务通知（完成/异常/需确认通知、提示音、系统通知、钉钉/飞书推送）、运行状态（进行中任务与最近完成一览）、语音朗读（浏览器 TTS 读回复：回合下方喇叭按钮 + 自动朗读）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
+  "version": "0.19.0",
+  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计，支持各模型自定义单价、多段分时价与周末/节假日谷价）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景）、任务通知（完成/异常/需确认通知、提示音、语音播报可选音色、系统通知、钉钉/飞书推送）、运行状态（进行中任务与最近完成一览）、语音朗读（浏览器 TTS 读回复：回合下方喇叭按钮 + 自动朗读）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
   "type": "module",
   "main": "index.js",
   "files": [

package/src/client.jsx

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

package/src/host-core.js

@@ -101,6 +101,15 @@ export const DockConfig = z.object({
     notifyOnError: z.boolean().default(true),
     // 工具等待用户确认/批准时提醒（dsh 会话流 approval/asked → decided）
     notifyOnConfirm: z.boolean().default(true),
+    // 卡住提醒卡片：编程阶段长时间无活动时弹一张（与 voiceOnStuck 同口径，但开关独立）
+    notifyOnStuck: z.boolean().default(true),
+    // 页内卡片总开关：关闭后右侧所有通知卡片一律不再弹出（含已挂着的）。
+    // 只管卡片——语音播报、提示音、系统通知、钉钉/飞书推送各有独立开关，不受它影响。
+    notifyCards: z.boolean().default(true),
+    // 卡片口径三挡（右侧卡片正文写多少）：brief = 任务与耗时/谁卡住；medium = 加模型、
+    // 起止时间、停滞时长；detailed = 全部（回合步骤、Token、摘要或错误、最后动作）。
+    // 默认 detailed ＝历史内容——未设置时卡片不缩水。
+    cardMode: z.string().default('detailed'),
     // 通知停留毫秒数（0 = 常驻直到手动关闭）
     notifyStayMs: z.number().default(8000),
     // 浏览器系统通知（页面后台时推送）
@@ -115,6 +124,23 @@ export const DockConfig = z.object({
     // 飞书群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
     feishuEnabled: z.boolean().default(false),
     feishuWebhook: z.string().default(''),
+    // ===== 语音播报（浏览器 speechSynthesis；与【语音朗读】同一套声音但相互独立开关） =====
+    // 总开关：关闭时下面所有播报都不发声（默认关，避免升级后突然说话吓人）。
+    voiceNotify: z.boolean().default(false),
+    // 播报口径三挡：brief = 一句话；medium = 点名任务 + 原因/耗时/停滞时长；
+    // detailed = 带标题/耗时/回合统计/工具名/最后动作。
+    voiceMode: z.string().default('brief'),
+    // 四个播报时刻，各自独立开关（开总开关后按这里筛选）：
+    voiceOnComplete: z.boolean().default(true),   // 任务正常完成
+    voiceOnError: z.boolean().default(true),      // 任务停止（出错/中止/受阻/达上限/中断）
+    voiceOnConfirm: z.boolean().default(true),    // 任务需要授权（工具等待批准）
+    voiceOnStuck: z.boolean().default(true),      // 任务卡住（编程阶段 18 秒无活动，与【任务动画】同口径）
+    // 播报语速/音量/语言/音色。voiceURI 与【语音朗读】同款语义：设备相关的音色标识，
+    // 空 = 按语言自动挑；本机音色表里找不到时由客户端按语言回落（见 features/notify/view.jsx）。
+    voiceRate: z.number().default(1),
+    voiceVolume: z.number().default(1),
+    voiceLang: z.string().default(''),
+    voiceURI: z.string().default(''),
     // 一次性迁移标记：animation 段的旧通知配置已搬到本段（搬完置 true，避免每次启动重复写）
     migratedFromAnimation: z.boolean().default(false),
   }).default({}).volatile(),
@@ -243,8 +269,13 @@ export async function mutateDockSection(ctx, path, value, expectedRevision) {
 /** 通知配置字段清单（schema、迁移、客户端默认值三处共用同一份键名）。 */
 export const NOTIFY_FIELDS = [
   'notifyOnComplete', 'notifyOnError', 'notifyOnConfirm', 'notifyStayMs',
+  'notifyOnStuck', 'notifyCards', 'cardMode',
   'systemNotify', 'soundNotify', 'soundEffect',
   'dingtalkEnabled', 'dingtalkWebhook', 'feishuEnabled', 'feishuWebhook',
+  // 语音播报（新增段字段；旧 animation 段里不存在，迁移循环自然不会搬它们）
+  'voiceNotify', 'voiceMode',
+  'voiceOnComplete', 'voiceOnError', 'voiceOnConfirm', 'voiceOnStuck',
+  'voiceRate', 'voiceVolume', 'voiceLang', 'voiceURI',
 ]
 
 /**

package/src/task-track.js

@@ -88,6 +88,32 @@ function createTracker(ctx) {
 		return ''
 	}
 
+	/**
+	 * 会话标题 + 主/子任务归属：优先 readTitleSnapshot（一次观测同时拿到标题与会话头），
+	 * 会话头里的 origin === 'subagent' / delegationDepth 是权威的子任务标记（见 dsh-session
+	 * SessionHeader），fallback 路径只拿标题、按主任务处理。取不到头不报错——播报退化为
+	 * 不带归属的旧口径，功能不受影响（测试桩只需实现 readTitle/readSession 也能跑）。
+	 * @returns {Promise<{ title: string, header: object|null }>}
+	 */
+	async function readSessionFacts(sessionId, sessionQuery) {
+		const facts = { title: '', header: null }
+		if (!sessionQuery) return facts
+		try {
+			if (typeof sessionQuery.readTitleSnapshot === 'function') {
+				const obs = await sessionQuery.readTitleSnapshot(sessionId)
+				if (obs) {
+					const t = obs.title
+					if (typeof t === 'string') facts.title = t
+					else if (t && typeof t.title === 'string') facts.title = t.title
+					if (obs.session && typeof obs.session === 'object') facts.header = obs.session
+					if (facts.title || facts.header) return facts
+				}
+			}
+		} catch { /* 换下一种读法 */ }
+		facts.title = await getSessionTitle(sessionId, sessionQuery)
+		return facts
+	}
+
 	function addActiveSession(sid, sessionQuery, extra = {}) {
 		if (activeSessions.has(sid)) return activeSessions.get(sid)
 		// 不在终端打「任务开始」日志：开始/结束状态界面（运行状态页）已实时可见
@@ -108,6 +134,11 @@ function createTracker(ctx) {
 			errorMessage: '',
 			lastText: '',
 			firstPrompt: '',
+			// 主/子任务归属 + 最近一次调用的工具：卡住播报与卡住卡要说清「哪里卡住、最后在干什么」
+			//（isSubtask 由会话头 origin/delegationDepth 异步判定，判定前按主任务处理）
+			isSubtask: false,
+			parentSessionId: '',
+			lastToolName: '',
 			// 工具等待用户确认（dsh 会话流 approval/asked）：浏览器侧据此弹"需确认"通知
 			approvals: new Map(), // approvalId -> { toolName, reason, askedAt }
 			phase: 'think',
@@ -120,10 +151,17 @@ function createTracker(ctx) {
 			...extra,
 		}
 		activeSessions.set(sid, record)
-		getSessionTitle(sid, sessionQuery).then((title) => {
+		readSessionFacts(sid, sessionQuery).then((facts) => {
 			const s = activeSessions.get(sid)
-			if (s) s.title = title
-		})
+			if (!s) return
+			if (facts.title) s.title = facts.title
+			const h = facts.header
+			if (h) {
+				s.isSubtask = h.origin === 'subagent'
+					|| (typeof h.delegationDepth === 'number' && h.delegationDepth > 0)
+				s.parentSessionId = typeof h.parentSession === 'string' && h.parentSession ? h.parentSession : ''
+			}
+		}).catch(() => { /* 标题/归属读失败：title 走 firstPrompt 兜底，归属按主任务 */ })
 		return record
 	}
 
@@ -229,6 +267,9 @@ function createTracker(ctx) {
 			s.toolCalls++
 			s.phase = phaseOfToolName(event.data && event.data.name)
 			s.phaseAt = now
+			// 记下最后调用的工具名：卡住播报/卡住卡要回答「最后在干什么」
+			const called = event.data && typeof event.data.name === 'string' ? event.data.name : ''
+			if (called) s.lastToolName = called
 			// 工具启动是稀疏事件，给一个更明显的短促动作，检索/写文件也不会显得停住。
 			s.motionTicks += s.phase === 'search' ? 7 : 9
 			s.lastMotionAt = now
@@ -329,6 +370,10 @@ function createTracker(ctx) {
 					lastActivityAt: s.lastActivityAt,
 					motionTicks: s.motionTicks,
 					lastMotionAt: s.lastMotionAt,
+					// 卡住播报/卡住卡专用：主/子归属（会话头判定）与最后调用的工具
+					isSubtask: !!s.isSubtask,
+					parentSessionId: s.parentSessionId || '',
+					lastToolName: s.lastToolName || '',
 					approvals: [...s.approvals.entries()].map(([id, v]) => ({ id, ...v })),
 				})
 			}