dsh-long-archive 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 dsh-archive-view contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# dsh-long-archive
+
+[中文](README.zh.md) | English
+
+An archived-session manager for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) WebUI: an "Archived" entry at the sidebar footer opens a grouped archive panel — open a session to continue it, unarchive, or delete it (full live-agent teardown + physical log removal).
+
+Native DSH only has the "archive" action (hides the session from the sidebar); there is no way to view, restore, or delete archived sessions. This plugin fills that gap.
+
+## Features
+
+- **Archive list** — an "Archived" entry at the sidebar footer opens a panel grouping sessions by workspace, visually matching the official sidebar
+- **Continue a session** — click an archived session to open it and keep chatting; its archived state is untouched
+- **Unarchive** — put a session back into its workspace with one click, original position preserved
+- **Delete for good** — safely stops the session first, then removes its complete on-disk record; a confirmation dialog guards the action
+- **Search** — instant filtering by title or workspace, plus message search (your prompts and the assistant's replies); behaves like the official search
+- **View sync** — grouping (by workspace / one list), ordering (manual / recently updated), and drag-to-reorder all stay in real-time two-way sync with the official sidebar
+- **Bilingual UI** — English and Chinese, following the system language automatically
+- Session status at a glance: running / completed / waiting for you — same as the official sidebar
+
+## Compatibility
+
+Developed against `@deepseek-ai/dsh` **0.1.0-rc.6**. Relies on official internal shapes (`workspaceRegistry.enqueueOperation`, `AgentHandle.dispose`, the client-runtime service shapes); a dsh upgrade may require adaptation — if something misbehaves after upgrading, check whether this repo has caught up with the new version.
+
+## Install
+
+From npm (one command):
+
+```sh
+npx @deepseek-ai/dsh plugin --profile web add dsh-archive-manager
+```
+
+Or from a git checkout:
+
+```sh
+# 1. Clone the repo — any location works; this is just an example
+git clone https://github.com/Jasonrale/dsh-archive-manager.git ~/dsh-archive-manager
+
+# 2. Register it (the profile is created automatically if missing;
+#    replace the path with the one YOU cloned to)
+npx @deepseek-ai/dsh plugin --profile web add ~/dsh-archive-manager
+
+# 3. Restart dsh web
+```
+
+### Updating
+
+A local install is a snapshot, not a live link — after changing the plugin sources, re-register:
+
+```sh
+npx @deepseek-ai/dsh plugin --profile web remove dsh-archive-manager
+npx @deepseek-ai/dsh plugin --profile web add ~/dsh-archive-manager
+```
+
+## Uninstall
+
+```sh
+npx @deepseek-ai/dsh plugin --profile web remove dsh-archive-manager
+```
+
+Then restart dsh web (the source directory can be kept or deleted).
+
+## Known limitations
+
+- Sessions that were running while the plugin itself was **hot-reloaded** cannot be deleted afterwards — the plugin will refuse with a clear message asking you to restart dsh first. (Normal use is unaffected: install once, and everything — including sessions archived before the plugin existed — stays manageable.)
+
+## License
+
+MIT
+
+---
+
+## 本仓库说明（fork 适配版 2.0.0）
+
+上游 `dsh-long-archive（基于上游 dsh-archive-manager@1.1.1）` 已停更（2026-08-17 后无提交），无法在 **DSH 0.1.5-rc.2** 上工作。
+本仓库从 1.1.1 起适配，**当前版本 2.0.0**，累计 8 处兼容补丁，**未改动任何功能语义**，仅修兼容性。
+
+### 补丁清单
+
+| # | 位置 | 问题 | 修复 |
+|---|---|---|---|
+| 1 | `cordis.patch.yml` | 服务端 inject 缺 `webServer` | 补上（`connection.rpc` 内部要用） |
+| 2 | `lib/index.js` | 用了 0.1.5 已不可用的 `connection.rpc.handle('/arcv')`（内部 `owner.webServer` 拿不到注入）→ **DSH 启动即崩** | 改为直挂 HTTP 路由 `ctx.webServer.register({kind:'exact', path:'/api/dsh-archive-rpc'})` |
+| 3 | `lib/client.js` | `connection.rpc.call('/arcv')` | 改为 `fetch('/api/dsh-archive-rpc')` |
+| 4 | `lib/client.js` | 客户端 `inject` 只声明 `['slots']`，但代码用了 `sessions/workspaces/locale/layout` → 全是 undefined（标题显示成文件夹名、点不开） | 补全声明 |
+| 5 | `lib/client.js` | 调用了 0.1.2+ 已移除的 `workspaces.project()` | 加 `typeof` 保护 |
+| 6 | `package.json` | `dsh.client` 缺 `inject` 列表 → **客户端模块根本不加载**（侧栏入口不出现） | 补 7 项核心包 |
+| 7 | `lib/index.js` + `lib/client.js` | 加载期异常会冒泡 → DSH 起不来 | `apply` 整体包 **try/catch 防崩**：失败只记日志，**最坏"入口消失"，绝不拖垮 DSH** |
+| 8 | `lib/client.js` | 客户端注册 `window.__ModuleLoader__.load({ id: "dsh-archive-manager" })` 用的是**旧包名** → 加载器找不到注册，报 `loaded without registering "dsh-long-archive"`（页面提示 Failed to load plugins） | 改为 `id: "dsh-long-archive"` |
+
+### 行为说明
+
+- 入口：**侧栏底部**（`sidebar.footer.action`）→ 分组归档面板（按工作区分组、可搜索）。
+- **点会话行不预览**，只提示「先恢复再预览」（归档会话被核心的投影缓存排除，直接打开是空壳）。
+- **恢复**：点「恢复」才真正恢复到原工作区。
+- 删除：二次确认后永久删除。
+
+### 兼容性
+
+- ✅ **不替换核心插件**（不碰 `workspace`/`session-projection-cache`/`ui-workspace`），所以它失效时不会拖垮会话列表/侧栏。
+- ⚠️ 依赖 DSH 内部服务（`agents`/`sessionPersistence`/`workspaceRegistry`/`storageDomain`/`sessions`）与 `workspaces.archivedSessionIds` 字段；这些变了它会**静默失效**（入口/列表不显示），届时重新打补丁即可。
+- 已验证：DSH **0.1.5-rc.2**。

package/cordis.patch.yml

@@ -0,0 +1,13 @@
+# This file is loaded automatically when the package is a profile layer
+# (declares dsh.bundle.patch). It inserts the plugin into the web composition.
+- insert:
+    - id: archive-manager
+      name: dsh-long-archive
+      inject:
+        - connection
+        - webServer
+        - agents
+        - sessionPersistence
+        - workspaceRegistry
+        - storageDomain
+        - sessions