前言¶
DeepSeek Harness(DSH)的插件机制允许开发者扩展客户端行为。在管理大量会话时,归档操作通常需要点击 ⋮ 菜单才能找到,操作路径较长。easy-archive 插件将这一功能从菜单中提取,直接平铺在工作区侧边栏的每一行会话上,通过两步确认机制,减少点击次数,避免归档入口被埋没。
是什么¶
这是一个由 bainianlaoyao 维护的 DSH Web 插件。
* 定位:DSH Web 插件
* 维护者:bainianlaoyao
* 许可证:MIT
* 核心价值:点一次变红确认,再点即归档;归档不再藏在 ⋮ 菜单里。
核心功能¶
-
行内两击归档
- 在每一行会话右侧(
⋮菜单旁)悬停时,会出现一个归档图标。 - 点击一次:图标变为红色的“确认归档 / Confirm archive”药丸状按钮。
- 点击两次:会话被归档。
- 在每一行会话右侧(
-
菜单集成
- 归档项会在
⋮菜单打开时自动隐藏(重命名 / 分叉功能保持原位)。
- 归档项会在
-
无槽位抢占
- 插件没有接管侧边栏渲染槽位,原生的工作区浏览器渲染逻辑保持不变。
- 重命名、分叉、搜索、拖拽排序等功能不受影响。
-
行为一致性
- 归档逻辑通过
ctx.workspaces.archiveSession调用,与内置菜单使用相同的底层接口。 - 因此,权限验证和行为表现与原生菜单完全一致。
- 归档逻辑通过
-
安全机制
- 自动解除:红色的确认状态会在 4 秒后自动解除,或在鼠标移出、点击其他区域时解除。
- 防误触:如果会话的显示标题和时间桶发生冲突(即身份模糊),该行不会显示归档按钮,以防止误删。
-
技术实现
- 支持多语言(zh / en)。
- 无需构建步骤。
- 无 React 依赖。
安装与启用¶
推荐通过 DSH 插件市场安装:
dsh plugin --profile web add github:bainianlaoyao/easy-archive
也可以使用 NPM 预构建版本:
dsh plugin --profile web add dsh-easy-archive
如果需要手动配置,在 package.json 中添加依赖和 bundles 条目:
{
"dependencies": { "dsh-easy-archive": "github:bainianlaoyao/easy-archive" },
"dsh": { "profile": { "bundles": [ "dsh-easy-archive" ] } }
}
随后在项目目录执行 pnpm install 并重启 dsh web。
典型用法¶
- 悬停:将鼠标悬停在任意会话行上,图标出现在
⋮按钮之前。 - 确认:点击一次,图标变为红色的“确认归档”状态。
- 归档:再次点击,会话被移除。
- 验证:打开
⋮菜单,你会发现刚才归档的条目已经消失,不再占用菜单空间。
适用场景与注意¶
- 适用对象:希望减少点击次数、习惯使用行内操作来管理大量会话的开发者。
- 排除项:空白“新建会话”行和搜索结果行不会显示按钮。
- 身份校验:系统会自动跳过标题和时间桶冲突的会话,避免误删。
- 卸载方法:删除
package.json中的依赖和 bundles 条目,运行pnpm install,然后重启dsh web。
总结¶
easy-archive 通过极简的两步确认机制,解决了归档入口过深的问题,同时保留了原生菜单的完整性。它适合作为 DSH 侧边栏管理的辅助工具。