
dream12347/dsh-session-manager
dsh-session-manager
dsh-session-manager is a community DeepSeek Harness plugin. Read the repository README before installing.
Install
npx @deepseek-ai/dsh plugin --profile web add https://github.com/tasselx/dsh-session-manager/releases/latest/download/dsh-session-manager.tgzRestart `dsh web` after install. Bundle APIs can change during the developer preview.
README badge
[](https://dshhub.dev/plugins/dsh-session-manager)Paste this into your README. The star count updates with every catalog sync.
From the README
Excerpt from dream12347/dsh-session-manager, cleaned of badges and images.
dsh-session-manager
English | 中文
这可能是目前功能最全的 DSH 会话管理插件:在 DeepSeek Harness Web 界面中全面管理会话,设置页与对话顶部均提供入口——删除(回收站可恢复或彻底清除)、恢复已归档会话、近期活动统计、继续/暂停会话、打开日志目录、未读/已读标记、新聊天中继续(fork)、工作区分组与排序管理、上下文压缩阈值设置,不修改 DSH 核心代码。
<sub><span style="opacity:.6">本项目由 dsh + Deepseek-V4-Flash0731 独立完成</span></sub>
<sub><span style="opacity:.6">如果觉得有用,欢迎点个 ⭐ Star,谢谢支持!</span></sub>
功能
- 设置页新增独立的「会话管理」分栏(与 Notifications 同级的设置分区)
- 面板列出全部会话(标题 / 工作目录),底部折叠区单独展示已归档会话,支持一键恢复回到会话列表
- 回收站:删除的会话移入回收站(保留最近 10 条,超出自动清除最早一条),可恢复或彻底删除
- 统计:每个会话可在居中弹窗中查看完整近期活动统计(轮次 / 用户消息 / 助手消息 / 全部工具调用 / 活动窗口)
- 继续会话:一键打开会话并关闭面板;暂停:停止正在运行会话的当前回合
- 未读 / 已读:会话行标题旁显示状态点——手动未读为蓝色、官方等待输入为琥珀、官方完成提醒为绿色、运行中为转圈;点击官方状态点就地已读(不跳转),点击蓝色点清除未读,打开会话自动已读;官方侧边栏的对应会话行旁同步显示蓝色未读点
- 新聊天中继续:每个会话一键 fork 子会话(官方
sessions.fork)并打开 - 文件夹:在系统文件管理器中打开会话日志目录
- 删除本对话:对话顶部右侧红色按钮,一键删除当前对话(Session log 左侧)
- 对话管理 / 回收站:对话顶部入口,打开自绘右侧抽屉(图钉固定常驻、点击外部自动收起),行内「更多」悬浮菜单收纳统计 / 文件夹 / 新聊天中继续
- 工作区管理:会话按工作区分组展示,组内按最后使用时间排序(可切换最新/最旧);拖拽工作区标题即可调整顺序(插入 / 交换 / 拖到末尾);悬停标题出现置于顶部 / 重命名 / 删除按钮(删除按官方定义:仅移出列表,文件夹与会话记录保留,会话归入「未分组」)
- 上下文压缩阈值(通用设置):设置对话上下文用到模型窗口(100 万 token)的多少比例时自动压缩(17%–90%),每次压缩保留最近 16% 原文;对所有 Agent 预设的会话统一生效(保存即时 + 持久化 + 重启自动应用)
- 删除限制:仅禁止删除「正在思考」的会话;当前打开的会话(空闲)可删除
- 子代理(subagent)会话支持删除(非运行中):即使主会话已删除、子代理成为「孤儿」,也能在会话管理中直接清理
- 中英文界面自适应(跟随页面语言)
安装
从 Release(推荐,适配 DSH 0.2.0)
dsh plugin --profile web add https://github.com/tasselx/dsh-session-manager/releases/latest/download/dsh-session-manager.tgz
也可以先下载 dsh-session-manager.tgz 再本地安装:
dsh plugin --profile web add /absolute/path/to/dsh-session-manager.tgz
如果安装了 dshmarket,请确认
~/.dsh/profiles/<profile>/.dsh-market/state.json的disabled数组里没有dsh-session-manager,否则插件会在启动时被重放禁用。
从 GitHub
dsh plugin --profile web add 'github:dream12347/dsh-session-manager#v0.2.2'
# CMD
dsh plugin --profile web add github:dream12347/dsh-session-manager#v0.2.2
从本地目录
dsh plugin --profile web add /absolute/path/to/dsh-session-manager
从 tarball
pnpm pack
dsh plugin --profile web add /absolute/path/to/dsh-session-manager-0.2.2.tgz
安装完成后重启 dsh web(host 插件与客户端 bundle 需要重启加载)。
截图
设置页「会话管理」分栏(工作区分组、行操作与回收站):
对话顶部快捷入口(对话管理 / 回收站 / 删除本对话):
会话管理抽屉(工作区分组、图钉固定、点击外部收起):
通用设置「上下文压缩阈值」(17%–90%,滑块刻度):
使用
设置页会话管理
- 打开侧边栏底部 设置(齿轮图标)
- 设置页面左侧导航出现独立的 会话管理 分栏,点击进入
- 主列表为未归档会话;底部「已归档会话」折叠区可展开查看、恢复或删除归档会话
- 删除会话 → 进入底部「回收站」折叠区(保留最近 10 条)
- 回收站内可 恢复(回到会话列表)或 彻底删除(永久清除,不可恢复)
- 每行操作:继续会话(打开并进入对话)、暂停(停止正在运行的回合)、统计(展开近期活动)、文件夹(打开日志目录)、删除
- 工作区标题右侧(悬停显示):置于顶部(挪到最前)、重命名、删除(红色,二次确认)
- 拖拽工作区标题可调整顺序:放到某个工作区上方/下方插入,放到标题上交换位置,拖到最下方即移到末尾
- 排序按钮(最新在前 / 最旧在前)切换组内会话的排列顺序
通用设置:上下文压缩阈值
- 打开 设置 → 通用设置(General)
- 找到「上下文压缩阈值」:滑块 / 输入框设置 17%–90%
- 保存后立即生效(含已打开的会话);配置对所有 Agent 预设统一生效,重启后依然有效
对话顶部快捷入口
任意对话页右上角(Session log 左侧):
- 对话管理:打开会话管理抽屉(完整列表 + 已归档 + 回收站),图钉可固定常驻,点击外部自动收起
- 回收站:打开抽屉并直接展开回收站
- 删除本对话(红色):确认后删除当前对话(移入回收站)
未读 / 已读状态点
会话行标题旁的圆点表示四种状态:蓝色=手动标记未读、琥珀=官方等待输入、绿色=官方完成提醒、转圈=运行中。点击琥珀 / 绿色点就地标记已读(不跳转,仅清除官方提醒);点击蓝色点清除未读;点击空白位置标记未读;打开会话自动已读。官方侧边栏的会话行旁同步显示蓝色未读点(按标题文本匹配,重复标题会话会共享该点)。
工作原理
…

