stack-diagram 本机实测。官方 logo、2000×1080 的图、release 包 105.4 kB。装法里有一条我没跑通,也写在这一页。
我给它的原句是这一句,英文,没有指定节点,也没给坐标:
出来的图是 2000×1080。上面一个 Vercel 分组框,里面是浏览器里的小人、Next.js 的 web app 和 HTTPS 连线;下面一个 Data layer 分组框,PostgreSQL 和 Redis 并排,分别标着 primary db 和 cache。SQL 与 cache 两条连线把两层接起来。
四个品牌 logo 都是原件,没有重新上色。分组框、连线的起止点、标签怎么避让,是它自己算的。
从敲命令到两张 PNG 落盘,大约 24 秒,不含下载 release 包的 1.85 秒。取 logo 花了 11.7 秒,也是唯一需要联网的一步。
它是一份 Agent skill,没有画布可以拖,也不靠生图模型拼图。Agent 先把节点、分组、连线定下来,填进模板;工具负责取 logo、算坐标、把资源内联、截图。分工清楚了,图才稳定。
fetch_icons.py 按 svgl、devicon、gilbarbara/logos 的顺序查。本机这批图标全部来自 svgl。这是唯一联网的步骤。规则是 logo 永不重上色,浅色 logo 就放到深色底板上。
build.py 把图标和字体转成 base64 塞进一个 HTML。本机产物 105,408 字节。从这一步之后,断网也能渲染。
render_png.py 用 Playwright 驱动 Chromium 截 .canvas,--scale 2。出两张 2000×1080:light 87,917 字节,dark 94,703 字节。
测量窗口 2026-11-18 13:46–13:59 CST;主机 macOS 27.2 / arm64 / Node v26.7.0 / npm 11.19.0 / Python 3.15.2。每条都能指回命令和输出。
| 项目 | 实测值 | 命令与关键输出 |
|---|---|---|
| star | 2,595 | curl -sS https://api.github.com/repos/caru-ini/stack-diagram → "stargazers_count": 2595(13:45 与 05:46Z 两次同值) |
| fork | 140 | 同一响应 → "forks_count": 140 |
| 许可 | MIT | 同一响应 → "license": {"spdx_id": "MIT"} |
| open issues | 1 | 同一响应 → "open_issues_count": 1 |
| 最新 release | v0.6.0 · 2026-11-13 | releases API → tag_name v0.6.0,published_at 2026-11-13T07:38:20Z,共 6 个 release |
| release 包 | 105,397 字节 = 105.4 kB = 102.93 KiB | asset size 105397;下载后 wc -c = 105397,sha256 821ed618… |
| 解压 | 25 个条目 / 160,364 字节 | unzip -l |
| 技能目录 | 212K | du -sh skills/stack-diagram |
| SKILL.md | v0.6.0 22,137 字节;main 23,938 字节 | 本地 wc -c vs contents API |
| 取 logo | 11.7 秒 | fetch_icons.py → real 11.706s,四个品牌加 Vercel 深色版全部 OK ... svgl |
| 组装 | 不到 1 秒 → 105,408 字节 | build.py → built out/saas.html (102 KB);html_bytes = 105408 |
| 单文件自检 | data:image 6 / data:font 2 / 未解析 %%TOKEN%% 0 | 见 evidence.md §4.2 |
| 渲染 | 11.7 秒 → 2000×1080 | render_local.py → real 11.68s;light 87,917 字节,dark 94,703 字节 |
| 全链路 | 约 24 秒(不含下载) | 11.7 + <1 + 11.7 |
| 仓库 size | 3,450 KB | "size": 3450,这是仓库体积,不是包体积 |
两条路径并列写:一条是我没跑通的官方文档装法,一条是我实际走通的 release zip。哪条是实测,标清楚。
npx skills add caru-ini/stack-diagram
我试了两次,skills@latest 和 skills@1.9.0。两次都被本机宿主的安全自动复核以 medium risk 拦下,命令没有执行。不是 registry 的问题,也不是网络问题。所以我不会把它写成「本机实测可跑」。它是官方文档里的装法,需要在允许执行第三方脚本的环境里自己试。
curl -sSL -H 'Accept: application/octet-stream' -o stack-diagram.zip \ https://api.github.com/repos/caru-ini/stack-diagram/releases/assets/742744355 unzip -q stack-diagram.zip -d skills
GitHub Releases 里 v0.6.0 提供了 stack-diagram.zip,README 把这条列为 Claude apps 的装法。unzip 退出码 0,得到 skills/stack-diagram:25 个文件,212K,SKILL.md 22,137 字节。
一个网络上的坑:github.com/.../releases/download/... 直链在我这台机器上 15 秒连不上,302 之后超时。走 API asset 端点 1.85 秒就下完了,文件是同一个,105,397 字节。
没跑通的、只有单次计时的、只在一种输入上试过的,都列在这里。
npx skills add caru-ini/stack-diagram 在本机被宿主安全复核拦下,未实测通过。render_png.py 默认的 Playwright headless-shell(chromium_headless_shell-1255 在沙箱时间预算内没下下来)。截图语义(.canvas、--scale 2、去圆角、明暗双主题)逐行照抄原脚本,差异只在浏览器可执行文件。size: 3450 是 GitHub 的仓库体积字段(KB),不是包体积。包体积是 105,397 字节,两者别混用。fetch_icons.py 调用(nextjs / postgresql / redis);Vercel 是随后单独一次调用,没有单独计时,evidence.md 按整批合计记为 11.7 秒。复跑时若要逐次计时,数字可能不同。