@michengai/dsh-archive-manager 1.1.22 → 1.2.3

package/CHANGELOG.md

@@ -4,6 +4,23 @@
 
 Published release notes are retained below; new versions are added without removing earlier entries.
 
+## 1.2.3 - 2026-11-03
+
+- **Compatibility with latest DSH Web (0.2.2-alpha.3+) and context menu overhaul**:
+  - Fixes missing session context menu actions (delete session, favorite, move to workspace) under the latest Web host;
+  - Fixes missing workspace context menu items ("Archive workspace sessions", "Copy workspace path", etc.);
+  - Seamlessly integrates workspace actions into the host's native context menu system with reactive session count updates and native icon styling;
+  - Hardens icon registration and session lifecycle integration across varying host setups and sidebar combinations with safe fallbacks;
+  - Fully retains backward compatibility across all previously supported host releases.
+
+## 1.2.0 - 2026-11-03
+
+- **Entry placement upgraded to 3-state control** (#103):
+  - Replaces the single sidebar toggle in plugin settings with a native 3-state segmented control (All locations / Sidebar only / Settings only), preventing accidental panel loss caused by disabling both entry points;
+  - Choosing "Sidebar only" unregisters the "Archived sessions" entry from the settings dialog for a cleaner settings view;
+  - Shows an inline error message when saving entry placement fails, preventing silent rollbacks;
+  - Automatically migrates existing configurations seamlessly with full backward compatibility.
+
 ## 1.1.22 - 2026-10-30
 
 - Add folder icons beside workspace names in the “Move to workspace” submenu, making destination workspaces easier to recognize.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,23 @@
 
 以下发布说明会持续保留；新增版本时不再删除较早记录。
 
+## 1.2.3 - 2026-11-03
+
+- **兼容 DSH Web 最新版本（0.2.2-alpha.3+）与上下文菜单重构**：
+  - 修复在新版 Web 宿主下侧边栏会话右键菜单（删除会话、收藏、移动工作区）未正常展示的问题；
+  - 修复工作区操作菜单中「归档工作区会话」、「复制工作区路径」等操作未正常展示的问题；
+  - 工作区操作菜单全面适配宿主原生上下文菜单体系，支持实时感知会话变动并自动对齐宿主原生图标与快捷交互；
+  - 加强菜单图标与会话生命周期在不同宿主定制环境与侧栏组合下的自适应加载与容错保护；
+  - 完整向后兼容所有已支持的旧版本宿主。
+
+## 1.2.0 - 2026-11-03
+
+- **入口展示位置升级为三选一设置**（#103）：
+  - 在插件配置页将原有的侧边栏单选开关升级为原生分段选择器，支持选择「两边显示」、「仅侧边栏」或「仅设置」，彻底解决两处同时关闭可能导致的面板失联问题；
+  - 选择「仅侧边栏」时，系统设置弹窗中的「归档会话」菜单项会自动隐藏注销，保持设置界面整洁；
+  - 保存入口展示位置失败时在界面直接显示错误提示，不再静默回弹；
+  - 自动向后兼容旧版配置，已有配置无需重新设置。
+
 ## 1.1.22 - 2026-10-30
 
 - 在「移动到工作区」子菜单的工作区名称旁增加文件夹图标，方便识别目标工作区。

package/README.md

@@ -123,15 +123,18 @@ Restart DSH Web, then refresh the page (or hard-refresh with `Ctrl+Shift+R`). Op
 The plugin follows standard DSH bundle configuration conventions. Options are located at:
 > **Sidebar → Plugins → Click `Archive Manager`** (the host's `plugins.bundle.config` slot).
 
-Two native switches are available:
-
-### 1. Sidebar Entry (`sidebarEntry`)
-- **Default**: Disabled (`false`)
-- **Description**: Displays a persistent **Archive** navigation icon in the host's left primary sidebar under **Plugins**.
+Native configuration options are available:
+
+### 1. Entry Location (`entryLocation`)
+- **Options**:
+  - **All locations (`both`)**: Displays the Archive navigation icon in the left sidebar and keeps the menu entry under **Settings → Archived sessions**.
+  - **Sidebar only (`sidebar`)**: Displays the Archive navigation icon in the left sidebar and unregisters the settings section for a streamlined settings dialog.
+  - **Settings only (`settings`)** (Default): Keeps the entry under **Settings → Archived sessions** while maintaining a minimal sidebar.
+- **Fail-safe Guarantee**: A mutually-exclusive 3-state segmented control ensures at least one entry point is always accessible, preventing accidental orphan states.
 - **Effect**:
-  - 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;
-  - When disabled, unregisters the sidebar entry cleanly (and resets the active panel gracefully if currently viewing the panel, preventing blank views);
-  - The standard **Settings → Archived sessions** view remains active either way, and state is synchronized live across both entry points.
+  - When the sidebar is enabled, clicking the icon opens 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;
+  - When switching to **Settings only**, safely unregisters the sidebar entry (and resets the active panel gracefully if currently viewing the panel, preventing blank views);
+  - Backward compatible with legacy `sidebarEntry` boolean settings (`true` maps to `both`, `false` maps to `settings`).
 
 ### 2. Online Updates (`onlineUpdate` / `updater`)
 - **Default**: Enabled (`true`)

package/README.zh-CN.md

@@ -127,15 +127,18 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 插件遵循 DSH 官方扩展配置规范，配置项位于：
 > **主界面侧边栏「插件」→ 点击 `Archive Manager` 详情页**（对应宿主 `plugins.bundle.config` 槽位）。
 
-此处提供两个原生扁平行开关：
-
-### 1. 侧边栏入口 (`sidebarEntry`)
-- **默认状态**：关闭（`false`）
-- **功能说明**：在宿主左侧主导航栏的「插件」下方增加常驻的 **「归档」** 图标入口。
+此处提供原生配置项：
+
+### 1. 入口展示位置 (`entryLocation`)
+- **选项范围**：
+  - **全部显示 (`both`)**：在左侧主导航栏显示「归档」图标，同时在「设置 → 归档会话」中保留菜单。
+  - **仅侧边栏 (`sidebar`)**：仅在左侧主导航栏显示「归档」图标，设置菜单中自动卸载隐藏，界面更精炼。
+  - **仅设置 (`settings`)**（默认）：仅在「设置 → 归档会话」中显示，侧边栏保持极简。
+- **防止失联保障**：采用互斥的三选一分段选择器，杜绝两处入口同时关闭导致面板失联的痛点。
 - **生效效果**：
-  - 开启后，在侧边栏点击即可直达归档中心，并在主工作区以 **960px 居中版心**（对齐官方插件管理与市场规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
-  - 关闭后安全注销侧栏槽位（若当前正停留在归档大面板，会自动安全切回默认视图，防止悬空和白屏）；
-  - 无论是否开启侧栏入口，DSH 原有的「设置 → 归档会话」入口始终保留，两处界面数据与操作 100% 实时同步。
+  - 侧边栏开启时，点击即可直达归档中心，并在主工作区以 **960px 居中版心**（对齐官方插件管理与市场规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
+  - 切换为「仅设置」关闭侧栏时安全注销侧栏槽位（若当前正停留在归档大面板，会自动安全切回默认视图，防止悬空和白屏）；
+  - 向后完全兼容旧版 `sidebarEntry` 配置（`true` 自动映射为 `both`，`false` 自动映射为 `settings`）。
 
 ### 2. 在线更新 (`onlineUpdate` / `updater`)
 - **默认状态**：开启（`true`）