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

internal/handler/skill_handler.go

@@ -0,0 +1,94 @@
+package handler
+
+import (
+	"context"
+	"net/http"
+
+	"github.com/Tencent/WeKnora/internal/application/service"
+	"github.com/Tencent/WeKnora/internal/types"
+	"github.com/gin-gonic/gin"
+)
+
+// usableSkillLister returns the installed skills a chat turn can actually
+// invoke on one sandbox config. The @ picker and the agent editor both read
+// this set so they cannot offer a skill the running image does not carry.
+type usableSkillLister interface {
+	ListUsableSkills(ctx context.Context, tenantID uint64, configID string) []*types.TenantSkillEntity
+}
+
+// SkillHandler handles skill-related HTTP requests
+type SkillHandler struct {
+	usableSkills usableSkillLister
+	catalog      skillCatalogService
+	instructions *service.InstructionSkillService
+}
+
+func (h *SkillHandler) SetInstructionService(s *service.InstructionSkillService) { h.instructions = s }
+
+type skillCatalogService interface {
+	ListCatalog(ctx context.Context, tenantID uint64) ([]service.SkillCatalogView, error)
+	RegisterCatalogFromArchive(ctx context.Context, tenantID uint64, archive []byte) (*types.TenantSkillCatalogEntity, error)
+	RegisterCatalogFromSource(ctx context.Context, tenantID uint64, source string) (*types.TenantSkillCatalogEntity, error)
+	InstallCatalogToConfigs(ctx context.Context, tenantID uint64, catalogID string, configIDs []string) (*service.CatalogInstallResult, error)
+	DeleteCatalog(ctx context.Context, tenantID uint64, catalogID string) error
+	ListCatalogFiles(ctx context.Context, tenantID uint64, catalogID string) ([]service.SkillFileEntry, error)
+	ReadCatalogFile(ctx context.Context, tenantID uint64, catalogID, relativePath string) (*service.SkillFileContent, error)
+}
+
+// NewSkillHandler creates a new skill handler. catalog may be nil in tests
+// that only exercise the chat picker.
+func NewSkillHandler(usableSkills usableSkillLister, catalog skillCatalogService) *SkillHandler {
+	return &SkillHandler{
+		usableSkills: usableSkills,
+		catalog:      catalog,
+	}
+}
+
+// SkillInfoResponse represents the skill info returned to frontend
+type SkillInfoResponse struct {
+	Name        string `json:"name"`
+	Description string `json:"description"`
+}
+
+// ListSkills godoc
+// @Summary      获取当前沙箱配置上可执行的 Skills
+// @Description  返回指定沙箱配置镜像内、智能体实际能调用的已安装技能（ready 且启用）。不传 sandbox_config_id 时列表为空。
+// @Tags         Skills
+// @Accept       json
+// @Produce      json
+// @Param        sandbox_config_id  query     string  false  "Sandbox config ID"
+// @Success      200  {object}  map[string]interface{}  "Skills列表"
+// @Security     Bearer
+// @Security     ApiKeyAuth
+// @Router       /skills [get]
+func (h *SkillHandler) ListSkills(c *gin.Context) {
+	configID := c.Query("sandbox_config_id")
+	if configID == "" || h.usableSkills == nil {
+		c.JSON(http.StatusOK, gin.H{
+			"success":          true,
+			"data":             []SkillInfoResponse{},
+			"skills_available": false,
+		})
+		return
+	}
+
+	rows := h.usableSkills.ListUsableSkills(
+		c.Request.Context(), sandboxConfigTenantID(c), configID,
+	)
+	response := make([]SkillInfoResponse, 0, len(rows))
+	for _, row := range rows {
+		if row == nil {
+			continue
+		}
+		response = append(response, SkillInfoResponse{
+			Name:        row.Name,
+			Description: row.Description,
+		})
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"success":          true,
+		"data":             response,
+		"skills_available": true,
+	})
+}