{ "swagger": "2.0", "info": { "contact": {} }, "paths": { "/api/file_proxy": { "get": { "description": "代理访问文件，解决 MinIO 内网和 HTTPS 问题", "consumes": [ "application/json" ], "produces": [ "application/octet-stream" ], "tags": [ "文件上传" ], "summary": "代理文件访问", "parameters": [ { "type": "string", "description": "文件Key", "name": "key", "in": "query", "required": true }, { "type": "string", "description": "知识库ID", "name": "kb_id", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "file" } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/file_upload": { "post": { "description": "上传文件到服务器（本地存储或MinIO）", "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "文件上传" ], "summary": "上传文件", "parameters": [ { "type": "file", "description": "要上传的文件", "name": "file", "in": "formData", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/file_upload/{filename}": { "delete": { "description": "删除指定文件", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "文件上传" ], "summary": "删除文件", "parameters": [ { "type": "string", "description": "文件名", "name": "filename", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/create": { "post": { "description": "创建一个新的知识库", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "创建知识库", "parameters": [ { "description": "知识库信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.CreateKnowledgeRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/list": { "get": { "description": "获取所有知识库列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "获取知识库列表", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/{id}": { "get": { "description": "根据ID获取知识库详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "获取知识库详情", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "put": { "description": "更新指定知识库的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "更新知识库", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.UpdateKnowledgeRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "delete": { "description": "删除指定的知识库", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "删除知识库", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/{id}/documents": { "get": { "description": "获取指定知识库下的所有文档", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "获取知识库文档列表", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "文档状态筛选", "name": "status", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "post": { "description": "上传文档到指定知识库", "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "上传文档", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true }, { "type": "file", "description": "文档文件", "name": "file", "in": "formData", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/{id}/documents/{doc_id}": { "delete": { "description": "删除知识库中的指定文档", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "删除文档", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "文档ID", "name": "doc_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/{id}/documents/{doc_id}/preview": { "get": { "description": "获取文档的解析预览内容", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "获取文档预览", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "文档ID", "name": "doc_id", "in": "path", "required": true }, { "type": "integer", "description": "页码", "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/api/knowledge/{id}/documents/{doc_id}/reparse": { "post": { "description": "重新解析指定文档（用于更新解析结果）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "知识库" ], "summary": "重新解析文档", "parameters": [ { "type": "string", "description": "知识库ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "文档ID", "name": "doc_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/auth/login": { "post": { "description": "用户登录并获取 JWT Token", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "认证" ], "summary": "用户登录", "parameters": [ { "description": "登录请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handler.LoginRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handler.LoginResponse" } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "401": { "description": "Unauthorized", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/auth/me": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取已登录用户的详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "认证" ], "summary": "获取当前用户信息", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "401": { "description": "Unauthorized", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/auth/register": { "post": { "description": "新用户注册账号", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "认证" ], "summary": "用户注册", "parameters": [ { "description": "注册请求", "name": "RegisterRequest", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handler.RegisterRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/database/add": { "post": { "description": "添加新的数据库连接信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "创建数据库", "parameters": [ { "description": "数据库信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.CreateDatabaseRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/model.DatabaseInfo" } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/database/check": { "post": { "description": "测试数据库连接是否正常", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "检查数据库连接", "parameters": [ { "description": "数据库连接信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.CheckRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/database/graph/save": { "post": { "description": "保存数据库的图谱结构信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "保存图谱信息", "parameters": [ { "description": "图谱信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.SaveGraphRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/database/list": { "get": { "description": "获取所有已添加的数据库列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "获取数据库列表", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/database/{id}": { "get": { "description": "根据ID获取数据库详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "获取数据库详情", "parameters": [ { "type": "string", "description": "数据库ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.DatabaseInfo" } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "put": { "description": "更新指定数据库的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "更新数据库信息", "parameters": [ { "type": "string", "description": "数据库ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.UpdateDatabaseRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.DatabaseInfo" } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "delete": { "description": "删除指定的数据库连接", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "数据库管理" ], "summary": "删除数据库", "parameters": [ { "type": "string", "description": "数据库ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/mcp/add": { "post": { "description": "创建新的MCP工具配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "MCP管理" ], "summary": "创建MCP", "parameters": [ { "description": "MCP信息", "name": "mcp", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.MCP" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/mcp/list": { "get": { "description": "获取所有MCP工具配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "MCP管理" ], "summary": "获取MCP列表", "parameters": [ { "type": "string", "description": "分类", "name": "category", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/mcp/{id}": { "get": { "description": "根据ID获取MCP配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "MCP管理" ], "summary": "获取MCP详情", "parameters": [ { "type": "string", "description": "MCP ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } }, "put": { "description": "更新MCP配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "MCP管理" ], "summary": "更新MCP", "parameters": [ { "type": "string", "description": "MCP ID", "name": "id", "in": "path", "required": true }, { "description": "MCP信息", "name": "mcp", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.MCP" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } }, "delete": { "description": "删除MCP配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "MCP管理" ], "summary": "删除MCP", "parameters": [ { "type": "string", "description": "MCP ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/model/add": { "post": { "description": "添加新的AI模型配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "模型管理" ], "summary": "添加模型", "parameters": [ { "description": "模型信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.CreateModelRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/model/list": { "get": { "description": "获取所有已添加的AI模型列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "模型管理" ], "summary": "获取模型列表", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/model/test": { "post": { "description": "测试AI模型连接是否正常", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "模型管理" ], "summary": "测试模型连接", "parameters": [ { "description": "模型测试请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.TestModelRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/model/{id}": { "get": { "description": "根据ID获取模型详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "模型管理" ], "summary": "获取模型详情", "parameters": [ { "type": "string", "description": "模型ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.ModelInfo" } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "put": { "description": "更新指定模型的信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "模型管理" ], "summary": "更新模型", "parameters": [ { "type": "string", "description": "模型ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.UpdateModelRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "delete": { "description": "删除指定的AI模型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "模型管理" ], "summary": "删除模型", "parameters": [ { "type": "string", "description": "模型ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": { "type": "boolean" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/neo4j/check": { "post": { "description": "测试 Neo4j 数据库连接是否正常", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Neo4j" ], "summary": "检查 Neo4j 连接", "parameters": [ { "description": "Neo4j连接信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.Neo4jCheckRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/neo4j/graphs": { "post": { "description": "获取 Neo4j 中的图谱概览数据", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Neo4j" ], "summary": "获取图谱概览", "parameters": [ { "description": "图谱查询请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.Neo4jGraphRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/neo4j/nodes": { "post": { "description": "获取 Neo4j 中的节点详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Neo4j" ], "summary": "获取节点列表", "parameters": [ { "description": "节点查询请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.Neo4jNodeRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/neo4j/relationships": { "post": { "description": "获取 Neo4j 中的关系详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "Neo4j" ], "summary": "获取关系列表", "parameters": [ { "description": "关系查询请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.Neo4jRelRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/sub-table/add": { "post": { "description": "添加数据库的子表映射关系", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "创建子表映射", "parameters": [ { "description": "子表信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.CreateSubTableRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/model.SubTableInfo" } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/sub-table/database/{database_id}": { "get": { "description": "获取指定数据库的所有子表映射列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "获取数据库下所有子表", "parameters": [ { "type": "string", "description": "数据库ID", "name": "database_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/sub-table/ddl/{database_id}": { "get": { "description": "获取数据库下所有表的DDL语句", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "获取表结构DDL", "parameters": [ { "type": "string", "description": "数据库ID", "name": "database_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/sub-table/mapping/{database_id}": { "get": { "description": "从文件中读取子表映射关系", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "从文件获取映射", "parameters": [ { "type": "string", "description": "数据库ID", "name": "database_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/sub-table/{id}": { "get": { "description": "根据ID获取子表映射详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "获取子表详情", "parameters": [ { "type": "string", "description": "子表ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.SubTableInfo" } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "put": { "description": "更新子表映射信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "更新子表映射", "parameters": [ { "type": "string", "description": "子表ID", "name": "id", "in": "path", "required": true }, { "description": "更新信息", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.UpdateSubTableRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.SubTableInfo" } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } }, "delete": { "description": "删除指定的子表映射", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "子表管理" ], "summary": "删除子表映射", "parameters": [ { "type": "string", "description": "子表ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": { "type": "string" } } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/system/info": { "get": { "description": "获取服务器系统信息（CPU、内存等）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "系统" ], "summary": "获取系统信息", "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/model.SystemInfo" } }, "500": { "description": "Internal Server Error", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/tool/add": { "post": { "description": "创建新的工具", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "工具管理" ], "summary": "创建工具", "parameters": [ { "description": "工具信息", "name": "tool", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.Tool" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/tool/list": { "get": { "description": "获取所有工具列表，支持按分类和状态筛选", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "工具管理" ], "summary": "获取工具列表", "parameters": [ { "type": "string", "description": "工具分类", "name": "category", "in": "query" }, { "type": "string", "description": "工具状态", "name": "status", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/tool/sync": { "get": { "description": "从代码中的默认配置同步工具到数据库", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "工具管理" ], "summary": "手动同步工具", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/tool/{id}": { "get": { "description": "根据ID获取工具详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "工具管理" ], "summary": "获取工具详情", "parameters": [ { "type": "string", "description": "工具ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } }, "put": { "description": "更新工具信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "工具管理" ], "summary": "更新工具", "parameters": [ { "type": "string", "description": "工具ID", "name": "id", "in": "path", "required": true }, { "description": "工具信息", "name": "tool", "in": "body", "required": true, "schema": { "$ref": "#/definitions/model.Tool" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } }, "delete": { "description": "删除工具", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "工具管理" ], "summary": "删除工具", "parameters": [ { "type": "string", "description": "工具ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/user/list": { "get": { "security": [ { "BearerAuth": [] } ], "description": "获取所有用户列表（需要管理员权限）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "用户管理" ], "summary": "获取所有用户", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "401": { "description": "Unauthorized", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } }, "/user/{id}": { "get": { "security": [ { "BearerAuth": [] } ], "description": "根据ID获取用户详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "用户管理" ], "summary": "获取用户详情", "parameters": [ { "type": "string", "description": "用户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": { "type": "string" } } } } } } }, "definitions": { "handler.LoginRequest": { "type": "object", "required": [ "password", "username" ], "properties": { "password": { "type": "string" }, "username": { "type": "string" } } }, "handler.LoginResponse": { "type": "object", "properties": { "token": { "type": "string" }, "user": {} } }, "handler.RegisterRequest": { "type": "object", "required": [ "password", "username" ], "properties": { "email": { "type": "string" }, "password": { "type": "string" }, "username": { "type": "string" } } }, "model.CPUInfo": { "type": "object", "properties": { "core_count": { "description": "核心数", "type": "integer" }, "model_name": { "description": "CPU型号", "type": "string" }, "percent": { "description": "CPU使用率", "type": "number" } } }, "model.CheckRequest": { "type": "object", "required": [ "db_type", "host", "port", "username" ], "properties": { "charset": { "type": "string" }, "database": { "type": "string" }, "database_id": { "description": "可选，用于获取已保存的字段映射", "type": "string" }, "db_type": { "type": "string" }, "host": { "type": "string" }, "password": { "type": "string" }, "port": { "type": "integer" }, "ssl_mode": { "type": "string" }, "uri": { "description": "Neo4j 连接地址，如 bolt://localhost:7687", "type": "string" }, "username": { "type": "string" } } }, "model.CreateDatabaseRequest": { "type": "object", "required": [ "db_type", "host", "name", "port", "username" ], "properties": { "charset": { "type": "string" }, "database": { "type": "string" }, "db_type": { "type": "string" }, "description": { "type": "string" }, "host": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "port": { "type": "integer" }, "ssl_mode": { "type": "string" }, "sub_tables": { "description": "可选，子表配置", "type": "array", "items": { "$ref": "#/definitions/model.CreateSubTableRequest" } }, "username": { "type": "string" } } }, "model.CreateKnowledgeRequest": { "type": "object", "required": [ "embedding_model_id", "llm_model_id", "name", "parsing_config" ], "properties": { "description": { "type": "string" }, "embedding_model_id": { "type": "string" }, "llm_model_id": { "type": "string" }, "name": { "type": "string" }, "parsing_config": { "$ref": "#/definitions/model.ParsingConfig" }, "storage_config": { "description": "存储配置，不传则使用全局配置", "allOf": [ { "$ref": "#/definitions/model.StorageConfig" } ] } } }, "model.CreateModelRequest": { "type": "object", "required": [ "api_key", "base_url", "model", "model_type", "name", "provider" ], "properties": { "api_endpoint": { "type": "string" }, "api_key": { "type": "string" }, "base_url": { "type": "string" }, "model": { "type": "string" }, "model_type": { "type": "string" }, "name": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" } } }, "model.CreateSubTableRequest": { "type": "object", "required": [ "database_id", "parent_table", "sub_table_name" ], "properties": { "database_id": { "type": "string" }, "ddl": { "description": "建表DDL", "type": "string" }, "fields": { "description": "字段映射列表", "type": "array", "items": { "$ref": "#/definitions/model.FieldMapping" } }, "mapping_type": { "type": "string" }, "parent_table": { "type": "string" }, "relation_field": { "type": "string" }, "relation_type": { "type": "string" }, "sub_table_comment": { "type": "string" }, "sub_table_name": { "type": "string" } } }, "model.DatabaseInfo": { "type": "object", "properties": { "charset": { "description": "连接选项", "type": "string" }, "created_at": { "description": "时间", "type": "string" }, "database": { "description": "数据库名", "type": "string" }, "db_type": { "description": "数据库类型: mysql, postgres, mongodb, neo4j等", "type": "string" }, "description": { "description": "描述", "type": "string" }, "graph_labels": { "description": "Neo4j 标签列表 (JSON 格式)", "type": "string" }, "graph_relationship": { "description": "Neo4j 关系类型列表 (JSON 格式)", "type": "string" }, "host": { "description": "主机地址", "type": "string" }, "id": { "description": "UUID", "type": "string" }, "name": { "description": "数据库名称", "type": "string" }, "password": { "description": "密码（建议加密存储）", "type": "string" }, "port": { "description": "端口", "type": "integer" }, "selected_label": { "description": "当前选中的标签", "type": "string" }, "ssl_mode": { "description": "SSL模式", "type": "string" }, "table_count": { "description": "子表数量", "type": "integer" }, "updated_at": { "type": "string" }, "uri": { "description": "Neo4j 专用字段", "type": "string" }, "username": { "description": "用户名", "type": "string" } } }, "model.FieldMapping": { "type": "object", "properties": { "column_name": { "description": "列名", "type": "string" }, "mapped_name": { "description": "中文映射名", "type": "string" } } }, "model.MCP": { "type": "object", "properties": { "args": { "description": "参数，JSON数组格式", "type": "string" }, "category": { "description": "分类", "type": "string" }, "command": { "description": "启动命令", "type": "string" }, "created_at": { "type": "string" }, "description": { "description": "英文描述", "type": "string" }, "description_cn": { "description": "中文描述", "type": "string" }, "env": { "description": "环境变量，JSON对象格式", "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" }, "transport": { "description": "stdio, http, sse", "type": "string" }, "updated_at": { "type": "string" } } }, "model.MemoryInfo": { "type": "object", "properties": { "available": { "description": "可用(字节)", "type": "integer" }, "available_gb": { "description": "可用(GB)", "type": "number" }, "percent": { "description": "使用率", "type": "number" }, "total": { "description": "总内存(字节)", "type": "integer" }, "total_gb": { "description": "总内存(GB)", "type": "number" }, "used": { "description": "已使用(字节)", "type": "integer" }, "used_gb": { "description": "已使用(GB)", "type": "number" } } }, "model.ModelInfo": { "type": "object", "properties": { "api_endpoint": { "description": "API 端点路径", "type": "string" }, "api_key": { "description": "API 密钥", "type": "string" }, "base_url": { "description": "基础 URL", "type": "string" }, "created_at": { "type": "string" }, "id": { "type": "string" }, "model": { "description": "模型标识", "type": "string" }, "model_type": { "description": "chat/embedding/rerank/vlm", "type": "string" }, "name": { "type": "string" }, "provider": { "description": "OpenAI/Ollama", "type": "string" }, "status": { "description": "active/inactive", "type": "string" }, "updated_at": { "type": "string" } } }, "model.Neo4jCheckRequest": { "type": "object", "required": [ "host", "password", "port", "username" ], "properties": { "database": { "description": "可选，默认 neo4j", "type": "string" }, "description": { "description": "可选，数据库描述", "type": "string" }, "host": { "type": "string" }, "name": { "description": "数据库名称", "type": "string" }, "password": { "type": "string" }, "port": { "type": "integer" }, "uri": { "description": "可选，Neo4j 连接地址 (bolt://host:7687)", "type": "string" }, "username": { "type": "string" } } }, "model.Neo4jGraphRequest": { "type": "object", "required": [ "password", "uri", "username" ], "properties": { "database": { "description": "可选，默认 neo4j", "type": "string" }, "password": { "type": "string" }, "uri": { "type": "string" }, "username": { "type": "string" } } }, "model.Neo4jNodeRequest": { "type": "object", "required": [ "label", "password", "uri", "username" ], "properties": { "database": { "type": "string" }, "label": { "type": "string" }, "limit": { "description": "默认 10", "type": "integer" }, "password": { "type": "string" }, "uri": { "type": "string" }, "username": { "type": "string" } } }, "model.Neo4jRelRequest": { "type": "object", "required": [ "password", "relationship_type", "uri", "username" ], "properties": { "database": { "type": "string" }, "limit": { "description": "默认 10", "type": "integer" }, "password": { "type": "string" }, "relationship_type": { "type": "string" }, "uri": { "type": "string" }, "username": { "type": "string" } } }, "model.ParsingConfig": { "type": "object", "properties": { "docling_url": { "description": "Docling 服务 URL", "type": "string" }, "enable_pdf": { "description": "是否启用 PDF 解析", "type": "boolean" }, "engine": { "description": "markitdown / docling", "type": "string" }, "pandoc": { "description": "是否启用 Pandoc", "type": "boolean" }, "vlm_api_key": { "description": "API Key", "type": "string" }, "vlm_base_url": { "description": "自定义 API 地址", "type": "string" }, "vlm_enabled": { "description": "VLM 配置（用于图片 OCR 等）", "type": "boolean" }, "vlm_model": { "description": "模型名称", "type": "string" }, "vlm_prompt": { "description": "自定义提示词", "type": "string" }, "vlm_provider": { "description": "VLM 提供商: openai, anthropic, local 等", "type": "string" } } }, "model.SaveGraphRequest": { "type": "object", "required": [ "databaseId", "databaseName", "labels", "relationshipTypes", "uri", "username" ], "properties": { "databaseId": { "type": "string" }, "databaseName": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "relationshipTypes": { "type": "array", "items": { "type": "string" } }, "selectedLabel": { "type": "string" }, "uri": { "type": "string" }, "username": { "type": "string" } } }, "model.StorageConfig": { "type": "object", "properties": { "access_key_id": { "description": "MinIO/S3 access key", "type": "string" }, "bucket": { "description": "MinIO/S3 bucket", "type": "string" }, "endpoint": { "description": "MinIO/S3 endpoint", "type": "string" }, "secret_access_key": { "description": "MinIO/S3 secret key", "type": "string" }, "type": { "description": "local / minio / s3", "type": "string" }, "use_ssl": { "description": "MinIO/S3 use SSL", "type": "boolean" } } }, "model.SubTableInfo": { "type": "object", "properties": { "created_at": { "type": "string" }, "database_id": { "description": "关联的数据库ID", "type": "string" }, "ddl": { "description": "建表 DDL", "type": "string" }, "fields": { "description": "字段映射列表（返回给前端）", "type": "array", "items": { "$ref": "#/definitions/model.FieldMapping" } }, "id": { "description": "UUID", "type": "string" }, "mapping_type": { "description": "映射类型", "type": "string" }, "parent_table": { "description": "父表名", "type": "string" }, "relation_field": { "description": "关联字段", "type": "string" }, "relation_type": { "description": "关联类型", "type": "string" }, "sub_table_comment": { "description": "子表注释", "type": "string" }, "sub_table_name": { "description": "子表名", "type": "string" }, "updated_at": { "type": "string" } } }, "model.SystemInfo": { "type": "object", "properties": { "cpu": { "$ref": "#/definitions/model.CPUInfo" }, "memory": { "$ref": "#/definitions/model.MemoryInfo" } } }, "model.TestModelRequest": { "type": "object", "required": [ "api_key", "base_url", "model", "model_type", "provider" ], "properties": { "api_endpoint": { "type": "string" }, "api_key": { "type": "string" }, "base_url": { "type": "string" }, "model": { "type": "string" }, "model_type": { "type": "string" }, "provider": { "type": "string" } } }, "model.Tool": { "type": "object", "properties": { "args": { "description": "参数，JSON数组格式", "type": "string" }, "category": { "type": "string" }, "command": { "description": "启动命令", "type": "string" }, "created_at": { "type": "string" }, "description": { "description": "英文描述", "type": "string" }, "description_cn": { "description": "中文描述", "type": "string" }, "env": { "description": "环境变量，JSON对象格式", "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "parameters": { "description": "JSON格式存储", "type": "string" }, "provider": { "type": "string" }, "require_approval": { "type": "boolean" }, "security_level": { "type": "string" }, "status": { "description": "状态", "type": "string" }, "transport": { "description": "MCP 特有字段", "type": "string" }, "updated_at": { "type": "string" } } }, "model.UpdateDatabaseRequest": { "type": "object", "properties": { "charset": { "type": "string" }, "database": { "type": "string" }, "db_type": { "type": "string" }, "description": { "type": "string" }, "graph_labels": { "description": "Neo4j 标签列表 (JSON)", "type": "string" }, "graph_relationship": { "description": "Neo4j 关系类型列表 (JSON)", "type": "string" }, "host": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "port": { "type": "integer" }, "selected_label": { "description": "当前选中的标签", "type": "string" }, "ssl_mode": { "type": "string" }, "sub_tables": { "description": "子表配置", "type": "array", "items": { "$ref": "#/definitions/model.CreateSubTableRequest" } }, "table_count": { "type": "integer" }, "uri": { "description": "Neo4j 连接地址", "type": "string" }, "username": { "type": "string" } } }, "model.UpdateKnowledgeRequest": { "type": "object", "properties": { "description": { "type": "string" }, "embedding_model_id": { "type": "string" }, "llm_model_id": { "type": "string" }, "name": { "type": "string" }, "parsing_config": { "$ref": "#/definitions/model.ParsingConfig" }, "status": { "type": "string" }, "storage_config": { "$ref": "#/definitions/model.StorageConfig" } } }, "model.UpdateModelRequest": { "type": "object", "properties": { "api_endpoint": { "type": "string" }, "api_key": { "type": "string" }, "base_url": { "type": "string" }, "model": { "type": "string" }, "model_type": { "type": "string" }, "name": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" } } }, "model.UpdateSubTableRequest": { "type": "object", "properties": { "ddl": { "type": "string" }, "mapping_type": { "type": "string" }, "parent_table": { "type": "string" }, "relation_field": { "type": "string" }, "relation_type": { "type": "string" }, "sub_table_comment": { "type": "string" }, "sub_table_name": { "type": "string" } } } } }