涌现科学 Render API 技能:在 Agent 里渲染 TikZ、Mermaid、Graphviz、D2

前言

在文档、技术方案或论文草稿里,Agent 经常能写出 Mermaid、Graphviz 或 TikZ 源码,但本地往往没有对应的编译链:LaTeX/TikZ 环境重,Graphviz、D2 也要单独安装。把源码贴进 Markdown 预览,多数编辑器也不会真正出图。下面介绍 SkillHub 上的 涌现科学官方技能,通过 Emergence Science Render API 渲染专业图表 (TikZ, Mermaid, Graphviz, D2):把渲染交给远端 Emergence Science Render API,Agent 按技能说明组织请求,拿回可嵌入文档的图表结果。

这是什么

一句话定位:面向支持 Agent Skills 的客户端,通过 Emergence Science Render API 把 TikZ、Mermaid、Graphviz、D2 等图示源码渲染成专业图表。

  • 坐标:@user_1acc1bde/emergence-render-image
  • 版本:1.0.0
  • 来源:community(SkillHub 标注)
  • 分类:design-media
  • 发布者:user_1acc1bde(页面与简介均冠以「涌现科学官方技能」)

SkillHub 页面:https://www.skillhub.cn/skills/user_1acc1bde/emergence-render-image
技能包地址(SkillHub 登记):https://api.skillhub.cn/user_1acc1bde/emergence-render-image

核心功能

依据 SkillHub 公开简介与标签,可核实的能力如下:

  1. 多引擎图示渲染:支持 TikZ、Mermaid、Graphviz、D2 四类常见「写源码、出矢量/专业图」的表达方式。
  2. 远端 Render API:不依赖本机安装 TeX、Graphviz 或 D2 CLI,由 Emergence Science Render API 完成渲染(具体请求参数、返回格式以安装后的 SKILL.md 为准;当前公开下载接口未返回正文,本文不展开未核实的字段)。
  3. 需要 API Key:SkillHub 标签为 requires_api_key=true,使用前需自行准备 Emergence Science 侧可用的 API 凭证,并按技能说明配置。

安装与启用

SkillHub 给出的安装方式是:让 Agent 阅读官方安装说明,再安装本技能坐标。

1. 安装 SkillHub CLI(若尚未安装)

先检查是否已有 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 文档执行完整安装(CLI + 默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明来源:https://skillhub.cn/install/skillhub.md

2. 安装本技能

安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被客户端加载。

skillhub install @user_1acc1bde/emergence-render-image --dir <你的 Agent skills 目录>

SkillHub 文档中列出的常见路径示例:

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

3. 自然语言安装(页面提示)

SkillHub 技能页亦提供可复制提示词,大意是:根据 https://skillhub.cn/install/skillhub.md,安装 @user_1acc1bde/emergence-render-image。在已接入 SkillHub 安装流程的 Agent 里,可直接发送该提示完成同样步骤。

经过上面的步骤后,重启或刷新 Agent 的技能列表,确认 @user_1acc1bde/emergence-render-image 已出现在可用技能中,再配置 Render API 所需的 Key(标签已标明需要 API Key)。

典型用法

公开页面未附带可复现的端到端示例命令;实际交互方式应遵循安装包内的 SKILL.md(通用 Agent Skill 格式)。在未拿到 SKILL.md 正文的前提下,只能归纳与简介一致的使用轮廓:

  1. 在对话中说明要画的图类型(TikZ / Mermaid / Graphviz / D2)及结构需求。
  2. Agent 在技能约束下生成对应源码,并调用 Emergence Science Render API 渲染。
  3. 将返回的图表用于回复、文档或附件(具体是 PNG、SVG 还是其他格式,以技能与 API 文档为准)。

若 skillhub install 或 API 下载失败,可先通过 SkillHub 页面确认技能是否仍可安装,或联系发布者 user_1acc1bde 更新包可用性。

适用场景与注意

适合谁

  • 需要在 Agent 工作流里稳定出 论文级 TikZ 或 工程里常用的 Mermaid / Graphviz / D2,又不想维护本机渲染环境的人。
  • 内容侧归类为 design-media,偏向图示与媒体产出,而不是通用代码生成。

限制与注意

  • API Key:requires_api_key=true,未配置 Key 时无法完成渲染;密钥不要提交到仓库。
  • 网络与合规:渲染走远端 API,需保证运行环境能访问 Emergence Science 服务,并遵守其使用条款。
  • 安装可用性:以 SkillHub 抓取数据为准,该技能 安装数登记为 0,且部分环境下 skillhub install 可能遇到下载 404;安装前建议在 SkillHub 页面确认状态。
  • 数据口径:SkillHub 登记 评分 100000、下载 899(页面统计会变动,写作时以 SkillHub 实时显示为准)。

结尾

若你的痛点是「Agent 能写图,但本机渲不出来」,这个技能把 TikZ、Mermaid、Graphviz、D2 统一接到 Emergence Science Render API,适合作为 design-media 类补充能力安装。官方入口:

  • SkillHub:https://www.skillhub.cn/skills/user_1acc1bde/emergence-render-image
  • 技能包登记地址:https://api.skillhub.cn/user_1acc1bde/emergence-render-image
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye