@gadmin2n/schematics 0.0.69 → 0.0.71

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/components/agentPanel/skills.ts

@@ -1,464 +0,0 @@
-/**
- * Gadmin2 Skills Metadata
- * Generated from gadmin2-llm-coding-plugin/skills/
- */
-
-export interface SubSkill {
-  id: string;
-  name: string;
-  description: string;
-}
-
-export interface Skill {
-  id: string;
-  name: string;
-  description: string;
-  category: 'page' | 'project';
-  /** Page types this skill applies to */
-  pageTypes?: ('list' | 'create' | 'edit' | 'show')[];
-  /** Sub-skills (references) */
-  subSkills?: SubSkill[];
-}
-
-export const skills: Skill[] = [
-  // ==================== 页面级技能 ====================
-
-  // 列表页定制
-  {
-    id: 'list-customization',
-    name: '列表页定制',
-    description:
-      '定制 Gadmin2 列表页 (web/src/pages/{model}/list.tsx)。适用场景：添加永久筛选器、自定义表格列、添加行操作、自定义导入/导出、添加批量操作、渲染 JSON 字段、转换为树形结构、添加外部链接、创建自定义页面（仪表盘、统计）、应用设计模式、添加弹窗调用 API、筛选关联选择器选项、搜索时重置分页、跨资源查询，或修改列表页行为。',
-    category: 'page',
-    pageTypes: ['list'],
-    subSkills: [
-      {
-        id: 'permanent-filter',
-        name: '添加永久数据筛选器',
-        description: '基于 Context 值（如 gameId）为列表页添加永久筛选器。',
-      },
-      {
-        id: 'filter-transform',
-        name: '筛选值类型转换',
-        description: '将筛选值从字符串转换为数字，以兼容 Prisma。',
-      },
-      {
-        id: 'relation-select-filter',
-        name: '自定义关联选择器筛选',
-        description: '根据当前上下文，用筛选后的数据覆盖默认的关联选择器选项。',
-      },
-      {
-        id: 'search-reset-pagination',
-        name: '搜索时重置分页',
-        description: '执行搜索筛选时，将表格分页重置到第一页。',
-      },
-      {
-        id: 'export-customization',
-        name: '自定义 CSV 导出',
-        description: '自定义导出 CSV 的字段名称、顺序和值格式化。',
-      },
-      {
-        id: 'import-customization',
-        name: '自定义 CSV 导入（含错误弹窗）',
-        description: '自定义导入字段映射，并为导入失败显示错误弹窗。',
-      },
-      {
-        id: 'batch-modify-modal',
-        name: '添加批量修改弹窗',
-        description: '添加弹窗，批量修改选中行的某个字段。',
-      },
-      {
-        id: 'batch-delete-promise',
-        name: '自定义批量删除（Promise 循环）',
-        description: '用 Promise 循环替代默认批量删除，提供详细反馈。',
-      },
-      {
-        id: 'column-render',
-        name: '自定义表格列渲染',
-        description: '使用 TagField、BooleanField、颜色、图标等自定义列显示。',
-      },
-      {
-        id: 'json-badge-render',
-        name: '将 JSON 字段渲染为 Badge 状态',
-        description: '解析 JSON 字符串并渲染为带状态指示器的 Badge。',
-      },
-      {
-        id: 'row-action-link',
-        name: '添加行操作跳转链接',
-        description: '在行操作中添加链接，跳转到带筛选条件的关联资源列表。',
-      },
-      {
-        id: 'row-action-external',
-        name: '添加外部系统链接',
-        description: '在行操作中添加外部系统链接（如云日志、监控）。',
-      },
-      {
-        id: 'row-action-modal-api',
-        name: '行操作弹窗调用 API',
-        description: '添加自定义行操作，打开弹窗并调用外部 API。',
-      },
-      {
-        id: 'custom-row-actions',
-        name: '通过配置添加自定义行操作',
-        description: '使用 rowActions 配置添加自定义行操作。',
-      },
-      {
-        id: 'tree-structure',
-        name: '扁平数据转树形结构',
-        description: '将层级数据显示为可展开的树形表格。',
-      },
-      {
-        id: 'extend-prisma-select',
-        name: '扩展 Prisma Select 字段',
-        description: '添加默认 select 中没有的额外查询字段。',
-      },
-      {
-        id: 'conditional-create-button',
-        name: '条件显示/隐藏创建按钮',
-        description: '仅在满足特定条件时显示 CreateButton。',
-      },
-      {
-        id: 'readonly-mode',
-        name: '简化为只读模式',
-        description: '移除创建/编辑/删除操作，仅保留查看功能。',
-      },
-      {
-        id: 'cross-resource-query',
-        name: '跨资源数据查询',
-        description: '通过名称或字段查询其他资源，获取 ID 用于 API 调用。',
-      },
-      {
-        id: 'custom-page',
-        name: '添加自定义页面',
-        description: '在模型目录中创建新的自定义页面（统计、仪表盘等）。',
-      },
-      {
-        id: 'design-patterns',
-        name: '定制化设计模式',
-        description: '组织自定义代码的常用 React 模式。',
-      },
-      {
-        id: 'column-visibility',
-        name: '列显示/隐藏控制',
-        description: '通过 UI Config 或自定义实现（含 localStorage 持久化）控制表格列的显示/隐藏。',
-      },
-      {
-        id: 'conditional-row-style',
-        name: '条件行样式',
-        description: '根据记录数据（如状态颜色、优先级指示器）为表格行应用条件样式。',
-      },
-      {
-        id: 'fixed-column',
-        name: '固定列',
-        description: '将表格列固定在左侧或右侧，支持水平滚动。',
-      },
-      {
-        id: 'inline-edit',
-        name: '行内编辑',
-        description: '启用表格单元格的行内编辑（Input、Select、Switch、点击编辑）。',
-      },
-    ],
-  },
-
-  // 表单页定制
-  {
-    id: 'form-customization',
-    name: '表单页定制',
-    description:
-      '定制 Gadmin2 创建/编辑表单页 (web/src/pages/{model}/create.tsx 和 edit.tsx)。适用场景：添加级联选择器、添加字段提示、添加自定义校验器、添加帮助提示、自定义表单组件、提交时转换表单数据、添加字段依赖（条件显示/隐藏字段）、添加业务隔离（studio_id）、创建单例表单（自动创建/编辑）、添加自动补全搜索、加载关联数据、添加外部帮助链接、添加保存后提示，或修改表单行为。',
-    category: 'page',
-    pageTypes: ['create', 'edit'],
-    subSkills: [
-      {
-        id: 'cascader-component',
-        name: '用级联选择器替换下拉框',
-        description: '使用 Cascader 进行层级选择（如 来源 -> 类型）。',
-      },
-      {
-        id: 'field-tooltip',
-        name: '为表单字段标签添加提示',
-        description: '在表单字段标签旁添加带 tooltip 的帮助图标。',
-      },
-      {
-        id: 'custom-validator',
-        name: '添加自定义表单校验器',
-        description: '添加自定义校验规则，如 cron 表达式、URL 格式等。',
-      },
-      {
-        id: 'help-alert',
-        name: '在表单上方添加帮助提示',
-        description: '在表单上方添加带说明的 Alert 组件。',
-      },
-      {
-        id: 'form-field-dependencies',
-        name: '添加表单字段依赖',
-        description: '根据其他字段的值显示/隐藏表单字段。',
-      },
-      {
-        id: 'form-data-transform',
-        name: '提交前转换数据',
-        description: '在发送到 API 之前转换表单值。',
-      },
-      {
-        id: 'business-isolation',
-        name: '业务隔离（多租户）',
-        description: '在表单提交时添加 studio_id 或 tenant_id 实现数据隔离。',
-      },
-      {
-        id: 'singleton-form',
-        name: '单例表单（动态创建/编辑）',
-        description: '根据已有记录自动判断是创建还是编辑。',
-      },
-      {
-        id: 'autocomplete-search',
-        name: '自动补全搜索',
-        description: '用 AutoComplete + Search 替换默认输入框，支持外部 API 查询。',
-      },
-      {
-        id: 'load-related-data',
-        name: '加载关联数据',
-        description: '从其他资源获取数据用于表单（选项、校验等）。',
-      },
-      {
-        id: 'external-help-links',
-        name: '外部帮助链接',
-        description: '在表单下方添加文档链接和帮助文本。',
-      },
-      {
-        id: 'post-save-alert',
-        name: '保存后提示与引导',
-        description: '保存成功后显示提示，引导用户进行下一步操作。',
-      },
-    ],
-  },
-
-  // 详情页定制
-  {
-    id: 'show-customization',
-    name: '详情页定制',
-    description:
-      '定制 Gadmin2 详情页 (web/src/pages/{model}/show.tsx)。适用场景：自定义字段显示、将 JSON 渲染为 Badge、添加自定义字段渲染、格式化字段值、简化为只读模式（移除编辑/删除按钮），或修改详情页布局。',
-    category: 'page',
-    pageTypes: ['show'],
-    subSkills: [
-      {
-        id: 'field-render',
-        name: '自定义字段显示',
-        description: '自定义详情页上字段的显示方式。',
-      },
-      {
-        id: 'json-field-render',
-        name: '将 JSON 字段渲染为结构化显示',
-        description: '解析并以合适的格式显示 JSON 字段。',
-      },
-      {
-        id: 'readonly-header',
-        name: '只读头部按钮',
-        description: '简化只读资源的详情页头部。',
-      },
-    ],
-  },
-
-  // ==================== 项目级技能 ====================
-
-  // 后端定制
-  {
-    id: 'backend-customization',
-    name: '后端定制',
-    description:
-      '定制 Gadmin2 NestJS 后端代码。适用场景：多数据库连接、级联创建/更新/删除、禁用/添加自定义接口、字段加密、API Key 认证、创建者权限检查、公开接口、强制分页、返回实体、聚合查询、Swagger 增强、业务状态机、乐观锁。适用于 server/src/modules/。',
-    category: 'project',
-    subSkills: [
-      {
-        id: 'multi-database',
-        name: '多数据库连接',
-        description: '使用 CustomPrismaService 连接多个数据库。',
-      },
-      {
-        id: 'cascade-create',
-        name: '级联创建',
-        description: '创建主记录时同时创建关联记录。',
-      },
-      {
-        id: 'cascade-update',
-        name: '级联更新',
-        description: '更新主记录时同时更新关联记录。',
-      },
-      {
-        id: 'cascade-delete',
-        name: '级联删除',
-        description: '删除主记录时同时删除关联记录。',
-      },
-      {
-        id: 'disable-endpoint',
-        name: '禁用接口',
-        description: '移除或禁用默认的 CRUD 接口。',
-      },
-      {
-        id: 'custom-endpoint',
-        name: '添加自定义接口',
-        description: '添加业务相关的 API 接口。',
-      },
-      {
-        id: 'field-encryption',
-        name: '字段加密',
-        description: '存储前对敏感字段进行加密。',
-      },
-      {
-        id: 'api-key-auth',
-        name: 'API Key 认证',
-        description: '除用户登录外，还支持通过 API Key 访问 API。',
-      },
-      {
-        id: 'owner-permission',
-        name: '创建者权限检查',
-        description: '仅允许创建者或管理员修改/删除记录。',
-      },
-      {
-        id: 'public-endpoint',
-        name: '公开接口（免认证）',
-        description: '使接口无需认证即可公开访问。',
-      },
-      {
-        id: 'force-pagination',
-        name: '强制分页参数',
-        description: '覆盖或修正分页参数。',
-      },
-      {
-        id: 'return-entity',
-        name: '返回实体而非计数',
-        description: '更新操作返回完整实体数据。',
-      },
-      {
-        id: 'aggregation-endpoint',
-        name: '聚合查询接口',
-        description: '添加 groupBy/aggregate 查询接口。',
-      },
-      {
-        id: 'swagger-enhancement',
-        name: 'Swagger 文档增强',
-        description: '添加包含示例的详细 API 文档。',
-      },
-      {
-        id: 'business-state-machine',
-        name: '业务状态机',
-        description: '基于状态变更触发操作。',
-      },
-      {
-        id: 'optimistic-lock',
-        name: '乐观锁',
-        description: '使用版本字段防止并发更新冲突。',
-      },
-    ],
-  },
-
-  // 国际化
-  {
-    id: 'i18n',
-    name: '国际化',
-    description:
-      '为 React 应用添加国际化（i18n）支持。适用场景：添加多语言支持、翻译菜单/资源、翻译页面内容标签/图例/提示、重构组件以支持 i18n、添加语言切换，或实现 react-i18next 翻译。',
-    category: 'project',
-    subSkills: [
-      {
-        id: 'menu-i18n',
-        name: '菜单国际化实现',
-        description: '在 Refine resources 配置中翻译菜单标签。',
-      },
-      {
-        id: 'page-i18n',
-        name: '图表/数据国际化实现',
-        description: '翻译图表图例、提示、系列名称、表格和表单标签。',
-      },
-    ],
-  },
-
-  // Prisma Schema
-  {
-    id: 'prisma-schema',
-    name: 'Prisma Schema 编写',
-    description:
-      '编写带 Gadmin2 注解的 Prisma schema。适用场景：定义模型、添加字段、创建/编辑 schema.prisma、使用 @FormItem（Select、Boolean、Text、JSON、Image 等）、@IgnoreAutoField、@IgnoreReactCode、@IgnoreNestCode、添加校验器（@Min、@Max、@Length、@IsByteLength、@IsEmail、@IsPhoneNumber）、添加索引（@@index、@@unique），或在 config/prisma/*.prisma 或 config/schema.prisma 文件中配置数据模型。',
-    category: 'project',
-  },
-
-  // UI 配置
-  {
-    id: 'ui-config',
-    name: 'UI 配置',
-    description:
-      '通过 config/ui.config.ts 配置 Gadmin2 UI。适用场景：配置表格列、设置表单字段、自定义列表/详情页、编辑 ui.config.ts、使用字段选择 glob 模式、配置表格操作、筛选器、排序器、批量操作、行操作，或表单联动。',
-    category: 'project',
-  },
-
-  // 使用指南
-  {
-    id: 'guide',
-    name: 'Gadmin2 使用指南',
-    description:
-      'Gadmin2 低代码管理面板生成器通用指南。适用场景：了解 gadmin2、如何使用 gadmin、创建管理面板、低代码工具、生成 CRUD、项目结构、快速开始流程、添加模型，或获取 Gadmin2 通用指导。',
-    category: 'project',
-  },
-];
-
-/**
- * Get skills by category
- */
-export function getSkillsByCategory(category: 'page' | 'project'): Skill[] {
-  return skills.filter((s) => s.category === category);
-}
-
-/**
- * Get page skills filtered by current page type
- */
-export function getPageSkills(
-  pageType?: 'list' | 'create' | 'edit' | 'show',
-): Skill[] {
-  const pageSkills = getSkillsByCategory('page');
-  if (!pageType) return pageSkills;
-  return pageSkills.filter((s) => s.pageTypes?.includes(pageType));
-}
-
-/**
- * Get project-level skills
- */
-export function getProjectSkills(): Skill[] {
-  return getSkillsByCategory('project');
-}
-
-/**
- * Get all sub-skills from a skill
- */
-export function getSubSkills(skillId: string): SubSkill[] {
-  const skill = skills.find((s) => s.id === skillId);
-  return skill?.subSkills || [];
-}
-
-/**
- * Find a skill or sub-skill by ID
- */
-export function findSkillById(id: string): Skill | SubSkill | undefined {
-  // First check main skills
-  const mainSkill = skills.find((s) => s.id === id);
-  if (mainSkill) return mainSkill;
-
-  // Then check sub-skills
-  for (const skill of skills) {
-    const subSkill = skill.subSkills?.find((sub) => sub.id === id);
-    if (subSkill) return subSkill;
-  }
-
-  return undefined;
-}
-
-/**
- * Get parent skill ID for a sub-skill
- */
-export function getParentSkillId(subSkillId: string): string | undefined {
-  for (const skill of skills) {
-    if (skill.subSkills?.some((sub) => sub.id === subSkillId)) {
-      return skill.id;
-    }
-  }
-  return undefined;
-}