T1-SD0102-01/2026Technology-Competition
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
169 Commits 1 Branch 0 Tags
5eac6480cf6959d2227f744e2e00d8961ce75813
Commit Graph
21 Commits
Author SHA1 Message Date
lhl 9a02fcd00f fix(rag): 移除 service 未用参数 + 引擎构建加锁 + 修正文档措辞 2026-08-30 00:31:18 +08:00
lhl f77fab707d feat(rag): 服务层接线（上传即索引 + use_rag 异步链路 + 强 e2e） 2026-08-30 00:25:24 +08:00
lhl 6cb92e3798 test(chat): WebSocket 进度流端到端冒烟 + design.md 记录 2026-08-29 12:15:02 +08:00
lhl 916c5beed7 feat(web): 项目级配置 + 会话命名/历史 + 设计文档纳入影响调查 
- 会话支持 name/project 字段，上传要件定义后自动命名；前端侧边栏会话历史 + localStorage 恢复，顶部只显示会话名
- 新增 ProjectsStore（SQLite）与 /api/projects CRUD；绑定项目后 _rebuild_source 合并模板/规则/代码库/设计文档，上传区仅要件定义
- StructuredSource.design_docs 与 ImpactReport.design_references；影响调查新增既有设计文档确定性交叉引用（无 LLM）
- 同步更新 docs/design.md §12.7、README、_AI_USAGE_LOG.md；全量测试 558 通过，覆盖率 99.10%
 2026-08-27 12:13:28 +08:00
lhl 838a93720e 聊天式交互改造（Web UI 升级） 
- 前端由分步表单页升级为 DeepSeek 式聊天页（static/chat.html）
- 新增 chat 包：意图识别（intent.py）+ ChatAgent（agent.py）自动驱动
  解析→影响→生成→QA 整条工作流，影响确认节点反问、错误分支兜底
- store.py 扩展 pending_intent 字段与 chat_messages 表
- app.py 新增 POST/GET /api/chat/{sid}/messages，GET / 返回聊天页
- README/design.md 同步聊天模式说明；测试 4 文件覆盖
- 全量 pytest 522 passed / 99.03%，覆盖率红线达标
 2026-08-27 05:11:40 +08:00
lhl 215c605650 feat(server): Web 服务化（FastAPI + SQLite + 内嵌零构建前端） 
参赛成果物 03「交互界面 + 数据存储」落地：
- src/genesis/server/: store.py（SQLite 会话持久化）、service.py（会话化服务层：
  上传→解析→确认→影响→确认→生成→QA）、app.py（api-design §2 核心端点 9 组）、
  static/index.html（内嵌单页，零构建无 node_modules 依赖）
- scripts/serve.py 启动入口（--fake 离线引擎 / 默认真实 LLM）
- pyproject 加 fastapi/uvicorn/python-multipart
- 修复 qa_loop._build meta={} 导致真实模板 {{doc_title}} 等占位符残留 DocxInjectError
- README Web 服务说明 + service_url 登记指引；design.md §12.5 记录（含同步执行/
  zip 既有系统/无 WebSocket 的诚实偏差标注）
- 测试：test_server_store/service/api 共 34 用例（TestClient 全链路 + zip 影响流程 + 错误分支）
全量 pytest 473 passed / 99.20%
 2026-08-26 22:13:19 +08:00
lhl a1fefd43eb docs(deliverables): 参赛成果物补齐（README 五项 + 范式图/架构图 + coverage 报告） 
按《参赛成果物提交规范·赛道一》§8：
- README：新增项目性质：新规声明、项目概述、整体功能说明、效果总结
  （431 测试/99.15% 覆盖/双语试运行/影响调查基线）、团队分工、规模与难度自评
- design.md：开发范式流程图（mermaid，6 步与 AI 日志步骤列一致）+ §2.1
  Agent 架构图（感知-规划-行动-记忆映射）
- _AI_USAGE_LOG.md：回填「待补充」→架构设计、「整体迭代」→反馈迭代
- tests/coverage/ 覆盖率 HTML 报告（99.15%）+ tests/test-execution-log.txt 执行日志
- docs/参赛成果物提交规范-赛道一.md → docs/submission-spec-track1.md（ASCII 化）
- pyproject: pytest norecursedirs 排除 test-execution-log.txt
全量 pytest 431 passed / 99.15%
 2026-08-26 14:24:02 +08:00
lhl becd3e1f57 chore(assets): 参赛提交规范红线修复（ASCII 化 + 相对路径） 
按《参赛成果物提交规范·赛道一》§6 红线：
- samples/ 目录改名 sample/（git mv，保留历史）
- 10 个中日文样本文件 + docs 参赛手册 PDF 重命名为 ASCII
  （requirements_*/template_*/rules_*/contestant-handbook.pdf）
