会话归档管理 Zephyr-vibe/dsh-archived-sessions

dsh-archived-sessions（DSH 会话管理）

一个 DSH Web 插件：在「设置」中提供会话管理，统一管理本机上的所有对话。

功能

- 双标签页：所有对话（未归档）与归档会话
- 视图切换：单列表或按工作区分组（无工作区归属的会话兜底归入「未分组」）
- 按标题 + 相对时间浏览对话，最近的排在最前
- 搜索框：按标题或 ID 实时过滤会话列表
- 勾选 / 拖动批量勾选 / 全选 / 批量归档（记录保留）/ 批量删除（永久删除，带确认弹窗）
- 「删除会话」入口已移至会话头部（适配 DSH 0.1.0-rc.8）：rc.8 起官方侧边栏行菜单（⋮）不再开放插件注入点（只剩 重命名/分叉/归档），删除按钮改放在打开的会话标题栏（🗑 垃圾桶图标）——确认弹窗可细粒度勾选删除其下子对话 / 下载·产出文件 / 整个文件夹，默认只删会话本身
- 归档页支持移出归档（回到所有对话）
- 打开记录文件夹按钮：在系统文件管理器中打开所选会话的记录目录，跨平台（explorer / open / xdg-open）
- 每行可展开详情（默认收起）：占用空间、最后更新、活动统计（轮次、步骤、消息数、工具调用分布、fetch 记录）、产出/下载文件、父会话与子会话（分叉）
- 子代理会话嵌套显示在父会话下方（缩进 + 「子代理」徽标）；父会话被删除或缺失时自动浮出为顶层行
- 删除父会话不会级联：子代理、分叉、下载/产出文件均保留，除非你显式勾选它们——避免误删
- 当前打开的会话显示「当前会话」徽标，且不可删除

截图

归档会话视图 / 子代理会话嵌套在父会话下

详情面板（含活动统计、产出文件、关联对话）

会话头部「删除会话」入口（rc.8 起删除入口移至会话头部）

删除确认弹窗——可勾选删除其下子对话 / 下载·产出文件 / 整个文件夹

安装

方式一：直接 tarball 安装

dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-archived-sessions/tar.gz/refs/heads/main

如果 pnpm 拦截构建脚本，在命令末尾加 --ignore-scripts：

dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-archived-sessions/tar.gz/refs/heads/main --ignore-scripts

方式二：让 agent 安装

告诉你的 DSH 智能体：

帮我把这个项目安装为插件：https://github.com/Zephyr-vibe/dsh-archived-sessions

agent 会下载项目、放入 profile 的 node_modules 并注册到 dsh.profile.bundles。

安装后重启 web 端，即可在「设置」中看到「会话管理」入口。

兼容性

- 零配置：会话目录按官方 DSH 布局（$DSH_HOME/sessions/<project-key>/<session-id>/）自动识别，无需核心补丁
- 归档 / 恢复：基于官方 archiveSession 相同的 registry 状态原语实现
- 删除不级联：只删除所选会话，子代理、分叉与文件均保留；运行中的会话拒绝删除（409）
- API 仅信任本机请求（127.0.0.1 / localhost / ::1）；仅使用官方公开 API（workspaceRegistry、sessionPersistence）

更新日志

0.1.5

背景：适配 DSH 核心 0.1.0-rc.8 更新。 rc.8 移除了官方 workspaceRegistry.deleteSession 与 sessionPersistence.remove，官方侧边栏会话行菜单（⋮）也只保留 重命名/分叉/归档 且不再开放插件注入点——本版本针对这些变化重做删除链路、补回删除入口，并修复升级过程中暴露的若干问题。

