Tutor Runtime Lab 是一个 Pi-native 学习导师 runtime。它把对话、引用、练习、研究、视觉表达、学习书和协作写作组织为任务级 capability，并通过一个统一的 AgentHarness 处理模型调用、工具授权、事件流、失败恢复和持久化。
项目当前适合本地研究、原型开发和架构评估，不是托管服务，也不提供教学效果保证。
要求：
- Node.js
22.19.0或更高版本； - Corepack；
- Linux、macOS 或 WSL。Windows 原生环境尚未验证。
corepack enable
pnpm install --frozen-lockfile
./scripts/dev.sh启动完成后打开 http://127.0.0.1:3000。默认模式：
- 不读取 API Key；
- 不访问外部模型；
- 不产生费用；
- 自动创建一个本地演示工作区；
- 支持自由输入、流式事件、任务隔离和重启恢复。
默认回答来自明确标识的确定性 simulator，用于体验 runtime 行为，不代表真实模型能力。详细步骤见 零基础上手指南。
- 单一逻辑 Tutor Agent 与任务级 session/context 隔离；
- source-bound Chat/Solve 与可回读 citation；
- Question、Quiz、Mastery、Notebook 和 Evidence Memory；
- Research、Visual 和受控 Manim sandbox；
- Book、Page、CoWriter、diff、apply、undo/redo；
- PGlite 持久化、content-addressed object store 和 canonical runtime events；
- Provider budget gate、tool grant、幂等与恢复合同；
- Fastify API、Next.js Web 和响应式三栏工作区。
公共默认 composition 只开放零费用自由对话 demo。其他模块的领域实现和测试保留在源码中，但真实 Provider composition 仍需要调用方自行完成凭据、模型兼容性、费用和数据边界审查；仓库不会默认发起付费请求。
# 本地启动 Web + API
./scripts/dev.sh
# 公共发行所需的构建、类型和测试检查
./scripts/verify.sh
# 只构建 API
corepack pnpm --filter @tutor-runtime-lab/api... build本地状态与日志位于 .local/，不会提交到 Git。按 Ctrl+C 会同时停止 Web 与 API。
- 默认只监听
127.0.0.1，不进行公网部署； - 演示数据应使用公开、合成或已去标识内容；
- 不要导入密钥、真实未成年人资料或无权使用的材料；
- simulator 结果不能用作事实、考试答案、医疗、法律或其他高风险判断依据。
原创源代码、配置和项目文档使用 Apache License 2.0。Vendored Pi packages 保留原 MIT License，详情见 NOTICE 与 THIRD_PARTY_NOTICES.md。