夜巡录：荒庙篇

《夜巡录：荒庙篇》是一个志怪题材的卡牌构筑 roguelike demo。你扮演游方夜巡人，带着半枚城隍印走进永宁县外的荒庙夜路，用符箓、剑诀、香火和奇物，在分岔路线里拼出一套能活到天明的牌组。

当前版本是第一关竖切 demo：可以从标题页进入地图，经历普通战、精英战、怪事、商店、休整，最终挑战荒庙正殿的 Boss。

下载试玩

桌面客户端会发布在 GitHub Releases：

https://github.com/op7418/Night-Patrol/releases

当前计划提供：

• macOS Apple Silicon 测试包
• Windows x64 测试包

macOS 版本目前是 demo 阶段的 ad-hoc 签名包，没有 Apple 公证。如果系统提示“无法验证开发者”，请右键点击应用，选择“打开”，再确认一次。

游戏特色

• 志怪与修行题材：荒庙、城隍印、符箓、香火、阴市、山君。
• 类《杀戮尖塔》的核心循环：走路线、打战斗、拿新牌、拿遗物、删牌升级、滚动构筑。
• 拖拽出牌：攻击牌拖向怪物，技能和法门拖向自己。
• 卡组循环：抽牌、回卷弃牌堆、能量补偿、符印爆发和香火成长互相配合。
• 完整第一关：普通怪、精英、Boss、事件、休整、商店和战利品界面。
• 视听演出：React + Phaser 战斗舞台、敌人大立绘、背景音乐、攻击音效、胜利结算视频。

基础玩法

战斗中每回合获得能量并抽牌。玩家可以用攻击牌造成伤害，用技能牌获得格挡、抽牌或施加状态，用法门牌建立长期能力。

核心机制：

• 符印：施加在敌人身上的标记，可以持续结算，也可以被特定卡牌引爆。
• 香火：战斗内临时资源，用来支撑请神、雷法和爆发牌。
• 格挡：抵消当回合伤害。
• 法门：打出后在本场战斗持续生效。
• 遗物：改变开局、抽牌、伤害、防御或资源节奏。

构筑目标不是拿单张最强牌，而是让牌组循环起来：抽得更多、费用更顺、弃牌能回卷、符印能叠高并爆掉。

操作方式

• 鼠标拖拽卡牌到目标身上出牌。
• 攻击牌拖到敌人区域。
• 技能牌和法门牌拖到玩家区域。
• 点击“结束回合”进入敌人回合。
• 地图界面点击可选节点前进。
• 顶部按钮可以回首页、静音或重新开始。

当前内容

• 1 名角色：游方夜巡人。
• 20 张左右卡牌。
• 多个敌人：灯笼精、披蓑水鬼、庙祝尸、山魈、黑坛术士、画皮影、山君。
• 关键词与状态：符印、香火、格挡、虚弱、易伤、法门、消耗。
• 地图分岔路线。
• 普通战、精英战、Boss 战。
• 怪事、阴市商店、休整、删牌、升级。
• 卡牌奖励、金币奖励、遗物奖励。
• 背景音乐、攻击音效、技能音效和 UI 音效。
• 战斗胜利结算视频与静态 fallback。
• 难度选择：演示、标准、劫难。

技术栈

• React 18：复杂 UI、卡牌、地图、事件、商店、奖励和结算界面。
• Phaser 3：战斗舞台、背景、角色、怪物、雾气粒子、受击摇晃和镜头震动。
• TypeScript：游戏状态、卡牌、敌人、遗物和事件类型。
• Vite：开发服务器和前端构建。
• Electron：桌面客户端打包。
• GitHub Actions：macOS 与 Windows 客户端自动构建。

本地开发

安装依赖：

npm install

启动开发服务器：

npm run dev

然后访问终端里显示的地址，通常是：

http://127.0.0.1:5173

客户端打包

本地客户端预览：

npm run desktop

生成本机客户端目录：

npm run desktop:pack

生成正式安装包：

npm run desktop:dist

产物会输出到 release/。

GitHub CI 打包方式：

git tag v0.2.1-demo
git push origin v0.2.1-demo

推送 tag 后，GitHub Actions 会构建 macOS 和 Windows 包，并附加到 GitHub Release 页面。

项目文档

• docs/PLANNING.md：早期玩法与世界观规划。
• docs/FIRST_ACT_DEMO_ROADMAP.md：第一关完整 demo 路线图。
• docs/IMPLEMENTATION_DETAILS.md：实现细节和 AI 协作复盘。
• docs/PACKAGING_DISTRIBUTION.md：客户端打包、Release、物料和运营方案。

版权与授权

《夜巡录：荒庙篇》由歸藏 × Codex 联合开发，仅供娱乐、学习和非商业展示。

除另有说明外，本项目采用 CC BY-NC 4.0 授权：允许非商业分享和改编，但必须署名，不得移除作者信息，不得用于售卖、广告导流、商业试玩包、应用商店上架或其它商业分发。

推荐署名：

《夜巡录：荒庙篇》，由歸藏 × Codex 联合开发。

完整声明见 LICENSE 与 NOTICE.md。

素材说明

本项目为个人学习与原型展示 demo。部分视觉素材来自用户下载素材包并经过筛选整理，部分为 AI 生成素材。若后续进入正式公开发行或商业化阶段，需要重新确认所有素材授权或替换为自有资产。

当前状态

这是一个正在打磨中的 demo。它已经能完整跑通第一关，但仍有后续优化空间，例如正式图标迭代、视频体积压缩、更多事件演出、更多卡牌平衡和正式代码签名。