@michengai/dsh-archive-manager 1.1.8 → 1.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/CHANGELOG.zh-CN.md +8 -0
  3. package/README.md +43 -47
  4. package/README.ru.md +1 -1
  5. package/README.zh-CN.md +45 -49
  6. package/lib/client.js +6 -5
  7. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,14 @@
4
4
 
5
5
  Published release notes are retained below; new versions are added without removing earlier entries.
6
6
 
7
+ ## 1.1.9 - 2026-10-24
8
+
9
+ - Redesigned the filter toolbar with a single-line adaptive layout (#74): the search input now uses the host's native `Input` primitive with an `IconSearchOutlineMedium` search icon and glowing green focus border; rearranged control order to search input, view filter/sort menu, project filter, and date range, with the input flexibly expanding to fill remaining width.
10
+ - Added in-house lightweight single-field DateRange capsule and calendar popover: eliminated native `<input type="date">` glitches such as dark-mode inversion and click-away focus loss (#74); displays the selected range in a single line with a dedicated clear button; the popover supports quick presets (All time, Today, Last 7/30/90 days), localized month/weekday headers in Chinese, English, and Russian, and full WAI-ARIA keyboard navigation (arrows, Home/End, PageUp/Down with month-end clamping).
11
+ - Consolidated filters and sorting into a Codex-style composite menu: merged \"All sessions / Favorites only\" and sorting options into a two-section dropdown, using the host `Menu`'s native checkmark primitive instead of hand-drawn icons.
12
+ - Search scope optimization: removed the manual title/content scope toggle, defaulting automatically to unified full content and title search across conversations in the active tab.
13
+ - Box model fix and folder icon removal: resolved text overflow in the project selector that previously overlapped the adjacent date picker's dropdown chevron, ensuring a clean 8px gap between controls; removed folder icons from project selector for a cleaner native look.
14
+
7
15
  ## 1.1.8 - 2026-10-23
8
16
 
9
17
  - Added primary sidebar navigation entry and dedicated workspace panel: users can now access Archive Manager directly from the first-level sidebar, opening a 960px centered workspace view. The entry can be toggled on or off at any time via the `sidebarEntry` switch in plugin configuration (`plugins.bundle.config` slot).
package/CHANGELOG.zh-CN.md CHANGED
@@ -4,6 +4,14 @@
4
4
 
5
5
  以下发布说明会持续保留；新增版本时不再删除较早记录。
6
6
 
7
+ ## 1.1.9 - 2026-10-24
8
+
9
+ - 重新设计筛选工具栏自适应单行布局（#74）：搜索框采用宿主原生 `Input` 原语，接入 `IconSearchOutlineMedium` 放大镜图标与聚焦绿色呼吸边框；控件顺序调整为「搜索输入框、查询条件、所有项目、时间选择」，输入框自动弹性撑满剩余宽度。
10
+ - 新增自研轻量级单字段日期范围胶囊与日历浮层组件：彻底移除原生 `<input type="date">` 带来的暗黑模式反白与点击失焦缺陷（#74），单行展示选定时间区间并提供独立清除按钮；浮层支持快捷预设（全部时间、今天、近 7/30/90 天）、中英俄三语原生年月与星期国际化排版，以及完备的 WAI-ARIA 键盘无障碍导航（上下左右键、Home/End、PageUp/Down 及月末夹紧）。
11
+ - 收归筛选与排序为 Codex 风格复合视图菜单：将「全部会话 / 只看收藏」与排序规则收归为单一两段式下拉菜单，彻底消除自绘勾选图标，全量接入宿主原生 `Menu` 勾选状态原语。
12
+ - 搜索范围优化：彻底移除正文/标题切换开关，默认直接联合搜索当前页签会话中的标题与正文历史（包含用户与助手消息）。
13
+ - 盒模型溢出与图标清理：彻底修复工作区项目选择器文本溢出导致覆盖遮挡右侧时间选择器下拉三角的盒模型缺陷，保证相邻控件间严格具有标准的 8px 间距；项目选择器彻底移除文件夹图标，对齐 Codex 原生简洁视觉风格。
14
+
7
15
  ## 1.1.8 - 2026-10-23
8
16
 
9
17
  - 新增主侧边栏直接导航入口与工作区主面板：支持在主界面一级侧边栏展示归档管理器图标入口，点击可直接切换至专属工作区主面板（960px 居中版心与独立滚动容器）；可在插件详情页（`plugins.bundle.config` 槽位）随时开启或关闭 `sidebarEntry` 开关。
package/README.md CHANGED
@@ -19,18 +19,22 @@
19
19
 
20
20
  > DSH Archive Manager is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.
21
21
 
22
- ## What you can do
22
+ This document describes **1.1.9**. See [Changelog](CHANGELOG.md) for published releases.
23
23
 
24
- Put inactive conversations away and find them again when needed, keeping everyday task lists tidy.
24
+ ## Overview
25
25
 
26
- - **Archive conversations**: put away one chat or all unarchived chats in a workspace.
27
- - **Find past work**: search titles and content, combine project/favorites/date filters, and sort by time, title, or turns.
28
- - **Restore tasks**: restore one chat, selected chats, or a project group; select all filtered results for bulk actions.
29
- - **Clean up records**: permanently delete unwanted archives after confirmation, track batch progress, and retry remaining items.
30
- - **Organize important chats**: save favorites and preview idle cleanup while protecting favorites and active work.
31
- - **Inspect and troubleshoot**: preview without restoring, copy IDs/paths, diagnose errors, and repair supported legacy logs.
26
+ Put inactive conversations away and find them again when needed, keeping everyday task lists tidy.
32
27
 
33
- > This README describes 1.0.0. See the [changelog](CHANGELOG.md) for the complete feature list and upgrade boundaries.
28
+ - **Dual views & primary sidebar entry**: Toggleable persistent icon on the host's primary sidebar opens a **960px centered workspace view** for both Archived and Unarchived sessions, eliminating narrow dialog scrolling constraints.
29
+ - **Full lifecycle session management**: Archive individual chats, all chats in a workspace, cross-project batches, and restore or open sessions seamlessly.
30
+ - **Clean single-line adaptive toolbar**: Uses the host's native `Input` primitive with an official search icon and glowing green focus border, flexibly expanding to fill remaining width; arranged as search input, view filter/sort menu, project filter, and date range in a clean single line with strict box-model boundaries.
31
+ - **Unified full-text search & Codex composite menu**: Search automatically covers both conversation titles and body history (including user and assistant messages) by default; consolidates session filtering (all / favorites only) and sorting into a two-section Codex-style menu with native checkmarks.
32
+ - **Lightweight DateRange capsule & calendar popover**: Completely replaces the native date input to eliminate dark-mode inversion and focus loss (#74); displays the selected range in a single line with a dedicated clear button; supports quick presets, localized English/Chinese/Russian typography, and full WAI-ARIA keyboard navigation (arrows, Home/End, PageUp/Down with month-end clamping) with real-time range stretch preview.
33
+ - **Automated idle session cleanup**: Specify an idle threshold in days to discover inactive chats, automatically protecting running tasks, interactive prompts, and starred items, with instant undo support.
34
+ - **Native workspace menu integration**: Securely injects an **Archive session** action into the sidebar workspace `...` menu, anchoring an in-place frosted glass confirmation modal following the "what you see is what you archive" principle.
35
+ - **Permanent deletion**: Thoroughly purge unwanted transcripts, cache rows, and indexes with per-item retry reporting.
36
+ - **Diagnostic & repair center**: Diagnose corrupted single-frame Zstandard transcripts and legacy format anomalies with in-place verified repair.
37
+ - **Controlled online updates & reverse proxy ready**: Features a toggleable online update switch, enterprise host-level configuration locking, and native baseURI dynamic endpoint resolution for prefix-stripping reverse proxies.
34
38
 
35
39
  ## Session diagnosis and repair
36
40
 
@@ -39,7 +43,7 @@ The archive page collects read failures, including archived IDs with missing sum
39
43
  ## Search and preview
40
44
 
41
45
  - Archived and Unarchived share title/content search, project, favorites, updated-date filters, and creation-time sorting. Star or unstar conversations on either tab.
42
- - Choose **Titles and content** to search user and assistant text; the default remains titles only. Date filters include the entire local end date and combine with project and favorites.
46
+ - Search automatically covers both conversation titles and body history (including user and assistant messages) by default. Date filters include the entire local end date and combine with project and favorites.
43
47
  - Matches show snippets and highlights. On Archived, click a snippet or **More → Quick preview** to inspect context without restoring. On Unarchived, a snippet opens the full conversation.
44
48
  - Preview renders Markdown tables, quotes, and code blocks with role labels; switch to source text for highlights. It shows up to eight recent messages, or context around the first match. Each message is limited to 2,000 UTF-16 code units without splitting Unicode characters.
45
49
  - Search accepts up to 200 query characters and reads batches of at most 20 sessions, sequentially within each batch. Tools, attachments, reasoning, system messages, and plugin injections are excluded. Read failures remain visible and can be retried. Stored text is not the model's current context.
@@ -62,54 +66,49 @@ Switch to **Unarchived** for the same filters, idle cleanup previews, and projec
62
66
 
63
67
  ![Unarchived: idle cleanup and project archiving](assets/screenshots/unarchived-sessions.webp)
64
68
 
65
- > Screenshots show the pre-release development build labeled 0.1.44; this release is 1.0.0. The sidebar belongs to the installed UI plugin and does not represent new sidebar features in this release.
66
-
67
- ## Prerequisites
68
-
69
- - A working [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web installation with `dsh` available in your terminal.
70
- - Supported DSH versions: `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`, and `0.2.1-rc.2`. Intermediate `0.2.1-alpha.*` releases and earlier hosts are rejected by the version gate and this plugin will not run. Existing archives and favorites are kept. Install `1.0.20` if you still use a `0.1.x` host.
71
- - Node.js matching `^22.19.0 || >=24.0.0`. Source installation also requires pnpm.
69
+ *Screenshots show core functional panels, including archived session search and unarchived idle cleanup. Lossless WebP format.*
72
70
 
73
71
  ## Installation
74
72
 
75
- Examples use the `web` profile. Replace it with the profile you actually use.
73
+ A working DeepSeek Harness environment is required. Examples use the `web` profile; adjust to your environment.
74
+
75
+ Plugin installation supports npm registry, locally built `.tgz` packages, and GitHub. Both GitHub and npm contain runnable `lib` artifacts.
76
76
 
77
77
  ### Ask an agent to install it
78
78
 
79
79
  Send this prompt to an agent that can run terminal commands on your computer:
80
80
 
81
81
  ```text
82
- Install the latest @michengai/dsh-archive-manager into my local DSH web profile using the official npm registry. Check the plugin configuration afterward, then explain how to reload DSH and open archived session management.
82
+ Please install the latest @michengai/dsh-archive-manager into my DSH web profile using the official npm registry, verify activation, and explain how to reload.
83
83
  ```
84
84
 
85
85
  ### Install manually
86
86
 
87
- Run in PowerShell:
88
-
89
87
  ```powershell
90
88
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
91
89
  $OutputEncoding = [System.Text.Encoding]::UTF8
92
-
93
90
  dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/
94
91
  ```
95
92
 
96
- Restart DSH Web, then hard-refresh your browser with `Ctrl+Shift+R`. Open **Settings → Archived sessions** to get started.
93
+ Restart DSH Web, then refresh the page (or hard-refresh with `Ctrl+Shift+R`). Open **Settings → Archived sessions** to get started. To update, click **Check for updates** or re-run the installation command.
97
94
 
95
+ - Plugin `1.1.9` is tested with DeepSeek Harness `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`, `0.2.1-rc.2`.
96
+ - Hosts before `0.2.0` are no longer supported. If you still use a `0.1.x` host, install plugin `1.0.20` instead of `@latest`.
98
97
  - **Reverse proxy deployment**: Supports hosting DSH behind prefix-stripping reverse proxies (e.g. `/app/dsh/`). API and update endpoints automatically resolve against the page base URI (`document.baseURI`), preventing 404 errors caused by lost prefix segments.
99
98
 
100
99
  ## Plugin Configuration & Toggles
101
100
 
102
101
  The plugin follows standard DSH bundle configuration conventions. Options are located at:
103
- > **Sidebar → Plugins → Click `@michengai/dsh-archive-manager`** (the host's `plugins.bundle.config` slot).
102
+ > **Sidebar → Plugins → Click `Archive Manager`** (the host's `plugins.bundle.config` slot).
104
103
 
105
- Two native switches are available. Their values are persisted in `archive-manager/settings.json` under your local configuration directory and survive restarts; they are not two equivalent Cordis YAML options. `sidebarEntry` is managed through this UI, while `onlineUpdate` is also subject to the host lock described below:
104
+ Two native switches are available:
106
105
 
107
106
  ### 1. Sidebar Entry (`sidebarEntry`)
108
107
  - **Default**: Disabled (`false`)
109
- - **Description**: Displays a persistent **Archived sessions** navigation icon in the host's left primary sidebar.
108
+ - **Description**: Displays a persistent **Archive** navigation icon in the host's left primary sidebar under **Plugins**.
110
109
  - **Effect**:
111
110
  - When enabled, clicking the sidebar icon opens the Archive Manager directly in the primary workspace with a **960px centered container** (matching host plugin manager conventions). This eliminates vertical scrolling constraints in narrow settings dialogs;
112
- - When disabled, unregisters the sidebar entry cleanly (and resets active panel gracefully if currently viewing the panel, preventing blank views);
111
+ - When disabled, unregisters the sidebar entry cleanly (and resets the active panel gracefully if currently viewing the panel, preventing blank views);
113
112
  - The standard **Settings → Archived sessions** view remains active either way, and state is synchronized live across both entry points.
114
113
 
115
114
  ### 2. Online Updates (`onlineUpdate` / `updater`)
@@ -120,31 +119,28 @@ Two native switches are available. Their values are persisted in `archive-manage
120
119
  - **Endpoint Guard**: When disabled, the update API route returns `HTTP 403` for all check and install requests, preventing unreviewed updates;
121
120
  - **Host / Platform Lock**: For curated plugin indexes (such as VibeDev) or restricted enterprise environments, this can be locked directly via Cordis configuration (bundle patch) without needing UI interaction:
122
121
  ```yaml
123
- - insert:
124
- - id: ui-workspace-archive-manager
125
- name: '@michengai/dsh-archive-manager'
126
- config:
127
- updater: false # or onlineUpdate: false
122
+ updater: false # or onlineUpdate: false
128
123
  ```
129
124
  Once configured, the updater is disabled at startup, the update action stays hidden, and the online-update switch is disabled. The host lock takes precedence over the user's choice in settings.json and cannot be lifted through the UI. Removing the host lock restores the saved user preference.
130
125
 
131
- ## Usage
126
+ ## Usage Guide
132
127
 
133
- | Goal | Action |
128
+ | Action | How to do it |
134
129
  | --- | --- |
135
- | Archive one chat | Open its sidebar menu and choose **Archive session** |
136
- | Archive a workspace | Open the workspace menu and choose the option to archive its chats |
137
- | Find an archive | Open **Settings → Archived sessions**, then choose title/content search or filter by project, favorites, and dates |
138
- | Change the order | Sort by update time, creation time, title, or most/fewest turns |
139
- | Restore one chat | Click the restore icon, or choose **More → Restore and open** |
140
- | Archive a project or ungrouped chats | On **Unarchived**, open the group’s **…** menu and confirm archiving all chats in that group, regardless of search filters |
141
- | Favorite a chat | Click its right-side star; use the favorites dropdown to filter |
142
- | Preview archived content | Click a match snippet or **More → Quick preview** |
143
- | Clean up idle chats | On Unarchived, set idle days, preview candidates, and confirm |
144
- | Locate a session | Copy its ID or path from More |
145
- | Handle read errors | Expand diagnosis, diagnose first, and confirm repair when eligible |
146
- | Archive across projects | Switch to **Unarchived**, select sessions across projects, then click **Archive** and confirm |
147
- | Restore or delete in bulk | Select chats and use the bulk actions, or use the project menu; there are no separate Restore all / Delete all buttons |
130
+ | **Archive one chat** | Open the session context menu in the sidebar and choose **Archive session** |
131
+ | **Archive a workspace** | Open the workspace menu and choose **Archive session** (opens an in-place confirmation overlay) |
132
+ | **Search & filter** | Open **Settings → Archived sessions** or click **Archive** in the sidebar; search bar automatically covers titles and body messages; use the Codex-style view menu to filter (all / favorites only) and sort; select projects from dropdown; pick dates with the single-field capsule |
133
+ | **Custom calendar & keyboard nav** | Click the date capsule to open the lightweight calendar popover; supports all time and quick presets; provides complete WAI-ARIA keyboard navigation (arrows, Home/End, PageUp/Down, Enter/Space) and real-time range stretch preview |
134
+ | **Quick preview** | Click a match snippet or **More → Quick preview** to inspect context with highlights without restoring |
135
+ | **Adjust ordering** | Sort by update time, creation time, title, or most/fewest turns in the view menu |
136
+ | **Restore a chat** | Click the restore icon on any row; use **More → Restore and open** to resume the chat directly |
137
+ | **Archive entire group** | On **Unarchived**, click the **…** menu next to a group and confirm archiving all chats in that project |
138
+ | **Favorite chats** | Click the star icon on any row; use the view menu to filter starred chats |
139
+ | **Clean up idle chats** | On **Unarchived**, set an idle day threshold, automatically protecting running and starred chats, preview candidates, and confirm |
140
+ | **Locate session files** | Select **Copy session ID** or **Copy session path** from the **More** menu |
141
+ | **Repair damaged logs** | Expand **Diagnosis and repair** to diagnose and repair corrupted single-frame Zstandard files or legacy anomalies |
142
+ | **Archive across projects** | Switch to **Unarchived**, select sessions across projects, then click **Archive** and confirm |
143
+ | **Restore or delete in bulk** | Select chats and use the bulk actions, or use the project menu; there are no separate Restore all / Delete all buttons |
148
144
 
149
145
  The page opens on **Archived**, with **Unarchived** on the right. Switching tabs clears selections; changing search or project filters preserves them. Check the hidden selection count before applying bulk actions, or clear your selection first.
150
146
 
package/README.ru.md CHANGED
@@ -39,7 +39,7 @@
39
39
  ## Поиск и предпросмотр
40
40
 
41
41
  - **Архив** и **Незаархивированные** используют общий поиск по названию/содержимому, фильтры проекта, избранного и даты обновления, а также сортировку по времени создания. Ставьте или снимайте избранное на любой вкладке.
42
- - Выберите **Названия и содержимое**, чтобы искать по тексту пользователя и ассистента; по умолчанию ищутся только названия. Фильтры дат включают весь локальный конечный день и комбинируются с проектом и избранным.
42
+ - Поиск по умолчанию автоматически охватывает как названия, так и текст истории сообщений (включая пользователя и ассистента). Фильтры дат включают весь локальный конечный день и комбинируются с проектом и избранным.
43
43
  - Совпадения показывают фрагменты и подсветку. На вкладке **Архив** щёлкните фрагмент или **Дополнительно → Быстрый предпросмотр**, чтобы изучить контекст без восстановления. На вкладке **Незаархивированные** фрагмент открывает полную беседу.
44
44
  - Предпросмотр рендерит Markdown-таблицы, цитаты и блоки кода с подписями ролей; переключитесь на исходный текст для подсветки. Показывается до восьми последних сообщений либо контекст вокруг первого совпадения. Каждое сообщение ограничено 2 000 кодовых единиц UTF-16 без разрыва Unicode-символов.
45
45
  - Поиск принимает до 200 символов запроса и читает пакетами максимум по 20 сессий последовательно внутри каждого пакета. Инструменты, вложения, рассуждения, системные сообщения и плагинные вставки исключаются. Ошибки чтения остаются видимыми и их можно повторить. Сохранённый текст — это не текущий контекст модели.
package/README.zh-CN.md CHANGED
@@ -19,18 +19,22 @@
19
19
 
20
20
  > DSH Archive Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
21
21
 
22
- ## 你可以用它做什么
22
+ 本文描述 **1.1.9**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
23
23
 
24
- 把暂时不用的会话收起来，需要时再找回，让日常任务列表更清爽。
24
+ ## 功能概览
25
25
 
26
- - **归档会话**：收起单条聊天，或整个工作区的未归档聊天。
27
- - **找回历史**：搜索标题与正文，组合项目、收藏和日期筛选，按时间、标题或轮次排序。
28
- - **恢复任务**：恢复单条、选中的会话或整个项目；可全选当前筛选结果后批量操作。
29
- - **清理记录**：确认后永久删除不再需要的归档会话，查看批量进度并重试剩余项。
30
- - **整理重要会话**：收藏常用聊天，预览闲置归档候选，保护收藏与活跃任务。
31
- - **查看与排障**：不恢复即可快速预览，复制会话 ID／路径，诊断异常并定向修复支持的旧日志。
26
+ 把暂时不用的会话收起来，需要时再找回，让日常任务列表更清爽。
32
27
 
33
- > 本文对应 1.0.0 版本，完整功能清单与升级边界见[更新日志](CHANGELOG.zh-CN.md)。
28
+ - **多视图与侧栏直达**：支持开启主侧边栏直接导航入口，在主工作区以 **960px 居中版心** 展开「已归档」与「未归档」完整大面板，告别狭窄弹窗。
29
+ - **全生命周期管理**：支持单条会话归档、全工作区一键归档、跨项目批量归档、单条/批量恢复并打开会话。
30
+ - **纯净自适应单行工具栏**：采用宿主原生 `Input` 原语，内置官方放大镜图标与绿色呼吸聚焦边框，自适应弹性撑满；控件按「输入框、查询条件、所有项目、时间选择」极简单行排列，锁死盒模型杜绝溢出重叠。
31
+ - **全文联合检索与 Codex 复合菜单**：默认自动联合搜索标题与正文历史（用户与助手消息）；将会话筛选（全部/只看收藏）与排序收归为 Codex 风格两段式复合菜单，完全采用宿主原生对勾原语。
32
+ - **轻量单字段日期胶囊与日历浮层**：彻底告别原生日期选择器的暗黑模式反白与失焦缺陷（#74），单行展示时间范围；浮层支持快捷预设、中英俄三语原生排版，以及完备的 WAI-ARIA 键盘无障碍漫游（上下左右键、Home/End、PageUp/Down 及月末夹紧）与高亮区间实时拉伸预览。
33
+ - **智能闲置会话整理**：自定义闲置天数，自动分析并排除正在运行、等待交互及已收藏的关键会话，支持预览候选后确认归档，并提供误操作撤回机制。
34
+ - **原生侧边栏菜单注入**：在原生侧栏工作区 `...` 菜单中安全注入「归档会话」项，弹出锚定工作区行的毛玻璃二次确认框，严格遵循「所见即所归」原则。
35
+ - **永久彻底清理**：确认后永久删除不再需要的会话，彻底清除物理日志、索引与缓存，支持错误项独立重试。
36
+ - **异常会话诊断与修复**：对损坏的 Zstandard 压缩帧日志与历史特定来源异常会话提供原地诊断和安全修复。
37
+ - **可控在线更新与反向代理适配**：提供独立在线更新开关与企业级宿主配置硬锁定；原生适配反代子路径前缀部署。
34
38
 
35
39
  ## 异常会话诊断与修复
36
40
 
@@ -42,7 +46,7 @@
42
46
 
43
47
  - 快速预览默认以 Markdown 排版展示，支持表格、引用与代码块，区分用户和助手；可切换为原文与关键词高亮。
44
48
 
45
- - 在搜索框左侧选择「标题与正文」，可搜索当前页签会话中的用户和助手文本；默认仍只搜索标题。
49
+ - 搜索框默认直接联合搜索当前页签会话中的标题与正文历史（包含用户和助手文本），无需手动切换范围。
46
50
  - 搜索框右侧「日期」可选择或清除更新时间范围；项目、收藏和更新时间范围可组合使用；结束日期包含本地当天。已归档和未归档页均支持正文搜索与这些筛选条件。
47
51
  - 正文命中显示片段和关键词高亮；已归档页点击片段或「更多 → 快速预览」查看上下文，不恢复会话；未归档页点击片段打开完整会话。没有关键词时预览最近八条消息，有关键词时定位首个命中附近。
48
52
  - 检索逐批读取，每批最多 20 条会话，批内逐条读取；关键词最多 200 字符。预览每条最多 2000 个 UTF-16 码元，截断保留完整 Unicode 字符，较长内容请打开完整会话。
@@ -66,53 +70,48 @@
66
70
 
67
71
  ![未归档会话：闲置整理与项目归档](assets/screenshots/unarchived-sessions.webp)
68
72
 
69
- > 截图来自发布前开发版，界面中版本标识为 0.1.44；本次发行版本为 1.0.0。侧栏由当前安装的 UI 插件提供，不代表本插件新增的侧栏功能。
70
-
71
- ## 前置条件
72
-
73
- - 已能正常使用 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web，并可在终端运行 `dsh`。
74
- - 当前支持 DSH `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`、`0.2.1-rc.2`。中间的 `0.2.1-alpha.*` 和更早宿主会被版本门拒绝，插件不会运行；已有归档和收藏仍保留。仍在使用 `0.1.x` 的，请安装 `1.0.20`。
75
- - Node.js 版本需满足 `^22.19.0 || >=24.0.0`；从源码安装还需要 pnpm。
73
+ *截图展示核心功能面板，包含已归档会话检索筛选与未归档闲置整理。采用无损 WebP 格式。*
76
74
 
77
75
  ## 安装
78
76
 
79
- 以下示例使用 `web` profile，请替换为你实际使用的 profile。
77
+ 需要已安装并能正常运行 DeepSeek Harness。以下命令使用 `web` profile，请按实际环境替换。
78
+
79
+ 插件安装支持 npm registry、本地构建的 `.tgz` 包和 GitHub。GitHub 与 npm 都包含可直接运行的 `lib`。改动源码后，提交前请先运行构建。
80
80
 
81
81
  ### 让 Agent 帮你安装
82
82
 
83
- 把下面这段话发给能执行本机终端命令的 Agent：
83
+ 把这段话发给能够操作本机终端的 Agent：
84
84
 
85
85
  ```text
86
- 请将 @michengai/dsh-archive-manager 最新版安装到本机 DSH 的 web profile，使用官方 npm 源。安装后检查插件配置，并告诉我如何重新加载 DSH、进入归档会话管理页。
86
+ 请把 @michengai/dsh-archive-manager 最新版安装到我的 DSH web profile，使用官方 npm 源，安装后确认生效并告诉我如何重新加载。
87
87
  ```
88
88
 
89
89
  ### 手动安装
90
90
 
91
- 在 PowerShell 中执行：
92
-
93
91
  ```powershell
94
92
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
95
93
  $OutputEncoding = [System.Text.Encoding]::UTF8
96
-
97
94
  dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/
98
95
  ```
99
96
 
100
- 安装后重启 DSH Web，并按 `Ctrl+Shift+R` 硬刷新浏览器。打开「设置 → 归档会话」即可使用。
97
+ 安装后重启 DSH Web，并刷新页面（或按 `Ctrl+Shift+R` 硬刷新浏览器），打开「设置 → 归档会话」即可使用。更新时可点击「检查更新」，或重新执行安装命令。
101
98
 
99
+ - `1.1.9` 已验证兼容 DeepSeek Harness `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`、`0.2.1-rc.2`。
100
+ - 不再支持 `0.2.0` 之前的宿主。仍在使用 `0.1.x` 的，请安装插件 `1.0.20`，不要装 `@latest`。
102
101
  - **反向代理部署**：支持将 DSH 部署在带路径前缀的反向代理后面（如 `/app/dsh/`），插件 API 与更新检查端点统一自动按页面基址（`document.baseURI`）相对解析，避免丢失代理路径前缀导致 404。
103
102
 
104
103
  ## 插件配置与可选开关
105
104
 
106
105
  插件遵循 DSH 官方扩展配置规范，配置项位于：
107
- > **主界面侧边栏「插件」→ 点击 `@michengai/dsh-archive-manager` 详情页**（对应宿主 `plugins.bundle.config` 槽位）。
106
+ > **主界面侧边栏「插件」→ 点击 `Archive Manager` 详情页**（对应宿主 `plugins.bundle.config` 槽位）。
108
107
 
109
- 此处提供两个原生扁平行开关。界面开关值保存在本地配置 `archive-manager/settings.json` 中，重启后保留；它们不是两个等价的 Cordis YAML 配置项。`sidebarEntry` 只通过此界面管理，`onlineUpdate` 另受下述宿主锁定规则约束：
108
+ 此处提供两个原生扁平行开关：
110
109
 
111
110
  ### 1. 侧边栏入口 (`sidebarEntry`)
112
111
  - **默认状态**：关闭（`false`）
113
- - **功能说明**：在宿主左侧主导航栏增加常驻的 **「归档会话」** 图标入口。
112
+ - **功能说明**：在宿主左侧主导航栏的「插件」下方增加常驻的 **「归档」** 图标入口。
114
113
  - **生效效果**：
115
- - 开启后，在侧边栏点击即可直达归档中心，并在主工作区以 **960px 居中版心**（对齐官方插件管理规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
114
+ - 开启后，在侧边栏点击即可直达归档中心，并在主工作区以 **960px 居中版心**（对齐官方插件管理与市场规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
116
115
  - 关闭后安全注销侧栏槽位（若当前正停留在归档大面板，会自动安全切回默认视图，防止悬空和白屏）；
117
116
  - 无论是否开启侧栏入口，DSH 原有的「设置 → 归档会话」入口始终保留，两处界面数据与操作 100% 实时同步。
118
117
 
@@ -124,31 +123,28 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
124
123
  - **接口安全拦截**：关闭后，服务端的更新路由对任何版本检查和安装请求均返回 `HTTP 403` 禁用状态，彻底杜绝在插件内安装未审核版本；
125
124
  - **宿主/平台级锁定**：面向精选插件索引（如 VibeDev）或企业安全合规环境，支持直接在 Cordis 配置文件（bundle patch）中声明，无需进入界面手动配置：
126
125
  ```yaml
127
- - insert:
128
- - id: ui-workspace-archive-manager
129
- name: '@michengai/dsh-archive-manager'
130
- config:
131
- updater: false # 或 onlineUpdate: false
126
+ updater: false # 或 onlineUpdate: false
132
127
  ```
133
- 配置生效后，更新器在启动时即被禁用，更新入口隐藏，详情页在线更新开关置灰。宿主锁定优先于本地配置中的用户选择，界面不能解除锁定；宿主移除锁定后，重新按已保存的用户选择生效。
128
+ 配置生效后，更新器在启动时即被完全禁用，更新入口隐藏，详情页在线更新开关置灰。宿主锁定优先于本地配置中的用户选择，界面不能解除锁定；宿主移除锁定后，重新按已保存的用户选择生效。
134
129
 
135
- ## 使用
130
+ ## 使用指南
136
131
 
137
- | 你想做什么 | 操作 |
132
+ | 核心操作 | 操作方式 |
138
133
  | --- | --- |
139
- | 归档一条会话 | 打开侧栏会话菜单，选择「归档会话」 |
140
- | 归档整个工作区 | 打开工作区菜单，选择归档该工作区的会话 |
141
- | 查找归档 | 打开「设置 → 归档会话」，选择标题／正文搜索，组合项目、收藏和日期筛选 |
142
- | 调整排列顺序 | 按更新时间、创建时间、标题、轮次最多／最少排序 |
143
- | 恢复一条会话 | 点击会话右侧的恢复图标；更多菜单可「恢复打开」 |
144
- | 归档某个项目或未分组 | 在「未归档」页点击分组右侧“…”菜单，确认归档该组全部聊天；不受搜索筛选影响 |
145
- | 收藏会话 | 点击行右侧星标，使用收藏下拉菜单筛选 |
146
- | 快速查看归档内容 | 点击命中片段或「更多 → 快速预览」 |
147
- | 整理闲置会话 | 在未归档页设置天数，预览、检查候选后确认归档 |
148
- | 定位会话文件 | 在更多菜单复制会话 ID 或路径 |
149
- | 处理读取异常 | 展开诊断与修复，先诊断，再按资格确认修复 |
150
- | 跨项目批量归档 | 切换到「未归档」，跨项目勾选会话后点击「归档」并确认 |
151
- | 批量恢复或删除 | 勾选会话后使用批量操作；也可使用项目菜单；页面不再提供独立的全部恢复／全部删除按钮 |
134
+ | **归档一条会话** | 打开侧栏会话菜单，选择「归档会话」 |
135
+ | **归档整个工作区** | 打开工作区菜单，选择归档该工作区的会话（弹出就地确认卡片） |
136
+ | **检索与筛选** | 打开「设置 → 归档会话」或点击侧边栏「归档」，搜索框自动联合检索标题与正文；使用 Codex 风格视图菜单切换「全部会话 / 只看收藏」与排序；按「所有项目」下拉过滤特定项目；使用单字段日期胶囊选择时间范围 |
137
+ | **自研日历与键盘漫游** | 点击日期胶囊展开轻量日历浮层，提供全部时间与常用预设；支持完整键盘无障碍漫游（上下左右键移动、Home/End 周首周末跳转、PageUp/Down 跨月切换、Enter/Space 选定），并提供区间高亮实时拉伸预览 |
138
+ | **快速预览** | 点击命中片段或「更多 → 快速预览」，无需恢复即可查看上下文与原文高亮 |
139
+ | **调整排序** | 统一在视图菜单中按更新时间、创建时间、标题、轮次最多／最少排序 |
140
+ | **恢复会话** | 点击会话右侧恢复图标；「更多」菜单可「恢复打开」直接进入原会话继续对话 |
141
+ | **项目整体归档** | 在「未归档」页点击分组右侧“…”菜单，确认归档该组全部聊天（不受搜索影响） |
142
+ | **收藏会话** | 点击行右侧星标，使用视图菜单「只看收藏」快速过滤重要会话 |
143
+ | **整理闲置会话** | 在未归档页设置闲置天数，自动排除运行中、等待交互与收藏的会话，预览并确认归档 |
144
+ | **撤回归档** | 批量归档后可在关闭页面前点击「撤回本次归档」，安全恢复误归档会话 |
145
+ | **永久彻底删除** | 勾选单条或多条会话后点击「删除」，二次确认后彻底清除日志与缓存，支持错误项重试 |
146
+ | **处理损坏日志** | 展开「诊断与修复」，针对单帧 Zstandard 压缩损坏或特定历史异常会话执行原地诊断修复 |
147
+ | **定位会话文件** | 在更多菜单选择「复制会话 ID」或「复制会话路径」 |
152
148
 
153
149
  页面默认打开「已归档」，右侧「未归档」用于批量归档。切换 TAB 会清空选择；切换搜索或项目筛选会保留已选会话。批量操作前留意隐藏的已选数量，或先清空选择。
154
150