@michengai/dsh-archive-manager 0.1.20 → 0.1.22

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 Published release notes are retained below; new versions are added without removing earlier entries.
 
+## 0.1.22 — 2026-09-01
+
+- Added arbitrary archived-chat selection in **Settings → Archived**, including per-row checkboxes, select-all for the current filtered results, cross-project selection, batch restore, and confirmed batch permanent deletion.
+- Kept selected operations on the existing authoritative host batch path, so stale records, partial deletion failures, and retry behavior match existing project-wide and all-chat actions.
+- Refreshed the client session projection after restoring chats so restored sessions immediately reappear in their original workspace.
+
+Published package: [`@michengai/dsh-archive-manager@0.1.22`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.22).
+
+## 0.1.21 — 2026-08-31
+
+- Preserved the projection-cache `put()` Promise contract when a tombstone suppresses a deleted Session write, so DSH `v0.1.2-alpha.2` cold-read write-back remains fail-soft instead of throwing a synchronous `TypeError`.
+- Added direct `put(...).catch(...)` regression coverage for alpha.2 while retaining the `putSoft` path used by DSH `v0.1.1-rc.2`, and clarified the separate safe cache domain and migration behavior.
+
+Published package: [`@michengai/dsh-archive-manager@0.1.21`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.21).
+
 ## 0.1.20 — 2026-08-31
 
 - Kept IM and other non-filesystem-safe Session ids unchanged while persisting projection checkpoints under fixed-length safe keys, preventing DSH `v0.1.2-alpha.2` from using colons as Windows filenames.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,21 @@
 
 以下发布说明会持续保留；新增版本时不再删除较早记录。
 
+## 0.1.22 — 2026-09-01
+
+- 在「设置 → 已归档」新增任意多选：每行复选框、全选当前筛选结果、跨项目保留选择、批量恢复和确认后的批量永久删除。
+- 所选操作复用宿主权威批量路径，陈旧记录清理、部分删除失败和重试行为与项目级及全部操作保持一致。
+- 恢复聊天后刷新客户端会话投影，使其立刻重新出现在原工作区。
+
+已发布包：[`@michengai/dsh-archive-manager@0.1.22`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.22)。
+
+## 0.1.21 — 2026-08-31
+
+- 墓碑拦截已删除会话的投影缓存写入时仍保持 `put()` 的 Promise 契约，使 DSH `v0.1.2-alpha.2` 冷读写回继续按 fail-soft 方式处理，而不会同步抛出 `TypeError`。
+- 补充 alpha.2 直接调用 `put(...).catch(...)` 的回归测试，同时保留 DSH `v0.1.1-rc.2` 使用的 `putSoft` 路径覆盖，并澄清独立安全缓存域与迁移行为。
+
+已发布包：[`@michengai/dsh-archive-manager@0.1.21`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.21)。
+
 ## 0.1.20 — 2026-08-31
 
 - 保持 IM 等不适合作文件名的会话 ID 不变，将投影检查点改用固定长度安全键落盘，避免 DSH `v0.1.2-alpha.2` 在 Windows 上把冒号直接用作文件名。

package/lib/client.js

@@ -49,7 +49,8 @@ window.__ModuleLoader__.load({
 				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");
+				if (value.scope === "sessions" && Array.isArray(value.sessionIds) && value.sessionIds.length > 0 && value.sessionIds.every((id) => typeof id === "string" && id.length > 0)) return value;
+				throw new TypeError("target.scope must be all, ungrouped, workspace with a non-empty workspaceId, or sessions with non-empty sessionIds");
 			}
 		};
 		const unarchivedBatchSchema = {
@@ -283,6 +284,195 @@ window.__ModuleLoader__.load({
 				}
 			});
 		}
