@michengai/dsh-archive-manager 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -2,7 +2,23 @@
 
 [简体中文](CHANGELOG.zh-CN.md)
 
-The five most recent published versions are listed below.
+Published release notes are retained below; new versions are added without removing earlier entries.
+
+## 0.1.15 — 2026-08-26
+
+- Hardened permanent deletion so missing transcripts clear stale archive, workspace, spill, and projection-cache data while failed physical deletion remains retryable.
+- Cleared workspace and projection-cache tombstones when a session ID is reused, preventing valid replacement sessions from being blocked.
+- Corrected batch deletion feedback and duplicate restore submission handling, and aligned client batch counts with the host's authoritative archive set.
+
+Published package: [`@michengai/dsh-archive-manager@0.1.15`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.15).
+
+## 0.1.14 — 2026-08-24
+
+- Added project-scoped batch restore and permanent deletion, plus a page-level **Restore all** action.
+- Added archived-chat sorting by last update, creation time, or title, backed by authoritative host creation metadata.
+- Added confirmation, success, and partial-failure feedback for batch archive operations.
+
+Published package: [`@michengai/dsh-archive-manager@0.1.14`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.14).
 
 ## 0.1.13 — 2026-08-23
 

package/CHANGELOG.zh-CN.md

@@ -2,7 +2,23 @@
 
 [English](CHANGELOG.md)
 
-以下记录最近发布的五个版本。
+以下发布说明会持续保留；新增版本时不再删除较早记录。
+
+## 0.1.15 — 2026-08-26
+
+- 加固永久删除流程：转录已缺失时清理陈旧归档标记、工作区记账、spill 和投影缓存，物理删除失败时仍可重试。
+- 会话 ID 被复用时同步撤销工作区与投影缓存墓碑，避免合法的新会话生命周期被阻断。
+- 修正批量删除反馈和单条恢复重复提交，并使客户端批量计数与宿主权威归档集合保持一致。
+
+发布包：[`@michengai/dsh-archive-manager@0.1.15`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.15)。
+
+## 0.1.14 — 2026-08-24
+
+- 新增项目级批量恢复和永久删除，并在页面顶部增加「全部恢复」。
+- 新增按更新时间、创建时间或标题排序归档聊天；创建时间来自宿主权威元数据。
+- 为批量归档操作新增确认、成功和部分失败反馈。
+
+发布包：[`@michengai/dsh-archive-manager@0.1.14`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.14)。
 
 ## 0.1.13 — 2026-08-23
 

package/README.md

@@ -8,7 +8,7 @@
 
   **Safely manage archived sessions in DeepSeek Harness**
 
