民国海港电报房断句解谜。
给一串没有标点的电文落停顿:逗、句、问、叹,落在哪儿,它就讲哪件事。
10 道谜题 / 32 条读法 / 92 个可落点 / 5 个结局;
单文件零依赖实现,附构建脚本、数据自检与端到端测试。
协议是 协议。
《电报员模拟器》开源工程说明 这是一款用单文件 HTML 写的浏览器文字解谜游戏(民国电报房断句解谜),拿回去既可以直接玩,也可以直接改。 一、工程主体 全部游戏逻辑写在 src/index.html 一个文件里,约 1800 行,纯 HTML + CSS + 原生 JavaScript,不用框架、不用打包器、不用装任何依赖,解压就能跑。代码本身只有 94KB。 内容规模:10 道断句谜题(含 1 道分段长电文)、32 条预设读法、92 个可落点、52 个剧情场景、5 种结局;单周目正文 4500–5100 字,通关约 25 分钟。 核心机制可以直接读、直接改:断句判定引擎(正读 / 偏读 / 自由读三档,任何断法都发得出去、不会卡关)、谜题 / 剧情 / 流程 / 线索 / 结局五张数据表、支持 12 种表现形式的剧情播放器、手记、结局收集。 工具与测试:构建脚本 build.mjs、本地服务 dev.mjs、数据自检 validate.mjs、打包脚本 make-zip.py;两套测试(数据一致性 + 端到端,5 条结局路线全部走通)。 二、文档(4 份,共 1.8 万字,全中文) README.md——上手必读:怎么跑、怎么改剧情 / 谜题 / 美术 / 音乐,谜题字段逐个解释,3 条硬性约束。 AGENTS.md——给接手的人和 AI 助手:源码内部结构、判定规则、流程闭环图、线索链、8 条修改规范。 HANDOFF.md——开发交接:版本沿革、实测数据、10 道谜题一览、发布记录、15 条已知问题与待办。 三、示例(可运行的样本,不是截图) 10 道谜题就是 10 组示例数据,覆盖逗、句、问、叹四种标点和「末了」落点。经典例子:「下雨天留客天留我不留」有 10 个可落点、4 条读法,落在不同地方意思完全不同;「无鸡鸭亦可无鱼肉亦可青菜一碟足矣」给了落 2 处和落 4 处两种读法。另有一道分两段的长电文。两套测试可以当场跑出结果:数据一致性校验 8 项,端到端测试把 5 条结局路线全部走通。 四、素材范围(19 个文件,约 6.2MB,请务必看这段) 背景音乐 3 首、音效 7 个——来自幻光平台免费素材库。随工程交付是作为「让它能直接跑起来」的示例;二次使用、商用或再分发之前,请自行到素材库确认授权范围,不建议直接搬到别的作品里。 图片 9 张(封面 1 + 场景图 4 + 人物头像 4)——为本作单独制作,画风和人物只对应这一部作品。要换主题,请替换成你自己持有使用权的素材,覆盖 assets/img/ 下的同名文件即可。 全部素材已本地化,运行时不联网、无外链。素材占整包的 97.7%,代码只占约 110KB——如果你只想要代码,这一整块可以直接换成自己的。 五、上手 3 步 1. 解压后执行 npm run dev,浏览器打开 http://127.0.0.1:5173/。注意:不要直接双击 index.html,那样图片和音乐会全部加载不出来。 2. 读 README.md,跑一遍 npm run validate 确认工程完整。 3. 要改内容就改 src/index.html。 六、改之前先知道(硬性约束) 1. 严禁任何在线外链(图片、字体、脚本、样式、音视频都要本地化),自检会拦截。 2. 不要打包 SDK,平台播放器会在运行时自动注入。 3. 不要提交 .lumimaker/ 目录,里面含平台身份凭据。 4. 不要手工编辑 dist/,每次构建会清空重建。 七、授权 代码:可用于学习与二次开发。 素材:不随代码一起授权。音频来源为幻光平台免费素材库,使用受其规则约束;请替换为自有素材。