Skip to content

wangjiehu/echo-string-genesis-prototype

Repository files navigation

Echo-String: Genesis Prototype

《语弦生态:创世纪》的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
  • 可记录的试玩测试

文件索引

总规格

数据

设计

生产

可运行原型

启动方式:

优先使用网页试玩入口。如果要本地运行:

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

推荐推进顺序

  1. 先实现数据读取和语义对象。
  2. 做Z1封文大门闭环:扫描、剥离、注入、破门。
  3. 做Z2质量谜题。
  4. 做Z4蒸汽反应。
  5. 做Z3和Z6战斗切片。
  6. 完整串联Z0到Z7。
  7. 开始试玩测试,根据数据删减或优化。

当前不要做

  • 不做自由输入文字。
  • 不做开放世界。
  • 不做文明语系切换。
  • 不做复杂因果闭环。
  • 不做真实流体模拟。
  • 不做大量装备、等级和数值成长。

这些都不是被否定,而是暂时不该抢MVP的验证空间。

当前已加入的体验层

  • 区域步骤清单:显示当前、待办和完成状态。
  • 推荐目标高亮:减少玩家不知道点谁的问题。
  • 写入/剥离预览:显示消耗、替换词和可能触发的反应。
  • 自动选中刚剥离的词缀:减少无意义点击。
  • 临时词库跨区归档:避免旧词挤满词库。
  • 试玩指标:记录扫描、剥离、注入、反应、误操作、Boss语义操作和首次操作时间。
  • 测试工具:补墨、重置当前区域、导出报告。
  • 测试模式:引导、低引导、调试三种模式可切换。
  • 分区报告:记录每区耗时、模式变化、最长区域和误操作总量。
  • 试玩会话栏:显示会话号、模式、报告状态和恢复建议。
  • 结构化扫描器:分为当前词缀、开放槽位、写入/剥离预览。
  • 动作分组:扫描、语义、战斗、机关、推进分区显示。
  • 撤销操作:支持撤销最近一次剥离、注入或清空词库。
  • 通关总结:Z7显示总用时、每区耗时、误操作、反应和Boss语义操作。
  • 首屏自动选中推荐目标:引导和调试模式进入页面即可直接扫描。
  • 状态仪表条:原墨、词库、区域进度和用时都有轻量进度反馈。
  • 对象卡片强化:推荐、选中、可写入、阻塞、生命和Boss护文都有直接视觉信号。
  • 词库路由提示:剥离后优先提示下一步扫描或写入目标。
  • 事件日志复盘:事件带时间和区域,便于对照卡点。
  • 通关判定:完成后给出路径稳定、可用或需要复盘的判定语。
  • Boss阶段化:残章守卫三层护文分别要求蒸汽爆发、破裂窗口和力场震荡。
  • 自动回归入口:?autorun=guided-regression 可在浏览器中跑完整引导路线并写入报告节点。
  • 双模式回归套件:?autorun=suite-regression 同时验证引导和低引导路线。
  • 质量审计:报告输出质量评分、路线断言、软锁风险、反应覆盖和检查点恢复次数。
  • 真人试玩硬化:低引导目标去答案化,未扫描对象隐藏词名、槽位和成本。
  • 玩家可见路径审计:禁止自动路线剥离UI不可见词,并覆盖Boss末尾与Z5词源误取风险。
  • 结果反馈条:每次操作后显示成功、警告或阻塞反馈,并写入报告的反馈事件。
  • 真实DOM点击回归:通过Chrome/Edge点击页面对象、词缀、词库和动作按钮完成双模式路线。
  • 视觉Smoke:自动检查桌面引导和手机低引导首屏,无横向溢出、关键反馈可见且存在可操作首步入口。
  • 逻辑拆分:核心交互留在app.js,回归和审计移入regression.js,保持无构建静态加载。

About

Echo-String: Genesis semantic rewriting MVP prototype and playtest work package

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors