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

package/skills/meritdata-platform-integration/references/service-notification.md

@@ -0,0 +1,168 @@
+## 前置条件
+
+**Nacos 配置**: 需在 Nacos 中配置二开服务名称，平台通过 Feign 动态调用。
+
+Maven 依赖已包含在 `cloud-starter-core` 基础包中，二开项目继承平台脚手架后自动引入。
+
+### 核心类
+
+| 类 | 说明 |
+|---|------|
+| `DynamicCloudFeignClient` | 动态 Feign 客户端，根据服务名构建 |
+| `CloudTenancySync` | 租户同步发送/接收 |
+| `CloudFeignMessageClient` | 权限变更消息发送 |
+
+---
+
+## 租户同步
+
+**使用场景**: 平台新建租户 → 异步通知二开服务创建租户专属资源。
+
+### Nacos 配置（平台端）
+
+```properties
+meritdata.cloud.sync-tenancy-receiver: {receiverServiceName1},{receiverServiceName2}
+```
+
+服务名取当前注册中心配置，不要将示例占位符写入生产 Nacos。
+
+### 二开服务接收
+
+```java
+@RestController
+@RequestMapping("/api/tenancy/sync")
+public class TenancySyncReceiver {
+
+    @PostMapping("/add")
+    public ResultBody<String> syncAdd(@RequestBody Tenancy tenancy) {
+        log.info("收到租户同步: {}", tenancy);
+        // 创建租户专属数据空间、初始化配置等
+        return ResultBody.success("同步成功");
+    }
+}
+```
+
+---
+
+## 权限变更消息
+
+**使用场景**: 角色/资源/权限分配变更时，通知二开服务刷新权限缓存。
+
+### Nacos 配置
+
+```properties
+meritdata.cloud.sync-cloud-data-application-name: {receiverServiceName}
+```
+
+### 公共消息体 MessageBody
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| tid | String | 租户 ID |
+| theme | String | 消息主题：ROLE / RESOURCE / USER_ROLE / ASSIGN |
+| data | List | 消息数据列表 |
+
+---
+
+### 角色变更 → sendRoleMessage
+
+**Feign 接口**: `POST /send-role-message`
+
+**主题**: `ROLE`
+
+**RoleMessage 字段**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | String | 角色 ID |
+| code | String | 角色编码 |
+| name | String | 角色名称 |
+| operation | String | 操作：add / update / del |
+
+`data` 的反序列化类型以目标项目的消息契约为准。不要对泛型载荷直接作集合类型强制转换；先使用目标项目已有的 DTO 映射或在真实消息上验证运行时类型。
+
+### 资源变更 → sendResourceMessage
+
+**Feign 接口**: `POST /send-resource-message`
+
+**主题**: `RESOURCE`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | String | 资源 ID |
+| type | String | 0-模块 / 1-菜单 / 2-组件 / 4-分组 |
+| name | String | 资源名称 |
+| url | String | 菜单路由 |
+| operation | String | add / update / del |
+
+资源消息同样应通过目标项目已有的 DTO 映射处理 `data`，并以实际消息契约核对字段。
+
+### 用户角色变更 → sendUserRoleMessage
+
+**Feign 接口**: `POST /send-user-role-message`
+
+**主题**: `USER_ROLE`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| userId | String | 用户 ID |
+| userCode | String | 用户编码 |
+| roleCode | String | 角色编码 |
+| operation | String | add / del |
+
+### 权限分配变更 → sendAssignMessage
+
+**Feign 接口**: `POST /send-assign-message`
+
+**主题**: `ASSIGN`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| resourceId | String | 资源 ID |
+| type | String | 3-按机构 / 4-按角色 / 6-按人员 |
+| code | String | 角色编码或机构编码 |
+| url | String | 菜单路由 |
+| operation | String | add / del |
+
+---
+
+## 用户/组织/人员变更通知（二开扩展接口）
+
+**适用场景**: 平台用户/组织/人员变更时，通知二开服务。
+
+### 用户通知
+
+| 接口 | FeignClient | Nacos 配置 |
+|------|-------------|------------|
+| `POST /user-add` | `IUserPortalService` | `meritdata.cloud.user-customization-extension-application-name` |
+| `POST /user-update` | 同上 | 同上 |
+| `POST /user-remove` | 同上 | 同上 |
+| `POST /resetPass` | 同上 | 同上 |
+| `POST /changePass` | 同上 | 同上 |
+
+### 组织通知
+
+| 接口 | FeignClient | Nacos 配置 |
+|------|-------------|------------|
+| `POST /api/ou/org/create` | `IOrgPortalService` | `meritdata.cloud.org-emp-customization-extension-application-name` |
+| `POST /api/ou/org/update` | 同上 | 同上 |
+| `POST /api/ou/org/delete` | 同上 | 同上 |
+
+### 人员通知
+
+| 接口 | FeignClient | Nacos 配置 |
+|------|-------------|------------|
+| `POST /emp-add` | `IOrgPortalService` | 同上 |
+| `POST /emp-update` | 同上 | 同上 |
+| `POST /emp-delete` | 同上 | 同上 |
+
+---
+
+## 服务通知注意事项
+
+1. 所有通知都是**平台端推送，二开服务被动接收**
+2. Nacos 配置的服务名需要和注册中心一致
+3. 租户同步是异步的，不要依赖同步完成再执行后续逻辑
+4. 消息体的 `data` 是泛型载荷；使用目标项目的 DTO 映射，并以真实消息或契约验证类型和字段。
+
+---

