lhl 9d0d3409c2 docs(log): 修复 _AI_USAGE_LOG.md 表格渲染断裂
- 删除表内 4 处空行与 1 处误写入的工具输出残留行
- L55 摘要内嵌错误码表的管道符转义为 \\|(GFM 表格内反引号不保护 |)
- 拆分被 || 拼接的两条 2026-08-23 记录为独立两行
- 零日志行删除;修复后 116 行均为有效 5 列,单一表格完整渲染
2026-08-24 16:03:09 +08:00

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)。

S
Description
零号概要设计者
Readme
2.3 MiB
Languages
HTML 73.8%
Python 22.4%
JavaScript 2.4%
CSS 1.4%