{"skill":{"slug":"uctoo-api-skill","displayName":"uctoo-api-skill","summary":"完整的 uctoo 后端 API 集成技能。将自然语言请求转换为 uctoo-backend API 调用，支持用户管理、产品管理、订单管理、登录认证等功能。使用时用户提及 \"uctoo\"、\"后端API\"、\"用户管理\"、\"产品\"、\"订单\"、\"登录\"、\"认证\" 等关键词时，你应该直接使用 http_request...","description":"---\nname: uctoo-api-skill\ndescription: 完整的 uctoo 后端 API 集成技能。将自然语言请求转换为 uctoo-backend API 调用，支持用户管理、产品管理、订单管理、登录认证等功能。使用时用户提及 \"uctoo\"、\"后端API\"、\"用户管理\"、\"产品\"、\"订单\"、\"登录\"、\"认证\" 等关键词时，你应该直接使用 http_request 工具发起实际的 API 请求。\nlicense: MIT\ncompatibility: 需要网络访问 uctoo 后端 API\nmetadata:\n  author: UCToo Team\n  version: \"7.0.0\"\n  category: api-integration\nallowedTools:\n---\n\n# UCTOO API Skill - 后端 API 集成技能\n\n## 概述\n\n**本技能指导你使用框架内置的 `http_request` 工具来发起 HTTP 请求。**\n\n**当用户请求 uctoo 相关的 API 操作时，你必须：**\n1. 分析用户需求，确定要调用哪个 API 端点\n2. **直接调用 `http_request` 工具发起 HTTP 请求**\n3. 将响应结果返回给用户\n\n**⚠️ 禁止事项：**\n- ❌ 不要调用 `uctoo-api-skill` 工具（这是技能文档，不是工具）\n- ✅ 直接使用 `http_request` 工具\n\n## 🎉 自动 Token 管理（重要）\n\n**系统已实现自动 Token 管理机制，你无需手动处理认证！**\n\n### 自动管理功能\n1. **自动保存**：当登录接口返回 `access_token` 时，系统会自动保存到会话中\n2. **自动注入**：后续请求会自动在 headers 中添加 `Authorization: Bearer {token}`\n3. **无需手动传递**：你不需要在请求中手动添加 Authorization header\n\n### 你只需要做的事\n- 调用登录接口完成登录\n- 后续请求直接调用即可，系统会自动处理认证\n\n## API 基础配置\n\n**API 基础地址**：`https://javatoarktsapi.uctoo.com`\n\n**完整 URL 格式**：`{基础地址}{API路径}`\n- 示例：`https://javatoarktsapi.uctoo.com/api/uctoo/auth/login`\n\n## http_request 工具参数格式\n\n**工具名称**：`http_request`\n\n**参数说明：**\n\n| 参数 | 必需 | 类型 | 说明 |\n|------|------|------|------|\n| method | 是 | string | HTTP 方法：GET、POST、PUT、DELETE |\n| url | 是 | string | 完整的请求 URL |\n| headers | 否 | string | JSON 字符串格式的请求头（可选，系统会自动注入 Authorization） |\n| body | 否 | string | JSON 字符串格式的请求体（POST/PUT 需要） |\n\n**⚠️ 重要：headers 和 body 参数必须是 JSON 字符串格式！**\n\n## 常用 API 端点\n\n### 认证相关\n\n| 端点 | 方法 | 说明 | 需要认证 |\n|------|------|------|----------|\n| `/api/uctoo/auth/login` | POST | 用户登录 | 否 |\n| `/api/uctoo/auth/signin` | POST | 用户登录（带验证码） | 否 |\n| `/api/uctoo/auth/logout` | GET | 用户登出 | 自动 |\n| `/api/uctoo/auth/me` | GET | 获取当前用户信息 | 自动 |\n\n### Entity 相关\n\n| 端点 | 方法 | 说明 | 需要认证 |\n|------|------|------|----------|\n| `/api/uctoo/entity/{limit}/{page}` | GET | 获取实体列表 | 否 |\n| `/api/uctoo/entity/{id}` | GET | 获取单个实体 | 否 |\n| `/api/uctoo/entity/add` | POST | 添加实体 | 自动 |\n| `/api/uctoo/entity/edit` | POST | 编辑实体 | 自动 |\n| `/api/uctoo/entity/del` | POST | 删除实体 | 自动 |\n\n## 完整调用示例\n\n### 示例 1：用户登录\n\n**用户请求：** \"请以用户名 demo 密码 123456 进行登录\"\n\n**调用 http_request 工具：**\n```json\n{\n  \"method\": \"POST\",\n  \"url\": \"https://javatoarktsapi.uctoo.com/api/uctoo/auth/login\",\n  \"headers\": \"{\\\"Content-Type\\\": \\\"application/json\\\"}\",\n  \"body\": \"{\\\"username\\\": \\\"demo\\\", \\\"password\\\": \\\"123456\\\"}\"\n}\n```\n\n**成功响应示例：**\n```json\n{\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIs...\",\n  \"refresh_token\": \"eyJhbGciOiJIUzI1NiIs...\",\n  \"user\": {\n    \"id\": \"505cf909-5e0e-4dde-b215-74274d2cc548\",\n    \"name\": \"UCTooApp\",\n    \"username\": \"demo\",\n    \"email\": \"demo@uctoo.com\"\n  }\n}\n```\n\n**注意**：登录成功后，系统会自动保存 token，后续请求无需手动添加 Authorization header。\n\n### 示例 2：获取实体列表\n\n**用户请求：** \"获取前10条实体数据\"\n\n**调用 http_request 工具：**\n```json\n{\n  \"method\": \"GET\",\n  \"url\": \"https://javatoarktsapi.uctoo.com/api/uctoo/entity/10/0\"\n}\n```\n\n### 示例 3：编辑实体（自动认证）\n\n**用户请求：** \"将 id 为 fd0a410a-7038-4c62-a5e4-9f7950d3d406 的实体的 link 字段更新为 uctoo.com\"\n\n**调用 http_request 工具：**\n```json\n{\n  \"method\": \"POST\",\n  \"url\": \"https://javatoarktsapi.uctoo.com/api/uctoo/entity/edit\",\n  \"headers\": \"{\\\"Content-Type\\\": \\\"application/json\\\"}\",\n  \"body\": \"{\\\"id\\\": \\\"fd0a410a-7038-4c62-a5e4-9f7950d3d406\\\", \\\"link\\\": \\\"uctoo.com\\\"}\"\n}\n```\n\n**注意**：系统会自动注入 Authorization header，你不需要手动添加。\n\n**⚠️ 关键注意事项：**\n- `id` 必须是实际的 UUID 值，格式如 `fd0a410a-7038-4c62-a5e4-9f7950d3d406`\n- **不要使用占位符** 如 `实体ID`、`YOUR_ID`、`id` 等\n- 如果用户没有提供具体的 ID，先查询列表获取 ID\n\n### 示例 4：获取当前用户信息\n\n**用户请求：** \"获取当前登录用户的信息\"\n\n**调用 http_request 工具：**\n```json\n{\n  \"method\": \"GET\",\n  \"url\": \"https://javatoarktsapi.uctoo.com/api/uctoo/auth/me\"\n}\n```\n\n**注意**：系统会自动注入 Authorization header。\n\n## 错误处理\n\n| 状态码 | 说明 | 处理方式 |\n|--------|------|----------|\n| 200 | 成功 | 正常处理响应 |\n| 400 | 请求参数错误 | 检查请求参数格式 |\n| 401 | 未授权/Token过期 | 提示用户重新登录 |\n| 403 | 无权限 | 检查是否登录或是否有权限 |\n| 404 | 资源不存在 | 检查URL路径是否正确 |\n| 500 | 服务器内部错误 | 联系管理员或稍后重试 |\n\n## 常见错误及解决方案\n\n### 错误 1：UUID 格式错误\n**错误信息：** `Error creating UUID, invalid character`\n**原因：** 传递的 id 不是有效的 UUID 格式\n**解决方案：** 确保 id 是实际的 UUID 值，如 `fd0a410a-7038-4c62-a5e4-9f7950d3d406`\n\n### 错误 2：未登录\n**错误信息：** `not login` 或 `403 Forbidden`\n**原因：** 用户尚未登录或 token 已过期\n**解决方案：** 先调用登录接口，系统会自动保存 token\n\n### 错误 3：参数格式错误\n**错误信息：** `400 Bad Request`\n**原因：** body 参数格式不正确\n**解决方案：** 确保 body 是有效的 JSON 字符串，且字段名和值正确\n\n## 重要提醒\n\n1. **✅ 直接调用 http_request 工具**\n2. **✅ headers 和 body 必须是 JSON 字符串格式**\n3. **✅ POST 请求必须设置 Content-Type: application/json**\n4. **✅ 认证 token 由系统自动管理，无需手动处理**\n5. **✅ id 参数必须是实际的 UUID 值，不能是占位符**\n6. **❌ 不要调用 uctoo-api-skill 工具**\n7. **❌ 不要使用 `实体ID`、`YOUR_ID` 等占位符**\n8. **❌ 不要手动添加 Authorization header（系统自动注入）**\n","tags":{"latest":"0.0.1"},"stats":{"comments":0,"downloads":567,"installsAllTime":21,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772781636718,"updatedAt":1778491748674},"latestVersion":{"version":"0.0.1","createdAt":1772781636718,"changelog":"Query your database using natural language\n- 首个版本发布，全面集成 uctoo 后端 API 接口。\n- 支持用户管理、产品管理、订单管理、登录认证等常用 API 操作。\n- 自动化 token 管理，无需手动处理授权。\n- 明确要求仅通过 http_request 工具发起真实 API 调用。\n- 提供详细使用说明、常见错误解决方案，以及请求参数格式规范。","license":null},"metadata":null,"owner":{"handle":"uctoocom","userId":"s177nrq6hcdpetbaftjn9bvgv5884yc7","displayName":"UCTooCom","image":"https://avatars.githubusercontent.com/u/261841032?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089778583}}