前言¶
DSH 的会话保存在本地目录，文件名就是会话标题。会话多了之后，按标题查找、按工作区分类都变得困难。DSH 官方没有提供可视化的会话管理界面，需要自己在文件系统里维护会话列表，再通过 DSH 的命令或快捷键打开。
下面介绍的 dsh-session-navigator 是一个客户端插件，在 DSH 的原有会话存储之上，提供一个类似 Windows 资源管理器的界面。它不移动或修改原有的会话文件，而是在 ~/.dsh-session-navigator/ 中维护一份索引，记录文件夹、名称、标签、备注等信息。
安装与启用¶
DSH 插件页 →「添加插件」→ 输入包名 dsh-session-navigator → 安装 → 重启 DSH。
如果需要从命令行安装，Web 端使用：
dsh plugin --profile web add dsh-session-navigator
Desktop 端使用：
dsh plugin --profile desktop add dsh-session-navigator
从 GitHub 源码安装：
dsh plugin --profile web add github:Anlerway/dsh-session-navigator
dsh plugin --profile desktop add github:Anlerway/dsh-session-navigator
需要 Node.js ^22.15.0 || >=24.0.0。
核心功能¶
工作区与目录树¶
插件会在 ~/.dsh-session-navigator/ 中创建索引目录，目录树按工作区自动生成，支持无限嵌套。用户可以在工作区中新建文件夹，并将会话拖入文件夹。
标签与备注¶
会话的标题、标签、备注可以自定义。标签可以预制。编辑方式包括点击编辑按钮或在右侧详情页编辑。
搜索与筛选¶
搜索框支持按标题、备注、标签进行搜索。筛选功能支持按收藏、归档、待办、标签进行过滤。
会话管理¶
- 收藏 / 取消收藏：选中会话后进行收藏操作
- 待办：支持标记会话为待办
- 置顶：文件夹和工作区可以置顶到列表顶部，同步到 DSH 自己置顶的会话
- 归档：归档会话默认在列表底部，可在设置中关闭显示
- 删除：会话会移入回收站，支持还原和清空
跨工作区操作¶
支持跨工作区剪切和粘贴会话，标签和备注会跟随移动。
会话导出¶
会话内容可以导出为 Markdown 或 JSONL 格式，供其他会话使用。
配置项¶
插件提供以下设置项：
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 打开方式 | 浮窗 | 浮窗 / 独立弹窗。独立弹窗需要额外下载浏览器组件，仅支持 Windows |
| 会话标题栏按钮样式 | 自动 | 也能固定只显示图标 |
| 自动折叠 | 关 | 进入一个文件夹后，收起它的同级目录 |
| 显示已归档 | 开 | 关掉后归档会话不再列在底部 |
| 过滤空会话 | 开 | 没开始过任何一轮的会话不列出来 |
| 折叠子智能体 | 开 | 可点箭头展开 |
| 日期格式 | 详细日期 | 或距今时间 |
| 大小单位 | 自动转换 | 在 B / KB / MB / GB 切换；也能固定 KB |
| 数据目录 | ~/.dsh-session-navigator |
迁移用，可在设置里改 |
界面模式¶
插件提供三种界面模式：
- 浮窗模式
- 独立弹窗：需要额外下载浏览器组件，仅支持 Windows
- 分屏模式：DSH 聊天在左，会话资源管理器停靠在右，两边各自独立
注意事项¶
插件以当前 DSH 进程的权限运行。安装前应检查源码与许可证。
目前插件仅在 Windows 平台经过测试（CI 使用 windows-latest，Node 22 和 24），macOS 和 Linux 未测。如有问题或需要新增功能，请在 GitHub 提交 issue。
结尾¶
dsh-session-navigator 让 DSH 的会话管理像文件管理那样简单，同时保持原有会话文件的物理位置不变。插件数据存储在 ~/.dsh-session-navigator/，卸载时不会自动删除，如需清理需手动删除该目录。
插件目录页：https://www.skillhub.cn/plugins/Anlerway/dsh-session-navigator
GitHub 仓库：https://github.com/Anlerway/dsh-session-navigator