package/skills/meritdata-platform-job/SKILL.md

@@ -1,41 +1,87 @@
 ---
 name: meritdata-platform-job
-description: |
-  任务调度（XXL-JOB）。注册 JobHandler、配置 cron、调度中心接入、幂等设计、失败重试、分布式锁、Job 间依赖。
-  触发场景：新二开模块需要定时任务；HR 数据同步；报表生成；清理任务。
-  何时不用：实时业务逻辑 → 用 code-spec；事件驱动 → L3 消息中心（待建）。
+description: MeritData 平台任务调度，支持 XXL-JOB Handler 与 Taier/DolphinScheduler 工作流编排。用于需要 @JobHandler/@XxlJob Handler、IJobApi、ICloudClient、Taier/DolphinScheduler 的定时任务或工作流场景。
 metadata:
   version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-07"
-  last_modified: "2026-09-07"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
   risk: medium
-  layer: L2
-  sub-layer: L2-C
-  stack: java
-allowed-tools: Read, Grep, Glob, Bash
+  allowed-tools: Read, Grep, Glob
 ---
 
-# 任务调度（job）
+## ⭐ MUST DO
 
-## 触发
-- 新二开模块需要定时执行（每天/每小时/每分钟）
-- HR 数据同步 / 报表生成 / 数据清理
-- 需要分布式锁防止并发执行
-- 需要 Job 间依赖（A 完成后触发 B）
+**XXL-JOB Handler 与 Taier/DolphinScheduler 工作流任务的启停操作必须设计幂等，状态变更审计，禁止在未确认目标项目版本前生成 Cron 表达式。**
 
-## 不触发
-- 实时业务逻辑（同步处理）→ 用 `meritdata-platform-code-spec`
-- 事件驱动（消息队列）→ L3 消息中心（待建）
-- 业务流程触发 → 用 `meritdata-platform-bpm`
+## 触发条件 / 不适用
 
-## 前置约束
-- 定时任务**必须幂等**（多次执行结果一致）
-- 失败必须显式上抛，**禁止** `catch + log + continue`（详见铁律 §八.3）
-- Feign 调用遵守 `meritdata-platform-integration` 批量装配规则
+**适用**：
+- XXL-JOB Handler（`@JobHandler` / `@XxlJob`）
+- 工作流任务（Taier / DolphinScheduler）
+- `IJobApi` / `ICloudClient` 调度编排接口
 
