自动化测试缺口每日汇总

[HeDaas-Code]

此 Issue 用于汇总每日自动化测试缺口分析结果。每天运行时会在下方追加评论，记录当日发现的覆盖率缺口及补充的测试。

---

首次创建于 2026-07-09

[HeDaas-Code]

📋 自动化测试缺口分析报告 — 2026-07-09

分析范围

• 仓库：HeDaas-Code/Neural-Engine (main 分支)
• 近 14 天内合并/提交的代码变更
• 覆盖率基准：全量 --cov 报告

---

覆盖率变化

模块	变更前	变更后	提升
core/engine/protocol.py	92%	99%	+7%
core/engine/executor.py	96%	98%	+2%
runtime/save.py	97%	100%	+3%

---

识别的覆盖率缺口与补充测试

1. protocol.py — v2 存档/读档协议验证缺口 (高优先级)

风险行为： SaveCmd/LoadCmd/SaveAckEvt/LoadAckEvt 的 from_dict 反序列化缺少类型校验测试。若协议字段类型错误（如 ok 传字符串而非 bool）未被捕获，会导致 GUI 端收到畸形数据后崩溃。

补充测试（22 个）：

• TestCheckDict: _check_dict 非 dict 输入 → ValueError
• TestSaveCmdRoundTrip: SaveCmd to_dict/from_dict round-trip + 缺字段/类型错
• TestLoadCmdRoundTrip: LoadCmd to_dict/from_dict round-trip + 缺字段/类型错
• TestTextEvtStyleValidation: TextEvt.style 非 str → ValueError
• TestDecoratorEvtKind: kind='stop' 序列化含 kind 字段 + kind 非 str 校验 + round-trip
• TestSaveAckEvtValidation: ok 非 bool / error 非 str → ValueError
• TestLoadAckEvtValidation: ok 非 bool / error 非 str → ValueError
• TestParseEvtValidation: event 字段非 str → ValueError

2. executor.py — GameState 序列化 + 存档命令处理缺口 (高优先级)

风险行为： GameState.from_dict 缺少版本兼容性校验测试（version>1 应拒绝），防御性拷贝未验证。In 节点在无输入时抛 NotImplementedError 路径未覆盖。无 save_manager 时 LoadCmd 处理路径未覆盖。

补充测试（15 个）：

• TestGameStateFromDictEdgeCases: 非 dict 输入 / version>1 / 缺字段默认值 / 无 version 兼容 / to_dict 防御性拷贝 / from_dict 防御性拷贝
• TestFindBlockByIdError: NextId 指向不存在块 → ValueError
• TestInNodeUnknownCmdBreak: 未知 cmd 类型（ShutdownCmd）→ break 循环
• TestInNodeNoneCmdRaises: get_cmd() 返回 None → NotImplementedError
• TestHandleLoadCmdNoSaveManager: 无 save_manager + LoadCmd → LoadAckEvt(ok=False)
• TestBusSaveLoadRoundTrip: SaveCmd/LoadCmd/SaveAckEvt/LoadAckEvt 通过 EngineBus round-trip

3. save.py — slot 类型校验缺口 (中优先级)

风险行为： _validate_slot 接收非 str 类型（int/None/list）时未覆盖。若调用方传入非 str slot，可能导致路径拼接异常。

补充测试（5 个）：

• TestValidateSlotTypeValidation: int/None/list slot → ValueError（save/load/delete 各路径）

---

新增/修改的测试文件

文件	新增测试数	覆盖模块
tests/core/test_protocol_gaps.py	22	protocol.py
tests/core/test_executor_gaps.py	15	executor.py + bus.py
tests/runtime/test_save_gaps.py	5	save.py

---

测试运行结果

509 passed in 12.33s (原有 467 + 新增 42)

所有新增测试均确定性通过，无不稳定行为。

---

为何这些测试能实质性降低回归风险

1. 协议层防御加固：SaveCmd/LoadCmd/SaveAckEvt/LoadAckEvt 是 GUI↔Engine 通信的关键路径。类型校验测试确保畸形消息不会穿透到业务层，避免运行时 TypeError/AttributeError 导致进程崩溃。

