create-yss-spec 3.0.0 → 3.1.0

package/template/.hermes/skills/yss-design-system/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Design System"
-  short_description: "YSS 产品设计系统与 Ant Design 风格基线"
-  default_prompt: "Use $yss-design-system to design or review a YSS UI against the project design system."

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

@@ -1,64 +0,0 @@
-# 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/.hermes/skills/yss-design-system/references/design-system.md

@@ -1,245 +0,0 @@
-# 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-ui-business-page-generation`；生命周期编排和旧触发词兼容使用 `yss-page-module-development`。
-- 新业务表单使用 `YFormily` schema；`YssFormily` 仅用于历史兼容。
-- 表格使用 `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/.hermes/skills/yss-design-system/scripts/validate-frontmatter.mjs

@@ -1,36 +0,0 @@
-#!/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/.hermes/skills/yss-design-system/scripts/validate-frontmatter.test.mjs

@@ -1,12 +0,0 @@
-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/.hermes/skills/yss-distributed-id/SKILL.md

@@ -1,69 +0,0 @@
----
-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/.hermes/skills/yss-distributed-id/agents/openai.yaml

@@ -1,5 +0,0 @@
-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/.hermes/skills/yss-distributed-id/assets/AutoIdInterceptor.java

@@ -1,246 +0,0 @@
-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;
-    }
-}