-## 路由
-- XXL-JOB 接入 + JobHandler 写法 → [references/xxl-job-guide.md](references/xxl-job-guide.md)
-- 幂等设计 + 分布式锁 → [references/idempotency.md](references/idempotency.md)
-- 典型场景（HR 同步/清理） → [references/scenarios.md](references/scenarios.md)
+**不适用**：
+- 简单 `@Scheduled` Spring 自带定时任务
+- 平台外部接口调用 → `meritdata-platform-integration`
+
+## 主题路由
+
+| 任务 | 优先读取 |
+| --- | --- |
+| XXL-JOB Handler、Cron、执行器、阻塞策略 | [`references/xxl-job.md`](references/xxl-job.md) |
+| Taier/DolphinScheduler 工作流任务 | [`references/scheduler.md`](references/scheduler.md) |
+
+### 公司级研发攻略（dev-docs 整合）
+
+| 攻略 | 内容 | 入口 |
+|------|------|------|
+| **攻略10：定时调度（8 章）** | XXL-JOB + 调度编排 + 对外 API | [`references/scheduler-ref/攻略-10-定时调度-00_总览.md`](references/scheduler-ref/攻略-10-定时调度-00_总览.md) |
+
+### 公共资产清单（公司级参考资料）
+
+| 内容 | 入口 |
+|------|------|
+| ICloudClient 调度组件详细（4.2） | [`references/iclient-detail/`](references/iclient-detail/) |
+| IJobApi 定时任务详细（4.3） | [`references/ijobapi-detail/`](references/ijobapi-detail/) |
+
+## 工作方式（Step 1/2/3/4）
+
+### Step 1：版本前检
+
+- 从目标项目确认 XXL-JOB 版本（推荐 2.3.x / 2.4.x）
+- 从配置确认是否启用 Taier / DolphinScheduler
+
+### Step 2：读取 reference
+
+按主题路由读取对应 md 文件。
+
+### Step 3：Handler 实现
+
+- 使用 `@JobHandler("name")` 注解
+- 实现 `ReturnT<String>` 返回
+- 设计幂等键（防重复触发）
+- 设计失败重试 + 告警
+
+### Step 4：调度配置
+
+- Cron 表达式必须明确，避免 `0/1 * * * * ?` 等过频繁表达式
+- 阻塞策略：单机串行 / 丢弃后续调度 / 覆盖之前调度
+- 启动/停止/冻结/立即触发的幂等与审计
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| Handler 无幂等键 | 重复触发数据错乱 | 设计 idempotency key |
+| Cron 表达式过于频繁 | 平台压力大 | 评估最低必要频率 |
+| 失败无重试 | 临时故障丢失 | 设计指数退避重试 |
+| Handler 返回 null | XXL-JOB 调度状态异常 | 返回 `ReturnT.SUCCESS` 或 `ReturnT.FAIL` |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 业务逻辑实现 → `meritdata-platform-cloud-dev`
+  - 消息通知 → `meritdata-platform-messaging`
+- **强制要求**：所有 Handler 必须包含失败处理和告警通知

package/skills/meritdata-platform-job/agents/openai.yaml

@@ -0,0 +1,30 @@
+display_name: "MeritData 平台 Job"
+short_description: "MeritData 任务调度（XXL-JOB + Taier/DolphinScheduler）"
+default_prompt: |
+  meritdata-platform-job 处理 MeritData 平台任务调度场景。
+
+  适用场景：
+  - XXL-JOB Handler（@JobHandler / @XxlJob）
+  - Taier / DolphinScheduler 工作流任务
+  - IJobApi / ICloudClient 调度编排
+
+  使用方式：
+  ```
+  meritdata-platform-job <调度需求>
+  ```
+
+  工作方式：
+  1. 从目标项目确认 XXL-JOB 版本和 Taier/DolphinScheduler 是否启用
+  2. 按主题路由读取 references/ 中的专题 md
+  3. 实现 Handler（@JobHandler + ReturnT<String>）
+  4. 设计幂等键、失败重试、告警
+  5. 配置 Cron、阻塞策略、执行器
+
+  2 个 references：
+  - xxl-job.md（Handler/Cron/执行器/阻塞策略）
+  - scheduler.md（Taier/DolphinScheduler）
+
+  强制约束：
+  - Cron 表达式必须明确，避免过频繁
+  - Handler 必须含失败处理和告警
+  - 启动/停止/冻结操作设计幂等与审计

