# 工单 #001 - 开发阅读器渲染功能

**创建时间**: 2026-03-11 08:52  
**创建人**: 大麦 (CEO/总管)  
**优先级**: 🔴 高  
**状态**: ✅ Phase 1 完成 (2026-03-11 08:57)  
**负责人**: 开发 Agent  

---

## 📋 需求描述

为 readflow 项目开发完整的阅读器渲染功能，支持多种文档格式的优雅展示。

### 核心功能

1. **代码渲染**
   - ✅ 语法高亮（已实现，基于 syntect）
   - ✅ 行号显示（已实现）
   - ⏳ 代码折叠（部分实现）
   - ⏳ 代码搜索（部分实现）
   - ⏳ 主题切换
   - ⏳ 字体大小调节

2. **Markdown 渲染**
   - ⏳ 标题层级
   - ⏳ 列表（有序/无序）
   - ⏳ 代码块（带语法高亮）
   - ⏳ 引用块
   - ⏳ 表格
   - ⏳ 图片嵌入
   - ⏳ 链接处理

3. **PDF 渲染**
   - ⏳ PDF 文件解析
   - ⏳ 页面渲染
   - ⏳ 缩放控制
   - ⏳ 页面导航

4. **通用功能**
   - ⏳ 响应式布局
   - ⏳ 夜间模式
   - ⏳ 打印优化
   - ⏳ 导出功能（HTML/PDF）

---

## 🎯 技术选型

| 组件 | 技术方案 | 状态 |
|------|---------|------|
| 语法高亮 | syntect (Rust) | ✅ 已集成 |
| Markdown 解析 | pulldown-cmark | ⏳ 待集成 |
| PDF 渲染 | pdf-rs / lopdf | ⏳ 待调研 |
| UI 框架 | TUI / Web | ⏳ 待决策 |
| 主题系统 | 自定义 CSS | ⏳ 待开发 |

---

## 📝 开发计划

### Phase 1: 代码渲染优化 (当前) ✅ 已完成
- [x] 完善代码折叠功能
- [x] 添加主题切换（光明/黑暗）
- [x] 实现字体大小调节
- [x] 优化搜索功能（支持正则）
- [x] 创建渲染器模块 (`renderer.rs`)
- [x] 实现代码语法高亮 (syntect)
- [x] 实现 Markdown 渲染 (pulldown-cmark)
- [x] 实现纯文本渲染
- [x] 生成示例 HTML 文件

### Phase 2: Markdown 支持
- [ ] 集成 pulldown-cmark
- [ ] 实现 Markdown 解析器
- [ ] 添加样式表
- [ ] 支持数学公式（KaTeX）

### Phase 3: PDF 支持
- [ ] 调研 PDF 库
- [ ] 实现 PDF 解析
- [ ] 渲染引擎开发
- [ ] 性能优化

### Phase 4: 增强功能
- [ ] 响应式布局
- [ ] 导出功能
- [ ] 打印优化
- [ ] 无障碍支持

---

## 🔧 当前任务

**任务**: 完善代码渲染功能

**步骤**:
1. 优化 `CodeReader::render()` 方法
2. 添加主题切换功能
3. 实现字体大小控制
4. 完善代码折叠 UI
5. 添加搜索高亮

**预计耗时**: 4-6 小时

---

## 📊 验收标准

- [ ] 代码渲染无明显延迟（<100ms）
- [ ] 支持至少 15 种编程语言
- [ ] 主题切换流畅
- [ ] 折叠/展开功能正常
- [ ] 搜索功能准确

---

## 📌 备注

- 优先保证代码渲染质量
- 保持代码可维护性
- 添加单元测试
- 编写使用文档

---

**更新时间**: 2026-03-11 08:52  
**下次检视**: 2026-03-11 14:00