WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

internal/handler/weknoracloud.go

@@ -0,0 +1,75 @@
+package handler
+
+import (
+	"net/http"
+
+	"github.com/Tencent/WeKnora/internal/types/interfaces"
+	"github.com/gin-gonic/gin"
+)
+
+// WeKnoraCloudHandler 处理 WeKnoraCloud 凭证管理
+type WeKnoraCloudHandler struct {
+	svc interfaces.WeKnoraCloudService
+}
+
+// NewWeKnoraCloudHandler 构造函数
+func NewWeKnoraCloudHandler(svc interfaces.WeKnoraCloudService) *WeKnoraCloudHandler {
+	return &WeKnoraCloudHandler{svc: svc}
+}
+
+type weKnoraCloudCredentialsRequest struct {
+	AppID     string `json:"app_id"     binding:"required"`
+	AppSecret string `json:"app_secret" binding:"required"`
+}
+
+// SaveCredentials POST /api/v1/weknoracloud/credentials
+// 仅保存 APPID/APPSECRET 凭证到空间配置，不自动创建模型
+//
+// SaveCredentials godoc
+// @Summary      保存 WeKnoraCloud 凭证
+// @Description  保存 APPID/APPSECRET 到当前空间配置（不自动创建模型）
+// @Tags         WeKnoraCloud
+// @Accept       json
+// @Produce      json
+// @Param        request  body      map[string]interface{}  true  "{app_id, app_secret}"
+// @Success      200      {object}  map[string]interface{}  "success: true"
+// @Failure      400      {object}  map[string]interface{}  "请求参数错误"
+// @Security     Bearer
+// @Security     ApiKeyAuth
+// @Router       /weknoracloud/credentials [post]
+func (h *WeKnoraCloudHandler) SaveCredentials(c *gin.Context) {
+	var req weKnoraCloudCredentialsRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	if err := h.svc.SaveCredentials(c.Request.Context(), req.AppID, req.AppSecret); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "凭证保存成功"})
+}
+
+// Status GET /api/v1/models/weknoracloud/status
+// 检查当前空间的 WeKnoraCloud 凭证是否完好，如需重新初始化则返回 needs_reinit=true
+//
+// Status godoc
+// @Summary      检查 WeKnoraCloud 凭证状态
+// @Description  检查当前空间的 WeKnoraCloud 凭证是否完好；needs_reinit=true 表示需要重新保存
+// @Tags         WeKnoraCloud
+// @Produce      json
+// @Success      200  {object}  map[string]interface{}  "凭证状态"
+// @Failure      500  {object}  map[string]interface{}  "服务器错误"
+// @Security     Bearer
+// @Security     ApiKeyAuth
+// @Router       /models/weknoracloud/status [get]
+func (h *WeKnoraCloudHandler) Status(c *gin.Context) {
+	result, err := h.svc.CheckStatus(c.Request.Context())
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, result)
+}