季风线 · MONSOON LINE
一个零依赖的浏览器空战小游戏
架空军事科幻 · 公元 2078 年 · 分水群岛
人类没能阻止气候变化，但学会了给其中一个旋钮装上螺丝刀。
然后有人发现，那个旋钮十六年来一直朝同一个方向拧。
▶ 在线试玩：https://gaogzs.github.io/monsoon-line/
也可以下载后双击 index.html 离线运行。不需要安装、不需要构建、没有任何第三方依赖。
目录
这是什么
2078 年，人类在平流层下部部署了一千四百个自主浮空单元，
每一个只做一点点，合起来微调季风线的落雨位置。这套阵列叫**「调节场」**，它救了很多人。
但它是一个位移系统，不是增量系统——它不能造雨，只能把本来要下的雨
往北或往南推一小段。十六年来，它每一个周期收到的都是同一条指令：
本周期目标：+4 公里
于是线北多下了 31% 的雨，线南少了 44%。
偏移量的表决机制写在一份文件的附件七里，而附件七从未公开过。
现在有人要把它转过来。
你为受益的那一方作战。这个设定不会让你舒服。
快速开始
最快的办法： 直接打开 https://gaogzs.github.io/monsoon-line/。
本地运行：
git clone https://github.com/gaogzs/monsoon-line.git
cd monsoon-line
然后直接用浏览器打开 index.html。
也可以起一个本地服务器（非必需，游戏在 file:// 下可正常运行）：
python -m http.server 8000
然后访问 http://localhost:8000
建议用支持 WebGL2 的现代浏览器并按 F11 全屏（不支持时会退回 2D 画法，画面效果会少一些）。第一次点击会启用音频。
挂载
每架飞机有几组成对的挂载点，在机库里一组一组地选装。右侧的挂载选择栏按
格斗弹 / 雷达弹 / 对地 / 吊舱 / 特殊分类，侧边的导航按钮点一下就跳到对应分类。
- 每个位置的可选清单不同 —— 翼尖只受得起轻型空空弹，大型弹只有重挂点挂得下；
挂不了的也会列出来，变暗、打叉并写明原因（挂点类型不符，或机体缺少对应能力）
- 同一种武器挂到多个组上，弹药池累加、一次齐射的枚数也累加
- 挂满会拖慢飞机（加速、俯仰、滚转、极速、失速速度都受影响），
打出去的弹会让拖累随之减轻；吊舱不消耗，所以拖累一直在
- 匿踪：机体自带的匿踪值会缩短敌方对你的锁定距离，外挂每个挂点会折损一点；
内埋弹舱里的挂载不折损。和它分工的是电子对抗，负责削弱来袭导弹的提前量预测
- 连基础短程导弹也是可选项 —— 不带就没有，只能靠机炮
操作
游戏默认使用鼠标引导（指令增稳飞控）：移动鼠标就是告诉飞控"我想让机头指向哪里"，
滚转、俯仰与协调转弯由飞控解算。
屏幕上的 CMD 瞄准环会随动压下降而张开——空气越稀薄，飞控越使不上劲。
| 输入 | 作用 |
|---|
| 鼠标移动 | 引导机头指向（默认模式） |
C | 切换 鼠标引导 / 键盘直控 |
M（按住） | 显示战场地图，松开关闭 |
W / S | 拉杆抬头 / 推杆低头 |
A / D | 左滚 / 右滚 |
Q / E | 方向舵 |
Shift / Ctrl | 油门增 / 减 |
X / Z | 加力燃烧室 / 减速板 |
↑↓←→ | 自由视角（松开自动回中） |
鼠标左键 / Space | 机炮 |
鼠标右键 / Enter | 发射特殊武器 |
F / Tab | 切换目标 |
R | 切换挂载 |
V | 释放干扰弹 |
N | 电磁静默 EMCON（关雷达 / 断数据链 / 停辐射） |
C | 切换视角（追尾 / 座舱 / 目标） |
1 2 3 | 僚机指令：散开 / 集火 / 掩护 |
H | 暂停 |
它特别在哪
平流层作战
整个战役里有三个阶段发生在 18 000 – 22 000 米。这不是为了好看——那个高度的
物理学是整个设计的支点：
| 高度 | 密度（相对海平面） | 静压 |
|---|
| 0 m | 1.00 | 101.3 kPa |
| 11 000 m | 0.30 | 22.6 kPa |
| 20 000 m | 0.072 | 5.5 kPa |
- 动压
q = ½ρv²：20 km 高度要获得同等动压需要 3.7 倍速度。HUD 上有独立的
Q 表，低于 12 kPa 开始告警，操纵面权限会实时下降
- 导弹过载崩塌：所有导弹的转弯能力按
√(ρ/ρ₀) 缩放。海平面上有 40G 的格斗弹，
在两万米只剩 6–9G——导弹在高空退化成一门有制导的炮
- 机炮反而更强：炮弹不需要空气来转向，只需要空气来保持弹道。20mm 的有效直射距离
从海平面的 1200 米变成 20 km 高度的 2600 米
所以"高端未来空战回到机炮"这件事，在这个游戏里有一个能算出来的理由，
而不是靠怀旧。
装备编号用的是真实的逻辑语（Lojban）词根
架空世界的签字语言是逻辑语——一门为消除歧义而造的人工语言。
跨国气候工程里的一次误读，代价是几千万吨雨落在错误的纬度上，
而后果要九个月后才显现。
装备制式编号的前缀全部取自真实的逻辑语词根，不是随手拼的字母：
| 编号 | 词根 | 源词 | 含义 |
|---|
CEL- | cel | cecla | 发射器 / 炮 —— 上游机炮 |
TCA- | tca | tcati | 火 / 炮 —— 下游机炮 |
SUT- | sut | sutra | 快 |
PEJ- | pej | preja | 扩散 / 播撒 |
GUS- | gus | gusni | 光 |
ZUN- | zun | zunti | 干扰 |
BAD- | bad | bandu | 防卫 |
CAV- | cav | carvi | 雨 |
DIL- | dil | dilnu | 云 |
完整对照表见游戏内资料库，或 世界设定集 7.6 节。
注意：逻辑语只用于书面与编号，不用于通话。没有一个飞行员能流利地说它——
它负责让文件不出错，不负责让人互相理解。
敌人在用消失的村庄名做呼号
下游航空军有一个违反常规的做法：飞行员用村庄名做呼号。
这些村庄全部位于调节场的降水负偏移区内，其中 4100 多个已经在统计上
"不再有稳定降水"。
当你的 RWR 上出现一个双机编队时，敌我识别会告诉你两个词：「沙口」和「干井」。
你不会在航图上找到它们。
项目结构
monsoon-line/
├── index.html 游戏入口（双击即可运行）：本地启动器，按语言重定向到对应的页面副本
├── CHANGELOG.md 更新日志（主菜单「更新记录」页读的就是它）
├── css/style.css 界面样式
├── locales/ 全部文本与页面
│ ├── _html/ 页面模板片段（与语言无关）
│ └── zh-CN/ text/（JSON 文本）· text.gen.js 与 index.html（生成的页面副本）
├── js/ 游戏代码：一个单位 / 一个关卡 / 一个界面一个文件，按层分目录
│ ├── core/ 数学、着色、注册表与标签、文本机制、版本戳与更新日志（生成）
│ ├── data/ 机型 / 武器 / 舰船 / 平台 / 设施 / 呼号 / 台词
│ ├── models/ 低多边形机体 / 水面舰船 / 地面目标几何
│ ├── missions/ 关卡的战场生成与触发器（一关一个文件）、战役
│ ├── engine/ 实体与飞行模型 / AI / 战斗 / 舰炮 / 航线 / 音效 / 挂载 / Game 的世界侧
│ ├── render/ 2D 与 WebGL 渲染、环境层、机库俯视识别图
│ ├── ui/ 平显、各屏界面、资料库、输入、相机、单位详情页
│ └── boot/ 主循环、开机自检、初始化
├── docs/ 文档（索引见 docs/README.md）
│ ├── DESIGN.md 总设计文档：架构、决策理由、已知问题
│ ├── VERSIONING.md 版本号规则
│ ├── world/ 世界设定（可脱离代码单独阅读）
│ └── systems/ 渲染 / 飞行模型 / 武器 / 挂载 / AI / HUD / 文本 / 页面等
└── tools/ test/（冒烟、快照、回放、探针）· build/（生成与发版）· render/（预览出图）· lib/
js/ 下的文件由 tools/build/gen-index.js 的层规则排序，按顺序用经典 <script> 标签加载（顺序写在各语言的页面副本里），
共享全局命名空间，因此无需任何打包工具。改了页面片段、文本或增删了 js 文件，跑一次 node tools/build/gen-pages.js。
技术说明
- 手写的 WebGL2 渲染：没有 Three.js，没有任何库。模型面、天空、海面、云和粒子
共用一个深度缓冲，着色规则在
shading.js 里只写一份；曳光与 HUD 画在 2D 画布上。
浏览器不支持 WebGL2 时退回原来的 Canvas 2D 管线（透视投影、近平面裁剪、画家算法排序）
- 画风：每个面一个颜色（flat shading），低多边形，距离大气透视
- 飞机姿态用正交基积分（罗德里格斯旋转）而非欧拉角，避免万向节锁
- 相机用位置 + 三个正交基向量而非矩阵
- 无任何外部资源：没有图片、没有音频文件、没有字体文件。音效全部由 WebAudio 实时合成
- 性能手段：每帧对象池、颜色量化缓存、屏幕面积极小的面剔除
文档
- 文档索引 —— 从这里进
- 更新日志 —— 从立项（v0.1.0）到现在的每一个版本。游戏里也能看：
主菜单 → 更新记录
- 版本号规则 —— 每一次改动怎么自己拿到版本号、
node tools/build/release.js 发一次版会做哪几件事
- 世界设定集 —— 可以脱离代码单独阅读：
世界线年表、调节场工作原理、四方势力、平流层作战、兵器谱系、术语表，
以及一节 「真实科学与虚构的边界」（明确区分哪些是真实大气科学，哪些是编的）
- 总设计文档 —— 面向要改这个项目的人：架构、模块划分、
关键决策的来龙去脉、已知问题清单
- 子系统文档 —— 渲染 / 飞行模型 / 武器 / 挂载 / AI / HUD / 音效等
开发
node tools/test/smoke.js
这是项目唯一的自动化测试：用最小 DOM / Canvas / WebAudio 桩把所有脚本
加载起来，跑一遍开机自检，逐个点击导航按钮，启动任务并推进 240 帧。
改完代码先跑它。
发一个新版本：
node tools/build/release.js vX.Y.Z
版本号由人指定（规则见 版本号规则）。脚本会把这一批提交
追加进 CHANGELOG.md，并刷新游戏读的 js/core/changelog.js 与主菜单上的版本戳。
剩下要你做的只有一件事：把生成的"待润色"标题改成一句人话。
游戏本身还有一层运行时自检（preflight()）：模块加载失败或数据引用了
不存在的模型/武器时，屏幕底部会弹出红色提示条列出问题。
如果你打开游戏后看到了红条，请把上面的内容提一个 issue。
文档在 docs/。改代码时请同步更新对应文档——
里面记的都是"为什么这么做"，不写下来就会在半年后被改回去。
状态
当前版本见更新日志。
- 13 个任务：战役「分水岭行动」12 关，加随机遭遇战役「第四周」1 关
- 6 架可驾驶机型（军舰鸟、旗鱼、鲣鸟、海燕、贼鸥、信天翁），另有 11 型敌方与勤务机
- 31 种可挂载的武器与吊舱，另有各方制式机炮与下游同盟的专用弹
- 16 艘水面舰船：四方的军船与勤务船，加上三个未参战国家停在这片海上的
民用与科学船。船与船之间会互射反舰弹，近防炮会拦截来袭导弹，
每条船有舰级与呼号。见 世界设定集 8.0.1 节
- 完整的 HUD 与雷达、电子战（干扰吊舱、EMCON、机体自带 ECM 与匿踪）、四方势力背景设定
- 资料库里的每个单位都能点进去看一页自己的详情：转子实时 3D 预览、
矢量俯视识别图、设定全文与完整参数表。见 单位详情页文档
已知问题清单见 设计文档第 8 节。
许可
GPL-3.0，Copyright (c) 2026 Xiwei Gao
本项目为完全虚构的作品。文中所有国家、组织、事件与人物均属架空设定，
与现实无关；出现的任何装备与技术细节不应被视为现实中的军事信息。
