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

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

apps/api/internal/httpapi/config_handlers.go

@@ -5,6 +5,16 @@ import (
 	"strings"
 )
 
+// getNetworkProxyConfig godoc
+// @Summary 获取网络代理配置
+// @Description 管理端查看服务当前使用的全局 HTTP 代理配置及来源。
+// @Tags config
+// @Produce json
+// @Security BearerAuth
+// @Success 200 {object} NetworkProxyConfigResponse
+// @Failure 401 {object} ErrorEnvelope
+// @Failure 403 {object} ErrorEnvelope
+// @Router /api/admin/config/network-proxy [get]
 func (s *Server) getNetworkProxyConfig(w http.ResponseWriter, r *http.Request) {
 	globalHTTPProxy := strings.TrimSpace(s.cfg.GlobalHTTPProxy)
 	writeJSON(w, http.StatusOK, map[string]any{