Асистент

Асистент відповідає на запитання про AutoFileSync звичайною мовою і може зробити частину роботи за вас: пропонує нові синхронізації, з'ясовує, чому щось не вдалося, і за бажанням виконує команди з меню. Він працює повністю на цьому комп'ютері – нічого не надсилається в інтернет, і не потрібні ні обліковий запис, ні ключ.

Як користуватися асистентом

Асистент → Чат… відкриває вікно чату.
Напишіть запитання або побажання в нижньому полі так, як сказали б людині.
Натисніть Надіслати або Ctrl+Enter (на Mac Cmd+Enter). Сама клавіша Enter починає новий рядок.
Відповідь з'являється вгорі в історії розмови, слово за словом, поки вона створюється. Тим часом унизу написано Асистент відповідає….

Залежно від комп'ютера відповідь триває від кількох секунд до кількох хвилин; найперша – трохи довше, бо спершу завантажується модель. Програмою можна користуватися й далі, а вікно чату можна закрити: відповідь буде в історії, коли ви відкриєте його знову.

Асистент пам'ятає попередню розмову, тож розуміє уточнення на кшталт «а як це скасувати?». Розмова зберігається, доки AutoFileSync не завершить роботу. Нова розмова починає все спочатку – це корисно, коли тема змінюється, бо тоді стара розмова вже не відволікає.

Асистент відповідає тією мовою, якою до нього звертаються.

Що вміє асистент

Відповідати на запитання про роботу з програмою	Він знаходить відповідний розділ цієї довідки, відповідає на його основі й називає сторінку довідки, де можна прочитати більше. «Як синхронізувати через SSH?»
Розповідати про ваші синхронізації	Він знає всі створені синхронізації з джерелом, призначенням, типом і ввімкненими параметрами, з'єднання SSH (без паролів), коли востаннє виконувалася синхронізація, чи були доступні джерело і призначення – і чи має синхронізація в такому разі попереджати – а також першу помилку останнього проходу. «Скільки в мене синхронізацій?», «Чому моя флешка не актуальна?»
Повідомляти поточний стан	Він знає, чи програма зараз синхронізує і чи працює фонова служба. «Синхронізація зараз виконується?»
Аналізувати журнал	Якщо в запитанні є слово журнал або лог, він читає найновіші записи журналу і пояснює їх. «Що написано в журналі?», «Що показує лог?»
Пропонувати нову синхронізацію	Якщо назвати джерело і призначення шляхами, він пропонує готову синхронізацію. «Синхронізуй /home/anna/Фото в /media/usb/Фото»
Пропонувати вилучення синхронізації	Якщо назвати створену синхронізацію на ім'я, він пропонує її вилучити. «Вилучи синхронізацію Фото»
Виконувати команди з меню	Синхронізувати один раз, Попередній перегляд, Запустити синхронізацію, Зупинити синхронізацію, Запустити фонову службу, Зупинити фонову службу і Показати журнал. «Синхронізуй зараз один раз», «Покажи мені журнал»

Підтвердження пропозицій

Асистент ніколи нічого не змінює сам. Якщо в нього є пропозиція, він описує її одним реченням, а внизу вікна чату з'являється кнопка, яка каже, що вона зробить:

Створити синхронізацію…	Відкриває звичний діалог нової синхронізації, уже заповнений назвою, типом, джерелом і призначенням. Там усе можна перевірити і змінити; створюється вона лише після OK.
Видалити синхронізацію…	Ставить те саме запитання для підтвердження, що й Редагування → Видалити синхронізацію.
Назва команди, наприклад Синхронізувати один раз	Виконує команду так само, як однойменний пункт меню.

Якщо пропозиція не потрібна, просто ставте наступне запитання: разом із ним кнопка зникає.

Як добре запитувати

Указуйте шляхи повністю, наприклад C:\Users\Anna\Documents, /home/anna/Документи або для SSH anna@server:/backup. Якщо шляху бракує, асистент перепитає, а не вигадає його.
Використовуйте слова, якими користується сама програма – джерело, призначення, синхронізація, кошик. За ними асистент знаходить потрібний розділ цієї довідки; найкраще це вдається тією мовою, якою програма показує свій інтерфейс.
Для команд формулюйте прохання: «синхронізуй», «запусти», «зупини», «заверши», «відкрий», «покажи».
Одна справа в одному запитанні. Кілька побажань в одному повідомленні частіше дають неповні пропозиції.

Обмеження

Асистент – це невелика мовна модель. Він може помилятися, плутати шляхи або стверджувати щось неправильне. Тому кожна пропозиція проходить через кнопку і звичний діалог – перед OK варто глянути на джерело і призначення. У разі сумніву правильним є те, що написано в цій довідці.

Із журналу він бачить лише найновіші записи. Якщо синхронізацій дуже багато, він докладно описує перші 30, а решту лише підраховує. Параметрів він не змінює, а лише пояснює, де їх знайти.

Налаштування моделі

Асистентові потрібна мовна модель – файл із розширенням .gguf. Він не входить до складу AutoFileSync, бо має розмір у кілька гігабайтів і власну ліцензію (див. Умови ліцензії). Якщо файлу немає, вікно чату показує Модель не знайдено. і називає папку, куди його слід покласти.

Windows	`setup_llama_windows.cmd` у папці встановлення завантажує відповідну модель у `%LOCALAPPDATA%\autofilesync\models`.
macOS	`setup_llama_macos.sh` завантажує відповідну модель у `~/Library/Application Support/autofilesync/models`.
Linux	Скопіюйте файл GGUF у `~/.local/share/autofilesync/models`.

Скрипти вибирають розмір за обсягом оперативної пам'яті: менше 16 ГБ – модель 3B, від 16 ГБ – модель 7B, від 32 ГБ – модель 14B. Більші моделі відповідають точніше, але повільніше. Якщо в папці кілька файлів, асистент бере перший за назвою файлу. Щойно покладену модель буде знайдено без перезапуску.

Щоб використовувати файл в іншому місці, вкажіть його повний шлях у змінній середовища AUTOFILESYNC_LLAMA_MODEL; вона має пріоритет над папкою.