# jsPsych-Easy-Builder

**Repository Path**: zfASA/jsPsych-Easy-Builder

## Basic Information

- **Project Name**: jsPsych-Easy-Builder
- **Description**: 一个基于 Reflex 的本地运行网页应用，通过可视化界面构建 jsPsych 实验，减轻编码负担。
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-30
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: utils

**Tags**: None

## README

# 🎨 可视化 jsPsych 实验构建器

**可视化构建 jsPsych 实验**  

一个基于 **Reflex** 的 **在本地运行的网页应用**，让你轻松设计、预览并导出实验。

---

## ✨ 功能一览

| 功能 | 描述 |
|---------|-------------|
| 🖱 **可视化实验设计** | 点击界面即可创建实验，无需写代码。 |
| ⚡ **快速启动** | 快速启动实验，无需复杂环境配置。 |
| 📦 **代码导出** | 导出可直接运行的 jsPsych 代码，用于在线或离线实验。 |
| 🧩 **组件库** | 预置试验类型和刺激，快速搭建实验。 |
| 👀 **实时预览** | 即时查看实验运行效果。 |

⚠️ 目前仅支持 Windows 系统。

⚠️ 目前不支持自动添加扩展（例如眼动扩展），需要手动添加。

---

## 🚀 快速开始

1. **从 发行版 下载：**
   
   [jsPsych_Easy_Builder.zip](https://gitee.com/zfASA/jsPsych-Easy-Builder/releases/download/v1.0.1/jsPsych_Easy_Builder.zip)

2. **解压并双击运行：**
   
   `jsPsych_Easy_Builder.exe`

3. **在浏览器中打开：**
     
   `http://localhost:3000`

---

## 🖌 使用方法

1. 点击并从侧边栏添加组件。
<img alt="image" src="https://gitee.com/zfASA/jsPsych-Easy-Builder/raw/main/images/1.png" />
⚠️ 在任意参数前加 `$` 可表示代码/变量而不是具体的值 （类似psychopy）

2. 实时预览实验效果。
<img  alt="image" src="https://gitee.com/zfASA/jsPsych-Easy-Builder/raw/main/images/2.png" />

3. 上传实验材料（可在实验中直接通过文件名引用）。
<img alt="image" src="https://gitee.com/zfASA/jsPsych-Easy-Builder/raw/main/images/3.png" />

4. 一键设置插件来源和数据存储方式（支持本地保存、[Naodao](https://naodao.com/)、[Credamo](https://www.credamo.com/) 和 [JATOS](https://www.jatos.org/)）。
<img alt="image" src="https://gitee.com/zfASA/jsPsych-Easy-Builder/raw/main/images/4.png" />

5. 准备好后导出 jsPsych 代码。