前言¶
在 DSH 的插件扩展方式中，社区插件可以补充本地工作流。@danglong0313/dsh-history-sync 解决的是一个比较具体的问题：把本机 Codex 与 Claude Code 中已经发生的历史任务，以只读镜像的形式单向导入 DeepSeek Harness（DSH）。
它不是双向同步工具，也不负责从 DSH 恢复 Codex 或 Claude 的模型、工具进程、审批、沙箱或运行状态。
这是什么¶
- 插件名：
@danglong0313/dsh-history-sync - 发布方：
danglong0313 - 许可证：MIT
- 定位：把本机 Codex 与 Claude Code 的用户/助手对话，单向、只读镜像到 DSH。
- 边界：不写回来源；不是双向同步；不能无损恢复上游运行状态。
核心能力¶
下面列出的都是插件已核实的能力：
1、单向只读导入 Codex 与 Claude Code 的用户/助手对话，不写回来源。
2、默认采用保守策略：默认预览、默认不自动同步、默认只扫描最近 30 天。
3、可以在 设置 → 插件 → 插件配置 → History Sync 中直接配置和启用自动同步。
4、自动按原工作目录创建或复用 DSH Workspace，并在左侧项目栏分组显示。
5、使用内容指纹、追加水位和 generation 处理重复同步、增量追加及上游历史重写。
6、过滤 system/developer、reasoning、工具调用、审批、命令输出和 Claude 控制标签，避免把协议消息当作真实聊天。
安装与启用¶
以 desktop profile 为例，先执行安装命令，再查看当前 profile 的配置状态：
dsh plugin --profile desktop add @danglong0313/dsh-history-sync@0.2.0
dsh --profile desktop --dump-config
第一条命令将插件安装到 desktop profile，第二条命令用于查看该 profile 的配置状态。
安装后启动 DSH，进入：
设置 → 插件 → 插件配置 → History Sync
这里可以直接配置插件，并在需要时启用自动同步。由于插件默认不自动同步，建议先完成预览，确认导入范围后再开启实际导入或自动同步。
典型用法¶
在任意 DSH 任务中执行预览：
/history-sync preview
确认范围后，在 History Sync 配置卡中开启“允许实际导入”，再执行：
/history-sync run
不带参数的 /history-sync 等同于预览。
如果后续希望插件自动处理新增历史，可以在 History Sync 配置卡中启用自动同步。自动同步默认关闭。
适用场景与注意¶
这个插件适合希望在 DSH 中查看已有 Codex 或 Claude Code 对话历史的开发者。它的核心限制是：这是一份历史镜像，不是可恢复的上游运行环境。
启用前需要注意以下几点：
- 导入会在 DSH 持久化中产生第二份历史副本。
- 原任务可能包含源码、命令输出、
.env内容、凭据或其他敏感信息。 - 删除 Codex/Claude 原任务不会自动删除 DSH 副本，反之亦然。
- v1 中
readOnly必须为true；previewOnly为true时拒绝实际导入。 - DSH 仍处于预发布阶段，Session 格式不保证跨预发布版本兼容；已验证 DSH 为
0.1.0-rc.6。 - 插件以当前
dsh进程权限运行，安装前应检查源码、依赖和 MIT 许可证。
结尾¶
@danglong0313/dsh-history-sync 的价值在于：在默认预览、默认只读、默认不自动同步的前提下，把本机 Codex 与 Claude Code 的历史对话单向导入 DSH，并在项目栏中按原工作目录分组显示。
- GitHub：dsh-history-sync
- 目录页：已核实资料未提供可用目录页，建议以 GitHub 仓库为准。
