dsh-session-manager

English | 中文

这可能是目前功能最全的 DSH 会话管理插件：在 DeepSeek Harness Web 界面中全面管理会话，设置页与对话顶部均提供入口——删除（回收站可恢复或彻底清除）、恢复已归档会话、近期活动统计、继续/暂停会话、打开日志目录、未读/已读标记、新聊天中继续（fork）、工作区分组与排序管理、把会话移动到其他工作区、上下文压缩阈值设置，不修改 DSH 核心代码。

功能

• 设置页新增独立的「会话管理」分栏（与 Notifications 同级的设置分区）
• 面板列出全部会话（标题 / 工作目录），底部折叠区单独展示已归档会话，支持一键恢复回到会话列表
• 回收站：删除的会话移入回收站（保留最近 10 条，超出自动清除最早一条），可恢复或彻底删除
• 统计：每个会话可在居中弹窗中查看完整近期活动统计（轮次 / 用户消息 / 助手消息 / 全部工具调用 / 活动窗口）
• 继续会话：一键打开会话并关闭面板；暂停：停止正在运行会话的当前回合
• 未读 / 已读：会话行标题旁显示状态点——手动未读为蓝色、官方等待输入为琥珀、官方完成提醒为绿色、运行中为转圈；点击官方状态点就地已读（不跳转），点击蓝色点清除未读，打开会话自动已读；官方侧边栏的对应会话行旁同步显示蓝色未读点
• 新聊天中继续：每个会话一键 fork 子会话（官方 sessions.fork）并打开
• 文件夹：在系统文件管理器中打开会话日志目录
• 删除本对话：对话顶部右侧红色按钮，一键删除当前对话（Session log 左侧）
• 对话管理 / 回收站：对话顶部入口，打开自绘右侧抽屉（图钉固定常驻、点击外部自动收起），行内「更多」悬浮菜单收纳统计 / 文件夹 / 新聊天中继续 / 移动到…；设置页会话管理同样把操作收进「更多」，行内仅保留删除
• 工作区管理：会话按工作区分组展示，组内按最后使用时间排序（可切换最新/最旧）；拖拽工作区标题即可调整顺序（插入 / 交换 / 拖到末尾）；悬停标题出现置于顶部 / 重命名 / 删除按钮（删除按官方定义：仅移出列表，文件夹与会话记录保留，会话归入「未分组」）
• 移动到工作区：把任意非运行会话（连同其日志文件夹、会话头工作目录与工作区记账）移动到另一个已注册工作区，移动后立即在目标工作区分组出现，重启不丢
• 搜索与筛选：面板顶部搜索框按标题 / 工作目录实时过滤，配合「全部 / 运行中 / 未读 / 已归档」状态筛选快速定位
• 拖拽移动：直接把会话行拖到目标工作区标题上即可完成移动（目标高亮提示）；运行中的会话不可拖
• 批量移动：勾选多个会话后点「移动到…」选目标工作区，一次搬入（运行中的会话自动跳过并在提示中说明）
• 移动到新工作区：「移动到…」菜单新增「＋新建工作区（会话所在目录）」——把会话的原始目录注册为工作区并移入，未注册路径的会话从此有了归属
• 上下文压缩阈值（通用设置）：设置对话上下文用到模型窗口（100 万 token）的多少比例时自动压缩（17%–90%），每次压缩保留最近 16% 原文；对所有 Agent 预设的会话统一生效（保存即时 + 持久化 + 重启自动应用）
• 删除限制：仅禁止删除「正在思考」的会话；当前打开的会话（空闲）可删除
• 子代理（subagent）会话支持删除（非运行中）：即使主会话已删除、子代理成为「孤儿」，也能在会话管理中直接清理
• 中英文界面自适应（跟随页面语言）

安装

环境要求

• 已全局安装 DSH CLI（npm i -g @deepseek-ai/dsh），版本 0.1.0-rc.6 或同代 0.1.x rc
• Node.js ^22.19.0 || >=24.0.0，pnpm >=9（DSH CLI 的插件管理直接转发给 pnpm）

从 GitHub Release 安装（推荐）

把下面 URL 中的 <用户名> 换成仓库所属的 GitHub 用户名：

dsh plugin --profile web add 'https://github.com/<用户名>/dsh-session-manager/releases/download/v0.3.0/dsh-session-manager-0.3.0.tgz'

从 GitHub 仓库标签安装

dsh plugin --profile web add 'github:<用户名>/dsh-session-manager#v0.3.0'

从本地目录 / tarball 安装

# 本地目录
dsh plugin --profile web add /absolute/path/to/dsh-session-manager
# 或本地打包产物
pnpm pack
dsh plugin --profile web add /absolute/path/to/dsh-session-manager-0.3.0.tgz

手动安装（dsh plugin 不可用时的后备方案）：dsh plugin 只是在 profile 目录里转发给 pnpm 并同步 dsh.profile.bundles。手动做法：

1. cd ~/.dsh/profiles/web && pnpm add <上面的包说明>
2. 编辑 package.json，在 dsh.profile.bundles 数组里追加 "dsh-session-manager"

安装完成后重启 dsh web（host 插件与客户端 bundle 需要重启加载）。

使用

设置页会话管理

1. 打开侧边栏底部 设置（齿轮图标）
2. 设置页面左侧导航出现独立的 会话管理 分栏，点击进入
3. 主列表为未归档会话；底部「已归档会话」折叠区可展开查看、恢复或删除归档会话
4. 删除会话 → 进入底部「回收站」折叠区（保留最近 10 条）
5. 回收站内可 恢复（回到会话列表）或 彻底删除（永久清除，不可恢复）
6. 行内仅保留 删除 按钮；其余操作统一收进「更多」菜单：继续会话（打开并进入对话）、暂停（停止正在运行的回合）、恢复（归档会话）、新聊天中继续、统计（展开近期活动）、文件夹（打开日志目录）、移动到…——会话名称不再被按钮遮挡
7. 顶部搜索框按标题 / 工作目录过滤；状态筛选：全部 / 运行中 / 未读 / 已归档
8. 拖拽会话行到某个工作区标题上直接移动（目标虚线高亮）；批量移动：勾选后点「移动到…」选目标工作区
9. 「移动到…」菜单里的 ＋新建工作区（会话所在目录） 会把会话的原始目录注册为新工作区并移入
10. 工作区标题右侧（悬停显示）：置于顶部（挪到最前）、重命名、删除（红色，二次确认）
11. 拖拽工作区标题可调整顺序：放到某个工作区上方/下方插入，放到标题上交换位置，拖到最下方即移到末尾
12. 排序按钮（最新在前 / 最旧在前）切换组内会话的排列顺序

把会话移动到其他工作区

1. 打开 设置 → 会话管理，或任意对话页顶部「对话管理」抽屉
2. 找到要移动的会话 → 点「更多」→「移动到…」→ 选择目标工作区
3. 移动成功后会话立即出现在目标工作区分组下；日志文件夹、会话头工作目录与工作区记账同步更新，重启不丢

移动限制：

• 正在运行 / 已加载（live）的会话不能移动——保护日志写入，先「暂停」或重启 dsh web 卸载后再移动
• 目标只能是已注册的工作区；「未分组」会话可以移入某个工作区，但已注册工作区之外的原路径无法作为目标

通用设置：上下文压缩阈值

1. 打开 设置 → 通用设置（General）
2. 找到「上下文压缩阈值」：滑块 / 输入框设置 17%–90%
3. 保存后立即生效（含已打开的会话）；配置对所有 Agent 预设统一生效，重启后依然有效

对话顶部快捷入口

任意对话页右上角（Session log 左侧）：

• 对话管理：打开会话管理抽屉（完整列表 + 已归档 + 回收站），图钉可固定常驻，点击外部自动收起
• 回收站：打开抽屉并直接展开回收站
• 删除本对话（红色）：确认后删除当前对话（移入回收站）

未读 / 已读状态点

会话行标题旁的圆点表示四种状态：蓝色=手动标记未读、琥珀=官方等待输入、绿色=官方完成提醒、转圈=运行中。点击琥珀 / 绿色点就地标记已读（不跳转，仅清除官方提醒）；点击蓝色点清除未读；点击空白位置标记未读；打开会话自动已读。官方侧边栏的会话行旁同步显示蓝色未读点（按标题文本匹配，重复标题会话会共享该点）。

工作原理