package/skills/meritdata-platform-job/references/iclient-detail/13_/345/233/233/344/270/232/345/212/241/347/273/204/344/273/266-4.2/350/260/203/345/272/246/347/273/204/344/273/266ICloudClient.md

@@ -0,0 +1,92 @@
+---
+name: 调度组件 ICloudClient
+source-file: 公共资产清单
+source-section: 4.2 调度组件
+keywords: [ICloudClient, 调度编排, Taier, DolphinScheduler, submit, status, log, getTaskList, cancelJob, frozenTask, createFlowAndTask]
+use-cases: [提交调度任务, 查询任务状态, 获取任务日志, 取消任务, 冻结任务, 创建工作流, 调度编排]
+related: [12, 14]
+---
+
+# 调度组件 ICloudClient
+
+> **原文章节**：`公共资产清单 → 4.2 调度组件`
+> **行号范围**：L2236–L2266
+
+## 🎯 一句话
+基于 Taier（基于 DolphinScheduler）的任务调度引擎，对外提供 **2 个接口共 12 个方法**：
+- `ICloudClient`（6 方法，普通 Spring Web 接口 + Feign 调用方均可）
+- `IScheduleClient`（6 方法，**Feign Client** `value = "cloud-system-schedule"`）
+
+> ⚠️ **2026-09-10 源码实测修正**：之前 skill 描述"通过 `ICloudClient` 提供 12 个方法"是错误的——**`frozenTask`/`createFlowAndTask` 等 6 个方法实际位于 `IScheduleClient`**，不在 `ICloudClient`。
+> 同时 `ICloudClient` **不是 `@FeignClient`**——是普通 Spring Web Controller（`@RestController`）。
+
+---
+
+## ⚠️ 关键差异说明（与之前 skill 对比）
+
+| 维度 | 之前 skill 声明 | 源码实测 |
+|------|---------------|---------|
+| 类总数 | 1 个 `ICloudClient` | **2 个接口**：`ICloudClient` + `IScheduleClient` |
+| 方法归属 | 全部 12 个在 `ICloudClient` | 6 + 6 拆分 |
+| `ICloudClient` 是否 Feign | 暗示 Feign Client | ❌ **普通 Spring Web 接口** |
+| `frozenTask` 位置 | `ICloudClient` | ❌ 在 `IScheduleClient` |
+| `createFlowAndTask` 位置 | `ICloudClient` | ❌ 在 `IScheduleClient` |
+
+## 📋 接口/方法清单（基于 2026-09-10 源码实测）
+
+### ICloudClient（6 方法，普通 Spring Web 接口）
+
+> ⚠️ **不是 Feign Client**，类级别路径是 `/schedule/sync/...`，**不是** `@FeignClient`
+
+| 方法名 | 完整 URL | 入参 | 返回 |
+|--------|---------|------|------|
+| `submit` | `POST /schedule/sync/job-exec-url` | taskSyncVO: TaskSyncVO | `ResultBody` |
+| `status` | `POST /schedule/sync/job-status-url` | taskSyncVO: TaskSyncVO | `ResultBody<StatusEnum>` |
+| `log` | `POST /schedule/sync/job-log-url` | taskSyncVO: TaskSyncVO | `ResultBody` |
+| `getTaskList` | `POST /schedule/sync/job-list-url` | vo: TaskVO | `ResultBody<GridView<TaskResult>>` |
+| `getParamList` | `POST /schedule/sync/job-param-url` | taskSyncVO: TaskSyncVO | `ResultBody<List<TaskParamVO>>` |
+| `cancelJob` | `POST /schedule/sync/job-cancel-url` | taskSyncVO: TaskSyncVO | `ResultBody` |
+
+### IScheduleClient（6 方法，**Feign Client** `value="cloud-system-schedule"`）
+
+> ✅ 这才是真正的 Feign Client，跨 JVM 调用使用
+
+| 方法名 | 完整 URL | 入参 | 返回 |
+|--------|---------|------|------|
+| `getScheduleStatus` | `POST /taier/schedule/sync/job-schedule-status` | taskStatusVO: TaskStatusVO | `ResultBody<List<TaskResult>>` |
+| `createFlowAndTask` | `POST /taier/batchTask/create-flow-and-task` | taskCreateFlowVO: TaskCreateFlowVO | `ResultBody<List<TaskCreateFlowVO>>` |
+| `frozenTask` | `POST /taier/batchTask/sync/frozen-task` | taskFrozenVO: TaskFrozenVO | `ResultBody<Boolean>` |
+| `getTaskListBySyncId` | `POST /taier/batchTask/getTaskListBySyncId` | syncId: String (form) | `ResultBody<List<LineageTaskInfoVO>>` |
+| `queryLastJobLogBySyncId` | `POST /taier/action/queryLastJobLogBySyncId` | syncId: String (form) | `ResultBody<String>` |
+| `queryLastJobStatusBySyncId` | `POST /taier/action/queryLastJobStatusBySyncId` | syncId: String (form) | `ResultBody<LineageTaskStatusVO>` |
+
+### 二开服务使用方式
+
+```java
+// ICloudClient：直接注入（普通 Spring Web 接口）
+@Autowired
+private ICloudClient cloudClient;
+ResultBody result = cloudClient.submit(taskSyncVO);
+
+// IScheduleClient：Feign 远程调用（跨 JVM）
+@FeignClient(name = "cloud-system-schedule")
+public interface MyFeignClient extends IScheduleClient {
+    // 继承即可用
+}
+```
+
+### ⚠️ 关键陷阱
+
+- `frozenTask` 和 `createFlowAndTask` **不在** `ICloudClient`！在 `IScheduleClient`
+- 跨 JVM 调用必须用 `IScheduleClient`，不是 `ICloudClient`
+
+## 💡 使用建议
+
+1. **任务同步 ID（syncId）**：作为业务系统和调度系统之间的关联键，便于按业务维度查询调度状态与日志。
+2. **冻结 vs 取消**：`frozenTask` 临时冻结任务（不调度），`cancelJob` 立即取消运行中/等待中的任务，操作前确认业务影响。
+3. **流程优先**：复杂 ETL 任务优先使用 `createFlowAndTask` 创建工作流，再串接多个子任务。
+
+## 🔗 相关章节
+
+- `12_四业务组件-4.1工作流BpmEngine.md`（BPM 流程触发任务）
+- `14_四业务组件-4.3定时任务IJobApi.md`（XXL-JOB 定时任务）

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-job/references/ijobapi-detail}/14_/345/233/233/344/270/232/345/212/241/347/273/204/344/273/266-4.3/345/256/232/346/227/266/344/273/273/345/212/241IJobApi.md

