docs(nacos-config): 添加 nacos_config 目录分析与修改指南

新增 g3fo-nacos-config 目录下的 SKILL.md 文档，详细说明 nacos_config 目录的结构、用户交互流程及配置文件的添加与修改规则。新增 yml-placement.md 文件，提供常见顶级键的插入顺序，以保持配置文件风格一致。

skills/g3fo-docs/references/middleware/mysql/deploy.md

@@ -1,26 +1,32 @@
 # MySQL 8.4 双主（Source-Source）同步部署文档（跨主机统一目录/容器名版）
 
 > **AI 响应规范 (MySQL 执行策略)**:
+>
 > 1. **强制参数**: 所有 `docker exec` 命令必须包含 `-h127.0.0.1` 参数。
 > 2. **双重输出**: 涉及 SQL 操作时，必须同时输出 `Docker 执行命令` 和 `纯 SQL 脚本`。
 
 ## 文档概述
+
 你需要部署跨两台独立主机的 MySQL 8.4 双主双向复制集群，核心要求是：两台主机的容器名、目录路径统一使用 `mysql`（仅通过 IP 区分节点），保证两节点数据一致性，支持初始化、校验、宕机重启恢复及节点重建全流程。核心设计遵循：
 
-+ **GTID + AUTO_POSITION**：重启后自动定位同步位点，减少人工干预；
+- **GTID + AUTO_POSITION**：重启后自动定位同步位点，减少人工干预；
-+ **ROW 模式 binlog**：避免非确定性函数导致的数据不一致；
+- **ROW 模式 binlog**：避免非确定性函数导致的数据不一致；
-+ **持久化数据卷**：独立 Volume 保障容器重启数据不丢失；
+- **持久化数据卷**：独立 Volume 保障容器重启数据不丢失；
-+ **自增键隔离**：通过步长/偏移配置避免双写主键冲突。
+- **自增键隔离**：通过步长/偏移配置避免双写主键冲突。
 
 ## 1. 环境准备
+
 ### 1.1 节点信息（核心区分点）
+
+
 | 节点   | 主机IP         | server_id | auto_increment_offset | 核心标识       |
-| :--- | :--- | :--- | :--- | :--- |
+| ---- | ------------ | --------- | --------------------- | ---------- |
 | 主节点A | ${NODE_A_IP} | 1         | 1                     | 生成主键1、3、5… |
 | 主节点B | ${NODE_B_IP} | 2         | 2                     | 生成主键2、4、6… |
 
 
 ### 1.2 系统依赖（两台主机统一执行）
+
 ```plain
 # 安装 Docker & Docker Compose、MySQL 客户端
 sudo apt update && sudo apt install -y docker.io docker-compose-plugin mysql-client
@@ -29,6 +35,7 @@ docker --version && docker compose version && mysql --version
 ```
 
 ### 1.3 目录规划（两台主机完全一致）
+
 ```plain
 # 两台主机均执行以下命令，目录统一为 /data/mysql
 sudo mkdir -p /data/mysql/{data,backup,logs}
@@ -36,7 +43,9 @@ sudo chown 999:999 /data/mysql -R  # MySQL 容器默认UID/GID为999，避免权
 ```
 
 ## 2. 双主节点部署
+
 ### 2.1 Docker Compose 配置（两台主机完全一致）
+
 创建 `/data/mysql/docker-compose.yml`，内容如下（无节点差异）：
 
 ```plain
@@ -73,7 +82,9 @@ services:
 ```
 
 ### 2.2 MySQL 配置文件（my.cnf）
+
 #### 节点A（${NODE_A_IP}）：`/data/mysql/my.cnf`
+
 ```plain
 [mysqld]
 # ========== 节点唯一标识（核心区分点） ==========
@@ -120,6 +131,7 @@ super_read_only=OFF
 ```
 
 #### 节点B（${NODE_B_IP}）：`/data/mysql/my.cnf`
+
 ```plain
 [mysqld]
 # ========== 节点唯一标识（核心区分点） ==========
@@ -166,6 +178,7 @@ super_read_only=OFF
 ```
 
 ### 2.3 启动容器（两台主机统一执行）
+
 ```plain
 # 进入目录并启动容器
 cd /data/mysql && docker compose up -d
@@ -175,7 +188,9 @@ docker ps | grep mysql
 ```
 
 ## 3. 双主复制初始化
