AirShelf/CLAUDE.md
iye 04335f3269
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 7s
feat(workbench): 三工序图片区视觉对齐 + 任务中心聚合 + 工具台头部筛选
- model-photo / platform-cover · 头部 toolbar 落地: 时间 / 模特(平台) chip 下拉 + 折叠搜索
- model-photo / platform-cover · 图片卡片样式同步图片创作 (.io-cell): bg / hover / .gen 脉冲 / .err 红框
- model-photo / platform-cover · 单图 hover overlay: 再次生成 + 下载 + 更多(加入资产库/删除)
- model-photo / platform-cover · 批次底栏: 再次生成图标统一 + 更多 menu(全部加入资产库/删除该批)
- model-photo · 修 TDZ bug: renderModelMini 调用挪到 MODELS 声明后, 解决整页崩溃
- model-photo · 去掉冗余 pv-summary, 商品自动选最近编辑, task 写入 name 字段
- image-optimize · 单图右上加再次生成图标, 加入 fs-image-tasks-image 与任务中心打通
- image-optimize · 输入区拆 3 行: + 在顶 / textarea 满宽 / 发送在底栏右; 参考图缩略与加号同 64×64
- asset-factory · 任务中心加时间 chip + image 类型 + 跳转表; 删冗余类型列
- pipeline · stage2 商品卡换商品库风格 + AI 生成三视图主 CTA + .tri-missing-badge[hidden] CSS 修复
2026-05-22 19:35:36 +08:00

4.6 KiB

流·Studio · 电商 AI 平台 · Claude Code 工程约定

本文件由 Claude Code 启动时自动加载。所有 AI 协作必须遵循以下规则。


项目简介

流·Studio · AI 短视频带货生成平台 · 5 阶段流水线(商品 → 故事板 → 镜头 → 生成 → 投放)

  • 设计代号: Restraint · V2.1 · Firecrawl-aligned
  • 主要工作目录: 电商AI平台/
  • Next.js 工程(独立): app/
  • V1 历史归档: v1/
  • V2.1 归档(原 v2.1/): v2/

★ 设计规范铁律(每次涉及页面 / CSS / UI 必读)

触发条件

只要任务涉及以下任一种,必须先 Read 电商AI平台/design.md:

  • 修改 .html 文件
  • 修改 assets/restraint.css 或任何 .css
  • 修改 inline <style>
  • 添加新页面 / 新组件
  • 调整布局 / 间距 / 颜色 / 字号
  • 用户提到"页面" "样式" "视觉" "组件" "色" "字" "圆角" "间距" 等关键词

必读章节

7 条铁律

  1. 任何页面 / CSS 调整前必须 Read 电商AI平台/design.md — 不读不动手
  2. 检查 电商AI平台/assets/restraint.css 已有组件Grep ".btn|.pill|.input"
  3. 禁止在页面 inline <style> 重写共享类(.btn .pill .input .modal .drawer .toast .field .tabs .chip .stats .list-row 等)— 要变体回 restraint.css 加
  4. 禁止创建新色值 — 必须用 design.md §2.1 的 token,不写裸 hex
  5. 禁止改动基础 token(--heat --background-base --border-faint 等)— 改了破坏全站
  6. 完成后对照 design.md §8 Don't List 逐条自检
  7. 不确定就问用户,不要凭感觉发挥 — 用户原话:"我都希望你能遵循我们的设计规范,而不是乱做"

设计核心速记(详见 design.md)

  • 冷灰底 #f9f9f9 · 主橙 #fa5d19 · 主前景 #262626
  • 全场 8 px 圆角(Pill / dot 999 例外)· >12 px 直接判错
  • inside-border 而非真 border(hover 不抖动)
  • 单橙锚点 · 全场只有一个 accent · hover 用 alpha 不用换 hue
  • Mono 装饰必有 · [ 200 OK ] // 05.14 [ /v2 ](品牌签名)
  • 主 CTA 唯一允许阴影 · 4 层橙色发光 · 其他场景禁阴影
  • Inter(英)+ Alibaba PuHuiTi(中)+ JetBrains Mono(装饰) · 字符级 fallthrough
  • 字重仅 3 档 · 400 / 500 / 600 · 700 仅给 Ctrl K 徽标

Git 工作流

  • 当前开发分支: dev
  • 主分支: main (生产)
  • 严禁直推 master/main — 走 dev 分支 → PR → 合并触发 CI/CD
  • 严禁 --no-verify 跳过 hook
  • Push 规则: 默认不 push,改完即停 · 用户明确说"push / 推一下"才执行
  • commit 前不要 amend — 创建新 commit,避免破坏历史

文件操作

  • 三视图 = 单张 16:9 图 · 不要拆成 3 张缩略 · 用 aspect-ratio: 16/9 单容器
  • 设计稿优先 · 写代码前必须先读 电商AI平台/_design_src/ 设计稿(如果有)
  • .pen 文件加密 · 只能用 pencil MCP 工具,不能 Read/Grep

用户偏好

  • 角色: UI 设计师 · 不读代码报错,只看最终视觉结果
  • 不需要的: 终端报错截图、深奥的代码解释、过度的实施细节
  • 需要的: 简短状态更新、视觉结果对照、清晰的"对/错"反馈

关键路径速查

资产 路径
设计规范(SSoT) 电商AI平台/design.md
共享 CSS 电商AI平台/assets/restraint.css
Shell 注入 电商AI平台/assets/shell.js
视觉样板间(归档) 电商AI平台/_archive/design-system.html
规范理论(归档) 电商AI平台/_archive/DESIGN_SPEC_V2.md
设计稿源 电商AI平台/_design_src/

违反任何规范规则,用户有权要求重做,无需解释。