# v1.5.0 Knowledge Pack 与本地 Reference Runtime

v1.5.0 的主线是把 AIOS 从“能写工程文档”推进到“能治理工程知识”。核心交付不是新增一批松散 Prompt，而是引入 AIOS 原生知识资产：`Knowledge Pack`。

## 版本定位

Knowledge Pack 是可编译、可查询、可评估的工程知识资产。它把规范摘录、企业标准、项目资料、历史审查口径和人工复核记录治理为一个统一对象，再交给 Skill、RAG / GraphRAG 流程和 Capability Runtime 使用。

本版本同时提供本地 Reference Runtime：`knowledge.norm_lookup` 可以查询编译后的 Knowledge Pack，返回 `status`、`citations`、`applicability`、`sourceVersion` 和 `notes`，并按 Capability 仲裁规则决定是否 `proceed`、`hold` 或升级人工复核。

## Knowledge Pack 文件链

```text
knowledge-pack.source.json
source-register.md
standard-register.md
clause-map.md
entity-relation-map.md
eval-questions.md
review-notes.md
        |
        v
compiled/knowledge-pack.json
        |
        v
knowledge:lookup / knowledge:eval / knowledge.norm_lookup
```

`knowledge-pack.source.json` 是结构化源，Markdown 文件用于业务人员阅读、复核和交接。编译产物 `compiled/knowledge-pack.json` 是 Runtime 消费对象。

## CLI

```bash
archsight-aios knowledge:init --sample --name scheme-review
archsight-aios knowledge:validate --name scheme-review
archsight-aios knowledge:compile --name scheme-review
archsight-aios knowledge:inspect --name scheme-review
archsight-aios knowledge:lookup --pack scheme-review/compiled/knowledge-pack.json --query "高支模方案是否应检查计算书"
archsight-aios knowledge:eval --name scheme-review
```

发布验证入口：

```bash
npm run validate:knowledge-pack
```

该命令会验证样板工作台、编译 Knowledge Pack、检查 inspect 摘要、执行 lookup、跑 eval gate，并通过 `capability:call` 验证本地 `knowledge.norm_lookup` MCP Reference Runtime。

## Reference Runtime 结果契约

```json
{
  "status": "found",
  "citations": [
    {
      "sourceId": "SRC-SYN-SCHEME",
      "standardId": "STD-SYN-SCHEME",
      "sourceVersion": "SYN-2026.01",
      "clauseId": "CLAUSE-HIGH-FORMWORK",
      "clauseNo": "S-2.1",
      "title": "高支模方案计算书要求",
      "pageRange": "p.7",
      "reviewStatus": "reviewed"
    }
  ],
  "applicability": "applicable",
  "sourceVersion": "SYN-2026.01",
  "notes": "命中高支模计算书口径；缺计算书时不得判断方案通过。"
}
```

`status` 支持：

- `found`：命中 Knowledge Pack。
- `not_found`：未命中，不得用模型常识补成规范结论。
- `conflict`：命中冲突口径，应阻断自动结论。
- `inapplicable`：版本、地区、专业或条件不适用。
- `error`：Runtime 或数据错误。

`applicability` 支持：

- `applicable`
- `not_applicable`
- `need_context`

## 与 Skill 的关系

- `aios-knowledge`：生产和维护 Knowledge Pack。
- `aios-runtime`：设计 Knowledge Pack 进入 RAG / GraphRAG / Tool Calling 的方式。
- `aios-review`：审查引用、版本、越权结论和 eval gate。
- `aios-scheme-audit`：在专项施工方案复核中优先使用 Knowledge Pack 和 `knowledge.norm_lookup` 证据；缺工具证据时标注 `需核验`。已使用 `aios-construction-scheme` 的团队可继续使用原领域型入口。

## 边界

- v1.5.0 不提供生产级法规 / 规范数据库。
- v1.5.0 不承诺自动合规判定。
- 未授权规范全文不得进入仓库。
- 合成样板只验证知识治理结构和 Runtime 契约，不代表真实规范条文。
- `published` 只表示包内资料通过本项目复核，不替代法务、总工、专家、审图或注册人员签审。