资源模型

理解资源模型，能够帮助你更快理解 API 路径设计、权限边界和数据归属关系。

核心资源

• spaces：知识和协作的容器
• documents：实际内容单元
• organizations：企业级组织治理单元
• versions：文档历史版本
• shares：分享与访问控制

路径设计原则

AI Wiki 优先使用复数资源名，并通过嵌套资源表达归属关系，例如 /spaces/:spaceId/documents。

分页与删除约定

分页统一返回 { items, total, page, pageSize, totalPages }。删除通常使用软删除模型，因此你在查询和恢复逻辑里都需要考虑 deletedAt。