mirror of https://github.com/CherryHQ/cherry-studio.git synced 2026-07-06 22:55:56 +08:00

Files

fullex 53a3577389 refactor(renderer): flatten src/renderer/src to src/renderer

Move all renderer source from src/renderer/src/* up one level to
src/renderer/*, removing the redundant nested src directory.

- Update path aliases (@renderer, @types, @logger, @data) and TanStack
  Router paths in electron.vite.config.ts; update tsconfig.{json,web,node}
  path mappings and include globs.
- Fix Vite root-relative script paths in the 8 renderer HTML entries.
- Update cross-process relative imports in main/preload (language,
  apiServer models, preload index) to drop the /src segment.
- Switch renderer test imports of the logger mock to the @test-mocks alias.
- Update hardcoded renderer paths in scripts and their fixtures, lint
  configs (eslint/oxlint/biome), CODEOWNERS, docs, and the data-classify tool.
- Convert deep (../../+) relative imports within the renderer to the
  @renderer alias (69 files, 108 imports); keep single-level relatives.
- Fix doc links broken by the move and correct one pre-existing broken
  link in naming-conventions.md.

2026-05-28 21:40:20 -07:00

2.5 KiB

Raw Permalink Blame History

笔记功能的文件树处理方式（现有实现）

本文档说明当前版本笔记功能如何管理文件树，包括存储位置、树结构加载、文件监听与文件操作路径。

存储位置与路径来源

笔记根目录来自 window.api.getAppInfo().notesPath。
notesPath 存在于 Redux（store/note），通过 useNotesSettings 读写。
main 侧默认目录由 getNotesDir() 创建。

文件树的构建与刷新

页面加载后调用 loadTree(notesPath) 获取目录结构。
loadTree 通过 window.api.file.getDirectoryStructure 读取真实文件系统树。
sortTree 按用户设置排序（A-Z、更新时间等）。
mergeTreeState 会把 starredPaths 与 expandedPaths 合并回树节点状态。

文件监听与同步

进入笔记页后，通过 window.api.file.startFileWatcher(notesPath) 启动监听。
监听事件来自 main 进程 FileStorage 的 chokidar watcher。
发生变更时触发 tree refresh，并更新 starred/expanded 状态。

文件与目录操作

新建目录：addDir -> window.api.file.mkdir。
新建笔记：addNote -> window.api.file.write（写入 .md）。
删除节点：delNode -> deleteExternalFile / deleteExternalDir。
重命名：renameNode -> file.rename / file.renameDir。

所有操作直接作用于文件系统，不经过 db.files。

上传处理

笔记只接受 Markdown 文件（.md, .markdown）。

上传路径：

拖拽或选择文件 -> useNotesFileUpload 收集文件列表。
uploadNotes 优先使用 main 侧批量上传：
- window.api.file.batchUploadMarkdown(filePaths, targetPath)
- 上传前暂停 watcher，上传后恢复并刷新。
若文件没有路径（浏览器 File API），回退到 renderer 逐个写入（uploadNotesLegacy）。

内容保存策略

编辑器内容通过防抖写入：window.api.file.write(targetPath, content)。
写入后刷新缓存，确保下次读取到最新内容。

与文件页面的关系

笔记文件树完全基于文件系统，不写入 db.files。
文件页面（/files）仅展示 db.files 中的记录，因此不会显示笔记文件。

限制与现状

笔记文件树依赖文件系统扫描与 watcher，同步逻辑分散在页面内。
与 db.files 的文件引用体系割裂，难以统一检索或跨业务归档。

2.5 KiB Raw Permalink Blame History Unescape Escape