# 03 模块、目录与接口责任

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

源码模块 | 
核心责任 | 
主要输入／输出 | 

MainActivity.java | 
主WebView、开场覆盖层、原生桥、文件选择、保存/分享、返回键 | 
系统Intent／本机URL／导出路径 → 页面、URI、原生提示 | 

WorkbenchService.java | 
拷贝应用资源、启动Python/Flask、阶段通知、WakeLock | 
files根/native目录/随机密钥 → baseUrl与运行摘要 | 

StartupAnimationView.java与StartupTiming.java | 
Canvas科技蓝动画及首帧计时 | 
首帧时刻、页面ready → 是否揭示WebView | 

ExportPolicy.java | 
同源和文件路径二次校验 | 
URL/文件 → 安全判定 | 

ExportProvider.java | 
临时内容URI映射、只读访问 | 
token/文件名 → MIME、描述、只读文件描述符 | 

android_runtime.py | 
Android启动、实际视频worker、系统图像解码、导出解析 | 
Java调用、任务/Control → 本机服务与手机成片 | 

app.py | 
路由、任务schema、调度、状态、图片确认、历史和恢复 | 
JSON请求 → 任务JSON/媒体/日志 | 

speech.py | 
音色表、正文分段、受控流、有限重试、片段复用与拼接 | 
正文/音色/控制 → part文件/audio.mp3 | 

photo_import.py | 
Base64/图片验证、批次保护、PNG规范化、公网URL安全 | 
手机图/直链 → PNG字节与脱敏元数据 | 

seedream.py | 
方舟图像单次请求、结果未知分类、错误脱敏 | 
用户Key/模型/prompt → 单张PNG与模型元信息 | 

image_sources.py | 
来源注册与客户端选择 | 
环境/provider → 可用来源和客户端 | 

records.py | 
版本说明、安全事件日志、分页 | 
白名单字段 → events.jsonl/响应列表 | 

make_homepage_bg.py | 
标题规范化、计数、字体与海报布局 | 
原图/主副标题 → 标题画面 | 

compose_video.py | 
保留PC CLI；Android仅复用时间轴函数 | 
Android调用build_image_sequence → ffconcat | 

trial_limits.py（仅试用版） | 
累计账本、文字差异、照片凭据、迁移、失效联动 | 
新正文/新图片 → 持久usage及到期状态 | 

界面主业务脚本并非独立app.js：它位于templates/index.html的内联script，随后加载static/mobile.js改写手机端布局、导航及PC按钮行为。技术维护时必须同时查看模板、移动JS和移动CSS，单看原模板会把“打开文件夹”等PC文案误认为Android实际动作。

应用随包资源包括字体、26段试听、许可证、模板和静态文件。用户任务、运行日志、草稿、API Key和签名私钥不应进入源码归档或APK资源。文档中的数据结构与示例使用合成内容，不来自实际用户任务。

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