会话 Git 同步 PerryLink/dsh-session-sync

🔄 dsh-session-sync

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-session-sync（计入 deepseek1024.com 的安装排名）。

dshfind

DeepSeek Harness 的跨设备会话同步 —— 为你的会话存储专门建一个 git 镜像。

在设备之间同步会话，遇到冲突时两边都保留，绝不丢一轮对话。

官方仓库。 这是 dsh-session-sync 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库与本项目无关。

dsh-doctor
DSH Market

English · 简体中文 · Español · Português · हिन्दी

dsh plugin --profile <name> add dsh-session-sync

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

- git 渠道（最新的 main）：dsh plugin --profile web add github:PerryLink/dsh-session-sync（等同于从 git+https://github.com/PerryLink/dsh-session-sync.git 安装）。无需构建步骤 —— index.mjs 和 lib/ 就是发布产物。
- npm 渠道（已发布的版本）：dsh plugin --profile web add dsh-session-sync。
- tarball 渠道：在本仓库执行 pnpm pack，然后执行 dsh plugin --profile web add ./dsh-session-sync-<version>.tgz。
- 卸载：dsh plugin --profile web remove dsh-session-sync（或从配置档补丁里删掉对应行）。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（共 95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-session-sync 是什么？

为 DeepSeek Harness 提供跨设备会话同步 —— 一份专属的会话存储 git 镜像。

在设备之间同步会话，遇到冲突时两边都保留，绝不丢一轮对话。

dsh-session-sync 的工作流示意图：请求 → 策略 / 审查 → 结论。

工作流概览：请求 → 策略 / 审查 → 结论。下面的示例都用真实的命令接口。

兼容性

| 层面 | 状态 |
| Harness | DeepSeek Harness dsh-v0.2.1-alpha.1（GitHub tag，2026-09-25 验证：针对锁定的 0.1.7-rc.2 对等依赖跑通完整门禁链）。npm 依赖线 0.1.7-rc.2，对等依赖 >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0。（2026-10-04 适配）：冲突分叉通知携带插件自己的生产者侧消息来源类型 —— harness 已废弃共享的 plugin 类型，读回时会拒绝它。 |
| Node | ^22.19.0 \|\| >=24.0.0 |
| 平台 | 只要 git 和 DSH 能跑就行（基于 git 的镜像，没有平台相关代码） |
| 模型 | 完全支持纯文本模型；不需要视觉能力或额外的模型能力 |

你能得到什么

dsh-session-sync 把 DSH 会话存储镜像到一份专属的 git worktree，再同步到你自己掌控的远程仓库 —— 不用云服务，不用第三方存储：

- /sync 命令 —— status（分支、脱敏后的远程地址、领先/落后、脏文件、分叉）、diff、log、pull、push、help。
- sync_status / sync_pull / sync_push 工具 —— 同一套接口，供模型在对话轮内调用。
- 只追加的冲突处理 —— 会话日志只追加；一旦出现分歧，插件两边都保留（本地版本留着，远程版本存为分叉文件），绝不悄悄覆盖。有分歧的会话还可以在会话层面分叉。
- 自动模式 —— 启动时拉取、每轮对话结束后推送、定时拉取，全部可配置，也全部可回退。
- 写入需确认 —— pull/push 先询问（通过 userQuestions 或 approval）；只读接口从不询问；没有应答方时操作按失败关闭处理。

device A remote (your git repo) device B
$DSH_HOME/sessions ──mirror──▶ commit ──push──▶ [sessions] ──pull──▶ merge (keep-both + fork)

快速开始

dsh plugin --profile web add github:PerryLink/dsh-session-sync

1. install the bundle into your profilesh
dsh plugin --profile web add github:PerryLink/dsh-session-sync

or from npm (published releases)

dsh plugin --profile web add dsh-session-sync

2. point it at a private git remote and verify the row

dsh --profile web --dump-config | grep -A2 'id: session-sync'

然后在配置档补丁里设置远端（私有仓库是基线），再同步： yaml
- insert:
- id: session-sync
name: dsh-session-sync
config:
remote: git@github.com:you/your-dsh-sessions.git

/sync status
/sync pull
/sync push

示例

下面这些是插件的真实入口；安装一次，之后按需调用。

详细示例

命令

~~~sh
/sync help

输出

~~~text
sync: usage — /sync [status | pull | push | diff | log | help] status show mirror state (default): branch, remote, ahead/behind, dirty, forks pull fetch + merge remote changes (keep-both; confirms first) push mirror + commit + push local changes (confirms first) diff uncommitted changes + HEAD..remote stat (read-only) log last commits in the sync repository

摘自 index.mjs:754-765 (registered /sync handler)

失败分支

输入

~~~text
/sync push

输出

~~~text
sync: cancelled: approval requires an open turn; /sync commands run between turns — mount userQuestions or set confirmVia: userQuestions

摘自 plugins/dsh-session-sync/lib/gate.mjs:134-137; plugins/dsh-session-sync/index.mjs:792-794; plugins/dsh-session-sync/test/gate.test.mjs:80-88; plugins/dsh-session-sync/README.md:246

