---
name: xiaoma-generate-deliver-config
description: 录制持续交付平台交付单配置：git diff 定改动 → 定位交付单 → 读测试环境现值 → 组装报文 → saveDeliver。只保存不提交。页签：nacos/SQL/rocketmq/定时任务/防火墙 + 内网·外网·中台·文件流网关（网关默认不配，点名才配）；其余页签取现值原样回填。开工门禁：8 项确认（服务名/本地仓库/上线时间/开发分支/对比分支 origin/master/平台账密/GitLab 账密/网关取舍），未确认不动手。改动判定：以「本分支 --not origin/master 的自有提交」为准，排除他人合入；新增表必带 CREATE TABLE（测试库已建→SHOW CREATE TABLE 取真实结构；否则仓库迁移脚本；否则按实体类+Mapper XML+同库既有表生成）。取值：Nacos/XXL-Job/网关平台/防火墙字典均读测试环境现值；查不到即跳过并说明，不编造、不兜底。硬约束：写操作只走 HTTP（禁 MCP）；严禁 commitDeliver；checkEditDeliver 非 M0200 即停；git 只读（不 checkout/pull/merge）。⚠️ 仅手动调用：只有当用户显式输入 /xiaoma-generate-deliver-config 或点名「用 xiaoma-generate-deliver-config 这个 skill」时才启用；日常对话中出现「交付配置」「配交付单」等字眼不要自动触发本 skill，先问用户是否要用它。Use when：仅当用户显式调用本 skill 时启用。
disable-model-invocation: true
---

# 生成交付配置（交付管理）

按「**服务名称 + 上线时间**」自动完善并保存交付单各页签配置。平台默认地址 `http://devops.test.yljr.com`（换成你司持续交付平台地址即可）。

## ⛔ 第 0 步：8 项信息全部确认后，才允许开始录制

**这是硬门禁。** 下面 8 项逐项问到、拼成确认卡片回读给用户、**拿到用户明确的「确认」二字之后**，才能执行任何录制动作（登录、定位交付单、读现值、组装报文、保存一律不许提前做）。
**任何一项都不许自行推断、从代码里猜、或沿用上次会话的值。**

| # | 信息 | 怎么取 / 校验 | 缺失或不确定时 |
|---|---|---|---|
| 1 | **服务名称** `SERVER_NAME` | 交付平台上的服务名（**不是** git 仓库名、不是中文别名）。仓库含多个服务 → 列出候选让用户选 | 停下来问，不自己挑 |
| 2 | **本地代码仓库地址** `REPO_PATH` | 本次要录制的**那个服务**的仓库在本机路径。多服务单仓要问清模块目录。先确认路径存在且是 git 仓库（`git rev-parse --git-dir`） | 停下来问；没有本地仓库 → 改让用户贴 diff / 改动文件清单 |
| 3 | **上线时间** `ONLINE_DATE` | `YYYY-MM-DD`。换算毫秒时间戳（当天 0 点 UTC+8）用于定位交付单和解析测试环境。用户说「下周三」「这个窗口」→ **换算成具体日期回读确认** | 停下来问 |
| 4 | **开发分支** `FEATURE_BRANCH` | 读仓库当前分支（`git rev-parse --abbrev-ref HEAD`）回读确认「这是本次需求的开发分支吗」。**不是 → 让用户自己切过去，停下来等**；⛔ 不替用户 checkout，⛔ 不在错分支上硬配 | 停下来等用户切分支 |
| 5 | **对比分支** `BASE_REF` | **默认 `origin/master`**（无则 `origin/main`）。默认值也要在卡片里列出来让用户看见；用户要改成发布分支/生产 tag 就按用户的来 | 主干分支名不明 → 问用户 |
| 6 | **交付平台账号密码** | 操作者本人的账号 + 明文密码（本地加盐 MD5 后登录）。优先读环境变量 `DEVOPS_USER` / `DEVOPS_PWD` | 停下来问 |
| 7 | **GitLab 账号密码** | **按需**：先看 remote 形式（`git remote -v`）。SSH 或凭据已缓存 → 标「不需要」；只有 `git fetch` 报认证失败才要。详见 [reference/change-detection.md](reference/change-detection.md) | fetch 认证失败 → 在对话里直接问用户并说明原因；⛔ 不弹交互窗口、不绕过 |
| 8 | **要不要配网关** | **默认四个网关全部不配**。卡片里必须把这句话和四个网关名字**写出来**，让用户看见并有机会要求配。要配的话，用户必须**点名是哪几个**（内网 / 外网 / 中台 / 文件流），见下方「网关确认规则」 | 用户没提 → 按「全部不配」执行，不追问 |

### 确认卡片（回读格式）

用 `AskUserQuestion` 或直接提问，把 7 项**连同默认值一起**列出来：

```
录制交付配置前请确认以下信息：

  1. 服务名称    : fc-external-integration
  2. 代码仓库    : D:\code\fc-external-integration
  3. 上线时间    : 2026-08-21（时间戳 1787846400000，测试环境待登录后解析）
  4. 开发分支    : feature/ZJJC-2452      ← 仓库当前分支
  5. 对比分支    : origin/master          ← 默认值
  6. 交付平台账号: 13800000000　密码：已提供（环境变量 DEVOPS_PWD）
  7. GitLab 账号 : 不需要（remote 走 SSH）
  8. 网关配置    : ⚠️ 默认【全部不配】
       内网网关 ✗　外网网关 ✗　中台网关 ✗　文件流网关 ✗
       即使代码里有接口改动也不会碰这四个页签（保持交付单现值不动）。
       需要配的话请点名是哪几个，例如「配外网网关」「内网和中台都要配」。

以上确认无误请回复「确认」，我再开始登录并校验录制权限。
```

- 每项都要**显示实际值**，不许写「已确认」「同上」这种糊弄过去。
- 有默认值的（对比分支、网关全部不配）**必须显式列出**，让用户有机会否决。
- 用户只回复部分修改（如「对比分支换成 release/2026-08」）→ **改完重新回读整张卡片**，再等确认。
- ⛔ 用户没回「确认」（或等价表述）之前，**一个录制动作都不许做**。用户直接说「开始吧」但卡片里还有「待提供」的项 → 先把那项补齐。

### 网关确认规则

| 用户的表态 | 怎么处理 |
|---|---|
| 没提网关 / 回「确认」 | **四个全部不配**，页签保持交付单现值。改动清单里注明「检测到 N 个接口改动，网关按默认未配」 |
| 点名了具体网关（「配外网网关」） | 只配点名的那个（那几个），其余仍不配 |
| 只说「网关也配一下」「网关要配」 | **不许自己猜是哪个**。回问：「要配哪几个？内网 / 外网 / 中台 / 文件流」，等答复，不要默认全配 |
| 说「网关全配」 | 四个都走流程，但每个仍要各自过测试环境门禁（§1.2），测试环境没有的照样跳过 |

被点名要配的网关，**仍然要过测试环境门禁和两级筛选**（§1.2、§1.3）——用户说要配 ≠ 一定配得出内容；测试环境查不到就跳过并在摘要里说明。

**只问上面 8 项**。读现值用的下游系统账号是**固定内置的，不要问用户、也不要列进确认卡片**：

| 系统 | 地址 | 账号 / 密码 | 出处 |
|---|---|---|---|
| 网关管理平台（routerView / routerFileView / routerMpsView） | `http://www.{env}.yljr.com`、`http://mps.{env}.yljr.com` | `admin` / `123456` | [reference/environment-lookup.md](reference/environment-lookup.md)、[reference/gateway-export-workflow.md](reference/gateway-export-workflow.md) |
| XXL-Job 调度中心 | `http://www.{env}.yljr.com/xxl-job-admin` | `admin` / `123456` | [reference/environment-lookup.md](reference/environment-lookup.md) |
| Nacos | 见项目 `bootstrap` 配置的 server-addr | 免登录，`curl` 直读 | [reference/environment-lookup.md](reference/environment-lookup.md) |

