Руководство пользователя

Что система умеет сегодня, как этим пользоваться и чего в ней пока нет.

Всё описанное здесь работает на живой установке. То, чего ещё нет, помечено в планах — и не описано так, будто оно есть.

Первые десять минут

1. Откройте https://ВАШДОМЕН/kanban/, войдите своим именем и паролем.
2. Слева выберите проект — или «🌊 свободный режим», если мысль ни к чему не относится.
3. Нажмите Холст — откроется записная книжка. Напишите что-нибудь: через секунду в углу появится «сохранено».
4. Откройте ту же страницу на телефоне. Ваша запись уже там.
5. Вернитесь на доску, нажмите 🎙, скажите мысль вслух и отправьте на разбор.

📱 На телефон — как приложение

Книжка ставится на телефон без магазина приложений и работает без интернета.

1. Откройте akii.quest/p/akii/ в Chrome (Android) или Safari (iPhone) и войдите логином и паролем, которые вам выдали.
2. Нажмите ⋯ на панели холста, откройте раздел «📲 Ярлык на телефон» и выберите «📲 Поставить на экран» — книжка попросит браузер поставить ярлык сама. Если браузер установку не предлагает (так бывает на iPhone), кнопка подскажет, что нажать: в Safari — «Поделиться» → «На экран „Домой“», в Chrome — меню ⋮ → «Добавить на главный экран». На экране появится значок книжки.
3. Откройте книжку со значка — она разворачивается на весь экран, как обычное приложение.

Ставите ярлык не с того устройства, на котором сидите? В том же разделе есть «🔗 Скопировать ссылку на книжку»: адрес нужно открыть на телефоне, а уже там нажать «Поставить на экран». Из Telegram и из кармана адрес не виден вовсе — за этим кнопка и стоит.

Без интернета книжка открывается и работает: записи на месте, писать и чертить можно, всё написанное само уедет на сервер, когда сеть вернётся, — плашка в углу честно скажет «офлайн — записи целы».

Свой бесплатный ключ — чтобы помощник не кончался

У гостевого входа есть потолок обращений к модели. Свой ключ снимает его: разбор записей, «Спросить» и сортировка пойдут вашим ключом напрямую — расход ваш собственный, у обоих сервисов ниже есть бесплатный уровень, карты не нужны.

1. Возьмите ключ: Groq — console.groq.com/keys, или Google Gemini — aistudio.google.com/apikey.
2. В книжке откройте ⋯ → ⚙ «Модели», выберите сервис, вставьте ключ, нажмите «проверить и добавить».
3. Всё. Ключ хранится на сервере и назад не показывается — в списке видна только маска. С ключом книжка ещё и разбирает записи сама, раз в полчаса.

1. Записная книжка — главное окно

Адрес: /kanban/canvas.html. Бесконечный холст: записи лежат там, где вы их положили; камера двигается мышью, пальцем или колесом.

Как писать

Написанное само собирается в лист. Штрих ищет рукопись по соседству и прирастает к ней. Пока пишете, ничего лишнего не появляется; тап по листу показывает шапку и рамку (потянуть за шапку — перенести, ⚙ — кнопки листа). Над листом столбиком — стенограмма вживую: строка за строкой по мере письма, под каждой строкой чернил — тонкая линия; правится на месте, ▾ — другие варианты чтения, слово с клавиатуры — жирным; формула с «=» в конце считается сразу, ответ — синим в конце строки. Набросок (штрихи, вложенные друг в друга) не читается. Знак в начале первой строки — как в бумажных заметках: «#» поручение (тег и ★), «@» встреча, «O» ждёт, «V» выполнено. Правка плашки отражается в чернилах: похожее слово — только текст, другое или добавленное — встаёт печатью, убранное — стирается; не нашлась граница слова — плашка подчёркнута волной, чернила не тронуты. Читает Google Input Tools: к нему уходят штрихи пера — не картинка и не текст записей, ключа не нужно; выключается в ⚙ Настройки → «Рукопись вживую через Google».

