归档对话管理 leogottadothebest/dsh-plugin-archived-conversations

dsh-plugin-archived-conversations

English: A DeepSeek Harness plugin for managing archived conversations in
the Settings UI — unarchive them back to the sidebar, or permanently delete
them (with confirmation). Ships a full archivedSessions remote API and
batch unarchive. Bilingual (zh/en), light/dark theme aware.

DeepSeek Harness 插件：在设置界面管理已归档对话。

- 取消归档 —— 对话恢复到侧边栏原位置（工作区记账保持不变）；
- 删除 —— 永久删除对话（内存会话、磁盘日志 session.jsonl.zstd、工作区记账与归档记录一并清理），带二次确认；
- 附带完整归档 API（archive，与核心归档路径一致），并支持「全部取消归档」批量操作。

对话被归档后不再出现在侧边栏；本插件是找回并清理它们的唯一入口。

功能

- 设置 →「已归档对话」页面，按归档顺序倒序列出全部已归档对话：标题、工作区路径、最近活动时间；
- 行操作：取消归档、删除（RiskConfirmation 确认，需勾选「我明白此操作不可恢复」）；
- 实时双向同步：在侧边栏归档的对话立即出现在本页；在本页取消归档的对话立即回到侧边栏；
- 读取失败的坏行仍可删除（自愈）；
- 中英双语，跟随浅色/深色主题。

安装

DSH 插件需要两步：作为依赖安装 + 挂载为 bundle 层（本包自带 dsh.bundle.patch，即 cordis.patch.yml 中的插入条目）。

桌面端（以默认 profile 为例）：从 npm registry 安装
cd ~/.dsh/profiles/desktop
pnpm add dsh-plugin-archived-conversations

本地开发时也可从源码路径安装（替换为你的克隆路径）
pnpm add /path/to/dsh-plugin-archived-conversations

把插件追加到 bundle 层：编辑 package.json，在 dsh.profile.bundles 中加入 "dsh-plugin-archived-conversations"（dshmarket / 插件市场安装插件时执行的正是这两步）。

然后重启 DeepSeek Harness，打开 设置 → 已归档对话 即可使用。也可在插件市场（dsh-community-market）中安装本包（需发布到 npm registry）。

远程 API（宿主）

命名空间 archivedSessions（Typert 协议，严格 zod wire codec）：

| 方法 | 参数 | 返回 |
| list(signal) | — | { items: ArchivedSessionItem[], archivedSessionIds: string[] } |
| archive(request, signal) | { sessionId } | { sessionId, archivedSessionIds } |
| unarchive(request, signal) | { sessionId } | { sessionId, archivedSessionIds } |
| deleteSession(request, signal) | { sessionId } | { sessionId, deleted: true } |

ArchivedSessionItem：

interface ArchivedSessionItem {
sessionId: string
title: string | null // 投影缓存中的标题 cwd: string | null // 工作区路径 createdAt: number | null // epoch ms updatedAt: number | null // 最近活动（lastPromptAt ?? createdAt） running: boolean // 会话当前是否仍在内存中 readError: string | null // 行读取失败原因（仍可删除） }

业务错误（{ok:false, error:{code, message, details}}）：
not-archived、live-detach-unsupported、unsupported-backend。

兼容性

| DSH core | 状态 |
| 0.2.0-rc.2（当前 Desktop） | ✅ 已验证（peer 范围放行；宿主/客户端契约逐项核对无变化） |
| 0.1.7-rc.2 | ✅ 兼容（清单 create() 工厂 + 头部绑定的投影缓存 + 笔画名图标） |
| 0.1.5-rc.2（Desktop 2.0.10） | ✅ 兼容（schema codec + 带 cut 的投影缓存 + 尺寸名图标） |
| 0.1.2-rc.1 及更早 | 兼容（同上，旧线） |

同一份产物在两条线上都能渲染与调用：wire codec 同时携带两个时代的字段，投影缓存按声明元数判别签名，图标按 ?? 在两代命名间解析。

peer 范围即开关。 DSH core ≥ 0.2.0-rc.2 的 profile loader （dsh-app-boot 的 evaluatePluginCompatibility）会用
semver.satisfies(runtime, range, { includePrerelease: true }) 校验插件的
peerDependencies，任何一个 @deepseek-ai/dsh peer 不匹配就静默跳过整个 bundle*：插件完全不挂载，没有报错、没有弹窗，只有一条 skippedBundles 记录。0.x 的 caret 不含下一个次版本行（^0.1.7-rc.2 = >=0.1.7-rc.2 <0.2.0-0），includePrerelease 也不会放宽上界——所以 0.1.6 在 0.2.0-rc.2 上「什么都没坏、却整个消失」。
支持矩阵与 peer 范围现在由 scripts/check-peers.mjs 在 pnpm run check 里强制对齐，两者不可能再各自漂移。

开发

宿主半程是纯 ESM（lib/index.js，lib/typert.js 经 dsh-typert-loader 自动注册，无需构建）。客户端半程必须构建：DSH 浏览器运行时把每个插件的 ./client 导出当作经典脚本加载，要求它通过
window.__ModuleLoader__.load({ id, factory }) 注册 CJS 工厂——裸 ESM
会导致页面启动失败。源码在 client/src/，发布产物是 client/client.js（zod 内联打包；react / jsx-runtime / primitives 走平台种子模块外部化）。

pnpm run build:client # 生成 client/client.js（含冒烟测试）
pnpm run check # 构建 + 宿主守卫 + peer 支持矩阵守卫（CI 跑的就是它）

构建脚本自带三段式冒烟测试，任何一段失败都会让构建（以及 CI、prepack）失败：

1. 物化：产物必须注册 window.__ModuleLoader__.load({id, factory}) 工厂并导出 apply/inject；
2. 激活：在 mock 的客户端 Context 上真正跑一遍 apply——校验 settings.section 注册、每个远程 codec 都带 create() 工厂、样式表标签满足 data-plugin/data-plugin-css 契约；
3. 渲染：对 4 个页面状态 × 3 代 primitives 种子（尺寸名 / 笔画名 0.1.7-rc.2 / 笔画名 0.2.0-rc.2）各渲染一遍并遍历结果树，任何元素类型为 undefined 立即失败——这正是 primitives 导出改名在浏览器里的症状（整页空白）。种子导出表还会与已安装的 @deepseek-ai/dsh-client-ui-primitives 真实导出表交叉比对。

改完客户端源码后需重新构建并重装（file: 安装时 pnpm 会重新复制包）。

客户端组合所需的官方包在 package.json 的 dsh.client.inject 中声明。

架构与设计决策

见 DESIGN.md：核心归档机制的现状分析、删除顺序（flush → detach → 删文件 → registry 清理）、实时同步链路、风险与取舍。

社区与发布

- 问题与功能建议：在 Issues 提交（Bug 模板 / 功能模板）。
- 参与开发：CONTRIBUTING.md；行为准则： CODE_OF_CONDUCT.md；安全漏洞请走 SECURITY.md 的私有报告渠道。
- 发布 npm：pnpm publish。prepack 钩子会自动重新构建客户端产物并做宿主语法检查，保证发布的 tarball 永远包含最新 client/client.js。
CI 同时校验产物与源码一致。
- 上架插件市场：向 awesome-dsh-plugin 提 PR 添加一条条目（dshmarket 等市场自动收录）。目录会校验 npm 包的 repository 字段与条目仓库一致（防冒名）。

License

MIT