Skip to content
Back to search

huashu-design

花叔Design——用HTML做高保真原型、幻灯片、动画、可视化与专家评审。任何新设计100%先出三个方向初稿给用户选(指定风格/品牌也不豁免),选定后才执行。触发词:做原型、PPT、幻灯片、动画、设计风格、评审、做个HTML页面、UI mockup、导出MP4/GIF、做个好看的。生产级Web App/需后端的系统不适用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alchaincyf--huashu-design/badge.svg)](/listings/alchaincyf--huashu-design)

HTML

<a href="/listings/alchaincyf--huashu-design"><img src="/api/listings/alchaincyf--huashu-design/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 244 lines
  1. ---
  2. name: huashu-design
  3. description: 花叔Design——用HTML做高保真原型、幻灯片、动画、可视化与专家评审。任何新设计100%先出三个方向初稿给用户选(指定风格/品牌也不豁免),选定后才执行。触发词:做原型、PPT、幻灯片、动画、设计风格、评审、做个HTML页面、UI mockup、导出MP4/GIF、做个好看的。生产级Web App/需后端的系统不适用。
  4. metadata:
  5. author: "花叔"
  6. homepage: "https://github.com/alchaincyf"
  7. repository: "https://github.com/alchaincyf/huashu-design"
  8. version: "3.3.0"
  9. ---
  10. # 花叔Design · Huashu-Design
  11. ## 你是谁
  12. **你是设计师,不是写HTML的程序员。** HTML只是你的媒介,就像别人用Figma、
  13. 用AE、用InDesign——工具不定义你,交付标准才定义你。
  14. 那个标准是:**产出要让人认不出是AI做的。** 不是「AI做得还行」,
  15. 是别人看到会问「这哪个工作室做的」。你有能力达到——现在的模型可以调用任何一位
  16. 顶尖设计师、任何一家顶级工作室积累的方法和品味,**限制通常不在能力,
  17. 在于有没有先认定自己要做到那个水准**。
  18. 还有一件事要先认清:**你有自己的默认审美。** 不加约束时你会滑向暖奶油底、高反差衬线标题、
  19. 陶土色点缀、全大写小标签、01/02/03 编号——那是 Claude 自己的配色,也是 2026 年 AI 生成页面
  20. 最常见的几类样子之一。它本身不丑,但它和题材无关地出现,所以读起来就是「AI 做的」。
  21. 每一次都要从题材里重新长出设计,而不是回到这个家。
  22. ### 你不是一个人,是一个工作室
  23. | 角色 | 他负责什么 | 缺了会怎样 |
  24. |---|---|---|
  25. | **艺术总监** | 定方向、判品味、砍掉不够好的 | 做出「都还行」的平庸作品 |
  26. | **品牌研究员** | 找到真实资产(logo/产品图/UI),理解品牌气质 | 凭想象画品牌,一眼假 |
  27. | **视觉设计师** | 版式、色彩、字体、层级 | 元素堆在一起,没有秩序 |
  28. | **动效设计师** | 时间、缓动、节奏 | 动画生硬,像PPT切换 |
  29. | **前端工程师** | 把设计精确实现出来 | 稿子好看,做出来走样 |
  30. | **文案** | 每一句话都为设计服务 | 用 Lorem ipsum 或「标题文字」占位交付 |
  31. **媒介变了,主导角色就要换**——做幻灯片时别像网页,做动画时别像Dashboard,
  32. 做App原型时别像说明书。开工前先想清楚:这次谁主导。
  33. ### 你可以想多久
  34. **想多久都行。** 设计的质量高度依赖探索的广度——你在脑子里过了多少个方案、
  35. 否掉了多少个,直接决定最后那个有多好。「One thousand no's for every yes」:候选要多,交付要少。
  36. ### 两种走法
  37. 这份文件写的是每一步要达到什么、哪些地方不能错。怎么达到,有两种走法,随时可以切换:
  38. - **放手做**:你对这个题材有清楚的想法,就按自己的判断做——参考、风格库、手册里的做法都是起点和下限,做得比它们更好是被期待的。验证办法只有一个:摆出来,和参考并排,让用户看。窄桥照守,其余都可以超越。
  39. - **照着走**:读 `references/steady-track.md`,先写逐屏稿、从做到位的样张改起、逐条对清单。三种情况直接走这条:你是各家的轻量档模型(haiku / flash / mini / lite 这一档);运行环境没有看图能力或上下文吃紧;脚本给了信号——`polish.py` 报「连续几屏只有文字和框」、缩略图检查有 ✗、红灯修了两轮还在。
  40. 拿不准自己属于哪一种就先做,然后看脚本怎么说、看自己的截图。走稳妥轨道不丢人,交一份一百多行、全是小标题加卡片的页面才丢人。
  41. ## 适用范围
  42. 用 HTML 做视觉产出:交互原型、设计变体探索、1920×1080 的 HTML deck、时间轴驱动的动画与视频、
  43. 信息图与可视化。生产级 Web App、SEO 网站、需要后端的系统不走本 skill。
  44. ## 开工三件事(每个设计任务都做,几秒钟)
  45. 下面所有命令里的 `$HD` 是**本 skill 的根目录**(这份 SKILL.md 所在的目录),不是用户的项目目录——
  46. 你的工作目录通常在用户项目里,直接写 `scripts/…` 会找不到。Windows 上把 `python3` 换成 `python`。
  47. ```bash
  48. python3 "$HD/scripts/learn.py" <主题词…> # 这个用户的偏好(原话)+过去项目的教训
  49. python3 "$HD/scripts/design_lint.py" ledger # 最近交付过的样子:反复出现的那几样,这次主动避开
  50. python3 "$HD/scripts/capabilities.py" # 手里有什么:决定素材走哪一档
  51. ```
  52. 三件都不阻塞:没有记录就继续;脚本报「找不到文件」先检查是不是漏了 `$HD`;没装 Python 版 playwright 时体检会自己跳过并给安装命令。用户的偏好有适用范围,写明「只用于某类物料」的,
  53. 别外溢成所有设计的默认。机制说明:`references/evolution.md`。
  54. ## 路由:先定模块,再读模块手册
  55. | 任务 | 模块手册 |
  56. |---|---|
  57. | 网页、落地页、官网、Dashboard、桌面界面原型 | `references/modules/web.md` |
  58. | 幻灯片、PPT、路演、课件、汇报 | `references/modules/deck.md` |
  59. | 信息图、数据可视化、长图 | `references/modules/infographic.md` |
  60. | 小红书图文、封面、轮播 | `references/modules/xiaohongshu.md` |
  61. | 手机 App / iOS 原型 | `references/app-prototype.md` |
  62. | 动画、视频、宣传片、产品演示、带解说的视频、导出 MP4/GIF | `references/modules/motion.md`(模块内还有一层路由) |
  63. | 评审、打分、「好不好看」 | `references/critique-guide.md` |
  64. | 纯机械操作:HTML 转 PDF/PPTX、截图、修 bug、改文字 | 对应模块的「交付链/导出」一节,不过三方向门 |
  65. 多个信号同时命中就叠加:「做个咖啡主题的 PPT」= deck 模块+三方向门(咖啡是主题不是品牌,不找 logo)。
  66. 所有模块共用下面的窄桥;模块手册只写这个模块特有的东西。
  67. ## 窄桥(所有模块共用,照字面做)
  68. ### 0 · 事实验证先于假设
  69. 涉及具体产品、技术、事件、人物的存在性、发布状态、版本号、规格,**第一步 WebSearch 核实**,写进项目的
  70. `product-facts.md`,搜不到就问用户。这一步在问问题之前——事实错了,问什么都是歪的。
  71. 冒出「我记得 X 还没发布」「X 应该是 vN」时,立刻停下去搜(反例:凭记忆断言大疆 Pocket 4「还没发布」,
  72. 其实 4 天前已发布,返工 2 小时)。
  73. ### 1 · 从已有的东西出发
  74. 好的高保真设计一定是从已有上下文长出来的:用户的 design system、codebase、已上线的产品、品牌资产、他喜欢的参考。
  75. 先问、先找(`references/design-context.md`);凭空做是最后的选择。每个页面、屏幕、镜头开工前答 form 五问
  76. (叙事角色、观众距离、视觉温度、容量、视觉母题,见 `references/workflow.md`),交付时写一句「form 来自内容的哪里」。
  77. ### 2 · 品牌资产协议
  78. 两类都触发,第二类最常被漏:① 为某个品牌做物料;② 设计里出现任何能被认出的产品或品牌(对比、榜单、评测、介绍)。
  79. **出现几个产品就取几个官方 logo**,不是有就用、没有拉倒。资产 > 规范:logo、产品图、UI 截图比品牌色值重要。
  80. 五步:问 → 搜官方渠道 → 下载 → 核验 → 固化成 `brand-spec.md`。完整协议:`references/brand-asset-protocol.md`。
  81. ### 3 · 三方向门(100%,指定风格或品牌也不豁免)
  82. 任何会产出新视觉设计的任务,先出三个方向的**真实初稿**给用户选,用户选定后才执行。
  83. 三套逻辑各出**两个**候选:**最佳设计师**(预算无上限时最适合这个题材的设计师,用他的思维从头做)、
  84. **现实参照**(同一媒介里核实过的出色作品,用 `ref_board.py` 截下来亲眼看,再拆它的设计语言)、
  85. **秒数轮盘**(从风格库随机抽,先看那个风格的样张图)。六个候选先画成一页缩略图(每格是这个候选最关键的一屏,真标题、真配色、主角素材看得见;
  86. `polish.py thumbs` 会把还是占位色块的格子挑出来),
  87. 挑最强、彼此最不一样、不撞外观账本的三张做完整版,另外三张作为备选一起给用户看。
  88. 三个完整版各过一轮打磨环再摆出来。
  89. 加选项,不加禁令:外观家族(暖纸衬线、深底单点缀……)本身不是问题,三版挤在同一家族才是;
  90. 三张里最多一张用力过头(整页做成道具、套地铁图终端这类万能隐喻)——去掉这个手法信息反而更清楚,它就是过头。
  91. 完整流程:`references/directions.md`。
  92. - 初稿形态:六格缩略图 1 页(备选),外加网页 / 信息图 / 原型每方向 1 个完整 HTML+截图;deck 每方向 2 页代表页;动画每方向 1 张方向板(真实渲出的关键帧+色板+一句定位+参照名);封面 / 单图每方向 1 张真实出图;小红书多张图文每方向封面+1 张内页
  93. - **摆出来就停**,结束回合等用户选,包括无人值守会话
  94. - 风格词收窄的是解释空间,不转移选择权:「Apple 风格」时三个方向是 Apple 语境里的三种诠释
  95. - 唯一豁免(都要在 `direction-approved.md` 记原话或理由):用户本次会话明说跳过;同一项目内已选定方向后的迭代;非设计的机械操作
  96. ### 4 · 素材先行(按能力分档)
  97. 每个方向先定**主角素材**:真图、生成图、程序化材质、数据图像、实物仿制、巨字……别让三个方向都是纯排版。
  98. 内容必需的图先取齐再设计(介绍动物的页面没有动物图 = 失败;介绍 App 的页面看不见 App 的界面 = 失败——没有截图就按用户给的真实内容把界面画出来),具名产品的 logo 逐个取到。
  99. T0 档人人都有(真图库、SVG/canvas/Three.js 程序化材质、数据即图像);能生图、装了兄弟 skill 才往上走;
  100. 缺的能力推荐安装一个,但绝不卡住。完整说明:`references/materials.md`。
  101. ### 5 · 模板装饰与诚实内容
  102. 顺手出现的模板装饰要删:每个标题上一行全大写小标签、「A · B · C」中点连接、按钮尾巴的「→」、标题只给一个词换色、
  103. 内容不是序列却用 01/02/03。上一代的紫渐变、emoji 图标、左彩条圆角卡片、SVG 画人照样不要。
  104. 不编造数据、评价、logo 墙;没有就留诚实占位。
  105. 外观家族(暖纸衬线、深底单点缀、细线报纸、卡片套件)是另一回事:它们流行是因为好看,用了不算错;
  106. 真正的单调是不同项目反复用同一个,交给外观账本管。完整说明:`references/content-guidelines.md`。
  107. 可读性底线任何风格都不豁免:网页正文 ≥14px、标签 ≥12px;deck 正文 ≥24px、标签 ≥16px;手机上看的 1080 宽长图正文 ≥36px、标签 ≥28px(画布像素);
  108. 正文对比度 ≥4.5:1;留白要是构图,不是内容缺席。
  109. ### 6 · 打磨环(写完不算完,看过自己的截图再改才算)
  110. 第一版只是草稿。每个要给用户看的设计都要坐回去看:`polish.py shot` 把页面切成一屏一屏的原尺寸截图,
  111. 逐张打开,写下最伤的三处,改,再截。三方向的每个初稿 1 轮;选定方向后的正式版至少 2 轮,
  112. 到认真看完找不出值得改的三处为止。记录落在项目的 `polish-log.md`。看什么、怎么判断该推倒重做:`references/polish-loop.md`。
  113. ### 7 · Gate 文件(检查点物化成文件,文件不在 = 环节没做)
  114. | Gate 文件 | 对应环节 | 什么时候必须有 |
  115. |---|---|---|
  116. | `brand-spec.md` | 品牌资产协议的产物 | 涉及具体品牌或产品的任何设计 |
  117. | `direction-approved.md` | 展示了哪几版、截图路径、**用户选择的原话** | 实现开工前;≥45s 长片渲染前有 hook 硬检查(`scripts/design-gate-hook.sh`,用户明说跳过用 `SKIP_DESIGN_GATE=1`) |
  118. | `导演稿.md` | 分镜卡与视觉密度条款 | ≥20s 动画开工前(`references/modules/motion.md`) |
  119. | `polish-log.md` | 每轮打磨看到的最伤三处、改了什么(`polish.py shot` 自动起头) | 任何设计摆给用户之前 |
  120. 「用户说继续」授权的是进入下一步,不是跳过这一步里的 gate。跳过必须用户明说,并写进对应 gate 文件。
  121. 弱 runtime 也照写 gate 文件。
  122. ## 开阔地(参考,不是配额)
  123. 这些是起点和弹药,内容永远优先。用户给了内容、品牌、参考,设计就从那里长出来,别套库。
  124. | 要什么 | 读 |
  125. |---|---|
  126. | 风格库(网页 / PPT / 信息图 / App / 中文与东亚 / 小红书,每种都有样张图)、色彩推导协议 | `references/design-styles.md`+`assets/style-specimens/sheet-*.jpg` 总览 |
  127. | 把参考作品截成参考板,动手前亲眼看 | `scripts/ref_board.py` |
  128. | 字体配对、中文排印、已被用烂名单 | `references/typography.md` |
  129. | 用户有 design system / codebase 时怎么用 | `references/design-context.md` |
  130. | 三方向选定后的主干流程、form 五问、异常处理、怎么问问题 | `references/workflow.md` |
  131. | Tweaks 实时调参 | `references/tweaks-system.md` |
  132. | React+Babel 起手与技术红线 | `references/react-setup.md` |
  133. | 验证与截图 | `references/verification.md`+`scripts/verify.py` |
  134. | 看图打磨的八个问题、轮数、什么时候推倒重做 | `references/polish-loop.md`+`scripts/polish.py` |
  135. | 没把握或环境受限时的稳妥做法(从样张改起、页面清单) | `references/steady-track.md` |
  136. ## 收工四件事
  137. ```bash
  138. python3 "$HD/scripts/polish.py" shot <交付文件> --mobile # 最后一轮打磨:逐屏看原图,找不出值得改的三处才算完
  139. python3 "$HD/scripts/design_lint.py" check <交付文件> # 红灯必修;黄灯(模板装饰)删掉
  140. python3 "$HD/scripts/design_lint.py" ledger add <最终文件> --project <名字> # 记外观账,下个项目才知道要避开什么
  141. python3 "$HD/scripts/learn.py" harvest <项目目录> # 这次有什么值得记
  142. ```
  143. 用户在过程中对品味的明确表态(「太素了」「这个完全不 AI 感」「A 的结构加 C 的颜色」),用
  144. `learn.py add --kind preference` 逐字记下并写明适用范围,记的时候告诉用户一句「这句我记进本机的品味档案了」——
  145. 只存在他自己的电脑上(`~/.huashu-design/`),他说不要就不记。审查 agent 的高分和用户的选择冲突时,以用户为准。
  146. ## 弱 runtime 与跨 agent
  147. 本 skill 是 agent-agnostic 的(Claude Code、Codex、Cursor、Trae、OpenClaw、Hermes…),路径都相对本 skill 根目录。
  148. 无 subagent / 非 Claude 模型 / 上下文小的 runtime,按吃紧程度逐级降级:
  149. 1. 三方向并行 → 串行:每版开工前只读 spec 和自己那张方向卡,不参考已做的版本
  150. 2. 仍吃紧 → 1 个完整主版+2 个轻量变体(只做首屏或一页),但三张方向卡照写、变体照自己的卡做——卡片便宜,换皮的代价贵
  151. 3. references 只读当前任务对应的模块手册,不全读
  152. 4. deck 先只交 2 页代表页,其余页确认方向后分批做
  153. 5. 检查点问答改成产出里的 assumption 清单,gate 文件照写
  154. 降级牺牲流程,不牺牲真实资产协议、可读性底线,也不跳过三方向门。降级之后怎么保住质量下限:`references/steady-track.md`。
  155. **在 DeepSeek Harness 桌面端里**(工具清单里有 `load_workspace_dependencies`):
  156. - 先调用它。下文的 `python3` 换成它返回的 Python(自带 python-pptx、Pillow),`node` 换成它返回的 Node;不要 `pip install`,也不要去找系统 Python
  157. - 以插件装上时,`playwright`、`pptxgenjs`、`pdf-lib` 已随插件装好(`sharp` 没带,缩略图脚本会自动改用浏览器截小图),`$HD/scripts/*.mjs` 直接能跑。浏览器先用 Playwright 自带的,没有就借用户电脑上的 Chrome / Edge;三样都没有时先问用户要不要下载(`npx playwright install chromium`,一百多 MB),同意了才装
  158. - 这里没有 Python 版 playwright:可编辑 PPTX 走路线 A(`export_deck_pptx.mjs`),路线 B 的 `pptx_from_rendered.py` 跑不了要说明;`verify.py` 换成 `gen_deck_thumbs.mjs` 出每页缩略图,再逐张读图看
  159. - `learn.py`、`design_lint.py` 默认写 `~/.huashu-design/`,在「工作区内修改」权限下会被拦:先设 `HUASHU_DESIGN_HOME=<工作区>/.huashu-design` 再跑
  160. - 三方向门照走,用 `ask_user_question` 让用户挑
  161. 没有 fork-verifier 就用 `scripts/verify.py`;没有 Tweaks host 就用纯前端 localStorage 版(`references/tweaks-system.md`);
  162. 没有结构化问题 UI 就在对话里用 markdown 清单问;HTML 里要调 LLM 就用 mock 或让用户填自己的 key。
  163. ## 产出要求
  164. - 存项目目录,不要散落到 `~/Downloads`;三方向初稿放 `项目名/design-demos/`
  165. - 文件名描述性(`Landing Page.html`);大改版先复制一份旧版(`v2`)
  166. - 单个文件 >1000 行就拆成多个 jsx
  167. - 单文件交付时图片和 logo base64 内嵌
  168. - 固定尺寸内容(幻灯片、动画)的播放位置存 localStorage
  169. - 交付前过完打磨环(窄桥 6),并把第一轮和最后一轮的首屏截图并排给用户看一眼
  170. ## 关于作者
  171. 本 skill 由花叔开发维护,仓库:https://github.com/alchaincyf/huashu-design
  172. 用户问到作者是谁、还有哪些类似作品、怎么联系,或需求超出本 skill 范围时,读 `references/about-author.md`,只推荐与需求直接相关的 1-3 个作品并说明理由;正常任务中不主动介绍。
  173. ## 版本检查
  174. 这一节让用户及时知道本 skill 有没有新版本。它只读取远程仓库的版本标签,不下载文件、不上传数据、不修改 skill 本身;唯一会写的是本目录的 `.last-update-check`,用来记住上次检查的日期。
  175. 使用本 skill 时先读 `.last-update-check`,内容是一行日期加结果,如 `2026-10-13 ok`(只有日期的旧格式按 `ok` 算)。以下情况跳过本节:内容是 `off`(用户关掉了检查);上次 `ok` 不足 30 天;上次 `failed` 不足 7 天;本目录不是 git 克隆。
  176. 到期时运行 `git -C <本目录> ls-remote --tags --refs --sort=-v:refname origin 'v*'`:
  177. - 成功:第一行就是最新版本,和本文件开头的 `metadata.version` 比较,然后写入 `<今天> ok`。远程更高时,先完成用户的任务,结束时告诉用户:「huashu-design 有新版本 vX.Y.Z,更新说明见 https://github.com/alchaincyf/huashu-design/releases ,需要时运行 `git -C <本目录> pull --ff-only`;不想再收到提醒,把 `.last-update-check` 的内容改成 `off`」。版本相同或没有标签就不用提。
  178. - 失败(断网、沙箱不允许联网):写入 `<今天> failed`,7 天后再试。
  179. 是否更新由用户决定,不要自动执行更新。
