Перейти до основного змісту

Безпечно виконувати локальні команди

У настільному застосунку асистент може виконувати команди та тести в робочій папці вашого чату. Про те, як це працює в чаті, читайте в розділі Локальний доступ до файлів. На цій сторінці ви налаштовуєте, коли це можна робити без запиту, і наскільки ізольовано виконуються команди.

Відкрити налаштування команд​

Відкрийте в чаті панель Команди й виберіть Налаштування команд для цієї папки. Налаштування діють для кожної папки окремо.

Коли асистент може виконати команду?​

Виберіть один із трьох режимів:

  • Завжди питати: ви схвалюєте кожну команду.
  • Автоматично надійні команди: збережені вами команди запускаються без запиту. Інші команди все ще потребують дозволу.
  • Автоматично в пісочниці: усе запускається без запиту, але в ізольованому середовищі.

У кожному режимі також діють такі правила:

  • Безпечні команди запускаються без картки: mkdir, ls, cat, head, tail, wc, grep, find (без -exec або -delete), touch, pwd, tree і перевірки версії (--version, -v або -V для node, npm, npx, python, pip та aischool-python). Вони не роблять більше, ніж вбудовані інструменти роботи з файлами без запиту. Вони працюють у пісочниці без мережі й лише з шляхами всередині робочої папки, навіть після переходу за посиланнями (без абсолютних шляхів, ~ або ..). Якщо посилання веде за межі папки, картка все одно з’явиться. Для цього потрібні пісочниця (macOS і Linux) та локальні команди, але не Дозволити автоматичне виконання від вашого адміністратора. У панелі Команди тоді показується Автоматично (безпечна команда). Також список у фігурних дужках, наприклад mkdir -p src/{components,utils}, запускається без картки: застосунок розгортає його в окремі шляхи й перевіряє всі.
  • Кожна картка показує точну команду та, для онлайн-дій, точну адресу. Нижче дрібнішим шрифтом наведено пояснення асистента.
  • Якщо пісочниця доступна і ваш адміністратор дозволив автоматичне виконання, то на картці для команди, що виконується в пісочниці, також є кнопка Надалі автоматично в пісочниці в цій папці. Вона встановлює для папки режим Автоматично в пісочниці, щоб наступні команди запускалися без картки. Команди, яким потрібна мережа, ще раз попросять дозвіл, якщо тільки не дозволено встановлення пакетів.
  • Перша картка в папці, яка виконується в пісочниці й не потребує мережі, одноразово показує Довіряти цьому проєкту. Вона виконує команду, переводить папку в режим Автоматично в пісочниці та вмикає Дозволяти встановлення пакетів без запиту. Після цього тести й збірки на кшталт npm test, npm run build та node --test запускаються без картки, у пісочниці без мережі. Команди, яким далі потрібна мережа або які виконуються поза пісочницею, і надалі потребують підтвердження. Після Виконати або Відхилити запит для цієї папки більше не з’являється; режим змінюється в налаштуваннях команд. Якщо автоматичне виконання вимкнено, кожна картка показує, чи це робить ваш адміністратор або політика керування цим комп’ютером.

Зберегти надійні команди​

Для команди виберіть Завжди дозволяти в цій папці, а потім Лише цю команду або Усе, що починається з цього. Збережені команди надалі запускаються без запитів. Команди зі спеціальними символами (наприклад ; | > $) завжди потребують дозволу.

Збережені правила показані в налаштуваннях команд у розділі Завжди дозволено в цій папці. Там їх також можна видалити.

Пісочниця та мережа​

  • Використовувати пісочницю: команди можуть записувати лише в цю папку. Ця опція за замовчуванням увімкнена на macOS і Linux.
  • Дозволити мережу: визначає, чи мають команди доступ до інтернету. Ця опція за замовчуванням вимкнена. Без пісочниці команди завжди мають доступ до мережі.

Кожна картка команди показує, чи ввімкнені пісочниця та мережа.