-  [简体中文](README.zh-CN.md) · [Apache-2.0](LICENSE)
+  [简体中文](README.zh-CN.md) · [Changelog](CHANGELOG.md) · [Apache-2.0](LICENSE)
 
   [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-archive-manager.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
@@ -22,9 +22,11 @@
 ## Features
 
 - Archive a session from the sidebar session menu.
-- Search archived chats and filter them by workspace in **Settings → Archived**.
-- Restore a session to its original workspace with **Unarchive**.
-- Permanently delete a confirmed session, its workspace association, archive marker, and projection cache.
+- Search archived chats, sort them by update time, creation time, or title, and filter them by workspace in **Settings → Archived**.
+- Restore a session to its original workspace with **Unarchive**.
+- Restore or permanently delete every archived chat in a project group.
+- Restore all archived chats from the page header.
+- Permanently delete a confirmed session, its workspace association, archive marker, and projection cache.
 - Delete all archived chats after confirmation, including child agents.
 - Remove unloaded deleted sessions from connected sidebars immediately.
 - Paste one sentence into DSH, Codex, or WorkBuddy and let that agent install the plugin locally.
@@ -35,7 +37,7 @@ Open the sidebar session menu and choose **Archive session**:
 
 ![Archive a session from the session menu](assets/screenshots/archive-session-menu.png)
 
-Search, filter by project, unarchive, or permanently delete chats in **Settings → Archived**:
+Search, sort, filter by project, unarchive, or permanently delete chats in **Settings → Archived**:
 
 ![Archived chats settings page](assets/screenshots/archived-sessions.png)
 
@@ -103,7 +105,7 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 dsh --profile web --dump-config
 ```
 
-To pin a release, replace `@latest` with a version such as `@0.1.8`.
+To pin a release, replace `@latest` with a specific version such as `@x.y.z`.
 
 The configuration output should contain `workspace-archive-manager` and `ui-workspace-archive-manager`. Restart DSH Web and hard-refresh the browser. Do not copy client files manually: the Settings page and archive menu need the mounted plugin.
 
@@ -129,9 +131,10 @@ Restart DSH Web and hard-refresh the browser. `dsh plugin ... add .` reads the p
 
 1. Open the sidebar session menu and choose **Archive session**.
 2. Open **Settings → Archived** to inspect sessions by workspace.
-3. Use the search box or project filter to narrow the list.
-4. Select **Unarchive** to restore a session, or use the delete icon to remove it permanently.
-5. Confirm deletion. **It cannot be undone.**
+3. Search by title, sort by update time, creation time, or title, or filter the list by project.
+4. Select **Unarchive** to restore one session, or select **Restore all** in the page header.
+5. Open a project heading's action menu to restore or delete all of that project's archived chats.
+6. Use the delete icon to remove one session permanently, then confirm the deletion. **It cannot be undone.**
 
 If the entry is missing after installation or upgrade, restart DSH Web and hard-refresh the browser. It is located directly after **Connectors** in Settings.
 
@@ -183,4 +186,4 @@ Licensed under [Apache License 2.0](LICENSE).
 
 ## Changelog
 
-See [CHANGELOG.md](CHANGELOG.md) for the five most recent releases.
+See [CHANGELOG.md](CHANGELOG.md) for retained release notes.

package/README.zh-CN.md

@@ -8,7 +8,7 @@
 
   **在 DeepSeek Harness 中安全管理已归档会话**
 
-  [English](README.md) · [Apache-2.0](LICENSE)
+  [English](README.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
 
   [![许可证：Apache-2.0](https://img.shields.io/badge/许可证-Apache--2.0-blue.svg)](LICENSE)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-archive-manager.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
@@ -22,9 +22,11 @@
 ## 功能概览
 
 - 在侧栏会话菜单中选择「归档会话」。
-- 在「设置 → 已归档」按工作区查看归档会话，并支持搜索和按项目筛选。
-- 安全取消归档，将会话恢复到原工作区位置。
-- 经确认后永久删除会话、工作区归属、归档标记和投影缓存。
+- 在「设置 → 已归档」按工作区查看归档会话，并支持搜索、按更新时间/创建时间/标题排序和按项目筛选。
+- 安全取消归档，将会话恢复到原工作区位置。
+- 在项目分组中批量恢复或永久删除该项目的全部已归档聊天。
+- 在页面顶部一键恢复全部已归档聊天。
+- 经确认后永久删除会话、工作区归属、归档标记和投影缓存。
 - 经确认后删除全部已归档聊天，包含子代理。
 - 已删除的未加载归档会话会立即从已连接客户端的侧栏移除。
 - 可把一句话复制到 DSH、Codex 或 WorkBuddy，让对方代装到本机 DSH。
@@ -35,7 +37,7 @@
 
 ![从会话菜单归档会话](assets/screenshots/archive-session-menu.png)
 
-在「设置 → 已归档」中搜索、按项目筛选、取消归档或永久删除：
+在「设置 → 已归档」中搜索、排序、按项目筛选、取消归档或永久删除：
 
 ![已归档聊天设置页面](assets/screenshots/archived-sessions.png)
 
@@ -103,7 +105,7 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 dsh --profile web --dump-config
 ```
 
-需要钉死某一版时，把 `@latest` 换成具体版本，例如 `@0.1.8`。
+需要钉死某一版时，把 `@latest` 换成具体版本，例如 `@x.y.z`。
 
 配置输出中应包含 `workspace-archive-manager` 与 `ui-workspace-archive-manager`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页和归档菜单不会被挂载。
 
@@ -129,9 +131,10 @@ dsh --profile web --dump-config
 
 1. 在侧栏右键或打开会话菜单，选择「归档会话」。
 2. 打开「设置 → 已归档」，按工作区查看归档会话。
-3. 用搜索框或项目筛选收窄列表。
-4. 点击「取消归档」恢复会话；点击删除图标永久移除会话。
-5. 删除前确认提示。**删除无法撤销。**
+3. 按标题搜索，按更新时间、创建时间或标题排序，或按项目筛选列表。
+4. 点击「取消归档」恢复单个会话，或在顶部点击「全部恢复」。
+5. 打开项目标题右侧菜单，可恢复或删除该项目的全部已归档聊天。
+6. 点击删除图标永久移除单个会话；删除前确认提示。**删除无法撤销。**
 
 安装或升级后找不到入口时，重启 DSH Web 并硬刷新浏览器；入口位于「设置」中，连接器之后。
 
@@ -183,4 +186,4 @@ pnpm pack:check
 
 ## 更新日志
 
-最近五个发布版本见 [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md)。
+完整保留的发布说明见 [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md)。

package/lib/client.js

@@ -29,12 +29,45 @@ window.__ModuleLoader__.load({
 				return value;
 			}
 		};
-		const deletedSchema = {
-			parse(value) {
-				if (typeof value !== "object" || value === null || Array.isArray(value) || value.deleted !== true) throw new TypeError("deleted must be true");
-				return value;
-			}
-		};
+		const deletedSchema = {
+			parse(value) {
+				if (typeof value !== "object" || value === null || Array.isArray(value) || value.deleted !== true) throw new TypeError("deleted must be true");
+				return value;
+			}
+		};
+		const archivedBatchTargetSchema = {
+			parse(value) {
+				if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("target must be an object");
+				if (value.scope === "all" || value.scope === "ungrouped") return value;
+				if (value.scope === "workspace" && typeof value.workspaceId === "string" && value.workspaceId.length > 0) return value;
+				throw new TypeError("target.scope must be all, ungrouped, or workspace with a non-empty workspaceId");
+			}
+		};
+		const unarchivedBatchSchema = {
+			parse(value) {
+				if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("result must be an object");
+				if (!Array.isArray(value.archivedSessionIds) || value.archivedSessionIds.some((id) => typeof id !== "string")) throw new TypeError("archivedSessionIds must be a string array");
+				if (!Array.isArray(value.unarchivedSessionIds) || value.unarchivedSessionIds.some((id) => typeof id !== "string")) throw new TypeError("unarchivedSessionIds must be a string array");
+				return value;
+			}
+		};
+		const deletedBatchSchema = {
+			parse(value) {
+				if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("result must be an object");
+				for (const key of ["requestedSessionIds", "deletedSessionIds", "skippedSessionIds"]) {
+					if (!Array.isArray(value[key]) || value[key].some((id) => typeof id !== "string")) throw new TypeError(`${key} must be a string array`);
+				}
+				if (!Array.isArray(value.failures) || value.failures.some((failure) => typeof failure !== "object" || failure === null || typeof failure.sessionId !== "string" || typeof failure.message !== "string")) throw new TypeError("failures must contain sessionId/message objects");
+				return value;
+			}
+		};
+		const archivedSessionMetadataSchema = {
+			parse(value) {
+				if (typeof value !== "object" || value === null || Array.isArray(value) || !Array.isArray(value.items)) throw new TypeError("result.items must be an array");
+				if (value.items.some((item) => typeof item !== "object" || item === null || typeof item.sessionId !== "string" || typeof item.createdAt !== "number" || !Number.isFinite(item.createdAt))) throw new TypeError("items must contain sessionId/createdAt objects");
+				return value;
+			}
+		};
 		/**
 		* 客户端通过 `ctx.remote.$mount` 注册 workspaceRegistry 的远程方法。
 		* 调用走 typert gateway SRC 路径，不影响既有 `/api/workspace.*` 网关。
@@ -61,8 +94,8 @@ window.__ModuleLoader__.load({
 					},
 					sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
 				},
-				{
-					id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteSession",
+				{
+					id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteSession",
 					service: "workspaceRegistry",
 					namespace: "workspaceRegistry",
 					method: "deleteSession",
@@ -78,8 +111,60 @@ window.__ModuleLoader__.load({
 						typeSymbol: "@michengai/dsh-archive-manager/types#Deleted",
 						schema: deletedSchema
 					},
-					sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
-				}
+					sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+				},
+				{
+					id: "@michengai/dsh-archive-manager#workspaceRegistry/unarchiveSessions",
+					service: "workspaceRegistry",
+					namespace: "workspaceRegistry",
+					method: "unarchiveSessions",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "target",
+						wire: "target",
+						source: "json",
+						codec: { mode: "strict", typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedBatchTarget", schema: archivedBatchTargetSchema }
+					}],
+					result: {
+						mode: "strict",
+						typeSymbol: "@michengai/dsh-archive-manager/types#UnarchivedBatch",
+						schema: unarchivedBatchSchema
+					},
+					sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+				},
+				{
+					id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteArchivedSessions",
+					service: "workspaceRegistry",
+					namespace: "workspaceRegistry",
+					method: "deleteArchivedSessions",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "target",
+						wire: "target",
+						source: "json",
+						codec: { mode: "strict", typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedBatchTarget", schema: archivedBatchTargetSchema }
+					}],
+					result: {
+						mode: "strict",
+						typeSymbol: "@michengai/dsh-archive-manager/types#DeletedBatch",
+						schema: deletedBatchSchema
+					},
+					sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+				},
+				{
+					id: "@michengai/dsh-archive-manager#workspaceRegistry/archivedSessionMetadata",
+					service: "workspaceRegistry",
+					namespace: "workspaceRegistry",
+					method: "archivedSessionMetadata",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: {
+						mode: "strict",
+						typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedSessionMetadata",
+						schema: archivedSessionMetadataSchema
+					},
+					sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+				}
 			]
 		};
 		/** Archived-session row presentation classes (theme-token driven). */
@@ -2107,9 +2192,7 @@ window.__ModuleLoader__.load({
 				setDeletingSession(true);
 				setDeleteSessionError(null);
 				const rootId = deleteSessionTarget.sessionId;
-				(async () => {
-					await deleteSession(rootId);
-				})().then(() => {
+				deleteSession(rootId).then(() => {
 					setDeletingSession(false);
 					setDeleteSessionTarget(null);
 					setDeleteSessionCommittedId(rootId);
@@ -2495,7 +2578,8 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region dsh-archive-manager: settings section
-		const ARCHIVE_SETTINGS_CSS = ".dsham_settings{box-sizing:border-box;width:min(100%,760px);margin:0 auto;padding:0 0 32px;color:var(--dsw-alias-label-primary)}.dsham_settingsHeader{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;margin-bottom:12px}.dsham_settings h2{margin:0;font-size:20px;font-weight:650;letter-spacing:-.2px;line-height:28px}.dsham_settingsIntro{margin:4px 0 0;max-width:42em;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}.dsham_settingsDanger{display:inline-flex;align-items:center;gap:6px;min-height:32px;padding:0 12px;color:var(--dsw-alias-state-error-primary);background:transparent;border:1px solid var(--dsw-alias-state-error-primary);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;font-weight:500}.dsham_settingsDanger:hover{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 20%,transparent)}.dsham_settingsToolbar{display:flex;gap:8px;margin-bottom:16px}.dsham_settingsSearch{display:flex;align-items:center;gap:8px;min-width:0;flex:1;height:32px;padding:0 12px;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-layer-3,var(--dsw-alias-button-elevated-fill));border:1px solid var(--dsw-alias-border-l2);border-radius:8px}.dsham_settingsSearch:focus-within{border-color:var(--dsw-alias-label-tertiary)}.dsham_settingsSearch input{width:100%;min-width:0;padding:0;color:var(--dsw-alias-label-primary);background:transparent;border:0;outline:0;font:inherit;font-size:12px}.dsham_settingsSearch input::placeholder{color:var(--dsw-alias-label-tertiary)}.dsham_settingsFilter{position:relative;min-width:168px;flex:none}.dsham_selectTrigger{box-sizing:border-box;display:flex;align-items:center;justify-content:space-between;gap:8px;width:100%;min-height:32px;padding:0 10px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-3,var(--dsw-alias-button-elevated-fill));border:1px solid var(--dsw-alias-border-l2);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;line-height:20px;text-align:left}.dsham_selectTrigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.dsham_selectTrigger:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}.dsham_selectTrigger[aria-expanded='true']{border-color:var(--dsw-alias-state-success-primary)}.dsham_selectValue{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dsham_selectCaret{flex:none;width:12px;height:12px;color:var(--dsw-alias-label-tertiary)}.dsham_selectMenu{position:absolute;top:calc(100% + 4px);left:0;right:0;z-index:30;box-sizing:border-box;min-width:100%;max-height:280px;overflow:auto;padding:4px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-specific-menu,var(--dsw-alias-bg-layer-2));box-shadow:var(--dsw-shadow-lv3)}.dsham_selectOption{box-sizing:border-box;display:flex;align-items:center;width:100%;min-height:32px;padding:0 10px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;line-height:20px;text-align:left;cursor:pointer}.dsham_selectOption:hover,.dsham_selectOption[data-active='true']{background:var(--dsw-alias-interactive-bg-hover)}.dsham_selectOption[aria-selected='true']{color:var(--dsw-alias-state-success-primary)}.dsham_settingsGroup{margin:0 0 20px}.dsham_settingsGroupHeading{display:flex;align-items:center;justify-content:space-between;gap:12px;margin:0 0 14px}.dsham_settingsGroupTitle{display:flex;align-items:center;gap:8px;min-width:0;margin:0;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600}.dsham_settingsGroupTitle svg{flex:none;color:var(--dsw-alias-label-secondary)}.dsham_settingsCount{flex:none;color:var(--dsw-alias-label-tertiary);font-size:12px}.dsham_settingsList{overflow:hidden;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-button-elevated-fill))}.dsham_settingsRow{display:flex;align-items:center;gap:12px;min-height:60px;padding:10px 16px;border-bottom:1px solid var(--dsw-alias-border-l2)}.dsham_settingsRow:last-child{border-bottom:0}.dsham_settingsContent{min-width:0;flex:1}.dsham_settingsTitle{overflow:hidden;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600;line-height:18px;text-overflow:ellipsis;white-space:nowrap}.dsham_settingsMeta{margin-top:2px;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:16px}.dsham_settingsActions{display:flex;align-items:center;gap:8px}.dsham_settingsAction{min-height:32px;padding:0 12px;color:var(--dsw-alias-label-primary);background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;font-weight:500}.dsham_settingsAction:hover{filter:brightness(1.12)}.dsham_settingsDelete{display:flex;align-items:center;justify-content:center;width:28px;height:28px;color:var(--dsw-alias-label-tertiary);background:transparent;border:0;border-radius:8px;cursor:pointer}.dsham_settingsDelete:hover{color:var(--dsw-alias-state-error-primary);background:var(--dsw-alias-interactive-bg-hover)}.dsham_settingsEmpty{padding:28px 8px;color:var(--dsw-alias-label-secondary);text-align:center}.dsham_settingsError{margin-top:10px;color:var(--dsw-alias-state-error-primary);font-size:12px}@media(max-width:720px){.dsham_settings{width:100%;margin:28px auto 48px;padding:0 16px}.dsham_settingsHeader{margin-bottom:28px}.dsham_settingsToolbar{flex-wrap:wrap;margin-bottom:28px}.dsham_settingsSearch{flex-basis:100%}.dsham_settingsFilter{flex:1;min-width:0}.dsham_settingsGroup{margin-bottom:32px}.dsham_settingsRow{padding:10px 12px}.dsham_settingsActions{gap:4px}}";
+		const ARCHIVE_SETTINGS_CSS = ".dsham_settings{box-sizing:border-box;width:min(100%,760px);margin:0 auto;padding:0 0 32px;color:var(--dsw-alias-label-primary)}.dsham_settingsHeader{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;margin-bottom:12px}.dsham_settings h2{margin:0;font-size:20px;font-weight:650;letter-spacing:-.2px;line-height:28px}.dsham_settingsIntro{margin:4px 0 0;max-width:42em;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}.dsham_settingsDanger{display:inline-flex;align-items:center;gap:6px;min-height:32px;padding:0 12px;color:var(--dsw-alias-state-error-primary);background:transparent;border:1px solid var(--dsw-alias-state-error-primary);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;font-weight:500}.dsham_settingsDanger:hover{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 20%,transparent)}.dsham_settingsToolbar{display:flex;gap:8px;margin-bottom:16px}.dsham_settingsSearch{display:flex;align-items:center;gap:8px;min-width:0;flex:1;height:32px;padding:0 12px;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-layer-3,var(--dsw-alias-button-elevated-fill));border:1px solid var(--dsw-alias-border-l2);border-radius:8px}.dsham_settingsSearch:focus-within{border-color:var(--dsw-alias-label-tertiary)}.dsham_settingsSearch input{width:100%;min-width:0;padding:0;color:var(--dsw-alias-label-primary);background:transparent;border:0;outline:0;font:inherit;font-size:12px}.dsham_settingsSearch input::placeholder{color:var(--dsw-alias-label-tertiary)}.dsham_settingsFilter{position:relative;min-width:168px;flex:none}.dsham_selectTrigger{box-sizing:border-box;display:flex;align-items:center;justify-content:space-between;gap:8px;width:100%;min-height:32px;padding:0 10px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-3,var(--dsw-alias-button-elevated-fill));border:1px solid var(--dsw-alias-border-l2);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;line-height:20px;text-align:left}.dsham_selectTrigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.dsham_selectTrigger:focus-visible{outline:2px solid var(--dsw-alias-state-success-primary);outline-offset:2px}.dsham_selectTrigger[aria-expanded='true']{border-color:var(--dsw-alias-state-success-primary)}.dsham_selectValue{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dsham_selectCaret{flex:none;width:12px;height:12px;color:var(--dsw-alias-label-tertiary)}.dsham_selectMenu{position:absolute;top:calc(100% + 4px);left:0;right:0;z-index:30;box-sizing:border-box;min-width:100%;max-height:280px;overflow:auto;padding:4px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-specific-menu,var(--dsw-alias-bg-layer-2));box-shadow:var(--dsw-shadow-lv3)}.dsham_selectOption{box-sizing:border-box;display:flex;align-items:center;width:100%;min-height:32px;padding:0 10px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;line-height:20px;text-align:left;cursor:pointer}.dsham_selectOption:hover,.dsham_selectOption[data-active='true']{background:var(--dsw-alias-interactive-bg-hover)}.dsham_selectOption[aria-selected='true']{color:var(--dsw-alias-state-success-primary)}.dsham_settingsGroup{margin:0 0 20px}.dsham_settingsGroupHeading{display:flex;align-items:center;justify-content:space-between;gap:12px;margin:0 0 14px}.dsham_settingsGroupTitle{display:flex;align-items:center;gap:8px;min-width:0;margin:0;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600}.dsham_settingsGroupTitle svg{flex:none;color:var(--dsw-alias-label-secondary)}.dsham_settingsCount{flex:none;color:var(--dsw-alias-label-tertiary);font-size:12px}.dsham_settingsList{overflow:hidden;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-button-elevated-fill))}.dsham_settingsRow{display:flex;align-items:center;gap:12px;min-height:60px;padding:10px 16px;border-bottom:1px solid var(--dsw-alias-border-l2)}.dsham_settingsRow:last-child{border-bottom:0}.dsham_settingsContent{min-width:0;flex:1}.dsham_settingsTitle{overflow:hidden;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600;line-height:18px;text-overflow:ellipsis;white-space:nowrap}.dsham_settingsMeta{margin-top:2px;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:16px}.dsham_settingsActions{display:flex;align-items:center;gap:8px}.dsham_settingsAction{min-height:32px;padding:0 12px;color:var(--dsw-alias-label-primary);background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;font-weight:500}.dsham_settingsAction:hover{filter:brightness(1.12)}.dsham_settingsDelete{display:flex;align-items:center;justify-content:center;width:28px;height:28px;color:var(--dsw-alias-label-tertiary);background:transparent;border:0;border-radius:8px;cursor:pointer}.dsham_settingsDelete:hover{color:var(--dsw-alias-state-error-primary);background:var(--dsw-alias-interactive-bg-hover)}.dsham_settingsEmpty{padding:28px 8px;color:var(--dsw-alias-label-secondary);text-align:center}.dsham_settingsError{margin-top:10px;color:var(--dsw-alias-state-error-primary);font-size:12px}@media(max-width:720px){.dsham_settings{width:100%;margin:28px auto 48px;padding:0 16px}.dsham_settingsHeader{margin-bottom:28px}.dsham_settingsToolbar{flex-wrap:wrap;margin-bottom:28px}.dsham_settingsSearch{flex-basis:100%}.dsham_settingsFilter{flex:1;min-width:0}.dsham_settingsGroup{margin-bottom:32px}.dsham_settingsRow{padding:10px 12px}.dsham_settingsActions{gap:4px}}";
+		const ARCHIVE_SETTINGS_BATCH_CSS = ".dsham_settingsHeaderActions,.dsham_settingsGroupMeta{display:flex;align-items:center;gap:8px;flex:none}.dsham_settingsRestoreAll{display:inline-flex;align-items:center;min-height:32px;padding:0 12px;color:var(--dsw-alias-label-primary);background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;cursor:pointer;font:inherit;font-size:13px;font-weight:500}.dsham_settingsRestoreAll:hover{background:var(--dsw-alias-interactive-bg-hover)}.dsham_settingsRestoreAll:disabled,.dsham_settingsDanger:disabled,.dsham_settingsGroupMenu:disabled{cursor:not-allowed;opacity:.5}.dsham_settingsGroupMenu{display:flex;align-items:center;justify-content:center;width:28px;height:28px;padding:0;color:var(--dsw-alias-label-tertiary);background:transparent;border:0;border-radius:8px;cursor:pointer}.dsham_settingsGroupMenu:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.dsham_settingsStatus{margin-top:10px;color:var(--dsw-alias-label-secondary);font-size:12px}@media(max-width:720px){.dsham_settingsHeader{flex-direction:column}.dsham_settingsHeaderActions{align-self:flex-end}}";
 		const ARCHIVE_SETTINGS_LAYOUT_OVERRIDE = ".dsham_settings{margin:0 auto!important}@media(max-width:720px){.dsham_settings{margin:0 auto!important}}";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify("dsh-archive-manager/ArchiveSettings.layout.css") + "]") === null) {
 			const tag = document.createElement("style");
@@ -2504,8 +2588,8 @@ window.__ModuleLoader__.load({
 			tag.textContent = ARCHIVE_SETTINGS_LAYOUT_OVERRIDE;
 			document.head.appendChild(tag);
 		}
-		/** 设置页项目筛选：自定义菜单，避免原生 select 弹出系统浅色下拉。 */
-		function ArchiveProjectSelect({ id, value, options, onChange, "aria-label": ariaLabel }) {
+		/** 设置页筛选/排序：自定义菜单，避免原生 select 弹出系统浅色下拉。 */
+		function ArchiveProjectSelect({ id, value, options, onChange, "aria-label": ariaLabel }) {
 			const [open, setOpen] = (0, react.useState)(false);
 			const selectedIndex = Math.max(0, options.findIndex((option) => option.value === value));
 			const [active, setActive] = (0, react.useState)(selectedIndex);
@@ -2634,10 +2718,75 @@ window.__ModuleLoader__.load({
 						children: option.label
 					}, option.value === "all" ? "all" : option.value))
 				}) : null]
-			});
-		}
-		/** 设置页“未分组”桶的稳定 key（workspaceId 均为非空 uuid，不会冲突）。 */
-		const ARCHIVE_UNGROUPED_KEY = "__ungrouped__";
+			});
+		}
+		/** 项目标题右侧的批量恢复/删除菜单，复用宿主菜单组件的键盘和焦点行为。 */
+		function ArchivedGroupActions({ group, busy, onRestore, onDelete, t }) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const ungrouped = group.key === ARCHIVE_UNGROUPED_KEY;
+			const items = [{
+				id: "restore",
+				label: t(ungrouped ? "archives.restoreUngrouped" : "archives.restoreProject")
+			}, {
+				id: "delete",
+				label: t(ungrouped ? "archives.deleteUngrouped" : "archives.deleteProject"),
+				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, {}),
+				danger: true
+			}];
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
+				open,
+				onClose: () => setOpen(false),
+				items,
+				onSelect: (id) => {
+					setOpen(false);
+					if (id === "restore") onRestore();
+					else if (id === "delete") onDelete();
+				},
+				portal: true,
+				anchor: (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					className: "dsham_settingsGroupMenu",
+					disabled: busy,
+					"aria-label": t(ungrouped ? "archives.ungroupedActions" : "archives.projectActions", { name: group.title }),
+					onClick: () => setOpen((current) => !current),
+					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEllipsisOutline16, {})
+				})
+			});
+		}
+		/** 设置页“未分组”桶的稳定 key（workspaceId 均为非空 uuid，不会冲突）。 */
+		const ARCHIVE_UNGROUPED_KEY = "__ungrouped__";
+		function archivedBatchTargetForGroup(groupKey) {
+			return groupKey === ARCHIVE_UNGROUPED_KEY ? { scope: "ungrouped" } : { scope: "workspace", workspaceId: groupKey };
+		}
+		/** 客户端只用此派生显示权威批次计数；宿主会用自己的持久状态重新解析。 */
+		function deriveArchivedBatchIds(archivedSessionIds, items, target) {
+			const ids = [...new Set(archivedSessionIds ?? [])];
+			if (target.scope === "all") return ids;
+			if (target.scope === "workspace") {
+				const accounted = new Set(items.find((workspace) => workspace.workspaceId === target.workspaceId)?.sessionIds ?? []);
+				return ids.filter((id) => accounted.has(id));
+			}
+			const accounted = new Set(items.flatMap((workspace) => workspace.sessionIds));
+			return ids.filter((id) => !accounted.has(id));
+		}
+		/** 把批量删除结果转换为准确区分“已删除”与“陈旧标记已清理”的反馈。 */
+		function archivedDeleteFeedback(result, t) {
+			const deleted = result.deletedSessionIds.length;
+			const skipped = result.skippedSessionIds.length;
+			if (result.failures.length > 0) return {
+				kind: "error",
+				message: t("archives.deletePartial", { deleted, skipped, failed: result.failures.length, detail: result.failures[0].message })
+			};
+			if (skipped > 0 && deleted > 0) return {
+				kind: "notice",
+				message: t("archives.deleteSuccessWithSkipped", { deleted, skipped })
+			};
+			if (skipped > 0) return {
+				kind: "notice",
+				message: t("archives.deleteSkipped", { n: skipped })
+			};
+			return { kind: "notice", message: t("archives.deleteSuccess", { n: deleted }) };
+		}
 		/**
 		* 设置页归档分组派生：按工作区分组，组 key 用 workspaceId（上游允许
 		* 不同路径的工作区同名，title 不能作 React key / 筛选 value），未归入
@@ -2648,7 +2797,7 @@ window.__ModuleLoader__.load({
 		* @param ungroupedLabel - “未分组”显示文案。
 		* @returns 分组数组（仅含有会话的组），每项含 key / title / sessions。
 		*/
