jpsclient 1.3.0 → 1.4.0

data/lib/jpsclient/api/tag.rb

@@ -1,16 +1,63 @@
 module JPSClient
   module API
     # Tag 相关 API
-    # 自动生成的模块，处理 tag 相关接口
+    # 处理标签管理相关接口
     module Tag
 
-      # Update Tag
+      # 创建标签
       #
-      # @param params [Hash] 请求参数
+      # @param params [Hash] 标签信息参数
+      #   - name: 标签名称（必需）
+      #   - type: 标签类型（必需）
+      #   - color: 标签颜色（可选）
+      #   - description: 标签描述（可选）
+      # @return [Hash] API响应
+      def create_tag(params: {})
+        config = @request_config && @request_config["tag_create"]
+        raise JPSClient::ExceptionError, "Missing config for tag_create" unless config && config["url"]
+
+        # 参数验证
+        required_fields = [:name, :type]
+        missing_fields = required_fields.select { |field| params[field].nil? || params[field].to_s.empty? }
+
+        if missing_fields.any?
+          raise JPSClient::ExceptionError, "Missing required fields: #{missing_fields.join(', ')}"
+        end
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 更新标签
+      #
+      # @param params [Hash] 更新参数
+      #   - tagId: 标签ID（必需）
+      #   - name: 标签名称（必需）
+      #   - type: 标签类型（必需）
+      #   - color: 标签颜色（可选）
+      #   - description: 标签描述（可选）
       # @return [Hash] API响应
       def update_tag(params: {})
-        config = @request_config && @request_config["tag_tag"]
-        raise JPSClient::ExceptionError, "Missing config for tag_tag" unless config && config["url"]
+        config = @request_config && @request_config["tag_update"]
+        raise JPSClient::ExceptionError, "Missing config for tag_update" unless config && config["url"]
+
+        # 参数验证
+        required_fields = [:tagId, :name, :type]
+        missing_fields = required_fields.select { |field| params[field].nil? || params[field].to_s.empty? }
+
+        if missing_fields.any?
+          raise JPSClient::ExceptionError, "Missing required fields: #{missing_fields.join(', ')}"
+        end
 
         path = config["url"]
 
@@ -26,37 +73,49 @@ module JPSClient
         return result.to_h
       end
 
-      # Create Tag
+      # 删除标签
       #
-      # @param params [Hash] 请求参数
+      # @param tagId [String, Integer] 标签ID（必需）
       # @return [Hash] API响应
-      def create_tag(params: {})
-        config = @request_config && @request_config["tag_tag"]
-        raise JPSClient::ExceptionError, "Missing config for tag_tag" unless config && config["url"]
+      def delete_tag(tagId:)
+        config = @request_config && @request_config["tag_delete"]
+        raise JPSClient::ExceptionError, "Missing config for tag_delete" unless config && config["url"]
 
-        path = config["url"]
+        path = config["url"].gsub("{tagId}", tagId.to_s)
 
-        response = @http_client.post(path, body: params)
+        response = @http_client.delete(path)
         result = JPSClient::Response.new(response)
 
         if result.need_login?
           do_login(force_login: true)
-          response = @http_client.post(path, body: params)
+          response = @http_client.delete(path)
           result = JPSClient::Response.new(response)
         end
 
         return result.to_h
       end
 
-      # Create Weights
+      # 更新标签权重
       #
-      # @param params [Hash] 请求参数
+      # @param weights [Array<Hash>] 权重数组
+      #   每个项包含：
+      #   - id: 标签ID
+      #   - weight: 权重值
+      #   - name: 标签名称
+      #   - type: 标签类型
+      #   - color: 标签颜色（可选）
+      #   - description: 标签描述（可选）
       # @return [Hash] API响应
-      def create_weights(params: {})
+      def update_tag_weights(weights: [])
         config = @request_config && @request_config["tag_weights"]
         raise JPSClient::ExceptionError, "Missing config for tag_weights" unless config && config["url"]
 
+        if weights.empty?
+          raise JPSClient::ExceptionError, "Weights array cannot be empty"
+        end
+
         path = config["url"]
+        params = { weights: weights }
 
         response = @http_client.post(path, body: params)
         result = JPSClient::Response.new(response)
