Skip to content

Commit ce602e9

Browse files
committed
feat(publish-website): 加查询审核状态接口 + 引导用户主动询问
8c 反馈话术尾巴增加一句:「如果想了解审核状态,可在这里询问, 我会查询并告诉你」(两种 ticket 分支都加)。 新增章节「查询审核状态」: - GET /v1/status?client_id=...&ticket=... (双键校验) - 字段说明: status / kind / block_resubmit / takedown_reason / last_deployed_at - 四种状态对应的反馈话术: pending_review / online / rejected / offline - 硬约束: 仅用户主动询问时调用、不得轮询、不得猜原因、 不暴露 raw JSON
1 parent 317e040 commit ce602e9

1 file changed

Lines changed: 46 additions & 0 deletions

File tree

  • .ai-ready/skills/publish-website

‎.ai-ready/skills/publish-website/SKILL.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -570,6 +570,8 @@ curl -f -X POST \
570570
应用已提交发布,预览地址:
571571
572572
<site_url>
573+
574+
应用上线前需经过管理员审核。如果想了解审核状态,可在这里询问,我会查询并告诉你。
573575
```
574576

575577
**若服务端返回的 `data.ticket` 与请求中携带的 `ticket` 不同**:
@@ -581,12 +583,56 @@ curl -f -X POST \
581583
582584
本应用的更新凭证 ticket 为:`<new_ticket>`
583585
后续如需继续更新本应用,请在新会话中向我提供此 ticket。
586+
587+
应用上线前需经过管理员审核。如果想了解审核状态,可在这里询问,我会查询并告诉你。
584588
```
585589

586590
失败时报告 HTTP 状态码与 `data.message`,**不得**编造应用地址。
587591

588592
---
589593

594+
## 查询审核状态(用户主动询问时执行)
595+
596+
用户在本会话内询问审核 / 上线 / 拒绝原因 / 下线原因等问题时,调用:
597+
598+
```
599+
GET https://ugc-submit.showcase.monkeycode-ai.online/v1/status?client_id=<client_id>&ticket=<ticket>
600+
```
601+
602+
- `client_id`:步骤 1 `hostname` 拿到的值;**必须**与提交时一致
603+
- `ticket`:会话内已缓存的 `ticket`
604+
605+
服务端用 `ticket` 找 site,再校验 `client_id` 与该 site 匹配;两者其中之一对不上即返回 404 `site_not_found`。
606+
607+
### 响应字段
608+
609+
成功时返回 `{ code: 0, data: {...} }`,`data` 字段:
610+
611+
| 字段 | 类型 | 说明 |
612+
|---|---|---|
613+
| `slug` | string | 应用 slug |
614+
| `status` | string | `pending_review` / `online` / `offline` / `rejected` |
615+
| `kind` | string | `static` / `backend` |
616+
| `block_resubmit` | bool | 当为 `true` 时同 `client_id` 已被禁止再次提交,再调 `/v1/create` 会得到 403 `resubmit_blocked` |
617+
| `takedown_reason` | string(可选) | 管理员在拒绝 / 下线时填写的原因;`status` 为 `rejected` 或 `offline` 时一般存在 |
618+
| `last_deployed_at` | int64(可选) | 上次部署的毫秒时间戳 |
619+
620+
### 向用户反馈的话术
621+
622+
按 `status` 分四类:
623+
624+
- `pending_review` → "应用已提交,审核中。"
625+
- `online` → "审核已通过,应用已上线,访问地址:`<site_url>`"
626+
- `rejected` → "审核未通过。" + 如有 `takedown_reason` 加上 "原因:`<takedown_reason>`"。如果 `block_resubmit=true`,告知用户「管理员已禁止当前 client_id 再次提交本应用」
627+
- `offline` → "应用已下线。" + 如有 `takedown_reason` 加上 "原因:`<takedown_reason>`"
628+
629+
**禁止**:
630+
- 不得主动轮询本接口;只有用户提问时才调用
631+
- 不得猜测原因;`takedown_reason` 为空时只能说"管理员未填写原因"
632+
- 不得在反馈中暴露 `slug` 以外的 raw JSON
633+
634+
---
635+
590636
## 硬性规则(必须遵守)
591637

592638
### 通用

0 commit comments

Comments
 (0)