医创工坊AI协作平台小白手册
一句话说明：团队成员不用共用你的登录密码，只拿自己的“接口钥匙”，在自己电脑的 Codex 里使用；后台会按成员分别统计用量。
常用入口
- 成员领取接口钥匙：
https://ycinno.top/portal - 管理员后台：
http://127.0.0.1:18080/admin（只能在管理员电脑通过授权器/SSH 通道打开） - IP 检测：
https://ycinno.top/ip-check
ChatGPT 网页版怎么用
- 成员登录
https://ycinno.top/portal后，点击“打开 ChatGPT 网页版”。 - 只能选择 Thinking Heavy 或 Extended Pro；系统不会开放 Pro、Instant、Auto 等其他模式。
- 同一个对话里，每次发送前都可以重新选择模式。历史消息会保留各自当时使用的模式。
- Extended Pro 每个成员每天最多 3 次；Thinking Heavy 不限次数。
- 如果要上传文件，每次发送一轮对话最多 20 个。点击发送后不要关闭页面，系统会先等文件完整上传，再发送本次问题。
几个常见词，用人话解释
- 接口钥匙（API Key）：成员调用 AI 的专属通行证。每个成员不同，泄露后要立刻更换。
- 服务地址（Base URL）：Codex 要连接的平台地址。
- Token：可以理解成 AI 读入和写出的文字量，提问/回答越长消耗越多。
- Codex：成员自己电脑上运行的 AI 工具。
- PowerShell：Windows 自带命令窗口，用来粘贴 Windows 一键配置命令。
- 终端 Terminal：macOS 自带命令窗口，用来粘贴 macOS 一键配置命令。
- 禁用：成员不能登录，接口钥匙也会立刻作废；历史审计记录保留。
- 删除成员：从成员列表移除账号，接口钥匙立即作废；历史审计记录仍保留，方便追溯。
成员怎么做
- 确认自己当前网络是非中国大陆网络。
- 打开成员入口并登录。
- 第一次使用建议先修改密码。
- 按电脑系统复制对应的一键配置：Windows 粘贴到 PowerShell；macOS 粘贴到“终端 Terminal”。
- 回到自己的命令行运行 Codex。
安全注意事项
- 接口钥匙不要发给别人，不要发到微信群、公开文档、GitHub。
- 密码连续输错 4 次会锁定账号，接口钥匙也会作废；需要联系管理员：353482553@qq.com。
- 页面 10 分钟不操作会自动退出。
- 成员必须使用非中国大陆网络，否则页面不显示接口钥匙，Codex 请求也会被拒绝。
- 成员输入给 AI 的完整内容会记录，请不要输入违法、涉密、隐私或不该上传的内容。
常见错误说明：Codex 里看到这些提示怎么办
| Codex/接口提示 | 人话解释 | 成员怎么处理 | 管理员怎么处理 |
|---|---|---|---|
401 invalid_api_key接口钥匙无效或已失效 | API Key 填错、复制不完整、管理员更换过钥匙、成员被禁用/锁定，或成员已经被删除。 | 重新登录成员入口，复制完整“一键配置 Codex”命令并执行；不要手动只改一部分。 | 检查该成员是否被禁用/锁定/删除；必要时“重设密码/解锁”或“更换接口钥匙”。 |
403 mainland_china_ip_blocked当前网络位置不符合要求 | 系统检测到中国大陆 IP，或 IP 位置无法确认。平台要求非中国大陆网络；香港、澳门、台湾允许。 | 切换到非中国大陆网络后重试；打开 https://ycinno.top/ip-check 看检测结果。 | 如果成员实际不在大陆但被误判，让成员提供 IP 检测截图后再排查。 |
403 path_user_mismatch服务地址和接口钥匙不是同一个成员 | Base URL 是 A 成员的，但 API Key 是 B 成员的，通常是手动拼接配置导致。 | 用自己的账号重新登录成员入口，复制整段配置，不要混用别人的地址或钥匙。 | 让成员重新领取配置；必要时更换被泄露的接口钥匙。 |
429 rate_limit_exceeded请求太频繁 | 1 分钟内请求太多，或同时开了太多 Codex 任务。 | 等 1 分钟再试；减少并发任务。 | 在后台查看该成员用量；如确实需要，可调整限额。 |
400 model_not_available所选模型暂时不可用 | 当前共享上游账号没有该模型权限，或上游代理不支持该模型。 | 改选 GPT-5.6 Sol、GPT-5.6 Terra、GPT-5.6 Luna 或 GPT-5.5；不要选 GPT-5.5 Pro。 | 在服务器上重新检查上游模型清单和真实请求结果。 |
413 request_too_large请求内容太大 | 一次性发了太多文件、日志或长文本，超过平台限制。 | 把任务拆小，文件分批交给 Codex。 | 确认是否合理；必要时调整最大请求大小。 |
| 网页版提示“文件数量过多” | 本轮对话上传的文件数量超过 20 个。 | 删减到 20 个以内，或分成多轮发送。 | 无需处理；这是为了符合 GPT 文件数量限制。 |
| 网页版提示“Extended Pro 今天已经用完” | 该成员当天的 Extended Pro 3 次额度已经用完。 | 改用 Thinking Heavy，或第二天再用 Extended Pro。 | 在“ChatGPT 网页版后台”查看该成员的当天用量。 |
upstream 401/unauthorized上游授权异常 | 服务器连接 ChatGPT/Codex 的共享上游授权可能过期，或者上游账号需要重新登录。 | 联系管理员，不要反复重试。 | 重新运行共享上游授权流程，确认 CLI Proxy 正常。 |
quota / limit / 429 上游额度限制 | 你的共享 ChatGPT/Codex 账号额度、频率或模型使用被上游限制。 | 稍后再试，或联系管理员。 | 检查上游账号额度、订阅状态和近期团队用量。 |
timeout / 502 / 503 / 504 | 网络、服务器、上游代理或 OpenAI 服务临时异常。 | 等待几分钟重试；如果持续失败，联系管理员。 | 检查服务器服务状态、共享上游池、Caddy/网关日志。 |
| 网页登录提示账号已锁定 | 网页登录密码连续输错 4 次，账号被锁定，API Key 同时作废。 | 联系管理员 353482553@qq.com 解锁。 | 在后台重设密码/解锁，必要时更换接口钥匙。 |
| 忘记密码 | 成员自己不能找回密码。 | 联系管理员重设密码。 | 后台为成员重设密码，并提醒成员首次登录后修改。 |
| 账号格式错误 | 成员账号只能以小写英文字母开头，只能包含小写字母、数字、下划线、短横线。 | 不用处理，联系管理员换账号。 | 建议用 yc001、yc002 这种编号，真实姓名写备注。 |
看到 API 错误时的快速排查顺序
- 先让成员打开
https://ycinno.top/ip-check，确认不是中国大陆 IP。 - 让成员重新登录成员入口，复制整段“一键配置 Codex”并执行。
- 管理员后台检查该成员是否被禁用、锁定、删除，或是否刚更换过接口钥匙。
- 如果多个成员同时失败，优先检查共享上游授权和服务器服务状态。
- 如果只有某一个成员失败，优先换该成员接口钥匙，并让他重新配置。