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

中文

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

English

功能

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

截图

安装

方式一：直接 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.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

A DSH web plugin: a Session Manager in Settings — manage every conversation on this machine in one place.

中文

Features

• Two tabs: All conversations (non-archived) and Archived
• View modes: flat list or grouped by workspace (sessions without a workspace fall back to "Ungrouped")
• Browse conversations by title + relative time, newest first
• Search box: filter the session list by title or id in real time
• Checkbox / drag-to-select / select-all / batch archive (records kept) / batch delete (permanent, with a confirmation modal)
• Unarchive from the Archived tab (move back to All conversations)
• Open record folder button: opens the selected session's record directory in your OS file manager — cross-platform via explorer / open / xdg-open
• Expand each row for details (collapsed by default): size on disk, last update, activity stats (turns, steps, messages, tool-call distribution, fetch history), produced/downloaded files, parent and child (fork) sessions
• Subagent sessions are shown nested under their parent conversation (indented, with a "subagent" badge); when the parent is deleted or missing they surface as top-level rows
• Deleting a parent session does NOT cascade: subagent children, forks, and downloaded/produced files are kept unless you explicitly select them — nothing is lost accidentally
• The currently open session shows a Current badge and cannot be deleted

Screenshots

Install

Option 1: Direct tarball install

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

If pnpm blocks build scripts, append --ignore-scripts:

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

Option 2: Let an agent install it

Tell your DSH agent:

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

The agent downloads the repo, places it into the profile's node_modules, and registers it in dsh.profile.bundles.

After installing, restart the web app — the Session Manager appears in Settings automatically.

Compatibility

• Zero config: session directories are auto-detected from the official DSH layout ($DSH_HOME/sessions/<project-key>/<session-id>/) — no core patches
• Archive / unarchive: built on the same registry state primitives as the official archiveSession
• Non-cascading delete: only the selected session is removed; subagents, forks and files are kept; running sessions are rejected (409)
• Loopback-only API (127.0.0.1 / localhost / ::1); official public APIs only (workspaceRegistry, sessionPersistence)

Changelog

0.1.2

• Search box: filter the session list by title or id in real time
• Activity stats in the detail panel: turns, steps, user/assistant messages, tool-call distribution and fetch history
• Safer file deletion: only files produced by the session can be deleted (directories rejected), with a confirmation dialog and all-settled error summary
• Batch operations now run in batches of 20 — selecting hundreds of sessions no longer floods the browser
• Orphan subagent sessions (parent deleted) are visible again in the workspace view
• Detail lineage no longer lists the same subagent twice; a failing workspace no longer blocks an entire delete
• Relative timestamps refresh automatically; keyboard (Tab + Enter/Space) selection; drag-select no longer sticks after releasing outside the window
• Open-record-folder now works for sessions without a working directory (_no-cwd layout); deleting a missing session returns 404
• Detail responses are bounded (files ≤ 200, fetches ≤ 50) so huge sessions stay snappy

0.1.1

• Subagent sessions are now collapsed by default and expand on click (expand/collapse arrow on the parent row)
• Subagents follow their parent into the correct workspace group (no longer dumped into "Ungrouped")
• Deleting a parent session is now non-cascading: subagents, forks, and files are kept unless explicitly selected
• Open-record-folder button; batch archive / unarchive / delete with confirmation; current-session protection
• Zero config on stock Harness — official APIs only, no core patches

0.1.0

• Initial release: two tabs (All conversations / Archived), flat / by-workspace views, batch archive & delete, detail expansion, subagent nesting

License

MIT — © 2026 Zephyr-vibe