密钥散落（Secret Sprawl）是指同一批密钥（API Key、AI 词典：Token">Token、数据库口令）被复制、硬编码或粘贴到大量本不该出现的位置，导致没人能说清“一共有几份、分别在哪、谁能读”。
一个比方
单个密钥泄露像丢了一把钥匙；密钥散落则像你把同一把钥匙配了三十把，塞在门垫下、花盆里、同事抽屉、车里和旧外套口袋，中间还搬过三次家。麻烦的不是“丢了一把”，而是真出事时不知道先换哪把锁，因为它们本来就是同一把。
它散在哪
- 提交历史（git history）：早期写死在代码里，后来改成读环境变量，但历史提交里那行字还在，克隆（clone）下来就能翻出来。
- CI 日志：调试时顺手打印了一遍配置，日志按惯例长期归档。
- 配置文件：.env、.env.example、本地 settings、笔记软件、群聊。
- 智能体一侧：编码智能体（coding agent）读文件、跑命令、看日志，内容进入上下文，落进会话历史、trace 和缓存。
智能体为什么放大它
人一天大概粘贴一次密钥；编码智能体跑一个任务就可能扫过几百个文件。它不判断“这是不是密钥”，只把它当普通字符串处理，于是密钥被从 .env 带进生成的示例代码、测试用例和会话记录里。它没有恶意，它工作的方式就是在不同上下文之间搬运内容。原来是一条小溪，现在成了分叉几十条的三角洲。
和“单个密钥泄露”的区别
| 维度 | 单个密钥泄露 | 密钥散落 |
|---|---|---|
| 形态 | 一个点 | 一整片 |
| 发现 | 常靠告警 | 往往没人知道，直到轮换卡住 |
| 处置 | 吊销重发 | 先做资产盘点 |
| 性质 | 事件 | 常态 |
对实际工作的意义
密钥散落最直接的后果，是让“轮换密钥”变成不敢做的事：不知道吊销后会打断谁，于是拖着不换，旧密钥越用越久。成本不在技术，而在“心里没底”。
将密钥统一收敛到可控范围的通用方向（工具选型各家不同，以官方文档为准）：
1. 单一可信来源：密钥进密钥管理器或云厂商的密钥服务，其余位置只放引用。
2. 运行时注入：优先使用短时凭证（short-lived credentials），在流水线里注入，而不是写进文件。
3. 收窄暴露面：在提交前扫描、扫描仓库与日志，并接入流水线。
4. 给智能体划定边界：限制智能体可读的目录，把会话记录与缓存当作敏感数据处理，不要默认长期保留。
5. 定期轮换且有账可查：每个密钥有归属人、用途、上次轮换时间。
衡量团队是否健康，看的不是“从没泄露过”，而是“能不能在十分钟内说清：有哪些密钥、在哪、谁能读”。