docs: add comprehensive client API reference

README.md

@@ -1,6 +1,6 @@
 # BSM Infra Full
 
-BSM 后端服务 Go workspace，包含 19 个独立业务模块和一个统一端口运行的 all 聚合模块。Go 版本为 1.26.5。
+BSM 后端服务 Go workspace，包含 19 个独立业务模块和一个使用独立 gRPC/HTTP 端口的 all 聚合模块。Go 版本为 1.26.5。
 
 ## 快速开始
 
@@ -53,10 +53,12 @@ Services 配置决定 all 启用哪些服务；BSM_SERVICES 环境变量可临
 | scripts/build-all-linux.sh | 构建 Linux amd64 独立服务 |
 | scripts/generate-protobuf.sh | 重新生成 protobuf |
 | scripts/update-all.sh | 更新全部依赖，执行后必须审阅差异 |
+| scripts/api-docgen | 从 protobuf descriptor 重新生成客户端 API 文档 |
 
 ## 文档
 
 - [Wiki 索引](wiki/README.md)
+- [API 接入与模块文档](wiki/api/00-overview.md)
 - [系统架构](wiki/architecture.md)
 - [开发与运维](wiki/operations.md)
 - [审计报告](wiki/audit-2026-08-10.md)