dsh-archived-chats 1.7.1 → 2.0.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@
 
 Entries describe behavior at each release, not necessarily current behavior. Consult the READMEs and user guides for current usage.
 
+## 2.0.0 — 2026-11-07
+
+### 中文
+
+- 最低宿主版本提高至 DeepSeek Harness `0.2.2-rc.1`。旧宿主请先升级 Harness，再安装新版插件；暂不升级宿主时可继续使用插件 `1.7.1`。
+- 同步官方 Session 与 Cordis 开发基线，原生集成 CI 统一使用官方 `0.2.2-rc.1` 后端，在 macOS、Windows 和 Linux 上验证。更新兼容声明、安装指引和市场信息。
+
+### English
+
+- Raise the minimum Host version to DeepSeek Harness `0.2.2-rc.1`. Upgrade Harness before installing this plugin release on older Hosts, or keep plugin `1.7.1` until the Host is upgraded.
+- Align official Session and Cordis development dependencies. Run native integration CI against the official `0.2.2-rc.1` backend on macOS, Windows and Linux, with matching compatibility declarations, installation guidance and catalog information.
+
 ## 1.7.1 — 2026-11-07
 
 ### 中文

package/README.md

@@ -35,7 +35,7 @@ Archive Management adds conversation search, organization and backups to DeepSee
 - **Portable backups:** export and import JSON + Markdown ZIPs; imports preview before writing and skip existing IDs to avoid overwrites.
 - **Conversation lineage:** read-only Origins & Branches view traces sources, forks and subagent relationships across all workspaces, including archived and unarchived chats.
 
-> This document describes version 1.7.1. Previous recovery features are removed, with explicit retries for permanent-deletion tasks.
+> This document describes version 2.0.0. Previous recovery features are removed, with explicit retries for permanent-deletion tasks.
 
 ## Install and open
 
@@ -94,7 +94,7 @@ Installing an older release can restore its earlier cleanup rules. Before downgr
 
 ## Compatibility
 
