Stronghold-Protocol - 明日方舟自走棋塔防同人复刻

项目说明

卫戍协议：盟约 · Stronghold Protocol: Alliance

《明日方舟》季节性自走棋塔防玩法「卫戍协议：盟约」的非官方同人复刻：浏览器即开即玩，单人或 1–4 人联机合作。

!
!license
!node

声明

> [!IMPORTANT]
> - 本项目是玩家自制的非官方同人作品，与上海鹰角网络科技有限公司（Hypergryph）、Yostar 及其关联方没有任何关系，未获其授权或认可。
> - 《明日方舟》及「卫戍协议」相关的名称、角色、美术、音乐、音效、文本与数据等素材，版权归原权利人所有。这些素材不适用本项目的 GPL-3.0 许可证；GPL 只覆盖本项目自己编写的代码。
> - 仅供学习交流与个人非商业使用。严禁任何形式的盈利，包括但不限于：售卖本项目或整合包、付费下载或付费分发、收费服务器或收费代开、广告 / 打赏 / 会员等变现方式，以及其他任何商业用途。
> - 仓库源码不包含游戏的美术与音频素材（只有由官方数据表生成的数据和几张游戏截图，同样不适用 GPL）；Releases 中的整合包为了方便玩家附带了素材，下载即视为同意本声明。请勿将素材用于本项目以外的用途或单独再分发。完整条款见 NOTICE.md。
> - 权利人如认为本项目侵犯其权益，请通过 Issue 联系，我们会立即删除相关内容。
> - 本项目按「现状」提供，不提供任何担保，使用风险自负。

English summary: below.

| 同盟房间 | 策略轮选 | 休整期（商店 / 盟约） |
|---|---|---|
| !房间 | !策略 | !休整期 |
| 部署方向轮盘 | 作战 | 最终攻势 |
| !方向 | !作战 | !最终攻势 |

目录

简介

「卫戍协议：盟约」是自走棋 + 塔防：休整期在调度中心招募干员、摆阵、配装备，作战期干员自动部署，迎击从红门涌来的敌人，漏过去的敌人扣目标生命值。本项目在浏览器里复刻了这一玩法，规则和数值尽量对照官方数据表与 PRTS 核对。

功能一览

快速开始

方式一：整合包（推荐）

整合包里已经包含代码、运行依赖和全部美术 / 音频（含官方 3D 棋盘贴图），解压就能玩，不需要再下载任何东西。

1. 安装 Node.js 22 或 24（LTS）
- Windows：在 PowerShell 里运行 winget install OpenJS.NodeJS.LTS，或到 < 下载安装包。
- macOS：brew install node@22，或到官网下载安装包。
- Linux：发行版的包管理器、nvm 或 fnm。
2. 下载：在 Releases 页面下载最新版本（v0.1.3）的整合包（zip），解压到一个路径较短的文件夹（Windows 上建议不要放在 OneDrive 同步的目录里）。
3. 启动
- Windows：双击 scripts\start-windows.bat。如果弹出「安全警告」，点「运行」；Windows 防火墙弹窗请勾选「专用网络」并允许。
- macOS / Linux：在解压出的文件夹里运行 ./scripts/start.sh（或 bash scripts/start.sh）。
4. 浏览器会自动打开 。窗口里列出的局域网地址可以直接发给同一网络的朋友。关闭窗口（或按 Ctrl+C）即停止服务器。

方式二：从源码运行

也可以直接运行启动脚本（Windows scripts\start-windows.bat，macOS / Linux scripts/start.sh）：首次会自动安装依赖、下载素材，然后启动服务器并打开浏览器。

系统要求

| 项目 | 要求 |
|---|---|
| 开服的电脑 | Windows / macOS / Linux，Node.js 22 或 24（LTS）；磁盘约 400–500 MB（素材、依赖与可选的本地提取贴图）；内存空闲约 100 MB，每局再加几 MB |
| 玩家 | 支持 WebGL 的现代浏览器（Chrome / Edge / Firefox / Safari 最新版），电脑、手机或平板（横屏） |
| 网络 | 首次进入游戏时，每位玩家要从开服的电脑下载几十 MB 素材（之后走浏览器缓存）；对局中流量很小 |

显卡较弱时可以在「设置」里调低画质，或在网址后加 ?board=2d（强制 2D 棋盘）/ ?render=fallback（不用 WebGL 的简化画面）。

端口与配置

默认监听 TCP 3000。换端口：启动脚本加 --port 3001，或设置环境变量 PORT。

