3f4d17cf69cb81380c50cd07750098d4491f38af
真实 ja 试运行暴露:auto 模式 fallback 误用 impact/data 源数据(含中文元素名 止损风控等 + 汉字标签无假名)→ 把日文文档误判为期望 zh → LLM 正常日文输出被 判违规 → 硬失败。修复:fallback 改用 write_rules/design_rules(RAG 自日文作成 说明书/记入规则检索,含假名可靠判 ja);加回归测试 test_generate_chapter_auto_with_ja_rules_but_chinese_source_data_enforces_ja。 修复后 ja 真实试运行成功(7章);zh 真实试运行成功(7章);425 passed / 99.15%
Genesis — 概要设计书自动生成 Agent
读取 Excel 版要件定义、概要设计做成说明书、概要设计模板、概要设计书记入规则和图表规则等输入资料,自动生成符合规范的 Word 版概要设计书(追加/改修场景会结合既有系统源码做影响调查)。
安装
# 1. 创建虚拟环境并安装依赖(Python >= 3.11)
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
# 2. 配置 LLM API Key(真实模式必需;离线 --fake 模式可跳过)
# 编辑 .env(已被 .gitignore 忽略,密钥不入库):
# GENESIS_INFERENCE__API_KEY=sk-xxx
# 可选:
# GENESIS_INFERENCE__BASE_URL=https://api.deepseek.com
# GENESIS_INFERENCE__MODEL=deepseek-chat
试运行
默认输入为 samples/ 下既有样本(追加改修·股票场景 + sunOnly 既有系统 + 真实概要设计书模板)。
离线 Fake 模式(无需 API key,验证整条管线)
python scripts/run_trial.py --fake
真实 LLM 模式(需先在 .env 配置 API Key)
python scripts/run_trial.py
输出
output/output.docx— 概要设计书output/impact-report.json— 影响调查书(JSON,独立可下载)
output/ 已加入 .gitignore,试运行产物不入库。
自定义输入
python scripts/run_trial.py `
--requirement samples\要件定義_追加改修_股票.xlsx `
--template samples\概要設計書テンプレート.docx `
--rules samples\概要設計做成説明書.docx samples\記入規則.docx `
--existing-system samples\existing-system `
--language java `
--output output\output.docx
测试
python -m pytest
全量单测 + 覆盖率检查(红线 fail_under = 99)。
Languages
HTML
73.8%
Python
22.4%
JavaScript
2.4%
CSS
1.4%