Xiaohan-Tian
8.6 KiB
幫助
歡迎使用 K.G.Studio 音樂創作助手。這是您的 AI 音樂創作與編曲助手，可以幫助您構思、編排和修改音樂內容。
您可以選擇使用 內建本地瀏覽器 LLM（無需 API Key），也可以設定外部 LLM 提供方。下面是常用的入門方式。
使用本地 LLM（瀏覽器）——無需 API Key
K.G.Studio 可以通過 WebGPU 在瀏覽器中直接運行 Gemma 4 E4B。不會產生外部 API 呼叫費用，資料也不會離開您的裝置。
- 進入 設定 ⚙️ → 通用 → LLM 提供方，選擇 本地 LLM（瀏覽器）（預設選項）。
- 第一次開啟聊天時會自動下載模型（約 2.8 GB），後續會快取在本地瀏覽器中。
- 可選設定 上下文長度（32k / 64k / 128k tokens）；越大越佔顯存。
- 現在就可以開始聊天，無需 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 系列
- 在 OpenAI 取得 API Key。您可能需要先註冊帳號並新增付款方式。
- 在 設定 ⚙️ → 通用 → LLM 提供方 中選擇 OpenAI。
- 在 OpenAI → 密鑰 中填入 API Key。
- 在 OpenAI → 模型 下拉中選擇模型。若希望在成本和效果之間取得平衡，推薦
gpt-5.4-mini。 - 可選：在 OpenAI → Flex 模式 中啟用 Flex Mode。它可能降低成本，但也可能帶來更高延遲或更多服務端錯誤。
使用 OpenRouter
OpenRouter 提供統一接口，可訪問多個語言模型提供方的模型，其中也包含免費選項，適合比較不同模型表現。
- 在 OpenRouter 取得 API Key。需要註冊；使用付費模型時可能還需要綁定付款方式。
- 在 設定 ⚙️ → 通用 → LLM 提供方 中選擇 OpenAI 兼容服務。
- 在 OpenAI 兼容服務 → 密鑰 中填入 API Key。
- 在 OpenRouter Models Page 瀏覽可用模型，並可使用 "Prompt Pricing" 過濾免費模型。
注意： 各模型提供方的資料保留與隱私策略可能不同，使用前請自行查看。 - 在 OpenAI 兼容服務 → 模型 中填入模型名。推薦系列包括：
Anthropic: Claude Sonnet 4.6（anthropic/claude-sonnet-4.6）—— Claude 系列裡質量和成本平衡較好- 免費模型：
OpenAI: GPT-OSS 120B（免費：openai/gpt-oss-120b:free）Google: Gemma 4 26B A4B IT（免費：google/gemma-4-26b-a4b-it:free）Google: Gemma 4 31B IT（免費：google/gemma-4-31b-it:free）
- 對於自託管/本地部署（需要約 24G 顯存或 24-32GB 統一記憶體），我們推薦：
Qwen: Qwen3.6 35B A3B（qwen/qwen3.6-35b-a3b）Google: Gemma 4 26B A4B IT（google/gemma-4-26b-a4b-it）Google: Gemma 4 31B IT（google/gemma-4-31b-it）
- 注意：免費模型會經常變化，請以 OpenRouter 模型頁中的 Prompt Pricing 過濾結果為準
- 注意：免費模型提供方可能會收集您的資料，使用前請先查看模型頁面說明
- 在 OpenAI 兼容服務 → 基礎 URL 中填寫
https://openrouter.ai/api/v1。
基本 DAW 操作
聊天命令：/clear、/welcome、/help、/hotkeys
-
音軌
- 在軌道資訊面板中新增、重命名和重排音軌。
- 通過樂器按鈕（鋼琴圖示）切換樂器；可調整 Solo（S）、Mute（M）和 Volume。
- 通過音軌設定選單刪除音軌（位於樂器按鈕右側）。
- 音訊錄音：點擊工具列裡的 Rec 按鈕，可直接從麥克風錄到音訊軌。
-
區域
- 建立區域：使用 Pointer 工具時可雙擊，或按住 Ctrl/Cmd 再點擊；使用 Pencil 工具時單擊即可。
- 移動/縮放：拖動區域主體可移動，拖動邊緣可調整長度。
- 通過區域左上角的小鉛筆開啟 Piano Roll。
-
Piano Roll（MIDI 音符）
- 工具：Select 與 Pencil。
- 建立音符：在 Select 模式下雙擊或 Ctrl/Cmd+點擊；在 Pencil 模式下單擊。
- 選取音符：單擊；Shift+單擊多選；拖曳框選。
- 移動/縮放：拖動音符主體可移動已選音符；拖動邊緣可調整長度。
- 五線譜視圖：可在 Piano Roll 工具列中切換 Piano Roll 與五線譜視圖。支援自動譜號、調號顯示、連音線和符槓分組。啟用 Track Scope 後會連續顯示整條 MIDI 音軌上的內容。
- 自動化軌道：可在下方自動化區域繪製和編輯 Pitch Bend 與 MIDI CC 曲線（Modulation、Breath、Volume、Expression、Sustain）。
- 頻譜模式：可在 Piano Roll 中查看音訊區域的頻譜，作為 MIDI 編輯參考層。
- 事件列表面板：提供 Notes / Pitch Bend / Controller 標籤頁，用於查看並內聯編輯當前 MIDI 區域中的事件。
- 可通過 X 或 ESC 關閉 Piano Roll 視窗。
-
智能和弦助手
- 在 Piano Roll 工具列中使用
⊘、T、S、D啟用和弦指導。 - 和弦候選會根據播放頭當前位置的有效調號來推斷：大調使用 Ionian，小調使用 Aeolian。
- 將滑鼠懸停在任意琴鍵上時，會以紅色高亮顯示上下文相關的和弦建議。
- 按
g循環切換和弦指導模式，按Tab切換到下一個候選和弦，按Shift+Tab切換到上一個。 - 雙擊（或 Ctrl/Cmd+點擊）高亮和弦可一次性建立整組音符。
- 和弦長度會自動匹配您最近編輯的音符長度，以保持節奏一致。
- 在 Piano Roll 工具列中使用
-
全域軌系統
- 時間線上方固定有四條軌道：Marker、Tempo、Key Signature、Chord。
- 建立全域區域：在全域軌中雙擊或 Ctrl/Cmd+點擊；拖動可移動，拖動邊緣可調整長度。
- 這些軌道會影響播放時序、和弦指導、五線譜調號顯示，以及和弦檢測結果。
-
音訊分析功能
- Detect Chords：在音訊區域開啟 Piano Roll 後，點擊 ... → Detect Chords，即可自動分析並把結果寫入全域 Chord Track。可設定靈敏度、穩定性和七和弦檢測。
- Detect Tempo：在音訊區域開啟 Piano Roll 後，點擊 ... → 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。
- 在主時間網格點擊小節編號可設定播放頭；在 Piano Roll 中點擊頂部時間軸也可設定，並遵守目前吸附設定。
- BPM、拍號和調號都可以通過工具列中的數值直接調整。
說明
出於安全考慮，在非本地主機場景下，K.G.Studio 預設不會把 API Key 持久化到 IndexedDB 中（以降低 XSS 風險）。您每次開啟 K.G.Studio 時都需要重新輸入。若您確實需要在非本地主機場景下持久化，請在設定中啟用 "Persist API Keys on Non-Localhost"（不建議在共享或生產環境下啟用）。
免責聲明
K.G.Studio 不提供也不託管上述任何模型，也不隸屬於任何模型提供方。所有資料預設都儲存在您的本地裝置中；您向第三方模型提供方發送的任何資料，都由您自行負責。
祝您使用 K.G.Studio 音樂創作助手創作愉快！