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

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → 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

@@ -14,7 +14,7 @@ source-file: 应用开发平台-基础平台-使用攻略（十一）：消息
 - method : post
 - url : http://IP:端口/gateway/cloud-system-manage/api/enclosure/upload 
 
-![image-20210701152410689](.\imgs\消息中心\1-42.png)
+[IMG: image-20210701152410689]
 
 
 
@@ -34,7 +34,7 @@ source-file: 应用开发平台-基础平台-使用攻略（十一）：消息
 - ​	url :http://IP:端口/gateway/cloud-system-manage/api/enclosure/list
 
 
-![image-20210701152410689](.\imgs\消息中心\1-35.png)
+[IMG: image-20210701152410689]
 
 ```json
 {
@@ -96,7 +96,7 @@ source-file: 应用开发平台-基础平台-使用攻略（十一）：消息
 
 url : http://IP:端口/gateway/cloud-system-manage/api/announcement/save
 
-![image-20210701152410689](.\imgs\消息中心\1-34.png)
+[IMG: image-20210701152410689]
 
 请求成功后拿到返回结果如下：
 

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 更精准触发

package/skills/meritdata-platform-org-sync/references//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-00_/346/200/273/350/247/210.md

@@ -0,0 +1,99 @@
+---
+name: 攻略-09-组织人员同步-00_总览
+description: 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+related: [cloud-system-manage / 1.16 外部接口]
+source: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 应用开发平台使用攻略（九）：组织和人员同步 — 总览
+
+**摘要**：美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+
+**关联**：cloud-system-manage / 1.16 外部接口
+
+## 章节索引
+
+01. [概述](攻略-09-组织人员同步-章节01_概述.md) (原 1)
+02. [组织同步](攻略-09-组织人员同步-章节02_组织同步.md) (原 2)
+03. [人员同步](攻略-09-组织人员同步-章节03_人员同步.md) (原 3)
+04. [资源菜单同步](攻略-09-组织人员同步-章节04_资源菜单同步.md) (原 4)
+05. [角色同步](攻略-09-组织人员同步-章节05_角色同步.md)
+06. [资源权限同步](攻略-09-组织人员同步-章节06_资源权限同步.md) (原 6)
+07. [组织同步配置](攻略-09-组织人员同步-章节07_组织同步配置.md) (原 7)
+
+
+## 📑 API 速查
+
+本攻略共 **6 个 API**（基于 2026-09-10 源码实测，4 大同步 + 2 个附加接口，按章节排序）：
+
+| 章节 | API | 方法 | 路径 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节02_组织同步 | `syncOrg` | POST | `/webapi/ou/sync/org` | http/WS | 同步组织（WebService + RESTful 双通道） |
+| 章节03_人员同步 | `syncUser` | POST | `/webapi/ou/sync/user` | http/WS | 同步人员（含 userId + token） |
+| 章节04_资源菜单同步 | `syncResource` | POST | `/webapi/ou/sync/resource` | http/WS | 同步资源菜单 |
+| 章节05_角色同步 | `syncRole` | POST | `/webapi/ou/sync/role` | http/WS | 同步角色 |
+| 附加（章节06）| `syncDuty` | POST | `/webapi/ou/sync/duty` | http/WS | 同步职务 |
+| 附加（章节06）| `syncAssign` | POST | `/webapi/ou/sync/assign` | http/WS | 同步资源授权 |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节02_组织同步",
+    "apiName": "syncOrg",
+    "method": "POST",
+    "urlPattern": "/webapi/ou/sync/org",
+    "type": "http/WS",
+    "signature": "",
+    "functionDesc": "同步组织（WebService + RESTful 双通道）"
+  },
+  {
+    "chapter": "章节03_人员同步",
+    "apiName": "syncUser",
+    "method": "POST",
+    "urlPattern": "/webapi/ou/sync/user",
+    "type": "http/WS",
+    "signature": "",
+    "functionDesc": "同步人员（含 userId + token）"
+  },
+  {
+    "chapter": "章节04_资源菜单同步",
+    "apiName": "syncResource",
+    "method": "POST",
+    "urlPattern": "/webapi/ou/sync/resource",
+    "type": "http/WS",
+    "signature": "",
+    "functionDesc": "同步资源菜单"
+  },
+  {
+    "chapter": "章节05_角色同步",
+    "apiName": "syncRole",
+    "method": "POST",
+    "urlPattern": "/webapi/ou/sync/role",
+    "type": "http/WS",
+    "signature": "",
+    "functionDesc": "同步角色"
+  },
+  {
+    "chapter": "附加(章节06)",
+    "apiName": "syncDuty",
+    "method": "POST",
+    "urlPattern": "/webapi/ou/sync/duty",
+    "type": "http/WS",
+    "signature": "",
+    "functionDesc": "同步职务"
+  },
+  {
+    "chapter": "附加(章节06)",
+    "apiName": "syncAssign",
+    "method": "POST",
+    "urlPattern": "/webapi/ou/sync/assign",
+    "type": "http/WS",
+    "signature": "",
+    "functionDesc": "同步资源授权"
+  }
+]
+```

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-org-sync/references}//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20202_/347/273/204/347/273/207/345/220/214/346/255/245.md

