作品集 开发日志

开发期：2026-10-01 ~ 2026-10-05，共 5 天
仓库 113 个提交 · 需求原话存档 59 节 · 批次任务单 17 份 · Round 0~18 + 后段 9 个批次

阶段速览

• ✅ 10/01 起盘：Vite + TS + GSAP + Lenis 脚手架，七个区块首版，当晚进入视觉打磨
• ✅ 10/02 点阵与角色：一天 7 轮任务单、33+ 条反馈，三视点阵解算与角色跟随定稿
• ✅ 10/03 内容与审美：ASCII 字符墙、IDE 控制台、四站参考定调、六板块风格方向
• ✅ 10/04 架构定型：demo3 基准定稿、250vh sticky 跑道 + 40/40/20 总纲、H/B/C/D 四批重构
• ✅ 10/05 收官：素材战役、符号加密、粒子四轮返修、光标五轮设计稿、加载页、中英双语、footer、归档

---

文档体系（先立规矩，再写码）

这个项目最重的不是代码，是文档——14 份活文档 + 17 份历史任务单，每条需求都有出处：

文档	职责
REQ-ARCHIVE.md（59 节）	需求原话总存档——每条 = 用户原文逐字 + 规格 + 验收，冲突以原文为准，是跑偏的唯一裁判
archive/docs/TASK*.md（17 份）	每轮任务单：批次拆分、依赖顺序、结束标记、红线条款
BATCH-TASKS.md / BATCH-PLAN.md	总队列与批次计划（q1~q9 + qa 的来源）
CONTENT-LIST.md	全站文案口径：12 个作品、数字一致性、中英文案
SPEC.md + STYLE.md	铁律 + 裁决表 J1–J8 + 走线判据；风格映射
REFERENCE.md	本地获奖站源码手册（70 个复刻路径）
ACCEPT.md	验收模式开关：ON = 双重验收（自检数据 + 独立复测），OFF = 实现 + 构建绿 + 人工肉眼
R18-STATE.md / R18-ISSUES.md	收官状态与问题单
PLAN-PARTICLES.md	粒子时间线专项（四轮返修的母本）
DEV-MODE.md / WORKFLOW.md	协作工序、汇报格式、命令规范
ASSETS-TODO.md	素材缺口清单（上线前回填）
docs/README.md	文档索引总入口

---

2026/10/01 — 起盘（Round 0~7）

• ✅ spec v1：Vite + TypeScript + GSAP + Lenis，七个 section，已装依赖只有 gsap 和 lenis，禁止新依赖
• ✅ 视觉打磨两轮：主标层级拉开、修掉「首屏主标题隐形」阻断 bug
  • 根因记进 pitfalls 至今：color: transparent + background-clip: text 在 Chromium 实测不绘制——验收从此必须元素截图数像素，不许目测
• ✅ 视觉重构拍板，用户原话：「太普通了，没什么新意，也没什么图片资源，动效也很一般……尝试炫酷的前端技术，比如 lottie、3d、图层拆分、图片转矢量」
  • 据此放开 three / Lottie / 图层拆分三个口子，走「获奖站参考」路线（REFERENCE.md 70 个复刻）
• ✅ Round 4 因 API 断连中断：代码写到 80% 但没自验——靠监督方完整视觉验收救回
  • 从此立规：每轮必须自验 + 结束标记，不许憋到最后
• ✅ 用户两轮 16 条实测反馈：矢量图透明层重做、三视点阵数学解算（14241 点起步，任务单里先验完再写码）
• 当晚立规矩：任务单驱动、批次验收、原话进档

这一天定下的三件事管了全程：原话进档、每批过目、先验算后写码。

---

2026/10/02 — 点阵、角色、电路（Round 9~15）

• ✅ TASK9：点阵双轴旋转定稿 + Emberveil 角色跟随（转向、脚底对齐、待机朝向）
• ✅ TASK10：性能与手感微调（离屏暂停、光效降本）
• ✅ TASK11：用户一天 18+1 条（点阵拖动 / 角色手感 / 图层叙事 / 粒子串联 / 电路走线）——A/B/C/D 四批，A 批是亲眼看到的 bug，做完立刻回报
• ✅ TASK12：Round 11 独立验收暴露的 P0/P1（粒子串联、性能、文字对比）
• ✅ 分批铁律诞生（TASK13 记录用户元规则原话）：「这次任务的执行效果我很不满意，可能是上次给的任务条数太多了。在接下来的开发中，若任务条数太多，则分批次进行开发。」
  • 从此 A 批做完先回报再动 B，每批结束跑一次构建