@@ -70,13 +129,20 @@ module JPSClient
         return result.to_h
       end
 
-      # Get Tags
+      # 获取标签列表
       #
-      # @param params [Hash] 请求参数
+      # @param params [Hash] 查询参数
+      #   - page: 页码（可选）
+      #   - type: 标签类型（必需）
       # @return [Hash] API响应
       def get_tags(params: {})
-        config = @request_config && @request_config["tag_tags"]
-        raise JPSClient::ExceptionError, "Missing config for tag_tags" unless config && config["url"]
+        config = @request_config && @request_config["tag_list"]
+        raise JPSClient::ExceptionError, "Missing config for tag_list" unless config && config["url"]
+
+        # type 参数是必需的
+        unless params[:type] || params["type"]
+          raise JPSClient::ExceptionError, "Missing required parameter: type"
+        end
 
         path = config["url"]
 
@@ -92,51 +158,207 @@ module JPSClient
         return result.to_h
       end
 
-      # Get Resources Detail
+      # 获取标签关联的资源
       #
-      # @param params [Hash] 请求参数
-      # @return [Hash] API响应
-      def get_resources_detail(tagId:, params: {})
-        config = @request_config && @request_config["tag_resources_detail"]
-        raise JPSClient::ExceptionError, "Missing config for tag_resources_detail" unless config && config["url"]
+      # @param tagId [String, Integer] 标签ID（必需）
+      # @return [Hash] API响应，包含applications和ideas数组
+      def get_tag_resources(tagId:)
+        config = @request_config && @request_config["tag_resources"]
+        raise JPSClient::ExceptionError, "Missing config for tag_resources" unless config && config["url"]
 
-        path = config["url"]
-        path = path.gsub("{tagId}", tagId.to_s)
+        path = config["url"].gsub("{tagId}", tagId.to_s)
 
-        response = @http_client.get(path, params: params)
+        response = @http_client.get(path)
         result = JPSClient::Response.new(response)
 
         if result.need_login?
           do_login(force_login: true)
-          response = @http_client.get(path, params: params)
+          response = @http_client.get(path)
           result = JPSClient::Response.new(response)
         end
 
         return result.to_h
       end
 
-      # Delete Tag
+      # 便捷方法：按类型获取标签
       #
-      # @param params [Hash] 请求参数
+      # @param type [String] 标签类型
+      # @param page [Integer] 页码（可选）
       # @return [Hash] API响应
-      def delete_tag(tagId:, params: {})
-        config = @request_config && @request_config["tag_tag"]
-        raise JPSClient::ExceptionError, "Missing config for tag_tag" unless config && config["url"]
+      def get_tags_by_type(type:, page: nil)
+        params = { type: type }
+        params[:page] = page if page
+        get_tags(params: params)
+      end
 
-        path = config["url"]
-        path = path.gsub("{tagId}", tagId.to_s)
+      # 便捷方法：批量创建标签
+      # 注意：此方法会逐个调用 API，返回结果数组
+      #
+      # @param tags [Array<Hash>] 标签数组
+      # @return [Array<Hash>] 每个请求的响应结果
+      def batch_create_tags(tags: [])
+        return [] if tags.empty?
 
-        response = @http_client.delete(path)
-        result = JPSClient::Response.new(response)
+        results = []
+        tags.each do |tag_params|
+          result = create_tag(params: tag_params)
+          results << result
+        end
 
