visuddhinanda af76d9bd5f feat(openapi): 规格加入 /v3/discussions；v3 按路由中间件写 security		пре 4 дана
..
README.md	a45b3ed43e feat(openapi): 依据 api-v13 源码重新生成全量 API 规格	пре 4 недеља
v2-auth-current.yaml	614b5fac17 docs: v2 认证端点只剩 dashboard-v4 在用（mobile 已切 v3）	пре 1 недеља
v2-auth-forgot-password.yaml	abd07a15a2 feat: 找回密码迁到 v3 password-resets，dashboard-v6 切过去	пре 1 недеља
v2-auth-reset-password-reset-password.yaml	abd07a15a2 feat: 找回密码迁到 v3 password-resets，dashboard-v6 切过去	пре 1 недеља
v2-auth-reset-password.yaml	abd07a15a2 feat: 找回密码迁到 v3 password-resets，dashboard-v6 切过去	пре 1 недеља
v2-channel-channel.yaml	9ae69a5625 chore(openapi): 重新生成规格与前端类型	пре 3 недеља
v2-chapter.yaml	9ae69a5625 chore(openapi): 重新生成规格与前端类型	пре 3 недеља
v2-discussion-discussion.yaml	af76d9bd5f feat(openapi): 规格加入 /v3/discussions；v3 按路由中间件写 security	пре 4 дана
v2-discussion.yaml	af76d9bd5f feat(openapi): 规格加入 /v3/discussions；v3 按路由中间件写 security	пре 4 дана
v2-email-certification-email-certification.yaml	e16c5e55d8 feat: 注册迁到 v3（email-certifications / invites / users），dashboard-v6 切过去	пре 1 недеља
v2-email-certification.yaml	e16c5e55d8 feat: 注册迁到 v3（email-certifications / invites / users），dashboard-v6 切过去	пре 1 недеља
v2-invite-invite.yaml	e16c5e55d8 feat: 注册迁到 v3（email-certifications / invites / users），dashboard-v6 切过去	пре 1 недеља
v2-progress-progress.yaml	9ae69a5625 chore(openapi): 重新生成规格与前端类型	пре 3 недеља
v2-progress.yaml	9ae69a5625 chore(openapi): 重新生成规格与前端类型	пре 3 недеља
v2-sign-in.yaml	614b5fac17 docs: v2 认证端点只剩 dashboard-v4 在用（mobile 已切 v3）	пре 1 недеља
v2-sign-up.yaml	e16c5e55d8 feat: 注册迁到 v3（email-certifications / invites / users），dashboard-v6 切过去	пре 1 недеља
v3-tipitaka-reading-channel.yaml	9ae69a5625 chore(openapi): 重新生成规格与前端类型	пре 3 недеља

手写补充

resources/auto/ 全部由 openapi/scripts/generate.php 自动生成，重跑会覆盖。

首选做法不是在这里写 YAML，而是把参数说明写进控制器的文档注释（@queryParam / @bodyParam / @urlParam，见 openapi/README.md），那样说明离代码最近，改接口时不容易忘记同步。

这里只放不适合写进 PHP 注释的东西：长篇示例响应、跨接口的补充说明等。建同名文件（例如 v2-channel.yaml），内容按 OpenAPI Path Item 结构写，生成时深度合并到自动结果之上。

合并规则：同名键以 overrides 为准，数组整体替换。所以在这里写 parameters 会覆盖掉自动生成的全部参数，通常不是你想要的。