• ✅ TASK14/15：场景修正 4 条 + 重构批 2 条（顺序被重排为 #10 → #12 → #13 → #8）
  • 需求单格式固定为三件套：每条 = 用户原文逐字 + 落地规格 + 验收方法——「只留总结会导致跑偏」从此是铁律

一天 7 轮、33+ 条反馈全收。这天之后，任何需求都能在 59 节存档里找到原话。

---

2026/10/03 — 内容与审美定调（Round 16~17 + R18 立项）

• ✅ TASK16 内容落地四批：#12 ASCII 字符墙（31 词零重复）、#13 控制台、三风格轮
• ✅ TASK17 成品修复：走线颜色 + 贴边双轨与板块全宽重构
• ✅ 创意基调拍板，用户原话：「大胆——字体大小粗细样式、背景色、配色、页面样式、动效全面放开，参考 benjamincreative / lukebaffait / monaka / bleibtgleich 四站，不许平庸默认排版。」
• ✅ R18 立项：六板块重构，任务单一次拆 A–F 六批、逐批标记

审美这天锁死：宁可大胆被骂，不要默认排版。

---

2026/10/04 — 架构定型（模式切换日）

• ✅ demo3 定稿为全站唯一样式基准，评审原话："perfect"——此后所有视觉争议以它为准，不以文档为准
• ✅ 开发模式切换，用户原话：「解下来我不打算让你指挥cc开发了，而是由你直接开发，请把model调成pro，我准备new一个新session进行开发」
  • 任务单委派制改为直接开发；历史任务单、日志、截图整体归档进 archive/
• ✅ H 批 pin 架构：250vh 跑道 + sticky 钉住 + 40/40/20 总纲（走线相位、补角 40×35 全局条款）
  • 此后粒子、标题、渐隐、入场全部按 40/40/20 对表
• ✅ B 批：IDE 四面板（文件树 / 标签栏 / 编辑器 / 终端）+ 四轮返工八条
• ✅ C 批：About 纸面宣言重做（三遍打回才定稿）
• ✅ D 批：Stack 孟菲斯字符墙 + Elsewhere 糖果贴纸三套物理

架构一天定生死：40/40/20 后来成了全站动效的总纲。

---

2026/10/05 — 内容与细节收官

• ✅ 素材战役：45 条风格动图分 5 批过审入库 + 48 风格混沌彩蛋（六项指标独立复算，不用算法记账充数）+「别点我」三联合并/拆分（无回弹）
• ✅ 内容修改 1a：README「11 个」→「12 个」、终端补 about / stack / links、数字口径巡检
• ✅ about 符号加密：三行正文 XOR + 半字节符号表，密钥与明文均不进构建包，解法两步藏在终端
• ✅ kitten ASCII 转码：22 帧 × 32×32 → 64 列，终端与编辑区双端展示
• ✅ 粒子四轮返修：角色对位（质心 dx + 背景平移 + flip）、标题起止完全同步（停 = 渐隐完）、光栅基线与 CSS 行盒同构、四板块左右同飞、三图案全云均匀抽样
• ✅ 光标五轮设计稿：五格分板块（箭头 / 钢笔 / I-beam / 栈块 / 糖果漩涡），else 漩涡三层修（rect 判定 + scroll 重算 + 段色 round）
• ✅ 加载页「走线通电」：六条金线汇心 + 焊盘点亮 + 计数 + 0.35s 电流 + 通电闪，1.12 秒揭示进站
• ✅ 中英双语三批：i18n 机制与导航切换 → 板块 UI 与数据段 → IDE 38 处功能件 + 终端闲聊 127 句字典（复比对 0 缺键）
• ✅ footer 对齐博客（备案号 + Copyright）
• ✅ 本文归档：作品集进博客「我的作品」第 12 席，站内与站外内容统一入档

一天收了七条主线，靠的是前四天攒下的规矩：原话进档、分批交付、构建绿了才说话。

---

流程备忘（给未来的自己）

1. 需求铁律：每条 = 用户原文逐字 + 落地规格 + 验收方法；冲突时以原文为准。
2. 验收：肉眼为准；开发侧底线 = 构建绿 + 零 pageerror；重大视觉先出效果稿再写码。
3. 分批：单轮超过 8 条拆批，任务单里显式写「本轮不做」；A 批做完先回报。
4. 审美：大胆，不许平庸默认排版；demo3 是唯一样式基准。