- 修复：删除后 live 会话残留（核心 rc.8 兼容）——rc.8 移除官方删除原语后，旧版删除只做工作区 detach + 磁盘清理，会漏掉仍挂在 sessions store 里的 live 会话：删除后它依旧出现在列表，且因工作区已 detach 而落入「未分组」（重启后才会消失）；现在删除前先 flush 全部目标会话日志，删除后用官方公开原语 SessionStore.liveEntryFor + detachEntered 摘除 live 会话（广播 session/disposed，持久化状态同步清理），并保持 0.1.3 的「只删自己 / 不级联」语义不变
- 修复：删除会话后残留空文件夹——「删除文件」模式（filePaths）与「保留文件」模式（deleteFiles=false）之前只删记录 log、会话目录残留为空壳；现在所有删除分支最终都会清理会话目录（工作区产出文件不受影响），并等待 persistence retire 落定后兜底重删（防尾部 flush 自动 mkdir 重建目录）
- 修复：点开会话详情面板崩溃变空——文件分组代码引用了浏览器端不存在的 node sep 变量（0.1.4 回归），当会话产出文件位于工作区内子文件夹时抛 ReferenceError: sep is not defined，被错误边界捕获后整个会话管理区域空白；已改为字面分隔符拼接
- 「删除会话」按钮从行菜单移到会话头部（rc.8 适配）——rc.8 侧边栏行菜单（⋮）不再开放插件注入点（只剩 重命名/分叉/归档），删除入口改放到打开的会话头部操作区（官方 conversation.session.header.actions slot，自动携带 sessionId），带确认弹窗走 /archived/api/delete，发布后任何导入本插件的部署都能获得删除能力
- 头部删除弹窗带细粒度选项：与设置面板一致——可勾选删除其下子对话（子代理，含孙级）与下载/产出文件（可展开查看具体列表、显示路径开关），默认都不勾选（只删会话本身）
- 增强：头部删除弹窗显示可整删的文件夹节点——文件按父目录归组，工作区根以下的子文件夹显示为 📁 节点（可展开、可勾选整删），工作区根本身绝不可整删；details API 新增返回 cwd 作为根判断依据（取不到 cwd 时宁可不推导文件夹）
- 修复：头部删除弹窗展开详情崩溃——baseName 原本定义在设置面板组件闭包内，头部删除弹窗访问不到（ReferenceError: baseName is not defined，slot 入口崩溃导致删除按钮消失）；已提升为模块级函数，两处共用
- 增强：检测 shell 命令创建的产出文件——详情/删除的文件列表原先只认 write/edit 工具的 file_path；现在也解析 pwsh/bash 的 Set-Content/Add-Content/Out-File/New-Item 及 >/>> 重定向中的路径（经 stat+isFile 存在性过滤，排除目录与残留 token）

0.1.4

- 详情面板关联对话区：只显示子代理个数（父会话/分叉不再列出）
- 删除弹窗子代理区：只显示子代理（含孙级等全部后代），标题带个数
- 文件列表完善：树形文件夹展开、列表滚动、显示路径开关（默认只显示文件名）、文件夹路径与文件一致
- 文件夹行样式统一：与文件行完全相同的组件与样式，无间距差异；箭头展开/收起带旋转动画
- 删除会话/删除文件后自动清理空父目录（直到非空或工作区根，根目录绝不删除）
- 已物理删除的文件不再出现在详情/删除弹窗（host 端 stat 过滤）
- 修复：文件列表包含子代理产出、id 格式兼容（session- 前缀）、工作区外文件兜底显示文件名

0.1.3

- 删除确认弹窗升级：两行确认；可细粒度勾选删除的子代理（含孙级）与下载/产出文件，默认都不勾选
- 删除级联与文件选项：删除会话时可一并删除其下子代理（cascade / subagentIds）、下载与产出文件（filePaths，含整个文件夹）
- 文件夹删除安全规则：工作区根目录绝不删除；子文件夹可整删（递归）；删除后自动清理空目录（逐级直到非空或工作区根）
- 文件列表树形显示：文件夹可展开查看内部文件；列表超出时滚动显示；"显示路径"开关（默认只显示文件名，实时切换完整路径）
- 默认按工作区分组；视图切换按钮顺序调整（按工作区在前）
- 修复：子代理收集双向 id 匹配（session- 前缀兼容）、文件列表包含子代理产出、工作区外文件兜底显示文件名

0.1.2

- 搜索框：按标题或 ID 实时过滤会话列表
- 详情面板活动统计：轮次、步骤、用户/助手消息、工具调用分布与 fetch 记录
- 更安全的文件删除：只能删除该会话的产出文件（拒绝目录），带确认弹窗与失败汇总
- 批量操作分批执行（每批 20 个）——选中数百会话不再压垮浏览器
- 父会话删除后，孤儿子代理会话在工作区视图仍可见
- 详情子会话不再重复列出；单个工作区异常不再阻塞整次删除
- 相对时间自动刷新；键盘（Tab + Enter/Space）选择；拖拽选择在窗口外释放不再卡住
- 打开记录文件夹支持无工作目录会话（_no-cwd 布局）；删除不存在的会话返回 404
- 详情响应有界（文件 ≤ 200、fetch ≤ 50），大会话保持流畅

0.1.1

- 子代理会话默认折叠，点击父行箭头展开/收起
- 子代理跟随父会话归入正确的工作区分组（不再落入「未分组」）
- 删除父会话不再级联：子代理、分叉与文件均保留，除非显式勾选
- 打开记录文件夹按钮；批量归档/恢复/删除带确认；当前会话保护
- 纯净 Harness 零配置——仅使用官方 API，无核心补丁

0.1.0

- 首个版本：双标签（所有对话/归档会话）、单列表/按工作区视图、批量归档与删除、详情展开、子代理嵌套

许可证

MIT — © 2026 Zephyr-vibe

