dsh-plugin-workspace-archive:一键归档整个工作区

前言

用 DeepSeek Harness(DSH)做开发,工作区会越开越多:临时验证用的、跑一半放弃的、已经交付但不想删的。官方只提供单条会话的「归档会话」,多个会话分布在一个工作区里时,只能逐条操作;想从侧边栏整体清掉,往往要挨个点。这个插件解决的就是「一批会话一起归档、一起恢复」这件事。

下面介绍 chineseryan/dsh-plugin-workspace-archive 插件。它由 ChineseRyan 维护,接收 DSH 插件,在工作区行的「…」菜单里加一个「归档工作区」入口,把该工作区下全部会话归档并从侧边栏隐藏,需要时可从侧边栏底部恢复。

核心功能

一次操作范围是整个工作区,不是单条会话:

  • 归档:对工作区下全部会话逐个调用官方归档命令,全部成功后写入归档账本,并从侧边栏隐藏该工作区行。
  • 恢复:按账本里的会话清单逐个还原,全部成功才删除记录。
  • 侧边栏底部提供「已归档工作区」面板,带数量角标,可查看与恢复。
  • 角标显示方式三档:常驻显示、首次显示、永不显示,在面板标题右侧的三枚图标切换。
  • 归档不会删除文件、会话或历史记录,正在运行的会话无法归档,菜单会提示先停止。
  • 只写本地一个位置的数据:$DSH_HOME/storages/dsh-workspace-archive.json;写入采用原子 rename 加跨进程文件锁,多窗口并发不丢记录;不联网,不读取会话内容,只记录 ID 名单。

里程碑行为差异(README 明确记载):

  • 0.1.5 起,空工作区归档后同样从工作区列表消失,只在「已归档工作区」面板出现;0.1.4 及以前这类工作区会两处同时显示(已修复的 bug)。
  • 0.1.6 起,角标偏好保存在宿主状态文件,重启 dsh 不会回到默认的「常驻显示」。

安装与启用

安装命令取自插件 README,按自己的 profile 替换 <profile> 和用户名:

从 GitHub 安装:

dsh plugin --profile <profile> add "git+https://github.com/<你的用户名>/dsh-plugin-workspace-archive.git"

本地开发安装:

git clone https://github.com/<你的用户名>/dsh-plugin-workspace-archive.git
dsh plugin --profile <profile> add "link:/path/to/dsh-plugin-workspace-archive"

安装后需要重启一次 dsh 宿主,宿主侧 JS 不做热重载;浏览器半侧刷新页面即可。如果 profile 由桌面应用独占管理,在「设置 → 插件」中安装,或使用桌面版自带的 CLI。

卸载:

dsh plugin --profile <profile> remove dsh-plugin-workspace-archive

依赖项:无运行时第三方依赖;要求 dsh 0.2.1-rc.2 及以上。

典型用法

1、归档某个工作区:在侧边栏找到该工作区行,点右侧「…」,选「归档工作区」。插件会先逐个归档其下所有会话,全部成功后,工作区行从侧边栏消失。

2、查看已归档工作区:点侧边栏底部「已归档工作区」面板,右侧显示带数量角标的总览。该面板可直接按 Esc 或底栏「关闭」关闭。

3、恢复:在面板中选择要恢复的工作区并点「恢复」,插件按账本名单逐个还原,全部成功才删掉这条记录;恢复最后一条后面板自动关闭。

归档过程中的插件行为(README 原文):只对工作区行通过 DOM 加隐藏标记,不读写、不改写官方任何视图数据。查看中的会话在切换焦点后才随工作区一同隐藏。

适用场景与注意

适合侧边栏工作区数量堆积、希望按工作区整体归档的 DSH 使用者。它对单条会话没有更细的操作,只需要归档某条会话时用官方自带的「归档会话」即可。

使用前按惯例检查源码与许可证(MIT)是否满足需求。插件以当前 dsh 进程的权限运行,角标偏好、归档账本都写在 $DSH_HOME 下的状态文件里,删除该文件即放弃恢复入口(已归档会话仍在官方归档里,可从官方入口恢复)。安装后记得重启宿主,否则入口不会生效。

小结

这个插件的定位很窄:把官方已有的「归档会话」能力按工作区批量执行,再用账本记录名单实现一键恢复,不改动历史数据,也不引入额外运行时依赖。如果你的痛点正是侧边栏工作区太多,值得装上一试。

  • 目录页:https://www.skillhub.cn/plugins/ChineseRyan/dsh-plugin-workspace-archive
  • GitHub:https://github.com/ChineseRyan/dsh-plugin-workspace-archive
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