# AI 探险号 · 众包课程创作 Skill（第一阶段） > 用途：给贡献者复制生产相似风格的课程。目标不是让每个人随意写课，而是把 AI 探险号的“互动硬科普”方法复制到其他知识主题。 --- ## 一、课程主旨 每门众包课程都必须符合这句话： **把一个抽象知识点，变成孩子能亲手操作、看见机制、最后掌握术语的互动课程。** 不是： - 普通图文讲义 - 知识百科 - 选择题集合 - 换皮小游戏 - AI 自动生成的长文 ### 课程长度 一门众包课程建议做成 **1 个 C 章节 + 4-8 个 S 小节**。 - **4 个 S 小节是下限**：少于 4 节通常只能做“概念介绍”，很难形成“现象 → 机制 → 变化 → 边界/应用”的完整学习弧线。 - **5-6 个 S 小节最稳**：适合一次 8-15 分钟的儿童互动学习，既不单薄，也不拖沓。 - **7-8 个 S 小节适合复杂主题**：例如网络安全、机器人、气候变化、人体免疫这类需要多个机制拼起来的主题。 - **超过 8 节要拆课**：拆成两门课或两个 C 章节，不要让一个课程变成长讲义。 推荐节奏： ```text S1 现象入口：孩子先看见问题 S2 核心机制：第一次真正操作机制 S3 变量变化：换一个条件，看结果怎么变 S4 边界/误区：指出什么时候不成立、哪里会出错 S5-S6 应用/迁移：把同一机制用到新场景 S7-S8 综合挑战：只在主题足够复杂时使用 ``` --- ## 二、每节固定节奏 每个 S 小节必须包含 6 个块： ```text 1. heading：术语 · 一句话 2. hook：阿波开场对话 3. paras：大白话正文 4. ux：互动/动画组件 5. after：技术深入 6. close：体验后命名术语 + 收束 ``` 标准节奏： ```text 阿波抛问题 ↓ 正文解释机制 ↓ 互动可视化 ↓ after 加一层技术信息 ↓ close 用 [[术语]] 划线命名 ``` --- ## 三、文本规范 ### heading 格式： ```text 核心术语 · 一句话说明 ``` 例： ```text 暴力破解 · 一个个试出来 搜索空间 · 可能答案有多少 浮力 · 水把物体往上托 ``` 不要写： ```text 小秘密 有趣的密码 来玩一下吧 ``` ### hook 必须像阿波在和孩子说话。 好： ```text 阿波：如果小偷不知道密码，他能不能把所有可能都试一遍？ ``` 差： ```text 本节将介绍暴力破解的概念。 ``` ### paras - 1–3 句。 - 一句一意。 - 只讲直觉，不堆术语。 - 不要在这里下复杂定义。 ### ux 交互必须对应知识机制。 合格： - 密码强度 → 拖长度滑块，看组合空间变大。 - K 近邻 → 自己放点，看最近邻居投票。 - 注意力 → 连线变粗表示权重变大。 不合格： - 任何主题都做成接金币。 - 与知识点无关的 QTE。 - 只是点按钮看下一段文字。 ### after after 是全节技术密度最高的地方，必须“加一层”。 合格： ```text 密码强度本质上和搜索空间有关：可选字符越多、长度越长，组合数量会快速变大。 ``` 不合格： ```text 所以密码真的很重要，我们要保护好自己哦。 ``` 判据：删掉 after，读者会不会少懂一个机制点？不会就删。 ### close 必须出现至少一个 `[[术语]]`，让主阅读器自动划线解释。 例： ```text 你刚才看到的一个个试密码，就叫 [[暴力破解]]。所以好密码不是神秘，而是让搜索空间变大。 ``` --- ## 四、上传格式 第一阶段上传的是 JSON 课程包。 课程包结构： > 注意：下面只完整展示 1 个 S 小节对象的写法，正式提交时 `sections` 必须包含 **4-8 个同结构 S 小节**。 ```json { "schemaVersion": "1.0", "id": "internet-security-basic", "status": "lab", "title": "网络安全小侦探", "emoji": "🔐", "audience": "9-12", "sourceSkills": ["explain-skill", "viz-ux-skill"], "chapters": [ { "id": "password", "title": "密码 · 为什么不能太简单", "sections": [ { "id": "password-bruteforce", "heading": "暴力破解 · 一个个试出来", "hook": "阿波：如果小偷不知道密码，他能不能把所有可能都试一遍？", "paras": [ "很短的密码，可能组合很少。", "组合越少，机器就越容易一个个试完。" ], "ux": { "component": "labSlider", "props": { "title": "密码强度滑块", "hint": "拖动长度，看破解难度怎么变" } }, "after": [ "密码强度本质上和搜索空间有关：可选字符越多、长度越长，组合数量会快速变大。" ], "terms": { "暴力破解": { "s": "把可能的密码一个个试，直到试中。", "pro": "它不靠聪明猜测，而是消耗计算时间枚举候选；密码空间越大，成本越高。" } }, "close": "你刚才看到的一个个试密码，就叫 [[暴力破解]]。所以好密码不是神秘，而是让搜索空间变大。" } ] } ] } ``` --- ## 五、UX 设计总则 众包课程**只允许用 JSON 描述互动**，不允许上传 JS。主站会把 `ux.component + ux.props` 交给隔离的内置渲染器执行。 这样做的原因： - 投稿者不用写代码，也能生产互动。 - 课程包不会污染主站样式和脚本。 - 审核者可以只看 JSON 判断 UX 是否合规。 - 好作品归档时，可以把临时通用组件升级成专用组件。 ### 5.1 UX 必须解释机制 合格 UX 的判断不是“能不能点”，而是： **孩子操作之后，是否看见了知识点的因果机制。** | 知识内核 | 好 UX | 差 UX | |---|---|---| | 分类 | 把样本放进不同筐，放错有反馈 | 随便点按钮得分 | | 流程 | 信号/步骤沿箭头前进 | 点下一页看文字 | | 权衡 | 拖一个变量，结果实时变化 | 三个按钮分别显示三段解释 | | 关系 | 节点之间连线变粗/点亮 | 孤立卡片依次出现 | | 层次 | 一层层揭示结构 | 一次把所有文字堆出来 | ### 5.2 组件隔离规则 课程包只能写： ```json "ux": { "component": "labSort", "props": { "title": "信息分拣台", "hint": "先点卡片，再点正确的筐" } } ``` 不能写： ```json "ux": { "html": "