00软件概览
Qiancheng Tools 是一款跑在 Windows 上的桌面小工具箱，用 C++ 写成，界面是一层 WebView2 外壳包着的前端页面。它把平时零散要开的格式转换、剪辑、压缩需求收进同一个窗口里，点一下就能在本地算完，文件不会上传到任何服务器。
01安装与启动
下载到的安装包是一个 .exe 安装程序（或绿色解压版），双击按提示装好即可，没有额外运行库要求。
- 下载安装包：从官网或工具下载页获取
QianchengTools_Setup_V1.exe，建议保存到非系统盘。 - 安装：跟着向导走，选择安装目录。装完会在开始菜单和桌面生成快捷方式。
- 首次启动：第一次打开会花几秒把内嵌的 FFmpeg / FFprobe 释放到程序目录下的
tools\文件夹，这是正常现象，之后就秒开了。 - 正常使用：左侧是功能导航，点哪个就切换到对应的工具页，所有操作都在右侧完成。
02界面速览
整个窗口分成左右两块：左边是深色侧边栏，列着所有功能入口和「设置」；右边是工作区，每个工具占一页，切换时内容淡入。
工作区里反复出现的几样东西：
- 文件框：点「浏览…」选文件，选中后路径显示在框里，边框变实线表示已就绪。
- 分段按钮（seg）：一组互斥的选项，比如画质、帧率，点一下高亮，代表当前选用的值。
- 滑块（slider）：拖动连续调参数，右边实时显示当前数值。
- 开始按钮：底部那条橙色大按钮，点它就真正开始转码，期间会变成转圈并禁用，防止重复点。
- 进度条 + 控制台：每个工具底下都有进度百分比和日志，转码卡住时可以看日志找原因。
03通用操作说明
不管用哪个工具，下面几条规则都适用，先记住能省很多事。
| 项目 | 说明 |
|---|---|
| 输出位置 | 优先级为：工具内单独指定的目录 > 设置里的统一保存目录 > 源文件所在目录。不指定就原样落在源文件旁边。 |
| 文件命名 | 默认不覆盖原文件，而是在名字后加后缀，例如 demo_compressed.mp4、demo_edited.png、demo_to_wav.wav。 |
| 一次一个任务 | 同一时刻只能跑一个转码任务，按钮转圈时其它开始按钮也会禁用，跑完自动恢复。 |
| 日志 | 控制台里的日志是 FFmpeg 的原始输出经过整理后的内容，报错时把最后几行发给我们最能准确定位。 |
04视频工具
四个视频相关功能：提取音频、出 GIF、压体积、一站式合成。它们共用同一套 FFmpeg 视频解码能力。
4.1 MP4 转 MP3
把视频里的音轨单独抽出来存成 MP3，丢弃画面。适合保存直播回放里的语音、BGM 之类。
- 选视频：支持 MP4 / MKV / MOV / AVI / WebM 等常见封装。
- 选输出目录（可选）：不选就用统一目录或源目录。
- 选音质：见下表，然后点「开始转换」。
| 音质选项 | 实际参数 | 适合场景 |
|---|---|---|
| VBR 高品质 | -q:a 2 动态码率 | 默认，体积音质均衡 |
| 320 kbps | -b:a 320k | 追求高保真、文件大点无所谓 |
| 192 kbps | -b:a 192k | 语音、播客够用，省空间 |
源文件名.mp3。命令层面会带 -vn，确保不要画面。4.2 视频转 GIF
先在波形 / 时间轴上框一段，再生成动图。适合做表情包、教程片段。
- 选视频：选完会自动画出波形，可以拖动橙色手柄框选起止，也能直接填「起始 / 时长」。
- 试看：点「▶ 播放选区」或「▶ 播放全部」预览，确认要截的段落。
- 设参数：帧率、宽度、是否高质量，然后「生成 GIF」。
| 参数 | 可选值 | 含义 |
|---|---|---|
| 帧率 | 101520 | 每秒多少帧。越高越流畅，文件越大。默认 15。 |
| 宽度 | 480320240原始 | 输出像素宽，高度按比例。窄一点体积小很多。 |
| 高质量调色板 | 开关 | 开启后走两遍：先生成调色板（palettegen），再合成（paletteuse），颜色更干净，耗时翻倍。 |
4.3 视频压缩
用 H.264 重新编码，靠 CRF 控制画质、靠分辨率控制体积。适合把手机拍的大视频压小好发送。
| 参数 | 可选值 | 含义 |
|---|---|---|
| 画质（CRF） | 高 20中 26低 32 | CRF 越小画质越高、体积越大。日常用「中」足够清晰。 |
| 最大宽度 | 原始1280960640 | 超过此宽就等比缩放到该宽度。1080p 压到 1280 通常看不出差别。 |
+faststart 方便网络播放。导出名：源文件名_compressed.mp4。4.4 视频合成台
这是功能最密的一页：一个界面里叠了好几条「效果轨」，想用哪条就把对应的开关拨亮，只有亮着的层才会进最终渲染。可以边调边点「生成样片预览」看 8 秒低清效果。
| 效果轨 | 能调的东西 |
|---|---|
| 截取片段 | 起始 / 时长；模式分「快速 copy」（不重编码，切得不准但快）和「精确重编码」。 |
| 旋转 / 翻转 / 缩放 / 裁剪 | 旋转 0/90/180/270°；水平、垂直翻转；输出宽度（0=原始）；裁剪的 X/Y/宽/高。 |
| 播放调速 | 0.25× ~ 4×，画面声音同步变速。 |
| 音轨处理 | 「替换原音轨」或「叠加混合」一段外部音频；混合时调速也会作用到混音上。 |
| 烧录字幕 | 选 SRT / ASS 字幕，设字号（12~72）和颜色（白/黄/青/绿/红/黑）。 |
05音频工具
五个音频功能，裁剪、合并、变速、变调、互转，全部在本地用 FFmpeg 的音频滤镜算。
5.1 音频剪辑
分三个小页：裁剪、合并、变速，底部用标签切换。
- 裁剪：波形上框选范围，可播放选区确认，输出 MP3 / M4A / WAV。
- 合并：添加多个文件（可多选），用 ↑↓ 调顺序，每段还能单独设起止截取，最后拼成一段。
- 变速：0.1× ~ 10×，音调保持不变（用 atempo 链实现），适合做慢放赏析或快进听书。
5.2 音频合并（详情）
合并走的是 atrim + asetpts 把每段截好，再用 concat 拼起来（纯音频，无画面）。每段在列表里能单独设「从哪秒到哪秒」，所以不一定是整段拼接。
5.3 音频变速
速度范围 0.1× 到 10×。底层用多个 atempo 串联逼近目标速率，因此变速后音调不会像老式录音机那样变声。
5.4 音频变调
按半音升高或降低音调，范围 -12 ~ +12（一个八度）。勾选「保持原时长」时，变调的同时把速度反调回来，听起来就是单纯的升 key / 降 key，长度不变。
| 参数 | 说明 |
|---|---|
| 变调（半音） | +12 = 升一个八度，-12 = 降一个八度，0 不变。 |
| 保持原时长 | 默认勾选。实现方式是先改采样率再重采样，并用反向 atempo 把时长拉回原长。 |
| 输出格式 | MP3 / M4A / WAV。 |
5.5 音频格式转换
在 MP3 / WAV / M4A / FLAC / OGG 之间互转，源文件会被保留。
| 目标格式 | 编码 | 性质 |
|---|---|---|
| MP3 | libmp3lame -q:a 2 | 有损，通用 |
| WAV | pcm_s16le | 无损 PCM，体积大 |
| M4A | aac -b:a 192k | 有损，苹果系友好 |
| FLAC | flac | 无损压缩 |
| OGG | libvorbis -q:a 5 | 有损，开源 |
06图片工具
6.1 图片编辑
可视化裁剪、旋转翻转、调色、改格式，预览实时联动。支持 JPG / PNG / WebP / BMP / GIF。
- 选图片：进来后画面上出现裁剪框，拖橙色角点缩放选区，拖框内部平移，在空白处拖可拉出新选区。
- 调参数：旋转 / 翻转按钮，亮度、对比度、饱和度三个滑块（-100~100），输出宽度（0=原始，最高 3840）。
- 选格式导出：PNG / JPG / WebP。
| 参数 | 范围 / 值 | 说明 |
|---|---|---|
| 亮度 / 对比度 / 饱和度 | -100 ~ 100 | 0 为不动；底层走 FFmpeg 的 eq 滤镜。 |
| 输出宽度 | 0 ~ 3840 | 0 表示保持原宽；填了就等比缩放到该宽度。 |
| 输出格式 | PNG / JPG / WebP | JPG 质量 -q:v 2，WebP -q:v 80。 |
6.2 图片编码转换
把图片的字节流直接转成文本形式，方便贴进代码或配置文件。任意图片格式都能读。
| 目标编码 | 说明 |
|---|---|
| Base64 | 每 6 位一个字符，最常用，适合嵌 HTML / CSS / JSON。 |
| Base32 | 每 5 位一个字符，全大写，容错好。 |
| 十六进制 | 每字节两个十六进制字符。 |
| 二进制 | 每字节 8 个 0/1，最长但最直观。 |
.txt 文本文件，命名如 demo_base64.txt，可以直接双击打开查看。07文件工具
7.1 文件编码转换
在 UTF-8 / GBK / UTF-16 等编码间批量转换文本、代码、文档。适合解决「中文乱码」「Windows 记事本打开是乱码」这类问题。
- 添加文件：txt / md / json / 代码 / csv / log 等都能加，可多选，支持批量。
- 选源编码：拿不准就选「自动检测」，程序会按 BOM 和字节特征判断。
- 选目标编码：常用 UTF-8（不带 BOM）或 UTF-8 带 BOM（给 Windows 老软件用）。
- 开始转换：输出
原名_conv.扩展名，不覆盖原文件。
| 支持的编码 | 备注 |
|---|---|
| UTF-8 / UTF-8 带 BOM | 现代默认，BOM 版兼容旧 Windows 程序 |
| GBK / GB2312 | 简体中文旧标准 |
| Big5 | 繁体中文 |
| UTF-16 LE / BE | 宽字符，带字节序 |
| ASCII / Latin-1 / Shift-JIS | 单字节或日文本地编码 |
08设置
设置页管四件事：统一保存目录、检测更新、FFmpeg 状态、关于信息。
| 模块 | 说明 |
|---|---|
| 统一保存目录 | 设一个文件夹，所有工具优先往这里存。不清空就退回「源文件目录」。设置存在本机，重启仍生效。 |
| 检测更新 | 点「检查更新」会去 dmxiaozi.xyz/tools/update.json 读版本号和下载地址；有新版会显示说明并给「立即更新并重启」按钮，下载带进度（MB / 速度 / 剩余）。 |
| FFmpeg 状态 | 显示当前 FFmpeg 路径。查找顺序：程序目录 → 程序目录\tools\ → 内嵌资源自动释放。全部本地，不上传。 |
| 程序目录 | 显示 exe 所在位置，可一键打开。 |
| 关于 | 作者、官网、B 站、版本号、技术栈（C++ / Win32 / WebView2 / FFmpeg）。 |
09常见问题
Q：点开始没反应 / 一直转圈？
先看底部日志。如果提示「未找到 ffmpeg.exe」，说明首次释放没成功，去设置页看 FFmpeg 路径，或重装一次。同一时间只能跑一个任务，上一个没跑完下一个会排队禁用。
Q：字幕烧录失败？
九成是字幕文件路径带了空格。把字幕文件挪到不带空格的路径再选一次就好。
Q：GIF 太大 / 太糊？
太大就调低宽度（如 320）或帧率（如 10），并缩短时长；太糊就打开「高质量调色板」两遍合成。
Q：转换后的文件去哪了？
按「工具内目录 > 统一目录 > 源目录」的优先级找。文件命名都带后缀，不会覆盖原文件。
Q：需要联网吗？
除「检测更新」和「立即更新」外，其余功能全本地运行，断网照常使用。
10技术说明
给想了解底层实现的朋友：程序主体是 Win32 窗口程序，内嵌 WebView2 承载前端界面，前端通过 chrome.webview.postMessage 把操作指令（JSON）发给 C++ 层，C++ 层拼出 FFmpeg 命令行、捕获进度与日志再回传。所有转码都是同步起进程 + 异步读输出，进度按 time= 推算百分比。
如果这份文档有没讲清楚的地方，或者你希望加某个工具、某个参数，欢迎通过官网或 B 站联系我们 —— 牢尘lc星闪工作室会持续把它打磨得更顺手。