dsh-archived-chats 1.5.3 → 1.6.0

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.6.0 — 2026-10-22
+
+### 中文
+
+- 兼容只有旧待删除标记、没有回收记录的会话：读取回收站时补齐待重试入口，不自动删除，也不撤销已提交的永久删除意图。
+- 修复旧回收记录恢复时将同一工作区的路径别名误判为 ID 冲突的问题；只有真实路径相同才允许恢复，不同或无法验证的路径仍拒绝。
+- 收拢归档管理入口：停止新增移入回收站，移除「空间与策略」。停止自动到期清理与启动快照清扫，保留旧回收记录、快照和策略文件；旧客户端的新增回收及策略请求返回 410。
+- 有旧回收记录时保留恢复、导出保护快照及确认永久删除；空回收站隐藏，读取异常时保留错误入口。未完成删除必须明确重试。保护快照 ZIP 包含会话与图片，单条上限 64 MiB，不能通过普通会话备份导入器导入。
+- 统一已归档、未归档和来源与分支的搜索、筛选、工作区折叠及操作布局；未归档只提供归档操作。已归档和未归档默认按官方首页的「最近更新」逻辑排序，支持未分组和定时任务筛选。
+- 全文搜索按筛选后的候选分批执行，展示进度并支持停止、重试；不再只展示前 100 个匹配。点击摘要定位命中消息，自动展开包含工具或推理内容的折叠轮次。
+- 修复永久删除归档时官方侧栏短暂重新显示会话的问题：确认文件删除后通知客户端移除，在归档状态下清理工作区成员关系，失败保留可重试任务。单条预览只读取所选聊天，待删除会话不再参与预览或标题读取。
+- 关于页提供手动残留会话检查、失败重试、预览、备份及确认删除；进入页面不自动扫描。新增定时、页面恢复和联网后的更新检查，失败 15 分钟后重试。
+- 更新弹窗提供当前宿主对应的命令、安装信息复制和本地开发版保护；宿主允许时安装已展示的精确版本，完成后明确提示重启，不自动重启 DSH。
+- 同步中英文 README、用户指南、架构文档及八张界面截图。
+- 已知宿主限制：DSH 0.2.1-rc.2 在首次配置未完成时，归档当前会话可能触发引导并关闭设置弹窗。已向官方反馈 [#10596](https://github.com/deepseek-ai/deepseek-harness/discussions/10596)，本版不包含宿主修复。
+
+### English
+
+- Keep legacy pending-only deletions visible for explicit retry by recording them when the Recycle Bin is read, without automatically deleting data or reversing committed deletion intent.
+- Fix legacy recovery rejecting aliases of the same workspace directory as ID conflicts. Allow differing path strings only when both resolve to the same directory; retain rejection for different or unverifiable paths.
+- Simplify archive management: retire new Recycle Bin moves and Storage & Policy navigation. Disable automatic expiry and startup snapshot sweeping while retaining legacy records, snapshots and saved policies. Stale recycle/policy mutation requests return 410.
+- Keep recovery, protection-snapshot export and confirmed permanent deletion for legacy records. Hide an empty bin and retain its error view when the catalog cannot be read. Incomplete deletions require explicit retry. Protection-snapshot ZIPs include session data and images, are limited to 64 MiB per record, and cannot be imported by the ordinary conversation-backup importer.
+- Align search, filters, workspace folding and actions across Archived, Unarchived and Origin & Branches. Unarchived offers archive actions only. The two chat lists default to the official home page's Recently updated ordering and support Ungrouped and Scheduled tasks filters.
+- Search all filtered candidates in batches with progress, stop and retry controls instead of showing only the first 100 matches. Open matching messages from result snippets and expand folded turns containing tool or reasoning matches.
+- Prevent permanently deleted archived chats from briefly reappearing in the official sidebar: notify clients after file removal, detach workspace membership while still archived, and retain retryable tasks on cleanup failure. Preview only the selected chat and exclude pending deletions before preview or title reads.
+- Add manual residual-chat checks, retry, preview, backup and confirmed deletion to About; opening the page never starts a scan. Check for updates periodically, after visibility/network recovery, and retry failures after 15 minutes.
+- Provide host-specific update commands, copyable installation information and local-checkout protection. Where supported by the official plugin manager, install the exact reviewed version and report restart requirements without restarting DSH automatically.
+- Update both READMEs, user guides, architecture documents and all eight interface screenshots.
+- Known Host limitation: in DSH 0.2.1-rc.2, archiving the current chat while initial setup is incomplete can trigger onboarding and close Settings. Reported upstream in [#10596](https://github.com/deepseek-ai/deepseek-harness/discussions/10596); this release does not include a Host fix.
+
 ## 1.5.3 — 2026-10-21
 
 ### 中文

package/README.md

@@ -8,12 +8,12 @@
 
 <h1>Archive Management</h1>
 
-<p><strong>A local-first archived-chat center for DeepSeek Harness</strong></p>
+<p><strong>Find past DSH chats, manage archives, and keep ZIP backups.</strong></p>
 <p><code>dsh-archived-chats</code></p>
 
 <p>
   <a href="https://www.npmjs.com/package/dsh-archived-chats"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-archived-chats?style=flat-square"></a>
-  <a href="https://www.npmjs.com/package/dsh-archived-chats"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-archived-chats?style=flat-square"></a>
+  <a href="https://www.npmjs.com/package/dsh-archived-chats"><img alt="npm total downloads" src="https://img.shields.io/npm/dt/dsh-archived-chats?style=flat-square&amp;label=total%20downloads"></a>
   <a href="https://github.com/Ultronen/dsh-archived-chats/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/Ultronen/dsh-archived-chats/ci.yml?branch=main&amp;style=flat-square&amp;label=CI"></a>
   <a href="https://github.com/Ultronen/dsh-archived-chats/actions/workflows/ci.yml"><img alt="Node.js 18 and 24" src="https://img.shields.io/badge/Node.js-18%20%7C%2024-339933?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white"></a>
 </p>
@@ -28,130 +28,110 @@
 
 </div>
 
-Archive Management gives DeepSeek Harness a place to find chats hidden from the main chat area after archiving. It keeps DSH's single-chat archive workflow and adds workspace bulk archiving, search, preview, backup, and a workspace-based Recycle Bin workflow.
+Archive Management adds conversation search, organization and backups to DeepSeek Harness. Find a past solution, preview its context, archive by workspace, or save a ZIP before deleting a chat.
 
-> The English name is **Archive Management**, and the Chinese name is **归档管理**. The installation package remains `dsh-archived-chats`.
->
-> This document follows the `main` branch and targets 1.5.3. This release adds installation support and native integration coverage for DSH `0.2.1-rc.2` while retaining older Host support. See the [changelog](CHANGELOG.md) for release history.
+- **Find past work:** search titles, messages, tool results, tags and notes; open a match with surrounding context.
+- **Organize chats:** manage Archived and Unarchived, including workspace groups, ungrouped chats, bulk actions, tags and notes.
+- **Keep a backup:** export JSON + Markdown ZIPs; preview imports and skip existing IDs instead of overwriting them.
 
-## Quick start
+> This document describes 1.6.0. New recycle operations and automatic cleanup are retired; see [upgrading](#upgrading-from-older-releases) for existing data.
 
-Search for `dsh-archived-chats` in DSH's plugin market, verify the author is **Ultronen**, and choose **Install**. After installation, follow the host's restart instructions. The settings entry is **归档管理** in Chinese; in English it is **Archive Management**.
+## Install and open
 
-Alternatively, run this command on the computer running DSH:
+Find `dsh-archived-chats` in the DSH plugin market, verify author **Ultronen**, and install. Follow the host's restart prompt, then open **Settings → Archive Management** (Chinese: **设置 → 归档管理**).
+
+Alternatively, use the CLI. `web` is an example profile; replace it with your running DSH profile and use the same profile for updates and removal:
 
 ```sh
 dsh plugin --profile web add dsh-archived-chats@latest
 ```
 
-Restart DSH, then open **Settings → Archive Management** (Chinese: **设置 → 归档管理**).
-
-Before updating an older installation, read “Upgrading from older releases” below. To update:
+If installation reports `ERR_PNPM_ADDING_TO_ROOT`, add `-w` after `add`. To update:
 
 ```sh
 dsh plugin --profile web update dsh-archived-chats
 ```
 
-## What it does
-
-| Area | Current behavior |
-| --- | --- |
-| Browse and search | Workspace-grouped archived chats, full-text search, filters, sorting, tags, and notes. |
-| Workspace archiving | Unarchived offers individual, workspace-wide, and global archiving with aggregate confirmation; blank, active, or unreadable chats are skipped. |
-| Read-only preview | Conversations, reasoning, tool activity, Markdown, JSON, code, and readable stored images without unarchiving. |
-| Backup | Export one workspace or the entire archive as JSON + Markdown ZIP; preview imports and skip conflicting IDs. |
-| Recycle Bin | Move archived chats by workspace or selection; restore one chat, a workspace, or the entire Recycle Bin back to Archived. |
-| Permanent deletion | Delete one archived chat, a workspace's archive, or all archived chats after confirmation. Recycle Bin deletion is separate. |
-| Residual chat check | Entering Storage & Retention automatically checks for subagents whose parent no longer exists; search, select, preview, back up and confirm permanent deletion of selected records only. Empty chats are excluded. |
-| Storage and relationships | Storage accounting, optional automatic Recycle Bin cleanup, and read-only Origins & Branches. |
-
-The six views are **Archived**, **Unarchived**, **Recycle Bin**, **Storage & Retention**, **Origins & Branches**, and **About**. Unarchived shares Archived’s search, filters, and workspace-group layout, offering read-only chat previews and individual, workspace-wide, and global archiving. Archiving does not create historical versions; Recycle Bin protection snapshots support recovery, not a browsable version-history library.
-
-## Screenshots
+## First task
 
-These screenshots show the current interface with synthetic example chats; they contain no private conversations. The [marketplace screenshot list](screenshots.json) uses the same files in the same order.
-
-1. [Archived chats](assets/screenshots/preview-01.png)
-2. [Full-text search and selected actions](assets/screenshots/preview-02.png)
-3. [Unarchived and workspace archiving](assets/screenshots/preview-03.png)
-4. [Read-only preview](assets/screenshots/preview-04.png)
-5. [Recycle Bin](assets/screenshots/preview-05.png)
-6. [Restore confirmation](assets/screenshots/preview-06.png)
-7. [Storage & Retention](assets/screenshots/preview-07.png)
-8. [Origins & Branches](assets/screenshots/preview-08.png)
+1. Open **Unarchived**, click a chat title to preview it, then archive the chat you want to keep. Blank new chats are excluded; running chats require explicit **Stop and archive** confirmation.
+2. Search **Archived**, open a title or matching snippet, and edit tags and notes from the preview.
+3. Choose **Select**, check chats, and choose **Export selected**; narrow layouts place this action in the three-dot menu. Verify the ZIP in browser downloads.
+4. **Unarchive** to continue chatting. Before deleting, decide whether to keep a backup: deletion is permanent and cannot be undone.
 
-The Archived header has **Select** and **More**. More contains Import backup, Export all, Unarchive all, Move all to Recycle Bin, then Delete all after a separator. The Recycle Bin header directly shows **Restore all** and **Empty Recycle Bin** without a More menu. Recycle rows retain the preview icon and use compact **Restore** and **Delete** text buttons. Workspace and global restoration separately confirm scope, counts, and the Archived destination, skipping pending deletions. Empty Recycle Bin still requires irreversible-action confirmation. The header keeps consistent dimensions across tabs. Workspace actions and global export, unarchive, and deletion ask you to confirm the complete archive scope and chat count.
+## Pages and capabilities
 
-**About** shows the running version, author, license, guides, project and feedback links, and Check for updates. Opening the page checks public npm version metadata in the background, at most once every 12 hours during a running backend session; failures never block archive management. A newer version adds a **Get update** link beside the title, opening the plugin market without installing or restarting anything. Follow the host's restart guidance when convenient; a browser refresh alone may not load an updated backend. No chat or backup content is sent during update checks.
+| Page | Purpose |
+| --- | --- |
+| Archived | Search, filter, preview, tags and notes, import/export, unarchive and confirmed permanent deletion. |
+| Unarchived | Ordinary workspace and ungrouped chats, preview, individual/workspace/global archiving. |
+| Origins & Branches | Read-only sources, forks and subagents related to archived chats. |
+| About | Automatic update checks, host and local-checkout detection, copyable installation details, host-supported updates, and manual residual-chat checks. |
+| Recycle Bin, when records exist | Recover legacy records to Archived, export protection snapshots, or confirm permanent deletion; hidden when empty. |
 
-Preview keeps real user messages on the right and the assistant's work on the left. Fully loaded, completed turns group intermediate work into a collapsed process disclosure, with the final response outside it. Partial turns remain in event order. After updating, reload the DSH backend to use the new preview projection; refreshing the browser alone is insufficient.
+Content search starts at two characters and scans the selected scope in batches, showing progress, matches and failures; it supports Stop and Retry. Unarchived searches titles or session IDs. See the [user guide](docs/USER_GUIDE.md) for scope, long-log limits and detailed operations.
 
-## Archive, recycle, or delete?
+## Archive, delete and maintain
 
-- **Archive:** retain a chat outside the main chat area. Unarchive returns it there.
-- **Move to Recycle Bin:** available through workspace menus, header More → Move all to Recycle Bin, or More in selection mode. Recovery returns the chat to Archived; Unarchive then returns it to the main chat area.
-- **Delete all on Archived:** permanently delete archived chats across all workspaces, not existing Recycle Bin entries.
-- **Empty Recycle Bin:** permanently delete recycled chats and their associated protection data.
+**Archive organizes; Delete permanently removes.** Archive and unarchive use official Host operations. Row deletion, selected deletion, workspace Delete all and global Delete all require confirmation. Workspace deletion never deletes project directories. Search and filters do not narrow workspace or global bulk actions.
 
-Choose Select to check one or more chats, then Unarchive or Delete permanently. More contains Export selected and Move to Recycle Bin. Select all checks only current search/filter results; hidden selections remain selected with a visible count. Cancel exits and clears the selection. Ordinary rows have no export or recycle buttons. Workspace and global actions include chats hidden by filters. Workspace actions do not delete workspace/project directories. See the [action scope table](docs/USER_GUIDE.md#actions-and-their-scope) before bulk operations.
+**Residual checks are manual maintenance.** Open **About → Maintenance → Check residual chats** to inspect subagents with an explicit parent reference whose parent no longer exists. Preview or export first, then select and confirm permanent deletion; eligibility is rechecked at execution. Ungrouped chats, independent forks, ordinary unarchived chats and blank chats are excluded. Opening the page never scans or cleans automatically.
 
-Empty Recycle Bin acts only on the exact recycle-record incarnations shown at confirmation. Records added afterward are excluded; a changed target fails instead of widening the confirmed scope. A chat without a working directory remains in Archived because this Host cannot make it reachable from the main chat list; a missing workspace alone can still restore as ungrouped.
+## Backups and data boundaries
 
-## Data safety and limits
+| Format | Contents | Use |
+| --- | --- | --- |
+| Conversation backup ZIP | JSON, Markdown, tags, notes and attachment references; no attachment bytes or automatic descendant bundling. | Preview with Import backup, then restore; existing IDs are skipped. |
+| Legacy protection-snapshot ZIP | Legacy record, validated session payload and image attachments; 64 MiB per record. | Preserve legacy data; not accepted by the ordinary conversation importer. |
 
-- **Local only:** plugin state lives under `$DSH_HOME/plugin-data/archived-chats/`; the plugin does not upload or cloud-sync chats. Update checks request only public npm version metadata, without chat or backup content.
-- **Recovery before purge:** workspace Recycle Bin moves require a healthy protection snapshot. Direct permanent deletion does not create a recoverable copy.
-- **No overwrite:** imports skip existing IDs. Recycle recovery prefers the original; snapshot fallback recreates an ordinary session ID only through an explicitly exclusive Host writer and otherwise retains the recovery record.
-- **Durable deletion:** confirmed deletion tasks clean related snapshots before the original. Partial failures retain non-restorable tasks for retries while running or after restart.
-- **Automatic Recycle Bin cleanup is off by default:** enabling or shortening retention requires confirmation. It applies to expired recycled chats, not ordinary archived chats.
-- **ZIP is not an attachment-complete backup:** attachment references remain, but attachment bytes and automatic descendant-session bundling are excluded.
+Successful exports are validated against the same format and budgets as import before the download starts. This applies to ordinary conversation backups; protection snapshots use a separate format. A download-started notice does not confirm the file was saved; check browser downloads.
 
-Successful exports are validated against the same format and budgets as import before the download starts. The browser buffers a validated ZIP with a five-minute timeout and 320 MiB response cap; this limits response bytes, not peak browser memory. “Backup download started” does not mean the browser has saved the file to disk.
+- Data stays on the DSH host under `$DSH_HOME/plugin-data/archived-chats/`, defaulting to `~/.dsh/`. The plugin does not upload or cloud-sync chats.
+- Permanent deletion removes session and related plugin data, not all global Host attachments, caches or external backups. Failures retain retryable tasks.
+- A chat without a working directory remains in Archived; a missing workspace alone allows an ungrouped chat.
+- Empty Recycle Bin uses the exact recycle-record incarnations shown at confirmation; changed targets do not expand the deletion scope.
 
 ## Upgrading from older releases
 
-**Names and versions:** Version 1.4.2 changes the export writer only; the menu names below are unchanged. Version 1.4.1 uses Archive Management; 1.4.0 labels its English menu Session Archive. Both correspond to **归档管理** in Chinese and are the same plugin. The Chinese entry, package name, install command, and data location are unchanged. Update to 1.4.1 or later and restart DSH to load the renamed English entry.
+Version 1.6.0 disables new Move to Recycle Bin actions, removes Storage & Retention navigation, and stops automatic expiry and startup snapshot sweeping.
 
-The standalone History and cleanup-preview interfaces have been removed; do not use older screenshots to locate them.
+**Removing navigation does not migrate or delete existing data.** Legacy recycle records, snapshots and saved policies remain. Records keep the Recycle Bin visible; catalog read errors retain a retry view instead of being mistaken for an empty bin. Saved cleanup policies do not run, and incomplete permanent deletions require explicit retry.
 
-**Startup recovery removes old snapshots that are not referenced by current recycle records, including plugin-owned attachment copies. They are not placed in the Recycle Bin. This cleanup is independent of the optional Recycle Bin retention setting.**
+Recovery prefers an intact original and returns it to Archived. Missing-original snapshot recovery depends on Host capabilities; unsupported or invalid recovery keeps the record and reports failure. Export a protection snapshot to preserve data first. Never treat manually deleting plugin data as emptying the Recycle Bin.
 
-Referenced protection snapshots are kept. Removing an unreferenced snapshot does not delete its source chat; already-confirmed deletion retries and enabled retention cleanup are separate operations.
-
-If old snapshot content is still needed, recover/export it using a supporting older version before updating, preserve required attachments separately, or make an offline backup of the full plugin-data directory. Before downgrading, finish pending deletion tasks and back up data; older releases may not understand snapshotless pending-deletion records.
+Installing an older release can restore its earlier cleanup rules. Before downgrading, keep a full data backup and check pending tasks and format compatibility.
 
 ## Compatibility
 
-The package declares DSH `>=0.1.0-rc.7`; individual features depend on public Host capabilities.
+The declared range is DSH `>=0.1.0-rc.7`; features still depend on Host capabilities. Native tests use pinned `0.1.7-rc.2` and `0.2.1-rc.2` backends; release CI covers macOS, Windows and Linux.
 
-| Host capability | Dependency or limitation |
-| --- | --- |
-| Public archive API | Required for workspace bulk archiving; unsupported requests make no changes. |
-| Session and attachment reads | Used by preview/search; unavailable attachment reads degrade images only. |
-| Session-scoped physical location | Required for session-directory accounting and permanent deletion; shared directories are never used as purge targets. |
-| Public writer | Required for ZIP import and snapshot fallback; restoring an intact original does not rewrite its log. Plain legacy create/append is not enough for safe ZIP restore unless the provider explicitly guarantees exclusive creation. |
-| Modern handles | Fork titles, preview/search, and Recycle Bin moves are supported. ZIP v2 preserves inherited boundaries; import uses create/append/flush/close and a safe session-scoped rollback location. Ordinary v1 ZIPs remain readable, but ambiguous seeded v1 sources are refused rather than flattened. |
-| Host module resolution | DSH `0.1.6-alpha.2` added a resolution layer that fails on any dependency requesting a builtin name with a trailing slash. Before 1.4.2 this package reached `readable-stream@4` through `zip-stream`, so the plugin aborted Host startup as soon as it loaded. 1.4.2 uses `fflate` for export and no longer carries that chain; update before running on those Host versions. |
+Archive, unarchive and inventory use official capabilities. Permanent deletion coordinates Host session lifecycle and storage locations rather than calling one unified public deletion API. ZIP import and legacy snapshot recovery also have different writer requirements. See [compatibility and limits](docs/USER_GUIDE.md#compatibility-and-limits).
 
-Recycle Bin preview still depends on the original session; a missing original may prevent preview even when a protection snapshot can restore it. See [compatibility and limits](docs/USER_GUIDE.md#compatibility-and-limits).
+## Screenshots
 
-The declared 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 both pinned official Host backends, `@deepseek-ai/dsh-session@0.1.7-rc.2` and `0.2.1-rc.2` (eight integration cases each) and package checks, including the v4 session format.
+These 1.6.0 screenshots use synthetic example chats. The legacy Recycle Bin appears only when records exist; [screenshots.json](screenshots.json) owns the order.
 
-## Documentation
+<details>
+<summary>View screenshots</summary>
 
-| Resource | English | 简体中文 |
-| --- | --- | --- |
-| User guide | [Read the guide](docs/USER_GUIDE.md) | [查看指南](docs/USER_GUIDE.zh-CN.md) |
-| Architecture | [Maintainer architecture](docs/ARCHITECTURE.en.md) | [维护者架构](docs/ARCHITECTURE.md) |
-| Release history | [GitHub Releases](https://github.com/Ultronen/dsh-archived-chats/releases) | [GitHub Releases](https://github.com/Ultronen/dsh-archived-chats/releases) |
+1. [Archived chats](assets/screenshots/preview-01.png)
+2. [Full-text search and selected actions](assets/screenshots/preview-02.png)
+3. [Unarchived and workspace archiving](assets/screenshots/preview-03.png)
+4. [Conversation preview](assets/screenshots/preview-04.png)
+5. [Legacy Recycle Bin](assets/screenshots/preview-05.png)
+6. [Restore confirmation](assets/screenshots/preview-06.png)
+7. [About and manual maintenance](assets/screenshots/preview-07.png)
+8. [Origins & Branches](assets/screenshots/preview-08.png)
+
+</details>
 
-See also [Support](SUPPORT.md), [Security](SECURITY.md), [Contributing](CONTRIBUTING.md), [Code of Conduct](CODE_OF_CONDUCT.md), and [Discussions](https://github.com/Ultronen/dsh-archived-chats/discussions). Before claiming work or opening a pull request, contributors must read the [Contributing Guide](CONTRIBUTING.md) in full.
+## Documentation and feedback
 
-## Project status
+[User guide](docs/USER_GUIDE.md) · [Architecture](docs/ARCHITECTURE.en.md) · [Changelog](CHANGELOG.md) · [Support](SUPPORT.md) · [Contributing](CONTRIBUTING.md)
 
-Archive Management is actively maintained. The latest stable npm release receives fixes and security updates; older releases should be upgraded before reporting a problem. Reproducible bug reports and focused pull requests are welcome. Accepted community tasks are marked [`help wanted`](https://github.com/Ultronen/dsh-archived-chats/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22); read the [claim workflow](CONTRIBUTING.md#community-proposals-and-claims) before starting substantial work. Maintenance is performed as availability permits, so no fixed response or release schedule is promised.
+Use [Discussions](https://github.com/Ultronen/dsh-archived-chats/discussions) for questions and suggestions. Bug reports should include plugin and DSH versions, minimal reproduction steps and redacted errors. Report security issues [privately](SECURITY.md). If this helped you find past work, consider [giving the project a Star](https://github.com/Ultronen/dsh-archived-chats).
 
-## Development
+## Development and validation
 
 ```sh
 npm test
@@ -162,7 +142,7 @@ node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host
 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. The two native command pairs use the locked `@deepseek-ai/dsh-session@0.1.7-rc.2` and `0.2.1-rc.2` fixtures; each requires all eight native integration cases to run without skips. All checks use isolated temporary data and never read real sessions.
+Native checks use isolated temporary data; all eight tests in each fixture must run without skips. Read the [contribution guide](CONTRIBUTING.md) in full before contributing.
 
 ## Uninstall
 
@@ -170,8 +150,6 @@ The suite covers Host and browser behavior, export/import, snapshot fallback rec
 dsh plugin --profile web remove dsh-archived-chats
 ```
 
-Uninstalling removes only the plugin package and preserves `$DSH_HOME/plugin-data/archived-chats/`; it does not run a permanent purge. Reinstallation follows the installed version's startup recovery and cleanup rules, including unreferenced-snapshot cleanup. Back up needed data before uninstalling or manually removing plugin state. See [local data and uninstall](docs/USER_GUIDE.md#local-data-and-uninstall).
-
-## License
+Removing the package preserves plugin data and does not permanently purge chats. See [local data and uninstall](docs/USER_GUIDE.md#local-data-and-uninstall).
 
-[MIT](LICENSE)
+[MIT License](LICENSE)

package/README.zh-CN.md

@@ -6,12 +6,12 @@
 
 <h1>归档管理</h1>
 
-<p><strong>面向 DeepSeek Harness 的本地优先归档聊天中心</strong></p>
+<p><strong>找回 DSH 历史对话，搜索、管理归档并保存 ZIP 备份。</strong></p>
 <p><code>dsh-archived-chats</code></p>
 
 <p>
   <a href="https://www.npmjs.com/package/dsh-archived-chats"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-archived-chats?style=flat-square"></a>
-  <a href="https://www.npmjs.com/package/dsh-archived-chats"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-archived-chats?style=flat-square"></a>
+  <a href="https://www.npmjs.com/package/dsh-archived-chats"><img alt="npm 累计下载量" src="https://img.shields.io/npm/dt/dsh-archived-chats?style=flat-square&amp;label=total%20downloads"></a>
   <a href="https://github.com/Ultronen/dsh-archived-chats/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/Ultronen/dsh-archived-chats/ci.yml?branch=main&amp;style=flat-square&amp;label=CI"></a>
   <a href="https://github.com/Ultronen/dsh-archived-chats/actions/workflows/ci.yml"><img alt="Node.js 18 and 24" src="https://img.shields.io/badge/Node.js-18%20%7C%2024-339933?style=flat-square&amp;logo=nodedotjs&amp;logoColor=white"></a>
 </p>
@@ -26,130 +26,110 @@
 
 </div>
 
-归档管理为 DeepSeek Harness 中归档后从主页面会话区隐藏的聊天提供查看和管理入口。保留 DSH 原有单条归档方式，并扩展工作区批量归档、搜索、预览、备份及按工作区移入回收站的流程。
+归档管理为 DeepSeek Harness 补充会话查找、整理和备份能力。搜索过去的解决方案，直接预览内容，按工作区归档，或在删除前保存一份 ZIP 备份。
 
-> 中文名称为「归档管理」，英文名称为 Archive Management；安装包名始终为 `dsh-archived-chats`。
->
-> 本文跟随 `main` 分支维护，适用于 1.5.3。本版加入 DSH `0.2.1-rc.2` 安装兼容性与原生集成验证，并保留旧版支持。版本变更见[更新日志](CHANGELOG.md)。
+- **找回内容：** 搜索标题、正文、工具结果、标签和备注，点击命中片段查看上下文。
+- **整理会话：** 管理已归档和未归档聊天，支持工作区分组、未分组、批量操作及标签备注。
+- **保存备份：** 导出 JSON + Markdown ZIP，导入前预览并跳过已有会话，避免覆盖。
 
-## 快速开始
+> 本文对应 1.6.0。此版本停止新增回收和自动清理，旧数据的处理方式见[从旧版升级](#从旧版升级)。
 
-在 DSH 插件市场搜索 `dsh-archived-chats`，核对作者为 **Ultronen** 后点击「安装」。安装完成后按宿主提示重启 DSH，打开 **设置 → 归档管理**。
+## 安装与打开
 
-也可以在运行 DSH 的电脑上使用命令行安装：
+在 DSH 插件市场搜索 `dsh-archived-chats`，核对作者 **Ultronen** 后安装。按宿主提示重启，打开 **设置 → 归档管理**（英文为 Archive Management）。
+
+也可使用命令行。`web` 是示例 profile，请替换为实际运行 DSH 的 profile，更新和卸载也使用同一个：
 
 ```sh
 dsh plugin --profile web add dsh-archived-chats@latest
 ```
 
-重启 DSH，打开 **设置 → 归档管理**。
-
-旧版用户请先阅读下方「从旧版升级」，再执行更新：
+若提示 `ERR_PNPM_ADDING_TO_ROOT`，在 `add` 后加 `-w`。更新命令：
 
 ```sh
 dsh plugin --profile web update dsh-archived-chats
 ```
 
-## 核心能力
-
-| 范围 | 当前行为 |
-| --- | --- |
-| 浏览与搜索 | 按工作区浏览归档聊天，支持全文搜索、筛选、排序、标签与备注。 |
-| 工作区批量归档 | 未归档视图支持单条、工作区和全局归档，汇总确认后执行；跳过空白、正在使用或无法确认内容的聊天。 |
-| 只读预览 | 无需取消归档即可查看对话、思考、工具活动、Markdown、JSON、代码及可读取的已存储图片。 |
-| 备份 | 支持按工作区或全部归档导出 JSON + Markdown ZIP；导入先预览，跳过冲突 ID。 |
-| 回收站 | 按工作区或勾选聊天移入回收站；支持单条、工作区和整个回收站恢复到已归档。 |
-| 永久删除 | 确认后删除单条归档、工作区归档或全部归档；回收站删除独立操作。 |
-| 残留会话检查 | 进入空间与策略时自动检查父会话已不存在的子代理，支持明细搜索、多选、预览、备份及确认后永久删除；只删除选中项，不清理空会话。 |
-| 空间与关系 | 空间分账、可选的回收站自动清理，以及只读「来源与分支」。 |
-
-六个视图为 **已归档**、**未归档**、**回收站**、**空间与策略**、**来源与分支** 和 **关于**。未归档复用已归档的搜索、筛选和工作区分组排版，提供只读预览、单条归档、工作区全部归档和全局全部归档。归档不会创建历史版本；回收站保护快照仅用于恢复，不是可浏览的历史版本库。
+## 第一次使用
 
-## 界面截图
-
-以下截图使用虚构示例聊天展示当前界面，不含私人会话。[插件市场截图清单](screenshots.json)使用相同文件及顺序。
-
-1. [已归档聊天](assets/screenshots/preview-01.png)
-2. [全文搜索与选择操作](assets/screenshots/preview-02.png)
-3. [未归档与工作区归档](assets/screenshots/preview-03.png)
-4. [只读预览](assets/screenshots/preview-04.png)
-5. [回收站](assets/screenshots/preview-05.png)
-6. [恢复确认](assets/screenshots/preview-06.png)
-7. [空间与策略](assets/screenshots/preview-07.png)
-8. [来源与分支](assets/screenshots/preview-08.png)
+1. 打开 **未归档**，点击聊天标题预览，选择需要保留的聊天并归档。空白新聊天不列入可归档范围；正在执行的聊天需要先确认「停止并归档」。
+2. 在 **已归档** 搜索关键词，点击标题或命中片段查看内容；在预览中编辑标签和备注。
+3. 点击 **选择**，勾选聊天后 **导出选中**；窄屏下该操作位于三点菜单。到浏览器下载中确认 ZIP 已保存。
+4. 需要继续聊天时 **取消归档**。删除会话前先确认备份是否需要保留；删除为不可撤销的永久删除。
 
-已归档页顶部提供 **选择** 和 **更多**；未归档页顶部提供 **全部归档**，筛选行最右侧提供刷新图标；「更多」依次提供导入备份、全部导出、全部取消归档、全部移入回收站，分隔线后为全部删除。回收站顶部直接并列显示 **全部恢复** 和 **清空回收站**，不再设更多菜单；聊天行保留预览图标，使用紧凑的 **恢复** 和 **删除** 文字按钮。工作区恢复和全局恢复分别确认范围、数量及已归档去向，跳过正在永久删除的条目；清空仍须确认不可恢复的后果。各 Tab 顶部保持一致尺寸。工作区操作及全局导出、取消归档、删除均先确认完整归档范围和聊天数量。
+## 页面与能力
 
-「关于」展示当前运行版本、作者、许可证、指南、项目与反馈链接，提供「检查更新」。打开页面时后台查询公开 npm 版本信息，运行期间自动检查间隔至少 12 小时；失败不会阻断归档功能。有新版时标题旁显示「去更新」，打开插件市场，不自动安装或重启。更新后按宿主提示自行安排重启 DSH，仅刷新网页不一定能加载新版后端。
+| 页面 | 用途 |
+| --- | --- |
+| 已归档 | 搜索、筛选、预览、标签备注、导入导出、取消归档和确认永久删除。 |
+| 未归档 | 获取工作区及未分组中的普通聊天，预览并按单条、工作区或全局归档。 |
+| 来源与分支 | 查看与已归档聊天相关的来源、分叉和子代理关系；只读，不改变会话。 |
+| 关于 | 自动检查更新、运行环境与本地开发版识别、复制安装信息、宿主支持时一键更新，以及手动「检查残留会话」。 |
+| 回收站（有旧记录时） | 处理旧记录：恢复到已归档、导出保护快照或确认永久删除；空目录隐藏。 |
 
-预览中真实用户消息在右侧，AI 处理过程在左侧。完整加载且已结束的轮次将中间过程默认折叠，最终回复独立展示；未完整加载的轮次保留事件顺序。更新后需要重新加载 DSH 后端才能使用新版预览投影，仅刷新浏览器不够。
+正文搜索从两个字符开始，分批扫描当前筛选范围，展示进度、命中和失败数量；支持停止和重试。未归档搜索标题或会话 ID。完整范围、长日志限制及操作说明见[用户指南](docs/USER_GUIDE.zh-CN.md)。
 
-## 归档、回收与删除的区别
+## 归档、删除与维护
 
-- **归档：** 保留聊天，但从主页面会话区隐藏；取消归档后返回主页面。
-- **移入回收站：** 通过工作区菜单、顶部「更多 → 全部移入回收站」或选择模式的「更多」操作。恢复先回到已归档，再取消归档返回主页面。
-- **归档页「全部删除」：** 永久删除所有工作区的已归档聊天，不影响已经在回收站中的聊天。
-- **「清空回收站」：** 永久删除回收聊天及其关联保护数据。
+**归档用于整理，删除用于永久移除。** 归档和取消归档使用 Host 的官方操作。行内垃圾桶、选中删除、工作区全部删除和全局全部删除均需确认；工作区删除不会删除项目目录。搜索和筛选不会缩小工作区或全局操作范围。
 
-点击「选择」进入选择模式，可勾选一条或多条聊天后取消归档或永久删除；「更多」提供导出选中和移入回收站。「全选」只勾选当前搜索／筛选结果，隐藏的已选项保留并显示数量；「取消」退出并清空选择。普通列表不增加单条导出或移入回收站按钮。工作区和全部操作包含被筛选隐藏的聊天；工作区操作不会删除工作区或项目目录。批量操作前可查看[操作范围表](docs/USER_GUIDE.zh-CN.md#操作入口与范围)。
+**残留检查是手动维护工具。** 从 **关于 → 维护工具 → 检查残留会话** 打开，仅检查有明确父来源且父会话已不存在的子代理会话。可先预览或导出，再勾选确认永久删除；执行时重新核对范围。未分组、独立分叉、普通未归档和空白聊天不作为该工具的清理目标。进入页面不会自动扫描或清理。
 
-清空回收站只作用于确认时展示的精确回收记录实例。之后新增的记录不纳入本次操作；目标已变更时会失败，不会扩大已确认范围。没有工作目录的聊天会留在已归档，因为当前 Host 无法让它在主聊天列表中可达；仅缺少工作区不等同于没有工作目录，仍可以未分组方式恢复。
+## 备份与数据边界
 
-## 数据安全与边界
+| 格式 | 内容 | 使用方式 |
+| --- | --- | --- |
+| 会话备份 ZIP | JSON、Markdown、标签备注及附件引用；不包含附件文件，不自动打包后代会话。 | 通过「导入备份」预览后导入；已有 ID 跳过。 |
+| 旧回收保护快照 ZIP | 旧记录、已验证的会话载荷及图片附件；单条上限 64 MiB。 | 用于保存旧数据，不能通过普通会话导入器导入。 |
 
-- **聊天数据只在本机：** 插件状态保存在 `$DSH_HOME/plugin-data/archived-chats/`，不会上传或云同步聊天；更新检查仅请求公开 npm 包版本，不发送聊天或备份内容。
-- **回收有保护，永久删除不可恢复：** 工作区移入回收站需要健康保护快照；直接永久删除不创建可恢复副本。
-- **不覆盖已有聊天：** 导入跳过已有 ID；回收恢复优先使用原会话，原件缺失时只能通过 Host 明确的独占写入器重建普通会话 ID，否则保留回收记录。
-- **删除可以续作：** 确认后的任务先清理关联快照，再删除原会话；失败保留不可恢复的任务，在运行期间或重启后重试。
-- **回收站自动清理默认关闭：** 开启或缩短期限需确认，只处理到期回收聊天，不自动删除普通归档聊天。
-- **ZIP 不等于完整附件备份：** 保留附件引用，但不包含附件字节，也不自动打包后代会话。
+导出成功前会按导入使用的同一格式和预算完成验证。此保证针对普通会话备份；保护快照是独立格式。浏览器提示开始下载不代表文件已保存，需自行核对下载结果。
 
-导出成功前会按导入使用的同一格式和预算完成验证。浏览器会在五分钟超时和 320 MiB 响应上限内缓冲经验证的 ZIP；这是响应字节上限，不是浏览器峰值内存上限。“备份已开始下载”不表示文件已保存到磁盘。
+- 数据保存在运行 DSH 的主机 `$DSH_HOME/plugin-data/archived-chats/`，默认位于 `~/.dsh/`；插件不上传或云同步聊天。
+- 永久删除清理会话及插件关联数据，不承诺擦除 Host 全局附件、缓存或外部备份。失败保留可重试任务。
+- 没有工作目录的聊天会留在已归档；仅缺少工作区时可显示为未分组。
+- 旧回收站清空仅处理确认时展示的精确回收记录实例；目标变化时拒绝扩大删除范围。
 
 ## 从旧版升级
 
-**名称与版本：** 1.4.2 仅更换导出实现，下列菜单名称不变。1.4.1 的英文名称为 Archive Management，1.4.0 英文菜单显示 Session Archive；两者都对应中文「归档管理」，不是不同插件。中文入口、包名、安装命令和数据位置不变。更新至 1.4.1 或更高版本并重启 DSH 后，英文入口名称生效。
-
-独立「历史版本」和「预览清理」界面已移除，不应再按旧版截图寻找这些入口。
+1.6.0 不再提供新增「移入回收站」，移除「空间与策略」入口，并停用自动到期清理和启动快照清扫。
 
-**启动恢复流程会清理未被当前回收记录引用的旧快照及其插件附件副本，不会将它们放进回收站。这项清理不受回收站自动清理开关控制。**
+**已有数据不会因为移除入口而自动迁移或删除。** 旧回收记录、快照和策略文件保留。只要存在回收记录，仍显示回收站；目录读取失败时保留错误与重试入口，不能当作空目录隐藏。旧策略不执行，未完成的永久删除需明确重试。
 
-当前回收记录引用的保护快照会保留。清理未引用快照不删除来源聊天本身；已确认删除任务的重试和已启用的到期清理是另外的操作。
+恢复优先使用仍完好的原会话，成功后回到已归档。原会话丢失时，快照回退依赖 Host 能力；不支持或校验失败会保留记录并报错，不伪报成功。可先导出保护快照保存数据。不要通过手动删除插件数据目录来清空回收站。
 
-如果仍需要旧快照内容，请在升级前使用支持该功能的旧版恢复并导出，另行保留附件，或离线备份完整插件数据目录。降级前应完成待删除任务并备份数据；旧版本可能不识别不带快照的待删除记录。
+重新安装旧版本可能重新启用其原有清理规则；降级前应保留完整数据备份，并确认待删除任务和数据格式兼容。
 
 ## 兼容性
 
-包声明支持 DSH `>=0.1.0-rc.7`；具体功能取决于 Host 公开能力。
+声明范围为 DSH `>=0.1.0-rc.7`，具体能力仍取决于 Host。原生测试使用锁定的 `0.1.7-rc.2` 与 `0.2.1-rc.2` 后端，发布 CI 覆盖 macOS、Windows 和 Linux。
 
-| Host 能力 | 依赖或限制 |
-| --- | --- |
-| 公开归档 API | 工作区批量归档必需；不支持时拒绝执行，不作修改。 |
-| 会话与附件读取 | 用于预览／搜索；缺少附件读取时只降级图片。 |
-| 会话独占物理位置 | 会话目录统计和永久删除必需；不把共享目录当作删除目标。 |
-| 公开 writer | ZIP 导入和快照回退恢复必需；恢复完好的原会话不重写日志。仅有旧 create/append 不足以安全恢复 ZIP，除非提供者明确保证独占创建。 |
-| 新版句柄接口 | 分叉支持标题、预览／搜索及移入回收站。ZIP v2 保存继承边界；导入通过 create/append/flush/close 写入，并要求安全的会话独占回滚位置。普通 v1 ZIP 仍可读取，但边界不明的 seeded v1 来源会被拒绝，不会展平。 |
-| Host 模块解析 | DSH `0.1.6-alpha.2` 新增的解析层会在任何依赖请求带斜杠的内置模块名时失败。1.4.2 之前，本插件经 `zip-stream` 引入 `readable-stream@4`，因此插件一被加载就会中止 Host 启动。1.4.2 的导出改用 `fflate`，不再携带该依赖链；请在这些 Host 版本上先升级。 |
+归档、取消归档、列表读取以官方能力为基础。永久删除由插件协调会话生命周期和存储位置完成，并非调用一个官方统一删除接口；ZIP 导入和旧快照恢复的写入能力要求也不同。详见[兼容性与限制](docs/USER_GUIDE.zh-CN.md#兼容性与限制)。
 
-回收站预览目前仍依赖原会话；原件丢失时，即使保护快照可恢复，也可能无法预览。详见[兼容性与限制](docs/USER_GUIDE.zh-CN.md#兼容性与限制)。
+## 界面截图
 
-声明的版本范围仍以 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` 两套锁定 Host 后端集成（各 8 项）与打包检查，覆盖 v4 会话格式。
+以下截图来自 1.6.0，使用虚构示例会话。旧回收站仅在存在旧记录时显示；[截图清单](screenshots.json)保持以下顺序。
 
-## 文档
+<details>
+<summary>查看界面截图</summary>
 
-| 资料 | English | 简体中文 |
-| --- | --- | --- |
-| 用户指南 | [Read the guide](docs/USER_GUIDE.md) | [查看指南](docs/USER_GUIDE.zh-CN.md) |
-| 架构说明 | [Maintainer architecture](docs/ARCHITECTURE.en.md) | [维护者架构](docs/ARCHITECTURE.md) |
-| 版本历史 | [GitHub Releases](https://github.com/Ultronen/dsh-archived-chats/releases) | [GitHub Releases](https://github.com/Ultronen/dsh-archived-chats/releases) |
+1. [已归档](assets/screenshots/preview-01.png)
+2. [全文搜索与选中操作](assets/screenshots/preview-02.png)
+3. [未归档与工作区归档](assets/screenshots/preview-03.png)
+4. [会话预览](assets/screenshots/preview-04.png)
+5. [旧回收站](assets/screenshots/preview-05.png)
+6. [恢复确认](assets/screenshots/preview-06.png)
+7. [关于与手动维护](assets/screenshots/preview-07.png)
+8. [来源与分支](assets/screenshots/preview-08.png)
 
-另见 [支持说明](SUPPORT.md)、[安全说明](SECURITY.md)、[贡献指南](CONTRIBUTING.md)、[行为准则](CODE_OF_CONDUCT.md)和[问题交流](https://github.com/Ultronen/dsh-archived-chats/discussions)。认领任务或提交 Pull Request 前，贡献者务必完整阅读[贡献指南](CONTRIBUTING.md)。
+</details>
 
-## 项目状态
+## 文档与反馈
 
-归档管理目前处于积极维护状态。最新 npm 稳定版会接收缺陷修复与安全更新；报告问题前请先从旧版本升级。欢迎可复现的缺陷报告和目标集中的 Pull Request。已开放认领的社区任务会标记为 [`help wanted`](https://github.com/Ultronen/dsh-archived-chats/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)；开始较大改动前，请先阅读[需求认领流程](CONTRIBUTING.md#社区需求与认领)。项目按维护者的可用时间推进，不承诺固定响应或发布时间。
+[用户指南](docs/USER_GUIDE.zh-CN.md) · [架构说明](docs/ARCHITECTURE.md) · [更新日志](CHANGELOG.md) · [支持](SUPPORT.md) · [贡献指南](CONTRIBUTING.md)
 
-## 开发
+使用问题和建议欢迎前往 [Discussions](https://github.com/Ultronen/dsh-archived-chats/discussions)；缺陷请附插件与 DSH 版本、最小复现步骤和脱敏错误。安全问题请[私密报告](SECURITY.md)。若帮助你找回了旧方案，欢迎[给项目一个 Star](https://github.com/Ultronen/dsh-archived-chats)。
+
+## 开发与验证
 
 ```sh
 npm test
@@ -160,7 +140,7 @@ node scripts/run-native-integration.mjs --fixture-root test/fixtures/native-host
 npm pack --dry-run --json
 ```
 
-测试覆盖 Host 与浏览器行为、导出导入、快照恢复、回收站、保留策略、全文搜索、响应式布局、公开类型、包内容和仓库卫生。两组原生集成命令分别使用锁定的 `@deepseek-ai/dsh-session@0.1.7-rc.2` 与 `0.2.1-rc.2` fixture，每组要求八个原生集成用例全部执行且不能跳过。所有检查只使用隔离临时数据，不读取真实会话。
+原生测试使用隔离临时数据，每套 8 项均要求执行且不能跳过。提交贡献前请完整阅读[贡献指南](CONTRIBUTING.md)。
 
 ## 卸载
 
@@ -168,8 +148,6 @@ npm pack --dry-run --json
 dsh plugin --profile web remove dsh-archived-chats
 ```
 
-卸载只移除插件包，保留 `$DSH_HOME/plugin-data/archived-chats/`，不执行永久删除。重新安装后仍按所安装版本执行启动恢复与清理，包括清理未引用快照。卸载或手动删除插件状态前请备份需要的数据，详见[本地数据与卸载](docs/USER_GUIDE.zh-CN.md#本地数据与卸载)。
-
-## 许可证
+卸载插件包保留插件数据，不执行永久删除。详见[本地数据与卸载](docs/USER_GUIDE.zh-CN.md#本地数据与卸载)。
 
-[MIT](LICENSE)
+[MIT License](LICENSE)