LianbinZhou/dsh-archive-manager

Name: LianbinZhou/dsh-archive-manager
Author: LianbinZhou

插件Plugin 原生Native ⭐ 2 MIT cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh

DSH 网络图形界面存档管理器：列出已存档会话并一键恢复（含错误修复）

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-archive-manager 是 DSH Web GUI 的历史归档管理插件，在侧边栏新增「历史归档」入口，列出已归档会话并显示真实标题，支持一键恢复回工作区；面板打开时自动刷新并每 3 秒轮询，归档与恢复无需刷新页面。适用于使用官方归档后缺少 unarchive 入口、需要找回会话的场景。注意：需通过 bundle 或 pnpm 安装并重启 dsh web，修改客户端源码后要重新构建。

dsh-archive-manager is a DSH Web GUI plugin for managing archived sessions. It adds a “History Archive” sidebar entry that lists archived sessions with real titles and provides a one-click restore button to return them to the workspace. The panel refreshes on open and polls every 3 seconds, so archiving or restoring works without a page reload. Use it when DSH’s official archive feature hides sessions with no unarchive UI. Caveat: install via bundle or pnpm, restart dsh web, and rebuild after client changes.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-archive-manager】【https://github.com/LianbinZhou/dsh-archive-manager】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:LianbinZhou/dsh-archive-manager

把 LianbinZhou/dsh-archive-manager 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.1 KB · 缓存于 2026-08-27 05:41:52 · 3.1 KB

dsh-archive-manager

DSH Web GUI 的「历史归档」管理插件：侧边栏新增「历史归档」入口，列出已归档的会话并支持一键恢复回工作区。

侧边栏「历史归档」入口（跟随 DSH 侧边栏样式）
面板列出所有归档会话（显示真实会话标题）
每条记录一个「恢复」按钮，一键取消归档、回到工作区列表
面板打开时自动刷新 + 打开状态下每 3 秒轮询，归档/恢复无需刷新页面

背景

DSH 官方提供「归档会话」（workspace.archiveSession），但没有恢复（unarchive）入口——归档后的会话会从工作区列表隐藏，官方没有任何界面能把它放回来。本插件补上这个缺口：

宿主端注册 /api/archive-manager/list 与 /api/archive-manager/unarchive
客户端注入侧边栏入口 + 面板

安装

方式一：bundle 激活（本仓库自带脚本）

把整个仓库复制到 ~/.dsh/profiles/web/node_modules/dsh-archive-manager/
运行 node activate.mjs（把 dsh-archive-manager 加入 profile 的 dsh.profile.bundles）
重启 dsh web

方式二：dsh plugin（pnpm）

cd ~/.dsh/profiles/web
pnpm add dsh-archive-manager  # 需要包已发布到 npm 或指向 git 仓库
dsh plugin --profile web ...

构建（修改客户端源码后）

node build-client.mjs   # src/client/client.js → lib/client.js（__ModuleLoader__ 包装）

验证：node host-test.mjs、node loader-test.mjs、node _precheck.mjs

修复记录

本仓库基于本地安装的 dsh-archive-manager v0.1.0 维护，修复了以下问题（lib/ 与 src/ 已同步）：

#	问题	修复
1	`/api/archive-manager/list` 返回 500 `domain 'workspace' is already open`——重复打开官方已占用的存储域	`_domain()` 先 `storageDomain.get("workspace")` 复用已打开的域，取不到才 `open`
2	点「恢复」后会话不立即回到工作区列表，必须刷新页面	`unarchive` 改走 `registry.setState`，同步 registry 内存态，触发 `host/archived-sessions-changed`
3	归档列表只显示「会话+随机后缀」，看不到真实标题	`list` 接口通过 `sessionPersistence.inspect` 读取会话日志中的 `session/title` 事件，返回 `items: [{sessionId, title}]`；客户端优先渲染真实标题
4	归档后历史归档面板不立即显示新记录（要刷新页面）	面板每次打开时重新拉取 `list`
5	面板保持打开时归档/恢复不刷新	面板打开状态下每 3 秒轮询（DOM 移除后自动停止）

反馈与贡献

欢迎提 issue 或 PR：

发现 bug（包括上面的修复是否有副作用）、想要新功能，直接开 issue
本仓库已包含完整修复；如果插件原作者发布了新版本，欢迎把本仓库的修复合并过去
安装/使用问题也可以在 issue 里提问

许可

MIT。上游为本地安装的 dsh-archive-manager v0.1.0（MIT），原作者未在包内署名；本仓库为修复维护版。

渲染基于仓库 LianbinZhou/dsh-archive-manager 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install