Якщо Дозволити мережу вимкнено і асистент хоче щось завантажити, наприклад через npm install, картка команди запитає, чи хочете ви виконати саме цю команду з мережею. Тож вам не потрібно вмикати мережу для всієї папки.

Windows

У Windows пісочниця ще недоступна.

Встановлення пакетів​

У застосунку є вбудований Node.js із npm. Тому команди node, npm і npx працюють навіть тоді, коли Node.js не встановлено на вашому комп’ютері. Якщо Node.js встановлено вами, застосунок використовує цю версію. Виняток: проєкт, який сам запускає Electron (electron .), потребує Node.js, встановленого вами.

Дозволяти встановлення пакетів без запиту​

У Налаштуваннях команд для цієї папки увімкніть перемикач Дозволяти встановлення пакетів без запиту. Тоді встановлення пакетів із назвою запускаються без картки: npm install <назва> і npm install з package.json, pnpm, yarn або bun з install чи add, а також pip install <назва> (також через uv). Вони завжди працюють у пісочниці з мережею. Інші команди дотримуються режиму, вибраного для папки.

Ці встановлення все ще показують картку:

  • стартові шаблони проєктів, як-от npm create vite@latest і npx create-…, бо вони виконують власний код;
  • pip install ., pip install -r requirements.txt, встановлення з іншого реєстру (--registry, -i, --index-url) та пакети з git-адреси, URL або шляху.

Перемикач працює лише з пісочницею (macOS і Linux) і якщо ваш адміністратор дозволяє автоматичне виконання. Інакше його не можна ввімкнути.

Без скриптів встановлення

Пакети, встановлені таким способом, ніколи не запускають власні скрипти встановлення (npm працює з --ignore-scripts). Python-пакети встановлюються лише як готові wheels.

Локальні сервери та вбудований браузер​

Асистент також може запустити сервер розробки, який працює постійно, наприклад npm run dev для невеликого React-проєкту з Vite. Для цього діють ті самі правила, що й для інших команд: ви схвалюєте точну команду, або вона запускається за збереженим правилом, або автоматично в пісочниці. Замість максимальної тривалості на картці показано: "Працює як локальний сервер, доки ви його не зупините."

Сервер продовжує працювати після відповіді асистента. У панелі Команди картка показує статус Сервер працює, з кнопками Відкрити в браузері та Зупинити. Одночасно може працювати максимум 4 сервери. Сервери зупиняються, коли ви їх зупиняєте або закриваєте застосунок.

У пісочниці без мережі сервер може слухати лише на цьому комп’ютері (localhost). Про те, як асистент встановлює пакети, читайте в розділі Встановлення пакетів.

Показати просту вебсторінку​

Для звичайної вебсторінки (наприклад index.html із CSS і JavaScript, без етапу збірки) команда не потрібна. Тоді асистент використовує вбудований вебсервер застосунку:

  • Папка видима лише на цьому комп’ютері, на http://127.0.0.1 із випадковим портом.
  • Приховані файли, як-от .git і .env, ніколи не показуються.
  • Якщо файл змінюється, сторінка автоматично перезавантажується.

Для цього не з’являється картка підтвердження. Сервер відображається в панелі Команди, з Відкрити в браузері та Зупинити, і враховується в ліміт 4 серверів.

Результат переглядають у вбудованому браузері: кнопка Браузер (значок глобуса) праворуч у верхній панелі. Панель відкривається поруч із чатом, із кнопками назад, уперед, оновити (зупинити під час завантаження), адресним рядком і Відкрити у стандартному браузері.

  • Асистент сам відкриває браузер, щоб показати результат локального сервера. Це можливо лише для локальних адрес, наприклад http://localhost:5173.
  • Якщо ви натискаєте в відповіді на посилання localhost, воно відкривається у вбудованому браузері. Інші посилання відкриваються у вашому стандартному браузері.
  • Ви також можете самі ввести будь-яку вебадресу.
  • Браузер має власну окрему сесію: ви там не ввійшли в AI-Public, вебсайти не отримують дозволів на кшталт камери чи мікрофона, і завантаження неможливе.
  • Поки відкрите меню або діалогове вікно застосунку, сторінка тимчасово приховується.

