| .. | ||
| ai-collab | ||
| 技术文档 | ||
| 设计文档 | ||
| 需求文档 | ||
| .DS_Store | ||
| .tmp_balance_excerpts.txt | ||
| README.md | ||
| 协作约定.md | ||
| 部署指南.md | ||
洪荒大陆 · 挂机手游 · 文档中心
游戏名（暂定）：洪荒大陆 类型：文字战斗 / 挂机 / 修仙 RPG 平台：Android、iOS、鸿蒙 NEXT 当前阶段：游戏设计阶段 — 暂停技术实现 最后更新：2026-07-01
阶段说明：本项目当前处于设计文档定稿期。用户已明确要求，在宣布进入下一阶段前不做技术实现。已生成的代码骨架（
server/、client/、api/、database/、configs/、docker-compose.yml等）仅作为设计阶段产物保留，不继续开发、不新增业务逻辑、不提交生产代码。
文档目录
设计文档（GDD）
📌 决策编号已归一：所有决策以 GDD-00 决策总索引 为单一事实源。核心决策
✅1–99（GDD-02 权威）；地图域✅D/✅Q（GDD-08）；各文档本地✅N跨文档引用须带前缀（如GDD-05 ✅8）。🤝 多智能体协作：并行编辑前必读 协作约定（CONTRIBUTING）——文档归属软锁、开工前读最新、决策只追加不重排、合并裁决以 GDD-00 为权威。
| 编号 | 文档 | 状态 | 最后更新 |
|---|---|---|---|
| GDD-00 | 决策总索引 | ✅ v2.1（新增✅147~✅156；决策编号顺延至✅157；GDD-29邮件系统标注为子模块） | 2026-07-03 |
| GDD-01 | 种族系统设计 | ✅ v2.12（术语对齐天启；文化三要素） | 2026-07-03 |
| GDD-02 | 底层核心机制设计 | ✅ v4.2（善恶值/作恶值/业力层级关系明确；术语对齐天启） | 2026-07-03 |
| GDD-03 | 战斗系统设计 | ✅ v2.2（PVP善恶值体系简化✅44；术语对齐天启） | 2026-07-03 |
| GDD-04 | 功法系统设计 | ✅ v1.12（术语对齐天启） | 2026-07-03 |
| GDD-05 | 职业与生活技能设计 | ✅ v1.18（术语对齐九大境界） | 2026-07-03 |
| GDD-06 | 经济系统设计 | ✅ v1.15（货币体系内部全面对齐✅154；§5/§11/§13/§2.4旧货币清除） | 2026-07-03 |
| GDD-07 | 帮派 / 门派 / 社交系统设计 | ✅ v2.5（弟子策略模板与自主性5级体系） | 2026-07-03 |
| GDD-08 | 大陆地图与区域开放系统 | ✅ v1.10（天启pity✅D20；术语对齐天启） | 2026-07-03 |
| GDD-08-附录A | 各层地图挂机资源 | ✅ v1.4（体力残留清理；资源效果改为按种族能量名称恢复能量） | 2026-07-01 |
| GDD-08-附录B | 各种族境界名称总表 | ✅ v2.0（扩展为9个大境界，每个大境界5-7个小境界，增加修炼深度；新增天启机制、突破命名体系、种族突破命名） | 2026-07-01 |
| GDD-09 | 种族出生地与新手区域设计 | ✅ v1.7（出生地事件轮播+环境叙事；术语对齐天启；章节编号修正） | 2026-07-03 |
| GDD-10 | 隐藏天赋完整表 | ✅ v1.4（子妖种独立隐藏天赋池、残响继承规则、掌握条件获取途径） | 2026-06-30 |
| GDD-11 | 种族转生与转化系统 | ✅ v1.6（血脉试炼期✅87：7天可回退、试炼期满自动确认） | 2026-07-03 |
| GDD-12 | 渡劫、破镜与境界掉落系统 | ✅ v1.8（善恶值体系全面对齐✅44；突破成功率pity✅156；术语对齐天启） | 2026-07-03 |
| GDD-13 | 佣兵大厅与悬赏系统 | ✅ v1.6（货币体系全面对齐✅154；章节编号修正；天机阁联动改为第七章） | 2026-07-03 |
| GDD-14 | 稀有宝物流转与拍卖系统 | ✅ v1.6（货币体系全面对齐✅154；天罚概率改为善恶值单轴） | 2026-07-03 |
| GDD-15 | 个性化成长与玩家驱动经济 | ✅ v1.8（能量货币吸收表更新为6种通用货币框架；术语对齐天启） | 2026-07-03 |
| GDD-16 | 社交系统与玩法扩展 | ✅ v1.7（长草期填充：境界巅峰挑战+服务器级大事件；异步社交：道侣信笺/师徒心得/帮派祝福） | 2026-07-03 |
| GDD-17 | 技能总库 | ✅ v2.2（Skill Schema 新增 energy_cost；所有主动技能释放时即时扣能；功法加持取代本命技） |
2026-07-01 |
| GDD-18 | 世界·地图·副本·遗迹生成引擎 | ✅ v2.1（"破界遗迹"专有名词恢复；世界层数从9行合并为5行；v1.6九级世界标注为过渡误记） | 2026-07-03 |
| GDD-19 | 怪物图鉴与生成引擎 | ✅ v1.3（签名怪图鉴、28 条词缀池、种族化战报文案） | 2026-06-30 |
| GDD-20 | 武器装备与打造系统 | ✅ v1.4（系统自动命名词根词缀池、新增 5 项生活技能并同步 GDD-05） | 2026-06-30 |
| GDD-21 | 数值平衡与联调参数总表 | ✅ v1.6（能量经济节奏表；能量上限数值同步修正；突破成功率pity参数） | 2026-07-03 |
| GDD-22 | 开放世界随机事件与玩家可交互内容层 | ✅ v1.2（新增天启事件类型；遭遇模板体力→能量） | 2026-07-03 |
| GDD-23 | 能量体系与功法相性设计 | ✅ v1.4（能量上限天花板修正✅149；版本号统一） | 2026-07-03 |
| GDD-24 | 种族传承大师与稀有生活职业 | ✅ v1.1（传承大师定价锚改为"日均净收入"） | 2026-07-03 |
| GDD-25 | 洪荒大陆世界观设定 | ✅ v1.3（宇宙创世论✅152；信仰面扩展为北欧/奥林匹斯；深潜裔独立为深渊势力） | 2026-07-03 |
| GDD-26 | 功法心法技能详细设计 | ✅ v1.2（术语对齐天启） | 2026-07-03 |
| GDD-27 | 修仙小说经典元素设计 | ✅ v1.2（因果业力术语对齐善恶值） | 2026-07-03 |
| GDD-28 | 神话体系与旧日邪神设计 | ✅ v2.2（阿撒托斯定位✅153；信仰面范围说明；善恶值术语对齐） | 2026-07-03 |
| GDD-29 | 聊天与信息传递系统设计 | ✅ v1.0（频道九类/消息六类/敏感词三级过滤/刷屏防护/屏蔽黑名单/系统广播/存储策略/社交联动） | 2026-07-02 |
| GDD-30 | 成就里程碑与图鉴系统设计 | ✅ v1.1（"天启记录"→"突破记录"避免歧义） | 2026-07-03 |
| GDD-31 | 洞府与个人空间系统设计 | ✅ v1.1（术语对齐天启） | 2026-07-03 |
| GDD-32 | NPC与势力关系系统设计 | ✅ v1.1（七势力与神话体系对齐：阿斯加德=天庭子区域） | 2026-07-03 |
| GDD-33 | 世界Boss与大型PVE协作机制 | ✅ v1.1（Boss战死亡惩罚差异化✅W09：进度-10%，低于通用20-30%） | 2026-07-03 |
| GDD-34 | 好友与组队系统设计 | ✅ v1.1（术语对齐天启） | 2026-07-03 |
需求文档（PRD）
| 编号 | 文档 | 状态 | 最后更新 |
|---|---|---|---|
| PRD-01 | 核心玩法与系统需求 | ✅ v1.0 | 2026-06-30 |
| PRD-02 | 境界隔离系统需求 | ✅ v1.0 | 2026-06-30 |
| PRD-03 | 热更新与活动系统需求 | ✅ v1.0 | 2026-06-30 |
技术文档（TDD）
| 编号 | 文档 | 状态 | 最后更新 |
|---|---|---|---|
| TDD-00 | 整体技术栈方案 | ✅ 已完成 v1.2 | 2026-06-29 |
| TDD-01 | 境界隔离系统技术设计 | ✅ 含于 TDD-00 第五章 | 2026-06-29 |
| TDD-02 | 客户端热更新技术方案 | ✅ v1.0 | 2026-06-30 |
| TDD-03 | 服务端开服自动化方案 | ✅ 含于 TDD-00 第四章 | 2026-06-29 |
| TDD-04 | 数据库表结构设计 | ✅ v1.1 | 2026-06-30 |
| TDD-05 | API 接口设计 | ✅ v1.0 | 2026-06-30 |
实现骨架
| 目录 | 说明 | 状态 |
|---|---|---|
server/ |
Go + Nakama 服务端模块、配置、数据库连接、Makefile（可 go build -buildmode=plugin） |
✅ 骨架已完成 |
client/assets/scripts/ |
Cocos Creator 3.x TypeScript 脚本骨架（登录/大厅/战斗/地图/背包/社交/设置 + 信息流/遭遇 UI） | ✅ 骨架已完成 |
api/proto/ |
gRPC/Protobuf 协议定义 | ✅ honghuang.proto 已完成 |
api/openapi.yaml |
RESTful OpenAPI 3.0 接口规范 | ✅ 已完成 |
database/migrations/ |
PostgreSQL 迁移脚本（up/down + seed） | ✅ 001_init_schema 已完成 |
configs/nacos/ |
Nacos 配置模板（global/combat/economy/map/event/cultivation） | ✅ 已完成 |
本地运行（开发环境）
# 1. 准备环境变量
cp .env.example .env
# 编辑 .env，确认 DATABASE_URL 等默认值即可用于 docker compose
# 2. 启动依赖服务（PG + Nakama + Valkey + Nacos）
docker compose up -d
# 3. 数据库迁移与 seed（等服务健康后）
make migrate
make seed
# 4. 构建并运行服务端（Nakama 插件模式）
cd server && make build
# Nakama 容器会自动加载 server/honghuang-server.so
# 5. 运行测试
cd server && go test ./...
说明：
docker compose config已校验通过；实际拉起需要本地安装 Docker。脚本已做 30 秒等待与幂等 seed。
核心设定速查
| 设定项 | 内容 |
|---|---|
| 世界观 | 洪荒大陆，融合中国上古神话 + 北欧/西方奇幻 + 克苏鲁域外邪神轴 |
| 战斗类型 | 文字战报 + ATB 行动速度制，速度差可导致 2-3 倍出手频率差 |
| 服务架构 | 感官单服，境界隔离（六大境界×层级0-5 竞争池，见 GDD-08） |
| 种族数量 | 19 种族（含转化/重生获得：人族、龙族、混沌裔、巨人族、堕天使裔；天使裔可创角） |
| 时间流速 | 游戏内时间 = 现实 3 倍（默认时间口径为游戏时间） |
| 成长哲学 | 大多数稀有资源/隐藏天赋靠机遇获取；创角不发天赋；无体力，靠能量/时间/风险/概率驱动 |
| 能量体系 | 移除体力；以内力/能量为核心，受功法/状态/纯净度/丹毒影响；各族/职业有独立能量命名 |
| 传承大师 | 每个种族有一个无法战斗的稀有生活大师职业；奇遇获取传承物品后专职；玩家可委托大师加工/布阵/炼丹 |
| 死亡惩罚 | 高惩罚基调（损失进度/纯度/产出/耐久 + 道伤） |
| 充值 | 引入鸿蒙紫气充值（6档）；人族修真可做"偷渡"经纪；只加速不专属，不可买进度/解锁种族 |
| 平台 | Android / iOS / 鸿蒙 NEXT |
| 客户端引擎 | Cocos Creator 3.x（Asset Bundle 热更） |
| 服务端 | Go + Nakama + PostgreSQL + Valkey |
种族速查
| 阵营 | 种族 |
|---|---|
| 天道 | 人族（重生）、神族、精灵族（光明）、天使裔 |
| 洪荒 | 妖族（狐/蛇/虎/凤/猿）、龙族、巫族（4传承）、兽人族、巨人族（矮人转化） |
| 幽冥 | 鬼族、魔族、冥族、吸血鬼族、堕天使裔、精灵族（暗影）、深潜裔（克苏鲁） |
| 混沌中立 | 地精族、矮人族、混沌裔 |
不可创角（转化/重生获得）：人族、龙族、混沌裔、巨人族、堕天使裔。
