本项目是适配 Claude、Codex 的开源绘图技能，生成带规范中文标注 3D 材质图解，搭配配套卡片工具一站式完成自媒体、课件配图制作。
一、这个项目能做什么？
编号1、项目核心开发者介绍 项目作者op7418，圈内名称歸藏，长期深耕AI设计、Claude Agent技能开发领域。 拥有成熟的图文自动化工作流搭建经验，配套开发了guizang-social-card-skill社交卡片配套工具。 完整打通内容配图+封面排版全流程，擅长解决中文内容可视化、AI绘图文字错乱、图表失真等行业痛点。
编号 2、项目基础简介
仓库地址：https://github.com/op7418/guizang-material-illustration
是 Claude Code、OpenAI Codex 专属开源绘图 Skill。
为文字内容生成带原生中文标签的歸藏材质 3D 图解，专门解决文章、PPT、新媒体内容缺少逻辑清晰的中心配图的痛点。
是社交卡片生成工具 guizang-social-card-skill 的配套子项目，前者产出中心插画，后者负责整张卡片版式排版。
编号 3、核心服务与目标市场
服务对象：中文内容创作者、技术从业者、教育老师、职场办公人群
目标场景：公众号、小红书、PPT、教学课件、技术文档、工作周报配图
核心技术优势：内置完整 QA 校验机制、冷门概念参考检索、图表语义还原、原生中文标签稳定渲染，采用瑞士简约 3D 材质视觉体系，不用人工调整提示词就能产出可读图解。
编号 4、三大核心服务功能
第一，概念解释图生成：把抽象技术、人文、科学概念做成带箭头、中文标签的逻辑图解。
第二，图表智能美化：上传截图 / 原始数据，自动提取数值、坐标轴，重绘材质化可视化图表，不照搬原图劣质排版。
第三，冷门素材参考辅助绘图：针对专业术语、科学仪器、历史物件、品牌 Logo 先检索事实参考，再统一转为项目专属材质画风，避免绘图出错。
二、Github项目代码库供那些人使用？
编号1、仓库数据 该仓库无公开单独标注Star、Fork统计数据，属于Claude生态细分技能仓库，受众垂直，没有大规模流量。 开源协议完全免费，允许Fork二次修改、自定义绘图模板。
编号 2、目标用户群体与特征
新媒体创作者：公众号、小红书博主，需要批量产出内容配图。
技术研发 / 产品经理：输出技术流程图、产品架构图、周报可视化图。
教师 / 教研人员：制作中小学理化生、文史知识讲解图解。
文字工作者：专栏、科普文章、读书笔记配图。
AI 工具玩家：使用 Claude Code、Codex 本地 Agent 的开发者。
编号 3、使用环境与场景
运行环境：本地电脑安装 Claude Agent 工具，macOS、Windows、Linux 全平台兼容。
使用场景：新媒体配图、工作汇报、教学课件、技术文档、知识科普图文。
编号 4、使用门槛与必备基础
基础门槛：会使用终端执行简单 git、npx 命令，拥有 Claude Code 或 OpenAI Codex 使用权限。
无需技能：不用手绘基础、不用专业设计软件操作。
进阶门槛：自定义提示词模板、修改视觉规则需要基础 markdown 阅读能力。
三、有哪些有亮点的特色功能和服务？
编号1、原生中文标签嵌入绘图（核心亮点） 详细内容：AI出图时直接在画面内生成短中文标签、箭头、图例，强制限制标签字数2-5个字，杜绝整段文字堆图、文字乱码、标注错位问题。 使用效果：生成的图解不用后期手动加字，缩小到小红书3:4尺寸也能清晰看清标注，完美适配传播载体。
编号 2、图表语义智能重绘功能
详细内容：输入图表截图或纯数据，自动识别图表类型、标题、坐标轴、数值、误差线，舍弃原图杂乱排版，重新制作干净 3D 材质图表。
使用效果：劣质截图一键升级专业可视化图，保证原始数据完全准确，不会篡改数值。
编号 3、冷门概念参考检索绘图
详细内容：针对 PKCE、科学装置、历史器物、专业管理框架等小众内容，先检索客观事实与视觉标准，再绘图，不会出现结构、部件绘制错误。
使用效果：专业科普、技术文档配图零常识错误，不用人工核对素材。
编号 4、多类型图解自动识别路由
详细内容：不用用户手动选择绘图模式，工具自动区分流程图、循环图、层级架构图、对比图、科学机制图；极端复合内容同时包含多种图表时识别会失效，需要手动指定绘图类型。
使用效果：普通单类型文字输入就能自动匹配对应绘图结构，降低操作成本。
编号 5、内置全流程 QA 校验机制
详细内容：图片生成完成后自动检查中文错别字、数据误差、画面裁切、参考素材准确性，出现错误自动重绘。
使用效果：大幅减少人工返工，批量出图稳定性大幅提升。
编号 6、多主题色视觉扩展
详细内容：默认 IKB 基础蓝，额外提供柠檬黄、柠檬绿、安全橙、石墨黑多套配色体系。
使用效果：适配不同品牌、内容风格，统一多图视觉调性。
编号 7、配套社交卡片 Skill 联动工作流
详细内容：先生成本项目中心插画，再把图片交给 guizang-social-card-skill 完成小红书、公众号封面完整排版。
使用效果：图文一体化生产，不用跨工具导图，完整适配新媒体发布尺寸。
四、如何使用工具和服务？
1、有没有演示网址？
项目未提供独立在线演示网站，仅支持本地Agent部署使用。 无云端在线预览地址，全部操作依托本地Claude Code终端执行。
2、安装部署这个项目对环境有哪些要求？
编号1、操作系统支持 Windows10/11、macOS全版本、Linux Ubuntu、CentOS均可本地私有化部署。
编号 2、软件环境基础要求
本地安装 Node.js，支持 npx 命令。
本地部署 Claude Code / OpenAI Codex Agent 工具。
终端支持 git 命令，能执行克隆、拉取更新代码操作。
编号 3、硬件无硬性限制，普通笔记本、台式机均可运行，无需高配显卡。
编号 4、部署方式：以本地私有化部署为主，无官方 Dockerfile，但用户可自行编写 Docker 打包本地运行；无可视化网页服务，理论可通过 API 转发对接 Vercel/Cloudflare 中转，适配难度极高，不推荐普通用户使用。
3、如何安装部署？
编号1、方式一：一行命令快速安装（推荐新手） 1. 打开电脑终端。 2. 直接输入命令执行：npx skills add https://github.com/op7418/guizang-material-illustration –skill guizang-material-illustration。 3. 等待工具自动克隆代码、配置目录，安装完成即可直接使用。
编号 2、方式二：AI 指令自动安装（仅限拥有 shell 权限的 Agent）
复制指令发给 Claude：帮我安装 guizang-material-illustration。请把 https://github.com/op7418/guizang-material-illustration 克隆到～/.claude/skills/guizang-material-illustration。
Agent 自动创建目录、克隆代码。
校验目录文件：确认 SKILL.md、assets、references 三个文件夹存在即安装成功。
编号 3、方式三：手动 git 命令部署
终端执行创建目录并克隆代码：git clone https://github.com/op7418/guizang-material-illustration.git ~/.claude/skills/guizang-material-illustration。
输入 ls ~/.claude/skills/guizang-material-illustration/，查看核心文件是否齐全。
安装完成。
编号 4、更新项目步骤
终端进入项目目录执行 git pull。
或发送指令给 AI：帮我更新 guizang-material-illustration，执行 git pull 并返回最新提交记录。
4、使用的大模型是什么？
编号1、图像生成依赖OpenAI图像生成接口（DALL·E系列），项目内部封装统一imagegen调用层。 编号2、上层Agent运行依托Claude Code、OpenAI Codex大模型解析文本、拆解绘图需求、生成规范提示词。 编号3、支持用户自有API密钥接入，可替换同系列兼容图像模型。
5、举例说明基本使用方法
编号1、实操例子：给小学科学课文做杠杆原理图解 1. 安装完成后，直接对Claude Agent发送指令：给这篇小学科学课文做一张杠杆原理图，图里标出支点、用力点、阻力点和力臂。 2. 工具自动执行流程：读取指令→判定为科学机制图→检索杠杆标准结构参考→压缩3-5个中文标签→生成材质3D图解。 3. 自动校验标签文字、结构是否准确，有错自动重绘。 4. 输出带标注的成品图片，可直接导入PPT、小红书卡片工具。
编号 2、另一实操例子：周报配图
发送指令：把这个周报整理成一张项目状态配图，包含进展、风险、决策、下周。工具自动生成四象限工作汇报图解。
6、最近升级或者增加了哪些新的功能？
编号1、优化中文标签渲染规则，缩短标签自动重绘逻辑，解决文字错乱问题。 编号2、完善图表美化规则，新增桑基图、热力图、漏斗图材质化渲染支持。 编号3、补充reference参考检索校验规则，降低冷门概念绘图出错概率。 编号4、优化与guizang-social-card-skill联动交互逻辑，简化跨工具传图步骤。 编号5、更新多套主题色视觉模板，新增石墨黑深色模式适配。
7、它还有哪些资源和工具？
编号1、项目内置文档资源 SKILL.md：完整触发规则、工作流程、交付标准。 PRODUCT.md：产品定位、适用边界、版本规划Roadmap。 HANDOFF.md：测试案例、绘图验证标准。 references文件夹：视觉风格、图表规则、提示词模板、QA检查清单全套文档。 assets文件夹：可复用AI绘图提示词模板。
编号 2、配套联动工具
同作者开源 guizang-social-card-skill，负责小红书、公众号封面完整排版，二者搭配形成完整图文工作流。
编号 3、社区资源
开源仓库支持用户提交 PR、Issue，可自定义新增图表模板、场景案例，共享自制提示词模板。
五、需要哪些资源支持？
编号1、本地运行基础资源 本地电脑磁盘空间，项目代码占用不足100MB。 Node.js运行环境，终端git工具。 Claude Code/OpenAI Codex Agent客户端。 OpenAI图像生成API密钥（付费调用图像生成接口）。
编号 2、部署限制
无官方 Docker 打包方案，用户可自行编写 Dockerfile 本地封装；无官方适配 Vercel、Cloudflare 网页托管方案，中转部署难度极高。
编号 3、数据库需求
项目无本地数据库依赖，所有绘图规则、模板以 markdown 文件本地存储，无需 MySQL、Redis 等数据库。
六、网友提出了哪些常见问题
编号1、问题：这个Skill能直接生成完整小红书卡片吗？ 答案：不能，它只产出卡片中心插画，完整封面排版、标题、尺寸交给配套guizang-social-card-skill处理。
编号 2、问题：生成图片里中文标签出错怎么解决？
答案：指令缩短标签文字重新生成，不要后期手动贴图添加文字。
编号 3、问题：只提供纯数据，不上传截图可以美化图表吗？
答案：可以，提供图表类型、数值、单位、核心结论就能生成材质图表。
编号 4、问题：支持生成英文为主的图解吗？
答案：支持，纯英文内容会自动切换英文标注；但中英文混合画面容易出现标签排版错位，属于已知局限。
编号 5、问题：能不能部署到网页端在线使用？
答案：不能，无官方网页服务，仅支持本地 Claude Agent 终端运行，自行中转部署门槛很高。
七、用户评价怎么样？
编号1、正面评价1：专门做中文标注图解的AI绘图工具太少见，普通AI画图要么没字要么文字乱码，这个自带校验，做科普配图效率翻倍。
编号 2、正面评价 2：图表美化功能特别实用，周报里模糊截图丢进去，自动还原干净数据图，不用自己重新做 Excel 图表。
编号 3、正面评价 3：搭配同系列社交卡片工具，写文章配图、做小红书封面一套流程走完，不用来回切换软件导图，自媒体人刚需。
编号 4、正面评价 4：冷门技术概念绘图很稳，像 PKCE 这类专业术语，会先查参考再画图，不会出现结构画错的低级错误，适合技术文档配图。
编号 5、负面评价 1：只能本地部署，没有官方网页在线版本，也没有开放 API 给团队多人共用，多人协作场景使用不方便。
八、与同类型项目对比有哪些亮点和不足？
编号1、对比基础说明 选取3个同类Claude绘图Skill对比：frontend-design、自媒体xhs-images、Open Design
编号 2、对比项目 1：frontend-design（Anthropic 官方排版 Skill）
本项目亮点：专注知识图解、图表美化，原生中文标签渲染，自带素材参考检索，适合科普、技术内容；frontend-design 主打 HTML 页面排版，虽支持简易流程图，但缺少 3D 材质画风、自动中文标注能力。
本项目不足：不支持网页页面设计，仅产出单张插画，页面排版相关功能弱于官方工具。
编号 3、对比项目 2：自媒体 xhs-images（通用小红书绘图 Skill）
本项目亮点：3D 材质杂志风视觉质感更强，有完整数据校验机制，图表还原精度更高，适配教学、技术等专业内容；xhs-images 只做纯氛围感海报，缺少逻辑图解、数据图表功能。
本项目不足：没有批量多图自动排版功能，单次指令仅生成单张图，批量组图效率不如 xhs-images。
编号 4、对比项目 3：Open Design（开源本地 AI 设计工作站）
本项目亮点：上手成本极低，一行命令即可安装，无需复杂前端配置，专门适配 Claude Agent 自然语言指令；Open Design 需要部署 Web 前端，配置流程繁琐，新手门槛高。
本项目不足：功能单一，只做中心插画，缺少完整画布、图层编辑能力，自定义设计自由度远低于 Open Design。
相关软件