Files
gin-vue-admin/aiDoc/examples/frontend/utils-usage-example.md
T
15e6e7685c update:发布2.9.2版本 (#2211)
* feat: 调整AI工作模式,更符合harness基准

* feat: 添加BusinessDB字段到PluginInitializeGorm结构体,并增加相关测试用例

* [middleware/jwt.go]: fix #2192 issues bug

* docs: add auto plugin design spec

* chore: ignore worktrees directory

* feat: 调整代码辅助能力至插件

* feat: 添加警告条组件,提示授权用户访问限制

* fix: 修正商业用途版权声明链接

* feat: 调整agent.md 更加节省token

* fix: 修改casbin版本为v3

* feat: 更新JSONMap和JSONSlice类型,优化GORM数据类型处理

* feat: 添加数据库就绪通知机制,优化插件注册流程

* feat: 重构API路径和描述,优化代码生成器和模板配置分组

* feat: 优化 person 页面的 css 作用域限制

* feat: 更新 vite 至 vite8

* 新增:MCP工具为指定URL的角色ID授权

* fix: 增加文件名合法性检查,拒绝包含非法字符的文件写入

* chore: 更新CI配置,升级Node.js和Go版本,调整checkout和setup动作版本

* feat: 为数据库连接增加最大复用时间配置

* feat: 为各数据库连接配置增加最大连接生命周期设置

* feat: 更新插件注册逻辑并优化API和菜单组件的标签显示

* feat: 更新版本号至v2.9.2并添加新插件路径信息

---------

Co-authored-by: taincheng <zhangtc@gmail.com>
Co-authored-by: Azir-11 <2075125282@qq.com>
Co-authored-by: lanxi <1220lanxi@gmail.com>
2026-05-11 13:48:18 +08:00

1.4 KiB

工具函数使用示例

这个文件负责什么

这个示例告诉 AI:当前端需要通用能力时,应先复用 src/utils/,而不是临时再造一套。

什么时候应该这样写

  • 发送 HTTP 请求
  • 格式化日期
  • 获取字典数据
  • 处理按钮权限
  • 做命名转换
  • 跨组件通信

推荐写法示例

import service from '@/utils/request'
import { formatDate, CreateUUID } from '@/utils/format'
import { getDict } from '@/utils/dictionary'
import { useBtnAuth } from '@/utils/btnAuth'

const token = CreateUUID()
const createdAt = formatDate(new Date())

const loadStatusDict = async () => {
  return await getDict('order_status')
}

const btnAuth = useBtnAuth()

export const fetchOrderList = (data) => {
  return service({
    url: '/order/getOrderList',
    method: 'post',
    data
  })
}

为什么这样写

  • 统一工具入口能减少重复实现
  • requestformatdictionarybtnAuth 都已经被项目广泛使用
  • 复用已有工具比新造 helper 更利于 AI 和人协作

常见错误

  • 手写日期格式化逻辑
  • 直接使用 axios 绕开 request
  • 自己再实现一套按钮权限判断
  • 明明已有字典工具,却在页面里重复请求和缓存

真实参考文件

  • web/src/utils/request.js
  • web/src/utils/format.js
  • web/src/utils/dictionary.js
  • web/src/utils/btnAuth.js