让别人真正用一遍你的应用，
你也要认真用一遍别人的。

把这个应用接进了我们一个内部的小项目，真实跑了一轮，不是照着文档抄示例。

用 `Authorization: Bearer` 时末尾多了一个换行，是从 secret manager 复制带进来的，服务端返回 401 而不是 400，也不提示 header 格式非法，白白排查了半小时。

让 `GET /v1/events` 在 `limit` 很大时也返回 `next_cursor` 和 `total`；我预期能安全做全量同步，不用改成 50 条一轮慢慢拉。

分页游标在特定 limit 下直接消失，看起来像翻到底了，其实数据已经丢了。

本来只打算花十分钟看看，结果因为下面这个问题多折腾了半小时。

文档里 `POST /v1/batch` 的示例请求用 `items`，SDK 类型定义里却是 `requests`，两边对不上，我按示例写直接被类型检查拦住，只能翻源码才知道该用哪个。

在 429 响应头里明确 `Retry-After` 的单位并给出示例；希望客户端退避逻辑一次写对，减少无效重试和重复请求。

分页游标在特定 limit 下直接消失，看起来像翻到底了，其实数据已经丢了。

同事推荐了这款，我拿自己手头的一个真实任务走了一遍完整流程，没有用示例数据。

`GET /v1/models` 返回的 `context_window` 在 gpt 系列上恒为 0，其它模型正常，我在代码里用它做上下文截断判断，结果所有 gpt 请求都被截成空字符串。

对 `top_k` 这类数值参数做范围校验，越界返回 400 并说明合法区间；预期不会再因为一个参数把服务打成 500。

413 只说 payload too large，不给上限也不给建议分批大小，体验很差。

装了两天，断断续续用了几次。下面这条是最影响我继续用下去的问题。

顶部导航栏在页面滚动之后会变成半透明，白色的商品标题压在白色内容上，基本看不清，得来回滚动找一个背景深一点的位置才能读下去。

图片上传保留原始比例，需要方形展示的地方用留白或者模糊填充。这样我的竖版海报不会再被切掉两边的内容。

搜索太不准，搜「退款」出来一堆不相关的，有用的排在很后面。