芽芽成长 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、配对、备份和常见问题步骤见部署与设备安装。发布验证记录见部署验证记录。

扩展

• 制作内容包： 从内容包制作指南和 content/examples/hello-pack/ 开始，使用 schema 校验、资源署名、音频清单和 bundle 流程。
• 编写第三方插件： 阅读插件开发指南，插件 type 必须带点号命名空间，并遵守 @sprout/plugin-sdk 契约。
• 查看课程路线： 见96 节课程总览；路线源文件位于 content/packs/sprout-core/routes/_stages/。
• 家长使用： 见家长使用手册，内容按 6–17、18–23、24–29、30–36 月龄说明。

开发、测试与契约

根脚本与工作区脚本保持一致：

export pnpm_config_verify_deps_before_run=false
pnpm test
pnpm typecheck
pnpm content:typecheck
pnpm content:test
pnpm qa:verify

常用包级命令：

export pnpm_config_verify_deps_before_run=false
pnpm --filter @sprout/server typecheck
pnpm --filter @sprout/server test
pnpm --filter @sprout/server build
pnpm --filter @sprout/admin typecheck
pnpm --filter @sprout/admin test
pnpm --filter @sprout/admin build
pnpm --filter @sprout/player typecheck
pnpm --filter @sprout/player test
pnpm --filter @sprout/player build

开发任务和协作边界见 docs/dev/tasks/；最重要的契约入口是：

• packages/schema/src/*.ts：内容、路线、运行时和插件清单的数据事实来源。
• packages/plugin-sdk/src/types.ts：活动插件生命周期与 ActivityContext。
• packages/plugin-sdk/src/tokens.css：播放端与活动共用的视觉令牌。
• docs/dev/api.md：REST API。
• docs/dev/architecture.md：架构和所有权。
• docs/README.md：完整文档索引。

许可与素材署名

本仓库分为代码、原创内容和第三方素材三类许可，不能把整个仓库笼统地标成同一种许可证。

代码： apps/、packages/、scripts/、plugins/、deploy/、构建配置和 schema 代码按根目录 LICENSE 采用 MIT。

内容： content/packs/** 中的原创课程、路线、词库文本、原创歌词、打印卡文案、家长指引，以及 docs/curriculum、docs/guide、docs/research 等原创文字按 CONTENT-LICENSE.md 提供：个人、家庭、非商业教育使用免费并须署名；商业使用须事先取得书面授权。各内容包 manifest 的 license 字段与此保持一致。公开仓库、发布 ZIP、APK 和演示站均不含任何预录音频。

第三方： Fluent Emoji 按 Microsoft 的 MIT 许可，Lucide 按 ISC 许可，CDC 里程碑整理数据按其来源与仓库现有说明使用，自绘图形的 CC0 范围以各包 assets/sources.json 为准。完整汇总见 THIRD_PARTY_NOTICES.md 和各包的 LICENSES.md。

在 macOS 上运行 pnpm content:audio 只供个人非商业使用：生成文件和 audio/manifest.local.json 写入本地忽略路径，不进入公开 bundle、ZIP 或应用。公开发布应接入已获音频再分发授权的 TtsProvider 或真人录音，并按内容流水线文档补齐来源与许可。

新增图片、录音、视频、旋律或插件时，请同时更新内容包的 credits、LICENSES.md 或插件清单，不要把 custom 当作自动获得许可。

服务端可通过现有 TtsProvider 接入获授权声音；audio/manifest.json 的结构与文本 key 不变。详细接入、全量重配音及发布检查见内容流水线。

免责声明

芽芽成长是亲子共学和家庭活动安排工具，不是医疗设备、治疗工具或发育诊断工具。里程碑条目用于日常观察和与专业人员沟通，不用于给孩子打分、排名或下诊断；发现能力倒退或持续担忧时，请及时咨询儿科或儿保医生。

屏幕策略是结合研究和产品边界做出的家庭使用建议，不是对所有家庭都适用的医疗处方。家长始终可以关闭孩子侧屏幕内容，改用家长指引、打印卡、纸书、真实物品、歌唱和户外活动。