【导读】Django联合创始人Simon Willison刚刚发布了一个Python CLI工具scan-for-secrets,专门解决一个让所有AI开发者细思极恐的问题——你兴高采烈分享的Claude Code日志、Agent调试记录里,API Key正在以6种你根本想不到的编码方式悄悄裸奔。推文发出不到24小时,已有超500人点赞、近4.3万人围观。更可怕的是,有人现身说法:去年团队在Slack分享debug日志,API Key混在里面,整整6个小时没人发现。
一条Slack消息,让整个团队冷汗直流
先说一个真实事故。
开发者Nithin K Anil在Simon的推文下回复了一段话,读完让人后背发凉:
"we had a postmortem last year where a dev shared debug logs in a Slack thread and the API key was in there. 6 hours before anyone noticed. this would have caught it before it left the machine"
「去年我们做过一次事后分析,一位开发者在Slack讨论串中分享了调试日志,其中就包含API密钥。六个小时后才有人注意到。如果当时用了这个工具,密钥根本不会离开本机。」
▲ Nithin K Anil分享的真实泄密事故——Slack日志里的API Key暴露了整整6小时
六个小时。
在这六个小时里,任何爬虫、任何有心人、任何自动化扫描器都可能已经把这个Key拿走了。轮转密钥、排查影响、写事后报告——整个团队为一次"随手分享"付出了巨大代价。
这样的场景,在AI编程时代正在以指数级增多。
AI编程的新型"裸奔":不是代码库,是日志
过去,开发者泄密的经典场景是什么?把`.env`文件提交到GitHub,或者CI/CD流水线日志公开。这些问题早就有成熟的解决方案——TruffleHog、Gitleaks、GitGuardian,扫一遍代码仓库就行。
但2026年的开发者面对的是一个全新的泄密场景。
你用Claude Code调试了一晚上bug,生成了几百行日志。觉得调试过程很有教育意义,想分享到博客。你用Cursor跑了一个复杂的重构任务,Agent的transcript里记录了每一步操作。你觉得这是很好的案例分析素材,贴到了Discord。
问题来了:这些日志里,你的OpenAI API Key可能以JSON转义的方式藏在某个HTTP请求dump里。你的Anthropic Key可能以URL编码的形式出现在某段错误栈中。你的AWS凭证可能被HTML实体编码后嵌在一段调试输出里。
你用`grep`搜了一下原始Key字符串,没找到,觉得安全了。
但它其实就在那里,只是换了一身你认不出的"马甲"。
Simon Willison的"paranoia":我就是太害怕了,所以做了这个工具
Django联合创始人、Datasette作者、Python圈的"瑞士军刀"制造机Simon Willison,长期维护一个叫claude-code-transcripts的开源项目,专门把本地Claude Code的会话记录发布出来。
他在博客里坦诚地写道:
"I like publishing transcripts of local Claude Code sessions using my claude-code-transcripts tool but I'm often paranoid that one of my API keys or similar secrets might inadvertently be revealed in the detailed log files. I built this new Python scanning tool to help reassure me."
「我喜欢用claude-code-transcripts工具发布本地Claude Code的对话记录,但我总是很偏执地担心某个API密钥或类似的敏感信息会不小心出现在详细的日志文件里。我做了这个Python扫描工具来让自己安心。」
▲ Simon Willison发布scan-for-secrets,推文获513赞、4.3万次查看、374次收藏
注意他用的词——paranoid(偏执)。一个拥有15万X粉丝的顶级开源开发者,每次发布日志前都战战兢兢。这说明什么?这个风险是真实的,而且连最有经验的人都没有安全感。
一行命令,六种"马甲"全部脱掉
scan-for-secrets的使用方式简单到令人发指:
``` uvx scan-for-secrets $OPENAI_API_KEY $ANTHROPIC_API_KEY -d logs-to-publish/ ```
就这一行。你甚至不需要安装——`uvx`会零安装直接运行。
但在这行命令的背后,工具会自动生成你提供的每个secret的6种编码变体,然后逐一扫描:
- literal
:原始字符串精确匹配 - json
:JSON转义版本(`"`、`\\`、`\uXXXX`等) - url
:URL百分号编码(`%20`、`%3D`等) - html
:HTML实体编码(`"`、`&`等) - backslash-doubled
:双反斜杠转义 - unicode-escape
:Unicode转义序列
这就是它比grep强的地方。grep只能找你肉眼看到的那个字符串。而你的Key经过JSON序列化、URL编码、HTML渲染后,长得完全不一样——但scan-for-secrets全都能抓出来。
找到了怎么办?工具会输出文件路径、行号、secret的前4个字符提示(比如`sk-p...`),以及它是被哪种编码"伪装"的。Exit code返回1,方便你集成到脚本或CI里。
没找到?安安静静退出,exit code 0。安心发布。
一小时四个版本:从扫描到一键擦除
Simon的迭代速度堪称恐怖。4月5日凌晨,他在不到一小时内连续发布了4个版本:
- 0.1(3:27am)
:基础扫描功能上线 - 0.1.1(3:39am)
:补充转义方案文档,删除冗余的repr方案 - 0.2(4:07am)
:大幅升级——流式输出、多目录扫描、指定单文件、Python API - 0.3(次日)
:终极武器上线——`--redact`
`--redact`是什么?直接把命中的secret替换成`REDACTED`,而且会处理所有编码变体。
"New -r/--redact option… replaces every match with REDACTED, taking escaping rules into account."
「新增-r/--redact选项……将每个匹配项替换为REDACTED,同时考虑转义规则。」
也就是说,你不仅能找到日志里的secret,还能一键清除——JSON转义版本的、URL编码版本的、HTML实体版本的,全部替换。手动用sed写这套逻辑?光想想各种编码的正则表达式就够你喝一壶的。
他还提供了Python API `redact_file()`,方便你把这个能力集成到自己的工作流里。
对于长期使用,你可以创建配置文件`~/.scan-for-secrets.conf.sh`,把所有需要扫描的secret命令写进去(比如`llm keys get openai`),以后每次扫描自动加载,连参数都不用敲。
「先写README,再让Claude Code按TDD实现」——一种新的造轮子方式
这个工具的开发过程本身就是一篇好故事。
Simon在推文中透露:
"I built this one using README-driven-development: I hand crafted a detailed README describing exactly how the tool should work... then dumped that into Claude Code and told it to build it"
「我用README驱动开发的方式构建了这个工具:我亲手写了一份详细的README,描述工具的具体工作原理……然后将其导入Claude Code并让它进行构建。」
▲ Simon分享README-driven development方法论,48赞、1万次查看
他甚至公开了完整的Claude Code对话记录(transcript),第一句提示词就是:
*"Read the README.md, it contains the not-yet-implemented design for this tool. Ask any clarifying questions, then build it with 'uv run pytest' and red/green TDD."*
先手写规格说明书(README),再让AI按红绿灯TDD流程实现。这套方法论完全可复用——你也可以这么干。先想清楚你要什么,写成文档,然后交给Agent去落地。
这可能是2026年最高效的个人开发范式之一。
▲ Simon的博客和GitHub README,42赞、1.1万次查看
网友吵翻了:为什么不用TruffleHog?这不就是grep的垃圾版?
这么一个看似简单的工具,居然在评论区引发了激烈争论。
质疑一:「为什么不直接用TruffleHog?」
▲ 开发者质疑:为什么不直接用TruffleHog?
这个问题看似合理,实际上搞混了两个完全不同的场景。TruffleHog/Gitleaks的定位是"在代码仓库和Git历史里发现未知的secret"——它用正则表达式和熵值分析来猜测哪些字符串可能是密钥。
而scan-for-secrets的定位是"我知道我的Key长什么样,我只想在分享文件前确认它没有出现"。它不猜,它精确匹配你给的字符串加上所有可能的编码变体。
这就好比TruffleHog是缉毒犬——闻到可疑气味就叫。scan-for-secrets是你手里的照片——你知道要找谁,只是确认他没混在人群里。
两者互补,场景完全不同。
质疑二:「不就是grep吗?」
▲ @ValueRaider直接开喷:"这看起来像个很烂的grep版本"
这位老兄显然没仔细看README。grep能帮你自动生成一个API Key的JSON转义版、URL编码版、HTML实体版然后同时搜索吗?grep能在找到后直接帮你把所有编码变体一键替换成REDACTED吗?grep的exit code和输出格式有为自动化脚本优化吗?
看起来简单的东西,恰恰是把"对的抽象"做到位了。
但也有人提出了真正值得警惕的问题
开发者tomviner的一条回复,让Simon本人都表示"确实担心":
"I hate to say this, but in the new world of rampant supply chain attacks, should we really be recommending uvx (without a version/hash)?"
「我很不愿意这么说,但在供应链攻击猖獗的新形势下,我们真的应该推荐uvx(没有版本/哈希值)吗?」
▲ tomviner提出供应链安全质疑,直指uvx的零安装模式
Simon的回复很坦诚:
"Yeah I do worry about that, especially given how key to my workflow uvx has become. I'm not sure telling people to 'pip install' or 'uv tool install scan-for-secrets' and then 'scan-for-secrets --help' is materially different though"
「是的,我确实很担心这一点,尤其考虑到uvx在我的工作流程中变得如此关键。但我不确定告诉人们'pip install'或'uv tool install scan-for-secrets'然后再'scan-for-secrets --help'在本质上是否有区别。」
▲ Simon坦诚回应:uvx的风险和pip install本质上没有区别
这个对话指向了一个更深层的悖论:一个帮你防止泄密的安全工具,其安装方式本身可能带来供应链风险。在LiteLLM PyPI投毒事件刚刚发生的2026年4月,这个担忧绝非杞人忧天。
你的Key,可能正在你最意想不到的地方裸奔
回到最根本的问题。
2026年,每一个使用AI编程工具的开发者,都在产生前所未有的大量日志——Claude Code的transcript、Cursor的操作记录、Copilot的上下文dump、Agent的调试输出。分享这些日志已经成为开发者社区的日常:用来提bug、写教程、做案例分析、记录工作流。
但每一次分享,都可能是一次裸奔。
你的OpenAI Key可能以`sk-proj-xxxxx`的原始形式出现在某行日志里。也可能以`sk-proj-xxxxx`的JSON转义形式藏在一个序列化的请求体里。也可能以`sk-proj-xxxxx`的URL编码形式嵌在一个错误信息的URL参数里。你以为grep一下没找到就安全了?那只是因为你没搜它换了衣服之后的样子。
Simon Willison把自己的"偏执"做成了一个零门槛的CLI工具。一行命令,六种编码,全面扫描,一键擦除。
安装方式:`pip install scan-for-secrets`,或者零安装直接跑`uvx scan-for-secrets --help`。
在你下次分享日志之前,先跑一遍。这可能是2026年最便宜的安全保险。
— END —

