Skip to main content

dsh-better-archive

7Stars3Forks1Issues0Watchers

DeepSeek Harness (DSH) web-GUI plugin: archived-session panel with unarchive & delete

Evidence3/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
MIT
Branch
main
cordisdeepseek-harnessdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add github:huahai0202/dsh-better-archive

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin huahai0202/dsh-better-archive for me: review the repository at https://github.com/huahai0202/dsh-better-archive first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

为 DeepSeek Harness (DSH) Web GUI 提供完整、可管理的已归档会话视图。

dsh-better-archive 会在 DSH 侧边栏的设置区域新增「已归档」入口。你可以查找和筛选归档会话、恢复会话,或按需永久删除不再需要的归档记录。

界面

深色模式浅色模式
深色模式下的已归档会话页面浅色模式下的已归档会话页面

功能

  • 在 DSH 设置区提供独立的「已归档」页面。
  • 按项目查看归档会话;支持关键词搜索、项目筛选,以及按更新时间或名称排序。
  • 一键取消归档。恢复后会话会立即回到 DSH 的正常会话列表。
  • 支持删除单个会话、某个项目下的全部归档会话,或清空全部归档会话;仍在使用的会话会在重启 DSH 后自动删除。
  • 页面文案跟随 DSH 的语言设置,中英文切换无需刷新页面。

安装

需要 Node.js 22.19+ 和 pnpm。

dsh plugin --profile web add github:huahai0202/dsh-better-archive

安装完成后重启 dsh web。插件会自动加入该 profile 的 dsh.profile.bundles;若未自动加入,请在该数组中添加 "dsh-better-archive",然后重启 DSH Web。

更新

通过上述 GitHub 方式安装的插件可使用以下命令更新:

dsh plugin --profile web update dsh-better-archive

更新完成后重启 dsh web,使正在运行的 Host 和客户端加载新版本。

本地开发

dsh plugin --profile web add link:<path-to-this-checkout>

本地修改后重启 dsh web,以加载最新的插件代码。

提交前可运行以下检查:

node --check lib/index.js
node --check lib/client.js
npm pack --dry-run

删除行为

永久删除只作用于已归档会话,操作前会要求确认。针对 DSH 0.1.0-rc.7 的默认 JSONL 会话存储,插件会删除会话专属目录,并同步移除对应的工作区与归档记账。

DSH 的归档操作只会将会话从常规列表中隐藏,并不等于终止会话。删除行为取决于会话当前是否仍由 DSH 进程持有:

会话状态点击删除后的行为页面状态
冷会话立即永久删除会话目录,并同步移除工作区和归档记录从已归档列表中移除
当前仍存活的会话写入待删除标记,下次 DSH 启动时自动完成物理删除保留在列表中并显示「重启后删除」

在 DSH 重启前点击「取消归档」,会同时撤销待删除标记,不会在下次启动时删除该会话。

批量删除可以同时处理冷会话和仍存活的会话;若中途失败,接口会报告已立即删除和已安排重启后删除的会话,并刷新页面状态。

DSH 的内容寻址附件由 DSH 独立管理,因此不会随会话记录一起删除。

开发接口

路由方法用途
/archived/pendingGET查询标记为重启后删除的会话
/archived/unarchivePOST取消归档一个会话
/archived/deletePOST立即删除或安排重启后删除一个归档会话
/archived/delete-projectPOST删除或安排删除一个项目的全部归档会话
/archived/delete-allPOST删除或安排删除全部归档会话

目录

dsh-better-archive/
├── lib/
│   ├── index.js        # DSH Host 路由与会话操作
│   └── client.js       # 归档页面与侧边栏入口
├── cordis.patch.yml    # Host 挂载配置
├── package.json        # 插件声明
└── assets/             # README 截图

License

MIT

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/huahai0202/dsh-better-archive)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory