mviz

将数据分析结果快速转化为精美静态HTML报告

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mviz。
它的用途是:将数据分析结果快速转化为精美静态HTML报告
完整的 Skill 内容见:https://321skill.com/skills/mviz/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我将最近三个月的销售数据用柱状图和趋势线展示出来,并生成一个报告文件。” AI会先编写一份mviz规范,然后根据你的需求,要么在聊天窗口内直接渲染出图表预览,要么运行CLI命令生成一个独立的 `report.html` 文件供你下载和分享。

介绍

mviz 是一个面向AI的图表和报告构建器,它解决了数据分析师和开发者在展示数据时,需要快速生成美观、专业且可分享的可视化报告的问题。它允许用户通过简洁的Markdown或JSON规范来描述图表、表格、KPI指标等组件,从而将数据快速转化为可视化内容。

使用方式非常灵活。用户只需编写一份mviz规范,即可根据场景选择两种渲染方式:在支持 visualize:show_widget 的AI对话界面(如Claude.ai)中,可以内联渲染图表,直接嵌入对话流;对于需要分享、保存或打印的场景,则可以使用mviz CLI命令行工具,将同一份规范生成为独立的、设计精美的完整HTML文件。

这个工具非常适合数据分析师、产品经理、开发者和任何需要频繁进行数据沟通的职场人士。当他们在AI辅助分析数据后,需要立即将结果可视化呈现,或者需要生成一份正式的报告文件用于邮件发送、会议演示或存档时,mviz能极大地提升效率。

与同类数据可视化工具或技能相比,mviz的核心优势在于其“一次编写,多处渲染”的理念。它定义了一套与渲染器解耦的规范语言,确保了可视化描述的可移植性和一致性。用户无需为不同输出格式(如内嵌聊天窗口或独立网页)编写两套代码,大大降低了使用和维护成本。

核心特点

mviz 的核心区别在于其规范与渲染器分离的架构:同一份简洁的Markdown/JSON规范,可根据场景无缝切换为AI对话内嵌渲染或生成独立HTML文件,实现了“一次编写,两种输出”,避免了为不同展示环境重复定义可视化内容。

注意事项

不适合需要复杂交互(如数据点钻取、动态筛选)或实时数据流更新的动态仪表板场景。

常见问题

mviz 需要安装吗?

无需安装,可直接使用 `npx -y -q mviz` 命令运行;如需频繁使用,建议全局安装以获得更佳体验。

生成的HTML报告能自定义样式吗?

可以,mviz CLI 使用名为“mdsinabox”的预设主题(极简风格,高数据墨水比),但目前主要通过规范控制布局和组件,深度样式定制能力有限。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mviz/raw/index.md 读取 mviz 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。