@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.10

package/skills/meritdata-platform-messaging/references/msg-center//346/224/273/347/225/245-12-/346/266/210/346/201/257/344/270/255/345/277/203-/347/253/240/350/212/20204_/351/231/204/357/274/232/351/231/204/344/273/266/344/270/212/344/274/240/344/270/213/350/275/275/345/210/240/351/231/244/346/216/245/345/217/243.md

@@ -0,0 +1,183 @@
+---
+name: 攻略-12-消息中心-章节04_附：附件上传下载删除接口
+description: 附：附件上传下载删除接口 — 美林平台消息中心攻略（使用场景 / 页面功能 / 接口功能 / 附件）
+keywords: [消息中心, 消息管理, 消息提醒, 消息列表, 附件上传, 附件下载, 定时发送, 消息模板, 附：附件上传下载删除接口]
+use-cases: [消息中心页面使用, 消息发送 API, 附件上传下载, 定时消息]
+source-section: 无编号. 附：附件上传下载删除接口
+source-file: 应用开发平台-基础平台-使用攻略（十一）：消息中心.md
+---
+
+# 附：附件上传下载删除接口
+
+#### 附件上传
+
+- method : post
+- url : http://IP:端口/gateway/cloud-system-manage/api/enclosure/upload 
+
+[IMG: image-20210701152410689]
+
+
+
+#### 附件下载
+
+- ​	method : get
+
+- ​	url : http://IP:端口/gateway/cloud-system-manage/api/enclosure/download
+
+
+​	无返回参数，下载文件
+
+#### 附件列表
+
+- ​	method : get
+
+- ​	url :http://IP:端口/gateway/cloud-system-manage/api/enclosure/list
+
+
+[IMG: image-20210701152410689]
+
+```json
+{
+    "timestamp": 1618390379395,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/enclosure/list",
+    "data": [
+        {
+            "tenantId": "",
+            "createTime": null,
+            "updateTime": 1618291808000,
+            "creatorId": null,
+            "reviserId": null,
+            //文件ID
+            "id": "3f28811578c8ba4a0178c9b55837001a",
+             //文件名称
+            "name": "图形化安装部署手册.html",
+             //文件大小  Byte
+            "size": 103974972,
+              //文件路径 
+            "path": "E:\\merit_cloud/enclosure/图形化安装部署手册.html"
+        },
+        {
+            "tenantId": "",
+            "createTime": null,
+            "updateTime": 1618291817000,
+            "creatorId": null,
+            "reviserId": null,
+            "id": "3f28811578c8ba4a0178c9b57c58001b",
+            "name": "安装.html",
+            "size": 30185,
+            "path": "E:\\merit_cloud/enclosure/安装.html"
+        }
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+
+​	
+
+### 备注
+
+#### 自定义消息内容
+
+使用场景：
+
+​		当发送的消息内容只有局部改变时，可使用此方法。例如：需要发送的消息内容为：
+
+```
+"今年的净利润为$profit，总收入为$count,总支出为$expendture"
+```
+
+​			其中净利润值，总收入，总支出是可修改变量，其他内容改变频率极低，这时可使用自定义模板，需要设置msgType为唯一值（假设设置为：money）。具体操作流程如下：
+
+首先新建模板，调用新增模板接口
+
+url : http://IP:端口/gateway/cloud-system-manage/api/announcement/save
+
+[IMG: image-20210701152410689]
+
+请求成功后拿到返回结果如下：
+
+```json
+{
+    "timestamp": 1660730394254,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/announcement/save",
+    "data": {
+        "tenantId": "",
+        "secretCode": null,
+        "secretName": null,
+        "createTime": null,
+        "updateTime": 1660730394251,
+        "creatorId": null,
+        "reviserId": null,
+        "id": "3f28835482aacb860182ab3ec68d000a",
+        "isSend": "0",
+        "msgType": "money",
+        "title": "收入支出明细",
+        "senderId": "admin",
+        "senderName": "系统管理员",
+        "sendTime": 1660730394252,
+        "isRead": "0",
+        "detailContent": "今年的净利润为$profit，总收入为$count,总支出为$expendture",
+        "receiverId": "",
+        "receiverName": "",
+        "receiverSessionId": null,
+        "showType": null,
+        "url": "",
+        "enclosureIds": "",
+        "isModel": "1",
+        "isTimer": "0",
+        "cronConfig": null,
+        "timeSend": null
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+需要发送消息时，查询模板列表中msgType为money的对象，拿到消息模板内容和标题（附件按需添加）
+
+```json
+detailContent ="今年的净利润为$profit，总收入为$count,总支出为$expendture";
+titile="收入支出明细";
+```
+
+然后替换的数据为key value键值对,可以用json,map，Java代码示例如下：
+
+```java
+#JSON键值对
+JSONObject data=new JSONObject();
+data.put("$profit":"100"),
+data.put("$expendture":"100"),
+data.put("$count":"200"),
+#Map键值对
+Map<String,Object> data=new HashMap<>();
+data.push("$profit":"100"),
+data.push("$expendture":"100"),
+data.push("$count":"200"),
+```
+
+遍历键值对后替换***detailContent***内容：
+
+```java
+JSON替换方法
+Iterator<String> keys=data.kets();
+while(keys.hasNext()){
+  String key=keys.next();
+  detailContent.replace(key,data.get("key"));
+}JAVA
+Map替换方法
+Set set=data.entrySet();
+for(Iterator iter=set.iterator();iter.hasNext()){
+ Map.Entry entry=(Map.Entry) iter.next();
+ String key=(String) entry.getKey();
+ detailContent.replace(key,entry.getValue());
+}
+```
+
+替换***detailContent***后，设置发送内容和标题，即可完成模板内容替换。调用  **3.1.1 新增消息接口**    将消息发送给用户

package/skills/meritdata-platform-nacos-importer/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: meritdata-platform-nacos-importer
+description: 美林平台二开工程的 Nacos 配置导入 —— 主要用途：二开过程中新生成/修改了一个 properties 文件，调用此 skill 把它导入到 Nacos（避免手动去 Nacos Web 端逐个上传）。也支持批量扫描导入。支持 Windows / macOS / Linux —— Windows 用 scripts/import-nacos.ps1，macOS/Linux 用 scripts/import-nacos.sh（先 chmod +x）。Use when a 2nd-dev module adds a new common-XYZ.properties config file, when modifying existing Nacos config and need to push to Nacos, or when scripting config import in CI/CD. Default user/password is admin / BigData.2018v6 and default host is 127.0.0.1:8849.
+metadata:
+  type: procedure
+---
+
+# 美林平台二开工程 Nacos 配置导入
+
+## ⚡ 快速开始：先选你的操作系统
+
+| 你的系统 | 用这个脚本 | 第一次用前 |
+|---|---|---|
+| **Windows** | `scripts/import-nacos.ps1` | 无（PowerShell 默认禁止，用 `-ExecutionPolicy Bypass`）|
+| **macOS / Linux** | `scripts/import-nacos.sh` | `chmod +x scripts/import-nacos.sh` |
+
+## 主要用途（单文件场景）
+
+二开过程中，**新生成或修改了某个 properties 文件**（如 `common-contract-X.properties`），调此 skill **把这个文件导入到 Nacos**。
+
+### Windows
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/import-nacos.ps1 `
+    -FilePath "<项目根>\Nacos 导出目录\DEFAULT_GROUP\common-contract-X.properties"
+```
+
+### macOS / Linux
+
+```bash
+# 第一次用前（之后不用）
+chmod +x scripts/import-nacos.sh
+
+# 导入单文件
+bash scripts/import-nacos.sh /path/to/DEFAULT_GROUP/common-contract-X.properties
+```
+
+**输出**（两个平台一致）：
+```
+=== Nacos config import ===
+  Nacos: 127.0.0.1:8849  User: admin  Group: DEFAULT_GROUP
+
+  Mode: single file
+  Files to import: 1
+    - common-contract-X.properties
+
+  Login... OK
+  Publish common-contract-X.properties ... OK
+
+=== Done ===
+  Success: 1  Failed: 0
+
+Next: restart backend services to pick up new Nacos config
+```
+
+## 参数化（两个脚本通用）
+
+| 参数 | 默认值 | 环境变量 | 说明 |
+|---|---|---|---|
+| 单文件路径 | （无）| — | **主用途**：传要导入的 properties 文件路径 |
+| 扫描目录 | `<脚本目录>/DEFAULT_GROUP` | — | 不传单文件路径时启用，扫 *.properties |
+| `-NacosHost` / `$NACOS_HOST` | `127.0.0.1:8849` | `NACOS_HOST` | Nacos 地址 |
+| `-User` / `$NACOS_USER` | `admin` | `NACOS_USER` | Nacos 用户名 |
+| `-Pass` / `$NACOS_PASSWORD` | `BigData.2018v6` | `NACOS_PASSWORD` | Nacos 密码 |
+| `-Group` / `$NACOS_GROUP` | `DEFAULT_GROUP` | `NACOS_GROUP` | 配置分组 |
+| `-Type` / `$NACOS_TYPE` | **`properties`** | `NACOS_TYPE` | 配置类型（properties/text/yaml/json/xml/html）|
+
+### 两种模式
+
+| 模式 | 调用 | 场景 |
+|------|------|------|
+| **单文件**（主）| 传单文件路径 | 你刚写/改了一个文件，导入它 |
+| **批量扫描** | 不传文件路径 | 一次导入多份（CI/初始化）|
+
+## 平台路径配置
+
+本 skill 自身完整，**不依赖其他 skill**。以下变量按你环境替换：
+
+| 变量 | 默认值 | 覆盖方式 |
+|------|--------|---------|
+| `NACOS_HOST` | `127.0.0.1:8849` | `-NacosHost` 参数 / `NACOS_HOST` 环境变量 |
+| `NACOS_USER` | `admin` | `-User` / `NACOS_USER` |
+| `NACOS_PASSWORD` | `BigData.2018v6` | `-Pass` / `NACOS_PASSWORD` |
+| `NACOS_GROUP` | `DEFAULT_GROUP` | `-Group` / `NACOS_GROUP` |
+| `NACOS_TYPE` | **`properties`** | `-Type` / `NACOS_TYPE`（可选 text/yaml/json/xml/html）|
+
+**默认配置在本地 Windows 平台**（admin / BigData.2018v6）。其他平台（macOS / Linux）需用上述环境变量或参数覆盖，**Nacos 凭据应保持一致**（美林平台 Nacos 统一用 `admin / BigData.2018v6`）。
+
+## 关键技术细节
+
+| 细节 | 说明 |
+|------|------|
+| API 路径必须带 `/nacos/` 前缀 | `POST /nacos/v1/cs/configs`（**不是** `/v1/cs/configs`）|
+| 鉴权 | `POST /nacos/v1/auth/login` 拿 accessToken |
+| dataId | = 文件名（含 `.properties`）|
+| **type 参数** | **必传 `type=properties`**（Nacos 默认 `text` 对 properties 文件不友好：后端按文本读、Nacos 控制台也不格式化）。可选值：`properties` / `text` / `yaml` / `json` / `xml` / `html` |
+| content 传递 | **必须用 form body**（hashtable 或 `--data-urlencode content@file`），不是 URL query — 大文件 11.5KB 触发 Tomcat header 长度限制 |
+| 重启生效 | 后端启动时从 Nacos 拉配置；改完 Nacos 需**重启后端**才生效 |
+
+## 常见问题
+
+| 问题 | 原因 | 解决 |
+|------|------|------|
+| "Nacos unreachable" / login FAIL | 8849 没监听 | `netstat -ano \| grep 8849`；没启动就 `cd mids\nacos\bin; .\startup.cmd`（启动需 30-60s）|
+| "No accessToken" / 401 | 用户名/密码错 | 默认 `admin / BigData.2018v6`；用 `-User` / `-Pass` 覆盖 |
+| HTTP 400 "Required parameter 'content' is not present" | content 没在 body 里 | 用 hashtable body（`-Body @{content=...}`）或 `--data-urlencode content@file` |
+| Nacos 控制台显示纯文本，无 key/value 高亮 | 没传 `type=properties` | 用本 skill（默认 properties）；或手动加 `-Type properties` / `$NACOS_TYPE=properties` |
+| 后端读不到 key-value | type 默认 text | 重新导入并传 `type=properties` |
+| HTTP 400 "MySQL 1366" | Nacos content 列不支持 UTF-8 中文 | 先用 `grep -v` 过滤中文行，或改 Nacos 库的 content 列为 utf8mb4 |
+| `chmod: command not found` | 在 Windows 上跑了 chmod | Windows 用户**不要 chmod**（用 .ps1）|
+| 后端配置没生效 | Nacos 改了但后端没重启 | 重启后端 |
+
+## 🔗 关联
+
+- `scripts/import-nacos.ps1` — Windows 脚本（本 skill 自带）
+- `scripts/import-nacos.sh` — macOS / Linux 脚本（本 skill 自带）
+- `meritdata-platform-menu-config` — 创建菜单后还需在 cloud-system-manage 系统管理里勾"显示"+分配角色
+- 项目内置脚本：**项目根目录**下的 `import-to-nacos.ps1`（功能相同，可直接用）
+
+> **设计原则**：本 skill **自包含**（变量都在 SKILL.md 自己的"美林平台环境变量"表里），**不依赖**其他 skill（如 `meritdata-platform-frontend-deploy` 的 `environment.md`）。每个 skill 独立安装即可使用。

package/skills/meritdata-platform-nacos-importer/agents/openai.yaml

@@ -0,0 +1,22 @@
+display_name: "Nacos 配置导入"
+short_description: "把 properties 文件导入 Nacos（PowerShell + Bash 脚本）"
+default_prompt: |
+  meritdata-platform-nacos-importer 处理二开过程中 Nacos 配置导入。
+
+  适用场景：
+  - 单文件导入（主用途）
+  - 批量扫描导入（CI/初始化）
+  - 修改现有 Nacos 配置后推送
+
+  使用方式：
+  ```
+  $meritdata-platform-nacos-importer <properties 文件路径>
+  ```
+
+  工作方式：
+  1. 选择平台（Windows 用 .ps1，macOS/Linux 用 .sh）
+  2. 运行 import-nacos 脚本，传入文件路径或扫描目录
+
+  强制约束：
+  - 必须传 type=properties（否则 Nacos 按 text 读）
+  - 凭据必须来自受管配置（默认 admin / BigData.2018v6）

package/skills/meritdata-platform-nacos-importer/references/README.md

@@ -0,0 +1,9 @@
+# meritdata-platform-nacos-importer References
+
+暂无独立参考文档。详细使用方式见 [SKILL.md](../SKILL.md)。
+
+## 关联资源
+
+- `scripts/import-nacos.ps1` — Windows 脚本
+- `scripts/import-nacos.sh` — macOS/Linux 脚本
+- `scripts/chmod.sh` — 文件权限设置

package/skills/meritdata-platform-nacos-importer/scripts/import-nacos.ps1

@@ -0,0 +1,95 @@
+# ============================================
+# Nacos config import script (single file or batch scan)
+# Path: .claude/skills/merit-nacos-importer/scripts/import-nacos.ps1
+# Usage (single file, MAIN use case):
+#     powershell -ExecutionPolicy Bypass -File .\import-nacos.ps1 `
+#         -FilePath "<项目根>\Nacos 导出目录\DEFAULT_GROUP\common-XYZ.properties"
+# Usage (batch scan):
+#     powershell -ExecutionPolicy Bypass -File .\import-nacos.ps1
+# Optional: -NacosHost / -User / -Pass / -Group
+# Env vars (override defaults): $env:NACOS_HOST / NACOS_USER / NACOS_PASSWORD
+# Default: 127.0.0.1:8849 / admin / BigData.2018v6 / DEFAULT_GROUP
+# ============================================
+
+param(
+    [string]$FilePath  = "",                    # single file to import (MAIN use case)
+    [string]$ScanDir   = "",                    # dir to scan for *.properties (batch mode)
+    [string]$NacosHost = $env:NACOS_HOST,
+    [string]$User      = $env:NACOS_USER,
+    [string]$Pass      = $env:NACOS_PASSWORD,
+    [string]$Group     = "DEFAULT_GROUP",
+    [string]$Type      = $env:NACOS_TYPE        # Nacos config type (default: properties)
+)
+
+# 1. Defaults
+if (-not $NacosHost) { $NacosHost = "127.0.0.1:8849" }
+if (-not $User)      { $User = "admin" }
+if (-not $Pass)      { $Pass = "BigData.2018v6" }
+if (-not $Type)      { $Type = "properties" }   # Nacos config type（默认 properties，可改 text/yaml/json）
+
+Write-Host "=== Nacos config import ===" -ForegroundColor Cyan
+Write-Host "  Nacos: $NacosHost  User: $User  Group: $Group  Type: $Type"
+Write-Host ""
+
+# 2. Resolve what to import
+$Files = @()
+if ($FilePath) {
+    if (!(Test-Path $FilePath)) { Write-Host "  File not found: $FilePath" -ForegroundColor Red; exit 1 }
+    $Files = @(Get-Item $FilePath)
+    Write-Host "  Mode: single file" -ForegroundColor Green
+} else {
+    if (-not $ScanDir) { $ScanDir = Join-Path $PSScriptRoot "DEFAULT_GROUP" }
+    if (!(Test-Path $ScanDir)) { Write-Host "  ScanDir not found: $ScanDir (and no -FilePath given)" -ForegroundColor Red; exit 1 }
+    $Files = Get-ChildItem -Path $ScanDir -Filter "*.properties" | Sort-Object Name
+    if ($Files.Count -eq 0) { Write-Host "  No .properties in $ScanDir" -ForegroundColor Red; exit 1 }
+    Write-Host "  Mode: batch scan ($ScanDir)" -ForegroundColor Green
+}
+Write-Host "  Files to import: $($Files.Count)"
+foreach ($f in $Files) { Write-Host "    - $($f.Name)" }
+Write-Host ""
+
+# 3. Login (also reachability check)
+Write-Host "  Login..." -NoNewline
+try {
+    $loginRes = Invoke-WebRequest -Uri "http://$NacosHost/nacos/v1/auth/login" -Method POST -Body @{username=$User;password=$Pass} -UseBasicParsing -TimeoutSec 5
+    $AccessToken = ($loginRes.Content | ConvertFrom-Json).accessToken
+    if (-not $AccessToken) { throw "No accessToken: $($loginRes.Content)" }
+    Write-Host " OK" -ForegroundColor Green
+} catch {
+    Write-Host " FAIL" -ForegroundColor Red
+    Write-Host "  $($_.Exception.Message)"
+    Write-Host "  Check Nacos is running at http://$NacosHost and credentials are correct"
+    exit 1
+}
+Write-Host ""
+
+# 4. Publish each (form body to avoid URL header limit on big files)
+#    关键：传 type=properties（Nacos 默认是 text，对 properties 文件不友好：
+#    后端读取时按文本而非 key-value 解析，Nacos 控制台也不显示格式化）
+$Success = 0; $Failed = 0
+foreach ($File in $Files) {
+    $DataId = $File.Name    # dataId = filename (e.g. common-XYZ.properties)
+    $Content = Get-Content $File.FullName -Raw -Encoding UTF8
+    Write-Host "  Publish $DataId (type=$Type) ... " -NoNewline
+    try {
+        $body = @{dataId=$DataId;group=$Group;accessToken=$AccessToken;type=$Type;content=$Content}
+        $res = Invoke-WebRequest -Uri "http://$NacosHost/nacos/v1/cs/configs" -Method POST -Body $body -UseBasicParsing -TimeoutSec 30
+        if ($res.Content -eq "true") { Write-Host "OK" -ForegroundColor Green; $Success++ }
+        else { Write-Host "FAIL ($($res.Content))" -ForegroundColor Red; $Failed++ }
+    } catch {
+        $err = $_.Exception.Message
+        if ($err -match "1366") { Write-Host "FAIL (MySQL charset)" -ForegroundColor Yellow }
+        else { Write-Host "FAIL ($err)" -ForegroundColor Red }
+        $Failed++
+    }
+}
+
+Write-Host ""
+Write-Host "=== Done ===" -ForegroundColor Cyan
+Write-Host "  Success: $Success"  -ForegroundColor Green
+Write-Host "  Failed:  $Failed"  -ForegroundColor Red
+
+if ($Failed -eq 0) {
+    Write-Host ""
+    Write-Host "Next: restart backend services to pick up new Nacos config" -ForegroundColor Cyan
+}

package/skills/meritdata-platform-nacos-importer/scripts/import-nacos.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# ============================================
+# Nacos config import script (macOS / Linux)
+# Path: .claude/skills/meritdata-nacos-importer/scripts/import-nacos.sh
+# Usage (single file, MAIN use case):
+#     bash ./import-nacos.sh /path/to/DEFAULT_GROUP/common-XYZ.properties
+# Usage (batch scan):
+#     bash ./import-nacos.sh
+# Env vars (override defaults): $NACOS_HOST / $NACOS_USER / $NACOS_PASSWORD
+# Default: 127.0.0.1:8849 / admin / BigData.2018v6 / DEFAULT_GROUP
+# ============================================
+set -e
+
+# 1. Args / defaults
+FILE_PATH="${1:-}"
+SCAN_DIR="${2:-}"
+NACOS_HOST="${NACOS_HOST:-127.0.0.1:8849}"
+NACOS_USER="${NACOS_USER:-admin}"
+NACOS_PASS="${NACOS_PASSWORD:-BigData.2018v6}"
+NACOS_GROUP="${NACOS_GROUP:-DEFAULT_GROUP}"
+# Nacos config type (默认 properties；可选: text / properties / yaml / json / xml / html)
+NACOS_TYPE="${NACOS_TYPE:-properties}"
+
+echo "=== Nacos config import ==="
+echo "  Nacos: $NACOS_HOST  User: $NACOS_USER  Group: $NACOS_GROUP  Type: $NACOS_TYPE"
+echo ""
+
+# 2. Resolve files to import
+FILES=()
+if [ -n "$FILE_PATH" ]; then
+    if [ ! -f "$FILE_PATH" ]; then
+        echo "  File not found: $FILE_PATH"
+        exit 1
+    fi
+    FILES=("$FILE_PATH")
+    echo "  Mode: single file"
+else
+    if [ -z "$SCAN_DIR" ]; then
+        SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+        SCAN_DIR="$SCRIPT_DIR/DEFAULT_GROUP"
+    fi
+    if [ ! -d "$SCAN_DIR" ]; then
+        echo "  ScanDir not found: $SCAN_DIR (and no FILE_PATH given)"
+        exit 1
+    fi
+    while IFS= read -r f; do FILES+=("$f"); done < <(find "$SCAN_DIR" -maxdepth 1 -name "*.properties" | sort)
+    if [ ${#FILES[@]} -eq 0 ]; then
+        echo "  No .properties in $SCAN_DIR"
+        exit 1
+    fi
+    echo "  Mode: batch scan ($SCAN_DIR)"
+fi
+echo "  Files to import: ${#FILES[@]}"
+for f in "${FILES[@]}"; do echo "    - $(basename "$f")"; done
+echo ""
+
+# 3. Login
+echo "  Login..."
+LOGIN_RESP=$(curl -sS -m 5 -X POST "http://$NACOS_HOST/nacos/v1/auth/login" \
+    -d "username=$NACOS_USER&password=$NACOS_PASS")
+ACCESS_TOKEN=$(echo "$LOGIN_RESP" | sed -n 's/.*"accessToken":"\([^"]*\)".*/\1/p')
+if [ -z "$ACCESS_TOKEN" ]; then
+    echo "  FAIL: $LOGIN_RESP"
+    echo "  Check Nacos at http://$NACOS_HOST and credentials"
+    exit 1
+fi
+echo "  OK"
+echo ""
+
+# 4. Publish each (form body to avoid URL header limit on big files)
+#    关键：传 type=properties（Nacos 默认是 text，对 properties 文件不友好：
+#    后端读取时按文本而非 key-value 解析，Nacos 控制台也不显示格式化）
+SUCCESS=0; FAILED=0
+for FILE_PATH in "${FILES[@]}"; do
+    DATA_ID=$(basename "$FILE_PATH")
+    echo -n "  Publish $DATA_ID (type=$NACOS_TYPE) ... "
+    RESP=$(curl -sS -m 30 -X POST "http://$NACOS_HOST/nacos/v1/cs/configs" \
+        --data-urlencode "dataId=$DATA_ID" \
+        --data-urlencode "group=$NACOS_GROUP" \
+        --data-urlencode "accessToken=$ACCESS_TOKEN" \
+        --data-urlencode "type=$NACOS_TYPE" \
+        --data-urlencode "content@$FILE_PATH")
+    if [ "$RESP" = "true" ]; then
+        echo "OK"
+        SUCCESS=$((SUCCESS+1))
+    else
+        echo "FAIL ($RESP)"
+        FAILED=$((FAILED+1))
+    fi
+done
+
+echo ""
+echo "=== Done ==="
+echo "  Success: $SUCCESS"
+echo "  Failed:  $FAILED"
+
+if [ "$FAILED" -eq 0 ]; then
+    echo ""
+    echo "Next: restart backend services to pick up new Nacos config"
+fi

package/skills/meritdata-platform-org-sync/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: meritdata-platform-org-sync
+description: 组织人员同步攻略（HR/ERP/门户对接）| 触发条件：HR 系统对接 / 组织人员同步 / 资源菜单同步 / 角色同步 / 资源权限同步 / WebService 对接 / RESTful 对接 / app-key 鉴权 | 包含 7 大子攻略（组织/人员/资源菜单/角色/资源权限/同步配置）+ 概述总览 | 不适用：纯前端展示（用 meritdata-platform-frontend）| 同 JVM 调用用 meritdata-platform-integration Feign 客户端
+metadata:
+  version: "1.0.0"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-10"
+  last_updated: "2026-09-10"
+  risk: medium
+  allowed-tools: Read, Grep, Glob, Bash
+---
+
+# 组织人员同步攻略（HR/ERP/门户对接）
+
+> **来源**：从 `meritdata-platform-integration/references/org-sync/` 抽离（2026-09-10）
+> **目的**：HR 系统对接是高频且独立的场景，单独 skill 可让 AI 更精准触发
+
+## ⭐ 这是什么
+
+**组织人员同步的完整攻略集**，覆盖：
+- **组织同步**（部门树建立）
+- **人员同步**（用户账号创建/更新/删除）
+- **资源菜单同步**（外部系统菜单接入平台）
+- **角色同步**（角色定义同步）
+- **资源权限同步**（角色-资源绑定）
+- **同步配置**（对接前置准备）
+
+## 🎯 适用场景
+
+| 场景 | 用本 skill |
+|------|----------|
+| HR 系统对接 | ✅ |
+| ERP 系统对接（人员/组织） | ✅ |
+| 第三方门户接入（人员/权限）| ✅ |
+| 跨系统用户账号同步 | ✅ |
+| 同 JVM 平台模块查询人员 | ❌ → 用 `meritdata-platform-entities` 或 `meritdata-platform-session` |
+| 跨 JVM Feign 装配人员/组织 | ❌ → 用 `meritdata-platform-integration/references/external-api/full/org-user.md` |
+| 纯前端人员选择器 | ❌ → 用 `meritdata-platform-ui-components` (UserSelect) |
+
+## 📂 references（8 个攻略文件）
+
+| 文件 | 章节 | 关键内容 |
+|------|------|---------|
+| `攻略-09-组织人员同步-00_总览.md` | 总览 | 全 7 章导航 + 集成方式对比 |
+| `攻略-09-组织人员同步-章节01_概述.md` | 第 1 章 | 同步原理 + 同步场景分类 |
+| `攻略-09-组织人员同步-章节02_组织同步.md` | 第 2 章 | 组织（部门）树同步接口 |
+| `攻略-09-组织人员同步-章节03_人员同步.md` | 第 3 章 | 人员同步接口（含字段映射）|
+| `攻略-09-组织人员同步-章节04_资源菜单同步.md` | 第 4 章 | 资源菜单对接 |
+| `攻略-09-组织人员同步-章节05_角色同步.md` | 第 5 章 | 角色同步 |
+| `攻略-09-组织人员同步-章节06_资源权限同步.md` | 第 6 章 | 权限绑定 |
+| `攻略-09-组织人员同步-章节07_组织同步配置.md` | 第 7 章 | 前置配置（Nacos / app-key）|
+
+## 🚀 快速使用
+
+1. **首次接入**：从 `00_总览.md` 开始读，了解整体流程
+2. **具体实施**：直接跳到对应章节（如 HR 对接 → 第 3 章人员同步）
+3. **配置问题**：查第 7 章前置配置
+
+## 🔗 相关 skill
+
+| Skill | 何时用 |
+|-------|------|
+| `meritdata-platform-integration` | 跨 JVM 集成 / 53+ 外部接口契约（org-user / dict / resource / menu）|
+| `meritdata-platform-entities` | 同 JVM 平台模块查人员/组织（用 CloudBaseEntity 等）|
+| `meritdata-platform-session` | 当前用户/部门/角色（SessionUtils 21 方法）|
+| `meritdata-platform-ui-components` | 前端 UserSelect / DeptSelect 选人组件 |
+
+## 📌 历史
+
+- **2026-09-10**：从 `meritdata-platform-integration/references/org-sync/` 抽离为独立 skill
+- **抽离原因**：评估报告指出 HR 集成是高频但狭窄的场景，独立 skill 可让 AI 更精准触发