前言¶
在 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 生态遵循「一切皆插件」，选型以仓库文档与源码为准。
