Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

百味录

一本没有写完的食谱,一次失业后的归乡,一条仍在过日子的老巷。

《百味录》是一款以“市井烟火·百味人间”为主题的网页叙事探索游戏。玩家扮演失业后回乡的小满,受奶奶委托,走访长明巷的三家小馆,为一本搁置多年的手记补写食谱。

收集方子是这趟行程的起点。随着玩家走进店里、坐下来交谈、帮着做一顿饭,手记中逐渐留下的,还有经营小店的难处、家人之间没有说清的话,以及一个暂时不知道下一步该往哪里走的年轻人。

产品介绍

从补写食谱开始,走进街坊的日常

故事发生在虚构的长明巷。这里有奶奶住着的老宅、清晨忙着出笼的包子铺、同时照顾堂食与外带的面馆,也有为晚归的人留着灯的小食堂。

小满刚刚失去工作,带着行李和还没整理好的求职草稿回到家中。奶奶请她帮忙续写《百味录》,把几家熟悉小馆的做法重新问清、记下来。于是,一件可以马上着手的小事,让小满重新走出家门,和巷子里的人产生联系。

每家店都有自己的生活节奏。玩家需要在具体的来往中认识他们:什么时候适合开口,谁还没吃上饭,一张留单究竟意味着什么,一个看起来简单的调整又会影响谁。人物会表达自己的想法,也会犹豫、拒绝或作出不同于小满期待的决定。

随着食谱逐页补齐,小满也逐渐有机会面对自己的处境。她的经历与街坊的故事一起,构成这本书里的“百味”。

看见、交谈,再亲手参与

游戏将阅读、场景探索和实物操作结合在一起。玩家可以观察房间里的陈设,拿起手机、展开家信、翻看照片和纸页,也可以与人物交谈,了解物件背后的来历。

这些发现会影响后续交流。读过的便条、听过的旧事、已经做过的行动,都可能让人物换一种方式接话;没有问完的话题,也可以在之后的回访中继续。

在小馆里,玩家还会参与与经营日常相连的操作:学习包早饭、按要求分装、理清面馆订单的先后,以及为不同的人核对餐食。这些操作让玩家实际碰到人物正在处理的事情,也为接下来的谈话提供具体的缘由。

交互与视听设计

让物件成为叙事的入口

游戏采用全视口场景,将人物、可操作物件、家具前景和界面分层呈现。玩家直接选择场景中的实物,进行翻面、展开或拖动;纸张、手机与书页的长文在各自正文区域内阅读。

物件既参与操作,也承载信息。一张照片、一页备料表或一段未发出的求职草稿,分别呈现不同人物的经历和当下处境。对白与观察记录会根据真实发生过的事情变化,避免把尚未听到的私话、尚未完成的行动提前写进手记。

一本随着经历逐渐充实的书

《百味录》是贯穿游戏的核心载体。玩家从整理食谱开始,随着行程推进,逐步读到“人间百味”中的人物片段。

书本采用独立封面、叠页、纸纹和翻页动画,文字与插图分别呈现。“人间百味”包含 11 个片段及相应条件版本,按玩家实际发现的顺序收录,每个纸面承载一篇完整的小事;记录内容与玩家经历保持一致。

暖木、纸面与长明巷的声音

视觉以暖木、旧纸、桂花和柔和光影为主要元素,让首页、场景、手记与功能界面保持统一。人物和物件使用独立素材,交互时通过轻微上浮、镜头靠近和动作变化给予回应。

声音围绕家中、白天小馆和夜饭三种环境编排原创合成轻配乐,并为翻纸、杯碟和木面等操作提供音效。对白与逐字显字保持安静,为阅读留出空间。

游玩与使用

作品可在浏览器中运行,采用自适应布局,支持鼠标、键盘和触屏操作。教学随当前任务逐步出现,玩家可以收起提示,自由探索。

游戏提供自动存档、三个手动档位、存档导入导出、章节重玩,以及音乐、音效、静音、减少动画和全屏设置。玩家可以中断后继续,也可以回到先前的章节重新作出选择。

技术实现

《百味录》使用 Vue 3、TypeScript、Vite、Three.js 与 GSAP 构建。界面、剧情规则、内容数据和浏览器服务分别组织,未使用 Bootstrap、Element 等预设样式库,木制控件、纸本界面和场景交互由项目自行实现。

剧情规则与内容分离

游戏将章节、对白、物件、前置条件和奖励编排为内容数据,由统一规则层处理玩家操作。界面负责呈现结果,不直接修改剧情进度。

这套结构让同一个物件能够根据玩家经历显示不同状态,也让人物记住已经发生的事情。例如,搬走的凳子会离开原位置,尚未听过的故事不会提前进入手记,已经完成的动作不会重复发放奖励。修改对白或替换素材,也不需要重写底层流程。

支持中断、回访和旧档接续

存档保存章节位置、对话进度、已发现线索、任务结果与关键选择。玩家中断阅读后可以继续未完成的步骤,回访旧地点后也能返回原来的行程。

读取存档时,程序先检查数据格式与内容引用,再恢复进度;旧版本通过迁移逻辑接入当前内容。开发者测试模式使用独立档位,方便检查不同场景和分支,并与正常游玩进度分开。

分层场景与实物交互

场景由背景、独立人物、物件和家具前景组合而成。物件可按剧情阶段改变位置、姿态和可操作状态;镜头靠近、翻面、展开和拖动等表现与剧情规则分开处理。

