DSH 工作区管理
面向 DeepSeek Harness（DSH）的原生工作区治理插件，将已归档对话管理、删除前重要文件保护与可验证本地备份统一集成到设置界面。插件以 DSH 原生会话状态为准，并通过严格的路径边界校验、内容哈希与失败关闭机制，降低清理历史会话时误删重要产出或产生不可恢复状态的风险。
主要功能
- 原生归档管理：集中浏览、搜索和筛选 DSH 已归档对话，支持单项或批量取消归档与删除；归档状态始终以 DSH 原生记录为唯一依据，不维护平行索引。
- 重要产出保护：删除前由 DSH 当前配置的模型审核符合条件的工作区产出，将选中文件写入共享去重保留库，并以内容哈希验证副本完整性；同时支持恢复、批量移除与应用内提醒。
- 可验证本地备份：支持手动、定时及正常关闭前生成 ZIP 备份。每份备份均包含文件清单与哈希，只能恢复到空目录且不会覆盖现有文件；自动备份默认关闭，默认保留最近五份已验证备份。
- 工作区与路径安全：支持跨磁盘的 DSH 已登记工作区和独立项目目录，可从原生元数据自动补齐历史映射，并拒绝通过 Junction 或符号链接越过受管路径边界。
界面预览
环境要求
| 组件 | 要求 |
|---|---|
| 操作系统 | Windows 10 或 11 |
| DSH | 已测试 0.1.1-rc.2 至 0.1.2-rc.1，其他版本尚未验证 |
| PowerShell | 5.1 或更高版本 |
| Node.js | 20 或更高版本，同时满足所安装 DSH 的要求 |
| 工作区 | 具有读写权限的文件夹，不直接使用盘符或网络共享根目录 |
安装
从 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 反馈问题，或联系 [email protected]。请提供 DSH 与插件版本、复现步骤和脱敏后的诊断信息。
本项目采用 MIT 协议。