-		function deriveArchivedGroups(byId, items, archivedSessionIds, ungroupedLabel) {
+		function deriveArchivedGroups(byId, items, archivedSessionIds, ungroupedLabel) {
 			const byWorkspace = items.map((workspace) => ({
 				key: workspace.workspaceId,
 				title: workspace.title,
@@ -2664,37 +2813,62 @@ window.__ModuleLoader__.load({
 			}
 			const result = byWorkspace.filter((group) => group.sessions.length > 0);
 			if (ungrouped.length > 0) result.push({ key: ARCHIVE_UNGROUPED_KEY, title: ungroupedLabel, sessions: ungrouped });
-			return result;
-		}
-		/**
-		* “全部删除”的提交集合：直接取归档全集，仅排除摘要已知为 subagent 的
-		* id（其删除由服务端级联）。不依赖摘要是否已加载，投影未就绪的会话
-		* 不会被静默漏删。
-		* @param archivedSessionIds - 注册表全局归档集合。
-		* @param byId - 会话摘要表（可能不完整）。
-		* @returns 去重后的待删除 id 列表。
-		*/
-		function deriveArchivedDeleteAllIds(archivedSessionIds, byId) {
-			const seen = /* @__PURE__ */ new Set();
-			const ids = [];
-			for (const id of archivedSessionIds ?? []) {
-				if (typeof id !== "string" || id.length === 0 || seen.has(id)) continue;
-				seen.add(id);
-				if (byId?.[id]?.origin === "subagent") continue;
-				ids.push(id);
-			}
-			return ids;
-		}
-		/** 管理设置页中的归档会话，数据直接订阅 DSH 的会话与工作区投影。 */
-		function ArchivedSessionsSection({ sessionStore, workspaceStore, unarchiveSession, deleteSession, t }) {
-			const sessions = (0, react.useSyncExternalStore)(sessionStore.subscribe, sessionStore.getSnapshot);
-			const workspaceState = (0, react.useSyncExternalStore)(workspaceStore.subscribe, workspaceStore.getSnapshot);
-			const [deleteTarget, setDeleteTarget] = (0, react.useState)(null);
-			const [busy, setBusy] = (0, react.useState)(false);
-			const [error, setError] = (0, react.useState)(null);
-			const [query, setQuery] = (0, react.useState)("");
-			const [project, setProject] = (0, react.useState)("all");
-			const groups = (0, react.useMemo)(() => deriveArchivedGroups(sessions.byId, workspaceState.items, workspaceState.archivedSessionIds, t("group.ungrouped")), [sessions.byId, workspaceState, t]);
+			return result;
+		}
+		/**
+		* 归档设置页排序：时间排序同时按每组首条会话排列项目，字母排序则
+		* 同时排列项目名和组内标题；所有输入均复制后排序，不改写 store 快照。
+		*/
+		function sortArchivedGroups(groups, sortBy, createdAtById, t) {
+			const compareText = (left, right) => String(left).localeCompare(String(right), void 0, { numeric: true, sensitivity: "base" });
+			const timestampOf = (session) => {
+				const value = sortBy === "created" ? createdAtById[session.id] : session.updatedAt;
+				return typeof value === "number" && Number.isFinite(value) ? value : Number.NEGATIVE_INFINITY;
+			};
+			const compareSessions = (left, right) => {
+				if (sortBy !== "alphabetical") {
+					const byTime = timestampOf(right) - timestampOf(left);
+					if (Number.isFinite(byTime) && byTime !== 0) return byTime;
+				}
+				return compareText(displayTitle(left, t), displayTitle(right, t)) || compareText(left.id, right.id);
+			};
+			const result = groups.map((group) => ({ ...group, sessions: [...group.sessions].sort(compareSessions) }));
+			return result.sort((left, right) => {
+				if (sortBy !== "alphabetical") {
+					const byTime = timestampOf(right.sessions[0]) - timestampOf(left.sessions[0]);
+					if (Number.isFinite(byTime) && byTime !== 0) return byTime;
+				}
+				return compareText(left.title, right.title) || compareText(left.key, right.key);
+			});
+		}
+		/** 管理设置页中的归档会话，数据直接订阅 DSH 的会话与工作区投影。 */
+		function ArchivedSessionsSection({ sessionStore, workspaceStore, unarchiveSession, deleteSession, unarchiveSessions, deleteArchivedSessions, archivedSessionMetadata, t }) {
+			const sessions = (0, react.useSyncExternalStore)(sessionStore.subscribe, sessionStore.getSnapshot);
+			const workspaceState = (0, react.useSyncExternalStore)(workspaceStore.subscribe, workspaceStore.getSnapshot);
+			const [deleteTarget, setDeleteTarget] = (0, react.useState)(null);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			const [notice, setNotice] = (0, react.useState)(null);
+			const [query, setQuery] = (0, react.useState)("");
+			const [project, setProject] = (0, react.useState)("all");
+			const [sortBy, setSortBy] = (0, react.useState)("updated");
+			const [createdAtById, setCreatedAtById] = (0, react.useState)({});
+			const [unarchivingSessionIds, setUnarchivingSessionIds] = (0, react.useState)(() => /* @__PURE__ */ new Set());
+			const unarchivingSessionIdsRef = (0, react.useRef)(/* @__PURE__ */ new Set());
+			const groups = (0, react.useMemo)(() => deriveArchivedGroups(sessions.byId, workspaceState.items, workspaceState.archivedSessionIds, t("group.ungrouped")), [sessions.byId, workspaceState, t]);
+			const sortedGroups = (0, react.useMemo)(() => sortArchivedGroups(groups, sortBy, createdAtById, t), [groups, sortBy, createdAtById, t]);
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				archivedSessionMetadata().then((result) => {
+					if (cancelled) return;
+					setCreatedAtById(Object.fromEntries(result.items.map((item) => [item.sessionId, item.createdAt])));
+				}).catch(() => {
+					if (!cancelled) setCreatedAtById({});
+				});
+				return () => {
+					cancelled = true;
+				};
+			}, [archivedSessionMetadata, workspaceState.archivedSessionIds]);
 			(0, react.useEffect)(() => {
 				// 选中的分组消失（如最后一个归档会话被取消归档）时回退到
 				// “所有项目”，避免筛选值停留在失效 key 上把列表过滤为空。
@@ -2704,20 +2878,42 @@ window.__ModuleLoader__.load({
 			}, [groups, project]);
 			const filteredGroups = (0, react.useMemo)(() => {
 				const normalizedQuery = query.trim().toLocaleLowerCase();
-				return groups.filter((group) => project === "all" || project === group.key).map((group) => ({
+				return sortedGroups.filter((group) => project === "all" || project === group.key).map((group) => ({
 					...group,
 					sessions: group.sessions.filter((session) => normalizedQuery === "" || displayTitle(session, t).toLocaleLowerCase().includes(normalizedQuery))
 				})).filter((group) => group.sessions.length > 0);
-			}, [groups, project, query, t]);
-			const deleteAllSessionIds = (0, react.useMemo)(() => deriveArchivedDeleteAllIds(workspaceState.archivedSessionIds, sessions.byId), [workspaceState.archivedSessionIds, sessions.byId]);
-			const onUnarchive = (sessionId) => {
-				setError(null);
-				unarchiveSession(sessionId).catch((reason) => {
-					setError(formatUnarchiveError(reason, t));
-				});
-			};
-			const closeDelete = () => {
-				if (!busy) setDeleteTarget(null);
+			}, [sortedGroups, project, query, t]);
+			const allBatchTarget = { scope: "all" };
+			const allBatchSessionIds = (0, react.useMemo)(() => deriveArchivedBatchIds(workspaceState.archivedSessionIds, workspaceState.items, allBatchTarget), [workspaceState.archivedSessionIds, workspaceState.items]);
+			const onUnarchive = (sessionId) => {
+				if (busy || unarchivingSessionIdsRef.current.has(sessionId)) return;
+				unarchivingSessionIdsRef.current.add(sessionId);
+				setUnarchivingSessionIds(new Set(unarchivingSessionIdsRef.current));
+				setError(null);
+				setNotice(null);
+				unarchiveSession(sessionId).catch((reason) => {
+					setError(formatUnarchiveError(reason, t));
+				}).finally(() => {
+					unarchivingSessionIdsRef.current.delete(sessionId);
+					setUnarchivingSessionIds(new Set(unarchivingSessionIdsRef.current));
+				});
+			};
+			const onBatchUnarchive = async (target) => {
+				if (busy) return;
+				setBusy(true);
+				setError(null);
+				setNotice(null);
+				try {
+					const result = await unarchiveSessions(target);
+					setNotice(t("archives.restoreSuccess", { n: result.unarchivedSessionIds.length }));
+				} catch (reason) {
+					setError(t("archives.restoreBatchFailed", { detail: reason instanceof Error ? reason.message : String(reason) }));
+				} finally {
+					setBusy(false);
+				}
+			};
+			const closeDelete = () => {
+				if (!busy) setDeleteTarget(null);
 			};
 			(0, react.useEffect)(() => {
 				if (deleteTarget === null) return;
@@ -2732,49 +2928,58 @@ window.__ModuleLoader__.load({
 				return () => window.removeEventListener("keydown", onKeyDown, true);
 			}, [deleteTarget, busy]);
 			const confirmDelete = async () => {
-				if (busy || deleteTarget === null) return;
-				setBusy(true);
-				setError(null);
-				try {
-					for (const id of deleteTarget.all ? deleteAllSessionIds : [deleteTarget.id]) {
-						try {
-							await deleteSession(id);
-						} catch (reason) {
-							if (deleteTarget.all && isUnknownSessionError(reason)) continue;
-							throw reason;
-						}
-					}
-					setDeleteTarget(null);
+				if (busy || deleteTarget === null) return;
+				setBusy(true);
+				setError(null);
+				setNotice(null);
+				try {
+					if (deleteTarget.kind === "batch") {
+						const result = await deleteArchivedSessions(deleteTarget.target);
+						const feedback = archivedDeleteFeedback(result, t);
+						if (feedback.kind === "error") setError(feedback.message);
+						else setNotice(feedback.message);
+					} else {
+						await deleteSession(deleteTarget.session.id);
+					}
+					setDeleteTarget(null);
 				} catch (reason) {
 					setError(formatDeleteError(reason, t));
-				} finally {
-					setBusy(false);
-				}
-			};
-			return (0, react_jsx_runtime.jsxs)("section", {
-				className: "dsham_settings",
-				"aria-label": t("archives.title"),
-				children: [(0, react_jsx_runtime.jsx)("style", { children: ARCHIVE_SETTINGS_CSS }), (0, react_jsx_runtime.jsxs)("header", { className: "dsham_settingsHeader", children: [(0, react_jsx_runtime.jsxs)("div", { children: [(0, react_jsx_runtime.jsx)("h2", { children: t("archives.title") }), (0, react_jsx_runtime.jsx)("p", { className: "dsham_settingsIntro", children: t("archives.description") })] }), (0, react_jsx_runtime.jsxs)("button", { type: "button", className: "dsham_settingsDanger", disabled: busy || deleteAllSessionIds.length === 0, onClick: () => setDeleteTarget({ all: true }), children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, {}), t("archives.deleteAll")] })] }), (0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsToolbar", children: [(0, react_jsx_runtime.jsxs)("label", { className: "dsham_settingsSearch", children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSearchOutline16, {}), (0, react_jsx_runtime.jsx)("input", { type: "search", value: query, onChange: (event) => setQuery(event.target.value), placeholder: t("archives.searchPlaceholder"), "aria-label": t("archives.searchPlaceholder") })] }), (0, react_jsx_runtime.jsx)(ArchiveProjectSelect, { id: "dsham-project-filter", value: project, options: [{ value: "all", label: t("archives.allProjects") }, ...groups.map((group) => ({ value: group.key, label: group.title }))], onChange: setProject, "aria-label": t("archives.projectFilter") })] }), groups.length === 0 ? (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsEmpty", children: t("archives.empty") }) : filteredGroups.length === 0 ? (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsEmpty", children: t("archives.emptyFiltered") }) : filteredGroups.map((group) => (0, react_jsx_runtime.jsxs)("section", {
-					className: "dsham_settingsGroup",
-					children: [(0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsGroupHeading", children: [(0, react_jsx_runtime.jsxs)("h3", { className: "dsham_settingsGroupTitle", children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenOutline16, {}), group.title] }), (0, react_jsx_runtime.jsx)("span", { className: "dsham_settingsCount", children: t("archives.sessionCount", { n: group.sessions.length }) })] }), (0, react_jsx_runtime.jsx)("div", {
-						className: "dsham_settingsList",
+				} finally {
+					setBusy(false);
+				}
+			};
+			const batchScope = deleteTarget?.kind === "batch" ? deleteTarget.target.scope : null;
+			const deleteDialogTitle = batchScope === "all" ? t("archives.deleteAllTitle") : batchScope === "ungrouped" ? t("archives.deleteUngroupedTitle") : batchScope === "workspace" ? t("archives.deleteProjectTitle", { name: deleteTarget.title }) : t("deleteSession.title");
+			const deleteDialogDescription = deleteTarget === null ? void 0 : batchScope === "all" ? t("archives.deleteAllDesc", { n: deleteTarget.count }) : batchScope === "ungrouped" ? t("archives.deleteUngroupedDesc", { n: deleteTarget.count }) : batchScope === "workspace" ? t("archives.deleteProjectDesc", { name: deleteTarget.title, n: deleteTarget.count }) : t("deleteSession.desc", { name: displayTitle(deleteTarget.session, t) });
+			const deleteConfirmLabel = batchScope === "all" ? t("archives.deleteAll") : batchScope === "ungrouped" ? t("archives.deleteUngroupedConfirm") : batchScope === "workspace" ? t("archives.deleteProjectConfirm") : t("deleteSession.title");
+			return (0, react_jsx_runtime.jsxs)("section", {
+				className: "dsham_settings",
+				"aria-label": t("archives.title"),
+				children: [(0, react_jsx_runtime.jsx)("style", { children: ARCHIVE_SETTINGS_CSS + ARCHIVE_SETTINGS_BATCH_CSS }), (0, react_jsx_runtime.jsxs)("header", { className: "dsham_settingsHeader", children: [(0, react_jsx_runtime.jsxs)("div", { children: [(0, react_jsx_runtime.jsx)("h2", { children: t("archives.title") }), (0, react_jsx_runtime.jsx)("p", { className: "dsham_settingsIntro", children: t("archives.description") })] }), (0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsHeaderActions", children: [(0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsRestoreAll", disabled: busy || allBatchSessionIds.length === 0, onClick: () => onBatchUnarchive(allBatchTarget), children: t("archives.restoreAll") }), (0, react_jsx_runtime.jsxs)("button", { type: "button", className: "dsham_settingsDanger", disabled: busy || allBatchSessionIds.length === 0, onClick: () => setDeleteTarget({ kind: "batch", target: allBatchTarget, title: t("archives.allProjects"), count: allBatchSessionIds.length }), children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, {}), t("archives.deleteAll")] })] })] }), (0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsToolbar", children: [(0, react_jsx_runtime.jsxs)("label", { className: "dsham_settingsSearch", children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSearchOutline16, {}), (0, react_jsx_runtime.jsx)("input", { type: "search", value: query, onChange: (event) => setQuery(event.target.value), placeholder: t("archives.searchPlaceholder"), "aria-label": t("archives.searchPlaceholder") })] }), (0, react_jsx_runtime.jsx)(ArchiveProjectSelect, { id: "dsham-sort-filter", value: sortBy, options: [{ value: "updated", label: t("archives.sortUpdated") }, { value: "created", label: t("archives.sortCreated") }, { value: "alphabetical", label: t("archives.sortAlphabetical") }], onChange: setSortBy, "aria-label": t("archives.sortBy") }), (0, react_jsx_runtime.jsx)(ArchiveProjectSelect, { id: "dsham-project-filter", value: project, options: [{ value: "all", label: t("archives.allProjects") }, ...sortedGroups.map((group) => ({ value: group.key, label: group.title }))], onChange: setProject, "aria-label": t("archives.projectFilter") })] }), groups.length === 0 ? (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsEmpty", children: t("archives.empty") }) : filteredGroups.length === 0 ? (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsEmpty", children: t("archives.emptyFiltered") }) : filteredGroups.map((group) => {
+					const target = archivedBatchTargetForGroup(group.key);
+					const count = deriveArchivedBatchIds(workspaceState.archivedSessionIds, workspaceState.items, target).length;
+					return (0, react_jsx_runtime.jsxs)("section", {
+					className: "dsham_settingsGroup",
+					children: [(0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsGroupHeading", children: [(0, react_jsx_runtime.jsxs)("h3", { className: "dsham_settingsGroupTitle", children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenOutline16, {}), group.title] }), (0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsGroupMeta", children: [(0, react_jsx_runtime.jsx)("span", { className: "dsham_settingsCount", children: t("archives.sessionCount", { n: count }) }), (0, react_jsx_runtime.jsx)(ArchivedGroupActions, { group, busy, onRestore: () => onBatchUnarchive(target), onDelete: () => setDeleteTarget({ kind: "batch", target, title: group.title, count }), t })] })] }), (0, react_jsx_runtime.jsx)("div", {
+						className: "dsham_settingsList",
 						children: group.sessions.map((session) => (0, react_jsx_runtime.jsxs)("article", {
 							className: "dsham_settingsRow",
 							children: [(0, react_jsx_runtime.jsxs)("div", { className: "dsham_settingsContent", children: [(0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsTitle", children: displayTitle(session, t) }), (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsMeta", children: archiveTimeLabel(session.updatedAt, t) })] }), (0, react_jsx_runtime.jsxs)("div", {
 								className: "dsham_settingsActions",
-								children: [(0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsAction", disabled: busy, onClick: () => onUnarchive(session.id), children: t("menu.unarchive") }), (0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsDelete", disabled: busy, "aria-label": t("menu.deleteSession"), onClick: () => setDeleteTarget(session), children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, {}) })]
-							})]
-						}, session.id))
-					})]
-				}, group.key)), error !== null && (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsError", role: "alert", children: error }), (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
-					open: deleteTarget !== null,
-					onClose: closeDelete,
-					closeLabel: t("close"),
-					title: deleteTarget?.all ? t("archives.deleteAllTitle") : t("deleteSession.title"),
-					...deleteTarget === null ? {} : { description: deleteTarget.all ? t("archives.deleteAllDesc", { n: deleteAllSessionIds.length }) : t("deleteSession.desc", { name: displayTitle(deleteTarget, t) }) },
-					footer: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, { variant: "outline", disabled: busy, onClick: closeDelete, children: t("cancel") }), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, { variant: "outline", disabled: busy, onClick: confirmDelete, children: deleteTarget?.all ? t("archives.deleteAll") : t("deleteSession.title") })] }),
-					children: busy && (0, react_jsx_runtime.jsx)("div", { role: "status", children: deleteTarget?.all ? t("archives.deleteAllPending") : t("deleteSession.pending") })
-				})]
+								children: [(0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsAction", disabled: busy || unarchivingSessionIds.has(session.id), onClick: () => onUnarchive(session.id), children: t("menu.unarchive") }), (0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsDelete", disabled: busy || unarchivingSessionIds.has(session.id), "aria-label": t("menu.deleteSession"), onClick: () => setDeleteTarget({ kind: "session", session }), children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, {}) })]
+							})]
+						}, session.id))
+					})]
+				}, group.key);
+				}), error !== null && (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsError", role: "alert", children: error }), notice !== null && (0, react_jsx_runtime.jsx)("div", { className: "dsham_settingsStatus", role: "status", children: notice }), (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+					open: deleteTarget !== null,
+					onClose: closeDelete,
+					closeLabel: t("close"),
+					title: deleteDialogTitle,
+					...deleteDialogDescription === void 0 ? {} : { description: deleteDialogDescription },
+					footer: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, { variant: "outline", disabled: busy, onClick: closeDelete, children: t("cancel") }), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, { variant: "outline", disabled: busy, onClick: confirmDelete, children: deleteConfirmLabel })] }),
+					children: busy && (0, react_jsx_runtime.jsx)("div", { role: "status", children: deleteTarget?.kind === "batch" ? t("archives.deleteBatchPending") : t("deleteSession.pending") })
+				})]
 			});
 		}
 		//#endregion