这些只用于**只读**（登录/检索/导出，不改网关和任务配置）。若登录失败（平台改了口令）→ 停下来问用户要新口令，不要试别的口令。

**凭据处理规则**：
- 密码**只在本次运行内存里用**：不回显、不写进任何文件、不写进 `run.py`、不落日志、不进 memory、不出现在最终摘要里（摘要里写「已使用账号 xxx」即可）。
- 优先从环境变量取：`DEVOPS_USER` / `DEVOPS_PWD`；取不到再问用户。
- 登录失败（账号密码错 / `M0401`）→ **原样报错并让用户重给**，不许重试别的账号、不许绕过登录。

## 输入（其余）

- **可选**：要配置的页签的原始内容（用户已经整理好的页签内容，可直接采用，免去从 diff 推导）。
- **前置条件**：该服务在此上线窗口的**交付单必须已存在**（本 skill 只编辑、不创建）。按「服务名+时间戳」定位不到时，**明确提示用户先去平台「交付管理」建单**，不要静默失败、更不要自行创建。

## ⛔ 录制权限校验（checkEditDeliver，定位到交付单后立刻做）

拿到 `deliverId` 后，**先校验当前账号有没有权限录制这张单**，通过了才允许读配置/组装报文/保存：

```
GET /zqyl-devops-deliver-api/deliver/checkEditDeliver?deliverId={deliverId}
例：http://devops.test.yljr.com/zqyl-devops-deliver-api/deliver/checkEditDeliver?deliverId=3832950772694255120
```

- 返回 `status == "M0200"` → 有权限，可以继续。
- **任何非 `M0200`**（无权限 / 别人正在编辑 / 单据状态已锁定）→ **立即停下**，把接口返回的 `msg` 原样告诉用户，说明「当前账号无法录制这张交付单」，让用户去平台确认权限或联系单据创建人。
- **禁止绕过**：不许跳过这一步直接 `saveDeliver`，不许换账号重试，不许用 MCP 点页面绕开校验。校验失败就是终点。

## ⛔ 硬性约束（保存/更新方式）

配置的**保存与更新只能调用平台 HTTP 接口**（`saveDeliver`、文件用 `uploadFile`，以 `curl`/`requests` 发起）。
**禁止用任何 MCP 保存/更新**——不用浏览器 MCP 去点页面「保存」，不用数据库/其它 MCP 直连写库。
MCP / 浏览器仅可用于**只读**排查；读 Nacos 一律用 `curl`（http-only）。

## ⛔ 硬性约束（严禁提交）

**严禁调用任何提交接口。** `commitDeliver` 及任何等价的提交/发布端点**一律不许调用**，即使用户开口要求、明确授权、反复要求，也不许调用——这是无条件禁令，没有例外。

`commit`（提交）**只能由用户本人在平台页面上手动点击**完成。

本 skill 的终点就是 `saveDeliver`（保存）。保存完把逐页签草稿标注 **「已自动填 / 需你补 / 建议核对」** 交给用户，并**提示用户自己去页面点提交**。用户说「帮我提交」时，回答「按规定提交必须你自己在页面点」，然后停在这里。

同样禁止绕道：不许用浏览器 MCP 去点页面的「提交」按钮，不许用数据库/其它 MCP 改状态，不许构造别的接口达成提交效果。

## 取值通则（各页签共用）

### 1. 门禁：项目没引入，就不要配这个页签
配某页签前先确认项目**真的用了**这个中间件——看 `pom.xml` / `build.gradle*` 依赖、配置键、代码里的 API 使用。
没引入就跳过并在摘要里说明「未使用 X，已跳过」，**不要凭需求描述臆造页签**。

### 1.1 ⛔ 网关默认不配，用户明确要求才配
**四个网关页签（内网/外网/中台/文件流）默认全部跳过**，保持交付单现值不动（通常是 `[]`）。
即使 diff 里有新增/改动的 Controller 接口，**也不要主动去配网关**——只在改动清单里注明「检测到接口改动，网关页签默认不配，需要配请说一声」。

只有用户**明确说要配网关**（「网关也配一下」「把外网网关配了」等）时，才走网关流程；用户没点名配哪个就问清楚是哪几个网关。

