docs(api): 补全 OpenAPI 注释与生成文档

为接口、模型与脚本补齐 Swagger/OpenAPI 注释，生成最新文档，并增加一键生成与查看入口。

README.md

@@ -43,6 +43,15 @@ pnpm dev
 
 后端热更新可通过 `GO_WATCH_SHUTDOWN_GRACE_MS` 和 `GO_WATCH_RESTART_DELAY_MS` 调整旧进程退出等待时间与重启间隔。
 
+## OpenAPI 文档
+
+修改 `apps/api/internal/httpapi` 下的接口、请求或响应类型后，请重新执行：
+
+```bash
+pnpm openapi
+```
+
+
 默认 EasyAI 部署里，`easyai-pgvector` 在容器网络内的连接串是：
 
 ```dotenv