AlloFlow Document Remediation

---

🚀 什么是 AlloFlow？

AlloFlow 是一款开源、隐私优先的 AI 课堂助手和教学差异化引擎，专为教育工作者、特殊教育团队和学校心理学家打造。使用无需密钥、由 Google 托管的 Gemini Canvas 路径，无需安装；也可以运行 AlloFlow Desktop，采用本地优先的教师笔记本电脑工作流。

阅读时，从选定的原文开始，并按需添加辅助材料。只有在有助于实现学习目标时，才创建改编版配套材料，同时保留原文供学生参考。AlloFlow 还可创建学习活动及其他差异化资源。

AlloFlow 软件无需订阅。无需学生账户，也无需提供个人身份信息（PII），即可运行本地课堂工作流。云服务提供商的条款、数据处理方式和费用取决于你选择的部署方式。

AlloFlow 官方网站： apomera.github.io/AlloFlow

官方源代码仓库： github.com/Apomera/AlloFlow

官方项目信息： apomera.github.io/AlloFlow/about.html — 包含维护的项目标识、版本、许可证、隐私边界，以及辨别官方项目与分支的指南。

搜索标识： AlloFlow 是一款免费的开源 AI 课堂助手，适用于差异化教学、UDL、无障碍、AAC 沟通、STEM/SEL 工具、RTI 和学校本地优先部署。

当前清单（2026 年 10 月 16 日验证）： 仓库注册表检查显示，已注册 152 个 STEM 工具和 72 个 SEL 工具；STEM 目录中包含 152 个插件文件。更广泛的 7 月 3 日代码库审查仍是架构和规模估算的日期依据。AlloFlow Desktop 是日常使用的本地优先方案，而 Docker School Box 技术栈是可选的服务器/设备基础设施。请参阅 docs/codebase_review_2026-07-03.md、docs/code_size_inventory_2026-07-03.csv、docs/competitive_positioning_review_2026-07-03.md 和 desktop/README.md。

🔗 启动 AlloFlow

---

⚡ 快速开始

1. 点击启动 — 打开 Gemini Canvas 路径（需要符合条件的 Google 账号；可用性和学校管理员设置可能会影响使用）
2. 将课程文本粘贴到「源材料」框中，并明确学习目标。如果根据主题生成源文本，请在用于教学前先行审核。
3. 选择「使用辅助工具阅读原文」，以原样打开选定文本。使用朗读和聚焦工具，并按需添加词语解释。打开原文无需调用 AI；生成解释则需要。
4. 按需添加辅助材料 — 词汇表、组织图、练习活动或改编版配套材料。默认情况下，改编版是补充材料；使用「原文 / 改编版 / 两者」与捕获的源文本进行比较。
5. 分享前先审核，并试用学生视图。 检查语境中的词义、重要观点以及内容是否适合学习者。然后使用实时课堂或导出，并在学习者的设备上测试他们收到的内容。

阅读流程指南： 打开原文、添加词语辅助、比较版本并检查学生端呈现。

需要多种资源？「完整套件」可根据你选定的源文本起草一组资源。当课程需要多种辅助材料时可使用此功能，并在分享前逐一审核。

💡 如需在教师笔记本电脑上本地优先使用，请参阅 desktop/README.md。如需试验学校自有服务器或设备，请参阅下文的 School Box。

🏫 学区决策者？ 请参阅 2 页的 管理员简报 — 其中包含成本比较、隐私与合规情况，以及试点路径概要。

由 Agent 编写的 AlloPack

Agent 无需打开 AlloFlow UI，即可编写相同的便携式资源包结构。本地 Agent Core MCP 可接收由 Agent 生成的资源历史记录，验证渲染器所需的关键结构和隐私保护措施，创建供教师审核的预览，并导出 .allopack.json 载荷。它不会暗中调用模型、读取 API 密钥、上传源文本、发布内容，也不会写入任意路径。请参阅 MCP 连接器指南、AlloPack 规范和可重复使用的 AlloFlow 资源包编写技能。

---

产品导览

• 推广网站 -- 概览、部署路径和当前证据
• 官方项目信息 -- 权威代码仓库、当前版本、许可证、作者信息和部署边界
• 工具查找器 -- 按目标、源文本要求、AI 需求和访问路径搜索
• 文档修复 -- 流程、证据边界、便携式 Skill 和连接器状态
• AlloFlow 的使用方式 -- 比较 Gemini Canvas、浏览器、桌面版、Skill 和连接器路径
• 无障碍白皮书 -- 标准背景、架构、隐私边界和证据
• 反馈 -- 提交想法、错误、无障碍障碍问题以及去标识化使用故事的安全渠道
• 功能目录 -- 按 UDL 组织的已记录功能
• 学生体验 -- 面向学习者的工具和无障碍辅助功能
• 学区简报 -- 规划、隐私、无障碍和试点注意事项

