Продукт

Расширение для VS Code

Версия 2.7.0. PromptFlowEngine для VS Code построен вокруг одного рабочего процесса: кодовая база → промпт → ИИ → кодовая база. Он запускает движок внутри процесса: без сервера, без Python и без собственных вызовов моделей.

Доступно в Visual Studio Marketplace как promptflow-ai.ide-extension. Эта страница описывает версию из репозитория; в Marketplace до публикации следующего выпуска может быть предыдущий. Само расширение — на английском.

Рабочий процесс

Codebase → Prompt → AI → Codebase
CODEBASE   pick a scope: workspace, current file, chosen files, or none
   ↓       only files relevant to the task are read
PROMPT     describe the change in your own words
   ↓       the engine structures it and grounds it in the code
AI         send to VS Code Chat, copy, or save
   ↓       secrets and personal data are checked first
CODEBASE   review the changes in Source Control,
           or build a review prompt from the modified files

Откройте значок PromptFlowEngine на боковой панели действий. Панель проведёт вас по четырём шагам по порядку.

1. Кодовая база

Выберите Всё рабочее пространство, Текущий файл, Выбрать файлы или папку или Без кода. Файлы фильтруются (без node_modules, результатов сборки и бинарных файлов), оцениваются по релевантности задаче и ограничиваются по числу, так что в промпт попадают несколько важных файлов, а не весь репозиторий.

2. Промпт

Опишите задачу так, как сказали бы её вслух. Создать промпт формирует структурированный инженерный промпт: роль, цель, контекст проекта, релевантный код, требования, ограничения, граничные случаи, тестирование, критерии приёмки и ожидаемый вывод. Разделы появляются, только когда они нужны задаче: у просьбы «объясни это» не будет плана тестирования. Панель показывает, сколько строк пришло из вашей задачи, из кодовой базы и из добавленного руководства, а промпт остаётся редактируемым. Это та же реструктуризация, которую предоставляют инструмент MCP и HTTP API.

3. ИИ

Отправить в чат с ИИ открывает промпт в чате VS Code (или копирует его, если чат недоступен). Прежде чем что-либо уйдёт, защита приватности проверяет текст на учётные данные и персональные данные. Режимы: strict (блокировать), redact (по умолчанию, заменять заполнителями), warn (спрашивать). Сократить токены убирает вводные слова и повторы проверенными правками, сохраняющими смысл.

4. Кодовая база

Когда ИИ изменил ваши файлы, Проверить изменения открывает систему управления версиями, где вы можете сохранить или отклонить каждое из них. Создать промпт для ревью читает файлы с незафиксированными изменениями и формирует промпт для ревью, сверяющий их с вашей исходной задачей. Для этого нужно встроенное расширение Git, и оно только читает: ничего не индексирует, не фиксирует и не откатывает.

Команды

  • PromptFlowEngine: Codebase → Prompt
  • PromptFlowEngine: Codebase → Prompt from Selection
  • PromptFlowEngine: Open PromptOps Workspace
  • PromptFlowEngine: Optimize Prompt
  • PromptFlowEngine: Restructure Prompt
  • PromptFlowEngine: Analyze Prompt
  • PromptFlowEngine: Compare Original vs Restructured
  • PromptFlowEngine: Send Prompt to AI Chat
  • PromptFlowEngine: Prompt → Codebase (Review Changes)
  • PromptFlowEngine: Insert Prompt Template
  • PromptFlowEngine: Select Model for Tokens and Cost
  • PromptFlowEngine: Connect to Organization
  • PromptFlowEngine: Organization Status
  • PromptFlowEngine: Install Agent Hooks (Claude Code, Cursor, Windsurf, Copilot, Gemini CLI)
  • PromptFlowEngine: Remove Agent Hooks
  • PromptFlowEngine: Turn On Activity History
  • PromptFlowEngine: Pause or Resume Activity History
  • PromptFlowEngine: Turn Off Activity History
  • PromptFlowEngine: Show Activity History
  • PromptFlowEngine: Turn Prompt Text in History On or Off
  • PromptFlowEngine: Set Activity History Retention
  • PromptFlowEngine: Export Activity History
  • PromptFlowEngine: Delete Activity History
  • PromptFlowEngine: Sign In
  • PromptFlowEngine: Sign Out
  • PromptFlowEngine: Account and Activity Status
  • PromptFlowEngine: Show Protection Dashboard
  • PromptFlowEngine: Scan Selection for Sensitive Data
  • PromptFlowEngine: Redact Sensitive Data in Selection
  • PromptFlowEngine: Protection Status
  • PromptFlowEngine: Reset Protection Metrics

Реструктурировать промпт работает с выделенным фрагментом или всем документом, открывает diff оригинала и результата и предлагает заменить текст, отправить его в чат или скопировать. Проанализировать промпт выводит в канал вывода PromptFlowEngine оценку качества, число токенов, оценку стоимости ввода и каждое замечание с причиной и исправлением. Вставить шаблон промпта вставляет в позицию курсора один из шаблонов или промптов из библиотеки. Выбрать модель для токенов и стоимости позволяет выбрать любую модель из каталога моделей. В строке состояния отображаются токены и оценка качества последнего промпта.

