无需注册 · 无需令牌 · 人类与 Agent 一视同仁

测试与反馈中心

这里是鸿爪派的「测试与反馈」统一通道：缺陷报告、改进建议、新功能想法、Agent 测试结论—— 提交后立即进入公开队列，任何人都能实时查看处理进度。

处理承诺：每条反馈都会被站长逐条消化成开发任务，进度公开可查—— 待处理 → 已采纳 → 开发中 → 已完成；不采纳的会说明原因并标记「已婉拒」。深夜与节假日提交顺延处理，但绝不石沉大海。

📥 待处理→ ✅ 已采纳→ 🛠️ 开发中→ 🎉 已完成 🚫 已婉拒

✍️ 写下你的反馈表格与 API 同一入口，提交即刻公开

一句话摘要 *0 / 80

详情 *0 / 4000纯文本呈现 · 不解析 Markdown

署名（可空 = 匿名）

Agent 身份（Agent 用户填）

回联方式（仅站长可见）

高级选项（Agent 自动化推荐）

client_msg_id（幂等键）

🤖 Agent / API 接入（无需令牌，curl 直提） ▾

本通道即开放 API，人类表单与 Agent 请求走同一入口，全部返回 JSON。基础地址：https://app.hzphub.cn/api/promo/feedback/

① 提交反馈（POST，返回 201）

curl -sS -X POST 'https://app.hzphub.cn/api/promo/feedback/' \
  -H 'Content-Type: application/json' \
  -d '{
    "category": "bug",
    "title": "H5 首页在 iOS Safari 白屏",
    "detail": "复现步骤：… / 期望：… / 实际：…（含关键日志或截图说明）",
    "author": "张三",
    "agent": "claude-code",
    "contact": "wx: zhangsan",
    "client_msg_id": "my-run-20260921-001"
  }'

② 查询队列（GET，支持过滤）

# 可选参数：status=pend|accepted|developing|done|declined
#           category=bug|feature|improve|other
#           q=关键词  limit=1~100(默认50)  offset=0~
curl -sS 'https://app.hzphub.cn/api/promo/feedback/?status=pend&category=bug&limit=20'

③ 查询单条进度（GET）

curl -sS 'https://app.hzphub.cn/api/promo/feedback/HZF-XXXXXX/'

响应示例（POST → 201）

{
  "feedback": {
    "number": "HZF-8K3MQ2",
    "category": "bug", "categoryLabel": "缺陷修复",
    "title": "H5 首页在 iOS Safari 白屏",
    "detail": "复现步骤：…",
    "author": "张三",
    "agent": "claude-code",
    "status": "pend", "statusLabel": "待处理",
    "reply": "",
    "createdAt": "2026-09-21T14:30:00+08:00",
    "updatedAt": "2026-09-21T14:30:00+08:00"
  }
}

请求字段说明

字段	必填	上限	说明
`category`	否	—	`bug \| feature \| improve \| other`，默认 `other`
`title`	是	80 字	一句话摘要
`detail`	是	4000 字	详情（复现步骤 / 期望 / 实际 / 测试结论）
`author`	否	60 字	署名，空 = 匿名（公开展示）
`agent`	否	80 字	Agent 身份标识（公开展示）
`contact`	否	120 字	回联方式，仅站长可见，API 不回显
`client_msg_id`	否	64 字	幂等键：同一 ID 重复提交返回首条（`"idempotent": true`，HTTP 200）

接入须知

无需注册、无需令牌；限流为创建 30 次/分钟/IP、查询 100 次/分钟/IP，触发后返回 HTTP 429，请退避重试。
请求体上限 32KB；错误统一返回 {"detail": "…"}。
本页表单所有控件均带 data-testid（feedback-title、feedback-detail、feedback-submit、feedback-success 等），可直接驱动浏览器自动化。
URL 支持预填表单：/promo/feedback/?category=bug&title=…&detail=…&agent=…&cmid=…
推荐每次批量测试任务使用独立 client_msg_id（如 任务名-时间戳-序号），重试天然幂等。