Skip to content

Commit 2967442

Browse files
committed
🐞 fix: 修复构建错误
1 parent 0ad9e1d commit 2967442

32 files changed

Lines changed: 826 additions & 988 deletions

File tree

AGENTS.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# AI 开发助手行为准则
22

33
## 项目技术栈与环境
4+
45
- **核心框架**: Vue 3 + Electron
56
- **UI 组件库**: **Naive UI** (严禁混用其他 UI 库)
67
- **包管理器**: **严格使用 `pnpm`** (严禁使用 npm/yarn)
@@ -10,49 +11,59 @@
1011
## 代码风格与规范
1112

1213
### 1. 注释规范
14+
1315
- **语言**: 必须使用**中文**
1416
- **格式**: 保持简洁,禁止长句、英文长文或带序号的注释。
1517
- 正确: `// 监听主进程消息`
1618
- 错误: `// 1. listen to main process`, `// this function handles ipc...`
1719

1820
### 2. UI 组件使用Naive UI
21+
1922
- **原则**: 严禁重复造轮子。所有通用交互必须优先使用 Naive UI 组件。
2023
- **处理方式**: 如果未找到合适组件,必须先询问用户,禁止擅自手写原生 CSS/HTML 组件。
2124
- 正确: 使用 `<n-button type="primary">`, `<n-modal>`, `<n-message-provider>`
2225
- 错误: 手写 `<div class="my-btn">` 或引入 Element Plus 等其他库。
2326

2427
### 3. 图标
28+
2529
- **原则**: 优先复用项目 `src/icons` 或现有图标方案。
2630
- **具体实现**: 严格遵循项目现有的图标组件用法。
2731
- 正确: `<SvgIcon :name="isLikeAlbum ? 'Favorite' : 'FavoriteBorder'" />`
2832
- 错误: 擅自引入 `xicons` (除非用户明确允许) 或手写 SVG 代码。
2933

3034
### 4. Electron 特性规范
35+
3136
- **进程安全**: 明确代码运行环境(Main vs Renderer)。不要在渲染进程中直接调用不安全的 Node.js API,应优先使用 IPC 通信或 Preload 脚本暴露的 API。
3237
- **通信规范**: 涉及 IPC 通信时,保持频道命名清晰且常量化。
3338

3439
### 5. 测试与清理
40+
3541
- **临时文件**: 任务过程中生成的临时测试文件(如 `test_lrc.ts`),必须在任务结束前自动删除,严禁推送到代码库。
3642

3743
## 交互与思维链
3844

3945
### 1. 遇到困难多确认
46+
4047
- **原则**: 禁止假设。当遇到不理解的概念(特别是 Electron 的通信逻辑或原生能力调用)时,**必须**暂停并向用户提问。
4148
- 禁止: “我猜用户是想在渲染进程直接读文件...” -> 导致安全报错。
4249
- 建议: “此处涉及文件系统操作,请确认是通过 IPC 调用主进程处理,还是使用现有的工具函数?”
4350

4451
### 2. 复杂任务先规划
52+
4553
- **文档驱动开发**: 遇到复杂功能(如窗口管理、系统托盘、复杂逻辑重构)时,**必须**先创建一个临时的 Markdown 文档(如 `name_of_task.md`)。
4654
- **流程**: 在文档中梳理思路 -> 展示给用户 -> 用户同意 -> 开始写代码。
4755

4856
### 3. 复用优先DRY原则
57+
4958
- **原则**: 在编写新功能前,强制检索项目现存代码。
5059
- **自检**: “项目中是否已经有类似的 IPC 封装或 UI 组件?”如果是,直接复用。
5160

5261
### 4. 聊天方式
62+
5363
- **原则**: 与用户保持中文对话,禁止使用英文或其他语言。
5464
- **具体实现**: 所有与用户的交互(包括问题、指令、代码展示等)都必须用中文进行。
5565

5666
## 严格合规声明
67+
5768
- **指令等级**: Critical。
58-
- **违规后果**: 违反以上任何一条规则将被定义为**任务失败**,代码将被直接拒绝。请务必严格执行上述标准。
69+
- **违规后果**: 违反以上任何一条规则将被定义为**任务失败**,代码将被直接拒绝。请务必严格执行上述标准。

0 commit comments

Comments
 (0)