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）：

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。

兼容性

同一份产物在两条线上都能渲染与调用：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