《语弦生态:创世纪》的MVP原型设计与生产工作包。当前目标不是完整3A开放世界,而是验证“语义槽位改写”是否能支撑一个15到20分钟的可玩垂直切片。
GitHub仓库:wangjiehu/echo-string-genesis-prototype
网页试玩入口:https://wangjiehu.github.io/echo-string-genesis-prototype/
项目应先做“断句庭院”:
- 10个MVP词缀
- 3个组合反应
- 1个灰盒关卡
- 2种普通敌人
- 1个小Boss
- 可记录的试玩测试
- data/semantic_tags_mvp.json:10个MVP词缀数据
- data/semantic_reactions_mvp.json:3个组合反应规则
- data/semantic_objects_mvp.json:断句庭院对象、敌人与Boss配置
- design/duanju_courtyard_graybox.md:断句庭院灰盒流程
- design/puzzle_route_matrix.md:谜题主解法、旁路和防卡死矩阵
- design/combat_slice.md:MVP战斗切片设计
- production/prototype_backlog.md:原型开发任务拆解
- production/playtest_plan.md:试玩测试计划
- production/risk_review_log.md:风险复盘与优化日志
- production/verification_report.md:本轮原型验证记录
- production/final_delivery_manifest.md:最终交付清单
- production/latest_playtest_report.json:最近一次自动化回归生成的试玩指标
- production/latest_mode_report.json:v0.5模式化回归生成的结构化报告
- production/latest_mode_summary.md:v0.5回归报告的可读摘要
- production/latest_mode_visibility_report.json:三种测试模式显隐验证记录
- production/latest_ux6_report.json:v0.6体验升级后的结构化回归报告
- production/latest_ux6_summary.md:v0.6回归报告摘要
- production/latest_ux6_visibility_report.json:v0.6模式显隐验证记录
- production/latest_ux7_report.json:v0.7界面与可玩性升级后的结构化回归报告
- production/latest_ux7_summary.md:v0.7回归报告摘要
- production/latest_ux7_visibility_report.json:v0.7模式显隐与首屏验证记录
- production/latest_ux8_report.json:v0.8网页直玩构建的结构化回归报告
- production/latest_ux8_summary.md:v0.8回归报告摘要
- production/latest_ux8_visibility_report.json:v0.8网页直玩与首屏验证记录
- production/latest_ux9_report.json:v0.9引导收口和状态修正后的结构化回归报告
- production/latest_ux9_summary.md:v0.9回归报告摘要
- production/latest_ux9_visibility_report.json:v0.9流程状态、Z5引导和重复扫描验证记录
- production/latest_ux10_report.json:UX10 Boss阶段与自动回归结构化报告
- production/latest_ux10_summary.md:UX10回归报告摘要
- production/latest_ux10_visibility_report.json:UX10桌面、手机和自动回归验证记录
- production/latest_ux20_report.json:UX20双模式回归套件结构化报告
- production/latest_ux20_summary.md:UX20十版推进摘要
- production/latest_ux20_visibility_report.json:UX20校验和回归套件验证记录
- production/latest_ux21_report.json:UX21真人试玩硬化与可见路径审计报告
- production/latest_ux21_summary.md:UX21回归套件摘要
- production/latest_ux21_visibility_report.json:UX21反馈面、失败上下文和可见路径验证记录
- production/latest_ux21_dom_click_report.json:UX21真实浏览器DOM点击回归记录
- production/latest_ux21_visual_smoke_report.json:UX21桌面/手机首屏视觉Smoke记录
- production/low_guidance_human_playtest_protocol.md:低引导真人试玩观察协议
- production/low_guidance_playtest_record_template.md:低引导真人试玩记录模板
- production/report_comparison.md:多份试玩报告对比表
- production/ux_iteration_plan.md:后续体验优化路线
- production/engineering_review_round_4.md:本轮工程审查和改动记录
- production/engineering_review_round_5.md:v0.6体验升级审查记录
- production/engineering_review_round_6.md:最终工程收口审查记录
- production/engineering_review_round_7.md:v0.7界面与可玩性审查记录
- production/engineering_review_round_8.md:v0.9最终体验收口审查记录
- production/engineering_review_round_9.md:UX10 Boss阶段与回归钩子审查记录
- production/engineering_review_round_10.md:UX20连续十版优化审查记录
- production/engineering_review_round_11.md:UX21真人试玩硬化审查记录
- production/web_playability_review.md:网页直玩发布与体验审查
- production/ux_upgrade_master_plan.md:全面UX升级方案与实施轮次
- prototype/index.html:静态灰盒交互原型
- prototype/app.js:原型逻辑
- prototype/regression.js:自动回归、失败审计和玩家路径审计
- prototype/styles.css:原型界面
- prototype/server.mjs:本地静态服务器
- prototype/start.ps1:自动选端口启动脚本
- prototype/prototype_modes_v5_full.png:最新版全流程验证截图
- prototype/prototype_ux6_full.png:v0.6全流程验证截图
- prototype/prototype_ux7_full.png:v0.7首屏界面验证截图
- prototype/prototype_ux8_full.png:v0.8网页直玩首屏验证截图
- prototype/prototype_ux8_mobile.png:v0.8手机首屏验证截图
- prototype/prototype_ux21_full.png:UX21桌面首屏验证截图
- prototype/prototype_ux21_mobile.png:UX21低引导手机首屏验证截图
- scripts/validate_project.ps1:项目校验脚本
- scripts/summarize_report.ps1:试玩报告摘要生成脚本
- scripts/aggregate_reports.ps1:多份试玩报告汇总脚本
- scripts/app_vm_harness.mjs:Node VM应用运行时测试支架
- scripts/run_app_regression.mjs:引导/低引导双模式回归套件
- scripts/run_failure_audit.mjs:失败归因审计脚本
- scripts/run_player_path_audit.mjs:玩家可见路径审计脚本
- scripts/run_dom_click_regression.mjs:真实浏览器DOM点击回归脚本
- scripts/run_visual_smoke.mjs:桌面/手机首屏视觉Smoke脚本
- scripts/write_ux_report.mjs:UX报告与显隐记录生成脚本
- scripts/check_app_data_consistency.mjs:原型与数据表一致性检查
- scripts/check_ui_contract.mjs:HTML与JS绑定合约检查
启动方式:
优先使用网页试玩入口。如果要本地运行:
cd "D:\Wonderful\Others\echo string-genesis prototype"
powershell -ExecutionPolicy Bypass -File .\prototype\start.ps1 -Port 4174脚本会输出实际可用地址,例如:
http://127.0.0.1:4174/index.html
校验方式:
cd "D:\Wonderful\Others\echo string-genesis prototype"
powershell -ExecutionPolicy Bypass -File .\scripts\validate_project.ps1 -Port 4174带 -Port 时会刷新真实DOM点击报告、视觉Smoke报告、UX21主报告、摘要和多报告对比。如果只做静态校验,可以省略 -Port。
生成报告摘要:
cd "D:\Wonderful\Others\echo string-genesis prototype"
powershell -ExecutionPolicy Bypass -File .\scripts\summarize_report.ps1生成多报告对比:
cd "D:\Wonderful\Others\echo string-genesis prototype"
powershell -ExecutionPolicy Bypass -File .\scripts\aggregate_reports.ps1运行应用级回归:
node .\scripts\run_app_regression.mjs
node .\scripts\run_failure_audit.mjs
node .\scripts\run_player_path_audit.mjs
node .\scripts\run_dom_click_regression.mjs http://127.0.0.1:4174/index.html
node .\scripts\run_visual_smoke.mjs http://127.0.0.1:4174/index.html- 先实现数据读取和语义对象。
- 做Z1封文大门闭环:扫描、剥离、注入、破门。
- 做Z2质量谜题。
- 做Z4蒸汽反应。
- 做Z3和Z6战斗切片。
- 完整串联Z0到Z7。
- 开始试玩测试,根据数据删减或优化。
- 不做自由输入文字。
- 不做开放世界。
- 不做文明语系切换。
- 不做复杂因果闭环。
- 不做真实流体模拟。
- 不做大量装备、等级和数值成长。
这些都不是被否定,而是暂时不该抢MVP的验证空间。
- 区域步骤清单:显示当前、待办和完成状态。
- 推荐目标高亮:减少玩家不知道点谁的问题。
- 写入/剥离预览:显示消耗、替换词和可能触发的反应。
- 自动选中刚剥离的词缀:减少无意义点击。
- 临时词库跨区归档:避免旧词挤满词库。
- 试玩指标:记录扫描、剥离、注入、反应、误操作、Boss语义操作和首次操作时间。
- 测试工具:补墨、重置当前区域、导出报告。
- 测试模式:引导、低引导、调试三种模式可切换。
- 分区报告:记录每区耗时、模式变化、最长区域和误操作总量。
- 试玩会话栏:显示会话号、模式、报告状态和恢复建议。
- 结构化扫描器:分为当前词缀、开放槽位、写入/剥离预览。
- 动作分组:扫描、语义、战斗、机关、推进分区显示。
- 撤销操作:支持撤销最近一次剥离、注入或清空词库。
- 通关总结:Z7显示总用时、每区耗时、误操作、反应和Boss语义操作。
- 首屏自动选中推荐目标:引导和调试模式进入页面即可直接扫描。
- 状态仪表条:原墨、词库、区域进度和用时都有轻量进度反馈。
- 对象卡片强化:推荐、选中、可写入、阻塞、生命和Boss护文都有直接视觉信号。
- 词库路由提示:剥离后优先提示下一步扫描或写入目标。
- 事件日志复盘:事件带时间和区域,便于对照卡点。
- 通关判定:完成后给出路径稳定、可用或需要复盘的判定语。
- Boss阶段化:残章守卫三层护文分别要求蒸汽爆发、破裂窗口和力场震荡。
- 自动回归入口:
?autorun=guided-regression可在浏览器中跑完整引导路线并写入报告节点。 - 双模式回归套件:
?autorun=suite-regression同时验证引导和低引导路线。 - 质量审计:报告输出质量评分、路线断言、软锁风险、反应覆盖和检查点恢复次数。
- 真人试玩硬化:低引导目标去答案化,未扫描对象隐藏词名、槽位和成本。
- 玩家可见路径审计:禁止自动路线剥离UI不可见词,并覆盖Boss末尾与Z5词源误取风险。
- 结果反馈条:每次操作后显示成功、警告或阻塞反馈,并写入报告的反馈事件。
- 真实DOM点击回归:通过Chrome/Edge点击页面对象、词缀、词库和动作按钮完成双模式路线。
- 视觉Smoke:自动检查桌面引导和手机低引导首屏,无横向溢出、关键反馈可见且存在可操作首步入口。
- 逻辑拆分:核心交互留在
app.js,回归和审计移入regression.js,保持无构建静态加载。