186 lines
4.2 KiB
Markdown
186 lines
4.2 KiB
Markdown
# 版本发布说明 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
|