lxy/u-desk
Private
Public Access
1
0
Fork 0
Code Activity
Files
6eaaa56eb65578647511ac7cc163949f2c5863b2
u-desk/docs/07-项目管理/版本发布/v0.2.1-发布说明.md

4.2 KiB
Raw Blame History

版本发布说明 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
View Git Blame Copy Permalink