visual-explainer 官方入口：HTML 图解和幻灯片生成指南

想找 visual-explainer 的官方入口？目前认准 nicobailon/visual-explainer 的 GitHub 仓库 就对了。这个仓库既是源码存放地，也汇总了安装说明、命令清单和版本发布入口，不用你额外注册什么在线制图账号。现在插件清单和 SKILL 元数据都标着 v0.8.1 版本。

HTML 图解和幻灯片是一回事吗？

这两种输出都是自包含的 HTML 文件，但打开后的阅读方式不一样。普通图解是可上下滚动的页面，适合放架构说明、审查报告、表格和项目回顾；幻灯片则是一个视口对应一页，带前后翻页、页码、键盘操作和位置指示。

普通 HTML 图解页用什么命令生成？

• /generate-web-diagram：任意主题都能生成对应的图解页面。
• /diff-review：把代码变更、架构影响和风险审查整合到同一页里。
• /plan-review：对照实施计划和实际代码库逐项核对。
• /project-recap：为重新进入项目准备一份可视化心智模型。

需要演示文稿时怎么选？

你只要明确说「生成幻灯片」，就会调用 /generate-slides；那些本来生成滚动页的命令，后面加个 --slides 参数也能转成幻灯片格式，比如 /diff-review --slides。Skill 会先梳理所有来源内容，把每个信息点合理分配到页面上，不会为了凑固定页数随便删内容。

生成的页面分十种版式，包括标题、章节分隔、内容、双栏、图表、看板、表格、代码、引语和满版画面。连续三页都用居中标题可不太合适，内容太密的时候就增加页数，别硬缩小字号或者让单页能滚动。

官方指南的使用顺序

1. 先看 README，确认你的 Agent 对应哪种安装方式。
2. 对照命令清单，选择图解、审查、计划或幻灯片入口。
3. 检查生成的文件是否存放在 ~/.agent/diagrams/ 目录下。
4. 打开 HTML，确认宽表不溢出、图可缩放、幻灯片不需要页面滚动。

入口正确，为什么仍可能打不开？

自动打开浏览器会受 Agent、浏览器权限和沙箱的限制，这可不代表 HTML 没生成。你先到输出目录手动打开文件试试。Mermaid 跟着系统明暗主题切换的时候可能得刷新一下页面，页面质量也会受所用模型能力影响。版本与兼容性的变化，要以 官方 Releases 为准。