常见问题与排查
先保留错误原文，再定位失败发生在哪一步：连接模型、读取文件、调用工具，还是运行 Graph。每次只改一个相关设置，更容易判断原因。
模型连接失败
先用一句简短问题复现，不附加大文件或复杂工具任务。详细配置见 Provider 与模型。
找不到文件或工作区
确认文件在磁盘上仍然存在，当前会话关联了正确的工作区，任务中使用的相对路径是相对于该目录的。
通过附件发送时，检查发送前是否已显示附件。不要假设“提到了文件名”就等于“提供了文件”。目录移动后，需要重新选择有效目录。
插件或 MCP 不可用
依次检查：
- 插件是否导入成功并已启用。
- Skill 或项目 MCP 是否属于当前会话的工作区。
- STDIO 启动命令及依赖是否可运行；HTTP 地址是否可达。
- 凭据、参数和环境变量是否符合服务说明。
- 配置后是否已经开始新的对话轮次。
- 当前聊天输入框工具菜单中的 MCP 开关是否开启。连接成功和允许当前轮调用是两回事。
查看页面中的连接状态与具体错误。不要反复重装来替代对错误的检查。更多说明见 插件、Skills 与 MCP。
Graph 无法运行
检查 Graph 是否已经保存、运行输入是否为空、Agent 的执行工作区是否存在、模型是否可用。检查节点必需字段，以及从 Input 到 Output 的连接。
使用 Router 时，每条路径需要填写选择条件并连接出口。运行过程中失败，选择对应的最近运行记录，再查看失败节点的消息。
为什么还在执行？
一项任务可能包含多次模型请求与工具调用。检查是否有等待你填写的表单、仍在运行的工具，或明确的错误提示。
如果决定停止，等待界面确认结束，再检查已经产生的文件和操作结果。停止不会自动撤销已完成的动作。
定时任务为什么没有执行
先检查下次执行时间、频率、电脑本地时间和 Tinybot 是否一直运行。退出应用或休眠后错过的计划不会自动补跑，会显示 已错过；可手动 立即运行。已有运行中或等待处理的执行也会阻止重叠运行，详见 定时任务。
Team 为什么停在等待或失败
检查前置任务是否成功、是否有暂停或停止请求，再打开失败任务的执行记录。人工输入、模型错误或无效完成结果都可能阻止后续调度。处理问题后明确重试，不要反复启动而不检查已经产生的文件。见 团队控制与重试。
修改记忆后，旧会话为什么没有变化
已有会话保留创建时的记忆快照。新建独立会话验证最新记忆；删除条目也不会清除旧快照，详见 记忆管理。
Token 用量为什么与预期不同
除了回答，还可能有规划、重试、标题、压缩和后台记忆调用。缓存和推理是输入或输出的子集，不应重复累加。失败调用未必没有消耗，整份计数缺失会显示不可用；单项字段缺失目前可能显示零。统计不等于服务商账单，详见 用量口径。
文件预览与任务当时的结果不同
文件可能在任务结束后被修改。当前文件预览不等于历史副本，Team 记录的产物读取还会校验版本。出现“文件已变化”时重新打开最新内容；需要恢复已保存基线时，先阅读 文件审阅。
反馈问题时附上什么
建议准备以下信息，并在 GitHub Issues 中用英文描述问题：
- Tinybot 版本、操作系统和相关环境信息。
- 能复现问题的最少步骤。
- 预期发生什么，实际发生什么。
- 错误原文与发生时间。
- 涉及的 Provider 和模型 ID，或插件、MCP、Graph 的必要配置，不包含密钥。
需要进一步定位时，可以在应用的 性能追踪 面板开启 诊断模式，复现一次问题后 导出诊断包，然后关闭诊断模式。
诊断包先保存在本地，不会自动上传。附到 Issue 之前检查内容，移除密钥、个人路径和不适合公开的任务信息。截图也应使用演示数据或做好遮挡。