-        if result.need_login?
-          do_login(force_login: true)
-          response = @http_client.delete(path)
-          result = JPSClient::Response.new(response)
+        results
+      end
+
+      # 便捷方法：按颜色筛选标签
+      # 获取指定类型的标签，然后在客户端筛选颜色
+      #
+      # @param type [String] 标签类型（必需）
+      # @param color [String] 标签颜色
+      # @return [Array<Hash>] 符合条件的标签数组
+      def get_tags_by_color(type:, color:)
+        response = get_tags(params: { type: type })
+
+        # 如果请求失败，返回空数组
+        return [] unless response && response['data']
+
+        tags = response['data']['tags'] || response['data'][:tags] || []
+        tags.select { |tag|
+          (tag['color'] || tag[:color]) == color
+        }
+      end
+
+      # 便捷方法：搜索标签
+      # 获取指定类型的标签，然后在客户端搜索
+      #
+      # @param type [String] 标签类型（必需）
+      # @param keyword [String] 搜索关键词
+      # @return [Array<Hash>] 符合搜索条件的标签数组
+      def search_tags(type:, keyword:)
+        response = get_tags(params: { type: type })
+
+        # 如果请求失败，返回空数组
+        return [] unless response && response['data']
+
+        tags = response['data']['tags'] || response['data'][:tags] || []
+        tags.select { |tag|
+          name = (tag['name'] || tag[:name] || "").to_s
+          description = (tag['description'] || tag[:description] || "").to_s
+          name.include?(keyword) || description.include?(keyword)
+        }
+      end
+
+      # 便捷方法：获取标签的应用列表
+      #
+      # @param tagId [String, Integer] 标签ID
+      # @return [Array] 应用列表
+      def get_tag_applications(tagId:)
+        response = get_tag_resources(tagId: tagId)
+
+        # 如果请求失败，返回空数组
+        return [] unless response && response['data']
+
+        response['data']['applications'] || response['data'][:applications] || []
+      end
+
+      # 便捷方法：获取标签的创意列表
+      #
+      # @param tagId [String, Integer] 标签ID
+      # @return [Array] 创意列表
+      def get_tag_ideas(tagId:)
+        response = get_tag_resources(tagId: tagId)
+
+        # 如果请求失败，返回空数组
+        return [] unless response && response['data']
+
+        response['data']['ideas'] || response['data'][:ideas] || []
+      end
+
+      # 批量更新标签权重（便捷方法）
+      #
+      # @param tag_weights [Hash] 标签ID到权重的映射
+      #   例如: { "1" => 100, "2" => 90, "3" => 80 }
+      # @param type [String] 标签类型
+      # @return [Hash] API响应
+      def batch_update_weights(tag_weights: {}, type:)
+        return update_tag_weights(weights: []) if tag_weights.empty?
+
+        # 先获取所有标签信息
+        response = get_tags(params: { type: type })
+
+        # 如果获取标签失败，直接返回错误响应
+        return response unless response && response['data']
+
+        tags = response['data']['tags'] || response['data'][:tags] || []
+        weights_array = []
+
+        tag_weights.each do |tag_id, weight|
+          tag = tags.find { |t| (t['id'] || t[:id]).to_s == tag_id.to_s }
+          if tag
+            weights_array << {
+              id: tag['id'] || tag[:id],
+              weight: weight,
+              name: tag['name'] || tag[:name],
+              type: tag['type'] || tag[:type],
+              color: tag['color'] || tag[:color],
+              description: tag['description'] || tag[:description]
+            }
+          end
         end
 
-        return result.to_h
+        # 如果没有找到任何有效标签，返回空权重数组的更新（将由API处理错误）
+        update_tag_weights(weights: weights_array)
+      end
+
+      # 复制标签
+      # 注意：此功能需要先获取标签详情，然后创建新标签
+      #
+      # @param tagId [String, Integer] 源标签ID
+      # @param new_name [String] 新标签名称
+      # @param tag_type [String] 标签类型（如果能提供）
+      # @return [Hash] API响应
+      def copy_tag(tagId:, new_name:, tag_type: nil)
+        # 由于没有获取单个标签详情的API，此方法暂时无法实现
+        # 建议使用 get_tags 获取标签列表后在客户端查找并复制
+        raise JPSClient::ExceptionError, "Copy tag feature requires get_tag_detail API which is not available"
       end
+
+      # 标签统计信息
+      # 获取标签并计算统计数据
+      #
+      # @param type [String] 标签类型
+      # @return [Hash] 包含统计数据的哈希
+      def get_tags_statistics(type:)
+        response = get_tags(params: { type: type })
+
+        # 如果请求失败，返回空统计
+        unless response && response['data']
+          return {
+            total_count: 0,
+            tags_with_resources: 0,
+            empty_tags: 0,
+            color_distribution: {},
+            top_used: []
+          }
+        end
+
+        tags = response['data']['tags'] || response['data'][:tags] || []
+
+        {
+          total_count: tags.size,
+          tags_with_resources: tags.count { |t|
+            (t['relatedCount'] || t[:relatedCount] || 0) > 0
+          },
+          empty_tags: tags.count { |t|
+            (t['relatedCount'] || t[:relatedCount] || 0) == 0
+          },
+          color_distribution: tags.group_by { |t|
+            t['color'] || t[:color] || "no_color"
+          }.transform_values(&:size),
+          top_used: tags.sort_by { |t|
+            -(t['relatedCount'] || t[:relatedCount] || 0)
+          }.first(10)
+        }
+      end
+
     end
   end
