Skip to content

v1.3.0 — Delivery, garden, and sidebar

Choose a tag to compare

@Aafff623 Aafff623 released this 19 Aug 11:25
· 63 commits to master since this release

What's new

v1.3.0 is the first GitHub release after v1.2.0. It covers production delivery on threetwoa.live, Ask / LiveChat (still DEV-gated), mobile and load-strategy work, then the garden watering easter egg, sidebar Grok Bot carousel, and tag-wall depth.

Production: https://www.threetwoa.live

Vercel fallback: https://fork-firefly.vercel.app

Highlights

Production delivery

  • Public path: www.threetwoa.live → EdgeOne CDN → Vercel origin.
  • Cloudflare is the authoritative DNS provider and hosts img.threetwoa.live on R2 for article and comment images.
  • Vercel and EdgeOne use separate cache policies for HTML, /_astro/*, Pagefind, assets, and /api/*.
  • The EdgeOne Pages adapter remains for compatibility testing; it is not the current production host.

Ask and LiveChat

  • HeroUI Pro React Ask island: personas, site retrieval, source-aware prompts, streamed replies.
  • Pet-triggered LiveChat uses the same server-side Ask proxy.
  • Browsers only call /api/ask; the MaxKB token stays server-side.
  • Ask remains DEV-only. Production routes and API calls return 404 until the cloud plan is approved.
  • DEV /ask/ now mounts the island through a static AskChatIsland.astro wrapper (client:load cannot hang off a dynamic TSX import). Production still dead-code-eliminates the island.

Garden footer

  • Watering grows in four beats: sprout → crown → blossom → persimmon.
  • The fourth beat is pickable: the fruit drops, then fireflies/butterflies and a fruit note.
  • Garden-hour state lives in sessionStorage (five minutes, per tab). The “last watered” date on the capsule is still the publish day.
  • The stage is transparent and sits in the existing gap under the capsule; it does not add height or a glass frame.
  • The Lottie kettle is sized to finish its clip. prefers-reduced-motion skips particles; fruit and note still appear.
  • The tree drawing is still a stamp-sized vector sprout.

Sidebar Grok Bot

  • Profile disc macro-cuts between the site avatar (short) and Grok Bot (long), about 1:4.
  • Six tour buckets; click does not default to a burst.
  • Bot geometry is local-only (ADR-0003). The repo ships choreography and a vendor README; public/vendor/grok-bot/** is gitignored. Production without vendor stays on the static avatar on purpose.
  • Ask / LiveChat still does not wire a 48/40px mascot or disable the sidebar Bot on /ask.

Tag wall

  • The chalk sphere paints depth from the current frame’s nearest/farthest tags, not a theoretical pole (12 Fibonacci points never sit at z = -R).
  • Front tag is full brightness; back tags stay readable (~0.4 opacity, no blur).
  • Idle spin is a little faster; drag stay is unchanged.

Performance and mobile UX

  • Continues the Swup lifecycle and load-strategy work from v1.2.0.
  • Mobile is not a scaled-down desktop: decorative RepelText and TagCloud work are removed, duplicate metadata requests are avoided, redundant bottom sidebars are skipped, and long controls collapse to icons.
  • Later passes sink widget scripts and tighten V4–V7 load strategy.
  • V3 trend (older online vs localhost, directional): mobile LCP 3241 → 2221 ms (-31.5%), mobile DOM 3597 → 3015 (-16.2%), forced layout 3734 → 2590 ms (-30.6%), TagCloud reflow 723 → 140 ms (-80.6%), CLS 0.

Content and authoring

  • Knowledge batches, Agentic Coding notes, career/interview notes, collection indexes, and matching dynamics.
  • AI Morning Brief and GitHub Weekly Hot authoring skills, plus collection/taxonomy registration.
  • Collections for CSDN tutorials, xiaolincoding, Vibe Coding, and related indexes.
  • Production-facing posts were later trimmed to handbooks, morning briefs, discount notes, and Zcode; other essays stay draft/local.

Polish and fixes

  • Footer bamboo-green garden palette; watering grass no longer follows site --hue.
  • Shared paper safety layer on collection cards.
  • Calendar uses three 3D voxel character loops; hover and keyboard focus pause rotation.
  • R2-backed comment-image upload and object cleanup; COS path remains a fallback.
  • Hardened Ask token handling, API cache boundaries, dynamic inline comments, and framework compatibility.
  • Hid demo content from production-facing lists.

Upgrade

No intentional breaking change.

pnpm install
pnpm check
pnpm type-check
pnpm build

Requirements remain Node.js ≥ 22 and pnpm 9. For image uploads, configure server-only R2_* from .env.example; COS_* remains a fallback. Ask needs MAXKB_ACCESS_TOKEN and an approved production enablement change. Local Grok Bot motion needs a copy of the study-repo replica into public/vendor/grok-bot/ (see that folder’s README); do not commit the geometry.

Validation and limits

  • GitHub Releases: this tag is the first after v1.2.0. Notes lived in-tree before the tag existed.
  • Vercel follows master; confirm https://www.threetwoa.live after the deployment that contains this tag is Ready. This document does not claim that check is done.
  • The domain is not ICP-filed; this release does not claim mainland EdgeOne node acceleration.
  • A Windows-local Vercel adapter build may end with symlink EPERM after generating the site. Cloud production remains the release gate.
  • Production will not show the Grok Bot unless a licensed or original mesh is shipped later.

Full changelog: v1.2.0...v1.3.0


中文说明

v1.3.0v1.2.0 之后的第一份 GitHub Release。覆盖 threetwoa.live 交付、Ask / LiveChat(仍 DEV 门禁)、移动端与加载策略,以及页脚浇水彩蛋、侧栏 Grok Bot 轮播、标签墙远近。

主入口:https://www.threetwoa.live

Vercel 备用:https://fork-firefly.vercel.app

本版重点

生产交付

  • 对外链路:www.threetwoa.live → EdgeOne CDN → Vercel 源站。
  • Cloudflare 权威 DNS;img.threetwoa.live 用 R2 承接文章与评论大图。
  • 按 HTML、/_astro/*、Pagefind、assets、/api/* 分层缓存。
  • EdgeOne Pages adapter 只做兼容回归,不是当前生产托管。

Ask 与 LiveChat

  • HeroUI Pro 问答岛:人设、站内检索、来源 Prompt、流式回答。
  • 桌宠 LiveChat 共用服务端代理;浏览器只打 /api/ask
  • Ask 仍为 DEV-only;生产页与 API 默认 404。
  • DEV /ask/AskChatIsland.astro 静态挂 client:load(不能对 TSX 动态 import);生产继续 DCE 掉该岛。

页脚花园

  • 浇水四拍:苗 → 冠 → 花 → 柿;第四拍可摘,萤火/蝴蝶 + 果笺。
  • 园时只写 sessionStorage(五分钟、按标签页);胶囊「上次浇灌」仍是发文日。
  • 舞台透明,叠在胶囊下原余白,不另开高度、不去玻璃框。
  • Lottie 壶按能播完的尺寸;「减少动态效果」跳过粒子,果和笺还在。
  • 树仍是邮票尺寸矢量苗。

侧栏 Grok Bot

  • 头像短、Bot 长,约 1:4 宏切;六桶巡演;点击不默认 burst。
  • 几何仅本机(ADR-0003),仓内只有编舞与 vendor README。线上缺 vendor 时锁静态头像,这是故意的。
  • Ask / LiveChat 的 48/40px 吉祥物与 /ask 关侧栏 Bot 尚未接线

标签墙

  • 远近按当前帧最近/最远归一化,不用理论球极。
  • 正中满亮;背面约 0.4、不糊,轮廓可读。
  • 闲置转速略加快;拖拽手感未放飞。

性能与移动端

  • 延续 v1.2.0 的 Swup 生命周期与加载策略。
  • 移动端不再等比缩小桌面装饰。
  • 后续下沉 widget 脚本并收口 V4–V7 加载。
  • V3 趋势(线上旧版 vs localhost,非严格同环境 A/B):移动 LCP 3241 → 2221 ms(-31.5%)等,见英文段。

内容与发文

  • Knowledge / Agentic Coding / 早报 / 热榜技能与合集。
  • 生产可见帖后来收到手册、早报、折扣与 Zcode;其余仍草稿/本地。

体验与修复

  • Footer 竹月绿、合集宣纸层、日历 voxel 轮播、评论图 R2、Ask 安全边界、示例内容隐藏。

升级

没有有意 breaking。Node.js ≥ 22、pnpm 9。本机看 Bot 需按 public/vendor/grok-bot/README.md 拷学习仓 replica,不要把几何 commit 上去

验收与边界

完整对比v1.2.0...v1.3.0

本版不附二进制资产。