chore(i18n): unify Traditional Chinese wording across UI and docs

This commit is contained in:
Xiaohan-Tian
2026-05-31 12:29:10 -07:00
parent e1f8e69ce3
commit f58d9a85b0
10 changed files with 261 additions and 261 deletions
+43 -43
View File
@@ -2,20 +2,20 @@
歡迎使用 **K.G.Studio 音樂創作助手**。這是您的 AI 音樂創作與編曲助手,可以幫助您構思、編排和修改音樂內容。
您可以選擇使用 **內本地瀏覽器 LLM**(無需 API Key),也可以配置外部 LLM 提供方。下面是常用的入門方式。
您可以選擇使用 **內本地瀏覽器 LLM**(無需 API Key),也可以設定外部 LLM 提供方。下面是常用的入門方式。
---
### 使用本地 LLM(瀏覽器)——無需 API Key
K.G.Studio 可以通過 WebGPU 在瀏覽器中直接運行 **Gemma 4 E4B**。不會產生外部 API 調用費用,數據也不會離開您的設備
K.G.Studio 可以通過 WebGPU 在瀏覽器中直接運行 **Gemma 4 E4B**。不會產生外部 API 呼叫費用,資料也不會離開您的裝置
1. 進入 **設 ⚙️ → 通用 → LLM 提供方**,選擇 **本地 LLM(瀏覽器)**默認選項)。
2. 第一次開聊天時會自動下載模型(約 2.8 GB),後續會緩存在本地瀏覽器中。
3. 可選設 **上下文長度**32k / 64k / 128k tokens);越大越佔顯存。
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 統一內存的系統。
**要求:** Chrome 113+ 或 Edge 113+,安全上下文(HTTPS 或 localhost),以及至少 8 GB 顯存的 GPU 或至少 16 GB 統一記憶體的系統。
> 注意:本地模型效果無法與 GPT 或 Claude 這類商業模型完全相比。複雜任務通常更適合外部提供方。
@@ -23,14 +23,14 @@ K.G.Studio 可以通過 WebGPU 在瀏覽器中直接運行 **Gemma 4 E4B**。不
### 配置外部 LLM 提供方
進入 **設 ⚙️ → 通用 → LLM 提供方**。根據所選提供方,您需要填寫對應的 API Key,以及在需要時填寫 Base URL(例如 Ollama、OpenRouter 等 OpenAI 兼容服務)。
進入 **設 ⚙️ → 通用 → LLM 提供方**。根據所選提供方,您需要填寫對應的 API Key,以及在需要時填寫 Base URL(例如 Ollama、OpenRouter 等 OpenAI 兼容服務)。
---
### 使用 OpenAI GPT 系列
1. 在 [**OpenAI**](https://platform.openai.com/account/api-keys) 取 API Key。您可能需要先冊帳號並添加支付方式。
2.**設 ⚙️ → 通用 → LLM 提供方** 中選擇 **OpenAI**
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。它可能降低成本,但也可能帶來更高延遲或更多服務端錯誤。
@@ -41,18 +41,18 @@ K.G.Studio 可以通過 WebGPU 在瀏覽器中直接運行 **Gemma 4 E4B**。不
OpenRouter 提供統一接口,可訪問多個語言模型提供方的模型,其中也包含免費選項,適合比較不同模型表現。
1. 在 [**OpenRouter**](https://openrouter.ai/keys) 取 API Key。需要冊;使用付費模型時可能還需要綁定付方式。
2.**設 ⚙️ → 通用 → LLM 提供方** 中選擇 **OpenAI 兼容服務**
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 操作
@@ -60,67 +60,67 @@ OpenRouter 提供統一接口,可訪問多個語言模型提供方的模型,
聊天命令:`/clear``/welcome``/help``/hotkeys`
- 音軌
- 在軌道信息面板中添加、重命名和重排音軌。
- 通過樂器按鈕(鋼琴圖)切換樂器;可調整 Solo(S)、MuteM)和 Volume。
- 通過音軌設置菜單刪除音軌(位於樂器按鈕右側)。
- **音錄音**:點擊工具裡的 Rec 按鈕,可直接從麥克風錄到音軌。
- 在軌道資訊面板中新增、重命名和重排音軌。
- 通過樂器按鈕(鋼琴圖)切換樂器;可調整 Solo(S)、MuteM)和 Volume。
- 通過音軌設定選單刪除音軌(位於樂器按鈕右側)。
- **音錄音**:點擊工具裡的 Rec 按鈕,可直接從麥克風錄到音軌。
- 區域
- 建區域:使用 Pointer 工具時可雙擊,或按住 Ctrl/Cmd 再點擊;使用 Pencil 工具時單擊即可。
-區域:使用 Pointer 工具時可雙擊,或按住 Ctrl/Cmd 再點擊;使用 Pencil 工具時單擊即可。
- 移動/縮放:拖動區域主體可移動,拖動邊緣可調整長度。
- 通過區域左上角的小鉛筆打開鋼琴卷簾窗口
- 通過區域左上角的小鉛筆開啟 Piano Roll
- 鋼琴卷簾MIDI 音符)
- Piano RollMIDI 音符)
- 工具:Select 與 Pencil。
- 建音符:在 Select 模式下雙擊或 Ctrl/Cmd+點擊;在 Pencil 模式下單擊。
-音符:單擊;Shift+單擊多選;拖框選。
-音符:在 Select 模式下雙擊或 Ctrl/Cmd+點擊;在 Pencil 模式下單擊。
-音符:單擊;Shift+單擊多選;拖框選。
- 移動/縮放:拖動音符主體可移動已選音符;拖動邊緣可調整長度。
- **五線譜視圖**:可在鋼琴卷簾工具中切換鋼琴卷簾與五線譜視圖。支自動譜號、調號顯示、連音線和符分組。啟用 **Track Scope** 後會連續顯示整條 MIDI 音軌上的內容。
- **五線譜視圖**:可在 Piano Roll 工具中切換 Piano Roll 與五線譜視圖。支自動譜號、調號顯示、連音線和符分組。啟用 **Track Scope** 後會連續顯示整條 MIDI 音軌上的內容。
- **自動化軌道**:可在下方自動化區域繪製和編輯 Pitch Bend 與 MIDI CC 曲線(Modulation、Breath、Volume、Expression、Sustain)。
- **頻譜模式**:可在鋼琴卷簾中查看音區域的頻譜,作為 MIDI 編輯參考層。
- **頻譜模式**:可在 Piano Roll 中查看音區域的頻譜,作為 MIDI 編輯參考層。
- **事件列表面板**:提供 Notes / Pitch Bend / Controller 標籤頁,用於查看並內聯編輯當前 MIDI 區域中的事件。
- 可通過 X 或 ESC 關閉鋼琴卷簾窗口
- 可通過 X 或 ESC 關閉 Piano Roll 視窗
- 智能和弦助手
-鋼琴卷簾工具中使用 `⊘``T``S``D` 啟用和弦指導。
- Piano Roll 工具中使用 `⊘``T``S``D` 啟用和弦指導。
- 和弦候選會根據播放頭當前位置的有效調號來推斷:大調使用 Ionian,小調使用 Aeolian。
- 將鼠懸停在任意琴鍵上時,會以紅色高亮顯示上下文相關的和弦建議。
-鼠懸停在任意琴鍵上時,會以紅色高亮顯示上下文相關的和弦建議。
-`g` 循環切換和弦指導模式,按 `Tab` 切換到下一個候選和弦,按 `Shift+Tab` 切換到上一個。
- 雙擊(或 Ctrl/Cmd+點擊)高亮和弦可一次性建整組音符。
- 雙擊(或 Ctrl/Cmd+點擊)高亮和弦可一次性建整組音符。
- 和弦長度會自動匹配您最近編輯的音符長度,以保持節奏一致。
-軌系統
-軌系統
- 時間線上方固定有四條軌道:**Marker**、**Tempo**、**Key Signature**、**Chord**。
- 創建全局區域:在全軌中雙擊或 Ctrl/Cmd+點擊;拖動可移動,拖動邊緣可調整長度。
- 建立全域區域:在全軌中雙擊或 Ctrl/Cmd+點擊;拖動可移動,拖動邊緣可調整長度。
- 這些軌道會影響播放時序、和弦指導、五線譜調號顯示,以及和弦檢測結果。
-分析功能
- **Detect Chords**:在音區域打開鋼琴卷簾窗口後,點擊 **...** → **Detect Chords**,即可自動分析並把結果寫入全 Chord Track。可配置靈敏度、穩定性和七和弦檢測。
- **Detect Tempo**:在音區域打開鋼琴卷簾窗口後,點擊 **...** → **Detect Tempo**,即可分析 BPM,並可選擇自動對齊項目中的 Tempo Track。
-分析功能
- **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 stemVocals / Instrumental,約 64 MB)和 **Demucs htdemucs_4s**4 stemVocals / Drums / Bass / Others,約 172 MB)。在生成器面板中下載模型後,點擊 **Separate Stems** 即可。需要 WebGPUChrome 113+ / Edge 113+)。
- 點擊工具中的 **✦**(魔杖)按鈕開生成器面板。
- **Full Song Generation**:根據文本描述和可選歌詞生成整首歌曲(需要 K.G.One 服器)。
- **Clip Generation**:根據文本提示生成短音片段和 MIDI loop(需要 K.G.One 服器)。
- **Stem Separation(瀏覽器)**:可完全在瀏覽器中把任意音區域分離成 stems,無需服器。支兩種模型:**UVR-MDX-NET-Inst_HQ_3**2 stemVocals / Instrumental,約 64 MB)和 **Demucs htdemucs_4s**4 stemVocals / Drums / Bass / Others,約 172 MB)。在生成器面板中下載模型後,點擊 **Separate Stems** 即可。需要 WebGPUChrome 113+ / Edge 113+)。
- 吸附與量化
- 在右上角的 NO SNAP 單中設吸附。
- 在右上角的 NO SNAP 單中設吸附。
- 使用 Qua. Pos.(起始)和 Qua. Len.(長度)進行量化。
- 播放與播放頭
- 工具可回到開頭,並執行 Play/Pause。
- 在主時間網格點擊小節編號可設播放頭;在鋼琴卷簾中點擊頂部時間軸也可設,並遵守前吸附設
- BPM、拍號和調號都可以通過工具中的數值直接調整。
- 工具可回到開頭,並執行 Play/Pause。
- 在主時間網格點擊小節編號可設播放頭;在 Piano Roll 中點擊頂部時間軸也可設,並遵守前吸附設
- BPM、拍號和調號都可以通過工具中的數值直接調整。
---
### 說明
出於安全考慮,在非本地主機場景下,K.G.Studio 默認不會把 API Key 持久化到 IndexedDB 中(以降低 XSS 風險)。您每次開 K.G.Studio 時都需要重新輸入。若您確實需要在非本地主機場景下持久化,請在設中啟用 "Persist API Keys on Non-Localhost"(不建議在共享或生產環境下啟用)。
出於安全考慮,在非本地主機場景下,K.G.Studio 預設不會把 API Key 持久化到 IndexedDB 中(以降低 XSS 風險)。您每次開 K.G.Studio 時都需要重新輸入。若您確實需要在非本地主機場景下持久化,請在設中啟用 "Persist API Keys on Non-Localhost"(不建議在共享或生產環境下啟用)。
### 免責聲明
K.G.Studio 不提供也不管上述任何模型,也不隸屬於任何模型提供方。所有數據默認都保存在您的本地設備中;您向第三方模型提供方發送的任何數據,都由您自行負責。
K.G.Studio 不提供也不管上述任何模型,也不隸屬於任何模型提供方。所有資料預設都儲存在您的本地裝置中;您向第三方模型提供方發送的任何資料,都由您自行負責。
祝您使用 K.G.Studio 音樂創作助手創作愉快!
+21 -21
View File
@@ -2,12 +2,12 @@
本指南列出了當前在 K.G.Studio 中已經實現的鍵盤快捷鍵,以及部分點擊時配合修飾鍵的操作。
### 平台相關的建操作
### 平台相關的建操作
-**macOS** 上,使用 Pointer 工具時按 `Cmd+click`建區域、音符或自動化點。
-**Windows/Linux** 上,使用 Pointer 工具時按 `Ctrl+click`建區域、音符或自動化點。
- 在主時間線中,Pointer 工具激活時雙擊空白處可建區域。
-鋼琴卷簾與自動化軌中,Pencil 工具支單擊建。
-**macOS** 上,使用 Pointer 工具時按 `Cmd+click` 可建區域、音符或自動化點。
-**Windows/Linux** 上,使用 Pointer 工具時按 `Ctrl+click` 可建區域、音符或自動化點。
- 在主時間線中,Pointer 工具啟用時雙擊空白處可建區域。
- Piano Roll 與自動化軌中,Pencil 工具支單擊建
### 主快捷鍵
@@ -16,40 +16,40 @@
- `R` — 開始 / 停止錄音
- `Cmd/Ctrl+Z` — 撤銷
- `Cmd/Ctrl+Shift+Z` — 重做
- `Cmd/Ctrl+C` — 複製所選項目
- `Cmd/Ctrl+V`
- `Cmd/Ctrl+S`保存項目
- `Cmd/Ctrl+A` — 選中當前 MIDI 區域中的全部音符
- `Cmd/Ctrl+C` — 複製所選專案
- `Cmd/Ctrl+V` — 貼
- `Cmd/Ctrl+S`儲存專案
- `Cmd/Ctrl+A` — 選取目前 MIDI 區域中的全部音符
- `Cmd/Ctrl+T` — 在播放頭處分割所選區域
- `Cmd/Ctrl+J` — 合併選中的 MIDI 區域
- `Cmd/Ctrl+J` — 合併已選取的 MIDI 區域
### 區域與鋼琴卷簾窗口快捷鍵
### 區域與 Piano Roll 視窗快捷鍵
- `E` — 為選中的 MIDI 區域打開鋼琴卷簾窗口,或為選中的音區域開波形編輯器;如果編輯器已經開,`E` 會關閉它。
- `N` — 以五線譜視圖打開選中的 MIDI 區域。
- `Delete` / `Backspace` — 刪除選中的區域、音符或自動化點。
- `Esc` — 關閉鋼琴卷簾窗口
- `E` — 為已選取的 MIDI 區域開啟 Piano Roll,或為已選取的音區域開波形編輯器;如果編輯器已經開`E` 會關閉它。
- `N` — 以五線譜視圖開啟已選取的 MIDI 區域。
- `Delete` / `Backspace` — 刪除已選取的區域、音符或自動化點。
- `Esc` — 關閉 Piano Roll 視窗
### 選擇操作
- `Shift+click` — 加入前選擇。
- 在空白區域套索拖 — 框選區域或自動化點。
-鋼琴卷簾窗口`Shift+套索` — 切換套索範圍內項目的選狀態。
- `Shift+click` — 加入前選擇。
- 在空白區域套索拖 — 框選區域或自動化點。
- Piano Roll 視窗`Shift+套索` — 切換套索範圍內項目的選狀態。
### 鋼琴卷簾快捷鍵
### Piano Roll 快捷鍵
- `G` — 循環切換和弦指導模式
- `Tab` — 跳到下一個和弦候選
- `Shift+Tab` — 跳到上一個和弦候選 / 轉位
### 鋼琴卷簾吸附快捷鍵
### Piano Roll 吸附快捷鍵
- `1` — 不吸附
- `2` — 吸附到 `1/4`
- `3` — 吸附到 `1/8`
- `4` — 吸附到 `1/16`
### 鋼琴卷簾量化快捷鍵
### Piano Roll 量化快捷鍵
- `5` — 起始量化到 `1/4`
- `6` — 起始量化到 `1/8`
+2 -2
View File
@@ -1,9 +1,9 @@
## 再次歡迎
很高興再次見到您。檢測到您的 LLM 提供方已經配置完成,現在可以直接開始聊天。
很高興再次見到您。檢測到您的 LLM 提供方已經設定完成,現在可以直接開始聊天。
提示:
- 隨時輸入 `/clear`置當前聊天。
- 隨時輸入 `/clear`設目前聊天。
- 輸入 `/welcome` 再次查看這條歡迎消息。
- 輸入 `/help` 查看幫助說明。
- 輸入 `/hotkeys` 查看快捷鍵指南。
+4 -4
View File
@@ -4,7 +4,7 @@
- 無需外部 API 調用。所有內容都直接在您的瀏覽器中運行,不會產生額外 API 成本。
- 此模式通過 **LiteRT-LM****WebGPU** 加速運行 **Gemma 4 E4B**
- 推薦硬:至少 **8 GB 顯存**的 GPU,或至少 **16 GB 統一內存**的系統。
- 推薦硬:至少 **8 GB 顯存**的 GPU,或至少 **16 GB 統一記憶體**的系統。
- 相比更大的雲端模型,本地模式在複雜規劃、長鏈路編輯和多步驟任務上能力會更有限。
### 推薦工作方式
@@ -19,11 +19,11 @@
- 例如,如果您想讓模型基於當前音樂寫一段和弦進行,可以先說:`請讀取當前音樂。`
- 等這一步完成後,再繼續說:`請基於它寫一段和弦進行。`
- 在本地 LLM 模式下,這種漸進式流程通常更可靠。
- 在整個流程中,保持您希望 agent 更新的 MIDI 區域處於選狀態。
- 在整個流程中,保持您希望 agent 更新的 MIDI 區域處於選狀態。
- 僅僅為了執行 `read_music`,您不需要切換到別的區域,因為 `read_music` 可以讀取所有音軌的音樂內容。
### 改用外部 LLM
- 如果您想使用更大的雲端模型或自管模型,請**設 -> 通用 -> LLM 提供方**,切換到 **本地 LLM(瀏覽器)** 以外的提供方。
- 如果您想使用更大的雲端模型或自管模型,請開 **設 -> 通用 -> LLM 提供方**,切換到 **本地 LLM(瀏覽器)** 以外的提供方。
- 如果要用雲端模型,可以選擇 **OpenAI**,或者選擇 **OpenAI Compatible** 並填寫 OpenRouter 等提供方。
- 如果要用自管模型,也請選擇 **OpenAI Compatible**,然後填寫您的服**Base URL****Model**
- 如果要用自管模型,也請選擇 **OpenAI Compatible**,然後填寫您的服器 **Base URL****Model**
- 切換提供方後,建議開啟一個新的對話,以便聊天會話乾淨地使用新模型。
+8 -8
View File
@@ -5,21 +5,21 @@
### 快速開始
**配置 K.G.Studio 音樂創作助手**
- [點擊這裡獲取免費的 OpenRouter API Key](https://openrouter.ai/keys)(您可能需要一個 OpenRouter 帳號)。
- 進入 **設 ⚙️ → 通用 → LLM 提供方**,選擇 **OpenAI 兼容服務**
-**OpenAI 兼容服務 → 密鑰**貼您的 Key。注意:在非 localhost 環境下,Key 默認不會持久化,刷新後需要重新輸入,請妥善保管。
- 進入 **設 ⚙️ → 通用 → 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 再點擊)可建區域。
- 拖動區域邊緣可調整長度;拖動區域主體可移動。
- 點擊區域左上角的小鉛筆可打開鋼琴卷簾窗口
-鋼琴卷簾中,雙擊(或 Ctrl/Cmd+點擊)可建音符。
- 單擊選Shift+單擊多選;拖框選。
- 點擊區域左上角的小鉛筆可開啟 Piano Roll
- Piano Roll 中,雙擊(或 Ctrl/Cmd+點擊)可建音符。
- 單擊選Shift+單擊多選;拖框選。
- 拖動音符邊緣可調整長度;拖動音符主體可移動所選音符。
- 使用鋼琴卷簾工具右上角的 Snapping 控制網格量化。
- 使用 Piano Roll 工具右上角的 Snapping 控制網格量化。
### 免責聲明
K.G.Studio 與任何 LLM 提供方均無隸屬關係。所有數據默認都保存在您的本地設備中;您發送給第三方服務的數據由您自行負責。
K.G.Studio 與任何 LLM 提供方均無隸屬關係。所有資料預設都儲存在您的本地裝置中;您發送給第三方服務的資料由您自行負責。