随着界面不断演进，截图可能很快过时。请通过当前推广页面和启动流程查看最新维护的产品导览。

---

✨ 主要功能

🎓 适用于教师

功能	描述
原文阅读与辅助工具	阅读选定的原文，内容保持不变，并可使用朗读、专注工具和可选的上下文词语解释；教师可以查看和编辑解释
改编读物与支架	为选定的难度和语言起草补充读物，在原文／改编版／两者之间进行比较，并添加完形填空文章或写作框架；分享前先检查含义和是否适合学习者
完整套件生成	一键同时生成词汇表、分级读物、测验、视觉组织图和教案
实时课堂（课堂同步）	实时将教师屏幕推送到所有学生设备——可使用教师引导或学生自主模式
小组差异化教学	在实时课堂中同时为不同学生小组分配不同资源
教案构建器	自动将所有生成的资源整合为符合标准的脚本化教案
标准对齐	对齐 CCSS、NGSS、CASEL 或任意州级标准；AI 会审核自身输出是否符合要求
智能配置文件	保存配置（例如“5 年级 + ESL”），以便在不同课程间一键切换
多模态输入	可从粘贴的文本、URL、PDF／图像 OCR、音频／视频转录或 AI 生成内容导入素材
AlloStudio	开箱即具备无障碍支持的传单／工作表／数字艺术工作室，提供真实文本、明确的阅读顺序、必需的替代文本／装饰性图像状态，以及具备来源追踪能力的流程历史
Open Groove Studio	基于浏览器的节奏盒／作曲工作室，用于节奏、合成、采样、记谱概念和遵循许可要求的课堂音乐创作
Cinematic Studio	Agent 式文档 → 视频生成器：基于来源的分镜 JSON、字幕 + 翻译，以及客户端渲染（WebCodecs / Remotion）——无需渲染服务（Educator Hub → 🎬）
专业发展	由社区编写的专业发展模块，支持 AI 协同创作、完成情况跟踪和证书（Educator Hub → Community Catalog → Professional Development）

🎮 适用于学生

功能	描述
冒险模式	自选剧情的冒险 RPG，包含经验值、物品栏、动态生成的 Imagen 场景和故事书导出
Boss 战	全班合作答题游戏——答对即可对 Boss 造成伤害
解谜挑战	团队解谜挑战，支持教师控制提示并限时追踪逃脱进度
复习游戏	Jeopardy 风格的竞赛复习游戏，支持组队和实时计分
民主模式	全班投票选择答案；提交多数人的选择
游戏化引擎	在所有活动中获得经验值、等级、连续完成记录和徽章
互动词汇表	记忆配对、单词搜索、填字游戏、宾果和单词拼排——均可根据词汇表即时生成
沉浸式阅读器	RSVP 速读、卡拉 OK 式高亮、仿生阅读和可调节阅读标尺

🩺 面向特殊教育工作者和 BCBA

功能	描述
BehaviorLens	完整的 FBA/BIP 套件 — ABC 数据收集、频率/间隔追踪、IOA 计算器（5 种方法）、散点图分析、偏好评估（MSWO、配对、自由操作）
Quick-Fill AI	输入自然语言观察记录；AI 会自动将其整理为前因、行为、后果，并给出功能假设
干预模板	DRO 方案、代币经济制、行为契约、SMART 目标、FCT 模板、降级处理工具包
修复性语言	肯定性词汇表会将临床 ABA 术语转换为以人为本的语言，并贯穿整个流程；每条已记录事件都会生成修复性问题
Symbol Studio	完整的 AAC 平台 — AI 生成 PCS 风格符号（Imagen + 图生图）、板面构建器、视觉日程、社交故事（Carol Gray 格式）、8 种快速板面类型、Symbol Quest（4 种游戏模式）、Symbol Search（听觉到视觉训练）、Word Garden（词汇增长追踪）、自动记录练习的 IEP 目标追踪、伙伴辅助扫描、多语言板面（14 种语言）、每个单元格均可录制家长语音、最多支持 8 个学生档案
Word Sounds Studio	涵盖五个领域的 17 项读写活动 — 6 项音位意识活动（计数、分段、识别、组合、声音分类、操作）、4 项音节与押韵活动、3 项自然拼读活动、3 项拼写活动、1 项书写活动，并具备按年级常模设定的自适应难度和 6 个成就徽章
StoryForge	6 阶段支架式创意写作，提供 AI 插图（Imagen）、旁白（8 种 TTS 语音）、自定义评分量规评分、支持 18 种语言、限时写作、AI 语法/风格指导、修订追踪和漫画分镜贴纸

