Legado阅读器替换规则执行结果可视化方案解析

在电子书阅读应用Legado中，文本替换功能是用户常用的核心功能之一，它能够帮助用户按照预设规则自动修改书籍内容。然而，当前版本存在一个明显的用户体验痛点——替换规则执行后，用户无法直观查看具体的替换结果，这在复杂规则或批量替换场景下尤为突出。

功能现状分析

Legado现有的替换规则系统虽然功能完备，但缺乏执行结果的反馈机制。当用户设置如"中文数字转换"这类规则时，系统确实会执行替换操作，但用户界面没有提供任何关于"哪些内容被替换了"、"替换是否正确"的视觉反馈。这种设计缺陷导致用户需要手动翻查书籍内容来验证规则效果，极大地降低了使用效率。

技术实现方案

执行结果记录模块

需要在替换引擎中新增一个日志记录组件，该组件应当捕获以下关键信息：

1. 原始文本片段
2. 替换后文本
3. 匹配的规则标识
4. 精确的时间戳
5. 规则匹配的具体参数（如正则表达式捕获组）

可视化界面设计

建议采用二级页面的形式展示替换历史，界面布局可考虑：

• 时间轴方式组织替换记录
• 支持按规则类型筛选
• 提供文本对比视图（原文本与替换文本并排显示）
• 添加搜索功能，便于定位特定替换记录

数据结构设计

为实现这一功能，后端需要维护一个替换记录队列，建议采用如下数据结构：

class ReplacementLog {
    String ruleId;          // 规则标识
    String originalText;    // 原始文本
    String replacedText;    // 替换后文本
    long timestamp;         // 时间戳
    Map<String, String> params; // 匹配参数
}

考虑到移动设备资源限制，建议实现以下优化：

• 采用LRU缓存策略，保留最近N条记录
• 支持手动清除历史记录
• 对大文本替换进行摘要显示（如只显示前后20个字符）

性能考量

在实现过程中需要注意：

1. 记录操作应当异步执行，避免阻塞主线程
2. 文本对比需要处理可能存在的超长行情况
3. 频繁替换场景下的内存管理
4. 列表渲染时的性能优化（如虚拟滚动）

用户体验提升

该功能的加入将显著改善以下场景的用户体验：

• 调试复杂正则表达式规则时，可以直观看到匹配结果
• 批量替换后快速验证是否所有预期内容都被正确处理
• 学习替换规则时，通过历史记录理解规则实际效果
• 发现意外替换时，便于追溯问题原因

扩展性思考

未来可考虑进一步扩展该功能：

1. 添加"撤销单次替换"操作
2. 支持导出替换记录用于分享或调试
3. 添加替换统计信息（如共执行多少次替换）
4. 与规则测试工具集成，形成完整的规则开发环境

通过实现替换结果可视化功能，Legado将提供一个更加透明、可控的文本替换体验，帮助用户更高效地管理和优化他们的阅读内容。这种改进不仅解决了当前的痛点，也为未来更高级的文本处理功能奠定了基础。