Module 技术设计
# Module 技术设计
修订记录
| 版本 | 日期 | 修订说明 |
|---|---|---|
| v0.1 | 2026-05-01 | 建立当前设计基线；延续 kunora-wiki 作为 llm-wiki 方案的既有产品封板和工程设计，不推倒重来。 |
本目录维护 kunora-wiki 自研模块的模块级技术设计。
模块级设计必须遵守 common 技术设计 中定义的公共契约、数据结构、路径规则、错误模型和测试约束。
自研模块目录
| 层级 | 模块 | 文档 | 状态 |
|---|---|---|---|
| L0 Common Foundation | ConfigManager | config-manager/README.md | 已创建 |
| L0 Common Foundation | WorkspaceStore | workspace-store/README.md | 已创建 |
| L1 Governance | SyncEngine | sync-engine/README.md | 已创建 |
| L1 Governance | ReviewBridge | review-bridge/README.md | 已创建 |
| L2 Publish/Index | DisplayBackend Adapter | display-backend-adapter/README.md | 已创建 |
| L2 Publish/Index | Index Adapter | index-adapter/README.md | 已创建 |
| L3 Access | Answer API | answer-api/README.md | 已创建 |
| L3 Access | Agent Access API | agent-access-api/README.md | 已创建 |
| L4 Iteration | AgentBridge | agent-bridge/README.md | 已创建 |
模块设计要求
每个模块设计至少应包含：
- 模块职责与非职责。
- 上游输入和下游输出。
- 依赖的 common 契约和数据结构。
- 对外接口或命令入口。
- 状态读写范围。
- 错误处理和幂等策略。
- 测试夹具和验收用例。
推荐设计顺序
- L0：先稳定 ConfigManager 与 WorkspaceStore。
- L1：再稳定 SyncEngine 与 ReviewBridge。
- L2：补展示发布和索引 adapter。
- L3：补 Answer API 与 Agent Access API。
- L4：最后补 AgentBridge，因为它依赖前面所有读写、review、access 和索引契约。