@michengai/dsh-archive-manager 1.1.16 → 1.1.18

package/CHANGELOG.md

@@ -4,6 +4,32 @@
 
 Published release notes are retained below; new versions are added without removing earlier entries.
 
+## 1.1.18 - 2026-10-27
+
+- Fix conflict where sidebar favorite star covers native session status dots (#92):
+  - Ensures host primary status dots (e.g. running spinner and waiting approval dots) remain fully visible during active states and are no longer faded out on hover.
+  - When a starred session is active, the star badge adapts into a 10px icon in the bottom-right corner with a subtle drop shadow, allowing both status progress and favorite state to coexist cleanly.
+  - Automatically restores the star to its standard 16×16px centered position as soon as the session returns to idle.
+
+## 1.1.17 - 2026-10-27
+
+- Full-row right-click context menu support in sidebar:
+  - Supports triggering workspace and session actions menus by right-clicking anywhere on the corresponding row.
+  - Tightens button detection to gracefully pass through the system context menu for ungrouped workspace rows and blank unpersisted sessions, preventing accidental clicks on create or favorite buttons.
+- Star favorite icon alignment and zero-jitter optimization:
+  - Aligns favorite star icon to standard 16×16px size and overlays host leading slot.
+  - Uses absolute positioning over the leading slot to eliminate horizontal title jitter in sidebar rows.
+  - Fades out underlying leading status dots only on hover or when favorited.
+- Archive settings page visual unification and compactness:
+  - Adopts unified drawer cards for workspace groups, aligning visual style with Skills Manager.
+  - Compacts session row height to 40px for increased information density.
+  - Reverts checkbox styling to host primitive specification using `accent-color`, seamlessly adapting to dark mode and eliminating solid white block glitches.
+- Modal dialog anti-bleedthrough and accessibility enhancements:
+  - Mounts preview and confirmation dialogs to document root via `portalToBody`, resolving container-type clipping and text bleedthrough.
+  - Adds localized accessible labels across zh/en/ru for modal close buttons (`common.close`).
+- Settings section ID standardization and coexistence compatibility (#91):
+  - Updates settings section ID to `archive-manager` with runtime fail-soft `try/catch` protection, resolving registration collisions with third-party archive plugins.
+
 ## 1.1.16 - 2026-10-26
 
 - Fix cross-platform path validation for opening folder in system explorer under Linux/POSIX environments, supporting both Windows and POSIX absolute path schemes.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,32 @@
 
 以下发布说明会持续保留；新增版本时不再删除较早记录。
 
+## 1.1.18 - 2026-10-27
+
+- 修复侧栏收藏星遮挡宿主会话状态点的冲突缺陷（#92）：
+  - 当会话处于运行中（转圈指示器）或等待审批等活跃状态时，宿主原生状态点保持完全可见，鼠标悬停时不再被淡出；
+  - 已收藏的会话在活跃状态下，收藏星自适应转为右下角 10px 金色角标并带有细微轮廓阴影，实现运行进度指示与收藏状态清晰共存；
+  - 会话恢复空闲后，星标即刻自动恢复为前导格标准 16px 居中展示。
+
+## 1.1.17 - 2026-10-27
+
+- 侧栏行整行右键操作菜单支持：
+  - 支持在侧栏工作区行和会话行上直接右键唤起对应操作菜单；
+  - 优化按钮匹配过滤，在未分组工作区行与空白未落盘会话行上优雅放行系统原生右键菜单，避免误触新建或星标。
+- 侧栏收藏星标视觉对齐与零抖动优化：
+  - 收藏星标与菜单图标标准尺寸对齐为 16×16px 并复用宿主前导插槽；
+  - 采用绝对定位精确覆盖前导槽位置，消除侧栏会话标题左右微小抖动；
+  - 仅在悬停或已收藏时淡出底层状态点，保护行内布局稳定性。
+- 归档管理设置页视觉一体化与紧凑化：
+  - 工作区卡片采用一体化抽屉设计，与技能管理视觉风格保持统一；
+  - 会话列表项排版超紧凑化（行高从 48px 收敛至 40px），信息密度显著提升；
+  - 复选框严格回归宿主原生原语 Checkbox 规范，使用原生 `accent-color` 完美适配深色模式（深暗底色与品牌蓝选中态），消除自绘样式导致的纯白刺眼方块问题。
+- 模态弹窗防穿透与无障碍体验优化：
+  - 预览及确认弹窗统一接入 body 根节点挂载（`portalToBody`），彻底消除被局部容器包含块限制导致的大弹窗偏左错位与文字透视重叠问题；
+  - 弹窗右上角 X 关闭按钮补充中、英、俄三语无障碍标签（`common.close`），消除英文硬编码回退。
+- 设置页 ID 规范与第三方插件共存兼容（#91）：
+  - 设置页 section ID 调整为团队统一规范的 `archive-manager`，消除与第三方同类插件的注册命名冲突并增加运行时 fail-soft 容错保护。
+
 ## 1.1.16 - 2026-10-26
 
 - 修复资源管理器打开路径校验在 Linux/POSIX 环境下对绝对路径与 Windows 盘符的兼容性问题，确保跨平台全绿通过。

package/README.md

@@ -19,7 +19,7 @@
 
 > DSH Archive Manager is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.
 
-This document describes **1.1.10**. See [Changelog](CHANGELOG.md) for published releases.
+This document describes **1.1.17**. See [Changelog](CHANGELOG.md) for published releases.
 
 ## Overview
 
@@ -27,11 +27,18 @@ Put inactive conversations away and find them again when needed, keeping everyda
 
 - **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.
 - **Full lifecycle session management**: Archive individual chats, all chats in a workspace, cross-project batches, and restore or open sessions seamlessly.
+- **Full-row sidebar right-click actions**: Right-click directly anywhere on sidebar workspace or session rows to trigger dedicated actions menus; passes through native system context menus on ungrouped or blank rows without accidental clicks.
+- **Zero-jitter star alignment & status dot coexistence (#90, #92)**: Standardizes favorite stars to 16×16px size and overlays the host leading slot via absolute positioning, eliminating horizontal title jitter; during active states (running or waiting approval), host status dots remain 100% visible while the star badge adapts into a 10px bottom-right badge for seamless coexistence, preserving custom skin compatibility.
+- **Workspace quick action menu**: Provides fast "Copy folder path", "Open folder" (directly opens in Windows Explorer or macOS Finder), and one-click "Archive sessions" in the sidebar workspace menu.
+- **Move session across workspaces**: Move conversations across project workspaces via a cascading hover submenu with process quiescence, atomic rewriting, instant projection pre-warming, and NTFS colon-safety for IM sessions.
+- **Unified accordion cards & 40px ultra-compact rows**: Unifies workspace groups with Skills Manager-style integrated drawer cards (38px header); compacts session row height to 40px for doubled information density.
+- **Host-native dark mode checkboxes**: Reverts checkbox styling strictly to host primitive Checkbox specifications using native `accent-color`, perfectly blending with dark backgrounds and brand blue checked states.
+- **Anti-bleedthrough modals & localized accessibility**: Mounts wide preview dialogs directly to body (`portalToBody`) with solid backing and frosted blur to prevent text bleedthrough; adds comprehensive trilingual close button accessibility labels (`common.close`).
+- **Standardized section ID & coexistence compatibility (#91)**: Section ID updated to `archive-manager` with runtime fail-soft `try/catch` protection, ensuring smooth coexistence with third-party archive plugins.
 - **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.
 - **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.
 - **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.
 - **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.
-- **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.
 - **Permanent deletion**: Thoroughly purge unwanted transcripts, cache rows, and indexes with per-item retry reporting.
 - **Orphan subagent detection & cleanup**: Automatically detect residue subagents whose parent sessions were externally deleted, displaying disk usage and enabling safe one-click reclamation.
 - **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.
@@ -57,15 +64,31 @@ When parent sessions are deleted externally or via the host, orphaned subagents
 
 ## Screenshots
 
-Search, favorite, preview, restore, and clean up in **Settings → Archived sessions → Archived**:
+### 1. Archive Settings Management (Accordion Cards & Dark Mode Checkboxes)
 
-![Archived: shared search filters, favorites, and restore](assets/screenshots/archived-sessions.webp)
+Search, favorite, preview, restore, and clean up in **Settings → Archived sessions → Archived** with integrated drawer cards, 40px ultra-compact rows, and native dark mode checkboxes:
 
-Switch to **Unarchived** for the same filters, idle cleanup previews, and project-wide archiving:
+![Archived: shared search filters, favorites, and compact rows](assets/screenshots/archived-sessions.webp)
 
-![Unarchived: idle cleanup and project archiving](assets/screenshots/unarchived-sessions.webp)
+Switch to **Unarchived** for smart idle cleanup suggestions, one-click archiving, and project-wide operations:
 
-*Screenshots show core functional panels, including archived session search and unarchived idle cleanup. Lossless WebP format.*
+![Unarchived: smart idle cleanup and project archiving](assets/screenshots/unarchived-sessions.webp)
+
+### 2. Centered Full-Screen Workspace Panel (Direct Sidebar Entry)
+
+With the sidebar entry enabled, open a full-featured 960px centered workspace panel directly from the main sidebar:
+
+![Main Workspace Panel: dedicated sidebar entry expanding 960px centered view](assets/screenshots/main-view-panel.webp)
+
+### 3. Native Sidebar Full-Row Right-Click & Cascading Menus
+
+Right-click directly on any workspace or session row in the primary sidebar to open context menus and cascading workspace migration submenus:
+
+| Workspace Actions (Copy/Open Folder) | Move Session Across Workspaces (Cascading Submenu) |
+| :---: | :---: |
+| <img src="assets/screenshots/workspace-context-menu.webp" alt="Workspace Actions Menu" width="100%"> | <img src="assets/screenshots/session-move-menu.webp" alt="Move Session Menu" width="100%"> |
+
+*Screenshots showcase the core management panels, centered workspace view, and native sidebar context menu enhancements in lossless WebP format.*
 
 ## Installation
 
@@ -203,6 +226,10 @@ Archiving puts a conversation away so you can restore it later. **Permanent dele
 
 Yes. [Codex UI](https://github.com/MichengAI/dsh-codex-ui) keeps its sidebar appearance and interactions. Archive management remains available in **Settings → Archived sessions**.
 
+### Coexisting with other archive plugins
+
+This plugin registers its Settings entry under the section ID `archive-manager`. If other session archive plugins (such as `@linxin666/dsh-session-archive`) are installed at the same time, two distinct "Archived sessions" entries will appear in the settings sidebar. Both can be accessed independently as expected.
+
 For other problems, open an [issue](https://github.com/MichengAI/dsh-archive-manager/issues) with your DSH and plugin versions, reproduction steps, and error details.
 
 ## Install from source

package/README.ru.md

@@ -29,8 +29,16 @@
 - **Очищать записи**: безвозвратно удалять ненужные архивы после подтверждения, отслеживать прогресс пакетной обработки и повторять оставшиеся элементы.
 - **Упорядочивать важные чаты**: сохранять избранное и предпросматривать очистку неактивных, защищая избранное и активную работу.
 - **Очистка сессий-сирот**: автоматически находить и физически удалять остаточные подагенты, чьи родительские сессии были удалены.
+- **Действия по правому клику на всю строку**: правый клик по строке рабочей области или сессии вызывает контекстное меню; для строк без меню сохраняется нативное системное меню.
+- **Стандартизация избранного и сосуществование с точками статуса (#90, #92)**: выравнивание звёздочки до 16×16px с абсолютным позиционированием поверх слота, устраняющее дрожание; при активности сессии нативные индикаторы статуса остаются полностью видимыми, а звёздочка адаптируется в 10px значок в правом нижнем углу.
+- **Быстрые действия рабочей области**: контекстное меню рабочей области позволяет скопировать путь («Копировать папку»), открыть в проводнике («Открыть папку») и заархивировать сессии в один клик.
+- **Перемещение сессии между рабочими областями**: каскадное подменю с блокировкой процессов, атомарной перезаписью, мгновенным прогревом проекций и безопасностью двоеточий IM-сессий в NTFS.
+- **Интегрированные карточки-аккордеоны и ультракомпактные строки 40px**: группировка проектов в едином стиле Skills Manager; высота строк уменьшена до 40px для максимальной плотности информации.
+- **Нативные темные чекбоксы**: возврат к нативным примитивам Checkbox с `accent-color`, идеальное слияние с темным фоном без белых артефактов.
+- **Защита модальных окон от просвечивания и локализация доступности**: модальные окна превью монтируются в body (`portalToBody`) с матовым размытием; кнопки закрытия поддерживают трехъязычные метки (`common.close`).
+- **Стандартизация ID секции и совместимость (#91)**: ID секции настроек обновлен на `archive-manager` с защитой fail-soft `try/catch` для мирного сосуществования с другими плагинами архивации.
 
-> В этом README описан выпуск 1.0.0. Полный список возможностей и границы обновления — в [истории изменений](CHANGELOG.md).
+> В этом README описан выпуск **1.1.18**. Полный список возможностей и границы обновления — в [истории изменений](CHANGELOG.md).
 
 ## Восстановление кеша списков (ещё не выпущено, #88)
 
@@ -53,15 +61,31 @@
 
 ## Скриншоты
 
-Поиск, избранное, предпросмотр, восстановление и очистка — в **Настройки → Архив сессий → Архив**:
+### 1. Панель настроек архива (карточки-аккордеоны и темные чекбоксы)
 
-![Архив: общие фильтры поиска, избранное и восстановление](assets/screenshots/archived-sessions.webp)
+Поиск, избранное, предпросмотр, восстановление и очистка в **Настройки → Архив сессий → Архив** с ультракомпактными строками 40px и нативными чекбоксами:
 
-Переключитесь на **Незаархивированные** для тех же фильтров, предпросмотра очистки неактивных и архивирования по проекту:
+![Архив: общие фильтры поиска, избранное и компактные строки](assets/screenshots/archived-sessions.webp)
 
-![Незаархивированные: очистка неактивных и архивирование по проекту](assets/screenshots/unarchived-sessions.webp)
+Переключитесь на **Незаархивированные** для умной очистки неактивных и пакетного архивирования:
 
-> На скриншотах показана предрелизная сборка с меткой 0.1.44; в этом выпуске — 1.0.0. Боковая панель принадлежит установленному UI-плагину и не отражает новые функции боковой панели в этом выпуске.
+![Незаархивированные: умная очистка неактивных и архивирование проектов](assets/screenshots/unarchived-sessions.webp)
+
+### 2. Главная панель рабочей области (вход с боковой панели)
+
+При включенном пункте боковой панели открывается центрированное представление рабочей области шириной 960px:
+
+![Главная панель: отдельный вход на боковой панели и 960px центрированный вид](assets/screenshots/main-view-panel.webp)
+
+### 3. Нативное контекстное меню боковой панели и каскадное перемещение
+
+Правый клик по строке рабочей области или сессии открывает контекстное меню и каскадное подменю перемещения:
+
+| Быстрые действия рабочей области | Перемещение сессии между проектами |
+| :---: | :---: |
+| <img src="assets/screenshots/workspace-context-menu.webp" alt="Меню рабочей области" width="100%"> | <img src="assets/screenshots/session-move-menu.webp" alt="Меню перемещения сессии" width="100%"> |
+
+*Скриншоты демонстрируют ключевые панели, полноразмерное представление и нативные контекстные меню в формате WebP без потерь.*
 
 ## Предварительные требования
 
@@ -174,6 +198,10 @@ dsh --profile web --dump-config
 
 Да. [Codex UI](https://github.com/MichengAI/dsh-codex-ui) сохраняет свой внешний вид и взаимодействие. Управление архивом остаётся доступным в **Настройки → Архив сессий**.
 
+### Сосуществование с другими плагинами архивации
+
+Этот плагин регистрирует пункт настроек с идентификатором `archive-manager`. Если одновременно установлены другие плагины управления архивом (например, `@linxin666/dsh-session-archive`), в боковой панели настроек появятся два отдельных пункта «Архив сессий». К каждому из них можно получить независимый доступ в настройках, что является ожидаемым поведением.
+
 При других проблемах откройте [issue](https://github.com/MichengAI/dsh-archive-manager/issues) с версиями DSH и плагина, шагами воспроизведения и деталями ошибки.
 
 ## Установка из исходников

package/README.zh-CN.md

@@ -19,7 +19,7 @@
 
 > DSH Archive Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
 
-本文描述 **1.1.10**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
+本文描述 **1.1.17**。已发布变更见[更新日志](CHANGELOG.zh-CN.md)。
 
 ## 功能概览
 
@@ -27,13 +27,20 @@
 
 - **多视图与侧栏直达**：支持开启主侧边栏直接导航入口，在主工作区以 **960px 居中版心** 展开「已归档」与「未归档」完整大面板，告别狭窄弹窗。
 - **全生命周期管理**：支持单条会话归档、全工作区一键归档、跨项目批量归档、单条/批量恢复并打开会话。
+- **侧栏全行右键操作**：支持直接右键点击侧栏工作区行或会话行空白处唤起专属操作菜单；未分组工作区行与空白未落盘会话行优雅放行系统原生右键菜单，杜绝误触新建或星标。
+- **侧栏星标对齐与状态点共存（#90, #92）**：收藏星标对齐 16×16px 宿主标准尺寸，通过绝对定位精确复用前导插槽位置，消除侧栏会话标题左右微小抖动；当会话处于运行中或等待交互时，原生状态指示点保持 100% 可见，星标自适应转为右下角 10px 金色角标，实现状态与收藏完美共存，保护原生选择器与第三方皮肤插件兼容性。
+- **工作区快捷操作菜单**：侧栏工作区提供快速「复制目录」、「打开目录」（在系统文件管理器 Windows Explorer / macOS Finder 中直接打开）及一键「归档会话」。
+- **会话跨工作区移动**：会话操作菜单支持级联悬停子菜单直接跨工作区迁移会话，采用进程锁静默停靠与原子级改写校验，投影缓存即时预热彻底消除临时“未命名”，安全兼容含冒号的 IM 会话。
+- **一体化抽屉与 40px 超紧凑列表**：工作区分组采用与技能管理同款的一体化卡片抽屉设计，折叠顶栏（高 38px）与下方列表融为一体；会话列表项行高超紧凑化至 40px，信息密度显著提升。
+- **暗黑模式原生复选框规范**：复选框严格回归宿主原生原语 Checkbox 规范，使用原生 `accent-color` 完美适配深色模式（深暗底色与品牌蓝选中态），根除白底白勾刺眼方块 bug。
+- **模态弹窗防穿透与本地化无障碍**：宽版预览弹窗直挂 body 根节点消除局部包含块限制，配合实色底与毛玻璃高斯模糊彻底杜绝文字穿透重叠；全量弹窗右上角 X 关闭按钮完整支持三语本地化无障碍标签（`common.close`）。
 - **纯净自适应单行工具栏**：采用宿主原生 `Input` 原语，内置官方放大镜图标与绿色呼吸聚焦边框，自适应弹性撑满；控件按「输入框、查询条件、所有项目、时间选择」极简单行排列，锁死盒模型杜绝溢出重叠。
 - **全文联合检索与 Codex 复合菜单**：默认自动联合搜索标题与正文历史（用户与助手消息）；将会话筛选（全部/只看收藏）与排序收归为 Codex 风格两段式复合菜单，完全采用宿主原生对勾原语。
 - **轻量单字段日期胶囊与日历浮层**：彻底告别原生日期选择器的暗黑模式反白与失焦缺陷（#74），单行展示时间范围；浮层支持快捷预设、中英俄三语原生排版，以及完备的 WAI-ARIA 键盘无障碍漫游（上下左右键、Home/End、PageUp/Down 及月末夹紧）与高亮区间实时拉伸预览。
 - **智能闲置会话整理**：自定义闲置天数，自动分析并排除正在运行、等待交互及已收藏的关键会话，支持预览候选后确认归档，并提供误操作撤回机制。
-- **原生侧边栏菜单注入**：在原生侧栏工作区 `...` 菜单中安全注入「归档会话」项，弹出锚定工作区行的毛玻璃二次确认框，严格遵循「所见即所归」原则。
 - **永久彻底清理**：确认后永久删除不再需要的会话，彻底清除物理日志、索引与缓存，支持错误项独立重试。
 - **无主孤儿子代理检测与物理清理**：自动探测母会话已被外部物理删除的残留子代理，在会话整理中直观展示空间占用并支持一键物理释放。
+- **设置页 ID 规范与第三方插件共存（#91）**：设置页注册 ID 调整为团队统一规范的 `archive-manager` 并带 fail-soft 运行时保护，支持与社区第三方归档插件和平共存。
 - **可控在线更新与反向代理适配**：提供独立在线更新开关与企业级宿主配置硬锁定；原生适配反代子路径前缀部署。
 
 ## 手动重建列表缓存（#88）
@@ -61,15 +68,31 @@
 
 ## 界面预览
 
-在「设置 → 归档会话 → 已归档」检索、收藏、预览、恢复和清理：
+### 1. 归档设置管理面板（一体化抽屉与暗黑模式适配）
 
-![已归档会话：统一检索筛选、收藏与恢复](assets/screenshots/archived-sessions.webp)
+在「设置 → 归档会话 → 已归档」体验一体化抽屉卡片、40px 超紧凑行高、原生暗黑 Checkbox 及统一检索筛选：
 
-切换到「未归档」，使用相同筛选条件整理会话，预览闲置归档或按项目批量归档：
+![已归档会话：统一检索筛选、收藏与超紧凑列表](assets/screenshots/archived-sessions.webp)
 
-![未归档会话：闲置整理与项目归档](assets/screenshots/unarchived-sessions.webp)
+切换到「未归档」，智能分析并预选闲置会话，支持一键安全归档与项目批量操作：
 
-*截图展示核心功能面板，包含已归档会话检索筛选与未归档闲置整理。采用无损 WebP 格式。*
+![未归档会话：智能闲置整理与项目批量归档](assets/screenshots/unarchived-sessions.webp)
+
+### 2. 主工作区大面板（侧边栏直达）
+
+开启侧边栏入口后，点击左侧主导航即可在主工作区以 960px 居中版心展开完整大面板：
+
+![主工作区大面板：侧边栏独立入口展开 960px 居中视图](assets/screenshots/main-view-panel.webp)
+
+### 3. 原生侧边栏全行右键与级联菜单
+
+在侧边栏任意工作区行或会话行上直接右键，即可唤起快捷操作菜单与跨工作区移动级联子菜单：
+
+| 工作区快捷菜单（复制/打开目录） | 会话跨工作区移动（悬停级联） |
+| :---: | :---: |
+| <img src="assets/screenshots/workspace-context-menu.webp" alt="工作区操作菜单" width="100%"> | <img src="assets/screenshots/session-move-menu.webp" alt="会话移动菜单" width="100%"> |
+
+*截图展示核心功能面板、主工作区大视图与侧边栏原生右键增强，采用高保真无损 WebP 格式。*
 
 ## 安装
 
@@ -207,6 +230,10 @@ dsh --profile web --dump-config
 
 可以。保留 [Codex UI](https://github.com/MichengAI/dsh-codex-ui) 的侧栏样式和交互，归档管理仍在「设置 → 归档会话」中。
 
+### 与其他归档插件共存说明
+
+本插件设置页入口注册 ID 为 `archive-manager`。若当前环境同时安装了其他归档管理插件（例如 `@linxin666/dsh-session-archive`），设置侧边栏中会出现两个各自独立的「已归档会话」入口，均可在设置中正常访问，这属于正常预期表现。
+
 遇到其他问题，请提交 [Issue](https://github.com/MichengAI/dsh-archive-manager/issues)，附上 DSH 与插件版本、复现步骤和错误信息。
 
 ## 从源码安装

package/assets/icon.svg

@@ -0,0 +1,19 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="dsh_svg_arch_g" x1="6" y1="8" x2="30" y2="28" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#10B981"/>
+      <stop offset="1" stop-color="#059669"/>
+    </linearGradient>
+  </defs>
+  <!-- Card Extracted from Box -->
+  <rect x="11" y="6" width="14" height="10" rx="2" fill="#E6FFFA" stroke="#10B981" stroke-width="1.8"/>
+  <line x1="14" y1="10" x2="22" y2="10" stroke="#10B981" stroke-width="1.8" stroke-linecap="round"/>
+  <!-- Archive Drawer Body -->
+  <rect x="6" y="13" width="24" height="17" rx="3.5" fill="url(#dsh_svg_arch_g)"/>
+  <!-- Drawer Face Panel -->
+  <rect x="8.5" y="15.5" width="19" height="12" rx="2" fill="#047857" fill-opacity="0.3"/>
+  <!-- Drawer Pull Handle -->
+  <rect x="14" y="19" width="8" height="3" rx="1.5" fill="#FFFFFF"/>
+  <!-- Extraction Arrow -->
+  <path d="M18 4L15 7M18 4L21 7" stroke="#10B981" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>