+		/**
+		* 归档多选原型。保留既有设置页作为兼容回退，原型直接使用相同宿主
+		* 批量接口，因此其恢复、删除和并发安全语义与原有项目级操作一致。
+		*/
+		function ArchivedSessionsSectionPrototype({ 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 [selectedSessionIds, setSelectedSessionIds] = (0, react.useState)([]);
+			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) setCreatedAtById(Object.fromEntries(result.items.map((item) => [item.sessionId, item.createdAt])));
+				}).catch(() => {
+					if (!cancelled) setCreatedAtById({});
+				});
+				return () => {
+					cancelled = true;
+				};
+			}, [archivedSessionMetadata, workspaceState.archivedSessionIds]);
+			(0, react.useEffect)(() => {
+				if (project !== "all" && !groups.some((group) => group.key === project)) setProject("all");
+			}, [groups, project]);
+			const filteredGroups = (0, react.useMemo)(() => {
+				const normalizedQuery = query.trim().toLocaleLowerCase();
+				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);
+			}, [sortedGroups, project, query, t]);
+			const visibleSessionIds = (0, react.useMemo)(() => archivedSessionIdsInGroups(filteredGroups), [filteredGroups]);
+			const selectedSessionIdSet = (0, react.useMemo)(() => new Set(selectedSessionIds), [selectedSessionIds]);
+			const selectedVisibleCount = visibleSessionIds.filter((sessionId) => selectedSessionIdSet.has(sessionId)).length;
+			const allVisibleSelected = visibleSessionIds.length > 0 && selectedVisibleCount === visibleSessionIds.length;
+			const allBatchTarget = { scope: "all" };
+			const allBatchSessionIds = (0, react.useMemo)(() => deriveArchivedBatchIds(workspaceState.archivedSessionIds, workspaceState.items, allBatchTarget), [workspaceState.archivedSessionIds, workspaceState.items]);
+			(0, react.useEffect)(() => {
+				setSelectedSessionIds((current) => pruneArchivedSelection(current, workspaceState.archivedSessionIds));
+			}, [workspaceState.archivedSessionIds]);
+			const toggleSessionSelection = (sessionId, checked) => {
+				setSelectedSessionIds((current) => toggleArchivedSelection(current, [sessionId], checked));
+			};
+			const toggleVisibleSelection = (checked) => {
+				setSelectedSessionIds((current) => toggleArchivedSelection(current, visibleSessionIds, checked));
+			};
+			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 }));
+					return result;
+				} catch (reason) {
+					setError(t("archives.restoreBatchFailed", { detail: reason instanceof Error ? reason.message : String(reason) }));
+				} finally {
+					setBusy(false);
+				}
+			};
+			const onSelectedUnarchive = async () => {
+				if (selectedSessionIds.length === 0) return;
+				const result = await onBatchUnarchive({ scope: "sessions", sessionIds: selectedSessionIds });
+				if (result !== void 0) {
+					const restored = new Set(result.unarchivedSessionIds);
+					setSelectedSessionIds((current) => current.filter((sessionId) => !restored.has(sessionId)));
+				}
+			};
+			const closeDelete = () => {
+				if (!busy) setDeleteTarget(null);
+			};
+			(0, react.useEffect)(() => {
+				if (deleteTarget === null) return;
+				const onKeyDown = (event) => {
+					if (event.key !== "Escape") return;
+					event.preventDefault();
+					event.stopPropagation();
+					if (typeof event.stopImmediatePropagation === "function") event.stopImmediatePropagation();
+					if (!busy) setDeleteTarget(null);
+				};
+				window.addEventListener("keydown", onKeyDown, true);
+				return () => window.removeEventListener("keydown", onKeyDown, true);
+			}, [deleteTarget, busy]);
+			const confirmDelete = async () => {
+				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);
+						if (deleteTarget.target.scope === "sessions") {
+							const completed = new Set([...result.deletedSessionIds, ...result.skippedSessionIds]);
+							setSelectedSessionIds((current) => current.filter((sessionId) => !completed.has(sessionId)));
+						}
+					} else {
+						await deleteSession(deleteTarget.session.id);
+					}
+					setDeleteTarget(null);
+				} catch (reason) {
+					setError(formatDeleteError(reason, t));
+				} 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 }) : batchScope === "sessions" ? t("archives.deleteSelectedTitle") : 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 }) : batchScope === "sessions" ? t("archives.deleteSelectedDesc", { 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") : batchScope === "sessions" ? t("archives.deleteSelectedConfirm") : 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 + ARCHIVE_SETTINGS_SELECTION_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.jsxs)("div", {
+					className: "dsham_settingsSelection",
+					children: [(0, react_jsx_runtime.jsxs)("label", {
+						className: "dsham_settingsSelectionToggle",
+						children: [(0, react_jsx_runtime.jsx)(ArchiveSelectionCheckbox, { checked: allVisibleSelected, indeterminate: selectedVisibleCount > 0 && !allVisibleSelected, disabled: busy || visibleSessionIds.length === 0, label: t("archives.selectAllFiltered"), onChange: (event) => toggleVisibleSelection(event.target.checked) }), t("archives.selectAllFiltered")]
+					}), (0, react_jsx_runtime.jsx)("span", { className: "dsham_settingsSelectionCount", children: t("archives.selectedCount", { n: selectedSessionIds.length }) }), (0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsSelectionAction", disabled: busy || selectedSessionIds.length === 0, onClick: onSelectedUnarchive, children: t("archives.restoreSelected") }), (0, react_jsx_runtime.jsx)("button", { type: "button", className: "dsham_settingsSelectionAction dsham_settingsSelectionDelete", disabled: busy || selectedSessionIds.length === 0, onClick: () => setDeleteTarget({ kind: "batch", target: { scope: "sessions", sessionIds: selectedSessionIds }, count: selectedSessionIds.length }), children: t("archives.deleteSelected") })]
+				}), 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.jsx)(ArchiveSelectionCheckbox, { checked: selectedSessionIdSet.has(session.id), disabled: busy, label: t("archives.selectSession", { name: displayTitle(session, t) }), onChange: (event) => toggleSessionSelection(session.id, event.target.checked) }), (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 || 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
 		//#region ../../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 		function r(e) {
@@ -2622,6 +2812,7 @@ window.__ModuleLoader__.load({
 		//#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_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_SELECTION_CSS = ".dsham_settingsSelection{display:flex;align-items:center;gap:10px;min-height:40px;margin:-8px 0 16px;padding:4px 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-button-elevated-fill))}.dsham_settingsSelectionToggle{display:inline-flex;align-items:center;gap:8px;min-width:0;color:var(--dsw-alias-label-primary);font-size:13px;cursor:pointer}.dsham_settingsCheckbox{width:16px;height:16px;margin:0;accent-color:#3b82f6}.dsham_settingsSelectionCount{margin-right:auto;color:var(--dsw-alias-label-tertiary);font-size:12px}.dsham_settingsSelectionAction{min-height:28px;padding:0 10px;color:var(--dsw-alias-label-primary);background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:7px;cursor:pointer;font:inherit;font-size:12px;font-weight:500}.dsham_settingsSelectionAction:hover{background:var(--dsw-alias-interactive-bg-hover)}.dsham_settingsSelectionDelete{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary)}.dsham_settingsSelectionAction:disabled{cursor:not-allowed;opacity:.5}@media(max-width:720px){.dsham_settingsSelection{flex-wrap:wrap}.dsham_settingsSelectionCount{margin-right:0}.dsham_settingsSelectionAction{margin-left:auto}.dsham_settingsSelectionAction+.dsham_settingsSelectionAction{margin-left:-2px}}";
 		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");
@@ -2762,6 +2953,22 @@ window.__ModuleLoader__.load({
 				}) : null]
 			});
 		}
