远程访问

跨设备记忆让两台运行 sivtr 的机器像读本地 source 一样读取彼此的 workspace session。分享是显式的、只读的，并且默认脱敏。

如果想先看协作场景，见远程协作记忆。本页是功能指南。

模型

部件	含义
Device daemon	每台机器一个。由 `sivtr serve` 启动；share/remote 需要时会自动拉起。
Share	被显式暴露的本机 workspace。
Invite	单次使用、短 TTL 的邀请 key。stdout 打印 bare key。
Grant	peer 兑换 invite 后获得的权限。
Mount	当前 workspace 本地别名，成为 `origin:body` ref 的左侧。

ref 统一为一种形式：

codex/4                 # 当前本地 workspace
docs:codex/4            # 本机另一个 workspace 名
desk:terminal/...       # 已挂载的远端别名

用 sivtr wb list 查看本机 origin 标签。未登记的 origin 会报错。

所有者设置

在拥有 workspace 的机器上：

sivtr share                   # 选择 workspace（Enter = 当前），打印 invite key

非交互：

sivtr share add --name alice-desk
sivtr share invite alice-desk --expires 10m

常用所有者命令：

sivtr share list
sivtr share grants alice-desk
sivtr share revoke alice-desk <peer>
sivtr share disable alice-desk
sivtr share remove alice-desk
sivtr serve status

对端设置

在你想挂载的 git workspace 里：

sivtr remote add desk <invite-key>
sivtr remote test desk
sivtr remote list

常用对端命令：

sivtr remote rename desk bob-desk
sivtr remote remove desk          # 只删本地 mount；grant 仍在，需所有者 revoke
sivtr peer list
sivtr peer forget <peer>

使用远端记忆

挂载后的 origin 走和本地一样的 WorkSet 表面：

sivtr s desk:terminal --status failure --latest 5 --refs
sivtr s desk:agent -m "panic|failed|decision" --latest 20 --save remote_hits --refs
sivtr show desk:terminal/session_42/3/o/1 --full
sivtr zoom desk:agent/<session>/3 -C 2 --save remote_ctx --refs
sivtr filter @remote_hits -m "cargo test" --save remote_tests --refs
sivtr nav @remote_tests[1] '<[-1..+1]' --refs
sivtr copy ref desk:terminal/session_42/3/o/1 --print

安全默认

只有 sivtr share 或 share add 之后才会分享。
访问是只读的。peer 不能写 session，也不能在所有者机器上跑命令。
默认脱敏（--no-redact 可关闭）。
invite 单次使用、短寿命（默认 10m）。
daemon 之间走加密 iroh。
默认仍然本地优先：未知 origin 直接失败，不会静默扫网。

Daemon 与数据

sivtr serve start
sivtr serve status
sivtr serve logs
sivtr serve stop

状态位于 data_dir()（可用 SIVTR_DATA_DIR 覆盖，否则是平台 config 目录下的 sivtr）：

文件	用途
`identity.key`	稳定设备身份
`remote-state.db`	peers、shares、grants、invites、mounts
`daemon.json` / `daemon.lock` / `daemon.log`	运行时控制与日志

详见数据位置和 Local-first 与隐私。

命令地图

命令	用途
`sivtr share`	交互式分享 + invite
`sivtr share add\|list\|invite\|grants\|revoke...`	管理 shares
`sivtr remote add\|list\|remove\|rename\|test`	管理当前 workspace 的 mounts
`sivtr peer list\|forget`	管理已知 peer 身份
`sivtr serve ...`	管理设备 daemon
`sivtr wb list`	列出本机 workspace origin 标签

精确语法见 CLI 参考。