代码阅读助手 (Code Reading Assistant)
中文介绍
解决的问题: 在阅读大型代码库或复杂项目时，是否经常忘记"这段代码我看过了吗？"很容易丢失阅读进度，导致重复阅读同一段代码或遗漏重要部分。
🚀 代码阅读助手 是一个VS Code扩展，通过可视化标记已读/未读行、维护阅读进度、生成代码调用关系图等功能，帮助开发者高效地阅读和理解代码。
✨ 主要功能
📖 阅读模式切换
- 一键启用/禁用阅读跟踪功能
- 快捷键:
Ctrl+Shift+R (Mac: Cmd+Shift+R)
🎯 智能光标跟踪
- 自动标记: 光标移动时自动标记已读行
- 手动标记: 通过快捷键手动标记特定行
- 智能过滤: 只跟踪非空的、有意义的代码行
📊 实时进度显示
- 活动栏显示文件阅读进度
- 状态栏显示当前文件统计信息
- 可视化高亮显示已读/未读行
🗂️ 进度管理
- 查看整个工作区的阅读进度
- 文件夹级别的进度统计
- 一键清除已读标记
- 快捷键:
Ctrl+Shift+D 清除当前文件标记
📈 代码结构分析
- 生成代码调用关系图
- 支持多种编程语言 (JavaScript/TypeScript, Python, Java, C/C++, Go, Rust, PHP, Ruby, C#)
- 美观的Mermaid图表显示
🌍 国际化支持
- 支持中文/英文界面
- 语言设置实时生效，无需重启
- 自动检测VS Code语言环境
English Description
Problem Solved: Ever found yourself staring at code wondering "Have I read this section before?" When exploring large codebases or complex projects, it's easy to lose track of what you've already reviewed, leading to wasted time re-reading the same code or missing important sections entirely.
🚀 Code Reading Assistant is a VS Code extension that helps developers efficiently read and navigate code by visually tracking read/unread lines, maintaining reading progress, and improving code comprehension workflow.
✨ Key Features
📖 Reading Mode Toggle
- One-click enable/disable reading tracking
- Keyboard shortcut:
Ctrl+Shift+R (Mac: Cmd+Shift+R)
🎯 Smart Cursor Tracking
- Auto-marking: Automatically marks lines as read when cursor moves through them
- Manual marking: Mark specific lines with keyboard shortcuts
- Intelligent filtering: Only tracks non-empty, meaningful code lines
📊 Real-time Progress Display
- Status bar indicator: Shows current file's reading progress in real-time
- Progress statistics: Displays read lines/total lines and completion percentage
- Detailed view: Click status bar for comprehensive progress information
🎨 Customizable Visual Themes
- Read marker: Green background (customizable)
- Unread marker: Red/Orange background (customizable)
- Opacity control: Adjustable transparency from 0.1 to 1.0
- Color configuration: Full hexadecimal color code support
📁 Multi-file State Management
- Independent tracking: Each file's reading state is saved separately
- Smart switching: Automatically restores reading state when switching files
- Persistence: Reading progress survives VS Code restarts
- Change adaptation: Intelligently adjusts line mappings when code is modified
🌳 Project Progress Tree View
- Complete file overview: Shows all file types (code, images, documents, etc.)
- Progress visualization: Each file and folder displays reading progress percentage
- Color-coded status: 🔴 0% (not started), 🟡 1-99% (in progress), 🟢 100% (completed)
- Smart handling: Code files tracked line-by-line, media files marked complete on open
- One-click access: Direct file opening with VS Code preview support
- Intelligent filtering: Excludes only temporary and system files
- ▶️ Toggle switch: Enable/disable entire extension functionality
- 🗑️ Clear progress: Reset all file reading progress (with confirmation)
- 🔄 Refresh tree: Manually refresh the progress tree display
- ⚙️ Open settings: Quick access to extension configuration
- 📊 Generate structure: Create code call graph visualizations
🌍 Multi-language Support
- Auto-detection: Follows VS Code's language settings
- Complete localization: Full Chinese and English interfaces
- Command localization: All command palette entries support multiple languages
- Configuration localization: Setting descriptions in multiple languages
📈 Code Structure Analysis
- Call graph generation: Visualize function call relationships
- Multiple formats: Mermaid diagrams, Graphviz DOT, text trees
- Multi-language support: TypeScript/JavaScript, Python, Java, C/C++, Go, Rust, PHP, Ruby, C#, and more
- Interactive HTML preview: Rich visualization with statistics and save options
| |
