create-yss-spec 2.1.10 → 2.1.13

package/template/.cursor/skills/yss-design-system/references/design-qa-theme.md

@@ -0,0 +1,64 @@
+# Design QA 项目主题对照
+
+本文件给 Codex `$design-qa` 使用。官方 `design-qa` skill 仍负责截图对比流程和 `final result: passed|blocked`；本文件只提供项目视觉真相，不改上游插件正文。
+
+## Source visual truth
+
+- 规范：`docs/design/design.md`
+- Token：`docs/design/tokens/theme.json`、`docs/design/tokens/tokens.default.json`、`docs/design/tokens/variables.css`
+- 实现截图：当前原型或页面在同一 viewport / 主题 / 状态下的渲染
+
+官方 `https://ant.design/design.md` 只是上游默认。项目覆盖与官方不同时，以项目覆盖为准。
+
+## 必查 fidelity surface（项目覆盖）
+
+### Colors and visual tokens
+
+| 角色 | 必须对照 | 记为 P1 token drift |
+| --- | --- | --- |
+| 主色 | `#3371ff` | `#1677ff` 或 `#3177ff` 当默认主色 |
+| 主色 hover / active | `#4096ff` / `#0958d9` | 用算法重算替代 `:root` 显式值且未记录 |
+| 错误色 | `#f5222d` | 官方 `#ff4d4f` 当默认错误色 |
+| 成功 / 警告 | `#52c41a` / `#faad14` | 改成非功能色装饰 |
+| 页面背景 | `#f0f2f5` | `#f5f5f5` 或其它灰底当默认 layout |
+| 容器 / 浮层 | `#ffffff` | 用卡片阴影堆叠替代表面层级 |
+| 主文本 / 次文本 | `rgba(0, 0, 0, 0.88)` / `rgba(0, 0, 0, 0.65)` | `#2e2e2e` / `#646464` 当默认文本 |
+| 边框 / 分割线 | `#d9d9d9` / `#f0f0f0` | `#dbdbdb` / `#f1f1f1` 当默认边框 |
+| 运行时变量 | `--primary-color` 指向 `--brand-color-primary` | 页面另写一套 Less 色值 |
+
+`blue` 预设色板里的 `#1677ff` 不是品牌主色，不要据此判定主色漂移。
+
+### Fonts and typography
+
+| 角色 | 必须对照 | 记为 P1 token drift |
+| --- | --- | --- |
+| 默认正文字号 | 14px | 16px 营销字号当正文 |
+| 默认控件高度 | 32px | 明显偏离 32px 且未走 compact algorithm |
+| 字体栈 | 系统栈（`-apple-system, BlinkMacSystemFont, "Segoe UI", ...`） | 强制 `Inter` 或其它未登记品牌字体 |
+| 字重 | 400 / 600 | 用 700+ 表达选中或激活 |
+
+### Spacing and layout rhythm
+
+| 角色 | 必须对照 | 记为 P1 token drift |
+| --- | --- | --- |
+| 圆角 | 小控件 4px、默认 6px、容器 8px | 历史品牌 8px / 10px，或 Less 前半 4px 当全局默认 |
+| 间距网格 | 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48 | 任意 magic number 撑开中后台密度 |
+| 顶栏 / 侧栏 | 顶栏 64px，深色侧栏 `#001529` | 未说明就改成营销式顶栏 |
+
+### Image quality and copy
+
+沿用官方 `design-qa` 规则。本主题不引入插画、logo 或营销文案；出现这类素材时按官方 rubric 记 finding，并同时记为偏离中后台定位。
+
+## 判定
+
+- 仍用官方 `#1677ff`、强制 `Inter` 或 8px 品牌圆角作为默认主题：P1。
+- 只改局部组件、且 `prototype-evidence.yaml` 的 `theme_override` 已记录：按官方 severity 评估，不自动升 P1。
+- 暗色模式：本轮未重派生完整暗色色板；暗色对照前若缺少新的 algorithm 派生证据，`final result: blocked`，写明 blocker。
+
+## 报告要求
+
+`design-qa.md` 必须写明：
+
+- source visual truth path：`docs/design/design.md` 与对应 token 文件
+- 已按本清单核对 Colors/tokens 与 Fonts/typography
+- 与官方默认的差异是否被接受为项目覆盖

package/template/.cursor/skills/yss-design-system/references/design-system.md

