在 DeepSeek Harness Web 中,归档会话通常需要两步操作:悬停会话行,点击“…”菜单,再选择“归档”。这种操作流在会话数量较多时较为繁琐。dsh-hover-archive 旨在将这一流程简化为“悬停即显示,点击即归档”。
是什么¶
这是一个纯客户端插件,由 zhifengjiang 维护。它通过在侧边栏会话行的右侧注入归档按钮,复刻了 Codex 的会话管理体验。它直接调用官方的 workspaces.archiveSession API,保证归档行为与内置菜单一致。
核心功能¶
- 悬停显示:鼠标悬停在侧边栏会话行上时,右侧会出现归档图标。
- 一键归档:点击图标即可归档会话,点击事件被捕获,不会打开会话内容。
- 空白行处理:新建会话的空白行(placeholder)不受影响,不会出现按钮。
- 多语言与键盘支持:图标文本随应用语言切换;按钮支持
:focus-within显示,且可用 Enter 或 Space 键触发。 - 状态反馈:归档过程中图标会变暗;失败时图标会闪烁错误颜色并显示提示信息。
- 零依赖:无额外构建步骤,纯 JavaScript 实现。
安装与启用¶
安装命令如下:
dsh plugin --profile web add github:zhifengjiang/dsh-hover-archive
安装后需要重启 dsh web 或刷新页面使插件生效。
典型用法¶
- 在 DSH Web 侧边栏找到目标会话行。
- 鼠标悬停在行上,右侧出现归档图标。
- 点击图标,会话即被归档。
适用场景与注意¶
- 平台限制:仅适用于 DSH Web。如果终端使用的是原生列表替换了侧边栏,可能无法显示。
- 版本兼容:插件基于 DSH 0.1.0-rc.6 构建。如果运行旧版本 Harness 且缺少
workspaces.archiveSession接口,插件会自动检测并禁用自身,避免破坏 UI。 - 共存性:可与
dsh-session-manager、dsh-plugin-session-delete以及内置的“…”菜单共存。 - 运行环境:插件在客户端运行,安装前建议查看源码与许可证(MIT)。
dsh-hover-archive 通过引入悬停即归档的交互,减少了点击次数,提升了侧边栏会话管理的效率。完整源码与文档可参考下方链接。