lhl 6372bb17b9 feat(run): 试运行脚本 + 运行说明（真实 LLM 默认 / --fake 离线） ...

- scripts/run_trial.py：库级端到端驱动（argparse 默认指向 samples/ 股票追加改修+sunOnly+真实模板）
  - --fake 离线 FakeEngine（无 key）/ 默认 build_inference_engine 真实 LLM（读 .env）
  - SourceParser → WriteOrchestrator 门控自动影响调查 → output/output.docx + impact-report.json
  - 暴露 main(argv) 供测试
- tests/test_run_trial.py（fake 模式断言 13 章 + summary 16/5/8/3/50/0 + 文件产出 + docx 注入）
- .gitignore 新增 output/（试运行产物不入库）
- 新建 README.md（安装 / .env 配置 / 离线与真实试运行 / 输出 / 测试）
- 全量 364 passed / 99.28%；fake 试运行 PASS（13 章、summary 与 MVP 基线一致）

2026-08-24 11:05:45 +08:00

..

fixtures

feat(eval): 黄金集 + 评分器（T13 架构审查整改，OV4）

2026-08-12 22:44:47 +08:00

__init__.py

chore: 项目骨架与 pyproject 打包（src 布局 + pytest 就绪）

2026-08-08 15:28:52 +08:00

docx_helpers.py

test: docx 测试基建（新建/落盘/规则文档快捷构造）

2026-08-10 09:21:55 +08:00

excel_helpers.py

feat: ExcelParser 基础（workbook/sheet 读取 + source_uri）

2026-08-08 16:50:24 +08:00

inference_helpers.py

feat(inference): LLM 客户端全异步化（T8 架构审查整改）

2026-08-12 09:50:37 +08:00

test_api_design_consistency.py

chore: 一致性门禁收尾（plan 计数、尾换行、消息与注释润色）

2026-08-09 17:11:38 +08:00

test_code_parser.py

refactor(impact): CodeParser 多语言就绪——语言适配器注册表（仅 Java，行为不变）

2026-08-23 18:49:34 +08:00

test_config.py

feat(rag): v1 rerank 精排 + bge-m3 多语言切换（T6/T11 架构审查整改）

2026-08-12 11:32:28 +08:00

test_data_models.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_datagate.py

feat(orchestrator): DataGate 机制化 + 任务级持久化（T14/T16 架构审查整改）

2026-08-12 15:43:10 +08:00

test_docx_injector.py

fix(writer): 防静默丢章告警 + 占位符正则宽容化（大小写/全角冒号）

2026-08-23 14:47:14 +08:00

test_eval_scorer.py

feat(eval): 黄金集 + 评分器（T13 架构审查整改，OV4）

2026-08-12 22:44:47 +08:00

test_excel_parser.py

test: 覆盖率提升至 100%（fail_under 90→99，13 个防御/边界用例）

2026-08-09 04:49:29 +08:00

test_excel_reader.py

feat: ExcelParser 基础（workbook/sheet 读取 + source_uri）

2026-08-08 16:50:24 +08:00

test_existing_system_explorer.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_formatting_detector.py

test: 覆盖率提升至 100%（fail_under 90→99，13 个防御/边界用例）

2026-08-09 04:49:29 +08:00

test_free_text_extractor.py

fix: 遗留清理（枚举同源/边界防御/断言补强）

2026-08-09 04:18:39 +08:00

test_impact_agent.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_inference_client.py

feat(inference): LLM 客户端全异步化（T8 架构审查整改）

2026-08-12 09:50:37 +08:00

test_inference_engine.py

feat(inference): LLM 客户端全异步化（T8 架构审查整改）

2026-08-12 09:50:37 +08:00

test_inference_errors.py

feat: 异常树 error_code 类属性（对齐 api-design §7 错误码）

2026-08-09 13:38:59 +08:00

test_inference_factory.py

feat(inference): 接通真实 LLM 引擎工厂（P5-T10 门禁接线）

2026-08-13 23:11:31 +08:00

test_inference_prompt_registry.py

feat: PromptRegistry 注册/版本/渲染（jinja2）

2026-08-09 08:03:17 +08:00

test_inference_token.py

feat(inference): CJK 保守 token 估算（T9 架构审查整改）

2026-08-12 09:54:20 +08:00