@@ -0,0 +1,245 @@
+# YSS 设计系统执行规范
+
+本文件是 `docs/design/design.md` 的 skill 侧执行清单。项目文档面向团队阅读并作为唯一规范来源，本文件面向 Agent 执行、设计评审和前端实现，不单独承载新的 token 决策。
+
+权威资料：
+
+- 团队规范：`docs/design/design.md`
+- Token 快照：`docs/design/tokens/*`
+- Skill 入口：`.agents/skills/yss-design-system/SKILL.md`
+
+## 设计定位
+
+本项目 UI 默认采用 Ant Design 企业级中后台风格，而不是营销站、品牌官网或概念展示风格。
+
+关键词：
+
+- 数据密集
+- 表单密集
+- 流程密集
+- 可扫描
+- 状态确定
+- 低装饰
+- 组件一致
+
+页面首屏应优先呈现实际业务界面。除非需求明确要求 Landing Page，不要创建营销式 hero、过度装饰、全屏宣传页或卡片堆叠式介绍页。
+
+## 设计原则
+
+| 原则 | 执行要求 |
+| --- | --- |
+| Natural | 使用熟悉的中后台模式，如筛选区、表格、详情抽屉、Modal、Tabs、左树右表 |
+| Certain | 每个操作都有明确状态反馈，加载、错误、权限、只读、冲突不靠猜 |
+| Meaningful | 视觉强调只服务于主操作、状态和层级，不做无意义装饰 |
+| Growing | 支持从简单表单扩展到复杂表格、审批流、控制台和多模块页面 |
+
+## Token 基线
+
+### 颜色
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `colorPrimary` | `#3371ff` | 主操作、链接、焦点、选中态 |
+| `colorPrimaryHover` | `#4096ff` | 主色 hover |
+| `colorPrimaryActive` | `#0958d9` | 主色 active |
+| `colorSuccess` | `#52c41a` | 成功状态 |
+| `colorWarning` | `#faad14` | 警告状态 |
+| `colorError` | `#f5222d` | 错误状态 |
+| `colorInfo` | `#3371ff` | 信息提示 |
+| `colorBgLayout` | `#f0f2f5` | 页面背景 |
+| `colorBgContainer` | `#ffffff` | 内容容器 |
+| `colorBgElevated` | `#ffffff` | 浮层容器 |
+| `colorText` | `rgba(0, 0, 0, 0.88)` | 主文本 |
+| `colorTextSecondary` | `rgba(0, 0, 0, 0.65)` | 次级文本 |
+| `colorTextTertiary` | `#8c8c8c` | 弱说明 |
+| `colorTextQuaternary` | `#bfbfbf` | placeholder / disabled |
+| `colorBorder` | `#d9d9d9` | 主边框 |
+| `colorBorderSecondary` | `#f0f0f0` | 次级分割线 |
+
+颜色规则：
+
+- 主色只用于主操作、链接、焦点、选中态和激活导航。
+- `success`、`warning`、`error`、`info` 只表达功能状态。
+- 预设色板只用于 Tag、图表、分类可视化，不用于重新定义主操作。
+- 不硬编码白色、灰色、状态色；优先引用 token、CSS variables 或 Ant Design theme。
+- semantic token 优先于色值：页面先声明背景、容器、浮层、文本、边框、状态等角色，再映射到具体 token。
+- 运行时短名 `--primary-color`、`--text-color`、`--bg-color` 必须指向 `--brand-*`，不要再维护第二套色值。
+- `blue` 等预设色板可以仍含官方 `#1677ff`；色板预设 ≠ 品牌主色。
+- accessibility contrast 不足时，通过 `ConfigProvider` 的 seed token 或组件 token 调整；不要为单个页面制造不可复用的深浅色例外。
+- Codex `$design-qa` 的 token / 字体对照读 `references/design-qa-theme.md`。
+
+### 排版
+
+| 层级 | 字号 | 字重 | 用途 |
+| --- | --- | --- | --- |
+| Heading 1 | 38 | 600 | 大标题，慎用 |
+| Heading 2 | 32 | 600 | 页面级标题 |
+| Heading 3 | 26 | 600 | 重要分区 |
+| Heading 4 | 22 | 600 | 分区标题 |
+| Heading 5 | 18 | 600 | 卡片 / 面板标题 |
+| Body | 14 | 400 | 默认正文、控件、表格 |
+| Small | 12 | 400 | 辅助信息、Tag |
+
+排版规则：
+
+- UI 默认正文 14px。
+- UI 字重优先 400 / 600。
+- 字体栈使用系统字体，不强制 `Inter`。
+- 不用 700+ 粗体表达选中或激活状态。
+- 选中状态优先使用颜色、边框、下划线、背景表达。
+
+### 间距、尺寸、圆角
+
+| 类型 | 基线 |
+| --- | --- |
+| 间距网格 | 4px |
+| 默认控件高度 | 32px |
+| 小控件高度 | 24px |
+| 大控件高度 | 40px |
+| 默认字号 | 14px |
+| 字体栈 | 系统栈，不强制 `Inter` |
+| 小控件圆角 | 4px |
+| 默认控件圆角 | 6px |
+| 大容器 / 浮层圆角 | 8px |
+| 顶栏高度 | 64px |
+| 深色侧栏 | `#001529` |
+
+执行规则：
+
+- 间距使用 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48。
+- 表单、筛选区、工具栏、表格、详情页使用密集但有节奏的布局。
+- 控件圆角不得明显大于容器圆角。
+- 不使用任意 magic number；确需新增尺寸时，先说明为什么 token 不够。
+
+### 动效
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `motionDurationFast` | `0.1s` | hover、focus、press |
+| `motionDurationMid` | `0.2s` | 折叠、淡入淡出、控件内部状态 |
+| `motionDurationSlow` | `0.3s` | Modal、Drawer、页面级浮层 |
+
+动效只服务于状态反馈、层级变化和空间关系。不自造 easing。
+
+## 组件规则
+
+| 组件 | 规则 |
+| --- | --- |
+| Button Primary | 每个决策区域只保留一个主按钮 |
+| Button Default | 次级动作默认使用默认按钮或描边按钮 |
+| Input / Select | 默认高度 32px，focus 可见 |
+| Card | 只用于真实内容容器，不做卡片套卡片 |
+| Modal | 用于阻断式决策和关键表单 |
+| Drawer | 用于详情、编辑、辅助流程，不打断主列表上下文 |
+| Menu | 选中态使用淡蓝背景和主色文本 |
+| Tabs | 激活态使用主色文本和下划线，不加背景块 |
+| Table | 表头浅表面色 + 600 字重；hover 再强调行 |
+| Tag | 表达分类，不表达关键阻断状态 |
+| Alert | 表达成功、警告、错误、信息等语义反馈 |
+| Badge | 只做紧凑状态提示，不能替代文本 |
+| Tooltip | 只提供补充解释，不承载关键业务信息 |
+
+交互规则：
+
+- 每个决策区域只保留一个 single primary action；危险操作和次级动作必须在视觉层级上降级。
+- 保存、提交、审批、发布、导出等可点击动作必须产生 interaction feedback，包括结果消息、行内状态变化、禁用原因或确认弹窗。
+- 风险或不可逆动作使用 Modal 二次确认；禁止将“已发布”误表示为“已执行数据库变更”。
+
+## 页面规则
+
+- 后台页面优先使用：Header / 查询区 / 工具栏 / 表格 / 详情抽屉 / 弹窗。
+- 主从关系优先使用：左树右表、列表 + 详情、Tabs + 分区。
+- 表格密集场景优先保证列可读、操作稳定、横向滚动受控。
+- 筛选区要支持重置、提交、默认值和窄屏重排。
+- 空态要说明下一步，不只显示“暂无数据”。
+- 无权限态要说明权限缺失，不假装是空数据。
+
+## 状态矩阵
+
+设计、原型或实现至少考虑：
+
+- loading
+- empty
+- error
+- readonly
+- disabled
+- no-permission
+- conflict
+- dirty / unsaved
+- success
+
+关键业务流还要补充：
+
+- optimistic update
+- idempotency
+- concurrent modification
+- partial success
+- retryable failure
+- audit-visible action
+
+## 响应式验收
+
+核心视口：
+
+| 名称 | 尺寸 |
+| --- | --- |
+| mobile compact | 360 × 800 |
+| mobile standard | 390 × 844 |
+| mobile large | 430 × 932 |
+| foldable / small tablet | 600 × 960 |
+| tablet portrait | 820 × 1180 |
+| tablet landscape | 1024 × 768 |
+| laptop | 1366 × 768 |
+| desktop | 1440 × 900 |
+| wide desktop | 1920 × 1080 |
+
+验收规则：
+
+- 页面整体不出现意外横向滚动。
+- 表格横向滚动必须限定在表格容器内。
+- 工具栏、筛选区、批量操作区在窄屏下重排或折叠。
+- 长文本、按钮、标签、表头、弹窗内容不得溢出。
+- 移动端表格需要说明替代形态，如卡片列表、关键列优先或详情抽屉。
+
+## 前端落地
+
+React + Ant Design：
+
+- 使用 `ConfigProvider` 注入主题。
+- 默认主题使用 `theme.defaultAlgorithm`；暗色与紧凑模式通过 theme algorithm 切换，不手工反转色值或逐组件压缩。
+- 优先通过 token、component token、CSS variables、theme algorithm 实现样式。
+- 静态反馈 API 使用 `App`、hook API 或 context holder，避免主题上下文丢失。
+- 暗色模式使用 `darkAlgorithm` 或 `variables.dark.css`。
+- 紧凑模式使用 `compactAlgorithm` 或 `tokens.compact.json`。
+
+YSS UI / Vue：
+
+- 业务页面优先走 `yss-ui` 和 `yss-page-module-development`。
+- 表单使用 `YssFormily` schema。
+- 表格使用 `YTable`，列定义使用项目约定字段。
+- 高度自适应使用 `useTableHeight` / `useTreeHeight`。
+- 请求、分页、筛选参数下沉到 Hook。
+
+## 评审清单
+
+设计评审时检查：
+
+- 是否引用 `docs/design/design.md`。
+- 是否符合中后台定位。
+- 页面清单、主路径、异常路径是否清楚。
+- 状态矩阵是否完整。
+- 组件选择是否复用 YSS UI / Ant Design。
+- API 反推字段、筛选、分页、动作、错误、权限是否完整。
+- 主操作是否唯一，次级操作是否降级。
+- 响应式断点和窄屏替代形态是否清楚。
+
+实现评审时检查：
+
+- 是否消费 token，而不是硬编码颜色和尺寸。
+- 是否以 semantic token 表达颜色、圆角、阴影和状态层级。
+- 是否保持默认 14px 正文、32px 控件、4px 间距网格。
+- 是否保留 hover、focus、active、disabled、loading、empty、error 状态。
+- 是否只保留一个 single primary action，并让每个关键操作提供 interaction feedback。
+- 是否在目标字号和背景下复核 accessibility contrast。
+- 是否存在卡片套卡片、营销式 hero、装饰性渐变或无意义插画。
+- 是否存在横向溢出、文本遮挡或按钮文字溢出。