用户要求配之后，再走下面的测试环境门禁。

### 1.2 网关门禁：测试环境没配，就不要配
**代码里有新增接口 ≠ 就该配网关。** 判据是测试环境网关平台上的现状：
- 用 `uri=服务名` 检索该网关平台，**该服务一条配置都没有 → 本服务不走这个网关，页签保持 `[]`，什么都不配、不上传文件**，摘要写明「测试环境 {env} 的 {平台} 无本服务配置，已跳过」；
- 服务有配置、但**本次新接口在测试环境查不到** → 说明该接口不走网关，**直接跳过它**（不问用户、不卡流程），摘要里列一行说明；其余命中的接口照常导出。**不许自己编一条塞进导出**；
- 四个网关页签各自独立判断，不要因为外网有就顺手配内网。

**导出内容必须是测试环境上真实存在的配置**，测试环境没有的一律不配。详见 [reference/gateway-export-workflow.md](reference/gateway-export-workflow.md) §3.1。

### 1.3 ⛔ 网关筛选：两级过滤，禁止全量导出
检索/导出**一律带过滤条件**，绝不无条件拉全量（全量 1–2MB，且必然混入别的服务）：
1. **第一级 按服务名**：路由用 `uri={SERVER_NAME}` 导出该服务全部路由（~13KB），得到该服务真实的 `routerCode` 全集 G；
2. **第二级 按接口**：在 G 里匹配本次改动接口得到 R，再按 R 的公共前缀 / 逐接口 `routerCode=` 过滤导出，最后精确删行留 R。

熔断/限流/参数的检索表单**没有 `uri` 字段**，第一级改用「从路由 G 里得到的本服务 routerCode」作为过滤词，同样不许全量拉。详见 [reference/gateway-export-workflow.md](reference/gateway-export-workflow.md) §4.2。

### 2. 定位配置值：本地 → Nacos，两级顺序
1. **本地**：`bootstrap.yml` / `bootstrap.properties` / `application*.yml` / `*.properties`、配置类与静态常量；
2. **Nacos**（本地凑不齐时）：从 `spring.cloud.nacos.config.ext-config[*].data-id` / `.group` 找目标文件，
   没有 `ext-config` 再搜 `shared-dataids` / `extension-configs`；按关键字挑（如库找 `database`/`datasource`/`mysql`/`oracle`/`db`，
   MQ 找 `mq`/`rocketmq`，Mongo 找 `mongo`）。读 Nacos 一律用 `curl`（见 [reference/environment-lookup.md](reference/environment-lookup.md)）。

**注意 namespace**：项目 `bootstrap.properties` 里的 `spring.cloud.nacos.config.namespace` 和 server-addr
未必等于上线窗口解析出的测试环境名（如项目在 `cscec2b`，而窗口环境是 `test2`），按项目实际配置连。

### 3. 一个文件里没有，就继续往下找
目标值不在第一个文件里是常态（如账号密码在 A 文件、jdbc url 在 B 文件）。
继续拉同 group 下其它相关 dataId，直到凑齐；**不要因为第一个文件没有就判定「查不到」**。

### 4. ⛔ 不猜、不兜底、不设「其它一律归 X」
候选选不出来时，**列出已查过的文件 / dataId / 候选项，交给用户定**，然后停在这里。
严禁从字典或候选列表里挑一个「看着像的」填进去；严禁写「未命中则默认取某某」这类兜底。

### 5. 默认「合并」不「整体替换」
本次配置默认**合并进交付单现值**（nacos 按 `dataId`+`key`、mq 按 `topic`、cronJobs 按 `jobHandler`、网关按 `type` 一类一份、sqlFile 追加去重），**不要**用本次 delta 直接覆盖掉整个页签（会丢已有条目）。只有「整批重配」某页签时才整体替换，并**提示用户**。`configtypes` 由后端按报文重算，无需手动维护。

### 6. 读的是「测试环境」，值交用户复核
Nacos / XXL-Job / 网关都读自该上线窗口对应的**测试环境**（`environmentType`）。**nacos 直接回填测试环境现值即可**（各环境不同的值也先填测试值，不必纠结）；填完把逐页签草稿标 **「已自动填 / 需你补 / 建议核对」** 交用户复核，**有问题用户自己改**。

## 工作流

复制此清单并逐步推进：

```
- [ ] 0. ⛔ 确认卡片：服务名 / 仓库地址 / 上线时间 / 开发分支 / 对比分支 / 交付平台账密 / GitLab 账密 / **网关默认全部不配（要配须点名哪几个）** —— 8 项回读，**拿到用户「确认」前一个动作都不许做**
- [ ] 0.3 卡片里的开发分支就是仓库当前分支；不是 → 让用户自己切过去，停下等（不许我 checkout）
- [ ] 0.4 fetch origin（对比分支默认 origin/master；必带 `GIT_TERMINAL_PROMPT=0` + `GIT_SSH_COMMAND='ssh -o BatchMode=yes'`，绝不弹交互窗口）；要 GitLab 账密 → 在对话里直接问用户并说明原因
- [ ] 0.5 算实际开发量：git log --no-merges --name-status 分支 --not origin/master → 本分支自己触碰的文件（排除别人合入的）；与三点 diff 对照，多出的说明来源
- [ ] 0.6 文件清单 → 映射成「本次要配哪些页签」，连同开发量报告出表给用户确认（见 reference/change-detection.md）
- [ ] 1. 用操作者账号登录取 Cookie（密码加盐 MD5，见 reference/api-and-auth.md）
- [ ] 2. 上线时间 → 毫秒时间戳（当天 0 点，UTC+8）
- [ ] 3. 按 服务名 + 时间戳 定位交付单 → deliverId（命中多条→补「创建人」；一条都没有→提示用户先建单，停）
- [ ] 3.5 checkEditDeliver?deliverId= 校验录制权限（须 M0200）；非 M0200 → 原样报 msg 给用户并停
- [ ] 4. 解析测试环境 environmentType（见 reference/environment-lookup.md）
- [ ] 5. 取交付详情 → projectId / optimistic(乐观锁) / 各页签现值
- [ ] 6. 按 0.5 的清单读实际配置：Nacos 补值 / XXL-Job 读定时任务 / 防火墙判触发（网关仅在用户明确要求时才读·导出）
- [ ] 7. 逐页签把内容转成 JSON（每个页签规则见 tabs/ 下对应文件）
- [ ] 8. 与交付单现值【合并】进报文骨架（未配页签补现值/空占位，见 reference/payload-skeleton.md）
- [ ] 9. saveDeliver 保存（保存前重取详情再合并；乐观锁 M0600 自动重取重试，避免覆盖并发改动）
- [ ] 10. 给用户核对逐页签草稿，并提示「提交请你自己到页面上点」——到此为止，不许调提交接口
```

一键脚本（二选一，功能等价）：

| 脚本 | 运行环境 | 用法 |
|---|---|---|
| [scripts/run.py](scripts/run.py) | Python + `requests` | 改顶部 `SERVER_NAME` / `ONLINE_DATE` / `OVERRIDES` 后运行 |
| [scripts/run.ps1](scripts/run.ps1) | **PowerShell（Windows 自带，无需装任何东西）** | `powershell -ExecutionPolicy Bypass -File run.ps1 -ServerName xxx -OnlineDate 2026-08-21 -OverridesPath .\overrides.json` |

两者都：账号密码走 `DEVOPS_USER` / `DEVOPS_PWD` 环境变量或运行时交互输入（密码不回显、不写进脚本）；启动回读参数要你确认；定位到单后自动跑 `checkEditDeliver`；合并语义一致；只 save 不 commit。

## 运行环境（没有 Python 也能用）

**Python 不是必需的。** 保存走的是 HTTP 接口，用什么发都行：

