简介

设计图谱知识库（Design Atlas Knowledge Runtime）是一个只读的设计知识服务： 内容系统（Design-Atlas）持续创作、审校并发布设计知识，经版本化发布管线导出为知识包， 由 Runtime 摄取并提供查询，供任意其他系统（产品、Agent、图谱应用）调用。

架构

flowchart LR
    A["内容系统 Design-Atlas<br/>人+AI 创作/审校/发布"] -->|kb:publish| B["版本化知识包<br/>releases/design-kb-vX.Y.Z.json"]
    B --> C["知识库 Runtime<br/>@halfway/atlas-runtime"]
    C --> D["REST API"]
    C --> E["MCP Server"]
    C --> F["TypeScript SDK"]
    D & E & F --> G["你的产品 / Agent / 其他系统"]

• 共享契约 @halfway/atlas-core：类型、校验、查询契约、套餐模型，三方共用
• 发布：npm run kb:export / kb:publish，原子落盘 + 热更新
• 服务：Runtime（查询）+ MCP（Agent 接入）+ SDK（代码调用）

服务地址（示例）

服务	开发	生产（示例）
REST API	http://localhost:4150	https://atlas.halfwaylab.cn
MCP	http://localhost:4180/mcp	https://atlas-mcp.halfwaylab.cn/mcp
健康检查	GET /api/atlas/v1/ready（公开）	同左