前言¶
在 DeepSeek Harness（DSH）裏做歌詞類內容時，常見做法是手寫腳本調 ffmpeg、或把文案交給通用視頻工具，再手工對齊節拍與畫面風格。JIZURA 是在線文字 PV 生成應用，支持 JIZURA 記法、BPM 檢測與多種視覺預設，但完整流程仍要在瀏覽器裏操作。
dsh-tool-jizura 是社區維護的 DSH 聯網工具插件：在本地用 Playwright 驅動 JIZURA 頁面，通過其公開的 window.J / J.uiApi 接口設置項目狀態並導出 MP4 或 PNG 序列，把「填詞 → 踩點 → 出片」收成一次工具調用，返回值裏帶回 BPM、樣式與文件路徑，便於在會話裏覈對是否踩點成功。
這是什麼¶
- 插件名稱：dsh-tool-jizura（npm 包名同倉庫名）
- 維護者：Flooding-Rain
- 分類：聯網工具（社區目錄 SkillHub 歸類）
- 版本：0.1.0（見倉庫
package.json） - 許可證：MIT
插件面向已安裝 DSH 的開發者或智能體編排場景：傳入歌詞（可選背景音樂與樣式參數），產出文字 PV 視頻或連番 PNG（ZIP），而不是替代 JIZURA 本體或 DeepSeek 官方能力。
核心功能¶
下列能力均來自倉庫 README 與實現說明。
自動踩點與音頻分析¶
提供 audioPath（背景音樂絕對路徑）時，插件會等待 JIZURA 完成異步 BPM 檢測，讓畫面切點落在節拍網格上。返回對象中的 bpm、beatCount、audioDuration 用於確認踩點是否生效；無音頻時仍可出片，但 bpm 爲 0，且不會啓用基於能量的段落對比。
情緒、強度與樣式¶
- 情緒
mood：glitch、calm、pop、graphic、editorial、emotional、horror、chaos共 8 種。 - 強度
intensity：0～1，在當前情緒的強度區間內線性插值，驅動 JIZURA 的 13 個效果參數（motion、glitch、chroma、texture、density 等）。 - 預設
stylePreset：auto（默認）、light、dark、neon，會展開爲樣式包 + 情緒 + 強度；顯式傳入mood/intensity會覆蓋預設推斷。 - 直傳樣式
styleKey：27 個樣式 key，優先於stylePreset；無效時忽略並沿用預設，實際生效值在返回的style字段中。
段落對比與畫面參數¶
autoDynamics（默認true）：有音頻時按能量包絡調整各行切分密度，安靜段落收斂、激烈段落切得更碎。paletteLock：鎖定樣式首套配色，避免逐行換色。- 畫幅
aspectRatio：16:9、9:16、1:1；分辨率720/1080/1440/2160；幀率24/30/60；畫質quality：standard/high/max。 - 綠幕背景
keyBg：off/green/black；seed可復現同一輸入下的隨機結果。
輸出格式與 DSH 集成¶
outputFormat：mp4或png_sequence（JIZURA 導出爲單個 ZIP，非裸 PNG 目錄）。- 遵守 DSH 取消信號：調用被中止時關閉瀏覽器進程。
- 實現上主要調用 JIZURA 的
J.ui.project、J.uiApi.replan()/syncUI()、J.omakase、J.analyzeAudio等；填歌詞、注入音頻文件、點擊導出仍走 DOM。
安裝與啓用¶
DSH 社區插件通過 profile 安裝，請使用 README 中的命令，不要自行拼接倉庫路徑。
dsh plugin --profile web add github:Flooding-Rain/dsh-tool-jizura
前置依賴¶
插件依賴 Node.js 側的 Playwright。首次使用前安裝 Chromium：
npx playwright install chromium
安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。插件以當前 dsh 進程權限運行，會啓動無頭瀏覽器並讀寫你指定的本地音頻與輸出目錄。
典型用法¶
僅歌詞¶
{ "lyrics": "夜明けの色を/覚えてる\n*透明*なままの街" }
lyrics 支持 JIZURA 記法：/ 切分、*強調*、[間奏 8]、LRC 時間戳等。
帶音樂、情緒與豎屏¶
{
"lyrics": "夜明けの色を/覚えてる\n*透明*なままの街\n君の名前を呼んだ",
"audioPath": "D:\\music\\song.mp3",
"mood": "emotional",
"theme": "ballad",
"intensity": 0.7,
"aspectRatio": "9:16",
"resolution": 1080,
"outputDir": "D:\\output\\pv",
"title": "夜明け",
"seed": 20261007
}
在 dsh 會話中的自然語言示例¶
在會話裏可指示模型調用工具 generate_jizura_pv，例如：用 emotional、強度 0.7，配上 D:\music\song.mp3，輸出 16:9 MP4 到 D:\output\pv，並粘貼歌詞正文。
返回值示例¶
成功時 execute 返回結構化對象（節選）：
{
"path": "D:\\output\\pv\\夜明け.mp4",
"bpm": 120,
"beatCount": 25,
"audioDuration": 12,
"style": "noir",
"mood": "emotional",
"intensity": 0.7,
"dynamicsApplied": true
}
歌詞爲空時不啓動瀏覽器，path 爲空並提示未生成；瀏覽器或分析超時等情況以錯誤卡片呈現。
適用場景與注意¶
適合誰
- 已在 DSH 中編排工具鏈，需要把「歌詞 → 文字 PV」自動化，並希望在返回裏看到 BPM、樣式與文件大小。
- 接受依賴在線 JIZURA 應用行爲（README 基於 JIZURA v0.10.1 源碼與實測總結上游規則）。
使用上務必知曉
- 導出時長：有音頻時導出長度以音頻爲準（與歌詞行數無關）。歌詞未鋪滿音軌時可用
[間奏 N]（支持小數）填充，否則會出現長時間空畫面。 - 雙語與註記：
|註記在多 cut 行上常不顯示；譯文宜寫成帶 LRC 時間戳的獨立行。 - 路徑：
audioPath、outputDir使用本機絕對路徑；默認輸出目錄爲./jizura-pv-output。 - 安全：聯網工具會訪問 JIZURA 站點並操作本地文件，安裝前請自行審查插件代碼與權限範圍。
社區插件目錄 SkillHub 插件頁 與 GitHub 倉庫相互獨立，均非 DeepSeek / 幻方官方應用商店；DSH 生態遵循「一切皆插件」，選型以倉庫文檔與源碼爲準。
