lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1882db7681d30446f9912d7f2b32e56b1541a21d
mnote/bugs/04-tree-domain/done/4-46-filetree-editor-context-menu-download-v1.md
T
lix-2026 1956a8a21a chore: align mvp design governance 
- 统一 local-first MVP 后阶段架构口径，补充 process 执行总序和 Reasonix 协作记录

- 归档已完成的 design checklist，标注参考型 process，更新 AGENTS/REASONIX/架构文档

- 补充文件树/主编辑器下载与上下文菜单相关实现、bug 记录和 smoke 脚本

验证：git diff --check；codegraph sync .；cargo test -p mnote-web；node --check scripts/task476-filetree-editor-context-menu-download-smoke.js
2026-05-21 09:04:13 +08:00

4.5 KiB
Raw Blame History

4-46 FileTree / Editor Context Menu Download v1

状态：done

日期：2026-05-21

Owner：FileTree action layer / editor attachment context menu

1. 问题

  • 文件树 asset/resource 行右键菜单没有 下载 动作，虽然后端已有 /api/local-folder/files/open?download=true 下载入口。
  • 主编辑器附件当前主要依赖 hover 后的更多按钮打开附件菜单，真实右键附件链接没有复用同一套菜单。
  • 本地文件下载响应只有 Content-Disposition: attachment，缺少 filename，浏览器可能无法使用原文件名保存，中文文件名尤其不稳定。

2. 目标

  • 文件树 asset 右键菜单显示 下载。
  • 点击文件树 asset 下载时复用现有 attachment 下载链路，并记录 data-mnote-filetree-last-action=download / data-mnote-filetree-last-action-status=requested。
  • 文件树已选中多个 asset/resource 时，右键任一已选文件执行 下载 会批量下载当前选择集中的资源文件。
  • 文件树主 Markdown 文件行和本地文件夹行也应支持下载；文件夹下载为 .tar 包。
  • 文件拖到本地文件树文件夹时，应上传到该文件夹路径，不应因缺少 rootUri 或 documentId 报错。
  • 主编辑器附件右键打开附件 context menu，菜单内容与 hover 更多按钮一致。
  • 本地文件下载响应带 filename 与 filename*，支持中文文件名。

3. Checklist

  • 文件树 asset 菜单增加 download 动作。
  • handleTreeContextMenuAction 处理 filetree asset download。
  • Ctrl/Cmd 多选和 Shift 范围多选后支持文件树 asset 批量下载。
  • 文件树主 Markdown 文件行支持下载原始 .md 文件。
  • 文件树本地文件夹行支持下载 .tar 包。
  • 文件拖到本地文件树文件夹时使用目标文件夹 targetRelativePath 上传。
  • 主编辑器附件链接右键打开 attachment menu。
  • /api/local-folder/files/open?download=true 响应补 Content-Disposition 文件名。
  • Rust contract / route 测试覆盖新增行为。
  • Reasonix 浏览器截图复核右键菜单与下载入口。
  • Codex post-fix browser smoke 复核文件树 asset 单文件下载与 Ctrl/Cmd、Shift 多选下载。

4. 验收

  • cargo test -p mnote-web sidebar_tree_runtime_renders_context_menu_and_scoped_title_updates -- --test-threads=1
  • cargo test -p mnote-web local_file_open_download_sets_content_disposition_filename -- --test-threads=1
  • cargo test -p mnote-web local_folder_open_downloads_directory_as_tar -- --test-threads=1
  • cargo test -p mnote-web web_shell -- --test-threads=1
  • node --check scripts/task476-filetree-editor-context-menu-download-smoke.js
  • node scripts/task476-filetree-editor-context-menu-download-smoke.js
  • Reasonix pre-fix browser result：tmp/reasonix-filetree-editor-context-menu-2026-05-21/result.json
  • Codex post-fix browser result：tmp/task476-filetree-editor-context-menu-download-smoke/result.json

4.1 执行记录

  • 2026-05-21：Reasonix 浏览器测试确认：文件树 asset 右键菜单缺少 download，主编辑器附件 hover/菜单下载可用。
  • 2026-05-21：已补 filetree asset download 菜单项和 action handler，下载时复用 attachment 下载链并记录 filetree action 状态。
  • 2026-05-21：已补文件树多选下载，右键已选资源时按当前选择集批量触发浏览器下载；task476 smoke 覆盖 Ctrl 多选 2 个文件与 Shift 范围多选 3 个文件。
  • 2026-05-21：已补主 Markdown 文件行下载、文件夹 .tar 下载和拖到文件夹上传；task476 smoke 覆盖 README.md 下载、README.tar 下载，以及 README/drag-upload-note.txt 上传落盘。
  • 2026-05-21：已补主编辑器附件链接真实右键菜单，右键打开与 hover 更多按钮一致的 attachment menu。
  • 2026-05-21：已补 local-folder open 下载文件名：Content-Disposition 同时提供 ASCII fallback filename 与 UTF-8 filename*。
  • 2026-05-21：task476 post-fix browser smoke 通过；文件树 asset 单文件下载得到浏览器 suggested filename report-a.pdf，Ctrl/Cmd 多选下载得到 report-a.pdf / report-c.pdf，Shift 范围下载得到 report-a.pdf / report-b.pdf / report-c.pdf。该 smoke 中编辑器附件链接未渲染为可见项，作为本轮文件树多选下载的非阻塞项记录为 editor_attachment_not_visible。

5. 非目标

  • 不一次性实现 attachment 菜单中所有历史占位动作。
  • 不改变文件树删除语义。
  • 不重构完整 command service。
Reference in New Issue View Git Blame Copy Permalink