本地优先、无API Key、秘密脱敏:backpass如何保证你的AI会话数据不外泄

原创2026-10-12 14:09:501,887 阅读

本地优先、无API Key、秘密脱敏:backpass如何保证你的AI会话数据不外泄

你是否担心 AI 编程助手积累的会话记录(transcript)会泄露项目机密?backpass 是一个本地优先(local-first)的记忆训练工具:它直接从磁盘读取你在 Claude Code、Codex、Pi、OpenCode、Grok、Cursor CLI、Hermes 中已产生的会话记录,通过梯度下降式的小步编辑持续改进 AGENTS.md / CLAUDE.md 与项目技能,全程无需 API Key、不上传数据,并自动对密钥与令牌做秘密脱敏(secret redaction),让 AI 会话数据始终留在你自己的机器上。

backpass 是什么:给 AI 记忆做"本地训练"

一句话理解:backpass 把你已经跑过的 AI 会话当成"损失信号",从中提炼出证据,再提出对记忆文件的微小、可审查的修改。整个训练闭环长这样:

AGENTS.md / CLAUDE.md + skills(权重)
  → agent session(前向传播)
  → 磁盘上的 transcript(损失信号)
  → backpass: 采集样本 → 蒸馏 → 计算损失 → 聚合梯度
  → backpass: 梯度下降(diff + 技能抽取)
  → 你接受或拒绝(人类闸门)
  → 回到权重

关键点在于:数据源全部是本地文件。backpass 不需要你把任何东西发到它的服务器,因为它根本没有服务器。

数据流向:只读磁盘,永不上传

backpass 对七类 agent 会话存储是直接读磁盘的,例如:

Harness 存储位置(示例)
claude ~/.claude/projects/<munged-cwd>/<uuid>.jsonl
codex ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
opencode ~/.local/share/opencode/opencode.db(sqlite)
grok ~/.grok/sessions/<encoded-cwd>/<uuid>/
cursor CLI ~/.cursor/chats/<md5(cwd)>/<uuid>/
hermes ~/.hermes/state.db(sqlite)

源码中把这个原则写成了一句硬约束(src/acpx.js):

backpass owns no API keys. Every model call goes through acpx to a harness the user has already authenticated.

也就是说:

  • 不经过任何 backpass 服务器:没有上传、没有中间代理,transcript 的读取发生在你的机器上;
  • 不持有凭证:backpass 自己没有任何 API Key 存储,它无法替你去任何模型服务商消费,也"不可能"成为你没要求过的账单或服务;
  • 模型调用复用你已有的登录态:分析调用走你本机已经安装并登录的 agent 工具(如 codex、claude、pi、opencode),认证关系完全沿用你原来的信任边界。

如果你希望把自己其他机器上的会话也纳入语料,backpass 走你本机的 ssh 连接(src/discovery/hosts.js):远端不安装任何东西,只在远端执行一次性 Node 探测程序并拉取已关联且被采样的会话副本,缓存到本地状态目录,30 天未使用即清理。数据仍然只在你自己的机器之间流动。

无 API Key 设计:为什么这本身就是安全边界

大多数 AI 工具需要你填一个 Key 才能工作,而 backpass 反其道而行:它没有任何自己的 Key。这带来三层安全收益:

  1. 没有"中心账单":每次模型调用都通过 acpx 转发到你已经登录的 harness,用的是你既有的订阅或认证,不会多出一笔你没申请的开销;
  2. 爆炸半径被隔离:所有模型调用逻辑收敛在一个模块里,上游 acpx 的 CLI 变化只影响这一处,不会扩散到其他代码路径;
  3. 候选梯子自动选择:backpass 内置"候选梯子"(src/config.js 的 DEFAULT_LADDERS),按"已安装 → 已登录 → 能提供服务"的顺序自动探测可用模型,你用哪个账号训练,取决于你自己的登录状态,而不是工具替你注册的服务。
npm install -g backpass
cd your-repo
backpass init    # 生成 .backpassrc.json,并把 .backpass/ 加入 .git/info/exclude
backpass         # 分析,永不写文件

秘密脱敏:密钥、令牌、私钥在出机前被抹掉

这是隐私设计中最容易被忽视的一环:即便数据只发给你"已登录"的模型,transcript 里也可能包含你在终端里敲过的密钥。backpass 在蒸馏阶段(任何模型看到内容之前)执行确定性脱敏,实现在 src/redact.js:

识别目标 脱敏结果示例
GITHUB_TOKEN=ghp_... 形式的赋值 GITHUB_TOKEN=[redacted]
Anthropic / OpenAI / OpenRouter 风格的 sk- Key [redacted:ANTHROPIC_KEY]
GitHub ghp_/gho_/... 令牌 [redacted:GITHUB_TOKEN]
Slack xox...、AWS AKIA...、JWT、私钥块 [redacted:SLACK_TOKEN] 等
PASSWORD / SECRET / ACCESS_KEY 等任意 KEY=value 赋值(含引号值) password=[redacted]

脱敏同时作用于消息正文、工具调用输入与输出(src/distill.js),并且非常小心地不误伤普通参数——比如 max_output_tokens:12000,yield_time_ms:1000 这种良性赋值不会被脱敏(见 test/distill.test.js 的测试用例)。

