dsh-archived-chats 1.4.2 → 1.4.4

package/CHANGELOG.md

@@ -4,6 +4,36 @@
 
 Entries describe behavior at each release, not necessarily current behavior. Consult the READMEs and user guides for current usage.
 
+## 1.4.4 — 2026-09-27
+
+### 中文
+
+- 运行时代码无变化，本次发布只更新包元数据中的已验证 Host 版本。可选 peer 范围原本就通过 `>=0.1.2-alpha.1 <0.2.0-0` 覆盖 0.1.7，现在额外显式列出已验证的 `0.1.7-rc.2`。
+- 发布验证的 Host fixture 从 `0.1.5-rc.2`（会话格式 v3）升级到 `0.1.7-rc.2`（v4），CI 因此在 Ubuntu、macOS 和 Windows 上真正执行 v4 路径。1.4.3 的缺陷此前无法被 CI 复现，正是因为旧 fixture 的会话格式是 v3。
+- 已安装 1.4.3 或更高版本并运行在 DSH `0.1.7-rc.2` 上的用户，本版没有需要采取的动作。
+
+### English
+
+- No runtime code changes. This release only updates the verified Host version in the package metadata. The optional peer range already admitted 0.1.7 through `>=0.1.2-alpha.1 <0.2.0-0`; it now also lists the verified `0.1.7-rc.2` explicitly.
+- The release-verification Host fixture moves from `0.1.5-rc.2` (session format v3) to `0.1.7-rc.2` (v4), so CI now exercises the v4 path on Ubuntu, macOS, and Windows. The 1.4.3 defect could not be reproduced by CI before this change precisely because the old fixture's session format was v3.
+- Users already on 1.4.3 or later running DSH `0.1.7-rc.2` have no action to take for this release.
+
+## 1.4.3 — 2026-09-26
+
+### 中文
+
+- 修复在 DSH `0.1.7-rc.2` 等新版 Host 上删除归档会话失败的问题。该版本把会话格式提升为 v4，磁盘上的 `header.version` 因此变为 `4`；插件的持久化兼容层只接受 v2 和 v3，在读取列表时就拒绝，删除随即以 `persistence-response-invalid` 中止。现在兼容层接受 v4。
+- v4 相对 v3 只是版本号递增，header 字段形状不变，因此接受 v4 时其余校验（必需字段类型、`cwd` 必须为绝对路径、`createdAt`/`delegationDepth` 的取值范围、未知扩展字段保留等）全部保持原样。
+- 新增 v4 header 的读取用例，覆盖列表与检查两条路径；该用例在放宽前失败，可阻止回归。
+- 删除归档依赖读取列表，因此此缺陷同时影响删除、批量删除、预览与搜索等所有走持久化兼容层的入口。
+
+### English
+
+- Fix deleting archived chats on DSH `0.1.7-rc.2` and later Hosts. Those versions raise the session format to v4, so the on-disk `header.version` is now `4`; the plugin's persistence compatibility layer accepted only v2 and v3, rejected the header during list, and the deletion aborted with `persistence-response-invalid`. The compatibility layer now accepts v4.
+- v4 differs from v3 by the version number alone and keeps the same header field shape. Accepting v4 therefore leaves every other check intact: required field types, `cwd` having to be absolute, the `createdAt` and `delegationDepth` ranges, and preserving unknown extension fields.
+- Add a v4 header read test covering both list and inspect; it failed before the relaxation, so it guards against regression.
+- Deletion reads the list first, so the defect also affected every entry point that goes through the compatibility layer, including bulk deletion, preview, and search.
+
 ## 1.4.2 — 2026-09-22
 
 ### 中文

package/README.md

@@ -32,7 +32,7 @@ Archive Management gives DeepSeek Harness a place to find chats hidden from the
 
 > The English name is **Archive Management**, and the Chinese name is **归档管理**. The installation package remains `dsh-archived-chats`.
 >
-> This document follows the `main` branch. This guide targets 1.4.2, whose export writer no longer carries a dependency that prevents startup on newer Hosts. See the [changelog](CHANGELOG.md) for release history, including 1.4.1's English rename and feedback improvements.
+> This document follows the `main` branch. This guide targets 1.4.4, whose runtime code is unchanged from 1.4.3; package metadata now lists DSH `0.1.7-rc.2` among the verified Hosts. 1.4.3 accepts the v4 session format those Hosts publish. The 1.4.2 export writer no longer carries a dependency that prevents startup on newer Hosts. See the [changelog](CHANGELOG.md) for release history, including 1.4.1's English rename and feedback improvements.
 
 ## Quick start
 
@@ -141,10 +141,12 @@ Archive Management is actively maintained. The latest stable npm release receive
 
 ```sh
 npm test
+npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
+node scripts/run-native-integration.mjs
 npm pack --dry-run --json
 ```
 
