# 版本发布说明 v0.2.1

**发布日期**：2026-02-04
**Git 标签**：v0.2.1
**上一个版本**：v0.2.0

## 变更统计

- **文件变更**：130 个文件
- **代码行数**：+11,636 / -12,233
- **提交次数**：2 次

## 主要更新

### 🎯 核心功能

#### 1. 文件系统模块化架构重构

- 拆分单体 `FileSystem.vue` 组件（4241 行）
- 新增 9 个功能组件：
  - `ContextMenu.vue` - 右键菜单
  - `FileEditorPanel.vue` - 文件编辑面板
  - `FileItemRow.vue` - 文件列表行
  - `FileListPanel.vue` - 文件列表面板
  - `Sidebar.vue` - 侧边栏
  - `Toolbar.vue` - 工具栏
  - `BinaryInfo.vue` - 二进制文件信息
  - `CodeEditor.vue` - 代码编辑器
  - `MediaPreview.vue` - 媒体预览

- 新增 6 个 Composables：
  - `useCommonPaths.ts` - 常用路径管理
  - `useFavorites.ts` - 收藏夹管理
  - `useFileEdit.ts` - 文件编辑
  - `useFileOperations.ts` - 文件操作
  - `useFilePreview.ts` - 文件预览
  - `usePathNavigation.ts` - 路径导航

#### 2. Markdown 渲染增强

**Mermaid 图表支持**：
- 支持流程图、时序图、类图、状态图等
- 自动识别并渲染 ` ```mermaid ` 代码块
- 异步渲染，错误处理
- 深色/浅色模式自动适配

**代码语法高亮**：
- 支持 180+ 编程语言
- 集成 highlight.js
- GitHub Dark / GitHub 主题自动切换
- 未知语言自动降级为纯文本

#### 3. 主题适配优化

- 修复亮色模式下代码高亮看不清问题
- 修复暗色模式下 Mermaid 图表对比度问题
- 使用 CSS 变量管理主题色
- 简化样式结构

### 🔧 技术改进

#### 新增文件

```
internal/filesystem/
  └── content_detector.go          # 内容检测器

frontend/src/components/FileSystem/
  ├── components/                  # 9 个组件
  ├── composables/                 # 6 个 composables
  ├── index.vue                    # 主入口
  └── index-simple.vue            # 简化版入口

frontend/src/utils/
  ├── markedExtensions.ts          # Markdown 扩展
  ├── errorHandler.js              # 错误处理
  ├── fileTypeHelpers.js          # 文件类型辅助
  └── pathHelpers.js              # 路径辅助

frontend/src/types/
  └── file-system.ts              # 类型定义

frontend/
  ├── tsconfig.json                # TypeScript 配置
  └── .eslintrc.js                # ESLint 配置
```

#### 删除文件

```
docs/
  ├── PROJECT_STATUS.md           # 已废弃
  ├── components-analysis.md      # 已废弃
  ├── filesystem-*.md             # 多个临时报告
  └── 架构*.md                     # 架构文档

frontend/src/
  └── components/FileSystem.vue   # 单体组件
```

### 🐛 问题修复

1. **Mermaid 渲染问题**
   - 修复编辑/预览模式切换时 Mermaid 图表不渲染
   - 添加 DOM 更新后自动渲染机制
   - 使用 `nextTick` 确保渲染时机

2. **主题适配问题**
   - 修复亮色模式下代码高亮颜色看不清
   - 修复暗色模式下 Mermaid 文字和背景无法区分
   - 使用 `body[arco-theme*='dark']` 选择器精确控制

3. **代码结构问题**
   - 移除重复的样式定义
   - 合并共享的 CSS 规则
   - 使用 CSS 变量替代硬编码颜色

### 📚 文档更新

- 新增 `docs/代码审查/` 目录
- 整理历史报告文档
- 新增 `版本发布手册.md`
- 删除 27 个临时/过时文档

## 技术栈变更

### 新增依赖

```json
{
  "highlight.js": "^11.11.1",
  "marked": "^17.0.1",
  "mermaid": "^11.12.2"
}
```

### 升级依赖

- Vue: 3.5.x → 3.5.26
- Vite: 7.x → 7.3.0
- Arco Design Vue: 2.x → 2.54.0

## 升级指南

### 从 v0.2.0 升级到 v0.2.1

1. **拉取最新代码**
   ```bash
   git fetch origin
   git checkout v0.2.1
   ```

2. **安装依赖**
   ```bash
   cd web
   npm install
   ```

3. **构建项目**
   ```bash
   wails build
   ```

### 兼容性说明

- ✅ 完全向后兼容 v0.2.0
- ✅ 配置文件无需修改
- ✅ 数据结构无变化
- ✅ 用户数据不受影响

## 已知问题

暂无

## 下一步计划

- [ ] 性能优化
- [ ] 更多文件类型支持
- [ ] 国际化支持
- [ ] 插件系统

## 反馈与支持

- 问题反馈：GitHub Issues
- 功能建议：GitHub Discussions
