深浅色
注册与登录
本页面面向第一次使用 Pragma 的人大用户。按顺序完成后，你应该能进入控制台，并清楚下一步是直接使用网页应用，还是创建 API Key 接入本地 agent 和客户端。
首次使用路径
四步完成首次进入
- 确认资格
使用本人的 @ruc.edu.cn 邮箱；已有账号直接登录。
- 创建账号
填写邮箱和至少 6 位密码，阅读并接受使用规范。
- 首次登录
使用同一邮箱和密码进入 Pragma 控制台。
- 选择下一步
网页端直接使用，或创建 API Key 接入本地客户端。
完整注册规则
- 自助注册仅接受你本人的
@ruc.edu.cn邮箱，无需翻墙即可访问。 - 密码至少需要 6 个字符，请设置一组自己长期记得住的密码并妥善保存。
- 提交前需要阅读并接受注册页展示的使用规范。
- 当前不要求邮箱验证，注册成功后直接前往登录页。
- 本站为学术公益项目，完全免费，没有充值、购买额度、套餐或发票等任何付费环节。
我是否需要注册
| 你的状态 | 应该怎么做 |
|---|---|
| 从未创建过 Pragma 账号 | 打开注册页 创建账号 |
| 已有账号或页面提示账号已存在 | 打开登录页，不要重复注册 |
| 已经能进入控制台 | 跳到 登录后，按目标继续 |
如果你不确定自己是否注册过，先尝试登录。只有确认没有账号时，再返回注册页。
注册前准备
开始前只需要准备三项内容：
- 你本人的
@ruc.edu.cn邮箱。 - 一组至少 6 个字符、便于自己长期管理的密码。
- 可以正常访问
https://pragma.academic-ruc.cc的浏览器（无需翻墙）。
账号与信息安全
不要向任何人发送账号密码、API Key、Cookie 或带有个人信息的完整截图。需要反馈问题时，只提供页面路径、错误提示和已经脱敏的信息。
完成注册
- 打开 Pragma 注册页。
- 在“邮箱”中填写你本人的完整人大邮箱，例如
yourname@ruc.edu.cn。 - 创建至少 6 个字符的密码，并确认浏览器没有自动填入其他网站的旧密码。
- 阅读注册页展示的使用规范并勾选同意。未同意时，创建账号按钮会保持不可用。
- 点击“创建账户”。当前流程不要求邮箱验证，注册成功后直接打开 登录页。
注册时常见提示
| 页面现象 | 常见原因 | 处理方法 |
|---|---|---|
| 提示邮箱域名不在允许范围 | 使用了个人邮箱、其他学校邮箱或临时邮箱 | 改用你本人的 @ruc.edu.cn 邮箱 |
| 提示账号已经存在 | 该邮箱以前已经注册 | 停止重复提交，直接前往登录页 |
| 创建账号按钮不可用 | 尚未接受页面上的使用规范，或页面设置仍在加载 | 阅读并勾选使用规范；稍候片刻再试 |
| 注册后没有收到验证邮件 | 当前没有启用邮箱验证 | 不需要等待邮件，直接尝试登录 |
| 页面无法打开或加载很慢 | 服务波动、本地网络或 DNS 问题 | 先查看 服务状态，再按需阅读 DNS 修复 |
页面将来发生变化时
注册策略可能调整。如果页面新增验证码、邮箱验证或其他必填项，以注册页当时展示的要求为准；文档也应同步更新。
首次登录
- 打开 Pragma 登录页。
- 输入注册时使用的人大邮箱和密码。
- 如果登录页再次要求确认使用规范，请阅读后勾选同意。
- 点击登录，等待控制台加载完成。
登录成功后，页面中应能看到 API Key、在线聊天、在线画图或使用记录等入口。看到控制台后，不需要再返回注册页。
登录失败时先检查
- 当前打开的是登录页，而不是注册页。
- 邮箱拼写和后缀是否正确。
- 浏览器是否自动填入了旧密码。
- 是否已经阅读并接受页面展示的使用规范。
- 服务状态 是否正常。
如果仍然无法进入，请记下页面提示和发生时间，再按 故障排查 中的安全反馈模板整理信息。不要粘贴密码、API Key、Cookie 或未经脱敏的完整日志。
登录后，按目标继续
创建 API Key 后，最小连接验证和 Base URL 说明统一放在 创建 API Key 页面；注册页不重复维护客户端配置命令。
常见问题
为什么个人邮箱不能注册？
Pragma 当前面向校内科研训练场景开放自助注册，只接受 @ruc.edu.cn 邮箱。个人邮箱、其他学校邮箱或临时邮箱会被拒绝。
为什么页面说账号已经存在？
这通常表示该邮箱已经注册过。请停止重复提交，直接使用 登录页。
为什么创建账号按钮一直不可用？
先确认页面已经加载完成，并检查是否阅读、勾选了使用规范。如果按钮仍不可用，刷新一次页面，再查看 服务状态。
为什么没有收到验证邮件？
当前注册流程没有启用邮箱验证，因此不需要等待邮件。注册成功后直接尝试登录即可。
忘记密码怎么办？
当前没有开放自助找回密码。请不要反复创建重复账号，也不要向他人发送旧密码或其他敏感信息。按照 故障排查 的安全反馈模板联系维护者处理。
注册成功后先看哪一页？
- 只想在浏览器里使用：阅读 在线聊天与画图。
- 想给本地 agent 或客户端配 API：阅读 创建 API Key。
- 已经有 API Key，但不知道客户端如何填写：阅读 客户端配置总览。
页面很慢或打不开怎么办？
先查看 服务状态。如果服务正常但只有你的设备打不开，再阅读 DNS 修复。
使用边界
账号仅供本人在学术与公益科研场景中使用。不要共享、转卖账号或 API Key，也不要把站点和内部信息传播给无关组织。完整要求见 使用规范与免责声明。