| 能力 | 首选 | 无 Python 时的替代 |
|---|---|---|
| 全流程一键跑 | `scripts/run.py` | **`scripts/run.ps1`**（PowerShell 自带） |
| 逐步调接口 | — | `curl`（Git Bash 自带）+ 由我在对话里组装 JSON，**完全不需要脚本** |
| 网关 xls 删行 | `scripts/trim_gateway_xls.ps1`（Excel/WPS COM） | `scripts/trim_gateway_xls.py`（需 `xlrd`+`xlwt`） |
| 网关 xls 合并 | `scripts/merge_gateway_xls.ps1` | **只有 PowerShell 版**，需装了 Excel/WPS |
| 查表结构（生成 DDL 时抄参考表） | **`scripts/table-struct.ps1`** / `scripts/query-db.ps1`（PowerShell，走内网 sql-console，只读） | 无——不依赖 Python 和数据库驱动 |
| 直连库导 DDL（可选） | `scripts/dump_ddl.py`（需 `pymysql` + Nacos 库密码） | 用上面的 `table-struct.ps1` 替代 |

> 改 `.ps1` 文件必须存成 **UTF-8 with BOM**：Windows PowerShell 5.1 读无 BOM 的 UTF-8 会按 GBK 解码，中文注释会吃掉引号导致语法错误。

## 交付摘要（输出格式，强制）

**载体**：摘要**只写在聊天消息里**（Markdown）。禁止默认生成 `.html` / 报告文件；用户明确要求「导出/落盘」才写文件。

**顺序**：`保存结果` → `逐页签明细` → `未配说明` → `下一步`。先结果，再明细，最后动作。

**顶行标签**（行内 code、空格分隔）：
`<服务名> · <上线日期> · <测试环境>` · `已保存|保存失败` · `deliverId=<…>` · `optimistic=<新值>`

**逐页签明细**：本次**动过的**页签每个一行，格式

```
<页签> · <条数>：<状态标签> —— <依据>
```

状态标签只用这三个，不要自创：

| 标签 | 含义 | 用在哪 |
|---|---|---|
| `已自动填` | 值来自测试环境现值 / 仓库原文，可信 | Nacos 现值、XXL-Job 现值、网关导出文件、仓库迁移脚本、SHOW CREATE TABLE 取的建表语句 |
| `建议核对` | 值有推断成分 | 生成的建表语句、防火墙端口选择、SQL 库地址抄历史单 |
| `需你补` | 缺信息没填成 | 新库地址待定、DDL 要不到、字典选不出候选 |

**未配说明**：**没配的页签也要各写一行**，写明原因——`未使用 X，已跳过` / `测试环境 {env} 的 {平台} 无本服务配置` / `网关按默认未配` / `本次无改动命中`。
沉默地不配是最容易出事的地方（用户以为配了），**宁可多写一行**。

**下一步**：固定收尾一句「提交请你自己到平台页面上点」，并列出**必须人工复核**的项（所有 `建议核对` / `需你补`）。⛔ 不许提出「我帮你提交」。

**骨架**：

~~~markdown
## 保存结果

`fc-external-integration · 2026-08-21 · test4` · `已保存` · `deliverId=3852055783659275792` · `optimistic=8`

本次开发量：本分支自有提交 7 个，触碰文件 12 个（三点 diff 96 个，已排除 master 上他人合入 84 个）

## 逐页签明细

- `SQL · 2 条`：`建议核对` —— 新增表 `t_biz_log` 的建表语句由 XxxEntity+XxxMapper.xml 生成；库定位抄历史单 `MySQL→fc_mysql→fc_integration`
- `nacos · 3 键`：`已自动填` —— 取自 test4 现值，dataId `fc-integration.yml`
- `防火墙 · 1 条`：`建议核对` —— 本服务 → `mysql_172.16.1.7:3306`，端口按 aotuSelection=true 全选

## 未配说明

- rocketmq：项目未引入 RocketMQ 依赖，已跳过
- 定时任务：本次无 `@XxlJob` 改动
- 内网/外网/中台/文件流网关：网关按默认未配（检测到 3 个接口改动，需要配请说明配哪几个）

## 下一步

1. 复核 `t_biz_log` 建表语句的字段长度与索引（生成件，建议 DBA 过一遍）
2. 复核防火墙那条放行的端口范围
3. 确认无误后**由你本人**到平台页面点「提交」——本 skill 不调提交接口
~~~

