
如何在 Factory Droid 上安装 Diagram Design 并按 commit 更新图表技能【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design在 Factory Droid 里想要生成架构、流程图、时序图等编辑风格的图表时Diagram Design 是以插件形式提供的技能skill它为 Claude Code、Codex、Factory Droid 和 Pi 提供 39 种图表类型输出自包含的 HTML SVG 文件无构建步骤、无 JavaScript、无外部图片依赖。本文覆盖从安装到更新、再到首次使用验证的完整路径前提是本地已安装可用的 Factory Droiddroid命令行。安装 Diagram Design 插件在项目目录中依次执行两条命令droid plugin marketplace add https://github.com/cathrynlavery/diagram-design droid plugin install diagram-designdiagram-design --scope user第一条命令把 diagram-design 仓库注册为一个 Git 插件市场marketplace第二条命令从该市场安装插件--scope user表示安装为个人级插件对你账号下的所有项目可见而不限于当前目录。安装的实际内容位于仓库的skills/diagram-design/目录包含SKILL.md、references/和模板assets/。Factory Droid 通过仓库根目录下的原生 manifest 加载它.factory-plugin/plugin.json是插件 manifest.factory-plugin/marketplace.json声明插件源指向仓库根。按仓库的 ADR 0008Claude Code、Codex 和 Factory 三端复用同一份skills/diagram-design/与commands/不存在 Droid 专用的副本。注意plugin.json里的version字段当前为2.6.5只是发布元数据不参与 Droid 的更新判定下一节会说明原因。按 commit 更新插件Droid 跟踪 Git 插件的方式是按 commit 跟踪而不是按 manifest 里的显示版本号。这意味着即使仓库里的version字段变了只要你不拉取新 commitDroid 也不会更新。要获取已合并的更新按顺序执行droid plugin marketplace update diagram-design droid plugin update diagram-designdiagram-design --scope user然后开启一个新会话新会话才会加载更新后的技能。ADR 0008 也确认了这一点Git 方式的 Factory 安装按 marketplace 的 commit 更新同步的 manifest 版本保留为发布元数据和评审门槛。运行 doctor 诊断确认本地环境就绪安装完成后在 Factory Droid 会话中运行/doctor可选参数--strict会把警告升级为失败--json追加机器可读的 JSON 报告。这是一次只读诊断不会安装依赖、不会修改文件、不会执行破坏性的 git 操作因此可以放心运行。诊断按固定顺序执行检查并逐项报告pass/warn/failPython 运行时先解析python3再回退到python要求版本不低于 3.10找不到解释器或版本低于 3.10 记为fail。Playwright 可用性PNG 导出用检查import playwright是否可用、Chromium 是否已安装。缺失时记warn并给出确切提示pip install playwright playwright install chromium但 doctor 本身绝不会自动安装。常见路径错误检查解析出的安装根目录下的SKILL.md是否存在若缺失建议重新安装或更新 Diagram Design而不是让你进入维护者的仓库目录。输出的契约是一行汇总Doctor summary: PASS|WARN|FAIL (pass pass, warn warn, fail fail)加逐项清单只有存在 warn/fail 时才会出现Next actions段落。下面是 references/doctor.md 中的文档示例输出Doctor summary: WARN (6 pass, 2 warn, 0 fail) [PASS] Python 3.11.9 found at /usr/bin/python3 [WARN] Playwright package not found in active interpreter [PASS] scripts/verify-drawio-import.py present ... Next actions - Install PNG export dependencies: pip install playwright playwright install chromium - Re-run: /diagram-design:doctor --strict上面是文档示例你的实际检查项数量与环境会不同。对安装路径来说关键判定是只要出现FAIL比如找不到 Python 解释器先按Next actions处理再谈画图Playwright相关的WARN只影响 PNG 导出——HTML/SVG 产出本身不依赖它。首次使用与结果验证在 Droid 会话中直接提需求即可例如 Make me an architecture diagram of my app: frontend, backend, database, Redis cache.agent 会选定类型、构建 HTML 并保存。首次在新项目中出图时skill 会检查references/style-guide.md是否已定制过。如果仍是默认样式它不会静默用默认皮肤出货而是暂停并询问你从你的网站 URL 拉取品牌 token、从已安装 skill 提取、从本地文件夹/设计系统目录提取、手动粘贴 token、加载已保存的 client profile或直接用默认样式继续。这个门禁的完整规范见 references/onboarding.md。生成图表后运行 skill 自带的输出自检脚本来验证这个文件python3 skills/diagram-design/scripts/self_check.py 生成的图表文件对生成的文件打印OK即表示该输出通过了打包时的自检契约。注意这个脚本位于维护者仓库中如果你是通过插件市场安装的请在 skill 安装位置对应的scripts/目录下运行或参照 SKILL.md 中的输出检查说明。限制与边界更新必须开新会话droid plugin update之后旧会话不会自动热加载新版技能README 明确要求 start a new session。版本号只是元数据Droid 按 commit 跟踪更新看到 manifest 里version变化不代表你的 Droid 端已更新是否更新只取决于 marketplace 是否拉到了新 commit。doctor 只读它不会替你装 PlaywrightPNG 导出缺依赖时安装命令需要你自己在项目环境执行。旧版独立安装的迁移如果你此前用npx skills add装过一份独立副本它不会自动跟随 Codex marketplace需要移除该独立副本、改装 README 中的市场命令之后各客户端才走原生更新路径。完成安装、/doctor无 FAIL、首图通过self_check.py后后续日常使用就是直接提需求需要品牌化出图时再按需走一次 onboarding 即可。【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考