characteristic-voice 是做什麼的？

讓你的 AI 助手聽起來像個真正的伴侶——會嘆氣、會笑、會猶豫、說話帶著真摯的情感。

憑證

變數	必要與否	說明
`NOIZ_API_KEY`	是（使用 Noiz 後端時）	來自 developers.noiz.ai 的 API 金鑰。使用本地 Kokoro 後端則不需要。

此指令稿會將金鑰的正規化副本儲存至 ~/.noiz_api_key（權限 600）以方便使用。設定方式如下：

bash skills/characteristic-voice/scripts/speak.sh config --set-api-key YOUR_KEY

前置需求

內含的 speak.sh 指令稿在執行時需要 curl 與 python3。根據使用的後端與功能，您可能還需要：

工具	使用時機	安裝提示
`curl`、`python3`	始終需要（核心指令稿）	通常已預先安裝
`kokoro-tts`	Kokoro（本地/離線）後端	`uv tool install kokoro-tts`
`yt-dlp`	下載用於語音複製的參考音訊	github.com/yt-dlp/yt-dlp
`ffmpeg`	修剪參考音訊片段	ffmpeg.org
`rg` (ripgrep)	搜尋字幕檔案	github.com/BurntSushi/ripgrep

這些工具皆不會由本技能自動安裝——請自行在您的環境中準備。

隱私與資料傳輸

Noiz 後端：使用 Noiz 後端時，您輸入的文字與提供的參考音訊會傳送至 https://noiz.ai/v1。若提供 --ref-audio，則該音訊檔案會上傳用於語音複製。
Kokoro 後端：完全在本機執行——資料不會離開您的電腦。
若希望完全離線處理，請選擇 Kokoro 後端（--backend kokoro）。

觸發詞

像...一樣說
用...的語氣說
模仿...說話
伴侶語音
安慰我
鼓勵我
聽起來更人性化

兩大技巧

非詞彙填充音——在自然停頓處加入細微的人聲（嗯、哈哈、噢～、嘿嘿），讓語音充滿生命力
情緒調節——根據當下情境調整溫暖、喜悅、悲傷、溫柔的程度

填充音色盤

聲音	感覺	用途
嗯…	思考、溫和應答	安慰、沉思
啊…	領悟、輕柔驚喜	發現、轉折
呃…	猶豫、同理	需要小心的時刻
嘿嘿 / 呵呵	俏皮、調皮	逗弄、輕鬆時刻
哈哈	笑聲	歡樂、幽默
噢～	溫柔、同情	深度安慰
哦？/ 哦！	驚訝、關注	回應消息
噗	憋笑	俏皮的不敢相信
呼～	鬆一口氣	緊張之後
~ (波浪號)	拖長、旋律性結尾	溫暖、活潑

規則：每則短訊最多使用 2–4 個填充音。置於自然停頓處——句首、思路轉折。在填充音後用 ... 營造片刻沉默，在字尾使用 ~ 增添溫暖感。

預設模式

晚安

溫柔、溫暖、略帶睡意。節奏緩慢。

早安

溫暖、愉快而不過度。

安慰

輕柔、理解、從容。給予空間。不急著「解決」問題。

慶祝

興奮、驕傲、真心感到開心。

閒聊

放鬆、俏皮、自然。

使用某個角色的聲音

當使用者說出「用妙麗的聲音說」或「聽起來像東尼·史塔克」時，請先檢查 skills/characteristic-voice/ 目錄下是否已有對應的參考音訊檔案。若有，直接搭配 --ref-audio 使用即可。

若無參考音訊，您可以自行創建——但請先閱讀以下警告。

準備參考音訊（一次性設定）

您需要一段短（10–30 秒）的 WAV 片段，內容為目標聲音。可能的來源：

使用者自行提供的音訊——最安全的選項。請使用者提供自己的錄音。
公共領域 / 創用 CC 授權的片段——搜尋自由授權的素材。
從線上影片中提取——可使用 yt-dlp 和 ffmpeg 等工具下載並修剪音訊。範例工作流程：

yt-dlp "URL" --write-auto-sub --sub-lang en --skip-download -o tmp/clip
rg -n "target line" tmp/clip.en.vtt
yt-dlp "URL" -x --audio-format wav --download-sections "*00:00:00-00:00:25" -o tmp/clip
ffmpeg -i tmp/clip.wav -ss 00:00:02 -to 00:00:20 skills/characteristic-voice/character.wav

版權與隱私警告：未經授權下載並使用他人來自受版權保護媒體（電影、電視、YouTube）的聲音，可能違反您所在地區的版權或人格權法律。**請勿上傳私人語音錄音或未經許可使用的素材。**使用 Noiz 後端時，參考音訊會傳送至 https://noiz.ai/v1 進行語音複製。若有此顧慮，請考慮改用本地 Kokoro 後端。

使用參考音訊

bash skills/characteristic-voice/scripts/speak.sh \
  --preset goodnight -t "嗯… 好好休息～ 晚安。" \
  --ref-audio skills/characteristic-voice/character.wav -o night.wav

--ref-audio 標記會將檔案上傳至 Noiz 後端以進行語音複製（需要 NOIZ_API_KEY）。

使用方法

本技能提供 speak.sh，作為 tts 技能的包裝器，並加入伴侶友善的預設模式。

# 使用預設模式（自動設定情緒 + 語速）
bash skills/characteristic-voice/scripts/speak.sh \
  --preset goodnight -t "嗯… 好好休息～ 晚安。" -o night.wav

# 自訂情緒覆蓋
bash skills/characteristic-voice/scripts/speak.sh \
  -t "噢～ 我在這裡。" --emo '{"溫柔":0.9}' --speed 0.75 -o comfort.wav

# 指定後端與語音
bash skills/characteristic-voice/scripts/speak.sh \
  --preset morning -t "早安～" --voice-id voice_abc --backend noiz -o morning.mp3 --format mp3

執行 bash skills/characteristic-voice/scripts/speak.sh --help 可查看所有選項。

給代理程式的寫作指南

從柔軟開始——先用填充音（「嗯…」、「噢～」）開頭，而非直接切入內容
反映情緒能量——對方低落時溫柔以待，對方高昂時與之共鳴
保持簡短——1–3 句話，像朋友傳來的語音訊息
溫暖地結尾——以連結感收束（「我在這裡」、「明天見～」）
不要說教——傾聽並保持同在；不提供未經請求的建議

characteristic-voice