lieflat-charts

一、平台与项目介绍

1. 项目名称：lieflat-charts。
2. 开发团队：moxt.ai 团队。
3. 核心定位：面向 AI Agent 的数据可视化 Skill（技能）。
4. 技术规范：基于 SKILL.md 规范开发。
5. 主要痛点：旨在解决常规 AI 直接生成图表时存在的“样式粗糙、无排版逻辑、色彩杂乱”等问题。
6. 核心价值：AI Agent 安装此 Skill 后，可直接根据数据生成设计感极强、支持交互的 HTML 独立图表或完整报告网页。

二、主要功能特点

1. 三大核心视觉体系（64+ 种图表组件）
2. Lupi 系（编辑叙事型）：采用发丝线、点阵、真实数据原子与大量留白，适合长文、论文、深度研报。
3. Glance 系（快速判断型）：粗笔画、大数字、高对比度，主打"3 秒看清趋势与异常”，适合周报、Dashboard 与 PPT 汇报。
4. Basics 系（基础型）：针对稀疏数据优化，重构经典的柱状图、折线图、环形图。
5. 完整 HTML 报告生成（Report Mode）
6. 模板数量：提供 12 款中英双语全页报告模板。
7. 适用场景：涵盖商业数据分析、财务研报、产品记录、个人 Log/海报等场景。
8. 配色与暗黑模式
9. 自动匹配：默认根据数据结构自动匹配 Mono（单色/灰阶）、Porcelain、Palm、Wire 等色彩预设。
10. 自定义支持：亦可由用户自定义品牌色。
11. 原生响应式与交互性
12. 技术栈：生成的均为原生纯 HTML/JS 页面。
13. 功能特性：自带优雅的动画、悬浮提示和高保真排版。
14. 环境要求：无需依赖任何第三方复杂的打包环境。

三、适用人群

1. AI Agent 开发者 / 高阶使用者：使用 Claude Code、Codex、Moxt 等平台的开发者，需让 Agent 具备高颜值出图能力。
2. 数据分析师 / 市场研究员：需要快速将 CSV、JSON 或论文研究数据转化为出版级图表或报告的从业者。
3. 产品经理与职场白领：需要高效制作周报、月报、Dashboard 汇报页面的用户。

四、免费 / 付费情况

1. 开源费用：lieflat-charts 项目本身采用 MIT 许可证 彻底开源免费，代码公开在 GitHub。
2. 相关服务收费：运行该 Skill 所需的 AI Agent 平台（如 Claude Code, Codex 等）由第三方按各自标准收取 API/订阅费用。
3. 官方环境：若配合官方推荐的原生开发环境 Moxt 使用，可查看其官网：https://moxt.ai。
4. 安装成本：开源项目本身无定价页面，使用 GitHub clone 或 npx 安装全过程无额外费用。

五、如何使用

1. 安装方式（二选一）
2. 命令行一键安装（推荐）bash

npx skills add https://github.com/larashero3-dotcom/lieflat-charts --skill lieflat-charts

1. AI Agent 交互安装：终端直接发指令：“请帮我安装 lieflat-charts，Clone https://github.com/larashero3-dotcom/lieflat-charts 到 ~/.claude/skills/lieflat-charts（Codex 环境请改为 ~/.codex/skills/lieflat-charts）”
2. 常用 Prompt 调优示例
3. 做单图：输入指令“用 lieflat-charts 将这份 CSV 转换成 Glance 风格的图表，适合放到演示 PPT 中。”
4. 生成整页报告：输入指令“分析这份周报数据，提炼核心结论，用 lieflat-charts 生成一份完整 HTML 格式的数据汇报页面。”

六、注意事项与踩坑点

1. 环境兼容性：需确保使用的 Agent 终端支持执行 Shell 命令或支持读取 SKILL.md 规范（如 Moxt, Claude Code, Codex 等）。
2. 图表数量控制：项目设计原则为“一图表达一独立结论”。单页报告建议图表数量不超过 6 张，过多图表会导致排版过于拥挤。
3. 颜色自定义原则：允许传入品牌主色（Brand Color），但建议保持其内建的阶梯对比度，避免传入过于刺眼或对比度极低的高饱和度色彩。
4. 触发词明确：默认 Agent 只会生成单个独立的图表；只有当 Prompt 中明确包含“报告”、“年报”、“白皮书”、“海报”等叙事词汇时，才会触发 12 全页模板生成模式。