Решаване на проблеми

Симптом	Какво да проверя
`agentboard` не е намерен	Рестартирайте PowerShell след Scoop. Когато инсталирате от ZIP, използвайте пълния път до `agentboard.exe`.
Уеб страница, показваща стар интерфейс след изграждане	Спрете работещия сървър Ctrl+C. Изпълнете `./scripts/build.ps1`, стартирайте нов двоичен файл. Vite трябва да се изгражда преди Go, защото интерфейсът е вграден в EXE. Обновете страницата Ctrl+F5.
Порт 7337 зает	AgentBoard може вече да работи. Отворете `http://127.0.0.1:7337` или прекратете стария процес. За друг порт използвайте `--addr`.
Проектът не е намерен	В желаната папка изпълнете `agentboard init`. След това `agentboard open` от него или `agentboard open C:\путь\к\проекту`.
Работникът не вижда задачата	Задачата трябва да бъде присвоена на този конкретен работник и да се намира в `Features`, `In progress`, `Testing` или `Verification`. AI не вижда `Backlog`, `Complete` и персонализирани колони.
Проверката на MCP сървъра съществува, но клиентът не е свързан	Проверката на сървъра не проверява настройките на външния клиент. Рестартирайте клиента, проверете конфигурационния му файл, пътя до `agentboard.exe`, `--project`, `--worker` и общия `--db`. Поискайте да се обадите на `get_my_board`.
Работник офлайн	Клиентът може да е прекратил или още да не е стартирал MCP. След 90 секунди без сърдечен ритъм сесията се счита за прекъсната.
JSON файлът не се импортира	Проверете `version: 1`, задължителен `title`, съществуващи работници `Slug` и имена на свойства. JSON не позволява коментари или запетаи в края.
Не може да се възстанови `agentboard.exe`	Windows не може да замени работещ EXE. Спрете сървъра Ctrl+C и опитайте компилацията отново.
Задачите изчезнаха след актуализация	Проверете дали `--db` не сочи към друг файл и че сте влезли като същия потребител на Windows. Базата по подразбиране е в `%AppData%\AgentBoard`.

Ако грешката не е описана, съберете точния текст на съобщението, версиите agentboard version и Windows и стъпките за повторен опит. Не публикувайте частни данни за проект или съдържание на база данни в открит проблем.