@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//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 
+
+![image-20210701152410689](.\imgs\消息中心\1-42.png)
+
+
+
+#### 附件下载
+
+- ​	method : get
+
+- ​	url : http://IP:端口/gateway/cloud-system-manage/api/enclosure/download
+
+
+​	无返回参数，下载文件
+
+#### 附件列表
+
+- ​	method : get
+
+- ​	url :http://IP:端口/gateway/cloud-system-manage/api/enclosure/list
+
+
+![image-20210701152410689](.\imgs\消息中心\1-35.png)
+
+```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
+
+![image-20210701152410689](.\imgs\消息中心\1-34.png)
+
+请求成功后拿到返回结果如下：
+
+```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-dev-docs-file-finder/references/keywords.md

@@ -0,0 +1,153 @@
+# dev-docs 关键词→文件反查表（兜底）
+
+> **使用方式**：当 `scenarios.md` 场景匹配不到时，按此表的"关键词"列反查
+> **优先级**：场景匹配 > 关键词匹配（场景匹配更精确）
+
+---
+
+## 关键词反查表
+
+### 一级关键词（直接定位文件）
+
+| 关键词 | 文件 |
+|--------|------|
+| **Redis / 缓存 / put / get / hset / enqueue / publish** | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` |
+| **String 缓存** | `03_一基础设施-1.1缓存操作-StringCacheFacade.md` |
+| **Nacos / 配置中心 / getConfigList** | `04_一基础设施-1.2配置中心-NacosUtils.md` |
+| **SM2 / SM3 / SM4 / 国密 / Sm2Utils / Sm4Utils / SM3Encoder** | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` |
+| **日志 / 审计 / ILogPostService** | `06_三平台服务-3.1日志服务-ILogPostService.md` |
+| **@LogOperation / @LogDesc / @AddDesc / @DelDesc** | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` |
+| **Session / getUserId / getDeptId / getOrgId / isAdmin** | `08_三平台服务-3.3会话信息-SessionUtils.md` |
+| **踢出用户 / 在线用户 / IUserOnlineTime** | `09_三平台服务-3.3在线用户-IUserOnlineTime.md` |
+| **WebService / RESTful / syncOrg / @EnableDataSecretFilter / 数据密级** | `10_三平台服务-3.4多系统集成+3.5数据密级.md` |
+| **CloudFeignMessageClient / sendRoleMessage / 服务通知** | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` |
+| **BPM / 流程 / BpmEngine / Camunda / startProcess** | `12_四业务组件-4.1工作流BpmEngine.md` |
+| **ICloudClient / 调度 / Taier / submit / cancelJob** | `13_四业务组件-4.2调度组件ICloudClient.md` |
+| **IJobApi / XXL-JOB / 定时任务 / triggerJob** | `14_四业务组件-4.3定时任务IJobApi.md` |
+| **CloudDialog / UserSelect / DeptSelect / RoleSelect / ImportButton / MenuAuth** | `15_五前端资产-5.1UI组件库-上半.md` |
+| **ResourceCodeAuth / ThreeMemberAuth / TableHeadSearch / VerifiyPassword / CommonHeader** | `16_五前端资产-5.1UI组件库-下半.md` |
+| **Maven 依赖 / 命名规范 / 组件统计** | `17_附录-统计汇总-Maven依赖-注意事项.md` |
+
+### 二级关键词（按类别定位）
+
+#### 组织人员类
+| 关键词 | 文件 |
+|--------|------|
+| **组织 / Org / 组织机构 / syncOrg / 组织树** | `25_2.1组织维护-上半.md` + `26_2.1组织维护-下半.md` |
+| **人员 / Emp / 人员列表 / 新增人员** | `27_2.2人员维护-上半.md` + `28_2.2人员维护-下半.md` |
+| **角色 / Role / 角色管理 / 添加角色** | `29_2.3角色维护-上半.md` + `30_2.3角色维护-下半.md` |
+| **用户 / User / 用户管理 / 用户启停** | `31_2.4用户维护-上半.md` + `32_2.4用户维护-下半.md` |
+| **工作组 / WorkGroup** | `33_2.5工作组维护.md` |
+| **其他接口 / 模糊查询 / 登录名称查询** | `34_2.6其他接口-上半.md` + `35_2.6其他接口-下半.md` |
+
+#### 资源管理类
+| 关键词 | 文件 |
+|--------|------|
+| **资源授权 / 按角色获取资源 / 按用户获取资源** | `36_3.1-3.7资源授权基础.md` |
+| **资源授权进阶 / 资源权限 / 资源树** | `37_3.8-3.10资源授权进阶.md` |
+| **数据字典 / 字典 / 基础数据** | `38_3.11基础数据.md` |
+| **动态数据源 / 数据源 CRUD** | `39_3.12数据源维护.md` |
+| **DAM / 第三方资源** | `40_3.13第三方资源维护.md` |
+| **应用服务 / 服务管理** | `41_3.14服务管理.md` |
+| **资源菜单 / 资源 CRUD** | `42_3.15资源维护-上半.md` + `43_3.15资源维护-下半.md` |
+| **人员选择器 / selectPerson** | `44_3.16人员选择器-上半.md` + `45_3.16人员选择器-下半.md` |
+| **填报报表 / 报表授权** | `46_3.17填报报表+3.18验证码.md` |
+| **验证码 / 登录验证码** | `46_3.17填报报表+3.18验证码.md` |
+| **工作台 / 用户工作台 / Logo** | `47_3.19工作台维护.md` |
+| **调度编排 / 立即执行** | `48_3.20调度编排.md` |
+| **返回码 / V6.8 / V6.9 版本** | `49_附录-4.1-4.3返回码与版本清单.md` |
+
+#### 使用攻略（10 篇 / 2026-08 新增）
+
+| 关键词 | 文件 |
+|--------|------|
+| **BPM 流程 API / 启动流程 / 完成任务 / 流程追踪 / 退回拟稿人 / 阅知** | `攻略-01-流程API-00_总览.md` |
+| **BPM 工作流程 / 工程创建 / 应用开发 / 后端工程 / 流程业务类** | `攻略-02-工作流程-00_总览.md` |
+| **BPM 监听 / 监听表达式 / JavaDelegate / 监听器 / 自定义 jar** | `攻略-03-监听表达式-00_总览.md` |
+| **系统认证 / token 认证 / CAS 单点登录 / 第三方认证 / JRE 证书** | `攻略-06-系统认证-00_总览.md` |
+| **流程模块设计 / BPM 架构 / 二次开发 / 流程设计器** | `攻略-07-流程模块设计-00_总览.md` |
+| **BPM 前端组件 / BpmFormTools / BpmGridButtonsNew / MeritBPM** | `攻略-08-流程前端组件-00_总览.md` |
+| **组织同步 / 人员同步 / HR 集成 / WebService / RESTful** | `攻略-09-组织人员同步-00_总览.md` |
+| **XXL-JOB / 定时任务 / JobHandler / Cron / 调度 API** | `攻略-10-定时调度-00_总览.md` |
+| **nacos 配置 / 配置项管理 / 命名空间 / 配置文件 / @Value** | `攻略-11-配置项-00_总览.md` |
+| **消息中心 / 消息管理 / 消息提醒 / 附件上传 / 附件下载** | `攻略-12-消息中心-00_总览.md` |
+
+#### 基础配置类
+| 关键词 | 文件 |
+|--------|------|
+| **产品信息 / 平台密级 / 初始化密码 / Logo 图片** | `19_1.1-1.6基础配置-平台信息类.md` |
+| **登录页 / 授权首页 / 保存消息** | `20_1.7-1.10基础配置-页面与消息类.md` |
+| **消息已读未读 / 首页框架 / 角色跳转** | `21_1.11-1.15基础配置-消息与配置类.md` |
+| **组织人员同步 / syncOrg / syncUser** | `22_1.16组织人员同步.md` |
+| **数据密级配置 / secretCode** | `23_1.17资源数据密级-上半.md` |
+| **密级字典 / 密级数据字典** | `24_1.17资源数据密级-下半.md` |
+
+---
+
+## 反向索引（按文件找关键词）
+
+### 公共资产（01-17）
+- `01`: 平台总览、目录、文档结构、命名规范
+- `02`: Redis、缓存、KV、Hash、List、Pub/Sub、SysCacheServiceFacade、put、get、hset、enqueue、publish、subscribe
+- `03`: String 缓存、StringCacheFacade
+- `04`: Nacos、配置中心、动态配置、getConfigList、publishConfig
+- `05`: 国密、SM2、SM3、SM4、Sm2Utils、SM3Encoder、Sm4Utils、电子签章
+- `06`: 操作日志、审计日志、ILogPostService
+- `07`: @LogOperation、@LogDesc、@AddDesc、@DelDesc、日志注解、自定义日志
+- `08`: SessionUtils、getUserId、getDeptId、getOrgId、当前用户
+- `09`: IUserOnlineTime、踢出用户、在线用户
+- `10`: WebService、RESTful、多系统集成、数据密级、@EnableDataSecretFilter
+- `11`: CloudFeignMessageClient、sendRoleMessage、服务通知、消息发送
+- `12`: BpmEngine、流程、Camunda、startProcess、流程审批
+- `13`: ICloudClient、调度、Taier、submit、status
+- `14`: IJobApi、XXL-JOB、定时任务、triggerJob、addJob
+- `15`: CloudDialog、UserSelect、DeptSelect、RoleSelect、ImportButton、MenuAuth
+- `16`: ResourceCodeAuth、ThreeMemberAuth、TableHeadSearch、VerifiyPassword、CommonHeader
+- `17`: Maven、依赖、组件统计、注意事项
+
+### 外部接口（18-49）
+- `18`: 目录、文档说明
+- `19`: 产品信息、平台密级、初始化密码、Logo、tagimage、自定义平台
+- `20`: 登录页、超链接、tempo 授权、消息发送、首页加载
+- `21`: 已读未读、消息详情、保存信息、首页框架、角色跳转
+- `22`: 组织同步、人员同步、资源同步、角色同步、权限同步
+- `23`: 数据密级、密级范围、密级配置、关联关系
+- `24`: 密级字典、密级数据字典
+- `25`: 组织维护、组织新增、组织删除、组织停用
+- `26`: 组织列表、组织树
+- `27`: 人员维护、人员新增、人员列表
+- `28`: 工作组人员、人员更新
+- `29`: 角色维护、添加角色人员、角色列表
+- `30`: 成果管理员、系统角色、删除角色
+- `31`: 用户校验、用户新增、用户停用、用户启用
+- `32`: 用户信息、密码强度、用户列表、密码初始化
+- `33`: 工作组、工作组树
+- `34`: 用户人员对象、登录查询、组织树
+- `35`: 模糊查询、用户对象
+- `36`: 资源授权基础、按角色授权、按用户授权
+- `37`: 资源授权进阶、权限删除、列表树
+- `38`: 基础数据、字典、日志同步
+- `39`: 数据源、动态数据源
+- `40`: DAM、第三方资源
+- `41`: 服务管理、应用服务
+- `42`: 资源维护、门户菜单、Vue 菜单
+- `43`: 资源列表、扩展字段查询
+- `44`: 人员选择器、组织机构、下级机构
+- `45`: 人员信息列表、工作组人员
+- `46`: 填报报表、验证码
+- `47`: 工作台、Logo 配置
+- `48`: 调度编排、立即执行
+- `49`: 返回码、V6.8、V6.9 版本
+
+### 使用攻略（攻略-01 ~ 攻略-12）
+
+- `攻略-01-流程API`: 流程启动、完成任务、追踪、阅知、退回拟稿人、BPM API
+- `攻略-02-工作流程`: BPM 工程创建、pom 配置、流程业务类开发、流程前端开发
+- `攻略-03-监听表达式`: 流程监听器、JavaDelegate、自定义 jar 包、监听服务
+- `攻略-06-系统认证`: token 认证、CAS 单点登录、第三方认证中心、JRE 证书
+- `攻略-07-流程模块设计`: BPM 架构、模块说明、二次开发、样例流程
+- `攻略-08-流程前端组件`: BpmFormTools、BpmGridButtonsNew、MeritBPM 方法
+- `攻略-09-组织人员同步`: HR 集成、组织同步、人员同步、权限同步（WebService/RESTful）
+- `攻略-10-定时调度`: XXL-JOB、JobHandler、Cron、调度 API
+- `攻略-11-配置项`: nacos 配置、配置项管理、命名空间、配置文件、@Value
+- `攻略-12-消息中心`: 消息中心页面、消息发送 API、附件上传下载

