归档会话管理 kiligzzz/dsh-session-archive

dsh-session-archive

installs

一个 DeepSeek Harness Web 插件：把注册表全局的已归档会话呈现出来，支持预览、恢复（取消归档）与删除。

harness 会把归档会话从所有界面（工作区分组、未分组、内容搜索、平铺列表）中隐藏，却不提供任何查看或恢复入口。本插件在侧边栏底部添加一个入口，补上这块缺失的能力。

截图

面板 —— 已归档会话按所属工作区目录分组，组内按时间倒序；每行显示最后活动时间，悬停可见绝对时间戳。

面板

实时标题搜索 —— 输入即跨所有分组过滤列表。

搜索

只读预览 —— 点击会话标题打开弹窗，从磁盘日志渲染全部用户问题；归档状态全程不受影响。

预览

删除二次确认 —— 删除必须经过显式确认弹窗；活跃会话一律拒绝删除。

删除确认

侧边栏入口 —— 插件在侧边栏底部添加按钮，与 Cordis Plugin、插件市场并列。

侧边栏入口

功能

- 侧边栏底部入口 —— 侧边栏底部的「已归档会话」按钮（收起为图标 rail 时同样可用）。
- 分组面板 —— 宽幅固定尺寸面板列出全部已归档会话，按所属工作区目录分组（未分组排最后），分组可折叠，每组带计数徽章。
- 每行最后活动时间 —— 紧凑相对时间（刚刚 / 5分钟 / 3小时 / 2天），风格与侧边栏会话行一致；悬停显示绝对本地时间。组内按时间倒序排列（最新在上）。
- 实时标题搜索 —— 输入即跨全部分组过滤会话。
- 只读预览 —— 点击会话标题打开弹窗，从磁盘日志渲染全部真实用户问题（系统注入内容已排除）。纯观察性操作：归档状态全程不受影响，可先查看内容再决定恢复还是删除。
- 一键恢复 —— 调用同源 host 路由，从持久化归档集中移除该 id （幂等，经 workspace-registry 写入链串行化）；会话随即回到原分组。
- 带确认的删除 —— 垃圾桶按钮打开确认弹窗；确认后永久移除归档记录、解除工作区记账并删除磁盘上的日志目录。活跃会话拒绝删除。
- Host 服务 API —— 向相邻 host 插件暴露 workspaceArchive
（list() / preview(sessionId) / restore(sessionId) /
deleteSession(sessionId)）。

安装

前置：DeepSeek Harness Web profile（dsh 可用，pnpm 在 PATH 上）。

dsh plugin --profile web add https://github.com/kiligzzz/dsh-session-archive

重启 Web profile（host 与浏览器 bundle 在启动时扫描），然后刷新页面。
bundle id 出现在 __DSH_BOOT__ 中，侧边栏底部出现 sidebar.footer.action 入口。

从本地 checkout 安装：

pnpm --dir install # 仅重建时需要（dev 依赖 esbuild）
pnpm --dir run build # 可选 —— lib/ 构建产物已提交
dsh plugin --profile web add "$PWD"

卸载

dsh plugin --profile web remove @kiligzzz/dsh-session-archive

工作原理

- host（src/index.ts）：注入 workspaceRegistry（及可选 webServer）的 cordis 插件。WorkspaceArchive.restore() 复刻注册表自身 archiveSession 的写入路径：enqueueOperation → requireState → setState({ ...state, archivedSessionIds: filtered })，变更经串行化原子持久化到工作区域（~/.dsh/storages/workspace.json）。
同源路由 /_dsh/session-archive 提供 GET（列表）与
POST {action:'restore'|'delete'|'preview'}。
- client（src/client/index.tsx）：注册 sidebar.footer.action 入口；面板从共享 useWorkspaces / useSessions store 读取 archivedSessionIds 与会话摘要，恢复时 POST 到 host 路由，随后 workspace 基线刷新。相对时间取自每个会话的 updatedAt。

许可证

MIT