# 使用说明（网页版）

## 这是什么

一个写歌的工具：**写歌词 → 生成旋律 → 编配伴奏 → 播放 / 导出 MIDI**。

- 全程在你的浏览器里计算，没有服务器参与，不上传、不收集任何内容（AI 写词除外，见下）
- 不用注册、不用安装，打开网址就能用
- 歌词和作品自动保存在**你自己这台电脑的浏览器**里，关掉网页也不会丢

## 四步用法

### ① 写主旨与歌词

- **主旨可以留空**：只要你填了歌词，程序会自己从歌词里推断情绪、曲风、标题
- **曲风 / 情绪也可以选「自动」**，同样由歌词推断（比如歌词里有说唱段，会自动偏向摇滚律动）
- 歌词按段落填：先选段落类型（主歌 / 预副歌 / 副歌 / 说唱 / 桥段 / 前奏 / 尾奏），再填这一段
- 已经有整首歌词？点「📋 粘贴整首歌词（自动切段）」，或者**直接粘到某个段落框里**，
  程序会按 `【主歌】``【副歌】``【说唱】``Verse``Chorus``Bridge` 这类标记自动拆成多段
  （带全角空格、行首编号、`1.` `②` `第3段` 这些写法都能认）
- 每段可单独改类型、上下移动、删除
- 不会写词？点「📖 作词辅助」拿韵脚表和意象词参考（**不替你写词**，保证作品是你自己的），
  写完点「🔍 押韵检查」看每句末字的韵母和韵部是否统一

### ② 生成旋律

点「🎵 生成原创旋律」，会得到：

- **通俗版（逐字对齐）**：一行歌词一行谱，每个字上方标音级数字、下方标唱名（do re mi）。
  不懂五线谱也能照着唱，**一个字都不少**
- **简谱**：按小节的数字谱，每小节标出和弦
- **五线谱**：给专业人士看的规范谱面（需要联网加载一次谱面组件）

可以「🎲 换个旋律」重投（换一个随机种子）；也可以复制给出的**种子**，以后用同样的参数复现同一首歌。
「⬇ 简谱文本」「⬇ MusicXML」可以下载，MusicXML 能导入 MuseScore / Sibelius 等制谱软件。

### ③ 编配伴奏

- 选曲风（流行抒情 / 民谣 / 摇滚 / 华尔兹 / 国风 / 说唱律动），会自动给一份对应的默认编制
- 乐器可多选，共 38 件（键盘、吉他贝斯、打击乐、弦乐、管乐、民族乐器、合成器）；
  标了「特色」的写法与通用伴奏不同（比如古筝的刮奏、失真吉他的强力和弦），按需勾选
- **每小节的和弦可以改**：输入 `C` `Am` `G7` `Fmaj7` 这类写法都会被识别

### ④ 播放与导出

- 点「▶ 播放」**立刻出声**：默认用网页内置的合成音源，不需要下载任何东西，手机上也不会卡在加载上
- 播放键会变成「⏸ 暂停」，再点继续；「■ 停止」回到开头
- 有进度条（可以拖动跳到任意位置）、时间显示，以及当前播到第几小节、属于哪个段落
- 右边有总音量；表格里每条轨有「静音 / 独听」，**播放中改动立刻生效**，被静音的那一行会变灰划线
- 快捷键：空格 = 播放/暂停，← → = 后退/前进 5 秒
- 想要更真实的音色，勾选「**高音质音源**」再播放：会去下载采样音源（首次几 MB，之后走浏览器缓存），
  界面上会显示正在下载哪件乐器；下载失败或超时会自动退回内置音源
- 「⬇ 导出 MIDI（多轨）」得到标准 MIDI 文件，可拖进任何音乐软件继续编曲

> 手机上听不到声音时，先检查侧面的静音开关和媒体音量；iOS 需要先点一下播放键（浏览器要求由用户操作来解锁音频）。

## 关于原创性

- **旋律**由算法生成：动机 → 模进发展 → 乐句拱形 → 终止式，只用通用乐理构件
  （音阶、三和弦、级数进行、节奏型），不检索、不引用任何曲库素材
- **词曲同步生成**：先按歌词音节定乐句节奏，再在调式与和弦框架内配音 ——
  不存在"旧曲填新词"的适配过程，程序也不提供这个功能
- 每次生成都会给出「创作档案」：生成参数、随机种子、旋律指纹（音程序列哈希）、
  可唱性检查、歌词重合度。可以打印留档，用来证明创作过程
- 提示：程序不联网查曲库，所以它证明的是「生成过程不引用外部素材」，
  **不等于"世上不存在相似作品"**。商用前建议另行做专业版权检索

## AI 写词（可选）

点「🤖 用 AI 写词」，在弹出的设置里填你自己的接口地址、模型名和 API Key（支持任何 OpenAI 兼容接口，
如 DeepSeek / 智谱 / 月之暗面）。Key 只存在你这台电脑的浏览器里。

- 提示词里带了硬约束：禁止引用、改写、拼接任何已发表作品的歌词、诗句、名言、网络成句，
  禁止模仿特定词人风格
- 浏览器直连接口可能被对方的跨域策略（CORS）拦下。真遇到会明确提示 ——
  这时用「📖 作词辅助」自己写就好，其它功能都不受影响
- 不填 Key 也能用全部其它功能

## 常见问题

**关掉网页会丢东西吗？**
不会。歌词、参数、最近的作品都存在你这台电脑的浏览器里（localStorage）。下次打开会自动恢复上次的草稿，
也可以在「最近的作品」里点「继续编辑」。

**换电脑 / 换浏览器还能看到吗？**
看不到。作品只存在原来那台电脑的浏览器里 —— 这也是它不上传你内容的原因。想带走就导出 MIDI / MusicXML。

**为什么识别乐谱图片的入口不在网页版？**
乐谱识别（把图片变成可编辑乐谱）依赖 Python 的识别模型，跑不进浏览器，所以留在桌面版软件里。

**网址能收回吗？**
能。发布者双击「收回Cloudflare网址.bat」选 2 就会删除项目，网址立即永久失效。