Приклад:

Створи в цій папці невеликий React-застосунок із Vite та лічильником. Встанови залежності, запусти dev-сервер і покажи результат у браузері.

Дозволити асистенту дивитися​

Якщо попросити асистента подивитися на сторінку у вбудованому браузері, він читає адресу, заголовок, видимий текст, знімок екрана та останні повідомлення про помилки сторінки. Усе це надсилається до AI-моделі.

  • Сторінку на цьому комп’ютері (localhost або 127.0.0.1) асистент переглядає без запиту.
  • Для будь-якого іншого вебсайту, наприклад сторінки, на якій ви ввійшли, асистент спочатку показує картку: "Асистент хоче подивитися на onedrive.live.com." Натисніть Дозволити перегляд або Відхилити. Він запитуватиме це щоразу.
  • Якщо після вашого дозволу сторінка переходить на інший вебсайт, асистент нічого не читає.
  • Лише на сторінці цього комп’ютера асистент сам натискає й вводить текст, щоб перевірити те, що він створив. На інших вебсайтах він не натискає, не вводить текст і не навігує. Він не отримує cookies або паролі.
  • В офлайн-режимі асистент переглядає лише сторінки на цьому комп’ютері.

Версії та GitHub​

У асистента є вбудований git. Тож вам не потрібно встановлювати git, навіть у Windows. Асистент може зберігати версії, показувати зміни, створювати гілки та публікувати проєкт онлайн.

  • Дії в цій папці, як-от збереження версії, запускаються без запиту. Файли, схожі на секрети (наприклад .env-файли, ключі або токени в коді, зокрема ключі Google API, що починаються з AIza), ніколи не потрапляють до версії. Асистент повідомляє, якщо щось пропускає.
  • Онлайн-дії (завантажити проєкт, отримати найновішу версію, опублікувати та створити GitHub-репозиторій) спочатку показують картку з точною адресою та мітками Вбудовано в застосунку і Мережа увімкнена. Якщо адреса не github.com або створюється новий відкритий репозиторій, картка попереджає. Під час публікації картка показує, які файли будуть надіслані. Виберіть Виконати або Відхилити.
  • Підключення репозиторію поза github.com також спочатку потребує дозволу.

Про те, як підключити GitHub і опублікувати проєкт, читайте в розділі Vibe coden.

Офлайн-режим

В офлайн-режимі команди завжди виконуються в пісочниці без мережі. Встановлення пакетів із мережею та онлайн-дії вбудованого git (завантаження, отримання, публікація та GitHub) тоді не працюють. Збереження версій і показ простої вебсторінки працюють.

Налаштування для адміністраторів​

Адміністратори можуть вимкнути локальні команди або автоматичне виконання для всіх у середовищі. Це робиться в адміністративному середовищі в розділі Функції (на рівні середовища), у картці Настільний застосунок:

  • Дозволити локальні команди: якщо вимкнено, асистент не може виконувати команди. Онлайн-дії вбудованого git тоді також не працюють. Збереження версій і гілки все ще працюють: вони лише змінюють файли в папці, як і інструменти роботи з файлами.
  • Дозволити автоматичне виконання: якщо вимкнено, кожна команда потребує дозволу, і ви не можете ввімкнути Дозволяти встановлення пакетів без запиту.
  • Дозволити Python застосунку для Office-файлів: для шаблонів, графіків і аналізу. Цей Python працює без інтернету, записує лише в робочу папку і не може запускати інші програми. Якщо нічого не налаштовано, він наслідує Дозволити локальні команди. Без пісочниці (Windows) він доступний лише якщо локальні команди увімкнені, і щоразу потребує підтвердження.

На цій сторінці