OpenMind

开放平台 Reserve 联调说明

这页用来给内部开发、合作方或后续自己联调时快速确认当前开放平台 reserve 能力，以及外部如何以“工作心智分析”的方式接入题目和报告结果。

这不是一份简单的性格测试，而是一份关于“如何做决定、如何承压、如何协作、如何成长”的工作心智分析。

对外联调时，题目和报告结果都按这层公开口径表达；算法、权重、修正规则和 Prompt 私有载荷继续只留在服务端。

先用心智测评看清结构，再决定下一步该进哪条链

对外 API 和开放平台优先服务这条“测评先行”的主链：先拉题、先提交、先拿报告，再根据结果继续进入后续场景，而不是直接暴露全部内部能力。

- 1. OpenMind Assessment
- 2. 合伙人增强包
- 3. OpenMind Diagnosis
- 4. OpenMind Coach
- 5. OpenMind Readiness

当前开放平台优先围绕公开产品主线开放；旧的内容 / 销售工具不在这条对外主叙事里抢前置位。

当前这套开放平台还是 reserve 环境：路径、字段、错误格式、日志、Webhook、限流口径都已经锁定，但多数能力还没有接真实写库、真实外发和真实计费。

当前联调 key

reserve-demo-key

先看上线前最终核对清单看最终联调总地图看 OpenMind Coach v2.3 总映射返回 Admin 先看三步联调顺序再看 questions 返回示例再看 submit → report 示例最后看 report 返回示例再看三条 API 验收总览再看报告 / PDF 交付验收

开放平台最后一轮建议顺序

开放平台这条线最后还是按同一条 1–6 周顺序收，不单独另开一套。

1先回个人测评真实写库和报告 / API 验收，确认共同底座稳定。

2再看 Org-OS reserve API，确认企业主线 reserve 结构和 handoff 已稳定。

3最后再按 questions → submit → report 三步联调和交付页收开放平台。

这页放在 4 条链里怎么用

开放平台页继续是对外交付链入口，同时把和个人测评、Org-OS、AI 教练的关系摆清楚。

OpenMind Assessment 主链

先收真实写库、报告回读和 API 边界，这是开放平台共享底座。

OpenMind Diagnosis 主链

再收 Org-OS reserve API 和 handoff，确认企业主线 public contract 已经稳定。

开放平台交付链

这页就是对外交付链入口，最后按 questions → submit → report 和 PDF 收口。

OpenMind Coach 支撑链

AI 教练继续负责承接和验收说明，帮助前两条主线往外部交付链顺着接。

如果要先回总入口

先看最终联调总地图，再看 Coach v2.3 总映射，最后回开放平台总入口看对外交付链，会更不容易把开放平台专项页和总收口顺序看混。

先看最终联调总地图再看 OpenMind Coach v2.3 总映射回 Admin 总入口

先点这 4 页就够了

这 4 张页已经覆盖开放平台当前最核心的 reserve 联调主链，先按这个顺序看最省脑子。

先看 1 · 三步联调顺序

先按 questions → submit → report 这条顺序看整条链，不容易把问题混在一起。

先看三步联调顺序

再看 2 · questions 返回示例

确认版本、题量、题干、选项，以及常见错误返回。

再看 questions 返回示例

再看 3 · submit → report 示例

确认提交返回和 report_id 如何接到报告结果。

再看 submit → report 示例

最后看 4 · report 返回示例

最后确认推荐版本、三套报告和合伙人增强公开结果是否齐全。

最后看 report 返回示例

请求头

联调时最常用的请求头和响应头，先集中放在这里。

`x-api-key: reserve-demo-key`
`Authorization: Bearer reserve-demo-key`
`x-reserve-force-rate-limit: true`
`x-request-id`
`x-api-key-id`
`x-open-platform-log-id`
`x-rate-limit-plan`
`x-rate-limit-limit-minute`
`x-rate-limit-limit-month`
`x-webhook-events`

调用顺序

合作方最小联调可以直接按这 5 步走。

1先创建 assessment，会拿到 `assessment_id`。
2再按版本拉题，例如 `GET /api/open/questions?version=L1`。
3提交答案到 `POST /api/open/submit`，会返回 `scores + report_id`。
4再去取报告和 PDF 下载信息。
5如果要模拟支付链路，再调 payments / callback。

当前接口范围

这些接口已经有 reserve 结构化响应，可以直接拿来联调字段和状态。

测评主链

POST /api/open/assessments
GET /api/open/questions?version=L1
POST /api/open/submit
GET /api/open/report/[reportId]
GET /api/open/report/[reportId]/pdf

历史与支付

GET /api/open/users/[externalUserId]/assessments
POST /api/open/payments
POST /api/open/payments/callback

管理入口

POST /admin/api-keys
DELETE /admin/api-keys/[id]
GET /admin/api-keys/[id]/usage
POST /admin/webhooks

Reserve 行为

下面这些是当前刻意保留在 reserve 层、不提前做实的部分。

• 题目与报告主链已经可联调，但多数结果仍是 reserve 样例或非持久化返回。
• API Key 管理、Webhook 配置、支付入口都已经有结构化响应，但暂不写真实数据库。
• 限流支持 `429 / retry-after` 口径，也支持 `x-reserve-force-rate-limit: true` 模拟。
• Webhook 当前只会输出 reserve delivery 日志，不做真实 HTTP 外发。
• 所有开放平台入口都带 `request_id`，大部分还会带 `x-open-platform-log-id`。

合伙人增强公开结果

开放平台报告现在也会继续带上协作判断增强包的公开说明，但仍只返回公开安全结果，不暴露匹配公式、权重或协同阈值。

协作判断增强包

这组公开字段把主智测评继续接到合伙协作判断里：先看单人版合作盲区，再看双人版匹配，最后再决定要不要继续邀请链。

单人版公开标签

风险标签绑定建议题目覆盖合作盲区适合 / 避免画像合作前必须先验证试合作建议

双人版公开标签

匹配度匹配档位绑定建议互补优势冲突热区协议重点试合作建议

邀请链公开标签

partner_invite reserve分享文案示意邀请状态流转分享动作载荷二维码 reserve

当前对应开放平台报告字段：`report_data.partner_copy` 与 `report_data.report_variants[].partner_follow_up_copy`

销帮执行公开结果

开放平台报告现在也会继续带上测评 → 销帮执行映射的公开说明，但仍只返回公开安全结果，不暴露算分、权重或私有修正规则。

这组字段当前主要回答 3 件事

• 当前更适合按什么成交策略推进。
• 当前最值得先拆开的主摩擦是什么。
• 如果继续接销帮，下一步更适合先做什么。

report_data.sales_copy

返回这份报告在开放平台侧的公开销帮执行摘要，包括： `current_direction / friction_label / next_step_hint`。

report_variants[].sales_follow_up_copy

返回标准版 / 深度版 / 融合版各自更适合怎么继续接销帮，方便合作方和主产品读同一套公开执行语言。

文帮执行公开结果

开放平台报告现在也会继续带上测评 → 文帮执行映射的公开说明，但仍只返回公开安全结果，不暴露动态权重深度算法或私有行为规则。

这组字段当前主要回答 3 件事

• 当前更适合先走什么内容方向。
• 当前最值得先写的主题是什么。
• 如果继续接文帮，下一步更适合怎么起内容。

report_data.creator_copy

返回这份报告在开放平台侧的公开文帮执行摘要，包括： `content_direction / primary_topic / next_content_hint`。

report_variants[].creator_follow_up_copy

返回标准版 / 深度版 / 融合版各自更适合怎么继续接文帮，方便合作方和主产品读同一套公开内容执行语言。