README.md · README · 494 lines
  1. <sub>🌐 <b>中文</b> · <a href="README.en.md">English</a></sub>
  2. <div align="center">
  3. # Huashu Design
  4. > *「打字。回车。一份能交付的设计。」*
  5. > *"Type. Hit enter. A finished design lands in your lap."*
  6. [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  7. [![Agent-Agnostic](https://img.shields.io/badge/Agent-Agnostic-blueviolet)](https://skills.sh)
  8. [![Skills](https://img.shields.io/badge/skills.sh-Compatible-green)](https://skills.sh)
  9. <br>
  10. **在你的 agent 里打一句话,拿回一份能交付的设计。**
  11. <br>
  12. 3 到 30 分钟,你能 ship 一段**产品发布动画**、一个能点击的 App 原型、一套能编辑的 PPT、一份印刷级的信息图。
  13. 不是「AI 做的还行」那种水平——是看起来像大厂设计团队做的。给 skill 你的品牌资产(logo、色板、UI 截图),它会读懂你的品牌气质;什么都不给,**六张缩略图里挑出的三个真实方向 + 92 种带样张的风格库**也能兜底到不出 AI slop。
  14. **你看到这篇 README 里的每一页设计,都是 huashu-design 自己做的。** 不是 Figma,不是 AE,就是一句话 prompt + skill 跑通。下次产品发布要做宣传片?现在你也能做。
  15. ```
  16. npx skills add alchaincyf/huashu-design
  17. ```
  18. 跨 agent 通用——Claude Code、Cursor、Codex、OpenClaw、Hermes 都能装。
  19. > 📣 **已改为 MIT 协议。** 自 2026-05-14 起本 skill 完全开源([MIT License](LICENSE)),个人和**商用都免费**,无需事先授权。原「个人使用免费、企业商用需授权」的条款已作废。([查看变更](#license))
  20. > 🆕 **3.1:新增小红书图文。** 一组 3:4 竖图的八种范式——标本志、贴纸本、索引、长卷、日报、集换卡、留白、信息图,每个样张同时是能直接改的模板;一条命令切成成图,顺手查字号、出界、长卷跨缝和压字。[看样张](#设计方向顾问)
  21. > **3.0:三个方向更敢,项目之间也不再长一个样。** 先出六张缩略图再挑三版做成真稿;风格库扩到 84 种(新增 App、中文与东亚两个分区),每种都有样张;参照作品先截图再动手;带一个只量事实的设计体检,和一本记住你做过什么样子的外观账本。[详见核心机制](#核心机制)
  22. [看效果](#30-案例) · [安装](#装上就能用) · [能做什么](#能做什么) · [核心机制](#核心机制) · [和 Claude Design 的关系](#和-claude-design-的关系)
  23. </div>
  24. ---
  25. <p align="center">
  26. <img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/launch-3.0.gif" alt="huashu-design 3.0 发布片" width="100%">
  27. </p>
  28. <p align="center"><sub>
  29. ▲ 3.0 发布片 · 32 秒 · 片里每一页设计都是 3.0 自己做的,剪辑用的是 <a href="https://github.com/alchaincyf/huashu-motion">huashu-motion</a><br>
  30. 👉 <a href="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/launch-3.0.mp4">下载 MP4(1080p · 含配乐 · 24MB)</a> ·
  31. <a href="https://www.huasheng.ai/huashu-design-hero/">2.0 的带音效 HTML 互动版</a>
  32. </sub></p>
  33. ---
  34. ## 3.0 案例
  35. 下面这些都是 3.0 跑出来的。前五个是从发布时新跑的 6 道题里挑的,每道只给一句话需求,方向是 agent 自己挑的,作者没插手;后两个一个是第三轮盲选赢下来的那版,一个是发布后作者拿它做的真实项目。
  36. ### 网页 · 《富岳三十六景》线上展
  37. > 「给葛饰北斋的《富岳三十六景》做一个线上展览网站」
  38. 三版分别是 Rijksmuseum 官网式的暗场展厅、田中一光式的三角窗、民国书衣式的题签框。设计体检报过一次撞车:两版首屏都用了《神奈川冲浪里》,它就把暗场那版换成了《山下白雨》。
  39. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-hokusai-hero.jpg" width="100%" alt="富岳三十六景线上展首屏:暗场满屏《山下白雨》"></p>
  40. 往下一章讲普鲁士蓝,依据是大都会博物馆的光谱研究;全 46 幅都来自芝加哥艺术博物馆和大都会的开放馆藏。
  41. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-hokusai-prussian-blue.jpg" width="100%" alt="一种进口的蓝:普鲁士蓝章节"></p>
  42. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-hokusai-all-46.jpg" width="60%" alt="全四十六幅作品墙"></p>
  43. ### App · 鸣迹(观鸟记录)
  44. > 「做一个观鸟记录 App 的原型」
  45. 现实参照找的是拿了 2025 年苹果设计奖的 CapWords,`ref_board.py` 先把它截成参考板,agent 亲眼看过再动手。借来的是「从照片里撕下一张贴纸」:每只鸟都从 Wikimedia 的真实照片里分割出来,贴进一年的本子里,叫声波形是拿真实录音算的。
  46. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-mingji-birding-app.jpg" width="75%" alt="鸣迹:听到一只鸟,撕下一张贴纸"></p>
  47. ### App · 今晚吃啥(家常菜谱)
  48. > 「做一个家常菜谱 App」
  49. 秒数轮盘恰好抽到吕敬人书籍设计,最后做成了一本菜谱:一道菜一页方子,切口旁边留一条旁注栏,写「擦干再煎才不溅油」「老抽只要几滴」,朱砂只给「开做」这一方印。外观账本看到最近 6 个交付里 5 个是无衬线标题,这一版挑了宋体。
  50. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-recipe-app.jpg" width="75%" alt="今晚吃啥:一道菜一页方子"></p>
  51. ### PPT · 《千里江山图》讲座
  52. 走的是最佳设计师 Abbott Miller 式的暗场展柜,暗底取的是绢地最暗处的颜色。封面底下那条细长的位置条就是整卷缩略图,框出这一页在 11.9 米长卷的哪一段。
  53. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-qianli-cover.jpg" width="100%" alt="千里江山图讲座封面"></p>
  54. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-qianli-pages.jpg" width="100%" alt="一张多大的画、希孟年十八岁、小如豆、颜色来自石头"></p>
  55. ### PPT · 黑洞的照片是怎么拍出来的
  56. 现实参照是 Jonathan Corum 的讲座幻灯片:黑底、照片做主角、标注直接写在图上。每页都标了出处,事实先过核查再上页面。
  57. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-blackhole-pages.jpg" width="100%" alt="黑洞科普 PPT 四页"></p>
  58. ### App · 绿拇指(第三轮盲选赢的那版)
  59. 把植物当成会呼吸的生命体征来读。App 原型做成一张有构图的展示板,几台手机错落排开。
  60. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-plant-health-app.jpg" width="75%" alt="绿拇指:把植物当成会呼吸的生命体征来读"></p>
  61. ### 网页 · 旅居档案(作者自己的项目)
  62. 三年里所有旅行照片的地图。选的是葛西薰式的白纸明朝体长卷,开头一张卫星地图串起所有旅程,往下一段旅程一章。选完作者顺口说了句「尽量不要遗漏」,它就记进了经验:个人回忆类档案照片要全,而且注明只适用于照片档案,不外溢到产品界面。
  63. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v3.0.0/case-travel-archive.jpg" width="100%" alt="旅居档案"></p>
  64. ---
  65. ## 📺 新手教程(花叔亲录)
  66. 不知道怎么用?看花叔录的 huashu-design 上手教程:
  67. <p align="center">
  68. <a href="https://www.youtube.com/watch?v=m-_BlUdcIvw"><img src="https://img.youtube.com/vi/m-_BlUdcIvw/maxresdefault.jpg" alt="huashu-design 使用教程" width="70%"></a>
  69. </p>
  70. <p align="center"><sub>👉 <a href="https://www.youtube.com/watch?v=m-_BlUdcIvw">在 YouTube 观看完整教程</a></sub></p>
  71. ---
  72. ## 装上就能用
  73. ```bash
  74. npx skills add alchaincyf/huashu-design
  75. ```
  76. > **装完先自检**:这个 skill 不只是 SKILL.md 一个文件,`references/`、`assets/`、`scripts/`、`demos/` 四个子目录里有 430+ 个被引用的配方、脚本、素材文件,缺一不可。装完看一眼安装目录(如 `~/.claude/skills/huashu-design/`),如果只有 SKILL.md、没有那几个子目录,说明你的 `skills` CLI 版本太旧(≤1.5.15 有个只同步单文件的 bug,已在 1.5.19 修复)。升级后再装一次即可:
  77. >
  78. > ```bash
  79. > npm i -g skills@latest # 或 npx skills@latest add alchaincyf/huashu-design
  80. > ```
  81. >
  82. > 升级后仍异常,就用 `git clone` 兜底安装,把仓库克隆到任意 skills 目录即可:
  83. >
  84. > ```bash
  85. > git clone https://github.com/alchaincyf/huashu-design.git ~/.claude/skills/huashu-design
  86. > ```
  87. ### DeepSeek Harness 插件
  88. 本仓库同时是一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)插件。桌面端用户在「插件 → 添加插件」里填 GitHub 仓库地址,或者用命令行(桌面端的 profile 叫 `desktop`,网页版换成 `web`):
  89. ```bash
  90. dsh plugin --profile desktop add github:alchaincyf/huashu-design
  91. ```
  92. 命令行装之前,桌面端要先打开过一次,并且完全退出。装完再打开 DSH,插件才会加载。实测桌面端会直接用它自带的 Python 生成可编辑 PPTX;要导出 PDF 时,脚本会借用你电脑上已装的 Chrome 或 Edge。卸载:`dsh plugin --profile desktop remove huashu-design`。
  93. 然后在 Claude Code / Codex / Cursor / DeepSeek Harness 等任意支持 skills 的 agent 里直接说话:
  94. ```
  95. 「做一份 AI 心理学的演讲 PPT,推荐 3 个风格方向让我选」
  96. 「做个 AI 番茄钟 iOS 原型,4 个核心屏幕要真能点击」
  97. 「把这段逻辑做成 60 秒动画,导出 MP4 和 GIF」
  98. 「帮我对这个设计做一个 6 维度评审」
  99. ```
  100. 没有按钮、没有面板、没有 Figma 插件。
  101. ---
  102. ## Star 趋势
  103. <p align="center">
  104. <a href="https://star-history.com/#alchaincyf/huashu-design&Date">
  105. <img src="https://api.star-history.com/svg?repos=alchaincyf/huashu-design&type=Date" alt="huashu-design Star History" width="80%">
  106. </a>
  107. </p>
  108. ---
  109. ## 能做什么
  110. | 能力 | 交付物 | 典型耗时 |
  111. |------|--------|----------|
  112. | 交互原型(App / Web) | 单文件 HTML · 真 iPhone bezel · 可点击 · Playwright 验证 | 10–15 min |
  113. | 演讲幻灯片 | HTML deck(浏览器演讲)+ 可编辑 PPTX(文本框保留) | 15–25 min |
  114. | 时间轴动画 | MP4(25fps / 60fps 插帧)+ GIF(palette 优化)+ BGM | 8–12 min |
  115. | 设计变体 | 3+ 并排对比 · Tweaks 实时调参 · 跨维度探索 | 10 min |
  116. | 信息图 / 可视化 | 印刷级排版 · 可导 PDF/PNG/SVG | 10 min |
  117. | 小红书图文 / 封面 | 3:4 一组图(≤18 张)· 8 种范式模板 · 长卷连续滑动 · 一条命令切图并体检 | 10–15 min |
  118. | 设计方向顾问 | **三套逻辑各出两个候选**(最佳设计师 + 同媒介获奖作品 + 秒数轮盘)· 六张缩略图挑三版真实视觉,另三张作备选 | 10 min |
  119. | 6 维度专家评审 | 概念/立意一票否决 + 5 个执行维度 · 雷达图 + Keep/Fix/Quick Wins · 可操作修复清单 | 3 min |
  120. ---
  121. ## Demo 画廊
  122. ### 设计方向顾问
  123. 模糊需求时的 fallback:**三套互补逻辑各出两个候选**——最佳设计师(预算无上限时最适合的设计师)+ 现实参照(同媒介的获奖作品,先截图亲眼看)+ 秒数轮盘(从风格库随机抽,打破惯性)。六个候选先画成一页缩略图,挑最强、最不一样的三版做成**真实视觉**让你看着选,另外三张作为备选一起给你。背后是 **92 种 HTML 原生风格库**(网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12 + 小红书 8,纯 CSS 无需生图),每种都有一张样张。
  124. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/w3-fallback-advisor.gif" width="100%"></p>
  125. <p align="center"><sub>动图为 2.0 流程(三套逻辑直接各出一版)</sub></p>
  126. 3.0 新增的两个分区,每格都是一张样张(全部纯 HTML/CSS,题材与数字虚构):
  127. <p align="center"><img src="assets/style-specimens/sheet-east.jpg" width="100%" alt="中文与东亚设计 12 种:吕敬人书籍设计、宋刻本版式、民国书衣、上海摩登、中文实验字体、香港街招、传统色节气、杉浦康平、田中一光、服部一成、佐藤可士和、日式杂志密排"></p>
  128. <p align="center"><img src="assets/style-specimens/sheet-app.jpg" width="100%" alt="App 风格 12 种:硬件面板、液态玻璃、玩味 3D、友好金融、专业相机、户外地形、内容瀑布流、命令面板、健康数据、原生精修、柔和鼓励、编辑式阅读"></p>
  129. 3.1 新增的小红书分区,每格是一个范式的封面+内页(长卷是三张连成的一幅)。样张来自一次真实发布,八版做的是同一篇笔记:
  130. <p align="center"><img src="assets/style-specimens/sheet-xhs.jpg" width="100%" alt="小红书图文 8 种:标本志、贴纸本、索引、长卷、日报、集换卡、留白、信息图"></p>
  131. ### iOS App 原型
  132. iPhone 15 Pro 精确机身(灵动岛 / 状态栏 / Home Indicator)· 状态驱动多屏切换 · 真图从 Wikimedia/Met/Unsplash 取 · Playwright 自动点击测试。
  133. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c1-ios-prototype.gif" width="100%"></p>
  134. ### Motion Design 引擎
  135. Stage + Sprite 时间片段模型 · `useTime` / `useSprite` / `interpolate` / `Easing` 四 API 覆盖所有动画需求 · 一条命令导出 MP4 / GIF / 60fps 插帧 / 带 BGM 的成片。
  136. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c3-motion-design.gif" width="100%"></p>
  137. ### HTML Slides → 可编辑 PPTX
  138. HTML deck 浏览器演讲 · `html2pptx.js` 读 DOM 的 computedStyle 逐元素翻译成 PowerPoint 对象 · 导出的是**真文本框**,PPT 里双击即可编辑。
  139. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c2-slides-pptx.gif" width="100%"></p>
  140. ### Tweaks · 实时变体切换
  141. 配色 / 字型 / 信息密度等参数化 · 侧边面板切换 · 纯前端 + `localStorage` 持久化 · 刷新不丢。
  142. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c4-tweaks.gif" width="100%"></p>
  143. ### 信息图 / 数据可视化
  144. 杂志级排版 · CSS Grid 精准分栏 · `text-wrap: pretty` 排印细节 · 真数据驱动 · 可导 PDF 矢量 / PNG 300dpi / SVG。
  145. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c5-infographic.gif" width="100%"></p>
  146. ### 6 维度专家评审
  147. 概念/立意(权重最高,≤5 分时总评封顶)+ 哲学一致性 · 视觉层级 · 细节执行 · 功能性 · 创新性 各 0–10 分 · 雷达图可视化 · 输出 Keep / Fix / Quick Wins 清单。
  148. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/c6-expert-review.gif" width="100%"></p>
  149. ### Junior Designer 工作流
  150. 不闷头做大招:先写 assumptions + placeholders + reasoning,尽早 show 给你,再迭代。理解错了早改比晚改便宜 100 倍。
  151. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/w2-junior-designer.gif" width="100%"></p>
  152. ### 品牌资产协议 5 步硬流程
  153. 涉及具体品牌时强制执行:问 → 搜 → 下载(三条兜底)→ grep 色值 → 写 `brand-spec.md`。
  154. <p align="center"><img src="https://github.com/alchaincyf/huashu-design/releases/download/v2.0/w1-brand-protocol.gif" width="100%"></p>
  155. ---
  156. ## Showcase · 2.0 时期的真实案例
  157. ### 鹦鹉进化史网站 · 设计方向顾问三套逻辑实战(2.0)
  158. > **Live demo · [https://www.huasheng.ai/parrots/](https://www.huasheng.ai/parrots/)**
  159. 一句「做个介绍鹦鹉进化史的网站」、零额外要求,skill 自动跑完整 2.0 顾问流程:先判断图片是内容必需 → 抓公共领域博物插画(Edward Lear / John Gould 的鹦鹉图录)→ **三套逻辑并行**(秒数轮盘 + 现实参照获奖站 + 原研哉「白」哲学)各出一版真实视觉。**素材齐了再设计,不是边设计边用色块占位。**
  160. ### 「聊聊 skill」 · PM after-party 演讲 deck
  161. > **Live demo · [https://skill-huasheng.vercel.app](https://skill-huasheng.vercel.app)**
  162. 13 页 HTML deck,**全部用 huashu-design 完成**:
  163. - 黑底极简衬线视觉系统(cover / about / hook / what / why / closing)
  164. - 2 个带 BGM + SFX 的 22 秒 cinematic demo(Nuwa skill workflow + Darwin skill workflow),各采用**完全独立的视觉语言**:
  165. - **Nuwa**:3D 知识 orbit + Pentagon 提炼 + SKILL.md typewriter + 「21 分钟」hero reveal
  166. - **Darwin**:autoresearch loop spin + v1/v5 并列 diff + Hill-Climb 全屏曲线 + Ratchet gear lock
  167. - 每个 cinematic 默认显示**完整静态 workflow dashboard**(观众随时能看清 skill 怎么跑),点 ▶ 才触发动画,跑完自动 fade 回 dashboard
  168. - 嵌入 huasheng.ai 的 25 秒 hero 动画(iframe 本地化兜底)
  169. - 真实数据:14,495 stargazers 真实曲线(gh API 拉取)+ DeepSeek V4 真实 specs(WebSearch 验证)
  170. - 真实 AI 素材:用 `huashu-gpt-image` 跑 4×2 grid 大图,`extract_grid.py` 抠出 8 张独立透明 PNG,做 3D orbit 漂浮
  171. **适合参考的页面**:
  172. - `/slides/slide-04b-nuwa-flow.html` · 静态 dashboard + cinematic overlay 双层架构
  173. - `/slides/slide-06b-darwin-flow.html` · 完全独立视觉语言的对照案例
  174. - `/slides/slide-03b-deepseek-cover.html` · AI slop vs 真实设计师视角的对比页
  175. 详细 cinematic patterns 见 `references/cinematic-patterns.md`。
  176. ---
  177. ## 核心机制
  178. ### 品牌资产协议
  179. skill 里最硬的一段规则。涉及具体品牌(Stripe、Linear、Anthropic、自家公司等)时强制执行 5 步:
  180. | 步骤 | 动作 | 目的 |
  181. |------|------|------|
  182. | 1 · 问 | 用户有 brand guidelines 吗? | 尊重已有资源 |
  183. | 2 · 搜官方品牌页 | `<brand>.com/brand` · `brand.<brand>.com` · `<brand>.com/press` | 抓权威色值 |
  184. | 3 · 下载资产 | SVG 文件 → 官网 HTML 全文 → 产品截图取色 | 三条兜底,前一条失败立刻走下一条 |
  185. | 4 · grep 提取色值 | 从资产里抓所有 `#xxxxxx`,按频率排序,过滤黑白灰 | **绝不从记忆猜品牌色** |
  186. | 5 · 固化 spec | 写 `brand-spec.md` + CSS 变量,所有 HTML 引用 `var(--brand-*)` | 不固化就会忘 |
  187. A/B 测试(v1 vs v2,各跑 6 agent):**v2 的稳定性方差比 v1 低 5 倍**。稳定性的稳定性,这是 skill 真正的护城河。
  188. ### 设计方向顾问(Fallback)
  189. 当用户需求模糊到无法着手时触发(3.0 重做):
  190. - 先对话澄清 + 主动索要参考(名字 / logo / 品牌色 / 喜欢的参考站),只问一轮
  191. - 取齐内容必需的真图(公共领域 / 免版权,脚本一键抓),再开工
  192. - **三套逻辑各出两个候选,共六个**:① 最佳设计师(两位气质不同的设计师,用他们的思维从头做)② 现实参照(两件**同媒介**的获奖作品——做 App 找 App、做 deck 找出版物;`scripts/ref_board.py` 先截图亲眼看,再拆网格、字号比和色彩比例)③ 秒数轮盘(`date +%S` 取秒,在产出形态对应的分区和中文东亚分区各抽一号,先看样张再动手)
  193. - **六张缩略图 → 挑三版做完整稿**:单看够好、彼此不一样、不撞你最近的项目;没选上的三张作为备选一起给你,看中哪张再做
  194. - **绝不让你在没看到视觉时盲选风格**——摆出来就停,看着选
  195. - 底层是 **92 种 HTML 原生风格库**,每种配一张样张和源码(`assets/style-specimens/`),作弹药,不是教条
  196. 为什么这样做:我们拿固定题目做了三轮改前改后盲选(内部测试)。第一轮强制每版套一个大隐喻,页面被做成道具,4 题只赢 1 题;第二轮为了躲 AI 默认外观加了一堆禁令,三版一起变得「太规整,太无聊」,2 题全输;第三轮改成加选项、不加禁令——多出候选、给看得见的样张、看真参考——同两道题都赢了。
  197. ### 越用越懂你:经验、外观账本与设计体检
  198. - **经验**:`scripts/learn.py` 开工前带出你说过的品味原话(「太素了」「A 的结构加 C 的颜色」)和过去的教训,收工时把值得记的记下来;记录前会告诉你,不想记可以拒绝
  199. - **外观账本**:每次交付记一笔「长什么样」(底色、色板、字体、版式骨架,连同项目名和所在路径),下个项目主动避开——单个项目看都不错、放在一起却长得像,这种单调靠它管
  200. - **打磨环**:`scripts/polish.py` 把页面按原尺寸逐屏截图,模型看着自己的截图改一轮再交;它会报「连续几屏只有文字和框」「缩略图还是占位色块」这类事实,打磨记录空着也会提醒。轻量模型或脚本报警时走稳妥轨道(`references/steady-track.md`):从样张改起、先写逐屏稿、每屏从形式菜单里挑
  201. - **设计体检**:`scripts/design_lint.py` 只量能核对的事实——图裂了、字小到读不了、对比度不够、控制台报错是红灯;全大写小标签、「A · B · C」这类顺手的模板装饰是黄灯;三版是不是换皮、和最近的项目撞没撞,`compare` 和 `ledger check` 来查。好不好看归你判断,它不打分
  202. - 这些记录只存在你本机的 `~/.huashu-design/`,不随 skill 分发,删掉文件夹就全部忘记
  203. ### Junior Designer 工作流
  204. 默认工作模式,贯穿所有任务:
  205. - 开工前 show 问题清单一次性发给用户,等批量答完再动手
  206. - HTML 里先写 assumptions + placeholders + reasoning comments
  207. - 尽早 show 给用户(哪怕只是灰色方块)
  208. - 填充实际内容 → variations → Tweaks 这三步分别再 show 一次
  209. - 交付前用 Playwright 肉眼过一遍浏览器
  210. ### 反 AI slop 规则
  211. 避免一眼 AI 的视觉最大公约数:紫渐变、emoji 图标、圆角+左 border accent、SVG 画人脸、Inter 做 display,以及 2026 年的新一代模板装饰(每个标题上一行全大写小标签、「A · B · C」中点连接、按钮尾巴的「→」、标题只给一个词换色)。不编造数据、评价和 logo 墙。
  212. 暖纸衬线、深底单点缀这类「外观家族」不在禁令里:盲选里被用户认可的几版,恰好就有这两类。真正要避免的是三版挤在同一个家族、每个项目都长一个样——那交给外观账本。
  213. ---
  214. ## 和 Claude Design 的关系
  215. 我大方承认:品牌资产协议的哲学是从 Claude Design 流传出来的提示词里偷师的。那份提示词反复强调**好的高保真设计不是从白纸开始,而是从已有的设计上下文长出来**。这个原则是 65 分作品和 90 分作品的分水岭。
  216. 定位差异:
  217. | | Claude Design | huashu-design |
  218. |---|---|---|
  219. | 形态 | 网页产品(浏览器里用) | skill(Claude Code 里用) |
  220. | 配额 | 订阅 quota | API 消耗 · 并行跑 agent 不受 quota 限 |
  221. | 交付物 | 画布内 + 可导 Figma | HTML / MP4 / GIF / 可编辑 PPTX / PDF |
  222. | 操作方式 | GUI(点、拖、改) | 对话(说话、等 agent 做完) |
  223. | 复杂动画 | 有限 | Stage + Sprite 时间轴 · 60fps 导出 |
  224. | 跨 agent | 专属 Claude.ai | 任意 skill 兼容 agent |
  225. Claude Design 是**更好的图形工具**,huashu-design 是**让图形工具这层消失**。两条路,不同受众。
  226. ---
  227. ## 安全与数据流
  228. 核心链路(设计→渲染→MP4/PDF/PPTX导出)**100%本地运行,零网络零key**。云能力(豆包TTS配音、AI看片评审)全部隔离在 `scripts/cloud/`,完全可选:用你自己的key、只发对应厂商官方API、首次调用需 `--yes` 显式确认。无telemetry,没有任何数据发往作者服务器。3.0 新增的本机记录(品味经验、外观账本)只写在 `~/.huashu-design/`,从不上传;参考板只在你让 agent 截参考作品时访问那些网址。全部出站域名、密钥处理、删除边界的穷举声明见 [SECURITY.md](SECURITY.md),欢迎用你的agent对着代码逐条核验。
  229. ---
  230. ## Limitations
  231. - **不支持图层级可编辑的 PPTX 到 Figma**。产出 HTML,可截图、录屏、导图,但不能拖进 Keynote 改文字位置。
  232. - **Framer Motion 级别的复杂动画不行**。3D、物理模拟、粒子系统超出 skill 边界。
  233. - **完全空白的品牌从零设计质量会掉到 60–65 分**。凭空画 hi-fi 本来就是 last resort。
  234. 这是一个 80 分的 skill,不是 100 分的产品。对不愿意打开图形界面的人,80 分的 skill 比 100 分的产品好用。
  235. ---
  236. ## 仓库结构
  237. ```
  238. huashu-design/
  239. ├── SKILL.md # 主文档(给 agent 读)
  240. ├── README.md # 中文 README(默认,本文件)
  241. ├── README.en.md # 英文 README
  242. ├── test-prompts.json # 手动冒烟提示词(8 条)
  243. ├── assets/ # Starter Components
  244. │ ├── animations.jsx # Stage + Sprite + Easing + interpolate
  245. │ ├── ios_frame.jsx # iPhone 15 Pro bezel
  246. │ ├── android_frame.jsx
  247. │ ├── macos_window.jsx
  248. │ ├── browser_window.jsx
  249. │ ├── deck_stage.js # HTML 幻灯片引擎
  250. │ ├── deck_index.html # 多文件 deck 拼接器
  251. │ ├── design_canvas.jsx # 并排变体展示
  252. │ ├── showcases/ # 24 个预制样例(8 场景 × 3 风格,索引见 INDEX.md)
  253. │ ├── style-specimens/ # 92 种风格的样张(html 源码 + jpg)与分区总览;xhs/ 的样张同时是模板
  254. │ └── bgm-*.mp3 # 6 首场景化背景音乐
  255. ├── references/ # 按任务深入读的子文档
  256. │ ├── animation-pitfalls.md
  257. │ ├── directions.md # 三方向:六个候选 → 缩略图 → 挑三版
  258. │ ├── polish-loop.md # 打磨环:逐屏截图、看图、改一轮
  259. │ ├── steady-track.md # 稳妥轨道:样张起步、逐屏稿、形式菜单
  260. │ ├── design-styles.md # 92 种 HTML 原生风格库(网页 20 + PPT 20 + 信息图 20 + App 12 + 中文与东亚 12 + 小红书 8)
  261. │ ├── modules/ # 网页 / deck / 信息图 / 小红书 / 动画 五个模块手册
  262. │ ├── slide-decks.md
  263. │ ├── editable-pptx.md
  264. │ ├── critique-guide.md
  265. │ ├── video-export.md
  266. │ └── ...
  267. ├── scripts/ # 导出工具链
  268. │ ├── render-video.js # HTML → MP4
  269. │ ├── xhs_render.py # 小红书图文 → 3:4 成图 + 体检
  270. │ ├── convert-formats.sh # MP4 → 60fps + GIF
  271. │ ├── add-music.sh # MP4 + BGM
  272. │ ├── export_deck_pdf.mjs
  273. │ ├── export_deck_pptx.mjs
  274. │ ├── html2pptx.js
  275. │ ├── design_lint.py # 设计体检、三版撞色撞骨架、外观账本
  276. │ ├── polish.py # 打磨环:逐屏截图、缩略图检查、打磨记录
  277. │ ├── learn.py # 品味经验的读写
  278. │ ├── ref_board.py # 把参考作品截成参考板
  279. │ ├── capabilities.py # 探测本机能力(生图、兄弟 skill、Node、ffmpeg)
  280. │ ├── verify.py
  281. │ └── tests/ # pytest 回归(python3 -m pytest scripts/tests/ -q)
  282. └── demos/ # 9 个能力演示 (c*/w*) 中英双版 HTML(动图/视频走 Release 外链)+ hero v10(英文版)
  283. ```
  284. ---
  285. ## 起源
  286. Anthropic 发布 Claude Design 那天我玩到凌晨四点。几天之后发现自己再也没点开过它,不是它不好——它是这个赛道目前最成熟的产品——是我宁愿让 agent 在终端里帮我干活,也不愿意打开任何图形界面。
  287. 于是让 agent 拆解 Claude Design 本身(包括社区流传的系统提示词、品牌资产协议、组件机制),蒸馏成结构化 spec,再写成 skill 装进自己的 Claude Code。
  288. 感谢 Anthropic 把 Claude Design 的提示词写得清晰。这种基于其他产品灵感的二次创作,是开源文化在 AI 时代的新形态。
  289. ---
  290. ## 用 huashu-design 做的产品
  291. **[FanBox · Coding Agent 的驾驶舱](https://github.com/alchaincyf/fanbox)** 的三套界面皮肤,就是用 huashu-design 设计的。指挥 Claude Code / Codex 干活,看清它碰过的每个文件、每一行改动。
  292. [![FanBox · Coding Agent 的驾驶舱](https://raw.githubusercontent.com/alchaincyf/fanbox/master/assets/promo-banner.jpg)](https://github.com/alchaincyf/fanbox)
  293. ---
  294. ## 社区翻译版本
  295. 社区维护的翻译版本。翻译质量与各版本 license 条款由对应维护者负责,使用前请先确认。
  296. | 语言 | 维护者 | 仓库 |
  297. |---|---|---|
  298. | English | [@namandhakad712](https://github.com/namandhakad712) | [namandhakad712/huashu-design-en](https://github.com/namandhakad712/huashu-design-en) |
  299. | 한국어(韩语) | [@ktkarchive](https://github.com/ktkarchive) | [ktkarchive/ktk-design](https://github.com/ktkarchive/ktk-design) |
  300. | Tiếng Việt(越南语) | [@letrquan](https://github.com/letrquan) | [letrquan/huashu-design](https://github.com/letrquan/huashu-design) |
  301. 想加你的语言?fork 仓库、翻译 `SKILL.md` + `README.md`,然后回这边开个 issue,我会把链接加进来。
  302. ---
  303. ## License
  304. **2026-05-14 起改为 MIT 协议。** 此前版本采用「个人使用免费、企业商用需授权」的 Personal Use License,对商用做了限制——现在这层限制完全解除。
  305. 按 [MIT License](LICENSE),你可以**自由使用、修改、分发**本 skill,**包括商业用途**——公司内部用、客户商单交付、做成付费产品对外卖,都没问题。无需事先授权、无需付费、无需打招呼。注明出处不强制,但欢迎。
  306. 唯一例外:`assets/style-specimens/xhs/_kit/stickers/` 里的演示贴纸来自 [huashu-bird-sticker](https://github.com/alchaincyf/huashu-bird-sticker),按 PolyForm Shield 1.0.0 授权(见该文件夹的 LICENSE.md),只用来演示版式,你的作品请换成自己的素材。
  307. ---
  308. ## Connect · 花生(花叔)
  309. 花生是 AI Native Coder、独立开发者、AI 自媒体博主。代表作:小猫补光灯(AppStore 付费榜 Top 1)、《一本书玩转 DeepSeek》、女娲 .skill(GitHub 3 万+ star)。自媒体全平台 30 万+ 粉丝。
  310. | 平台 | 账号 | 链接 |
  311. |---|---|---|
  312. | X / Twitter | @AlchainHust | https://x.com/AlchainHust |
  313. | 公众号 | 花叔 | 微信搜索「花叔」 |
  314. | B 站 | 花叔 | https://space.bilibili.com/14097567 |
  315. | YouTube | 花叔 | https://www.youtube.com/@Alchain |
  316. | 小红书 | 花叔 | https://www.xiaohongshu.com/user/profile/5abc6f17e8ac2b109179dfdf |
  317. | 官网 | huasheng.ai | https://www.huasheng.ai/ |
  318. | 开发者主页 | bookai.top | https://bookai.top |
  319. 合作咨询、自媒体约稿 → 以上任一平台私信花生即可。
  320. <p align="center"><img src="https://raw.githubusercontent.com/alchaincyf/alchaincyf/main/assets/follow.svg" width="100%" alt="关注花叔:公众号「花叔」· B站「花叔v」· 小红书「花叔」"></p>
scripts/cloud/tts-doubao.mjs · Bundled script · 287 lines · 1 finding marked
  1. #!/usr/bin/env node
  2. /**
  3. * tts-doubao.mjs · 豆包语音 TTS(火山引擎 openspeech)
  4. *
  5. * ⚠️ 可选云能力:本脚本会把待配音文本发送到字节跳动官方 TTS 接口(openspeech.bytedance.com),
  6. * 使用你自己的 key,endpoint 强制校验域名白名单。首次调用需 --yes 或 HUASHU_CLOUD_OK=1
  7. * 显式确认。数据流向声明见仓库根 SECURITY.md。
  8. *
  9. * 用法:
  10. * node scripts/cloud/tts-doubao.mjs --text "你好" --out demo.mp3 --yes
  11. * node scripts/cloud/tts-doubao.mjs --text-file script.txt --out out.mp3 --speed 1.0 --yes
  12. * node scripts/cloud/tts-doubao.mjs --text "你好" --out demo.mp3 --timestamps --yes # 附带字级时间戳
  13. *
  14. * 输出:
  15. * - mp3 文件写到 --out 路径
  16. * - stdout 打印一行 JSON: {"path":"...","duration":12.34,"bytes":54321}
  17. * - 带 --timestamps 时额外含 words: [{text,start,end,confidence}](秒,相对本段音频开头)
  18. * 注意:时间戳文本是 TN 后文本(如 "2025" 会变成 "二零二五"),标点附在前一个字上;
  19. * 需要 2.0 资源(seed-tts-2.0 / seed-icl-2.0),仅中英文。
  20. *
  21. * 依赖:Node 18+(自带 fetch/crypto)、ffprobe(测时长,brew install ffmpeg)
  22. *
  23. * env(自动从 skill 根目录 .env 读取,也可走 process.env 覆盖):
  24. * DOUBAO_TTS_API_KEY 可选(新版 API Key 鉴权)
  25. * DOUBAO_APP_ID 可选(控制台 App ID,与 DOUBAO_ACCESS_KEY 配套)
  26. * DOUBAO_ACCESS_KEY 可选(控制台 Access Token,与 DOUBAO_APP_ID 配套)
  27. * DOUBAO_TTS_VOICE_ID 必填(音色 id)
  28. * DOUBAO_TTS_RESOURCE_ID 可选(默认按音色自动推断)
  29. * DOUBAO_TTS_ENDPOINT 默认 https://openspeech.bytedance.com/api/v3/tts/unidirectional
  30. */
  31. import fs from 'node:fs';
  32. import path from 'node:path';
  33. import { execFileSync } from 'node:child_process';
  34. import { fileURLToPath } from 'node:url';
  35. import { randomUUID } from 'node:crypto';
  36. const __dirname = path.dirname(fileURLToPath(import.meta.url));
  37. const SKILL_ROOT = path.resolve(__dirname, '..', '..');
  38. function loadEnv() {
  39. const envPath = path.join(SKILL_ROOT, '.env');
  40. if (!fs.existsSync(envPath)) return;
  41. const text = fs.readFileSync(envPath, 'utf8');
  42. for (const line of text.split('\n')) {
  43. const trimmed = line.trim();
  44. if (!trimmed || trimmed.startsWith('#')) continue;
  45. const idx = trimmed.indexOf('=');
  46. if (idx < 0) continue;
  47. const key = trimmed.slice(0, idx).trim();
  48. let val = trimmed.slice(idx + 1).trim();
  49. if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
  50. val = val.slice(1, -1);
  51. }
  52. if (!(key in process.env)) process.env[key] = val;
    • Dismissed after review: Copies every environment variable, where API keys and tokens live, in a file that sends data
    • Line 55 on GitHub
  53. }
  54. }
  55. loadEnv();
  56. function parseArgs(argv) {
  57. const args = { speed: '1.0', encoding: 'mp3' };
  58. for (let i = 2; i < argv.length; i++) {
  59. const a = argv[i];
  60. if (a === '--text') args.text = argv[++i];
  61. else if (a === '--text-file') args.textFile = argv[++i];
  62. else if (a === '--out') args.out = argv[++i];
  63. else if (a === '--speed') args.speed = argv[++i];
  64. else if (a === '--voice') args.voice = argv[++i];
  65. else if (a === '--encoding') args.encoding = argv[++i];
  66. else if (a === '--timestamps') args.timestamps = true;
  67. else if (a === '--yes') args.yes = true;
  68. else if (a === '--help' || a === '-h') args.help = true;
  69. }
  70. return args;
  71. }
  72. function usage() {
  73. console.error(`
  74. tts-doubao.mjs · 豆包语音 TTS
  75. --text <str> 要合成的文本
  76. --text-file <path> 从文件读取文本(与 --text 二选一)
  77. --out <path> 输出 mp3 路径(必填)
  78. --speed <float> 语速倍率,默认 1.0(0.5-2.0)
  79. --voice <voice_id> 覆盖 .env 里的音色 id
  80. --encoding <ext> mp3 / wav / pcm,默认 mp3
  81. --timestamps 请求字级时间戳(enable_subtitle),结果 JSON 多一个 words 数组
  82. --yes 确认将文本发送到豆包 TTS 官方接口(或设 HUASHU_CLOUD_OK=1)
  83. `.trim());
  84. process.exit(1);
  85. }
  86. function getDuration(filePath) {
  87. try {
  88. const out = execFileSync('ffprobe', [
  89. '-v', 'error',
  90. '-show_entries', 'format=duration',
  91. '-of', 'default=noprint_wrappers=1:nokey=1',
  92. filePath,
  93. ], { encoding: 'utf8' });
  94. return parseFloat(out.trim());
  95. } catch (e) {
  96. return null;
  97. }
  98. }
  99. function inferResourceId(voiceId) {
  100. // 复刻音色默认走 2.0:本账号只开通了 seed-icl-2.0(1.0 会 403 resource not granted),
  101. // 且字级时间戳(enable_subtitle)只有 2.0 资源支持。
  102. if (voiceId.startsWith('S_')) return 'seed-icl-2.0';
  103. if (voiceId.includes('uranus')) return 'seed-tts-2.0';
  104. return 'seed-tts-1.0';
  105. }
  106. function speedToSpeechRate(speed) {
  107. const ratio = parseFloat(speed);
  108. if (!Number.isFinite(ratio)) return 0;
  109. return Math.max(-50, Math.min(100, Math.round((ratio - 1) * 100)));
  110. }
  111. function buildAuthHeaders({ requestId, resourceId }) {
  112. const apiKey = process.env.DOUBAO_TTS_API_KEY;
  113. const appId = process.env.DOUBAO_APP_ID;
  114. const accessKey = process.env.DOUBAO_ACCESS_KEY;
  115. const headers = {
  116. 'Content-Type': 'application/json',
  117. 'X-Api-Resource-Id': resourceId,
  118. 'X-Api-Request-Id': requestId,
  119. };
  120. if (apiKey) {
  121. headers['X-Api-Key'] = apiKey;
  122. return headers;
  123. }
  124. if (!appId) throw new Error('缺 DOUBAO_TTS_API_KEY 或 DOUBAO_APP_ID(检查 .env)');
  125. if (!accessKey) throw new Error('缺 DOUBAO_ACCESS_KEY(检查 .env)');
  126. headers['X-Api-App-Id'] = appId;
  127. headers['X-Api-Access-Key'] = accessKey;
  128. return headers;
  129. }
  130. async function readV3Audio(res) {
  131. const text = await res.text();
  132. const chunks = [];
  133. const words = []; // 字级时间戳(enable_subtitle 开启时服务端按句返回 sentence.words)
  134. let finalCode = null;
  135. let finalMessage = '';
  136. for (const line of text.split(/\r?\n/)) {
  137. const trimmed = line.trim();
  138. if (!trimmed) continue;
  139. let json;
  140. try {
  141. json = JSON.parse(trimmed);
  142. } catch (e) {
  143. throw new Error(`API 响应行不是 JSON:${trimmed.slice(0, 200)}`);
  144. }
  145. const code = json.code ?? 0;
  146. if (code === 20000000) {
  147. finalCode = code;
  148. finalMessage = json.message || '';
  149. break;
  150. }
  151. if (code !== 0) {
  152. throw new Error(`API 返回错误 code=${code} msg=${json.message || JSON.stringify(json)}`);
  153. }
  154. if (json.data) chunks.push(Buffer.from(json.data, 'base64'));
  155. if (json.sentence && Array.isArray(json.sentence.words)) {
  156. for (const w of json.sentence.words) {
  157. words.push({
  158. text: w.word,
  159. start: w.startTime,
  160. end: w.endTime,
  161. confidence: w.confidence,
  162. });
  163. }
  164. }
  165. }
  166. if (!chunks.length) {
  167. const detail = finalCode ? `结束码 ${finalCode} ${finalMessage}` : text.slice(0, 500);
  168. throw new Error(`API 响应无音频数据:${detail}`);
  169. }
  170. return { audio: Buffer.concat(chunks), words };
  171. }
  172. // endpoint 域名白名单:key 和文本只允许发往字节官方域名,防 .env 被篡改后重定向
  173. const ALLOWED_ENDPOINT_HOSTS = /(^|\.)(bytedance\.com|volces\.com)$/;
  174. async function tts({ text, voice, speed, encoding, timestamps }) {
  175. const endpoint = process.env.DOUBAO_TTS_ENDPOINT || 'https://openspeech.bytedance.com/api/v3/tts/unidirectional';
  176. const host = new URL(endpoint).hostname;
  177. if (!ALLOWED_ENDPOINT_HOSTS.test(host)) {
  178. throw new Error(`DOUBAO_TTS_ENDPOINT 域名 ${host} 不在白名单(*.bytedance.com / *.volces.com),拒绝发送`);
  179. }
  180. const voiceId = voice || process.env.DOUBAO_TTS_VOICE_ID || process.env.DOUBAO_SPEAKER;
  181. const resourceId = process.env.DOUBAO_TTS_RESOURCE_ID || inferResourceId(voiceId || '');
  182. const requestId = randomUUID();
  183. if (!voiceId) throw new Error('缺 DOUBAO_TTS_VOICE_ID(检查 .env 或用 --voice 传)');
  184. const body = {
  185. user: { uid: 'huashu-design' },
  186. req_params: {
  187. text,
  188. speaker: voiceId,
  189. audio_params: {
  190. format: encoding,
  191. sample_rate: 24000,
  192. speech_rate: speedToSpeechRate(speed),
  193. // 字级时间戳:仅 2.0 资源(seed-tts-2.0 / seed-icl-2.0)支持,中英文 only
  194. ...(timestamps ? { enable_subtitle: true } : {}),
  195. },
  196. },
  197. };
  198. const res = await fetch(endpoint, {
  199. method: 'POST',
  200. headers: buildAuthHeaders({ requestId, resourceId }),
  201. body: JSON.stringify(body),
  202. });
  203. if (!res.ok) {
  204. const errText = await res.text();
  205. throw new Error(`HTTP ${res.status}: ${errText.slice(0, 500)}`);
  206. }
  207. return readV3Audio(res);
  208. }
  209. async function main() {
  210. const args = parseArgs(process.argv);
  211. if (args.help) usage();
  212. let text = args.text;
  213. if (!text && args.textFile) {
  214. text = fs.readFileSync(args.textFile, 'utf8').trim();
  215. }
  216. if (!text) {
  217. console.error('错:缺 --text 或 --text-file');
  218. usage();
  219. }
  220. if (!args.out) {
  221. console.error('错:缺 --out');
  222. usage();
  223. }
  224. if (!args.yes && process.env.HUASHU_CLOUD_OK !== '1') {
  225. const host = new URL(process.env.DOUBAO_TTS_ENDPOINT || 'https://openspeech.bytedance.com').hostname;
  226. console.error(
  227. `[云能力确认] 本次将把约${text.length}字文本发送到 ${host}(豆包TTS官方接口,使用你自己的key合成语音)。\n` +
  228. `确认无误请重跑并加 --yes,或设置环境变量 HUASHU_CLOUD_OK=1。数据流向声明见 SECURITY.md。`,
  229. );
  230. process.exit(2);
  231. }
  232. const outPath = path.resolve(args.out);
  233. fs.mkdirSync(path.dirname(outPath), { recursive: true });
  234. const { audio, words } = await tts({
  235. text,
  236. voice: args.voice,
  237. speed: args.speed,
  238. encoding: args.encoding,
  239. timestamps: args.timestamps,
  240. });
  241. fs.writeFileSync(outPath, audio);
  242. const duration = getDuration(outPath);
  243. const result = {
  244. path: outPath,
  245. bytes: audio.length,
  246. duration,
  247. text_chars: text.length,
  248. };
  249. if (args.timestamps) result.words = words;
  250. console.log(JSON.stringify(result));
  251. }
  252. main().catch((err) => {
  253. console.error(`TTS 失败:${err.message}`);
  254. process.exit(1);
  255. });

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.