@michengai/dsh-archive-manager 0.1.0 → 0.1.1

package/README.md

@@ -5,67 +5,123 @@
 <h1 align="center">DSH Archive Manager</h1>
 
 <p align="center">
-  <strong>An npm-installable DeepSeek Harness Web plugin for managing archived sessions.</strong>
+  <strong>A DeepSeek Harness Web plugin for safely managing archived sessions.</strong>
 </p>
 
 <p align="center">
   <a href="https://github.com/MichengAI/dsh-archive-manager/issues">Report an issue</a>
-  · <a href="https://github.com/MichengAI/dsh-archive-manager">View on GitHub</a>
-</p>
-
-<p align="center">
-  <strong>English</strong> · <a href="README.zh-CN.md">简体中文</a>
+  · <a href="https://www.npmjs.com/package/@michengai/dsh-archive-manager">View on npm</a>
+  · <a href="README.zh-CN.md">简体中文</a>
 </p>
 
 <p align="center">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache License 2.0"></a>
+  <a href="https://www.npmjs.com/package/@michengai/dsh-archive-manager"><img src="https://img.shields.io/npm/v/%40michengai/dsh-archive-manager?label=npm" alt="npm package"></a>
   <img src="https://img.shields.io/badge/DSH-Web%20Plugin-10b981" alt="DSH Web Plugin">
   <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
+
+- 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)
 
-> DSH Archive Manager is a community-maintained plugin. It is not an official DeepSeek AI product.
+## Prerequisites
 
-## What it provides
+- A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
+- Examples use the `web` profile; replace it with the target profile.
+- Source installation and development require Node.js 22+ and pnpm. npm installation does not require running `npm install` in an arbitrary directory.
 
-- **Archived Sessions settings page** — placed directly after Connectors and grouped by workspace.
-- **Dark session cards** — show the session title and update time with explicit restore and delete actions.
-- **Safe unarchive** — restores a session to its original workspace position.
-- **Permanent deletion** — removes the transcript, workspace accounting, archive marker, and projection-cache record after confirmation.
-- **Immediate sidebar cleanup** — deleted cold sessions emit the standard removal event, so they do not reappear under Recent.
+## Installation
 
-## Quick start
+### Install from npm
 
-You need a working DeepSeek Harness Web installation. Install the published package into the DSH Web profile:
+Run this from any PowerShell directory. Install into the DSH profile through `dsh plugin`, not as a dependency of an unrelated project:
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web add @michengai/dsh-archive-manager
+dsh --profile web --dump-config
+```
+
+Restart DSH Web and hard-refresh the browser after installation or upgrade. If a package mirror is behind, append `--registry=https://registry.npmjs.org/`.
+
+### Install from source
+
+Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-archive-manager.git
+Set-Location .\dsh-archive-manager
+pnpm install --frozen-lockfile
+pnpm build
+dsh plugin --profile web add .
+dsh --profile web --dump-config
 ```
 
-For a local checkout, replace the package name with the absolute repository path. Restart DSH Web and hard-refresh the browser after installing or upgrading.
+Restart DSH Web and hard-refresh the browser. Local installation applies `cordis.patch.yml`; do not copy `lib` or client files manually.
 
-## Use Archived Sessions
+## Usage
 
 1. Open **Settings → Archived Sessions**.
-2. Select a workspace group to review its archived sessions.
-3. Choose **Unarchive** to restore a session, or **Delete** to permanently remove it.
-4. Confirm deletion. This action cannot be undone.
+2. Expand a workspace group to inspect its archived sessions.
+3. Select **Unarchive** to restore a session, or **Delete** to remove it permanently.
+4. Confirm deletion. **It cannot be undone.**
 
-## Before you delete
+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
 
 - Deletion always requires confirmation.
-- A deleted session is removed from its transcript directory, workspace records, archived-session set, and projection cache.
-- Live sessions finish writing before cleanup; unloaded archived sessions are also removed from connected sidebars.
+- It removes the session directory, workspace records, archive set, and projection cache.
+- A live session finishes writing before cleanup to prevent data truncation.
+- The plugin replaces DSH’s default workspace and projection services. Install through the DSH profile instead of manually composing the patch.
+
+## Secondary development
+
+This repository has no `src` directory. `lib` is directly maintained runtime source, which is its current layout rather than the recommended layout for new plugins. New plugins should prefer `src` built to `lib`.
+
+- [lib\index.js](lib/index.js): host service entry point.
+- [lib\workspace.js](lib/workspace.js): archived-session and workspace service.
+- [lib\projcache.js](lib/projcache.js): session projection cache.
+- [lib\client.js](lib/client.js): Settings page and archive UI.
+- `test\*.test.mjs`: host, client, Remote, and styling coverage.
+
+After changing the runtime source, validate, test, and install from the local directory:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm build
+pnpm test
+pnpm pack:check
+dsh plugin --profile web add .
+```
+
+`pnpm build` validates package integrity; it does not compile `lib` into another directory.
+
+## Validation
 