+
 ### 3.1 创建复制专用用户（两台主机统一执行）
+
 ```plain
 # 无需区分节点，直接执行（创建repl用户，允许跨主机访问）
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
@@ -186,7 +201,9 @@ FLUSH PRIVILEGES;
 ```
 
 ### 3.2 配置双向复制（核心：仅IP参数不同）
+
 #### 步骤1：节点A（${NODE_A_IP}）配置为节点B的从库
+
 ```plain
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
 STOP REPLICA;
@@ -198,13 +215,14 @@ CHANGE REPLICATION SOURCE TO
   SOURCE_PASSWORD = 'afe123456',
   SOURCE_AUTO_POSITION = 1,       # GTID自动定位（无需手动找位点）
   SOURCE_CONNECT_RETRY = 10,
-  SOURCE_RETRY_COUNT = 86400,
+  SOURCE_RETRY_COUNT = 9999999999,
   GET_SOURCE_PUBLIC_KEY = 1;      # 适配MySQL 8.0+密码认证
 START REPLICA;
 "
 ```
 
 #### 步骤2：节点B（${NODE_B_IP}）配置为节点A的从库
+
 ```plain
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
 STOP REPLICA;
@@ -216,29 +234,34 @@ CHANGE REPLICATION SOURCE TO
   SOURCE_PASSWORD = 'afe123456',
   SOURCE_AUTO_POSITION = 1,
   SOURCE_CONNECT_RETRY = 10,
-  SOURCE_RETRY_COUNT = 86400,
+  SOURCE_RETRY_COUNT = 9999999999,
   GET_SOURCE_PUBLIC_KEY = 1;
 START REPLICA;
 "
 ```
 
 ## 4. 同步状态校验
+
 ### 4.1 核心校验命令（两台主机统一执行）
 
 **A. Docker 执行模式 (包含 -h127.0.0.1):**
+
 ```bash
 # 查看复制状态
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "SHOW REPLICA STATUS\G"
 ```
 
 **B. 纯 SQL 模式:**
+
 ```sql
 SHOW REPLICA STATUS\G
 ```
 
 ### 4.2 关键校验字段（必须全部满足）
+
+
 | 字段                    | 目标值                  | 说明               |
-| :--- | :--- | :--- |
+| --------------------- | -------------------- | ---------------- |
 | Replica_IO_Running    | Yes                  | IO线程正常（接收binlog） |
 | Replica_SQL_Running   | Yes                  | SQL线程正常（执行事务）    |
 | Last_SQL_Error        | 空                    | 无同步错误            |
@@ -248,6 +271,7 @@ SHOW REPLICA STATUS\G
 
 
 ### 4.3 数据一致性验证
+
 ```plain
 # 节点A（${NODE_A_IP}）创建测试数据
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
@@ -266,8 +290,11 @@ docker exec -it mysql mysql -uroot -pafe123456 -h${NODE_A_IP} -e "SELECT * FROM
 ```
 
 ## 5. 故障处理流程
+
 ### 5.1 宕机重启恢复
+
 #### 场景：容器/主机重启后复制未自动恢复（两台主机操作逻辑一致，仅IP不同）
+
 ```plain
 # 以节点A（${NODE_A_IP}）为例，恢复与节点B的复制关系
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
@@ -289,7 +316,9 @@ SHOW REPLICA STATUS\G;
 ```
 
 ### 5.2 重建节点（单节点数据损坏/丢失）
+
 #### 步骤1：从正常节点全量备份（假设节点B损坏，从节点A备份）
+
 ```plain
 # 节点A（${NODE_A_IP}）执行备份
 docker exec -it mysql mysqldump -uroot -pafe123456 -h127.0.0.1 --all-databases --master-data=2 --single-transaction > /data/mysql/backup/full_backup.sql
@@ -299,6 +328,7 @@ scp /data/mysql/backup/full_backup.sql root@${NODE_B_IP}:/data/mysql/backup/
 ```
 
 #### 步骤2：停止损坏节点并恢复数据（节点B执行）
+
 ```plain
 # 停止mysql容器
 cd /data/mysql && docker compose down
@@ -314,24 +344,34 @@ docker exec -i mysql mysql -uroot -pafe123456 < /data/mysql/backup/full_backup.s
 ```
 
 #### 步骤3：重新配置双向复制
