全部技能 / 设计 / web-proto-soft
设计 · nexu-io/html-anything

web-proto-soft

Apple 调: 银/奶 canvas + 双层斜面卡片 + button-in-button + spring

风险提醒:绿色 · 放心使用AI 侦查报告
作者 nexu-ioGitHub nexu-io/html-anything ↗Stars 8827许可 Apache-2.0(仓库根 LICENSE 文件;GitHub API license.spdx_id = Apache-2.0)commit 553ed98c28
agent 宿主通常会约束 skill 执行权限;风险提醒为 AI 侦查观点,不构成质量或安全保证。第三方 skill 仅作拆解与展示,安装使用风险自负,版权归原作者。

1实现原理 · 为什么它能做到

该 skill 不是可执行程序,而是 html-anything 的「模板」:一个目录(SKILL.md + example.html[/example.md]),由 loader.ts 在运行时扫盘读取——新增模板=新增目录,不需要改 TypeScript。

next/src/lib/templates/loader.ts
Adding a template = adding a folder. No TS code change required; the API
注:SKILLS_DIR 固定在应用 cwd 的 src/lib/templates/skills;listSkills() 遍历一级子目录并按 isValidBundledId 过滤,逐目录读 SKILL.md、解析 frontmatter,所以「选择器元数据」和「生成用 prompt 正文」出自同一份文件。

frontmatter 是给选择器/API 的元数据(zh_name/en_name/emoji/description/category/scenario/aspect_hint/featured/recommended/tags),由 fmToMeta() 映射成 SkillMeta;frontmatter 之后的正文才是给模型的规格。

next/src/lib/templates/loader.ts
zhName: fm.zh_name ?? fm.name ?? id,
注:id 取自目录名;example 元数据(example_id/name/format/tagline/desc/source_url)只在目录带 example.md/html 时才产出 SkillExampleMeta,body 被刻意排除在列表 API 之外(注释:Body is excluded so we can return the entire registry in one cheap fetch)。

生成时该模板正文被当成 prompt body:/api/convert 用 assemblePrompt() 把「全局设计指令 + 本模板正文 + 用户内容」拼成一段 prompt,交给宿主的本地 agent CLI,HTML 由 stdout 流式捕获。

next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
注:同路由另有 editFromHtml/editFromContent 的「最小化差异编辑」分支;模板正文在这条链路上只是字符串,没有求值、没有执行。

模板正文之上还压着一段全局前置指令(SHARED_DESIGN_DIRECTIVES),把技术与内容纪律统一加在每个模板之前——示例 HTML 里普遍出现的 CDN/字体外链就源自这里(宿主壳注入,不是模板自身要求)。

