PV Tool Skill 用于操作随技能打包在 app/ 目录下的 pv-tool 应用。它的定位是支持歌词视频与动态字体工作流，包括启动本地 PV Tool 开发服务器、构建打包应用、预览生产构建，以及在该应用中进行歌词视频和动态文字相关的创作。
用途 该技能面向需要制作歌词视频、宣传视频和动态图形文字叠加的场景。通过它可以在本地运行 PV Tool 网页应用，并进行编辑、试验和输出验证。
环境要求 运行时需要 Node.js 20+ 和 npm。
命令 所有命令需从 skills/pv-tool/ 目录下运行：
bash scripts/bootstrap.sh bash scripts/dev.sh bash scripts/build.sh bash scripts/preview.sh
环境变量覆盖项： PV_TOOL_DEV_HOST=0.0.0.0 PV_TOOL_DEV_PORT=4173 PV_TOOL_PREVIEW_HOST=127.0.0.1 PV_TOOL_PREVIEW_PORT=4174 VITE_BASE=/pv-tool/
标准工作流
- 运行 bash scripts/bootstrap.sh 将依赖安装到 app/node_modules。
- 运行 bash scripts/dev.sh 进行本地编辑和试验。
- 打开输出的本地 URL 并使用界面。
- 当用户需要生产构建时，运行 bash scripts/build.sh。
- 运行 bash scripts/preview.sh 在浏览器中验证构建产物。
应用内用法 可以从预设模板开始，或切换到 Custom。输入文本时使用 / 作为分段分隔符。可加载图片或视频作为背景媒体层。可加载音频用于 BPM 和节拍响应效果。可导入 .lrc 文件用于歌词时间轴。可调整后期特效，如 shake、zoom、tilt、glitch、hue shift。当用户需要捕获输出时，可使用内置录制/导出控件。
智能体行为 优先运行提供的脚本，而不是手动重述 npm 命令。启动 dev.sh 或 preview.sh 时，报告准确的本地 URL。除非用户要求将其守护进程化，否则保持长时间运行的服务器进程附着。如果缺少依赖，让包装脚本先安装它们。如果 Node.js 版本过低，停止并告知用户先升级再继续。
文件布局 app/ — 随包的上游 PV Tool 源代码 scripts/bootstrap.sh — 依赖安装 scripts/dev.sh — 本地 Vite 开发服务器 scripts/build.sh — 生产构建 scripts/preview.sh — 本地预览服务器
许可说明 随包的上游应用 app/ 不采用通用宽松许可证。默认仅限非商业使用。商业使用需要向上游作者单独获取许可。用于付费工作前请查看 app/LICENSE 和 app/COMMERCIAL.md。如果用户要求将 PV Tool 用于商业工作流，需明确指出该限制。