Skip to content
Haruhi-LabsPublic

About

射手座之日 舰队对战游戏

Resources

Stars

9 stars

Watchers

0 watching

Forks

Repository files navigation

射手座之日 · The Day of Sagittarius

浏览器端的即时舰队对战游戏 —— 取材自谷川流《凉宫春日》系列中 SOS 团自制的同名游戏《射手座之日》。 强调「看得见才能打」的情报博弈与「集中 / 分散」的编队取舍,而非数值碾压。

▶ 正式站:https://star.haruyuki.cn · 测试站:https://haruyuki.cn/test-game/ · 公测版 v0.3


简介

你指挥一支三舰编队(1 主舰 + 2 副舰)在星海中迎战对手。通过走位、分离、技能与侦察压制,歼灭对方全部舰船(含主舰与副舰)即获胜。视野远小于射程,你常常看不见就被打、也能吊在敌人视野外输出——情报是获胜的关键。

玩法特色

  • 单人 vs AI:四档难度(简单 / 普通 / 困难 / 极限)。难度同时调整敌方数值、AI 反应速度与战术风格;极限难度的 AI 会智能集火残血。AI 会依据公开视野、雷达误差接触与历史动向组织搜索,长门旗舰可编组战斗僚机执行前沿任务,三味线旗舰则会组织猎杀突破或针对性护卫撤游。AI 通过大量对抗模拟逐项调校。
  • 在线对战与观战:基于 WebSocket 的实时 PvP,支持公开房、私人房、AI 训练房和对战观战;多人开战前有三秒倒计时。
  • 可选统一身份:游客无需登录即可完整游玩;登录后联机服务以主站签名票据确认账号昵称和头像,本地编队、阵营与设置仍留在游戏档案中。
  • 公开胜率统计:首页底部可进入单人/多人阵容榜,按公开游戏版本筛选,并按出场场次或胜率排序;对局档案与匿名玩家汇总仅在结算时异步写入,不进入实时快照链路。
  • 8 名角色:凉宫春日、阿虚、长门有希、古泉一树、朝比奈1096、朝仓凉子、鹤屋、三味线——每名角色在「主舰位」与「副舰位」拥有不同的主动或被动技能。
  • 机制深度:
    • 视野 ≪ 射程 —— 派侦察机开图、主力吊在敌方视野外输出;侦察机还能吸引火力。
    • 火力与朝向 —— 侧舷火力 ×1.5、船尾不开火;从敌方船尾命中造成 ×1.2 尾击(阿虚旗舰会均衡各方向火力密度,且各方向射速均 ×1.5)。
    • 分离取舍 —— 不分离时编队可分摊伤害、火力集中、共享能量池;分离后开火 ×1.2、获得独立视野、可释放分舰技、走位更灵活,但更脆弱、无法共同承伤、易被各个击破。
    • 碰撞与阻挡 —— 舰船有碰撞体积,相撞会减速;舰船会挡住中途的子弹,替后方承受伤害。
    • 速度与能量 —— 推进统一为 P 档和前进 1–4 档;P/1/2 档用于回能,3 档巡航并小幅回能,4 档超速并持续耗能。AI 也使用同一档位与能量规则,并会在低能量时主动降档恢复。
  • 独立新手教程:从单人游戏的战役菜单进入分步引导,不再与标准对战的首次进入状态耦合。
  • 公共更新日志:点击首页页脚版本号可进入 /changelog,按版本查看角色、规则与操作体验的更新内容。
  • 复古皮装界面:以「皮装星历名鉴」为主题的复古仿真 UI;角色选择是翻开一本古书。

操作(桌面端)

操作 作用
右键单击战场 创建航线目标(拖拽控制点微调曲线)
左键单击空白 在 3×3 地图中选择战区
1 / 2 / 3 切换 主舰 / 副一 / 副二
C / V 旗舰技 / 分舰技
X / Z 侦察 / 自动侦察
P · Shift+1–4 切换到 P 档 · 直接切换前进档位
Q / E 降档 / 升档
B · 滚轮 急刹 · 缩放镜头

移动端为触控布局,详见游戏内「玩法说明」。

本地开发

需要 Node.js ^20.19.0 || >=22.12.0(与锁文件中的 Vite 要求一致)。

npm ci
npm run dev          # 开发服务器(Vite)
npm run build        # 生产构建 → dist/
npm run preview      # 预览生产构建
npm run start:server # 启动联机 WebSocket 服务端
npm run test:logic   # 无浏览器的领域与契约测试
npm run test:browser # Chromium 界面与 WebGL 测试
npm run test:all     # 发布候选完整回归;构建另行执行
npm run test:core    # 仅运行规则、AI 与教程校验
npm run test:ai:simulation # 16 局固定种子双 AI 模拟对战

开发服务器使用根路径;npm run build 默认按隔离测试站 /test-game/ 基路径构建。正式站根路径构建使用 VITE_BASE=/ npm run build,其他子路径使用 VITE_BASE=/子路径/ npm run build。本地统一身份联调还需同时启动主站 news 前端(5204)与 Rust 后端(17777)。 网络容量压测独立运行 npm run test:network:load,不包含在日常 test:all 中。