package/template/.cursor/skills/yss-design-system/scripts/validate-frontmatter.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export function validateFrontmatter(text) {
+  const match = /^---\n([\s\S]*?)\n---/.exec(text);
+  if (!match) throw new Error("Invalid SKILL.md frontmatter block");
+  const fields = new Map();
+  for (const line of match[1].split("\n")) {
+    if (!line.trim()) continue;
+    const index = line.indexOf(":");
+    if (index < 0) throw new Error(`Invalid frontmatter line: ${line}`);
+    fields.set(line.slice(0, index).trim(), line.slice(index + 1).trim());
+  }
+  const keys = [...fields.keys()].sort();
+  if (keys.join(",") !== "description,name") throw new Error(`Expected keys ['description', 'name'], got ${JSON.stringify(keys)}`);
+  const name = fields.get("name");
+  const description = fields.get("description");
+  if (!/^[a-z0-9-]+$/.test(name)) throw new Error("Invalid skill name: " + name);
+  if (!description || description.length > 1024) throw new Error("Description must be present and <= 1024 chars");
+  return name;
+}
+
+async function main() {
+  const skill = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "SKILL.md");
+  try {
+    const name = validateFrontmatter(await readFile(skill, "utf8"));
+    console.log(`${name} frontmatter ok`);
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+  }
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) await main();

