附录 B：差距矩阵与分阶段路线图

对应主蓝图：app/assets/docs/research/cstar-research-platform-blueprint.md 配套附录：app/assets/docs/research/research-data-foundation.md（附录 A） 版本：v1.0 · 2026-11-11 · 状态：待评审 性质：本文件全部内容为现状核验结论与未来实施建议，不代表已实现。

1. 文档说明

1.1 用途

• 第 2 章：把《研究计划.md》的每条要求映射到现有代码，给出「已有 / 需新增 / 需改造 / 明确不做」判定，供评审逐项追踪、供实施拆任务。
• 第 3 章：汇总本次只读核验的证据，凡「现状」断言均可回溯到具体路径与行号。
• 第 4 章起：阶段路线图、验收清单、冻结清单、风险映射、站内文档导航注册方式。

1.2 判定口径

1.3 路径约定

表内路径相对仓库根 d:/Projects/GitHub/urdoc/；行号为 2026-11-11 只读核验结果。条款列中的「§」均指《研究计划.md》，「手册」指《CSTAR 答题样例与评分手册（草稿）》v0.1，「分析」指《CSTAR 相关理论或方法的分析》。

2. 差距矩阵

2.1 三个研究入口

2.2 CSTAR 五模块

2.3 多模态：图像 / 视频 / 声音

2.4 研究底座与数据层

2.5 合规与质量

2.6 「明确不做」汇总（本期）

3. 现状断言核验表

本章为第 2 章「现状」列的证据汇总。本次核验为只读，未修改任何文件。

4. 分阶段路线图

阶段划分对齐《研究计划.md》§13 与里程碑 M2 / M3 / M5 / M6，并计入本次新增的待决事项（主蓝图第 9 章 D1–D4）。所有交付物均为未来实施建议。

flowchart LR
  S0["阶段0 评审与预研"] --> S1["阶段1 协议与底座"]
  S1 --> S2["阶段2 平台 v2 与 pilot"]
  S2 --> S3["阶段3 正式采集"]
  S3 --> S4["阶段4 锁定与分析"]
  S4 --> S5["阶段5 结题与推广"]
  S1 -.-> M2["M2 量规冻结 2027.06"]
  S2 -.-> M3["M3 pilot 报告 2027.12"]
  S3 -.-> M5["M5 有效样本 ≥94"]
  S4 -.-> M6["M6 数据锁定 2028.08"]

关键路径说明：D1 / D2 决策 → 伦理审批 → 量规与题库冻结（M2）→ 平台 v2 与 pilot 门控（M3）→ 正式采集。任一门控未达标不得进入下一阶段；pilot 与敏感性分析（AB/BA 交叉）结果并入主报告但不改变主设计（§7.1、§7.9）。

5. 可勾选验收清单

用于阶段评审与结题自查。每条均应能对应到差距编号或《研究计划.md》条款；勾选前需有可核验证据（导出记录、审计报告、冻结版本或 pilot 报告）。

5.1 研究设计合规

• 以《研究计划.md》定稿为唯一基线，评分手册旧 AB/BA 设计未被误用（主蓝图 C1、C2）
• A 臂不接触 CSTAR 训练，B 臂完成 10 至 20 套完整闭环（§7.2、R-03）
• 三套题库互不重叠，练习库不进入任何测评，出科 Y 为全新题（C-08、R-04）
• A/B 题型组合、题量与 rubric 一致，唯一差异为 Story 叙事层与线上闭环（C-07、Q-02）
• 单一主要结局 0 至 100，权重 W1 40 / W2 30 / W3 30 已冻结（Q-10、R-07）
• JSE-HPS 与 vOSCE 作为独立量表保留，未以「题目已融合」为由取消（R-09）
• vOSCE 患者人格独立于训练引擎，入科 / 出科使用平行等价剧本（C-14、Q-04、R-05）
• 论文与平台如实命名 vOSCE 及替代方式（R-10）
• 结论表述限定为「CSTAR 程序效应」（R-08）
• 真实 SP / MSF / CBD 等排除项未被悄然引入确证链（Q-01、第 2.6 节）

5.2 页面与能力

• 三个 project 页面按角色分工，且不再重复实现同一能力（P-01 至 P-06）
• 三页 UDashboardPanel 的 id、面包屑与 i18n 键已修正（P-05）
• 叙事医学页保留生成器并新增理论、研究总览与证据链地图（P-01、P-02）
• 教师工作台具备冲突设计、审核、量规、学情、复盘、教师采集与培训入口（P-03）
• 学生端按入科 / 轮转 / 出科窗口组织，不暴露臂别、题库标签、标准答案（P-04、第 5.4 节）
• Case / Story 支持结构化参数与人工审核冻结（C-01 至 C-03）
• Test 支持选择 / 简答 / 对话子题三类题型与逐题置信度 1 至 5（C-05 至 C-09）
• Act 为答题内 1 至 2 轮对话子题，训练与测评 persona 解耦（C-13、C-14）
• Rate 具备 AI 双维报告、教师脚手架、同伴协商、反思叙事档案四个可采集动作（C-16 至 C-20）
• 多模态素材按「生成 → 审核 → 冻结 → 投放 → 归档」生命周期管理（M-01 至 M-09）
• vOSCE 起步方案（视频触发器 + 学员回应录制）与转录存档可用（M-03、M-04、M-07）
• 移动端与桌面端均适配，输入控件触摸友好（AGENTS.md）

