指令如下: # Codex 全局规则 ## 操作原则 - 优先提交小规模、易于审查的代码变更(diffs)。除非明确要求,否则避免进行大范围的重构。 - 在开始编辑前,请先确定需要修改的文件,并用 3 到 6 个要点简述你的修改计划。 - 绝不凭空捏造 API、配置项或文件路径。如有疑问,请先在代码仓库(repo)中进行搜索。 - 每一次我提出需求后,你给出改动方案,等我确认后,再开始改。 - 确保所有修改与项目现有的代码风格及架构保持一致。 ## 安全与敏感信息 - 绝不允许将敏感信息(Secrets)、Token、私钥、`.env` 变量值或各类凭据直接粘贴到代码或日志中。 - 如果某项任务确实需要使用敏感信息,请要求我通过环境变量的形式提供。 - 除非我明确要求,否则请勿添加任何数据分析、遥测追踪或网络请求相关的代码。 ## UI设计 - 当我提供figma文稿时,请严格按照figma文稿进行UI制作,优先在本地搜索同名素材,若本地icon库无同名素材,则使用figma本地素材,注意图标渲染效果,确保图标、图片等本地素材可以正常显示。 ## 代码质量标准 - 如果项目已建立测试体系,且你的代码修改涉及功能行为的变更,请同步添加或更新相应的测试用例。 - 优先采用类型安全(Type Safety)的编程实践,并确保错误处理逻辑清晰且显式。 - 仅当代码意图并非一目了然时,才需要添加注释进行解释。 ## 构建与运行规范 - 如果你需要执行特定的命令行指令,请明确提出具体的命令内容,并说明执行该命令的理由。 - 当你提交的修改可能导致构建失败时,请务必优先运行最快速、最相关的检查(如单元测试)。 ## 输出格式要求 - 针对代码修改任务:请提供一份简短的修改摘要,并列出所有被修改的文件列表。 - 针对调试任务:请说明你的假设(Hypotheses)、已执行的实验步骤,以及最终应用的最小化修复方案。 ## 修订历史记录 - 每完成一次修订后,请同步更新以下文件:`PROJECT_BRIEF.md`、`PAGE_MAP.md`、`DATA_MAP.md` 、 `CHANGELOG.md`。 - 仓库内文档与源码统一使用 UTF-8,脚本读写文件时要显式指定 utf-8,PowerShell / 终端查看中文文件时优先切换到 UTF-8 输出。 ## 我的偏好 - 我偏好简明扼要的解释、具体可行的操作步骤,以及可以直接复制粘贴执行的命令行指令。 - 解释说明的默认语言:中文。