返回版本档案

Released

v0.1.0

Jelix 技术作品主站的视觉、案例、双语、三维系统与生产性能升级。

目录

v0.1.0 技术作品主站

发布日期:2026-09-13。完整契约见 v0.1.0 需求。

本版目标

把 v0.0.1 的公开内容和本地学习闭环升级为可用于技术面试的作品主站。首页用真实系统边界、运行界面、版本记录和测试结果表达能力;RAG Lab 与 Agent Lab 只展示已确定的后续计划,不提前声明尚未实现的能力。

实际交付

  • 建立 Jelix 公开身份与六章产品叙事首页,采用冷白、金属灰、石墨黑和信号绿视觉系统;拉丁展示字使用随站点打包的 Inter Variable,技术标签使用 IBM Plex Mono。
  • 首页展示 MBlogs、RAG Lab 与 Agent Lab 三个案例状态;MBlogs 使用实际运行截图,规划项目明确标记版本和未交付边界。
  • 新增唯一的 Three.js 系统场景,表达 Interface、Content、Data 与 AI 四层;场景随原生滚动变化,并在手机、减少动态、无 WebGL 或初始化失败时显示静态最终帧。
  • GSAP 只负责首页一次性进入动画;Three.js 与 GSAP 均为客户端动态导入,组件卸载时释放几何体、材质、渲染器、观察器和事件。
  • 新增 /en 首页、项目、核心案例、博客、笔记、关于与搜索界面。没有人工英文稿的普通内容标记 Chinese only 并链接中文原文。
  • 项目模型新增角色字段,中文与英文列表均可按角色、技术和状态过滤;三个核心案例使用背景、职责、约束、过程、架构、结果、证据和反思结构。
  • 公开内容查询下沉到 Nitro API;页面不直接运行内容数据库查询。生产浏览器测试确认阅读路由不请求首页动效块或 Nuxt Content SQLite/WASM。
  • 增加 canonical、zh-CN/en/x-default hreflang、Open Graph、Person JSON-LD、sitemap、RSS 与 robots 规则;未知 GitHub、邮箱和简历配置保持为空且不渲染。
  • 将六张设计参考图与一张实际运行截图转换为 42 个 AVIF/WebP 响应式变体,保留明确宽高、源文件哈希和构建清单。
  • 全局链接预取改为用户交互触发,避免阅读页因首页链接进入视口而提前下载作品首页代码。

需求对应

需求实际交付状态证据
PORT-01—PORT-06身份、代表系统、MBlogs 案例、系统层次、工程证据、内容与联系六章已交付应用视觉证据、Chrome E2E
CASE-01—CASE-03三维筛选、统一案例结构、集中公开资料配置已交付内容检查、类型检查、Chrome E2E
I18N-01—I18N-02双语导航、首页、状态、核心案例与中文内容回退已交付Chrome E2E、正式预览测试
SEO-01canonical、hreflang、Open Graph、JSON-LD、sitemap、RSS 与 robots已交付正式预览测试
MEDIA-017 个源媒体、42 个 AVIF/WebP 变体、尺寸与哈希清单已交付媒体清单
DESIGN-101—DESIGN-104六张分区图、Ardot 可编辑原型、本地点击原型与四视口验收已通过设计简报、Ardot 审计
动效与性能首页动态加载、释放、静态降级、生产路由隔离与移动性能预算已通过Web Vitals、正式预览测试
既有功能回归公开内容、学习工作台、持久化、恢复与本地请求边界已通过14 个 Chrome E2E、4 个数据库集成测试、隐私检查

测试与证据

  • 5 个单元测试和 4 个数据库集成测试通过。
  • 14 个 Chrome E2E 场景通过;新增首页状态、双语案例、系统层标签、WebGL 合成像素、减少动态回退和阅读路由资源隔离检查。
  • Nuxt 正式构建成功,2 个正式预览测试通过;生产浏览器确认首页请求动效资源,阅读路由不请求 Three.js、GSAP、首页组件或内容 SQLite/WASM。
  • 1440×900、1366×768、390×844、412×915 四个首页视口均为 HTTP 200,六章完整,横向溢出、文本裁切、图片失败、console error 和 page error 均为 0。
  • 独立桌面 WebGL 截图要求 data-state=ready,并对浏览器合成后的 canvas 截图执行非空像素检查;减少动态的四视口证据使用静态降级。
  • 移动性能在 390×844、4× CPU 降速、150 ms 延迟、1.6 Mbps 下载环境中测得 LCP 1972 ms、CLS 0.0008、INP 32 ms,达到 2500 ms、0.1、200 ms 预算。
  • 公开构建隐私检查未发现私人数据库、备份、密钥字段或测试复盘文本。

数据迁移与回退

本版没有工作台 SQL 迁移,v0.0.1 数据库结构和导出格式保持兼容。升级前仍建议从 /workspace/data 导出 JSON;恢复路径和失败事务保护保持不变。

代码可回退到本地标签 v0.0.1;回退后不会识别 v0.1.0 新增的项目角色字段和双语路由,但不会修改私人工作台数据。需要恢复本版本时使用 v0.1.0 标签和锁文件重新安装、构建。

当前限制

  • 仅在本机回环地址开发和验收,没有执行 GCP 部署;/workspace 仍不是线上认证后的功能。
  • GitHub、邮箱与简历地址尚未由用户提供,集中配置为空,因此页面不显示对应入口。
  • RAG Lab 和 Agent Lab 分别规划在后续版本,当前没有运行服务、评测数据、执行轨迹或成功率。
  • 公开文章和笔记仍包含 v0.0.1 明确标记的示例内容,需要逐步替换为站主真实资料。
  • Three.js 主运行时为独立约 719 KiB 的未压缩异步块,只在首页且满足动效条件时请求;移动端始终采用静态降级。