> 功能说明: 本技能涵盖 自动化配置和灵活的参数设置、工作流程和效率、时使用、化配置和灵活的参数设置 等核心能力。

> 功能说明: 本技能涵盖 映射为 等核心能力。

magic-api-generate

能力梳理

详见参考文档：

• 语法参考 - 完整语法、内置函数、模块导入
• 数据库操作 - 多数据源、分页、事务
• 业务示例 - 登录认证、文件上传、导出等
• 针对语法参考(/api/v1/skills/magic-api-generate/file?md&ownerHandle=webx32),解析输入数据并返回响应
• 验证返回数据的完整性和格式正确性

数据库操作(/api/v1/skills/magic-api-generate/file?md&ownerHandle=webx32)

针对数据库操作(/api/v1/skills/magic-api-generate/file?
输入: 用户提供数据库操作(/api/v1/skills/magic-api-generate/file?
输出: 返回数据库操作(/api/v1/skills/magic-api-generate/file?
- 针对数据库操作(/api/v1/skills/magic-api-generate/file?md&ownerHandle=webx32),解析输入数据并返回响应
- 验证返回数据的完整性和格式正确性

业务示例(/api/v1/skills/magic-api-generate/file?md&ownerHandle=webx32)

针对业务示例(/api/v1/skills/magic-api-generate/file?
输入: 用户提供业务示例(/api/v1/skills/magic-api-generate/file?
输出: 返回业务示例(/api/v1/skills/magic-api-generate/file?
- 针对业务示例(/api/v1/skills/magic-api-generate/file?md&ownerHandle=webx32),解析输入数据并返回响应
- 验证返回数据的完整性和格式正确性

场景示例

不适用于：需要人工判断的复杂决策场景

操作步骤

依赖说明

运行环境

1. Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
2. 操作系统: Windows / macOS / Linux

第三方依赖

API Key 配置

可用性分类

4. 分类: MD+execute()
5. 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

参数说明

输出说明

{
  "success": true,
  "data": {
    "result": "处理结果",
    "status": "success",
    "metadata": {
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

依赖说明(补充)

国内替代方案:
- OpenAI GPT → 智谱GLM-4 / 百度文心一言 / 通义千问 / DeepSeek
- OpenAI Embedding → 智谱embedding-2 / 百度embedding

案例展示

示例1：基础用法

# 请参考上方使用说明进行配置和调用
result = "ready"
```xml
<dependency>
    <groupId>org.ssssssss</groupId>
    <artifactId>magic-api-spring-boot-starter</artifactId>
    <version>2.2.2</version>
</dependency>

请参考上方使用说明进行配置和调用

result = "ready"

server:
  port: 9999

magic-api:
  web: /magic/web              # Web UI 入口
  resource:
    location: /data/magic-api  # 脚本存储位置（可改为 classpath: 只读模式）

请参考上方使用说明进行配置和调用

result = "ready"

http://localhost:9999/magic/web

请参考上方使用说明进行配置和调用

result = "ready"
```

热门问题

Q1: 如何开始使用magic-api-generate？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

故障处理体系

能力边界

1. 安全性 - 生产环境关闭 Web UI 或限制 IP 访问
2. 版本控制 - 脚本目录建议 Git 管理
3. 密码加密 - 使用 MD5/BCrypt，不要明文存储
4. SQL 注入 - 使用参数化查询 ? 占位符
5. 性能 - 复杂逻辑拆分多个接口，避免单脚本过长

创新特色

效率提升量化分析

差异化对比

核心痛点解决

常见问题FAQ

Q1: magic-api-generate是否支持多种编程语言？

A: magic-api-generate主要支持JavaScript，但可以通过插件扩展支持其他编程语言。

Q2: magic-api-generate如何处理异常情况？

A: magic-api-generate提供了异常处理机制，当出现异常时，会返回错误信息，并记录到日志中。

Q3: magic-api-generate是否支持跨域请求？

A: magic-api-generate支持跨域请求，但需要配置CORS策略。

Q4: magic-api-generate如何进行性能优化？

A: magic-api-generate提供了多种性能优化方法，如缓存、异步处理等。

Q5: magic-api-generate如何进行安全防护？

A: magic-api-generate提供了安全防护措施，如输入验证、权限控制等。

安全合规声明

1. 确保API密钥安全，避免泄露。
2. 对输入数据进行验证，防止输入验证等攻击。
3. 设置合理的权限控制，防止未授权访问。
4. 定期更新依赖库，避免安全漏洞。
5. 对敏感数据进行加密处理，确保数据安全。