层	实现
Host	src/index.ts 注册 8 条路由：POST /delete（归档 + 非 live 会话文件移入回收站 + 记录条目）、POST /restore（文件移回 + 取消归档 + 删除条目）、POST /purge（清除回收站与原位置文件 + 删除条目）、GET /trash（回收站列表）、POST /open-folder（打开日志目录）、POST /pause（暂停运行中会话）、POST /move-workspace（移动会话到其他工作区）、`GET
Client	src/client/index.ts 通过官方 settings.section 插槽注册独立分栏，用 useSessions / useWorkspaces 标准数据源列出会话（含归档/回收站分组），删除/恢复/彻底删除/移动调用 host 路由；抽屉通过 sessions.list（ObservableSnapshot）订阅实时列表；彻底删除的会话 id 记录在浏览器 localStorage，避免 live 会话删除后刷新「复活」

• 未读机制：手动未读集保存在浏览器 localStorage 的共享 key dsh.session-unread.v1（{version:1, ids:[]} 格式，与其他会话管理插件互通）；官方状态点（琥珀/绿色/转圈）由官方 SessionSummary 的 pendingInteraction / completed / running 字段驱动，点击就地已读通过清除官方提醒标记实现，无需打开会话；侧边栏的蓝色未读点由 MutationObserver 装饰官方树节点（官方行元素没有会话 id 属性，故按标题文本匹配）
• 移动到工作区：host 读取会话原始 zstd 日志，把首帧改写为只含一行会话头（cwd 更新为目标工作区路径），事件帧原样保留（DSH 要求首帧恰好一行头部，单帧重写会被判定为 corrupt）；日志目录先改名搬入目标工作区目录，再写回新文件；最后更新工作区记账（旧组 detachSession + 新组 attachSession）。任一步失败都会回滚：先把目录改回原名，再恢复原始文件字节，绝不先删后移
• 压缩阈值全局生效：保存在存储域（dsh_delete_session 的 thresholdRatio）；如果默认 Agent 预设是用户预设，则同时写入 agent-presets 服务解析出的 agent.cordis.yml，系统预设文件保持只读。host 在每个 agent/pre-step 钩子里把阈值写入所有预设的压缩引擎配置，因此对所有 Agent 预设的会话统一生效，重启后依然有效
• 删除时先走官方归档通道：侧边栏立即隐藏该会话
• 回收站条目持久化在 DSH 存储域（~/.dsh/storages/dsh_delete_session.json），文件在 ~/.dsh/dsh-delete-session-trash/
• 工作区记账（sessionIds 槽位）在下次启动时由 registry 重建索引自动对账，无需手动编辑文件
• 无系统提示词改动、无模型工具新增，对 token 与模型行为零影响

隐私与安全

• 完全本地运行：所有操作（删除、恢复、移动、统计、阈值）只读写本机 ~/.dsh 下的文件与浏览器 localStorage，没有任何遥测、统计上报或网络请求
• 移动会话只是把本机日志目录换个位置并更新元数据，不会上传任何内容
• 插件不修改 DSH 核心代码，卸载插件不影响已有会话

限制

• 不能删除正在运行的会话（按钮禁用并拒绝删除），多标签页场景请先在别处确认该会话已停止
• 不能移动正在运行 / 已加载（live）的会话：运行中的会话先「暂停」；已加载的会话重启 dsh web 卸载后再移动
• 子代理会话可删除（非运行中），包括主会话已删除的「孤儿子代理」——不会再有无法清理的残留会话
• live 会话（当前进程内打开的会话）删除后，其内存状态由 DSH 在重启时彻底清理
• 已彻底删除的会话 id 会保留在浏览器 localStorage（防止刷新后重新出现）与归档集合中（无害残留，不显示）
• 侧边栏未读点按标题文本匹配，存在重复标题的会话时两者会共享同一个点（会话管理抽屉内不受影响，按真实会话 id 精确标记）

兼容性

当前版本适配 DSH 0.1.0-rc.6（依赖 settings.section / settings.general.item / conversation.session.header.utilities 插槽与 ctx.sessionPersistence / ctx.workspaceRegistry / ctx.agents / ctx.storageDomain / ctx.agentPresets 服务；运行时 @deepseek-ai/* 包由 DSH host 提供，通过全局安装解析）。DSH 版本升级后如插槽或服务 API 变化，需要同步适配。

开发

pnpm install        # 安装依赖（@deepseek-ai 系列来自 npm 注册表，任何机器可直接构建）
pnpm run check      # typecheck + test + build
pnpm pack           # 产出 dsh-session-manager-0.3.0.tgz（用于 GitHub Release）

lib/ 为提交的构建产物，修改源码后必须重新构建并提交 lib/（保证 github: 方式安装无需构建即可使用）。

致谢

本仓库 fork 自 dream12347/dsh-session-manager（MIT），在其全部功能基础上新增「移动到工作区」与相关修复。原版作者与贡献者：dream12347、DoggyHU、cmj799、Chen5173。

_{如果觉得有用，欢迎点个 ⭐ Star，谢谢支持！}