Реструктуризация, анализ, вставка шаблона и отправка есть также в контекстном меню редактора в разделе PromptFlowEngine, а у каждой команды есть сочетание клавиш на базе Ctrl+Alt+P (Cmd+Alt+P в macOS):

  • Ctrl+Alt+P O: Optimize Prompt
  • Ctrl+Alt+P W: Open PromptOps Workspace
  • Ctrl+Alt+P R: Restructure Prompt
  • Ctrl+Alt+P A: Analyze Prompt
  • Ctrl+Alt+P T: Insert Prompt Template
  • Ctrl+Alt+P S: Send Prompt to AI Chat
  • Ctrl+Alt+P M: Select Model for Tokens and Cost
  • Ctrl+Alt+P P: Codebase → Prompt

Установка

В VS Code откройте представление «Расширения» и найдите PromptFlowEngine или выполните:

shell
code --install-extension promptflow-ai.ide-extension

Чтобы вместо этого собрать именно эту версию из исходного кода:

shell
# from the root of your PromptFlowEngine checkout
corepack enable && pnpm install
pnpm --filter ide-extension build
cd apps/vscode-extension && pnpm exec vsce package --no-dependencies
code --install-extension ide-extension-2.7.0.vsix

Режим агента Copilot

При активации расширение регистрирует свой встроенный сервер MCP в .vscode/mcp.json (нужен node в PATH), чтобы агенты могли напрямую вызывать те же инструменты. См. клиент MCP.

Настройки

НастройкаПо умолчаниюНазначение
promptflow.mcpServerCommand"node"Advanced: overrides the command used to launch the external MCP server registered for GitHub Copilot Agent mode (.vscode/mcp.json). The panel and PromptFlowEngine commands don't use this; they run in-process. Leave unset to use the bundled server.
promptflow.mcpServerArgs[]Advanced: arguments for promptflow.mcpServerCommand. Leave unset to use the bundled server.
promptflow.model""Model used for token counts and cost estimates, as a model id from the catalog (for example gpt-4.1 or claude-sonnet-5-5). Leave empty to use promptflow.defaultProvider.
promptflow.defaultProvider"gpt"Model family used for token counts when promptflow.model is empty. Kept for existing configurations.
promptflow.codebaseMaxFiles2000Maximum number of files scanned per Codebase → Prompt run, before relevance filtering.
promptflow.codebaseMaxRelevantFiles12Maximum number of files included as relevant context in a generated prompt.
promptflow.privacy.enabledtrueScan prompts for sensitive data (credentials, PII, cloud secrets) before they're sent to AI Chat or copied for that purpose.
promptflow.privacy.mode"redact"How PromptFlowEngine reacts when sensitive data is detected in an outbound prompt. When this editor is connected to an organization, its policy applies instead.
promptflow.privacy.exclusions[]Exact substrings that should never be treated as sensitive (e.g. a shared team email alias).
promptflow.privacy.customPatterns[]Additional organization-specific sensitive-data patterns, detected alongside the built-in ones.
promptflow.exposure.enabledtrueWarn when an open file contains credentials that an AI assistant could attach as context. Detection is on this device; values are never shown or sent.
promptflow.enterprise.enrollmentKey""Set by IT: an enrollment key from the PromptFlowEngine admin console (pfe_…). Connects this editor to the organization on start.
promptflow.enterprise.server""Set by IT: the PromptFlowEngine server origin. Defaults to https://promptflowengine.com.
promptflow.enterprise.userEmail""Set by IT (optional): the user’s work email, so their devices count as one seat. Only a keyed hash is stored.
promptflow.account.server"https://promptflowengine.com"
promptflow.diagnostics.errorReportsfalse
promptflow.dashboard.metricstrueKeep daily counts (prompts scanned, categories found, warned/redacted/blocked/handed off) for the Protection Dashboard. Counts only, on this machine, for 90 days; no prompt text or values. Turn off to stop counting; "Reset Protection Metrics" deletes what was kept.

Ключи настроек сохраняют префикс promptflow. из прежних версий, поэтому существующая конфигурация продолжает работать.

Изменения в 2.2

  • Полный каталог моделей заменил четыре семейства моделей: для каждой модели указаны прайс-листовая цена, дата проверки и точность подсчёта токенов.
  • Новые команды: «Вставить шаблон промпта» и «Выбрать модель для токенов и стоимости». Новая настройка: promptflow.model.
  • Команда «Проанализировать промпт» теперь сообщает качество, токены, стоимость и исправление для каждого замечания.
  • Контекстное меню редактора и сочетания клавиш.
  • Исправлено: модели без справочной цены больше не приписывается стоимость другой модели; запись Copilot в .vscode/mcp.json восстанавливается после обновления; mcp.json с комментариями никогда не перезаписывается.

Изменения в 2.1

  • Везде переименовано в PromptFlowEngine: отображаемое имя, панель действий, команды, сообщения и канал вывода.
  • Отдельное представление «Оптимизация» и команда Optimize Prompt удалены. Сокращение токенов теперь — одно действие внутри панели рабочего процесса.
  • Новое: «Реструктурировать промпт», область «Без кода», шаг ревью и редактируемый сгенерированный промпт.
  • Сгенерированные промпты создаются общим движком, а разделы выбираются по задаче, а не по фиксированному шаблону.
  • Панель теперь работает под строгой Content Security Policy.