256 lines
18 KiB
Markdown
256 lines
18 KiB
Markdown
# 穹狼传奇 Qonnwolf Legend · 假期项目课程设计文档
|
||
|
||
> **文档性质**：课程总体设计（spec），是后续课程大纲与逐课教案的上层依据。
|
||
> **状态**：方向已锁定（经一轮 grill 拷问逐分支确认）。**12 天骨架为首版草案，待 Rocky 审核。**
|
||
> **版本**：v0.1 **日期**：2026-06-12 **作者**：课程运营助手 + Rocky
|
||
> **产品工作名**：《穹狼传奇·创世录》（命名待定，见 §18）
|
||
|
||
---
|
||
|
||
## 0. 一句话定义
|
||
|
||
> 上过 AICODE 的孩子，在 **穹狼传奇** 这个统一奇幻世界里，**各自设计一个原创游戏角色**（形象 / 动作 / 技能 / 设定），用 AI 生图出美术、用提示词驱动 AI 编出技能逻辑，最终全部汇入**一个共享的回合制对战游戏** + 一本**实体艺术设定集**，并办一场**线下展出**。
|
||
|
||
---
|
||
|
||
## 1. 定位与成功标准
|
||
|
||
**这不是一门"教新技术"的课，是一门"用已掌握的技能 + AI 生图，做一个有意义、能展示、点燃创作欲的大项目"的课。**
|
||
|
||
成功标准按优先级：
|
||
|
||
1. **创作欲第一**：熊孩子愿意来、想创作、愿意迭代。没有这个，其余都是空中楼阁。
|
||
2. **展示价值**：成品"绝不能 low"，能拿去招生、家长愿意发朋友圈。
|
||
3. **完整闭环（神圣不可砍）**：每个孩子**做完一个角色 → 能对战 → 进设定集 → 上展出**。
|
||
4. **教师可执行**：老师无游戏/美术经验，只能当 turnkey 系统的执行员。
|
||
5. **意义**：跨"学科/文化"味道靠世界观与角色设定承载，但不喧宾夺主。
|
||
|
||
**给家长的"学了什么"叙事**（不是新概念，是三个升级）：
|
||
- ① 学会 **AI 生图**（从没碰过，最出片）；
|
||
- ② 第一次把零散技能**拧成一个完整、有意义、能展示的大项目**（质变）；
|
||
- ③ **用提示词 + 企业级 workflow 驱动 AI 编程** + 跨角色团队协作。
|
||
|
||
---
|
||
|
||
## 2. 世界观与 IP（前置，非后挂）
|
||
|
||
- **统一世界观 = 穹狼传奇的奇幻世界。** 这不是装饰，而是"风格锁定 + 设定集连贯 + 展出像一个整体"的**硬依赖**——"一个世界"本身就是 IP，所以世界观必须前置定义，不能后挂。
|
||
- **角色定位**：孩子造的是"穹狼传奇世界的英雄 / 灵兽"，与公司**穹狼科创**、客户端**穹狼AI** 同源（"穹狼"品牌一脉）。
|
||
- **可选 IP 主角**：是否设一只**灵狼 / 灵兽**做世界图腾 / 向导、叫什么名字——**待定**（世界观细节，可后置，见 §18）。
|
||
- **系列延展**：每季（暑/寒假）= 世界的一个新地域 / 纪元，IP 自然生长。本期完整闭环，下期是新篇章而非烂尾续命。
|
||
|
||
---
|
||
|
||
## 3. 产品形态
|
||
|
||
> **分两期**：第一期 = 独立完整作品（本地双人对战）；第二期 = 在第一期基础上继续扩展（人机 / 冠军 / 难度 / 联机…）。
|
||
|
||
- **核心 = 图鉴 + 1v1 回合制对战。**
|
||
- **主界面 = 全角色图鉴**：所有角色排成墙，点任一 → 角色页（立绘 + 4 帧动作 + 属性 + 技能 + 背景故事 + **署名**）。**图鉴页 = 设定集页 = 展墙页（一鱼三吃）。**
|
||
- **对战 = 任选两角，1v1 回合制（手动选招）。** 复用并升级 AICODE-06「涂鸦PK」引擎。
|
||
- **本地双人同机**：键盘左右分区，两个孩子一台电脑对打。
|
||
- **人机冠军模式 → 第二期**（第一期不做）。
|
||
- **明确不做**：实时格斗。回合制是规避"逐帧动画 + 手感调校"两堵墙的关键，**键盘左右只是双人输入区，不是实时互殴**。
|
||
- **最小内容量**：一个班 6 人 → 至少 **2 个场景 + 6 个角色** 才玩得起来。
|
||
- **第二期扩展位**：**人机对战 + 冠军模式 + 难度递升**、联机对战、更多角色、更炫特效、新对战模式。
|
||
|
||
---
|
||
|
||
## 4. 工作室协作模型
|
||
|
||
- **单一工作室，跨所有班次**：上午班 / 下午班 / 所有班型的学生，**同属一个工作室、一个穹狼传奇正典**——一个游戏、一本设定集、一次展出。
|
||
- **人人有产权角色 + 署名**（创作欲与归属感的根）。
|
||
- **加挂工种**（学有余力者承担，可单人或双人小队）：
|
||
- 影像师 / 过场动画师 / 场景师 / **美术统筹**（盯风格一致性）。
|
||
- **差异化由此自然吸收**：手快的孩子角色做完 → 去加挂工种服务集体作品；慢的孩子专心打磨好自己一个角色，不掉队。
|
||
|
||
---
|
||
|
||
## 5. 三层架构（★ 全案核心）
|
||
|
||
| 层 | 谁做 | 内容 | 作用 |
|
||
|----|------|------|------|
|
||
| **层1 · 核心引擎** | 公司预建（Rocky）· 焊死 | 对战循环、平衡校验、通用 AI、风格管线、图鉴/页面框架 | 保"不 low"、保"永远跑得起来"，孩子不碰 |
|
||
| **层2 · 决策填充** | 孩子选 / 配 | 属性分配、角色形象、背景故事 | 创作决策（创作欲 + 取舍训练）|
|
||
| **层3 · AI 共创** | 孩子用 **Kimi** 驱动 AI 编 | **自定义技能✓、角色展示页✓**（必做）；被动、大招特效（加分）| Vibe Coding 真练习场 |
|
||
|
||
**画线尺子**：引擎兜住"易碎的、技术的、调手感的"；孩子握住"定义'我的角色'身份的每个决策与创造"。**检验：孩子会不会指着屏幕说"这是我的角色"？**
|
||
|
||
**层3 安全靠"隔离/沙箱化每个插件面"**：
|
||
- **角色展示页** = 天然隔离（崩了只伤自己那页）→ 最安全，放开编。
|
||
- **特效** = 装进带超时/容错的表现层（崩了跳过）→ 中等。
|
||
- **技能/被动** = 走"受限原语接口 + 自动评分封顶"（防"秒杀技"）→ 最难，是真正的引擎投资。
|
||
|
||
**铁律**：**层3 接口契约必须按 Kimi 的能力设计，并用 Kimi 实测**（不能用 Claude 验收）——课堂上孩子用的是 Kimi，接口要傻瓜到 Kimi 也能稳定填对。
|
||
|
||
---
|
||
|
||
## 6. 标准化角色框架与平衡
|
||
|
||
- **等额总分预算**：每个角色固定一样的总分（如 100），在属性 + 技能成本里分配。起跑线一致 = 基础公平。
|
||
- **属性相克三角**（石头剪刀布）：物攻克低物防、魔攻克低魔防、高速抢先手、高血肉盾……**纯堆一项打不了通关**，每个角色都有赢面、也被克制 → 没人是废物。
|
||
- **技能从预算买**：强技能贵，买了让出属性点 → 强制取舍（喂养"拆解/取舍"）。
|
||
- **引擎护栏**：每项属性上下限 + 总分校验，schema 自动拒绝非法配置。孩子**造不出破坏平衡的角色**；约束本身就是取舍课。
|
||
- **预期管理**：目标不是锦标赛级完美平衡（不可能），是"**人人可玩 + 无无脑碾压 + 每角色有一席之地**"。本地自选对局、不排名，进一步消解挫败感。
|
||
- *(具体属性项数 / 技能槽数 / 总分值，预生产时定，见 §18)*
|
||
|
||
---
|
||
|
||
## 7. AI 对战与难度（★ 第二期，第一期不含）
|
||
|
||
> 第一期只做本地双人对战，智能由真人提供、零 AI。以下人机与难度设计整体推到第二期。
|
||
|
||
- **通用回合制 AI 驾驶任意角色**：每回合读取角色属性+技能数据，按规则选招（血少防守/治疗、对面血少出强招、平时用性价比招）。**角色的"打法个性"来自孩子设计的数值与技能本身，不需逐角色写 AI** → 零额外授权工作量，100 角色即插即用。
|
||
- **回合制 AI 是最简单的一档**（有无限时间想、不需反应速度），与被否掉的"实时格斗 AI"两个量级。涂鸦PK 已做过"AI 对手 + 伤害公式"，非新风险。
|
||
- **难度递升 = 三个数字旋钮**：① AI 犯错率（越简单越爱走错）② 对手按总分从弱到强排序出场 / boss 加成 ③ handicap 让步。
|
||
- **可选**：孩子选"打法性格"预设（激进/防守/治疗/均衡）给 AI 调味（一个决策，非写码）。
|
||
- 人机模式**不需额外美术**，复用角色 4 帧动作。
|
||
|
||
---
|
||
|
||
## 8. 美术风格锁定（"不 low"第一杠杆）
|
||
|
||
- **风格基准 = 拳皇 / 街霸式 2D 精致格斗立绘 × 穹狼传奇奇幻世界**（《苍翼默示录》《罪恶装备》即奇幻格斗，二者兼容）。格斗立绘是单张精美图，正是 AI 生图主场，天然不 low。
|
||
- **风格是脚手架（焊死），不是孩子的选项。** 孩子自由在"角色是什么"，不在"画成什么风"。
|
||
- **锁定四层**：
|
||
1. **焊死的风格前缀 prompt**（每次生图自动拼上穹狼传奇画风描述）；
|
||
2. **固定参考图锚定**（"视觉圣经"喂给每次生成）；
|
||
3. **统一立绘模板**（构图/背景/尺寸一致，兜住微小漂移）；
|
||
4. **人工闸门**（美术统筹 + 老师审核，进正典前过审）。
|
||
- **"视觉圣经"由 AI 辅助定**（公司无现成美术）：一套画风 + 锁定的 prompt/参考图，且**实测能稳定出一致结果**——这是预生产实打实的任务。
|
||
- **预期**：层 1-3 把一致性做到八九成，最后一成靠层 4 人工闸门。**不存在全自动完美统一。**
|
||
|
||
---
|
||
|
||
## 9. 内容安全（防熊孩子）
|
||
|
||
- **不焊进程序**（gpt-image-2 自带安全为地板）。课堂上的随手生成，**老师口头约束即可**。
|
||
- **真风险不在课堂瞬间，在"被印进设定集 / 挂上展墙"的永久品牌脸面**；且无经验老师**尤其抓不住山寨 IP**。
|
||
- **机制零额外成本**：复用 §8 的人工闸门，把"傻瓜三问"扩成 **① 原创吗？② 适龄吗？③ 合风格吗？**——卡在"**入正典 / 入设定集**"时刻。课堂口头管，要印要展的过一眼人审。
|
||
- **"原创"立规并化成荣誉**：第一天立规"造穹狼传奇的原创角色，不抄现成的"，把原创包装成酷、被尊重的事。
|
||
|
||
---
|
||
|
||
## 10. 技术栈与工具
|
||
|
||
| 用途 | 选型 | 备注 |
|
||
|------|------|------|
|
||
| AI 生图 | **gpt-image-2** | 文生图 / 图生图 / 局部重绘 / 角色一致性 |
|
||
| 客户端 agent 大脑 / 课堂层3 | **Kimi K2.6 / DeepSeek**（带视觉识别）| 便宜、孩子驱动；接口须按其能力设计 |
|
||
| 动作 sprite | **agent-sprite-forge**（MIT）的"单图整组帧"提示法 + 对齐脚本 `generate2dsprite.py` | 纯 numpy+Pillow，Win10 核显可跑；**4 帧/动作上限**，回合制够用，复杂连招别强求 |
|
||
| 运行客户端 | **穹狼AI 客户端**（Electron + Pi agent，生图功能开发中）| forge 依赖客户端生图就绪 |
|
||
| 对战引擎 | 升级 AICODE-06「涂鸦PK」回合制引擎 | 已验证 territory |
|
||
| 框架开发 | **Claude Code / Codex 顶级模型**（Rocky solo）| 贵模型造框架一次性，便宜模型驱动课堂 |
|
||
|
||
- ❌ **不用 sprite-sheet-creator**（无 license 不能商用、已停维护），仅可参考其 UI 思路。
|
||
- ❌ **不上 3D**（粗糙 3D 比精致 2D 更 low，且用不上 AI 的 2D 美图）。
|
||
|
||
---
|
||
|
||
## 11. 教学法落地
|
||
|
||
- 遵循 **SDDT + 4C 四幕剧 + 六大能力**（见 `.claude/rules/`）。
|
||
- **核心循环每课至少一轮**：需求 → 生图/生成 → **审查** → 迭代。
|
||
- **第 1 课就产出**：靠预建引擎，孩子第一天就把自己的角色塞进真能玩的游戏 → 即时"哇时刻"，消灭入门空窗期。
|
||
- **ZPD**：从孩子已会的切入（他们做过涂鸦PK/数据驱动/需求文档），往未知（生图、自定义技能、项目级整合）延伸。
|
||
- **创作欲第一**：AI 生图的"一句话变出角色"魔法是核心引擎，整门课压在这个魔法上。
|
||
|
||
---
|
||
|
||
## 12. 12 天骨架（★ 首版草案，待 Rocky 审核）
|
||
|
||
12 天 × 约 2.5h ≈ **30 小时**。**完整闭环神圣**，排布反推着砍以保闭环装得进。
|
||
|
||
| 阶段 | 天 | 焦点 | 当天产出 | 核心能力 / 层 |
|
||
|------|----|------|---------|--------------|
|
||
| **一·入世界 + 角色雏形** | D1 | 进穹狼传奇世界 + 客户端上手 + 生出"我的角色"初版立绘，塞进 demo 对战看它打（哇时刻）；立"原创"规 | 角色初版立绘 + 已在 demo 里能打 | 提问力 / 生图 |
|
||
| | D2 | 角色形象打磨（图生图迭代、风格审查"像穹狼传奇吗/原创吗"）；视觉识别玩法（手绘→拍照→立绘）当亮点 | 定版角色立绘 | 审美力 / 层2 |
|
||
| | D3 | 角色动作（4 帧 sprite：idle/攻击/技能动作生图 + forge 拼接） | 角色会动 | 审美力 / 生图 |
|
||
| **二·让角色活起来** | D4 | 标准化框架 + 总分预算 → 属性分配（取舍训练），数值进对战实测 | 角色有数值、能正经对战 | 拆解力 / 层2 |
|
||
| | D5 | **自定义技能**（层3 Vibe Coding：写技能 mini-PRD → Kimi 生成 → 测 → 迭代）| 1 个能用的自定义技能 | 共创力 / 层3 ★ |
|
||
| | D6 | 技能迭代 + 平衡审查（相克三角，在对战里测强不强） | 技能定版、平衡过关 | 韧性力 / 层3 |
|
||
| | D7 | 大招 + 特效（层3：描述大招→生成特效→集成）；被动（加分/视进度） | 大招 + 特效 | 共创力 / 层3 |
|
||
| **三·包装 + 集成** | D8 | **角色展示页**（层3 HTML/CSS Vibe Coding，= 设定集页 = 图鉴页）+ 背景故事/人设撰写 | 角色展示页 + 设定文案 | 表达力 / 层3 ★ |
|
||
| | D9 | 集成 + 工种分工（快的孩子加挂音效/场景/过场）；本地双人对战联调 + 手感打磨 | 角色入正典 + 工种产物起步 | 共创力 / 协作 |
|
||
| | D10 | 全工作室集成测试（所有角色进同一游戏，互测、平衡微调、人审闸门入正典） | 可玩的共享对战游戏 v1 | 韧性力 / 协作 |
|
||
| **四·发布 + 展出** | D11 | 设定集定稿（数字页 → 印刷文件）+ 路演排练（讲设计思路/提示词/迭代过程） | 设定集印刷稿 + 路演稿 | 表达力 |
|
||
| | D12 | **发布会 / 线下展出**：大屏图鉴 + 现场锦标赛 + 实体设定集 + 路演 + 家长 | 最终作品 + 展出 | 表达力 / 全部 |
|
||
|
||
> **退路应用**：时间紧时按 §15 退路阶梯砍（先砍 D7 被动/特效，再压缩工种加挂层），**砍到只剩"角色做完→能双人对战→进设定集→展出"也成立、也不 low**。
|
||
|
||
---
|
||
|
||
## 13. 工种分工
|
||
|
||
- **底座（人人）**：角色设计师——自己角色的形象/动作/技能/设定。
|
||
- **加挂（学有余力，单或双人）**：影像师、过场动画师、场景师、美术统筹。服务"汇总成一个游戏 + 设定集 + 展出"的集体产物。
|
||
- 进度差异由"加挂工种"吸收，老师好 hold。
|
||
|
||
---
|
||
|
||
## 14. 设定集与线下展出
|
||
|
||
- **设定集 = 全工作室一本合订**（跨所有班次），**每孩子一页 + 署名**。数字角色页（层3 产出）= 设定集页源，导出印刷文件 → 实体书。
|
||
- **线下展出**：大屏轮播图鉴 + 现场可玩对战/锦标赛 + 实体设定集陈列 + **孩子现场讲解自己的角色** + 邀请家长。放在 12 天后。
|
||
- **展出是独立办一场，还是并入常规期末发布会**——灵活，开课前定（见 §18）。
|
||
|
||
---
|
||
|
||
## 15. 预生产工程（Rocky 的活）
|
||
|
||
**开发力量 = Rocky solo，用 Claude Code / Codex 顶级模型。** 这是全项目头号风险（不在课堂，在开课前半个月，且与"接生图进客户端"抢同一窗口）。
|
||
|
||
**脚手架清单（9 项）：**
|
||
1. 生图接进客户端 2. forge 封装（含对齐脚本） 3. 视觉圣经（AI 辅助定 + 实测稳定） 4. 对战引擎（图鉴 + 1v1 + 本地双人）〔人机 AI + 难度旋钮 → 第二期〕 5. 平衡 schema + 护栏 6. 技能接口（自动评分封顶，**按 Kimi 能力设计并用 Kimi 实测**） 7. 角色展示页模板 8. 设定集印刷模板 9. 老师傻瓜手册 + 培训
|
||
|
||
**MVS（最小可行脚手架）= "完整闭环"神圣不可砍。**
|
||
|
||
**退路阶梯（时间紧按序砍）：** 被动/特效层3 → 工种加挂层 → ……（砍到只剩闭环。人机/难度本就在第二期，不占第一期清单）。
|
||
|
||
**go / no-go 闸**：开课前 X 天，必须跑通**端到端 demo**（一个孩子用 **Kimi**：生角色 → 进对战打一场 → 出设定集页）。跑不通 → 砍 scope 或推期，**绝不带病开课**。
|
||
|
||
---
|
||
|
||
## 16. 成本与补贴
|
||
|
||
- **实验性头炮，公司补贴**：印刷成本、token/生图费用该补就补。
|
||
- **token 补贴 = 孩子可放开迭代生图**（利于审查/迭代训练与创作欲）。
|
||
- 打响后续期可提价。
|
||
- *待估*：每孩子生图预算（采购规划，非课堂限制）。
|
||
|
||
---
|
||
|
||
## 17. 风险登记
|
||
|
||
| 风险 | 等级 | 应对 |
|
||
|------|------|------|
|
||
| 预生产半个月做不完（solo + 抢生图窗口）| 🔴 高 | MVS + 退路阶梯 + go/no-go（§15）|
|
||
| 生图功能延期 | 🔴 高 | go/no-go 推期；闭环优先 |
|
||
| 层3 用 Kimi 不稳、孩子挫败 | 🟠 中 | 接口按 Kimi 设计并实测；隔离沙箱兜底 |
|
||
| 风格不统一 → low | 🟠 中 | 视觉圣经四层锁定 + 人审闸门 |
|
||
| 山寨 IP / 不当内容印进设定集 | 🟠 中 | 入正典人审三问 |
|
||
| 平衡崩 / 有人角色总输 | 🟡 低 | 等额预算 + 相克三角 + 护栏；不排名 |
|
||
| 老师无经验 hold 不住 | 🟠 中 | 全 turnkey + 傻瓜手册 + 三问清单 |
|
||
|
||
---
|
||
|
||
## 18. 待定项
|
||
|
||
- [ ] **产品/课程正式命名**（工作名《穹狼传奇·创世录》）
|
||
- [ ] **灵狼 / 灵兽 IP 主角**：是否设、命名（世界观细节，可后置）
|
||
- [ ] 角色 schema 具体：属性项数、技能槽数、总分值（预生产定）
|
||
- [ ] 展出形式：独立办 vs 并入期末发布会（开课前定）
|
||
- [ ] 音效来源：AI 生成 vs 素材库
|
||
- [ ] 教师培训方案（傻瓜手册形态）
|
||
- [ ] 班型 / 人数 / 排期具体
|
||
- [ ] 每孩子生图预算估算
|
||
|
||
---
|
||
|
||
## 19. 下一步
|
||
|
||
1. **Rocky 审本文档**——重点审 **§12 的 12 天骨架**（首次成稿、你还没过目）+ **§18 待定项**。
|
||
2. 确认后 → 细化 **课程大纲**（第二层文档）。
|
||
3. 再 → 逐课 **教案**（第一层，逐字稿级）。
|
||
4. 并行：Rocky 启动 **§15 预生产**，先冲 go/no-go 的端到端 demo。
|