# 24 维护、故障定位、性能和当前限制

听文视频工作台 · 技术架构与实现 · 1.0.2

## 定位顺序

- 启动层：查看Activity/Service的starting/ready/error、资源拷贝、Python初始化与baseUrl；不能先把3秒动画慢解释为TTS问题。

- 会话层：确认当前源、Android密钥Cookie和local token；仅明确过期拒绝可恢复一次。

- 任务层：核对保存快照、三阶段state、paused/cancelled、ACTIVE冲突及image_version。

- 语音层：看part完成数量、partial、等待消息和最后错误；分段重试遵守有限请求，不改旧任务正文。

- 图片层：区别decode/尺寸、URL公网与内容校验、云配置/未知结果；Seedream错误看官方code而不是只看429。

- 编码层：看cover、ffconcat、progress与video-log尾；确认尺寸/音轨/时长检查，pending不当成品。

- 导出层：确认文件已完成、路径白名单、系统URI选择和目标可写；分享目标支持MIME。

- 试用层：核对usage/migration_note、差异snapshot、receipt、是否已expired；不要自动删坏账重新发额度。

## 性能事实与容量

低静态帧率、veryfast和threads2减少编码负担是当前取舍，没有跨机型基准测试给出统一耗时。规范化高像素图片仍可能大，PNG背景/字体绘制在CPU上，软件编码耗时受时长、CPU与温度影响。语音依赖网络速度和服务响应，累计分段进度不代表剩余时间。

目前没有作业队列、自动媒体清理、容量水位控制、数据库压缩或日志轮转；每个任务保存原文/图片/分段/画面/成片，长时间使用会增加磁盘占用。设备磁盘满既可能影响任务保存，也可能影响试用账本/草稿，必须保留用户可读错误和现有素材。

## 未提供的功能与已知实现边界

- 没有离线TTS模型、IndexTTS/OmniVoice或Android系统TTS分支；没有克隆声音、任意SSML、语速音调UI。

- 没有字幕、ASR、按段落智能配图/配时、视频素材剪辑、背景音乐或转场编辑；保留CLI字幕选项不是APK功能。

- 没有PC本机Draw Things接入；保留检查路由在Android来源校验被拒绝。

- 没有账号登录、跨设备云同步、支付、激活/续期、设备永久试用绑定。

- 没有每次成片永久多版本快照；同任务最终路径可能被成功新成片替换。

- 无所有格式在API24均可读保证，无后台永不退出保证，无全编码总时限/无进度watchdog。

- 无整条数据的加密数据库，ledger是私有JSON；卸载/清数据会重置本机试用。

- 任务损坏JSON没有普遍逐文件恢复，依赖传递图未全hash锁定，share token映射无固定TTL清理。

Android前台服务类型和系统约束随版本变化，项目实际声明specialUse，不能因为存在前台通知而宣称通过所有应用商店政策审核或可无限后台运行。Android前台服务类型文档提供平台背景，实际交付仍需目标系统验收。

---
招商合作微信：wzqy2019。添加备注：听文合作。
原网页：https://tingwen-creator-studio-102.pages.dev/guide/technical-24