- Add rewrites in next.config.ts to proxy /api/* to api-dev.copilothub.ai - Update docs to reflect new local dev workflow (no devd needed) - Fix web port number in CLAUDE.md (3001 → 3000) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.7 KiB
1.7 KiB
Desktop 登录集成
登录流程
Desktop 点击登录
↓
启动本地 HTTP 服务器 (随机端口,如 54321)
↓
打开浏览器 → http://localhost:3000/api/desktop/session?port=54321&platform=web
↓
Web 重定向 → /login?next=...
↓
用户登录,调用 /api/v1/auth/login (代理到 api-dev.copilothub.ai)
↓
登录成功,回调 → http://127.0.0.1:54321/callback?sid=xxx&user=xxx
↓
Desktop 保存到 ~/.super-multica/auth.json
前端逻辑
Web 端
- 端口:3000
- 登录 API:
/api/v1/auth/login(通过 Next.js rewrites 代理到后端) - 登录成功后回调:
http://127.0.0.1:{port}/callback?sid=xxx&user=xxx
Desktop 端
- 点击登录 → 启动本地服务器 → 打开浏览器
- 收到回调 → 保存到本地文件
存储
路径: ~/.super-multica/auth.json
Desktop 登录成功后,SID 和用户信息存储在本地文件:
{
"sid": "session-id-from-backend",
"user": {
"uid": "user-id",
"name": "User Name",
"email": "user@example.com"
}
}
后续请求可从此文件读取 sid 进行认证。
退出登录
后端只需要返回错误,前端会自动处理退出。
前端收到认证错误后:
- 调用
auth:clear清除本地数据 - 跳转到登录页
本地调试
# 1. 启动 Web(Next.js rewrites 自动代理 /api/* 到 api-dev.copilothub.ai)
pnpm dev:web
# 2. 启动 Desktop
pnpm dev:desktop
本地调试时,Next.js rewrites(配置在 apps/web/next.config.ts)自动将 /api/* 请求代理到 api-dev.copilothub.ai。