-end
+end

data/lib/jpsclient/api/template.rb

@@ -0,0 +1,216 @@
+module JPSClient
+  module API
+    # Template 相关 API
+    # 处理模板管理相关接口
+    module Template
+
+      # 获取模板列表
+      #
+      # @param params [Hash] 请求参数
+      #   - page: 页码（默认1）
+      #   - pageSize: 每页数量（默认10）
+      #   - type: 模板类型（可选）
+      #   - name: 模板名称（可选，用于搜索）
+      # @return [Hash] API响应
+      def get_template_list(params: {})
+        config = @request_config && @request_config["template_list"]
+        raise JPSClient::ExceptionError, "Missing config for template_list" unless config && config["url"]
+
+        path = config["url"]
+
+        # 设置默认值
+        default_params = {
+          page: 1,
+          pageSize: 10
+        }
+        params = default_params.merge(params)
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取模板详情
+      #
+      # @param id [String, Integer] 模板ID（必需）
+      # @return [Hash] API响应
+      def get_template_detail(id:)
+        config = @request_config && @request_config["template_detail"]
+        raise JPSClient::ExceptionError, "Missing config for template_detail" unless config && config["url"]
+
+        path = config["url"]
+
+        # GET请求，ID作为查询参数
+        params = { id: id }
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 创建模板
+      #
+      # @param params [Hash] 模板信息参数
+      #   - name: 模板名称（必需）
+      #   - type: 模板类型（必需）
+      #   - content: 模板内容（必需）
+      #   - description: 模板描述（可选）
+      # @return [Hash] API响应
+      def create_template(params: {})
+        config = @request_config && @request_config["template_create"]
+        raise JPSClient::ExceptionError, "Missing config for template_create" unless config && config["url"]
+
+        # 参数验证
+        required_fields = [:name, :type, :content]
+        missing_fields = required_fields.select { |field| params[field].nil? || params[field].to_s.empty? }
+
+        if missing_fields.any?
+          raise JPSClient::ExceptionError, "Missing required fields: #{missing_fields.join(', ')}"
+        end
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 更新模板
+      #
+      # @param params [Hash] 更新参数
+      #   - id: 模板ID（必需）
+      #   - name: 模板名称
+      #   - type: 模板类型
+      #   - content: 模板内容
+      #   - description: 模板描述
+      # @return [Hash] API响应
+      def update_template(params: {})
+        config = @request_config && @request_config["template_update"]
+        raise JPSClient::ExceptionError, "Missing config for template_update" unless config && config["url"]
+
+        # ID 是必需的
+        raise JPSClient::ExceptionError, "Missing required field: id" unless params[:id]
+
+        path = config["url"]
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 删除模板
+      #
+      # @param id [String, Integer] 模板ID（必需）
+      # @return [Hash] API响应
+      def delete_template(id:)
+        config = @request_config && @request_config["template_delete"]
+        raise JPSClient::ExceptionError, "Missing config for template_delete" unless config && config["url"]
+
+        path = config["url"]
+
+        # POST请求，ID作为body参数
+        params = { id: id }
+
+        response = @http_client.post(path, body: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 批量获取模板（扩展方法）
+      # 注意：此方法会逐个调用 API，返回结果数组
+      #
+      # @param ids [Array<String, Integer>] 模板ID列表
+      # @return [Array<Hash>] 每个请求的响应结果
+      def get_templates_by_ids(ids: [])
+        return [] if ids.empty?
+
+        results = []
+        ids.each do |id|
+          result = get_template_detail(id: id)
+          results << result
+        end
+
+        results
+      end
+
+      # 按类型获取模板列表（便捷方法）
+      #
+      # @param type [String] 模板类型（message, document, email, report, other）
+      # @param params [Hash] 其他查询参数
+      # @return [Hash] API响应
+      def get_templates_by_type(type:, params: {})
+        params[:type] = type
+        get_template_list(params: params)
+      end
+
+      # 搜索模板（便捷方法）
+      #
+      # @param keyword [String] 搜索关键词
+      # @param params [Hash] 其他查询参数
+      # @return [Hash] API响应
+      def search_templates(keyword:, params: {})
+        params[:name] = keyword
+        get_template_list(params: params)
+      end
+
+      # 复制模板（创建模板副本）
+      #
+      # @param template_id [String, Integer] 源模板ID
+      # @param new_name [String] 新模板名称
+      # @return [Hash] API响应
+      def copy_template(template_id:, new_name:)
+        # 先获取原模板
+        original = get_template_detail(id: template_id)
+
+        # 如果获取失败，直接返回错误响应
+        return original unless original && original['data']
+
+        template_data = original['data']
+
+        # 创建新模板
+        create_template(params: {
+          name: new_name,
+          type: template_data['type'] || template_data[:type],
+          content: template_data['content'] || template_data[:content],
+          description: "Copy of #{template_data['name'] || template_data[:name]}: #{template_data['description'] || template_data[:description]}"
+        })
+      end
+
+    end
+  end
+end

data/lib/jpsclient/auth/auth.rb

@@ -281,7 +281,7 @@ module JPSClient
           result = JSON.parse(response.body)
           puts "API 响应: #{result.inspect}" if @verbose
 
-          if result['meta'] && result['meta']['code'] == 200 && result['data']
+          if result['meta'] && result['meta']['code'] == 0 && result['data']
             data = result['data']
             @access_token = data['token'] if data['token']
             @username = data['username'] if data['username']

data/lib/jpsclient/http/http_client.rb

@@ -120,9 +120,17 @@ module JPSClient
       @need_login = http_response[:need_login]
 
       if http_response[:body].is_a?(Hash)
-        @code = http_response[:body]['code'] || http_response[:code]
-        @data = http_response[:body]['data']
-        @msg = http_response[:body]['msg'] || http_response[:body]['message']
+        # 处理 Meta 格式响应: {meta: {code: 0, message: "..."}, data: {...}}
+        if http_response[:body]['meta']
+          @code = http_response[:body]['meta']['code']
+          @msg = http_response[:body]['meta']['message']
+          @data = http_response[:body]['data']
+        # 处理直接格式响应: {code: 0, data: {...}, msg: "..."}
+        else
+          @code = http_response[:body]['code'] || http_response[:code]
+          @data = http_response[:body]['data']
+          @msg = http_response[:body]['msg'] || http_response[:body]['message']
+        end
       else
         @code = http_response[:code]
         @data = http_response[:body]
@@ -130,7 +138,8 @@ module JPSClient
     end
 
     def success?
-      @success && @code.to_s == '200'
+      # 成功码从 200 改为 0，同时向后兼容 200
+      @success && (@code.to_s == '0' || @code.to_s == '200')
     end
 
     def need_login?
@@ -144,5 +153,16 @@ module JPSClient
         'msg' => @msg
       }
     end
+
+    # 添加新方法返回 meta 格式响应
+    def to_h_with_meta
+      {
+        'meta' => {
+          'code' => @code,
+          'message' => @msg
+        },
+        'data' => @data
+      }
+    end
   end
 end

data/lib/jpsclient/upload/upload_client.rb

@@ -139,7 +139,7 @@ module JPSClient
               upload_config: @upload_config
           )
 
-          if complete_result && complete_result["code"] == 200
+          if complete_result && (complete_result["code"] == 0 || complete_result["code"] == 200)
               # 返回 URL 字符串以保持向后兼容
               upload_result = complete_result.dig("data", "url") || s3_key
               Logger.instance.fancyinfo_success("文件#{@upload_binary_file} 上传成功! 😎😎😎")

data/lib/jpsclient/version.rb

@@ -1,3 +1,3 @@
 module JPSClient
-  VERSION = "1.3.0"
+  VERSION = "1.4.0"
 end