egret-app-template/AGENTS.md at master

Files

dayjoy d474216047 fix: 增加bug修复描述

2025-10-15 14:39:19 +08:00

核心目标

基于提供的工程模板架构，智能解析用户的JSON格式需求，自动生成完整的node应用及移动端Web应用。确保生成的代码具备以下特性：

最终目标：运行 yarn build 并生成部署产物，没有失败报错

基于响应式设计的单页应用（SPA）
专为移动端优化，采用单一入口点架构，所有功能模块通过组件化方式在同一页面内动态加载和切换，确保用户体验的连贯性和加载性能的优化
主题适配: 确保组件支持亮色/暗色主题
- 确保页面背景色、文字色、按钮色等UI元素在不同主题下均有良好对比度和可读性
- 但是页面上不要展示主题切换按钮，主题切换根据url参数 ?theme=dark 或 ?theme=light 来控制
错误展示：前端页面需要有统一的错误展示，用于显示API请求失败或其他操作错误的信息
不需要实现登录页，默认访问应用的用户都是已登录状态
所有请求统一使用 /src/api/index 中的 api 方法进行调用，因为已经内置了必要的请求头封装
如果有需要，使用 /src/api/user 中的 getUserInfo 方法获取当前用户信息
如果有需要，使用 /src/api/user 中的 getGroupMembers 方法获取全部用户信息列表

所有接口以 /api 为前缀
所有接口按照 tsoa 规范来编写，参考 src/controllers 目录下的 UserController、GroupController 示例
如果接口需要登录，请使用 @Security('jwt') 装饰器，tsoa 会自动调用登录校验，并把 user 信息写到req上，参考 UserController 示例
每个接口相关的类型定义(如interface、type)等，都需要按照标准注释进行类型及字段的描述注释。不明确的字段，如string类型的日期等，还需要加上 @example 表明字段具体的格式示例，例如：
```
/**
 * 用户ID
 * @example "123456"
 */
id: string;
/**
* 注册日期，格式为yyyy-MM-dd
* @example "2025-01-01"
*/
registryDate: string;
```

请注意，用户可能会多次修改需求，每次修改后用户会重新给你最新的完整的JSON需求描述。

用户每次修改后，请在现有代码基础上针对JSON中较上一次有变动的地方重点编辑实现，确保所有变更都被正确反映。

此外用户还可能通过 appBug 字段反馈bug，如果 appBug 字段不为空字符串，则必须优先修复对应的bug，并确保修复后代码依然符合用户最新的JSON需求。

请基于以上规范和用户JSON需求，生成完整的、可运行的、符合输出格式要求的代码实现。

接下来我会输出用户JSON需求，其中前端需求放在 webapp_requirements, 后端需求放在 node_backend_requirements，bug修复需求放在 appBug。

如果 webapp_requirements 为 null，代表不需要前端web页面或者web页面本次不需要变更，只需要生成后端代码如果 node_backend_requirements 为 null，代表后端代码本次不需要变更如果 appBug 不为空字符串，代表本次需要修复 bug