故障排查

按现象找到对应小节，逐步排查。还没解决可回到常见问题看背景说明。

模型调用失败

调用模型时报错或无响应，按顺序检查：

1. API Key：是否填写正确、是否过期或额度用尽。
2. Base URL：使用自定义或国内服务时，确认接口地址正确（OpenAI 兼容通常以 /v1 结尾）。
3. 模型名：与供应商提供的模型标识完全一致（大小写、连字符都要对）。
4. 协议类型：Claude 系列要选 Anthropic 原生，其余多为 OpenAI 兼容。
5. 备用模型：若配了备用模型却仍失败，确认备用模型同样可用——主模型失败时会自动切换到它。
6. 网络：确认能正常访问该供应商的接口（部分服务对网络环境有要求）。

TIP

Silicon Worker 对临时性错误（网络抖动、限流、超时）会自动重试，并在配置了主备模型时自动切换。持续失败多半是 Key、地址或模型名的问题。

配置方法见连接第一个模型与配置供应商。

无法操作某个应用

Silicon Worker 通过系统接口操作其他应用，缺少权限时会失败。

macOS

在「系统设置 → 隐私与安全性」中确认已授予：

• 辅助功能（Accessibility）：识别并操作界面元素，桌面自动化必需。
• 自动化（Automation）：通过脚本控制其他应用时需要。

授予后可能需要重启该应用或 Silicon Worker 才能生效。详见授予系统权限。

Windows

Windows 通过 UI Automation 操作界面，一般无需手动授权。若操作仍失败，检查是否被杀毒/安全软件拦截，将 Silicon Worker 加入信任列表即可。

下载或安装被系统拦截

macOS：提示来自身份不明的开发者

首次打开时若被拦下，前往「系统设置 → 隐私与安全性」，找到对应提示点「仍要打开」。

Windows：SmartScreen 拦截

若 SmartScreen 弹窗，点「更多信息 → 仍要运行」继续安装。

安装步骤详见安装。

浏览器自动化不工作

• 确认本机已安装 Chrome——浏览器自动化通过 Chrome DevTools Protocol 驱动 Chrome。
• 首次使用时让其完整启动一次，Silicon Worker 会使用独立的浏览器配置目录来保存登录状态。
• 若页面加载较慢导致操作落空，可让任务在关键步骤之间稍作等待后重试。
• 若涉及提交表单、点击删除等动作而任务停下，那是高风险动作的确认机制（见下文），不是故障。

详见桌面与浏览器自动化。

定时任务没触发

• 确认任务已启用，且 cron 表达式与你期望的时间一致。
• 定时任务到点会启动新会话执行，需要应用处于运行状态——如果到点时应用没开，任务不会触发。
• 确认任务所需的权限、模型与连接器都已就绪。

详见定时与远程执行。

任务中途暂停，等待我确认

这是正常的权限确认机制，不是卡死。当任务要执行高风险操作（写文件、执行命令、删除、提交表单等）时，Silicon Worker 会暂停并请你确认，你批准后会从原处继续。

如果你希望少一些打断，可以调整权限模式（如「自由」会自动放行安全/低风险操作）；如果想更谨慎，则用「受控」或「受限」。详见工具与风险分级与权限参考。

找不到我导入的知识库资料

• 确认资料已成功导入到某个知识库。目前支持 Markdown 与纯文本导入（PDF / Office 文档暂未支持）。
• 确认该知识库已绑定到当前会话、专家或团队——检索只会搜索已绑定的知识库。
• 检索用全文搜索（关键词匹配），换用资料中实际出现的词或更具体的措辞往往更容易命中。

详见知识库。

还没解决？

• 背景与概念：常见问题、工具与风险分级
• 重新检查配置：连接第一个模型、授予系统权限