package/skills/meritdata-dev-docs-file-finder/references/scenarios.md

@@ -0,0 +1,313 @@
+# dev-docs 场景→文件映射表（30+ 场景）
+
+> **使用方式**：根据用户需求描述，匹配下表中"场景描述"列，找到对应文件
+
+---
+
+## 一、后端公共资产
+
+### 1. 缓存 / Redis
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 缓存用户会话/Token | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | KV 缓存（put/putExpire） |
+| 缓存配置项/简单字符串 | `03_一基础设施-1.1缓存操作-StringCacheFacade.md` | 字符串专用 |
+| 计数器/点赞/浏览量 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | increment/decrement |
+| 任务队列/消息队列 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | enqueue/dequeue |
+| 跨服务通知/事件订阅 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | publish/subscribe |
+| 分布式锁 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | setIfAbsent |
+
+### 2. 配置中心 / Nacos
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 动态读取配置项 | `04_一基础设施-1.2配置中心-NacosUtils.md` | getProperty |
+| 修改 Nacos 配置 | `04_一基础设施-1.2配置中心-NacosUtils.md` | addConfig/publishConfig |
+| 获取 Nacos Token | `04_一基础设施-1.2配置中心-NacosUtils.md` | getNacosToken |
+
+### 3. 国密加解密
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| SM2 加密/签名/电子签章 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | Sm2Utils |
+| SM4 加密/合同加密 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | Sm4Utils |
+| SM3 哈希/数据指纹 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | SM3Encoder |
+| 数据签名验签 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | Sm2Utils |
+
+### 4. 日志 / 审计
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 记录操作日志/审计 | `06_三平台服务-3.1日志服务-ILogPostService.md` | ILogPostService |
+| 方法级日志注解 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | @LogOperation |
+| 实体字段变更日志 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | @LogDesc/@AddDesc/@DelDesc |
+| 自定义日志 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | POST /post-diy |
+
+### 5. 会话 / 当前用户
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 获取当前登录用户 ID | `08_三平台服务-3.3会话信息-SessionUtils.md` | getUserId |
+| 获取当前用户部门/组织 | `08_三平台服务-3.3会话信息-SessionUtils.md` | getDept/getOrg |
+| 获取当前用户角色/权限 | `08_三平台服务-3.3会话信息-SessionUtils.md` | getRoleCodes/getAuthoritiesIds |
+| 获取租户 ID | `08_三平台服务-3.3会话信息-SessionUtils.md` | getTenantId |
+| 判断是否管理员 | `08_三平台服务-3.3会话信息-SessionUtils.md` | isAdmin |
+| 踢出在线用户 | `09_三平台服务-3.3在线用户-IUserOnlineTime.md` | getOutOnlineByUserNames |
+
+### 6. 多系统集成 / 数据密级
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 同步组织人员数据 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | WebService/RESTful |
+| WebService 同步接口 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | syncOrgWebService |
+| RESTful 同步接口 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | /webapi/ou/sync/* |
+| 启用数据密级过滤 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | @EnableDataSecretFilter |
+| 行级权限控制 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | Hibernate @Filter |
+
+### 7. 服务通知
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 角色变更通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendRoleMessage |
+| 资源变更通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendResourceMessage |
+| 用户角色变更通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendUserRoleMessage |
+| 权限分配通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendAssignMessage |
+
+### 8. 业务组件
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 流程发起/审批/退回 | `12_四业务组件-4.1工作流BpmEngine.md` | BpmEngine |
+| 流程追踪/待办查询 | `12_四业务组件-4.1工作流BpmEngine.md` | getGraphTrack |
+| 调度编排/DolphinScheduler | `13_四业务组件-4.2调度组件ICloudClient.md` | ICloudClient |
+| 定时任务/XXL-JOB | `14_四业务组件-4.3定时任务IJobApi.md` | IJobApi |
+| 添加定时任务 | `14_四业务组件-4.3定时任务IJobApi.md` | addJob |
+| 触发任务 | `14_四业务组件-4.3定时任务IJobApi.md` | triggerJob |
+
+---
+
+## 二、前端公共资产
+
+### 9. Vue UI 组件
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 通用对话框/弹窗 | `15_五前端资产-5.1UI组件库-上半.md` | CloudDialog |
+| 用户选择器/单选 | `15_五前端资产-5.1UI组件库-上半.md` | UserSelect |
+| 用户选择器/多选 | `15_五前端资产-5.1UI组件库-上半.md` | UserSelectMulti |
+| 部门选择器 | `15_五前端资产-5.1UI组件库-上半.md` | DeptSelect |
+| 角色选择器 | `15_五前端资产-5.1UI组件库-上半.md` | RoleSelect |
+| 导入按钮/Excel导入 | `15_五前端资产-5.1UI组件库-上半.md` | ImportButton |
+| 菜单权限控制 | `15_五前端资产-5.1UI组件库-上半.md` | MenuAuth |
+| 资源代码授权 | `16_五前端资产-5.1UI组件库-下半.md` | ResourceCodeAuth |
+| 三员授权 | `16_五前端资产-5.1UI组件库-下半.md` | ThreeMemberAuth |
+| 表格头部搜索 | `16_五前端资产-5.1UI组件库-下半.md` | TableHeadSearch |
+| 二级鉴别密码 | `16_五前端资产-5.1UI组件库-下半.md` | VerifiyPassword |
+| 通用头部布局 | `16_五前端资产-5.1UI组件库-下半.md` | CommonHeader |
+
+---
+
+## 三、外部接口
+
+### 9.5 外部接口总览
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 外部接口目录/清单说明 | `18_目录与文档说明.md` | 147 个外部 API 文档说明 |
+| 接口清单总览/平台有哪些接口 | `18_目录与文档说明.md` | 文档结构 + 接口统计 |
+
+### 10. 基础配置（1.x）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 平台产品信息/首页配置 | `19_1.1-1.6基础配置-平台信息类.md` | 1.1-1.6 |
+| 平台密级信息 | `19_1.1-1.6基础配置-平台信息类.md` | 1.5 |
+| 初始化密码策略 | `19_1.1-1.6基础配置-平台信息类.md` | 1.3 |
+| 登录页定制/超链接 | `20_1.7-1.10基础配置-页面与消息类.md` | 1.7-1.10 |
+| 保存/发送消息 | `20_1.7-1.10基础配置-页面与消息类.md` | 1.10 |
+| 消息中心/已读未读 | `21_1.11-1.15基础配置-消息与配置类.md` | 1.11-1.15 |
+| 首页框架配置 | `21_1.11-1.15基础配置-消息与配置类.md` | 1.14 |
+| 角色路由跳转 | `21_1.11-1.15基础配置-消息与配置类.md` | 1.15 |
+
+### 11. 组织人员同步（1.16）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 同步 HR 组织架构 | `22_1.16组织人员同步.md` | syncOrg |
+| 同步人员信息 | `22_1.16组织人员同步.md` | syncUser |
+| 同步资源/菜单 | `22_1.16组织人员同步.md` | syncResource |
+| 同步角色 | `22_1.16组织人员同步.md` | syncRole |
+| 同步权限分配 | `22_1.16组织人员同步.md` | syncAssign |
+
+### 12. 数据密级（1.17）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 数据密级配置 | `23_1.17资源数据密级-上半.md` + `24_1.17资源数据密级-下半.md` | 1.17.1-1.17.4 |
+| 密级数据字典 | `24_1.17资源数据密级-下半.md` | 1.17.5-1.17.8 |
+
+### 13. 组织机构（2.x）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 组织 CRUD | `25_2.1组织维护-上半.md` + `26_2.1组织维护-下半.md` | 2.1.1-2.1.11 |
+| 组织树查询 | `26_2.1组织维护-下半.md` | 2.1.9 |
+| 人员 CRUD | `27_2.2人员维护-上半.md` + `28_2.2人员维护-下半.md` | 2.2.1-2.2.14 |
+| 人员列表/查询 | `27_2.2人员维护-上半.md` | 2.2.6 |
+| 角色管理 | `29_2.3角色维护-上半.md` + `30_2.3角色维护-下半.md` | 2.3.1-2.3.16 |
+| 添加角色人员 | `29_2.3角色维护-上半.md` | 2.3.1 |
+| 用户管理 | `31_2.4用户维护-上半.md` + `32_2.4用户维护-下半.md` | 2.4.1-2.4.13 |
+| 用户启停/启用 | `31_2.4用户维护-上半.md` | 2.4.5-2.4.6 |
+| 密码初始化 | `32_2.4用户维护-下半.md` | 2.4.12 |
+| 工作组管理 | `33_2.5工作组维护.md` | 2.5.1-2.5.2 |
+| 根据用户查人员 | `34_2.6其他接口-上半.md` | 2.6.1 |
+| 登录名称查询 | `34_2.6其他接口-上半.md` | 2.6.2 |
+| 模糊查询用户 | `35_2.6其他接口-下半.md` | 2.6.8 |
+
+### 14. 资源管理（3.x）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 资源授权 | `36_3.1-3.7资源授权基础.md` + `37_3.8-3.10资源授权进阶.md` | 3.1-3.10 |
+| 按角色获取菜单 | `36_3.1-3.7资源授权基础.md` | 3.1 |
+| 按用户获取菜单 | `36_3.1-3.7资源授权基础.md` | 3.3 |
+| 数据字典 | `38_3.11基础数据.md` | 3.11.1 |
+| 日志同步 | `38_3.11基础数据.md` | 3.11.2 |
+| 动态数据源 | `39_3.12数据源维护.md` | 3.12.1-3.12.3 |
+| DAM 第三方资源 | `40_3.13第三方资源维护.md` | 3.13.1-3.13.4 |
+| 应用服务管理 | `41_3.14服务管理.md` | 3.14.1-3.14.7 |
+| 资源菜单 CRUD | `42_3.15资源维护-上半.md` + `43_3.15资源维护-下半.md` | 3.15.1-3.15.10 |
+| 门户菜单 | `42_3.15资源维护-上半.md` | 3.15.4-3.15.5 |
+| 人员选择器（API）| `44_3.16人员选择器-上半.md` + `45_3.16人员选择器-下半.md` | 3.16.1-3.16.7 |
+| 报表授权 | `46_3.17填报报表+3.18验证码.md` | 3.17 |
+| 验证码 | `46_3.17填报报表+3.18验证码.md` | 3.18 |
+| 工作台/Logo | `47_3.19工作台维护.md` | 3.19.1-3.19.2 |
+| 调度编排状态 | `48_3.20调度编排.md` | 3.20.1 |
+| 立即执行调度 | `48_3.20调度编排.md` | 3.20.3 |
+
+---
+
+## 四、附录
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 返回码列表 | `49_附录-4.1-4.3返回码与版本清单.md` | 4.1 |
+| V6.8/V6.9 版本新增接口 | `49_附录-4.1-4.3返回码与版本清单.md` | 4.2-4.3 |
+| Maven 依赖 | `17_附录-统计汇总-Maven依赖-注意事项.md` | 附录 A |
+| 组件开发注意事项 | `17_附录-统计汇总-Maven依赖-注意事项.md` | 附录 B |
+| 平台命名规范 | `01_目录与文档结构.md` | 文档结构 |
+| 组件统计 | `17_附录-统计汇总-Maven依赖-注意事项.md` | 统计汇总 |
+
+---
+
+## 五、使用攻略（10 篇 / 2026-08 新增）
+
+> **匹配原则**：用户提"教程 / 怎么做 / 集成 / 接入 / 二开 / 自定义"等意图时，优先进入使用攻略。比详细 API 文档更易读。
+
+### 1. 流程 API（攻略-01）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 流程引擎初始化 / 规则引擎初始化 | `攻略-01-流程API-章节02_规则引擎初始化接口.md` | 启动前初始化 |
+| 启动流程实例 / 发起流程 | `攻略-01-流程API-章节03_启动流程实例接口.md` | 流程发起 |
+| 完成任务 / 流程审批 | `攻略-01-流程API-章节05_完成任务接口.md` | 审批通过 |
+| 填写意见 / 审批意见 | `攻略-01-流程API-章节06_填写意见接口.md` | 审批备注 |
+| 查看流程追踪 / 流程图 | `攻略-01-流程API-章节08_查看追踪接口.md` | 含 8.1-8.4 |
+| 退回拟稿人 / 退回流程 | `攻略-01-流程API-章节09_退回拟稿人接口.md` | 一键回退 |
+| 退回上一环节 | `攻略-01-流程API-章节10_退回上一环节处理人接口.md` | 退回指定节点 |
+| 流程设计器列表 | `攻略-01-流程API-章节11_流程设计器列表查询.md` | 设计器端 |
+| 个人待办 / 我的待办 | `攻略-01-流程API-章节12_个人待办.md` | 待办列表 |
+| 阅知 / 抄送 / 通知 | `攻略-01-流程API-章节13_阅知.md` | 阅知完整流程 |
+| 流程最新定义ID | `攻略-01-流程API-章节14_流程最新定义ID.md` | procDefId |
+| 业务相关接口 / 流程实例查询 | `攻略-01-流程API-章节15_业务相关接口.md` | 14.1-14.5 |
+
+### 2. 工作流程应用开发（攻略-02）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 创建 BPM 后端工程 | `攻略-02-工作流程-章节02_后端工程创建.md` | 工作流程工程 |
+| 引入 BPM 依赖 / pom 配置 | `攻略-02-工作流程-章节03_后端工程配置.md` | pom.xml + bootstrap.properties |
+| 流程业务类编写 | `攻略-02-工作流程-章节04_后端工程业务类创建.md` | 实体 + Service |
+| 启动后端应用 | `攻略-02-工作流程-章节05_启动后端应用工程.md` | 启动流程 |
+| 流程前端开发 | `攻略-02-工作流程-章节06_流程应用前端开发.md` | 前端集成 |
+| 启动前端应用 | `攻略-02-工作流程-章节07_启动前端应用工程.md` | npm/scripts |
+| 流程设计 / 流程图设计 | `攻略-02-工作流程-章节08_流程设计.md` | 流程图编辑器 |
+
+### 3. 监听表达式开发（攻略-03）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 流程监听器 / 监听表达式 | `攻略-03-监听表达式-章节01_实现策略.md` | 实现思路 |
+| 自定义监听 jar 包 | `攻略-03-监听表达式-章节02_自定义_jar_包的实现流程.md` | jar 工程创建 |
+| 监听服务搭建 | `攻略-03-监听表达式-章节03_自定义服务搭建.md` | 微服务 |
+| 流程设计设置 listener | `攻略-03-监听表达式-章节04_流程设计中设置_listener_参数.md` | 流程定义 |
+| 验证监听事件 | `攻略-03-监听表达式-章节05_测试触发流程监听事件是否生效.md` | 测试 |
+
+### 6. 系统认证集成（攻略-06）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 平台 token 认证 / token 集成 | `攻略-06-系统认证-章节02_token_认证集成.md` | 含 2.3.1/2.3.2/2.3.3 |
+| CAS 单点登录 / CAS 集成 | `攻略-06-系统认证-章节03_cas_统一认证中心.md` | 含 3.2.1-3.2.6 完整步骤 |
+| 第三方认证中心 / 自定义认证 | `攻略-06-系统认证-章节04_第三方认证中心.md` | 4.1-4.5 |
+| 认证中心端配置 | `攻略-06-系统认证-章节05_附录_1_认证中心端配置.md` | 证书生成 |
+
+### 7. 流程模块设计（攻略-07）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| BPM 架构理解 | `攻略-07-流程模块设计-章节01_背景.md` | 整体介绍 |
+| 工作流相关介绍 | `攻略-07-流程模块设计-章节02_工作流相关介绍.md` | BPM 概念 |
+| 流程包含模块 | `攻略-07-流程模块设计-章节03_应用开发平台流程包含模块.md` | 模块图 |
+| 流程功能模块 | `攻略-07-流程模块设计-章节04_流程功能模块介绍.md` | 设计器/业务/组件/样例 |
+| 流程后端设计 | `攻略-07-流程模块设计-章节05_流程后端设计.md` | 5.1-5.5 |
+| 流程前端设计 | `攻略-07-流程模块设计-章节06_流程前端设计.md` | 6.1-6.3 |
+| 流程模块二次开发 | `攻略-07-流程模块设计-章节07_二次开发.md` | 二次开发 |
+| 个人样例流程 | `攻略-07-流程模块设计-章节08_个人样例流程的配置.md` | 8.1-8.6 |
+
+### 8. 流程前端组件（攻略-08）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| BpmFormTools / 流程表单工具 | `攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件.md` | Props/Events |
+| BpmGridButtonsNew / 流程按钮 | `攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件.md` | 状态值 |
+| MeritBPM / BPM 组件方法 | `攻略-08-流程前端组件-章节01_概述.md` | 方法概览 |
+| 后端 BpmEngine 核心接口 | `攻略-08-流程前端组件-章节05_后端BpmEngine核心接口.md` | 4.1-4.5 |
+
+### 9. 组织人员同步（攻略-09）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 组织同步 / webservice / RESTful | `攻略-09-组织人员同步-章节02_组织同步.md` | 2.1.1/2.1.2 |
+| 人员同步 / HR 集成 | `攻略-09-组织人员同步-章节03_人员同步.md` | 3.1.1/3.1.2 |
+| 资源菜单同步 | `攻略-09-组织人员同步-章节04_资源菜单同步.md` | 4.1.1/4.1.2 |
+| 角色同步 | `攻略-09-组织人员同步-章节05_角色同步.md` | 5.1.1/5.1.2 |
+| 资源权限同步 | `攻略-09-组织人员同步-章节06_资源权限同步.md` | 6.1.1/6.1.2 |
+| 同步配置 / 触发器 | `攻略-09-组织人员同步-章节07_组织同步配置.md` | nacos 配置 |
+
+### 10. 定时调度任务（攻略-10）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| XXL-JOB 调度 / JobHandler | `攻略-10-定时调度-章节03_调度相关应用包.md` | 引入依赖 |
+| 调度配置 / Cron 表达式 | `攻略-10-定时调度-章节04_配置项相关.md` | nacos 配置 |
+| 调度任务注册 / 客户端注册 | `攻略-10-定时调度-章节05_调度功能使用.md` | 3.1-3.3 |
+| 调度任务 API | `攻略-10-定时调度-章节06_调度任务_API_接口.md` | 调用样例 |
+| 对外调度 API | `攻略-10-定时调度-章节07_对外调度任务_API_接口.md` | 平台对外 |
+
+### 11. 系统配置项管理（攻略-11）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| nacos 配置查询 / 配置项说明 | `攻略-11-配置项-章节01_应用配置项相关.md` | bootstrap 地址 |
+| 配置文件列表 / 命名空间维护 | `攻略-11-配置项-章节02_配置中心配置项说明.md` | 9 个配置文件 + 2.3 全量详情 |
+| 配置项使用 / @Value / 配置实体类 | `攻略-11-配置项-章节03_配置项的使用.md` | @RefreshScope 等 |
+
+### 12. 消息中心（攻略-12）
+
+| 用户需求关键词 | 推荐文件 | 备注 |
+|--------------|---------|------|
+| 消息中心使用场景 | `攻略-12-消息中心-章节01_消息中心使用场景.md` | 概述 |
+| 消息中心页面 / 消息管理 / 消息提醒 | `攻略-12-消息中心-章节02_消息中心页面功能使用.md` | 2.1-2.3 |
+| 消息发送 API / 消息列表 | `攻略-12-消息中心-章节03_消息中心接口功能使用.md` | 3.1-3.2 |
+| 附件上传 / 附件下载 | `攻略-12-消息中心-章节04_附：附件上传下载删除接口.md` | 附录 |