mirror of
https://github.com/flipped-aurora/gin-vue-admin.git
synced 2026-09-23 21:08:09 +00:00
15e6e7685c
* 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>
61 lines
1.4 KiB
Markdown
61 lines
1.4 KiB
Markdown
# 工具函数使用示例
|
|
|
|
## 这个文件负责什么
|
|
|
|
这个示例告诉 AI：当前端需要通用能力时，应先复用 `src/utils/`，而不是临时再造一套。
|
|
|
|
## 什么时候应该这样写
|
|
|
|
- 发送 HTTP 请求
|
|
- 格式化日期
|
|
- 获取字典数据
|
|
- 处理按钮权限
|
|
- 做命名转换
|
|
- 跨组件通信
|
|
|
|
## 推荐写法示例
|
|
|
|
```js
|
|
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
|
|
})
|
|
}
|
|
```
|
|
|
|
## 为什么这样写
|
|
|
|
- 统一工具入口能减少重复实现
|
|
- `request`、`format`、`dictionary`、`btnAuth` 都已经被项目广泛使用
|
|
- 复用已有工具比新造 helper 更利于 AI 和人协作
|
|
|
|
## 常见错误
|
|
|
|
- 手写日期格式化逻辑
|
|
- 直接使用 axios 绕开 `request`
|
|
- 自己再实现一套按钮权限判断
|
|
- 明明已有字典工具，却在页面里重复请求和缓存
|
|
|
|
## 真实参考文件
|
|
|
|
- `web/src/utils/request.js`
|
|
- `web/src/utils/format.js`
|
|
- `web/src/utils/dictionary.js`
|
|
- `web/src/utils/btnAuth.js`
|