工单与支持
登录后打开 /tickets 与管理员沟通。工单适合需要订单核验、日志定位或账户上下文的问题;普通接入疑问应先查阅文档和故障排查。
创建工单
填写标题、类别、优先级和首条消息。类别包括账户、支付、API、模型、计费和其他;优先级包括低、普通、高和紧急。
一条高质量工单应包含:
- 问题发生时间和时区。
- 使用的端点、模型和分组名。
- 脱敏后的 API Key 名称,不要粘贴完整 Key。
- HTTP 状态码、错误消息和
request_id。 - 支付问题的订单号、支付方式和交易时间。
- 预期行为与实际行为,以及能稳定复现的最小步骤。
工单当前只支持文本消息。截图可先上传到可信存储并提供不含敏感信息的受控链接;不要公开对象存储凭证。
状态
| 状态 | 含义 |
|---|---|
waiting_admin | 已等待管理员处理;用户新建或回复后通常进入该状态 |
waiting_user | 管理员已回复,等待用户补充或确认 |
closed | 工单已关闭,不能直接继续回复 |
关闭后问题仍存在时可以重新打开。请优先续用原工单,避免把同一问题拆成多条而丢失上下文。
回复与未读
进入工单可查看完整消息、发送回复并标记已读。列表中的未读圆点和总数按消息 ID 计算,不依赖设备时间。管理员回复后,工单会在用户侧显示未读;用户发送自己的消息不会被计为自己的未读。
搜索和筛选
可按关键词、状态、类别和优先级筛选。搜索没有结果时先清空筛选条件,再确认关键词是否来自工单标题或文本内容。
隐私和安全
- 不要提交完整 API Key、登录密码、支付私钥、Webhook Secret 或身份证件。
- API Key 问题只需提供 Key 名称、末尾少量字符和 Key ID(页面可见时)。
- 日志应删除 Authorization、Cookie 和个人信息。
- 每个用户只能访问自己的工单;管理员通过受保护的管理入口处理。
何时使用紧急优先级
紧急优先级用于正在发生的大面积不可用、安全事件或已扣款但系统持续无法交付权益。单个模型限流、参数错误或一般配置咨询通常不应标为紧急。
