feat: align teacher guidance with persistent discussion tools

This commit is contained in:
鲨鱼辣椒
2026-09-23 22:44:23 +08:00
parent 404cfcde46
commit 847a752dba
8 changed files with 362 additions and 10 deletions

View File

@@ -167,7 +167,10 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
- 老师讨论采用“上方固定整理内容、下方独立滚动对话、底部原有输入框”的布局。普通回答可带直接发送的引导问题;想法板、结构图、流程/条件图和逐项对照由同一次模型回复提供结构化数据。先邀请学生“用这个一起想”,进入后程序锁定信息结构,老师随讨论更新同一份内容;解释问题可仅回复文字。节点点击只选择讨论焦点,对照里的“聊聊这一点”直接发问,都保留输入草稿。
- 想法板区分已留下、老师建议和暂放内容,可由学生采纳、暂放、选择先想哪项。“把想法理一理”明确转换为老师归纳的结构图,并可“回去补充想法”。“只聊天”暂停整理,“先这些”暂时结束并保留未确定内容,“接着改”恢复原工具;这些操作只影响老师讨论,不创建项目分支、不执行作品修改。状态、版本和历史快照按当前账号/项目/话题保存。
- Main 校验结构、引用和内容长度,拒绝未经学生选择的类型变更与旧版本更新。结构化回复在完整校验后一次应用;生成中显示简短处理状态,停止、失败或无效组件保留上一份内容,不展示模型原始 JSON。现有旧纯文本、主动关心、朋友和运营预览保持兼容。
- 老师保留运营发布的提示词、文本教学 Skills、模型和原生思考选项。首期朋友使用同一发布版本的模型、预算与启停配置,采用独立的体验交流提示词,不继承老师 Skills;具体教学方向和角色提示词后续另行讨论。两者均只读取按预算截取的当前操作对话已完成分支文本及明确引用,不运行工具,也不能声称实际看到了画面或试玩过作品。Main 直接调用既有计费网关,不创建 Pi worker。
- 老师教学基线由 Main 的 `electron/coding-teacher/behavior-prompt.ts` 接入 `compileTeacherContext`,适用于普通咨询、快捷求助、主动关心及运营预览。面向 6–14 岁学生,通过创作培养自主构思、产品与结构化思考、AI 协作、有依据的判断和改进;按当前困难提供适量建议与解释,不强制固定步骤,不做演示或项目执行。运营发布的身份、提示词补充、已启用文本 Skills、模型、预算与原生思考选项仍保留;无需另装教学 Skill。朋友继续使用独立体验提示词,不加载这份教学基线或老师 Skills。
- 每轮格式由 Main 的对应意图协议决定;`discussion.ts` 为支持组件的请求注入唯一 `{reply, quickReplies, tool}` 协议。运营教学补充不另写字段协议或要求始终纯文字。工具内讨论保留类型、稳定 ID、未修改内容和采纳状态;暂停/未进入时 `tool:null`,没有实质变化时也可保留原内容。结构图、流程和对照目前没有独立的采纳/来源字段,待定、建议与预测只能在展示文字中明确,不能据此推导已确认共识。
- 当前实际输入仍是按预算截取的所选操作对话已完成分支文本、明确引用、师生历史和适用的当前组件;未实现全量操作上下文读取或向操作 Agent 注入师生共识。“先这些”仍仅结束本轮整理,保留各条目状态,不确认全部候选、不自动制作。提示词不宣称这些系统能力已接通,也不声称看过未提供的画面或试玩过作品。Main 直接调用既有计费网关,不创建 Pi worker。
- `tests/fixtures/teacher-guidance-examples.json` 提供宠物、种植、射击、蛋糕的人工多轮输入输出样例,由真实解析器、上下文编译器与讨论状态机校验;样例不加载到运行时,也不代表真实模型教学效果已验收。云端定义仍需在运营端核对、保存草稿和发布;本地代码修改不会自动改写云端配置或学生已有话题的固定发布版本。
- 咨询话题及未发送草稿按当前云端账号、项目与角色分别保存;切换操作对话仍延续该项目下的咨询,每轮发送时绑定当时的操作对话来源。创建话题时固定发布版本,每轮重新检查启停。关闭面板或切换会话不取消已接受的问题,退出账号会中止。请求先落盘再调用模型,同一请求标识不重复发送,重启后未完成请求标记中断。没有操作对话时也可咨询,但无操作文本上下文。
- 删除操作对话会停止正在使用该来源的回复,保留项目级咨询历史;归档来源需先恢复后才能引用。原有来源会话级老师 API 与存储保持兼容,原路径历史不自动迁移到新项目级咨询栏。运营草稿试聊仍使用 `niancode://coding-teacher/preview?draft_revision=N` 打开独立示例上下文,不读取学生项目,要求桌面当前账号具有运营权限。