GET CONNECTED / 设备接入

连接你的记忆。

只需要下载的守护进程和可访问 HTTPS 的网络。无需 Cloudflare 账号、Tunnel、公网 IP 或路由器端口映射。先在 Web 登录并生成配对码。

1. 下载、校验和初始化

解压对应平台的压缩包，对照 SHA256SUMS 核对下载文件；保留二进制在固定位置。当前 macOS 包未签名/公证，组织的 Gatekeeper 策略可能要求管理员批准。

chmod +x ./context-ledger
./context-ledger init --dir "$HOME/.context-ledger"
./context-ledger serve --dir "$HOME/.context-ledger"

已经有 Hub 的设备沿用原目录，不要重新初始化。服务只监听 127.0.0.1:7341。

2. 配对与本地授权

另开终端执行，将工作台地址替换为浏览器中的实际 HTTPS origin。配对码粘贴到标准输入，回车后按 Ctrl-D；不要把凭据放进命令参数。

./context-ledger pair --cloud https://YOUR-WEB-APP --dir "$HOME/.context-ledger-cloud"

配对只建立设备连接，不授权采集。已有使用者需为 Web 查看单独创建 reader 凭据；新使用者先登记获准项目，再显式导入脱敏快照。下列 JSON 均由操作者填写，不默认扫描个人历史。

project.json:
{"project":"my-project","environment":"dev","root":"/absolute/approved/project","approval":"此次登记与采集的明确授权"}

grant.json:
{"project":"my-project","environment":"dev","consumer":"my-web-account via hosted Cloudflare relay","approval":"授权此账户通过云端中转和浏览器查看此范围"}

./context-ledger request --token-file "$HOME/.context-ledger/admin.token" --method project --input project.json
./context-ledger request --token-file "$HOME/.context-ledger/admin.token" --method grant --input grant.json

将 grant 返回的 data.token 保存为仅本人可读的 reader.token（chmod 600），保留 data.id 用于撤销。管理 token 不能代替 reader。正文将按需经过托管云端和浏览器；云端不持久保存正文，但这不是端到端加密。

3. 启动连接

./context-ledger relay --dir "$HOME/.context-ledger-cloud" --token-file /absolute/private/reader.token

保持 Hub 与 relay 运行，返回工作台查看。首次没有导入来源时出现空状态是正常的。网络故障自动退避重连；撤销或替换设备后停止重连，需重新配对。Ctrl-C 停止本次进程；常驻配置参见仓库部署文档。

4. 导入获准快照

import.json:
{"project":"my-project","environment":"dev","path":"/absolute/approved/sanitized-session.jsonl","session":"native-session-id","generation":"snapshot-1","approval":"对此具体脱敏快照的采集授权"}

./context-ledger request --token-file "$HOME/.context-ledger/admin.token" --method import --input import.json

支持既有 Claude 可见文本 JSONL adapter。原始 cwd/sessionId/UUID/role 必须匹配获准项目；完整格式与更正、撤回流程见仓库 README。没有自动 hooks 安装，也没有默认个人历史采集。活动信号须通过显式 activity_report 接口提供，否则会话显示状态未知。

停止与撤销

Web「撤销设备连接」立即撤销云端设备凭据并清屏；本地 token 撤销沿用 Hub 的 revoke 接口，影响后续全部读取。已被浏览器或第三方复制的内容无法追回。若配对中断或保存失败，重新生成配对码并使用新的连接目录，避免覆盖旧凭据。