dsh-prime-memory 0.18.4 → 0.20.0-beta.1

package/CHANGELOG.en.md

@@ -7,6 +7,13 @@
 
 This file covers the **0.12.0** release notes and the current **unreleased** changes in English. For the full history, see [CHANGELOG.md](./CHANGELOG.md) (Chinese).
 
+## [0.19.0] — 2026-09-29
+
+### Changed
+
+- **DSH 0.2.0 adaptation (compat/0.2.0)**: peerDependencies and engines.dsh (package.json + dsh.plugin.json) moved wholesale to `>=0.2.0-rc.1 <0.2.1-0` (single-range replacement; the 0.1.7 line remains served by the compat/0.1.7 branch); the 9 dsh-* devDependencies re-pinned 0.1.1-rc.2 → 0.2.0-rc.1 and the type-only dependency `@deepseek-ai/dsh-compaction` added. Code-level adaptation to 0.2.0 host API drift: the `agent/session-start` event merged into `agent/created` (listeners made async to satisfy the serial contract); session event reads switched from `session.events` to `session.snapshotEvents()` (host deprecated synchronous full reads; degradation chain preserved); test stubs updated (projection cursor offset semantics).
+- **Release metadata**: version 0.18.4 → 0.19.0; publishConfig.tag `dsh-0.1.7` → `dsh-0.2.0`; dsh.plugin.json version → `0.19.0-dsh0.2.0.1`.
+
 ## [0.17.0-dsh0.1.7.1] — 2026-09-25
 
 > First release of the **host 0.1.7** compatibility line (dist-tag `dsh-0.1.7`, based on main @ 85d9b05). **Requires host ≥0.1.7-rc.1**; hosts 0.1.5 / 0.1.6 should stay on the `dsh-0.1.5` tag. Contains everything from main plus the adaptation below.

package/CHANGELOG.ja.md

@@ -9,6 +9,13 @@
 
 本ファイルは **0.12.0** リリースノートと現在の**未リリース**変更の日本語版です。全履歴は [CHANGELOG.md](./CHANGELOG.md)（中文）を参照してください。
 
+## [0.19.0] — 2026-09-29
+
+### 変更
+
+- **DSH 0.2.0 適応（compat/0.2.0）**：peerDependencies と engines.dsh（package.json + dsh.plugin.json）を `>=0.2.0-rc.1 <0.2.1-0` へ一括更新（単一レンジ置換。0.1.7 系は compat/0.1.7 ブランチが継続サポート）；dsh-* devDependencies 9 件を 0.1.1-rc.2 → 0.2.0-rc.1 に固定し直し、type-only 依存 `@deepseek-ai/dsh-compaction` を追加。コード面では 0.2.0 ホスト API の変化に対応：`agent/session-start` イベントを `agent/created` に統合（serial 契約に合わせリスナーを async 化）；Session イベント読み取りを `session.events` → `session.snapshotEvents()` に変更（ホストが同期全量読み取りを非推奨化。フォールバックチェーンは維持）；テストスタブ更新（projection カーソルの offset セマンティクス）。
+- **リリースメタデータ**：バージョン 0.18.4 → 0.19.0；publishConfig.tag `dsh-0.1.7` → `dsh-0.2.0`；dsh.plugin.json version → `0.19.0-dsh0.2.0.1`。
+
 ## [0.18.4] — 2026-09-28
 
 ### 追加

package/CHANGELOG.ko.md

@@ -9,6 +9,13 @@
 
 이 파일은 **0.12.0** 릴리스 노트와 현재 **미출시** 변경 사항의 한국어판입니다. 전체 이력은 [CHANGELOG.md](./CHANGELOG.md)（中文）를 참조하세요.
 
+## [0.19.0] — 2026-09-29
+
+### 변경
+
+- **DSH 0.2.0 대응（compat/0.2.0）**：peerDependencies와 engines.dsh(package.json + dsh.plugin.json)를 `>=0.2.0-rc.1 <0.2.1-0`로 일괄 갱신(단일 범위 치환. 0.1.7 라인은 compat/0.1.7 브랜치가 계속 지원)；dsh-* devDependencies 9건을 0.1.1-rc.2 → 0.2.0-rc.1로 재고정하고 type-only 의존성 `@deepseek-ai/dsh-compaction` 추가. 코드 측면에서 0.2.0 호스트 API 변화 대응：`agent/session-start` 이벤트를 `agent/created`로 통합(serial 계약에 맞춰 리스너를 async화)；Session 이벤트 읽기를 `session.events` → `session.snapshotEvents()`로 변경(호스트가 동기 전량 읽기를 폐기 예정. 폴백 체인 유지)；테스트 스텁 갱신(projection 커서 offset 시맨틱스).
+- **릴리스 메타데이터**：버전 0.18.4 → 0.19.0；publishConfig.tag `dsh-0.1.7` → `dsh-0.2.0`；dsh.plugin.json version → `0.19.0-dsh0.2.0.1`.
+
 ## [0.18.4] — 2026-09-28
 
 ### 추가