- tests/test_zh_template.py 硬编码绝对路径 D:\00_project\Genesis 改为相对路径
- 全局更新 21 个活动文件引用；历史日志/审查文档不改（追加说明记录）
全量 pytest 431 passed / 99.15%
 2026-08-26 14:15:52 +08:00
lhl 84d3b87da3 docs: 输出语言功能文档收尾（README/design.md/计划/opencode忽略） 
- README 新增 --output-language 参数表、中文模板用法、auto 推导规则与中文场景注意
- design.md §6.2.1 新增输出语言控制设计（贯通链路/auto推导/生成期强制/标签本地化）；
  §7.2 十项校验清单 → 11 项（新增语言一致性维度）
- 计划文档验收复选框勾选
- .gitignore 加入 .opencode/（AI 工具本地配置不入库）
 2026-08-26 00:45:09 +08:00
lhl e4f533799d chore: cleanup unused imports + design.md Phase5 notes 2026-08-13 11:49:58 +08:00
lhl 7368626de6 docs(design): add Phase 5 Writer/QA subsystem section 2026-08-13 11:36:08 +08:00
lhl 0b704fb07e feat: QA 护栏 + fallback 路由（T15 架构审查整改收官，OV6） 
- src/genesis/qa/guardrails.py: resolve_qa_model() 强制 QA 走 fallback 模型（防
  DeepSeek 校验 DeepSeek 自校验盲区）；QALoopController(max_rounds=3) 约束
  「QA→Writer修正→重校验」循环边界防无限
- 集成测试验证 QA 调用实际落到 fallback 而非 primary（FakeLLMClient 记录 model）
- design.md §7.4 补 QA 护栏说明（循环边界 + 独立校验模型）
- TDD：257 passed / 100.00% 覆盖，17 项架构审查整改全部完成
 2026-08-12 23:24:15 +08:00
lhl a1336f6dd3 docs: Writer 串行约束写回（T10 架构审查整改，I14） 
- design.md §6.8.1 新增串行生成约束：理由（章间引用依赖前章 WriterState /
  并行收益低复杂度高 / Token 友好）+ 落地点（编排层严格顺序串行、UI 预估
  总时长与逐章进度、禁止并发多章）
- api-design §4.3 补串行消费说明（对应 §6.8.1）
- web-ui-design 进度 UI 补串行语义（预计=章数×单章 3-5 分）
- 纯文档，无代码变更；全量 248 passed / 100.00% 不回归
 2026-08-12 23:11:14 +08:00
lhl e3c714d5d9 feat(writer): docx 注入原型提前（T17 架构审查整改，OV8） 
- T17 (OV8, P1): 新建 src/genesis/writer/ 包
  - docx_injector.py: DocxInjector 用原生 python-docx 实现 §6.6 占位符注入
    - 章节级 {{section:id}} → 内容块 docx 元素序列（heading/paragraph/table）
    - 行内 {{meta}} → 元信息填充
    - 残留检查: 未替换 {{...}} 抛 DocxInjectError
    - 格式精度: 注入 heading 继承模板 Heading 样式，原内容不被破坏
  - 新增 test_docx_injector.py（5 用例）
  - 同步 design.md §6.7 渲染链路 T17 原型说明
- TDD: RED（模块缺失）→ GREEN（聚焦 5 passed）→ 全量 245 passed / 100.00%（1361 stmts/340 br）
 2026-08-12 22:47:43 +08:00
lhl d2e651bad0 feat(eval): 黄金集 + 评分器（T13 架构审查整改，OV4） 
- T13 (OV4, P1): 新建 src/genesis/eval/ 包
  - golden_set.py: GoldenCase/GoldenSet（YAML 加载，samples/ 真实脱敏样本作 input_ref）
  - scorer.py: ChapterScorer 按 §7.2 指标体系打分
    - 确定性维度: traceability（resolver 验证 source_uri 可解析率）/
      placeholder_residue（无 {{...}} 残留）/chapter_completeness（章节覆盖）
    - LLM 语义维度: llm_evaluators 钩子（默认中性分，待 Phase5）
  - tests/fixtures/eval/golden_set.yaml 示例黄金集
- 新增 test_eval_scorer.py（9 用例）
- 同步 design.md §7.5 黄金集与评分器（定位 CI 质量门禁）
- TDD: RED（模块缺失）→ GREEN（聚焦 8 passed）→ 全量 240 passed / 100.00%（1279 stmts/308 br）
 2026-08-12 22:44:47 +08:00
