dsh-notify-ding 0.0.1 → 0.1.0

package/README.md

@@ -1,19 +1,50 @@
-# dsh-notify-ding 占位包
+# dsh·通知叮咚插件
 
-这个包是**占位**。
+在 DSH 需要你人工回答或一轮对话跑完时，弹出系统通知，并让宿主播放 Windows 自带的提示音。
 
-它唯一的作用是在 npm 上保留 `dsh-notify-ding` 这个包名，本身不含任何代码，也不含任何 DSH 插件结构。
+纯浏览器端触发、宿主端发声的双半身插件，不替换任何原生界面。
 
-真正的插件在 https://github.com/better-er/dsh-notify-ding 。
+## 引言
+
+<!-- 本节由作者本人撰写，AI 不代笔。 -->
+最小的 Windows 11 系统通知 + 内置提示音的提醒插件。
+
+## 功能
+
+- 某个会话出现新的待人工回答交互时叮咚一次，question、plan-review、approval 都算。
+- 某个会话从执行中落到空闲、也就是一轮对话跑完时叮咚一次。
+- 两种触发都会弹浏览器系统通知，同时请宿主播放 Windows 内置提示音。
+- 不判断页面是否聚焦，也不区分是否为当前会话，任何会话有事都会响。
+- 同一待回答请求只响一次，两次响铃之间至少有 800 毫秒间隔，且该间隔跨标签页共享，多开标签页不会重复响。
+
+## 使用
+
+### 首次使用
+
+浏览器系统通知需要页面授权。插件在加载时会尝试请求一次，若被浏览器拒绝，会在你下一次点击或按键时再请求一次。所以在第一次看到页面后点一下任意位置，授权弹窗就会出来。
+
+若浏览器通知一直弹不出来，声音仍然会正常响——两条路是独立的。
+
+### 声音从哪来
+
+浏览器沙箱读不到 `C:\Windows\Media` 下的文件，所以声音必须由宿主进程来播。宿主半身在 web 载体上注册一条精确路由 `POST /dsh-notify-ding/ding`，收到请求就用 PowerShell 的 `System.Media.SoundPlayer` 播放 `Windows Notify System Generic.wav`，响一声。
 
 ## 安装
 
-本包没有可用功能，请不要安装。若你只是想用那个插件，请改用：
+**从 GitHub 安装**：源码在 `src/`，`lib/` 不入仓库，安装时 npm 会触发 `prepare` 脚本现场构建。
 
 ```powershell
 dsh plugin --profile web add github:better-er/dsh-notify-ding
 ```
 
