知序学习 / 题内 AI 导师 / 本地开发接入

把孩子的具体疑问，
交给真正的 AI 回答。

原型已提供自由提问、多轮追问、解题步骤补充和讲解方式选择。服务端已准备 GPT 与 DeepSeek 的调用适配；未配置时只显示连接状态，不使用预设答案充当 AI 回复。

现在可以体验什么

  1. 在原型中进入“举一反三”、独立订正或到期复习。
  2. 点击“我有疑问，问问 AI”，写下疑问，可补充已经做到哪一步。
  3. 配置服务后，AI 会结合题目、已填答案、思路和最近对话生成回答；可以继续追问、换说法或请求完整讲解。
  4. 没有配置或请求失败时，问题保留，可以重试；不会给出虚构的实时回复，也不记录为获得解题帮助。
当前提供本机开发服务，尚无生产账号、家庭授权、付费管理与多设备数据同步。先使用原创样题与模拟作答验证。真实儿童数据处理必须满足所选供应商与适用地区条件，不能仅凭配置成功判断可以上线。

第一步：启动本机服务

需要 Node.js 20 或以上。终端进入本文件所在目录，运行：

node server.mjs --port 4173

打开 本机学习原型。未设置供应商、模型和密钥时，页面显示“尚未连接 AI”。模型密钥仅从启动进程的环境变量读取；不会自动读取 .env 文件。

如果端口已占用，先停止你原来启动的本地预览服务，再运行 Node 服务；也可换用另一个端口。浏览器记录按访问地址隔离，更换端口前可先在“我的”导出学习记录。

第二步：配置一个供应商

先在供应商开放平台确认账号、实际服务地区、数据处理条件与可用模型。模型 ID 必须来自自己的可用列表；下列中文模型名称是占位说明，运行前需要替换。每次修改环境变量后重新启动服务。

DeepSeek · macOS zsh 示例

export TUTOR_PROVIDER=deepseek
export TUTOR_MODEL="替换为支持对话和JSON输出的模型ID"
read -s "DEEPSEEK_API_KEY?输入 DeepSeek API Key: "
export DEEPSEEK_API_KEY
node server.mjs --port 4173

这里调用 Chat Completions 与 JSON mode，按当前请求和对话动态生成回答。密钥通过不回显的输入读取，不写进网页或命令中的明文参数。具体接口见 DeepSeek 官方接入文档。

OpenAI / GPT · macOS zsh 示例

export TUTOR_PROVIDER=openai
export TUTOR_MODEL="替换为支持Responses与结构化输出的模型ID"
read -s "OPENAI_API_KEY?输入 OpenAI API Key: "
export OPENAI_API_KEY
node server.mjs --port 4173

这里调用 Responses API 与 JSON Schema 输出。代码中的 store:false 不等于已实施 Zero Data Retention。低龄儿童个人数据处理和实际服务地区的前提见 供应商接入条件及 OpenAI 未成年人指南。

不要将密钥写入 index.html、tutor.js、浏览器存储或学习记录。当前只使用选定的一家供应商；故障时不会自动把对话转发给另一家。

第三步：验证一轮真实答疑

用样题询问“为什么这里可以这样拆开”，再追问“还是不明白，能举生活中的例子吗”。检查回答是否针对本题、是否承接上一轮，以及自己没有填写的步骤是否被模型误当成事实。页面显示“已配置”仅说明配置项齐全，第一轮成功回复才代表此次调用完成。

检查点预期表现
不同的具体疑问通过真实 API 生成针对性回答，不从客户端答案表匹配。
继续追问带上最近对话和已补充的思路；历史超过长度预算时只保留最近完整轮次。
只有澄清或无法判断要求补充必要信息，不能算已经提供解题帮助。
已展示解释或思路反馈记录帮助曝光，影响后续同题的独立判定；不倒改已提交作答。
关窗、切题或停止取消当前等待，旧回复不显示到新题；未发送问题在本次页面保留。
出错或未配置显示服务状态、保留草稿；没有固定教学回答作为降级替身。

传递的数据与当前边界

请求只包含当前题目、年级学科、已有关联知识说明、参考答案与解析、学生填写的答案和思路、当前问题及最近对话。自录参考答案标为未经独立核验；照片、全部错题本和私人反思笔记不会自动发送。

答疑对话保存在当前页面内存，刷新后清除。本地服务不将对话写入文件或数据库；供应商侧的数据处理依其实际条款与账户设置，不能据此推断供应商也不保存。浏览器会保存帮助曝光记录，用于之后的独立作答判定。

本地限制为仅监听 127.0.0.1、同源访问、每分钟最多 20 个推理请求、最多 2 个并发、请求正文 64 KB、单次服务端等待约 30 秒。它们用于开发验证，不能替代生产环境的账户权限、用户配额和成本控制。

这次未执行真实付费推理。已用受控模拟响应检查两种供应商协议、异常分支、前端多轮上下文、切题取消、草稿与学习证据。正式启用后仍需用所选模型评估数学准确性、解释适龄性、提示类型分类和追问质量。