音愈空间（yinyunkongjian）

一个面向中小学音乐课堂的 AI 文生图小应用。基于 Model2App 工具包，调用沐曦 Token 资源包中的 flux-1-schnell 文生图模型，把「乐理知识」「乐器」「情绪」等音乐主题转化为治愈系插画。

本项目是 Model2App 的一次完整作品发布（research → design → build），保留了提示词、工作流脚本、通用底座、模型资料、阶段成果和最终网页，供学习与复现。

目标模型

模型：flux-1-schnell（文生图，同步返回，约 15 秒）
接口：POST /v1/images/generations（经 api_runtime.py + model_adapter.py 封装）
底座：Model2App 通用底座（配置读取、参数表单、HTTP 请求、结果导出），已内置于成品

网页功能

首页「音愈空间」提供三个知识引导入口，点击卡片会在下方展开引导面板，而不是直接生成：

卡片	主题	引导内容
柔和水彩（乐理基础）	节奏、节拍、音阶	科普 + 引导问句 + 乐理相关水彩配图
童趣蜡笔（乐器组合）	钢琴 / 吉他 / 小提琴 / 架子鼓	各乐器音色特点 + 合奏搭配 + 乐器插画
极简线稿（音乐情绪）	低落 / 紧张 / 喜悦等情绪	情绪配乐知识 + 随机暖心寄语 + 情绪线稿

每个面板内都有【填入创作提示词】按钮：点击后把预设提示词与负向提示词填入输入框（只填文字、不自动生成），可继续修改后再点「生成配图」。生成过程中卡片和面板按钮会禁用。

目录结构

yinyunkongjian/
├── README.md              # 本说明
├── LICENSE                # 木兰宽松许可证 v2
├── .env.example           # 配置模板
├── .gitignore             # 排除密钥、依赖、结果与备份
├── requirements.txt       # 依赖
├── model2app.py           # 入口（research / design / build / serve）
├── prompts/               # 四个阶段提示词（研究/设计/生成/修复）
├── scripts/               # 工作流脚本（通用底座 + 各阶段命令）
├── templates/             # 通用底座模板
└── workspace/
    ├── input/             # 模型 API 资料
    ├── artifacts/         # 学习笔记、设计需求、生成记录、问题记录
    ├── design-preview/    # 设计阶段静态预览
    └── web-project/       # 最终成品（FastAPI + 静态前端）

安装与启动

需要 Python 3.12+ 与沐曦 Token 资源包的访问令牌。

# 1. 创建并激活虚拟环境
python -m venv .venv
.venv\Scripts\activate

# 2. 安装依赖
python -m pip install -r requirements.txt

# 3. 配置令牌（不要提交真实配置）
copy .env.example .env.local

编辑 .env.local，填写 GITEE_AI_TOKEN、GITEE_AI_BASE_URL、GITEE_AI_PACKAGE_ID。

# 4. 启动已保存的成品（无需重新生成）
python model2app.py serve

按终端显示的地址打开网页（默认 http://localhost:3000），保持终端运行，`Ctrl+C` 停止。点击「生成配图」才会调用目标模型并消耗额度。

重新制作（可选）

更新 workspace/input/模型API资料.md 与 prompts/02-设计应用提示词.md 后，依次执行：

python model2app.py research
python model2app.py design
python model2app.py build

素材声明

场景预设卡片缩略图：以 Base64 内嵌于 static/index.html，无需联网即可显示。
场景参考图来源（仅展示，不提交给接口）：Unsplash 摄影师 Cristofer Maximilian、Kenneth Li、Hikerwise.com，详见页面「场景参考」标注。

已知问题

应用默认只监听本机（127.0.0.1），无账号鉴权与限流，不适合直接作为公开服务部署。
生成依赖远程模型额度；异步任务可能受网络与限流影响。

许可证

本项目遵循根目录 LICENSE（木兰宽松许可证，第 2 版）。发布源码不等于部署上线，请勿在公开服务中使用真实密钥或开放给陌生人。