alchaincyf/huashu-design

GITHUB项目档案

主语言 HTML · 27,423 星 · MIT · 创建于 2026-04-19

打开 GitHub 仓库

Huashu Design 3.0 · 在 agent 里打一句话,拿回能交付的设计:网页 / App 原型 / 可编辑 PPTX / 动画 / 信息图 · 六个候选挑三个方向 · 84 种带样张的风格库 · 越用越懂你的外观账本与设计体检 · HTML-native design skill for Claude…

Stars 27,423 累计 star,越多说明被认可得越广
Watching 101 订阅该仓库变动的人数
Forks 2,955 被派生出去的仓库数
Issues 5 当前开放的 Issue 数
语言 HTML GitHub 自动判定的主语言
许可证 MIT 开源协议,用之前先确认能不能商用
24h 增长 — 数据积累中
7 日增长 — 数据积累中
30 日增长 — 数据积累中

仓库健康度

5 个维度
只看客观信号,不构成安全性结论
维护活跃度 数据完整
2026-10-23 23:32 最近推送

最近推送 2026-10-23 23:32(5 天前),属于活跃维护

社区响应 数据完整
5 开放 Issue

开放 Issue 5 个 · Fork 2,955 个

增长趋势 证据不足
— 7 日新增

star 记录还不够天数,增量算不出来

项目规范 数据完整
MIT 许可证

许可证 MIT · 10 个 topics · 开了 Wiki

版本发布 证据不足
— 发布次数

这一项暂无数据,不代表项目没有发布

「证据不足」表示这项数据暂时没有取到,不能读成「项目有问题」;「部分数据」表示只拿到一部分信号。版本发布要额外调 Releases 接口,下一版补。

Star 趋势

3 天记录
最近 90 天站内记录的星数
27,423当前 Star +875首尾差值 2026-10-26最早记录 2026-10-28最近记录

横轴 2026-10-26 → 2026-10-28,纵轴按这段时间的最小/最大值拉伸。趋势来自站内每天记录一次的星数,页面打开时不会实时请求 GitHub。

README 原文细节

4 个板块
项目自己写的功能与用法,原文照录

核心功能README 里列出来的能力清单

能做什么

  • 交互原型(App / Web) — 单文件 HTML · 真 iPhone bezel · 可点击 · Playwright 验证 — 10–15 min
  • 演讲幻灯片 — HTML deck(浏览器演讲)+ 可编辑 PPTX(文本框保留) — 15–25 min
  • 时间轴动画 — MP4(25fps / 60fps 插帧)+ GIF(palette 优化)+ BGM — 8–12 min
  • 设计变体 — 3+ 并排对比 · Tweaks 实时调参 · 跨维度探索 — 10 min
  • 信息图 / 可视化 — 印刷级排版 · 可导 PDF/PNG/SVG — 10 min
  • 设计方向顾问 — 三套逻辑各出两个候选(最佳设计师 + 同媒介获奖作品 + 秒数轮盘)· 六张缩略图挑三版真实视觉,另三张作备选 — 10 min
  • 5 维度专家评审 — 雷达图 + Keep/Fix/Quick Wins · 可操作修复清单 — 3 min

实现原理它内部是怎么做的

设计方向顾问

模糊需求时的 fallback:三套互补逻辑各出两个候选——最佳设计师(预算无上限时最适合的设计师)+ 现实参照(同媒介的获奖作品,先截图亲眼看)+ 秒数轮盘(从风格库随机抽,打破惯性)。六个候选先画成一页缩略图,挑最强、最不一样的三版做成真实视觉让你看着选,另外三张作为备选一起给你。背后是 84 种 HTML 原生风格库(网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12,纯 CSS 无需生图),每种都有一张样张。

鹦鹉进化史网站 · 设计方向顾问三套逻辑实战(2.0)

一句「做个介绍鹦鹉进化史的网站」、零额外要求,skill 自动跑完整 2.0 顾问流程:先判断图片是内容必需 → 抓公共领域博物插画(Edward Lear / John Gould 的鹦鹉图录)→ 三套逻辑并行(秒数轮盘 + 现实参照获奖站 + 原研哉「白」哲学)各出一版真实视觉。素材齐了再设计,不是边设计边用色块占位。

设计方向顾问(Fallback)

为什么这样做:我们拿固定题目做了三轮改前改后盲选(内部测试)。第一轮强制每版套一个大隐喻,页面被做成道具,4 题只赢 1 题;第二轮为了躲 AI 默认外观加了一堆禁令,三版一起变得「太规整,太无聊」,2 题全输;第三轮改成加选项、不加禁令——多出候选、给看得见的样张、看真参考——同两道题都赢了。

  • 先对话澄清 + 主动索要参考(名字 / logo / 品牌色 / 喜欢的参考站),只问一轮
  • 取齐内容必需的真图(公共领域 / 免版权,脚本一键抓),再开工
  • 三套逻辑各出两个候选,共六个:① 最佳设计师(两位气质不同的设计师,用他们的思维从头做)② 现实参照(两件同媒介的获奖作品——做 App 找 App、做 deck 找出版物;scripts/refboard.py 先截图亲眼看,再拆网格、字号比和色彩比例)③ 秒数轮盘(date +%S 取秒,在产出形态对应的分区和中文东亚分区各抽一号,先看样张再动手)
  • 六张缩略图 → 挑三版做完整稿:单看够好、彼此不一样、不撞你最近的项目;没选上的三张作为备选一起给你,看中哪张再做
  • 绝不让你在没看到视觉时盲选风格——摆出来就停,看着选
  • 底层是 84 种 HTML 原生风格库,每种配一张样张和源码(assets/style-specimens/),作弹药,不是教条

