# 洪荒大陆 Nacos 配置导入说明

## 配置清单

| 文件 | 命名空间建议 | 说明 |
|------|-------------|------|
| `honghuang-global.yaml` | `honghuang` | 全局锚点参数：时间流速、每日重置 |
| `honghuang-combat.yaml` | `honghuang` | 战斗/ATB/技能系数 |
| `honghuang-economy.yaml` | `honghuang` | 经济、税率、拍卖、帮派、社交 |
| `honghuang-map.yaml` | `honghuang` | 世界地图、副本、遗迹、怪物 |
| `honghuang-event.yaml` | `honghuang` | 登录信息流、实时遭遇、世界脉动 |
| `honghuang-cultivation.yaml` | `honghuang` | 功法、渡劫、转生、装备 |

## 导入方式

### 方式一：Nacos 控制台

1. 登录 Nacos 控制台 → 配置管理 → 配置列表。
2. 选择命名空间 `honghuang`（如不存在请新建）。
3. 点击「+ 新建配置」：
   - Data ID：`honghuang-global.yaml`
   - Group：`DEFAULT_GROUP`
   - 配置格式：YAML
   - 将文件内容粘贴到配置内容中。
4. 依次导入其余 5 个文件。

### 方式二：Nacos OpenAPI

```bash
NACOS_SERVER="http://127.0.0.1:8848"
NAMESPACE="honghuang"
GROUP="DEFAULT_GROUP"

for file in honghuang-global honghuang-combat honghuang-economy honghuang-map honghuang-event honghuang-cultivation; do
  curl -X POST "$NACOS_SERVER/nacos/v1/cs/configs" \
    -d "tenant=$NAMESPACE" \
    -d "dataId=${file}.yaml" \
    -d "group=$GROUP" \
    -d "type=yaml" \
    --data-urlencode "content=$(cat configs/nacos/${file}.yaml)"
done
```

## 命名空间规则

- 生产环境：`honghuang-prod`
- 测试环境：`honghuang-test`
- 灰度环境：`honghuang-gray`

服务端通过环境变量 `NACOS_NAMESPACE` 指定命名空间，默认 `honghuang`。

## 键名约定

- 所有键与 GDD-21《数值平衡与联调参数总表》保持一致，例如：
  - `combat.atb.base_coefficient`
  - `economy.tax.trade_rate`
  - `event.encounter.base_interval_min`
- 默认值与取值范围以行内注释形式标注，便于策划直接在 Nacos 中调参。

## 后续调参流程

1. 策划在 Nacos 修改目标参数并发布。
2. 服务端 `config/config.go` 通过 `ListenConfig` 监听变更并更新本地缓存。
3. 数值生效无需重启 Nakama 游戏逻辑服。