omdsh-dev/session-teleport
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 停止状态下操作,不可视为热替换。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:session-teleport(omdsh-dev/session-teleport)
仓库:https://github.com/omdsh-dev/session-teleport
本站详情页:https://www.yhbd.top/plugins/omdsh-dev-session-teleport/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 BSD-3-Clause · ⭐ 2 · 最近提交 2026-09-28 · 主语言 TypeScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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/SessionHandleadapter 和 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 →
liangmianya/dsh-synapse
alaliqing/claude-paper
acryldev/acryl
omdsh-dev/dsh-annotation
Anionex/dsh-turn-rewind
Tyan66666/billion-context-dsh
qkycir-123/dsh-run2skill