bHorse/dsh-session-sync

README 摘要

dsh-session-sync 中文 English DeepSeek Harness(DSH)会话跨设备同步插件:把本机产生的每一个会话镜像到中心 PostgreSQL 数据库 ,并按照可配置的间隔把其他设备上的会话拉回本机。换一台 电脑也能继续看到、恢复之前的所有对话。 核心痛点 :DSH 默认把会话存成 /.dsh/sessions/... 下的本地文件,换一台 电脑就"找不到"了。本插件在不动本地存储的前提下,加一层双向同步,让会话 跟着你走。 功能特性 - 双向同步 :本机会话定时推送到中心数据库;远端会话定时拉回本机。 - 增量传输 :只同步游标(seq)之后的新事件,不重复传输整段会话。 - 最后写入胜出(LWW) :同一事件在多台设备同时修改时,以 updated at 较新者为准,不会静默丢失数据。 - 显式工作区绑定 :远端工作区在本地 必须手动绑定目录 才会被拉取, 绝不把别人的路径自动绑到你机器上的任意目录。 - 崩溃安全 :本地状态文件原子写入(写临时文件 → fsync → 改名);同步游标 只在事务提交后前进;进程中途被杀不会产生半成品数据。 - 完全惰性 : enabled: false 时不连接数据库、不调度定时器、不订阅任何事件。 交付形态:常规 npm 包(不是动态插件) 本插件以 常规 npm 包 方式加载到 profile 的 cordis.yml (与 @deepseek-ai/dsh-session 、 @deepseek-ai/dsh-llm 等内置插件同级), 不是 动态的 cordis define / cordis run 插件。 为什么 :动态 Cordis 插件的 Host 沙盒只暴露 ctx 、 harness 、 console 、 btoa / atob 、 TextEncoder / TextDecoder (已通过 Builtin.listBuiltins 验证)。它无法 import pg 驱动、无法读取 process.env 、无法使用 node:fs —— 而这三者正是本插件的硬依赖(Postgres 连接、 DSH HOME 解析、 state.json 原子写入)。常规包插件拥有完整的 Node 能力,所以本插件必须 以此形态交付。 安装 1. 打包 2. 安装到 DSH profile 3. 注册插件行 在 /.dsh/profiles/ /cordis.patch.yml 中加入: 重启 DSH 后生效。 enabled: false (默认值)时插件完全惰性:不连接数据库、不调度定时器、 不订阅事件。 配置项说明 配置项 类型 默认值 说明 enabled boolean false 是否启用; false 时插件完全惰性 pgHost string 无 Postgres…

分类