@michengai/dsh-archive-manager 1.1.22 → 1.2.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 Published release notes are retained below; new versions are added without removing earlier entries.
 
+## 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,14 @@
 
 以下发布说明会持续保留；新增版本时不再删除较早记录。
 
+## 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`）