dsh-notify-yimit 0.2.2 → 0.2.3

package/lib/client.js

@@ -78,6 +78,17 @@ window.__ModuleLoader__.load({
 			'.dn-msg.ok{color:var(--dsw-alias-state-success-primary)}',
 			'.dn-msg.err{color:var(--dsw-alias-state-error-primary)}',
 			'.dn-divider{height:1px;background:var(--dsw-alias-border-l1)}',
+			// ④ 宿主故障横幅:让"通知不显示"从静默失败变成可见、可解释。
+			//    颜色走 --dsw-alias-state-* 令牌,深/浅色模式都能自适应。
+			'.dn-host{display:flex;flex-direction:column;gap:8px;border:1px solid var(--dsw-alias-state-error-primary);border-radius:8px;padding:10px 12px;background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent)}',
+			'.dn-host-line{display:flex;align-items:flex-start;gap:8px;font-size:12px;line-height:18px}',
+			'.dn-host-icon{flex:none;font-size:13px;line-height:18px;color:var(--dsw-alias-state-error-primary)}',
+			'.dn-host-title{font-weight:600;color:var(--dsw-alias-state-error-primary)}',
+			'.dn-host-body{color:var(--dsw-alias-label-secondary);flex:1;min-width:0}',
+			'.dn-host-actions{display:flex;align-items:center;gap:8px;padding-left:21px}',
+			'.dn-host-detail{font-size:11px;line-height:16px;font-family:var(--dsw-font-mono);color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l1);border-radius:6px;padding:6px 8px;margin-left:21px;max-height:88px;overflow:auto;white-space:pre-wrap;word-break:break-all}',
+			'.dn-host[data-tone="ok"]{border-color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 10%,transparent)}',
+			'.dn-host[data-tone="ok"] .dn-host-icon,.dn-host[data-tone="ok"] .dn-host-title{color:var(--dsw-alias-state-success-primary)}',
 			'.dn-layer{position:fixed;top:16px;right:16px;z-index:9999;display:flex;flex-direction:column;align-items:flex-end;gap:10px;pointer-events:none}',
 			'.dn-card{pointer-events:auto;width:320px;max-width:calc(100vw - 32px);border-radius:12px;box-shadow:var(--dsw-shadow-lv3);border:1px solid var(--dsw-alias-border-l2);background:var(--dn-bg,#20272f);color:var(--dn-fg,#e6edf3);overflow:hidden;animation:dn-in .18s ease}',
 			'@keyframes dn-in{from{opacity:0;transform:translateX(24px)}to{opacity:1;transform:translateX(0)}}',
@@ -131,6 +142,20 @@ window.__ModuleLoader__.load({
 			permissionDefault: '系统通知需要浏览器通知权限',
 			requestPermission: '申请通知权限',
 			triggerNote: '触发场景:任务完成、任务出错、运行中(实时内容)、等待审批、等待回答。通知标题为对话标题;点击通知或跳转按钮可打开对应会话。',
+			// ④ 宿主故障横幅
+			hostErrTitle: '通知宿主异常退出',
+			hostErrBody: '自定义通知当前无法显示{detail}。',
+			hostErrPending: ' —— 已积压 {n} 条通知',
+			hostErrRetryIn: ';正在退避,约 {s} 秒后自动重试',
+			hostErrRetryNow: '立即重试',
+			hostErrRetry: '重新拉起宿主',
+			hostErrDetail: '查看详情',
+			hostErrDetailHide: '收起详情',
+			hostErrDetailText: '退出码 {code},连续失败 {n} 次',
+			hostErrSignal: '退出码 {code}(信号 {signal}),连续失败 {n} 次',
+			hostErrOkTitle: '通知宿主已恢复',
+			hostErrOkBody: '自定义通知已恢复正常。',
+			hostErrOkBodyPending: '已补发 {n} 条积压通知。',
 			toastStyleTitle: '通知窗口样式',
 			toastGapLabel: '通知间距(px)',
 			enterEdit: '进入编辑模式',
@@ -177,6 +202,20 @@ window.__ModuleLoader__.load({
 			permissionDefault: 'System notifications need browser notification permission',
 			requestPermission: 'Request permission',
 			triggerNote: 'Triggers: task completed, task failed, running (live activity), awaiting approval, awaiting answer. The title is the conversation title; clicking the notification or the jump button opens the session.',
+			// ④ host-failure banner
+			hostErrTitle: 'Notification host exited unexpectedly',
+			hostErrBody: 'Custom notifications cannot be shown right now{detail}.',
+			hostErrPending: ' — {n} notification(s) queued',
+			hostErrRetryIn: '; backing off, retrying in about {s}s',
+			hostErrRetryNow: 'Retry now',
+			hostErrRetry: 'Restart host',
+			hostErrDetail: 'Show details',
+			hostErrDetailHide: 'Hide details',
+			hostErrDetailText: 'exit code {code}, {n} consecutive failure(s)',
+			hostErrSignal: 'exit code {code} (signal {signal}), {n} consecutive failure(s)',
+			hostErrOkTitle: 'Notification host recovered',
+			hostErrOkBody: 'Custom notifications are working again.',
+			hostErrOkBodyPending: '{n} queued notification(s) delivered.',
 			toastStyleTitle: 'Toast window style',
 			toastGapLabel: 'Toast gap (px)',
 			enterEdit: 'Enter edit mode',
@@ -356,10 +395,27 @@ window.__ModuleLoader__.load({
 
 		function parseState(v, path) {
 			if (v === null || typeof v !== 'object' || Array.isArray(v)) fail(path)
+			// ④ 宿主故障状态。旧宿主没有该字段 → null(不显示横幅)。
+			// 手写 codec 是"只取已知字段"的宽容解析,多余字段会被忽略,
+			// 但宿主侧 typert 的 z.object 会**丢弃**未声明字段,所以那边也必须声明。
+			let hostError = null
+			const he = v.hostError
+			if (he !== null && he !== undefined && typeof he === 'object' && !Array.isArray(he)) {
+				hostError = {
+					code: typeof he.code === 'number' ? he.code : null,
+					signal: typeof he.signal === 'string' ? he.signal : null,
+					at: typeof he.at === 'number' ? he.at : 0,
+					count: typeof he.count === 'number' ? he.count : 1,
+					retryAt: typeof he.retryAt === 'number' ? he.retryAt : 0,
+				}
+			}
 			return {
 				config: parseConfig(v.config, path + '.config'),
 				// 宿主运行环境:true = 桌面端。缺省按 web 端处理(旧宿主无该字段)。
 				desktop: v.desktop === true,
+				hostError,
+				pendingCount: typeof v.pendingCount === 'number' && v.pendingCount >= 0 ? Math.floor(v
+					.pendingCount) : 0,
 				events: Array.isArray(v.events) ? v.events.map((e, i) => parseEvent(e, path + '.events[' +
 					i + ']')) : []
 			}
@@ -474,6 +530,16 @@ window.__ModuleLoader__.load({
 				},
 				parameters: [],
 				result: strictResult('dsh-notify-yimit#AckResult', ackCodec)
+			}, {
+				id: 'dsh-notify-yimit#notify/retryHost',
+				service: 'notify',
+				namespace: 'notify',
+				method: 'retryHost',
+				invocation: {
+					kind: 'direct'
+				},
+				parameters: [],
+				result: strictResult('dsh-notify-yimit#AckResult', ackCodec)
 			}]
 		}
 
@@ -714,6 +780,22 @@ window.__ModuleLoader__.load({
 				.permission : 'unsupported')
 			// 通知窗口编辑模式(样板窗拖拽/缩放)
 			const [editing, setEditing] = useState(false)
+			// ④ 横幅里的「查看详情」折叠状态
+			const [hostDetail, setHostDetail] = useState(false)
+			// ④ 宿主故障横幅:退避倒计时每秒重算一次(依赖的 retryAt 是稳定数字,
+			//    所以这个 effect 不会因为轮询重渲染而反复重建定时器)。
+			const hostError = state?.hostError ?? null
+			const pendingCount = state?.pendingCount ?? 0
+			const retryAt = hostError !== null && typeof hostError.retryAt === 'number' ? hostError.retryAt : 0
+			const [nowTick, setNowTick] = useState(0)
+			useEffect(() => {
+				if (retryAt <= 0) return undefined
+				const timer = setInterval(() => setNowTick((n) => n + 1), 1000)
+				return () => clearInterval(timer)
+			}, [retryAt])
+			// 倒计时秒数(取整);nowTick 参与依赖以触发重算
+			void nowTick
+			const retryInSec = retryAt > 0 ? Math.max(0, Math.round((retryAt - Date.now()) / 1000)) : 0
 			// 最新值镜像:卸载清理时读取(避免空依赖闭包拿到陈旧值)。
 			const editingRef = useRef(false)
 			editingRef.current = editing
@@ -1084,6 +1166,52 @@ window.__ModuleLoader__.load({
 				el('p', {
 					className: 'dn-note'
 				}, t('saveHint')),
+				// ④ 宿主故障横幅:让"自定义通知不显示"从静默失败变成可见、可解释。
+				//    仅在宿主确实异常退出时出现(hostError 由宿主侧置上)。
+				hostError !== null ? el('div', {
+						className: 'dn-host',
+						'data-tone': 'err'
+					},
+					el('div', {
+							className: 'dn-host-line'
+						},
+						el('span', {
+							className: 'dn-host-icon'
+						}, '✕'),
+						el('span', {
+								className: 'dn-host-body'
+							},
+							el('span', {
+								className: 'dn-host-title'
+							}, t('hostErrTitle')),
+							t('hostErrBody', {
+								detail: (pendingCount > 0 ? t('hostErrPending', {
+									n: pendingCount
+								}) : '') + (retryInSec > 0 ? t('hostErrRetryIn', {
+									s: retryInSec
+								}) : '')
+							}))),
+					el('div', {
+							className: 'dn-host-actions'
+						},
+						el('button', {
+							className: 'dn-btn primary',
+							onClick: () => void api.retryHost()
+						}, retryInSec > 0 ? t('hostErrRetryNow') : t('hostErrRetry')),
+						el('button', {
+							className: 'dn-btn',
+							onClick: () => setHostDetail(!hostDetail)
+						}, hostDetail ? t('hostErrDetailHide') : t('hostErrDetail'))),
+					hostDetail ? el('div', {
+						className: 'dn-host-detail'
+					}, hostError.signal !== null && hostError.signal !== undefined ? t('hostErrSignal', {
+						code: hostError.code === null ? '-' : hostError.code,
+						signal: hostError.signal,
+						n: hostError.count
+					}) : t('hostErrDetailText', {
+						code: hostError.code === null ? '-' : hostError.code,
+						n: hostError.count
+					})) : null) : null,
 				msg !== null ? el('div', {
 					className: 'dn-msg ' + msg.kind
 				}, msg.text) : null,
@@ -1111,6 +1239,8 @@ window.__ModuleLoader__.load({
 			const store = makeStore({
 				config: null,
 				desktop: false,
+				hostError: null,
+				pendingCount: 0,
 				events: [],
 				browsers: []
 			})
@@ -1125,6 +1255,8 @@ window.__ModuleLoader__.load({
 						store.set({
 							config: state.config,
 							desktop: state.desktop,
+							hostError: state.hostError ?? null,
+							pendingCount: state.pendingCount ?? 0,
 							events: state.events,
 							browsers: parsed.browsers
 						})
@@ -1162,6 +1294,9 @@ window.__ModuleLoader__.load({
 						store.set({
 							config: parseConfig(result.value, 'config'),
 							desktop: state.desktop,
+							// ④ 保留宿主故障状态与积压数,否则改一次配置横幅就被抹掉
+							hostError: state.hostError ?? null,
+							pendingCount: state.pendingCount ?? 0,
 							events: state.events,
 							browsers: state.browsers
 						})
@@ -1186,6 +1321,17 @@ window.__ModuleLoader__.load({
 					} catch {
 						/* 静默 */ }
 				},
+				// ④ 横幅上的「重新拉起宿主」:清退避并立刻重试,然后重新拉一次状态。
+				retryHost: async () => {
+					try {
+						await notify.retryHost()
+					} catch {
+						/* 静默 */ }
+					try {
+						await reload()
+					} catch {
+						/* 静默 */ }
+				},
 			}
 
 			// ===== 现在设置 __localeService 并使用 api =====

package/lib/index.js

@@ -519,10 +519,41 @@ export function apply(ctx) {
 	let toastSeq = 1
 	let host = null
 	let hostAlive = false
-	let hostRestartAttempts = 0
 	let hostRestartUntil = 0
+	// ② 早退退避:spawn 成功 ≠ 进程活着。旧代码在 spawn 后同步置 hostAlive = true,
+	// 于是 ensureHost() 里的 `if (!hostAlive)` 永不成立、退避计数恒被清零,退避形同虚设。
+	// 宿主秒退时(例如 BOM 丢失),每条通知都会重拉一个 powershell.exe
+	// (冷启动 200–300ms + WPF 初始化),而 running 是高频事件 → 进程风暴。
+	// 因此把"早退"记在 exit 回调里(那里有真实存活时长),按连续早退次数退避。
+	let hostEarlyExits = 0
+	// ③ 一个故障周期内只告警一次,避免 600 字符 stderr 刷屏把关键信息淹掉。
+	let hostWarned = false
+	const HOST_EARLY_EXIT_MS = 3000
+	// ④ 设置页可见的宿主故障状态。null = 正常;否则描述最近一次故障。
+	// 客户端把它渲染成设置页上的横幅 —— 否则宿主失败时用户只看到"没有通知",
+	// 完全不知道发生了什么(报告者的核心抱怨就是"没有任何报错")。
+	// 形状:{ code, signal, at, count, retryAt }
+	let hostError = null
 
 	function spawnHost() {
+		// ① 运行时自检:toast-host.ps1 必须是「UTF-8 with BOM」。
+		// 宿主是 Windows PowerShell 5.1 拉起的,它对无 BOM 的 .ps1 会按系统 ANSI
+		// 代码页解码;在中文 Windows(936/932/950)下中文会吃掉字符串收尾引号 →
+		// 整段脚本语法错误 → 宿主秒退 → 所有自定义通知不显示且无任何报错。
+		// prepublishOnly 里也有同样的断言,但那只在发布时拦得住;这里是给
+		// "开发期误丢 BOM 后本地重载插件"这条路径兜底。
+		try {
+			const head = fs.readFileSync(TOAST_HOST_SCRIPT)
+			if (!(head[0] === 0xEF && head[1] === 0xBB && head[2] === 0xBF)) {
+				console.warn(
+					'[dsh-notify-yimit] lib/toast-host.ps1 缺少 UTF-8 BOM!中文 Windows 下 ' +
+					'PowerShell 5.1 会按 ANSI 解码导致脚本语法错误、宿主秒退,自定义通知将全部不显示。' +
+					'请把该文件另存为「UTF-8 with BOM」。'
+				)
+			}
+		} catch (error) {
+			if (process.env.DSH_DEBUG) console.warn(`[dsh-notify-yimit] BOM 自检失败: ${String(error)}`)
+		}
 		try {
 			const spawnFn = typeof globalThis.__DSH_NOTIFY_TEST_SPAWN__ === 'function' ? globalThis
 				.__DSH_NOTIFY_TEST_SPAWN__ : spawn
@@ -537,6 +568,9 @@ export function apply(ctx) {
 			return
 		}
 		hostAlive = true
+		// ④ 新宿主已拉起:清掉上一次的故障状态(真正的恢复以"活过阈值"为准,
+		// 但拉起成功即可先收起横幅,若又秒退会立刻重新置上)。
+		hostError = null
 		host.stdin.on('error', (err) => {
 			if (process.env.DSH_DEBUG) console.warn(`[dsh-notify-yimit] stdin error: ${err}`)
 		})
@@ -546,6 +580,64 @@ export function apply(ctx) {
 		})
 		host.stdout.setEncoding('utf8')
 
+		// ── 宿主 stderr 与早退诊断 ──────────────────────────────────────────
+		// toast-host.ps1 是「UTF-8 with BOM」文件:Windows PowerShell 5.1 对无 BOM 的
+		// .ps1 会按系统 ANSI 代码页解码,在中文 Windows(936/932/950)下中文会吃掉
+		// 字符串引号 → 整段脚本语法错误 → 宿主**秒退**。
+		// 而发通知失败原本是"静默入队",用户既看不到浮窗、也拿不到任何报错。
+		// 所以这里把宿主的 stderr 留住,并在它启动后很快以非 0 退出时明确告警。
+		let hostStderr = ''
+		let spawnedAt = Date.now()
+		host.stderr.on('data', (d) => {
+			if (hostStderr.length < 8192) hostStderr += String(d)
+		})
+		host.stderr.on('error', () => {})
+		// exit 报告里带上"存活时长"与 stderr,便于直接定位。
+		// ③ 条件用 `code !== 0 || signal != null`:被信号杀死时 code 为 null、signal 才有值,
+		//    旧写法 `code !== 0 && code !== null` 会正好漏掉这种情况而不告警。
+		host.on('exit', (code, signal) => {
+			const livedMs = Date.now() - spawnedAt
+			hostAlive = false
+			activeToasts.clear()
+			toastOrder.length = 0
+			pendingClose.clear()
+			if (livedMs < HOST_EARLY_EXIT_MS && (code !== 0 || signal !== null)) {
+				// ② 记一次早退,据此退避,避免进程风暴
+				hostEarlyExits++
+				hostRestartUntil = Date.now() + Math.min(30000, 1000 * (2 ** hostEarlyExits))
+				// ④ 暴露给设置页(客户端据此显示横幅)
+				hostError = {
+					code: code === null ? null : Number(code),
+					signal: signal === null ? null : String(signal),
+					at: Date.now(),
+					count: hostEarlyExits,
+					retryAt: hostRestartUntil,
+				}
+				// ③ 一个故障周期内只告警一次
+				if (!hostWarned) {
+					hostWarned = true
+					const detail = hostStderr.trim().slice(0, 600)
+					console.warn(
+						`[dsh-notify-yimit] 通知宿主进程启动后 ${livedMs}ms 即退出` +
+						`(code=${code}${signal !== null ? `, signal=${signal}` : ''}),自定义通知将无法显示。` +
+						`最可能的原因:lib/toast-host.ps1 丢失了 UTF-8 BOM` +
+						`(中文 Windows 下 PS 5.1 会按 ANSI 解码导致语法错误)。` +
+						`已进入退避,${Math.round((hostRestartUntil - Date.now()) / 1000)}s 内不再重启。` +
+						(detail.length > 0 ? `\n--- 宿主 stderr ---\n${detail}` : '\n(宿主未输出 stderr)')
+					)
+				}
+			} else if (livedMs >= HOST_EARLY_EXIT_MS) {
+				// ② 活过阈值 = 健康,清零计数与告警状态(并可提示已恢复)。
+				if (hostEarlyExits > 0) {
+					console.warn('[dsh-notify-yimit] 通知宿主已恢复正常运行。')
+				}
+				hostEarlyExits = 0
+				hostRestartUntil = 0
+				hostWarned = false
+				// ④ 清除故障状态,设置页横幅随之收起
+				hostError = null
+			}
+		})
 		let buf = ''
 		host.stdout.on('data', (d) => {
 			buf += String(d)
@@ -617,13 +709,6 @@ export function apply(ctx) {
 				}
 			}
 		})
-
-		host.on('exit', () => {
-			hostAlive = false
-			activeToasts.clear()
-			toastOrder.length = 0
-			pendingClose.clear()
-		})
 	}
 
 	function sendCmd(payload) {
@@ -638,14 +723,11 @@ export function apply(ctx) {
 
 	function ensureHost() {
 		if (host !== null && hostAlive) return true
+		// ② 退避窗口内直接放弃:否则宿主秒退时每条通知都会重拉一个 powershell.exe。
+		// 退避时长由 exit 回调按"连续早退次数"设置(那里才有真实存活时长),
+		// 不能像旧代码那样在 spawn 之后同步判断 hostAlive —— 那是恒为 true 的。
 		if (Date.now() < hostRestartUntil) return false
 		spawnHost()
-		if (!hostAlive) {
-			hostRestartAttempts++
-			hostRestartUntil = Date.now() + Math.min(30000, 1000 * (2 ** hostRestartAttempts))
-		} else {
-			hostRestartAttempts = 0
-		}
 		return host !== null && hostAlive
 	}
 
@@ -1195,6 +1277,14 @@ export function apply(ctx) {
 				config: store.get(),
 				// 运行环境:桌面端(=Electron 宿主)还是 web 端。客户端据此隐藏只对浏览器有意义的设置项。
 				desktop: isDesktopRuntime === true,
+				// ④ 宿主故障状态(null = 正常)。客户端在设置页渲染成横幅,让"通知不显示"
+				// 这件事从"静默失败"变成可见、可解释。
+				hostError: hostError === null ? null : {
+					...hostError
+				},
+				// 宿主不可用时,通知会堆在插件侧的 queue 里(见 showDesktopToast 的失败分支)。
+				// 给客户端一个条数,用于告诉用户"积压了多少条"。
+				pendingCount: Math.max(0, queue.length - queueHead),
 				events: queue.slice(queueHead).map((item) => ({
 					...item
 				}))
@@ -1272,6 +1362,22 @@ export function apply(ctx) {
 				ok: true
 			}
 		},
+		/**
+		 * ④ 立即重试拉起通知宿主(设置页横幅上的「重新拉起宿主」)。
+		 * 清掉退避窗口与故障状态后立刻 spawn;若又秒退,exit 回调会重新置上
+		 * hostError 并按新的连续早退次数退避。
+		 */
+		retryHost() {
+			hostEarlyExits = 0
+			hostRestartUntil = 0
+			hostWarned = false
+			hostError = null
+			hostAlive = false
+			spawnHost()
+			return {
+				ok: hostAlive
+			}
+		},
 	}
 
 	Object.defineProperty(service, 'typertRemote', {

package/lib/toast-host.ps1

@@ -1,4 +1,15 @@
-<# dsh-notify-yimit 常驻浮窗宿主(Windows PowerShell + WPF)。
+<# dsh-notify-yimit 常驻浮窗宿主(Windows PowerShell + WPF)。
+
+★★★ 编码要求:本文件必须保存为「UTF-8 with BOM」(文件头 EF BB BF)。★★★
+本文件含大量中文,而宿主是用 Windows PowerShell 5.1(`powershell.exe`)拉起的,
+PS 5.1 对**没有 BOM** 的 .ps1 会按**系统 ANSI 代码页**解码。在中文 Windows
+(ACP=936/GBK,以及 932/950)下,中文字节会被错误解码、吃掉字符串收尾引号,
+导致整段脚本语法错误 —— 宿主进程秒退,**所有自定义通知全部不显示,且没有任何报错**。
+表现特征:报错行往往是纯 ASCII 行(例如 `$q.Enqueue('{"cmd":"shutdown"}')`),
+真正的病灶在它上面的中文行。
+注意:ACP=65001(UTF-8)的机器上不会复现,PS 7(pwsh)也不会复现 —— 所以本地验证
+必须按 936 解码后再交给解析器,或直接用带 BOM 的文件。
+凡是重写/另存本文件后,请重新确认 BOM 仍在(编辑器与多数脚本化改写都会丢掉它)。
 
 倒计时即进度(本版核心变化):
 - 非粘性通知整卡抽象为倒计时:强调色 @12% "液面层"锚定左缘,ScaleX 1→0,
@@ -667,9 +678,14 @@ public class ToastWin32 {
     $script:ToastWin32Ready = $false
 }
 
-function Write-ActLog([string]$msg) {
+function Write-ActLog([string]$msg, [switch]$Always) {
     # 诊断日志:激活这一步涉及"按 exe 路径找进程 + 枚举窗口"两处环境相关行为,
     # 出问题时按钮只会静默无反应,没有日志无法定位。
+    #
+    # 写入策略(避免往用户安装目录里持续写日志):
+    #   · -Always:仅启动探针使用,每次宿主加载写一行(极小,且是诊断秒退的关键线索);
+    #   · 其余(逐次点击的明细)只有设了 DSH_DEBUG 才写 —— 与插件其它调试输出的约定一致。
+    if (-not $Always -and [string]::IsNullOrEmpty($env:DSH_DEBUG)) { return }
     # 落点优先级:脚本所在目录(真实宿主 = lib/)→ DSH_HOME。
     try {
         $line = "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')  $msg`r`n"
@@ -693,7 +709,7 @@ try {
     try { $probe += " selfExe='$((Get-Process -Id $PID).Path)'" } catch { $probe += " selfExe=<取不到>" }
     try { $probe += " DSH_HOME='$env:DSH_HOME'" } catch { }
     try { $probe += " PSScriptRoot='$PSScriptRoot'" } catch { }
-    Write-ActLog $probe
+    Write-ActLog $probe -Always
 } catch { }
 
 function Invoke-ToastActivateApp([string]$appPath) {

package/lib/typert.host.js

@@ -52,10 +52,27 @@ const notifyEventSchema = z.object({
 	at: z.number(),
 })
 
+/**
+ * 宿主故障状态(④ 设置页横幅的数据源)。
+ * null = 正常。旧宿主不返回该字段,靠 .default(null) 兼容。
+ */
+const hostErrorSchema = z.object({
+	code: z.number().nullable(),
+	signal: z.string().nullable(),
+	at: z.number(),
+	count: z.number(),
+	retryAt: z.number(),
+}).nullable().default(null)
+
 const getStateSchema = z.object({
 	config: configSchema,
 	// 可选+默认 false:旧宿主(无该字段)仍能通过校验,按 web 端处理。
 	desktop: z.boolean().default(false),
+	// 可选+默认:旧宿主无这两个字段也能通过校验。
+	// 注意 zod 的 z.object 会**丢弃**未声明字段,所以新增字段必须在这里声明,
+	// 否则宿主返回了也会被 codec 吃掉(已实测确认)。
+	hostError: hostErrorSchema,
+	pendingCount: z.number().default(0),
 	events: z.array(notifyEventSchema),
 })
 
@@ -179,6 +196,17 @@ export const TYPERT = {
 			parameters: [],
 			result: _ack$codec,
 		},
+		{
+			id: 'dsh-notify-yimit#notify/retryHost',
+			service: 'notify',
+			namespace: 'notify',
+			method: 'retryHost',
+			invocation: {
+				kind: 'direct'
+			},
+			parameters: [],
+			result: _ack$codec,
+		},
 	],
 	model: {
 		services: [{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-notify-yimit",
-	"version": "0.2.2",
+	"version": "0.2.3",
 	"description": "DeepSeek Harness 通知插件:任务完成 / 任务出错 / 运行中(实时活动)/ 等待审批 / 等待回答 时,通过 Windows 系统通知或插件自定义样式通知提醒用户,支持点击跳转到对应会话;设置页集成在 DSH 设置界面。",
 	"type": "module",
 	"main": "lib/index.js",
@@ -33,12 +33,14 @@
 		"lib/typert.host.js",
 		"lib/client.js",
 		"lib/toast-host.ps1",
+		"scripts/check-prepublish.mjs",
 		"cordis.patch.yml",
 		"README.md",
 		"README.en.md"
 	],
 	"scripts": {
-		"prepublishOnly": "node -e \"const bad = Object.keys(require('./package.json').dependencies || {}).filter((k) => k.startsWith('@deepseek-ai/')); if (bad.length) throw new Error('host packages belong in peerDependencies: ' + bad.join(', '))\""
+		"prepublishOnly": "node scripts/check-prepublish.mjs",
+		"check:prepublish": "node scripts/check-prepublish.mjs"
 	},
 	"repository": {
 		"type": "git",

package/scripts/check-prepublish.mjs

@@ -0,0 +1,60 @@
+/**
+ * 发布前守卫(prepublishOnly 调用)。
+ *
+ * 目前只做两件事,都是"发布后才会暴露、且用户端极难自查"的机械检查:
+ *
+ * 1. host 包不能出现在 dependencies —— 它们必须留在 peerDependencies,
+ *    否则 pnpm 会把 @deepseek-ai/* 复制进 profile 的 node_modules,
+ *    顶掉宿主自带的同名插件并破坏 settings namespace 注册。
+ *
+ * 2. lib/toast-host.ps1 必须带 UTF-8 BOM。该文件含大量中文,而宿主是
+ *    Windows PowerShell 5.1 拉起的:PS 5.1 对**没有 BOM** 的 .ps1 会按系统
+ *    ANSI 代码页解码,在中文 Windows(936/932/950)下中文会吃掉字符串收尾引号,
+ *    导致整段脚本语法错误 → 宿主秒退 → **所有自定义通知都不显示,且没有任何报错**。
+ *    只有双字节代码页(DBCS)才会破坏语法,所以英文/UTF-8 ACP 的机器上
+ *    完全测不出来 —— 必须在发布前机械拦截。
+ *
+ * 失败一律以非 0 退出码结束,让 npm publish 中止。
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const failures = []
+
+// ── 1. dependencies 里不允许出现 @deepseek-ai/* ──
+try {
+	const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+	const bad = Object.keys(pkg.dependencies ?? {}).filter((k) => k.startsWith('@deepseek-ai/'))
+	if (bad.length > 0) {
+		failures.push(`host 包必须放在 peerDependencies,却出现在 dependencies: ${bad.join(', ')}`)
+	}
+} catch (error) {
+	failures.push(`读取 package.json 失败: ${String(error)}`)
+}
+
+// ── 2. lib/toast-host.ps1 必须带 UTF-8 BOM ──
+const HOST_SCRIPT = 'lib/toast-host.ps1'
+try {
+	const bytes = readFileSync(join(root, HOST_SCRIPT))
+	if (!(bytes[0] === 0xEF && bytes[1] === 0xBB && bytes[2] === 0xBF)) {
+		const head = [...bytes.subarray(0, 3)].map((b) => b.toString(16).toUpperCase().padStart(2, '0')).join(' ')
+		failures.push(
+			`${HOST_SCRIPT} 缺少 UTF-8 BOM(文件头是 ${head},应为 EF BB BF)。\n` +
+			'    中文 Windows 下 PowerShell 5.1 会按 ANSI 解码 → 脚本语法错误 → 宿主秒退,\n' +
+			'    用户端表现为"所有自定义通知都不显示且无任何报错"。\n' +
+			'    请把该文件另存为「UTF-8 with BOM」后重试。'
+		)
+	}
+} catch (error) {
+	failures.push(`读取 ${HOST_SCRIPT} 失败: ${String(error)}`)
+}
+
+if (failures.length > 0) {
+	console.error('\n[dsh-notify-yimit] 发布前检查未通过:\n')
+	for (const f of failures) console.error(`  ✗ ${f}`)
+	console.error('')
+	process.exit(1)
+}
+console.log('[dsh-notify-yimit] 发布前检查通过 ✓')