Akne Knowledge Manager

| | 2026-06-27 | 2.0.0 | 重构：提炼思想/原理/IO Contract/流程/方法/规则。具体命令、案例移至 references/ | | 2026-06-13 | 1.0.0 | 初始版本：内容级审计（矛盾、版本簇、研究空白、假设） |

契约层 · BOUNDARY

边界：技能功能边界。

契约层 · IO_CONTRACT

输入：请求描述、上下文信息。 输出：执行结果、状态反馈。

验证清单 · VERIFICATION

• 输出中的事实性陈述已逐条核查，无编造数据（准确为先）
• 每个结论可追溯到具体证据或数据源（证据驱动），无孤证断言
• 操作步骤可重复执行且结果可验证（可复现性）
• 多重原则冲突时按"准确 > 证据 > 可复现"优先级裁决，裁决过程留有记录
• 改进/变更已通过 Golden 集合（Input/Output/Error）测试验证
• 每项验证可执行、可记录、可复现，验证失败时已记录原因及修复方案
• 边界情况（空输入/极大值/异常）有明确错误信息和恢复指引

核心原则 · PRINCIPLES

1. 准确为先: 所有输出必须经过事实核查，不编造数据
2. 证据驱动: 每个结论必须可追溯到具体证据或数据源
3. 可复现性: 每一步操作必须可重复，结果可验证

Golden 集合 · GOLDEN SET

• Golden Input: BPPV 知识库源文件集（含 BPPV拟真参数设置.md 等），用于内容级审计——提取各文件物理参数声明并交叉比对（正常路径，AKNE-002）。
• Golden Output: 审计结论中每条矛盾标注 文件路径 + 声明原文 + 正确值来源（如"耳石半径 0.5~15nm"与碳酸钙晶体实际 5-30 μm 相差 1000 倍），可复算、可复现（准确为先，AKNE-001/003）。
• Golden Error: 对空实体名或未知实体执行 qe.resolve_entity() 查询 → 预期返回明确错误信息与恢复指引（建议的查询入口或参数修正），而非静默空结果（边界情况，AKNE-007）。

Golden 集合是测试的单一真理来源。所有改进必须通过 golden 测试。

违反任何原则的输出视为失败。原则优先级：准确 > 证据 > 可复现。

每项验证必须可执行、可记录、可复现。验证失败时记录原因和修复。

Akne Knowledge Manager---

Genes (策略基因)

紧凑策略表示。条件→策略。需要深度时参考完整文档。

• [AKNE-001] 输出包含事实性陈述 → 必须经过事实核查，严禁编造数据
• [AKNE-002] 得出任何结论 → 必须确保其可追溯到具体的证据或数据源
• [AKNE-003] 执行操作步骤 → 必须保证过程可重复且结果可验证
• [AKNE-004] 面对多重原则冲突 → 严格遵循“准确 > 证据 > 可复现”的优先级顺序
• [AKNE-005] 进行系统改进或变更 → 必须通过 Golden 集合（输入/输出/错误）的测试验证
• [AKNE-006] 执行验证流程 → 确保每项验证可执行、可记录、可复现，失败时记录原因及修复方案
• [AKNE-007] 处理边界情况（空输入/极大值/异常） → 必须包含明确的错误信息和恢复指引

示例 · EXAMPLES

1. 内容级审计：发现单位矛盾（证据驱动，AKNE-002；方法见 references/content-audit-aug2026.md）→ 输入 BPPV 知识库源文件；提取各文件物理参数声明并交叉比对，发现 BPPV拟真参数设置.md 声明"耳石半径 0.5~15nm 平均7.5nm"，与碳酸钙晶体实际直径 5-30 μm 相差 1000 倍（致命级矛盾）→ 验证：每条矛盾标注文件路径 + 声明原文 + 正确值来源（准确为先，AKNE-001），审计结论可复算、可复现（AKNE-003）。
2. 改进走 Golden 验证（AKNE-005）→ 输入对 KnowledgeGraph 查询逻辑的修改；按 Golden 集合依次回放 Golden Input（正常路径）/Golden Output（格式校验）/Golden Error（失败路径）→ 验证：全部 Golden 测试通过；若冲突按"准确 > 证据 > 可复现"优先级裁决（AKNE-004）并留存裁决记录。
3. 边界情况处理（AKNE-007）→ 输入空实体名或未知实体的 QueryEngine 查询（路径/导入模式见 references/api-reference.md，如 qe.resolve_entity()）→ 操作/输出：返回明确错误信息与恢复指引（建议的查询入口或参数修正），而非静默空结果 → 验证：错误信息含上下文与恢复指引，步骤可重复执行且结果一致（可复现性），无孤证断言。