docs: emphasize dual implementation replacement (HtmlView + RichText)

Update all planning documents to clearly specify that RichView replaces
TWO different existing implementations:

1. HtmlView (WKWebView) - for topic content in NewsContentView
2. RichText (NSAttributedString) - for reply content in ReplyItemView

Updates to richtext_plan.md:
- Expanded background section detailing both current implementations
- Added specific problems for each implementation
- Updated goals to emphasize unification benefits
- Restructured Phase 4 with separate sections for:
  - 4.1 Topic content migration (HtmlView → RichView)
  - 4.2 Reply content migration (RichText → RichView)
  - 4.3 UI adaptation, 4.4 Interaction testing, 4.5 Degradation

Updates to richview_api.md:
- Completely rewritten migration guide with two sections
- Added side-by-side comparison table (HtmlView vs RichText vs RichView)
- Provided complete before/after code examples for both use cases
- Added migration checklists for both implementations
- Documented configuration differences (.default vs .compact)

These changes clarify the full scope: unifying two inconsistent
implementations into a single, high-performance module with consistent
features (code highlighting, @mentions, image preview) across both
topic and reply content.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: graycreate

.plan/richtext_plan.md

@@ -3,20 +3,58 @@
 ## 📌 项目概述
 
 ### 背景
-当前 V2er-iOS 使用 WKWebView 渲染帖子详情页的 HTML 内容，存在以下问题：
-- 性能开销大，每个回复一个 WebView
-- 内存占用高，容易出现内存问题
-- 滚动性能差，多个 WebView 导致卡顿
-- 高度计算延迟，导致界面跳动
+
+当前 V2er-iOS 在两个地方使用不同的方式渲染 V2EX HTML 内容，都存在性能和功能问题：
+
+#### 1. 帖子内容（NewsContentView）
+- **实现**: `HtmlView` - 基于 WKWebView
+- **问题**:
+  - 性能开销大，WebView 初始化慢
+  - 内存占用高（每个 WebView ~20MB）
+  - 高度计算延迟，导致界面跳动
+  - JavaScript 桥接复杂，维护困难
+
+#### 2. 回复列表（ReplyItemView）
+- **实现**: `RichText` - 基于 NSAttributedString HTML 解析
+- **问题**:
+  - 不支持代码语法高亮
+  - 不支持 @mention 识别和跳转
+  - 不支持图片预览交互
+  - 渲染效果与帖子内容不一致
+
+#### 统一问题
+- 两套实现维护成本高
+- 功能不一致，用户体验割裂
+- 都缺少缓存机制
+- 都不支持完整的 V2EX 特性（@mention、代码高亮等）
 
 ### 目标
-使用 HTML → Markdown → swift-markdown + Highlightr 方案，实现高性能、原生的富文本渲染。
+
+使用统一的 **RichView** 模块替换现有的两套实现：
+- ✅ 统一渲染引擎: HTML → Markdown → swift-markdown + Highlightr
+- ✅ 统一交互体验: @mention、图片预览、代码高亮
+- ✅ 统一配置管理: 支持不同场景的样式配置（帖子 vs 回复）
+- ✅ 统一缓存策略: 自动缓存，提升列表滚动性能
 
 ### 预期收益
-- **性能提升**: 10x+ 渲染速度，流畅滚动
-- **内存优化**: 减少 70%+ 内存占用
-- **用户体验**: 消除界面跳动，即时显示
-- **可维护性**: 标准化代码，易于扩展
+
+#### 性能提升
+- **帖子内容**: 10x+ 渲染速度（WKWebView → Native）
+- **回复列表**: 3-5x 渲染速度（支持缓存 + 优化）
+- **内存优化**: 减少 70%+ 内存占用（移除 WebView）
+- **滚动流畅**: 60fps 稳定帧率，无卡顿
+
+#### 功能增强
+- **代码高亮**: 支持 185+ 编程语言语法高亮
+- **@mention**: 自动识别并支持点击跳转
+- **图片预览**: 内置图片查看器，支持手势缩放
+- **一致体验**: 帖子和回复使用相同渲染效果
+
+#### 开发体验
+- **统一 API**: 一套代码适用于所有场景
+- **易于维护**: 移除 WebView 和 JavaScript 桥接
+- **类型安全**: Swift 原生实现，编译时检查
+- **可扩展**: 模块化设计，易于添加新功能
 
 ---
 
@@ -504,33 +542,88 @@ Models/ + Extensions/
 - 内存占用减少 70%+
 - 流畅滚动 (60fps)
 