5.3 数据与导出

• 研究数据全部落库，浏览器 localStorage 与截屏不作为研究证据（D-05、D-13、E-08）
• subject 表只存哈希 ID，姓名 / 学号不出平台（附录 A 第 3.1 章、E-01）
• 逐题事件含开始 / 提交时间、用时、置信度、修改次数，且批量写入与幂等去重（C-09、附录 A 第 4 章）
• 三类日志分离：业务日志、研究事件日志、审计日志（附录 A 第 4 章）
• 盲态评分视图隐藏臂别、身份、题库标签与 pre/post 时点（D-04、Q-05）
• 教师轨独立于学员流程采集并可单独导出（D-10、§11）
• 每次 AI 调用记录模型 / 版本 / 温度 / 提示词版本 / 时间戳（D-12、E-06）
• 按月导出附数据字典版本、行数与校验和，锁库后只读（D-11、附录 A 第 5.2 章）
• 大素材存 Blob，库内只有元数据、引用与哈希（M-02、附录 A 第 8.4 章）
• 驱动抽象可切换，迁移与回滚方案经过验证（D-13、D-14、附录 A 第 8.1 / 8.4 章）

5.4 质量门控

• 人—人 ICC ≥0.75 且 AI—人一致性（Pearson r / ICC / 加权 κ + Bland-Altman）同时报告（Q-06、§9）
• ICC 未达 0.75 时已降级为「AI 辅助、人工主导」并记录决策（§10.4）
• JSE 中文版 α ≥0.80，注明出处与 10 道反向题（D-06、§8.1(1)）
• pilot（n≈10）跑通完整闭环并形成报告（§13 M3）
• 2 名专家审定等值性与量规，分歧有仲裁记录（D-07、D-08）
• 无效作答剔除、缺失率规则与 ITT / PP 双分析集已执行（Q-09、E-07）
• ANCOVA 以入科 X 为协变量，vOSCE 与主结局同构分析（§7.5、§8.1(3)）
• 统计计划与冻结清单在数据锁定前归档（第 6 章）

5.5 合规与治理

• 知情同意文本获批，明确自愿参与与用途限定，非授课教师招募（Q-07、R1）
• 答题数据与出科成绩 / 个人评价物理隔离并书面告知（E-02、R1）
• RBAC、传输与静态加密、盲态字段服务端过滤已落实（E-03、D-04）
• 人工在环审核清单、RAG 指南接入与一键纠错留痕可用（C-02、E-05、R4）
• 数据保留期限（结题后 5 年）与锁库只读规则写入治理配置（E-04）
• 待决 D1 / D2 有书面决策，部署形态与数据驻留边界明确（主蓝图第 9 章、附录 A 第 9 章）
• 001_users.sql:5 语法瑕疵已修正，迁移脚本可重复执行（第 3 章核验 9）
• 本次三份文档未被误当作已实现功能，业务代码零改动（第 1.2 节、第 8 章）

6. 冻结与锁库清单

7. 风险映射

7.1 研究计划 R1–R10

7.2 平台侧新增风险（本次识别）

8. 纳入站内文档导航的后续注册方式

本次仅新增三份 Markdown，不修改 app/utils/docs.ts。app/utils/docs.ts:84-87 通过 globalThis._importMeta_.glob('~/assets/docs/**/*.md') 加载全部 Markdown，getDocContent(slug)（:89-99）按 assets/docs/{slug}.md 匹配，因此三份文档在注册前已可通过以下路径访问，只是不会出现在文档侧边栏：

后续若需纳入侧边栏，可在 docNav（app/utils/docs.ts:19-59）中新增一个分组，示例（仅为示例，本次不写入代码文件；DocGroup 类型定义见 app/utils/docs.ts:10-14）：

{
  label: '研究平台蓝图',
  icon: 'i-lucide-git-branch',
  children: [
    { label: '整体改造蓝图', icon: 'i-lucide-map', slug: 'research/cstar-research-platform-blueprint' },
    { label: '研究数据底座', icon: 'i-lucide-database', slug: 'research/research-data-foundation' },
    { label: '差距矩阵与路线图', icon: 'i-lucide-list-checks', slug: 'research/gap-matrix-and-roadmap' },
  ],
} as DocGroup

注册后由 generateDocSidebarItems()（app/utils/docs.ts:105-128）自动生成导航；若需要中英双语标签，另按 i18n/locales/{zh,en}.json 与 AGENTS.md 的 i18n 约定补充文案。

文档闭环与交叉引用

边界复核：三份文档均为设计蓝图，业务代码、配置、依赖与 docNav 零改动；所有改造项以「未来实施建议」表述，实施顺序与验收以本附录第 4、5 章为准。