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-defaulthreflang、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-01 | canonical、hreflang、Open Graph、JSON-LD、sitemap、RSS 与 robots | 已交付 | 正式预览测试 |
| MEDIA-01 | 7 个源媒体、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 的未压缩异步块,只在首页且满足动效条件时请求;移动端始终采用静态降级。