新版智测替换会影响哪里

后面你发来的 L1-L3 题目、计算、报告和提示词,不会只改一两个文件。这页专门把影响面先摊开,避免我们临时边找边改。

这页不是让你现在就改代码,而是帮我们先锁定: 题库、计算、报告、Prompt、API、开放平台映射分别会落到哪些代码点。

如果你后面准备发新版材料,最省力的方式还是先回 智测内容接入准备 按 `题目包 → 计算规则包 → 报告与页面文案包 → 提示词包` 这 4 包来发。

我们后面也会按 一包一改、一包一验 的节奏推进,不会等所有材料全齐了才开始改。

如果你只能先发一批,最优先还是 题目包 ,因为它会先决定 L1-L3 结构、版本入口和页面答题流。

所以我们收到题目包后的第一轮成功标准也很简单: 版本入口稳、答题页稳、题量结构稳、预检不报大错。

建议替换顺序

后面拿到新版材料后,我们按这个顺序改,会比直接散改稳很多。

1先替换题库源头和版本配置,再动计算逻辑。
2再同步报告解释、推荐下一步和页面话术,不先乱动主链结构。
3然后统一 Prompt 合同和教练解释口径。
4最后再同步 API 输出和开放平台映射,避免内外口径打架。

这次替换的保密落法

这批 MindOS 文档不会直接变成前台常量。我们会保持『服务端私有源 → 脱敏题目视图 → API / 页面输出』这条链,继续沿用你之前开放平台文档里的保密口径。

服务端私有源:保留 question_id、score、dimension_weights、B 模块规则和报告模板。
脱敏题目视图:只保留题干、选项、版本、模块、功能组这些前台真正需要的字段。
API / 页面输出:继续按开放平台方式返回结果,不把内部算法和修正规则直接吐给前台。

当前已导入的私有题量

L1

10

L2

24

L3

65

题库与版本源头

这里是后面替换 L1 / L2 / L3 新题时最先动的地方,决定题目本身、层级结构和版本状态。

next-mvp/lib/assessment/questions.ts

正式题库、L1-L3 版本配置、题目层级和开放状态都从这里起。

next-mvp/lib/assessment/types.ts

如果新版题型、维度或 level 结构有变化,这里要一起跟着调整。

next-mvp/lib/assessment/content-import-contracts.ts

新版题库导入、预检和 starter bundle 结构会在这里对齐。

计算与解释逻辑

如果你要改计算、维度口径、报告解释和分流推荐,这组文件一定会动。

next-mvp/lib/assessment/scoring.ts

分数计算、标签归类和结果编码都在这里。

next-mvp/lib/assessment/service.ts

测评完成、写库、报告快照、下一步推荐和校验摘要都在这里串。

next-mvp/lib/assessment/messaging.ts

官网入口、应用入口、报告页的主链话术和步骤说明会在这里同步更新。

报告页与测评页承接

如果报告结构、解释顺序、CTA 或测评入口说明要改,这组页面会直接受影响。

next-mvp/app/assess/page.tsx

官网测评页说明、版本展示和公开承接文案在这里。

next-mvp/app/app/assess/page.tsx

应用内测评入口、版本切换、提交前状态和接入说明在这里。

next-mvp/app/app/assess/report/page.tsx

报告页结构、维度分数、解释说明、下一步推荐和报告状态都在这里。

next-mvp/app/app/assess/actions.ts

测评提交后怎么跳报告页、怎么携带结果参数,会在这里一起调整。

Prompt 与教练解释

如果你要连提示词一起重做,这组文件会一起改,不只是题库本身。

next-mvp/lib/assessment/prompt-contracts.ts

评分、解读、推荐三套测评 Prompt 合同在这里。

next-mvp/app/admin/assessment-prompts/page.tsx

这里是后面核对新版 Prompt 合同是否同步更新的可视化入口。

next-mvp/lib/coach/prompt-contracts.ts

测评教练卡和情感智能承接里会引用测评结果口径。

API 与开放平台映射

如果版本、题目结构、报告字段或评分口径变化,对内 API 和对外开放平台都要一起跟。

next-mvp/app/api/assessment/complete/route.ts

应用内测评提交 API 会直接受版本和结果结构影响。

next-mvp/app/api/assessment/profile/route.ts

档案读取和摘要输出字段要和新版报告口径保持一致。

next-mvp/lib/open-platform/questions.ts

内部题库如何映射成开放平台 `/questions` 返回,要跟着新题库同步。

next-mvp/lib/open-platform/assessment-mappers.ts

内部结果如何映射成开放平台报告、提交结果和历史记录,会跟着新版结果结构调整。