nicobailon GitHub avatar

visual-explainer

JavaScript
可视化讲解技能集nicobailon最近推送 2026年11月5日
未分类MIT11.2k7053 issues7 天 +204

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

把终端里的复杂输出转成可读的 HTML 页面或幻灯片,供编程 Agent 使用。

这是一个面向编程 Agent 的技能(skill),当 Agent 需要解释系统架构、审查代码差异、对比计划或展示数据表时,它会生成一个自包含的 HTML 页面并在浏览器中打开,替代传统的 ASCII 图和终端表格。支持多种 Agent 运行环境,如 Claude Code、Pi、MCP 主机、Cursor 等。

推荐指数

4.0

对经常用 Agent 做架构解释和代码审查的开发者很实用,能显著提升可读性,但需要按环境配置。

近 7 天

+204

新增 Star

总 Star 排名

#622

雷达追踪的 3,958 个 AI 仓库中

创建于

2026

2026年2月17日

核心亮点

  • 1告别 ASCII 图

    用真实排版和手绘风格图表替代终端里的字符画和表格。

  • 2多环境支持

    覆盖 Claude Code、Pi、MCP、Cursor、Codex CLI 等十余种 Agent 运行方式。

  • 3零构建依赖

    常规使用只需浏览器,无需构建步骤;可选功能才依赖 Node。

  • 4交互式图表

    支持状态机逐事件回放、动画和明暗主题切换。

  • 5导出能力

    可将 HTML 幻灯片转为 PPTX 或录制为带旁白的 MP4 视频。

适用场景

  • 系统架构讲解

    例如:让 Agent 画出认证流程的示意图,生成 HTML 页面在浏览器中查看。

  • 代码差异审查

    例如:使用 /diff-review 命令,把 diff 渲染成带高亮的 HTML 审查页。

  • 计划审计对比

    例如:用 /plan-review 对比 15 条需求与重构计划,生成可读的对比表格。

  • 项目总结汇报

    例如:将项目进展数据生成幻灯片式 HTML 页面,或导出为 PPTX。

它是怎么工作的

  1. 第 1 步

    接收请求

    Agent 根据用户指令(如画图、审查 diff)触发该技能。

  2. 第 2 步

    生成 HTML

    技能将复杂信息组织成自包含的 HTML 页面,包含样式和交互。

  3. 第 3 步

    打开浏览

    生成的页面在浏览器中打开,或通过 Glimpse 查看器展示。

  4. 第 4 步

    可选导出

    可将 HTML 幻灯片转为 PPTX 或录制为 MP4 视频。

快速上手

  1. 1

    Claude Code 安装

    通过插件市场添加并安装。

    /plugin marketplace add nicobailon/visual-explainer
    /plugin install visual-explainer@visual-explainer-marketplace
  2. 2

    Pi 安装

    使用 pi install 从 GitHub 安装。

    pi install git:github.com/nicobailon/visual-explainer
  3. 3

    其他环境

    按 README 表格将插件目录复制到对应 Agent 的技能路径。

适合谁

  • 经常用编程 Agent 解释架构或审查代码的开发者
  • 需要向团队展示复杂技术信息的工程师
  • 使用 Claude Code、Pi、Cursor 等支持技能扩展的 Agent 用户

不太适合

  • 不常使用编程 Agent 的开发者
  • 只需要纯文本输出的轻量场景

成熟度

  • 活跃度最近一次推送在 2026 年 11 月,star 数超过 1.1 万,活跃度高。
  • 文档README 详细列出了各环境安装方式和命令,但部分高级功能说明较简略。
  • 社区有 702 个 fork 和 1.1 万 star,但开放 issue 仅 3 个,社区讨论规模有限。
  • 上手难度需要按不同 Agent 环境手动配置路径,对新手有一定门槛。

使用前注意

  • · 不同 Agent 环境的安装路径和配置方式不同,需对照 README 操作。
  • · 视频导出需要额外安装 ffmpeg、Chrome 和 playwright-core。
  • · PPTX 导出为尽力而为的静态工具,复杂 HTML 可能转换不完整。
  • · 项目采用 MIT 许可,可自由使用和修改。