dsh-archive-replica
通过您已有的文件同步工具在不同机器间复制 DeepSeek Harness Session 归档集
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-archive-replica@0.1.6通过您已有的文件同步工具进行复制的文件夹，在不同机器间复制 DeepSeek Harness Session 归档集
Archive Replica 以 dsh-archive-replica 发布，当前版本为 0.1.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 DeepSeek Harness（dsh）的会话归档状态在多台机器之间同步。
English · README.en.md
dsh 的会话归档状态不在会话日志里：
| 数据 | 位置 | 随网盘同步？ |
|---|---|---|
| 会话内容 | ~/.dsh/sessions/ | ✅（软链到同步目录时） |
归档集合 archivedSessionIds | $DSH_HOME/storages/workspace.json | ❌ 只在本机 |
于是 A 机归档一个会话后，B 机（会话日志已经同步过去）里它照旧显示——归档状态没有任何可同步的载体。
本插件补上的就是复制这一件事：每台机器把本机归档集合写成共享目录里的一份文档，所有机器读取时取并集。
取消归档不归本插件管：dsh 自己已经有这个能力（workspaceRegistry.unarchiveSession，侧栏筛选「全部对话（显示已归档）」里也有取消归档入口），
所以把会话取回来是在本机做的一次操作，不跨机传播——哪台机器想让它重新出现，就在那台机器上取消归档。
前置：多台机器通过同一个文件同步工具（坚果云 / Dropbox / Syncthing…）共享一个目录，并且各自的 ~/.dsh/sessions 也指向同步目录（会话日志才会跨机）。
共享目录必须落在同步工具的已注册同步范围内——坚果云这类工具的挂载根下新建目录默认不同步。
本包是可安装的 DSH 组合包（package.json 声明 dsh.bundle.patch）：安装进 profile 后，插件行由包自己携带，不再需要外置安装脚本。
dsh plugin --profile web add dsh-archive-replica # 装进 web profile（包名即参数）
首次使用会初始化 profile，并把本包追加进它的组合包层。装完还要启用它——组合包层里的插件行默认禁用（原因见下节「配置」），它需要你给出共享目录与本机 id。重启 dsh 即生效。
沿用旧版外置副本（@local/dsh-archive-replica ＋ install-archive-replica.sh）的机器：删掉外置副本的启用行（id archive-replica-external）与 ~/.dsh/plugins/archive-replica、~/.dsh/profiles/node_modules/@local/dsh-archive-replica 软链，改用上面「配置」一节里的那一行即可；数据文件 archive-<machineId>.json 不动。要迁回外置副本（例如机器装不上 pnpm）：git clone 本仓库后 bash install.sh --enable --vault <共享目录> --machine <本机 id>，或 npm i -g dsh-archive-replica 后用 dsh-archive-replica-install --check 自检——这两条路与本包各自独立，不要同时启用。
组合包自带这一行（cordis.patch.yml，默认 disabled: true），启用 = 在自己的 profile patch 里按 id 覆盖它。归档集合同步离开用户配置就没有合理默认值——默认启用只会得到一个"看起来配好了、其实什么都没复制"的插件，所以这行必须由你写成实际值：
# ~/.dsh/profiles/<profile>/cordis.patch.yml
- id: archive-replica
disabled: false
config:
directory: '/共享目录/绝对路径' # 必填，且必须已存在（落在网盘「已注册同步范围」内）
machineId: desktop # 必填，每台机器必须不同；纯数字也要加引号
# watch: true # 是否持续扫描共享目录（默认 true）
# pollIntervalMs: 2000 # 扫描间隔，毫秒（默认 2000）
directory：所有机器共享、且被网盘复制的目录（必填，且必须已存在）machineId：本机唯一标识，用于命名本机的文档；每台机器必须不同。
⚠️ 多台机器 hostname 相同是常事 —— 别照抄 desktop 这类文档占位符；插件会在发布文档里记下本机指纹，一旦发现"同名文档来自另一台机器"就会告警config 整体，不是深合并：改了 directory 就得把 machineId 一起写上在侧栏把筛选切到「全部对话（显示已归档）」或「仅显示已归档」，对着那一行点「取消归档」即可；
核心接口就是 workspaceRegistry.unarchiveSession(id)，会把它从注册表全局归档集合里删掉，会话回到原来的位置。
unarchiveSession，从不从自己的文档里删 id。WorkspaceActiveSessionError）：插件不打断本机正在跑的回合，而是跳过它、
在日志里报一次，之后每次扫描重试——工作停下来之后它会自己归档进来。unarchived-<machineId>.json 撤销清单已不再被读取，可以删掉（见 CHANGELOG 0.1.6）。共享目录里每台机器写一份文件，单写者：
| 文件 | 内容 |
|---|---|
archive-<machineId>.json | 本机的归档集合 |
读取时对整个目录取并集，逐个交给 dsh 自己的 workspace/archiveSession 归档（插件从不直接写注册表）。
文件按内容识别而非文件名，所以网盘产生的冲突副本会被自然并入，写了一半或不相干的 JSON 被忽略。
插件用扫描循环（默认 2s）读目录，不依赖文件系统通知——网盘挂载点上的通知本就不可靠。
本机新归档一个会话时，注册表的 domain/changed 事件会立刻触发一次发布（约 1 秒内），不用等下一次扫描。
pinnedSessionIds）都不在同步范围内；machineId 就无法正常工作：它们写同一份文档、互相覆盖归档集合。插件与安装脚本都会检测并报错（依据是文档里的机器指纹），但 machineId 仍要你自己保证唯一。源码是 TypeScript，由 dsh 的 tsx 启动器直接加载；插件只依赖 Node 内建能力与宿主提供的 @deepseek-ai/* 包，不依赖任何第三方运行时包（这也是它能装在 dsh 源码目录之外的原因）。
npx vitest run # 38 tests：vault / replica / 失败路径 / 插件行 / 指纹
npx tsc --noEmit # 全部源码与测试的类型检查
唯一的例外是 tests/loader-composition.spec.ts——真实 Loader + Include + 真实 workspace 注册表的组合守卫，
它按相对路径 import dsh 源码树里的 workspace/src 与 storage-domain/tests，只能在 dsh 源码树里跑：
cd /path/to/deepseek-harness
pnpm exec vitest run packages/workspace/archive-replica/ # 含组合守卫
其余测试所需的 @deepseek-ai/* 就是宿主 dsh 自带的那几个包：在仓库根建 node_modules/@deepseek-ai/
把它们软链进来即可（node_modules/ 已在 .gitignore 里）。
lib/index.js 是发布用的构建产物（esbuild 打的单文件 ESM bundle；@deepseek-ai/* 保持外部引用，运行时由宿主的 dsh 提供）。
改了 src/ 之后要重新构建并随提交更新 lib/：
npx esbuild src/index.ts --bundle --format=esm --platform=node --target=node22 \
--external:@deepseek-ai/\* --outfile=lib/index.js
（在 dsh 源码树里也可以用 pnpm exec esbuild，两者产物一致。）
docs/cross-machine-sync.zh.md —— 原理、安装、配置与排障CHANGELOG.md —— 版本历史与修复记录PUBLISH.md —— 维护者发布流程（GitHub / npm）