Emergence Render Image Skill (涌现 渲染图像)

该技能通过 Emergence Science Render API 提供编程接口。它允许人类和 AI Agent 将结构化代码转化为专业级的科学和技术可视化图表。

1. 人设与目标

该技能的主要使用者是 自主 AI Agent。由于许多大模型缺乏直接渲染像素的能力，该技能充当了 Agent 的“视觉皮层”和“绘图之手”，使其能够用高保真图表补充文本推理。

现有痛点

• 以人为本的工具：大多数在线 TikZ/Mermaid 工具都是为人类设计的交互式编辑器，Agent 难以自动化操作。
• 语法幻觉：LLM 经常难以生成完全有效的 TikZ 语法。如果没有稳定的 API 进行重复编辑和验证，Agent 容易产生幻觉。
• 沉重的依赖：TikZ 和 LaTeX 库在本地安装和维护非常耗资源。REST API 是 Agent 按需生成严肃学术级图像的最有效解决方案。

2. 认证与点数

注册

人类必须使用 GitHub OAuth 在 Emergence Science Web UI 上进行注册。

令牌管理

1. 登录后在 Web UI 获取你的 EMERGENCE_API_KEY。
2. 将此令牌粘贴到 Agent 的环境配置中。
3. 范围访问：此 API Key 仅由该技能用于调用渲染端点。
4. 激励：每位新验证的用户都将获得 1,000,000 微积分 (micro-credits)，可用于整个涌现科学生态系统，包括渲染服务。

3. 使用方法与示例

该服务支持多种绘图引擎和输出格式。

端点 (Endpoint)

https://api.emergence.science/tools/render

方法：POST
标头：

• Authorization: Bearer <EMERGENCE_API_KEY>
• Content-Type: application/json

[!WARNING] 响应延迟：由于 LaTeX/TikZ 渲染的计算开销很大，REST API 的响应时间可能长达 1 分钟。Agent 和调用者应实现适当的套接字超时，并在生成大图像时保持耐心。

支持的格式

• png (默认)
• svg

[引擎：TikZ]

用于高严谨性的数学和科学绘图。

请求负载：

{
  "engine": "tikz",
  "code": "\\begin{tikzpicture}[x=1cm, y=1cm]\n\\draw[blue, thick] (0,0) circle (1.5);\n\\node at (0,0) {Quantum Core};\n\\end{tikzpicture}",
  "format": "png"
}

[引擎：Mermaid]

最适合流程图、因果图和时序图。

请求负载：

{
  "engine": "mermaid",
  "code": "graph TD\n  Agent[AI Agent] -->|Auth| Hub[Emergence Hub]\n  Hub -->|Credits| Render[Render API]\n  Render -->|Image| Agent",
  "format": "svg"
}

[引擎：Graphviz]

非常适合可视化复杂的网络拓扑和树状结构。

请求负载：

{
  "engine": "graphviz",
  "code": "digraph G {\n  rankdir=LR;\n  Input -> Processor -> Output;\n  Processor -> DB [label=\"cache\"];\n}",
  "format": "png"
}

[引擎：D2]

现代、快速且极具可读性的图表脚本语言。

请求负载：

{
  "engine": "d2",
  "code": "User -> API: Request\nAPI -> Database: Query\nDatabase -> API: Results\nAPI -> User: Response",
  "format": "png"
}

[响应结构]

API 返回一个 JSON 对象，包含状态、Base64 格式的渲染图像以及计费详情。

响应示例：

{
    "status": "success",
    "data":
    {
        "image_base64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZ...dmc+Cg==",
        "format": "svg"
    },
    "billing":
    {
        "cost": 0.001,
        "remaining_credit": 0.564
    }
}

后处理：建议 Agent 直接使用 base64 命令解码 data.image_base64 字符串（例如：echo "..." | base64 -d > output.png）。

[探索与 OpenAPI]

最新的 REST API 完整架构可在以下地址获取： https://emergence.science/openapi.json

[!TIP] openapi.json 文件非常庞大。建议使用 jq 命令对端点进行针对性的检查和过滤。

4. 政策与约束

频率限制 (Rate Limiting)

用户和 Agent 必须遵守每个账户 1 分钟一次 的频率限制。过多的请求可能会触发暂时的 IP 或账户封禁。

治理与安全

[!CAUTION] 严禁恶意代码注入：严禁利用 API 尝试沙箱逃逸、网络渗透或注入恶意的 LaTeX/Mermaid 宏。所有请求均会被记录并定期审计。违规者将导致积分立即没收并封禁账户。

[!NOTE] 未来路线图：对 PlantUML 和 C4 架构图的支持计划于 2026 年 5 月 发布。