MindOS API 使用路线
这页专门用来把『什么能通过 API 给前台 / 合作方，什么必须继续留在服务端』讲清楚。后面你继续发算分、报告、提示词文档时，我们就按这条路线继续接。
当前判断
MindOS 智测后面会继续沿着『私有算法只留服务端，前台和合作方只拿脱敏结果』这条链推进。当前先把题目层走通，算分、报告、Prompt 等你后续文档发来后再继续接。
最后一轮 API 收口顺序
这条路线页继续讲 API 分层，但真正上线前还是先按下面这条顺序收。
- 1先回个人测评真实写库和报告 / API 验收，确认共同底座稳定。
- 2再回 Org-OS reserve API，确认组织测评当前 reserve 结构和 handoff 已稳定。
- 3最后再回开放平台 questions → submit → report 三步联调与交付页。
服务端私有源
仅工程内部服务端使用 · 无直接公开路径
暴露规则
保留原始题库、score、dimension_weights、B 模块修正规则、报告模板。
这一层不直接暴露到前台。
这一层也不直接作为开放平台返回结果。
内部脱敏题目 API
前台页面 / 内部联调 · /api/assessment/questions
暴露规则
只返回标准题目结构、题干、选项、模块、功能组，不返回内部算法字段。
这是当前最适合继续推进正式替换的入口。
后面替 questions.ts 时，会优先沿着这条 API 式路径继续前进。
开放平台题目 API
第三方合作伙伴 · /api/open/questions
暴露规则
继续保持脱敏输出，并叠加 API Key、日志、限流、开放平台协议。
这一层更偏对外合作接入。
它不应该直接透出内部算分与修正规则。
Org-OS reserve API
组织诊断前台 / admin 联调 · /api/org-os
暴露规则
当前只开放 1 分钟体检、团队邀请、仪表盘、报告、咨询等 reserve 结构，以及轻量 Lead_ID / risk state 回包。
这层先服务 1–6 周里的组织测评与 API 平台，不提前承诺正式聚合写库。
后面正式 Aggregation Engine 接进来之前，继续把公式、权重、组织熵与传播链推导留在服务端。
服务端算分 / 报告 / Prompt 层
仅服务端内部使用 · 无直接公开路径
暴露规则
算分链路、B 模块校验、深度报告模板、解释 Prompt 继续只保留在服务端。
等你后面继续发算分、报告、提示词文档后，我们就接这一层。
这层接完后，前台与开放平台仍只读结果，不直接读算法。
接下来继续怎么走
你后面继续发文档时，我们就按这个顺序往下接。
1先把个人测评的脱敏题目与开放平台题目 API 保持稳定。
2再把 Org-OS reserve API 接稳，作为组织测评的 API 联调主线。
3然后继续把算分链路、报告输出和教练解释层统一收回服务端私有链路。