Жесты

Долгое нажатие — второй смысл кнопки

Запись в двух видах: карточка и правка

Пока запись не правят, она лежит на холсте карточкой: текст показан размеченным, а сама карточка занимает ровно столько места, сколько нужно тексту. Длинная обрезается — под ней «…ещё N строк — открыть». Клик по строке возвращает поле ввода, и курсор встаёт в ту строку, по которой ткнули.

Значки буллет-джорнала — кнопка • Значок под записью: задача •, выполнено ✕, перенесено →, запланировано ←, событие ○, заметка –, важно ★, идея !, изучить 👁. Значок встаёт в начало той строки, где стоит курсор, и заменяет прежний, если он там был: «задача → выполнено» — одно движение.

🧭 Разбор — то, что происходит без вас

Кнопка На разбор под записью — это «сделай сейчас». Но если вы её не нажали, это не значит «не разбирать»: значит «не горит».

Раз в полчаса система читает записи, которые вы не отправляли, и складывает из них кандидатов в задачи — во вкладку 🧭 Разбор. У кандидата есть:

• формулировка в одну-две фразы, пригодная для работы;
• срок — если в записи названа дата («завтра», «в пятницу», «до 5-го»);
• ответственный — если назван в записи; кроме того, его можно назначить самому — списком участников прямо у кандидата;
• ★ — если запись помечена важной или это сказано в тексте;
• сложность — по объёму работы;
• ссылки на записи, из которых он сделан.

👤 Ответственный-человек

Рядом с кнопками кандидата — список участников коробки: кому эта работа. В списке вы сами, владелец и те, чьим учёткам дано имя. Кнопка 👤 на мне в шапке вкладки оставляет только назначенное на вас — это и есть список задач на человеке.

Ответственный уезжает в задачу доски отдельным полем, а не словами в заголовке: слова из заголовка не отфильтровать и не собрать списком. Менять его можно, пока кандидат не ушёл в работу — карточку на доске книжка не переписывает.

Остальные инструменты

Синхронизация — как она устроена

Книжка одна на человека и открыта где угодно одновременно. Единица хранения — запись, а не холст: страница отправляет только изменившееся и тем же ответом забирает чужое. Между сохранениями — опрос раз в пять секунд и сразу при возврате на вкладку.

Одна и та же запись, изменённая с двух устройств в одну минуту, — побеждает последняя. Это сознательная цена: спорить с самим собой за одну заметку человек не будет, а терять заметку из-за соседней — будет. Камера у каждого устройства своя: телефон и ноутбук смотрят в разные места одной книжки.

👥 Общий холст — книжка на нескольких человек

В шапке (на планшете — в меню «⋯») есть выбор книжки: 📓 Моя книжка, ниже — общие холсты, и ➕ Новый общий холст…. Общий холст — это вторая книжка: свои записи, свой разбор, своя очередь внимания; личная от него не меняется никак.

2. Голос

Как записать

• В книжке: 🎙 в шапке записи — диктовка прямо в неё.
• На доске (/kanban/): большая кнопка микрофона — наговорить мысль и отправить на разбор.

Пока идёт запись, ведётся и звук, и текст распознавателя. Звук хранится — он источник правды.

Что происходит дальше

1. Запись уходит на расшифровку — на ваш домашний ПК или в облако, по переключателю «🎙 расшифровка» на доске.
2. Локально расшифровка идёт в несколько проходов: быстрая модель даёт текст сразу, лучшая уточняет, когда компьютер освободится. Статус так и говорит: «расшифровано начерно, уточняется» → «расшифровано».
3. Чистка снимает мусор распознавания: повторы (Android часто присылает фразу дважды), обрывки, сомнительные куски. Ничего не удаляется — помечается, и вы видите долю шума цифрой.
4. Разбор получает чистый текст, оригинал лежит рядом.

В планах ключевая фраза («слушать постоянно, писать после слова»), распознавание говорящего, персоны домочадцев.

