14 KiB
14 KiB
AI 使用日志
自动记录 — 每次创建/修改代码文件后 AI 自动追加
范式步骤说明：开发结束后将"待补充"替换为设计文档范式图中的步骤名称（如：需求澄清→AI生成方案→人工审核→AI编码→测试验证→反馈迭代）
| 日期时间 | 范式步骤 | 修改摘要 | 涉及文件 | 使用模型 |
|---|---|---|---|---|
| 2024-06-12 10:00 | 需求澄清 | 项目文件夹结构规划，确定项目资料/ + ppt-agent/ 二级分离 | 项目资料/, ppt-agent/ | DeepSeek |
| 2024-06-12 11:00 | 需求澄清 | 竞品调研，整理20+工具（国际/国内/开源）形成竞品清单 | 参考资料/竞品分析/竞品清单.md | DeepSeek |
| 2024-06-12 15:00 | 需求澄清 | 创建AGENTS.md项目规则文件，建立AI使用日志规范 | AGENTS.md | DeepSeek |
| 2024-06-12 16:00 | 需求澄清 | 规范日志格式：统一为一日一文件、仅含摘要 | AGENTS.md | DeepSeek |
| 2026-06-13 09:00 | 需求澄清 | 梳理事前调查清单（17项6阶段），确认试跑ppt-master策略 | 项目资料/事前调查/ | DeepSeek |
| 2026-06-13 11:00 | 需求澄清 | 确认项目定位：Web端可视化界面，完全依赖AI写代码 | 项目资料/事前调查/ | DeepSeek |
| 2026-06-15 09:00 | AI 编码实现 | ppt-master v1.0首次试跑，发现3个问题并修复（封面白、中文乱码、英文大写） | ppt-master skill files | DeepSeek |
| 2026-06-15 12:00 | AI 编码实现 | 技能扩展：新增D) Tech Training模式，修改5个文件 | references/strategist.md, executor-base.md, executor-tech-training.md, brands/tech-training/ | DeepSeek |
| 2026-06-15 15:00 | AI 编码实现 | ppt-master v2.0全流程生成，输出日文版PPT（10页） | ai-basics-jp-v2_v2.0.pptx | DeepSeek |
| 2026-06-15 16:00 | AI 编码实现 | 源文件恢复（--move导致源文件被移入项目目录，复制回原位置） | sources/ | DeepSeek |
| 2026-06-22 10:00 | 需求澄清 | 项目方向审视：从"Web系统"修正为"Agent为核心"，更新项目说明 | 对外资料/项目说明.md | DeepSeek |
| 2026-06-22 14:00 | 需求澄清 | 确认Agent架构：感知→规划→行动→记忆，明确范围（汇报+培训） | 对外资料/项目说明.md | DeepSeek |
| 2026-06-23 09:00 | 需求澄清 | 环境确认（Python/Node.js/OpenCode/DeepSeek API全绿灯） | 项目资料/ | DeepSeek |
| 2026-06-23 10:00 | AI 编码实现 | 分析3份社内PPT标杆素材，提炼汇报和培训的结构规范 | 事前调查/02-场景规范/社内汇报与培训PPT规范.md | DeepSeek |
| 2026-06-23 14:00 | AI 编码实现 | 撰写设计文档（成果物02）：范式图+架构图+组件+工具清单 | 对外资料/设计文档.md | DeepSeek |
| 2026-06-25 09:00 | AI 编码实现 | PPT自动生成试跑：用AI用语说明资料_v7.md初始化PPT项目 | projects/ai_terminology_training_ppt169_20260624/ | DeepSeek |
| 2026-06-25 10:00 | AI 编码实现 | 生成17页商务蓝白PPT，完成质量检查（0 error）并导出首版 | 17个svg_output/.svg → exports/.pptx | DeepSeek |
| 2026-06-25 14:00 | AI 编码实现 | 第一轮优化：字体统一、目录4+4、◆前缀替代横线、编号对齐、页码右下角 | spec_lock.md, svg_output/*.svg | DeepSeek |
| 2026-06-25 16:00 | AI 编码实现 | 第二轮优化：纯中文去日文、正文去◆纯编号、表格/流程图化、色块间距≥16px | spec_lock.md, svg_output/*.svg | DeepSeek |
| 2026-06-25 17:27 | AI 编码实现 | 最终导出优化版PPTX（17页Native DrawingML，0失败） | exports/ai_terminology_training_20260625_172746.pptx | DeepSeek |
| 2026-06-25 18:00 | 需求澄清 | 查阅参赛者手册，确认当前进度与下一步行动计划 | AGENTS.md, _AI_USAGE_LOG.md | DeepSeek |
| 2026-06-25 18:30 | 需求澄清 | 在AGENTS.md中添加自动日志规则，创建_AI_USAGE_LOG.md并回填历史 | AGENTS.md, _AI_USAGE_LOG.md | DeepSeek |
| 2026-07-20 15:40 | 需求澄清 | 【回补】撰写产品需求文档 PRD：23条用户故事、错误码体系、两版本策略/不做布局模板等关键决策定稿 | 项目资料/需求与思路/02-需求文档/产品需求文档_PRD.md | DeepSeek |
| 2026-07-23 10:09 | 需求澄清 | 【回补】PRD 修订至 v1.2，补充里程碑与开发阶段对应关系 | 项目资料/需求与思路/02-需求文档/产品需求文档_PRD.md | DeepSeek |
| 2026-08-17 14:13 | AI 编码实现 | 【回补】ppt-master 引擎完整拷贝进项目内副本作为真值（58.27MB/12144文件） | engine/ppt-master/ | DeepSeek |
| 2026-08-17 14:28 | AI 编码实现 | 【回补】撰写《系统详细设计》v0.1：分层架构/REST API/数据库设计/Agent四层模块/参数映射/集成方式 | ppt-agent/docs/系统详细设计.md | DeepSeek |
| 2026-08-17 16:41 | AI 编码实现 | 【回补】Sprint 1 骨架编码：config、SQLite五表DDL、感知/规划/行动/记忆/调度五模块、引擎桥接、Flask路由、前端四页面与中日语包 | config.py, src/db/, src/agent/, src/engine_bridge/, src/web/app.py, static/*.html, lang/zh.json, lang/ja.json | DeepSeek |
| 2026-08-24 16:32 | 需求澄清 | 渲染引擎选型调研：ppt-master vs aura-ppt 十三维度对比，定选 aura-ppt 并形成移植可行性评估与缺口清单 | 项目资料/事前调查/引擎选型对比_ppt-master_vs_aura-ppt.md | DeepSeek |
| 2026-08-24 16:35 | AI 编码实现 | 将 aura-ppt 引擎（6文件/112.7KB）拷入项目内副本作为真值，原技能路径转为只读参照 | engine/aura-ppt/ | DeepSeek |
| 2026-08-24 16:40 | 需求澄清 | AGENTS.md 引擎管理章节同步新格局：aura-ppt 主渲染引擎 + ppt-master 辅助引擎双副本约束 | AGENTS.md | DeepSeek |
| 2026-08-24 16:55 | AI 编码实现 | aura-ppt 首次实战：依据 aurak-wiki.md 生成日文本部长报告 PPT（16页 report-jp），修复章节页 content 数组格式与流程图分隔符两处适配问题，保真验证通过 | 华丹用文件/02.報告用資料/00.本部长报告/AI人材育成/plan_honbu_aurak.json | DeepSeek |
| 2026-08-24 17:18 | AI 编码实现 | 追加公司模板版：--template 继承母版（白紙版式/10.83×7.5in），主次色 #0B3D91/#1976D2 与 report-jp 一致，保真验证通过，与纯设计系统版并存对比 | 华丹用文件/02.報告用資料/00.本部长报告/AI人材育成/*_テンプレート版.pptx | DeepSeek |
| 2026-08-24 17:41 | AI 编码实现 | P0 渲染链路真化：config 双引擎路径、engine.py 注册五色设计系统（corp-blue/green/purple/orange/gray）、planning.py 改产出 plan.json（Markdown标题分页算法）、bridge.py 封装 render/verify、action.py 删占位SVG接通真渲染、并发信号量接通（2003）；新增 tests 冒烟+e2e 全链路通过（注册→生成→下载真实PPTX） | config.py, src/agent/planning.py, src/agent/action.py, src/agent/orchestrator.py, src/engine_bridge/bridge.py, src/engine_bridge/__init__.py, engine/aura-ppt/scripts/engine.py, tests/smoke_build_plan.py, tests/e2e_web.py | DeepSeek |
| 2026-08-24 17:46 | AI 编码实现 | 设计文档 v0.2：第5章重写为 plan.json 映射（五色板/分页算法/母版策略），第6章重写为 aura-ppt 集成方式，第1/4/9章散点同步；AGENTS.md 成果物③状态更新；回补6/25～8/23日志空档5条并归档当日摘要 | ppt-agent/docs/系统详细设计.md, AGENTS.md, _AI_USAGE_LOG.md, 项目资料/AI使用日志/2026-08-24_本次对话主要内容.md | DeepSeek |
| 2026-08-25 07:57 | AI 编码实现 | 界面修复：工作台中间内容区去掉 max-width:900px 限制改为 width:100%，宽屏下表单卡片铺满浏览器，消除右侧空白条 | src/web/static/workspace.html | DeepSeek |
| 2026-08-25 08:06 | AI 编码实现 | 工作台单屏化改造：中间区与配置面板改弹性布局（卡片/正文框自动伸缩、生成按钮钉底、间距压缩），1920×800 与 1366×768 双分辨率验证页面/主区/配置区均无滚动条 | src/web/static/workspace.html | DeepSeek |
| 2026-08-25 08:30 | AI 编码实现 | 修复配置面板内部空白：定位到 .btn-generate 的 margin-top:auto 吸收全部 flex 自由空间导致 space-between 失效，去掉 auto 后六个配置区均匀分布铺满面板高度（1920×1080 验证） | src/web/static/workspace.html | DeepSeek |
| 2026-08-25 09:40 | AI 编码实现 | Sprint 2 对话修改闭环：新增 chat.py（中日双语意图解析：换色/改标题/改页增删改 + plan.json 变更 + 重渲染 + 两版本落库）；app.py 增加 /api/chat 与消息查询；前端对话弹窗；修复 save_version 缺 svg_dir、下载路由误取旧版、bridge 子进程 GBK 编码崩溃、plan 变更未写盘四个 bug；e2e_chat 16 项断言全绿 + 浏览器实测通过 | src/agent/chat.py, src/agent/memory.py, src/web/app.py, src/web/static/workspace.html, lang/zh.json, lang/ja.json, tests/e2e_chat.py, docs/系统详细设计.md, src/engine_bridge/bridge.py | DeepSeek |
| 2026-08-25 10:04 | AI 编码实现 | 在线预览上线：PowerPoint COM（WPS 兜底）导出每页 PNG，按版本缓存；新增 preview_export.ps1 + bridge.export_preview_images（本地化文件名归一化 Slide.PNG）+ app.py 预览两路由（归属校验/文件名白名单）+ 前端预览弹层；浏览器实测 7 页加载成功且预览反映对话修改后的科技紫版本 | src/engine_bridge/preview_export.ps1, src/engine_bridge/bridge.py, src/engine_bridge/__init__.py, src/web/app.py, src/web/static/workspace.html, lang/zh.json, lang/ja.json | DeepSeek |
| 2026-08-25 12:09 | AI 编码实现 | 大模型接入（零Key方案）：新建 llm.py 客户端复用 opencode serve（模型 mimo-v2.5-free 经三模型基准选定44s/大纲）；四项能力落地——LLM内容规划（章节结构+信息量标题+每页个性化备注）、智能标题接口+按钮、对话意图LLM化（自动定位页码）、三级降级链（提示词约束→数字消毒器→保真失败自动降规则模式）；新增 e2e_llm 与 bench_models 测试全绿，修复元组赋值顺序/用户标题被LLM改写两 bug；设计文档新增5.6节 | src/agent/llm.py, src/agent/planning.py, src/agent/chat.py, src/web/app.py, src/web/static/workspace.html, lang/zh.json, lang/ja.json, config.py, tests/e2e_llm.py, tests/bench_models.py, docs/系统详细设计.md | DeepSeek |
| 2026-08-25 13:28 | AI 编码实现 | 状态文档同步：AGENTS.md 成果物③更新为 Sprint 2 完成（对话修改+在线预览+LLM零Key接入）并补技术栈 LLM 说明；系统详细设计升 v0.3——1.2 模块表、2.3 接口清单预览路由、4.1 文件树补 chat.py/llm.py、4.6 意图解析改 LLM 优先、新增 4.7 在线预览设计、9.3 补六个 LLM 配置项、第十章 Sprint 1/2 标注完成及实现偏差 | AGENTS.md, ppt-agent/docs/系统详细设计.md, ppt-agent/_AI_USAGE_LOG.md | DeepSeek |
| 2026-08-25 16:33 | AI 编码实现 | Sprint 3 上传解析提前落地：新建 upload.py 解析模块（CLI 调 ppt-master source_to_md 五脚本，md/txt 直读，URL 抓取，产物清洗：去横幅/图片引用/反转义）；app.py 新增 /api/upload（白名单+20MB+24h清理）与 /api/parse 两路由；前端上传区接通点击弹窗/拖拽/文件列表/URL行/解析回填正文；语言包补10键、requirements 补5依赖；e2e_upload 21项断言全绿 + 浏览器实测点击→选文件→解析回填全链路通过 | src/agent/upload.py, src/web/app.py, src/web/static/workspace.html, lang/zh.json, lang/ja.json, requirements.txt, tests/e2e_upload.py | DeepSeek |
| 2026-08-25 16:52 | AI 编码实现 | Sprint 3 设置偏好+历史语言筛选落地：app.py 新增 Epic 6 四路由（GET /api/settings、PUT username/password/preferences，含 5001/5002/1001/1003 校验）；settings.html 重构为账户安全+默认偏好双卡片并接真实接口（补 i18n 中日支持）；memory.list_records 加 language 参数；history.html 加语言筛选下拉与记录语言标签；e2e_settings 18项断言全绿 + 浏览器实测保存偏好→工作台预填联动通过 | src/web/app.py, src/web/static/settings.html, src/web/static/history.html, src/agent/memory.py, lang/zh.json, lang/ja.json, tests/e2e_settings.py | DeepSeek |
| 2026-08-25 17:49 | AI 编码实现 | UI 全语言收尾：login.html/history.html 接入中日语包（含动态文案），三页补侧栏/角落语言切换按钮，修复设置页标题键名冲突，语言包补18键；四页浏览器联测日英切换全通过 | src/web/static/login.html, src/web/static/history.html, src/web/static/settings.html, lang/zh.json, lang/ja.json | DeepSeek |
| 2026-08-25 17:49 | AI 编码实现 | 网络配图管线落地：aura-ppt 引擎（项目内副本）新增 place_image 右侧配图布局（等比缩放/居中/边框，r_content 左文右图）+ verify 跳过 image 键；新建 imaging.py 配图模块（CLI 调 image_search.py，test 本地通道/off 禁用，单页失败仅告警优雅降级）；action.py 主流程与 LLM 降级分支挂载；config 增 IMAGE_SEARCH* 四配置；引擎试跑 + e2e_image 9项断言全绿（含空图源降级场景）；实测本机 openverse/wikimedia 不可达，真实源待换网络或配 Key 即启用 | engine/aura-ppt/scripts/engine.py, src/agent/imaging.py, src/agent/action.py, config.py, tests/e2e_image.py | DeepSeek |
| 2026-08-26 11:18 | 反馈迭代 | 修复用户报告的110页照搬问题（产品决策：取消规则降级）：planning.py 重写为纯 LLM 总结模式——失败抛 PlanningError 明确报错；新增长文档两级规划（分段通读提炼→汇总大纲，全文覆盖不再只读前3000字）；页数硬约束（校验裁剪保证不超上限）；action.py 重构为两轮完整尝试+具体失败原因透传；前端失败 toast 显示后端原因；chat.py 封面替换意图规范化为改标题；e2e_llm 15项全绿 + 8168字80节长文档冒烟：13页预算内、13/13带备注、后段章节覆盖 | src/agent/planning.py, src/agent/action.py, src/agent/chat.py, src/web/static/workspace.html, config.py, tests/e2e_llm.py | DeepSeek |
| 2026-08-26 14:14 | 反馈迭代 | 修复要点碎片化问题（用户反馈：内容全是短语无完整句）：两级提示词改写——通读阶段要求完整陈述句（15-40字含主语谓语）、大纲阶段明确完整句要求并附正误示例对照；_validate_slides 新增碎片化门禁（要点均长<10字打回重写）；e2e 增加完整句断言，17项全绿（短文档均长22字/长文档26字） | src/agent/planning.py, tests/e2e_llm.py | DeepSeek |