src/主要包含 React + TypeScript 组件、hooks、Zustand stores；核心文件有Canvas.tsx、Toolbox.tsx、PropertiesPanel.tsx和hooks/useStimulation.ts。public/存放静态资源与国际化入口配置；index.html用于 Vite 注入。dist/为npm run build生成的产物，调试时无需手动修改。- 根目录下的
vite.config.ts、tsconfig.*、eslint.config.js描述构建、类型检查与 Lint 规则。
npm run dev启动 Vite 开发服务器并热更新实验画布。npm run lint按 ESLint 规则检查 TypeScript/TSX；提交前必须通过。npm run build执行tsc -b与 Vite 生产构建，验证类型与打包配置。npm run preview在本地以生产模式验证刺激渲染表现。
- 使用 TypeScript 严格模式，组件命名采用 PascalCase，hooks 以
use前缀的 camelCase。 - Zustand action 与工具函数保持动词开头的 camelCase，避免直接改写 store。
- UI 文案统一从
src/i18n加载，翻译键使用点号层级，如properties.element.frequency。 - 代码默认两空格缩进，提交前运行 ESLint 自动修复轻微格式问题。
- 目前未引入单元测试框架；每次功能变更需运行
npm run lint与npm run build。 - 对刺激精度相关改动，应在
FullscreenMode中实测频率统计，并观察StimulationStats输出。 - 若新增模块，优先补充 store 或 hook 层的可测逻辑，为后续引入 Vitest 做好拆分。
- 推荐遵循类似 Conventional Commits 的前缀（如
feat:,fix:,doc:），简述影响范围与目的。 - PR 描述需明确变更点、影响界面、验证步骤；涉及 UI 变化时附截图或录屏。
- 引用相关 issue 或待办任务，确保审核者可追踪上下文与验收标准。
- 与用户互动时保持中文回复，并在响应中解释关键决策。
- 改动完成后主动给出建议的自测命令。
仓库已整合最小导出 + Python 端分析闭环，详见 docs/validation.md。
- 浏览器端一键运行评测示例并导出单个 JSON，文件命名遵循
{date}_{browser}_{hz}_{mode}_{runID}.json。 - 导出结构包含环境元信息、刺激配置
stims、帧记录frames、切换事件toggles，便于直接交由脚本处理。 - 数据默认存放于
scripts/data/，该路径已在.gitignore中排除。
python -m scripts.measure <inputs> -o scripts/out/measure解析 JSON、输出summary.csv、生成图表与report.md。- 频率误差图使用折线 + 散点，误差棒表示 ±1 标准差；抖动与帧率稳定性指标同步写入汇总表。
- 图表与报告默认输出到
scripts/out/，该目录同样已经忽略提交。
scripts/out/summary.csv：逐刺激指标汇总。scripts/out/measure/plots/：误差曲线、抖动箱线图、帧间时间分布。scripts/out/measure/report.md：自动化报告，可直接嵌入评审材料。
- 剩余前端体验任务（拖拽调宽、分享优化）保持在主待办清单中，完成后配合上述验证流程复测。