package/template/.cursor/skills/yss-design-system/scripts/validate-frontmatter.test.mjs

@@ -0,0 +1,12 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { validateFrontmatter } from "./validate-frontmatter.mjs";
+
+test("accepts the required skill frontmatter", () => {
+  assert.equal(validateFrontmatter("---\nname: yss-design-system\ndescription: Use when validating a skill.\n---\n"), "yss-design-system");
+});
+
+test("rejects missing and unsupported frontmatter fields", () => {
+  assert.throws(() => validateFrontmatter("# no frontmatter"), /Invalid SKILL/);
+  assert.throws(() => validateFrontmatter("---\nname: bad\nextra: x\n---"), /Expected keys/);
+});

package/template/.cursor/skills/yss-distributed-id/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: yss-distributed-id
+description: Use when 用于 YSS 分布式 ID 组件的接入与排障。当用户提到 Leaf、CosId、号段模式、雪花算法、AutoIdInterceptor、MyBatis 自动注入 ID 或主键生成策略时调用。
+---
+
+# yss-distributed-id
+
+用于处理 `yss-component-distributed-id` 的配置、接入和问题定位。
+
+## 何时使用
+
+- 用户要启用分布式 ID。
+- 用户提到 Leaf Segment、Snowflake、CosId、UUID。
+- 用户反馈批量插入未自动注入 ID、ID 冲突、ID 类型不匹配。
+
+## 工作方式
+
+1. 先识别项目用的是哪种 ID 策略。
+2. 涉及真实类名、配置项、Leaf 服务或批量插入排障时，先读 `references/source-index.md`，再定位源码或文档。
+3. 再看实体注解、拦截器配置和底层表或注册中心依赖是否齐全。
+4. 修改时优先保持现有策略，不轻易切换算法。
+
+## 源码索引
+
+- 源码位置不要假设固定目录；先按 `yss-source-index/references/source-location.md` 定位。
+- 当前技能索引：`references/source-index.md`
+- 重点源码入口通常包括 `EnableDistributedId`、`AutoIdInterceptor`、Leaf 配置、Leaf REST/Feign/gRPC 模块、ID 策略相关类。
+
+当组件源码变化后，用 `yss-source-index` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
+
+## 检查清单
+
+- 启动类是否启用了分布式 ID 能力。
+- 当前策略是否与部署条件匹配。
+- 批量插入链路是否会经过拦截器。
+- 实体主键类型与生成策略是否兼容。
+- Leaf Segment 场景下 `leaf_alloc` 是否已初始化。
+- MyBatis/MyBatis-Plus 的插入方法是否绕过了自动 ID 拦截逻辑。
+- 多服务共享号段时，业务 tag/key 是否唯一且稳定。
+
+## 策略建议
+
+- 追求稳定和趋势递增时，优先 Leaf Segment。
+- 依赖 ZooKeeper 且要求高吞吐时，可考虑 Snowflake。
+- 若项目已有 CosId 统一方案，沿用现有生态。
+- 除非业务明确允许，否则不要把 Long 主键切到 String UUID。
+
+## 修改约束
+
+- 不要混用多种主键生成策略而不说明边界。
+- 不要仅改实体注解而忽略底层配置和依赖。
+- 如果用户只是在做普通 MyBatis-Plus 主键配置，不要过度引入新组件。
+- 不要在已有 Long 主键生态里随意改成 String UUID，除非调用方和数据库约束都确认兼容。
+
+## 排障顺序
+
+1. 确认启用注解和 starter 依赖。
+2. 确认实体主键类型、注解和插入方法。
+3. 确认拦截器是否参与 MyBatis 调用链。
+4. Leaf 场景确认服务、号段表和业务 key。
+5. Snowflake/CosId 场景确认机器号、时钟、注册中心或 worker 分配。
+6. 批量插入失败时确认是否调用了项目推荐批量方法。
+
+## 按需读取
+
+- 源码索引：`references/source-index.md`
+- 拦截器与自动注入：`assets/AutoIdInterceptor.java`
+- 启用注解：`assets/EnableDistributedId.java`
+- Leaf 配置相关：`assets/LeafConf.java`

