feat: added i18n support; added Simplified Chinese support

public/chat/help-zh_cn.md

@@ -0,0 +1,126 @@
+## 帮助
+
+欢迎使用 **K.G.Studio Musician Assistant**。这是您的 AI 音乐创作与编曲助手，可以帮助您构思、编排和修改音乐内容。
+
+您可以选择使用 **内置本地浏览器 LLM**（无需 API Key），也可以配置外部 LLM 提供方。下面是常用的入门方式。
+
+---
+
+### 使用本地 LLM（浏览器）——无需 API Key
+
+K.G.Studio 可以通过 WebGPU 在浏览器中直接运行 **Gemma 4 E4B**。不会产生外部 API 调用费用，数据也不会离开您的设备。
+
+1. 进入 **设置 ⚙️ → 通用 → LLM 提供方**，选择 **本地 LLM（浏览器）**（默认选项）。
+2. 第一次打开聊天时会自动下载模型（约 2.8 GB），后续会缓存在本地浏览器中。
+3. 可选设置 **上下文长度**（32k / 64k / 128k tokens）；越大越占显存。
+4. 现在就可以开始聊天，无需 Key、账号或持续联网。
+
+**要求：** Chrome 113+ 或 Edge 113+，安全上下文（HTTPS 或 localhost），以及至少 8 GB 显存的 GPU 或至少 16 GB 统一内存的系统。
+
+> 注意：本地模型效果无法与 GPT 或 Claude 这类商业模型完全相比。复杂任务通常更适合外部提供方。
+
+---
+
+### 配置外部 LLM 提供方
+
+进入 **设置 ⚙️ → 通用 → LLM 提供方**。根据所选提供方，您需要填写对应的 API Key，以及在需要时填写 Base URL（例如 Ollama、OpenRouter 等 OpenAI 兼容服务）。
+
+---
+
+### 使用 OpenAI GPT 系列
+
+1. 在 [**OpenAI**](https://platform.openai.com/account/api-keys) 获取 API Key。您可能需要先注册账号并添加支付方式。
+2. 在 **设置 ⚙️ → 通用 → LLM 提供方** 中选择 **OpenAI**。
+3. 在 **OpenAI → 密钥** 中填入 API Key。
+4. 在 **OpenAI → 模型** 下拉中选择模型。若希望在成本和效果之间取得平衡，推荐 `gpt-5.4-mini`。
+5. 可选：在 **OpenAI → Flex 模式** 中启用 Flex Mode。它可能降低成本，但也可能带来更高延迟或更多服务端错误。
+
+---
+
+### 使用 OpenRouter
+
+OpenRouter 提供统一接口，可访问多个语言模型提供方的模型，其中也包含免费选项，适合比较不同模型表现。
+
+1. 在 [**OpenRouter**](https://openrouter.ai/keys) 获取 API Key。需要注册；使用付费模型时可能还需要绑定支付方式。
+2. 在 **设置 ⚙️ → 通用 → LLM 提供方** 中选择 **OpenAI 兼容服务**。
+3. 在 **OpenAI 兼容服务 → 密钥** 中填入 API Key。
+4. 在 [**OpenRouter Models Page**](https://openrouter.ai/models) 浏览可用模型，并可使用 “Prompt Pricing” 过滤免费模型。  
+   **注意：** 各模型提供方的数据保留与隐私策略可能不同，使用前请自行查看。
+5. 在 **OpenAI 兼容服务 → 模型** 中填入模型名。推荐系列包括：
+   - `Anthropic: Claude Sonnet 4.6`（`anthropic/claude-sonnet-4.6`）—— Claude 系列里质量和成本平衡较好
+   - `Qwen: Qwen3.5-35B-A3B`（`qwen/qwen3.5-35b-a3b`）—— 推荐开源模型
+   - `Qwen: Qwen3-Next-80B-A3B`（免费：`qwen/qwen3-next-80b-a3b-instruct:free`）—— 推荐免费模型
+   - `OpenAI: GPT-OSS 120B`（免费：`openai/gpt-oss-120b:free`）—— 推荐免费模型
+   - 注意：免费模型会经常变化，请以 OpenRouter 模型页中的 **Prompt Pricing** 过滤结果为准
+   - 注意：免费模型提供方可能会收集您的数据，使用前请先查看模型页面说明
+6. 在 **OpenAI 兼容服务 → 基础 URL** 中填写 `https://openrouter.ai/api/v1`。
+
+### 基本 DAW 操作
+
+聊天命令：`/clear`、`/welcome`、`/help`、`/hotkeys`
+
+- 音轨
+  - 在轨道信息面板中添加、重命名和重排音轨。
+  - 通过乐器按钮（钢琴图标）切换乐器；可调整 Solo（S）、Mute（M）和 Volume。
+  - 通过音轨设置菜单删除音轨（位于乐器按钮右侧）。
+  - **音频录音**：点击工具栏里的 Rec 按钮，可直接从麦克风录到音频轨。
+
+- 区域
+  - 创建区域：使用 Pointer 工具时可双击，或按住 Ctrl/Cmd 再点击；使用 Pencil 工具时单击即可。
+  - 移动/缩放：拖动区域主体可移动，拖动边缘可调整长度。
+  - 通过区域左上角的小铅笔打开钢琴卷帘窗口。
+
+- 钢琴卷帘（MIDI 音符）
+  - 工具：Select 与 Pencil。
+  - 创建音符：在 Select 模式下双击或 Ctrl/Cmd+点击；在 Pencil 模式下单击。
+  - 选择音符：单击；Shift+单击多选；拖拽框选。
+  - 移动/缩放：拖动音符主体可移动已选音符；拖动边缘可调整长度。
+  - **五线谱视图**：可在钢琴卷帘工具栏中切换钢琴卷帘与五线谱视图。支持自动谱号、调号显示、连音线和符杠分组。启用 **Track Scope** 后会连续显示整条 MIDI 音轨上的内容。
+  - **自动化轨道**：可在下方自动化区域绘制和编辑 Pitch Bend 与 MIDI CC 曲线（Modulation、Breath、Volume、Expression、Sustain）。
+  - **频谱模式**：可在钢琴卷帘中查看音频区域的频谱，作为 MIDI 编辑参考层。
+  - **事件列表面板**：提供 Notes / Pitch Bend / Controller 标签页，用于查看并内联编辑当前 MIDI 区域中的事件。
+  - 可通过 X 或 ESC 关闭钢琴卷帘窗口。
+
+- 智能和弦助手
+  - 在钢琴卷帘工具栏中使用 `⊘`、`T`、`S`、`D` 启用和弦指导。
+  - 和弦候选会根据播放头当前位置的有效调号来推断：大调使用 Ionian，小调使用 Aeolian。
+  - 将鼠标悬停在任意琴键上时，会以红色高亮显示上下文相关的和弦建议。
+  - 按 `g` 循环切换和弦指导模式，按 `Tab` 切换到下一个候选和弦，按 `Shift+Tab` 切换到上一个。
+  - 双击（或 Ctrl/Cmd+点击）高亮和弦可一次性创建整组音符。
+  - 和弦长度会自动匹配您最近编辑的音符长度，以保持节奏一致。
+
+- 全局轨系统
+  - 时间线上方固定有四条轨道：**Marker**、**Tempo**、**Key Signature**、**Chord**。
+  - 创建全局区域：在全局轨中双击或 Ctrl/Cmd+点击；拖动可移动，拖动边缘可调整长度。
+  - 这些轨道会影响播放时序、和弦指导、五线谱调号显示，以及和弦检测结果。
+
+- 音频分析功能
+  - **Detect Chords**：在音频区域打开钢琴卷帘窗口后，点击 **...** → **Detect Chords**，即可自动分析并把结果写入全局 Chord Track。可配置灵敏度、稳定性和七和弦检测。
+  - **Detect Tempo**：在音频区域打开钢琴卷帘窗口后，点击 **...** → **Detect Tempo**，即可分析 BPM，并可选择自动对齐项目中的 Tempo Track。
+
+- K.G.One 音乐生成器
+  - 点击工具栏中的 **✦**（魔杖）按钮打开生成器面板。
+  - **Full Song Generation**：根据文本描述和可选歌词生成整首歌曲（需要 K.G.One 服务器）。
+  - **Clip Generation**：根据文本提示生成短音频片段和 MIDI loop（需要 K.G.One 服务器）。
+  - **Stem Separation（浏览器）**：可完全在浏览器中把任意音频区域分离成 stems，无需服务器。支持两种模型：**UVR-MDX-NET-Inst_HQ_3**（2 stem：Vocals / Instrumental，约 64 MB）和 **Demucs htdemucs_4s**（4 stem：Vocals / Drums / Bass / Others，约 172 MB）。在生成器面板中下载模型后，点击 **Separate Stems** 即可。需要 WebGPU（Chrome 113+ / Edge 113+）。
+
+- 吸附与量化
+  - 在右上角的 NO SNAP 菜单中设置吸附。
+  - 使用 Qua. Pos.（起始）和 Qua. Len.（长度）进行量化。
+
+- 播放与播放头
+  - 工具栏可回到开头，并执行 Play/Pause。
+  - 在主时间网格点击小节编号可设置播放头；在钢琴卷帘中点击顶部时间轴也可设置，并遵守当前吸附设置。
+  - BPM、拍号和调号都可以通过工具栏中的数值直接调整。
+
+---
+
+### 说明
+
+出于安全考虑，在非本地主机场景下，K.G.Studio 默认不会把 API Key 持久化到 IndexedDB 中（以降低 XSS 风险）。您每次打开 K.G.Studio 时都需要重新输入。若您确实需要在非本地主机场景下持久化，请在设置中启用 “Persist API Keys on Non-Localhost”（不建议在共享或生产环境下启用）。
+
+### 免责声明
+
+K.G.Studio 不提供也不托管上述任何模型，也不隶属于任何模型提供方。所有数据默认都保存在您的本地设备中；您向第三方模型提供方发送的任何数据，都由您自行负责。
+
+祝您使用 K.G.Studio Musician Assistant 创作愉快！

public/chat/hotkeys-zh_cn.md

@@ -0,0 +1,59 @@
+## 快捷键
+
+本指南列出了当前在 K.G.Studio 中已经实现的键盘快捷键，以及部分点击时配合修饰键的操作。
+
+### 平台相关的创建操作
+
+- 在 **macOS** 上，使用 Pointer 工具时按 `Cmd+click` 可创建区域、音符或自动化点。
+- 在 **Windows/Linux** 上，使用 Pointer 工具时按 `Ctrl+click` 可创建区域、音符或自动化点。
+- 在主时间线中，Pointer 工具激活时双击空白处可创建区域。
+- 在钢琴卷帘与自动化轨中，Pencil 工具支持单击创建。
+
+### 主快捷键
+
+- `Space` — 播放 / 停止
+- `C` — 切换循环
+- `R` — 开始 / 停止录音
+- `Cmd/Ctrl+Z` — 撤销
+- `Cmd/Ctrl+Shift+Z` — 重做
+- `Cmd/Ctrl+C` — 复制所选项目
+- `Cmd/Ctrl+V` — 粘贴
+- `Cmd/Ctrl+S` — 保存项目
+- `Cmd/Ctrl+A` — 选中当前 MIDI 区域中的全部音符
+- `Cmd/Ctrl+T` — 在播放头处分割所选区域
+- `Cmd/Ctrl+J` — 合并选中的 MIDI 区域
+
+### 区域与钢琴卷帘窗口快捷键
+
+- `E` — 为选中的 MIDI 区域打开钢琴卷帘窗口，或为选中的音频区域打开波形编辑器；如果编辑器已经打开，`E` 会关闭它。
+- `N` — 以五线谱视图打开选中的 MIDI 区域。
+- `Delete` / `Backspace` — 删除选中的区域、音符或自动化点。
+- `Esc` — 关闭钢琴卷帘窗口。
+
+### 选择操作
+
+- `Shift+click` — 加入当前选择。
+- 在空白区域套索拖拽 — 框选区域或自动化点。
+- 在钢琴卷帘窗口中 `Shift+套索` — 切换套索范围内项目的选中状态。
+
+### 钢琴卷帘快捷键
+
+- `G` — 循环切换和弦指导模式
+- `Tab` — 跳到下一个和弦候选
+- `Shift+Tab` — 跳到上一个和弦候选 / 转位
+
+### 钢琴卷帘吸附快捷键
+
+- `1` — 不吸附
+- `2` — 吸附到 `1/4`
+- `3` — 吸附到 `1/8`
+- `4` — 吸附到 `1/16`
+
+### 钢琴卷帘量化快捷键
+
+- `5` — 起始量化到 `1/4`
+- `6` — 起始量化到 `1/8`
+- `7` — 起始量化到 `1/16`
+- `8` — 长度量化到 `1/4`
+- `9` — 长度量化到 `1/8`
+- `0` — 长度量化到 `1/16`

public/chat/welcome_again-zh_cn.md

@@ -0,0 +1,11 @@
+## 再次欢迎
+
+很高兴再次见到您。检测到您的 LLM 提供方已经配置完成，现在可以直接开始聊天。
+
+提示：
+- 随时输入 `/clear` 重置当前聊天。
+- 输入 `/welcome` 再次查看这条欢迎消息。
+- 输入 `/help` 查看帮助说明。
+- 输入 `/hotkeys` 查看快捷键指南。
+
+祝你在 K.G.Studio Musician Assistant 中创作顺利。

public/chat/welcome_local_llm-zh_cn.md

@@ -0,0 +1,29 @@
+## 本地 LLM 模式
+
+欢迎使用 **K.G.Studio Musician Assistant** 的本地 LLM 模式。
+
+- 无需外部 API 调用。所有内容都直接在您的浏览器中运行，不会产生额外 API 成本。
+- 此模式通过 **LiteRT-LM** 和 **WebGPU** 加速运行 **Gemma 4 E4B**。
+- 推荐硬件：至少 **8 GB 显存**的 GPU，或至少 **16 GB 统一内存**的系统。
+- 相比更大的云端模型，本地模式在复杂规划、长链路编辑和多步骤任务上能力会更有限。
+
+### 推荐工作方式
+- 保持请求小而明确。
+- 分步骤引导模型逐步完成目标。
+- 尽量针对较小的音乐区域工作，而不是一次处理整首歌。
+- 优先选择更简单的音乐编排。
+- 每个独立任务尽量开启新的对话。
+
+示例：
+- 对较复杂的请求，建议拆成多个小步骤。
+- 例如，如果您想让模型基于当前音乐写一段和弦进行，可以先说：`请读取当前音乐。`
+- 等这一步完成后，再继续说：`请基于它写一段和弦进行。`
+- 在本地 LLM 模式下，这种渐进式流程通常更可靠。
+- 在整个流程中，保持您希望 agent 更新的 MIDI 区域处于选中状态。
+- 仅仅为了执行 `read_music`，您不需要切换到别的区域，因为 `read_music` 可以读取所有音轨的音乐内容。
+
+### 改用外部 LLM
+- 如果您想使用更大的云端模型或自托管模型，请打开 **设置 -> 通用 -> LLM 提供方**，切换到 **本地 LLM（浏览器）** 以外的提供方。
+- 如果要用云端模型，可以选择 **OpenAI**，或者选择 **OpenAI Compatible** 并填写 OpenRouter 等提供方。
+- 如果要用自托管模型，也请选择 **OpenAI Compatible**，然后填写你的服务器 **Base URL** 和 **Model**。
+- 切换提供方后，建议开启一个新的对话，以便聊天会话干净地使用新模型。

public/chat/welcome_new-zh_cn.md

@@ -0,0 +1,25 @@
+## 欢迎
+
+欢迎使用 **K.G.Studio Musician Assistant**。这是您在浏览器中的 AI 音乐创作与编曲助手。
+
+### 快速开始
+**配置 K.G.Studio Musician Assistant**
+- [点击这里获取免费的 OpenRouter API Key](https://openrouter.ai/keys)（您可能需要一个 OpenRouter 账号）。
+- 进入 **设置 ⚙️ → 通用 → LLM 提供方**，选择 **OpenAI 兼容服务**。
+- 在 **OpenAI 兼容服务 → 密钥** 中粘贴您的 Key。注意：在非 localhost 环境下，Key 默认不会持久化，刷新后需要重新输入，请妥善保管。
+- 在 **OpenAI 兼容服务 → 模型** 中输入 `qwen/qwen3-30b-a3b:free`。注意：非免费模型可能需要计费。
+- 在 **OpenAI 兼容服务 → 基础 URL** 中输入 `https://openrouter.ai/api/v1`。
+
+*（或者，您也可以使用官方 OpenAI API，或者任何 OpenAI 兼容服务。）*
+
+**基本 DAW 操作**
+- 在音轨上双击（或按住 Ctrl/Cmd 再点击）可创建区域。
+- 拖动区域边缘可调整长度；拖动区域主体可移动。
+- 点击区域左上角的小铅笔可打开钢琴卷帘窗口。
+- 在钢琴卷帘中，双击（或 Ctrl/Cmd+点击）可创建音符。
+- 单击选择；Shift+单击多选；拖拽框选。
+- 拖动音符边缘可调整长度；拖动音符主体可移动所选音符。
+- 使用钢琴卷帘工具栏右上角的 Snapping 控制网格量化。
+
+### 免责声明
+K.G.Studio 与任何 LLM 提供方均无隶属关系。所有数据默认都保存在您的本地设备中；您发送给第三方服务的数据由您自行负责。