值得注意的是,backpass 对脱敏的定位很诚实:这是一张粗网(coarse net),能抓住常见令牌格式与 shell 中的 KEY=value 赋值,但不承诺识别所有秘密。配合蒸馏阶段的截断(工具输入 160 字符、输出 200 字符、消息 6000 字符,src/distill.js),到达模型的上下文本身就大幅缩减了敏感面。

文件系统权限:状态目录"默认不共享"

数据不外泄不只靠网络层,磁盘上的权限同样被管住:

  • 用户级状态目录(~/.config/backpass/user/)以 0700 创建,其他用户不可读(src/state.js、src/commands/init.js);
  • 远端会话缓存(.backpass/hosts/)同样 0700,条目文件名是 (host, harness, key) 的 SHA-256 哈希——远端路径属于不可信输入,绝不允许它把文件写出去(src/discovery/cache.js);
  • 临时原始事件文件以 0600 写入,且在调用结束或进程可捕获退出(含 SIGINT/SIGTERM)时删除(src/analyze.js);
  • 项目级状态 .backpass/ 通过仓库本地排除文件 .git/info/exclude 挡在 git 之外(而不是提交到 .gitignore),分析产物不会随代码一起被推送。

在 Windows 上由于没有 POSIX 权限位,backpass 会检查状态目录是否位于用户 profile 之内,若被重定向到同步盘/网络盘会明确警告"隐私无法在此验证",而不是假装通过。

SSH 采集:不自动信任任何主机

当你启用跨机器采集时,src/discovery/remote/ssh.js 是唯一的 ssh 边界,设计上有几个"不妥协":

  • BatchMode=yes:需要密码输入的主机直接判定失败并命名原因,而不是挂起或偷偷回退;
  • 主机密钥永不自动接受:未知或变更的 host key 只报告"请人工核实",永远不会建议 StrictHostKeyChecking=no;
  • 主机名是个人配置:.backpassrc.json 出现在仓库里是共享文件,若其中写了 discovery.hosts,backpass 直接拒绝加载(src/config.js 的 refuseRepoPersonalSettings)——提交进仓库的配置永远无法把别人的 backpass 指向某台机器,"读取他人会话"这条路被从源头封死;
  • 所有 ssh 目标参数做注入防御:以 - 开头或包含引号、反斜杠、换行的值一律拒绝(assertSafeSshValue)。

每台主机失败都是"fail-soft + 命名":一台睡了的笔记本只会变成 backpass scan 里的一行记录,不会拖垮整次运行。

本地审查界面:review 页面不连网

最后的写入闸门 backpass apply 默认在浏览器打开一个审查界面,但它是纯静态模板:包内携带 templates/apply.html,CLI 只注入一份本地 JSON,渲染即时、确定、每次一致,"没有任何模型生成的内容"。没有本地服务、没有外发请求,无浏览器环境下 --no-open 只会把本地 URL 打印给你。每条编辑的 diff、证据引文、预算仪表都在这一个离线页面里完成 ACCEPT / REJECT。

隐私设计小结:四条边界一次说清

关注点 backpass 的做法 对应实现
数据去哪 只读本机(或你 SSH 信任的机器)磁盘,无上传 src/acpx.js、src/discovery/index.js
用什么调模型 复用你已登录的 harness,自身零 API Key src/agents.js、src/config.js
密钥会不会出机 蒸馏前正则脱敏 + 截断,粗网明示 src/redact.js、src/distill.js
磁盘上的副本 0700 / 0600 权限、哈希命名、git 本地排除、用后清理 src/state.js、src/discovery/cache.js

更根本的态度写在 VISION.md 里:跨人协作时"可共享的是派生证据,绝不共享 transcript,且绝不经过 backpass 运行的任何东西"。

常见问题(FAQ)

Q:backpass 需要配置 API Key 吗? 不需要。它没有自己的 Key,所有模型调用都经由 acpx 到你已登录的 agent harness。如果你的 harness 没登录,它只会探测失败并列出修复建议,而不是让你填一个新 Key。

Q:transcript 会离开我的机器吗? 不会上传到任何 backpass 服务。唯一离开本机磁盘的情况:你自己配置了 SSH 主机(在你机器之间),或蒸馏后脱敏过的内容发给你已认证的模型用于分析。

Q:我的 git token / 云厂商密钥会不会被分析模型看到? 会被 src/redact.js 的正则网替换成 [redacted:*] 占位符后才进入蒸馏轨迹。但请记住官方定位:这是"粗网",能覆盖常见格式,不是万能保险——对极高敏感场景,建议结合你自己的 secret 扫描流程。

Q:.backpass/ 状态目录会被误提交吗? 不会。backpass init 及每次命令都会把它写入 .git/info/exclude(仓库本地排除,不污染跟踪文件)。

Q:远端机器上的数据如何保管? 拉取的会话副本缓存在 .backpass/hosts/(0700),文件名是内容哈希,30 天未使用自动清理;backpass status 会列出每台主机的缓存状态。

总结

backpass 的隐私模型可以浓缩成三句话:数据源在本机磁盘,模型调用借你已有的登录态,敏感值在出机前被脱敏。它用"零 API Key、零服务器、零上传"的架构,把 AI 会话数据的所有权完整地留在你自己手里——这正是本地优先(local-first)工具应有的样子。如果你想给自己的 AGENTS.md 做一次有证据支撑的本地"训练",它值得进你的工具箱。

登录后查看全文
backpass