大家好，我是一个在读大学生，平时喜欢逛博物馆，也总会好奇：古书里那些写得很香的菜，今天为什么只能停在一段文字里？
风味考古局是我和 TRAE 一起做出来的。刚开始我只会把脑子里的想法讲给它听，比如“我不想做一个只会生成菜谱的网站，我想让人能看到一盘古菜是怎么被一步步推出来的”。后来我把需求拆成离线体验、复原流程、3D 展台和打包验证等小任务，TRAE 帮我把页面、交互、数据、测试和离线打包一项项完成。这个 Demo 从最初的想法、代码实现到测试和参赛材料整理，都是在 TRAE 的对话里持续完成的；对我来说，最惊喜的是原本完全不敢碰的 Three.js 展示和离线单文件打包，最后也真的跑起来了。
1. Demo 简介
是什么：风味考古局是一个可以离线打开的数字风味博物馆 HTML Demo。用户给它一段古籍线索，它会把古菜背后的食材、技法、时代背景和现代做法整理成一条能看见的复原过程。
面向谁：它主要面向博物馆、非遗馆、研学老师和喜欢传统饮食文化的普通人。希望大家不只是“看一眼古菜”，而是真的参与一次复原。
我做了这些核心功能：
- 古籍线索复原：从《山家清供》的“蟹酿橙”线索出发，依次查看古籍、食材、技法和现代转译，而不是直接丢出一份菜谱。
- 3D 证据展台：用 Three.js 做了蟹酿橙的可交互展台，可以点壳、馅和蒸制三个热点，看这道菜的证据来源；浏览器不支持 WebGL 时，也能切换到 2.5D 视图继续体验。
- 风味馆藏和融合推演：离线内置 40 道风味档案；还能选择两道有历史资料的菜，查看它们可以怎样形成新的展项提案。
2. Demo 创作思路
我做这个项目的灵感，来自每次看展时遇到的那种遗憾：展板上会写“某道菜见于某书”，但我还是不知道它到底长什么样、为什么会这样做、今天能不能尝试还原。
我想解决的不是“古菜资料太少”，而是资料太散、太难读的问题。古籍、地方志、口述记录里常常藏着线索，但普通人很难把它们拼成一道菜；而普通 AI 生成出来的古风菜谱虽然好看，也常常说不清出处。
所以我没有把它做成“随机生成菜谱”的工具，而是把古籍原文、食材、技法、时代地域和现代转译放在一起。复原结果不一定是绝对答案，但用户至少能知道：这个结论从哪里来，哪些地方还需要继续考证。我觉得这比生成一段漂亮文案更重要。
3. Demo 体验地址
本作品采用“交互式 HTML + ZIP 上传社区”的方式体验。
-
上传文件：
风味考古局-TRAE初赛.zip (1.0 MB)
-
解压后打开：
风味考古局-离线体验.html (2.0 MB)
-
使用方式：双击 HTML 即可体验，推荐使用 Chrome 或 Edge；作品不需要联网，数据、图片和交互资源都已经内嵌。
4. TRAE 实践过程
这个项目不是我先写完代码再让 TRAE 帮忙补文案，而是从构思到交付都由我在 TRAE 中持续拆任务、推进和验证完成的。下面是三个关键任务的对话记录：
TRAE-01：离线数字博物馆和完整复原流程
我先让 TRAE 把原来的想法变成一个能离线跑的博物馆。它完成了单文件 HTML 的构建、40 道风味档案、线索匹配和五阶段复原流程，也把数字传承人、味觉星图和风味进化等功能放进同一个离线体验里。
Session ID：6a55f8c1fd3185fa87ee5d3a
TRAE-02：Three.js 蟹酿橙证据展台
这部分是我一开始最担心的。我把“能不能做一个能点、能拆、还能在不支持 3D 时继续看的蟹酿橙”讲给 TRAE，它用程序化几何做出了壳、馅和盖，并加上三个证据热点、拆解视图和 2.5D 降级方案。整个展台没有依赖外部模型文件，离线打开也能正常展示。
Session ID：6a562c2ffd3185fa87ee63f0
TRAE-03：测试、离线打包和参赛材料
最后我让 TRAE 帮我把“能跑”变成“能交”。它补齐了离线包检查、浏览器兼容性检查和参赛材料门禁，确认 ZIP 内的 HTML 不依赖外部网络资源；也完成了桌面端、手机端以及 WebGL 降级情况下的验证。
Session ID：6a56f39ca1f7f092c0593b3d
