# 零号维修站 **Repository Path**: mrjkchen/zero-repair-station ## Basic Information - **Project Name**: 零号维修站 - **Description**: 明亮卡通风两分钟生存射击 Demo，横屏虚拟摇杆、自动射击、零件升级；当前交付浏览器试玩，预留抖音小游戏适配。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-02 - **Last Updated**: 2026-11-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 零号维修站 2026-11-05触控恢复复核见[实现与边界](docs/touch-reload.md)及[实际整局/交互审阅](http://127.0.0.1:4178/touch-reload-review/index.html)。游戏构建仍为12dc6438；203测试，第一章308.867秒/17选择/HP128、第二章309.817秒/18选择/HP110均实际胜利。伤害数字807/983完整对应；脉冲8/8与14/15（一次升级拦截），五次实际重开、滑出松手及真实失焦冻结通过。仅修QA协议输入，不改游戏、美术或UI；不是手机、真正document-hidden或独立新玩家验收。 2026-11-05第一章阶段更新：3:30同侧进入护盾/冲撞/追踪/炮击混合小队，复用已有素材与敌人机制，借用7次常规刷怪时间。地图、镜头、角色、HUD与40×24暂停开关不改。见[实现、配置和边界](docs/chapter-squad.md)及[同镜头对比/运行采样](http://127.0.0.1:4178/squad-review/index.html)。202测试和前后各72局模型通过；本轮刷新后协议触控异常未解决，阶段网页样例用真实键盘，不算双指/手机通过。 2026-11-05网页候选复核：最终同构建第一章308.933秒自然胜利、17选择、HP132，第二章已有307.067秒胜利证据；运行源码、美术、数值与UI未改。新增[手册逐项核对](docs/handbook-evidence.md)、34PNG独立图层索引及[开局/首领预览](http://127.0.0.1:4178/final-web-review/index.html)。第一章3:30仍缺单独精英组合，手机/新玩家/最终视听未验收，未将候选当全部完成。 2026-11-05成长阶段：单武器时提供两种第二武器选择，经验中段2.2/后段.8；原主武器优先与新增第二武器优先分别做168局匹配对照，保留失败及19次升级样本。197测试通过，见[修改、参数与限制](docs/growth-stage.md)，构建后打开[实际运行与前后对照](http://127.0.0.1:4178/growth-stage-review/index.html)。整份手册仍未完成。 2026-11-05双核心复核：修复已消耗＋剩余核心超过等级发放上限的记录，六种合法组合实际确认/保存恢复通过；2808固定案例与144整局回归见[方法及限制](docs/dual-core-audit.md)，构建后可看[运行预览与组合数据](http://127.0.0.1:4178/dual-core-review/index.html)。192测试通过，正常数值/美术/UI保留，整份手册仍未完成。 2026-11-05路线移动复核：新增1944组站定/拾取避险/双向绕行对照，分别记录进阶与备用武器伤害；本轮不调整数值或美术。见[方法与限制](docs/motion-matchups.md)，构建后打开[可筛选数据与实际运行样例](http://127.0.0.1:4178/motion-matchup-review/index.html)。 2026-11-05进阶校验：生成、存档加载和确认共用实际条件，防止损坏记录或失效选择造成负核心/重复消费；合法三卡与原抽取策略保持。见[实现与实际验证](docs/upgrade-legality.md)，构建后可打开[前后对比](http://127.0.0.1:4178/upgrade-legality-review/index.html)。 2026-11-05开局衔接：新局首次实际回收一枚普通零件即可升级，短暂收近开场入场周边；旧局当前经验门槛保留。参数、固定模型结果和未完成项见[opening-flow](docs/opening-flow.md)，构建后可打开[实际前后对比与约24秒运行采样](http://127.0.0.1:4178/opening-flow-review/index.html)。 明亮卡通风 2D 俯视生存射击。当前网页试玩为 **0.5.0 竖屏版**，包含中央维修区、动力维护区两章，以及三把基础武器和六条进阶路线。每章最多六分钟。 0.4.4 重做主炮暴击的白金接触闪光、定向碎片、断口能量环、数字弹出和金属撞击声。表现节奏集中在 `FEEDBACK.cannonCritical`。网页的减少动态效果偏好会降低局部闪光强度并关闭机体视觉偏移。 目前按用户要求交付**网页试玩**；抖音小游戏只预留适配入口，AppID 为空，尚未进行手机原生验收。 ## 立即运行 Windows双击根目录 **开始游戏.cmd**，或执行 `npm run play`：自动构建/启动或复用本工程服务，再进入系统默认浏览器。需要Node.js20+，端口冲突会提示，不结束其他程序。入口固定 [127.0.0.1:4178](http://127.0.0.1:4178/)，继续使用该地址的存档。 单文件版本：先执行 `npm run build`，然后双击 `dist/零号维修站-试玩Demo.html`。无需安装引擎或联网加载素材。音频在首次点击开始后启用。 若HTML被关联到编辑器，请用浏览器打开或使用上方cmd入口。HTTP、localhost、局域网IP与file路径的存档独立，旧存档请沿用原地址。启动/离线/解压包的实际验证及本地制作候选包方法见 [交付入口](docs/play-entry.md)；维护者执行 `python scripts/package.py` 后，包与SHA256清单位于dist/delivery。源码ZIP不含Git历史；常规构建/测试可运行，历史对照及再次打包需Git仓库。 开发模式需要 Node.js >=20，无第三方 npm 依赖： ```sh npm test npm run check npm run build npm start ``` 在电脑浏览器打开 [试玩地址](http://127.0.0.1:4178/)。手机竖屏试玩时，使用同一 Wi-Fi，打开开发电脑的局域网 IPv4 地址加 `:4178`。网络和防火墙由使用者按环境配置，本项目不自动修改系统防火墙。用同一浏览器地址继续游戏，存档按来源独立保存。 ## 操作与胜负 - 左下虚拟摇杆：360 度移动，松手停止；支持与技能按钮同时操作。 - 右下电磁脉冲：对附近敌人造成伤害并击退，12 秒冷却。 - 武器自动攻击。主炮、锯片、电弧可以升级、专精或融合。 - 黄色零件：靠近自动吸入，填满经验条暂停并选择一项升级。 - 追踪机：圆形，持续靠近；冲撞机：三角形，地面箭头预警后沿锁定方向冲撞。 - 5:00 首领登场。6:00 前击败首领获胜，生命归零失败，首领仍存活则超时。第一章胜利解锁第二章。 - 顶部暂停可继续、调整音效、震动与闪光、退出。首页可继续已保存的对局。 - 浏览器桌面调试也可使用 WASD/方向键、空格、Esc；手机界面不显示键盘提示。 选中升级卡片后按确认，每局可重抽两次。锯片或电弧首次命中会解锁相应起始武器。对局、设置、最高成绩与进阶发现记录保存在本地浏览器。 ## 配置与维护 存档异常现在会区分写入失败、临时进度与不可读记录：保留本次内存对局，写入恢复后5秒限频重试；读取受限时不覆盖未知旧记录，需恢复权限后重新打开。正常UI布局不变。见[存档可靠性说明与170测试](docs/storage-reliability.md)及[实际前后与恢复记录](http://127.0.0.1:4178/save-reliability-review/index.html)。关闭前尚未成功写入的临时进度仍可能丢失。 两章已分别通过正常规则的完整实时浏览器流程：主炮起手第一章5:05胜利、电弧起手第二章5:07胜利，均17次实际升级确认；章节/武器/图鉴解锁和结算后刷新已验证。详见[完整浏览器流程与边界](docs/browser-full-flow.md)及[关键帧验收页](http://127.0.0.1:4178/browser-flow-review/index.html)。这是自动控制的桌面实测，未替代新玩家或手机；旧浏览器“seed804”标注已更正为实际种子未知，新两局在启动后记录真实seed。 成长节奏已改为新局首级3点、核心前后分段成本，第二武器保底适用于三种starter；旧存档保留当前门槛。[成长调整与真实测试](docs/growth-timing.md)包括161测试、72+24正常规则模型、实际选卡/存档和仍超出30秒的网页路径。可打开 [阶段数据与约32秒开局采样](http://127.0.0.1:4178/growth-timing-review/index.html)。这是阶段改善，未宣称全部时点、新玩家或手机验收完成。 黄色零件现在使用独立透明六角螺母、接地影和既有落地动画，吸附半径及奖励不变。[素材与测试说明](docs/pickup-art.md)记录来源、24逻辑像素参数、156测试、实际单次拾取和压力开销；构建后可打开 [同尺前后与22.2秒采样预览](http://127.0.0.1:4178/pickup-art-review/index.html)。这是桌面固定预设，物理手机、自然新玩家和最终美术仍待验收。 2026-11-04 网页战斗HUD使用独立原生控件与四层摇杆/脉冲画面，支持安全区、大字体、焦点导航及多指操作；原生小游戏仍用Canvas后备。关键参数、真实测试、性能成本和未验收项见 [战斗HUD说明](docs/hud-native-controls.md)。构建后可访问 [同尺前后截图](http://127.0.0.1:4178/hud-review/index.html)，截图预设不等于完整自然对局。 基础参数在 `src/config.js`，关卡与进阶参数在 `src/chapter.js`。用 `node scripts/chapter-playthrough.js --alternates` 重跑固定种子的完整模拟。现有证据与剩余验收见 [批次 H](docs/portrait-batch-h.md)。 六路线可用 `node scripts/route-audit.js --out=work/route-audit.json` 复核。报告区分胜负、是否取得目标与是否真实命中；其退出码只检查结算完整性，不代表路线/平衡全部通过。成长保底、前后72局样本与真实浏览器证据见 [成长复核](docs/route-growth-audit.md)，整份手册未完成项见 [交付核对](docs/delivery-audit.md)。 贴身炮弹漏判已修复，轨道主弹系数集中为3.6；沿用原结算与暴击规则。新增等13次选择的252组固定比较、72局完整复核和60敌CPU测量，见 [路线与命中报告](docs/route-matchups.md)。构建后的 [对照图与约22秒采样预览](http://127.0.0.1:4178/route-matchup-review/index.html)可直接查看；不是自然成型、手机或全部路线平衡完成的证据。 星核主弹系数现为5.5，保留蓄力、四目标贯穿和1.2秒间隔。[专项报告](docs/star-audit.md)记录288组候选、实际刷新继续/贯穿与72局复核（72胜、69目标有效，不能混同）。构建后可看 [同尺对照与采样预览](http://127.0.0.1:4178/star-review/index.html)。 开局回收提示现在读取真实掉落与已回收数量，实际拾取后结束；常规HUD位置不变。首级经验集中为`CHAPTER.openingXp=10`，未采用8/6候选。[阶段报告](docs/pacing-audit.md)区分第二武器机会/实际选择、核对经验守恒与核心，并明确前30秒升级等未完成项。可打开 [前后截图与阶段数据](http://127.0.0.1:4178/pacing-review/index.html)。 首领瞄准带、通电边缘与敌弹使用独立前景层，炮口/方向/设备阻挡与真实发射共用几何；死因显示实际敌人与冲撞阶段。[首领预警验收](docs/boss-warning.md)包含前后截图、两首领实际周期、约12秒无音轨采样预览及CPU测量边界。 HUD包边与中心纹理已使用两张独立素材，文字、进度、触区仍是实时组件；原有布局矩形保留。[材质说明与拆图参数](docs/hud-materials.md)及构建后的 [同尺对照页](http://127.0.0.1:4178/hud-material-review/index.html)可查看来源、最终PNG和实际验证。材质仍待用户最终视觉认可。 `npm run build` 生成浏览器目录、自包含 HTML 和预留的小游戏目录；构建不会执行上传、提审或发布。小游戏配置依据[抖音官方开发指南](https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/guide/dev-guide/bytedance-mini-game)和[横屏配置说明](https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/framework/mini-game-configuration)预留。绑定与平台验证须待用户后续通知。 浏览器服务器仅提供静态文件，无账号系统、云端 API、广告、付费或埋点。音效是 `scripts/sounds.js` 生成的原创合成音，修改后执行 `node scripts/sounds.js`，再构建。 0.2 的战斗反馈、交互改动、关键参数、性能对比与验证见 `docs/feedback-v02.md`。素材来源见 `docs/assets.md`，首版验证证据与限制见 `docs/validation.md`，跨 AI 交接约束见 `AGENTS.md`。 0.2.1 复核补强、29项测试、升级前后台回归与完整性能数据见 `docs/feedback-v021.md`。角色、场景、UI布局和资源文件沿用0.2。 0.3.0 大地图美术修复：同尺度连续地砖、固定工位与三个透明机械模块、实体碰撞/轻量绕行、独立柔和阴影、宽屏补全真实视野、控件材质与遮挡提醒。参数在 `ART`，布局在 `src/scene.js`；变更原因、34项测试、实跑路线与性能限制见 `docs/visual-v03.md`。 0.4.0 按用户选定的 `docs/reference-map-v04.png` 重制四角功能区、中央空场与环形通道，新增四组透明设备及地板纹理，地面以原生3840×2160静态层绘制。开局位置在维修区通道入口；玩法与UI操作保持一致。新地图、碰撞校准、36项测试、运行路线和性能数据见 `docs/map-v04.md`；本轮素材提示词见 `docs/assets-v04-prompts.json`。 0.4.1暂停场景扩展，修复高窗口中HUD悬浮、校准角色/敌人/操作控件比例，隐藏大型设备与标识，保留一处原有小维修设备。原素材不删除/覆盖；实际安全区锚点与触控共用 `src/layout.js`，图层开关位于 `ART.layers`。原因、41项测试、同位置对比和恢复方法见 `docs/layout-v041.md`。 0.4.2只优化战斗可读性：有上限的渐进分离、缓存浅色轮廓、短促真实命中落点、同步蓄力/冲撞预警、技能数字与图标分层、控件后危险提示。地图结构、镜头、角色尺度、UI位置、刷怪规则均保留；17张既有PNG完全不改，降低地板接缝对比的版本另存。45项测试、固定38敌前后对比、25秒录屏事件、浏览器双指模拟、原始性能数据与恢复方式见 `docs/readability-v042.md` / `docs/readability-v042-data.json`。同步模拟/绘制提交平均耗时5.62→5.96ms，不代表帧率提升或手机验收。 0.4.3新增逐次伤害数字、受伤血条、真实暴击和分武器命中/音效反馈。现有伤害入口共用一次结算并产出完整damage事件；主炮/锯片初始10%暴击、1.5倍，伤害四舍五入最小1；脉冲固定伤害。默认每命中一个数字，未伤满血怪隐藏血条；可选合并只影响表现。场景/镜头/尺寸/UI与原18张PNG、12个WAV不变。57项测试、固定七场景、24秒实跑、性能成本与开发开关见 `docs/damage-v043.md`，完整事件数据见 `docs/damage-v043-data.json`。手机/抖音原生尚未验收。