## 各页签填写规则（每个页签一个独立文件）

**本 skill 只负责下面 9 个页签**。按需只读对应页签文件。
**其余页签不在覆盖范围**：一律用交付单**现值原样保留**（组装报文时回填、不改动、不清空）。

| 页签 | 字段 | 默认 | 规则文件 |
|---|---|---|---|
| nacos 配置文件 | `nacos` | 命中 diff 就配 | [tabs/nacos.md](tabs/nacos.md) |
| SQL | `sqlFile` | 命中 diff 就配 | [tabs/sql.md](tabs/sql.md) |
| rocketmq | `mq` | 命中 diff 就配 | [tabs/rocketmq.md](tabs/rocketmq.md) |
| 定时任务 | `cronJobs` | 命中 diff 就配 | [tabs/cronjobs.md](tabs/cronjobs.md) |
| 防火墙 | `firewall` | 命中触发判据就配 | [tabs/firewall.md](tabs/firewall.md) |
| 内网网关配置 | `innerGateway` | **默认不配** | [tabs/gateway-inner.md](tabs/gateway-inner.md) |
| 外网网关配置 | `outGateway` | **默认不配** | [tabs/gateway-out.md](tabs/gateway-out.md) |
| 中台网关 | `midGateway` | **默认不配** | [tabs/gateway-mid.md](tabs/gateway-mid.md) |
| 文件流网关配置 | `outFileGateway` | **默认不配** | [tabs/gateway-outfile.md](tabs/gateway-outfile.md) |

> 四个网关**只在用户明确要求时才配**（见 §1.1）；防火墙按 [tabs/firewall.md](tabs/firewall.md) 的触发判据自动判断。

## 参考

- **识别本次改动（git diff → 该配哪些页签）** → [reference/change-detection.md](reference/change-detection.md)
- 接口清单 / 登录鉴权（加盐 MD5）/ 录制权限校验 / 乐观锁 / 状态码 → [reference/api-and-auth.md](reference/api-and-auth.md)
- 完整保存报文骨架 + 页签↔字段对照 → [reference/payload-skeleton.md](reference/payload-skeleton.md)
- 按上线时间解析测试环境 + 从 Nacos/XXL-Job/网关平台读现值 → [reference/environment-lookup.md](reference/environment-lookup.md)
- **网关：按本次改动接口 筛选→导出 xls→上传 全流程** → [reference/gateway-export-workflow.md](reference/gateway-export-workflow.md)
- 参数化脚本 → [scripts/run.py](scripts/run.py) / [scripts/run.ps1](scripts/run.ps1)
- **只读查表结构（生成建表语句时抄参考表）** → [scripts/table-struct.ps1](scripts/table-struct.ps1)、[scripts/query-db.ps1](scripts/query-db.ps1)
  内网 sql-console `http://10.111.80.170:8080`（`SQL_CONSOLE_BASE_URL` 可覆盖）；凭据取 `SQL_CONSOLE_USERNAME`（默认 admin）/ `SQL_CONSOLE_PASSWORD`，
  环境变量没有时依次回落到**本 skill 根目录**的 `.secrets.env`、log-analysis skill 的 `.secrets.env`（若存在）。
  `.secrets.env` 含密码，拷贝/提交 skill 时注意排除（已在 `.gitignore`）。连不通/无凭据 → `===DB_SKIP===` 软失败，不中断录制。

## 可迁移性（换平台需替换的专有常量）

本 skill 自包含、可独立部署，不依赖任何其它 skill。但以下为**本平台/本公司专有常量**，迁到别的平台时需替换：平台地址 `devops.test.yljr.com`、登录**加盐 MD5 的盐值**、SQL 库字典 id、MQ 集群 id 与 `fc-`→`fc-rocketmq` 约定、网关平台主机与 `routerView/routerFileView/routerMpsView` 前缀及 `verifyMode` 内外网约定、`www.{env}` / `mps.{env}` 域名规则。这些在对应 tabs/reference 文件里，按新平台实测值替换即可。