多人协作:普通 PR → dev → 独立测试服;评估与明确指令 → 选择性晋级 PR → main → 人工审批部署正式服。发版与热更新、初始化条件见发布流程。

开发环境与交付方式见开发约定,按改动选测试及浏览器安装要求见测试与验收。纯文档修改不默认运行完整游戏回归。

技术架构

  • Vite 单页应用:单一 index.html + History 路由(src/router.js),干净无 .html 后缀的 URL。每个路由是一个可挂载模块(mount(root) → 返回 unmount()),切换路由时统一停渲染循环 / 断 WebSocket / 移除监听。
  • 规则内核(单一事实来源):shared/game-core.js 保留稳定入口,角色、规则、推进能量、数学工具和 AI 分别位于 shared/game/。单人模式在浏览器本地运行这套权威模拟,多人模式在服务端运行同一套模拟;在线客户端只发送标准动作并显示权威快照,不维护第二份战斗规则。
  • 统一动作、时钟与显示插值:shared/protocol/match-actions.js 定义单人/多人共用动作,src/battle/action-transport.js 只区分本地或远程传输;单人和服务端共用固定 30Hz 逻辑时钟,单人逻辑帧与多人 15Hz 快照都通过 src/battle/state-interpolation.js 生成平滑显示状态,且从不写回权威模拟。
  • 规则版本保护:shared/protocol/ruleset-version.js 在客户端与服务端之间协商规则版本。显式版本冲突会阻止进入对局;未声明版本的旧端暂时走兼容模式。
  • 联机服务端:server/server.js(基于 ws)只负责编排连接和消息;房间注册、生命周期、输入队列、比赛循环与快照流已拆到 server/ 下的独立模块。
  • 可选身份链路:src/identity.js 使用 Authorization Code + PKCE 建立游戏站独立 HttpOnly 会话;server/game-identity.js 只用 Ed25519 公钥校验 60 秒联机票据并防止 jti 重放。认证失败自动保留游客协议,当前不绑定排行榜、成就或统计。
  • 统计归档:server/statistics-store.js 以按月 JSONL 追加日志作为事实来源,在内存中缓存公开阵容聚合;shared/game/match-telemetry.js 只维护常数级计数器,且统计字段不会进入 serializeState() 或网络快照。
  • 渲染:战场由原生 WebGL2 直接绘制,使用批量弹体、GPU 三角形与有界字形/立绘纹理缓存;不支持 WebGL2 的设备使用同源 WebGL1 后端,仅在 WebGL 完全不可用时保留 Canvas 2D 可用性兜底。菜单与普通页面仍按各自现有 DOM/Canvas 实现。

详细依赖方向、权威边界、修改定位表和验证要求见 docs/architecture.md;测试站发布、正式站隔离与回滚约定见 docs/operations.md。

项目结构

index.html            SPA 外壳
src/
  main.js             装载样式 + 注册路由 + 启动
  router.js           History 路由
  menu.js             主菜单(首页)
  changelog.js        公共更新日志页面(版本内容与元数据在 changelog/)
  statistics.js       单人/多人阵容胜率榜页面
  statistics-client.js 结算单次上报与榜单单次请求
  solo.js             单人对战
  online.js           在线对战页面编排(快照显示状态在 online/state-sync.js)
  character-select.js 翻书式角色选择(立绘在 character-select/portraits.js)
  battle/             单人/联机共用相机、输入、HUD、显示插值与渲染(专项效果位于 render/,原生 GPU 后端位于 webgl/)
  i18n/               日英词典与角色文本
  changelog/          当前版本元数据与多语言版本更新数据
  tutorial.js         新手引导教程
  guide.js / credits.js / profile.js …
shared/
  game-core.js        游戏规则兼容入口与模拟编排
  game/               角色、规则、推进能量、视野/雷达、固定时钟、数学工具与 AI
  protocol/           标准战斗动作与规则版本协商
server/               房间、输入队列、权威循环、协议、快照流与对局统计归档
scripts/              核心、联机、网络与模块边界校验
AGENTS.md             项目底线与按需文档入口
docs/                 开发、架构、测试与发布运维约定

制作人员

  • 画师:橙海
  • 开发:春日しゅぎ
  • 设计:春日しゅぎ · syd · 可能是寂寞
  • 出品:凉宫春日应援团超能力者组 · 凉宫春日应援团开发组

许可证

本仓库中由项目贡献者持有版权的源代码与其他原创内容采用 GNU Affero General Public License v3.0 only(AGPL-3.0-only) 许可,完整条款见 LICENSE。

如果您修改本项目并通过网络向用户提供交互服务,须依照 GNU AGPL v3 第 13 条向这些用户提供对应版本的完整源代码。角色、世界观及第三方素材仍归各自权利人所有,不因本项目的软件许可证而获得额外授权。

版权与致谢

本作为非商业同人作品,取材自谷川流《凉宫春日》系列;角色、世界观与《射手座之日》设定的版权归原作者及相关版权方所有,本项目与版权方无任何关联。仅供学习交流与粉丝同好娱乐使用。

About

射手座之日 舰队对战游戏

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages