恢复
故障排除
引导失败时，问题通常出在会话状态、MCP 配置路径或服务器 URL 错误。按顺序检查。
已选 IDE
Cursor
.cursor/mcp.json
Swylink 在文档中显示 --ide cursor 和对应的 MCP 配置路径，以明确当前 IDE 的桥接设置。
章节
无活跃 CLI 会话
如果设置令牌生成或兑换失败，本地认证状态可能缺失或已过期。
- 运行 npx @swylink/cli auth whoami --api-base-url https://api.swylink.com
- 如果显示无会话，请重新运行 npx @swylink/cli auth login --api-base-url https://api.swylink.com
- 如果登录成功但设置令牌生成或桥接启动被拒绝，请在仪表盘中确认账号有有效订阅
章节
IDE 保持离线
IDE 通常在配置指向错误文件或命令仍解析到 localhost 而非生产后端时保持离线。
- 确认文件路径与所选 IDE 的 .cursor/mcp.json 一致
- 确认配置包含 --ide cursor
- 如果目标是生产环境，请在生成的配置中显式保留 --server wss://api.swylink.com/ws
- 运行 npx @swylink/cli doctor --ide cursor 检查配置冲突
最小调试循环
先在终端手动运行完整的启动命令。如果在终端中能连接，剩余问题几乎一定是 IDE 配置文件或进程环境。
章节
语言与本地化
CLI 支持多种语言的输出消息。如自动检测不正确，请显式设置语言。
- 使用 --lang pt（或 en、es、fr、de、zh）覆盖检测到的语言
- 也可以设置 SWYLINK_LANG 环境变量
继续
从认证到 IDE 连接完成完整的 CLI 流程，或跳回起点为新用户生成引导文档。