-The suite covers Host and browser behavior, export/import, snapshot fallback recovery, Recycle Bin, retention, search, responsive layout, public types, package contents, and repository hygiene. It uses isolated temporary data and never reads real sessions.
+The suite covers Host and browser behavior, export/import, snapshot fallback recovery, Recycle Bin, retention, search, responsive layout, public types, package contents, and repository hygiene. The native commands install the locked `@deepseek-ai/dsh-session@0.1.7-rc.2` fixture and require all five native round-trip cases to run without skips. All checks use isolated temporary data and never read real sessions.
 
 ## Uninstall
 

package/README.zh-CN.md

@@ -30,7 +30,7 @@
 
 > 中文名称为「归档管理」，英文名称为 Archive Management；安装包名始终为 `dsh-archived-chats`。
 >
-> 本文跟随 `main` 分支维护。本文适用于 1.4.2，其导出实现不再携带会导致新版 Host 启动失败的依赖；已安装用户请先升级。版本变更见[更新日志](CHANGELOG.md)，其中包含 1.4.1 的英文名称统一与交互提示优化。
+> 本文跟随 `main` 分支维护。本文适用于 1.4.4，其运行时代码与 1.4.3 相同；包元数据现将 DSH `0.1.7-rc.2` 列为已验证 Host。1.4.3 接受这些 Host 发出的 v4 会话格式。1.4.2 的导出实现不再携带会导致新版 Host 启动失败的依赖；已安装用户请先升级。版本变更见[更新日志](CHANGELOG.md)，其中包含 1.4.1 的英文名称统一与交互提示优化。
 
 ## 快速开始
 
@@ -139,10 +139,12 @@ dsh plugin --profile web update dsh-archived-chats
 
 ```sh
 npm test
+npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
+node scripts/run-native-integration.mjs
 npm pack --dry-run --json
 ```
 
-测试覆盖 Host 与浏览器行为、导出导入、快照恢复、回收站、保留策略、全文搜索、响应式布局、公开类型、包内容和仓库卫生。测试只使用隔离临时数据，不读取真实会话。
+测试覆盖 Host 与浏览器行为、导出导入、快照恢复、回收站、保留策略、全文搜索、响应式布局、公开类型、包内容和仓库卫生。原生集成命令会安装锁定的 `@deepseek-ai/dsh-session@0.1.7-rc.2` fixture，并要求五个原生往返用例全部执行且不能跳过。所有检查只使用隔离临时数据，不读取真实会话。
 
 ## 卸载
 

package/docs/ARCHITECTURE.en.md

@@ -2,7 +2,7 @@
 
 English · [中文](ARCHITECTURE.md) · [User guide](USER_GUIDE.md)
 
-This document follows `main`, covering 1.4.2 behavior, which switches export ZIP generation to `fflate`; see the [changelog](../CHANGELOG.md) for release history. Runtime code is the authority for interfaces and behavior; user-facing documentation should agree with it.
+This document follows `main`, covering 1.4.4 behavior, whose runtime code is unchanged from 1.4.3 (1.4.3 accepts the v4 session format in the persistence compatibility layer, 1.4.2 switched export ZIP generation to `fflate`); see the [changelog](../CHANGELOG.md) for release history. Runtime code is the authority for interfaces and behavior; user-facing documentation should agree with it.
 
 ## Product boundary and modules
 
@@ -208,8 +208,12 @@ Tests cover retained modules: export/import rollback, snapshots/recycle states,
 
 ```sh
 npm test
+npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
+node scripts/run-native-integration.mjs
 npm pack --dry-run --json
 git diff --check
 ```
 
+The native commands install the locked `@deepseek-ai/dsh-session@0.1.7-rc.2` fixture and require all five native round-trip cases to run without skips. This is the local equivalent of the mandatory native Host integration gate in CI.
+
 The declared DSH `>=0.1.0-rc.7` range remains capability-based. Release automation passed Node.js 18 on Ubuntu and Node.js 24 on Ubuntu, macOS, and Windows; the Node.js 24 matrix required the official Host backend integration (5/5) and package checks. The installed 1.4.0 artifact also passed the official native round trip (5/5) against `@deepseek-ai/dsh-session@0.1.5-rc.2`. Existing screenshots are from v1.3.1 and include retired snapshot UI; they remain historical examples rather than current behavior documentation.

package/docs/ARCHITECTURE.md

@@ -2,7 +2,7 @@
 
 [English](ARCHITECTURE.en.md) · 中文 · [用户指南](USER_GUIDE.zh-CN.md)
 
-本文跟随 `main` 分支，功能对应 1.4.2，该版本改用 `fflate` 生成导出 ZIP；版本变更见[更新日志](../CHANGELOG.md)。运行时代码是接口与行为的依据；用户操作说明与本文应保持一致。
+本文跟随 `main` 分支，功能对应 1.4.4，其运行时代码与 1.4.3 相同（1.4.3 在持久化兼容层接受 v4 会话格式，1.4.2 改用 `fflate` 生成导出 ZIP）；版本变更见[更新日志](../CHANGELOG.md)。运行时代码是接口与行为的依据；用户操作说明与本文应保持一致。
 
 ## 产品边界与模块
 