3. Консоль — akii

Если рабочее окружение уже живёт в терминале, браузер не нужен.

Настройка один раз

export AKII_URL=https://ВАШДОМЕН
export AKII_USER=ваше_имя
export AKII_PASS=ваш_пароль
# либо ~/.akii.json: {"url": "...", "user": "...", "pass": "..."}

Команды и примеры

akii note "после работы купить молоко"          # запись в книжку
akii note --star "не забыть про договор"        # сразу помеченная важной

npm run build 2>&1 | akii note --title "сборка упала"    # вывод команды — в книжку
tail -200 /var/log/app.log | akii send --title "ошибки за ночь"  # сразу на разбор
git diff | akii ask "что здесь рискованно?"     # вопрос модели, ответ в консоль
docker logs mysvc --tail 100 | akii ask "почему падает?"

akii feed 10           # последние записи ленты и их судьба
akii tasks             # доска: открытые задачи по проектам
akii tasks platform    # все задачи одного проекта
akii candidates        # кандидаты из разбора
akii groom             # разобрать книжку сейчас
akii who               # кто я, куда подключён, чем занят

Вывод длиннее 20 000 знаков режется хвостом — там, где обычно ошибка. Всё, отправленное из консоли, через несколько секунд видно на планшете и телефоне: книжка одна.

4. Доска и агенты

Адрес: /kanban/.

Как задача попадает в работу

мысль → разбор → задача на доске → агент → результат → журнал

• Автопилот включён — агент берёт задачи сам, по одной.
• Сложность решает, какой моделью: простая — дешёвой, обычная — средней, сложная и архитектурная — сильной. Каждое решение пишется в журнал.
• Роль решает, кто выполняет: серверный контейнер (ваша подписка) или домашний ПК (локальные подписки и ваши файлы).
• Кончился лимит — задача возвращается в очередь без штрафа, исполнитель ждёт сброса и продолжает сам.
• Пока вы сидите в терминале в каталоге проекта, автопилот в этот проект не лезет — чтобы не спорить с вами за одни и те же файлы.

Команды (в поле ввода на доске или в Telegram)

5. Терминал в браузере

Адрес: /term/. Это ваш контейнер: тот же каталог и те же файлы, что у агента, ваша подписка.

Что помогает на планшете:

6. Проекты

Проект — каталог на коробке с git-репозиторием и обязательными файлами: CLAUDE.md (правила проекта), todo.md, changelog.md, папка public/.

• Результат виден по адресу /p/<проект>/ — это содержимое public/.
• /publish открывает его без пароля, /unpublish закрывает.
• Живой сервер проекта запускается командой /serve по манифесту run.json:

{ "cmd": "node server/server.mjs", "dir": ".", "port_env": "PORT" }

Порт назначает платформа, сервер берёт его из переменной окружения — зашитый в коде номер здесь самая частая поломка. API проекта доступно по /p/<проект>/api/, префикс срезается.

7. Что система делает сама

Без вашего участия, пока вы заняты:

8. Возможности — что есть сегодня

9. Если что-то пошло не так

10. Что стоит знать про приватность

• Квота принадлежит владельцу коробки. Домочадцы и гости работают локальными моделями или получают доступ к подписке владельца осознанно, с потолком.
• Владелец видит расход и границы, но не переписку. Это правило системы, а не настройка.
• Голос расшифровывается дома, если так стоит переключатель. Тихой подмены на облако нет.
• Записи участника с контейнером разбирает только его подписка — к третьему ключу они не уходят. Единственное исключение вы заводите сами: добавили свой ключ во вкладке ⚙ Модели и выбрали его у «🤖 Спросить» — эта запись уходит в тот сервис, чей ключ вы вписали. Разбор туда не ходит никогда, только вопрос, который вы задали сами.
• Проекты живут на вашей коробке. Наружу ничего не отправляется, пока вы сами не нажмёте «открыть всем».