面向前端开发者的界面装饰工作台:把气泡边框、卡片丝带、优惠券缺口等细节,调成可以直接用于项目的 HTML 和 CSS。
由 cssTriangle 升级而来,优先解决完整场景里的尺寸、内容和挂靠关系,同时保留原有五种基础图形。
| 卡片丝带:连同挂靠关系一起导出 | 优惠券:缺口、分隔线与轮廓阴影 |
|---|---|
![]() |
![]() |
- 八种模板:对话气泡、卡片丝带、优惠券,以及三角形、五角星、爱心、无限符号、月牙。
- 精确调整:方向按钮、尺寸滑块与数字输入、可选宽高比例锁定、颜色与旋转。
- 内容自适应气泡:按内容换行、增高,也可指定尺寸;支持四向箭头、圆角、内边距、边框颜色与宽度、阴影。箭头和气泡使用连续的填充与边框。
- 完整卡片丝带:支持左上、右上、左下、右下挂靠,调整卡片尺寸、边距与圆角,编辑丝带文字和卡片内容。长文字不会遮住正文;导出包含卡片结构。
- 优惠券:调整缺口半径、分隔位置、圆角和阴影,编辑优惠标题、说明和优惠码。内容增高时缺口与分隔线一起移动;外层阴影沿券面轮廓绘制。
- 画布工具:浅色、暖色、深色背景,网格开关和预览缩放;预览缩放不会改变导出尺寸。
- 复制与导出:分别复制 HTML / CSS,或下载可独立打开的完整 HTML;预览和导出共用生成逻辑。
- 撤销 / 重做:保留最近 100 步设计变更。
- 保存与分享:设计自动保存到当前浏览器;分享链接携带完整参数。不同设备的本地保存不会同步,打开分享链接即可恢复设计。
- 响应式工作台:桌面三栏布局,手机上依次展示模板、画布、参数和代码。
所有形状在浏览器本地生成,无需账号、后端或模型 API。分享链接中的文字和参数对获得链接的人可见。
每种模板有独立入口,例如 /?template=bubble、/?template=ribbon、/?template=coupon。分享具体参数时使用页面的「分享设计」。
将 HTML 和 CSS 一起复制到页面,或下载完整 HTML 查看效果。保留气泡的文字容器、丝带的卡片容器和优惠券的两层结构;它们负责自适应排版和阴影。
气泡的「指定尺寸」模式可能裁切过长文字,可切换「内容自适应」。优惠券高度是最小值,上下区块会随内容增长。优惠码只是展示文本,不包含领取或核销服务。优惠券遮罩需要支持 CSS mask 的现代浏览器。
需要 Node.js 22.12+(或 24+)和 pnpm 11.22.0,与发布工作流保持一致。
pnpm install --frozen-lockfile
pnpm dev打开终端输出的本地地址。
pnpm typecheck
pnpm test
pnpm lint
pnpm build
pnpm previewdist/ 为静态构建产物,可部署到 GitHub Pages 等静态托管服务。构建使用相对资源路径,支持子目录部署。
推送到 master 后,GitHub Actions 依次执行 Lint、类型检查、测试和构建。全部通过后上传本次构建产物,并发布到 GitHub Pages。Pull Request 和 main 分支仅执行检查。
发布使用仓库的 github-pages 环境和工作流临时令牌,无需配置个人访问令牌。Pages 发布来源为 GitHub Actions,不再使用 gh-pages 分支;dist/ 由工作流构建,不纳入版本管理。
需要重新发布时,在 CI & Pages 中选择 Run workflow,分支选择 master。
src/studio.ts:设计参数、输入校验、形状 CSS 与独立 HTML 导出。src/decorations.ts:气泡、完整卡片丝带、优惠券的 HTML / CSS 模板。src/components/DecorationControls.tsx:场景专属参数与内容编辑。src/pages/index.tsx:工作台交互、历史记录、保存与分享。src/pages/studio.css:工作台视觉与响应式布局。src/utils/css.ts:沿用的边框三角形与伪元素图形生成逻辑。
图形调整使用原生表单控件,生成代码不依赖 React 或其他运行时。丝带导出包含其卡片;气泡预览中的聊天头像属于示例,不会导出。
项目定位、范围与下一步验证见 产品方向。


