English | 简体中文

Flu CLI for VSCode

让 Flutter 研发像呼吸一样顺畅
集初始化、架构开发、资源管理与多平台发布于一体的全能工具链

🚀 版本动态：可视化鸿蒙开发工作台 (v0.2.1)

💡 v0.2.1 重磅更新：全新推出 Flu: 鸿蒙管理。很多 Flutter 开发者尝试鸿蒙适配时，真正卡住的不是业务代码，而是 SDK 下载、版本损坏、环境变量、老项目改造这些前置工作。现在这些都可以在 VSCode 里可视化完成。

• 先看清环境问题：自动检查鸿蒙工具链路径，发现 VSCode 读不到配置时直接提示，不再靠猜。
• 不用手动折腾 SDK：选择社区分支后自动下载、修复版本并注册到本机版本管理里。
• 修复常见坏版本：遇到 0.0.0-unknown 这类 SDK 版本异常，可直接在面板里一键修复。
• 老项目也能快速适配：选择目标项目和 SDK 后，自动补齐鸿蒙运行所需的项目配置，并可一键注入 ohos 平台目录。

⏱️ 3 步快速上手

1. 右键新建：在目录右键选择 Flu: 新建项目（或命令面板执行 Flu: 直达可视化创建页）
2. 配置预设：在 7 卡向导中按需勾选，或一键应用「官方推荐配置包」（「标准业务 App」/「Clean 企业级」）
3. 一键跑通：点击创建，等待自动 flutter pub get 完成，按弹窗引导即可开跑

✨ 核心亮点

1. 🚀 可视化创建项目（Create Project vNext）⭐️

7 卡向导式可视化项目创建器，覆盖结构、架构、能力、平台、示例与资源，所见即所得。

• 极速预设: 内置「标准业务 App」「Clean 企业级」官方推荐配置包，一选即填
• 灵活架构: Lite / Modular / Clean 三套架构，自由组合 Base / Pure / Mixins 代码心智
• 智能补丁: 启用功能自动回补 Android/iOS/鸿蒙原生权限，并在 pub get 后回补 iOS Podfile 宏
• 环境适配: 深度适配标准 FVM 与鸿蒙 FVM 隔离开发环境，提供免绝对路径污染的 launch 启动引导

📖 查看 Starter 架构设计与环境适配细节 →

2. 📱 可视化鸿蒙适配与 SDK 管理 ⭐️

鸿蒙适配最耗时间的地方，往往不是写 Dart 代码，而是把本机环境、Flutter SDK、VSCode 终端和项目目录对齐。Flu 提供专属的鸿蒙开发工作台，把这些步骤收进一个面板里完成。

• 环境诊断更直观: 自动识别 DevEco / OpenHarmony 工具链路径，告诉你当前 VSCode 会话到底能不能读到鸿蒙环境。
• SDK 准备更省心: 在面板里选择鸿蒙 Flutter 分支，自动完成下载、版本修复和本机注册，不需要手动拉仓库、搬目录、改版本文件。
• 坏 SDK 可直接修: 本地已存在的鸿蒙 Flutter SDK 如果出现版本异常，会在列表里标出，并提供一键修复入口。
• 多版本管理更清楚: 本机已安装的鸿蒙 SDK 会集中展示，可查看路径、删除旧版本、用指定版本新建项目或适配当前项目。
• 老项目改造更稳: 对已有 Flutter 项目，可一键绑定鸿蒙 SDK，补齐项目侧配置；缺少 ohos 平台目录时，也能直接从面板注入。

3. 📤 8 平台一键发布

无需手动登录各大商店后台，在 VSCode 内一键完成从构建到分发的全流程。

• 多模构建: 支持「仅构建 / 仅上传 / 构建+上传」一站式流水线
• 并行发布: 腾讯应用宝、华为、小米、OPPO、vivo、鸿蒙、App Store、蒲公英等 8 平台一键分发
• 进度看板: 实时可视化日志看板，构建和上传进度一目了然
• 密钥安全: 密钥支持会话/项目/全局三级存储，安全不落地

📖 阅读 8 平台发布详细配置指南 →

4. 🛠️ 智能代码生成

一键创建 Page、ViewModel、Widget、Component、Service、Model、Module，通过 .flu-cli.json 适配已有项目。

• 架构自适应: 自动根据项目架构模式（Base/Pure）生成风格一致的代码文件
• 右键直接生成: 深度结合 Explorer 树，右键即可在对应目录渲染模板

5. 🎨 应用资源管理

一张 1024 像素大图自动适配全平台图标，启动图支持 Logo + 背景图模式。

6. 🤖 AI + SKILL（让 AI 按项目规范写代码）

一键生成适配当前项目的 Cursor / Claude / SKILL 规则，让大模型生成的代码完美符合你的工程规范。

• 规范同步: 提取 .flu-cli.json 配置，自动投影生成项目规则文件
• 完美一致: 杜绝 AI 瞎写 unused imports、乱用基类或打破架构边界

[!IMPORTANT] 💡 需要查看更深度的功能配置与最佳实践？
请移步至我们的 🌐 官方文档 (huozhiye.cn) 获取完整的配置细节与故障排查手册。

📋 命令 & 快捷键

资源管理交互模式：右键一级入口为 新建项目 / 生成文件 / 打包上传 / 更多 Flu；低频维护命令收纳在「更多 Flu」子菜单。快捷键支持 Explorer 右键、Editor 上下文与 Fallback 到项目根目录三种模式，自定义快捷键参考文档。

📖 详细文档

配置文件说明、密钥管理、各平台接入指南等详细内容请参阅：

• 🌐 官方文档
• 📤 核心发布模块 — 适配 CLI 和编程方式调用
• 📦 CLI 工具 (NPM)
• 🐛 问题反馈

🤝 社区

扫描下方二维码或搜索公众号「火叶」关注我们。

关注公众号	加作者微信入群	赞赏支持
火叶	微信: Huoye-TT （备注: flu-cli）	给作者加鸡腿 ☕️

💡 你也可以点击插件详情页顶部的 Sponsor 按钮来支持本项目。

🛠️ 参与开发

如果你想在本地基于源码调试此插件：

1. 环境准备：在项目根目录运行 npm install。
2. 构建全量产物：在根目录运行 npm run vs。
   • 提示：该命令会自动处理 core 与 app-ship 的内联依赖关系。
3. F5 调试：
   • 打开项目源码。
   • 按 F5 (或在“运行与调试”面板选择 VSCode Extension (Dev))。
   • 这会启动一个新的“扩展开发宿主”窗口，供你测试功能。

💡 如果你只是想打包安装包使用，直接运行 npm run package 即可在 releases/ 目录下找到 .vsix 文件。

License: MIT | Copyright © 2025-2026 Huoye Studio