@@ -13,7 +13,10 @@ related: [13]
 > **行号范围**：L2267–L2295
 
 ## 🎯 一句话
-基于 XXL-JOB 的分布式任务调度引擎，对外通过 `IJobApi` 提供 11 个方法覆盖任务 CRUD、触发、启停、执行器查询等全场景。
+基于 XXL-JOB 的分布式任务调度引擎，对外通过 `IJobApi` 提供 **12 个方法**（含 1 个 @Deprecated）覆盖任务 CRUD、触发、启停、执行器查询等全场景。
+
+> ⚠️ **2026-09-10 源码实测**：核心 11 方法 + `getHandler`（已 @Deprecated）共 12 个。
+> `@FeignClient` 配置：`value = "cloud-system-job"`, configuration = `JobFeignConfiguration.class`
 
 ## 📋 接口/方法清单
 
@@ -43,6 +46,7 @@ private IJobApi webServerJobService;
 | webServerJobService | getByAppName | 根据应用名获取执行器 | 根据应用名获取执行器信息 |
 | webServerJobService | getHandlerList | 根据handler获取任务列表 | 根据执行器名称获取关联的任务列表 |
 | webServerJobService | getHandlerAndGroup | 根据handler和执行器获取job | 根据执行器名称和执行器组ID获取任务信息 |