@@ -208,8 +208,12 @@ apply 只接受凭据，不接受调用方增补会话 ID。每条执行前在
 
 ```sh
 npm test
+npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
+node scripts/run-native-integration.mjs
 npm pack --dry-run --json
 git diff --check
 ```
 
+原生集成命令会安装锁定的 `@deepseek-ai/dsh-session@0.1.7-rc.2` fixture，并要求五个原生往返用例全部执行且不能跳过；这是 CI 强制原生 Host 集成门禁的本地等价检查。
+
 声明的 DSH `>=0.1.0-rc.7` 范围仍以 Host 公开能力为准。发布自动化已通过 Ubuntu 上的 Node.js 18，以及 Ubuntu、macOS 和 Windows 上的 Node.js 24；Node.js 24 矩阵强制运行官方 Host 后端集成（5/5）与打包检查。已安装的 1.4.0 产物也已在 `@deepseek-ai/dsh-session@0.1.5-rc.2` 上通过官方 native 闭环（5/5）。现有截图来自 v1.3.1，含退役快照界面；它们仍是历史示例，不作为当前行为说明。

package/docs/USER_GUIDE.md

@@ -2,7 +2,7 @@
 
 English · [简体中文](USER_GUIDE.zh-CN.md) · [Back to README](../README.md)
 
-Archive Management provides a place to browse and manage DSH's archived chats, plus workspace bulk archiving. This document follows the `main` branch. This guide targets 1.4.2, whose export writer no longer carries a dependency that prevents startup on newer Hosts. See the [changelog](../CHANGELOG.md) for release history, including 1.4.1's English rename and feedback improvements. For interfaces and data formats, see the [architecture](ARCHITECTURE.en.md).
+Archive Management provides a place to browse and manage DSH's archived chats, plus workspace bulk archiving. This document follows the `main` branch. This guide targets 1.4.4, whose runtime code is unchanged from 1.4.3; package metadata now lists DSH `0.1.7-rc.2` among the verified Hosts. 1.4.3 accepts the v4 session format those Hosts publish. The 1.4.2 export writer no longer carries a dependency that prevents startup on newer Hosts. See the [changelog](../CHANGELOG.md) for release history, including 1.4.1's English rename and feedback improvements. For interfaces and data formats, see the [architecture](ARCHITECTURE.en.md).
 
 ## Understand the three locations
 

package/docs/USER_GUIDE.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](USER_GUIDE.md) · 简体中文 · [返回 README](../README.zh-CN.md)
 
-归档管理为 DSH 已归档聊天提供查看和管理页面，并扩展按工作区批量归档。本文跟随 `main` 分支维护。本文适用于 1.4.2，其导出实现不再携带会导致新版 Host 启动失败的依赖；已安装用户请先升级。版本变更见[更新日志](../CHANGELOG.md)，其中包含 1.4.1 的英文名称统一与交互提示优化。接口和数据格式见[架构说明](ARCHITECTURE.md)。
+归档管理为 DSH 已归档聊天提供查看和管理页面，并扩展按工作区批量归档。本文跟随 `main` 分支维护。本文适用于 1.4.4，其运行时代码与 1.4.3 相同；包元数据现将 DSH `0.1.7-rc.2` 列为已验证 Host。1.4.3 接受这些 Host 发出的 v4 会话格式。1.4.2 的导出实现不再携带会导致新版 Host 启动失败的依赖；已安装用户请先升级。版本变更见[更新日志](../CHANGELOG.md)，其中包含 1.4.1 的英文名称统一与交互提示优化。接口和数据格式见[架构说明](ARCHITECTURE.md)。
 
 ## 先理解三个位置
 

package/lib/persistence-compat.js

@@ -10,7 +10,7 @@ function objectLike(value) {
 
 function validatedHeader(value, expectedId) {
   if (!objectLike(value)
-    || (value.version !== 2 && value.version !== 3)
+    || (value.version !== 2 && value.version !== 3 && value.version !== 4)
     || typeof value.id !== 'string'
     || value.id === ''
     || (expectedId !== undefined && value.id !== expectedId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-archived-chats",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "查看、搜索和恢复已归档会话，支持按工作区批量归档、备份导入导出与回收站管理。",
   "license": "MIT",
   "author": "Ultronen",
@@ -96,7 +96,7 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-session": ">=0.1.0-rc.7 <0.1.1-0 || >=0.1.1-rc.1 <0.1.2-0 || >=0.1.2-alpha.1 <0.2.0-0 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.7 <0.1.1-0 || >=0.1.1-rc.1 <0.1.2-0 || >=0.1.2-alpha.1 <0.2.0-0 || 0.1.5-rc.2 || 0.1.7-rc.2",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
@@ -108,7 +108,7 @@
     "fflate": "^0.8.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
     "typescript": "^5.9.3"
   }
 }