| 环境变量 | 默认 | 说明 |
|---|---|---|
| PORT | 3000 | 监听端口 |
| HOST | 0.0.0.0 | 监听地址（127.0.0.1 = 只允许本机，放在反向代理后面时使用） |
| SP_COMBAT | client | client：各玩家浏览器模拟自己的战斗（服务器负载极低）；server：由服务器模拟并推流 |
| SP_ | off | 服务器复算客户端上报的战斗结果：off / sample（约 1/8 抽查）/ all（全部复算，更耗 CPU） |
| TRUST_PROXY | auto | 是否信任 X-Forwarded-For 等转发头：auto 只信任来自本机 / 内网的代理；1 总是；0 从不 |
| DEBUG | 空 | 设为任意值输出详细日志 |
| SP_NO_BROWSER | 空 | 设为 1 时启动脚本不自动打开浏览器 |

设置方式：macOS / Linux PORT=8080 npm start；PowerShell $env:PORT=8080; npm start；cmd set "PORT=8080" && npm start。健康检查：GET /healthz。

和朋友一起玩（局域网）

1. 打开页面 → 输入昵称 → 同盟模拟 → 创建房间。房主选择难度，可以添加 / 移除 AI 队友；开始前也可以把其他博士移出房间（对方可凭密钥重新加入）。
2. 把 4 位字母的同盟密钥，或「复制链接」得到的 发给朋友。
3. 所有人点「准备就绪」后房主开始。
4. 同一 Wi-Fi / 路由器下的朋友打开启动窗口里列出的地址（形如 ）即可。打不开时多半是防火墙：Windows 首次启动时在弹窗中允许「专用网络」，或运行 npm run doctor 查看具体命令；访客 Wi-Fi 常开启「AP 隔离」，也会导致连不上。

刷新页面或断线后，同盟模拟 10 分钟内、独立模拟 24 小时内重新打开即可回到原座位。服务器把房间和对局都保存在内存里，重启服务器会结束所有对局。

联机方式

朋友不在同一个局域网时，下面是几类常见做法，按自己的情况选一种即可。这里只做简单介绍，提到的工具和服务只是举例，本项目与它们没有任何关系，也不做推荐；具体的安装、费用和使用规则请以各自的官方说明为准。部署细节（防火墙、开机自启、反向代理与 HTTPS、Docker）见 docs/DEPLOY.md。

| 方式 | 怎么做 | 适合 |
|---|---|---|
| 同一局域网直连 | 把启动窗口里的局域网地址发给朋友 | 同一个家、宿舍或网吧 |
| 组网工具（虚拟局域网） | 例如 Tailscale、ZeroTier、EasyTier、蒲公英：开服的人和朋友都安装同一个工具并加入同一个网络，朋友用开服电脑的虚拟 IP 访问 IP>:3000 | 固定的几个熟人；不暴露到公网。朋友也要装客户端，部分工具需要注册账号；跨地区时可能走中继而变慢 |
| 内网穿透 / 隧道 | 只有开服的人运行客户端，朋友直接打开网址。例如自建的 frp（需要一台有公网 IP 的服务器）、Cloudflare 的 cloudflared tunnel --url （临时地址，每次启动都会变；国内访问延迟可能较高）、国内的樱花 frp 一类公共穿透服务（通常需要实名，大陆节点承载网页可能有备案要求） | 不想改路由器、没有公网 IP；免费线路带宽小时，首次加载素材会慢一些 |
| 云服务器 / VPS 直接部署 | 在 VPS 上运行整合包，或用仓库自带的 Dockerfile；用 Caddy / Nginx 加上 HTTPS。选离玩家近、线路好的地区（面向大陆玩家时，境外机房要关注回程线路，否则晚高峰延迟可能很高；大陆服务器绑定域名需要 ICP 备案） | 想长期开服、玩家分布在不同地区 |

通用注意事项：

操作

