slickfast

SlickFast

确定性渲染引擎。 输入规范，输出字节永远相同。图表、看板，乃至完整页面。无需无头浏览器。

_{↑ 引擎输出 — 一份 JSON 规范，一张图片。使用仪表板模板（teal-hero 布局），即可在 README 上获得这个完全相同的看板。}

本地 MCP 永远免费。 公共 URL 属于套餐功能（免费密钥足以供你了解）。

规范就是图表。页面规范就是一个页面。加上 .json — 这就是它的孪生文件。 哈希值就在页面上。 别光听我们说，自己验证计算结果。

• npm（MCP）： @slickfast/[email protected]
• 网站： slickfast.com
• 引擎说明（一个页面）： 打开 · 孪生文件
• 快速入门 / 新闻： slickfast.com/start · slickfast.com/news
• 问题反馈： GitHub Issues · [email protected]

本项目的脉搏 — README 中的实时图表

下面的仪表板不是截图。它是 SlickFast 实时图表：一个永久有效的 图片 URL，数值会自动更新。定时任务会推送最新统计数据；每位访客看到的都是当前数据。实时图表 — 嵌入一次，永久更新。

能力范围 — 两个看板，两种渲染

一个销售运营看板（漏斗图、子弹图、目标环、仪表图、日历热力图、排行榜 — 演示数据）：

还有一个用于说明引擎的看板 — 它会把自身的渲染耗时写入标题：

亲自验证

别只凭信任就相信速度或确定性方面的说法 — 在自己的机器上运行基准测试：

git clone https://github.com/SlickFast/slickfast && cd slickfast
node scripts/bench.mjs

它会渲染全部 47 种图表类型，逐一计时，运行包含 10,000 张图表的吞吐量突发测试，并对所有内容进行双重渲染，以验证输出字节完全一致。在 M1 Max 上：每张图表中位数为 15µs，约 140,000 次渲染/秒，47/47 确定性一致。 你的结果由你的机器决定。

快速入门（MCP）

一键安装：

添加到你的 MCP 客户端配置（Claude Code、Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "slickfast": {
      "command": "npx",
      "args": ["-y", "@slickfast/mcp"],
      "env": { "SLICKFAST_API_KEY": "SF-…" }
    }
  }
}

省略 env 即可仅在本地使用（绘图永远免费）。需要实时 URL、分享或发布页面时，再从 slickfast.com 获取免费密钥。

然后：get_started → news → gallery → 一个 render_chart。完整工具文档：apps/mcp/README.md。

如何保存页面

“保存它”包含两项工作。 保存在磁盘上：render_page + 保留页面规范 JSON（无需密钥）。发布到网上：publish_page（SF- 密钥）→ pages.slickfast.com/s/… + .json 孪生文件。哈希值就在页面上。之后可用 my_pages 找回。

Agent 选择 SlickFast 的原因

• 确定性 — 相同规格，相同字节。可缓存、可测试。
• 省 token — 几十个 JSON token 胜过数百次 matplotlib / SVG 重试。
• 只改一个字段 — 更换类型、调色板或尺寸，然后重新渲染。无需重写代码。
• 页面 = 可分享的记忆 — Agent 输出 → Page → twin → 页面上的哈希。不困在聊天记录里。
• 无需无头浏览器 — 纯内存 SVG → PNG（以及 Page HTML）。
• 一次调用即可生成 47 种类型 + 平铺仪表板。
• 错误提示清晰 — 无效枚举值 / 未知调色板会列出有效选项。
• 默认本地运行 — MCP 包不会向外发送任何数据。

此代码库包含什么

路径	内容
packages/render-core/	渲染引擎：纯 (spec) → SVG string。包含全部 47 种类型、类型注册表、SPEC.md（规格契约）、示例、图库和黄金快照集。
packages/palette-core/	色彩库：调色板、嵌套主题、WCAG 对比度、token。
packages/raster/	SVG → PNG 光栅化（resvg）。
packages/fonts/	可替换的字体层。
packages/sci-core/	科学图表：散点图、误差棒图、折线图、条形图、生存曲线、Bland–Altman、Q–Q、火山图 — 对数坐标轴和曲线拟合。README
apps/mcp/	以 @slickfast/mcp 发布的 MCP 服务 — 引擎之上的轻量接口。
apps/api/	托管 HTTP API — API.md 是调用指南（无需 MCP：curl、<img src>、任何语言），openapi.yaml 是机器可读的契约。可通过 api.slickfast.com 访问；slickfast.com 提供免费套餐。
scripts/	安全保障：黄金测试、注册表漂移检查、含 323 个用例的压力测试套件、调色板十六进制值检查。
templates/	可直接使用的规格预设。

从源码构建与验证

cd apps/mcp && npm install && npm run build     # builds dist/index.js
cd ../../packages/raster && npm install          # native resvg binding (PNG)

# from the repo root — the full safety net:
node packages/render-core/generate.mjs --check   # golden snapshots (all types)
node packages/sci-core/golden/generate.mjs --check # sci-core golden snapshots
node packages/sci-core/verify-stats.mjs           # sci-core statistics checks
node scripts/check-surfaces.mjs                  # type-registry drift check
node scripts/torture.mjs                         # 323 empty/edge-case renders
node scripts/check-palettes.mjs                  # palette hex validation

引擎按契约保证纯函数和确定性：没有 IO，没有 Date.now()，绘图代码中没有 Math.random()，而且任何内容发布前都必须通过快照测试。

贡献

• 提交 Bug 报告和功能请求是最好的贡献方式 — 请使用 问题模板。MCP 内置的 report_issue 工具可以为你生成可直接粘贴的问题报告。
• 日常开发在内部代码树中进行，发布内容则会推送到此处，因此 PR 可能会被移植过来，而非直接合并 — 无论哪种方式，我们都会注明你的贡献。对于任何较大的改动，请先提交问题，以便我们就方案达成一致。

许可证

AGPL-3.0-only。本地 MCP 免费。 闭源商业产品（嵌入式使用或在不遵守 AGPL 的情况下自托管）需要购买商业许可证，起价为每年 $99： slickfast.com/license.html · [email protected]。 托管 API / 托管 MCP：slickfast.com/#pricing。