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

版本发布说明 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 个临时/过时文档

技术栈变更

新增依赖

{
  "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. 拉取最新代码

   git fetch origin
   git checkout v0.2.1
   

2. 安装依赖

   cd web
   npm install
   

3. 构建项目

   wails build
   

兼容性说明

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

已知问题

暂无

下一步计划

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

反馈与支持

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