声页 Soundleaf v1.2.0

声页 v1.2.0

本次增加 CPU 本地语音合成与模型管理，并修复未保存编辑、成品更新状态、重复操作及任务恢复等问题。

新增与改进

• Kokoro 内置音色、ZipVoice 参考音频音色克隆、模型下载与管理；可切换云端与本地语音引擎。
• 保存期间继续编辑不会被旧响应覆盖，忽略 AI 分段建议保留草稿。
• 修复生成期间修改中文读音词典或角色音色后的过期判断，避免混合旧配置的成品被误认作最新。
• 重复 AI 分章能显示新结果，切书会取消旧音频的在途加载。
• 远端请求状态持久化，重启后对未知结果进入待确认；封面提交与清理共享锁。
• 改善手机设置标签，修正对比度审计，补充回归测试和统一版本门禁。
• 绿联上架描述同步真实功能，说明云端费用、本地模型下载及设备能力边界，不作第三方授权、合作或认证宣称。

安装资源

• GHCR 镜像：ghcr.io/panda-995/soundleaf:1.2.0，支持 linux/amd64 与 linux/arm64；latest 指向本次版本。
• 绿联 UGOS Pro UPK：按 NAS 架构选择 amd64 或 arm64，套件版本 1.2.0.0003。
• Soundleaf-1.2.0-deploy.zip：版本固定的 Compose、配置示例、部署说明、更新日志及绿联描述。
• SHA256SUMS：Release 安装资源校验值。Source code 由 GitHub 提供。

升级

升级前停止实例并完整备份原数据目录，包括 studio.sqlite3、secret.key、WAL/SHM 与文件子目录。保持原挂载目录和访问权限，再更新镜像或安装新 UPK；不要同时运行两个实例共用数据。

v1.1.0 数据采用增量迁移，旧账号、加密设置、书籍、音频、封面、角色、词典、播放进度、问题标记与导出均可保留。新增的任务请求状态不需要重新导入。中断且可能已计费的远端任务需要用户确认后再重试。

本地模型需另外下载。云端合成、AI 分析和封面生成使用用户自配接口，可能产生费用。模拟服务集成验证不等同于真实付费服务音质或 NAS 实机验证。

发布前验证

• 完整后端测试 115 项通过，包括 v1.1.0 真实存储实现创建的数据升级验证。
• 浏览器主流程 13 项、编辑竞态回归 4 项、对比度测试 2 项通过；10 页面、双主题、三种宽度 UI 检查通过。
• Ruff、TypeScript/Vite、版本校验与工作流 YAML 检查通过。
• 本机已有 Kokoro 与 ZipVoice 模型实际生成三份有效 WAV，验证 CPU 合成与参考音频克隆链路。
• 发布流水线另行验证 amd64/arm64 原生启动、旧数据升级与重启持久化；绿联 UPK 会校验安装参数和自定义目录映射。

已完成发布验收

• 功能、浏览器与容器 CI 全部通过，后端 115 项测试通过。
• 双架构镜像发布 成功；amd64/arm64 原生启动、v1.1.0 数据升级、重启持久化及目录权限场景通过。
• 1.2.0 与 latest 已验证可公开拉取，均含两个 Linux 架构，清单 digest 为 sha256:99e4c8f5761f45675276c6fa7906634d6f36291ca0670dc05d1218a93093486b。
• 绿联打包流程 成功；两份 UPK 的版本、395 字中文描述、英文描述、图标、数据文件夹参数及内嵌镜像已检查，下载哈希与 GitHub 资源 digest 一致。
• 两份 UPK、部署 ZIP 及校验文件均已更新；不包含安卓客户端。

声页 Soundleaf v1.1.0

声页 Soundleaf 首个公开发布版本：自托管小说有声书制作工作室。

功能

• TXT / 未加密 EPUB 上传、自动分章，导入时支持编辑、拆分、合并、排序和排除章节
• 逐章或批量生成；AI 自动标注对白与旁白、分配角色音色与 21 种情绪风格，原文逐字符校验
• 书级角色库：登记全书角色、一键绑定/更换音色并批量重生成受影响章节，音色跨章节一致
• 读音词典：在 AI 导演页划选正文直接修正多音字、人名、地名读音，合成时自动应用
• 片段级重生成：改完一句话，几秒内只重合成该段并就地拼接
• M4B 章节有声书（AAC + 章节导航 + 封面元数据）/ 逐章 MP3、WAV 打 ZIP 导出
• 响度归一化：跨角色/旁白/情绪音量听感一致
• 听书端：全局快捷键、真实波形、倍速、播放进度记忆、持久化任务队列
• 界面中英双语

安装

绿联 UGOS Pro

下载对应架构的 UPK，在应用中心选择手动安装：

• amd64_com.panda.soundleaf_1.1.0.0001.upk（x86 机型，如 N100）
• arm64_com.panda.soundleaf_1.1.0.0001.upk（ARM 机型）
• SHA256SUMS-UPK：两个 UPK 的 SHA-256 校验值

安装向导中选择数据文件夹（可留空使用应用内置目录），装完访问 http://NAS的IP:8780，默认账户 admin / admin，首次登录强制修改密码；语音与 AI 服务在设置页填写。详见 ugreen/README.md。

Docker

docker run -d --name soundleaf -p 8780:8780 -v /path/to/data:/data ghcr.io/panda-995/soundleaf:latest

镜像为 amd64 / arm64 双架构，固定版本 tag：ghcr.io/panda-995/soundleaf:1.1.0。单账户、单容器、单数据目录，无需 GPU。

说明

• 首次登录后请在「设置 → 语音服务」填写 MiniMax 或兼容 /audio/speech 的服务密钥，AI 分析支持兼容 /chat/completions 的服务；不配置 AI 也能手动制作
• 密钥仅由服务端加密保存；云端分析与合成可能产生费用
• 数据备份请完整复制数据目录（含 studio.sqlite3 与 secret.key）

更新记录

• 构建 0002（当前）：修复绿联 UGOS Pro 上数据文件夹属主无法接管时的启动崩溃循环。现会自动探测数据目录可写性：优先以非 root 应用账户运行，chown 被拒绝时改以可写的目录属主运行，仍不可写时按 ALLOW_ROOT_DATA_FALLBACK（UPK 默认开启）以容器 root 继续运行；彻底不可写时以退出码 73 给出明确错误。旧 0001 包已移除，请重新下载安装 0002。