# tang

**Repository Path**: caocaoca3/tang

## Basic Information

- **Project Name**: tang
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-29
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 裂土：唐末五代沙盘

唐梁易代题材的单人策略游戏。2026-10-29 起，主工程改为 **Cocos Creator 3.8.6 / TypeScript**，玩法参考《三国群英传》的武将治城、编军行军和横版交战。原 C++ / SDL3 客户端保留为规则与资产参考，停止作为主客户端扩展。

## 打开主工程

1. 在 Cocos Dashboard 使用 Creator **3.8.6** 打开仓库内的 **`cocos/` 文件夹**，等待资源导入和脚本编译。
2. 打开由编辑器保存的 `cocos/assets/scenes/Boot.scene` 并预览。场景与组件引用通过运行中的 MCP 保存、回读与诊断，不手工编造 UUID。
3. 从“新的征途”进入：主菜单 → 剧本 → 势力 → 开局确认 → 天下。进入天下默认暂停，选城安排内政或编军，再点击一倍速推进。

当前迁移包含 `Campaign.ts` 独立规则与 `GameApp.ts` 界面代码；真实预览与验收证据见 `production/qa/`，没有证据的项目不视为通过。Windows 原生安装包尚不属于本轮交付。

## 已接入的研发工具

- [Claude Code Game Studios](https://github.com/Donchitos/Claude-Code-Game-Studios)：本地 `.claude/` 是主导研发流程，producer 管范围/状态，game-designer 管玩法/流程，程序员按 story 开发，QA 验证后关单。采用 `minimal`，先完成可玩闭环。来源与本地适配见 [工作室接入说明](docs/studio-integration.md)。
- [Funplay Cocos MCP](https://github.com/FunplayAI/funplay-cocos-mcp)：工程扩展位于 `cocos/extensions/funplay-cocos-mcp/`，实际版本 0.6.9；Creator 3.8.6 的本地服务端口为 20547，已健康并已注册到 Codex。当前会话也可用 [scripts/cocos_mcp.py](scripts/cocos_mcp.py) 调用接口；先运行 `python scripts/cocos_mcp.py --help` 查看实际参数。

Codex 按 `AGENTS.md` 读取同一套角色与技能，并使用实际可用工具执行。Claude 专用 slash 命令、hooks、模型与 Agent 工具不会自动成为 Codex 功能；接入工作室不表示调用了 Claude 服务。

## 当前玩法范围

- 907 年四月，朱晃即位后的纵切片；有独立身份、证据链与据点的势力开放试玩，其余台账条目可查但禁用开局。
- 城池开发、募兵、练兵与出征共用空闲武将；真实驻军编军、按日行军，按月结算钱粮与简化 AI。
- 步/骑/弓编成；玩家进攻或防守进入横版聚合战斗，支持暂停、进军/坚守、技力与冷却约束的破阵、撤退和战后回写。
- 双方独立的通商、互不侵犯、宣战、议和、简化还价与期限。初始中立是测试设定，尚非全量史实关系。
- Cocos JSON 存档、三个档位与浏览器导入/导出；旧整数索引存档须识别版本后显式迁移，不承诺自动无损兼容。
- 六折开场演义、插画、字幕与旁白资产继续保留；暂停、静音、跳过和重播入口迁入新界面。

当前是迁移 MVP。战场用少量示意兵呈现聚合兵力，尚非千人独立单位模拟；完整兵种克制、阵形、攻城、人物登用、全历史剧本与成熟战略 AI 均需后续制作。完整原生包、设备音频和性能以独立验证结果为准。

## 设计与历史数据

- [现行设计简报](design/game-brief.md)：本轮方向、实现边界与制作顺序。
- [界面与玩法规划](docs/migration/cocos-ui-and-gameplay.md)：完整页面流程、暂停规则、信息层级、首轮验收。
- [冲突处理记录](docs/migration/conflict-resolution.md)：已提交冲突的来源、保留决定、旧存档限制。
- [Cocos MCP 安装记录](docs/migration/cocos-mcp-installation.md)：固定版本、Codex 注册、桥接与验证范围。
- [原始游戏策划案](游戏策划案.md)：原文保留；引擎与战斗方向以本轮简报为准。
- [907 台账](data/907_faction_ledger.csv) 与 [复核记录](data/907_review_notes.md)：逐镇身份、在任者、证据和争议。

`907_nodes.csv` 的 35 个节点是玩法锚点与测试值，不是历史疆界或已核实人口。边地“未见明确控制”不代表无人居住。夷州自建势力只获得一个沿海据点，其他本地人口与社群仍存在；航运实现前无法无条件跨海。

## 开发与验证

主代码在 `cocos/assets/scripts/`；`core/` 不依赖 `cc`，用于独立规则回归。引擎版本见 `docs/engine-reference/cocos/VERSION.md`，制作状态见 `production/session-state/active.md` 与 `production/epics/cocos-migration/`。

在仓库根目录执行：

```powershell
# 导出当前台账与美术音频，并检查独立规则和旧存档转换
.\scripts\build-cocos.ps1 -TestOnly

# 使用 Creator 3.8.6 构建 Web 桌面包（会先导出资源并运行测试）
.\scripts\build-cocos.ps1 -Platform web-desktop

# 只重跑已有资源上的规则/存档测试
node --preserve-symlinks --preserve-symlinks-main scripts/test-cocos.cjs

# 启动本地试玩，浏览器打开 http://127.0.0.1:8027/
.\scripts\preview-cocos.ps1
```

构建脚本默认使用本机 `C:/ProgramData/cocos/editors/Creator/3.8.6/CocosCreator.exe`；其他安装位置用 `-Creator` 指定。测试使用该 Creator 自带 TypeScript；可用 `COCOS_TYPESCRIPT` 指定 `typescript.js` 的完整路径。Web 输出在 `cocos/build/web-desktop/`，通过 HTTP 服务打开，不能把双击 `index.html` 视为运行验证。当前已有 Web 构建成功日志和输出；原生 Windows 构建尚未验证。玩家可见改动仍需真实预览、实际输入和截图，不能只凭构建成功或 MCP 健康检查判定 UI 验收通过。

已知的旧版 `LTFY 1`、16/27 区布局可以显式转档：

```powershell
node --preserve-symlinks --preserve-symlinks-main scripts/convert-legacy-save.cjs old.sav converted.json
```

输出必须是新文件，原存档和已有输出都不覆盖。转换保留可映射的兵力、开发、钱粮和月份；人口/产粮重基为当前剧本，旧版未存的武将、外交和种子采用新初值，未存工程归零。报告写入战史；未知布局拒绝转换，不承诺无损升级。

旧 C++ 参考可使用 `scripts/build.ps1 -Test` 回归；当前 CMake 默认只构建纯规则 core，SDL 客户端需显式启用，详见构建脚本与 CMake 选项。常规回归复用 `build/vcpkg_installed` 现有依赖。旧菜单、音频与演义源码及资源仍在仓库中，不表示它们已经全部接回默认 C++ 可执行文件。