lhl 69aec7716c feat(provenance): URI 统一 + resolver + 强验证（T12 架构审查整改） 
- T12 (OV3, P1): 新建 src/genesis/parsers/resolver.py
  - parse_source_uri: 解析 file.xlsx#Sheet!CellRef → SourceRef（格式非法 raise URIError）
  - provenance_to_uri: Provenance 还原 URI（与 build_source_uri 互逆）
  - resolve_source_uri: StructuredSource 内定位真实 CellValue
  - validate_source_uris: 批量强验证 → ValidationResult(resolved/unresolved)
    格式错误或源中不存在一律 unresolved（防 QA#8 编造 URI 作弊）
- URI 唯一生成入口 build_source_uri（provenance.py），无散落不一致
- 新增 test_resolver.py（13 用例）；同步 design.md §9.2 + §6.8 第五步
- TDD: RED（模块缺失）→ GREEN（聚焦 10 passed）→ 全量 231 passed / 100.00%（1191 stmts/298 br）
 2026-08-12 22:35:56 +08:00
lhl 6a54580ca4 feat(orchestrator): DataGate 机制化 + 任务级持久化（T14/T16 架构审查整改） 
- T14 (OV5): 新建 src/genesis/orchestrator/datagate.py
  - DataGate.load(source, selector) 机制化：子集加载 + 规模保护（超 500 行
    无 selector 拒绝全量，1000 行 Excel 防上下文爆炸）+ token 预算（8000，
    复用 CJK 保守估算）+ 未知表容错
  - agent-runtime §4.2 原则→机制说明
- T16 (OV7): 新建 src/genesis/orchestrator/task_queue.py
  - TaskQueue ABC + PersistentTaskQueue（SQLite 落盘）
  - enqueue/poll/update_status/get/cancel/recover/close
  - 幂等去重（§5.3 缓存结果）+ recover 将 running→failed、pending 保留
  - api-design §5.2/5.3、agent-runtime §3.5/3.6、design §8.4.1 同步
- 新增 test_datagate.py（8 用例）+ test_task_queue.py（11 用例）
- TDD: RED（模块缺失）→ GREEN（聚焦 16 passed）→ 全量 218 passed / 100.00%（1140 stmts/278 br）
 2026-08-12 15:43:10 +08:00
lhl 3decdfc31c feat(rag): v1 rerank 精排 + bge-m3 多语言切换（T6/T11 架构审查整改） 
- T6 (Issue6): RerankConfig（enabled/model=BAAI/bge-reranker-v2-m3/device）
  - rag-layer-design §6.3 Rerank 精排：窗口=RRF top-10、候选≤top_k 跳过、
    故障降级 RRF 原序；原 §6.3-6.6 顺延 6.4-6.7
  - config-design §5 新增 rerank 段；design §5.5 检索策略加 rerank
- T11 (OV2): EmbeddingConfig.model 默认 bge-small-zh-v1.5 → BAAI/bge-m3（日文语料）
  - rag-layer-design 选型表/依赖表/manifest/流程图同步 + 新增 §2.3 日文样本验证
  - design.md / implementation-plan 4.3 / config-design embedding 同步
- 新增 test_rag_design_consistency.py 一致性门禁（6 用例防文档漂移）
- TDD: RED（默认模型仍旧 + rerank 字段不存在）→ GREEN → 全量 198 passed / 100.00%（996 stmts/252 br）
 2026-08-12 11:32:28 +08:00
lhl c170ec2edd feat(config): 删死配置 + 同步文档（T5 架构审查整改） 
- Issue5: 删除 QdrantStoreConfig / VectorStoreConfig.qdrant / task_queue.redis_url
- OV1: 同步 6 处文档（api-design §1/§4.3/§5/§6、rag-layer §9、agent-runtime §3、
  design §5.5/§8.4.1、config-design、web-ui §4.1）+ tests/fixtures/rag.yaml
  - TaskQueue 标注 v1 仅 InMemory，Redis/Valkey 为 v2 预留（Scope 缩减裁定）
  - Storage Adapter 仅 ChromaAdapter，工厂移除 qdrant 分支
  - 历史评审记录保留原样不改写
- 新增 3 用例，同步 2 个 qdrant 依赖用例；全量 189 passed / 100.00%（991 stmts/252 br）
 2026-08-12 10:54:56 +08:00
lhl 1a3c829d4c docs: Web UI 设计评审修订（v1.0→v1.1，7 项发现全修 + api §2.2 write_instruction） 2026-08-09 13:28:38 +08:00
lhl 82cd2f270e chore: 基线提交——既有设计文档与样本数据 2026-08-08 15:16:42 +08:00