omdsh-dev/session-teleport

Plugin插件 Native原生 ⭐ 2 BSD-3-Clause Sessions & Context会话与上下文

Project Overview项目介绍

Session Teleport is a DSH plugin for multi-device session handoff. PostgreSQL is the sole online authority, enforcing single-writer semantics through writer_epoch fencing. It supports lossless JSON envelope persistence, transactional CAS appends, one-time handoff codes, idempotent retries, SSE observation, and snapshot-based import with constrained rollback. Use it to move active sessions atomically between devices. Caveat: enabling or upgrading changes session authority; stop the profile first, as it is not a hot-swap for running turns.

Session Teleport 是 DSH 多设备 Session 接力插件,PostgreSQL 作为唯一在线权威,通过 writer_epoch 凭据隔离实现单写者原子切换。支持 JSON envelope 无损保留、事务化 CAS 追加、一次性限时 handoff code、幂等重试、SSE 观察及一致快照导入回滚。适用于跨设备连续接手 Session。注意:切换会改变 Session authority,需在 profile 停止状态下操作,不可视为热替换。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:omdsh-dev/session-teleport

把 omdsh-dev/session-teleport 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

session-teleport

DeepSeek Harness 多设备 Session 接力插件。PostgreSQL 是唯一在线权威;同一时间只有一台设备持有写入凭据,移交后旧凭据立即被 writer_epoch 拒绝。

这是独立插件仓库,只分发 BSD-3-Clause 许可下的 Session Teleport 代码。 DSH peer packages 是外部依赖,保留各自许可,不在本仓库中复制、镜像或重新授权。 本包保留 private: true,避免本地发布演练误触 npm 发布;受支持的插件源是 https://github.com/omdsh-dev/session-teleport,安装时必须固定到完整 commit。

当前适配目标是 DSH 0.2.0-rc.1(2026-09-28 的 npm next 预发布版本), 严格编译基线为:@deepseek-ai/cordis@4.0.4, 以及 @deepseek-ai/dsh-session、@deepseek-ai/dsh-session-persistence、 @deepseek-ai/dsh-session-persistence-jsonl 的 0.2.0-rc.1。这些精确版本只用于 开发和验证;安装时仍由目标 DSH 环境按 peerDependencies 提供兼容版本。

新版采用 create/open → SessionHandle,支持 read/append/flush/close、 stat/list 和空会话持久化。0.7.0-rc.1 插件与 authority 服务应一起升级: 数据库自动迁移到 schema 5,保留 fork 的 inheritedEventCount。 已有旧格式日志不会被自动改写成 format 4;应先通过兼容源后端迁移、读取并导出。 直接保存的旧 Teleport 日志仍可归档,但新版 adapter 会拒绝打开非 format 4 日志。 同一设备的所有 profile 必须共用 writer credential 目录;本地文件锁防止重复写者, 跨设备交接由 PostgreSQL epoch fencing 保证。当前文件锁路径面向 macOS/Linux。

能做什么

  • 原样保存 JSON event envelope,包括扩展字段。
  • 在单个事务中校验 writer、revision、next seq 和连续事件序号。
  • 通过 idempotency key 与请求摘要安全重认“已提交但响应丢失”的重试。
  • 生成一次性、限时 handoff code;接管后旧 writer token 被 fencing。
  • 旧设备丢失时可由独立管理员凭据执行显式恢复接管,并审计每次 writer 变化。
  • 可对既有 Session 做无写入 dry-run、单事务导入和受约束的回滚切换。
  • 可从旧 DSH Profile 临时挂载只读 overlay,经 open(id, "read") / handle.read() 抓取 Session, 不必手写 TypeScript,也不解析 JSONL/SQLite 物理文件。
  • 提供计划优先的 install / upgrade / uninstall / doctor 生命周期工具; 只接受完整 commit pin,结构校验失败会恢复旧依赖。
  • 提供一致快照、增量读取与 SSE 观察端点。
  • 提供 DSH SessionPersistence / SessionHandle adapter 和 profile bundle patch。
  • 将每个 Session 的 writer credential 保存为本机 0600 原子文件。
  • 在非 loopback 监听时强制配置服务 Bearer token。

架构

DSH device A ─┐
DSH device B ─┼─ HTTP/SSE Teleport service ─ PostgreSQL
observer     ─┘

客户端不直接连接 PostgreSQL。PostgreSQL 负责事务、行锁、CAS、writer fencing 和幂等记录;SSE 只是通知通道,客户端仍从权威表读取数据。

安装插件

首次安装从目标 commit 的本地 checkout 运行生命周期工具。默认只输出计划:

node dist/plugin-cli.js install --profile web --revision <full-commit-sha>
node dist/plugin-cli.js install --profile web --revision <full-commit-sha> \
  --apply --profile-stopped --cutover-safe

目标环境需要通过其正常、受支持的软件源解析匹配版本的 @deepseek-ai peer packages。本仓库不分发这些依赖,也不要求把软件源配置或访问凭据放入仓库。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev kubemd 下一个 Next dsh-plugin →