// 问题与解法
AI 技术问题与解决方案
45 个 AI 常见问题与解决方案：报错排查、怎么做、怎么选，覆盖个人、开发者、企业 IT、研究者、创作者和学生，每个都链到官方文档、相关软件和场景。
21 个场景共 45 个问题最近核实 2026-10-22
💸 控制 AI 成本和限额
🛡️ 让 agent 安全地执行
- 怎么做防止 agent 删除文件、执行危险命令 让 agent 少犯不可逆的错误，靠的是三层：执行环境隔离、权限最小化、操作前有检查点。
- 怎么做撤回 agent 的改动：git 检查点、worktree 和 reflog git 是最可靠的 agent “撤销键”：每个任务一个分支或工作树，频繁提交；误操作后还能用 reflog 找回已提交过的状态。
- 怎么做防止 agent 读取 .env、把密钥提交进仓库 agent 能读到的文件，内容就可能进入模型上下文、日志甚至提交记录。要从“少暴露、早发现、快轮换”三方面处理。
- 怎么做agent 读网页、文档时被提示注入怎么防 提示注入目前没有能彻底解决的办法。实际做法是把外部内容当作不可信数据，限制 agent 读到注入内容后能造成的破坏。
- 怎么做安装 MCP 服务器前怎么核实它是正版、安全的 MCP 服务器以你的权限运行，等于安装了一个能被模型调用的程序。仿冒包名、恶意更新和在工具描述里藏指令（工具投毒）都出现过。
- 报错LiteLLM 1.107.0 被投毒：我中招了吗，怎么处理 2026-10-21，LiteLLM 的发布流水线被攻破，PyPI 上的 litellm==1.107.0 全部 7 个 wheel 和 Docker 镜像 v1.107.0 / latest / main-latest / main-stable 被植入凭据窃取程序和远程代码加载器。官方确认：PyPI 包在线时间为北京时间 10-21 19:39–21:23（UTC 11:39–13:23），Docker 镜像为 19:46–22:20（UTC 11:46–14:20）；GitHub 上的 v1.107.0 源码标签本身不含恶意文件，此前版本都安全，已全部下架。在这段时间里没锁版本安装或拉取过镜像的环境，要按“已被入侵”处理。
🔌 给 agent 接工具（MCP、CLI、鉴权）
📐 让多个 agent 共用规则和技能
- 怎么做AGENTS.md 怎么写 AGENTS.md 是放在仓库里给编程 agent 看的说明文件，作用类似给新同事的 README：怎么构建、怎么测试、代码规范和提交要求。
- 怎么做在 Claude Code、Codex、Cursor、Gemini CLI 之间共用一套规则 各家 agent 读取的规则文件名不同。做法是保留一份主文件（推荐 AGENTS.md），其他工具通过引用、软链接或配置指向它。
- 怎么做Agent Skills（SKILL.md）是什么，怎么复用 技能（Skill）是一个文件夹，核心是一份带 YAML 头信息（名称、描述）的 SKILL.md，可附带脚本和参考资料。agent 按描述判断何时加载，比把所有说明塞进规则文件更省上下文。
🔁 换模型：自带 key、国产模型、本地模型
🖥️ 在本机跑模型
- 怎么选我的显存/内存能跑多大的模型 粗略估算：模型权重占用 ≈ 参数量 × 每个参数的位数 ÷ 8，再加上上下文（KV cache）和运行时开销。4 位量化时，每 10 亿参数大约需要 0.5–0.7 GB。
- 报错Ollama 长文档被截断、模型“忘记”前文 Ollama 默认的上下文长度比很多模型支持的上限小得多（默认值随版本变化）。输入超过上下文长度时，前面的内容会被丢掉。
- 报错llama.cpp 输出乱码、角色混乱或不调用工具 对话模板（chat template）决定了消息怎样拼成模型训练时见过的格式。模板不对时，模型会输出奇怪的标记、自问自答，或者不按格式调用工具。
- 报错vLLM 启动时报 CUDA out of memory vLLM 启动时会按设定比例预先占用显存，并为最大上下文长度预留 KV cache。模型加上下文放不下时会直接报显存不足。
- 怎么做在自己电脑上搭一个“私有版 ChatGPT”（Ollama + Open WebUI） 用 Ollama 在本机运行开放权重模型，再用 Open WebUI 提供类似 ChatGPT 的网页界面，对话和文件都不出本机。
🧭 在国内合规用上 AI
📄 做 RAG 和文档处理
📈 评估、监控 AI 质量
🎁 找免费资源和福利
🧪 选型与避坑
- 怎么做这个开源 AI 项目还在维护吗？怎么判断 AI 开源项目更替很快，停更、归档、改名、转闭源都很常见。选型前花几分钟看几项指标，可以避免把系统建在停更的项目上。
- 怎么做开源 AI 工具能不能商用？怎么看许可证 “代码公开”不等于“开源许可”。不少热门 AI 工具使用带附加条件的许可证，例如限制托管成 SaaS 或要求保留品牌。
- 怎么选agent 框架怎么选：LangGraph、OpenAI Agents SDK、Pydantic AI、CrewAI、Mastra 框架之间没有绝对的好坏，关键看语言、对流程控制的要求、要接哪些模型和部署方式。本站没有做统一实测，下面是选型时该问的问题。
- 怎么选API 中转 / OpenRouter 安全吗 任何把请求转给上游的第三方都会看到明文 prompt 与回复（除非做端到端加密，目前主流 API 没有）。OpenRouter 是公开文档较全的聚合平台，默认不长期保存 prompt/回复，并提供 Zero Data Retention（ZDR）路由；低价不明中转站则常有掺水、虚报 token、跑路与留存风险。安全取决于你的数据敏感度、是否核验、以及付款与密钥隔离方式，而不是某个品牌口号。
🎓 学 AI（路线、教程）
✍️ 日常办公：写作、翻译、做 PPT
👩💻 用 AI 写代码：选工具、控质量
🧱 不会编程也能做应用和网站
🧠 个人知识库：让 AI 基于我的资料回答
🏢 企业私有化部署大模型和知识库
🗓️ 会议纪要和团队协作自动化
🔬 科研：找文献、读论文、写综述
🎬 创作者：AI 做图、做视频
📚 学生：用 AI 学习（守规矩地用）
没有匹配的问题，换个关键词，或去场景页看看。 场景 →
根据官方文档和公开讨论整理（每页注明核实日期），尚未在本站环境复现；与官方文档不一致时以官方为准。 /api/v1/problems.json