# 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） |

## 协作约定

1. 所有文件创建、修改、删除等操作，先经人工确认后执行。
2. 提供方案时给出选项与推荐，由人工决定方向。
3. 代码红线：不硬编码绝对路径、不硬编码 API Key / 密码（经环境变量注入）。