Files
KGStudio/public/chat/help-zh_hk.md
T

8.3 KiB
Raw Blame History

幫助

歡迎使用 K.G.Studio 音樂創作助手。這是您的 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 取得 API Key。您可能需要先註冊帳號並新增付款方式。
  2. 設定 ⚙️ → 通用 → LLM 提供方 中選擇 OpenAI
  3. OpenAI → 密鑰 中填入 API Key。
  4. OpenAI → 模型 下拉中選擇模型。若希望在成本和效果之間取得平衡,推薦 gpt-5.4-mini
  5. 可選:在 OpenAI → Flex 模式 中啟用 Flex Mode。它可能降低成本,但也可能帶來更高延遲或更多服務端錯誤。

使用 OpenRouter

OpenRouter 提供統一接口,可訪問多個語言模型提供方的模型,其中也包含免費選項,適合比較不同模型表現。

  1. OpenRouter 取得 API Key。需要註冊;使用付費模型時可能還需要綁定付款方式。
  2. 設定 ⚙️ → 通用 → LLM 提供方 中選擇 OpenAI 兼容服務
  3. OpenAI 兼容服務 → 密鑰 中填入 API Key。
  4. OpenRouter Models Page 瀏覽可用模型,並可使用 "Prompt Pricing" 過濾免費模型。
    注意: 各模型提供方的資料保留與隱私策略可能不同,使用前請自行查看。
  5. OpenAI 兼容服務 → 模型 中填入模型名。推薦系列包括:
    • Anthropic: Claude Sonnet 4.6anthropic/claude-sonnet-4.6)—— Claude 系列裡質量和成本平衡較好
    • Qwen: Qwen3.5-35B-A3Bqwen/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)、MuteM)和 Volume。
    • 通過音軌設定選單刪除音軌(位於樂器按鈕右側)。
    • 音訊錄音:點擊工具列裡的 Rec 按鈕,可直接從麥克風錄到音訊軌。
  • 區域

    • 建立區域:使用 Pointer 工具時可雙擊,或按住 Ctrl/Cmd 再點擊;使用 Pencil 工具時單擊即可。
    • 移動/縮放:拖動區域主體可移動,拖動邊緣可調整長度。
    • 通過區域左上角的小鉛筆開啟 Piano Roll。
  • Piano RollMIDI 音符)

    • 工具: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 工具列中使用 TSD 啟用和弦指導。
    • 和弦候選會根據播放頭當前位置的有效調號來推斷:大調使用 Ionian,小調使用 Aeolian。
    • 將滑鼠懸停在任意琴鍵上時,會以紅色高亮顯示上下文相關的和弦建議。
    • g 循環切換和弦指導模式,按 Tab 切換到下一個候選和弦,按 Shift+Tab 切換到上一個。
    • 雙擊(或 Ctrl/Cmd+點擊)高亮和弦可一次性建立整組音符。
    • 和弦長度會自動匹配您最近編輯的音符長度,以保持節奏一致。
  • 全域軌系統

    • 時間線上方固定有四條軌道:MarkerTempoKey SignatureChord
    • 建立全域區域:在全域軌中雙擊或 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_32 stemVocals / Instrumental,約 64 MB)和 Demucs htdemucs_4s4 stemVocals / Drums / Bass / Others,約 172 MB)。在生成器面板中下載模型後,點擊 Separate Stems 即可。需要 WebGPUChrome 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 音樂創作助手創作愉快!