Files
2026Technology-Competition/_AI_USAGE_LOG.md
T

31 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
| 日期时间 | 范式步骤 | 修改摘要 | 涉及文件 | 使用模型 |
|----------|----------|----------|----------|----------|
| 2026-07-04 | 架构设计 | 在AGENTS.md中新增"文档生成规则",强制所有文档保存到docs/目录 | AGENTS.md | deepseek-v4-flash-free |
| 2026-07-21 10:47 | 需求理解 | 完成大赛规则分析、项目需求理解、技术调研 | docs/extracted.txt | deepseek-v4-flash-free |
| 2026-07-21 10:47 | 架构设计 | 完成5 Agent协作架构设计与数据模型设计 | AGENTS.md | deepseek-v4-flash-free |
| 2026-07-21 | 架构设计 | 完成Parser Agent详细设计(Probe/Extract二段阶、画像认识、format处理、风险分析) | 会话记录 | deepseek-v4-flash-free |
| 2026-07-21 | 架构设计 | AGENTS.md追加"交流语言"规则(统一使用中文);RAG必要性讨论 | AGENTS.md | deepseek-v4-flash-free |
| 2026-07-21 | 架构设计 | Grilling Session:RAG定位分析、股票量化交易系统文档规范分析、确认RAG为必需基础设施 | 会话记录 | deepseek-v4-flash-free |
| 2026-07-21 | 架构设计 | Impact Agent苏格拉底式讨论:明确影响调查书双面向(人+Writer Agent),采用确认版方案 | 会话记录 | deepseek-v4-flash-free |
| 2026-07-21 | 設計 | Web UI設計文書をdocs/に出力(画面構成・状態管理・多ユーザー・SQLiteセッション・タスクキュ) | docs/web-ui-design.md | deepseek-v4-flash-free |
| 2026-07-21 | 設計 | Writer Agent詳細設計確定(データマッピング/逐章生成/Heading定位/全章生成後統一確認/WriterStateによる章間参照) | 会话記録 | deepseek-v4-flash-free |
| 2026-07-21 | 設計 | QA Agent詳細設計確定(10項チェック/逐字比較+LLM意思一致判定/エラーはWriterにフィードバック) | 会話記録 | deepseek-v4-flash-free |
| 2026-07-21 | 設計 | 現状システム探索・RAG Layer・既存設計文書の必要性とRAGの位置づけを最終確認 | 会話記録 | deepseek-v4-flash-free |
| 2026-07-21 | 架构设计 | 完成设计文档(docs/design.md)和实现计划(docs/implementation-plan.md)输出 | docs/design.md, docs/implementation-plan.md | deepseek-v4-flash-free |
| 2026-07-30 11:11 | 待补充 | 恢复会话上下文,准备继续设计工作 | _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-07-30 12:30 | 架构设计 | 完成 RAG Layer 详细设计(技术选型/分割/存储/版本管理/检索/冲突处理/接口)并输出文档;design.md 第5章改为摘要+链接 | docs/rag-layer-design.md, docs/design.md | deepseek-v4-flash-free |
| 2026-07-30 13:10 | 架构设计 | 完成 Agent 运行时层详细设计(推理引擎/编排状态机/三层记忆/工具接口/可观测性/幂等/安全)并输出文档 | docs/agent-runtime-design.md | deepseek-v4-flash-free |
| 2026-07-30 14:00 | 架构设计 | 全面自查修复:状态机删 parsing_done 统一8状态+确认事件持久化;版本号统一整数;术语统一(写入/设计/参考);补 Storage Adapter 章节;QA 第7章细化10项验证;implementation-plan 同步运行时层/RAG/QA 任务 | docs/agent-runtime-design.md, docs/web-ui-design.md, docs/design.md, docs/rag-layer-design.md, docs/implementation-plan.md | deepseek-v4-flash-free |
| 2026-07-30 14:30 | 文档规范 | 全文档日文翻译中文:design.md 第2/3/4/8/10章、web-ui-design.md 全部日文页面/技术设计/异常处理翻译;保留技术必要日文(Sheet检测关键词/JSON Schema枚举/日文规则文档示例,均加说明注释) | docs/design.md, docs/web-ui-design.md, docs/rag-layer-design.md | deepseek-v4-flash-free |
| 2026-07-30 | 架构设计 | 设计充分性评估后补齐缺口:design.md 新增 §9.4 数据模型定义(SheetType等枚举/Parser类型补全/运行时衔接/引用关系图)、§6 Writer 详细设计扩展(JSON内容块格式/章节↔模板映射/docxtpl占位符/渲染链路/每章时序/WriterState章间引用);新增 docs/api-design.mdREST端点清单+状态转移/WebSocket事件/编排调用链/TaskQueue抽象/部署拓扑/错误码)、docs/config-design.mdapp/inference/rag yaml+.env+Docker Compose/校验脱敏)、docs/sample-spec.md(样本规格);用 openpyxl+python-docx 造样 7 个脱敏样本至 samples/(3类要件定义+概要设计模板+做成说明书+记入规则+图表规则);同步 implementation-plan.md 文档引用 | docs/design.md, docs/api-design.md, docs/config-design.md, docs/sample-spec.md, docs/implementation-plan.md, samples/要件定義_新規開発.xlsx, samples/要件定義_追加改修.xlsx, samples/要件定義_自由記述.xlsx, samples/概要設計書テンプレート.docx, samples/概要設計做成説明書.docx, samples/記入規則.docx, samples/図表規則.xlsx | deepseek-v4-flash-free |
| 2026-07-30 | 架构设计 | 全量四层设计评审(config+数据模型/核心Agent+运行时/RAG+API+WebUI/一致性交付),产出 docs/design-review.md;修复 P0-1data_models.py 统一+future.annotations 落地说明)、P1-1agent-runtime 两处 Redis → TaskQueue 抽象)、P2-1embedding 字段命名统一)、P2-2ImageDescription vs ImageAnalysis 区分注释)、P2-4impact_matrix 结构补全)、P2-5writing 回退端点)、P0-1 连带(plan §1.2 future.annotations | docs/design-review.md, docs/design.md, docs/agent-runtime-design.md, docs/api-design.md, docs/rag-layer-design.md, docs/implementation-plan.md | deepseek-v4-flash-free |
| 2026-08-08 | 架构设计 | 设计补齐与评审收口(按今日日期补记):① 设计充分性评估并补齐缺口(design.md §9.4 数据模型、§6 Writer 详细设计;新增 api-design/config-design/sample-spec 三文档;造样 7 个脱敏样本至 samples/);② 全量四层设计评审并修复 8 处问题(P0-1 前向引用落地说明、P1-1 TaskQueue 抽象、P2 系列字段/结构/端点修正);③ 输出统一评审报告 docs/design-review.mdv1.1)。设计阶段全部收口,待进入 Agent 实现阶段 | docs/design-review.md, docs/design.md, docs/agent-runtime-design.md, docs/api-design.md, docs/config-design.md, docs/sample-spec.md, docs/implementation-plan.md, samples/7个样本) | deepseek-v4-flash-free |
| 2026-08-08 | Agent 实现 | Phase1 里程碑1 实现:① 实施计划(docs/superpowers/plans/2026-08-08-phase1-foundation.md3 任务:骨架/数据模型/config);② 项目骨架与 pyproject 打包(src 布局);③ 数据模型 data_models.pydesign §3+§9.4 全部枚举与 dataclassfuture.annotations);④ 配置加载 config.py(三 yaml 模型 + 环境变量优先级 + ${VAR} 展开 + 脱敏);修正实现期发现的两个问题(fixtures 命名与 _load_yaml 名称对齐、_env_overrides 键小写化) | docs/superpowers/plans/2026-08-08-phase1-foundation.md, pyproject.toml, src/genesis/__init__.py, src/genesis/data_models.py, src/genesis/config.py, tests/test_smoke.py, tests/test_data_models.py, tests/test_config.py, tests/fixtures/ | deepseek-v4-flash-free |
| 2026-08-08 | 测试验证 | Phase1 里程碑1 验证:pytest 全绿(14 passed:冒烟/data_models/config),配置加载覆盖 yaml 映射、默认值、env 覆盖、env 新增键、占位符展开、脱敏;git 提交 4 次(e865a78/9d69bb3/dc62670 + 计划 b4587aa | tests/, src/genesis/ | deepseek-v4-flash-free |
| 2026-08-08 | Agent 实现 | 里程碑2 Task1 实现:parsers 包基础与来源标注。新建 src/genesis/parsers/__init__/provenance/excel_reader)、测试辅助 tests/excel_helpers.pynew_workbook/save_workbook 供全任务复用)与 tests/test_excel_reader.py3 用例:source_uri 格式、open_workbook+sheet_matrix、拒绝 .xls);TDD 验证 REDModuleNotFoundError)→ GREEN3 passed);pytest 全量 17 passed;提交 df9427c | src/genesis/parsers/__init__.py, src/genesis/parsers/provenance.py, src/genesis/parsers/excel_reader.py, tests/excel_helpers.py, tests/test_excel_reader.py | deepseek-v4-flash-free |
| 2026-08-08 | Agent 实现 | 里程碑2 Task2 实现:SheetDetector 类型识别。新建 src/genesis/parsers/sheet_detector.py(名称关键词→表头关键词→GENERIC 三级判定,detect_sheet_type(sheet_name, matrix)->SheetType)与 tests/test_sheet_detector.py3 用例:名称/表头/未知);TDD 验证 REDModuleNotFoundError)→ GREEN3 passed);修正 brief 缺陷:brief 原始 NAME_KEYWORDS 无法匹配「コード管理」判为 MASTER(不含"マスタ"),最小补入 ("コード", MASTER)pytest 全量 20 passed;提交 66753e4 | src/genesis/parsers/sheet_detector.py, tests/test_sheet_detector.py | deepseek-v4-flash-free |
| 2026-08-08 | Agent 实现 | 里程碑2 Task3 实现:Sheet 性质判定。新建 src/genesis/parsers/sheet_nature.py(纯函数:SheetNature 枚举 TABLE/FREE_TEXT/MIXED、find_header_row 表头行定位、classify_sheet 按 design §3.5.2 启发式判定)与 tests/test_sheet_nature.py4 用例);TDD RED→GREENpytest 全量 24 passed | src/genesis/parsers/sheet_nature.py, tests/test_sheet_nature.py | deepseek-v4-flash-free |
| 2026-08-08 23:04 | Agent 实现 | 里程碑2 Task4 实现:MergeHandler 与 TableExtractor。新建 src/genesis/parsers/merge_fill.pyforward_fill 合并单元格展开,(min_row,min_col,max_row,max_col) 1-based 范围用左上主格值填充,边界保护)与 src/genesis/parsers/table_extractor.pycolumn_letter 1→A/27→AAextract_table 首行表头→其后为数据行,构建 CellValue+Provenance(row=r-header_row 从 1 起、column 字母、column_header),无矩阵时返回空表)及 tests/test_table_extractor.py4 用例:纵向/横向合并、列字母、基本提取);TDD 验证 REDImportError: No module named 'genesis.parsers.merge_fill')→ GREEN4 passed);pytest 全量 28 passeddata_models.py 未改动;提交 63d0c90 | src/genesis/parsers/merge_fill.py, src/genesis/parsers/table_extractor.py, tests/test_table_extractor.py | deepseek-v4-flash-free |
| 2026-08-09 02:59 | Agent 实现 | 里程碑2 Task5 实现:FormattingDetector(取消线/背景色/批注)。新建 src/genesis/parsers/formatting_detector.pycell_formatting 检测 strike/字体色/背景色,纯默认单元格返回 Nonecell_comment 返回 CellCommentcollect_comments 遍历 ws.iter_rows 收集批注)与 tests/test_formatting_detector.py4 用例);TDD 验证 REDImportError)→ GREEN4 passed);修正 brief 两处 openpyxl 3.1.5 兼容问题(① 字体 Style 对象不可变,测试用 copy 副本设 strike;② 默认 theme 色 .rgb 返回错误文本而非 None,新增 _to_rgb_hex 严格校验仅接受 6/8 位十六进制并排除纯黑);pytest 全量 32 passeddata_models.py 未改动 | src/genesis/parsers/formatting_detector.py, tests/test_formatting_detector.py | deepseek-v4-flash-free |