2. 存档系统健壮性：GameState.from_dict 的版本校验和防御性拷贝测试防止：a) 未来版本升级导致老存档加载崩溃；b) 外部修改反序列化结果意外污染引擎内部状态。

3. In 节点边界行为锁定：NotImplementedError 和未知 cmd 类型 break 路径的覆盖，确保阻塞式输入和异常命令不会导致引擎静默挂起或数据损坏。

4. EngineBus 完整性：新增的 SaveCmd/LoadCmd/SaveAckEvt/LoadAckEvt 通过 bus 的 round-trip 测试，验证进程间通信序列化/反序列化链路完整，防止 JSON 编码问题在真实多进程环境下才暴露。

---

剩余未覆盖行（低风险，暂不补充）

• executor.py L181: _find_block_by_id 运行时 ValueError（构造时 _validate_target_ids 已提前拦截）
• executor.py L292: NotImplementedError（未实现节点类型，触发需构造非法 AST 节点）
• executor.py L350-351: var 匹配 TypeError 路径（需 state.vars 含 None 值的特定 if 配置）
• protocol.py L36: _require_str_list 缺字段路径（已被 DecoratorEvt args 校验间接覆盖）

[HeDaas-Code]

📋 自动化测试缺口分析报告 — 2026-07-10

分析范围

本次运行覆盖 4 个监控仓库，判定窗口为「自上次测试缺口分析（2026-07-09）以来的变动」。上次分析（见上一条评论）仅覆盖 Neural-Engine，其余 3 个仓库为首次纳入测试缺口分析。

仓库	最近 push	本次是否有变动	处理
Neural-Engine	2026-07-01	否（已于 2026-07-09 分析，无新增提交）	无新增缺口
persona-distillation	2026-07-08	是（首次分析：972d563 修复 16 issue + 7deb615 oc-cocreate/webui）	✅ 补充测试
Mortis	2026-07-01	否（无新提交）	无新增缺口
create_web_board	2026-07-09	仅有开放 PR #12（纯 UI 主题重设计，CSS+HTML）	⏭️ 按规则跳过（纯外观变更）

判定依据：create_web_board PR #12 feat(ui): redesign frontend with industrial steampunk theme 仅改动 style.css(+163/-156) 与 trains.html(+60/-56)，无 JS/Java 逻辑变更，属「纯粹外观调整」，依准则跳过。

---

识别的覆盖率缺口与补充测试（persona-distillation）

commit 972d563（fix(issues): 修复 16 个 GitHub issue P1+P2+P3）修改 24 个生产文件（+2997/-544）未同步任何测试；后续 0ec5dd8 仅补 eval/pipeline/interview/oc_writer，核心 intake 逻辑仍零覆盖。本次补齐三处高优先级缺口（均为「新增逻辑路径、零测试覆盖」）：

1. chunker.py — chunk 去重逻辑（Issue #18.a，高优先级）

风险行为：dedup_chunks 在 NER 前去除重复 chunk 以节省 LLM 调用。三条路径中任一失效都会导致重复文本被多次识别（浪费成本）或近义文本被误删（丢语料）。_cosine_sim 边界处理不当（零向量/长度不匹配）会抛 ZeroDivisionError 或返回错误相似度。

补充测试（8 个）：

• _sha256_hex 确定性 + 空串
• _cosine_sim 边界：空向量/长度不匹配→0、相同→1、正交→0、零向量不崩
• dedup_chunks 精确匹配路径（None / HashEmbeddings）：去重保序、保留首次
• dedup_chunks 真嵌入路径：cosine≥threshold 去重 + 阈值边界
• dedup_chunks embedder 抛错降级到精确匹配

2. entity_resolver.py — 跨 chunk 实体归并（Issue #17，新文件，高优先级）

风险行为：三重信号（别名/字符串/嵌入）融合判定同一人物。底层 levenshtein/jaro/jaro_winkler 算法实现错误会直接导致错误合并（人格混淆）或遗漏合并（同一人物分裂成多份，污染蒸馏语料）。resolve_entities 的 ≥2 合并 / 1 待确认 / 0 跳过决策与无嵌入降级策略是数据完整性的关键。

