dsh-plugin-archived-conversations

dsh plugin --profile web add 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。

开发

宿主半程是纯 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
node --check lib/*.js            # 宿主语法检查

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

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

架构与设计决策

见 [DESIGN.md](./DESIGN.md)：核心归档机制的现状分析、删除顺序

（flush → detach → 删文件 → registry 清理）、实时同步链路、风险与取舍。

社区与发布

• 问题与功能建议：在

Issues

提交（[Bug 模板](./.github/ISSUE_TEMPLATE/bug_report.yml) /

[功能模板](./.github/ISSUE_TEMPLATE/feature_request.yml)）。

• 参与开发：[CONTRIBUTING.md](./CONTRIBUTING.md)；行为准则：

[CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)；安全漏洞请走

[SECURITY.md](./SECURITY.md) 的私有报告渠道。

• 发布 npm：pnpm publish。prepack 钩子会自动重新构建客户端产物并做

宿主语法检查，保证发布的 tarball 永远包含最新 client/client.js。

CI 同时校验产物与源码一致。

• 上架插件市场：向

awesome-dsh-plugin

提 PR 添加一条条目（dshmarket 等市场自动收录）。目录会校验 npm 包的

repository 字段与条目仓库一致（防冒名）。

License

MIT