+**从 npm 安装**：包内已含构建产物 `lib/index.js` 与 `lib/client.js`，安装时不再构建。
+
+```powershell
+dsh plugin --profile web add dsh-notify-ding
+```
+
+两种方式装完都会自动挂载，重启 DSH web 后启用，无需手工编辑任何文件。
+
 ## 卸载
 
 ```powershell
@@ -22,6 +53,31 @@ dsh plugin --profile web remove dsh-notify-ding
 
 彻底移除，重启 DSH web 后不再加载。
 
+## 工作原理
+
+浏览器半身订阅 `ctx.sessions.list` 与 `ctx.uiSession.pendingInteractions` 两个只读快照，用边沿检测判断该不该响：运行态从真落到假算一轮跑完，出现新 key 的待回答交互算需要人工介入。首帧只建基线不发声，同一待回答请求只响一次，两次响铃之间留至少 800 毫秒并把该时刻写入 localStorage 跨标签页共享。
+
+判定通过时它做两件事：弹浏览器系统通知，以及向宿主发一个 POST。宿主半身只负责后者，它注册的 `/dsh-notify-ding/ding` 路由收到请求就用 PowerShell 播放提示音。完整设计见 [设计说明](docs/design.md)。
+
+## 要求与开发
+
+- 是标准形态的 dsh client 插件，声明 `dsh.client`，导出 `./client`。
+- 同时声明了 `dsh.bundle`，因此也是一个自挂载的 bundle 层插件：用 `dsh plugin --profile <name> add` 从 GitHub 安装后会被自动识别为 profile layer 并挂载，无需手工写组合 entry。
+- 宿主半身依赖 `webServer` 服务，浏览器半身依赖 `uiSession` 与 `sessions`。
+- 构建型插件：`src/` 是 TypeScript 源码，`lib/` 是构建产物且不入库，安装或发布前由 `prepare` 构建。
+
+## 开发
+
+```powershell
+pnpm install
+pnpm run typecheck   # tsc --noEmit 严格类型检查
+pnpm run build       # tsdown，产出 lib/index.js 与 lib/client.js
+```
+
+- `src/index.ts`：宿主半身，注册播音路由。
+- `src/client/index.ts`：浏览器半身，边沿检测与通知。
+- 构建用 tsdown，client 产物是 `window.__ModuleLoader__.load({ id, factory })` 的注册式模块，`@deepseek-ai/cordis` 保持外部依赖。
+
 ## License
 
 [MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# dsh-notify-ding bundle patch: mount the notification plugin.
+#
+# Applied when this bundle appears in a profile's dsh.profile.bundles list.
+# The node half (package root) owns the host-side sound route and the optional
+# window sound; the browser half (dsh.client) is discovered automatically
+# through the package's dsh.client declaration + exports["./client"].
+
+- insert:
+    - id: dsh-notify-ding
+      name: dsh-notify-ding

package/docs/design.md

@@ -0,0 +1,44 @@
+# 设计说明
+
+## 为什么是双半身
+
+浏览器沙箱读不到 `C:\Windows\Media` 下的音频文件，所以「Windows 本家音色」这件事只能由宿主进程完成。插件因此拆成两半：
+
+- **宿主半身** 只负责发声：在 web 载体上注册一条精确路由，收到请求就用 PowerShell 的 `System.Media.SoundPlayer` 播放 wav。
+- **浏览器半身** 只负责判断：盯住会话状态，判断什么时刻该响，然后同时弹系统通知并请求宿主播音。
+
+宿主半身不参与任何触发判断，浏览器半身不碰任何文件路径，职责边界清楚。
+
+## 触发信号
+
+浏览器半身盯两个快照源：
+
+| 信号 | 来源 | 触发条件 |
+| --- | --- | --- |
+| 待人工回答 | `ctx.uiSession.pendingInteractions` | 某会话出现新 key 的交互，question、plan-review、approval 都算 |
+| 一轮跑完 | `ctx.sessions.list` 的 `byId[].running` | 某会话运行态从真落到假 |
+
+两者都是可订阅的只读快照，插件不修改任何状态，只观察。
+
+## 去重与节流
+
+按用户选择，两种触发都要响，且不判断页面是否聚焦、不区分是否为当前会话，所以「响太多次」是主要风险，靠三道闸门控制。
+
+1. **首帧只建基线**：初次读到的快照只记录不发声，避免每次刷新页面补报一轮旧状态。
+2. **同一待回答请求只响一次**：按交互的稳定 key 记忆，消失后清理记录但不发声。
+3. **滚动最小间隔 800 毫秒**：两次响铃之间至少间隔这么久。窗口内到达的请求不丢弃，而是挂到窗口边界的定时器上补发，保证不漏报。该时刻写入 localStorage 跨标签页共享，多开标签页时同一件事只响一轮。
+
+## 声音与通知的关系
+
+两者互相独立：浏览器通知弹不出来时声音照响，宿主播音失败时通知照弹。任一侧失败只记一条 `console.warn`，不抛错、不互相阻塞。
+
+## 认证
+
+dsh web 由 connection 插件提供认证边界：根路径带 token 打开后铸出浏览器 cookie，后续同源请求自动带上。插件走同源 fetch 且带 `credentials: 'same-origin'`，因此沿用同一套 cookie，不需要自己处理 token。
+
+## 已知边界
+
+- 宿主半身依赖 `webServer` 服务，浏览器半身依赖 `uiSession` 与 `sessions`，缺任一则不激活。
+- 播音走 PowerShell 进程，单次开销约是一百毫秒级，慢但不阻塞响应。
+- 「一轮跑完」只覆盖正常结束与被打断这两种空闲落点，插件不区分具体结束原因。
+- Windows 聚焦助手开启时系统通知可能被静音，但宿主播音不受影响。

package/lib/client.js

@@ -0,0 +1,285 @@
+window.__ModuleLoader__.load({
+	id: "dsh-notify-ding",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperties(exports, {
+			__esModule: { value: true },
+			[Symbol.toStringTag]: { value: "Module" }
+		});
+		//#region src/client/index.ts
+		/** 插件名，同时也是配置项 id。 */
+		const name = "dsh-notify-ding";
+		/** 本插件需要的客户端服务。 */
+		const inject = ["uiSession", "sessions"];
+		/** 宿主播音路由，与宿主半身注册的路径一致。 */
+		const DING_PATH = "/dsh-notify-ding/ding";
+		/** 两次响铃之间的最小间隔，窗口内的合并成一次。 */
+		const MIN_INTERVAL_MS = 800;
+		/** 跨标签页共享「上次响铃时刻」的 localStorage 键。 */
+		const LAST_DING_KEY = "dsh-notify-ding.lastDingAt";
+		/** 系统通知自动关闭的延时。 */
+		const NOTIFICATION_TTL_MS = 1e4;
+		/** 记录各会话上一帧状态，用来做边沿检测。 */
+		const tracks = /* @__PURE__ */ new Map();
+		/** 本页面上次响铃的时间戳，兜住同一帧内的重复触发。 */
+		let lastDingAt = 0;
+		/** 因节流被暂时压下的最新一条待响请求，窗口过后补发。 */
+		let deferred = null;
+		/** 补发定时器的句柄，0 表示当前没有挂起的补发。 */
+		let deferredTimer = 0;
+		/**
+		* 读取跨标签页共享的上次响铃时刻。
+		*
+		* localStorage 可能因隐私模式或禁用存储而抛错，抛错时按 0 处理即可，
+		* 最坏退化成只在单个标签页内节流。
+		*
+		* @returns 上次响铃的 Unix 毫秒时间戳。
+		*/
+		function readSharedLastDing() {
+			try {
+				const raw = window.localStorage.getItem(LAST_DING_KEY);
+				const value = raw === null ? 0 : Number(raw);
+				return Number.isFinite(value) ? value : 0;
+			} catch (error) {
+				console.warn("[dsh-notify-ding] 读取共享响铃时刻失败：" + String(error));
+				return 0;
+			}
+		}
+		/** 写回跨标签页共享的上次响铃时刻，存储不可用时静默降级。 */
+		function writeSharedLastDing(stamp) {
+			try {
+				window.localStorage.setItem(LAST_DING_KEY, String(stamp));
+			} catch (error) {
+				console.warn("[dsh-notify-ding] 写入共享响铃时刻失败：" + String(error));
+			}
+		}
+		/**
+		* 请求宿主播放提示音。
+		*
+		* 声音本身与系统通知互相独立：通知弹不出来时声音照样响，反之亦然。
+		* 这里不阻塞调用方，播音失败只记一条警告。
+		*/
+		function requestHostDing() {
+			fetch(DING_PATH, {
+				method: "POST",
+				credentials: "same-origin"
+			}).catch((error) => {
+				console.warn("[dsh-notify-ding] 请求宿主播音失败：" + String(error));
+			});
+		}
+		/**
+		* 弹一条浏览器系统通知。
+		*
+		* 浏览器未授权时不强行索要权限，而是记下需要补授权，等到用户下一次
+		* 与页面交互时再请求——权限请求必须由用户手势触发。
+		*
+		* @param title 通知标题。
+		* @param body 通知正文。
+		*/
+		function showSystemNotification(title, body) {
+			if (typeof Notification === "undefined") return;
+			const present = () => {
+				try {
+					const notification = new Notification(title, { body });
+					notification.onclick = () => {
+						try {
+							window.focus();
+						} catch (error) {
+							console.warn("[dsh-notify-ding] 聚焦窗口失败：" + String(error));
+						}
+						notification.close();
+					};
+					window.setTimeout(() => notification.close(), NOTIFICATION_TTL_MS);
+				} catch (error) {
+					console.warn("[dsh-notify-ding] 弹出系统通知失败：" + String(error));
+				}
+			};
+			if (Notification.permission === "granted") {
+				present();
+				return;
+			}
+			if (Notification.permission === "denied") return;
+			Notification.requestPermission().then((permission) => {
+				if (permission === "granted") present();
+				else armPermissionGesture();
+			}).catch((error) => {
+				console.warn("[dsh-notify-ding] 请求通知权限失败：" + String(error));
+			});
+		}
+		/** 是否已经挂过一次手势补授权监听。 */
+		let gestureArmed = false;
+		/** 在下一次用户手势时补一次通知权限请求，只挂一次。 */
+		function armPermissionGesture() {
+			if (gestureArmed || typeof Notification === "undefined") return;
+			if (Notification.permission === "granted" || Notification.permission === "denied") return;
+			gestureArmed = true;
+			const onGesture = () => {
+				window.removeEventListener("pointerdown", onGesture, true);
+				window.removeEventListener("keydown", onGesture, true);
+				Notification.requestPermission().catch((error) => {
+					console.warn("[dsh-notify-ding] 手势补授权失败：" + String(error));
+				});
+			};
+			window.addEventListener("pointerdown", onGesture, true);
+			window.addEventListener("keydown", onGesture, true);
+		}
+		/**
+		* 发一次「叮咚」：弹系统通知并请宿主播音。
+		* @param title 通知标题。
+		* @param body 通知正文。
+		*/
+		function emit(title, body) {
+			showSystemNotification(title, body);
+			requestHostDing();
+		}
+		/**
+		* 发一次「叮咚」，并做节流。
+		*
+		* 节流时刻写进 localStorage，多标签页共享，避免多开时同一件事响好几轮。
+		* 被节流压下的请求不会直接丢弃，而是挂到窗口边界的定时器上补发，
+		* 这样连续两次状态变化仍然各响一次，只是间隔被拉开，不会出现漏报。
+		*
+		* @param title 通知标题。
+		* @param body 通知正文。
+		*/
+		function ding(title, body) {
+			const now = Date.now();
+			const since = now - Math.max(lastDingAt, readSharedLastDing());
+			if (since < 0 || since >= MIN_INTERVAL_MS) {
+				lastDingAt = now;
+				writeSharedLastDing(now);
+				emit(title, body);
+				return;
+			}
+			deferred = {
+				title,
+				body
+			};
+			if (deferredTimer !== 0) return;
+			deferredTimer = window.setTimeout(() => {
+				deferredTimer = 0;
+				const pending = deferred;
+				deferred = null;
+				if (pending === null) return;
+				const stamp = Date.now();
+				lastDingAt = stamp;
+				writeSharedLastDing(stamp);
+				emit(pending.title, pending.body);
+			}, MIN_INTERVAL_MS - since);
+		}
+		/** 会话标题，缺失时退回会话 id，保证通知里总有个能认的名字。 */
+		function titleOf(summary, fallbackId) {
+			const raw = summary?.displayTitle;
+			return raw && raw.length > 0 ? raw : fallbackId;
+		}
+		/**
+		* 用一帧会话列表快照做边沿检测：新出现的待回答交互响一次，运行态从真落到假响一次。
+		*
+		* 首帧只建基线不响，否则每次刷新页面都会把既有状态补报一轮。
+		*
+		* @param state 当前会话列表快照。
+		*/
+		function scanSessions(state, baseline) {
+			const seen = /* @__PURE__ */ new Set();
+			for (const id of Object.keys(state.byId)) {
+				const summary = state.byId[id];
+				if (!summary) continue;
+				seen.add(id);
+				let track = tracks.get(id);
+				if (!track) {
+					track = {
+						running: summary.running,
+						pendingKeys: /* @__PURE__ */ new Set()
+					};
+					tracks.set(id, track);
+				}
+				if (!baseline && track.running && !summary.running) ding("DSH 完成了一轮", titleOf(summary, id) + " 已空闲");
+				track.running = summary.running;
+			}
+			for (const id of Array.from(tracks.keys())) if (!seen.has(id)) tracks.delete(id);
+		}
+		/**
+		* 用一帧待回答交互快照做边沿检测：某会话冒出新的 key 时响一次。
+		*
+		* 消失的 key 只清理记录，不触发任何声音。
+		*
+		* @param pending 当前按会话索引的待回答交互快照。
+		* @param state 与本次快照同时读到的会话列表，用来取标题。
+		*/
+		function scanPending(pending, state, baseline) {
+			for (const [id, interaction] of pending) {
+				const track = tracks.get(id);
+				if (!track) continue;
+				if (track.pendingKeys.has(interaction.key)) continue;
+				track.pendingKeys.add(interaction.key);
+				if (baseline) continue;
+				ding("DSH 需要你回答", titleOf(state.byId[id], id) + " 正在等你");
+			}
+			for (const [id, track] of tracks) {
+				if (track.pendingKeys.size === 0) continue;
+				const stillPending = pending.get(id);
+				if (stillPending === void 0) {
+					track.pendingKeys.clear();
+					continue;
+				}
+				for (const key of Array.from(track.pendingKeys)) if (key !== stillPending.key) track.pendingKeys.delete(key);
+			}
+		}
+		/**
+		* 同时盯住会话列表与待回答交互两个快照源。
+		*
+		* @param ctx 客户端根上下文，sessions 与 uiSession 已就绪。
+		*/
+		function apply(ctx) {
+			if (typeof Notification !== "undefined" && Notification.permission === "default") armPermissionGesture();
+			const pendingSource = ctx.uiSession.pendingInteractions;
+			const listSource = ctx.sessions.list;
+			/** 是否已经用首帧快照建立过基线；首帧只记录不发声。 */
+			let initialized = false;
+			/** 读两个源并各扫一遍，保证两处看到的是同一帧会话列表。 */
+			const scan = () => {
+				let state;
+				try {
+					state = listSource.getSnapshot();
+				} catch (error) {
+					console.warn("[dsh-notify-ding] 读取会话列表失败：" + String(error));
+					return;
+				}
+				const baseline = !initialized;
+				initialized = true;
+				scanSessions(state, baseline);
+				try {
+					scanPending(pendingSource.getSnapshot(), state, baseline);
+				} catch (error) {
+					console.warn("[dsh-notify-ding] 读取待回答交互失败：" + String(error));
+				}
+			};
+			const unsubscribeList = listSource.subscribe(scan);
+			const unsubscribePending = pendingSource.subscribe(scan);
+			scan();
+			ctx.effect(() => () => {
+				unsubscribeList();
+				unsubscribePending();
+				if (deferredTimer !== 0) {
+					window.clearTimeout(deferredTimer);
+					deferredTimer = 0;
+				}
+				deferred = null;
+				tracks.clear();
+			});
+		}
+		/** 兼容旧产物的默认导出形态：同时提供命名导出与 default。 */
+		var client_default = {
+			name,
+			inject,
+			apply
+		};
+		//#endregion
+		exports.apply = apply;
+		exports.default = client_default;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+/** 插件名，同时也是配置项 id。 */
+export declare const name = "dsh-notify-ding";
+/** 依赖宿主 web 载体的具名路由注册能力。没有 web 载体时本插件不激活。 */
+export declare const inject: string[];
+/** Windows 通知音的绝对路径，本家音色。 */
+export declare const SOUND_FILE = "C:\\Windows\\Media\\Windows Notify System Generic.wav";
+/** 一次「叮咚」播放的次数，一声即可，重复反而显得吵。 */
+export declare const BEEP_COUNT = 1;
+/**
+ * 挂载播音路由。
+ *
+ * @param ctx 宿主上下文，webServer 服务已就绪。
+ */
+export declare function apply(ctx: Context): void;
+//#endregion

package/lib/index.js

@@ -0,0 +1,114 @@
+import { spawn } from "node:child_process";
+//#region src/index.ts
+/**
+* dsh-notify-ding 的宿主半身。
+*
+* 职责只有一件：在 dsh 的 web 载体上注册一条精确路由 POST /dsh-notify-ding/ding，
+* 收到请求就用 PowerShell 的 System.Media.SoundPlayer 播放 Windows 自带的提示音。
+* 之所以要绕宿主这一圈，是因为浏览器沙箱读不到 C:\Windows\Media 下的文件，
+* 而 Windows 本家音色只有读得到那些 wav 的宿主进程才播得出来。
+*
+* 浏览器半身负责判断「该响了」；本半身不参与任何触发判断，只负责发声。
+*
+* @module dsh-notify-ding
+*/
+/** 插件名，同时也是配置项 id。 */
+const name = "dsh-notify-ding";
+/** 依赖宿主 web 载体的具名路由注册能力。没有 web 载体时本插件不激活。 */
+const inject = ["webServer"];
+/** 播音路由的绝对路径。 */
+const ROUTE_PATH = "/dsh-notify-ding/ding";
+/** Windows 通知音的绝对路径，本家音色。 */
+const SOUND_FILE = "C:\\Windows\\Media\\Windows Notify System Generic.wav";
+/** 一次「叮咚」播放的次数，一声即可，重复反而显得吵。 */
+const BEEP_COUNT = 1;
+/**
+* 组装播音用的 PowerShell 脚本。
+*
+* 路径经单引号转义后拼进脚本字面量，避免文件名里的特殊字符被当成命令解析。
+* 播放次数写进脚本，因此一次进程启动就能响完整段声音，不必每声各起一个进程。
+*
+* @returns 一段自包含的 PowerShell 脚本。
+*/
+function buildPlayScript() {
+	return [
+		"$ErrorActionPreference = 'Stop'",
+		"$ProgressPreference = 'SilentlyContinue'",
+		"$player = New-Object System.Media.SoundPlayer '" + SOUND_FILE.replace(/'/g, "''") + "'",
+		"for ($i = 0; $i -lt 1; $i++) {",
+		"  $player.PlaySync()",
+		"}"
+	].join("\n");
+}
+/**
+* 把播音请求交给一个脱离宿主事件循环的 PowerShell 进程。
+*
+* 用 detached 启动，因此响铃不会被 dsh 的生命周期或响应结束打断；
+* stderr 仍要接住，否则播放失败时宿主会留下无人消费的管道数据。
+*
+*/
+function spawnPlayer() {
+	const script = buildPlayScript();
+	const encoded = Buffer.from(script, "utf16le").toString("base64");
+	const child = spawn("powershell.exe", [
+		"-NoLogo",
+		"-NoProfile",
+		"-NonInteractive",
+		"-EncodedCommand",
+		encoded
+	], {
+		detached: true,
+		stdio: [
+			"ignore",
+			"ignore",
+			"pipe"
+		],
+		windowsHide: true
+	});
+	child.stderr?.on("data", (chunk) => {
+		const text = chunk.toString("utf8").trim();
+		if (text) console.warn("[dsh-notify-ding] 播音进程报错：" + text);
+	});
+	child.on("error", (error) => {
+		console.warn("[dsh-notify-ding] 播音进程启动失败：" + error.message);
+	});
+	child.on("close", (code) => {
+		if (code !== 0 && code !== null) console.warn("[dsh-notify-ding] 播音进程退出码：" + String(code));
+	});
+	child.unref();
+}
+/**
+* 挂载播音路由。
+*
+* @param ctx 宿主上下文，webServer 服务已就绪。
+*/
+function apply(ctx) {
+	const webServer = ctx.get("webServer");
+	if (!webServer) {
+		console.warn("[dsh-notify-ding] 未找到 webServer 服务，播音路由不注册。");
+		return;
+	}
+	webServer.register({
+		kind: "exact",
+		path: ROUTE_PATH,
+		handler: (req, res) => {
+			if (req.method !== "POST") {
+				res.statusCode = 405;
+				res.end("method not allowed");
+				return;
+			}
+			try {
+				spawnPlayer();
+			} catch (error) {
+				console.warn("[dsh-notify-ding] 播音调用失败：" + error.message);
+				res.statusCode = 500;
+				res.end("spawn failed");
+				return;
+			}
+			res.statusCode = 200;
+			res.end("ding");
+		}
+	});
+}
+//#endregion
+export { BEEP_COUNT, SOUND_FILE, apply, inject, name };

package/package.json

@@ -1,16 +1,65 @@
 {
   "name": "dsh-notify-ding",
-  "version": "0.0.1",
-  "description": "占位包，手动发布以在 npm 上保留 dsh-notify-ding 这个包名。0.1.0 起改为真正的插件并走 Trusted Publishing，见 https://github.com/better-er/dsh-notify-ding。",
+  "version": "0.1.0",
+  "description": "在 DSH 需要人工回答或一轮对话跑完时，弹出系统通知并让宿主播放 Windows 内置提示音。标准可安装的 dsh 客户端插件。",
   "keywords": [
     "deepseek-harness",
     "dsh",
-    "placeholder"
+    "dsh-plugin",
+    "notification",
+    "sound",
+    "notify"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/better-er/dsh-notify-ding.git"
+  },
   "author": "betterer",
-  "license": "MIT",
+  "packageManager": "pnpm@9.15.9",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
   "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/index.d.ts",
+    "cordis.patch.yml",
     "README.md",
-    "LICENSE"
-  ]
+    "docs/"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=26.3.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-session"
+      ]
+    }
+  },
+  "scripts": {
+    "prepare": "tsdown",
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@types/node": "^22.20.1",
+    "tsdown": "^0.23.0",
+    "typescript": "^5.9.3"
+  }
 }