package/template/.cursor/skills/yss-distributed-id/agents/openai.yaml

@@ -0,0 +1,5 @@
+version: 1
+interface:
+  display_name: "YSS Distributed ID"
+  short_description: "Leaf、CosId 与分布式 ID 接入与配置规范"
+  default_prompt: "Use $yss-distributed-id to configure or debug distributed ID generation, Leaf, CosId, and MyBatis ID injection."

package/template/.cursor/skills/yss-distributed-id/assets/AutoIdInterceptor.java

@@ -0,0 +1,246 @@
+package com.yss.cloud.sankuai.mybatis;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.yss.cloud.exception.BizException;
+import com.yss.cloud.sankuai.CosidSegmentContextHelper;
+import com.yss.cloud.sankuai.GenerationTypeSeq;
+import com.yss.cloud.sankuai.SegmentContextHelper;
+import com.yss.cloud.sankuai.SnowflakeContextHelper;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.lang3.StringUtils;
+import org.apache.ibatis.binding.BindingException;
+import org.apache.ibatis.binding.MapperMethod;
+import org.apache.ibatis.executor.statement.StatementHandler;
+import org.apache.ibatis.mapping.BoundSql;
+import org.apache.ibatis.plugin.Interceptor;
+import org.apache.ibatis.plugin.Intercepts;
+import org.apache.ibatis.plugin.Invocation;
+import org.apache.ibatis.plugin.Signature;
+import org.springframework.util.ObjectUtils;
+import org.springframework.util.ReflectionUtils;
+
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.Table;
+import java.lang.reflect.Field;
+import java.sql.Connection;
+import java.util.*;
+
+@Intercepts(
+    {
+        @Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})
+    }
+)
+@Slf4j
+public class AutoIdInterceptor implements Interceptor {
+
+    @Override
+    public Object intercept(Invocation invocation) throws Throwable {
+        StatementHandler statementHandler = (StatementHandler) invocation.getTarget();
+        BoundSql boundSql = statementHandler.getBoundSql();
+        String boundSqlStr = boundSql.getSql();
+        if (StringUtils.startsWithIgnoreCase(StringUtils.trim(boundSqlStr),"INSERT")){
+            processInsertStatement(statementHandler);
+        }
+
+        return invocation.proceed();
+    }
+
+    /**
+     * 1.处理插入的情况
+     *
+     * @apiNote 1.处理新增insert
+     * @param statementHandler 句柄
+     */
+    private void processInsertStatement(StatementHandler statementHandler) {
+        BoundSql boundSql = statementHandler.getBoundSql();
+        Object parameterObject = boundSql.getParameterObject();
+
+        if (parameterObject != null) {
+            processParameterObject(parameterObject);
+        }
+    }
+
+    /**
+     * 处理参数对象
+     *
+     * @apiNote 2.处理参数对象 mapper->entityList,plus->param1
+     * @param parameterObject 参数对象
+     */
+    private void processParameterObject(Object parameterObject) {
+        if (parameterObject instanceof MapperMethod.ParamMap<?>){
+            // 获取批量实体对象，若为空则为single 参数对象
+            Object entityList = null;
+            try {
+                entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("entityList");
+            }catch (BindingException e){
+                log.warn("non entityList. info -> {}",e.getLocalizedMessage());
+            }
+            // 兼容mybatis默认参数 集合的场景
+            if (ObjectUtils.isEmpty(entityList)){
+                try {
+                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("collection");
+                }catch (BindingException e){
+                    log.warn("non entityList & non collection. info -> {}",e.getLocalizedMessage());
+                }
+            }
+            // 兼容mybatis默认参数 数组的场景
+            if (ObjectUtils.isEmpty(entityList)){
+                try {
+                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("array");
+                }catch (BindingException e){
+                    log.warn("non entityList & non collection & non array. info -> {}",e.getLocalizedMessage());
+                }
+            }
+            if (ObjectUtils.isEmpty(entityList)){
+                try {
+                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("param1");
+                }catch (BindingException e){
+                    log.error("non param1. info -> {}",e.getLocalizedMessage());
+                    throw new BizException("FeignAutoIdInterceptor run error");
+                }
+            }
+            if (entityList instanceof List) {
+                // 批量插入
+                List<?> el = (List<?>) entityList;
+                for (Object entity : el) {
+                    processEntity(entity);
+                }
+            } else  if (entityList.getClass().isArray()) {
+                // 批量插入
+                Object[] array = (Object[]) entityList;
+                for (Object entity : array) {
+                    processEntity(entity);
+                }
+            }else {
+                // 单独插入
+                processEntity(entityList);
+            }
+        } else {
+            // 单独插入
+            processEntity(parameterObject);
+        }
+    }
+
+    /**
+     * 3.处理对象实体
+     *
+     * @apiNote 3.处理对象实体
+     * @param entity 对象实体
+     */
+    private void processEntity(Object entity) {
+        Class<?> entityClass = entity.getClass();
+        if (isEntityClass(entityClass)) {
+            autoIdSet(entity);
+        }
+    }
+
+    /**
+     * 4.自动为实体设置id
+     *
+     * @apiNote 4.自动为实体设置id
+     * @param entity 对象实体
+     */
+    private void autoIdSet(Object entity) {
+        Class<?> entityClass = entity.getClass();
+        List<Field> fields = getAllFields(entityClass);
+        for (Field field : fields) {
+
+            if (field.isAnnotationPresent(GeneratedValue.class)||
+                    field.isAnnotationPresent(TableId.class)) {
+                processGeneratedValue(entity, field);
+            }
+        }
+    }
+
+    /**
+     * 5.设置id字段
+     *
+     * @param entity 实体对象
+     * @param field id字段
+     */
+    private void processGeneratedValue(Object entity, Field field) {
+        String genIdType = getGenIdType(field);
+
+        String tableName = getTableName(entity);
+
+        if (Objects.nonNull(genIdType)&&
+                Objects.nonNull(SegmentContextHelper.LeafConf())&&
+                SegmentContextHelper.LeafConf().isLeafSegmentEnable()&&
+                (genIdType.equals(GenerationTypeSeq.SEGMENT) || genIdType.equals(IdType.AUTO.name()) || genIdType.equals(IdType.ASSIGN_ID.name()))) {
+            long idValue = SegmentContextHelper.nextId(tableName);
+            setFieldValue(entity, field, idValue);
+        } else if (Objects.nonNull(genIdType)&&
+                Objects.nonNull(SnowflakeContextHelper.LeafConf())&&
+                SnowflakeContextHelper.LeafConf().isLeafSnowflakeEnable()
+                &&genIdType.equals(GenerationTypeSeq.SNOWFLAKE) ) {
+            long idValue = SnowflakeContextHelper.nextId();
+            setFieldValue(entity, field, idValue);
+        } else if (Objects.nonNull(genIdType)&&
+                (genIdType.equals(GenerationTypeSeq.UUID)|| genIdType.equals(IdType.ASSIGN_UUID.name()))) {
+            String idValue = UUID.randomUUID().toString();
+            setFieldValue(entity, field, idValue);
+        } else if (Objects.nonNull(genIdType) &&
+                genIdType.equals(GenerationTypeSeq.COSID_SEGMENT)) {
+            long idValue = CosidSegmentContextHelper.nextId(tableName);
+            setFieldValue(entity, field, idValue);
+        }
+    }
+
+    private void setFieldValue(Object entity, Field field, Object value) {
+        field.setAccessible(true);
+        // 如果value为null,则ID生成服务不可用,使用默认规则替代;有值则覆盖
+        if(!Objects.isNull(value)) {
+            if (field.getType() == String.class) {
+                ReflectionUtils.setField(field,entity,String.valueOf(value));
+            } else if (field.getType() == Integer.class) {
+                ReflectionUtils.setField(field,entity,Integer.valueOf(String.valueOf(value)));
+            } else {
+                ReflectionUtils.setField(field,entity,value);
+            }
+        }
+    }
+
+    private boolean isEntityClass(Class<?> clazz) {
+        return clazz.isAnnotationPresent(Entity.class)||clazz.isAnnotationPresent(TableName.class);
+    }
+
+    private String getTableName(Object entity){
+        Table table = entity.getClass().getAnnotation(Table.class);
+        if (Objects.nonNull(table)){
+            return table.name();
+        }
+
+        TableName tableName = entity.getClass().getAnnotation(TableName.class);
+
+        if (Objects.nonNull(tableName)){
+            return tableName.value();
+        }
+
+        return null;
+    }
+    private static List<Field> getAllFields(Class<?> clazz) {
+        List<Field> fields = new ArrayList<>();
+        while (clazz != null) {
+            Collections.addAll(fields, clazz.getDeclaredFields());
+            clazz = clazz.getSuperclass();
+        }
+        return fields;
+    }
+    private String getGenIdType(Field field){
+        GeneratedValue generatedValueAnnotation = field.getAnnotation(GeneratedValue.class);
+
+        if (Objects.nonNull(generatedValueAnnotation)){
+           return generatedValueAnnotation.generator();
+        }
+
+        TableId tableId = field.getAnnotation(TableId.class);
+
+        if (Objects.nonNull(tableId)){
+            return tableId.type().name();
+        }
+        return null;
+    }
+}