Genie Flow
Genie Flow 是一个独立的 VS Code 插件，用来在编辑器内承载 Genie Flow 能力，帮助你围绕当前项目完成需求分析、技术方案梳理、代码生成和文件级操作。
当前版本采用“独立插件壳 + 远端 Genie Flow 页面”的方式运行：
- 继续加载远端 Genie Flow 页面
- 独立提供 VS Code bridge services
- 优先复用
~/.fta-cli/userInfo.json 登录态
- 登录缺失时走插件内登录流程
- 支持文件读写、搜索、编辑、校验、命令执行和后台任务
适用场景
- 在 VS Code 里直接打开 Genie Flow，而不是依赖旧的 FTA Workstation 入口
- 让 Genie Flow 读取当前仓库结构、Git 信息和代码文件
- 在一个明确的业务项目里完成分析、改动建议和代码落地
安装前准备
建议在开始前确认下面几项：
- 使用支持的 VS Code 版本
- 当前机器可以访问 Genie Flow 远端页面和 FTA SSO
- 本机如已存在
~/.fta-cli/userInfo.json，插件会优先复用这份登录态
- 打开的目录是一个真实项目，而不是空目录
- 项目最好已经配置
git remote origin，因为 Genie Flow 当前初始化依赖 Git 远端地址
安装后的新手教程
1. 打开一个项目
先在 VS Code 中打开你真正要操作的业务仓库。
注意：
- 不建议在空目录里直接使用
- 当前 Genie Flow 初始化依赖工作区路径和 Git 远端信息
- 如果项目没有
origin，插件会在打开前直接提示
2. 完成登录
第一次使用时，先执行命令面板里的 Genie Flow: Login。
插件会按下面的顺序处理登录：
- 优先复用本机
~/.fta-cli/userInfo.json
- 如果本地登录态失效或不存在，再拉起浏览器登录
3. 打开 Genie Flow
登录完成后，可以通过两种方式进入：
- 命令面板执行
Genie Flow: Open
- 点击底部状态栏里的
Genie Flow
首次打开时，插件会校验：
- 当前是否已经登录
- 当前是否打开了工作区
- 当前项目是否能识别到 Git 远端地址
4. 确认项目初始化成功
进入 Genie Flow 后，先确认它已经拿到当前项目上下文：
- 当前工作区路径
- 当前 Git 仓库远端地址
src 目录树- 当前用户登录信息
如果这些信息缺失，Genie Flow 的很多能力都会降级或直接不可用。
5. 从一个小任务开始
建议第一次不要直接让 Genie Flow 做大规模改造，先从这些动作开始：
- 读取某个文件
- 搜索某个关键字
- 查看当前项目结构
- 让它先给出改动计划
- 执行一个简单命令并查看结果
这样更容易确认 bridge、登录和工作区识别都已经跑通。
常用命令
Genie Flow: Open
打开 Genie Flow 主界面Genie Flow: Login
手动触发登录Genie Flow: Get Started
再次打开插件内置的新手教程
常见问题
为什么在某些目录里打不开？
当前 Genie Flow 初始化依赖工作区路径和 Git 远端地址。如果你打开的是空目录、临时目录，或者当前项目没有配置 git remote origin，插件会直接拦住。
为什么已经装了插件，还是提示登录？
如果本机没有可复用的 ~/.fta-cli/userInfo.json，或者里面的 cookies 已经过期，插件会要求你重新登录。
为什么界面打开了，但能力不完整？
这通常说明远端页面已经加载成功，但项目上下文没有初始化完整。优先检查：
- 当前是否打开了真实项目
- 当前项目是否有 Git 远端
- 是否已经登录成功
- 网络是否可以访问 Genie Flow 远端页面
| |