🧠 面向学校心理学家

功能	描述
报告撰写向导	10 步引导式向导，将标准化评估数据综合为双语心理教育报告；采用三角验证生成（N 次并行处理，按证据覆盖率选出最佳结果）、自我修复式双轮准确性审计、分数与文本核验，以及跨章节一致性检查
事实分块处理流程	不可变的 PII 清理层可防止报告生成期间 AI 产生幻觉或误解统计数据；支持交叉参照发展常模（按年龄划分的注意力持续时间、发脾气频率、社交游戏和词汇量）
17 种评估预设	WISC-V、WIAT-4、BASC-3（家长和教师）、Vineland-3、BRIEF-2、Conners-4、WJ-IV COG 和 ACH、KABC-II、DAS-II、CELF-5、KTEA-3、SRS-2、GARS-3、BOT-2
学生分析（RTI）	自动进行 Tier 1/2/3 分类并监测目标线（4 周预警、6 周关键警报）；提供 ORF、数学流畅度和读写能力 CBM 测试；皮尔逊相关分析；异常标记；CSV 导出
数学流畅度测试	按 K–8 年级常模设置的 DCPM 算术练习（加法、减法、乘法、除法），提供错误分析和挫败情绪检测
PDF 无障碍处理流程	上传任意 PDF → 最多由 10 位审计员进行三角验证式 AI 审计（用户可配置，并提供利益相关者视角变体：屏幕阅读器用户、残障权利倡导者、Section 508、Title II ADA、JAWS/NVDA 测试人员等）→ 统计一致性分析（类似 ICC、类似 Cronbach）→ 通过 Vision API + Tesseract.js OCR 一键修复 WCAG（针对扫描/加密 PDF，可回退到 Gemini Vision）→ axe-core 4.10 验证 → 自我修复自动修正循环，支持回归撤销和基于 SEM 的平台期检测 → 原生带标签 PDF 输出（通过 pdf-lib 生成真实的 /StructTreeRoot，并按照 PDF/UA §7.21.4.1 嵌入字体）→ 应用内结构检查，并可选择通过本地 veraPDF 演示/QA 工作流进行独立的 PDF/UA-1 (ISO 14289-1) 验证 → 使用主题、品牌匹配和 AI 图像工具预览/编辑 → PII 涂黑（真正移除文本）和 可填写的 AcroForm 工作表 → 导出为无障碍 PDF、HTML、ePub3、DAISY、ODT 或音频

---

STEM Lab（152 个插件文件 / 152 个已注册工具 ID）

STEM Lab 是一套动态加载的浏览器交互式工具。根据 2026 年 10 月 16 日运行 node dev-tools/check_tool_registry.cjs 的验证结果，工作区包含 152 个 stem_tool_*.js 文件和 152 个已注册的 STEM 工具 ID。

领域	工具
数学基础	Fraction Lab、Area Model、Multiplication Table、Number Line、Math Manipulatives、Money Math、Coordinate Grid、Angle Explorer、3D Volume Explorer、3D Geometry Sandbox
高等数学	Function Grapher、Inequality Grapher、Calculus Visualizer、Algebra CAS、Graphing Calculator、Probability Explorer、Unit Converter、Logic Lab
生命科学与生物学	Cell Simulator、Human Anatomy、Brain Atlas、DNA Lab、Punnett Square、Virtual Dissection、Decomposer、Companion Planting Lab、Aquaculture & Ocean Lab、Ecosystem Simulator、Beehive Simulator
地球与空间科学	Rocks & Minerals、Water Cycle、Climate Explorer、Plate Tectonics、Solar System、Universe Timelapse、Galaxy Explorer、Moon Mission
物理与化学	Wave Simulator、Physics Simulator、Circuit Builder、Chemical Equation Balancer、Molecule Builder、Titration Lab、Semiconductor Lab、Data Plotter
技术与计算机科学	Coding Playground、Cyber Defense Lab、Data Studio
创意与设计	Architecture Studio、Art & Design Studio、Art Studio、Creative Studio、Game Studio
社会研究与生活	Economics Lab、Life Skills Lab
模拟与应用	Kepler Colony、Behavior Shaping Lab、Flight Simulator、ATC Tower、Fire Ecology、Epidemic Simulator、World Builder、Science Lab、Geometry World

每个工具都支持 Generate Drill，可即时生成相关练习集，并在会话期间保存和恢复状态。

Perception Lab 提供七种视觉实验和三项 Match by eye 活动，分别用于比较亮度、圆形大小和线条长度。学习者可以替换或移除周围环境、显示绘图数值、按相同比例比较固定的设置，并保存观察结果，还支持删除撤销和 JSON 导出。预览和验证信息请参阅 Perception Lab 增强报告。

每项匹配活动还支持一项 三次匹配研究，其中周围环境固定、起始位置各不相同，并可单独添加笔记。记录完三次匹配后，学习者可以查看其中位数和范围、回顾已保存的研究，或重复其设置。验证和预览信息请参阅 重复研究增强报告。

可以在相同实验和参照条件下比较已保存的研究。独立揭示、共用比例的绘图、中位数变化以及设置变更说明，都有助于学习者比较观察结果。请参阅研究比较增强报告。

完整保存的研究还提供单项设置重复规划器。它会保留参照和实际起始位置，在笔记本达到记录上限时保护基线记录，并在完成三次新匹配后打开两项研究，以便分别揭示结果。请参阅引导式研究增强报告。

导出的 Perception 笔记本现在可以通过预览导入重新打开。此功能会保留现有观察记录，将重复匹配归为一组，检查 24 条记录的上限，并提供撤销导入选项。请参阅笔记本导入增强报告。 Perception 笔记本还提供查找器，包含观察和已保存研究视图、实验／状态筛选器，以及对可见笔记、印象和标题的搜索。重复匹配项会保持分组，原始笔记本编号仍然可见，已打开的研究比较不受筛选器影响。请参阅笔记本查找器增强报告。

现在，已揭示的 Perception 研究会显示实际记录的绘图预览。选择任意一项试验，查看其印象和笔记，并以相同缩放比例比较独立选择的 A/B 试验。预览控件会保留当前绘图和笔记本。请参阅已记录绘图增强报告。

现在，Perception 研究和已准备就绪的 A/B 比较可以导出为独立的 HTML 报告，其中包含所有已记录绘图、完整笔记、设置和结果。在浏览器中打开导出的文件即可阅读或打印；未完成或隐藏的研究无法导出。请参阅便携式研究报告增强报告。

现在，Perception 笔记本会显示已保存和可用空间，并在空间已满时保留现有观察记录。通过标题／数量预览删除整个已保存研究，然后使用一次受保护的撤销操作恢复其所有记录。请参阅笔记本容量增强报告。

已记录的 Perception 绘图可以在模态查看器中放大显示，查看器提供近乎全窗口宽度、试验选择、测量参考线和完整笔记。键盘焦点和已保存结果的可见性仍受保护。请参阅放大绘图增强报告。

兼容的 Perception 研究也可以在放大的 A/B 查看器中同时打开，支持独立选择试验、统一绘图比例，以及自适应或手动堆叠。请参阅成对绘图增强报告。

已保存的 A/B 审阅现在提供 在同一位置切换绘图，可通过按钮和方向键在固定位置和比例下比较完整的已记录试验。独立试验、参考线和笔记均保持不变；已保存数据和完整报告也会保留。请参阅固定位置已保存绘图比较报告。

现在，在放大的审阅视图中，已保存的试验绘图支持共享缩放和平移，并提供适应窗口、键盘导航，以及原生鼠标／触控拖动操作。A/B 视图会保持对齐，同时保留已保存数据和完整报告。请参阅已保存绘图检查器报告。

放大的已保存绘图现在会在图像旁显示完整绘图或当前裁剪放大视图，并提供本地检查／适应窗口操作，同时确保键盘焦点始终可见。请参阅已保存绘图边框报告。

已保存的研究比较现在使用自适应图表，显示清晰易读的标签和试验点、共享线性比例，以及明确的范围、中位数和参考标记。请参阅研究比较图表报告。

单项研究结果现在使用自适应试验卡片，并提供清晰的列标签、对齐的数值，以及在窄屏和较大字号下仍清晰可见的试验编号。请参阅研究试验记录表报告。

正在进行的三次匹配研究现在会在结果标题下方显示已记录、当前和即将进行的步骤，并清晰标示等待揭示和已揭示结果的状态。请参阅进行中研究进度报告。 A/B 对比详情现在会以紧凑且带标签的行展示结果指标和已更改的设置，在窄屏和放大文本时也清晰易读。请参阅对比详情报告。

已保存的笔记本观察记录现在采用响应式卡片，分别呈现观察记录标识、记录的印象、完整笔记和可用操作。请参阅笔记本观察卡片报告。

在窄屏上，可折叠图库现在会显示全部七个实验的初始绘图；切换实验或调整工作区大小时，选择状态和键盘焦点都会保留。请参阅移动端实验预览图库报告。

当前绘图和参考绘图的说明现在会标明周围环境或立方体面提示，以及参考线是否可见，并且在常规、切换、滑动和聚焦视图中始终采用各自绘图的设置。请参阅绘图条件报告。

实时设置对比表现在会在窄屏上将参考值和当前值分别排列为易读的行，同时保留现有的对比方式和隐藏值行为。请参阅绘图更改报告。

当前绘图现在包含其印象提示词以及一个快捷方式，可打开调整控件并聚焦于已选或第一个印象选项。请参阅印象快捷方式报告。

印象选项现在包含“转到绘图”，补全了绘图与观察控件之间的键盘和触控操作路径。选项列也会适应狭窄空间和放大的文本。请参阅返回绘图报告。

放大的绘图现在会显示“已裁切视图”指示标记，旁边还提供直接“适应完整绘图”的快捷方式，即使检查控件已关闭也会显示。该快捷方式会恢复完整视图和键盘焦点，且不会更改已保存的实验数据。请参阅实时画框报告。

绘图操作现在采用更清晰的工具栏，包含带标签的图标、清晰可见的展开检查状态以及响应式间距。对比选择和关闭控件位于操作行上方，说明文字位于下方。请参阅场景工具栏报告。

实时绘图检查器现在会在紧凑的响应式面板中归类缩放和平移控件。查看提示可按需打开，放大时则会始终显示简洁的裁切提醒。请参阅检查器布局报告。

实验设置现在显示为独立的调整卡片，当前值更加清晰，并提供响应式精确值行和“重置”行，以及清晰可见的焦点和验证状态。请参阅调整卡片报告。

Perception Lab 现在提供带插图的实验选项、更清晰的绘图工作区、紧凑的已记录绘图控件，以及区分明确的结果和笔记区域，并适用于响应式布局和无障碍主题。请参阅视觉呈现增强报告。

使用聚焦实验，即可在近乎全窗口的 Perception 工作区中操作实时控件、笔记、匹配研究和固定对比。关闭该视图后，绘图会保留，键盘焦点也会返回工作区。请参阅聚焦实验增强报告。 Perception Lab 可从任一工作区将当前绘图导出为背景不透明的白色 2400 × 1440 PNG。导出会保留捕获的帧，并在研究或学习者上下文发生变化时安全取消。请参阅 PNG export enhancement report。

Perception Lab 为实时比较提供并排、全宽堆叠和固定切换视图布局。共享工具栏可在当前聚焦的工作区中使用，保留绘图的颜色和缩放比例，并确保深色主题下的比较表格清晰易读。请参阅 live comparison enhancement report。

滑动比较绘图可在同一视图中以相同缩放比例，将当前绘图与同一实验中的参考图进行比较。拖动分隔线，或使用 Arrow 键、Home 和 End；按钮可显示完整绘图，或将分隔线居中。此功能适用于两个工作区中的固定图钉、周边环境和起始视图比较，也支持手机。分隔线位置是本地视图偏好设置；已保存的数据和隐藏的测量值仍会受到保护。SVG 和 PNG 导出包含完整的当前绘图。请参阅 slide comparison enhancement report。

检查绘图新增 150%、200% 和 300% 放大倍率，并提供有限范围内的平移、方向控制和键盘导航。比较绘图会同步移动，包括滑动比较绘图。此视图适用于两个工作区，不会更改已保存的数据或完整导出内容，并会在重复研究时恢复为适应视图。请参阅 drawing inspector enhancement report。

绘图检查器现在包含当前绘图概览，并显示带轮廓的查看窗口。在缩略图中选择或拖动即可浏览放大后的细节，也可使用 Arrow 键和 Enter。比较视图会保持对齐，已保存的数据和完整导出内容也不会更改。请参阅 drawing overview enhancement report。

Perception Lab 支持直接输入数值，并可单独重置全部十三项实验设置。输入的值会在按 Enter 或失去焦点时应用；无效输入不会更改绘图，重复研究控件仍会锁定。请参阅 precision controls enhancement report。

现在，聚焦的 Perception 工作区会在空间允许时将控件放在绘图旁边，并提供绘图和控件之间的快速导航，以及放大文字的空间。通过选择器或 Previous/Next 控件浏览全部七项实验，同时保留各实验的设置和备注。浏览时，莫尔纹动画会暂停，并且会持续锁定，直到当前重复研究结束。请参阅 focused browsing enhancement report。

使用比较周边环境，以相同缩放比例查看两幅实时绘图，二者仅上下文不同。两个视图都会响应你的调整，保留尚未揭示的匹配值，并保留已保存的图钉。立方体需要面部提示；瓷砖和网格视图使用明确的标签。此比较适用于所有可用布局和两个工作区，并且在重复研究期间始终处于禁用状态。请参阅 surroundings comparison enhancement report。 免费的目测匹配活动现在从不同的起始状态开始，而不是从相等的绘图数值开始。新起始状态允许学习者重新进行一次匹配；使绘图数值相等则会明确恢复数值相等。两者都会清除之前的印象和揭示状态，同时保留笔记和周边环境。已保存的匹配数值和受控的重复学习起始状态都会保留。请参阅匹配起始状态增强报告。

尝试一项更改为咖啡馆墙面、模棱两可的立方体、莫尔纹和庞佐透视提供固定起始视图对比。学习者选择要探索的设置，捕获当前绘图，并比较自己的印象；更改计数会区分其所选设置与其他编辑。捕获莫尔纹时，会暂停在当前可见角度。临时起始视图使用现有的对比布局，保留已保存的图钉，并保留常规观察记录和导出内容。请参阅起始视图探究增强报告。

探究指南现在会显示所选设置的起始值和当前值，并可从指南和绘图中使用调整所选设置。还原所选设置仅将该设置恢复为捕获时的值；还原其他设置则保留所选更改，同时还原其他已更改的设置。笔记、印象、测量指南和固定起始视图都会保留。请参阅探究控件增强报告。

探究指南现在可以为咖啡馆墙面、模棱两可的立方体、莫尔纹和庞佐透视导出独立的探究报告。报告会以相同比例保留两幅绘图、所有设置、印象和完整笔记；测量指南差异会单独标出。报告会捕获可见的莫尔纹画面，可供阅读或打印，且不会更改实验或笔记本。请参阅探究报告增强报告。

庞佐透视新增了可调整的透视轨道，围绕两条等长线段。可对比周边环境、显示对齐的端点指南、捕获起始视图、还原单项探究设置，并导出可打印的探究报告。第七个实验现已在两个工作区和笔记本中提供。请参阅庞佐扩展报告。

已保存的观察记录现在提供查看观察记录功能，采用绘图优先布局，包含带标签的印象和笔记面板，以及已保存的设置；宽屏上还可使用全宽绘图选项。查看记录时会保留已保存的测量可见状态，并可导出独立、可打印的 HTML 报告，而不会更改当前实验或笔记本。请参阅已保存观察记录查看增强报告。

---

💚 SEL Hub（72 款互动工具）

SEL Hub 提供 72 款社会情感学习工具，与 CASEL 的核心能力以及 AlloFlow 扩展类别相契合，包括自我导向、内在探索、自我关怀和责任担当：

能力	工具
自我认知	情绪探索器、优势清单、日记、情绪调节区、成长型思维工作坊
自我管理	应对策略、目标与规划、正念、过渡
社会认知	换位思考、同情、文化探索者、挺身而出培训
关系技能	友谊建设者、冲突解决、社区、团队合作、修复性圆圈
负责任的决策	决策实验室、伦理推理实验室、公民行动与希望、安全、社交技能、倡导

亮点包括 成长型思维工作坊（脑科学、重新诠释引擎、名人成功故事、AI 成长教练、给未来自己的信）、修复性圆圈（5 种圈会类型，源自原住民传统，并配有发言物件）、伦理推理实验室（6 个当代困境、6 种伦理框架、利益相关者映射），以及 文化探索者（涵盖 80 多种世界文化，并支持 AI 深度探索）。

---

🔐 隐私与符合 FERPA 的部署

AlloFlow 的设计旨在让学校能够将学生数据保留在浏览器、教师设备或学校控制的基础设施中。是否使用云服务由用户明确选择，并取决于部署方式。

原则	实施方式
无需个人身份信息	工具不要求提供姓名、ID 或可识别身份的信息
设备端存储	大多数日常工作会保存在浏览器本地存储中，或作为下载的项目文件保存；实时会话的云端路径旨在避免持久保存学生记录
TeacherGate	临床工具、评分标准和答案密钥均隔离在教育工作者验证机制之后
本地语音/ASR 选项	桌面端可使用本地语音和转录路径；在可用时，Web 部署可回退到浏览器或本地选项
本地优先选项	AlloFlow Desktop 支持无需 Docker 的本地使用和同一房间内的 LAN 会话；Docker School Box 技术栈是可选的服务器/设备基础设施

对于使用 Google Workspace for Education 的学区：Canvas/Firebase 的覆盖范围和学生隐私义务取决于学区的账号、合同、数据保留设置和实际使用情况。AlloFlow 的设计旨在支持符合 FERPA 的部署，但最终是否合规应由学区/法律部门判定。

---

🏫 本地优先：桌面端和 School Box

截至 2026 年 8 月 1 日的状态： 对于教师笔记本电脑或个人工作站，推荐使用 AlloFlow Desktop 作为本地优先方案。它可在本地托管内置应用、管理密钥和本地 AI 设置、支持内置本地引擎，并可在无需 Docker 的情况下运行同一房间内的 Desktop LAN 会话。Docker School Box 技术栈仍是可选的服务器/设备方案，适用于学校自有设备、学区/服务器实验，以及更大型的气隙基础设施。

日常本地使用：

npm.cmd run desktop:check
npm.cmd run desktop:smoke
npm.cmd run desktop

可选的 School Box 服务器/设备测试：

# Clone the repository
git clone https://github.com/apomera/AlloFlow.git

# Start the optional Docker server stack
docker-compose up -d

可在本地运行的内容：

• AlloFlow Desktop — 内置应用托管、本地密钥、诊断、内置本地引擎、本地 ASR/TTS 设置和 Desktop LAN 会话
• 可选的 Docker School Box 技术栈 — 学校需要受管本地基础设施时，可提供 PocketBase、Ollama、Piper、SearXNG、Flux 和 Nginx 等服务器/设备服务
• LM Studio / Ollama / LocalAI — 适用于已在本地运行这些服务提供商的用户的兼容路径
• PocketBase — 可替代 Firebase 的本地数据库

硬件需求取决于本地模型和服务配置。请参阅 desktop/README.md、docker/README.md 和 DEPLOY_YOUR_OWN.md。

---

♿ 无障碍

AlloFlow 致力于满足 WCAG 2.2 AA，采用键盘优先的交互模式、自动化审计以及逐工具无障碍门槛。目前的证据包括一份临时版 v1.2 VPAT 和一项范围有限的 WCAG 2.2 审计；两者都不代表产品整体通过认证。对合规性敏感的部署仍应核验实际使用的工作流和导出内容。

• 阅读障碍字体 — OpenDyslexic、Lexend、Atkinson Hyperlegible
• 仿生阅读 — 将单词开头的字母加粗，帮助引导解码
• 语音选项 — 通过已配置的浏览器、云端、桌面或可选的本地语音引擎逐字跟踪
• 颜色叠层 — 提供桃色、蓝色、黄色色调，支持 Irlen 综合征用户
• 阅读标尺 — 跟随鼠标移动的行隔离条
• 高对比度和深色模式
• 语音听写 — 所有输入字段均支持语音转文本
• 键盘优先支持 — 核心导航和经过审计的工作流支持标准键盘交互；请参阅已发布的审计报告，并报告特定工具存在的差距

---

💵 真的免费吗？

**软件：**是的——依据 AGPL v3 免费开源。Gemini API 的使用费用取决于部署方式：

方式	软件费用	API 费用	所需条件
Gemini Canvas	无需支付 AlloFlow 许可费	受 Google 当前条款和配额限制	Google 账号；使用平台提供的无密钥方式
Firebase Hosting（Spark — 免费层级）	无需支付 AlloFlow 许可费	托管和 AI 提供商的使用受当前免费层级限制	Firebase 项目，以及安全配置的 AI 提供商接入方式
Firebase Hosting（Blaze — 按用量付费）	无需支付 AlloFlow 许可费	提供商和托管费用因使用量而异	适用于工作流用量较大的情况；请参阅 DEPLOY_YOUR_OWN.md，并核实提供商当前的定价
AlloFlow 桌面版	免费	使用本地引擎的费用为 $0；可选云端提供商	教师笔记本电脑或工作站；无需 Docker
学校盒子服务器（可选 Docker）	仅需硬件费用	使用本地模型的费用为 $0；可选云端提供商	学校自有的服务器或设备堆栈

---

🎯 与 UDL 的对应关系

每项功能都对应 CAST 的 UDL 指南：

