@michengai/dsh-archive-manager 0.1.2 → 0.1.4

package/README.md

@@ -21,17 +21,20 @@
   <img src="https://img.shields.io/badge/Node.js-22%2B-339933?logo=nodedotjs&logoColor=white" alt="Node.js 22 or later">
 </p>
 
+<p align="center">
+  <img src="assets/screenshots/archived-sessions.png" alt="Archived Sessions settings page" width="1200">
+</p>
+
 > DSH Archive Manager is a community-maintained plugin, not an official DeepSeek AI product.
 
 ## Features
 
+- Archives a session from the sidebar session menu.
 - Lists archived sessions by workspace in **Settings → Archived Sessions**.
 - Safely restores a session to its original workspace position.
 - Permanently deletes a confirmed session, its workspace association, archive marker, and projection cache.
 - Removes unloaded deleted sessions from connected sidebars immediately.
 
-![Archived Sessions settings page](assets/screenshots/archived-sessions.png)
-
 ## Prerequisites
 
 - A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
@@ -73,11 +76,15 @@ Restart DSH Web and hard-refresh the browser. Local installation applies `cordis
 
 ## Usage
 
-1. Open **Settings → Archived Sessions**.
-2. Expand a workspace group to inspect its archived sessions.
-3. Select **Unarchive** to restore a session, or **Delete** to remove it permanently.
+1. Open the sidebar session menu and choose **Archive session**.
+2. Open **Settings → Archived Sessions** to inspect sessions by workspace.
+3. Select **Unarchive** to restore a session, or use the delete icon to remove it permanently.
 4. Confirm deletion. **It cannot be undone.**
 
+<p align="center">
+  <img src="assets/screenshots/archive-session-menu.png" alt="Archive a session from the session menu" width="1200">
+</p>
+
 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.
 
 ## Data handling limits

package/README.zh-CN.md

@@ -21,17 +21,20 @@
   <img src="https://img.shields.io/badge/Node.js-22%2B-339933?logo=nodedotjs&logoColor=white" alt="Node.js 22 或更高版本">
 </p>
 
+<p align="center">
+  <img src="assets/screenshots/archived-sessions.png" alt="已归档会话设置页面" width="1200">
+</p>
+
 > DSH Archive Manager 是社区维护的插件，并非 DeepSeek AI 官方产品。
 
 ## 功能概览
 
+- 在侧栏会话菜单中选择「归档会话」。
 - 在「设置 → 已归档」按工作区展示归档会话。
 - 安全取消归档，将会话恢复到原工作区位置。
 - 经确认后永久删除会话、工作区归属、归档标记和投影缓存。
 - 已删除的未加载归档会话会立即从已连接客户端的侧栏移除。
 
-![已归档会话设置页面](assets/screenshots/archived-sessions.png)
-
 ## 前置条件
 
 - 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
@@ -73,12 +76,16 @@ dsh --profile web --dump-config
 
 ## 使用
 
-1. 打开「设置 → 已归档」。
-2. 展开工作区分组，查看其中的归档会话。
-3. 点击「取消归档」恢复会话；点击「删除」永久移除会话。
+1. 在侧栏右键或打开会话菜单，选择「归档会话」。
+2. 打开「设置 → 已归档」，按工作区查看归档会话。
+3. 点击「取消归档」恢复会话；点击删除图标永久移除会话。
 4. 删除前确认提示。**删除无法撤销。**
 
-安装或升级后找不到入口时，重启 DSH Web 并硬刷新浏览器；入口位于「设置」中，紧随「连接器」之后。
+<p align="center">
+  <img src="assets/screenshots/archive-session-menu.png" alt="从会话菜单归档会话" width="1200">
+</p>
+
+安装或升级后找不到入口时，重启 DSH Web 并硬刷新浏览器；入口位于「设置」中，连接器之后。
 
 ## 数据处理边界
 

package/lib/client.js

@@ -2456,7 +2456,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region dsh-archive-manager: settings section
 		const ARCHIVE_SETTINGS_CSS = ".dsham_settings{box-sizing:border-box;width:min(100%,768px);margin:64px auto 80px;padding:0 20px;color:var(--dsw-alias-label-primary)}.dsham_settingsHeader{display:flex;align-items:center;justify-content:space-between;gap:16px;margin-bottom:48px}.dsham_settings h2{margin:0;font-size:24px;font-weight:650;letter-spacing:-.02em;line-height:32px}.dsham_settingsDanger{display:inline-flex;align-items:center;gap:6px;height:30px;padding:0 11px;color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 12%,transparent);border:0;border-radius:9px;cursor:pointer;font-size:12px;font-weight:600}.dsham_settingsDanger:hover{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 20%,transparent)}.dsham_settingsToolbar{display:flex;gap:8px;margin-bottom:40px}.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-button-elevated-fill);border:1px solid var(--dsw-alias-border-l2);border-radius:16px}.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{min-width:132px;height:30px;padding:0 28px 0 11px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-button-elevated-fill);border:1px solid var(--dsw-alias-border-l2);border-radius:9px;cursor:pointer;font:inherit;font-size:12px}.dsham_settingsGroup{margin:0 0 48px}.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:14px;background: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{height:30px;padding:0 10px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover);border:0;border-radius:9px;cursor:pointer;font-size:12px;font-weight:600}.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_LAYOUT_OVERRIDE = ".dsham_settings{margin:24px auto 80px!important}.dsham_settingsFilter{color-scheme:dark;background-color:var(--dsw-alias-button-elevated-fill)!important;color:var(--dsw-alias-label-primary)!important}.dsham_settingsFilter option{color-scheme:dark;background-color:#2b2b2b;color:#f1f1f1}@media(max-width:720px){.dsham_settings{margin:16px auto 48px!important}}";
+		const ARCHIVE_SETTINGS_LAYOUT_OVERRIDE = ".dsham_settings{margin:24px auto 80px!important}@media(max-width:720px){.dsham_settings{margin:16px auto 48px!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");
 			tag.dataset.plugin = "@michengai/dsh-archive-manager";
@@ -2472,7 +2472,6 @@ window.__ModuleLoader__.load({
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [error, setError] = (0, react.useState)(null);
 			const [query, setQuery] = (0, react.useState)("");
-			const [chatType, setChatType] = (0, react.useState)("all");
 			const [project, setProject] = (0, react.useState)("all");
 			const groups = (0, react.useMemo)(() => {
 				const archived = new Set(workspaceState.archivedSessionIds);
@@ -2496,9 +2495,9 @@ window.__ModuleLoader__.load({
 				const normalizedQuery = query.trim().toLocaleLowerCase();
 				return groups.filter((group) => project === "all" || project === group.title).map((group) => ({
 					...group,
-					sessions: group.sessions.filter((session) => (chatType === "all" || session.origin === chatType) && (normalizedQuery === "" || displayTitle(session, t).toLocaleLowerCase().includes(normalizedQuery)))
+					sessions: group.sessions.filter((session) => normalizedQuery === "" || displayTitle(session, t).toLocaleLowerCase().includes(normalizedQuery))
 				})).filter((group) => group.sessions.length > 0);
-			}, [chatType, groups, project, query, t]);
+			}, [groups, project, query, t]);
 			const archivedSessionIds = (0, react.useMemo)(() => groups.flatMap((group) => group.sessions.map((session) => session.id)), [groups]);
 			const onUnarchive = (sessionId) => {
 				setError(null);
@@ -2525,7 +2524,7 @@ window.__ModuleLoader__.load({
 			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.jsx)("h2", { children: t("archives.title") }), (0, react_jsx_runtime.jsxs)("button", { type: "button", className: "dsham_settingsDanger", disabled: busy || archivedSessionIds.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)("select", { className: "dsham_settingsFilter", value: chatType, onChange: (event) => setChatType(event.target.value), "aria-label": t("archives.chatFilter"), children: (0, react_jsx_runtime.jsx)("option", { value: "all", children: t("archives.allChats") }) }), (0, react_jsx_runtime.jsx)("select", { className: "dsham_settingsFilter", value: project, onChange: (event) => setProject(event.target.value), "aria-label": t("archives.projectFilter"), children: [(0, react_jsx_runtime.jsx)("option", { value: "all", children: t("archives.allProjects") }), groups.map((group) => (0, react_jsx_runtime.jsx)("option", { value: group.title, children: group.title }, group.title))] })] }), 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", {
+				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.jsx)("h2", { children: t("archives.title") }), (0, react_jsx_runtime.jsxs)("button", { type: "button", className: "dsham_settingsDanger", disabled: busy || archivedSessionIds.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)("select", { className: "dsham_settingsFilter", value: project, onChange: (event) => setProject(event.target.value), "aria-label": t("archives.projectFilter"), children: [(0, react_jsx_runtime.jsx)("option", { value: "all", children: t("archives.allProjects") }), groups.map((group) => (0, react_jsx_runtime.jsx)("option", { value: group.title, children: group.title }, group.title))] })] }), 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",
@@ -2591,8 +2590,6 @@ window.__ModuleLoader__.load({
 			"archives.empty": "暂无已归档会话",
 			"archives.emptyFiltered": "没有匹配的已归档聊天",
 			"archives.searchPlaceholder": "搜索已归档聊天",
-			"archives.chatFilter": "按聊天类型筛选",
-			"archives.allChats": "全部聊天",
 			"archives.projectFilter": "按项目筛选",
 			"archives.allProjects": "所有项目",
 			"archives.sessionCount": "{n} 个聊天",
@@ -2678,8 +2675,6 @@ window.__ModuleLoader__.load({
 			"archives.empty": "No archived sessions.",
 			"archives.emptyFiltered": "No archived chats match your filters.",
 			"archives.searchPlaceholder": "Search archived chats",
-			"archives.chatFilter": "Filter by chat type",
-			"archives.allChats": "All chats",
 			"archives.projectFilter": "Filter by project",
 			"archives.allProjects": "All projects",
 			"archives.sessionCount": "{n} chats",

package/lib/projcache.js

@@ -10,29 +10,35 @@ import { SessionProjectionCache } from "@deepseek-ai/dsh-session-projection-cach
  *
  * - `delete(id)` — permanently remove one session's cached projection row
  *   (`table.delete` on the `session_projcache` domain).
- * - `whenIdle()` — resolve once every in-flight fail-soft checkpoint write
- *   has settled. Session disposal triggers one final write-behind
- *   (`flushSoft(session, "detach")`); the deletion flow must wait for that
- *   write to land BEFORE deleting the row, otherwise the row is written back
- *   after deletion and resurrects the cache entry.
+ * - `whenIdle()` — resolve once every in-flight public `write()` has settled.
+ * - `delete(id)` installs a tombstone before removing the row, so an earlier
+ *   write that settles late removes its own stale row instead of resurrecting
+ *   the deleted cache entry.
  *
  * The default export is a Service subclass (same shape as the shipped
  * `@deepseek-ai/dsh-session-projection-cache` package), so the profile patch
  * can substitute this package for the `session-projection-cache` row with no
  * other wiring change.
  */
-var ArchiveProjectionCache = class extends SessionProjectionCache {
-	/** Tail of in-flight fail-soft checkpoint writes (settled promises only). */
-	writeTail = Promise.resolve();
+var ArchiveProjectionCache = class extends SessionProjectionCache {
+	/** 已永久删除的会话不会再允许投影缓存写入。 */
+	deletedSessionIds = /* @__PURE__ */ new Set();
+	/** Tail of in-flight checkpoint writes (settled promises only). */
+	writeTail = Promise.resolve();
 	constructor(ctx, config) {
 		super(ctx, config);
 	}
-	/** Fail-soft durable checkpoint, tracked so {@link whenIdle} can observe it. */
-	flushSoft(session, trigger) {
-		const task = super.flushSoft(session, trigger);
-		this.writeTail = Promise.allSettled([this.writeTail, task]).then(() => void 0);
-		return task;
-	}
+	/** 跟踪公开写入路径，避免依赖上游私有 `flushSoft` 的实现细节。 */
+	write(session) {
+		const task = this.writeCore(session);
+		this.writeTail = Promise.allSettled([this.writeTail, task]).then(() => void 0);
+		return task;
+	}
+	async writeCore(session) {
+		if (this.deletedSessionIds.has(session.id)) return;
+		await super.write(session);
+		if (this.deletedSessionIds.has(session.id)) await this.requireTable().delete(session.id);
+	}
 	/**
 	* Resolve once every tracked in-flight write has settled (failures
 	* included). Fresh calls during an idle cache resolve immediately.
@@ -46,9 +52,10 @@ var ArchiveProjectionCache = class extends SessionProjectionCache {
 	* @param id - the session whose cache row to delete.
 	* @returns resolution after the row is gone.
 	*/
-	async delete(id) {
-		await this.requireTable().delete(id);
-	}
+	async delete(id) {
+		this.deletedSessionIds.add(id);
+		await this.requireTable().delete(id);
+	}
 };
 //#endregion
 export { ArchiveProjectionCache, ArchiveProjectionCache as default };

package/lib/workspace.js

@@ -146,8 +146,9 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 			await rm(transcriptDir, { recursive: true, force: true });
 		} catch (error) {
 			const message = `cannot delete session "${sessionId}": transcript directory "${transcriptDir}" remains after bookkeeping cleanup`;
-			this.ctx.logger.warn(`archive-manager: ${message}: ${String(error)}`);
-			throw new Error(`${message}: ${String(error)}`, { cause: error });
+			const detail = `${message}: ${String(error)}`;
+			this.ctx.logger.warn(`archive-manager: ${detail}`);
+			throw new Error(detail, { cause: error });
 		}
 	}
 	/** Drop the id from every workspace record and refresh entity snapshots. */

package/package.json

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