| 操作 | 方法 |
|---|---|
| 购买 / 升级调度中心 / 机变选卡 | 点一次选中，再点一次确认（D 升级） |
| 部署 / 移动干员 | 从整备区拖到棋盘格 → 出现方向轮盘 → 往上 / 右 / 下 / 左滑动选择朝向后松手；松在中心或点「✕ 点击取消」取消。拖动时模型在指针 / 手指下，指针所在的格子就是落点 |
| 调整朝向 | 把干员拖回它自己的格子，再选方向 |
| 出售 / 撤退 / 销毁装备 | 点击单位所在的格子 → 底部按钮「出售 +1」「撤退」；也可以把棋盘上的干员拖回整备区撤退。整备区里的装备与法术只能「销毁」，已配发的装备锁定在干员身上（干员出售或合成精锐时退回整备区） |
| 装备 | 把装备拖到干员所在的格子上（每人 2 件；满了会弹出替换窗口，被替换的一件会被销毁）；法术拖到地块上并选方向 |
| 查看详情 | 右键或长按单位 / 卡牌（属性为实时数值，高于基础值为绿色、低于为红色） |
| 快捷键 | R 刷新 · F 冻结 · D 升级 · Space 准备就绪 · Esc 取消 / 关闭 |
| 方向轮盘键盘操作 | 方向键预览 · Enter 确认 · Esc 取消 |
| 暂停（独立模拟） | 作战中（含最终攻势 / 隐秘核心）点顶栏的「暂停」或按 Space，再点「继续作战」（或 Space）继续；同盟模拟的作战不能暂停 |
| 表情 | 左下角「交流」，左右滑动（或方向键）换主题，冷却 1 秒 |
| 观战 | 自己的作战结束后（或休整期）点左侧队友头像 →「前往查看」；不参战的朋友可以在大厅输入同盟密钥点「观战」（每个同盟最多 2 名观战者，本作新增） |

完整的规则、数值和小技巧见 docs/PLAYING.md（游戏内左下角也有「玩法说明」）。

文档

| 文档 | 内容 |
|---|---|
| CHANGELOG.md | 更新记录：每个版本修复了什么、哪些反馈经核实不是问题 |
| docs/PLAYING.md | 玩法指南：流程、经济、招募与晋升、摆阵、联防、盟约、最终攻势、结算称号 |
| docs/DEPLOY.md | 部署指南：Windows 开服与开机自启、防火墙、组网 / 隧道、反向代理与 HTTPS、Docker、systemd、排错 |
| docs/WINDOWS.md | Windows 便携包：怎么打一份「零安装」包（scripts/make-windows-bundle.mjs）、包里放了什么、授权注意事项 |
| docs/DESIGN.md | 架构与契约（英文）：技术栈、目录分工、网络协议、渲染与 UI、各次试玩后的规则修订 |
| docs/SIM.md | 战斗模拟引擎参考（英文）：钩子、技能描述格式、职业默认行为 |
| docs/META.md | 对局与经济引擎（英文）：回合流程、商店、联防、最终攻势的实现细节 |
| docs/DATA.md | 由官方数据表生成的游戏数据（英文） |
| docs/ASSETS.md | 素材来源、目录结构与清单（英文） |
| docs/BALANCE.md | 难度模型与测量（英文） |
| docs/research/ | 官方规则、数据与界面的调研记录 |

开发与测试

项目结构

| 路径 | 内容 |
|---|---|
| server/ | Node HTTP 静态服务 + WebSocket（/ws）、大厅、对局引擎（match/）、战斗模拟（sim/，浏览器与服务器共用） |
| shared/ | 前后端共用的常量与网络协议 |
| public/ | 浏览器客户端（原生 ES 模块，PixiJS + pixi-spine、three.js 3D 棋盘、Preact + htm UI） |
| data/ | 由官方数据表生成的游戏数据与素材清单 assets.json |
| tools/ | setup.mjs / doctor.mjs、素材下载 fetch-assets.mjs、数据构建、本地提取 local-extract/ |
| scripts/ | 启动脚本（Windows / macOS / Linux）、Windows 开机自启 |
| docs/ | 文档与调研 |
| test/ | node:test 测试 |

许可证

致谢与数据来源

感谢以上项目的作者与维护者，以及鹰角网络带来的这款游戏。

贡献

欢迎提 Issue 反馈 bug、与官方规则不一致的地方或改进建议，也欢迎提交 Pull Request：

---

English

An unofficial, non-commercial fan remake of Arknights' seasonal auto-象棋 tower-defense mode *Stronghold 协议: Alliance*, played in the browser: solo, or 1–4 player co-op (AI teammates can fill seats). Combat is simulated in each player's browser, so a low-power PC can host.

技术栈

开发语言：未知

项目类型：明日方舟自走棋塔防同人复刻

Star 数：0

功能特点

这是一套明日方舟自走棋塔防同人复刻，代码结构清晰，适合开发者学习手机游戏的客户端渲染、服务端逻辑、网络通信与资源管理。项目涵盖了游戏的核心玩法、场景管理、角色与地图系统等模块，对理解手游的完整开发流程具有较高的参考价值。

从技术实现角度看，手游项目的难点在于：客户端与服务端的协议同步、资源热更新、场景切换与状态管理、以及多端适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / C# / PHP / Cocos / Unity 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入手游开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到手游的核心玩法实现、网络协议设计、场景与资源管理、以及游戏状态同步等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了手游项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整手游项目的架构，对后续开发其他实时对战类游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。