简要示例

- /sync diff
- /sync pull

配置

所有可调项都是 Schemastery 的 Config 字段（可在 cordis.yml 中修改）。按 id 定向覆盖会替换整行——需要哪些键就全部重写一遍。cordis.patch.yml 中每个键都有行内说明。

| 键 | 默认值 | 含义 |
| enabled | true | 总开关；设为 false 会注销命令、工具、监听器和自动模式 |
| backend | git | 同步后端：git（明文镜像）或 encrypted（age 加密的镜像内容） |
| sessionRoot | '' | 会话存储根目录；留空 = $DSH_HOME/sessions（两者都缺失则加载失败） |
| repoDir | '' | 同步工作树根目录；留空 = $DSH_HOME/dsh-session-sync/repo |
| remote | '' | 远端地址（pull/push 前必填；status/diff 没有也能用） |
| branch | main | 远端分支名 |
| gitBin | git | git 可执行文件路径 |
| ageBin | age | age 可执行文件路径（backend: encrypted 时会探测；缺失则降级为明文） |
| ageRecipient | '' | age 接收方（公钥或身份字符串）；留空 = 无法加密，降级为明文 |
| ageIdentity | '' | 用于解密的免口令 age 私钥路径；留空 = 无法解密，降级为明文 |
| autoPullOnStart | false | 插件挂载时拉取一次（配置即授权；不再二次确认） |
| autoPushOnTurnEnd | false | 每轮对话结束后推送 |
| pullIntervalMinutes | 0 | 每隔 N 分钟定时拉取（0 = 关闭，最大 10080） |
| confirmVia | auto | 确认渠道：auto（先 userQuestions，再 approval）、userQuestions、approval |
| graceMs | 10000 | git 终止的宽限期（ms） |
| commandTimeoutMs | 120000 | 单条命令超时（ms） |
| maxOutputBytes | 262144 | 每个输出流收集的上限（bytes） |
| commitName | dsh-session-sync | 提交作者名 |
| commitEmail | dsh-session-sync@localhost | 提交作者邮箱 |
| registerCommand | true | 注册 /sync 命令 |
| registerTools | true | 工具服务存在时注册 sync_ 工具 |

在配置档补丁里覆盖配置的示例： yaml
- insert:
- id: session-sync
name: dsh-session-sync
config:
remote: git@github.com:you/your-dsh-sessions.git
branch: main
autoPushOnTurnEnd: true
pullIntervalMinutes: 30
confirmVia: userQuestions

工具与入口

| 入口 | 只读 | 需要确认 | 说明 |
| /sync status | ✅ | — | 分支、脱敏后的远端、领先/落后、有改动的文件、分叉文件、上次拉取/推送 |
| /sync diff | ✅ | — | 未提交的改动 + HEAD..remote 统计（只读） |
| /sync log | ✅ | — | 同步仓库里最近的提交 |
| /sync pull | | ✅ | 拉取 + 合并，两边都保留；本地保留，远端内容存为分叉 |
| /sync push | | ✅ | 镜像 + 提交 + 推送；从不强制推送，被拒时先协调再重试一次 |
| sync_status | ✅ | — | 与 /sync status 相同的事实，供模型使用 |
| sync_pull | | ✅ | 模型可调用的拉取 |
| sync_push | | ✅ | 模型可调用的推送 |

权限与数据

- 权限：会改动数据的操作都要过确认关卡（confirmVia）；插件从不重新实现或绕过 harness 的 userQuestions/approval 服务。自动模式由配置授权覆盖，不再重复确认。
- 数据：同步元数据（设备 id、上次拉取/推送、上次推送 head、上次错误）存放在 session-sync 存储域。会话文件按不透明字节复制——插件从不解析它们。设备 id 还会写入同步仓库里的 device.txt，用于跨设备的分叉归属。
- 会话日志：sync/push、sync/pull、sync/conflict 在 types.d.ts 中声明；只有宿主记录了这些类型时才会追加（见已知限制）。写入或展示的内容都经过脱敏。插件写入的唯一持久消息——冲突分叉通知——带有插件自己的生产者归属来源类型（dsh-session-sync）；harness 已弃用共享的 plugin 类型，读回会话时会拒绝它。

安全边界
- 绝不静默覆盖。 只追加的三方合并遇到任何分歧都保留双方，包括删除/修改冲突（修改后的字节保留，删除意图也照办）；fork 文件永不删除，git 也绝不 force-push、reset、rebase 或切换分支。
- 路径约束。 文件按不透明字节镜像，拒绝符号链接，每个拼接后的路径都做约束检查（PATH_UNSAFE 直接报错）。
- 输出脱敏。 远程 URL 里的凭据、token 和 key=value 形式的密钥，在进入模型或日志之前一律打码；路径展示拒绝根目录之外的任何内容。
- 不存凭据。 插件不保存任何凭据；git 凭据放在你平时的 git credential helper 里。age 密钥从你配置的路径读取（ageIdentity）；密钥永不进入同步仓库。
- Git 加固。 Git 运行时带 GIT_TERMINAL_PROMPT=0 和 GIT_OPTIONAL_LOCKS=0，受截止时间和信号约束，每个输出流都有上限。
- 失败即拒绝。 缺少确认应答器、缺少远程、路径不安全，都会直接报错并拒绝操作。

加密与威胁模型

backend: encrypted 在镜像之上加一层可选的 age：会话字节先加密成 encrypted//.age 文件，再提交、推送；合并之前再解密回本地明文镜像。三方合并始终在本地明文上运行，所以只追加、双方都保留的语义不变。

加密保护什么：

- 远程端的镜像静态内容。 你推送的会话文件是 age 密文；远程主机、其运维人员，以及任何克隆仓库的人，没有私钥都看不到明文会话字节。

加密不保护什么（边界）：

- 密钥和 age 身份由你自己管理。 接收者/身份文件从不随插件发布、存储或轮换。密钥一旦泄露，它保护的镜像内容就暴露了。请使用无口令的身份文件，并把它放在仓库之外。
- 远程实际上仍是私有仓库。 git 元数据——提交信息、.gitignore、encrypted/ 路径结构、分支名、push/fetch 活动——对远程主机依然可见。加密隐藏的是内容，不是你同步这件事，也不是你会话树的形状。
- 本地仍有明文。 <repoDir>/sessions/ 下的镜像是磁盘上的明文；加密保护的是传输/远程副本，不是本地磁盘加密，也不是正在运行的会话存储。
- 优雅降级意味着明文。 用 backend: encrypted 时，如果 age 缺失，或 ageRecipient/ageIdentity 为空，插件会回退到明文 git 路径，并在状态/日志里明确警告——绝不悄悄假装已加密。在信任远程为加密之前，先看 /sync status 里的警告。
基线：使用 backend: git（默认值）时，会话字节以未加密形式存放在你的 git 远程仓库里——请使用私有仓库。

已知限制

- 对象存储后端仅占位。 object-storage 只是接口占位，加载时会直接报错；目前只实现了 git 和 encrypted。
- 依赖 git。 插件需要 git 可执行文件和 subprocess 服务；缺少它们时，同步操作会失败并给出明确原因（配置档仍能正常启动）。
- age 可选，且需外部安装。 加密依赖 PATH 上的 age 二进制（或 ageBin）。没有 age 就回退到明文，并给出警告；受口令保护的 identity 无法使用（解密会卡在 TTY 提示上，因此按失败关闭处理）。
- 每个后端一个 repoDir。 不支持在同一个 repoDir 上切换 git 和 encrypted；请为每个后端使用全新的工作树。
- 0.1.0-rc.6/0.1.0-rc.8/0.1.1-rc.2/0.1.2-alpha.2/0.1.2-alpha.3/0.1.2-rc.1/0.1.7-alpha.2 上的会话事件。 宿主不记录 sync/ 事件类型，因此会跳过会话日志追加（会话仍能加载）；一旦宿主记录这些类型，或在 Session.append 上暴露 ignorable 信封，插件就会自动启用它们。
- 轮次之间的 approval。 /sync 在轮次之间运行，此时 approval 通道没有可挂载的打开轮次；命令驱动的同步请用 confirmVia: userQuestions，或者在轮次内通过工具驱动同步。打开轮次检查读取宿主的 turnBoundary 会话投影：缺少 @deepseek-ai/dsh-session-projection 的组合无法验证轮次状态，会以该原因按失败关闭处理。
- 宿主私有产物始终留在宿主侧。 session.lock（宿主会话租约）和 session.migration..tmp 暂存文件永远不会被镜像或删除——它们是运行时状态，不是可同步内容。会话日志（session.jsonl、session.v[1-9].jsonl[.zstd]）仍是镜像的载荷。

开发 sh
pnpm install # node ^22.19 || >=24
pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs against the published 0.1.7-alpha.2 peers
pnpm test # node --test (13 test files; the engine git suite skips without git)
pnpm run verify:self-contained # dependency specs resolve from the registry
pnpm run verify:artifacts # shipped files present + index.mjs importable
pnpm run check:readmes # five-language README consistency
pnpm pack # the published tarball

没有构建步骤：纯 ESM，index.mjs 和 lib/ 就是发布的产物。

主题

dsh、dsh-plugin、deepseek-harness、deepseek、cordis、session-sync、session、git、sync、cross-device

贡献者
- @BlakrPander — PAT 当用户名用的脱敏处理，以及删除/修改 keep-both 分析（#14）；两部分都已随 0.2.27/0.2.28 发布。

- @PerryLink — 创建者兼维护者：git 镜像引擎、append-only keep-both 合并、/sync 命令与 sync_ 工具、自动模式、脱敏器，以及五种语言的文档。

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下面这份名单默认折叠，好让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

LICENSE（Apache License 2.0）© 2026 dsh-session-sync contributors