故障排查

先确定失败的位置

先记下失败时间、应用与 CLI 版本、操作系统、当前模型和运行目标。区分模型请求、工具执行、文件访问、浏览器、远程服务与界面显示，避免同时更改多个设置。

• 查看原聊天是否在等待审批、回答或其他输入。
• 核对错误信息与最后一次成功步骤。
• 检查实际工作目录、目标文件和当前连接。
• 对发送、支付、发布和写入等操作，先查目标系统状态再恢复。

模型没有响应或工具不可用

检查服务地址、凭据、配额、模型代码与网络。模型支持普通文字，不代表支持图片、工具、搜索或所需推理选项。工具不可用时再检查插件／MCP 连接、依赖和沙盒范围。

网络允许访问与某次操作获准是两件事。代理、域名限制、受管要求和工具自身权限都可能阻止请求；保留具体错误后调整正确层级。

侧面板出现并非 Lime 修改的文件

差异列表可能反映整个工作目录相对比较基准的变化，包括您、编辑器和其他工具产生的修改。先检查文件差异与 Git 状态，不要把所有变化都归给当前任务，也不要批量丢弃。

pwd
git status --short
git diff --stat

这些命令用于定位工作区。继续修改前，把本次任务与已有变更区分清楚。

找不到项目或历史聊天

检查聊天筛选、项目上下文、归档记录和当前连接的 App Server。不同本机、远端服务或账户上下文不一定拥有相同记录。

从项目列表移除条目不应被当作磁盘文件已经删除；反过来，聊天仍在也不证明项目文件仍可访问。先在正确目录核对实际文件，再恢复工作。

远程聊天无法访问本机资源

远程运行使用远端的文件、工具和网络。聊天可见不代表远端已经连接本机目录、桌面或应用。检查当前运行目标、连接状态与授权，并在原任务中说明资源所在位置。

连接中断或撤销访问后，正在运行的步骤可能停止。先保留回合状态和已产生结果，再决定重连、取消或恢复；不要直接重复未知的外部写入。

工作树或本地环境不能运行

• 确认进入了任务实际使用的工作树，而非原仓库目录。
• 核对该目录的依赖、环境文件与项目启动命令。
• 检查未提交修改与忽略文件，必要材料不会自动出现在另一份工作树。
• 团队共享的环境配置仍需要本机具备对应依赖和有效路径。

计划任务或多项工作积累了工作树时，先检查任务历史与未提交文件。只清理已确认无需保留的对象，不把清理当作解决任务失败的第一步。

系统请求访问意外的目录或应用

macOS 等系统可能因为目标路径、媒体目录或自动化调用显示权限提示。先检查任务正在读取哪个路径、调用哪个应用，再决定是否授权。

拒绝不需要的访问，并把材料移到明确授权的项目目录，或调整任务范围。不要为了消除提示一次授予全部磁盘和所有应用的控制权。

权限设置没有按预期生效

查看当前生效的权限档案、审批设置和受管要求，区分配置文件、项目配置、启动参数与会话选择。自动审批选项缺失时，还要核对版本和服务端支持。

配置保存不一定改变已经开始的操作；必要时在确认当前回合状态后启动新回合。发现策略限制时，应说明限制，不能改用另一入口绕过。

选错运行目标或界面差异

发出请求后才发现选错目录、模型或运行目标时，先停止并检查已执行步骤，再把原提示与材料放到正确上下文中继续。不要假设取消一定撤回所有外部操作。

桌面、CLI 与 App Server 版本可能不同，某个入口有功能也不代表另一个入口立即具备相同界面。核对各自版本和当前功能范围。

聊天或终端卡住

• 确认是否存在等待审批、交互命令或仍在运行的进程。
• 检查工作目录、Git 状态、进程与最近输出。
• 终端显示异常时，核对终端兼容性、尺寸、字体和输入模式。
• 保留日志与任务标识后，再选择中止、重新连接或恢复。

反复重试可能制造重复工作并掩盖原因。先从最后一个可确认的检查点恢复。

反馈与日志

提交问题时提供最小复现：操作步骤、预期与实际结果、版本、系统、失败时间及脱敏错误。界面问题附相关区域截图；工具问题附必要的命令与退出状态。

日志和截图应移除 API Key、Token、Cookie、完整连接串、私人文件内容和无关对话。不要为了复现发送整份用户目录或完整历史。