本文介绍在 jspsych 框架中不重复编码、不手动拼接的前提下，将多个已有的独立实验（如主实验和 digit span 实验）串联执行，并统一管理时间线与数据流的可靠方案。
本文介绍在 jspsych 框架中不重复编码、不手动拼接的前提下，将多个已有的独立实验（如主实验和 digit span 实验）串联执行，并统一管理时间线与数据流的可靠方案。
在 jsPsych 开发实践中，常遇到需将多个功能独立、结构完整的实验（例如一个认知主任务 + 一个标准化的 Digit Span 测验）按顺序执行的需求。直接复制粘贴代码不仅违背模块化原则，还会导致维护困难、时间线割裂、数据导出混乱等问题。而原生 jspsych-external-html 插件仅支持加载静态 HTML（如知情同意书），无法动态启动另一个完整的 jsPsych 实验实例——因其未提供 JS 执行上下文与实验生命周期控制能力。
✅ 推荐方案：采用 JATOS 平台进行多组件编排
JATOS 是专为在线行为实验设计的开源服务器平台，天然支持“多组件研究”（Multi-Component Study）。每个组件是一个独立的、自包含的网页（含 HTML/JS/CSS），可分别部署为独立的 jsPsych 实验。你无需修改任一实验的内部逻辑，只需做轻量适配即可实现无缝跳转与数据聚合：
-
将现有实验封装为 JATOS 组件
- 将
main/文件夹作为组件 1，digit-span/文件夹作为组件 2； - 确保每个文件夹内含完整可运行的
index.html（含<script src="jspsych.js"></script>和jsPsych.init({...})调用）； - 参考 JATOS 官方适配指南，仅需添加两行关键代码以兼容 JATOS 运行时：
- 将
<!-- 在 index.html 的 jsPsych.init() 之前添加 -->
<script src="jatos.js"></script><script>
// 确保实验完成后自动跳转至下一组件（需提前在 JATOS 后台配置流程）
jsPsych.init({
timeline: [...], // 你的原始 timeline
on_finish: function() {
jatos.endStudyAndStartNext(); // ✅ 核心：结束当前组件并启动下一组件
}
});
</script>
-
在 JATOS 后台构建研究流程
- 登录 JATOS 管理界面 → 创建新研究（Study）→ 添加两个组件（Component）；
- 按顺序拖拽：
main组件 →digit-span组件； - JATOS 自动为每个组件分配唯一 URL，并在前一个实验
endStudyAndStartNext()调用后，无缝重定向至下一个组件，同时继承 participant ID 与 session 信息。
-
统一数据管理优势
- 所有组件的数据默认以 JSON 格式按组件名归档，可通过 JATOS REST API 或导出功能一键获取完整时间线；
- 支持跨组件元数据传递（如
jatos.addResultData({phase: 'main', rt_avg: 420})），便于后期关联分析。
⚠️ 注意事项：
- 避免在浏览器端尝试
fetch()+eval()加载外部实验 JS——存在 CSP 限制、作用域隔离、事件循环冲突等严重风险； - 若必须纯前端方案（无服务端），可考虑将各实验打包为独立
jsPsych.init()函数并动态注入 DOM，但需自行处理资源路径、全局变量污染及错误恢复，强烈不推荐用于正式数据采集； - 所有实验应使用相同版本的 jsPsych（建议 ≥ 7.3），避免插件 API 不兼容。
综上，JATOS 不仅解决了实验串联问题，更提供了标准化的数据追踪、参与者管理、失败恢复与 GDPR 合规支持，是科研级 jsPsych 多任务集成的事实标准方案。