GSAP 用于镜头与物件转场,Three.js 按需加载,用于部分物件和小游戏的三维表现。小游戏内部处理本轮操作,结束后将完成或取消结果交回统一规则层,避免各小游戏分别维护剧情奖励。

渐进阅读与响应式布局

对白、物件说明和纸面文字采用渐进显示,玩家可点按补全或继续;回答在阅读完成后开放,由玩家明确选择。显字进度、翻页位置和教学收起状态独立于剧情存档。

界面根据视口调整场景取景、控件和纸本排版:桌面可并排阅读书页,窄屏切换为单页;长文在正文区域内滚动,边框和常用操作保持固定。减少动画设置用于降低持续运动和阅读等待。

资源与运行方式

提交包同时提供源码和生产成品。图片仅在打包副本中转换为等尺寸 WebP,保留透明通道与原有裁切坐标,开发工程原图完整保留。三维模块与小游戏按需加载。

作品无需后端、账号或 API 密钥。安装 Node.js 后,可通过随包静态服务启动成品,无需先下载项目依赖;源码则可独立安装、检查与构建。

验证与质量检查

项目通过类型检查、内容校验、自动测试和浏览器检查分别验证工程与运行表现。

检查项 已验证内容
TypeScript 类型检查 内容契约、组件与运行装配的类型一致性
内容校验 章节、对白、条件、奖励及资源引用,拒绝对白自循环
190 项自动测试 分支流程、奖励去重、中断恢复、回访与存档迁移等
六档视口检查 1920×1080、1440×900、1280×720、720×1280、390×844、320×640
浏览器交互检查 首页确认、引子、开门、续读及 13 处场景跳转
交付包检查 匿名扫描、逐层解压、独立启动及全部成品文件的 HTTP 校验

生产构建目标为 Chrome 129,2026-11-11 的浏览器检查使用 Chrome 157;Chrome 129 实机、Safari、手机真机和完整人工通关尚未全部覆盖,当前工程不支持 IE。具体范围随包记录,便于评审复核。

队伍信息

队伍:风栖林;组别:壹组。队长:蔺博洋;队员:王子萌。

比赛提交

可上交的附件:零杯壹组-风栖林-蔺博洋.zip(74.49 MiB)。内含完整、匿名两个子压缩包,均提供源码、可运行成品、测试、设计说明和许可。

总包已通过匿名扫描、逐层解压及独立运行验证。详细记录见 比赛提交验收记录。后续修改游戏后须重新打包,再替换根目录附件。

本地启动

需要 Node.js 24.15 或更新版本。

npm ci
npm run dev

macOS 可双击 START.command;Windows 可在安装依赖后双击 START.bat。本机独立浏览器预览使用 npm run preview:local。

npm run build
node scripts/serve.mjs dist

成品通过终端打印的 localhost 地址打开,不直接双击 HTML。比赛子包自带 dist,安装 Node 后即可运行,无需先安装依赖。

目录导航

位置 内容
src/ 正式源码:规则、剧情、运行装配、界面和适配
public/assets/ 正式运行素材与字体许可;原图保留
tests/ 规则、分支与存档测试
scripts/ 内容检查、素材工具、构建预览和比赛打包
docs/ 策划、设计、工程记录与素材来源
references/competition/ 比赛选手手册、评分 PPT 原件,仅本地保存
archive/original-packages/ 原始归档 ZIP,仅本地保存
archive/local-snapshots/ 此前的本地版本副本,仅供追溯,不作为开发入口
submission/ 比赛打包副本、检查日志、截图、解压验收与子包
dist/ 本机生成的生产成品
node_modules/ 本机依赖,由 npm 安装

根目录的 package.json、锁文件、index.html、TypeScript/Vite 配置及 START 脚本是标准工程入口,保留原位。.tmp/、.npm-cache/、.tools/ 为隐藏的本机工作目录,不进入比赛包。

检查与协作

npm run typecheck
npm run check:content
npm test
npm run build

当前内容 v6、状态 v3。存档在浏览器本地,可导入导出;开发测试工具通过设置、F8 或 ?dev=1 开启,测试档与正常进度分离。

开始开发先读 AGENTS.md、开发原则与协作约定 和 架构与边界。更多内容见 文档索引、交付规范 与 第三方说明。原 README 的详细进度与历史说明保存在 历史入口记录。

第三方库与工具

名称 版本 用途 许可
Vue 3.5.44 组件和响应式界面 MIT
Three.js 0.180.0 独立物件三维渲染 MIT
GSAP 3.15.1 相机、开合、光影与转场 Standard “No Charge” License
Vite 8.3.5 开发预览与生产构建 MIT
TypeScript 5.9.3 类型与源码检查 Apache-2.0
@vitejs/plugin-vue 6.0.10 Vue 单文件组件编译 MIT
vue-tsc 3.3.14 Vue 类型检查 MIT
@types/three 0.180.0 Three.js 类型定义 MIT
Node.js ≥24.15.0 构建、测试与本机静态服务 Node.js License
LXGW WenKai / Noto Serif SC 本地 WOFF 子集 正文和标题字体 SIL OFL 1.1

未使用预设样式库,无后端或 CMS。字体采用本地 WOFF 子集,保留随附 OFL 许可;图像使用 AI 图像工具,音乐与音效为本项目原创合成。详细来源与授权见 第三方说明。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages