前言¶
在文档、技术方案或论文草稿里,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 公开简介与标签,可核实的能力如下:
- 多引擎图示渲染:支持 TikZ、Mermaid、Graphviz、D2 四类常见「写源码、出矢量/专业图」的表达方式。
- 远端 Render API:不依赖本机安装 TeX、Graphviz 或 D2 CLI,由 Emergence Science Render API 完成渲染(具体请求参数、返回格式以安装后的
SKILL.md为准;当前公开下载接口未返回正文,本文不展开未核实的字段)。 - 需要 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 正文的前提下,只能归纳与简介一致的使用轮廓:
- 在对话中说明要画的图类型(TikZ / Mermaid / Graphviz / D2)及结构需求。
- Agent 在技能约束下生成对应源码,并调用 Emergence Science Render API 渲染。
- 将返回的图表用于回复、文档或附件(具体是 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