+
 参考「3.2 配置双向复制」，重新执行节点B作为节点A从库、节点A作为节点B从库的配置命令（仅IP参数区分）。
 
 ### 5.3 复制冲突解决
+
 详细的冲突定位与修复流程，请参考：[MySQL 复制冲突解决指南](./fault-analysis.md)
 
 ## 6. 日志管理
+
 详细的日志轮转与安全登录配置，请参考：[MySQL 日志管理指南](./log-management.md)
 
 ## 7. 重要提醒
+
 ### 7.1 核心区分点（避免配置错误）
-+ 两台主机仅 `server_id`、`report_host`（IP）、`auto_increment_offset` 三个参数不同，其余配置完全一致；
+
-+ 容器名、目录路径、端口均统一为 `mysql`/`/data/mysql`/3306，通过主机IP区分节点。
+- 两台主机仅 `server_id`、`report_host`（IP）、`auto_increment_offset` 三个参数不同，其余配置完全一致；
+- 容器名、目录路径、端口均统一为 `mysql`/`/data/mysql`/3306，通过主机IP区分节点。
 
 ### 7.2 一致性限制
-+ MySQL原生异步双主复制**无法保证严格的数据一致性**，双写场景仍可能出现冲突；
+
-+ 生产环境建议**单写多读**（指定一个节点为写节点，另一个为读节点），避免双写冲突。
+- MySQL原生异步双主复制**无法保证严格的数据一致性**，双写场景仍可能出现冲突；
+- 生产环境建议**单写多读**（指定一个节点为写节点，另一个为读节点），避免双写冲突。
 
 #### 总结
+
 #### 跨主机双主复制的核心差异仅为 `server_id`、主机IP、自增偏移量，其余目录/容器名/配置可完全统一；
+
 #### 同步故障优先通过错误日志定位冲突，修复数据而非跳过事务（避免永久不一致）；
+
 #### GTID模式下无需手动定位同步位点，重启/重建节点时仅需重新指定对端IP即可自动恢复复制。
+

skills/g3fo-docs/references/middleware/mysql/fault-analysis.md

@@ -150,9 +150,28 @@ scp /data/backup/mysql/20250127120000.7z root@192.168.1.100:/data/backup/mysql/
 
 **注意**: 确保还原机的 `/data/backup/mysql/` 目录存在且有写入权限。
 
-#### 步骤 3: 在还原机上执行还原
+#### 步骤 3: 在还原机上还原前准备（清空数据并重启 MySQL）
 
