常见问题

账号与登录

• 登录支持哪些写法？——拼音用户名 / 姓名 / 邮箱任选其一 + 密码。
• 忘记密码怎么办？——联系管理员重置（评估期未开通邮件自助找回）。
• 连续输错被锁定？——稍等片刻再试，或找管理员解锁。

任务与修订

• 改了任务但没生成修订？——普通小改动走 PATCH 不生成修订，重大变更走「修订」入口。
• 能回滚任务吗？——可以，回滚会生成一条新修订（快照当前值），全程留痕。
• 任务必须挂阶段吗？——新任务建议挂阶段，历史任务允许无阶段。

文件与网盘

• 上传失败？——检查文件是否超单文件上限（默认 100MB）或不在 MIME 白名单内。
• 误删文件能找回吗？——回收站保留 30 天，期内可恢复。
• 为什么删不了文件夹？——删除文件夹需 MANAGER 及以上权限。

IM 与 Android

• 消息收不到 / 断连？——检查 NEXT_PUBLIC_WS_URL 是否为 origin 根域名（带路径会被当 namespace 导致断连）。
• Android 装不上？——微信内会拦截下载，换系统浏览器扫码；安装时允许「未知应用」。
• App 与网页账号通用吗？——通用，同一套 JWT 鉴权。

部署与 MCP

• 服务器 OOM？——2 核 2G 起步，构建前先看 free -m 水位。
• MCP 连接 401？——需带 Bearer Token（系统登录同一套 JWT）。
• 完整部署步骤在哪？——docs/deployment.md。