在使用 DeepSeek Harness (DSH) 进行智能体开发时,随着会话数量增加,在长列表中快速定位特定会话需要频繁滚动或搜索,效率较低。dsh-plugin-pin-session 插件通过在侧边栏顶部提供固定分组区域,解决了这一问题。
插件介绍¶
这是一个由 NattoCB 维护的 DSH Web 插件。它采用零核心修改的方式,在侧边栏会话列表上方添加「Pinned Sessions」分组,并在每行会话的菜单中集成 Pin/Unpin 操作,实现会话的快速固定与管理。
核心功能¶
- 行内固定操作:在会话行的菜单中直接提供 Pin/Unpin 选项,状态实时反映。
- 分组显示:固定后的会话显示在侧边栏列表上方的可折叠分组中。
- 主机端存储:固定顺序存储在主机文件系统(
$DSH_HOME/storages/pin-session.),跨浏览器持久化。 - 零侵入:不修改 DSH 核心代码,仅通过注入客户端包实现功能扩展。
安装与启用¶
使用 DSH 官方插件命令安装:
dsh plugin --profile web add github:NattoCB/dsh-plugin-pin-session
安装完成后,必须重启 DSH 进程以加载新的客户端包。
典型用法¶
- 固定会话:鼠标悬停在目标会话行,点击菜单,选择带有图标的 Pin 选项。
- 查看效果:该会话会立即出现在侧边栏列表上方的「Pinned Sessions」区域,菜单项变为 Unpin。
- 交互:点击固定行可直接打开会话;点击 Unpin 即可移除。
- API 调用:支持通过 HTTP API 进行操作:
GET /pin-session/pinsPOST /pin-session/pin {id, title?}POST /pin-session/unpin {id}
注意事项¶
- 重启要求:安装新客户端包必须重启 DSH,否则无法生效。
- 数据持久化:固定列表由主机端文件管理,非浏览器本地存储,因此跨浏览器环境数据一致。
- 安全检查:在安装前建议检查源码与许可证(MIT)。
总结¶
该插件通过轻量级的方式优化了 DSH 的会话管理体验。适合需要频繁切换特定会话的开发者。更多详情可参考:GitHub | 技能树目录