-在需要还原的 MySQL 服务器（从库）上执行还原脚本：
+在需要还原的 MySQL 服务器（还原机）上，**先清空数据目录并重启容器**，再执行还原脚本，避免旧数据与备份冲突。
+
+1. **删除数据目录中的现有数据**（在还原机执行）：
+```bash
+# 删除 /data/mysql/data 下数据（请确认该路径为当前 MySQL 数据目录）
+rm -rf /data/mysql/data/*
+```
+
+2. **在 docker-compose 目录下重启 MySQL 容器**（在还原机执行）：
+```bash
+cd /data/docker-compose
+docker-compose down mysql
+docker-compose up -d mysql
+```
+
+等待 MySQL 启动就绪（可查看容器日志或稍等 10～30 秒）后，再进行步骤 4 的还原。
+
+#### 步骤 4: 在还原机上执行还原脚本
+
+在还原机上执行还原脚本：
 
 ```bash
 cd /data/backup/mysql
@@ -171,50 +190,170 @@ cd /data/backup/mysql
 - 导入备份数据（导入时禁用 binlog，避免循环复制）
 - 设置 GTID purged（从备份时的 GTID 位置）
 - 恢复 MySQL 为读写模式
-- **自动启动复制并检查状态**
 
-#### 步骤 4: 在备份机上启动同步（重要）
+#### 步骤 5: 还原后创建账号（在还原机执行）
 
-还原完成后，还原脚本会自动启动复制并显示同步状态。确认看到同步成功后，**需要在备份机（主库）上执行以下操作**：
+还原完成后，在**还原机**上创建复制与业务所需账号（若备份中已含用户则可酌情跳过，建议按环境统一执行一次）。
+
+**A. 创建复制账号 `repl` 与日志刷新账号 `log_flush`**
+
+Docker 执行：
+```bash
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
+CREATE USER 'repl'@'%' IDENTIFIED BY 'afe123456';
+GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%';
+FLUSH PRIVILEGES;
+"
+
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
+CREATE USER 'log_flush'@'127.0.0.1' IDENTIFIED BY 'afe123456';
+GRANT RELOAD ON *.* TO 'log_flush'@'127.0.0.1';
+FLUSH PRIVILEGES;
+"
+```
+
+**B. 创建 G3SF 相关业务账号**
+
+Docker 执行：
+```bash
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
+CREATE USER 'g3sf'@'%' IDENTIFIED BY 'k2-fkW@7z>zSYQo';
+GRANT ALL PRIVILEGES ON *.* TO 'g3sf'@'%';
+CREATE USER 'g3sfreader'@'%' IDENTIFIED BY '@feg3sf10port';
+GRANT SELECT ON *.* TO 'g3sfreader'@'%';
+CREATE USER 'g3sfsupport'@'%' IDENTIFIED BY '@feg3sf10port';
+GRANT ALL PRIVILEGES ON *.* TO 'g3sfsupport'@'%';
+FLUSH PRIVILEGES;
+"
+```
+
+纯 SQL（在 MySQL 客户端中执行）：
+```sql
+-- g3sf：应用库完全访问
+CREATE USER 'g3sf'@'%' IDENTIFIED BY 'k2-fkW@7z>zSYQo';
+GRANT ALL PRIVILEGES ON *.* TO 'g3sf'@'%';
+-- g3sfreader：只读
+CREATE USER 'g3sfreader'@'%' IDENTIFIED BY '@feg3sf10port';
+GRANT SELECT ON *.* TO 'g3sfreader'@'%';
+-- g3sfsupport：支持库完全访问
+CREATE USER 'g3sfsupport'@'%' IDENTIFIED BY '@feg3sf10port';
+GRANT ALL PRIVILEGES ON *.* TO 'g3sfsupport'@'%';
+FLUSH PRIVILEGES;
+```
+
+#### 步骤 6: 在还原机上连接主 DB 并启动复制（在还原机执行）
+
+在**还原机**上配置复制源为主库（将 `NODE_A_IP` 替换为实际主 DB 的 IP）：
 
 **A. Docker 执行模式 (包含 -h127.0.0.1):**
 ```bash
+# 将 NODE_A_IP 替换为主 DB 的 IP
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
+STOP REPLICA;
+RESET REPLICA ALL;
+CHANGE REPLICATION SOURCE TO
+  SOURCE_HOST = 'NODE_A_IP',
+  SOURCE_PORT = 3306,
+  SOURCE_USER = 'repl',
+  SOURCE_PASSWORD = 'afe123456',
+  SOURCE_AUTO_POSITION = 1,
+  SOURCE_CONNECT_RETRY = 10,
+  SOURCE_RETRY_COUNT = 9999999999,
+  GET_SOURCE_PUBLIC_KEY = 1;
 START REPLICA;
 "
 ```
 
 **B. 纯 SQL 模式:**
 ```sql
+STOP REPLICA;
+RESET REPLICA ALL;
+CHANGE REPLICATION SOURCE TO
+  SOURCE_HOST = 'NODE_A_IP',   -- 主 DB IP
+  SOURCE_PORT = 3306,
+  SOURCE_USER = 'repl',
+  SOURCE_PASSWORD = 'afe123456',
+  SOURCE_AUTO_POSITION = 1,
+  SOURCE_CONNECT_RETRY = 10,
+  SOURCE_RETRY_COUNT = 9999999999,
+  GET_SOURCE_PUBLIC_KEY = 1;
 START REPLICA;
 ```
 
-等待 3 秒后，检查同步状态：
+等待几秒后检查复制状态，确认 IO/SQL 均为 Yes：
 
-**A. Docker 执行模式 (包含 -h127.0.0.1):**
 ```bash
-sleep 3
+sleep 5
 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "SHOW REPLICA STATUS\G"
 ```
 
-**B. 纯 SQL 模式:**
-```sql
--- 等待 3 秒后执行
-SHOW REPLICA STATUS\G;
-```
-
 检查关键指标：
 - `Replica_IO_Running`: 应为 `Yes`
 - `Replica_SQL_Running`: 应为 `Yes`
-- `Last_IO_Error`: 应为空
+- `Last_IO_Error` / `Last_SQL_Error`: 应为空
-- `Last_SQL_Error`: 应为空
+
-- `Seconds_Behind_Source`: 延迟秒数（应逐渐减小）
+状态正常后，再进行步骤 7，在主库上配置指向本机（还原机/备份库）。
+
+#### 步骤 7: 在主库上配置指向备份库（还原机）并检查状态（在主库执行）
+
+在**主备份数据库（主库）**上配置复制源为当前还原机（备份库），将 `NODE_B_IP` 替换为还原机/备份 DB 的 IP：
+
+**A. Docker 执行模式 (包含 -h127.0.0.1):**
+```bash
+# 将 NODE_B_IP 替换为备份 DB（还原机）的 IP
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "
+STOP REPLICA;
+RESET REPLICA ALL;
+CHANGE REPLICATION SOURCE TO
+  SOURCE_HOST = 'NODE_B_IP',
+  SOURCE_PORT = 3306,
+  SOURCE_USER = 'repl',
+  SOURCE_PASSWORD = 'afe123456',
+  SOURCE_AUTO_POSITION = 1,
+  SOURCE_CONNECT_RETRY = 10,
+  SOURCE_RETRY_COUNT = 9999999999,
+  GET_SOURCE_PUBLIC_KEY = 1;
+START REPLICA;
+"
+```
+
+**B. 纯 SQL 模式:**
+```sql
+STOP REPLICA;
+RESET REPLICA ALL;
+CHANGE REPLICATION SOURCE TO
+  SOURCE_HOST = 'NODE_B_IP',   -- 备份 DB（还原机）IP
+  SOURCE_PORT = 3306,
+  SOURCE_USER = 'repl',
+  SOURCE_PASSWORD = 'afe123456',
+  SOURCE_AUTO_POSITION = 1,
+  SOURCE_CONNECT_RETRY = 10,
+  SOURCE_RETRY_COUNT = 9999999999,
+  GET_SOURCE_PUBLIC_KEY = 1;
+START REPLICA;
+```
+
+等待几秒后再次检查主库复制状态：
+
+```bash
+sleep 5
+docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "SHOW REPLICA STATUS\G"
+```
+
+确认：
+- `Replica_IO_Running`: 应为 `Yes`
+- `Replica_SQL_Running`: 应为 `Yes`
+- `Last_IO_Error` / `Last_SQL_Error`: 应为空
+- `Seconds_Behind_Source`: 延迟应逐渐减小
+
+至此，全量备份还原与主从（含主库侧）复制配置完成。
 
 ### 2.3 注意事项
 
 1. **备份时机**: 建议在业务低峰期执行备份，减少对业务的影响
 2. **网络传输**: 确保备份机和还原机之间网络畅通，备份文件较大时传输可能需要较长时间
-3. **磁盘空间**: 确保还原机有足够的磁盘空间存放备份文件和临时解压文件
+3. **磁盘空间**: 确保还原机有足够的磁盘空间存放备份文件和临时解压文件；还原前清空 `/data/mysql/data` 前请确认该路径为当前 MySQL 数据目录
-4. **权限要求**: 脚本需要 MySQL root 权限，以及 `/data/backup/mysql/` 目录的读写权限
+4. **权限要求**: 脚本需要 MySQL root 权限，以及 `/data/backup/mysql/`、`/data/mysql/data` 等目录的相应权限
 5. **GTID 一致性**: 还原脚本会自动处理 GTID，确保复制能够正常继续
-6. **备份机同步**: 还原完成后务必在备份机（主库）上执行 `START REPLICA` 并检查状态，确保双向复制正常
+6. **还原前准备**: 还原前必须在还原机上删除 `/data/mysql/data` 数据并重启 MySQL 容器（步骤 3），再执行还原脚本，避免旧数据与备份冲突
+7. **账号与复制顺序**: 还原后先创建账号（步骤 5），再在还原机配置指向主库的复制并检查状态（步骤 6），最后在主库上配置指向还原机的复制并检查状态（步骤 7），确保双向复制正常

skills/g3fo-docs/references/middleware/redis/deploy.md

@@ -1,15 +1,19 @@
 # Redis Sentinel 高可用架构部署与运维手册
 
 ## 一、概述
+
 ### 1.1 核心功能
+
 Redis Sentinel（哨兵）是 Redis 的高可用解决方案。其核心目标是实现主从切换的自动化，确保系统在主节点故障时能够自动选举新的主节点并恢复服务。
 
 ### 1.2 适用场景
+
 - 生产环境下的 Redis 高可用需求。
 - 需要自动故障转移（Failover）的分布式系统。
 - 读写分离架构。
 
 ### 1.3 前置条件
+
 - **运行环境**：Docker & Docker Compose。
 - **镜像版本**：推荐使用 Redis 8.4.0 及以上版本。
 - **网络规划**：所有节点需网络互通，且需明确各宿主机的外部 IP。
@@ -17,9 +21,11 @@ Redis Sentinel（哨兵）是 Redis 的高可用解决方案。其核心目标
 ---
 
 ## 二、环境准备
+
 在所有节点（主节点、从节点、哨兵节点）上执行目录初始化及权限设置。
 
 ### 2.1 目录结构配置
+
 ```bash
 # 创建配置、数据、日志目录
 mkdir -p /data/redis/{conf,data,logs}