DSH web 插件：设置里的会话管理器——在这台机器上统一管理每一个对话。

功能

- 两个标签：所有对话（未归档）与归档会话
- 视图模式：单列表或按工作区分组（没有工作区的会话归入「未分组」）
- 按标题 + 相对时间浏览对话，最新的排在最前
- 搜索框：按标题或 id 实时过滤会话列表
- 复选框 / 拖拽选择 / 全选 / 批量归档（记录保留）/ 批量删除（永久删除，带确认弹窗）
- 「删除会话」入口移到会话标题栏（适配 DSH 0.1.0-rc.8）：从 rc.8 起，官方侧边栏行菜单（⋮）不再暴露插件注入点（只剩 Rename / Fork / Archive），所以删除按钮现在放在已打开会话的标题栏（🗑 垃圾桶图标）——它的确认对话框让你可选删除该会话的子会话 / 已下载·已生成文件 / 整个文件夹，默认什么都不勾选（只删会话本身）
- 从 Archived 标签页取消归档（移回 All conversations）
- 打开记录文件夹按钮：在系统文件管理器里打开所选会话的记录目录——跨平台，走 explorer / open / xdg-open
- 展开每一行看详情（默认折叠）：磁盘占用、最后更新时间、活动统计（轮次、步骤、消息、工具调用分布、抓取历史）、已生成 / 已下载文件、父会话与子（fork）会话
- 子代理会话嵌套显示在父会话下面（缩进，带「subagent」徽标）；父会话被删除或找不到时，它们会浮到顶层显示
- 删除父会话不会级联：子代理子会话、fork、已下载 / 已生成文件都会保留，除非你明确勾选——不会误删任何东西
- 当前打开的会话显示 Current 徽标，且不能删除

截图

归档视图 / 子代理会话嵌套在父会话下

详情面板——活动统计、已生成文件、相关会话

标题栏「删除会话」入口（从 rc.8 起删除入口移到会话标题栏）

删除确认对话框——可选删除子会话 / 已下载·已生成文件 / 整个文件夹

安装

方式 1：直接安装 tarball

dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-archived-sessions/tar.gz/refs/heads/main

如果 pnpm 拦截构建脚本，追加 --ignore-scripts：

dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-archived-sessions/tar.gz/refs/heads/main --ignore-scripts

方式 2：让智能体帮你装

对你的 DSH 智能体说：

帮我把这个项目安装为插件：https://github.com/Zephyr-vibe/dsh-archived-sessions

智能体会下载仓库，放进配置档的 node_modules，并在 dsh.profile.bundles 里注册。

安装完成后重启 web 应用——Session Manager 会自动出现在 Settings 里。

兼容性

- 零配置：会话目录从官方 DSH 布局（$DSH_HOME/sessions/<project-key>/<session-id>/）自动识别——无需改动核心
- 归档 / 取消归档：与官方 archiveSession 建立在同一套 registry 状态原语之上
- 非级联删除：只移除选中的会话；子代理、分叉和文件都保留；正在运行的会话会被拒绝（409）
- 仅限回环地址的 API（127.0.0.1 / localhost / ::1）；只用官方公开 API（workspaceRegistry、sessionPersistence）

更新日志

0.1.5

背景：适配 DSH 核心 0.1.0-rc.8 更新。 rc.8 移除了官方 workspaceRegistry.deleteSession 和 sessionPersistence.remove，官方侧边栏行菜单（⋮）现在只保留 Rename / Fork / Archive，没有插件注入点——本次发布重做了删除流程，恢复了删除入口，并修复了升级暴露出的几个问题。