test_inference_types.py

feat: 结果对象 error_code 字段（默认 None 向后兼容）

2026-08-09 13:44:19 +08:00

test_paragraph_splitter.py

feat: 段落分割 split_paragraphs（通用空行分词）

2026-08-09 03:59:24 +08:00

test_phase5_context_builder.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_phase5_e2e.py

test(qa): add headless Phase5 e2e (FakeLLM pipeline)

2026-08-13 11:23:00 +08:00

test_phase5_exceptions.py

feat(writer): add WriterGenerationError

2026-08-13 09:11:58 +08:00

test_phase5_models.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_phase5_qa_loop.py

test(writer/qa): 覆盖 engine=None 委托工厂的真实门禁路径

2026-08-13 23:13:58 +08:00

test_phase5_rag.py

fix(services): make RagService protocol sync + fix no-op isinstance assertion

2026-08-13 09:27:16 +08:00

test_phase5_renderer.py

feat(writer): add renderer (ChapterContent -> DocxInjector.Block)

2026-08-13 10:08:41 +08:00

test_phase5_report.py

feat(qa): add QAReport + QAValidator.validate_doc

2026-08-13 11:05:01 +08:00

test_phase5_scorer.py

feat(eval): populate EvalReport.per_chapter + failed_chapters in score()

2026-08-13 10:44:35 +08:00

test_phase5_template_mapper.py

fix(writer): 防静默丢章告警 + 占位符正则宽容化（大小写/全角冒号）

2026-08-23 14:47:14 +08:00

test_phase5_validator.py

feat(qa): add QAValidator (validate_chapter + validate_document)

2026-08-13 10:56:33 +08:00

test_phase5_writer_agent.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_phase5_writer_orchestrator.py

feat(impact): Impact Agent MVP —— 变更点定位 + 影响调查书（追加改修场景）

2026-08-23 17:59:08 +08:00

test_phase5_writer_state.py

feat(writer): add WriterState (cross-chapter regeneration tracking)

2026-08-13 09:46:38 +08:00

test_qa_guardrails.py

feat: QA 护栏 + fallback 路由（T15 架构审查整改收官，OV6）

2026-08-12 23:24:15 +08:00

test_rag_design_consistency.py

feat(rag): v1 rerank 精排 + bge-m3 多语言切换（T6/T11 架构审查整改）

2026-08-12 11:32:28 +08:00

test_real_samples.py

chore: Phase3 Word 解析收尾（尾随换行/import 排序/契约注释）

2026-08-10 23:39:53 +08:00

test_resolver.py

feat(provenance): URI 统一 + resolver + 强验证（T12 架构审查整改）

2026-08-12 22:35:56 +08:00

test_rule_doc_parser.py

feat: RuleDocParser 规则文档 Markdown 化与分类

2026-08-10 10:14:15 +08:00

test_run_trial.py

feat(run): 试运行脚本 + 运行说明（真实 LLM 默认 / --fake 离线）

2026-08-24 11:05:45 +08:00

test_sheet_detector.py

feat: SheetDetector 类型识别（名称/表头关键词）

2026-08-08 16:59:17 +08:00

test_sheet_nature.py

test: 覆盖率提升至 100%（fail_under 90→99，13 个防御/边界用例）

2026-08-09 04:49:29 +08:00

test_smoke.py

chore: 项目骨架与 pyproject 打包（src 布局 + pytest 就绪）

2026-08-08 15:28:52 +08:00

test_source_aggregator.py

refactor(impact): CodeParser 多语言就绪——语言适配器注册表（仅 Java，行为不变）

2026-08-23 18:49:34 +08:00

test_state_machine.py

feat(orchestrator): 会话状态机实现 + cancelled/resume（T3 架构审查整改）

2026-08-12 09:39:34 +08:00

test_table_extractor.py

test: 覆盖率提升至 100%（fail_under 90→99，13 个防御/边界用例）

2026-08-09 04:49:29 +08:00

test_task_queue.py

feat(orchestrator): DataGate 机制化 + 任务级持久化（T14/T16 架构审查整改）

2026-08-12 15:43:10 +08:00

test_word_template_parser.py

fix(writer): 防静默丢章告警 + 占位符正则宽容化（大小写/全角冒号）

2026-08-23 14:47:14 +08:00