@@ -34,9 +40,11 @@ chmod -R 750 /data/redis
 ## 三、部署流程
 
 ### 3.1 Docker 服务编排
+
 使用 Docker Compose 部署 Redis 服务及 Sentinel 节点。
 
 **docker-compose.yml 示例：**
+
 ```yaml
 version: '3.8'
 
@@ -49,9 +57,9 @@ services:
     ports:
       - "6379:6379"
     volumes:
-      - /etc/localtime:/etc/localtime:ro
+      - /etc/localtime:/etc/localtime
-      - /etc/timezone:/etc/timezone:ro
+      - /etc/timezone:/etc/timezone
-      - /data/redis/conf:/etc/redis
+      - /data/redis/conf/redis.conf:/etc/redis/redis.conf
       - /data/redis/data:/data
       - /data/redis/logs:/var/log/redis
     command: redis-server /etc/redis/redis.conf
@@ -66,7 +74,9 @@ services:
     ports:
       - "26379:26379"
     volumes:
-      - /data/redis/conf:/etc/redis
+      - /etc/localtime:/etc/localtime
+      - /etc/timezone:/etc/timezone
+      - /data/redis/conf/sentinel.conf:/etc/redis/sentinel.conf
       - /data/redis/logs:/var/log/redis
     command: redis-sentinel /etc/redis/sentinel.conf
     networks:
@@ -82,6 +92,7 @@ networks:
 ## 四、核心配置说明
 
 ### 4.1 Redis 服务端配置 (`redis.conf`)
+
 ```Properties
 # 基础配置
 bind 0.0.0.0
@@ -142,7 +153,9 @@ auto-aof-rewrite-min-size 64mb
 
 notify-keyspace-events AE
 ```
+
 从节点添加配置
+
 ```Properties
 # 指定广播地址，即使 Docker 内部获取到的是 172.x，也强制告诉 Sentinel 我是 ${REDIS_SLAVE_IP}
 replica-announce-ip ${REDIS_SLAVE_IP}
@@ -152,10 +165,12 @@ replicaof ${REDIS_MASTER_IP} 6379
 # 从节点只读（默认开启，避免误写）
 replica-read-only yes
 ```
+
 以下为生产环境推荐的核心配置项：
 
+
 | 配置项                    | 说明                        | 推荐值                |
-| :--- | :--- | :--- |
+| ---------------------- | ------------------------- | ------------------ |
 | `bind`                 | 绑定 IP 地址                  | `0.0.0.0`          |
 | `protected-mode`       | 保护模式                      | `no`               |
 | `port`                 | 监听端口                      | `6379`             |
@@ -165,9 +180,11 @@ replica-read-only yes
 | `appendonly`           | 开启 AOF 持久化                | `yes`              |
 | `aof-use-rdb-preamble` | 开启混合持久化                   | `yes`              |
 
+
 > **注意：** 在从节点配置中，必须包含 `replicaof <master-ip> 6379` 以建立主从关系。
 
 ### 4.2 哨兵配置 (`sentinel.conf`)
+
 ```Properties
 # 基础配置
 bind 0.0.0.0