- 修复：删除后残留活动会话（兼容核心 rc.8）——官方删除原语没了之后，旧的删除路径只把工作区分离、删掉磁盘文件，活动会话仍挂载在会话存储里：它继续出现在列表中，工作区没了就掉进「Ungrouped」（只有重启后才消失）；现在删除会先刷出所有目标日志，再通过官方公开原语 SessionStore.liveEntryFor + detachEntered 分离活动会话（广播 session/disposed，持久化状态依次清理），保留 0.1.3「只删除选中会话 / 不级联」的语义
- 修复：删除后残留空会话文件夹——「删除文件」模式（filePaths）和「保留文件」模式（deleteFiles:false）以前只移除记录日志，把会话目录留成空壳；现在每个删除分支最后都会清理会话目录（工作区产出的文件不受影响），并等持久化退役落定后再做一次幂等重删（防止尾部刷写自动 mkdir 把目录又建回来）
- 修复：会话详情面板崩溃变空白——文件分组代码引用了浏览器里不存在的 node sep 变量（0.1.4 的回归）；当产出文件位于工作区子文件夹内时会抛 ReferenceError: sep is not defined，错误边界把整个会话管理区域刷成空白；现在改用字面量分隔符拼接
- 「删除会话」按钮从行菜单移到会话头部（适配 rc.8）——rc.8 起侧边栏行菜单（⋮）不再暴露插件注入点（只剩 Rename / Fork / Archive）；删除入口现在位于已打开会话的头部操作区（官方 conversation.session.header.actions 插槽，自带 sessionId），确认对话框调用 /archived/api/delete，在任何导入该插件的部署中都能用
- 带细粒度选项的头部删除对话框：与设置面板一致——可选删除会话的子对话（子代理，含孙代理）和下载/生成的文件（可展开列表，带「显示路径」开关）；默认全部不勾选（只删除会话本身）
- 增强：头部删除对话框显示可删除的文件夹节点——文件按父目录分组；工作区根目录下的子文件夹显示为 📁 节点（可展开，可勾选整文件夹删除），工作区根目录本身永远不能删除；details API 现在返回 cwd 作为根目录判断依据（cwd 不可用时完全不推导文件夹节点）
- 修复：头部删除对话框展开详情时崩溃——baseName 原本位于设置面板组件的闭包内，头部删除对话框无法访问（ReferenceError: baseName is not defined，插槽入口崩溃，删除按钮消失）；已提升到模块作用域，两处共用
- 增强：检测通过 shell 生成的文件——详情/删除文件列表原先只识别 write/edit 工具的 file_path；现在还会解析 pwsh/bash 中 Set-Content/Add-Content/Out-File/New-Item 以及 >/>> 重定向里的路径（用 stat+isFile 存在性检查过滤，丢弃目录和杂散 token）

0.1.4

- 详情「相关对话」：现在只显示子代理数量（不再列出父级 / 分叉）
- 删除对话框的子代理区块：只显示子代理（含孙代理在内的所有后代），并带数量
- 文件列表打磨：树形文件夹展开、滚动、「显示路径」开关（默认显示文件名），文件夹路径与文件保持一致
- 文件夹行与文件行共用同一组件/样式——间距不漂移；箭头展开/折叠带旋转动画
- 删除会话或文件会清理空的父目录（直到第一个非空目录或工作区根目录；根目录永不删除）
- 物理删除的文件不再出现在详情 / 删除对话框中（宿主侧 stat 过滤）
- 修复：文件列表包含子代理输出；id 格式容错（session- 前缀）；工作区根目录之外的文件回退为文件名

0.1.3

- 升级删除确认：两行确认；可细粒度选择子代理（含孙代理）和下载/生成的文件，默认全部不勾选
- 级联与文件选项：删除会话时还可移除其子代理（cascade / subagentIds）和下载/生成的文件（filePaths，含整个文件夹）
- 文件夹删除安全：工作区根目录永不删除；子文件夹可递归移除；空的父目录自动清理（直到第一个非空目录或工作区根目录）
- 树形文件列表：文件夹可展开显示其中的文件；列表过长时滚动；带「显示路径」开关（默认显示文件名，实时切换完整路径）
- 默认使用工作区视图；视图切换顺序调整（工作区在前）
- 修复：子代理 id 双向匹配（容忍 session- 前缀），文件列表包含子代理输出，工作区根目录之外的文件回退为文件名

0.1.2

- 搜索框：按标题或 id 实时过滤会话列表
- 详情面板中的活动统计：轮次、步骤、用户/助手消息、工具调用分布和抓取历史
- 更安全的文件删除：只能删除会话产生的文件（拒绝目录），带确认对话框和全部结算的错误汇总
- 批量操作现在按每批 20 个执行——选中数百个会话不再冲垮浏览器
- 孤儿子代理会话（父会话已删除）在工作区视图中重新可见
- 详情血缘不再重复列出同一个子代理；某个工作区失败不再阻塞整个删除
- 相对时间戳自动刷新；键盘（Tab + Enter/Space）选择；在窗口外松开鼠标后拖拽选择不再粘滞
- 打开记录文件夹现在对没有工作目录的会话也有效（_no-cwd 布局）；删除不存在的会话返回 404
- 详情响应有上限（文件 ≤ 200，抓取 ≤ 50），超大会话也能保持流畅

0.1.1

- 子代理会话现在默认折叠，点击展开（父行上有展开/折叠箭头）
- 子代理跟随父会话进入正确的工作区分组（不再被丢进「未分组」）
- 删除父会话现在不级联：除非显式选中，否则子代理、分叉和文件都会保留
- 打开记录文件夹按钮；批量归档 / 取消归档 / 删除带确认；当前会话保护
- 原版 Harness 上零配置——只用官方 API，不打核心补丁

0.1.0

- 首次发布：两个标签页（全部对话 / 已归档），平铺 / 按工作区视图，批量归档与删除，详情展开，子代理嵌套

License

MIT — © 2026 Zephyr-vibe