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%
This commit is contained in:
@@ -24,7 +24,7 @@ Genesis/
|
||||
├── _AI_USAGE_LOG.md # AI 使用日志（自动生成）
|
||||
├── docs/ # 大赛规则、设计文档等
|
||||
├── src/ # 源代码
|
||||
├── samples/ # 样本输入文件（脱敏）
|
||||
├── sample/ # 样本输入文件（脱敏）
|
||||
└── README.md # 安装与运行说明
|
||||
```
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ pip install -e ".[dev]"
|
||||
|
||||
## 试运行
|
||||
|
||||
默认输入为 `samples/` 下既有样本（追加改修·股票场景 + sunOnly 既有系统 + 真实概要设计书模板）。
|
||||
默认输入为 `sample/` 下既有样本（追加改修·股票场景 + sunOnly 既有系统 + 真实概要设计书模板）。
|
||||
|
||||
### 离线 Fake 模式（无需 API key，验证整条管线）
|
||||
|
||||
@@ -45,10 +45,10 @@ python scripts/run_trial.py
|
||||
|
||||
```powershell
|
||||
python scripts/run_trial.py `
|
||||
--requirement samples\要件定義_追加改修_股票.xlsx `
|
||||
--template samples\概要設計書テンプレート.docx `
|
||||
--rules samples\概要設計做成説明書.docx samples\記入規則.docx `
|
||||
--existing-system samples\existing-system `
|
||||
--requirement sample\requirements_enhancement_stock.xlsx `
|
||||
--template sample\template_design_ja.docx `
|
||||
--rules sample\rules_design_ja.docx sample\rules_entry_ja.docx `
|
||||
--existing-system sample\existing-system `
|
||||
--language java `
|
||||
--output output\output.docx
|
||||
```
|
||||
@@ -69,12 +69,12 @@ python scripts/run_trial.py `
|
||||
|
||||
```powershell
|
||||
python scripts/run_trial.py `
|
||||
--template samples\概要设计书模板_中文.docx `
|
||||
--template sample\template_design_zh.docx `
|
||||
--output-language zh `
|
||||
--output output\output.docx
|
||||
```
|
||||
|
||||
`samples\概要设计书模板_中文.docx` 为日文模板的完整镜像（7 章锚点 `section:*` 原样保留），由
|
||||
`sample\template_design_zh.docx` 为日文模板的完整镜像（7 章锚点 `section:*` 原样保留），由
|
||||
`scripts/make_zh_template.py` 生成，可随时用该脚本重新生成。
|
||||
|
||||
**中文场景注意**：若规则文档（作成说明书/记入规则）仍为日文，`auto` 推导会倾向日文——请显式
|
||||
|
||||
@@ -119,3 +119,4 @@
|
||||
| 2026-08-25 13:40 | Agent 实现 | 输出语言一致性 + 可选输出语言 实施完成并提交（d01e1b7）：步骤A language.py 修正 resolve_expected_language（标题仅含假名时可信任，纯汉字标题回落 fallback）；步骤B _format_impact 标签本地化 zh 实际区分（新建/变更/删除/警告）；步骤C scorer 第11维度 language_consistency（不可验证=满分）、ChapterArtifact.expected_language、validator/qa_loop 透传 output_language；全量 pytest 424 passed / 99.15%；zh 模板 fake 试运行 7 章 + 扫描零假名混入；真实 LLM 双语双跑因无 API key 暂缓 | src/genesis/writer/language.py; src/genesis/eval/scorer.py; src/genesis/qa/validator.py; src/genesis/qa/qa_loop.py; src/genesis/writer/models.py; tests/test_scorer_language.py; tests/test_language_coverage.py; tests/test_phase5_e2e.py; docs/superpowers/plans/2026-08-24-language-consistency.md | x-preview-f-free (opencode) |
|
||||
| 2026-08-26 01:20 | 测试验证 | 真实 LLM 双语试运行验收（补做）：zh 模板+zh 强制 → 7章成功；ja 默认 auto → 暴露 BUG（fallback 误用 impact/data 源数据含中文元素名→日文文档误判期望 zh→硬失败），修复为 fallback 改用 write_rules/design_rules（日文规则文档）+ 回归测试；修复后 ja 重跑成功 7章；程序化扫描两输出：zh 1处=表5-1表格说明引用日文源表名（照抄原文范畴，可接受），ja 1处=封面字段作成日（误报）→ 均无中日混杂正文缺陷；全量 pytest 425 passed / 99.15% | src/genesis/writer/writer_agent.py; tests/test_writer_language.py; docs/superpowers/plans/2026-08-24-language-consistency.md; _AI_USAGE_LOG.md | x-preview-f-free (opencode) |
|
||||
| 2026-08-26 02:10 | 反馈迭代 | 未解决问题收尾：#1/#2 orchestrator.generate 新增 chapter_attempts 章级管道重试（默认3，单章硬失败不连坐整次run，耗尽才抛错）+ tests/test_orchestrator_retry.py；#3 find_language_violations 增加表格 caption 检查（rows/headers 仍照抄源不检），QA ChapterArtifact.blocks 扩为 (type,text,caption) 同步生效；#4/#5/#6/#7 文档收尾（README --output-language/中文模板、design.md §6.2.1/§7.2 十一项校验、计划验收勾选、.gitignore 加 .opencode/）；全量 pytest 431 passed / 99.15% | src/genesis/writer/orchestrator.py; src/genesis/writer/language.py; src/genesis/qa/validator.py; src/genesis/eval/scorer.py; tests/test_orchestrator_retry.py; tests/test_writer_language.py; README.md; docs/design.md; docs/superpowers/plans/2026-08-24-language-consistency.md; .gitignore | x-preview-f-free (opencode) |
|
||||
| 2026-08-26 03:00 | 文档规范 | 参赛提交规范红线修复（阶段A）：samples/ 改名为 sample/（git mv），11 个非 ASCII 文件名重命名为 ASCII（要件定義→requirements_*、模板→template_*、规则→rules_*、参赛手册PDF→contestant-handbook.pdf）；tests/test_zh_template.py 硬编码绝对路径 D:\00_project\Genesis\samples 改为相对路径；全局更新 21 个活动文件引用（src/scripts/tests/README/AGENTS/design.md/sample-spec.md）；历史日志与审查文档不改（追加本记录说明）；全量 pytest 431 passed / 99.15% 无回归 | sample/（目录改名+10文件重命名）; docs/contestant-handbook.pdf; tests/test_zh_template.py; scripts/run_trial.py; scripts/run_phase5_slice.py; scripts/make_zh_template.py; src/genesis/services/rag_service.py; src/genesis/writer/context_builder.py; src/genesis/writer/orchestrator.py; src/genesis/qa/qa_loop.py; tests/test_real_samples.py; tests/test_code_parser.py; tests/test_impact_agent.py; tests/test_phase5_rag.py; tests/test_phase5_e2e.py; tests/test_language_coverage.py; tests/test_orchestrator_retry.py; tests/test_data_models.py; tests/test_eval_scorer.py; README.md; AGENTS.md; docs/design.md; docs/sample-spec.md | x-preview-f-free (opencode) |
|
||||
|
||||
+4
-4
@@ -754,7 +754,7 @@ Writer Agent（每章循环）
|
||||
（paragraph/note/list；heading/table 不检——标题跟随模板、表格照抄源），违规按生成失败重试
|
||||
（max_retries 默认 2），耗尽抛 `WriterGenerationError` 硬失败
|
||||
- 影响调查标签按 output_language 本地化（`_format_impact`）：zh=新建/变更/删除/警告，ja=新規/変更/削除/警告
|
||||
- 中文输出需配合中文模板 `samples/概要设计书模板_中文.docx`（日文模板镜像，锚点 id 原样保留）
|
||||
- 中文输出需配合中文模板 `sample/template_design_zh.docx`（日文模板镜像，锚点 id 原样保留）
|
||||
|
||||
### 6.3 模板注入策略
|
||||
|
||||
@@ -795,7 +795,7 @@ Writer Agent（每章循环）
|
||||
"type": "list",
|
||||
"style": "bullet", // bullet | numbered
|
||||
"items": ["PK は ユーザーID とする", "外部キー制約を設定する"],
|
||||
"source_uris": ["記入規則.docx#見出し!5.1"]
|
||||
"source_uris": ["rules_entry_ja.docx#見出し!5.1"]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -1065,7 +1065,7 @@ QA 输出:
|
||||
- `placeholder_residue`：渲染文本无 `{{...}}` 残留（残留即 fail）
|
||||
- `chapter_completeness`：生成章节覆盖模板期望集合（覆盖率）
|
||||
- LLM 语义维度（内容准确性/幻觉/规则遵守）：通过 `llm_evaluators` 钩子注入，默认中性分，待 Phase5 接入真实推理
|
||||
- **黄金集（GoldenSet）**：从 YAML 加载回归基线，`samples/` 真实脱敏样本作 `input_ref`（审查报告 §8.2 已确认 7 个样本为黄金集基础）；每条 `GoldenCase` 标注 `expected_min_score`，Phase5 后用于端到端回归
|
||||
- **黄金集（GoldenSet）**：从 YAML 加载回归基线，`sample/` 真实脱敏样本作 `input_ref`（审查报告 §8.2 已确认 7 个样本为黄金集基础）；每条 `GoldenCase` 标注 `expected_min_score`，Phase5 后用于端到端回归
|
||||
- 评分器作为 CI 质量门禁：生成结果总分 < 阈值 → 阻断合并（与 fail_under=99 覆盖率门禁同级）
|
||||
→ 重复至全部通过或用户确认放行
|
||||
```
|
||||
@@ -1798,7 +1798,7 @@ Document（注入后 Word 文档）
|
||||
### 12.4 垂直切片状态
|
||||
|
||||
**FakeLLM 模式已打通（可回归）**：
|
||||
- 运行 `python scripts/run_phase5_slice.py --fake`，使用 `FakeLLMClient` 驱动整条链路，产出 `samples/phase5-slice/output.docx`。
|
||||
- 运行 `python scripts/run_phase5_slice.py --fake`，使用 `FakeLLMClient` 驱动整条链路，产出 `sample/phase5-slice/output.docx`。
|
||||
- 该切片覆盖：build_contexts → 逐章生成 → 渲染 → 注入 → QA 闭环（仅重失败章），并附带 `QAReport`。
|
||||
|
||||
**真实 LLM 生成 + 人工质量门禁（待人工执行项，P5-T10 推后）**：
|
||||
|
||||
+11
-11
@@ -1,8 +1,8 @@
|
||||
# 样本数据规格（samples/）
|
||||
# 样本数据规格（sample/）
|
||||
|
||||
> 版本: v1.0 | 日期: 2026-07-30 | 状态: 初版
|
||||
>
|
||||
> 本文档定义 `samples/` 目录下**脱敏样本数据**的规格。样本用于：
|
||||
> 本文档定义 `sample/` 目录下**脱敏样本数据**的规格。样本用于：
|
||||
> 1. 开发期单元/集成测试（implementation-plan §2.9 / §5.9 / §9.3）
|
||||
> 2. 端到端演示与验收（implementation-plan §9「3 个实样本正常动作」）
|
||||
>
|
||||
@@ -14,13 +14,13 @@
|
||||
|
||||
| 文件 | 格式 | 对应输入类型（design §3.3） | 用途 |
|
||||
|------|------|---------------------------|------|
|
||||
| `要件定義_新規開発.xlsx` | .xlsx | 要件定义（表格型） | 新规开发场景 |
|
||||
| `要件定義_追加改修.xlsx` | .xlsx | 要件定义（混合型：表格+取消线+变更区分） | 追加改修场景 |
|
||||
| `要件定義_自由記述.xlsx` | .xlsx | 要件定义（自由记述型） | LLM 结构化场景 |
|
||||
| `概要設計書テンプレート.docx` | .docx | 概要设计模板 | 输出结构/样式 |
|
||||
| `概要設計做成説明書.docx` | .docx | 做成说明书 | 各章作成指引 |
|
||||
| `記入規則.docx` | .docx | 记入规则 | 写法规范 |
|
||||
| `図表規則.xlsx` | .xlsx | 图表规则 | 图表书写规范 |
|
||||
| `requirements_newdev.xlsx` | .xlsx | 要件定义（表格型） | 新规开发场景 |
|
||||
| `requirements_enhancement.xlsx` | .xlsx | 要件定义（混合型：表格+取消线+变更区分） | 追加改修场景 |
|
||||
| `requirements_freetext.xlsx` | .xlsx | 要件定义（自由记述型） | LLM 结构化场景 |
|
||||
| `template_design_ja.docx` | .docx | 概要设计模板 | 输出结构/样式 |
|
||||
| `rules_design_ja.docx` | .docx | 做成说明书 | 各章作成指引 |
|
||||
| `rules_entry_ja.docx` | .docx | 记入规则 | 写法规范 |
|
||||
| `rules_diagram_ja.xlsx` | .xlsx | 图表规则 | 图表书写规范 |
|
||||
|
||||
---
|
||||
|
||||
@@ -98,7 +98,7 @@
|
||||
- 「機能一覧の書き方」：機能ID は F001 から連番 / 省略記号禁止
|
||||
- 「画面遷移図の書き方」：状態遷移表との整合性
|
||||
- 「用語の統一」：略語は初出時に正式名称と併記
|
||||
- 供 RAG 层测试：`記入規則.docx # 章タイトル` 检索命中（rag-layer §5.2）
|
||||
- 供 RAG 层测试：`rules_entry_ja.docx # 章タイトル` 检索命中（rag-layer §5.2）
|
||||
|
||||
### 4.4 图表规则（xlsx）
|
||||
|
||||
@@ -125,5 +125,5 @@
|
||||
## 6. 造样方法
|
||||
|
||||
- 造样脚本使用 `openpyxl`（xlsx）与 `python-docx`（docx）编程生成，**不手工编辑**
|
||||
- 脚本执行后产物落盘 `samples/`；脚本本身为一次性开发工具，不纳入版本库（如后续需重建，按本文档规格重新编写即可）
|
||||
- 脚本执行后产物落盘 `sample/`；脚本本身为一次性开发工具，不纳入版本库（如后续需重建，按本文档规格重新编写即可）
|
||||
- 生成后校验：打开所有 xlsx 确认 Sheet 名/单元格可读；打开所有 docx 确认标题层级与占位符完整
|
||||
|
||||
@@ -0,0 +1,213 @@
|
||||
# 参赛成果物提交规范 · 赛道一：Agent开发实战赛
|
||||
|
||||
> 适用范围：赛道一 · Agent开发实战赛全部参赛队伍（9 队）
|
||||
> 说明：本规范为赛道一成果物提交的唯一标准。评审系统将依据本规范自动拉取代码、检测成果物并开展评审；不符合规范将导致成果物无法被采集或评审扣分。
|
||||
|
||||
---
|
||||
|
||||
**技术大赛现已进入中期发布阶段**。为配合中期检查 / 阶段性评审，现将赛道一《参赛成果物提交规范》发布如下。各参赛队须按本规范将成果物提交至 Gitea 仓库，评审系统将据此自动拉取、检测并评审。**不按本规范提交，成果物可能无法被采集，导致不得分或扣分。**
|
||||
|
||||
> ## ⚠️ 提交截止时间（重要）
|
||||
>
|
||||
> **中期成果提交截止：2026-08-31（周一）。**
|
||||
>
|
||||
> **若 8/31 前未能将成果物提交（push）到 Gitea 服务器，该队成果物将无法被评审系统采集，中期评审结果将直接受影响（视为未按时提交，按未提交处理，不得分）。**
|
||||
>
|
||||
> 请务必在截止时间前完成：账号登录 → 成果物放入仓库 → `git push` 到 main 分支，并确认服务器上能看到最新提交。
|
||||
|
||||
---
|
||||
|
||||
## 1. 中期成果提交
|
||||
|
||||
**赛道一各队均须提交中期成果**。中期评价**不要求全部成果物**，**将截至当前已完成的部分提交即可**——主要目的是让组委会了解各队**开发进度与项目状况**。
|
||||
|
||||
**提交时间**：**2026-08-31（周一）前**完成提交并 `git push` 到 main 分支；超过截止时间未提交 → 成果物无法被采集，中期评审按未提交处理（以仓库该时间点最新提交为准）。
|
||||
> *注：以上为中期检查提交（8/31 前），建议尽量提交 §8 成果物清单中列出的全部成果物，以利最终评审的完整性判断。*
|
||||
|
||||
**提交方式与要求**：
|
||||
|
||||
- **提交对象**：赛道一全部参赛队伍
|
||||
- **提交内容**：不要求全部提交——将已完成的部分提交即可（建议至少含：项目说明、设计文档、可运行源码、AI 使用日志；未完成的可注明"进行中"）
|
||||
- **存放位置**：各队 Gitea 仓库 `2026Technology-Competition`，main 分支持续提交演进
|
||||
- **账号凭据**：Gitea 用户名与密码由组委会另行联络下发；使用前先完成账号登录与密码核对
|
||||
- **放置规则**：已完成成果物的命名与位置参照本文档 §8，与最终提交一致
|
||||
|
||||
## 2. Gitea 账号规范
|
||||
|
||||
| 项目 | 要求 |
|
||||
|---|---|
|
||||
| 用户名 | 使用组委会下发的**独立账号**（如 `T1-SD0102-01`），**禁止修改、禁止换绑** |
|
||||
| 密码 | 使用组委会下发的初始密码，**请勿修改**。如修改评审系统将无法拉取仓库，会影响评审结果 |
|
||||
| 账号用途 | 仅用于本大赛成果物存放，禁止外借、禁止在他处使用同一凭据 |
|
||||
|
||||
> 评审系统使用 `config/teams.json` 中的每队账号凭据自动拉取仓库，凭据被修改即拉取失败。
|
||||
|
||||
## 3. 仓库规范
|
||||
|
||||
> **仓库已由组委会统一创建**（命名、可见性、默认分支均已就绪），各参赛队**无需自行创建**，直接登录账号、按 §8 成果物清单放入文件并 `git push` 即可。
|
||||
|
||||
| 项目 | 要求 |
|
||||
|---|---|
|
||||
| 仓库位置 | 位于各队 Gitea 账号命名空间下（评审系统按 `https://gittea.dev/<账号>/<仓库>.git` 拉取） |
|
||||
| **仓库名称** | **统一为 `2026Technology-Competition`**（连字符，无空格） |
|
||||
| 可见性 | **Private（私有）**；评审系统使用每队下发的 token 拉取，无需公开 |
|
||||
| 默认分支 | **`main`**；使用其他分支必须在报名表登记 |
|
||||
| 仓库结构 | 成果物按 **§8 成果物清单与放置规则** 的结构存放；未按要求存放会影响评价结果 |
|
||||
| 提交规范 | 截止前须 `git push` 到该私有仓库的 main 分支；评审以仓库最新提交为准 |
|
||||
|
||||
> ⚠️ 仓库名固定为 `2026Technology-Competition`，已统一构建完毕。若账号下未见到该仓库，请联系组委会确认账号与权限。
|
||||
|
||||
## 4. 项目性质声明（必填）
|
||||
|
||||
**评审区分新规/升级项目的考核要点，一经确认不可变更。**
|
||||
|
||||
| 项目 | 要求 |
|
||||
|---|---|
|
||||
| 声明位置 | 项目说明中明确标注 **`项目性质：新规` 或 `项目性质：升级`** |
|
||||
| 新规项目 | 从零开发的新作品。提效/效果类维度须提供**对比数据**证明价值 |
|
||||
| 升级项目 | 对存量系统/流程的改造。**强制要求**提交「存量系统分析」文档与「改造前后对比」数据（缺失则对应维度扣分） |
|
||||
| 项目说明内容 | 项目概述、整体功能说明、效果总结（核心指标摘要）、团队分工、规模与技术难度自我评估 |
|
||||
|
||||
> 注：新规项目不需要提交「存量系统分析」与「改造前后对比」数据（系统为新开发），缺失不扣分；升级项目强制要求提交，缺失则对应维度扣分。
|
||||
|
||||
## 5. 开发范式与 AI 使用日志
|
||||
|
||||
**评审将范式图 ↔ AI 日志逐步骤对照验证开发过程真实性；AI 日志缺失或空白将扣分。**
|
||||
|
||||
### 5.1 开发范式流程图（必须提交）
|
||||
|
||||
- 范式图是**团队开发过程的工作流设计**（如：需求分析→AI生成方案→人工审核→AI编码→测试验证→反馈迭代），不是产品架构图。
|
||||
- 放入**设计文档**（成果物02）。图中每个步骤的名称将对应出现在 AI 使用日志的"范式步骤"列。
|
||||
- 评审时评委对照**范式图每个步骤 ↔ AI 日志对应记录**，验证范式是否真实执行。
|
||||
|
||||
### 5.2 AI 使用日志格式（`_AI_USAGE_LOG.md`）
|
||||
|
||||
根目录 `_AI_USAGE_LOG.md` 中每行/每表一条记录，**请包含以下字段**：
|
||||
|
||||
| 字段 | 说明 |
|
||||
|---|---|
|
||||
| **日期时间** | AI 修改代码的时间 |
|
||||
| **范式步骤** | 与设计文档范式图中步骤名称**一致**（如"需求分析→AI生成方案"） |
|
||||
| **修改摘要** | 本次 AI 修改做了什么 |
|
||||
| **涉及文件** | 被 AI 创建或修改的代码文件路径（**评审抽检源码文件路径回查日志**） |
|
||||
| **使用模型** | 本次使用的 AI 模型（如 DeepSeek、Qwen） |
|
||||
|
||||
**自动记录方法**：将以下规则写入项目的**指令文件**，AI 会在每次创建/修改代码文件后自动追加一条记录到 `_AI_USAGE_LOG.md`：
|
||||
|
||||
```markdown
|
||||
## 日志规则（自动执行）
|
||||
每次创建或修改代码文件后，在项目根目录的 `_AI_USAGE_LOG.md` 中追加一条记录，必须包含以下字段：日期时间、范式步骤、修改摘要、涉及文件、使用模型
|
||||
```
|
||||
|
||||
各工具的指令文件位置：
|
||||
|
||||
| 工具 | 指令文件位置 |
|
||||
|------|-------------|
|
||||
| **OpenCode** | `opencode.md` 或 `AGENTS.md` |
|
||||
| **Claude Code** | `CLAUDE.md` 或 `.claude/CLAUDE.md` |
|
||||
| **Trae** | `.trae/rules/*.md`（建议 `alwaysApply: true`） |
|
||||
| **Cursor** | `.cursor/rules/*.mdc`（建议 `alwaysApply: true`） |
|
||||
| **GitHub Copilot** | `.github/copilot-instructions.md` |
|
||||
| **Windsurf** | `.windsurfrules` |
|
||||
| **Gemini CLI** | `GEMINI.md` |
|
||||
| **其他工具** | 对应工具规则文件 |
|
||||
|
||||
> **注意**：评审系统能识别 `_AI_USAGE_LOG.md` 及 `ai_log` / `ai_usage` / `usage_log` 等变体文件名，但**建议统一使用 `_AI_USAGE_LOG.md`**（手册标准命名，最不易遗漏）。
|
||||
|
||||
## 6. 通用命名与内容红线
|
||||
|
||||
1. **文件名**：统一使用 ASCII 小写字母、数字、连字符（`-`）或下划线（`_`）。禁止空格、中文、全角字符、`&`/`#`/`%` 等特殊字符。
|
||||
2. **禁止提交**：
|
||||
- 密钥 / token / 密码 / `.env` 等敏感文件
|
||||
- 构建产物：`node_modules/`、`dist/`、`build/`、`target/`、`__pycache__/`
|
||||
- 超大二进制文件（单个 >50MB）
|
||||
3. **代码红线**：禁止硬编码绝对路径（如 `C:\...`、`/home/...`）、禁止硬编码 API Key/密码（须配置在环境变量或配置文件中）。
|
||||
4. **README 必须为根目录文件**（嵌套 README 不满足要求）。
|
||||
5. **信息安全**：顾客数据、公司内部数据不得上传至外部公开仓库，不得用于 AI 训练或上传至外部服务。
|
||||
6. **编程语言不限**：任何能实现选题的技术栈均可。
|
||||
|
||||
## 7. 源码可运行前提（强制）
|
||||
|
||||
**源码无法按 README 启动运行的，后续所有评分项扣分**——这是基础前提项，不满足则整体扣分。
|
||||
|
||||
- 依赖须随仓库可复现（含依赖清单/锁文件），不依赖外部不可达资源。
|
||||
- 若为 Web 类作品，请登记**服务地址（service_url）**，格式 `http://<域名或公网IP>:<端口>`。
|
||||
- 服务地址用于评审期"系统验证（B 阶段）"：浏览器访问 + 黑盒冒烟，验证核心功能可达性。
|
||||
- 服务无法访问（环境问题）不影响静态评分，但"声称的核心功能"将无法实测验证。
|
||||
|
||||
> **项目理解文档（评审必读）**：评审系统会读取仓库内文档与源码自动生成"项目理解文档"。因此代码与文档应真实反映实际实现，**文档声称的功能须能在代码/运行中找到对应实现**（存在"声称 vs 实测"交叉验证，不符将扣分）。
|
||||
|
||||
---
|
||||
|
||||
## 8. 成果物清单与放置规则
|
||||
|
||||
**构建步骤**：在已建好的 `2026Technology-Competition` 仓库 main 分支下，依次放入下列文件 → `git add .` → `git commit` → `git push origin main`。
|
||||
|
||||
成果物清单（按提交顺序）：
|
||||
|
||||
| # | 成果物 | 放置位置（命名） | 内容要求 |
|
||||
|---|---|---|---|
|
||||
| 01 | 项目说明 | 仓库根目录下的 `README.md` | 参赛作品的详细介绍，项目性质声明、项目概述、整体功能说明、效果总结、团队分工、规模与技术难度自我评估 |
|
||||
| 02 | 设计文档 | 仓库根目录下的 `DESIGN.md`，或 `docs/`、`design/` 目录内 | 场景与价值、开发范式流程图、**Agent 架构图（感知-规划-行动-记忆）**、架构说明、工具/API 清单 |
|
||||
| 03 | 源码 | 仓库根目录，或 `src/` 目录内 | **Agent + 交互界面 + 数据存储 + 工具调用**，可自主完成业务闭环；安装步骤、运行方法、环境要求、依赖清单写在 README.md |
|
||||
| 04 | 实验报告 | `tests/` 目录内，附 `coverage/` 覆盖率报告与测试执行日志 | **Agent 闭环成功率、工具调用、异常恢复**数据 + 完整测试用例清单及执行结果。**评审系统以"测试真实运行且有用例"为准**（不会只因 tests/ 目录存在而判定已提交） |
|
||||
| 05 | AI 使用日志 | 仓库根目录下的 `_AI_USAGE_LOG.md` | 覆盖需求/设计/编码/测试全环节，格式见 §5 |
|
||||
| 06 | 演示视频 | `docs/` 目录下的 `demo.mp4`，或仓库根目录的 `demo.mp4`；也可在根目录 README 或 `docs/*.md` 中附视频链接 | ≤15 分钟：完整成功流程 + Agent 闭环 + 工具调用 + 异常恢复 |
|
||||
|
||||
**仓库目录结构（赛道一）**
|
||||
|
||||
```
|
||||
2026Technology-Competition/ # 仓库根目录（main 分支）
|
||||
├── README.md # 01 项目说明
|
||||
├── DESIGN.md # 02 设计文档（含 Agent 架构图、范式图）
|
||||
├── src/ # 03 源码：Agent + 交互界面 + 数据存储 + 工具调用
|
||||
│ └── …（项目源码）
|
||||
├── tests/ # 04 实验报告
|
||||
│ ├── …（测试代码）
|
||||
│ └── coverage/ # 覆盖率报告
|
||||
├── _AI_USAGE_LOG.md # 05 AI 使用日志
|
||||
├── AGENTS.md # 评审必检：AI 协作方式与项目说明
|
||||
├── data/ # 评审必检：样本数据（也可用 sample/ 或 fixtures/）
|
||||
└── docs/
|
||||
└── demo.mp4 # 06 演示视频（≤15 分钟）
|
||||
```
|
||||
|
||||
> 放置规则：
|
||||
> - 成果物须位于仓库根目录或上表约定目录；评审系统不递归到任意深层目录。
|
||||
> - 文件名/目录名用 ASCII 小写字母、数字、连字符、下划线，禁止空格与中文。
|
||||
> - **评审系统另检测以下必填项**（缺失会降低"成果物齐全度"）：
|
||||
> - **AGENTS.md**（根目录）：AI 协作方式与项目说明，与 AI 使用日志配合溯源
|
||||
> - **样本数据**：`data/`、`sample/`、`fixtures/` 目录或随仓库提供的样例数据文件
|
||||
|
||||
## 9. 所需资源
|
||||
|
||||
| 资源 | 要求 |
|
||||
|---|---|
|
||||
| 开发环境 | 编程环境 + 终端（可运行 Agent 脚本、调用模型 API） |
|
||||
| AI 模型/API | Agent 运行时调用的模型 API（DeepSeek/Qwen 等，见 §5.2；免费方案：OpenCode + DeepSeek） |
|
||||
| 外部服务/账号 | Agent 用到的工具/API 账号（如有：数据库、第三方服务、代码平台 token） |
|
||||
| 运行/演示环境 | 可运行 Agent 的服务或本地环境（Web 类建议登记 service_url） |
|
||||
| 数据资源 | Agent 业务闭环所需样例数据、工具调用样例 |
|
||||
| 测试资源 | Agent 闭环测试、工具调用成功率测试 |
|
||||
|
||||
> AI 模型 API 组委会不提供 token，由各队自备（推荐完全免费的 OpenCode + DeepSeek 组合）；海外服务使用注意信息安全（见 §6）。
|
||||
|
||||
## 10. 提交前自查清单
|
||||
|
||||
- [ ] **已在 2026-08-31 前提交并 `git push` 到 main 分支**
|
||||
- [ ] 已用组委会账号登录 Gitea，密码未修改
|
||||
- [ ] 已在项目说明中声明**项目性质（新规/升级）**
|
||||
- [ ] 成果物齐全且按 §8 放置：README、DESIGN.md（含 Agent 架构图与范式图）、源码（Agent+界面+存储+工具调用）、tests/（测试真实运行）+ 覆盖率报告、`_AI_USAGE_LOG.md`、AGENTS.md、样本数据、演示视频
|
||||
- [ ] `_AI_USAGE_LOG.md` 字段完整，范式步骤与范式图一致
|
||||
- [ ] 文件名无空格/中文/特殊字符；无密钥/token/.env/构建产物
|
||||
- [ ] 源码可按 README 启动运行；已 `git push`，本地与远端一致
|
||||
|
||||
## 11. 违规后果
|
||||
|
||||
- **超过 8/31 截止时间未提交 / 未 push 到服务器** → 成果物无法被采集，按未提交处理（不得分）。
|
||||
- 仓库名、分支、凭据不符合本规范 → 评审系统**无法拉取**，按未提交处理（不得分）。
|
||||
- 必填成果物缺失或命名不符 → 对应成果物判定为未提交，相关维度扣分。
|
||||
- 文档/日志声称功能与实测不符 → 真实性考核扣分。
|
||||
- AI 使用日志缺失或空白 → 相关维度扣分。
|
||||
- 源码无法按 README 运行 → 后续所有评分项扣分。
|
||||
- 升级项目未提交「存量系统分析」与「改造前后对比」数据 → 对应维度扣分。
|
||||
@@ -1,7 +1,7 @@
|
||||
"""生成中文镜像模板（步骤 0）。
|
||||
|
||||
镜像既有日文概要设计书模板的结构与锚点 id（section:xxx 原样保留），
|
||||
仅将 H1/H2 标题与封面字段翻译为中文，产物 samples/概要设计书模板_中文.docx 入库。
|
||||
仅将 H1/H2 标题与封面字段翻译为中文，产物 sample/template_design_zh.docx 入库。
|
||||
|
||||
锚点段落文本保持不变是硬约束：Writer 子系统（template_mapper / docx_injector）
|
||||
依赖这些占位符定位章节，任何改动都会破坏映射与注入。
|
||||
@@ -69,8 +69,8 @@ def main() -> None:
|
||||
import argparse
|
||||
|
||||
parser = argparse.ArgumentParser(description="生成中文镜像模板")
|
||||
default_src = str(Path(__file__).resolve().parents[1] / "samples" / "概要設計書テンプレート.docx")
|
||||
default_dst = str(Path(__file__).resolve().parents[1] / "samples" / "概要设计书模板_中文.docx")
|
||||
default_src = str(Path(__file__).resolve().parents[1] / "sample" / "template_design_ja.docx")
|
||||
default_dst = str(Path(__file__).resolve().parents[1] / "sample" / "template_design_zh.docx")
|
||||
parser.add_argument("--src", default=default_src, help="源日文模板")
|
||||
parser.add_argument("--dst", default=default_dst, help="输出中文模板")
|
||||
args = parser.parse_args()
|
||||
|
||||
@@ -50,7 +50,7 @@ def _main() -> None:
|
||||
parser.add_argument("--template", required=True, help="概要设计模板 docx 路径")
|
||||
parser.add_argument("--output", required=True, help="输出 docx 路径")
|
||||
parser.add_argument("--fake", action="store_true", help="使用 FakeEngine（无 LLM）")
|
||||
parser.add_argument("--samples-dir", default="samples", help="RAG 样本目录")
|
||||
parser.add_argument("--samples-dir", default="sample", help="RAG 样本目录")
|
||||
args = parser.parse_args()
|
||||
|
||||
source = _build_source(args.template)
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
用法:
|
||||
python scripts/run_trial.py [--fake] [--output out.docx] ...
|
||||
|
||||
默认输入为 samples/ 下既有样本（追加改修·股票场景 + sunOnly 既有系统 + 真实概要设计书模板）。
|
||||
默认输入为 sample/ 下既有样本（追加改修·股票场景 + sunOnly 既有系统 + 真实概要设计书模板）。
|
||||
真实模式需先在 .env 配置 GENESIS_INFERENCE__API_KEY（见 README「运行说明」），
|
||||
缺失时抛 LLMNotConfiguredError 并给出配置提示；--fake 为离线确定性引擎，无需 key。
|
||||
|
||||
@@ -42,20 +42,20 @@ class FakeEngine:
|
||||
|
||||
def _parse_args(argv: list[str] | None) -> argparse.Namespace:
|
||||
p = argparse.ArgumentParser(description="概要设计书自动生成试运行")
|
||||
p.add_argument("--requirement", default=str(ROOT / "samples" / "要件定義_追加改修_股票.xlsx"),
|
||||
p.add_argument("--requirement", default=str(ROOT / "sample" / "requirements_enhancement_stock.xlsx"),
|
||||
help="要件定义 Excel（可多个，逗号分隔）")
|
||||
p.add_argument("--template", default=str(ROOT / "samples" / "概要設計書テンプレート.docx"),
|
||||
p.add_argument("--template", default=str(ROOT / "sample" / "template_design_ja.docx"),
|
||||
help="概要设计书 Word 模板")
|
||||
p.add_argument("--rules", nargs="*", default=[
|
||||
str(ROOT / "samples" / "概要設計做成説明書.docx"),
|
||||
str(ROOT / "samples" / "記入規則.docx"),
|
||||
str(ROOT / "sample" / "rules_design_ja.docx"),
|
||||
str(ROOT / "sample" / "rules_entry_ja.docx"),
|
||||
], help="写入规则/记入规则 docx（可多个）")
|
||||
p.add_argument("--existing-system", default=str(ROOT / "samples" / "existing-system"),
|
||||
p.add_argument("--existing-system", default=str(ROOT / "sample" / "existing-system"),
|
||||
help="既有系统源码目录（追加/改修场景）")
|
||||
p.add_argument("--language", default="java", help="既有系统开发语言（默认 java，None=自动探测）")
|
||||
p.add_argument("--output-language", default="auto",
|
||||
choices=["auto", "zh", "ja"], help="输出语言：auto=与标题一致，zh=简体中文，ja=日文")
|
||||
p.add_argument("--samples-dir", default=str(ROOT / "samples"), help="样本资产根目录")
|
||||
p.add_argument("--samples-dir", default=str(ROOT / "sample"), help="样本资产根目录")
|
||||
p.add_argument("--output", default=str(ROOT / "output" / "output.docx"), help="概要设计书输出路径")
|
||||
p.add_argument("--impact-report", default=str(ROOT / "output" / "impact-report.json"),
|
||||
help="影响调查书 JSON 输出路径")
|
||||
|
||||
@@ -47,7 +47,7 @@ class QALoop:
|
||||
doc.save(output_path)
|
||||
return [contents_map[cid] for cid in order]
|
||||
|
||||
def run(self, structured_source, output_path, session_id="writer", samples_dir="samples", engine=None, prompt_registry=None, template_path=None, output_language: str = "auto") -> QAReport:
|
||||
def run(self, structured_source, output_path, session_id="writer", samples_dir="sample", engine=None, prompt_registry=None, template_path=None, output_language: str = "auto") -> QAReport:
|
||||
engine = engine or build_inference_engine()
|
||||
prompt_registry = prompt_registry or PromptRegistry()
|
||||
validator = QAValidator()
|
||||
|
||||
@@ -12,14 +12,14 @@ class RagService(Protocol):
|
||||
|
||||
|
||||
class CannedRagService:
|
||||
"""从 samples/ 读入记入规则文档（Markdown），整体作为规则文本返回。"""
|
||||
"""从 sample/ 读入记入规则文档（Markdown），整体作为规则文本返回。"""
|
||||
|
||||
def __init__(self, samples_dir: str = "samples") -> None:
|
||||
def __init__(self, samples_dir: str = "sample") -> None:
|
||||
self._samples_dir = Path(samples_dir)
|
||||
|
||||
def _load_rules_text(self) -> list[str]:
|
||||
texts: list[str] = []
|
||||
for name in ("記入規則.docx", "概要設計做成説明書.docx"):
|
||||
for name in ("rules_entry_ja.docx", "rules_design_ja.docx"):
|
||||
p = self._samples_dir / name
|
||||
if not p.exists():
|
||||
continue
|
||||
|
||||
@@ -9,7 +9,7 @@ from genesis.writer.template_mapper import map_template
|
||||
|
||||
def build_contexts(
|
||||
structured_source: StructuredSource,
|
||||
samples_dir: str = "samples",
|
||||
samples_dir: str = "sample",
|
||||
output_language: str = "auto",
|
||||
) -> list[GenerationContext]:
|
||||
specs: list[ChapterSpec] = map_template(structured_source.template)
|
||||
|
||||
@@ -51,7 +51,7 @@ class WriteOrchestrator:
|
||||
structured_source: StructuredSource,
|
||||
output_path: str,
|
||||
session_id: str = "writer",
|
||||
samples_dir: str = "samples",
|
||||
samples_dir: str = "sample",
|
||||
engine=None,
|
||||
prompt_registry=None,
|
||||
template_path: str | None = None,
|
||||
|
||||
@@ -115,7 +115,7 @@ def test_parse_missing_root_raises(tmp_path):
|
||||
|
||||
|
||||
def test_parse_real_sample_has_order_controller():
|
||||
root = Path(__file__).resolve().parents[1] / "samples" / "existing-system"
|
||||
root = Path(__file__).resolve().parents[1] / "sample" / "existing-system"
|
||||
if not root.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = CodeParser().parse(root)
|
||||
@@ -125,7 +125,7 @@ def test_parse_real_sample_has_order_controller():
|
||||
|
||||
|
||||
def test_parse_real_sample_has_entities_and_endpoints():
|
||||
root = Path(__file__).resolve().parents[1] / "samples" / "existing-system"
|
||||
root = Path(__file__).resolve().parents[1] / "sample" / "existing-system"
|
||||
if not root.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = CodeParser().parse(root)
|
||||
|
||||
@@ -58,8 +58,8 @@ def test_structured_source_assembles_all():
|
||||
tables=[],
|
||||
template=ParsedTemplate(file_name="t.docx", sections=[], placeholders={}, styles={}),
|
||||
rule_docs=[RuleDocument(
|
||||
file_name="記入規則.docx", category="write", markdown_content="# 規則",
|
||||
source_path="samples/記入規則.docx", file_type="word", hash="abc",
|
||||
file_name="rules_entry_ja.docx", category="write", markdown_content="# 規則",
|
||||
source_path="sample/rules_entry_ja.docx", file_type="word", hash="abc",
|
||||
)],
|
||||
image_analyses=[ImageAnalysis(
|
||||
image_ref="img1", description="画面遷移図", confidence=0.9,
|
||||
|
||||
@@ -161,7 +161,7 @@ def test_golden_set_load(tmp_path):
|
||||
yaml_text = """
|
||||
cases:
|
||||
- id: g1
|
||||
input_ref: samples/要件定義.xlsx
|
||||
input_ref: sample/要件定義.xlsx
|
||||
expected_min_score: 0.7
|
||||
note: 脱敏真实样本回归基线
|
||||
"""
|
||||
|
||||
@@ -38,7 +38,7 @@ def _existing() -> ExistingSystemInfo:
|
||||
EntityInfo("StrategyBacktest", "StrategyBacktest", "SB.java", "ts_strategy_backtest", [], "trade-strategy/SB.java"),
|
||||
],
|
||||
api_endpoints=[],
|
||||
source_path="samples/existing-system",
|
||||
source_path="sample/existing-system",
|
||||
)
|
||||
|
||||
|
||||
@@ -129,7 +129,7 @@ def test_metadata_and_summary_shape():
|
||||
report = ImpactAgent().run(_ss(_existing(), tables), session_id="sess-1")
|
||||
assert report.metadata["version"] == "v1"
|
||||
assert report.metadata["session_id"] == "sess-1"
|
||||
assert report.metadata["source"] == "samples/existing-system"
|
||||
assert report.metadata["source"] == "sample/existing-system"
|
||||
assert report.summary["total"] == 1
|
||||
assert report.summary["new"] == 1
|
||||
|
||||
|
||||
@@ -50,7 +50,7 @@ def test_writer_agent_zh_expected_rejects_japanese():
|
||||
|
||||
def test_qa_loop_passes_with_explicit_zh_on_chinese_fake(tmp_path):
|
||||
"""显式 zh + 中文 Fake → 语言维度通过（验证透传链路）。"""
|
||||
template = Path("samples/phase5-slice/template.docx")
|
||||
template = Path("sample/phase5-slice/template.docx")
|
||||
if not template.exists():
|
||||
import pytest
|
||||
pytest.skip("样本模板缺失")
|
||||
@@ -75,7 +75,7 @@ def test_qa_loop_passes_with_explicit_zh_on_chinese_fake(tmp_path):
|
||||
|
||||
def test_qa_loop_fails_with_explicit_ja_on_chinese_fake(tmp_path):
|
||||
"""显式 ja + 中文 Fake → 语言维度判失败。"""
|
||||
template = Path("samples/phase5-slice/template.docx")
|
||||
template = Path("sample/phase5-slice/template.docx")
|
||||
if not template.exists():
|
||||
import pytest
|
||||
pytest.skip("样本模板缺失")
|
||||
|
||||
@@ -39,7 +39,7 @@ class _FlakyEngine:
|
||||
|
||||
|
||||
def _ss() -> StructuredSource:
|
||||
template = Path("samples/phase5-slice/template.docx")
|
||||
template = Path("sample/phase5-slice/template.docx")
|
||||
if not template.exists():
|
||||
pytest.skip("样本模板缺失，跳过")
|
||||
parsed = WordTemplateParser().parse(str(template))
|
||||
@@ -54,7 +54,7 @@ def test_generate_recovers_stochastic_single_chapter_failure(tmp_path):
|
||||
# chapter_attempts=3，内部 max_retries=2 → 单章最多约 3×2 次调用
|
||||
contents = WriteOrchestrator().generate(
|
||||
_ss(), str(out), samples_dir="nonexistent_dir_xyz",
|
||||
engine=engine, template_path=str(Path("samples/phase5-slice/template.docx")),
|
||||
engine=engine, template_path=str(Path("sample/phase5-slice/template.docx")),
|
||||
)
|
||||
assert contents, "应成功产出章节"
|
||||
assert out.is_file()
|
||||
@@ -72,6 +72,6 @@ def test_generate_hard_fails_after_chapter_attempts_exhausted(tmp_path):
|
||||
with pytest.raises(WriterGenerationError):
|
||||
WriteOrchestrator().generate(
|
||||
_ss(), str(out), samples_dir="nonexistent_dir_xyz",
|
||||
engine=AlwaysFail(0), template_path=str(Path("samples/phase5-slice/template.docx")),
|
||||
engine=AlwaysFail(0), template_path=str(Path("sample/phase5-slice/template.docx")),
|
||||
chapter_attempts=1,
|
||||
)
|
||||
|
||||
@@ -36,7 +36,7 @@ def _all_text(doc: Document) -> str:
|
||||
|
||||
|
||||
def test_phase5_e2e_fake_llm(tmp_path):
|
||||
template = Path("samples/phase5-slice/template.docx")
|
||||
template = Path("sample/phase5-slice/template.docx")
|
||||
if not template.exists():
|
||||
pytest.skip("样本模板缺失，跳过 e2e")
|
||||
parsed = WordTemplateParser().parse(str(template))
|
||||
|
||||
@@ -3,7 +3,7 @@ from genesis.services.rag_service import RagService, CannedRagService
|
||||
|
||||
|
||||
def test_canned_rag_returns_rules():
|
||||
svc = CannedRagService(samples_dir="samples")
|
||||
svc = CannedRagService(samples_dir="sample")
|
||||
rules = svc.retrieve_write_rules("db_design")
|
||||
assert isinstance(rules, list)
|
||||
rules2 = svc.retrieve_design_rules("db_design")
|
||||
@@ -11,4 +11,4 @@ def test_canned_rag_returns_rules():
|
||||
|
||||
|
||||
def test_rag_service_is_protocol():
|
||||
assert isinstance(CannedRagService("samples"), RagService)
|
||||
assert isinstance(CannedRagService("sample"), RagService)
|
||||
|
||||
+12
-12
@@ -7,7 +7,7 @@ from genesis.parsers.rule_doc_parser import RuleDocParser
|
||||
from genesis.parsers.source_aggregator import SourceParser
|
||||
from genesis.parsers.word_template_parser import WordTemplateParser
|
||||
|
||||
SAMPLES = Path(__file__).resolve().parents[1] / "samples"
|
||||
SAMPLES = Path(__file__).resolve().parents[1] / "sample"
|
||||
|
||||
|
||||
def _d(name: str) -> Path:
|
||||
@@ -19,7 +19,7 @@ def _x(name: str) -> Path:
|
||||
|
||||
|
||||
def test_new_dev_sample_has_tables():
|
||||
p = _x("要件定義_新規開発.xlsx")
|
||||
p = _x("requirements_newdev.xlsx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = ExcelParser().parse(p)
|
||||
@@ -30,7 +30,7 @@ def test_new_dev_sample_has_tables():
|
||||
|
||||
|
||||
def test_additional_modification_has_tables():
|
||||
p = _x("要件定義_追加改修.xlsx")
|
||||
p = _x("requirements_enhancement.xlsx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = ExcelParser().parse(p)
|
||||
@@ -39,7 +39,7 @@ def test_additional_modification_has_tables():
|
||||
|
||||
|
||||
def test_free_text_sample_detected():
|
||||
p = _x("要件定義_自由記述.xlsx")
|
||||
p = _x("requirements_freetext.xlsx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = ExcelParser().parse(p)
|
||||
@@ -47,7 +47,7 @@ def test_free_text_sample_detected():
|
||||
|
||||
|
||||
def test_mixed_sample_segments_detected():
|
||||
p = _x("要件定義_混合型.xlsx")
|
||||
p = _x("requirements_mixed.xlsx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = ExcelParser().parse(p)
|
||||
@@ -68,7 +68,7 @@ def test_mixed_sample_segments_detected():
|
||||
|
||||
|
||||
def test_word_template_sample_chapters_and_placeholders():
|
||||
p = _d("概要設計書テンプレート.docx")
|
||||
p = _d("template_design_ja.docx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = WordTemplateParser().parse(p)
|
||||
@@ -85,7 +85,7 @@ def test_word_template_sample_chapters_and_placeholders():
|
||||
|
||||
|
||||
def test_rule_doc_sample_markdown_and_category():
|
||||
p = _d("記入規則.docx")
|
||||
p = _d("rules_entry_ja.docx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = RuleDocParser().parse(p, category="write")
|
||||
@@ -96,7 +96,7 @@ def test_rule_doc_sample_markdown_and_category():
|
||||
|
||||
|
||||
def test_write_instruction_sample_category_write():
|
||||
p = _d("概要設計做成説明書.docx")
|
||||
p = _d("rules_design_ja.docx")
|
||||
if not p.exists():
|
||||
pytest.skip("样本缺失")
|
||||
result = RuleDocParser().parse(p, category="write")
|
||||
@@ -105,10 +105,10 @@ def test_write_instruction_sample_category_write():
|
||||
|
||||
|
||||
def test_source_parser_full_sample_assembly():
|
||||
xlsx = _x("要件定義_新規開発.xlsx")
|
||||
template = _d("概要設計書テンプレート.docx")
|
||||
rule = _d("記入規則.docx")
|
||||
instr = _d("概要設計做成説明書.docx")
|
||||
xlsx = _x("requirements_newdev.xlsx")
|
||||
template = _d("template_design_ja.docx")
|
||||
rule = _d("rules_entry_ja.docx")
|
||||
instr = _d("rules_design_ja.docx")
|
||||
if not all(p.exists() for p in [xlsx, template, rule, instr]):
|
||||
pytest.skip("样本缺失")
|
||||
result = SourceParser().parse(
|
||||
|
||||
@@ -14,9 +14,9 @@ from docx import Document
|
||||
from genesis.parsers.word_template_parser import WordTemplateParser
|
||||
from genesis.writer.template_mapper import map_template
|
||||
|
||||
_SAMPLES = Path(r"D:\00_project\Genesis\samples")
|
||||
_JA = _SAMPLES / "概要設計書テンプレート.docx"
|
||||
_ZH = _SAMPLES / "概要设计书模板_中文.docx"
|
||||
_SAMPLES = Path(__file__).resolve().parents[1] / "sample"
|
||||
_JA = _SAMPLES / "template_design_ja.docx"
|
||||
_ZH = _SAMPLES / "template_design_zh.docx"
|
||||
|
||||
|
||||
EXPECTED_ANCHORS = [
|
||||
@@ -27,9 +27,9 @@ EXPECTED_ANCHORS = [
|
||||
|
||||
@pytest.fixture
|
||||
def zh_template(tmp_path):
|
||||
"""生成 zh 模板到临时目录并返回路径（不污染 samples/）。"""
|
||||
"""生成 zh 模板到临时目录并返回路径（不污染 sample/）。"""
|
||||
from scripts.make_zh_template import build_zh_template
|
||||
dst = tmp_path / "概要设计书模板_中文.docx"
|
||||
dst = tmp_path / "template_design_zh.docx"
|
||||
build_zh_template(str(_JA), str(dst))
|
||||
return dst
|
||||
|
||||
|
||||
Reference in New Issue
Block a user