Skip to content

dsh-session-navigator

Verified

dsh-session-navigator · v1.1.0 · MIT · Web UI

会话资源管理器 (Session Navigator) for DeepSeek Harness: virtual folders, tags, notes, trash and multi-workspace session browsing on top of the native DSH session store.

Install

dsh plugin add dsh-session-navigator

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

会话资源管理器 · dsh-session-navigator

中文 | English

npm npm downloads GitHub stars license listed on dsh-plugin.org

会话资源管理器

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

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

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

  • 目录树按工作区自动生成,自己可以新建文件夹无限嵌套,会话工作区支持拖进拖出
  • 所有会话 按工作区切成一段一段,标题就是工作区名字;点标题收起整段,折叠状态跟着布局记忆一起保存
  • 侧车投影按「文件大小 + 修改时间」复用,没变的会话不再重读:本地实测列表读取 141ms → 2ms、面板重开 129ms → 4ms
  • 标题、标签、备注随心所欲的自定义
  • 搜索支持标题、备注、标签,并可勾选「会话内容」检索对话正文(用户说的与助手回复的,不含工具输出);搜索框右侧的漏斗打开「搜索范围」弹窗,位置可选「所有位置」(缺省)或「当前目录」,还能一键跳到搜索索引设置
  • 收藏、待办、置顶、归档;配备回收站,删除后有后悔药
  • 跨工作区剪切粘贴;会话可自由导出 Markdown 或 JSONL:用户的话、助手的回复、每次工具调用与输出都在里面,压缩过的历史也按原文保留

界面介绍

浮窗模式

筛选

设置界面

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

独立窗口全屏

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

DSH 聊天在左,会话资源管理器停靠在右,两边各自独立

分屏模式

安装

快速开始(推荐)

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

DSH 的「添加插件」对话框,输入 dsh-session-navigator 后点安装

命令行安装

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。

功能

目录 操作
给会话分组 工作区里新建文件夹,拖到文件夹内
改名字 点击编辑按钮或在右侧详情页编辑
加标签 / 写备注 右侧详情栏;标签可以预制
搜索查找 搜索框搜标题、备注、标签;点搜索框右侧的漏斗打开「搜索范围」弹窗:位置选所有位置(缺省,整库)或当前目录,字段勾会话名 / 标签 / 备注 / 会话内容(会话内容=用户说的与助手回复的文字,不含工具输出,走正文索引,第一次会建一会儿);弹窗里还能跳到搜索索引设置;「筛选」按收藏、归档、待办、标签
收藏 / 待办 选中后收藏 / 加入待办;两个页面里指向文件夹或工作区的条目就是那个容器,双击回到原位置(双击要两次按下都在 400ms 内,慢拍的两下只算两次单击)
快捷方式 右键「在本目录生成快捷方式」,把会话或目录放进当前容器;删掉只去掉这条引用
置顶 文件夹和工作区可以置顶到本来的位置最前面,同步到 DSH 自己置顶的会话;树里带图钉标记
快速访问 把文件夹 / 工作区拖到「快速访问」带,作为第二个入口;带里的行就是那个文件夹,拖东西进去=放进它
多选 勾选多行后右键,一次收藏 / 待办 / 置顶 / 归档 / 快速访问 / 复制 / 删除;也可以在列表空白处(或任何没选中的行上)按住鼠标拖出一个框,框住的行一起勾上,点一下空白处取消勾选。拖动只搬已经选中 / 勾选的行,没选中的行一拖就是框选;勾了几行就整批搬走(会话与文件夹可以混着勾,落到哪里就取那里收得下的那一半)
归档 默认在列表底部;设置里可以关掉显示
删除 整个会话目录移进回收站,可还原、可清空
换工作区 跨工作区剪切 / 粘贴,标签备注跟着走
会话导出 详情栏和右键菜单,导出为 Markdown 或 JSONL:用户的话、助手的回复、每次工具调用与输出,压缩过的历史按原文保留
AI 字段 让模型给会话写标题、描述、标签:详情栏「AI 字段」段一键生成,右键菜单可以一次勾多个会话批量生成,设置里还能一键补齐所有缺描述或标签的会话。三段各自合并:点「用这个标题」才改名,点「并入我的备注」把描述接在你写的备注后面,标签是勾选式——只并你留下的那几个,点完立刻刷新列表和详情。标签优先复用你的标签库,库里没有合适的才新造一个,并进去的新标签也会进库。每条记录底下写着这一次花了多少 token,累计花费记在设置页(这一项要用的模型服务来自 DSH 的 llm 服务,profile 里没配模型时这一组会灰掉并说明原因)

配置

设置界面

设置项 默认值 说明
打开方式 浮窗 浮窗 / 独立弹窗。独立弹窗需要额外下载浏览器组件,仅支持 Windows
会话标题栏按钮样式 自动 也能固定只显示图标
自动折叠 关 进入一个文件夹后,收起它的同级目录
显示已归档 开 关掉后归档会话不再列在底部
过滤空会话 开 没开始过任何一轮的会话不列出来
折叠子智能体 开 可点箭头展开
日期格式 详细日期 或距今时间
大小单位 自动转换 在 B / KB / MB / GB 切换;也能固定 KB
搜索索引缓存 恒开 建好的会话内容索引落盘(content-index.v1.json),重启后不必重读日志。没有开关:它是派生文件,删掉只花一次重建
空闲时自动建立索引 关 打开后,启动完在后台一点点把索引建起来,不挡任何请求
重建 / 删除索引 — 两枚按钮:从头重建(答案逐步变全)或删掉缓存文件(省一百多 MB);搜索范围弹窗里也能一键跳到这一组
AI 字段的模型 宿主默认 从 DSH 的模型目录里(下拉框)选模型,再选推理强度;强度是适配器自己定义的词(比如 low / high),换模型时会清空,因为上一个模型的词在新模型上未必存在
生成哪几项 标题、描述、标签全开 要模型写哪几个字段。只影响产出,不影响输入:对话正文总是送,思考过程与工具输出从不送
一键补齐缺的字段 — 把缺描述或标签的会话排进队列(只看这两项,手改过名字不算写完),进度显示在设置页与面板底部,随时可以停
数据目录 ~/.dsh-session-navigator 迁移用,可在设置里改

文档

开发与测试

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

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

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

issue

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

许可证

MIT,见 LICENSE。