返回资讯中心
外部精选
软件工程
#开发者实时流

swapback:本地代理在提示词发送前替换姓名邮箱电话,回复时还原

来源标题:Keeping names, emails and phone numbers out of LLM prompts with a local proxy

swapback 是一个本地代理工具,在提示词发往 LLM 供应商前把姓名、邮箱、电话和密钥替换为占位符,收到回复后再还原。代理默认监听 127.0.0.1:8787,客户端只需改 base_url 即可接入。用户可通过 known.yaml 配置需保护的敏感信息,也可从 vcf 联系人文件导入。

Hacker News 最新rohitmishra12782026/11/12 · 6 天前11 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

你的数据始终属于你。一个本地代理,在 prompt 到达 LLM 提供商之前,把姓名、邮箱、电话和密钥替换成占位符,并在回复中还原。

pip install swapback swapback demo swapback init && swapback-proxy

需要 Python 3.11 或更新版本。swapback demo 用编造的数据运行一个假模型:无需密钥,无需网络。代理监听 127.0.0.1:8787;把你的客户端指向它,其他什么都不用改:

from openai import OpenAI client = OpenAI( base_url="http://127.0.0.1:8787/v1")

为真实提供商配置

swapback init 会生成 swapback.yaml 和 known.yaml。把绝不能到达提供商的姓名、邮箱、电话和 ID 放进 known.yaml(也可以用 swapback known init --vcf contacts.vcf 从通讯录导出文件生成),在 swapback.yaml 中设置 upstream:,运行 swapback check-config,然后启动 swapback-proxy。完整步骤(包括 OpenRouter 和 Anthropic 的 base URL)见指南。

OpenClaw:已用一个 provider 块做过端到端测试(2026.10.7);它的 exec、web_fetch、web_search、browser 和 message 工具默认保留占位符。配置。

Hermes Agent:每天运行在维护者自己的 Hermes agent 前面,处理真实的邮件和日历流量。

任何 OpenAI 兼容客户端:OpenAI Chat Completions 和 Responses(官方 SDK、OpenRouter、LiteLLM 客户端)。设置 base URL,其他什么都不用改。

Anthropic Messages:Anthropic SDK,普通和流式,包括 tool_use。

Claude Code 和 code CLI 的工具策略配方:框架配方。

工作原理

flowchart LR A["你的应用或 agent"] -- "Email Jane Q Doe" --> S["swapback (127.0.0.1:8787)"] S -- "Email «PERSON_1»" --> P["LLM 提供商"] P -- "Hi «PERSON_1» ..." --> S S -- "Hi Jane Q Doe ..." --> A Loading

替换。你列表中的值会按常见写法匹配(大小写、分隔符、转义、嵌套 JSON);检测器会捕获你未列出的电话、邮箱、卡号、IBAN 和 API 密钥。每一项都会变成一个带类型的占位符。

检查。出口复检会再次扫描发出的请求。如果列表中任何内容仍然存在,或者清洗失败,请求会被阻断(503)。它是失败关闭的。

还原。回复中的占位符会按字节精确还原,普通回复、流式回复以及工具调用参数中都会还原。网络、shell 和发送类工具调用会保留占位符,除非你允许该工具,因此被 prompt 注入的 web_fetch 无法把你的邮箱带出去。

无需下载模型,也没有任何概率性成分:精确匹配加模式匹配,约 5,900 行 Python,3 个依赖。你可以用 swapback selftest 自行重新运行泄漏测试(编造数据,7 条请求路径,约 12 秒)。

主题 位置 为什么用 swapback、配置、agent、工具调用、配置项、hooks docs/guide.md 它捕获不到什么,以及安全说明 docs/limits.md 泄漏测试、性能、检测得分 docs/testing.md 与 PasteGuard、Maskit、Veil、piighost 和 Kiji 的对比 docs/comparison.md 各版本的变更 CHANGELOG.md 报告漏洞 SECURITY.md

项目事实:Python 3.11+,约 5,900 行(302 KB),3 个依赖(PyYAML、phonenumbers、pyahocorasick),stdlib HTTP 服务器,MIT。

pip install -e ".[test]" pytest -q # 完整测试套件,包括作为回归下限的 holdout 得分 python evals/run_holdout.py # docs/testing.md 中的检测得分表(--misses 列出未捕获的案例) python examples/smoke.py # 端到端:mock 上游 + 代理,普通和流式

内置规则集位于 swapback/vendor(见 THIRD_PARTY_NOTICES.md);tools/build_vendor.py 会重新生成 Presidio 模式。

还原 Anthropic Messages 流。已在 0.1.1 完成。 捕获所列值的分隔符和大小写变体(NBSP、.、_、-、%20、全大写),统一到同一个占位符下。已在 0.1.1 完成。 还原 OpenAI Responses API 流。已在 0.3.0 完成。 在可能把数据发送出去的工具调用中保留占位符。已在 0.3.0 完成。 从通讯录导出文件构建已知值文件。已在 0.3.0 完成(swapback known init)。 可选的、可插拔的 NER,用于你从未列出的姓名,默认关闭。 更多国家 ID 和地址模式,附带基于合成数据的测试。 发布到 PyPI。已完成:pip install swapback。 用于支出上限、本地回退和用量统计的 hooks。已在 0.4.0 完成。 公开、可重复运行的泄漏测试。已在 0.4.2 完成(swapback selftest)。

欢迎提出想法和 pull request;任何较大的改动请先开 issue。

MIT,见 LICENSE。内置规则数据:gitleaks(MIT)和 Microsoft Presidio(MIT),见 THIRD_PARTY_NOTICES.md。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →