芽芽成长 Sprout

A gentle, parent-led learning companion for ages 6 months to 3 years.

官网 · 在线演示 · English README

芽芽成长是面向 6 个月–3 岁家庭的亲子共学工具：屏幕只做一个慢慢的引子，真正的学习发生在家长的回应、真实物品、游戏、阅读、歌唱和户外活动里。它不是电子保姆，也不以延长观看时长为目标。

项目适合在家庭局域网运行：一台 Mac、NAS 或小主机运行服务端，电视、iPad 或浏览器打开播放端，手机和电脑打开家长后台。没有服务器时，也可以使用播放端内置内容包离线体验。

先了解五件事

1. 真人互动优先于被动观看。 婴幼儿把视频内容迁移到现实世界并不容易；屏幕内容必须配合家长共看、提问、等待和回应。视频学习元分析 与本项目的循证综述是产品取舍的主要依据。
2. 6–17 月龄不给宝宝播放孩子侧课程。 这一阶段使用家长指引课、打印实体卡和真实物品；家长读完就放下设备陪玩。18–23 月龄共看默认关闭，24–36 月龄也可以完全不看，若开启必须由家长陪同。屏幕策略说明了中国指南、WHO 与 AAP 口径的差异。
3. 亲子对话比“听得更多”更重要。 看见孩子正在关注的东西，命名，停一下，接住目光、动作、手势或声音，再把话题放回生活。语言证据与 JAMA Pediatrics 屏幕使用综述支持把回合对话放在中心。
4. 中文自然交流是主干，英语是可选的互动补充。 双语不会因为同时存在就造成语言迟缓，但每种语言都需要真实、足量且自然的输入；不熟练的英语或录播音频不能替代高质量中文交流。双语与语言章节给出边界。
5. 数学从生活里的数量、空间和规律开始。 点一件、说一个，数完说总数；比较两组真实物品；在收拾、穿衣、拼图和摆放中说“里面、上面、旁边、再来一个”。不使用快速闪卡，也不把课程正确率当作能力诊断。数学启蒙章节列出了按月龄的活动建议。

这些原则不是医疗建议，也不承诺某节课会带来特定发育或学习结果。屏幕时间、睡眠、进食、身体活动和发育担忧请结合孩子实际情况，必要时咨询儿科或儿保专业人员。

功能一览

部分	能做什么
播放端	电视/iPad/浏览器播放课程；支持遥控器 D-pad、键盘和触屏；支持远程服务器与离线内置内容；按月龄提供家长模式、亲子共看、暂停、家长门和自然结束点。
家长后台	首次设置、孩子档案、语言模式、屏幕时段、今日计划、成长路线、课程库、打印实体卡、里程碑观察、设备配对、备份恢复。
内容包	sprout.core 内置 6 个阶段、96 节课程和 254 个词条；课程含家长导语、慢节奏步骤和线下延伸活动；内容可打包、校验、导入和升级。
活动插件	17 个内置活动，另支持带命名空间的第三方活动插件；插件必须遵守生命周期、焦点导航、资源、音频、权限和婴幼儿内容安全约定。

架构

flowchart LR
  subgraph LAN["家庭局域网"]
    Server["Mac / NAS / 小主机<br/>@sprout/server :4310"]
    API["/api/*<br/>REST + Swagger"]
    Packs["/packs/*<br/>内容包静态资源"]
    Plugins["/plugins/*<br/>插件静态资源"]
    Admin["/admin/<br/>家长后台"]
    Player["/<br/>播放端"]
    Server --> API
    Server --> Packs
    Server --> Plugins
    Server --> Admin
    Server --> Player
  end

  TV["电视浏览器 / Android TV"] --> Player
  IPad["iPad Safari / Capacitor App"] --> Player
  Family["手机 / 电脑浏览器"] --> Admin
  Player -->|RemoteSource：配对后的 device token| API
  Player -->|LocalSource：内置 sprout.core + 本地记录| Local["设备本地存储"]
  Admin -->|admin token| API

