{
  "markdown": "# thesis-figure-skill\n\n**中文 | [English](README.en.md)**\n\n> Claude Skill：粘贴论文文案或上传图片，自动生成学术级配图（LaTeX/TikZ + draw.io）\n\n一个用于 [Claude](https://claude.ai) 的 Skill，让 AI 自动将学术论文文案转化为高质量配图。支持两种输出格式：\n\n- **LaTeX/TikZ**：适合系统架构图、数据流图、几何示意图等结构化图表，可直接嵌入论文\n- **draw.io XML**：适合技术路线图、科研展示图、学术汇报配图等装饰性强的图表，支持渐变色、阴影、自由布局\n\n> 输入论文文字/图片 → 自动生成代码 → 编译验证 → 高质量交付\n\n## 效果展示\n\n### 数据可视化混合图（NEW）\n\n| Transformer 架构 + 注意力热力图 | zkSNARK 密码学流水线 + 椭圆曲线 | 扩散模型 U-Net + 损失曲线 |\n|:---:|:---:|:---:|\n| ![transformer](examples/06_transformer.png) | ![zksnark](examples/07_zksnark.png) | ![diffusion](examples/08_diffusion.png) |\n\n| 联邦学习 + 雷达图 + 收敛曲线 | 图注意力网络 GAT + 散点图 |\n|:---:|:---:|\n| ![fl_crypto](examples/09_fl_crypto.png) | ![gat](examples/10_gat.png) |\n\n### 经典图表类型\n\n| 编译器优化流程图 | 时序交互图 | 对比方案图 |\n|:---:|:---:|:---:|\n| ![compiler_pipeline](examples/05_compiler_pipeline.png) | ![sequence_interaction](examples/01_sequence_interaction.png) | ![comparison](examples/02_comparison.png) |\n\n| 分层路线图（draw.io） | 侧栏+中心嵌套图（draw.io） |\n|:---:|:---:|\n| ![layered_roadmap](examples/03_layered_roadmap.png) | ![sidebar_center](examples/04_sidebar_center.png) |\n\n> 以上示例均由本 Skill 自动生成，包含编译验证、19 项视觉审查、六维度评分全流程。\n\n> 完整版本更新历史见 [Releases](https://github.com/0xE1337/thesis-figure-skill/releases)\n\n## 特性\n\n- **双格式输出**：TikZ 嵌入论文 + draw.io 自由编辑，按需选择\n- **数据可视化嵌入**：在框图内嵌入热力图、柱状图、波形、雷达图、散点图——架构流程 + 数据展示一张图搞定\n- **文案驱动**：粘贴论文段落，自动分析内容生成画图指令，再转化为代码\n- **图片驱动**：上传已有截图，自动复刻为可编辑代码\n- **领域自适应**：自动识别论文所属学科，以该领域专家视角设计配图\n- **统一配色**：TikZ 内置 6 色暖色架构配色 + 蓝紫冷色数据可视化配色；draw.io 提供 4 套领域主题配色\n- **14 种图表类型**：分层架构图、时序图、对比图、流水线图、三栏映射图、几何数学图、多实例汇聚图、电路原理图、数据可视化混合图、draw.io 路线图等\n- **19 项审查规则 + 六维度评分**：生成后自动编译、转 PNG、基于渲染图视觉审查，不满分自动迭代修改\n- **三阶段自动化质检**：编译前坐标验证 → 编译后 PDF 重叠检测（pdfplumber, 0.1pt 精度）→ 可选 A* 路径规划\n- **设计野心体系**：最低设计门槛 + ASCII 布局草图 + 三轮自审（找 bug→找平庸→找排版问题）\n- **防御性 TikZ 模板**：箭头防刺入（shorten）、连线防贴框（-|/|-）、分叉防断连（coordinate）、装饰防遮挡（background 层）\n- **A* 路径规划器**：密集连线场景自动计算避障正交路径，告别手动路由\n- **中文优先**：原生支持中文标签，多平台 CJK 字体自动检测\n- **渐进式规则加载**：核心规则常驻，审查清单和专项规则按需加载，节省上下文 token\n- **进化基线**：已验证最佳参数自动复用，标准只升不降\n- **经验自动沉淀**：55+ 条踩坑经验自动记录，后续复用越画越顺\n\n## 安装\n\n### 方法一：命令行安装（推荐）\n\n```bash\nnpx skills add 0xE1337/thesis-figure-skill\n```\n\n### 方法二：上传安装\n\n下载 [`thesis-figure-skill.skill`](thesis-figure-skill.skill) 文件，在 Claude 对话中上传，点击 **\"Copy to your skills\"** 即可。\n\n### 方法三：手动安装\n\n将 `skills/thesis-figure-skill/` 整个目录（包含 `SKILL.md` 和 `references/` 子目录）复制到 Claude 的 skills 目录下。\n\n## 使用方式\n\n### 4 种生成模式\n\nskill 根据你的描述自动选择生成路径（默认走 A，无需手动指定）：\n\n| 模式 | 触发示例 | 说明 |\n|------|---------|------|\n| **A 模板复用**（默认）| \"帮我画一张 X 图\" | 从 6 个验证过的版面骨架中选最匹配的，复制版面 + 替换内容。最快最稳，版面经大量迭代零回归 |\n| **C 原创设计** | \"独特版面\"、\"从零设计\"、\"复刻这张图\" | 不依赖骨架从零设计版面，经独立多镜头审查 gate 把关后交付 |\n| **D 沉淀入库** | \"把这张 .tex 存进模板库\" | 把你画好的图自动入库为新骨架，模板库越用越大 |\n\n> B 模式（跨骨架拼装模块）规划中，当前自动回退到 A。\n\n安装后，在 Claude 对话中直接说：\n\n```\n帮我根据以下论文内容画一张架构图：\n\n本文提出一种基于联邦学习的隐私保护框架，包含三层结构：\n底层为分布在各医院的本地训练节点...（粘贴论文段落）\n```\n\n或者上传一张已有的图片：\n\n```\n帮我用 TikZ 复刻这张图\n（附上截图）\n```\n\n或者指定使用 draw.io 格式：\n\n```\n帮我画一张技术路线图，用 draw.io 格式\n（粘贴论文内容）\n```\n\n> **提示**：首次运行时需要安装字体和 TeX 编译环境，耗时较长，请耐心等待。后续使用会直接复用已创建的环境。\n\nClaude 会自动：\n1. 识别论文领域\n2. 选择合适的输出格式（TikZ / draw.io）\n3. 生成详细画图指令\n4. 输出完整代码\n5. 编译验证（TikZ）或生成可编辑文件（draw.io）\n6. 自动评分，不达标则迭代修改\n7. 交付最终文件\n\n## 输出格式对比\n\n| 场景 | 推荐格式 | 理由 |\n|------|---------|------|\n| 嵌入 LaTeX 论文、含数学公式、结构化图表 | **TikZ** | 编译可控，公式精确 |\n| 技术路线图、科研展示图、装饰性强（渐变/阴影） | **draw.io** | 视觉效果好，可拖拽编辑 |\n| 用户明确指定 | 遵循用户要求 | — |\n\n## 支持的图表类型\n\n| 类型 | 布局 | 适用场景 |\n|------|------|---------|\n| 系统架构图 | 垂直分层 | 端→云→链、硬件→中间件→应用 |\n| 时序交互图 | 多列生命线 | 多方协议交互、握手流程 |\n| 对比方案图 | 左右并列 | 原有 vs 改进方案 |\n| 数据流水线图 | 水平多阶段 | 数据处理流水线 |\n| 电路/约束原理图 | 左→右 | ZK 电路、信号处理、编译器 pipeline |\n| 三栏映射图 | 左-中-右 | 格式转换、API 适配、编码映射 |\n| 几何/数学示意图 | 坐标系 | 算法原理、向量关系、椭圆曲线 |\n| 多实例汇聚图 | 横排→汇聚 | 联邦学习、分布式系统 |\n| **数据可视化混合图** | **框图+嵌入图表** | **深度学习架构+热力图/柱状图/曲线** |\n| 技术路线图 | 多层板块 | 研究框架、技术方案总览（draw.io） |\n| 同心嵌套图 | 多层嵌套 | 从宏观到微观（draw.io） |\n| 侧栏+中心图 | 左右侧栏 | 技术突破+路径+核心（draw.io） |\n| 总论-展开-归纳图 | 顶→三栏→底 | 核心创新+应用场景（draw.io） |\n| 分层技术路线图 | 多层板块 | 毕业论文路线图、开题报告（draw.io） |\n\n## 配色方案\n\n内置 draw.io 风格配色，适合学术论文：\n\n| 颜色 | 填充色 | 边框色 | 典型用途 |\n|------|--------|--------|---------|\n| 蓝色 | `#DAE8FC` | `#6C8EBF` | 通用模块、基础层 |\n| 绿色 | `#D5E8D4` | `#82B366` | 核心模块、安全组件 |\n| 橙色 | `#FFE6CC` | `#D79B00` | 数据流、强调元素 |\n| 紫色 | `#E1D5E7` | `#9673A6` | 高层抽象、决策层 |\n| 红色 | `#F8CECC` | `#B85450` | 关键操作、警告 |\n| 灰色 | `#F5F5F5` | `#666666` | 辅助服务、存储 |\n\n### 数据可视化配色（嵌入图表专用）\n\n| 颜色 | 色值 | 用途 |\n|------|------|------|\n| waveBlue | `#3B82F6` | 主波形线、柱状图 |\n| wavePurple | `#8B5CF6` | 副波形线 |\n| heatDeep | `#6D28D9` | 热力图最深 |\n| heatMid | `#93C5FD` | 热力图中 |\n| heatLight | `#DBEAFE` | 热力图浅 |\n\n> 架构框图用暖色（蓝绿橙紫红灰），嵌入可视化用冷色（蓝紫），两套配色自然区分\"结构\"和\"数据\"。\n\n### draw.io 领域配色方案\n\n根据论文所属领域自动选择：\n\n| 方案 | 名称 | 适用领域 |\n|------|------|---------|\n| A | 学术蓝灰 | 计算机、工程、通用学术 |\n| B | 粉紫渐变 | 生物医学、心理学 |\n| C | 翠绿自然 | 环境科学、农业、生态 |\n| D | 科技深色 | 网络安全、区块链、硬件 |\n\n## 环境要求\n\n本 Skill 在 Claude Code 中运行，自动处理编译环境。如需本地编译 TikZ 示例：\n\n- TeX Live（含 `xelatex`）\n- CJK 中文字体（macOS 自带 PingFang SC，Linux 需安装 Noto Sans CJK SC，Windows 使用 SimHei）\n- ctex 宏包\n- poppler-utils（用于 PDF 转 PNG）\n- Python 3.8+（用于自动化质检工具）\n- pdfplumber（用于编译后重叠检测）\n- pathfinding（可选，用于 A* 路径规划）\n- draw.io Desktop（可选，用于 draw.io 格式导出）\n\n### macOS（推荐）\n\n```bash\n# 安装 TeX Live\nbrew install --cask mactex-no-gui\n# 安装 poppler（提供 pdftoppm）\nbrew install poppler\n# 安装 Python 质检工具依赖\npip3 install pdfplumber pathfinding\n# 安装 draw.io Desktop（可选，用于 draw.io 格式导出）\nbrew install --cask drawio\n\n# 编译 TikZ\nxelatex -interaction=nonstopmode example.tex\n# 转 PNG（300dpi）\npdftoppm -png -r 300 example.pdf preview\n```\n\n> macOS 自带 PingFang SC 字体，无需额外安装中文字体。\n\n### Ubuntu/Debian\n\n```bash\nsudo apt-get install texlive-xetex texlive-lang-chinese fonts-noto-cjk poppler-utils\npip3 install pdfplumber pathfinding\n# 编译\nxelatex -interaction=nonstopmode example.tex\n# 转 PNG\npdftoppm -png -r 300 example.pdf preview\n```\n\ndraw.io 格式的文件可直接在 [app.diagrams.net](https://app.diagrams.net) 打开编辑，也可用 draw.io Desktop 导出 PDF/PNG。\n\n## 许可证\n\nMIT License\n",
  "bytes": 5811,
  "sha": "8fb93bf89b5fd09100eefcf351b01bbbf37c0159032de9b27d17741d6040a87e",
  "repo_slug": "0xe1337/thesis-figure-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_0xe1337_thesis_figure_skill_tikz_figure__13e5a7a7/readme"
}