next/src/lib/templates/shared.ts
通过 CDN 引入 Tailwind v3 Play (https://cdn.tailwindcss.com) 与所需的 Google Fonts。
注:模板正文只负责风格/版面/组件,不重复这些硬要求;判级只算模板自身目录,该端点是宿主壳行为,写进 security.reason 自证。

产物以 stdout 文本返回:全局指令显式禁止 agent 动用文件系统,落盘由前端负责——所以模板目录既无脚本也无写盘能力。

next/src/lib/templates/shared.ts
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。
注:原文续句要求「不要把 HTML 写到任何 .html 文件里……前端直接捕获你的 stdout 文本, 文件落盘由前端负责」;产物最终由前端写入任务记录与导出。

example.html 是随包预渲染示例:/api/templates/<id>/preview 原样按 text/html 返回给 iframe(选择器内联预览),/api/templates/<id>/example 另把 example.md + example.html 一起返回。

next/src/app/api/templates/[id]/preview/route.ts
return new Response(skill.exampleHtml, {
注:示例只作预览/文档,不参与生成 prompt(生成只用 SKILL.md 正文),因此它的外链不影响模板自身的能力边界。

正文把「Apple-tier 软质感」拆成四件可执行的事:银/奶 canvas + ambient mesh 背景、双层斜面(double-bezel)卡片、button-in-button CTA、spring 微反弹动效。

next/src/lib/templates/skills/web-proto-soft/SKILL.md
- Double-bezel 卡片 (内外两层圆角 + 高光)
注:配套为「- Silver / cream canvas + ambient mesh background」「- Button-in-button CTA」「- Spring motion (微反弹的 hover)」——四条都是结构级指令。

双层斜面用一对圆角变量实现:外层 --shell-radius 2.25rem,内层 --core-radius = shell - 0.4rem,配合 --innerlight 高光做「嵌套斜角」观感。

next/src/lib/templates/skills/web-proto-soft/example.html
--shell-radius: 2.25rem;
注:同变量块里给出 --core-radius: calc(2.25rem - 0.4rem) 与 --innerlight: rgba(255,255,255,0.65),示例注释把该区块标为 BENTO (double-bezel cards)。

spring 动效由专门的缓动曲线承载(--ease-spring: cubic-bezier(0.16, 1.16, 0.3, 1),贝塞尔过冲 >1),并配一条常规 --ease 作非弹性过渡。

next/src/lib/templates/skills/web-proto-soft/example.html
--ease-spring: cubic-bezier(0.16, 1.16, 0.3, 1);
注:示例把它用在 hover 位移(transition: transform 360ms var(--ease-spring)),正是「微反弹」的技术来源。

ambient mesh 背景是两个大半径模糊色斑(.mesh::before/::after)缓慢漂移,并对 prefers-reduced-motion 做了关闭处理。

next/src/lib/templates/skills/web-proto-soft/example.html
@media (prefers-reduced-motion: reduce) { .mesh::before, .mesh::after { animation: none; } }
注:这是三个 proto 里唯一显式处理 reduced-motion 的示例,与 vfx-text-cursor 正文的要求同源,属加分项。

CLI 侧另有一条关键词直配通道:skills-matcher.ts 把用户内容里的关键词直接映射到该模板 id,命中即给 confidence=命中数×2+3,达到阈值 3 就走本地规则、不再让模型挑模板。

cli/src/skills-matcher.ts
[["苹果", "Apple", "iOS", "soft", "squircle"], "web-proto-soft"],
注:苹果/Apple/iOS/soft/squircle 直配该模板;与另外两个 proto 共用 design 场景信号。

CLI 兜底匹配用到的阈值常量:内容长度需超过 60 字符才启用 AI 摘要匹配;强信号阈值是 3。

cli/src/skills-matcher.ts
const MIN_CONTENT_LENGTH_FOR_AI = 60;
注:另有 SCENARIO_SIGNALS 按模板 scenario 给关键词加权、fallbackMatch 用 tags/zhName/description 打分,两层都失效才调用 agent 做摘要匹配。

宿主壳用 sandbox="allow-scripts allow-same-origin" 的 iframe 渲染示例/产物(允许脚本、允许同源)——这是产品壳取舍,写进风险,不参与本 skill 判级。

next/src/components/template-picker.tsx
sandbox="allow-scripts allow-same-origin"
注:preview-pane.tsx / deck-viewer.tsx 同款;示例 HTML 的内联 JS 只在浏览器预览时执行,skill 自身不执行任何脚本。

2核心能力

01银/奶 canvas + ambient mesh 背景(含 reduced-motion 关闭)
02Double-bezel 卡片(shell/core 双层圆角 + 内高光)
03Button-in-button CTA
04spring 微反弹缓动
05squircle 大圆角体系
06入场 reveal 微动效

3外部依赖

类型依赖
networkGoogle Fonts(Plus Jakarta Sans / JetBrains Mono)
networkGoogle Fonts 静态资源域(preconnect)

4风险提醒 风险提醒:绿色 · 放心使用

风险提醒:绿色 · 放心使用
  • Button-in-button 仅有文字规格 — 正文只写「- Button-in-button CTA」一句,示例未见对应的嵌套按钮结构(grep 无 btn-in-btn 类名);该项的实现细节需模型自行补全,容易出现风格不一致。
  • 动效与性能 — mesh 用大半径 blur + 持续动画,低端设备/长页面可能掉帧;示例已做 reduced-motion 关闭,但未做性能降级(如暂停不可见区域动画)。
  • spring 曲线依赖浏览器插值 — cubic-bezier 过冲在不同引擎下视觉略有差异;模板未给降级方案。
  • 外链字体与宿主 Tailwind — 示例引用 Google Fonts 两域(+ 产品壳注入的 Tailwind CDN);属产物/宿主行为,不计档。
风险提醒:绿色,放心使用。判级对象=本 skill 目录(next/src/lib/templates/skills/web-proto-soft/),逐文件核对:零脚本、零凭证读取、零写盘;目录内出现的端点仅限 Google Fonts(Plus Jakarta Sans / JetBrains Mono)、Google Fonts 静态资源域(preconnect),且全部位于 example.html 这一「产物示例」;SKILL.md 正文只规定版面/风格/字体族名,未点名任何运行时外部接口,故为纯指令模板=green。宿主侧说明(不计档):html-anything 产品壳会经 assemblePrompt() 把正文拼进 prompt 并 spawn 本地 agent CLI,并注入 cdn.tailwindcss.com + Google Fonts 要求(next/src/lib/templates/shared.ts),预览 iframe 用 sandbox="allow-scripts allow-same-origin"(next/src/components/template-picker.tsx)。

5第二遍独立确认

  • [ok] skill 目录文件清单 — find 得 SKILL.md + example.html,无 scripts/references。
  • [ok] 外部端点仅字体 — example.html 仅 fonts.googleapis.com css2 与 fonts.gstatic.com preconnect;无 <script src> 外链;SKILL.md 正文无 URL。
  • [ok] Double-bezel 是否落地 — --shell-radius/--core-radius 变量 + BENTO 注释区块 + .b-card .core 结构(grep 命中 .b-card .core 与 .hero-preview .core)。
  • [discrepancy] Button-in-button 是否在示例中 — SKILL.md 写了「- Button-in-button CTA」,但示例中未找到该结构的类名或嵌套按钮标记(对 example.html grep 无 in-btn/btn-in-btn 类命中),属示例只演示其余三条。
  • [ok] spring 缓动是否真实使用 — --ease-spring 定义于 :root,并在 .hero-preview 等元素上以 transition: transform 360ms var(--ease-spring) 使用。
  • [ok] reduced-motion 处理 — 存在 @media (prefers-reduced-motion: reduce) 关闭 .mesh 动画;同系列的 brutalist/editorial 未见同等处理。
  • [ok] CLI 匹配器路由 — cli/src/skills-matcher.ts 存在 [["苹果", "Apple", "iOS", "soft", "squircle"], "web-proto-soft"] 行。
  • [ok] 判级 green 自证 — 目录零脚本文件(示例内联 reveal 属产物示例)、零凭证、零写盘;正文无运行时接口 → green。

6结论

  • 「高级感」被参数化:双层圆角是 calc 关系、动效是过冲贝塞尔,模型可按值复现而非凭感觉
  • 无障碍细节到位:mesh 动画对 prefers-reduced-motion 显式关闭
  • 组件库化程度高:BENTO 卡片、pill、meta 等区块在示例里已成体系,可直接复用
  • 动效克制:只有 hover 位移与一次性 reveal,无滚动特效,切合「ambient」定位
  • 适合:适合消费级产品官网、AI/SaaS 工具落地页、需要「顺滑、贵气」质感的品牌页;也适合作为三种风格原型里偏现代的对照。
    不适合:不适合需要硬朗工业感的页面(应选 brutalist)、不适合信息密集的后台界面(双层斜面与大圆角会挤占信息密度)。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-15
    方式 A · 人下载镜像包下载 web-proto-soft.tar.gz
    sha256: d75a8b1932228559…
    方式 B · JSON 格式安装指南,复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub?直接去上游安装(实时版,可能已更新)GitHub 原始 ↗
    本页镜像锁定 commit 553ed98c28;上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库nexu-io / nexu-io/html-anything
    Stars8827
    最近推送2026-09-15
    本 skill commit553ed98c28
    许可Apache-2.0(仓库根 LICENSE 文件;GitHub API license.spdx_id = Apache-2.0)
    本站信息
    收录日期2026-09-06
    分类设计
    侦查报告AI 侦查 · 2 遍 · 2026-09-06
    本站镜像与 GitHub 原始是不同来源:本站锁定 commit 快照经 /r2 分发;GitHub 为实时上游,内容可能已更新。
    同分类邻近