@@ -183,8 +183,8 @@ public static void main(String[] args) {
 ```
 
 - 运行后结果如下：
-  ![image](/imgs/组织人员同步/1-1.jpg)
-  ![image](/imgs/组织人员同步/1-2.jpg)
+  [IMG: image]
+  [IMG: image]
   
 - 以下是 webservice 实现的一个修改操作演示示例（将同步机构 1 名称替换为“技术研发部”）。
 
@@ -216,7 +216,7 @@ public static void main(String[] args) {
   ```
   
 - 修改只需将编码和所需修改的字段传入即可。运行后"同步机构"修改为"技术研发部"。
-  ![image](/imgs/组织人员同步/1-3.jpg)
+  [IMG: image]
 
 #### 2.1.2 RESTful API 实现 Demo
 
@@ -266,16 +266,16 @@ public static void main(String[] args) {
     ```
 
 这两段代码的作用是生成在调用 RESTful API 需要的 app-token,RSAUtils 类是用来对内容进行加密，Main 类作用是生成 app-token，其中<font color="red">证书 Secret</font>内容是在登录应用开发平台后，在服务管理中的证书管理中获取，如图所示：
-![image](./imgs/组织人员同步/1-10.jpg)
+[IMG: image]
 
 - 使用类似 Postman 接口测试工具，在地址栏中输入http://localhost:8081/cloud-system-manage/webapi/+同步服务接口，接口URL在服务管理中的接口管理中查看
-  ![image](/imgs/组织人员同步/1-11.jpg)
+  [IMG: image]
   
 - 通过接口同步时，请求 Header 中需要携带三个参数，Content-Type、app-key、app-token
   Content-Type: application/x-www-form-urlencoded
   app-key: 在证书管理页面中获取
   app-token: 在工程中手动创建(app-token 生效时间 1 分钟，超时后需要重新生成)
-  ![image](/imgs/组织人员同步/1-12.jpg)
+  [IMG: image]
   
   ##### 2.1.2.1批量同步（推荐）
   
@@ -289,12 +289,12 @@ public static void main(String[] args) {
   ```
 
 - Postman 中填写如下图所示：
-  ![image](/imgs/组织人员同步/1-13.jpg)
-  ![image](/imgs/组织人员同步/1-14.jpg)
+  [IMG: image]
+  [IMG: image]
   
 - 运行结果如下：
-  ![image](/imgs/组织人员同步/1-15.jpg)
-  ![image](/imgs/组织人员同步/1-16.jpg)
+  [IMG: image]
+  [IMG: image]
 
 #### 2.1.3 注意事项
 

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-org-sync/references}//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20203_/344/272/272/345/221/230/345/220/214/346/255/245.md

@@ -105,7 +105,7 @@ source-file: 应用开发平台-基础平台-使用攻略（九）：组织和
   ```
   
 - 运行后在“技研中心”部门新增“同步人员 1”，“同步人员 2”的信息。
-  ![image](/imgs/组织人员同步/1-4.jpg)
+  [IMG: image]
 
 - 与组织同步一样，如果人员编码在系统中已经存在，则更新人员，如果不存在，则为新增操作，若需要修改某人员信息，把它的编码和需要修改的项写成 xml 字符串传入即可。
   以下是 webservice 实现的一个修改操作演示实例。
@@ -138,7 +138,7 @@ source-file: 应用开发平台-基础平台-使用攻略（九）：组织和
   ```
 
 - 运行后,将“同步人员 1”姓名修改为“新用户”
-  ![image](/imgs/组织人员同步/1-5.jpg)
+  [IMG: image]
 
 #### 3.1.2 RESTful API 实现 Demo
 
@@ -152,8 +152,8 @@ source-file: 应用开发平台-基础平台-使用攻略（九）：组织和
   <LIST><USER><RY_STAFFNAME>同步人员1</RY_STAFFNAME><RY_STAFFCODE>sync1</RY_STAFFCODE><ORG_SIMPLENAME>同步</ORG_SIMPLENAME><RY_PART_TIME_DEPARTMENTCODE>nengyuan,zhizao,chanpin</RY_PART_TIME_DEPARTMENTCODE><RY_EMAIL>merit@merit.com</RY_EMAIL><RY_ISSEAL_V>1</RY_ISSEAL_V><RY_SEX>1</RY_SEX><RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE><RY_WORKPHONE>02988888888</RY_WORKPHONE><RY_MOVEPHONE>13389262116</RY_MOVEPHONE><RY_EDUCATIONBG>本科</RY_EDUCATIONBG><RY_ORDER>1</RY_ORDER><RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY><RY_SAFE_LEVEL>1</RY_SAFE_LEVEL></USER></LIST>
   ```
 - 执行结果如下
-  ![image](/imgs/组织人员同步/1-17.jpg)
-  ![image](/imgs/组织人员同步/1-18.jpg)
+  [IMG: image]
+  [IMG: image]
 
 #### 3.1.3 注意事项
 

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-org-sync/references}//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20204_/350/265/204/346/272/220/350/217/234/345/215/225/345/220/214/346/255/245.md

@@ -57,7 +57,7 @@ source-file: 应用开发平台-基础平台-使用攻略（九）：组织和
   ```
   
 - 运行后结果如下：
-  ![image](/imgs/组织人员同步/1-6.jpg)
+  [IMG: image]
 
 #### 4.1.2 RESTful API 实现 Demo
 
@@ -104,8 +104,8 @@ source-file: 应用开发平台-基础平台-使用攻略（九）：组织和
   ```
   
 - 运行结果如下图：
-  ![image](/imgs/组织人员同步/2-1.jpg)
-  ![image](/imgs/组织人员同步/2-2.jpg)
+  [IMG: image]
+  [IMG: image]
 
 ### 4.2 配置说明