-### Phase 4: 集成与测试 (2天)
+### Phase 4: 集成与测试 (2-3天)
 
-**目标**: 集成到现有项目，A/B 测试
+**目标**: 集成到现有项目的两个使用场景，实现统一渲染
 
 **任务**:
-- [ ] 替换 FeedDetail 页面的 HtmlView
-  - [ ] 保留 WebView 作为降级方案
-  - [ ] Feature Flag 控制切换
-- [ ] 集成到回复列表
-- [ ] UI 适配
-  - [ ] 字体大小适配
-  - [ ] Dark Mode 适配
-  - [ ] 行距和段距调整
-- [ ] 完整测试
-  - [ ] 各类帖子内容测试
-  - [ ] 交互功能测试
-  - [ ] 降级场景测试
-- [ ] 文档编写
-  - [ ] 代码注释
-  - [ ] README 更新
-  - [ ] 架构文档
+
+#### 4.1 替换帖子内容渲染（NewsContentView）
+- [ ] 将 `HtmlView` 替换为 `RichView`
+  - [ ] 移除 `imgs` 参数（自动从 HTML 提取）
+  - [ ] 使用 `.default` 配置
+  - [ ] 实现事件处理（链接、图片、@mention）
+  - [ ] 保留 `rendered` 状态绑定
+- [ ] Feature Flag 控制
+  - [ ] 添加 `useRichViewForTopic` 开关
+  - [ ] 降级逻辑：失败时回退到 HtmlView
+- [ ] 测试
+  - [ ] 纯文本帖子
+  - [ ] 包含图片的帖子
+  - [ ] 包含代码的帖子
+  - [ ] 包含 @mention 的帖子
+  - [ ] 混合内容帖子
+
+#### 4.2 替换回复内容渲染（ReplyItemView）
+- [ ] 将 `RichText` (Atributika) 替换为 `RichView`
+  - [ ] 使用 `.compact` 配置（更小字体、更紧凑间距）
+  - [ ] 实现事件处理
+  - [ ] 适配回复列表布局
+- [ ] Feature Flag 控制
+  - [ ] 添加 `useRichViewForReply` 开关
+  - [ ] 降级逻辑：失败时回退到 RichText
+- [ ] 性能测试
+  - [ ] 回复列表滚动流畅度（60fps）
+  - [ ] 缓存命中率监控
+  - [ ] 内存占用对比测试
+- [ ] 测试
+  - [ ] 短回复（< 100 字符）
+  - [ ] 长回复（> 1000 字符）
+  - [ ] 包含代码的回复
+  - [ ] 包含 @mention 的回复
+  - [ ] 列表滚动性能（100+ 回复）
+
+#### 4.3 UI 适配
+- [ ] 字体大小适配
+  - [ ] 帖子内容: fontSize = 16
+  - [ ] 回复内容: fontSize = 14（compact 配置）
+- [ ] Dark Mode 适配
+  - [ ] 文本颜色自动适配
+  - [ ] 代码高亮主题切换
+  - [ ] 链接颜色适配
+- [ ] 行距和段距调整
+  - [ ] 与现有 UI 保持一致
+  - [ ] 适配不同屏幕尺寸
+
+#### 4.4 交互功能测试
+- [ ] 链接点击
+  - [ ] 外部链接在浏览器打开
+  - [ ] 内部链接应用内导航
+- [ ] 图片预览
+  - [ ] 单击显示图片查看器
+  - [ ] 支持手势缩放
+  - [ ] 支持关闭
+- [ ] @mention 跳转
+  - [ ] 点击跳转到用户主页
+  - [ ] 正确解析用户名
+- [ ] 文本选择
+  - [ ] 支持长按选择
+  - [ ] 支持复制
+
+#### 4.5 降级测试
+- [ ] 超大内容降级（>100KB）
+- [ ] 包含不支持标签的内容降级
+- [ ] 渲染错误时降级
+- [ ] 验证降级后功能正常
 
 **验收标准**:
-- 所有现有功能正常工作
-- UI 与现有设计一致
-- 无明显 Bug
-- 降级方案可用
+- ✅ 帖子内容和回复内容均使用 RichView
+- ✅ 所有交互功能正常工作
+- ✅ UI 与现有设计一致
+- ✅ 回复列表滚动流畅（60fps）
+- ✅ 缓存命中率 > 80%
+- ✅ 降级方案可用且功能完整
+- ✅ 无明显性能或内存问题
 
 ### Phase 5: 发布与监控 (1天)