登录故障排除

当社交登录挂起、返回欢迎屏幕，或核心记录未经授权的 /auth 请求时，使用此检查清单。

检查后端可达性

从与桌面应用相同的网络，验证公共 OpenHuman 端点：

curl -I https://tinyhumans.ai/
curl -I https://api.tinyhumans.ai/health

如果网站加载但 API 端点失败，桌面应用可能无法将 OAuth 回调交换为会话。

检查选定的核心

如果使用 Advanced 远程核心模式，请在开始 OAuth 前确认 RPC URL 和 bearer token：

curl -sS https://your-core.example/rpc \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer CORE_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"core.ping","params":{}}'

401 响应表示桌面 token 和远程核心 token 不匹配。先修复这个问题再重试 Google 或 GitHub 登录。

检查 deep-link 回调

成功的桌面 OAuth 以 openhuman://auth?... 回调结束。如果浏览器显示该 URL 但应用停留在欢迎屏幕：

1. 确保只有一个 OpenHuman 桌面实例在运行
2. 重启应用，保持相同的远程核心设置，重试登录
3. 如果使用远程核心，检查核心是否收到 openhuman.auth_store_session

对于远程核心，临时手动注入可以确认核心是否正常运行：

curl -sS https://your-core.example/rpc \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer CORE_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"openhuman.auth_store_session","params":{"token":"JWT_FROM_CALLBACK"} }'

错误报告内容

在错误报告中包含：

• 应用版本和操作系统
• 核心模式是本地还是远程
• RPC URL 主机、脱敏 token 状态和 core.ping 结果
• 使用的 OAuth 提供商
• 浏览器中是否出现了 openhuman://auth URL
• 第一个未经授权的日志行（如果存在）

下一步

• 入门指南 - 安装和首次使用
• 平台与可用性 - 支持的平台