补充测试（13 个）：

• levenshtein/jaro/jaro_winkler/strings_similar 纯算法（含经典 MARTHA/MARHTA=0.9444/0.961 向量、空值守卫、中文 2 字删除）
• _cosine 边界 + CharacterSignals.hit_count + ResolveResult.total_actions
• resolve_entities 集成：别名+字符串 2 重自动合并 / 单重待确认 / 0 重跳过 / auto_merge=False / 嵌入信号隔离（受控伪嵌入）/ target 选择（mention 多者胜）

3. index_store.py — 检索退化 + 归并原子操作（Issue #12 / #17，高优先级）

风险行为：search 在 HashEmbeddings/Chroma 不可用时必须退化到 SQLite LIKE，否则离线/单测场景返回空或随机向量结果，掩盖真实检索缺陷。merge_characters 是实体归并底层原子操作，边界与别名传播错误会破坏索引数据完整性。

补充测试（7 个）：

• search LIKE 退化：关键词命中 / character_name 过滤 / k 上限 / 无匹配返回空
• merge_characters：source==target→0 / 不存在→0 / 迁移计数 + 源名作为别名传播 + 原别名保留

---

新增/修改的测试文件

文件	新增测试数	覆盖模块	PR
tests/test_chunker_gaps.py	8	chunker.dedup_chunks / _cosine_sim / _sha256_hex	#20
tests/test_entity_resolver_gaps.py	13	entity_resolver（字符串相似度 + resolve_entities）	#20
tests/test_index_store_gaps.py	7	index_store.search 退化 + merge_characters	#20

命名沿用 Neural-Engine 既定的 _gaps 后缀约定；测试风格沿用 tests/smoke_test.py/test_chunk_cache.py 的 pytest test_* + tempfile 隔离模式。

---

测试运行结果

pytest: 78 passed（原有 50 + 新增 28）
smoke_test: 11/11 PASSED
新测试 3 次重跑：28 passed ×3（确定性，无不稳定行为）

所有新增测试均确定性通过，无不稳定性，未排除任何测试。

---

为何这些测试能实质性降低回归风险

1. 实体归并正确性锁定：levenshtein/jaro/jaro_winkler 是归并判定的数学基础。用经典向量（MARTHA/MARHTA）+ 中文场景锁定实现，防止未来重构（如换 C 扩展或换阈值默认值）时悄悄改变归并边界，直接避免人格语料被错误合并/分裂。

2. 去重降级链路契约化：dedup_chunks 三条路径（精确匹配 / 真嵌入阈值 / embedder 失败降级）被分别覆盖，锁定了「HashEmbeddings 必须走精确匹配」「失败必降级不崩溃」的契约，防止重复 chunk 浪费 LLM 调用或近义 chunk 被误删。

3. 离线检索可用性兜底：search 的 LIKE 退化是离线/单测/Chroma 不可用场景的兜底路径。覆盖关键词命中、人物过滤、k 上限、无匹配四个分支，确保退化路径失效时能被立即发现（而非静默返回空）。

4. 归并原子操作数据完整性：merge_characters 的边界（source==target / 不存在）与别名传播（源名写入 target、原别名保留）被覆盖，防止实体归并时丢失身份信息或产生孤立脏数据。

---

其他仓库结论

• Neural-Engine：无新提交，2026-07-09 已分析（42 测试已落地），本次无新增缺口。
• Mortis：最近提交 2026-07-01（对话写入 Session 管道 / provider tools 透传），无新变动；本次窗口内无缺口需补充。
• create_web_board：唯一活动为开放 PR #12（纯 CSS+HTML 主题重设计），按「纯粹外观调整」准则跳过；待 PR 合并后若引入逻辑变更再评估。

---

本摘要由自动化测试缺口分析任务生成，数据截止 2026-07-10（Asia/Shanghai）。测试已提交至 persona-distillation PR #20。