-## Can't find Archived Sessions?
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm build
+pnpm test
+pnpm pack:check
+```
 
-Restart DSH Web and hard-refresh the browser after installing or upgrading the plugin. The entry is located in **Settings**, directly after **Connectors**.
+`prepublishOnly` runs the build check and tests before publishing.
 
 ## License
 
-Licensed under the [Apache License 2.0](LICENSE).
+Licensed under [Apache License 2.0](LICENSE).

package/README.zh-CN.md

@@ -5,66 +5,122 @@
 <h1 align="center">DSH Archive Manager</h1>
 
 <p align="center">
-  <strong>通过 npm 安装的 DeepSeek Harness Web 插件，用于管理已归档会话。</strong>
+  <strong>安全管理已归档会话的 DeepSeek Harness Web 插件。</strong>
 </p>
 
 <p align="center">
   <a href="https://github.com/MichengAI/dsh-archive-manager/issues">反馈问题</a>
-  · <a href="https://github.com/MichengAI/dsh-archive-manager">在 GitHub 查看</a>
-</p>
-
-<p align="center">
-  <a href="README.md">English</a> · <strong>简体中文</strong>
+  · <a href="https://www.npmjs.com/package/@michengai/dsh-archive-manager">在 npm 查看</a>
+  · <a href="README.md">English</a>
 </p>
 
 <p align="center">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache License 2.0"></a>
+  <a href="https://www.npmjs.com/package/@michengai/dsh-archive-manager"><img src="https://img.shields.io/npm/v/%40michengai/dsh-archive-manager?label=npm" alt="npm 包"></a>
   <img src="https://img.shields.io/badge/DSH-Web%20Plugin-10b981" alt="DSH Web Plugin">
   <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`。
+- 以下示例使用 `web` profile；请替换为实际目标 profile。
+- 从源码安装或二次开发需要 Node.js 22+ 与 pnpm；仅从 npm 安装无需在任意目录执行 `npm install`。
 
-## 快速开始
+## 安装
 
-环境要求：可正常运行的 DeepSeek Harness Web 环境。将已发布的包安装到 DSH Web profile：
+### 从 npm 安装
+
+在任意 PowerShell 目录执行。请通过 `dsh plugin` 安装到 DSH profile，而不是在普通项目中安装该 npm 包：
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web add @michengai/dsh-archive-manager
+dsh --profile web --dump-config
+```
+
+安装或升级后重启 DSH Web，并在浏览器硬刷新。若镜像未同步最新版本，可在安装命令末尾追加 `--registry=https://registry.npmjs.org/`。
+
+### 从源码安装
+
+适用于调试或使用未发布改动。克隆后的目录会直接作为插件安装路径：
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-archive-manager.git
+Set-Location .\dsh-archive-manager
+pnpm install --frozen-lockfile
+pnpm build
+dsh plugin --profile web add .
+dsh --profile web --dump-config
 ```
 
-本地开发时，可将包名替换为仓库绝对路径。安装或升级后请重启 DSH Web，并在浏览器执行硬刷新。
+完成后重启 DSH Web 并硬刷新浏览器。`dsh plugin ... add .` 会自动应用 `cordis.patch.yml`；不要手工复制 `lib` 或客户端文件。
 
-## 使用已归档会话
+## 使用
 
 1. 打开「设置 → 已归档」。
 2. 展开工作区分组，查看其中的归档会话。
-3. 点击「取消归档」恢复会话，或点击「删除」永久移除会话。
-4. 确认删除；该操作无法撤销。
+3. 点击「取消归档」恢复会话；点击「删除」永久移除会话。
+4. 删除前确认提示。**删除无法撤销。**
+
+安装或升级后找不到入口时，重启 DSH Web 并硬刷新浏览器；入口位于「设置」中，紧随「连接器」之后。
+
+## 数据处理边界
+
+- 删除操作始终需要确认。
+- 删除会移除会话目录、工作区记录、归档集合和投影缓存。
+- 正在写入的会话会在完成写入后清理，避免截断数据。
+- 本插件替换 DSH 默认的工作区和会话投影服务；请仅通过 DSH profile 安装，避免手工拼接补丁配置。
+
+## 二次开发
 
-## 删除前请注意
+当前仓库未提供 `src` 源目录，`lib` 是直接维护的运行源码；这是当前仓库的实现方式，不是新插件的推荐布局。新插件建议使用 `src` 开发并构建到 `lib`：
 
-- 删除操作始终要求确认。
-- 删除会同步移除会话目录、工作区记录、归档集合和投影缓存。
-- 运行中的会话会在完成写入后再清理；未加载的归档会话也会从已连接客户端的侧栏移除。
+- [lib\index.js](lib/index.js)：客户端插件 Host 服务入口。
+- [lib\workspace.js](lib/workspace.js)：归档会话和工作区服务实现。
+- [lib\projcache.js](lib/projcache.js)：会话投影缓存实现。
+- [lib\client.js](lib/client.js)：设置页和归档会话界面。
+- `test\*.test.mjs`：Host、客户端、Remote 和样式边界测试。
 
-## 找不到「已归档」入口？
+修改后运行检查、测试并用本地目录重新安装：
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm build
+pnpm test
+pnpm pack:check
+dsh plugin --profile web add .
+```
+
+`pnpm build` 负责发布包完整性检查，不会将 `lib` 重新编译为其他目录。
+
+## 验证
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm build
+pnpm test
+pnpm pack:check
+```
 
-安装或升级插件后，请重启 DSH Web 并在浏览器执行硬刷新。入口位于「设置」中，紧随「连接器」之后。
+`prepublishOnly` 会在发布前执行构建检查与测试。
 
 ## 许可证
 

package/lib/client.js

@@ -2872,6 +2872,7 @@ window.__ModuleLoader__.load({
 				id: "archived-sessions",
 				order: 18,
 				label: () => ctx.locale.bind(NS)("archived.badge"),
+				icon: "archive",
 				locale: NS,
 				inject: () => ({
 					sessionStore: ctx.sessions.list,

package/package.json

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