qd 不像 vs code 那样，一个窗口就只能绑在一个项目里
为什么要做 Roam？ 主流工具里，「文件」和「AI」是两个割裂的世界：想给 AI 一个文件，要先记路径、再开资源管理器、来回拖拽；看到一段路径，也只是一串死文本。Roam 是 qqqide 的回答——让整台电脑都成为 AI 的资源层。
- 打破「项目文件夹」的枷锁——AI 的视野不该被一个文件夹框住：任意盘符、任意目录的文件，一步到达、一键喂给 AI；
- 「在哪里看到，就在哪里打开」——一个键用 qqqide 自己的能力打开一切：图片进内置预览层、音视频直接播放（不认识的格式自动转码）、文件夹开新窗口、文本进编辑器，全程不离开 IDE；
- 引用即地址——AI 回复与文档预览里的文件链接不再是一串死文本：点击即直达目标；文件移动或改名后，也能落到最近可用位置并给出明确提示。
以上定位响应与视图呈现机制已提交发明专利 + 实用新型专利（同日双报）。完整技术方案：《一种文件资源定位响应与视图呈现的软件开发装置》
Roam 是 qqqide 的文件中枢——常驻在编辑器区域的「文件面板」。浏览、整理、复制、预览、送进 AI，全程不用离开 IDE。
一、打开
- Tab 或 F2 键（最快，非编辑状态）：随时切到 Roam；
- 或点击编辑器区域标签栏的 Roam 标签——它是常驻标签，关掉会自动回来。
打开时自动回到上次访问的目录；每个目录的排序、大小列偏好分别记忆。
二、界面速览
- 左侧栏：磁盘列表（Windows 另有回收站入口，占用非零时显示大小）；下面是最近访问区——文件 + 目录混合排列（点文件名直接打开、点目录直接进入），目录行右侧的图钉按钮可置顶（置顶列表会随 Cloud Sync 云同步）；
find输入框做多词模糊筛选（空格 = and）。 - 置顶目录行：置顶目录显示在内容区顶部，点 × 取消置顶、点 ▲▼ 调整顺序。
- 地址栏：点击即编辑路径（回车前往）；带历史下拉；右侧按钮一键复制当前路径。旁边的 open 按钮 = 在系统文件管理器中打开当前目录。
- 过滤框：地址栏右侧，实时筛选当前目录的文件。
- 排序 / 显示：
SCM切换「大小列」的显示字段（文件大小 / 创建时间 / 修改时间）；NSCM切换排序字段（名称 / 大小 / 创建时间 / 修改时间）；「文件在上」按钮一键切换文件与文件夹的分组方式。以上偏好均按目录分别记忆。 - 底部：文件名输入框 + 「新建文件」「新建文件夹」两个按钮。
三、键盘流（核心玩法）
列表非编辑状态下直接按键：
| 键 | 作用 |
|---|---|
| 单击 | 选中；文件夹单击直接进入；「..」返回上一级 |
| Shift+单击 | 范围多选；Ctrl+A 全选；Esc 取消选择 |
| q | 打开——四向分派：文件夹 → 新窗口；图片 → 悬浮预览层；音视频 → 独立播放器窗；文本 → 编辑器；多选一批音视频（可混合）→ 整批进同一播放列表，从列表第一个起播（详见下一节） |
| w | 系统打开——文件 → 默认程序；文件夹 → 系统文件管理器；多选 → 全部打开（多媒体文件自动排入播放列表，从第一首开始播） |
| a | 喂给 AI——有选中喂选中项，无选中喂当前文件夹（进入当前焦点 AI 面板的附件区） |
| d | 删除到系统回收站（无确认弹窗、有提示音，可去回收站还原） |
| Shift+Delete | 永久删除（不进回收站——慎重） |
| e / F2 | 就地重命名（回车确认 / Esc 取消） |
| z | 复制路径（无选中时复制当前文件夹路径） |
| x | 短按（600ms 内抬起）在当前目录开新 kmd；长按（超过 600ms）开 qmd；两者都带当前目录（选中单个文件时预填文件名；详解 kmd 终端指南 · qmd — 全交互终端） |
| m / p | 打开系统终端 CMD / PowerShell（Windows 为管理员方式打开；macOS 打开系统「终端」并进入该目录） |
| 空格 | 计算大小——对选中项（或全列）递归计算文件夹体积，GB 级红色高亮（仅本次会话有效） |
| 1 / 2 | 快速滚动：顶部 / 中点 / 底部 |
| Backspace | 返回上层目录 |
| Ctrl+C | 复制文件（系统标准剪贴板格式——粘到 Roam、编辑器，或系统资源管理器都行） |
| Ctrl+V | 把剪贴板里的文件粘贴到当前目录 |
右键菜单同款操作，分两组（中间一条分组线，线下全隐藏时线一起隐藏）：
- 线上（带快捷键）：AI / qqqide / open / delete / rename / copy path；
- 线下（不带快捷键）：search（打开搜索并锁定该文件夹）/ 加入播放列表（选中的媒体、或整个文件夹递归收集，追加进最近的播放器窗）/ 发布页面…（单选文件夹或
.html/.htm/.md，详见 页面发布）/ 在 bed 取链接（单选其它文件）。
空白区右键另有：喂给 AI / copy path / open / kmd、qmd / PowerShell、CMD（后两行只在 Windows 出现，macOS / Linux 直接不显示——那里由 m p 键打开系统终端）。
四、q 键——用 qqqide 自己的能力打开一切
q 不是「编辑器打开」的别名，而是四向分派：所有形态都用 qqqide 内置能力呈现，不跳系统程序、不打断工作流。
| 选中 | 按 q 的打开方式 |
|---|---|
| 文件夹 | 以该目录为主文件夹新开一个 qqqide 窗口（并自动记入「最近主文件夹」——左上角菜单「开新窗口」与 AI 视口的 + 下拉都能直接找回） |
| 图片 | 悬浮预览层直开——滚轮缩放、拖拽平移、D-pad 四向微调（中央房子钮 = 一键还原位置与角度）、双钮旋转（单击 90° 步进；按住超半秒进入角度微调，松手即定；横竖自动适配）；左右贴边按钮或 q / w 键可翻页浏览同组图片（序列跟随当前文件夹排序）；顶部按钮分别复制内存（图像数据）/ 文件本体 / 文件路径（与 AI 面板里点开图片的是同一台预览机器） |
| 视频 / 音频 | 独立播放器窗播放：视频出画、音频出音；关窗即停播、不后台空响（玩法见 qd 播放器） |
| 文本 | 编辑器打开（可编辑、可搜索、语法高亮） |
| 其余二进制 | 仅提示错误音效——不乱开、不误吞 |
多选是「播放列表」手势：选中一批音视频（音频、视频可混合）后按 q，它们整体进入一个新的播放器窗列表、从列表第一个开始播；右键「加入播放列表」可随时把媒体或整个文件夹追加进最近的播放器窗（不打断播放）。播放列表的拖动重排、追踪与循环等完整玩法见 qd 播放器；它为什么独立存在，见 qd 要「媒体查看」快。
格式覆盖（原生直开组 + 转码兜底组）：
- 图片：
pngjpgjpegjpejfifjifgifbmpwebpicosvgavifapng原生直显；psdtiftiff自动转码后预览； - 视频：
mp4m4vwebmmkvmovogv原生播放；aviwmvflvrmvbrmmpgmpegm2tsmts3gpvobasff4vogm自动转码后播放； - 音频：
mp3wavflacm4aaacoggogaopusweba原生播放；wmaaiffaifapeac3mkaamrau自动转码后播放。
转码兜底的工作方式：
- 视频已是通用编码（H.264 / HEVC / VP9…）时，秒级无损重封装（不重编码、不损画质）；否则重新编码；
- 转码产物独立缓存（2GB 上限、自动淘汰）——第二次打开瞬开；
- 转码中显示「正在转码预览 xx%」与取消按钮；关闭预览自动取消在途任务；
- 原生能播的先走原生；播放失败或 8 秒无响应，自动落转码——全程零跳转。
五、复制 / 粘贴与任务卡
- 大量文件的粘贴会弹出任务卡（窗口右下角）：实时进度、字节数、耗时，可随时取消；
- 取消 = 精确回滚——本次粘贴产生的半成品会被清干净，不会留下残缺文件；
- 重名规则：同目录内粘贴 = 自动生成
名字_1副本，绝不自覆盖；跨目录粘贴时，若目标已存在内容完全相同的文件 → 自动跳过（省空间），内容不同 → 生成副本，绝不覆盖。
六、贴心细节
- 自动感知外部变化：在系统里对当前目录增删改文件，Roam 自动刷新（不闪屏、不打断滚动）。
- 家目录标识：
_qqq、_qqqvault恒为红色加粗——它们是 qqqide 的项目数据 / 附件目录（随项目迁移），详见 家目录：_qqq · 家目录：_qqqvault。 - 拖放复制：从系统把文件 / 文件夹拖进 Roam 窗口 = 复制到当前目录。
- 提示音：进入、复制、删除等操作伴随轻提示音（可在设置里统一关闭）。