前言¶
DeepSeek Harness (DSH) 的理念是“一切皆插件”。在本地环境中,会话归档的整理、重要输出的防误删以及本地备份的完整性验证,通常需要额外的脚本或手动操作,存在一定的风险。dsh-conversation-archive 插件将归档管理、输出保留和本地备份功能原生集成到了 DSH 的设置界面中,旨在让 DSH 成为会话状态的唯一事实来源,并通过严格的路径验证和哈希校验降低清理风险。
核心功能¶
该插件由 yxv1203-collab 维护,采用 MIT 许可证,主要提供以下能力:
- 原生归档管理:直接在 DSH 界面中浏览、搜索、筛选已归档的会话,支持恢复或批量删除。归档状态始终由 DSH 同步,而非依赖插件维护的独立索引。
- 受保护输出保留:在删除会话前,插件会调用配置的 DSH 模型审查符合条件的输出。选中的文件会被复制到共享库并经过内容哈希验证,防止误删重要数据。
- 经核实的本地备份:支持手动创建 ZIP 备份,或按计划、在关机前自动备份。每个备份包含清单和哈希校验,默认保留 5 个已核实的备份,自动备份功能默认关闭。
- 工作区与路径安全:支持跨驱动器的 DSH 注册工作区。插件会回填历史元数据,并拒绝通过链接或符号链接遍历,确保路径安全。
安装与启用¶
使用官方安装命令将插件添加到 Web 配置文件中:
dsh plugin --profile web add github:yxv1203-collab/dsh-conversation-archive#v1.1.0
安装完成后,重启 DSH,然后在 Settings → Workspace Manager 中即可看到相关功能入口。
典型用法¶
在安装前,通常建议验证安装包的完整性。下载 dsh-conversation-archive-1.1.0.tgz 后,可以使用以下 PowerShell 命令计算哈希值:
Get-FileHash .\dsh-conversation-archive-1.1.0.tgz -Algorithm SHA256
需要移除插件时,使用:
dsh plugin --profile web remove dsh-conversation-archive
适用场景与注意¶
- 环境要求:插件需要 Windows 10 或 11、PowerShell 5.1+、Node.js 20+ 环境。DSH 版本需在
0.1.1-rc.2至0.1.2-rc.1之间测试通过。 - 备份范围:备份仅涵盖注册的 DSH 会话数据和保留文件,不包含整个源代码仓库。
- 恢复策略:文件恢复仅能进入空目标位置,绝不会覆盖现有文件。
- 数据留存:移除插件后,已保留的文件和备份依然存在,不会随之删除。