UDL 原则	AlloFlow 工具
投入	冒险模式、Boss 战、谜题挑战、民主模式、符号探索、符号搜索、StoryForge、成长型思维工作坊、游戏化引擎
表征	分级文本、双语视图、带图标的术语表、STEM 实验室（152 个插件文件 / 152 个已注册 ID）、SEL 中心（72 个工具）、TTS（40 多种语言）、颜色叠层、仿生阅读、Symbol Studio AAC 板
行动与表达	写作支架、StoryForge、自动评分器、评分标准、口语流利度教练、听写、QTI 导出、Symbol Studio、报告撰写器、PDF 管道

---

📚 文档

资源	链接
🏫 管理员简介（面向学区）	AdminBrief.md
♿ 临时无障碍符合性报告（VPAT® 2.5Rev WCAG）	VPAT-2.5-WCAG-AlloFlow.md
♿ 当前 WCAG 2.2 审核	a11y-audit/WCAG-2.2-current-audit.md
♿ 历史 WCAG AA 审核	alloflow_wcag_aa_audit_report.md
📖 完整用户手册	AlloFlow Complete User Manual.md
教师指南（可搜索）	guide/index.html
教师指南（离线／打印版）	guide/offline.html
🖨️ 快速参考卡	QuickReferenceCards.md
🏗️ 架构概览	architecture.md
🚀 Firebase 部署	DEPLOY_YOUR_OWN.md
🔒 安全策略	SECURITY.md
🤝 参与贡献	CONTRIBUTING.md
🐛 报告问题	GitHub Issues

---

🔧 面向开发者

AlloFlow 采用中心辐射式架构——单个协调器组件（App.jsx / AlloFlowANTI.txt，当前部署副本约 31K 行）会按需动态加载大量模块和插件系列：STEM Lab（152 个插件文件／152 个已注册 ID）、SEL Hub（72 个工具）、BehaviorLens、Report Writer、Symbol Studio、Word Sounds、Student Analytics、StoryForge、Cinematic Studio（文档→视频）、AlloStudio、Open Groove Studio、Professional Development、Doc Pipeline、Games、AI Backend 等。模块由所选部署的静态资源主机提供；build.js 负责处理 URL 解析。有关架构规则，请参阅 CONTRIBUTING.md；有关完整技术概览，请参阅 architecture.md。

# Cloud deployment (Firebase)
cd desktop/web-app
npm install
npm run build
firebase deploy

# Desktop local runtime
npm.cmd run desktop:check
npm.cmd run desktop:smoke
npm.cmd run desktop

# Run clinical logic test suite (no dependencies)
node tests/clinical_tests.js

🧪 测试套件

AlloFlow 包含 117 项自动化测试，用于覆盖会影响实际学生服务的临床决策逻辑，包括评分算法、分类查找和数据转换。测试分为三个层级：

• 第 1 层（临床决策）： 分数分类（标准分和 T 分数）、百分位计算、PII 清理、RTI 层级分类、发展常模
• 第 2 层（学习跟踪）： 熟悉度评分、词汇增长级别、代号验证、Pearson 相关、目标线监控
• 第 3 层（数据质量）： 数学流利度基准、错误分析、文档流水线问题规范化、评估预设完整性

运行 node tests/clinical_tests.js 即可——无需依赖项，只需 Node.js。完整文档请参阅 tests/README.md。

---

🤝 参与贡献

欢迎贡献，尤其是新增 STEM/SEL 工具、无障碍改进、临床测试用例和更多语言支持。

1. 阅读 CONTRIBUTING.md，了解架构规则（中心辐射式模式、Cloudflare CDN 模块解析、插件模板）。
2. 阅读 architecture.md，了解完整技术概览。
3. 提交描述清晰的 PR，说明你的更改增强了哪项 UDL 检查点或临床工作流。

新贡献者可以快速完成的事项：

• 添加新的 STEM 工具（stem_lab/stem_tool_yourname.js）——独立运行，无需修改核心文件
• 添加新的 SEL 工具（sel_hub/sel_tool_yourname.js）——采用相同的插件模式
• 在 tests/clinical_tests.js 中添加临床测试用例（根据评估手册核对预期值）
• 为代表性不足的语言改进 ui_strings.js 中的 i18n 字符串
• 为现有游戏添加键盘导航
• 修复 GitHub Issues 上标记为 good first issue 的问题

---

📄 许可证与致谢

AGPL v3 — 采用强著作权传染性许可证，免费开源，支持将教育技术作为公共产品。

© 2026 Aaron Pomeranz, PsyD

由学校心理学家为教育工作者打造。
“差异化教学应成为常态，而非例外。”