1.6 KiB
1.6 KiB
AGENTS.md — AI 协作方式与项目说明
本文件说明本项目的 AI 开发协作方式，并与根目录
_AI_USAGE_LOG.md配合溯源。
项目说明
- 项目：PPT 自动生成 Agent（赛道一：Agent 开发实战赛 · 新规项目）
- 核心定位：Agent 为 C 位，Web 为必要交互界面。Agent 包装 aura-ppt 主渲染引擎，实现「感知→规划→行动→记忆」业务闭环。
- 技术栈：OpenCode + DeepSeek（完全免费，大赛推荐）；主渲染引擎 aura-ppt（python-pptx 确定性渲染）；Web 框架 Flask；数据存储 SQLite；大模型经 opencode serve 免费接入（mimo-v2.5-free，零 Key），预留 OpenAI 兼容接口，配 Key 即切 DeepSeek。
- 开发范式：需求澄清 → AI 生成方案 → 人工审核 → AI 编码实现 → 测试验证 → 反馈迭代（范式图见
DESIGN.md）。
AI 使用日志规则（自动执行）
每次创建或修改代码文件后，在项目根目录的 _AI_USAGE_LOG.md 中追加一条记录，必须包含以下字段：
| 字段 | 说明 |
|---|---|
| 日期时间 | AI 修改代码的时间 |
| 范式步骤 | 与 DESIGN.md 范式图步骤名一致 |
| 修改摘要 | 本次 AI 修改做了什么 |
| 涉及文件 | 被 AI 创建或修改的代码文件路径 |
| 使用模型 | 本次使用的 AI 模型（DeepSeek） |
协作约定
- 所有文件创建、修改、删除等操作，先经人工确认后执行。
- 提供方案时给出选项与推荐，由人工决定方向。
- 代码红线：不硬编码绝对路径、不硬编码 API Key / 密码（经环境变量注入）。