Roam 使用指南
Roam 是 qqqide 的文件中枢——常驻在编辑器区域的「文件面板」。浏览、整理、复制、预览、送进 AI，全程不用离开 IDE。
一、打开
- Tab 或 F2 键（最快，非编辑状态）：随时切到 Roam；
- 或点击编辑器区域标签栏的 Roam 标签——它是常驻标签，关掉会自动回来。
打开时自动回到上次访问的目录；每个目录的排序、大小列偏好分别记忆。
二、界面速览
- 左侧栏：磁盘列表（Windows 另有回收站入口，显示占用大小）；下面是最近访问区——文件 + 目录混合排列（点文件名直接打开、点目录直接进入），目录行右侧的图钉按钮可置顶；
find输入框做多词模糊筛选（空格 = and）。 - 置顶目录行：置顶目录显示在内容区顶部，点 × 取消置顶、点 ▲▼ 调整顺序。
- 地址栏：点击即编辑路径（回车前往）；带历史下拉；右侧按钮一键复制当前路径。旁边的 open 按钮 = 在系统文件管理器中打开当前目录。
- 过滤框：地址栏右侧，实时筛选当前目录的文件。
- 排序 / 显示：
SCM切换大小列显示（文件大小 / 创建时间 / 修改时间）；NSCM按不同字段排序；「文件在上」按钮一键切换分组方式。 - 底部：文件名输入框 + 「新建文件」「新建文件夹」两个按钮。
三、键盘流（核心玩法）
列表非编辑状态下直接按键：
| 键 | 作用 |
|---|---|
| 单击 | 选中；文件夹单击直接进入；「..」返回上一级 |
| Shift+单击 | 范围多选；Ctrl+A 全选；Esc 取消选择 |
| q | 打开——文件 → 编辑器打开；文件夹 → 以该目录新开一个 qqqide 窗口 |
| w | 系统打开——文件 → 默认程序；文件夹 → 系统文件管理器；多选 → 全部打开（多媒体文件自动排入播放列表，从第一首开始播） |
| a | 喂给 AI——有选中喂选中项，无选中喂当前文件夹（进入 AI 面板附件区） |
| d | 删除到系统回收站（无确认弹窗、有提示音，可去回收站还原） |
| Shift+Delete | 永久删除（不进回收站——慎重） |
| e / F2 | 就地重命名（回车确认 / Esc 取消） |
| z | 复制路径 |
| x | 在当前目录打开一个新 kmd 终端（选中单个文件时预填文件名） |
| m / p | 打开系统终端 CMD / PowerShell（Windows 为管理员方式打开；macOS 打开系统「终端」并进入该目录） |
| 空格 | 计算大小——对选中项（或全列）递归计算文件夹体积，GB 级红色高亮（仅本次会话有效） |
| 1 / 2 | 快速滚动：顶部 / 中点 / 底部 |
| Backspace | 返回上层目录 |
| Ctrl+C | 复制文件（系统标准剪贴板格式——粘到 Roam、编辑器，或系统资源管理器都行） |
| Ctrl+V | 把剪贴板里的文件粘贴到当前目录 |
右键菜单同款操作：文件项上右键 = AI / qqqide / open / delete / rename / copy path；空白区右键另有：喂给 AI / kmd / PowerShell / CMD 等。
四、复制 / 粘贴与任务卡
- 大量文件的粘贴会弹出任务卡（窗口右下角）：实时进度、字节数、耗时，可随时取消；
- 取消 = 精确回滚——本次粘贴产生的半成品会被清干净，不会留下残缺文件；
- 重名规则：同目录内粘贴 = 自动生成
名字 (1)副本，绝不自覆盖；跨目录粘贴时，若目标已存在内容完全相同的文件 → 自动跳过（省空间），内容不同 → 生成副本，绝不覆盖。
五、贴心细节
- 自动感知外部变化：在系统里对当前目录增删改文件，Roam 自动刷新（不闪屏、不打断滚动）。
- 家目录标识：
_qqq、_qqqvault恒为红色加粗——它们是 qqqide 的项目数据 / 附件目录（随项目迁移）。 - 拖放复制：从系统把文件 / 文件夹拖进 Roam 窗口 = 复制到当前目录。
- 提示音：进入、复制、删除等操作伴随轻提示音（可在设置里统一关闭）。