服务端使用 Node 22、Fastify 和 node:sqlite，默认监听 0.0.0.0:4310。播放端通过同一个 DataSource 抽象连接服务器或使用本地数据；后台和播放端都复用 @sprout/schema 的数据契约，排课与屏幕策略复用 @sprout/core。

完整边界、数据流和目录所有权见系统架构。

仓库结构

apps/
  server/                 Fastify 服务端、SQLite、静态文件托管
  admin/                  家长后台（Vite + React + Ant Design）
  player/                 大屏播放端与 Capacitor 工程
packages/
  schema/                 数据契约、Zod 校验、JSON Schema
  core/                   排课、屏幕时间、内容包运行时工具
  plugin-sdk/             活动插件运行时契约与视觉令牌
  activities/             17 个内置活动与 playground
content/
  packs/sprout-core/      内置词库、路线、课程、素材和音频
  milestones/             CDC 2022 里程碑整理数据
scripts/                  内容素材、音频、校验、bundle 和 zip 流水线
plugins/examples/         第三方插件示例
docs/                     研究、课程、开发、部署和家长指南
deploy/                   Docker、macOS 自启和发布检查

快速开始

环境

• Node.js >=22.12，当前项目验证版本为 Node 22。
• pnpm 11.1.0（根 package.json 的 packageManager）。
• macOS 上生成系统 TTS 音频需要可用的 say；没有音频时播放端会按“预生成音频 → Web Speech API → 文字”回退。

依赖已经随开发工作区准备好时，可以跳过安装步骤。全新工作区可运行：

corepack enable
export pnpm_config_verify_deps_before_run=false
pnpm install

生成内容与构建

内容源文件已经在仓库中；需要从源重新生成路线、素材、音频、校验结果和离线 bundle 时，在 macOS 上运行：

export pnpm_config_verify_deps_before_run=false
pnpm content:all --pack content/packs/sprout-core

content:all 依次执行 route → assets → audio → validate → bundle。它会改写生成的路线、音频和 bundle.json，不应在只想查看源码时随意运行。构建三个工作区应用：

export pnpm_config_verify_deps_before_run=false
pnpm build

构建不含预录音频的 GitHub Pages 演示站：

export pnpm_config_verify_deps_before_run=false
pnpm --filter @sprout/player build:demo

输出目录为 apps/player/dist-demo/，部署前缀为 /ai-study/demo/。演示版只使用内置 sprout.core 和浏览器本地存储，不连接家庭服务器。

启动已构建版本

export pnpm_config_verify_deps_before_run=false
pnpm start

然后打开：

• 家长后台
• 播放端
• API 文档

首次进入后台时设置家庭名、管理员密码、孩子名字、生日和语言模式。之后在播放端选择“连接家庭服务器”，在后台“播放设备”页输入播放端显示的 6 位配对码，并绑定孩子。配对码 10 分钟有效。

开发模式

服务端、后台和播放端分别运行；每个终端都先设置 pnpm 依赖检查环境变量：

# 终端一：服务端
export pnpm_config_verify_deps_before_run=false
pnpm --filter @sprout/server dev

# 终端二：播放端，http://localhost:5310/
export pnpm_config_verify_deps_before_run=false
pnpm --filter @sprout/player dev

# 终端三：后台，http://localhost:5311/admin/
export pnpm_config_verify_deps_before_run=false
pnpm --filter @sprout/admin dev

开发端口被占用时，按各包脚本支持的备用端口运行；结束验证后关闭由自己启动的服务。

电视与 iPad

电视浏览器或 Android TV 可以直接打开服务端根地址；Android TV 也可以安装 release APK。iPad 可以用 Safari 打开根地址并添加到主屏幕，或使用 Capacitor App。设备与服务器必须在同一家庭网络，电视端不能填写服务器的 localhost。

详细的 Mac、Docker、Android TV、iPad、配对、备份和常见问题步骤见部署与设备安装。发布验证记录见部署验证记录。

This is the beginning of the README. Read the rest at the original. Read the full README ↗