# nacos 配置文件（字段 `nacos`，数组）

## 用户提供
- **配置分组 `groups`**、**文件名 `dataId`**；
- 每个配置项的 **类型 / 键 / 值 / 注释**。
- 也可直接给一段标准 `.properties` 文本，调 `POST /zqyl-devops-continuous-api/script/nacos/parse`（body `{content:"..."}`）解析成 key/value/comment。
- 各环境不同的值 → 给「变量英文名」，写成 `${{'变量英文名'}}`（走变量库）。

## 可自动读（值不清楚时）
从代码 diff 抓新增 `@Value("${x.y}")`/`@ConfigurationProperties`/yml 键 → 用 `bootstrap.yml` 的 `ext-config` 定位 dataId/group → 去**对应测试环境** Nacos 用 `curl` 读现值回填（见 [../reference/environment-lookup.md](../reference/environment-lookup.md) 第 2 节）。

> **值就填测试环境现值即可**（各环境不同的值也先填测试值，不必纠结变量）。填完把该页签草稿标「已自动填 / 需你补 / 建议核对」交用户复核，**有问题用户自己改**——不用在这里纠结生产值。
> 合并：新增的 key 会**合并进**交付单里已有的 nacos 配置（同 `dataId` 文件按 `key` 去重），不会覆盖掉原有条目。

## JSON
```json
"nacos": [
  { "groups": "application.properties", "dataId": "app.properties",
    "nacosKeys": [ { "type": 1, "key": "server.port", "value": "8080", "comment": "端口" } ] }
]
```
- `type`：配置项类型，`1`=新增，其余=修改/删除（以界面下拉为准）。
- 一个文件可含多条 `nacosKeys`；可有多个文件对象。