越用越懂你:经验、外观账本与设计体检

  • 经验:scripts/learn.py 开工前带出你说过的品味原话(「太素了」「A 的结构加 C 的颜色」)和过去的教训,收工时把值得记的记下来;记录前会告诉你,不想记可以拒绝
  • 外观账本:每次交付记一笔「长什么样」(底色、色板、字体、版式骨架,连同项目名和所在路径),下个项目主动避开——单个项目看都不错、放在一起却长得像,这种单调靠它管
  • 这些记录只存在你本机的 ~/.huashu-design/,不随 skill 分发,删掉文件夹就全部忘记

限制与常见问题项目自己写明的坑与限制

Limitations

  • 不支持图层级可编辑的 PPTX 到 Figma。产出 HTML,可截图、录屏、导图,但不能拖进 Keynote 改文字位置。
  • Framer Motion 级别的复杂动画不行。3D、物理模拟、粒子系统超出 skill 边界。
  • 完全空白的品牌从零设计质量会掉到 60–65 分。凭空画 hi-fi 本来就是 last resort。

其它说明README 里剩下的内容

3.0 案例

下面这些都是 3.0 跑出来的。前五个是从发布时新跑的 6 道题里挑的,每道只给一句话需求,方向是 agent 自己挑的,作者没插手;后两个一个是第三轮盲选赢下来的那版,一个是发布后作者拿它做的真实项目。

网页 · 《富岳三十六景》线上展

三版分别是 Rijksmuseum 官网式的暗场展厅、田中一光式的三角窗、民国书衣式的题签框。设计体检报过一次撞车:两版首屏都用了《神奈川冲浪里》,它就把暗场那版换成了《山下白雨》。

关于 huashu-design 的常见问题

3 个问题
答案来自 README 归纳与 GitHub 实时数据
huashu-design 是做什么的?

alchaincyf/huashu-design 是 GitHub 上的开源项目:Huashu Design 3.0 · 在 agent 里打一句话,拿回能交付的设计:网页 / App 原型 / 可编辑 PPTX / 动画 / 信息图 · 六个候选挑三个方向 · 84 种带样张的风格库 · 越用越懂你的外观账本与设计体检 · HTML-native design skill for Claude Code, Codex, Cursor & any agent。README 里的说明是:3 到 30 分钟,你能 ship 一段产品发布动画、一个能点击的 App 原型、一套能编辑的 PPT、一份印刷级的信息图。 不是「AI 做的还行」那种水平——是看起来像大厂设计团队做的。给 skill 你的品牌资产(logo、色板、UI 截图),它会读懂你的品牌气质;什么都不给,六张缩略图里挑出的三个真实方向 + 84 种带样张的风格库也能兜底到不出 AI slop。 你看到这篇 README 里的每一页设计,都是 huashu-design 自己做的。

huashu-design 有哪些功能?

项目 README 列出的能力包括:交互原型(App / Web) — 单文件 HTML · 真 iPhone bezel · 可点击 · Playwright 验证 — 10–15 min;演讲幻灯片 — HTML deck(浏览器演讲)+ 可编辑 PPTX(文本框保留) — 15–25 min;时间轴动画 — MP4(25fps / 60fps 插帧)+ GIF(palette 优化)+ BGM — 8–12 min;设计变体 — 3+ 并排对比 · Tweaks 实时调参 · 跨维度探索 — 10 min;信息图 / 可视化 — 印刷级排版 · 可导 PDF/PNG/SVG — 10 min;设计方向顾问 — 三套逻辑各出两个候选(最佳设计师 + 同媒介获奖作品 + 秒数轮盘)· 六张缩略图挑三版真实视觉,另三张作备选 — 10 min。

huashu-design 现在还在维护吗?数据怎么样?

目前 27,423 星,2,955 个 Fork,主语言 HTML,创建于 2026-04-19,最近一次推送 2026-10-23 23:32,许可证 MIT。星数、Fork、推送时间都是 GitHub 返回的实时数据,「最近推送」离现在越近说明越活跃;长期不动要留意是否已停止维护。

这些内容来自哪

读法说明
中文整理据 README 归纳,数据取自 GitHub
中文说明据项目 README 归纳只写 README 能确认的内容,不替作者补功能与数字
关键数据与 GitHub 页面一致星数、Fork、语言与时间都不做二次加工
数据日期2026-10-27 00:50星数与介绍这份数据是哪一天的

项目数据取自 GitHub 官方接口与项目 README;星数、Fork、语言与时间以 GitHub 页面为准,档案更新于 2026-10-27 00:50。