黑域协议 / BLACK SIGNAL

可直接在浏览器运行的单机 3D 战术搜打撤 FPS 纵向切片。核心循环为：

大厅整备 → 交易/改枪 → 进入灰港 → 搜索露天物资和容器 → 交战/Boss → 撤离 → 战利品入库

启动

npm install
npm run dev

浏览器打开终端给出的本地地址。生产构建使用：

npm run build
npm run preview

战局操作

按键	功能
W A S D	移动
Shift	冲刺
Ctrl / C	蹲伏
鼠标左键	射击
鼠标右键	瞄准
R	换弹
F	拾取、搜索容器、刷房卡
Tab	战术背包与保险箱
G	F1 破片手雷
V	M84 震撼弹
X	V-9 烟雾弹（会阻断敌人视线）
Q	脉冲扫描技能
H	使用医疗包
J	使用手术包修复坏死肢体
5	注射肾上腺素
Esc	暂停

大厅整备操作

• 在“战备”中把中央仓库的装备直接拖到 9 个真实装备槽；绿色槽位可投放，红色槽位不兼容。
• 已装备物品可拖回中央仓库卸下，也可单击快速卸下；“自动配置”保留为触屏/键盘备用操作。
• 在“改枪台”中先选择任意已装备或仓库枪械，再把兼容配件拖到枪口、瞄具、前握把、弹匣、枪托、握把、激光或枪管接口。
• 已安装配件可以拖回配件仓库卸下。每次变更都会自动写入本地存档。

已实现系统

• Three.js 第一人称战斗、阴影、雾效、程序化材质与工业区地图
• 玩家实体碰撞；玩家和敌人弹道均采用墙体首碰撞判定
• 敌人视线、巡逻、追击、射击、不同护甲等级和 Boss 半血增援
• 头/胸/腹/手臂/腿分区生命、头甲耐久、医疗、针剂和手术
• 破片雷、震撼弹、烟雾弹；烟幕会动态截断 AI 视线
• 露天战利品、工具箱、医疗箱、武器箱、上锁保险库和 Boss 专属掉落
• 北向固定小地图、撤离点、Boss/扫描标记和六秒撤离读条
• 80+ 数据驱动物品：枪械、配件、1–6 级弹药、1–6 级头甲、胸挂、背包、耳机、医疗、针剂、手术包、房卡、保险箱、收集品
• 动态交易行、商人库存、中央拖拽仓库、9 槽自由战备、保险箱、8 接口拖拽改枪台
• 任务、技能经验、撤离统计与 localStorage 自动存档
• Web Audio HRTF 3D 环绕：枪声、脚步、命中、爆炸、开箱、医疗和 UI 音效均为程序化合成

主要源码

• src/game.ts：游戏循环、战斗、AI、UI 和搜打撤流程
• src/world.ts：地图生成、碰撞、遮挡、出生和撤离数据
• src/data.ts：物品、商人、任务、技能和掉落表
• src/state.ts：仓库、市场、装备、改枪、任务及存档状态
• src/audio.ts：程序化 HRTF 3D 音频