uwu9039/dsh-unarchive

Plugin插件 Native原生 ⭐ 3 MIT Sessions & Context会话与上下文

可恢复已归档的插件 DeepSeek Harness 的归档会话回收站:列出、预览并恢复已归档的会话 昨天手滑归档了个会话,花了几百万才捞出来,所以做了这个。

Project Overview项目介绍

dsh-unarchive is a native plugin built exclusively for DeepSeek Harness (DSH), acting as a recycle bin for archived chat sessions. It is published to npm, so the easiest way to install it is to run the DSH CLI command dsh plugin --profile web add dsh-unarchive in your terminal. If you prefer to install a local development build, you can run npm pack to create a tarball, then install it via dsh plugin --profile web add [tarball name]. It targets DSH version 0.1.0-rc.6 with the web profile, and is an independent third-party plugin not affiliated with DeepSeek.

This plugin is designed for DSH users who regularly archive sessions but occasionally need to retrieve old archived chats that would otherwise be inaccessible. After installation, a floating button appears in the bottom right corner of the web interface; clicking it opens an overlay panel that lists all archived sessions grouped by workspace. You can expand any entry to preview the first user message, up to two recent messages, message count, and last activity time, with each preview capped at 200 characters of text content only. Once you select the sessions you want, you can restore them individually or all at once, and the sidebar updates instantly without a page refresh.

The plugin relies on several public DSH APIs, including workspaceRegistry, sessionQuery, and webServer, and uses a fail-open design where missing dependencies only disable corresponding features instead of breaking core archiving. It does not include support for deleting or searching archived sessions, restoring and opening sessions automatically, or working with the DSH headless profile, and it does not display tool parameters or attachments in previews. When you uninstall the plugin, all modified DSH resources are restored automatically, and only a single settings file ~/.dsh/unarchive/settings.json remains on your system. The plugin is released under the open source MIT license.

dsh-unarchive 是专为 DeepSeek Harness (DSH) 开发的原生第三方插件,相当于 DSH 归档会话的回收站。它支持查看按工作区分组的归档会话列表,预览会话内容,将会话恢复到原工作区,还提供默认关闭的归档二次确认开关。可通过 DSH CLI 直接安装,执行 dsh plugin --profile web add dsh-unarchive 即可,也支持本地打包安装,本插件为独立开发,与 DeepSeek 官方无隶属关系。

对于经常需要整理归档会话但偶尔需要找回旧会话的 DSH 用户来说,这个插件解决了 DSH 原生没有找回归档入口的问题。用户点击界面右下角的悬浮按钮即可打开浮层面板,在面板内可以预览每条归档会话的开头、最近消息和统计信息,选中想要恢复的会话即可一键恢复,也可以一次性恢复所有归档会话。恢复后侧边栏会即时更新,无需刷新页面,多标签页也会同步状态。

本插件依赖 DSH 公开的多个 API,包括 workspaceRegistry、sessionQuery、webServer 等,如果依赖缺失会对应功能降级,不会影响原生归档功能,属于 fail-open 设计。它不支持删除清空归档、搜索归档内容,也不兼容 headless 模式,不会展示工具参数和附件。卸载后仅残留设置文件 ~/.dsh/unarchive/settings.json,其余内容会自动清理,采用 MIT 许可开源。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-unarchive

把 uwu9039/dsh-unarchive 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-unarchive

npm version npm downloads license

归档会话回收站 · An archived-session recycle bin for DeepSeek Harness (DSH).

查看已归档会话、预览内容、恢复到原工作区;另有一个默认关闭的归档二次确认开关。

List archived sessions, preview their content, and restore them to their original workspace. An optional archive confirmation (off by default) is included.

独立第三方插件,与 DeepSeek 无隶属关系。Independent third-party plugin, not affiliated with DeepSeek.


功能 / Features

功能 说明
归档列表 右下角悬浮按钮打开浮层面板,按工作区分组、组内按创建时间倒序;空态、总数、中英文界面
内容预览 行内展开会话开头与最近消息:第一条用户消息、最近 1–2 条消息文本、消息/工具统计、最后活动时间;单条 ≤200 字符,只提取 text 块,不展示工具参数与附件
单个恢复 幂等、存在性校验、串行写入;恢复后侧边栏即时回到原工作区原位置(不刷新页面、多标签页同步)
全部恢复 列表 ≥2 条时可用,面板内二次确认,逐个恢复,失败项不整体回滚
归档二次确认 默认关闭;开启后从侧边栏右键归档前弹确认框(Esc / 遮罩 / 取消均可取消);包装 workspaces.archiveSession,fail-open
设置 面板「设置」页签:confirmOnArchive / showButton / previewEnabled;即时生效,持久化到 ~/.dsh/unarchive/settings.json

安装 / Install

已发布到 npm,直接安装:

dsh plugin --profile web add dsh-unarchive

也可以本地打包安装:

npm pack
dsh plugin --profile web add dsh-unarchive-0.1.8.tgz

官方参考:打包与安装插件 (basic/publish)

配置 / Configuration

cordis.yml 的 config: 块(Schemastery 校验,默认值见 schema):

plugins:
  dsh-unarchive:
    config:
      confirmOnArchive: false   # 归档二次确认(默认关)
      showButton: true          # 显示右下角入口
      previewEnabled: true      # 内容预览

兼容性 / Compatibility

  • 目标 DSH 0.1.0-rc.6,profile web。
  • 依赖公开服务:workspaceRegistry(archivedSessionIds 为公开 API;恢复走 enqueueOperation / requireState / setState / sessionKnown,与原生 archiveSession 同一串行化队列)、sessionQuery(列表/标题/预览)、webServer(HTTP API)、客户端 workspaces / locale / timer。
  • 任一依赖缺失即相应功能降级,不阻塞原生归档(fail-open)。
  • 卸载后仅残留设置文件 ~/.dsh/unarchive/settings.json,其余由插件清理还原。

架构 / Architecture

src/index.js   宿主插件:恢复 / 列表 / 预览 / 标题 / 设置 HTTP API(同源 /dsh-unarchive/api/*)
src/client.js  客户端插件:右下角悬浮按钮 + 浮层面板 + 行内预览 + 设置页签
               + 归档二次确认(包装 workspaces.archiveSession)

数据流:

恢复 → registry.enqueueOperation → requireState → sessionKnown 校验 → setState
     → domain 持久化写 → domain/changed → host-apiproxy watcher
     → host/archived-sessions-changed 推送 → 客户端 store → 侧边栏与面板即时刷新

边界 / Out of scope

不做删除/清空归档、不做归档内容搜索、不做"恢复并打开"、不兼容 headless UI、不展示工具参数与附件。

许可 / License

MIT。

← 上一个 Prev DSH-mobile-sync 下一个 Next dsh-balance-display →