@@ -201,19 +218,23 @@ sentinel failover-timeout mymaster 180000
 # 禁止Sentinel在故障转移后自动重配置主节点（Docker环境下无需开启）
 sentinel deny-scripts-reconfig yes
 ```
+
 哨兵节点用于监控主节点状态并协调切换。
 
+
 | 配置项                                | 说明                   | 示例值                                  |
-| :--- | :--- | :--- |
+| ---------------------------------- | -------------------- | ------------------------------------ |
 | `sentinel monitor`                 | 监控主节点（名称、IP、端口、法定人数） | `mymaster ${REDIS_MASTER_IP} 6379 2` |
 | `sentinel auth-pass`               | 主节点访问密码              | `mymaster afe123456`                 |
 | `sentinel down-after-milliseconds` | 故障判定超时时间（毫秒）         | `30000`                              |
 | `sentinel failover-timeout`        | 故障转移超时时间             | `180000`                             |
 | `sentinel announce-ip`             | 宣告哨兵外部 IP            | 宿主机实际 IP                             |
 
+
 ---
 
 ## 五、客户端集成（Redisson）
+
 在 Spring Boot 应用中，使用 Redisson 实现哨兵模式的连接：
 
 ```yaml
@@ -307,12 +328,14 @@ spring:
 ## 六、运维常用命令
 
 ### 6.1 哨兵管理命令
+
 详细的 Redis 常用命令及 Sentinel 运维操作请参考：[Redis 常用命令使用指南](./usage.md)
 
 通过 `redis-cli` 连接哨兵端口（默认 26379）执行：
 
+
 | 命令                                        | 功能描述              |
-| :--- | :--- |
+| ----------------------------------------- | ----------------- |
 | `SENTINEL masters`                        | 列出所有被监控的主节点状态     |
 | `SENTINEL master <name>`                  | 查看指定主节点的详细信息      |
 | `SENTINEL slaves <name>`                  | 查看指定主节点的从节点列表     |
@@ -322,15 +345,18 @@ spring:
 | `SENTINEL reset <pattern>`                | 重置配置，清除过期节点信息     |
 | `SENTINEL ckquorum <name>`                | 检查当前哨兵数量是否满足法定人数  |
 
+
 ---
 
 ## 七、注意事项与最佳实践
 
 > 注意：
+>
 > 1. **脑裂保护**：建议配置 `min-replicas-to-write 1` 和 `min-replicas-max-lag 10`，确保主库至少有 1 个正常的从库时才允许写入，防止网络分区导致的数据丢失。
 > 2. **Docker 网络**：在容器环境下，务必配置 `replica-announce-ip` 和 `sentinel announce-ip`，否则哨兵可能会记录容器内部 IP 导致客户端无法连接。
 > 3. **持久化平衡**：推荐开启混合持久化（AOF + RDB），并设置 `appendfsync everysec` 以平衡性能与安全性。
 > 4. **权限细化**：生产环境建议将 `/data/redis` 目录权限进一步收紧，仅允许特定 UID 访问。
 
 ---
