dsh-session-navigator

中文 | English

会话资源管理器

像 Windows 资源管理器那样管理 DSH 的会话，让会话管理像文件管理那样简单。

不改变会话文件的物理位置，在 ~/.dsh-session-navigator/ 记一份索引——记录文件夹、名称、标签、备注。

适用：多会话用户：得心应手的对您的会话和工作区分类，移动，删除，备注，重命名，也可以待办，收藏，置顶您的会话，让会话管理像文件管理那样简单。

• 目录树按工作区自动生成，自己可以新建文件夹无限嵌套，会话工作区支持拖进拖出
• 标题、标签、备注随心所欲的自定义
• 搜索支持标题、备注、标签搜索
• 收藏、待办、置顶、归档；配备回收站，删除后有后悔药
• 跨工作区剪切粘贴；会话内容可自由导出 Markdown 或 JSONL，供其他会话使用

界面介绍

浮窗模式太小，不方便，不过瘾？别急，我们还有独立弹窗——真正像资源管理器那样

当然，也可以进行分屏/多屏协作

分屏模式

安装

快速开始（推荐）

DSH 的插件页 → 「添加插件」→ 输入包名 dsh-session-navigator → 安装 → 重启 DSH。

命令行安装

Web:

dsh plugin --profile web add dsh-session-navigator

Desktop:

dsh plugin --profile desktop add dsh-session-navigator

从 Github 源码安装

Web

dsh plugin --profile web add github:Anlerway/dsh-session-navigator

Desktop

dsh plugin --profile desktop add github:Anlerway/dsh-session-navigator

从本地安装

下载资源：最新版本安装包

dsh plugin --profile web add '<实际路径>'

更新

Web

dsh plugin --profile web add dsh-session-navigator@latest

Desktop

dsh plugin --profile desktop add dsh-session-navigator@latest

卸载

Web

dsh plugin --profile web remove dsh-session-navigator

Desktop

dsh plugin --profile desktop remove dsh-session-navigator

插件自己的数据不会跟着删，如果要清理干净，需要删掉 ~/.dsh-session-navigator/

需要 Node.js ^22.15.0 || >=24.0.0。

功能

目录	操作
给会话分组	工作区里新建文件夹，拖到文件夹内
改名字	点击编辑按钮或在右侧详情页编辑
加标签 / 写备注	右侧详情栏；标签可以预制
搜索查找	搜索框搜标题、备注、标签；「筛选」按收藏、归档、待办、标签
收藏 / 待办	选中后进行收藏，取消收藏操作
置顶	文件夹和工作区可以置顶到列表顶上，同步到DSH 自己置顶的会话
归档	默认在列表底部；设置里可以关掉显示
删除	整个会话目录移进回收站，可还原、可清空
换工作区	跨工作区剪切 / 粘贴，标签备注跟着走
会话导出	详情栏和右键菜单，导出为Markdown 或 JSONL

配置

设置项	默认值	说明
打开方式	浮窗	浮窗 / 独立弹窗。独立弹窗需要额外下载浏览器组件，仅支持 Windows
会话标题栏按钮样式	自动	也能固定只显示图标
自动折叠	关	进入一个文件夹后，收起它的同级目录
显示已归档	开	关掉后归档会话不再列在底部
过滤空会话	开	没开始过任何一轮的会话不列出来
折叠子智能体	开	可点箭头展开
日期格式	详细日期	或距今时间
大小单位	自动转换	在 B / KB / MB / GB 切换；也能固定 KB
数据目录	~/.dsh-session-navigator	迁移用，可在设置里改

文档

• 架构 · HTTP 接口 · 数据目录
• 树的规则 · 独立窗口组件 · 主题与桥接
• 测试 · 文档索引

开发与测试

零运行时依赖，lib/ 直接跟着仓库走，没有构建步骤。

node --test "test/*.test.mjs"   # 380 个用例
node test/render-smoke.mjs      # 渲染冒烟

CI 只跑 Windows（windows-latest，Node 22 和 24），因为发布目标是 DSH 桌面版，独立窗口的资产名是 win32 的。macOS 和 Linux 没测。

issue

如果您需要macOS和Linux下的适配，或遇到一些使用bug，或你需要新增的功能，请在issue提出

许可证

MIT，见 LICENSE。