Zephyr-vibe/dsh-archived-sessions

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

中文

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

English

功能

- 双标签页：所有对话（未归档）与归档会话
- 视图切换：单列表或按工作区分组（无工作区归属的会话兜底归入「未分组」）
- 按标题 + 相对时间浏览对话，最近的排在最前
- 搜索框：按标题或 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///）自动识别，无需核心补丁
- 归档 / 恢复：基于官方 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

English

一个 DSH Web 插件：设置中的会话管理器——在一处管理本机上的每一个对话。

中文

功能特性

- 两个标签页：所有对话（未归档）与归档会话
- 视图模式：扁平列表或按工作区分组（无工作区的会话归入「未分组」）
- 按标题 + 相对时间浏览会话，最新在前
- 搜索框：按标题或 id 实时过滤会话列表
- 复选框 / 拖拽选择 / 全选 / 批量归档（保留记录）/ 批量删除（永久删除，带确认弹窗）
- “删除会话”条目已移至会话标题栏（针对 DSH 0.1.0-rc.8 适配）：自 rc.8 起，官方侧边栏行菜单（⋮）不再暴露插件注入点（仅保留重命名 / 分支 / 归档），因此删除按钮现在位于已打开会话的标题栏中（🗑 垃圾桶图标）——其确认对话框允许你可选地删除该会话的子对话 / 已下载·生成的文件 / 整个文件夹，默认不勾选任何内容（仅删除会话本身）
- 从“已归档”标签页中取消归档（移回“所有对话”）
- 打开记录文件夹按钮：在操作系统文件管理器中打开所选会话的记录目录——通过 explorer / open / xdg-open 实现跨平台
- 展开每一行以查看详情（默认折叠）：磁盘占用大小、最后更新时间、活动统计（轮次、步骤、消息、工具调用分布、抓取历史）、生成/下载的文件、父会话和子（分支）会话
- 子智能体会话嵌套显示在其父对话下（缩进，并带有“subagent”徽章）；当父会话被删除或缺失时，它们会作为顶层行显示
- 删除父会话不会级联：子智能体子会话、分支以及已下载/生成的文件都会被保留，除非你明确选择它们——不会意外丢失任何内容
- 当前打开的会话会显示 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 应用——会话管理器会自动出现在设置中。

兼容性
- 零配置：会话目录从官方 DSH 布局（$DSH_HOME/sessions///）自动检测——无需核心补丁
- 归档 / 取消归档：基于与官方 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，且官方侧边栏行菜单（⋮）现在仅保留重命名 / 分支 / 归档，没有插件注入点——此版本重做了删除流程，恢复了删除入口，并修复了升级暴露出的若干问题。

- 修复：删除后残留活动会话（核心 rc.8 兼容性）——由于官方删除原语已移除，旧的删除路径仅分离工作区并移除磁盘文件，导致活动会话仍挂载在会话存储中：它仍出现在列表中，且由于工作区已不存在而落入“未分组”（仅在重启后消失）；现在删除会先刷新所有目标日志，然后通过官方公共原语 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 起，侧边栏行菜单（⋮）不再暴露插件注入点（仅保留重命名 / 分支 / 归档）；删除入口现在位于已打开会话的头部操作中（官方 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

- 初始版本：两个标签页（所有对话 / 已归档）、平铺 / 按工作区视图、批量归档和删除、详情展开、子代理嵌套

许可证

MIT — © 2026 Zephyr-vibe