Kunora Wiki Development 文档
# Kunora Wiki Development 文档
修订记录
| 版本 | 日期 | 修订说明 |
|---|---|---|
| v0.1 | 2026-05-01 | 建立当前设计基线；延续 kunora-wiki 作为 llm-wiki 方案的既有产品封板和工程设计，不推倒重来。 |
本目录用于维护 kunora-wiki 的工程实现设计。
产品文档 v1.0 已封板在 docs/product。development 文档只处理进入实现阶段后必须稳定下来的工程结构、公共契约、数据结构、模块边界、测试策略和部署运行约束。
范围原则
- 非自研模块的采购、配置、部署和常规使用属于产品层面的实施事项，默认不进入 development 设计。
- 非自研模块只有在发生二次开发、adapter 封装、协议转换，或自研代码依赖其错误、重试、幂等、回滚等行为时，才进入 development 设计。
- 自研模块必须先稳定公共契约和数据结构，再进入模块级实现设计。
- development 文档不改变产品封板决策；如发现产品级决策需要调整，应新增 ADR 或回到 product 文档做版本化变更。
文档分层
| 分层 | 文档 | 状态 | 说明 |
|---|---|---|---|
| Common | common | 首版已完成 | 公共边界、契约、数据结构、错误模型、路径/hash/id、fixture 与测试要求。 |
| Modules | modules | 首版已完成 | 9 个自研模块的模块级技术设计。 |
自研模块范围
| 层级 | 模块 |
|---|---|
| L0 Common Foundation | ConfigManager、WorkspaceStore |
| L1 Governance | SyncEngine、ReviewBridge |
| L2 Publish/Index | DisplayBackend Adapter、Index Adapter |
| L3 Access | Answer API、Agent Access API |
| L4 Iteration | AgentBridge |
当前状态
Development 技术设计首版已覆盖：
- 自研模块边界和依赖方向。
- 公共契约、数据结构、错误与状态模型。
- 路径、hash、ID、幂等和去重规则。
- 公共 fixture、contract test、golden test 要求。
- 9 个自研模块的职责、输入输出、接口语义、状态边界、错误处理、测试要求和待确认问题。
下一步
- 对 development 技术设计做整体 review，重点检查模块边界、契约一致性、开放问题和实现准入条件。
- 决定是否封板 development 技术设计首版。
- 封板后再进入实现计划、任务拆分和真实 fixture/schema/test scaffold。