+| webServerJobService | getHandler | 获取任务详情（**@Deprecated**）| 根据 handler 名称获取任务详情 | **已废弃**，建议改用 `getHandlerList` |
 
 ## 💡 使用建议
 

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-job/references/scheduler-ref}//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-00_/346/200/273/350/247/210.md

@@ -1,49 +1,49 @@
----
-name: 攻略-10-定时调度-00_总览
-description: 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API]
-use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
-related: [IJobApi / cloud-system-job / 14_四业务组件-4.3定时任务IJobApi.md]
-source: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
----
-
-# 微服务使用攻略（十）：定时调度任务 — 总览
-
-**摘要**：美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-
-**关联**：IJobApi / cloud-system-job / 14_四业务组件-4.3定时任务IJobApi.md
-
-## 章节索引
-
-01. [使用背景](攻略-10-定时调度-章节01_使用背景.md)
-02. [更新记录](攻略-10-定时调度-章节02_更新记录.md)
-03. [调度相关应用包](攻略-10-定时调度-章节03_调度相关应用包.md) (原 1)
-04. [配置项相关](攻略-10-定时调度-章节04_配置项相关.md) (原 2)
-05. [调度功能使用](攻略-10-定时调度-章节05_调度功能使用.md) (原 3)
-06. [调度任务 API 接口](攻略-10-定时调度-章节06_调度任务_API_接口.md) (原 4)
-07. [对外调度任务 API 接口](攻略-10-定时调度-章节07_对外调度任务_API_接口.md) (原 5)
-
-
-## 📑 API 速查
-
-本攻略共 **1 个 API**（按章节排序）：
-
-| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
-|------|------|------|----------|------|------|
-| 章节05_调度功能使用 | `JobHandler` | - | `class JobHandler` | java | XXL-JOB JobHandler 实现（@JobHandler 注解） |
-
-### JSON Schema 完整索引
-
-```json
-[
-  {
-    "chapter": "章节05_调度功能使用",
-    "apiName": "JobHandler",
-    "method": "",
-    "urlPattern": "",
-    "type": "java",
-    "signature": "class JobHandler",
-    "functionDesc": "XXL-JOB JobHandler 实现（@JobHandler 注解）"
-  }
-]
-```
+---
+name: 攻略-10-定时调度-00_总览
+description: 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+related: [IJobApi / cloud-system-job / 14_四业务组件-4.3定时任务IJobApi.md]
+source: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 微服务使用攻略（十）：定时调度任务 — 总览
+
+**摘要**：美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+
+**关联**：IJobApi / cloud-system-job / 14_四业务组件-4.3定时任务IJobApi.md
+
+## 章节索引
+
+01. [使用背景](攻略-10-定时调度-章节01_使用背景.md)
+02. [更新记录](攻略-10-定时调度-章节02_更新记录.md)
+03. [调度相关应用包](攻略-10-定时调度-章节03_调度相关应用包.md) (原 1)
+04. [配置项相关](攻略-10-定时调度-章节04_配置项相关.md) (原 2)
+05. [调度功能使用](攻略-10-定时调度-章节05_调度功能使用.md) (原 3)
+06. [调度任务 API 接口](攻略-10-定时调度-章节06_调度任务_API_接口.md) (原 4)
+07. [对外调度任务 API 接口](攻略-10-定时调度-章节07_对外调度任务_API_接口.md) (原 5)
+
+
+## 📑 API 速查
+
+本攻略共 **1 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节05_调度功能使用 | `JobHandler` | - | `class JobHandler` | java | XXL-JOB JobHandler 实现（@JobHandler 注解） |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节05_调度功能使用",
+    "apiName": "JobHandler",
+    "method": "",
+    "urlPattern": "",
+    "type": "java",
+    "signature": "class JobHandler",
+    "functionDesc": "XXL-JOB JobHandler 实现（@JobHandler 注解）"
+  }
+]
+```

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-job/references/scheduler-ref}//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20201_/344/275/277/347/224/250/350/203/214/346/231/257.md

@@ -1,12 +1,12 @@
----
-name: 攻略-10-定时调度-章节01_使用背景
-description: 使用背景 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 使用背景]
-use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
-source-section: 无编号. 使用背景
-source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
----
-
-# 使用背景
-
+---
+name: 攻略-10-定时调度-章节01_使用背景
+description: 使用背景 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 使用背景]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 无编号. 使用背景
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 使用背景
+
 ​		很多的业务场景需要我们在某一个特定的时刻去做某件任务，比如特定时间对数据统计，数据同步，对账，导出业务数据。使用分布式调度任务, 整体操作都在页面中，可视化效果好。之前我们用的单体调度，系统中一个集群中只有一个节点运行调度进程，该节点执行所有调度任务，但是一旦出现故障，则所有的都进行不下去，扩展性比较低，因此，我们引入了分布式调度。

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-job/references/scheduler-ref}//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20202_/346/233/264/346/226/260/350/256/260/345/275/225.md

@@ -1,14 +1,14 @@
----
-name: 攻略-10-定时调度-章节02_更新记录
-description: 更新记录 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 更新记录]
-use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
-source-section: 无编号. 更新记录
-source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
----
-
-# 更新记录
-
-| 版本   | 时间       | 更新内容     |
-| ------ | ---------- | ------------ |
+---
+name: 攻略-10-定时调度-章节02_更新记录
+description: 更新记录 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 更新记录]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 无编号. 更新记录
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 更新记录
+
+| 版本   | 时间       | 更新内容     |
+| ------ | ---------- | ------------ |
 | 6.13.2 | 2025-05-27 | 定时调度任务 |

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-job/references/scheduler-ref}//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20203_/350/260/203/345/272/246/347/233/270/345/205/263/345/272/224/347/224/250/345/214/205.md

@@ -1,15 +1,15 @@
----
-name: 攻略-10-定时调度-章节03_调度相关应用包
-description: 调度相关应用包 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 调度相关应用包]
-use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
-source-section: 1. 调度相关应用包
-source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
----
-
-# 1.调度相关应用包
-
-| 应用/依赖包       | 备注                 |
-| ----------------- | -------------------- |
-| cloud-system-job  | 调度任务服务端       |
+---
+name: 攻略-10-定时调度-章节03_调度相关应用包
+description: 调度相关应用包 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 调度相关应用包]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 1. 调度相关应用包
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 1.调度相关应用包
+
+| 应用/依赖包       | 备注                 |
+| ----------------- | -------------------- |
+| cloud-system-job  | 调度任务服务端       |
 | cloud-starter-job | 调度任务客户端依赖包 |

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-job/references/scheduler-ref}//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20204_/351/205/215/347/275/256/351/241/271/347/233/270/345/205/263.md

@@ -1,23 +1,23 @@
----
-name: 攻略-10-定时调度-章节04_配置项相关
-description: 配置项相关 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
-keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 配置项相关]
-use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
-source-section: 2. 配置项相关
-source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
----
-
-# 2.配置项相关
-
-调度任务配置为 nacos 中的 common-cloud-system-job.properties 文件
-
-```properties
-#job执行器可以使用的端口,用于创建客户端netty服务 默认从8000,65535端口轮询，填一个值，端口作为起始端口
-meritdata.cloud.job.executor.port=8000,9000
-#job config 日志清理天数
-meritdata.cloud.job.logretentiondays=-1
-#i18n (default empty as chinese, "en" as english)
-meritdata.cloud.job.i18n=
-#系统日志文件路径
-meritdata.cloud.job.executor.port=
+---
+name: 攻略-10-定时调度-章节04_配置项相关
+description: 配置项相关 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 配置项相关]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 2. 配置项相关
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 2.配置项相关
+
+调度任务配置为 nacos 中的 common-cloud-system-job.properties 文件
+
+```properties
+#job执行器可以使用的端口,用于创建客户端netty服务 默认从8000,65535端口轮询，填一个值，端口作为起始端口
+meritdata.cloud.job.executor.port=8000,9000
+#job config 日志清理天数
+meritdata.cloud.job.logretentiondays=-1
+#i18n (default empty as chinese, "en" as english)
+meritdata.cloud.job.i18n=
+#系统日志文件路径
+meritdata.cloud.job.executor.port=
 ```