-The declared range is DSH `>=0.1.0-rc.7 || 0.2.2-rc.1`; features still depend on Host capabilities. Native integration tests cover official `0.1.7-rc.2`, `0.2.1-rc.2`, `0.2.1-rc.5` and `0.2.2-rc.1` backends; CI runs the Host matrix on macOS, Windows and Linux.
+Requires DeepSeek Harness `0.2.2-rc.1` or later (`>=0.2.2-rc.1`). Upgrade Harness before updating the plugin on older Hosts, or keep plugin `1.7.1`. CI runs native integration tests against the official `0.2.2-rc.1` backend on macOS, Windows and Linux.
 
 Archive, unarchive and inventory use official capabilities. Permanent deletion coordinates Host session lifecycle and storage locations rather than calling one unified public deletion API. See [compatibility and limits](docs/USER_GUIDE.md#compatibility-and-limits).
 
@@ -149,12 +149,6 @@ Use [Discussions](https://github.com/Ultroncn/dsh-archived-chats/discussions) fo
 
 ```sh
 npm test
-npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs
-npm ci --prefix test/fixtures/native-host-0.2.1 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1
-npm ci --prefix test/fixtures/native-host-0.2.1-rc.5 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1-rc.5
 npm install --prefix test/fixtures/native-host-0.2.2-rc.1 --ignore-scripts --include=optional --package-lock=true
 node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.2-rc.1
 npm pack --dry-run --json

package/README.zh-CN.md

@@ -33,7 +33,7 @@
 - **可迁移备份：** 导出和导入 JSON + Markdown ZIP；导入前预览，跳过已有 ID，不覆盖现有数据。
 - **会话溯源：** 只读的「来源与分支」视图查看所有工作区中已归档、未归档会话的来源、分叉和子代理关系。
 
-> 本文描述 1.7.1，旧恢复功能已移除，永久删除支持任务重试。
+> 本文描述 2.0.0，旧恢复功能已移除，永久删除支持任务重试。
 
 ## 安装与打开
 
@@ -92,7 +92,7 @@ dsh plugin --profile web update dsh-archived-chats
 
 ## 兼容性
 
-声明范围为 DSH `>=0.1.0-rc.7 || 0.2.2-rc.1`，具体能力仍取决于 Host。原生集成测试覆盖官方 `0.1.7-rc.2`、`0.2.1-rc.2`、`0.2.1-rc.5` 与 `0.2.2-rc.1` 后端；CI 在 macOS、Windows 和 Linux 上运行 Host 测试矩阵。
+最低要求 DeepSeek Harness `0.2.2-rc.1`（声明 `>=0.2.2-rc.1`）。旧宿主请先升级 Harness，再更新插件；旧宿主可继续使用插件 `1.7.1`。CI 在 macOS、Windows 和 Linux 上运行官方 `0.2.2-rc.1` 后端集成测试。
 
 归档、取消归档、列表读取以官方能力为基础。永久删除由插件协调会话生命周期和存储位置完成，并非调用一个官方统一删除接口。详见[兼容性与限制](docs/USER_GUIDE.zh-CN.md#兼容性与限制)。
 
@@ -147,12 +147,6 @@ 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 ci --prefix test/fixtures/native-host-0.2.1 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1
-npm ci --prefix test/fixtures/native-host-0.2.1-rc.5 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1-rc.5
 npm install --prefix test/fixtures/native-host-0.2.2-rc.1 --ignore-scripts --include=optional --package-lock=true
 node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.2-rc.1
 npm pack --dry-run --json

package/docs/ARCHITECTURE.en.md

@@ -2,7 +2,7 @@
 
 English · [中文](ARCHITECTURE.md) · [User guide](USER_GUIDE.md)
 
-This document describes the interfaces and behavior of version 1.7.0. Native integration tests cover DSH `0.1.7-rc.2`, `0.2.1-rc.2`, `0.2.1-rc.5` and `0.2.2-rc.1`. 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 describes the interfaces and behavior of version 2.0.0. Native integration tests cover DSH `0.2.2-rc.1`. See the [changelog](../CHANGELOG.md) for release history. Runtime code is the authority for interfaces and behavior; user-facing documentation should agree with it.
 
 The client capability-detects public UI primitives. `HostModal` uses the official headless Modal for complex business content. Ordinary `ConfirmDialog` uses its heading, description and footer. `ControlButton` and `ControlInput` forward refs, disabled state and editing events. Older Hosts retain HTML fallbacks. Native controls use separate styling classes so legacy button CSS cannot override their sizing, colors or hover states. Menus retain filter placement and scrolling constraints; preview content stays within the outer modal bounds. Native modals own focus layering, with document-level legacy traps registered only in compatibility mode. Plugin-owned portals belong to the archive interaction so clicks inside a dialog cannot prematurely release settings protection.
 
@@ -175,16 +175,12 @@ Tests cover retained modules: export/import rollback, deletion-task states, inte
 
 ```sh
 npm test
-npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs
-npm ci --prefix test/fixtures/native-host-0.2.1 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1
-npm ci --prefix test/fixtures/native-host-0.2.1-rc.5 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1-rc.5
+npm install --prefix test/fixtures/native-host-0.2.2-rc.1 --ignore-scripts --include=optional --package-lock=true
+node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.2-rc.1
 npm pack --dry-run --json
 git diff --check
 ```
 
-The native commands install the locked `@deepseek-ai/dsh-session@0.1.7-rc.2`, `0.2.1-rc.2` and `0.2.1-rc.5` fixtures and require all nine native integration cases to run without skips for each fixture. This is the local equivalent of the mandatory native Host integration gate in CI.
+The native commands install the exact official `0.2.2-rc.1` fixture and require all nine integration cases to run without skips, matching the mandatory Host integration gate in CI.
 
-The declared DSH `>=0.1.0-rc.7` range remains capability-based. Release automation tests Node.js 18 on Ubuntu and Node.js 24 on Ubuntu, macOS, and Windows; the Node.js 24 matrix requires all three official Host backend fixtures, `@deepseek-ai/dsh-session@0.1.7-rc.2`, `0.2.1-rc.2` and `0.2.1-rc.5`, on all three platforms (9/9 each), along with package checks, including the v4 session format. The [screenshots](../screenshots.json) show the current interface with synthetic example chats.
+Requires DSH `0.2.2-rc.1` or later, declared as `>=0.2.2-rc.1`. Release automation runs unit tests on Node.js 18 on Ubuntu and requires all nine integration cases against the official `0.2.2-rc.1` backend on Node.js 24 on Ubuntu, macOS and Windows, plus package checks. The [screenshots](../screenshots.json) show the current interface with synthetic example chats.

package/docs/ARCHITECTURE.md

@@ -2,7 +2,7 @@
 
 [English](ARCHITECTURE.en.md) · 中文 · [用户指南](USER_GUIDE.zh-CN.md)
 
-本文描述 1.7.0 的接口与行为；原生集成测试覆盖 DSH `0.1.7-rc.2`、`0.2.1-rc.2`、`0.2.1-rc.5` 和 `0.2.2-rc.1`。版本变更见[更新日志](../CHANGELOG.md)。运行时代码是接口与行为的依据；用户操作说明与本文应保持一致。
+本文描述 2.0.0 的接口与行为；原生集成测试覆盖 DSH `0.2.2-rc.1`。版本变更见[更新日志](../CHANGELOG.md)。运行时代码是接口与行为的依据；用户操作说明与本文应保持一致。
 
 客户端通过能力探测复用公开 UI primitives。`HostModal` 为复杂业务内容使用官方无头 Modal，普通 `ConfirmDialog` 直接使用 Modal 的标题、说明及 footer；`ControlButton` 与 `ControlInput` 透传 ref、禁用状态和编辑事件。旧 Host 保留 HTML 兼容入口。原生按钮使用独立样式类，避免旧按钮 CSS 覆盖官方尺寸、颜色和悬停。菜单保留筛选定位与滚动约束，预览内容限制在外层弹窗边界内。原生弹窗拥有焦点层，旧文档级焦点陷阱仅在兼容模式注册。带插件归属标记的 portal 计入归档交互范围，避免设置保护被弹窗内点击提前解除。
 
@@ -176,18 +176,14 @@ apply 只接受凭据，不接受调用方增补会话 ID。每条执行前在
 
 ```sh
 npm test
-npm ci --prefix test/fixtures/native-host --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs
-npm ci --prefix test/fixtures/native-host-0.2.1 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1
-npm ci --prefix test/fixtures/native-host-0.2.1-rc.5 --ignore-scripts --include=optional
-node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.1-rc.5
+npm install --prefix test/fixtures/native-host-0.2.2-rc.1 --ignore-scripts --include=optional --package-lock=true
+node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host-0.2.2-rc.1
 npm pack --dry-run --json
 git diff --check
 ```
 
-原生集成命令会分别安装锁定的 `@deepseek-ai/dsh-session@0.1.7-rc.2`、`0.2.1-rc.2` 和 `0.2.1-rc.5` fixtures，每套都要求九个原生集成用例全部执行且不能跳过；这是 CI 强制原生 Host 集成门禁的本地等价检查。
+原生集成命令安装版本固定的官方 `0.2.2-rc.1` fixture，要求九个用例全部执行且不能跳过，对应 CI 的强制 Host 集成门禁。
 
-声明的 DSH `>=0.1.0-rc.7` 范围仍以 Host 公开能力为准。发布自动化在 Ubuntu 上测试 Node.js 18，并在 Ubuntu、macOS 和 Windows 上测试 Node.js 24；Node.js 24 矩阵在三个平台上分别强制运行基于官方 `@deepseek-ai/dsh-session@0.1.7-rc.2`、`0.2.1-rc.2` 和 `0.2.1-rc.5` 的三套 Host 后端集成（每套 9/9）与打包检查，覆盖 v4 会话格式。[截图](../screenshots.json)使用虚构示例聊天展示当前界面。
+最低要求 DSH `0.2.2-rc.1`，声明范围为 `>=0.2.2-rc.1`。发布自动化在 Ubuntu 上运行 Node.js 18 单元测试，并在 Ubuntu、macOS 和 Windows 上使用 Node.js 24 强制执行官方 `0.2.2-rc.1` 后端的九项集成用例与打包检查。[截图](../screenshots.json)使用虚构示例聊天展示当前界面。
 
 永久删除在最终读取子代理关系前先取消并释放活动代理。完整后代集合以可选 `cascadeSessionIds` 保存到父会话的 `purge-pending` 记录；父目录消失后也保留该记录，直到所有子代理清理完成。用户明确重试时据此恢复级联，不跨越分叉或已有独立删除任务的子树。待重试记录清空前不要降级到不支持此字段的版本。

package/docs/USER_GUIDE.md

@@ -4,7 +4,7 @@ Current source removes the previous recovery UI and keeps explicit permanent-del
 
 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 describes version 1.7.0, with native integration coverage for DSH `0.1.7-rc.2`, `0.2.1-rc.2`, `0.2.1-rc.5` and `0.2.2-rc.1`. See the [changelog](../CHANGELOG.md) for release history. 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 describes version 2.0.0, with native integration coverage for DSH `0.2.2-rc.1`. See the [changelog](../CHANGELOG.md) for release history. For interfaces and data formats, see the [architecture](ARCHITECTURE.en.md).
 
 Archive Management prefers the Host’s public Modal, Button, Input, menu, Tooltip, and icon components. Search fields follow the built-in plugin inventory’s 36px height, search icon, and focus styles. Ordinary text fields use the public Input. Confirmations use the official heading, description, and action areas. Complex preview and import content use the official modal frame. Older Hosts without these exports use compatible controls. Page headings, descriptions, secondary list text, and focus states follow the official settings typography and theme variables.
 
@@ -191,6 +191,8 @@ Local link:/file: installations are labeled Local checkout, offer Copy local pat
 
 ## Upgrades
 
+Version 2.0.0 requires DeepSeek Harness `0.2.2-rc.1` or later. Upgrade Harness before updating the plugin on older Hosts, or keep plugin `1.7.1`. The official update API checks compatibility before replacing the plugin and rejects incompatible versions.
+
 Upgrades preserve archives, tags, notes, and pending permanent-deletion tasks. Previous recovery records and protection snapshots remain on disk without the previous recovery actions. Host compatibility follows the package declaration and native integration coverage.
 
 ## Compatibility and limits
@@ -199,7 +201,7 @@ Upgrades preserve archives, tags, notes, and pending permanent-deletion tasks. P
 
 Features depend on public Host capabilities, not just a version number:
 
-The declared DSH `>=0.1.0-rc.7` range remains capability-based. Release automation tests Node.js 18 on Ubuntu and Node.js 24 on Ubuntu, macOS, and Windows; the Node.js 24 matrix requires all three pinned official Host backends, `@deepseek-ai/dsh-session@0.1.7-rc.2`, `0.2.1-rc.2` and `0.2.1-rc.5` (nine integration cases each) and package checks, including the v4 session format.
+Requires DSH `0.2.2-rc.1` or later, declared as `>=0.2.2-rc.1`. Release automation runs unit tests on Node.js 18 on Ubuntu and requires all nine integration cases against the official `0.2.2-rc.1` backend on Node.js 24 on Ubuntu, macOS and Windows, plus package checks.
 
 ## Local data and uninstall
 

package/docs/USER_GUIDE.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](USER_GUIDE.md) · 简体中文 · [返回 README](../README.zh-CN.md)
 
-归档管理为 DSH 已归档聊天提供查看和管理页面，并扩展按工作区批量归档。本文描述 1.7.0行为（包含未归档正文搜索），原生集成测试覆盖 DSH `0.1.7-rc.2`、`0.2.1-rc.2`、`0.2.1-rc.5` 和 `0.2.2-rc.1`。版本变更见[更新日志](../CHANGELOG.md)，接口和数据格式见[架构说明](ARCHITECTURE.md)。
+归档管理为 DSH 已归档聊天提供查看和管理页面，并扩展按工作区批量归档。本文描述 2.0.0 的行为（包含未归档正文搜索），原生集成测试覆盖 DSH `0.2.2-rc.1`。版本变更见[更新日志](../CHANGELOG.md)，接口和数据格式见[架构说明](ARCHITECTURE.md)。
 
 归档管理优先复用宿主公开的 Modal、Button、Input、菜单、Tooltip 和图标组件。搜索框采用内置插件页面的 36px 高度、搜索图标和焦点样式，普通文本输入使用公开 Input。确认弹窗的标题、正文和操作区使用官方组件，复杂预览和导入内容使用官方弹窗框架；缺少相应导出的旧 Host 使用兼容样式。页面标题、说明、列表次要文字和焦点状态采用官方设置页的文字层级与主题变量。
 
@@ -191,6 +191,8 @@ JSON 是机器可读记录，Markdown 是可读副本。新版 Host 导出 ZIP v
 
 ## 升级
 
+从 2.0.0 起，最低宿主版本为 DeepSeek Harness `0.2.2-rc.1`。旧宿主请先升级 Harness，再更新插件；暂不升级宿主时可保留插件 `1.7.1`。官方更新接口在替换前检查兼容性，不兼容时会拒绝更新。
+
 升级保留已有归档、标签备注及待完成删除任务。旧恢复记录和保护快照文件留在磁盘，当前版本不再提供旧恢复操作。Host 兼容范围由包声明与原生集成测试确定。
 
 ## 兼容性与限制
@@ -199,7 +201,7 @@ JSON 是机器可读记录，Markdown 是可读副本。新版 Host 导出 ZIP v
 
 功能取决于 Host 公开能力，不仅取决于版本号：
 
-声明的 DSH `>=0.1.0-rc.7` 范围仍表达基于 Host 公开能力的兼容性。发布自动化在 Ubuntu 上测试 Node.js 18，并在 Ubuntu、macOS 和 Windows 上测试 Node.js 24；Node.js 24 矩阵强制运行官方 `@deepseek-ai/dsh-session@0.1.7-rc.2`、`0.2.1-rc.2` 和 `0.2.1-rc.5` 三套锁定 Host 后端集成（各 9 项）与打包检查，覆盖 v4 会话格式。
+最低要求 DSH `0.2.2-rc.1`，声明范围为 `>=0.2.2-rc.1`。发布自动化在 Ubuntu 上运行 Node.js 18 单元测试，并在 Ubuntu、macOS 和 Windows 上使用 Node.js 24 强制执行官方 `0.2.2-rc.1` 后端的九项集成用例与打包检查。
 
 ## 本地数据与卸载
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-archived-chats",
-  "version": "1.7.1",
+  "version": "2.0.0",
   "description": "查看、搜索和管理会话归档，支持工作区批量归档、标签备注、ZIP 备份和会话谱系。",
   "license": "MIT",
   "author": "Ultronen",
@@ -76,7 +76,7 @@
   ],
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.0-rc.7 || 0.2.2-rc.1"
+      "dsh": ">=0.2.2-rc.1"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -90,8 +90,8 @@
     }
   },
   "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 || 0.1.7-rc.2 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.5 || 0.2.2-rc.1",
+    "@deepseek-ai/cordis": "^4.1.0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-rc.1",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
@@ -103,7 +103,10 @@
     "fflate": "^0.8.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
     "typescript": "^5.9.3"
+  },
+  "overrides": {
+    "zod": "4.6.7"
   }
 }