@michengai/dsh-archive-manager 0.1.3 → 0.1.5

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/workspace.js

@@ -17,7 +17,7 @@ import { sessionDir } from "@deepseek-ai/dsh-spill-local";
 *
 * 所有可失败的持久化清理都先于不可逆的物理删除。此前任一步失败时，
 * 转录仍保留，可重试删除；物理删除失败时记录残留路径供人工排查。
-* `unarchiveSession` 与 `deleteSession` 通过 Typert Remote 暴露给浏览器。
+* `unarchiveSession` 与 `deleteSession` 通过 Typert Remote 暴露给浏览器，并注册到 typert.local，避免生产环境只靠 SRC 扫描时 404。
 */
 function markRemoteMethod(instance, method) {
 	// Simulate the TS decorator pipeline `@Remote(method)` for one method:
@@ -33,17 +33,100 @@ function markRemoteMethod(instance, method) {
 	};
 	Remote(method)(void 0, context);
 }
+const sessionIdSchema = {
+	parse(value) {
+		if (typeof value !== "string" || value.length === 0) throw new TypeError(`sessionId must be a non-empty string, got ${String(value)}`);
+		return value;
+	}
+};
+const archivedSetSchema = {
+	parse(value) {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("result must be an object");
+		const ids = value.archivedSessionIds;
+		if (!Array.isArray(ids) || ids.some((id) => typeof id !== "string")) throw new TypeError("archivedSessionIds must be a string array");
+		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;
+	}
+};
+/**
+* Host 严格描述符。网关优先读 typert.local，避免 SRC 扫描缓存
+* 或协议包双份导致 /api/workspaceRegistry/deleteSession 在生产环境 404。
+*/
+const ARCHIVE_MANAGER_INVOCATIONS = [
+	{
+		id: "@michengai/dsh-archive-manager#workspaceRegistry/unarchiveSession",
+		service: "workspaceRegistry",
+		namespace: "workspaceRegistry",
+		method: "unarchiveSession",
+		invocation: { kind: "direct" },
+		parameters: [{
+			name: "sessionId",
+			wire: "sessionId",
+			source: "json",
+			codec: { mode: "strict", typeSymbol: "@deepseek-ai/dsh-session/types#SessionId", schema: sessionIdSchema }
+		}],
+		result: {
+			mode: "strict",
+			typeSymbol: "@michengai/dsh-archive-manager/types#ArchivedSessionIds",
+			schema: archivedSetSchema
+		},
+		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+	},
+	{
+		id: "@michengai/dsh-archive-manager#workspaceRegistry/deleteSession",
+		service: "workspaceRegistry",
+		namespace: "workspaceRegistry",
+		method: "deleteSession",
+		invocation: { kind: "direct" },
+		parameters: [{
+			name: "sessionId",
+			wire: "sessionId",
+			source: "json",
+			codec: { mode: "strict", typeSymbol: "@deepseek-ai/dsh-session/types#SessionId", schema: sessionIdSchema }
+		}],
+		result: {
+			mode: "strict",
+			typeSymbol: "@michengai/dsh-archive-manager/types#Deleted",
+			schema: deletedSchema
+		},
+		sourceLocation: { file: "@michengai/dsh-archive-manager/lib/workspace.js", line: 1, column: 1 }
+	}
+];
+const ARCHIVE_MANAGER_TYPERT = {
+	package: "@michengai/dsh-archive-manager",
+	face: "host",
+	schemas: [],
+	model: { services: [], events: [], objects: [] },
+	invocations: ARCHIVE_MANAGER_INVOCATIONS
+};
+function registerHostRemote(ctx) {
+	const existing = ctx.get("typert");
+	if (existing !== undefined) {
+		existing.register(ARCHIVE_MANAGER_TYPERT);
+		return;
+	}
+	ctx.inject(["typert"], (typertCtx) => {
+		typertCtx.typert.register(ARCHIVE_MANAGER_TYPERT);
+	});
+}
 var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
 	static inject = [
 		"storageDomain",
 		"sessionPersistence",
-		"sessionProjectionCache"
+		"sessionProjectionCache",
+		"typert"
 	];
 	constructor(ctx) {
 		super(ctx);
 		this.typertRemote = bindTypertRemote(this, this.name);
 		markRemoteMethod(this, "unarchiveSession");
 		markRemoteMethod(this, "deleteSession");
+		registerHostRemote(this.ctx);
 	}
 	/**
 	* Move one session out of the registry-global archive set, restoring its

package/package.json

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