# 排错 大多数问题出在首次启动、钥匙串、模型连接或数据源上。先找到下面对应的小节;如果问题仍在,带上应用版本与复现步骤提交 Issue。 ## macOS 拦截首次启动 前往 系统设置 → 隐私与安全性,为 Seris 选择“仍要打开”。Seris 采用 ad-hoc 签名、未经 Apple 公证,所以 macOS 会询问一次。 ## 升级后出现钥匙串提示 macOS 可能会请你允许访问已有的模型凭据,选择允许即可。如果凭据库被锁定或不可用,先解锁再重启 Seris,或在 Settings → Models 中重新保存模型连接。 ## 提示需要配置模型,或连接失败 打开 Settings → Models,检查 API key、端点与模型,然后测试连接。使用 Ollama 或 LM Studio 时,先启动本地服务再选择模型。 ## 没有加密新闻 加密新闻需要在 Seris 启动环境中设置 `CRYPTOCOMPARE_API_KEY`。 ## 行情暂不可用 检查网络后点“重试”。更新失败时,图表会保留上一次快照并显示其时间。美股与 ETF 需要在 Markets 中连接长桥,可见范围取决于你的账户权限。 ## 搜不到某个标的 试试用代码代替公司名称。例如搜索 `V` 可找到 Binance 的 Visa 永续合约。 ## 浏览器工具无法启动 浏览器工具使用 Google Chrome。要使用其他浏览器,把 `SERIS_BROWSER_PATH` 设为它的可执行文件路径。 ## 出现 “Run reached its step limit” Seris 0.1.1 去掉了固定步数上限。升级到[最新版本](https://github.com/aowang-ai/seris/releases/latest)后,长任务会一直进行到完成,或直到你按下 Stop。 ## 服务无法启动 如果 Seris 提示服务多次启动失败,退出并重新打开应用。 ## 反馈 bug [提交 Issue](https://github.com/aowang-ai/seris/issues),写明 macOS 版本、应用版本、复现步骤与预期结果。日志和截图里请删掉 API key、账户信息与私密对话。安全漏洞请按 [SECURITY.md](https://github.com/aowang-ai/seris/blob/main/SECURITY.md) 私下报告。 文档: https://seris.im/zh/docs/