← Docs

Часто задаваемые вопросы

Что происходит с моими данными о затратах, когда я удаляю правило выставления счетов?
Твои данные о затратах всегда сохраняются. Удаление правила выставления счетов удаляет только само правило — оно никогда не затрагивает историю твоих затрат. Затраты, которые ранее соответствовали этому правилу, просто становятся не назначенными и снова появляются в твоем представлении 'Unassigned Costs' при следующем открытии панели. Оттуда ты можешь переназначить их на другой проект или клиента в любое время.
Если я переназначу затраты на другой проект после удаления правила выставления счетов, будет ли переназначение применяться к прошлым затратам?
Да — переназначение применяется ретроспективно ко всем затратам, записанным с момента установки расширения. Твои исходные события затрат хранятся постоянно в локальной базе данных и никогда не привязаны к конкретному правилу выставления счетов. Когда ты добавляешь новое сопоставление, механизм синхронизации сопоставляет его с твоей полной записанной историей. В следующий раз, когда ты запустишь 'Sync Now' или 'Backfill', временные записи создаются или обновляются в твоем программном обеспечении для выставления счетов для каждого совпадающего дня в прошлом, включая дни, которые ранее были не назначены. Ничего не теряется между моментом удаления правила и моментом создания нового.
Нужно ли мне что-то настраивать перед началом отслеживания затрат?
Нет. 'Vibes to Bucks' начинает записывать использование твоего Cursor AI в момент установки — не требуется ни учетная запись для выставления счетов, ни сопоставления. Расширение использует разумные настройки по умолчанию (интервал опроса 5 минут, отображение в EUR, курсы обмена ECB) и сразу начинает заполнять твою локальную базу данных. Ты можешь сразу исследовать 'Usage Dashboard'. Синхронизация счетов с Moneybird или Harvest — это отдельный шаг, который ты настраиваешь, когда будешь готов. Примечание: отслеживаются только те затраты, которые происходят, пока расширение установлено и работает. Нет способа импортировать или восстановить затраты до установки.
В чем разница между планами Free и Pro?
План Free предоставляет полное отслеживание затрат: непрерывный опрос использования твоего Cursor AI, локальный журнал SQLite, 'Usage Dashboard' с графиками, фильтрами, навигацией по периодам и спарклайнами, а также отображение в нескольких валютах для 30 валют. План Pro (€24 в год или €149 пожизненно, с 14-дневной бесплатной пробной версией) разблокирует синхронизацию с Moneybird или Harvest, бюджеты затрат AI с предупреждениями о перерасходе, AI-генерируемые сводки коммитов для описаний временных записей, команды dry-run и backfill для синхронизации, а также статусную строку на окно, показывающую разрешенное имя клиента, имя проекта и использование недельного бюджета для текущего рабочего пространства.
Что такое множитель затрат и когда его следует использовать?
Множитель затрат масштабирует твои исходные затраты на токены AI перед их преобразованием в оплачиваемые часы. Используй его, когда хочешь выставлять счета за работу с AI с учетом прибыли — множитель отражает реальную ценность, которую ты предоставляешь: создание запросов, проверка и итерация результатов, интеграция результата и ответственность за конечный продукт. Множитель 5 означает, что каждый €1 затрат на AI становится €5 дохода от выставления счетов. Начни с 5 и отрегулируй в соответствии с соглашениями с клиентами. Если ты хочешь только возмещение затрат без маржи, используй режим passthrough.
Могу ли я сопоставить нескольких клиентов с одним репозиторием?
Да. Используй сопоставление репозитория с несколькими клиентами с шаблонами веток. Каждый шаблон ветки сопоставляется с разными контактами и проектами в твоем программном обеспечении для выставления счетов. Например, ветки, соответствующие `client-a/*`, могут выставлять счета Клиенту A, в то время как ветка `dev` выставляет счета Клиенту B по другой ставке. Шаблоны веток поддерживают точное совпадение, одноуровневый подстановочный знак (`client-a/*`) и рекурсивный подстановочный знак (`feature/**`). Если ни один шаблон ветки не совпадает, событие рассматривается как не сопоставленное и появляется в твоем представлении 'Unassigned Costs'.
Работает ли Vibes to Bucks, когда я подключен к удаленному серверу через SSH?
Да. Расширение работает как UI-расширение, что означает, что оно всегда выполняется на твоем локальном компьютере — даже когда Cursor подключен к удаленному хосту через SSH. Твоя локальная папка `~/.vibes-to-bucks/` (база данных журнала, конфигурация и файл лицензии) всегда находится на твоем ноутбуке, поэтому 'Usage Dashboard' всегда имеет полный обзор всей активности, независимо от того, к какому удаленному рабочему пространству ты подключен. Единственное требование для удаленных SSH — это аутентификация на основе ключей без пароля, чтобы расширение могло запускать `git log` на удаленном сервере для получения сообщений о коммитах.
Поддерживает ли Vibes to Bucks облачных агентов Cursor (облачная разработка Cursor)?
Нет — облачная разработка в настоящее время не поддерживается. 'Vibes to Bucks' работает, наблюдая за активностью в твоих открытых локальных окнах Cursor, чтобы отнести затраты AI к правильному рабочему пространству. Облачные агенты Cursor работают полностью в облачной инфраструктуре Cursor без локального окна Cursor, поэтому расширение не может наблюдать или атрибутировать эти затраты. Любые затраты AI, сгенерированные облачными агентами, будут отображаться как не назначенные затраты в твоем представлении 'Unassigned Costs'. Локальная разработка и удаленная разработка через SSH полностью поддерживаются.
Где хранятся мои данные и отправляет ли Vibes to Bucks что-либо в облако?
Все данные о затратах хранятся в локальной базе данных SQLite по адресу `~/.vibes-to-bucks/ledger.db` на твоем компьютере. Ничего не отправляется на серверы Vibes to Bucks. Расширение делает четыре исходящих подключения: к API панели управления Cursor для получения событий использования, к API Frankfurter (Европейский центральный банк) для получения ежедневных курсов обмена, к API Lemon Squeezy для проверки твоей лицензии Pro (периодическая перепроверка, данные об использовании не отправляются) и к твоему поставщику выставления счетов (Moneybird или Harvest) при синхронизации. Нет телеметрии, нет аналитики, никакие данные о затратах не покидают твой компьютер, кроме тех, которые отправляются непосредственно на твой собственный счет для выставления счетов.
Что происходит, если у проекта нет удаленного репозитория git?
Ты все равно можешь отслеживать и выставлять счета за затраты AI, используя правило сопоставления на основе папок. Добавь сопоставление с путем `folder` вместо URL удаленного репозитория `repo` — например, `/home/user/experiments`. Любые события использования Cursor из этой папки рабочего пространства будут сопоставлены с указанным клиентом и проектом. Сопоставления папок также полезны как универсальное правило для захвата затрат из папок с нуля, репозиториев на ранней стадии или любого рабочего пространства, для которого еще не настроен удаленный репозиторий.
Чем отличается Sync Now от Backfill?
'Sync Now' отправляет оплачиваемые часы в твое программное обеспечение для выставления счетов за все дни, записанные до сих пор. 'Backfill' позволяет синхронизировать определенный исторический диапазон — ты выбираешь дату отсечения, и расширение создает или обновляет временные записи для каждого совпадающего дня между этой датой и сегодняшним днем. Обе команды охватывают только затраты, записанные с момента установки расширения; нет способа восстановить затраты до этого момента. Обе команды идемпотентны: если временная запись уже существует для данного дня, клиента и проекта и итоговые суммы не изменились, синхронизация пропускает ее без выполнения вызова API.
Какие валюты поддерживаются и как получается курс обмена?
Расширение поддерживает все 30 валют, публикуемых API Frankfurter (источник Европейский центральный банк), включая EUR, USD, GBP, CHF, JPY, CAD, AUD и другие. USD всегда используется в качестве базы, поскольку затраты Cursor номинированы в USD — для отображения в USD конвертация не требуется. Для всех остальных валют ежедневные курсы получаются из Frankfurter и кэшируются локально в SQLite. Если API недоступен, расширение использует значение `fallback_rate` в твоей конфигурации (по умолчанию 0.92, откалибровано для EUR). Для Backfill расширение извлекает исторический курс для каждого конкретного прошедшего дня, чтобы конвертации были точными даже для записей, созданных несколько месяцев назад. Валюта отображения по умолчанию — EUR и может быть изменена в настройках расширения.