12 KiB
12 KiB
快捷输入格式规则 v3.0
支持更灵活的输入方式，适应课后快速记录场景
🎯 输入原则（新版）
极简输入，AI智能理解
- 教师只需提供关键词和关键事实
- AI自动理解语境、补充细节、规整格式
- 支持口语化、碎片化、无序化输入
- 接受语音转文字、手写速记、随手记录
- 自动纠正谐音姓名（如"良心桥"→"梁昕乔"）
核心目标：让教师以最自然的方式记录，AI负责后续整理
🔊 语音输入特别说明
谐音姓名自动纠正
问题：语音输入时姓名可能被识别为谐音
- "梁昕乔" → "良心桥"、"亮新巧"
- "钟昀昊" → "中云浩"、"钟运好"
- "张宇" → "章鱼"、"张瑜"
解决：AI自动匹配班级学生名单进行纠正
- 高相似度（>90%）：自动纠正，不打扰
- 中相似度（70-90%）：生成前提示确认
- 低相似度（<70%）：要求重新输入
示例：
教师语音输入："良心桥今天搭了三层"
AI处理：
1. 识别疑似姓名"良心桥"
2. 匹配班级名单：梁昕乔（相似度100%）
3. 自动纠正为"梁昕乔"
4. 查询画像小名："乔乔"
5. 课评输出："乔乔今天搭了三层..."
✨ 支持的输入方式
方式1：极简一句话（最自由）
特点：任意格式，AI自动解析
示例1：口语化
小明今天开始不敢碰，后来主动搭了三层，球卡住自己调高度，挺稳定的，比上周主动多了
示例2：碎片化
梁昕乔 快速启动 搭3层 自己加装饰 情绪好 创意突出
示例3：无序关键词
观望5分钟，主动尝试，自己调整，情绪稳定，比上周好，小明
示例4：语音转文字风格
呃...钟昀昊啊，今天上课啊，就是慢热，观察了一会儿才开始，然后搭了三层，反复调整，情绪挺稳定的
方式2：自然对话式（推荐）
特点：像和同事聊天一样描述
示例：
今天梁昕乔表现挺好的，一上课就进入状态了，搭了3层还自己加了装饰，情绪很开心，和之前一样主动
钟昀昊呢，还是老样子，慢热型，观察了5分钟才开始，不过后来搭得挺稳的，反复调整了几遍，最后完成了
AI自动识别：
- 学生姓名（梁昕乔、钟昀昊）
- 关键行为（快速启动、搭3层、加装饰）
- 情绪状态（开心、稳定）
- 对比信息（和之前一样）
方式3：列表速记（半结构化）
特点：无序列表，无需严格格式
示例1：简单列表
- 小明
- 开始不敢碰管道
- 后来主动搭3层
- 球卡住自己调整
- 情绪稳定
- 比上周进步
示例2：混合关键词
小明：观望→主动→3层→调整，稳定，比上周好
小红：全程专注，5层+弯管，开心，帮助旁边人
小强：换玩法多，没完成，兴奋转烦躁，需引导
方式4：表格简化版（批量）
特点：极简表格，不要求对齐
示例：
小明 观望5分钟 搭3层 自己调 稳定 比上周好
小红 全程专注 5层加弯管 开心 帮助人
小强 换玩法 没完成 烦躁 需引导
豆豆 独自玩球 没搭 开心 社交需引导
AI自动转换为规整表格
方式5：分段描述（详细）
特点：按时间/环节分段，自由描述
示例：
【小明】
导入阶段：坐着看其他小朋友玩
探索阶段：第6分钟开始尝试
搭建阶段：能搭3层直管
调整阶段：球卡住自己调高度
情绪：整体稳定
亮点：比上周主动多了
方式6：极简符号速记（专业用户）
特点：用符号快速编码
符号对照：
→ 表示行为发展/时间线
+ 表示正面/进步
- 表示需关注/问题
↑ 表示情绪积极
↓ 表示情绪消极
? 表示疑问/不确定
! 表示亮点/惊喜
示例：
小明：观望5m → 主动3层 → 自调 ↑ + 比上周!
小红：专注全程 → 5层+弯管 ↑↑ + 助人!
小强：频换玩法 → 未完成 ↓ 需引导
🔍 AI智能解析规则
自动识别要素
| 要素 | AI识别方式 | 示例 |
|---|---|---|
| 学生姓名 | 首词/大写/冒号前 | "小明"、"梁昕乔" |
| 关键行为 | 动词+数量/结果 | "搭3层"、"自己调" |
| 情绪状态 | 情绪词/表情描述 | "开心"、"稳定"、"烦躁" |
| 对比信息 | 时间词+比较 | "比上周"、"和之前" |
| 课程信息 | 上下文/历史记录 | 自动推断 |
模糊匹配
行为词模糊匹配：
| 教师输入 | AI理解 | 标准输出 |
|---|---|---|
| 不敢碰/不敢动/犹豫 | 观望型 | "开始有些犹豫" |
| 主动/积极/马上 | 主动型 | "主动尝试" |
| 自己弄/自己搞/自己调 | 自主解决 | "自己调整" |
| 搭了3层/做了三层/堆了3个 | 完成3层 | "搭了3层" |
情绪词模糊匹配：
| 教师输入 | AI理解 |
|---|---|
| 开心/高兴/笑/兴奋 | 积极情绪 |
| 稳定/平静/正常 | 平稳情绪 |
| 低落/不开心/烦躁 | 消极情绪 |
| 先好后差/开始可以后来不行 | 情绪波动 |
💡 输入优化建议
最少有效信息
只需提供：
- 学生姓名（必须）
- 一个关键行为（必须）
AI会自动：
- 匹配课程信息
- 推断情绪状态
- 对比历史表现
- 生成完整课评
极简示例：
小明：主动搭了3层
AI输出：
小明今天学习了互锁结构，能主动尝试并搭了3层...
[基于画像的完整课评]
推荐信息量
| 场景 | 建议输入 | 效果 |
|---|---|---|
| 最省时间 | 姓名+1个行为 | 自动生成 |
| 常规记录 | 姓名+2-3个行为+情绪 | 个性化强 |
| 重点关注 | 姓名+详细表现+对比 | 深度定制 |
🚫 不推荐的输入方式
虽然系统会尽力理解，但以下方式可能影响质量：
| 不推荐 | 原因 | 建议替代 |
|---|---|---|
| 纯数字代码 | 无上下文 | 加姓名或关键词 |
| 过于省略 | 信息不足 | 至少一个行为 |
| 完全乱序 | 难以解析 | 大致按时间顺序 |
| 错别字过多 | 理解困难 | 常用拼音即可 |
🔄 输入示例大全
示例1：口语化输入（推荐）
教师输入：
呃，小明啊，今天上课一开始不敢碰，就坐着看，后来我看他开始动了，搭了大概三层吧，然后那个球卡住了，他就自己调了一下高度，情绪还挺稳定的，比上周好一些，上周是完全不敢碰的
AI解析结果：
- 学生：小明
- 行为：观望→主动搭3层→自己调整
- 情绪：稳定
- 对比：比上周进步（上周完全不敢碰）
示例2：碎片化输入
教师输入：
梁昕乔 快速启动 3层 加装饰 开心 和之前一样
AI解析结果：
- 学生：梁昕乔
- 行为：快速启动→搭3层→加装饰
- 情绪：开心
- 对比：和之前一样
示例3：无序关键词
教师输入：
稳定，自己调整，观望5分钟，主动尝试，比上周好，小明
AI解析结果：
- 学生：小明
- 行为：观望5分钟→主动尝试→自己调整
- 情绪：稳定
- 对比：比上周好
示例4：批量简化
教师输入：
周四19点 DISC-003
小明 观望5分 搭3层 自调 稳定 比上周好
昕乔 快速 3层 加装饰 开心 一样
昀昊 慢热 3层 反复调 稳定 渐入佳境
AI解析结果： 自动识别为批量模式，生成3份课评
示例5：详细描述
教师输入：
【李怡瞳】四年级 AI03
今天学Prompt编写
开始比较慢，观察别人
后来能写简单指令
遇到困难主动问
情绪平和
初学阶段正常
AI解析结果：
- 学生：李怡瞳
- 年级：四年级
- 课程：AI03
- 行为：观察→写简单指令→主动求助
- 情绪：平和
- 状态：初学阶段
📝 输入模板速查
模板1：最简版
[姓名]：[一个行为]
模板2：常规版
[姓名]：[行为1]，[行为2]，[情绪]，[对比]
模板3：自然版
今天[姓名][表现描述]，[情绪]，[对比]
模板4：批量版
课程：[代码]
[姓名1] [表现1] [情绪1]
[姓名2] [表现2] [情绪2]
🎯 与旧版对比
| 维度 | 旧版（v2.0） | 新版（v3.0） |
|---|---|---|
| 格式要求 | 较严格 | 非常灵活 |
| 输入方式 | 5种固定格式 | 任意自然语言 |
| 口语支持 | 有限 | 完全支持 |
| 容错性 | 中 | 高 |
| 智能解析 | 关键词匹配 | AI语义理解 |
| 推荐场景 | 规范记录 | 快速随手记 |
✅ 使用建议
不同场景推荐输入方式
| 场景 | 推荐方式 | 示例 |
|---|---|---|
| 边走边记 | 极简一句话 | "小明搭3层自己调" |
| 语音输入 | 自然对话式 | "小明今天表现很好..." |
| 课后整理 | 列表速记 | "- 小明 - 搭3层 - 开心" |
| 批量生成 | 简化表格 | "小明 搭3层 开心" |
| 重点关注 | 分段描述 | "【小明】导入...探索..." |
黄金法则
- 有姓名 → AI知道是谁
- 有行为 → AI知道做了什么
- 其他随意 → AI自动补充
记住：没有固定格式，说人话就行！
📦 存储位置（双轨制）
新增：确认后同时保存到两个位置
| 存储位置 | 用途 | 文件路径 |
|---|---|---|
| 班级周汇总 | 集中查看当周全班表现 | memory/class-evaluation-summary/第X周/{班级}.md |
| 个人历史课评 | 追踪学生完整成长轨迹 | memory/student/{班级}/{学生名}/历史课评记录.md |
数据流转
教师输入 → AI生成 → 【等待确认】 → 确认后双轨保存
↓
┌──────────┴──────────┐
↓ ↓
班级周汇总.md 个人历史课评.md
使用场景
- 班级周汇总：周回顾、备课参考、批量发送家长群
- 个人历史课评：一对一家长沟通、学期总结、成长档案
📞 常见问题
Q：我写得乱，AI能懂吗？
A：能！只要包含姓名和关键行为，AI会自动理解并规整。
Q：语音转文字很多错别字怎么办？
A：没关系，AI能根据上下文推断。关键是发音清晰的动词和名词。
Q：忘记写课程信息怎么办？
A：AI会从历史记录或上下文中自动推断。
Q：批量输入需要严格对齐吗？
A：不需要！用空格或制表符分隔即可，AI会自动整理。
Q：补课/体验学生怎么处理？
A：详见 33-first-class-rules.md 新学生与补课学生处理规则。
Q：体验课学生不想建档怎么办？
A：直接回复「跳过」或「仅保存到班级汇总」。课评会保存在 class-evaluation-summary/第X周/{班级}.md 中，标记为体验学生，不影响后续正式学员的档案管理。
版本历史
| 版本 | 日期 | 更新内容 |
|---|---|---|
| v3.2 | 2026-04-16 | 新增补课/体验学生处理说明：说明无档案学生的检测、提醒和可选保存方式 |
| v3.1 | 2026-04-15 | 新增双轨存储说明：确认后同时保存到班级周汇总和个人历史课评，便于集中查看和追踪成长 |
| v3.0 | 2026-03-26 | 大幅增强格式包容性，支持任意自然语言输入 |
| v2.0 | 2026-03-26 | 新增单个/批量生成方式 |
| v1.0 | 2026-03-25 | 初始版本，5种固定格式 |
新版本核心理念：用最自然的方式记录，让AI处理格式