promptcode-vscode比堆砌多个AI插件更可控、可复用，它将“如何让AI生成代码”转化为可存档、调试和团队共享的结构化Flow流程，支持变量传递、分支条件与分步调试。
直接结论：用 promptcode-vscode 比堆砌多个 AI 插件更可控、更可复用——它不生成代码，而是帮你把“怎么让 AI 生成代码”这件事变成可存档、可调试、可团队共享的流程。
为什么不用 Copilot / Tabnine 直接写代码？
它们适合单点补全，但解决不了结构化任务：比如“给当前组件加权限控制 + 同步更新路由守卫 + 补全测试用例”。这类需求需要多步上下文传递、中间产物（如提取的权限字段名）跨步骤复用、失败时能定位到哪一步出错。Copilot 的对话是线性的、无状态的；promptcode-vscode 的 Flow 是有变量、有分支、可 debug 的脚本。
常见错误现象：
– 在 Copilot 里反复粘贴上一步输出，手动改提示词，5 分钟后忘了自己做到哪一步
– 生成的 Hook 名称和组件名不一致，因为模型没记住你 3 轮前定下的命名约定
– 团队新人拿到同样需求，写出的代码风格和接口设计完全不同
- 使用场景：中大型项目中需高频复用的模板化开发（如微前端子应用接入、API 客户端自动生成、i18n 提取）
- 性能影响：本地 Flow 运行不依赖网络，但每步
AI Action仍需调用模型 API 或本地推理后端（如llama.cpp） - 兼容性：要求 VSCode 1.86+，且必须配置好至少一个可用模型（云端或本地），否则
AI Action步骤会静默失败
Flow 文件里 codeAction 和 aiAction 怎么配合？
codeAction 是真正执行文件读写、正则替换、Shell 命令的环节，它让 AI 的“建议”落地为“动作”。而 aiAction 只负责生成文本结果（比如一段 TypeScript 接口定义），不碰文件系统。
典型协作链：
1. codeAction 读取当前 src/api/index.ts，提取所有 export 的函数名 → 存入变量 apiNames
2. aiAction 根据 apiNames 和预设模板，生成对应的 mock 实现代码
3. codeAction 将生成内容插入到 mocks/api.ts 的指定位置
- 参数差异：
codeAction支持filePath、insertAt、regexReplace；aiAction关键参数是prompt、model、variables（用于注入上一步变量） - 容易踩的坑：
codeAction的insertAt如果指定为"end"，但文件末尾已有空行，新内容可能被挤到倒数第二行；建议统一用regexReplace匹配结尾注释块再插入 - 调试技巧：在 Flow 编辑器中右键某一步 → “Run Step Only”，可单独验证该步输入/输出，避免整条 Flow 重跑
如何让 Flow 适配不同语言项目？
不能靠一套 Flow 打天下。关键在 variables 注入和 codeAction 的路径动态拼接。
例如，Python 项目要生成 Pydantic 模型，而 TypeScript 项目要生成 Zod schema：
– 在 Flow 开头用 codeAction 读取 package.json 或 pyproject.toml，判断项目类型 → 设为变量 projectType
– 后续 aiAction 的 prompt 字段用模板语法引用："Generate a {{projectType}} schema for..."
– 最后 codeAction 的 filePath 也根据 projectType 动态选："{{projectType == 'ts' ? 'src/schema' : 'src/models'}}/user.py"
- 语言特定配置：VSCode 的
[python]或[typescript]块对 Flow 无效，必须在 Flow 内部做逻辑分支 - 性能影响：每次运行 Flow 都会重新解析整个 JSON，分支过多（>5 层嵌套）会导致启动延迟明显，建议用
switch类型的条件 Action 替代深层 if-else - 可维护性陷阱：把所有逻辑塞进一个大 Flow，不如拆成
detect-project-type.flow.json+generate-schema.flow.json，用runFlowAction 调用
最易被忽略的复杂点是变量作用域——Flow 内部变量默认只在当前步骤生效，跨步骤传递必须显式声明 outputVariables。很多人卡在“上一步明明提取了字段名，下一步 prompt 里却渲染为空”，其实只是忘了在上一步的 codeAction 里配置 "outputVariables": ["fieldNames"]。