package/CHANGELOG.md

@@ -6,6 +6,37 @@
 > **UI 截图约定**：带界面变化的条目在 `assets/changelog/<版本号>/<两位编号>-<简述>.png`
 > 存真机截图，并在条目内以相对路径引用，读者可在更新日志里直接看到新版本 UI 的样子。
 
+## [Unreleased] — 长任务模式
+
+### 新增
+
+- **长任务模式(`longTask.*`,默认关)——「长跑会话」的三件套:上下文计量、任务参考、尾部压缩,以及一个非阻断的浮动建议面板。**
+  - **上下文使用量(`store/context-usage.ts`)**:监听 `assistant/message` 官方 `usage` 的输入侧(input + cache 读/写),取**最近值**语义(每轮输入侧已含全部历史,不累加);`compaction/summary` 后归零重计。纯内存 per-session Map——重启后首条 assistant 消息即可重建,持久化只会让过期样本诈尸。
+  - **todo 参考(`store/todo-ref.ts` + `hooks/long-task.ts`)**:监听宿主结构化 `todo/write` 事件(全量快照;包类型到 0.2.0-rc.1 未声明,插件以 declare module 自扩充——同 §E 的 dsh-compaction 先例)。**仅长任务会话**:快照刷进一张 pinned `todo` 槽位(`SlotStore.refreshByTitle` 受管刷新——同一主体反复写必须原地更新,否则 ≤8 槽上限里堆出关闭槽位尾迹),经 slot-recall 常驻注入——压缩把旧上下文逐出后,任务北极星仍在。相邻快照做词面 Jaccard 漂移检测(同快照重复写入不稀释信号);body ≤512 字节,截断明示。
+  - **尾部 turn 压缩(`longtask-compress-tail` 端点 + `compressTailTurns`)**:把(压缩水位线, 最新已捕获轮] 内最近 N 轮立即 `enqueue(force:true)` 蒸馏入记忆——立即把尾部对话落成可检索记忆,而不是等蒸馏阈值。水位线(`SessionModeStore.lastTailCompressedTurn`)只前进,重复按压天然幂等;off 档完全隐身;无锚点老数据只在首次压缩(水位线 0)时纳入——宁少收不重蒸。
+  - **建议状态(`longtask-hint-get`)+ 浮动球(`client/src/longtask-fab.ts`)**:ego-browser 式 vanilla overlay(FAB+面板,拖拽/位置持久化/视口夹紧),**建议不阻断**——仅当「上下文占用达 `contextThresholdPct`」或「todo 漂移达 `driftThreshold`」且长任务未开启时点亮呼吸光晕;面板内:长任务开关(临时,per-session,**不带 mode**——切开关不重置用户档位)、占用/漂移进度条、手动尾部压缩按钮(长任务开启才可用)、任务计数。轮询忙 2s/闲 5s,RPC 失败静默;座位契约不变(settings.section 恰一个,body 单例不占任何座位)。
+  - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。
+
+## [0.20.0-beta.1] — 2026-10-01
+
+> dsh-0.2.0 线首个 beta 渠道发布(`dsh-0.2.0-beta` tag):长任务模式真机预览。除下述内容外,本版同时携带此前 parked 于 `[Unreleased]` 的全部 main 改动(激活槽位/来源锚点/证据读取器/记忆退场闭环/三轴冲突等)——它们已随 0.1.7 线发布,但 main 线尚无对应版本号。
+
+### 新增
+
+- **长任务模式(`longTask.*`,默认关)——「长跑会话」的三件套:上下文计量、任务参考、尾部压缩,以及一个非阻断的浮动建议面板。**
+  - **上下文使用量(`store/context-usage.ts`)**:监听 `assistant/message` 官方 `usage` 的输入侧(input + cache 读/写),取**最近值**语义(每轮输入侧已含全部历史,不累加);`compaction/summary` 后归零重计。纯内存 per-session Map——重启后首条 assistant 消息即可重建,持久化只会让过期样本诈尸。
+  - **todo 参考(`store/todo-ref.ts` + `hooks/long-task.ts`)**:监听宿主结构化 `todo/write` 事件(全量快照;包类型到 0.2.0-rc.1 未声明,插件以 declare module 自扩充——同 §E 的 dsh-compaction 先例)。**仅长任务会话**:快照刷进一张 pinned `todo` 槽位(`SlotStore.refreshByTitle` 受管刷新——同一主体反复写必须原地更新,否则 ≤8 槽上限里堆出关闭槽位尾迹),经 slot-recall 常驻注入——压缩把旧上下文逐出后,任务北极星仍在。相邻快照做词面 Jaccard 漂移检测(同快照重复写入不稀释信号);body ≤512 字节,截断明示。
+  - **尾部 turn 压缩(`longtask-compress-tail` 端点 + `compressTailTurns`)**:把(压缩水位线, 最新已捕获轮] 内最近 N 轮立即 `enqueue(force:true)` 蒸馏入记忆——立即把尾部对话落成可检索记忆,而不是等蒸馏阈值。水位线(`SessionModeStore.lastTailCompressedTurn`)只前进,重复按压天然幂等;off 档完全隐身;无锚点老数据只在首次压缩(水位线 0)时纳入——宁少收不重蒸。
+  - **建议状态(`longtask-hint-get`)+ 浮动球(`client/src/longtask-fab.ts`)**:ego-browser 式 vanilla overlay(FAB+面板,拖拽/位置持久化/视口夹紧),**建议不阻断**——仅当「上下文占用达 `contextThresholdPct`」或「todo 漂移达 `driftThreshold`」且长任务未开启时点亮呼吸光晕;面板内:长任务开关(临时,per-session,**不带 mode**——切开关不重置用户档位)、占用/漂移进度条、手动尾部压缩按钮(长任务开启才可用)、任务计数。轮询忙 2s/闲 5s,RPC 失败静默;座位契约不变(settings.section 恰一个,body 单例不占任何座位)。
+  - **`session-mode-set` 的 `mode` 转为可选**:与 `longTask` 二选一必传——纯切长任务开关不再被迫发送档位(旧客户端恒传 mode,行为不变)。响应 `mode` 改回当前生效值。
+
+## [0.19.0] — 2026-09-29
+
+### 变更
+
+- **DSH 0.2.0 适配（compat/0.2.0）**：peerDependencies 与 engines.dsh（package.json + dsh.plugin.json）整体换代到 `>=0.2.0-rc.1 <0.2.1-0`（单段替换，0.1.7 线由 compat/0.1.7 分支继续服务）；devDependencies 9 个 dsh-* 精确钉 0.1.1-rc.2 → 0.2.0-rc.1 并新增 type-only 依赖 `@deepseek-ai/dsh-compaction`。代码层适配 0.2.0 宿主 API 漂移：`agent/session-start` 事件并入 `agent/created`（监听器改为 async 以满足 serial 契约）；Session 事件读取 `session.events` → `session.snapshotEvents()`（宿主已弃用同步全量读取，保留降级链）；测试桩同步更新（projection 游标 offset 语义）。
+- **发布元数据**：版本 0.18.4 → 0.19.0；publishConfig.tag `dsh-0.1.7` → `dsh-0.2.0`；dsh.plugin.json version → `0.19.0-dsh0.2.0.1`。
+
 ## [0.18.4] — 2026-09-28
 
 ### 新增

