dsh-notify-windows 0.7.6 → 0.7.7-beta.0

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)。
 
+## [0.7.7-beta.0] - 2026-09-24
+
+### Beta（DSH 0.1.7-rc.1 适配，测试版）
+
+- 本分支（`dev-0.1.7.rc1`，尚未合并 `main`）相对 `main` 的适配改动：
+  `package.json` 的 `dsh.compatibility.dshReleases` 新增 `"0.1.7-rc.1": "compatible"`
+  （`peerDependencies` 仍为 `@deepseek-ai/cordis ^4.0.2`）；README 徽章与兼容性声明同步；
+  `lib/index.js` 的 `VERSION` 常量升至 `0.7.7`，并补充 `snapshotEvents()` 弃用延期迁移的
+  头注。源码逻辑无变更。
+- 发布为 npm 测试版（`--tag beta`）；`latest` 保持不变。正式版 `0.7.7` 待 `main` 合并后发布。
+
+## [0.7.7] - 2026-09-24
+
+### 兼容性
+
+- **适配 DSH 0.1.7-rc.1**：在本机 **0.1.7-rc.1** 上真实装载运行通过（插件正常加载、
+  零错误；`dsh-notify` 入口激活）。`dsh.compatibility.dshReleases` 新增
+  `"0.1.7-rc.1": "compatible"`；README 徽章与兼容性声明同步。
+- **`snapshotEvents()` 弃用（延期迁移）**：DSH 0.1.6-alpha.1 起将
+  `Session.snapshotEvents()` / `eventAt()` / `ownEvents()` 标记为 `@deprecated`，
+  0.1.7-rc.1 Release Notes 重申；官方 Agent Note 明确"新调用被禁止，但现有未迁移
+  逻辑可暂时保留"。本插件的历史读取（通知摘要 / `/goal` 轮次检查）属既有逻辑，
+  继续使用该访问器，并在 `lib/index.js` 的 `sessionEvents()` 头注记录延期理由与
+  迁移触发条件（待 DSH 提供异步分页读取替代后再迁移）。无源码逻辑变更。
+
+### 其它
+
+- `lib/index.js` 的 `VERSION` 常量同步提升为 `0.7.7`，与 `package.json` 一致。
+
 ## [0.7.6] - 2026-09-22
 
 ### 兼容性

package/README.en.md

@@ -7,11 +7,12 @@
   <img src="https://img.shields.io/github/license/SeverusZh/dsh-notify-windows" alt="license">
   <img src="https://img.shields.io/badge/platform-Windows%2010%2F11-blue" alt="platform">
   <img src="https://img.shields.io/github/stars/SeverusZh/dsh-notify-windows?style=social" alt="stars">
+  <img src="https://img.shields.io/badge/DSH%200.1.5--rc.1%20%2F%20rc.2%20%2F%200.1.6--alpha.2-blue" alt="dsh">
 </p>
 
 **Task finished** ✅ ｜ **Approval pending** 🔐 ｜ **Question pending** ❓ — never miss anything that needs you, even away from the screen.
 
-> **Compatibility**: v0.7.5 supports DSH **0.1.2-alpha.4+** and was verified against the `snapshotEvents()` contract on **0.1.5-rc.1** with the real-Cordis probe suite (15/15; peer `@deepseek-ai/cordis ^4.0.2`). Session history is read through both the legacy `session.events` (DSH <= 0.1.2-alpha.3) and `snapshotEvents()` (DSH 0.1.2-alpha.4+, where that property no longer exists), so excerpts, `/goal` round detection and approval-policy suppression work again after upgrading to 0.7.5. If you saw "all notifications went silent after a restart", upgrade to **0.7.3+**.
+> **Compatibility**: v0.7.5 supports DSH **0.1.2-alpha.4+** and was verified against the `snapshotEvents()` contract on **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2** with the real-Cordis probe suite (15/15; peer `@deepseek-ai/cordis ^4.0.2`). Session history is read through both the legacy `session.events` (DSH <= 0.1.2-alpha.3) and `snapshotEvents()` (DSH 0.1.2-alpha.4+, where that property no longer exists), so excerpts, `/goal` round detection and approval-policy suppression work again after upgrading to 0.7.5. If you saw "all notifications went silent after a restart", upgrade to **0.7.3+**.
 
 ## ✨ Features
 

package/README.md

@@ -7,12 +7,14 @@
   <img src="https://img.shields.io/github/license/SeverusZh/dsh-notify-windows" alt="license">
   <img src="https://img.shields.io/badge/platform-Windows%2010%2F11-blue" alt="platform">
   <img src="https://img.shields.io/github/stars/SeverusZh/dsh-notify-windows?style=social" alt="stars">
-  <img src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.5--rc.1-blue" alt="dsh">
+  <img src="https://img.shields.io/badge/DSH%200.1.5--rc.1%20%2F%20rc.2%20%2F%200.1.6--alpha.2%20%2F%200.1.7--rc.1-blue" alt="dsh">
 </p>
 
 **任务完成** ✅ ｜ **等待审批** 🔐 ｜ **等待回答** ❓ —— 离开屏幕也不错过任何需要你处理的事。
 
-> **兼容性**：v0.7.5 支持 DSH **0.1.2-alpha.4+**，已在 **0.1.5-rc.1** 上核对 `snapshotEvents()` 契约并通过真实-Cordis 探针（15/15；peer `@deepseek-ai/cordis ^4.0.2`）。历史读取同时兼容旧版 `session.events`（DSH ≤ 0.1.2-alpha.3）与新版 `snapshotEvents()`（DSH 0.1.2-alpha.4 起该属性已不存在），升级到 0.7.5 后摘要 / `/goal` 轮次 / 审批策略恢复正常。收到过「重启后所有通知静默」问题的请升级到 **0.7.3+**（见 FAQ）。
+> **兼容性**：v0.7.7 支持 DSH **0.1.2-alpha.4+**，已在 **0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1** 上核对 `snapshotEvents()` 契约并通过真实-Cordis 探针（15/15；peer `@deepseek-ai/cordis ^4.0.2`）。历史读取同时兼容旧版 `session.events`（DSH ≤ 0.1.2-alpha.3）与新版 `snapshotEvents()`（DSH 0.1.2-alpha.4 起该属性已不存在），升级到 0.7.5 后摘要 / `/goal` 轮次 / 审批策略恢复正常。收到过「重启后所有通知静默」问题的请升级到 **0.7.3+**（见 FAQ）。
+>
+> **0.1.7-rc.1 说明**：该版本起 `snapshotEvents()` 被标记为 `@deprecated`（"新调用被禁止，现有未迁移逻辑可暂时保留"）。本插件的历史读取属既有逻辑，按官方 Agent Note 的延期口径暂不迁移——DSH 仍在内存保留完整事件序列，通知摘要与 `/goal` 轮次检查照常工作；待 DSH 提供异步分页读取替代后再迁移。
 
 ## ✨ 功能
 

package/lib/index.js

@@ -25,7 +25,7 @@ import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const NOTIFY_SCRIPT = fileURLToPath(new URL("./notify.ps1", import.meta.url));
-const VERSION = "0.7.6";
+const VERSION = "0.7.7";
 
 // Convert a script path so powershell.exe can read it.
 //   - On WSL: powershell.exe is a Windows process and can't read Linux paths
@@ -124,6 +124,17 @@ function textOfMessage(message) {
  * losing the excerpt or the goal-round check is acceptable, but breaking the
  * notification path is not. The degradation is reported through
  * `onUnavailable` so it never disappears without a trace again.
+ *
+ * DSH 0.1.6+ deprecation deferral: `Session.snapshotEvents()` (with `eventAt()`
+ * and `ownEvents()`) is marked `@deprecated` from 0.1.6-alpha.1 and restated in
+ * the 0.1.7-rc.1 release notes — "new production calls are prohibited", while
+ * "existing logic may remain unmigrated for now". This reader is existing
+ * logic and keeps the deprecated accessor deliberately: the notification
+ * excerpt / `/goal` round check only need the current turn's tail, and DSH
+ * still retains the complete event sequence in memory, so no rewrite is
+ * required to keep working on 0.1.7-rc.1. Revisit only when DSH ships the
+ * async paged-read replacement. See the official Agent Note
+ * `.agents/notes/implemented/architecture/2026-09-09-deprecate-synchronous-session-event-reads.md`.
  */
 export function sessionEvents(session, onUnavailable) {
   // Reporting must never break the notification path either: a throwing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-notify-windows",
-  "version": "0.7.6",
+  "version": "0.7.7-beta.0",
   "description": "DeepSeek Harness (DSH) 插件：任务完成 / 等待审批 / 等待回答时发送 Windows 系统桌面通知",
   "repository": {
     "type": "git",
@@ -41,7 +41,8 @@
       "dshReleases": {
         "0.1.5-rc.1": "compatible",
         "0.1.5-rc.2": "compatible",
-        "0.1.6-alpha.2": "compatible"
+        "0.1.6-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible"
       },
       "node": ">=20"
     }