+
 **参考资料**：[Redisson 官方配置文档](https://redisson.pro/docs/configuration/#sentinel-yaml-config-format)

skills/g3fo-nacos-config/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: g3fo-nacos-config
+description: 分析并修改 g3fo-db/当前工作区下 nacos_config 目录中的配置。若当前项目没有 nacos_config 则提示用户打开 g3fo-db 或提供 g3fo-db 路径。支持添加、修改 yml 配置及添加配置注释；需引导用户确认「场」与「单个配置文件」；当添加/修改位置不确定时必须先与用户确认再执行；在合适位置、正确缩进下编辑。
+---
+
+# nacos_config 分析与修改
+
+## 目录结构
+
+- **根路径**：当前工作区根目录下的 `nacos_config`；若不存在则要求用户打开 g3fo-db 或提供 g3fo-db 的明确路径。
+- **场（site）**：`nacos_config/{site_name}/`，每个子目录为一个场（如 afe_ap、dev_200、uat_226、vn-demo 等）。场列表通过列出 `nacos_config` 子目录动态得到，不写死。
+- **配置文件**：每场下多为 yml，常见有 `common.yml`、`dubbo.yml`、`mysql.yml`、`redis.yml`、`rocketmq.yml` 以及各服务 `g3fo-*-dev.yml` 等。
+
+## 用户交互流程（必须按顺序执行）
+
+### 0. 确认 nacos_config 所在位置
+
+- 先检查**当前工作区根目录**下是否存在 `nacos_config`。
+- **若不存在**：提示「当前项目下未找到 `nacos_config` 目录」，引导用户二选一：
+  - 请先**打开 g3fo-db 项目**再操作，或
+  - **提供 g3fo-db 项目的明确路径**（后续操作基于该路径下的 `nacos_config`）。
+- 在用户完成其一之前**不执行任何配置编辑**。
+- 若存在或用户已提供路径，继续下一步。
+
+### 1. 确定要修改的场
+
+- 若用户**未明确**要改哪个场：反问用户，并**列出**（当前工作区或用户提供的 g3fo-db 路径下的）`nacos_config` 下所有子目录（即所有场），引导用户选择**一个或多个场**，或选择「**全部场**」。
+- 若用户已明确指定场，则直接使用。
+
+### 2. 确定要修改的配置文件
+
+- 若用户**未指定**配置文件，或指定了**多个**：**引导用户确认仅一个**配置文件（如 `common.yml`、`dubbo.yml` 等）。
+- 若用户已明确指定一个配置文件，则直接使用。
+
+### 3. 确定添加/修改位置（必须遵守）
+
+- **当不确定**要把新配置加在哪个位置、或要改哪一处时：**必须先与用户确认**（列出可选位置或给出建议，等用户选定），**再执行**编辑；不得在位置模糊时自行猜测并修改。
+
+### 4. 执行修改
+
+在选定的每个「场」下，对选定的配置文件进行编辑：
+
+- **添加**：根据要添加的 key 路径（如 `dubbo.application.metadata-service-port`）在文件中找合适位置——若已有同名顶级块（如 `dubbo`）则合并到该块下并保持 2 空格缩进；若无则新增顶级块，放在与现有顶级键风格一致的位置。位置不明确时先与用户确认再执行。
+- **修改**：若 key 已存在，则只改值并保持原有缩进与注释风格；若存在多处或歧义，先与用户确认再执行。
+- **添加配置的注释**：在指定 key 上方或行尾添加注释，风格与文件内现有注释一致；位置不明确时先与用户确认再执行。
+
+**YAML 规则**：一律 **2 空格缩进**；新加块与现有同级键对齐；不破坏现有注释与键顺序。若文件中已有 `dubbo` 块，新 dubbo 相关项应合并到该块下，避免重复顶级 `dubbo`。插入新顶级块时的常见顺序可参考 [references/yml-placement.md](references/yml-placement.md)。
+
+## 示例
+
+**在 common.yml 中添加 dubbo 配置**
+
+若 `common.yml` 中尚无顶级 `dubbo`，可新增顶级块（与 `server`、`spring` 等同级），例如：
+
+```yaml
+dubbo:
+  application:
+    metadata-service-port: 28101
+```
+
+若 `common.yml` 或目标文件中已有 `dubbo:` 块，则将 `metadata-service-port` 合并到 `dubbo.application` 下，保持 2 空格缩进，不新增重复的 `dubbo:` 顶级键。
+
+## 约定摘要
+
+- **路径**：优先用当前工作区的 `nacos_config`；没有则要求用户打开 g3fo-db 或提供 g3fo-db 路径。
+- **确认优先**：添加/修改/注释的**目标位置**一旦不确定，必须先与用户确认再执行，不得自行猜测。

skills/g3fo-nacos-config/references/yml-placement.md

@@ -0,0 +1,14 @@
+# nacos_config 常见顶级键与插入顺序
+
+在 common.yml、dubbo.yml 等文件中插入**新的顶级块**时，可参考以下常见顺序，以保持与现有风格一致：
+
+- `server`
+- `spring`
+- `swagger` / `springdoc` / `knife4j`
+- `logging`
+- `management`
+- `powerjob`
+- `dubbo`
+- 其他自定义顶级键（如 `webdav`、`db-delete-logs.table.include.list`、`actuator-url` 等）
+
+同一文件中若已存在某顶级键（如 `dubbo`），新配置应**合并到该块下**，而不是再起一个同名顶级块。