快捷键与上下文感知

Flu CLI VSCode 扩展针对键盘操作进行了深度优化，让你可以不仅无需离开键盘，甚至无需打开侧边栏即可完成所有文件生成操作。

⚡️ 核心快捷键

扩展提供了一个全局快捷键来唤起生成面板：

• macOS: Cmd + Shift + G
• Windows / Linux: Ctrl + Shift + G

记忆技巧: Generate (生成)

按下快捷键后，VSCode 顶部会弹出一个输入框，询问你要生成的文件类型（Page, Widget, Service 等）。

🧠 智能上下文感知

Flu CLI 最强大的特性之一是"上下文感知"。当你按下快捷键时，扩展会自动判断你的意图，并选择正确的目标目录。

支持以下三种上下文模式：

1. 📂 资源管理器模式 (Explorer Context)

场景: 你的焦点在左侧的文件资源管理器 (Explorer) 中，并选中了一个文件夹。

行为: 扩展会自动将你选中的文件夹作为生成目标。

示例:

1. 在 Explorer 中选中 lib/features/profile 文件夹。
2. 按 Cmd+Shift+G。
3. 选择 Page，输入 settings。
4. 结果：lib/features/profile/pages/settings_page.dart。

---

2. 📝 编辑器模式 (Editor Context)

场景: 你的焦点在编辑器 (Editor) 中，正在编写代码（例如正在编辑 home_page.dart）。

行为: 扩展会自动识别当前文件所在的目录，并尝试向上查找最近的有效父级目录（如 features/xx 或 lib），作为生成目标。

优势: 你不需要手动去 Explorer 中找目录，直接在写代码的地方按快捷键即可在当前模块下添加新文件。

示例:

1. 你正在编辑 lib/features/home/pages/home_page.dart。
2. 突然想到需要一个 UserCard 组件。
3. 直接按 Cmd+Shift+G -> 选择 Widget -> 输入 user_card。
4. 扩展检测到你在 home 模块下，自动将文件生成到 lib/features/home/widgets/user_card_widget.dart。

---

3. global 兜底模式 (Fallback Context)

场景: 你没有打开任何文件，或者焦点不在任何特定上下文。

行为: 扩展默认使用项目根目录，并根据 .flu-cli.json 的全局配置来决定生成位置。

---

⚙️ 自定义快捷键

如果你习惯其他键位，完全可以自定义。

1. 打开 VSCode 命令面板 (Cmd+Shift+P / Ctrl+Shift+P)。
2. 输入 Preferences: Open Keyboard Shortcuts (JSON)。
3. 添加以下配置：

[
  {
    "key": "cmd+n", // 你喜欢的快捷键，例如 Cmd+N
    "command": "flu.generateFile",
    "when": "editorTextFocus || filesExplorerFocus"
  }
]

🚀 最佳实践 (键盘流)

结合 VSCode 的其他快捷键，你可以实现全键盘开发流：

1. 创建新模块:
   • Cmd+Shift+G -> Module -> order
2. 跳转到新文件:
   • Cmd+P -> order_page
3. 添加列表页:
   • Cmd+Shift+G (在编辑器中) -> Page -> order_list -> 勾选 BaseListPage
4. 添加服务:
   • Cmd+Shift+G -> Service -> order

全程无需鼠标，行云流水。