系统架构
本页面呈现知识库的完整系统架构,帮助贡献者与维护者快速理解各模块的职责边界与数据流向。
整体数据流
模块职责
| 模块 | 文件 | 职责 |
|---|---|---|
| 数据模型 | schema.py | Category, AlgorithmEntry, Reference 数据类定义 |
| 注册表 | algorithm_registry.py | 加载、索引、全文搜索 |
| 分类管理 | category_manager.py | 分类层级查询、category_exists() 验证 |
| 验证器 | validate.py | 字段规则 + JSON Schema 双重验证 |
| 文档生成器 | generate_docs.py | 双语 VitePress 页面生成 |
| CLI | __main__.py | 命令分发入口 |
设计原则:所有展示层(文档、README)均从数据层自动生成,禁止手工编辑生成文件。