夜雨聆风
这份清单里的每一条，都是真金白银换来的
上一篇文章讲了怎么让 AI 真的替你干活。评论区和后台有人问细节，我把自己这几天踩过的坑整理成了这份清单。
先说一句实话：这不是一份「入门教程」，而是一份「别踩这里」的地图。教程网上有很多，但坑通常没人写——因为写教程的人往往没踩过。
一、最贵的坑：杀毒干净 ≠ 安全
这条排第一，因为它最反直觉，也最容易出事。
我给自己的 AI 助手找记忆增强插件的时候，看上了四个热门的。按常规流程扫描了一遍，结果让人放心：四个全部通过杀毒检测，66 个杀毒引擎零报毒，没有任何恶意代码特征。
但换成行为分析工具再扫一遍，结论完全翻转：四个里有三个被判为最高风险，明确标注「不要安装」。
被抓出来的具体行为是这两条，我原样翻译：
• 「当检测到 API 密钥存在时，把对话内容发送给外部服务」
• 「鼓励长期留存对话、账号与凭据相关信息，且缺少用户控制手段」
看明白了吗？这不是病毒，是设计意图。代码本身没有任何恶意特征，杀毒软件当然扫不出来——它做的事情在技术上完全「合法」，只是把你的东西送了出去。
结论：任何 AI 插件，只看杀毒结果都是不够的。AI 助手手里握着你的文件、消息和密钥，它的权限有多大，风险就有多大。
怎么做才对
① 默认拒绝。不是「先装了看看」，而是没审核过的一律不装。
② 看三个信号，不只看一个。静态扫描、杀毒引擎、行为分析——前两个干净不代表第三个干净。
③ 额外查两项：有没有数字签名（unsigned 要警惕）、来源能不能追溯。
④ 把「默认拒绝」写成机器规则，不靠自觉。我在自己机器上设了一道强制关卡，没有审批记录就装不上，哪怕我自己想偷懒也绕不过去。
权限越大的工具，审核就越不能省
二、密钥别乱放，这三个动作省你一场事故
AI 助手要干活，就得给它各种密钥——大模型的、公众号的、云服务的。这些东西怎么放，是新手最容易出事的地方。
坑 1：粘贴到聊天窗口里
很多人图省事，直接把密钥发给 AI。问题是聊天记录会留存、会被同步、可能被索引。密钥一旦进过聊天记录，就该当它已经泄露了。
正确做法是在终端里用隐藏输入的方式写进文件：
关键点：`-s` 让输入不回显，`600` 权限只有你自己能读，最后 `unset` 清掉内存里的痕迹。
坑 2：命令留在历史记录里
你在终端敲过的命令会存进 history 文件。如果密钥出现在命令里，它就永久留下来了。
解法很简单：确认你的 shell 配置里有 `HISTCONTROL=ignoreboth`，然后在敏感命令前面加一个空格——带空格开头的命令不会进历史。
坑 3：不检查粘贴结果
我自己就中过。隐藏输入看不见内容，多按了几次粘贴，结果同一串 AppID 被粘了 7 遍，长度从 18 位变成 126 位。当时完全没察觉，直到调接口报错才发现。
所以写完一定要校验，但只看长度和前几位，不要打印全文：
三、7 个高频报错，直接给解法
1. 接口报「IP 不在白名单」服务器出口 IP 没加白名单。先查自己的出口 IP，再去对应平台后台加进去。注意家宽 IP 会变，服务器才稳定。
2. 报「无效的令牌」但配置没动过八成是额度用完或密钥被重置，不是配置错误。先用最轻的接口探活确认，别急着改配置。
3. 令牌频繁失效很多平台的访问令牌全局唯一，重复申请会让上一个立即作废。要缓存复用，不要每次调用都重新取。
4. 接口报「未授权」不是密钥错，是这个账号没开通该功能权限。得去平台后台申请，或者认证账号类型。这个开发者自己解决不了。
5. 图片上传成功但显示不出来很多平台的正文图片必须用它自己的图床地址，外链会被拦。要先上传拿到平台地址再引用。
6. 排版发布后全乱富文本编辑器通常会剥离外部样式表，样式必须写成内联形式，不能用 class。
7. 中文变成乱码请求头没声明字符集。加上 charset=utf-8，并确认发送的是 UTF-8 编码的字节流。
四、三条经验之谈
1. 不可逆的操作，先备份再动手。我修那个粘了 7 遍的密钥文件时，先复制了一份备份才改。万一判断错了还能还原。这个习惯迟早救你一次。
2. 报错信息要读完，别只看第一行。错误码通常直接告诉你是权限问题还是参数问题，读懂错误码比盲目试参数快十倍。
3. 权限最小化。给 AI 助手开权限时，只开这次任务需要的。「先都开着方便」是所有事故的共同起点。
这份清单我会持续更新——每踩一个新坑就补一条。如果你在实际操作中遇到清单里没有的问题，欢迎留言告诉我，我补进去，也回你怎么解。
想进那个小群一起交换踩坑经验的，后台回复 进群