package/INSTALL.en.md

@@ -4,7 +4,7 @@ This plugin ships as a **DSH official bundle package**: after install, the `dsh.
 
 ## Requirements
 
-- Node.js ≥ 22.16 (DSH 0.1.1-rc.2 and above)
+- Node.js ≥ 22.16 (DSH 0.2.0-rc.1 and above)
 - DeepSeek Harness (DSH) installed, with `--profile web` available
 
 ## Install

package/INSTALL.ja.md

@@ -4,7 +4,7 @@
 
 ## 環境要件
 
-- Node.js ≥ 22.16（DSH 0.1.1-rc.2 以上）
+- Node.js ≥ 22.16（DSH 0.2.0-rc.1 以上）
 - DeepSeek Harness（以下 DSH）が導入済みで、`--profile web` が利用可能
 
 ## インストール

package/INSTALL.ko.md

@@ -4,7 +4,7 @@
 
 ## 환경 요구
 
-- Node.js ≥ 22.16（DSH 0.1.1-rc.2 이상）
+- Node.js ≥ 22.16（DSH 0.2.0-rc.1 이상）
 - DeepSeek Harness（이하 DSH）설치 완료, `--profile web` 사용 가능
 
 ## 설치

package/INSTALL.md

@@ -4,7 +4,7 @@
 
 ## 环境要求
 
-- Node.js ≥ 22.16（DSH 0.1.1-rc.2 及以上）
+- Node.js ≥ 22.16（DSH 0.2.0-rc.1 及以上）
 - 已安装 DeepSeek Harness（以下简称 DSH），且 `--profile web` 可用
 
 ## 安装