DSH 工作区管理

English · 简体中文

面向 DeepSeek Harness（DSH）的原生工作区治理插件，将已归档对话管理、删除前重要文件保护与可验证本地备份统一集成到设置界面。插件以 DSH 原生会话状态为准，并通过严格的路径边界校验、内容哈希与失败关闭机制，降低清理历史会话时误删重要产出或产生不可恢复状态的风险。

主要功能

• **原生归档管理：**集中浏览、搜索和筛选 DSH 已归档对话，支持单项或批量取消归档与删除；归档状态始终以 DSH 原生记录为唯一依据，不维护平行索引。
• **重要产出保护：**删除前由 DSH 当前配置的模型审核符合条件的工作区产出，将选中文件写入共享去重保留库，并以内容哈希验证副本完整性；同时支持恢复、批量移除与应用内提醒。
• **可验证本地备份：**支持手动、定时及正常关闭前生成 ZIP 备份。每份备份均包含文件清单与哈希，只能恢复到空目录且不会覆盖现有文件；自动备份默认关闭，默认保留最近五份已验证备份。
• **工作区与路径安全：**支持跨磁盘的 DSH 已登记工作区和独立项目目录，可从原生元数据自动补齐历史映射，并拒绝通过 Junction 或符号链接越过受管路径边界。

界面预览

环境要求

安装

从 GitHub 安装

dsh plugin --profile web add github:yxv1203-collab/dsh-conversation-archive#v1.1.0

重启 DSH，打开“设置 → 工作区管理”。

从发布包安装

从 GitHub Releases 下载 dsh-conversation-archive-1.1.0.tgz 及其 .sha256 文件。

Get-FileHash .\dsh-conversation-archive-1.1.0.tgz -Algorithm SHA256
Get-Content .\dsh-conversation-archive-1.1.0.tgz.sha256

确认哈希一致。离线安装时，先把发布包复制到 profile 的持久依赖目录，再安装这份保留副本：

$profileDeps = Join-Path $env:DSH_HOME 'profiles\web\deps'
New-Item -ItemType Directory -Force $profileDeps | Out-Null
$profilePackage = Join-Path $profileDeps 'dsh-conversation-archive-1.1.0.tgz'
Copy-Item .\dsh-conversation-archive-1.1.0.tgz $profilePackage
dsh plugin --profile web add $profilePackage

只要 profile 仍采用文件依赖，就必须保留该 .tgz，不要删除或移动；否则 pnpm 在后续安装其他插件、重新解析全部依赖时会失败。使用上面的 GitHub 标签安装则不会依赖临时下载路径。

删除与数据保护

取消归档与删除是独立操作。删除流程先校验会话归属和路径，再扫描符合条件的产出，交由 DSH 配置的模型审核内容；保留副本通过校验后，才回收会话数据。候选文件内容可能发送给 DSH 配置的模型服务商。

原始项目目录和源码文件不属于删除目标。审核、复制、完整性或路径校验失败时，保护性删除流程会停止。AI 保留是选择性保护，不能替代完整项目备份。

在已支持的 DSH 版本中，会话数据回收后暂时保留归档标记；下次正常启动时解除工作区引用并完成删除，避免对话重新出现在活动列表。

工作区与元数据

元数据未登记表示原生归档会话尚无有效的插件工作区映射。插件在启动和归档同步时，从 DSH 会话元数据自动回填映射。若提示持续出现，请检查工作区是否可访问、会话元数据是否可读取；完整的工作区产出保护和备份需要有效映射。

原生会话路径不受共享存储根目录限制。插件首次使用时可从规范的日常工作区识别共享根目录，并记录该位置供后续启动使用。已有映射和保留文件不会自动迁移。显式设置的 harnessRoot、DCA_HARNESS_ROOT 或 DSH_HARNESS_ROOT 优先。

恢复保留文件到原位置时，目标须属于可识别的 DSH 工作区；否则请选择其他恢复目录。恢复不会覆盖已有文件，并拒绝通过 Junction 或符号链接越界的路径。

备份范围

备份包含已登记的 DSH 会话数据和保留文件，不包含完整源码仓库。目标可选本地文件夹或受支持的网络路径；最新备份验证通过后，才会回收超出保留数量的旧备份。网络可用性、目录权限及回收站支持取决于目标位置。

插件不直接连接云盘账号，可由外部同步软件同步备份文件夹。提醒仅在 DSH 内显示，不发送 Windows 系统通知。

卸载

dsh plugin --profile web remove dsh-conversation-archive

卸载后重启 DSH。已有保留文件和备份不会被删除。

开发与测试

本机安装兼容版本的 DSH 后执行：

npm test
npm pack --dry-run --json
npm pack

测试覆盖归档同步、历史元数据回填、跨盘路径规则、文件保留、备份、删除恢复及发布完整性。

反馈与协议

通过 GitHub Issues 反馈问题，或联系 yxv1203@gmail.com。请提供 DSH 与插件版本、复现步骤和脱敏后的诊断信息。

本项目采用 MIT 协议。