@@ -2819,15 +3024,39 @@ window.__ModuleLoader__.load({
 			"archives.description": "管理已归档的会话。",
 			"archives.empty": "暂无已归档会话",
 			"archives.emptyFiltered": "没有匹配的已归档聊天",
-			"archives.searchPlaceholder": "搜索已归档聊天",
-			"archives.projectFilter": "按项目筛选",
+			"archives.searchPlaceholder": "搜索已归档聊天",
+			"archives.sortBy": "排序方式",
+			"archives.sortUpdated": "更新时间",
+			"archives.sortCreated": "创建时间",
+			"archives.sortAlphabetical": "按字母顺序",
+			"archives.projectFilter": "按项目筛选",
 			"archives.allProjects": "所有项目",
-			"archives.sessionCount": "{n} 个聊天",
-			"archives.timestamp": "{date}，{time}",
-			"archives.deleteAll": "全部删除",
-			"archives.deleteAllTitle": "删除全部已归档聊天",
-			"archives.deleteAllDesc": "将永久删除全部 {n} 个已归档聊天及其子代理（含正在运行的）和记录，此操作不可恢复。",
-			"archives.deleteAllPending": "正在删除已归档聊天…",
+			"archives.sessionCount": "{n} 个聊天",
+			"archives.timestamp": "{date}，{time}",
+			"archives.restoreAll": "全部恢复",
+			"archives.restoreProject": "恢复该项目的全部聊天",
+			"archives.restoreUngrouped": "恢复未分组的全部聊天",
+			"archives.deleteProject": "删除该项目的全部聊天",
+			"archives.deleteUngrouped": "删除未分组的全部聊天",
+			"archives.projectActions": "项目“{name}”的归档操作",
+			"archives.ungroupedActions": "未分组聊天的归档操作",
+			"archives.restoreSuccess": "已恢复 {n} 个已归档聊天。",
+			"archives.restoreBatchFailed": "批量恢复失败：{detail}",
+			"archives.deleteAll": "全部删除",
+			"archives.deleteAllTitle": "删除全部已归档聊天",
+			"archives.deleteAllDesc": "将永久删除全部 {n} 个已归档聊天及其子代理（含正在运行的）和记录，此操作不可恢复。",
+			"archives.deleteAllPending": "正在删除已归档聊天…",
+			"archives.deleteProjectTitle": "删除“{name}”中的已归档聊天",
+			"archives.deleteProjectDesc": "将永久删除“{name}”中的 {n} 个已归档聊天及其子代理和记录。项目目录和未归档聊天不会受影响，此操作不可恢复。",
+			"archives.deleteProjectConfirm": "删除该项目的全部聊天",
+			"archives.deleteUngroupedTitle": "删除未分组的已归档聊天",
+			"archives.deleteUngroupedDesc": "将永久删除未分组中的 {n} 个已归档聊天及其子代理和记录。其他项目和未归档聊天不会受影响，此操作不可恢复。",
+			"archives.deleteUngroupedConfirm": "删除未分组的全部聊天",
+			"archives.deleteBatchPending": "正在删除已归档聊天…",
+			"archives.deleteSuccess": "已删除 {n} 个已归档聊天。",
+			"archives.deleteSuccessWithSkipped": "已删除 {deleted} 个已归档聊天；另清理 {skipped} 个已不存在会话的归档记录。",
+			"archives.deleteSkipped": "已清理 {n} 个已不存在会话的归档记录。",
+			"archives.deletePartial": "已删除 {deleted} 个聊天，清理 {skipped} 个已不存在会话的归档记录；{failed} 个删除失败：{detail}",
 			"archives.unarchiveUnknown": "会话已不存在，无法取消归档。",
 			"archives.unarchiveFailed": "取消归档失败：{detail}",
 			"archives.archiveUnknown": "会话已不存在，无法归档。",
@@ -2911,15 +3140,39 @@ window.__ModuleLoader__.load({
 			"archives.description": "Manage archived sessions.",
 			"archives.empty": "No archived sessions.",
 			"archives.emptyFiltered": "No archived chats match your filters.",
-			"archives.searchPlaceholder": "Search archived chats",
-			"archives.projectFilter": "Filter by project",
+			"archives.searchPlaceholder": "Search archived chats",
+			"archives.sortBy": "Sort archived chats",
+			"archives.sortUpdated": "Last updated",
+			"archives.sortCreated": "Created",
+			"archives.sortAlphabetical": "Alphabetical",
+			"archives.projectFilter": "Filter by project",
 			"archives.allProjects": "All projects",
-			"archives.sessionCount": "{n} chats",
-			"archives.timestamp": "{date}, {time}",
-			"archives.deleteAll": "Delete all",
-			"archives.deleteAllTitle": "Delete all archived chats",
-			"archives.deleteAllDesc": "This permanently deletes all {n} archived chats, their child agents (including any that are still running), and their records. This cannot be undone.",
-			"archives.deleteAllPending": "Deleting archived chats…",
+			"archives.sessionCount": "{n} chats",
+			"archives.timestamp": "{date}, {time}",
+			"archives.restoreAll": "Restore all",
+			"archives.restoreProject": "Restore all chats in this project",
+			"archives.restoreUngrouped": "Restore all ungrouped chats",
+			"archives.deleteProject": "Delete all chats in this project",
+			"archives.deleteUngrouped": "Delete all ungrouped chats",
+			"archives.projectActions": "Archive actions for project {name}",
+			"archives.ungroupedActions": "Archive actions for ungrouped chats",
+			"archives.restoreSuccess": "Restored {n} archived chats.",
+			"archives.restoreBatchFailed": "Could not restore the archived chats: {detail}",
+			"archives.deleteAll": "Delete all",
+			"archives.deleteAllTitle": "Delete all archived chats",
+			"archives.deleteAllDesc": "This permanently deletes all {n} archived chats, their child agents (including any that are still running), and their records. This cannot be undone.",
+			"archives.deleteAllPending": "Deleting archived chats…",
+			"archives.deleteProjectTitle": "Delete archived chats in {name}",
+			"archives.deleteProjectDesc": "This permanently deletes the {n} archived chats in {name}, their child agents, and their records. The project directory and unarchived chats are not affected. This cannot be undone.",
+			"archives.deleteProjectConfirm": "Delete all project chats",
+			"archives.deleteUngroupedTitle": "Delete ungrouped archived chats",
+			"archives.deleteUngroupedDesc": "This permanently deletes the {n} ungrouped archived chats, their child agents, and their records. Other projects and unarchived chats are not affected. This cannot be undone.",
+			"archives.deleteUngroupedConfirm": "Delete all ungrouped chats",
+			"archives.deleteBatchPending": "Deleting archived chats…",
+			"archives.deleteSuccess": "Deleted {n} archived chats.",
+			"archives.deleteSuccessWithSkipped": "Deleted {deleted} archived chats and cleared {skipped} stale archive entries for sessions that no longer exist.",
+			"archives.deleteSkipped": "Cleared {n} stale archive entries for sessions that no longer exist.",
+			"archives.deletePartial": "Deleted {deleted} chats and cleared {skipped} stale archive entries; {failed} could not be deleted: {detail}",
 			"archives.unarchiveUnknown": "This session no longer exists, so it cannot be unarchived.",
 			"archives.unarchiveFailed": "Could not unarchive the session: {detail}",
 			"archives.archiveUnknown": "This session no longer exists, so it cannot be archived.",
@@ -3034,12 +3287,33 @@ window.__ModuleLoader__.load({
 				const result = await registry.unarchiveSession(sessionId);
 				if (!result.ok) throw new Error(result.error.message);
 			};
-			const deleteSession = async (sessionId) => {
-				const registry = ctx.get("remote.workspaceRegistry");
-				if (registry === void 0) throw new Error("archive-manager remote service is unavailable");
-				const result = await registry.deleteSession(sessionId);
-				if (!result.ok) throw new Error(result.error.message);
-			};
+			const deleteSession = async (sessionId) => {
+				const registry = ctx.get("remote.workspaceRegistry");
+				if (registry === void 0) throw new Error("archive-manager remote service is unavailable");
+				const result = await registry.deleteSession(sessionId);
+				if (!result.ok) throw new Error(result.error.message);
+			};
+			const unarchiveSessions = async (target) => {
+				const registry = ctx.get("remote.workspaceRegistry");
+				if (registry === void 0) throw new Error("archive-manager remote service is unavailable");
+				const result = await registry.unarchiveSessions(target);
+				if (!result.ok) throw new Error(result.error.message);
+				return result.value;
+			};
+			const deleteArchivedSessions = async (target) => {
+				const registry = ctx.get("remote.workspaceRegistry");
+				if (registry === void 0) throw new Error("archive-manager remote service is unavailable");
+				const result = await registry.deleteArchivedSessions(target);
+				if (!result.ok) throw new Error(result.error.message);
+				return result.value;
+			};
+			const archivedSessionMetadata = async () => {
+				const registry = ctx.get("remote.workspaceRegistry");
+				if (registry === void 0) throw new Error("archive-manager remote service is unavailable");
+				const result = await registry.archivedSessionMetadata();
+				if (!result.ok) throw new Error(result.error.message);
+				return result.value;
+			};
 			const browserInjected = () => ({
 				startSession: (workspaceId) => {
 					ctx.workspaces.startSession(workspaceId);
@@ -3113,25 +3387,30 @@ window.__ModuleLoader__.load({
 				locale: NS,
 				inject: () => ({
 					sessionStore: ctx.sessions.list,
-					workspaceStore: ctx.workspaces.list,
-					unarchiveSession,
-					deleteSession,
-					t: ctx.locale.bind(NS)
+					workspaceStore: ctx.workspaces.list,
+					unarchiveSession,
+					deleteSession,
+					unarchiveSessions,
+					deleteArchivedSessions,
+					archivedSessionMetadata,
+					t: ctx.locale.bind(NS)
 				})
 			}, ArchivedSessionsSection));
 		}
 		//#endregion
 		/** Pure derivation surface for dsh-archive-manager self-tests (no-op for the runtime). */
-		exports.__test = {
+		exports.__test = {
 			displayTitle,
 			sessionVisible,
 			isUnknownSessionError,
 			deriveGroups,
 			deriveFlat,
-			deriveSearchResults,
-			deriveArchivedGroups,
-			deriveArchivedDeleteAllIds,
-			createWorkspaceViewStore,
+			deriveSearchResults,
+			deriveArchivedGroups,
+			sortArchivedGroups,
+			deriveArchivedBatchIds,
+			archivedDeleteFeedback,
+			createWorkspaceViewStore,
 			groupByWorkspace,
 			byRecency,
 			ARCHIVE_MANAGER_REMOTE

package/lib/workspace.js

@@ -15,8 +15,9 @@ import { trackTombstone } from "./tombstone.js";
 * 删除投影缓存，级联删除 SUBAGENT 子会话并清理 spill；最后才删除转录
 * 目录。fork 分支虽有 `parentSession`，但属于独立用户会话，不参与级联。
 *
-* 所有可失败的持久化清理都先于不可逆的物理删除。此前任一步失败时，
-* 转录仍保留，可重试删除；物理删除失败时记录残留路径供人工排查。
+* 父会话的可失败记账清理先于其转录目录删除；父目录删除失败时保留头部
+* 索引，允许再次调用同一入口完成删除。SUBAGENT 级联跨多个转录目录，无法
+* 组成事务：子会话可能已先删除，重试会跳过它们并继续处理仍保留的父会话。
 * 物理删除成功后必须遗忘父类内存索引（headers / sessionPaths /
 * invalidSessionPaths）并打上删除墓碑：父类 sessionKnown 以 headers.has
 * 短路，indexHeaders 只增不减，stale list() 否则会把已删 id 救活，
@@ -24,7 +25,8 @@ import { trackTombstone } from "./tombstone.js";
 * 墓碑同时记录被删生命周期的日志身份（createdAt/cwd）：其他进程以同 id
 * 重建并落盘新会话时（冷复用），sessionKnown 的探针以身份差异区分新旧
 * 生命周期并撤掉墓碑，避免已重建的会话在本进程永久 UNKNOWN_SESSION。
-* `unarchiveSession` 与 `deleteSession` 通过 Typert Remote 暴露给浏览器，并注册到 typert.local，避免生产环境只靠 SRC 扫描时 404。
+* 单会话与批量恢复/删除方法均通过 Typert Remote 暴露给浏览器，并注册到
+* typert.local，避免生产环境只靠 SRC 扫描时 404。
 */
 function markRemoteMethod(instance, method) {
 	// 模拟 TS 装饰器管线 `@Remote(method)`：`Remote` 返回标准方法装饰器，
@@ -71,12 +73,45 @@ const archivedSetSchema = {
 		return value;
 	}
 };
-const deletedSchema = {
-	parse(value) {
-		if (typeof value !== "object" || value === null || Array.isArray(value) || value.deleted !== true) throw new TypeError("deleted must be true");
-		return value;
-	}
-};
+const deletedSchema = {
+	parse(value) {
+		if (typeof value !== "object" || value === null || Array.isArray(value) || value.deleted !== true) throw new TypeError("deleted must be true");
+		return value;
+	}
+};
+const archivedBatchTargetSchema = {
+	parse(value) {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("target must be an object");
+		if (value.scope === "all" || value.scope === "ungrouped") return value;
+		if (value.scope === "workspace" && typeof value.workspaceId === "string" && value.workspaceId.length > 0) return value;
+		throw new TypeError("target.scope must be all, ungrouped, or workspace with a non-empty workspaceId");
+	}
+};
+const unarchivedBatchSchema = {
+	parse(value) {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("result must be an object");
+		if (!Array.isArray(value.archivedSessionIds) || value.archivedSessionIds.some((id) => typeof id !== "string")) throw new TypeError("archivedSessionIds must be a string array");
+		if (!Array.isArray(value.unarchivedSessionIds) || value.unarchivedSessionIds.some((id) => typeof id !== "string")) throw new TypeError("unarchivedSessionIds must be a string array");
+		return value;
+	}
+};
+const deletedBatchSchema = {
+	parse(value) {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("result must be an object");
+		for (const key of ["requestedSessionIds", "deletedSessionIds", "skippedSessionIds"]) {
+			if (!Array.isArray(value[key]) || value[key].some((id) => typeof id !== "string")) throw new TypeError(`${key} must be a string array`);
+		}
+		if (!Array.isArray(value.failures) || value.failures.some((failure) => typeof failure !== "object" || failure === null || typeof failure.sessionId !== "string" || typeof failure.message !== "string")) throw new TypeError("failures must contain sessionId/message objects");
+		return value;
+	}
+};
+const archivedSessionMetadataSchema = {
+	parse(value) {
+		if (typeof value !== "object" || value === null || Array.isArray(value) || !Array.isArray(value.items)) throw new TypeError("result.items must be an array");
+		if (value.items.some((item) => typeof item !== "object" || item === null || typeof item.sessionId !== "string" || typeof item.createdAt !== "number" || !Number.isFinite(item.createdAt))) throw new TypeError("items must contain sessionId/createdAt objects");
+		return value;
+	}
+};
 /**
 * Host 严格描述符。网关优先读 typert.local，避免 SRC 扫描缓存
 * 或协议包双份导致 /api/workspaceRegistry/deleteSession 在生产环境 404。
@@ -101,8 +136,8 @@ const ARCHIVE_MANAGER_INVOCATIONS = [
 		},
 		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
 	},
-	{
-		id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteSession",
+	{
+		id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteSession",
 		service: "workspaceRegistry",
 		namespace: "workspaceRegistry",
 		method: "deleteSession",
@@ -117,10 +152,62 @@ const ARCHIVE_MANAGER_INVOCATIONS = [
 			mode: "strict",
 			typeSymbol: "@michengai/dsh-archive-manager/types#Deleted",
 			schema: deletedSchema
-		},
-		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
-	}
-];
+		},
+		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+	},
+	{
+		id: "@michengai/dsh-archive-manager#workspaceRegistry/unarchiveSessions",
+		service: "workspaceRegistry",
+		namespace: "workspaceRegistry",
+		method: "unarchiveSessions",
+		invocation: { kind: "direct" },
+		parameters: [{
+			name: "target",
+			wire: "target",
+			source: "json",
+			codec: { mode: "strict", typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedBatchTarget", schema: archivedBatchTargetSchema }
+		}],
+		result: {
+			mode: "strict",
+			typeSymbol: "@michengai/dsh-archive-manager/types#UnarchivedBatch",
+			schema: unarchivedBatchSchema
+		},
+		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+	},
+	{
+		id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteArchivedSessions",
+		service: "workspaceRegistry",
+		namespace: "workspaceRegistry",
+		method: "deleteArchivedSessions",
+		invocation: { kind: "direct" },
+		parameters: [{
+			name: "target",
+			wire: "target",
+			source: "json",
+			codec: { mode: "strict", typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedBatchTarget", schema: archivedBatchTargetSchema }
+		}],
+		result: {
+			mode: "strict",
+			typeSymbol: "@michengai/dsh-archive-manager/types#DeletedBatch",
+			schema: deletedBatchSchema
+		},
+		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+	},
+	{
+		id: "@michengai/dsh-archive-manager#workspaceRegistry/archivedSessionMetadata",
+		service: "workspaceRegistry",
+		namespace: "workspaceRegistry",
+		method: "archivedSessionMetadata",
+		invocation: { kind: "direct" },
+		parameters: [],
+		result: {
+			mode: "strict",
+			typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedSessionMetadata",
+			schema: archivedSessionMetadataSchema
+		},
+		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+	}
+];
 const ARCHIVE_MANAGER_TYPERT = {
 	package: "@michengai/dsh-archive-manager",
 	face: "host",
@@ -155,11 +242,27 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 	deletedIdentities = /* @__PURE__ */ new Map();
 	constructor(ctx) {
 		super(ctx);
-		this.typertRemote = bindTypertRemote(this, this.name);
-		markRemoteMethod(this, "unarchiveSession");
-		markRemoteMethod(this, "deleteSession");
-		registerHostRemote(this.ctx);
-	}
+		this.typertRemote = bindTypertRemote(this, this.name);
+		markRemoteMethod(this, "unarchiveSession");
+		markRemoteMethod(this, "deleteSession");
+		markRemoteMethod(this, "unarchiveSessions");
+		markRemoteMethod(this, "deleteArchivedSessions");
+		markRemoteMethod(this, "archivedSessionMetadata");
+		registerHostRemote(this.ctx);
+	}
+	/** 归档设置页创建时间排序所需的最小元数据；列表摘要本身只暴露 updatedAt。 */
+	async archivedSessionMetadata() {
+		const items = [];
+		for (const sessionId of [...new Set(this.requireState().archivedSessionIds)]) {
+			try {
+				const header = await this.readSessionHeader(sessionId);
+				if (typeof header.createdAt === "number" && Number.isFinite(header.createdAt)) items.push({ sessionId, createdAt: header.createdAt });
+			} catch (error) {
+				this.ctx.logger.warn(`archive-manager: could not read creation time for archived session "${sessionId}": ${String(error)}`);
+			}
+		}
+		return { items };
+	}
 	/**
 	* 把一个会话移出注册表全局归档集合，恢复其正常可见性（其记账位从未
 	* 移动，会话在原工作区位置重新出现）。幂等：未归档的已知会话直接返回
@@ -167,7 +270,7 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 	* @param sessionId - 要取消归档的会话。
 	* @returns 更新后的完整归档集合。
 	*/
-	async unarchiveSession(sessionId) {
+	async unarchiveSession(sessionId) {
 		return this.enqueueOperation(async () => {
 			if (!await this.sessionKnown(sessionId)) throw new ArchiveUnknownSessionError(sessionId);
 			const state = this.requireState();
@@ -178,8 +281,108 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 			};
 			await this.setState(next);
 			return { archivedSessionIds: [...next.archivedSessionIds] };
-		});
-	}
+		});
+	}
+	/**
+	* 按宿主权威归档集合一次恢复全部、一个工作区或未分组的归档会话。
+	* 目标全部来自已归档集合，因此即使日志已被外部移除，也会清掉陈旧归档标记。
+	*/
+	async unarchiveSessions(target) {
+		return this.enqueueOperation(async () => {
+			const unarchivedSessionIds = this.archivedSessionIdsForTarget(target);
+			if (unarchivedSessionIds.length === 0) return {
+				archivedSessionIds: [...this.requireState().archivedSessionIds],
+				unarchivedSessionIds: []
+			};
+			const restored = new Set(unarchivedSessionIds);
+			const state = this.requireState();
+			const next = {
+				...state,
+				archivedSessionIds: state.archivedSessionIds.filter((id) => !restored.has(id))
+			};
+			await this.setState(next);
+			return {
+				archivedSessionIds: [...next.archivedSessionIds],
+				unarchivedSessionIds
+			};
+		});
+	}
+	/**
+	* 按作用域永久删除归档会话。跨会话文件删除无法组成事务，因此继续处理
+	* 后续目标并把成功、并发消失和失败分别返回给客户端。
+	*/
+	async deleteArchivedSessions(target) {
+		return this.enqueueOperation(async () => {
+			const requestedSessionIds = this.archivedSessionIdsForTarget(target);
+			const deletedSessionIds = [];
+			const skippedSessionIds = [];
+			const failures = [];
+			for (const sessionId of requestedSessionIds) {
+				try {
+					await this.deleteSessionCore(sessionId);
+					deletedSessionIds.push(sessionId);
+				} catch (error) {
+					if (error instanceof ArchiveUnknownSessionError) {
+						// 转录已消失时仍需清完可达的持久痕迹；只有全部完成才算
+						// skipped，否则保留归档标记并作为 failure 暴露，允许重试。
+						try {
+							await this.cleanupUnknownArchivedSession(sessionId);
+							skippedSessionIds.push(sessionId);
+						} catch (cleanupError) {
+							failures.push({ sessionId, message: String(cleanupError) });
+						}
+						continue;
+					}
+					failures.push({ sessionId, message: String(error) });
+				}
+			}
+			return { requestedSessionIds, deletedSessionIds, skippedSessionIds, failures };
+		});
+	}
+	/**
+	* 清理已无转录的陈旧归档项。缓存墓碑只在清除在途写入期间短暂持有：
+	* workspace 没有可记录的旧 header 身份，永久保留它会挡住未来的冷复用。
+	* 归档标记最后清除，前序可失败步骤出错时批量入口仍能再次命中。
+	*/
+	async cleanupUnknownArchivedSession(sessionId) {
+		const projCache = this.ctx.get("sessionProjectionCache");
+		await projCache?.whenIdle?.();
+		if (projCache !== void 0) {
+			await projCache.delete(sessionId);
+			// 等待删除期间可能已进入的写回观察到墓碑并完成补删，再允许
+			// 同 id 的未来新生命周期写入缓存。
+			await projCache.whenIdle?.();
+			projCache.clearTombstone?.(sessionId);
+		}
+		await this.cleanSpill(sessionId);
+		await this.removeFromWorkspaceAccounts(sessionId);
+		const state = this.requireState();
+		if (state.archivedSessionIds.includes(sessionId)) {
+			await this.setState({
+				...state,
+				archivedSessionIds: state.archivedSessionIds.filter((id) => id !== sessionId)
+			});
+		}
+	}
+	/** 以归档集合顺序解析批量目标，避免依赖浏览器尚未加载完整的摘要投影。 */
+	archivedSessionIdsForTarget(target) {
+		target = archivedBatchTargetSchema.parse(target);
+		const state = this.requireState();
+		const archivedSessionIds = [...new Set(state.archivedSessionIds)];
+		if (target.scope === "all") return archivedSessionIds;
+		if (target.scope === "workspace") {
+			const workspace = this.requireTable().get(target.workspaceId);
+			if (workspace === void 0) throw new Error(`unknown workspace "${target.workspaceId}"`);
+			const accounted = new Set(workspace.sessionIds);
+			return archivedSessionIds.filter((id) => accounted.has(id));
+		}
+		const accounted = /* @__PURE__ */ new Set();
+		const table = this.requireTable();
+		for (const workspaceId of state.workspaceIds) {
+			for (const sessionId of table.get(workspaceId)?.sessionIds ?? []) accounted.add(sessionId);
+		}
+		return archivedSessionIds.filter((id) => !accounted.has(id));
+	}
 	/**
 	* 永久删除一个会话及其全部痕迹（转录目录、工作区记账、归档标记、
 	* 投影缓存行）。
@@ -211,7 +414,8 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 		// dispose 的写后落盘必须先于缓存行删除完成，
 		// 否则该行会在删除之后被写回（复活）。
 		await projCache?.whenIdle?.();
-		// 物理删除不可逆：先完成所有可失败的持久化清理，失败时仍可重试。
+		// 先完成父会话的可失败记账清理；SUBAGENT 级联跨目录且非事务，可能
+		// 部分完成，但父转录失败时仍保留索引供重试。
 		const state = this.requireState();
 		if (state.archivedSessionIds.includes(sessionId)) {
 			await this.setState({
@@ -233,12 +437,15 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 	* 从父类内存索引中遗忘已删除会话，并阻止后续 indexHeaders 把它加回。
 	* 实时会话以同 id 重新出现时（自定义 id 复用）会撤掉墓碑。
 	*/
-	clearTombstone(sessionId) {
-		this.deletedSessionIds.delete(sessionId);
-		this.deletedIdentities.delete(sessionId);
-		const idx = this.deletedSessionOrder.indexOf(sessionId);
-		if (idx !== -1) this.deletedSessionOrder.splice(idx, 1);
-	}
+	clearTombstone(sessionId) {
+		this.deletedSessionIds.delete(sessionId);
+		this.deletedIdentities.delete(sessionId);
+		const idx = this.deletedSessionOrder.indexOf(sessionId);
+		if (idx !== -1) this.deletedSessionOrder.splice(idx, 1);
+		// workspace 与 projection-cache 共同描述同一删除生命周期；新生命周期
+		// 被接纳时必须同步撤销两处墓碑，否则缓存写入仍会永久被拦截。
+		this.ctx.get("sessionProjectionCache")?.clearTombstone?.(sessionId);
+	}
 	forgetIndexedSession(sessionId) {
 		for (const evicted of trackTombstone(this.deletedSessionIds, this.deletedSessionOrder, sessionId, this.deletedSessionTombstoneLimit)) this.deletedIdentities.delete(evicted);
 		this.headers.delete(sessionId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-archive-manager",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "NPM-installable DSH Web plugin for managing archived sessions.",
   "type": "module",
   "packageManager": "pnpm@11.21.0",