+		/** 原生 checkbox 保留浏览器的正确键盘语义，并显式同步三态显示。 */
+		function ArchiveSelectionCheckbox({ checked, indeterminate = false, disabled = false, label, onChange }) {
+			const inputRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				if (inputRef.current !== null) inputRef.current.indeterminate = indeterminate;
+			}, [indeterminate]);
+			return (0, react_jsx_runtime.jsx)("input", {
+				ref: inputRef,
+				type: "checkbox",
+				className: "dsham_settingsCheckbox",
+				checked,
+				disabled,
+				"aria-label": label,
+				onChange
+			});
+		}
 		/** 项目标题右侧的批量恢复/删除菜单，复用宿主菜单组件的键盘和焦点行为。 */
 		function ArchivedGroupActions({ group, busy, onRestore, onDelete, t }) {
 			const [open, setOpen] = (0, react.useState)(false);
@@ -2805,6 +3012,10 @@ window.__ModuleLoader__.load({
 		function deriveArchivedBatchIds(archivedSessionIds, items, target) {
 			const ids = [...new Set(archivedSessionIds ?? [])];
 			if (target.scope === "all") return ids;
+			if (target.scope === "sessions") {
+				const selected = new Set(target.sessionIds ?? []);
+				return ids.filter((id) => selected.has(id));
+			}
 			if (target.scope === "workspace") {
 				const accounted = new Set(items.find((workspace) => workspace.workspaceId === target.workspaceId)?.sessionIds ?? []);
 				return ids.filter((id) => accounted.has(id));
@@ -2812,6 +3023,24 @@ window.__ModuleLoader__.load({
 			const accounted = new Set(items.flatMap((workspace) => workspace.sessionIds));
 			return ids.filter((id) => !accounted.has(id));
 		}
+		/** 当前筛选结果中的可选会话；按列表显示顺序去重。 */
+		function archivedSessionIdsInGroups(groups) {
+			return [...new Set(groups.flatMap((group) => group.sessions.map((session) => session.id)))];
+		}
+		/** 只保留仍属于权威归档集合的选中项，避免对已变化的列表执行旧操作。 */
+		function pruneArchivedSelection(selectedSessionIds, archivedSessionIds) {
+			const archived = new Set(archivedSessionIds);
+			return [...new Set(selectedSessionIds)].filter((id) => archived.has(id));
+		}
+		/** 向当前选择中加入或移除一组可见会话，供“全选筛选结果”复用。 */
+		function toggleArchivedSelection(selectedSessionIds, sessionIds, checked) {
+			const selected = new Set(selectedSessionIds);
+			for (const sessionId of sessionIds) {
+				if (checked) selected.add(sessionId);
+				else selected.delete(sessionId);
+			}
+			return [...selected];
+		}
 		/** 把批量删除结果转换为准确区分“已删除”与“陈旧标记已清理”的反馈。 */
 		function archivedDeleteFeedback(result, t) {
 			const deleted = result.deletedSessionIds.length;
@@ -2898,6 +3127,7 @@ window.__ModuleLoader__.load({
 			const [createdAtById, setCreatedAtById] = (0, react.useState)({});
 			const [unarchivingSessionIds, setUnarchivingSessionIds] = (0, react.useState)(() => /* @__PURE__ */ new Set());
 			const unarchivingSessionIdsRef = (0, react.useRef)(/* @__PURE__ */ new Set());
+			const [selectedSessionIds, setSelectedSessionIds] = (0, react.useState)([]);
 			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)(() => {
@@ -2926,8 +3156,21 @@ window.__ModuleLoader__.load({
 					sessions: group.sessions.filter((session) => normalizedQuery === "" || displayTitle(session, t).toLocaleLowerCase().includes(normalizedQuery))
 				})).filter((group) => group.sessions.length > 0);
 			}, [sortedGroups, project, query, t]);
+			const visibleSessionIds = (0, react.useMemo)(() => archivedSessionIdsInGroups(filteredGroups), [filteredGroups]);
+			const selectedSessionIdSet = (0, react.useMemo)(() => new Set(selectedSessionIds), [selectedSessionIds]);
+			const selectedVisibleCount = visibleSessionIds.filter((sessionId) => selectedSessionIdSet.has(sessionId)).length;
+			const allVisibleSelected = visibleSessionIds.length > 0 && selectedVisibleCount === visibleSessionIds.length;
 			const allBatchTarget = { scope: "all" };
 			const allBatchSessionIds = (0, react.useMemo)(() => deriveArchivedBatchIds(workspaceState.archivedSessionIds, workspaceState.items, allBatchTarget), [workspaceState.archivedSessionIds, workspaceState.items]);
+			(0, react.useEffect)(() => {
+				setSelectedSessionIds((current) => pruneArchivedSelection(current, workspaceState.archivedSessionIds));
+			}, [workspaceState.archivedSessionIds]);
+			const toggleSessionSelection = (sessionId, checked) => {
+				setSelectedSessionIds((current) => toggleArchivedSelection(current, [sessionId], checked));
+			};
+			const toggleVisibleSelection = (checked) => {
+				setSelectedSessionIds((current) => toggleArchivedSelection(current, visibleSessionIds, checked));
+			};
 			const onUnarchive = (sessionId) => {
 				if (busy || unarchivingSessionIdsRef.current.has(sessionId)) return;
 				unarchivingSessionIdsRef.current.add(sessionId);
@@ -2949,12 +3192,21 @@ window.__ModuleLoader__.load({
 				try {
 					const result = await unarchiveSessions(target);
 					setNotice(t("archives.restoreSuccess", { n: result.unarchivedSessionIds.length }));
+					return result;
 				} catch (reason) {
 					setError(t("archives.restoreBatchFailed", { detail: reason instanceof Error ? reason.message : String(reason) }));
 				} finally {
 					setBusy(false);
 				}
 			};
+			const onSelectedUnarchive = async () => {
+				if (selectedSessionIds.length === 0) return;
+				const result = await onBatchUnarchive({ scope: "sessions", sessionIds: selectedSessionIds });
+				if (result !== void 0) {
+					const restored = new Set(result.unarchivedSessionIds);
+					setSelectedSessionIds((current) => current.filter((sessionId) => !restored.has(sessionId)));
+				}
+			};
 			const closeDelete = () => {
 				if (!busy) setDeleteTarget(null);
 			};
@@ -2981,6 +3233,10 @@ window.__ModuleLoader__.load({
 						const feedback = archivedDeleteFeedback(result, t);
 						if (feedback.kind === "error") setError(feedback.message);
 						else setNotice(feedback.message);
+						if (deleteTarget.target.scope === "sessions") {
+							const completed = new Set([...result.deletedSessionIds, ...result.skippedSessionIds]);
+							setSelectedSessionIds((current) => current.filter((sessionId) => !completed.has(sessionId)));
+						}
 					} else {
 						await deleteSession(deleteTarget.session.id);
 					}
@@ -2992,9 +3248,9 @@ window.__ModuleLoader__.load({
 				}
 			};
 			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");
+			const deleteDialogTitle = batchScope === "all" ? t("archives.deleteAllTitle") : batchScope === "ungrouped" ? t("archives.deleteUngroupedTitle") : batchScope === "workspace" ? t("archives.deleteProjectTitle", { name: deleteTarget.title }) : batchScope === "sessions" ? t("archives.deleteSelectedTitle") : 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 }) : batchScope === "sessions" ? t("archives.deleteSelectedDesc", { 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") : batchScope === "sessions" ? t("archives.deleteSelectedConfirm") : t("deleteSession.title");
 			return (0, react_jsx_runtime.jsxs)("section", {
 				className: "dsham_settings",
 				"aria-label": t("archives.title"),
@@ -3075,6 +3331,11 @@ window.__ModuleLoader__.load({
 			"archives.projectFilter": "按项目筛选",
 			"archives.allProjects": "所有项目",
 			"archives.sessionCount": "{n} 个聊天",
+			"archives.selectAllFiltered": "全选当前筛选结果",
+			"archives.selectSession": "选择会话“{name}”",
+			"archives.selectedCount": "已选 {n} 个",
+			"archives.restoreSelected": "恢复所选",
+			"archives.deleteSelected": "删除所选",
 			"archives.timestamp": "{date}，{time}",
 			"archives.restoreAll": "全部恢复",
 			"archives.restoreProject": "恢复该项目的全部聊天",
@@ -3088,6 +3349,9 @@ window.__ModuleLoader__.load({
 			"archives.deleteAll": "全部删除",
 			"archives.deleteAllTitle": "删除全部已归档聊天",
 			"archives.deleteAllDesc": "将永久删除全部 {n} 个已归档聊天及其子代理（含正在运行的）和记录，此操作不可恢复。",
+			"archives.deleteSelectedTitle": "删除所选已归档聊天",
+			"archives.deleteSelectedDesc": "将永久删除所选的 {n} 个已归档聊天及其子代理（含正在运行的）和记录。其他聊天不会受影响，此操作不可恢复。",
+			"archives.deleteSelectedConfirm": "删除所选聊天",
 			"archives.deleteAllPending": "正在删除已归档聊天…",
 			"archives.deleteProjectTitle": "删除“{name}”中的已归档聊天",
 			"archives.deleteProjectDesc": "将永久删除“{name}”中的 {n} 个已归档聊天及其子代理和记录。项目目录和未归档聊天不会受影响，此操作不可恢复。",
@@ -3191,6 +3455,11 @@ window.__ModuleLoader__.load({
 			"archives.projectFilter": "Filter by project",
 			"archives.allProjects": "All projects",
 			"archives.sessionCount": "{n} chats",
+			"archives.selectAllFiltered": "Select all results",
+			"archives.selectSession": "Select chat {name}",
+			"archives.selectedCount": "{n} selected",
+			"archives.restoreSelected": "Restore selected",
+			"archives.deleteSelected": "Delete selected",
 			"archives.timestamp": "{date}, {time}",
 			"archives.restoreAll": "Restore all",
 			"archives.restoreProject": "Restore all chats in this project",
@@ -3204,6 +3473,9 @@ window.__ModuleLoader__.load({
 			"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.deleteSelectedTitle": "Delete selected archived chats",
+			"archives.deleteSelectedDesc": "This permanently deletes the selected {n} archived chats, their child agents (including any that are still running), and their records. Other chats are not affected. This cannot be undone.",
+			"archives.deleteSelectedConfirm": "Delete selected chats",
 			"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.",
@@ -3482,11 +3754,20 @@ window.__ModuleLoader__.load({
 			});
 			const browserFlowSource = flowSource("sidebar.workspaces.directoryFlow");
 			const pickerFlowSource = flowSource("conversation.hero.workspace.directoryFlow");
+			const refreshSessionList = async () => {
+				if (typeof ctx.sessions.refresh !== "function") return;
+				try {
+					await ctx.sessions.refresh();
+				} catch (error) {
+					console.warn("archive-manager: restored archived sessions but session list refresh failed:", error);
+				}
+			};
 			const unarchiveSession = 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.unarchiveSession(sessionId);
 				if (!result.ok) throw new Error(result.error.message);
+				await refreshSessionList();
 			};
 			const deleteSession = async (sessionId) => {
 				const registry = ctx.get("remote.workspaceRegistry");
@@ -3499,6 +3780,7 @@ window.__ModuleLoader__.load({
 				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);
+				await refreshSessionList();
 				return result.value;
 			};
 			const deleteArchivedSessions = async (target) => {
@@ -3605,7 +3887,7 @@ window.__ModuleLoader__.load({
 					archivedSessionMetadata,
 					t: ctx.locale.bind(NS)
 				})
-			}, ArchivedSessionsSection));
+			}, ArchivedSessionsSectionPrototype));
 		}
 		//#endregion
 		/** Pure derivation surface for dsh-archive-manager self-tests (no-op for the runtime). */
@@ -3620,6 +3902,9 @@ window.__ModuleLoader__.load({
 			deriveArchivedGroups,
 			sortArchivedGroups,
 			deriveArchivedBatchIds,
+			archivedSessionIdsInGroups,
+			pruneArchivedSelection,
+			toggleArchivedSelection,
 			archivedDeleteFeedback,
 			createWorkspaceViewStore,
 			bindObservable,

package/lib/projcache.js

@@ -122,10 +122,11 @@ async function importMissingRecords(ctx, target, records, label) {
 }
 
 /**
- * Seed the compatibility domain without ever opening alpha.2's unsafe
- * per-record source while a v3 whole-file cache is present. Imports are
- * add-only: a newer compatibility-domain checkpoint always wins, and a
- * partially completed import resumes on the next startup.
+ * Seed the compatibility domain without opening alpha.2's unsafe per-record
+ * source while the v3 whole-file cache contains rows. An empty v3 source may
+ * fall through to the current source; source-open failures stay fail-soft.
+ * Imports are add-only: a newer compatibility-domain checkpoint always wins,
+ * and a partially completed import resumes on the next startup.
  */
 async function importPreviousProjectionCache(ctx, target) {
 	const legacy = await readSourceRecords(ctx, legacyProjectionCacheDomainSpec, "legacy v3");
@@ -142,17 +143,19 @@ async function importPreviousProjectionCache(ctx, target) {
 /**
  * dsh-archive-manager projcache 半边。
  *
- * `ArchiveProjectionCache` 继承上游 `SessionProjectionCache`
- * （服务名 `sessionProjectionCache`，同域、同 fail-soft 写路径），
- * 为归档管理的 `deleteSession` 增加三处守护：
+ * `ArchiveProjectionCache` 继承上游 `SessionProjectionCache`，保留服务名
+ * `sessionProjectionCache` 与 fail-soft 写路径，但使用独立、路径安全的
+ * `session_projcache_archive_manager` 兼容域，为归档管理的
+ * `deleteSession` 增加三处守护：
  *
- * - `delete(id)` - 永久移除一个会话的缓存投影行
- *   （`session_projcache` 域上的 `table.delete`），写入前先登记墓碑。
+ * - `delete(id)` - 永久移除兼容域中该会话经 SHA-256 映射的缓存投影行，
+ *   写入前先登记墓碑。
  * - `whenIdle()` - 全部在途公开写入落定后 resolve。
  * - 墓碑挡住已删除会话的写入：迟到的写入要么被直接拦截，要么在
  *   落定后补删自己的残留行，不会复活已删除的缓存条目。守护覆盖
- *   `write()`（dispose 写后路径）与 `putSoft()`（`coldSnapshot` 的
- *   冷读写回路径），两条落盘路径都纳入 `whenIdle` 跟踪。
+ *   `write()`（dispose 写后路径）与 `put()`（rc.2 的 `putSoft` 最终调用
+ *   它，alpha.2 的 `coldSnapshot` 则直接调用它），两代落盘路径都纳入
+ *   `whenIdle` 跟踪。
  *
  * 默认导出是 Service 子类（与上游 `@deepseek-ai/dsh-session-projection-cache`
  * 包同形），profile 补丁可直接替换 `session-projection-cache` 服务行，
@@ -201,7 +204,9 @@ var ArchiveProjectionCache = class extends SessionProjectionCache {
 	 * 直接经 `put`；把墓碑与 whenIdle 跟踪放在这里可同时兼容两代实现。
 	 */
 	put(id, identity, rows) {
-		if (this.deletedSessionIds.has(id)) return;
+		// alpha.2 coldSnapshot unconditionally chains `.catch()` onto put().
+		// A blocked write must therefore preserve the upstream Promise contract.
+		if (this.deletedSessionIds.has(id)) return Promise.resolve();
 		const task = this.putCore(id, identity, rows);
 		this.writeTail = Promise.allSettled([this.writeTail, task]).then(() => void 0);
 		return task;

package/lib/workspace.js

@@ -84,7 +84,8 @@ const archivedBatchTargetSchema = {
 		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");
+		if (value.scope === "sessions" && Array.isArray(value.sessionIds) && value.sessionIds.length > 0 && value.sessionIds.every((id) => typeof id === "string" && id.length > 0)) return value;
+		throw new TypeError("target.scope must be all, ungrouped, workspace with a non-empty workspaceId, or sessions with non-empty sessionIds");
 	}
 };
 const unarchivedBatchSchema = {
@@ -400,6 +401,10 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 		const state = this.requireState();
 		const archivedSessionIds = [...new Set(state.archivedSessionIds)];
 		if (target.scope === "all") return archivedSessionIds;
+		if (target.scope === "sessions") {
+			const selected = new Set(target.sessionIds);
+			return archivedSessionIds.filter((id) => selected.has(id));
+		}
 		if (target.scope === "workspace") {
 			const workspace = this.requireTable().get(target.workspaceId);
 			if (workspace === void 0) throw new Error(`unknown workspace "${target.workspaceId}"`);

package/package.json

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