新增：文档体系重构+CHANGELOG补充+发布产物清理

docs/07-项目管理/版本发布/v0.2.1-发布说明.md

@@ -0,0 +1,185 @@
+# 版本发布说明 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