产品概述

  小说文本清洁器是一款专为小说阅读爱好者打造的 Android

  原生应用，能够智能清洗 TXT 小说文件中的广告、网址、乱码和多余空行，为

  听书软件提供纯净的文本内容。无论是网络小说、传统小说还是电子书，都可以

  通过一键清洗，获得干净整洁的文本，提升阅读和听书体验。

  开发环境及工具

   - 开发工具：Android Studio Hedgehog （2023.1.1） 或更高版本

   - Gradle 版本：8.7.3

   - Kotlin 版本：2.1.0

   - JDK 版本：11

   - 支持系统：Android 12 （API 31）

   - 目标系统：Android 15 （API 35）

   - 推荐内存：4GB 以上

  技术架构

  开发语言

   - Kotlin：Google 官方推荐的 Android 开发语言，简洁安全

  UI 框架

   - Jetpack Compose：Android 声明式 UI 框架，代码简洁，性能优异

  架构模式

   - MVVM （Model-View-ViewModel）：清晰的架构分层，易于维护和扩展

  异步处理

   - Kotlin Coroutines：协程处理，不阻塞主线程，用户体验流畅

  核心功能详解

  1. 文件选择

   - 支持从手机文件管理器选择本地 TXT 小说文件

   - 自动读取文件名和文件大小

   - 支持外部打开文件（直接分享到APP）

   - 文件大小限制：30MB 以内

  2. 智能清洗

  一键点击即可自动清洗文本，支持的清洗规则包括：

  网址链接清理

   - http/https 开头的网址

   - www 开头的网址

   - 域名链接

  广告推广清理

   - 下载APP、软件下载推广

   - 扫码关注、公众号推广

   - 加群推广（QQ群、微信群）

   - 社交媒体关注推广（抖音、快手、B站、微博）

   - 官网访问、官方网站推广

  特殊符号清理

   - emoji 表情符号

   - 各种特殊字符和装饰符号

   - 括号内的广告内容（保留书名号《》内的章节名）

  文本优化

   - 多余空格和空白字符

   - 连续空行（最多保留一行空行）

   - 过短的无意义行

   - 乱码文本

  3. 实时预览

   - 清洗完成后提供前500字符预览

   - 显示清洗后文本总字符数

   - 可滚动查看更多内容

   - 实时确认清洗效果

  4. 清洗统计

  展示详细的清洗数据：

   - 原始文件大小

   - 清洗后文件大小

   - 文件减少百分比

   - 移除的行数

   - 帮助用户了解清洗效果

  5. 文件保存

   - 将清洗后的文本保存为新的 TXT 文件

   - 自动在原文件名后添加"_cleaned"后缀

   - 支持选择保存位置

   - 保持原文件编码（自动检测 UTF-8 或 GBK）

  6. 进度显示

   - 大文件处理时显示实时进度百分比

   - 进度条显示处理状态

   - 提升用户体验，避免等待焦虑

  清洗规则详解

  网址清理

  应用使用正则表达式匹配并移除以下类型的网址：

   - 完整 URL（http:// 或 https:// 开头）

   - www 开头的网址

   - 域名链接（如 example.com）

  广告清理

  识别并清理以下类型的广告内容：

   - 扫码关注、二维码推广

   - 公众号关注推广

   - 下载APP、客户端下载推广

   - 限时特价、优惠活动推广

   - 社交媒体关注（抖音、快手、B站、微博）

  符号清理

  移除各类干扰阅读的符号：

   - emoji 表情符号

   - 特殊装饰符号（★☆◆◇■□等）

   - 各类箭头和标记符号

   - 不影响内容的括号内文字

  文本优化

   - 合并多余空格

   - 处理连续空行

   - 移除过短行（少于2个字符）

   - 保留书名号《》内的章节标题

  性能优化

  内存优化

   - 逐行处理大文件，避免一次性加载全部内容到内存

   - 流式读写文件，降低内存占用

   - 针对 4GB 内存设备进行了特别优化

   - 支持 30MB 以内的大文件处理

  处理速度优化

   - 正则表达式预编译，提高匹配速度

   - 使用 Kotlin Coroutines 异步处理，不阻塞 UI

   - 每处理 1000 行更新一次进度，减少 UI 刷新开销

  编码支持

   - 自动检测文件编码（UTF-8、GBK）

   - 使用原始编码保存清洗后的文件

   - 支持多种中文编码格式

  适用场景

  小说阅读爱好者

   - 清洗网络小说中的广告和推广内容

   - 移除乱码和多余空行

   - 准备纯净文本导入听书软件

  文本处理需求

   - 清理各类文本文件中的无用内容

   - 格式化文档，提升可读性

   - 批量处理多个文件

  开发学习

   - 学习 Kotlin 和 Jetpack Compose 开发

   - 了解 MVVM 架构设计

   - 参考 Android 实践

  源码特点

  代码质量

   - 代码结构清晰，模块化设计

   - 详细的代码注释，易于理解

   - 遵循 Android 开发实践

   - 无多余依赖，开箱即用

  架构设计

   - MVVM 架构，职责分离

   - StateFlow 状态管理

   - ViewModel 业务逻辑处理

   - Compose UI 声明式界面

  可扩展性

   - 清洗规则可灵活配置

   - 易于添加新的清洗功能

   - 支持二次开发和定制

  隐私安全

  本地处理

   - 所有文本处理均在本地完成

   - 不上传任何文件到服务器

   - 不收集用户任何个人信息

   - 不需要网络权限

  安全性

   - 使用 Android 标准 API

   - 无第三方 SDK 依赖

   - 不涉及敏感权限申请

  包含内容

  完整项目源码

   - MainActivity.kt - 主界面

   - MainViewModel.kt - 业务逻辑

   - NovelTextCleanerTheme.kt - 主题配置

   - Color.kt - 颜色配置

   - Type.kt - 字体配置

  项目配置文件

   - build.gradle.kts - 构建配置

   - AndroidManifest.xml - 应用清单

   - gradle.properties - Gradle 属性

  可直接编译运行

   - 无需额外配置

   - 导入 Android Studio 即可运行

   - 支持真机和模拟器调试

  技术支持

  基础支持

   - 源码可正常编译运行

   - 提供基本使用问题解答

   - 协助解决环境配置问题

  售后说明

   - 源码功能与描述一致

   - 代码无硬性 bug

   - 不提供二次开发服务（如需可另议）

   - 不提供服务器部署服务（本APP为纯本地应用）

  目标用户

  个人用户

   - 需要清洗小说文本导入听书软件的用户

   - 需要清理网络小说中广告和乱码的读者

   - 对文本处理有需求的用户

  开发者

   - 学习 Kotlin 和 Jetpack Compose 的开发者

   - 需要 Android 开发参考的开发者

   - 准备进行二次开发的开发者

  学生

   - 需要 Android 毕设项目的学生

   - 学习移动应用开发的学生

   - 需要项目实战案例的学生

  产品优势

  功能完整

   - 涵盖文本清洗的所有核心功能

   - 实时预览和统计信息

   - 完善的错误处理和用户提示

  技术先进

   - 采用 Jetpack Compose UI 框架

   - Kotlin 开发，代码简洁安全

   - MVVM 架构，易于维护

  性能优异

   - 支持 30MB 大文件处理

   - 内存占用低，运行流畅

   - 针对 4GB 内存设备优化

  安全可靠

   - 纯本地处理，不上传服务器

   - 无需网络权限

   - 保护用户隐私

  版本信息

  当前版本：v1.0.0

  发布日期：2026-02-21

  更新日志

   - 初始版本发布

   - 支持基本的文本清洗功能

   - 文件选择和保存功能

   - 预览和统计功能

   - 针对 4GB 内存设备的优化