Заметки о выпусках
Текущая стабильная версия: 1.1.3. Обновите инструмент командой dotnet tool update --global bee-ai --version 1.1.3; см. инструкцию по установке. Разделы ниже сохраняют подробную историю версий. Подробности нового выпуска добавляются сюда после редакционной проверки.
Проектные инструкции для агентов разработки
Заголовок раздела «Проектные инструкции для агентов разработки»bee setup agents --root CHECKOUT --dry-run --json показывает будущий блок Bee в AGENTS.md и CLAUDE.md; без --dry-run устанавливает его. bee doctor --root CHECKOUT --json проверяет блоки и конфигурацию hook’ов хоста без подключения к базе. Интерактивный bee init предлагает настройку после успешной инициализации; автоматический запуск требует явного --setup-agents. Существующая установка может вызвать setup напрямую. Установка пакета не знает каталог проекта и не редактирует его автоматически.
Управляемые инструкции требуют выбирать подходящий маршрут Bee один раз для класса действий, использовать поддерживаемый bee code analyze и проверенные, привязанные к исходникам проверки bee qa run вместе с реальными тестами репозитория. Точная версия или хеш утверждённого дизайна связывается с внешним видом и действиями frontend и необходимыми API и данными backend; пропущенную часть нельзя скрывать.
Код 0 команды doctor подтверждает совпадение управляемых файлов с этим бинарным файлом; код 5 указывает на отсутствующие, устаревшие, изменённые или небезопасные файлы. hostActivation и toolReadiness остаются unverified, пока не проверены новая сессия хоста и нужные инструменты. Частичный анализ кода, только объявленные QA проверки и визуальное сходство сами по себе не означают полного принятия.
Обновите Bee командой dotnet tool update --global bee-ai --version 1.1.3 и перезапустите длительно работающие процессы. Команды приведены в руководстве первого запуска.
Локальные инструкции и явные проверки изменений
Заголовок раздела «Локальные инструкции и явные проверки изменений»bee guide capabilities --json перечисляет установленные возможности CLI и MCP, их эффекты и требования. bee guide task предлагает инструкции для исходного кода, изменений, тестов, покрытия и дизайна. Команда читает публичные метаданные без базы данных или настройки провайдера; она не изучает код, не запускает проверки и не подтверждает готовность. Для Python используются пакеты с явными диапазонами строк или передача контекста вместо семантического графа.
Хуки начала сессии могут передать публичное руководство, даже если необязательная память не настроена или недоступна. Настройка и доверие к хукам в хосте по-прежнему обязательны; регистрация сама по себе не доказывает доставку или использование инструмента. Защита выбора экземпляра и отказа в передаче контекста сохраняется.
bee qa run --root CHECKOUT --spec task.json --json запускает явно заданные проверки репозитория или анализа кода. Результаты связывают критерии с проверками и путями исходников, сохраняют хеши вывода и сравнивают состояние исходников до и после выполнения. Вызывающая сторона должна проверить команды: они могут записывать файлы и запускать процессы. Это не песочница. Контракт команды доступен через bee qa run --help --json.
verifiedCompletion=true подтверждает только соответствие объявленных критериев выполненным проверкам с границей доверия in_process_only. Это не доказывает качество проверок или смысл требований на естественном языке; субъективные критерии требуют оценки. Сохранённый JSON не является доверенным доказательством для следующего запуска. Существующая bee qa assess остаётся диагностической: acceptance=false и код выхода 5.
Обновите инструмент командой dotnet tool update --global bee-ai --version 1.1.2 и перезапустите долгоживущие процессы Bee.
Результаты тестов с ошибками и исходный код
Заголовок раздела «Результаты тестов с ошибками и исходный код»bee test summarize REPORT.trx --failures --json выбирает тесты с исходами Failed, Error и Timeout, добавляя итоги по классам и первую непустую строку сообщения. Объявленные и фактически прочитанные итоги остаются видимыми. Отсутствующие сведения и ограничения вывода обозначаются явно; переход к следующей странице привязан к хешу отчёта.
bee graph explain TARGET --source --compact --json добавляет к результату графа текст найденного объявления и проверенные диапазоны строк. Устаревший, неоднозначный или неполный исходный код отмечается явно.
Эти режимы CLI включаются явно; совместимость существующего вывода по умолчанию сохраняется. Общая инструкция направляет агентов к нужным данным и рекомендует прекратить дополнительные чтения, когда запрошенные сведения получены полностью. Существующий MCP-инструмент bee_context_packet по-прежнему доступен для ограниченных выборок исходного кода.
Обновите пакет командой dotnet tool update --global bee-ai --version 1.1.1 и перезапустите длительно работающие процессы Bee.
Локальный контекст и обязательное подтверждение задачи
Заголовок раздела «Локальный контекст и обязательное подтверждение задачи»Выпуск добавляет запросы и восстановление локальных артефактов, ограниченные пакеты исходного кода, проверенный вывод команд, явные профили провайдеров и необязательное локальное сжатие текста. Импорт покрытия поддерживает выбор файлов и непокрытых строк с метаданными полноты.
Bee использует единый контракт рабочего процесса. Управляемые профили Codex с типизированным требованием задачи проверяют принятие по фактическому совпадающему результату команды Bee; свободные запросы и неподдерживаемые пути ограничиваются рекомендациями. Строки прогресса холодного графа принимаются с сохранением проверок команды, артефакта и актуальности.
Обновите пакет командой dotnet tool update --global bee-ai --version 1.1.0 и перезапустите длительно работающие процессы Bee.
MQTT QoS 2
Заголовок раздела «MQTT QoS 2»Подсказки передаются с MQTT QoS 2. Существующий Mongo claim обеспечивает вставку в контекст не более одного раза. Сбой во время вызова harness оставляет доставку в состоянии uncertain без автоматического повтора; повторная отправка допускается только по явному запросу получателя. Только worker использует постоянную сессию брокера с ограниченным сроком; publisher и doctor используют чистые сессии и случайные ID. bee collaborate doctor сообщает о снижении QoS, а доставка продолжается через Mongo polling. Результат каждого получателя сохраняется даже при истечении срока сообщения до публикации подсказки.
Несколько экземпляров Bee на одной машине
Заголовок раздела «Несколько экземпляров Bee на одной машине»Одна машина может параллельно запускать полностью раздельные экземпляры Bee — например, по одному на каждую организацию. Существующий ~/.bee по-прежнему работает без изменений как экземпляр по умолчанию. bee instance add <name> --path <dir> [--remote <glob>] создаёт именованный экземпляр в ~/.bee/instances/<name>/ с собственным bootstrap и базой данных, пространством для совместной работы, персоной, worker’ом и локальным состоянием.
Bee выбирает экземпляр по рабочему каталогу и remote репозитория (включая worktree), по --instance или BEE_INSTANCE, либо по вызывающей сессии. Этот последний источник не ограничен только hook-вызовами: внутри сессии Claude Code, Codex или Hermes обычный CLI-вызов закрепляется (pinned) точно так же, как hook-вызов, а bee instance exec <other> отказывается обращаться к экземпляру, отличному от собственного экземпляра вызывающей сессии. Это закрепление действует сразу для каждого native-идентификатора сессии, присутствующего в окружении, поэтому вложенный harness (Codex, запущенный внутри Claude Code, или наоборот) продолжает работать с тем же экземпляром, а смешивание двух экземпляров внутри одного дерева разговора намеренно запрещено. Конфликтующий выбор останавливается с кодом выхода 8 вместо смешивания данных, а hook’и не выдают содержимое чужого экземпляра, а просто не доставляют steering. Каталоги, не принадлежащие ни одному экземпляру, используют экземпляр по умолчанию и явно сообщают об этом. bee instance list, show, which, map, unmap, policy, remove, exec, doctor, worker-agent и sessions prune управляют настройкой и проверяют её. Ни один pin сессии никогда не удаляется автоматически; единственный явно подтверждаемый способ отозвать сессии, простаивающие дольше выбранного возраста, — команда bee instance sessions prune --older-than <days> --yes. bee init никогда не перезаписывает существующий bootstrap без подтверждения. Без реестра экземпляров Bee ведёт себя в точности как раньше.
Это разделение защищает от ошибок в пределах одного пользователя операционной системы; настоящей жёсткой границей между организациями служат отдельные учётные данные — пользователь базы данных и учётная запись брокера, привязанные к своему экземпляру. Настройка и ограничения описаны в руководстве по экземплярам.
Импорт дизайна и визуальные проверки
Заголовок раздела «Импорт дизайна и визуальные проверки»bee design один раз импортирует полный интерактивный экспорт дизайна (HTML, каталог или ZIP) и возвращает ограниченные, точные фрагменты исходника для реализации (import, list, slice, map, verify); bee design mcp предоставляет агентам те же инструменты только для чтения. bee visual захватывает экраны приложения через Playwright и сравнивает их по областям с проверенными эталонами дизайна (reference, capture, compare, report, select); те же сравнения используют помощники iOS SnapshotTesting и Android Roborazzi. Настройка выполняется явно: Bee не устанавливает пакеты Node или браузеры, а профиль QA ui-visual остаётся диагностическим.
Плагин Bee для Claude Code и Codex
Заголовок раздела «Плагин Bee для Claude Code и Codex»Один плагин bee объединяет десять рабочих процессов (память, анализ кода, проверка, планы и совместная работа, worker’ы, дизайн и операции) и запускает инструменты Bee только для чтения — skill и plan. Нативный установщик по умолчанию показывает предпросмотр и применяет изменения только по запросу; он проверяет хост, marketplace и установленную версию Bee, сохраняя настройки модели и провайдера.
Флаг версии
Заголовок раздела «Флаг версии»bee -v и bee --version выводят версию одной строкой; bee --version --json добавляет commit, runtime и платформу. Флаг отвечает раньше, чем происходит обращение к конфигурации, базе данных или сети, поэтому работает даже при неисправной настройке.
Ответы графа в пределах бюджета
Заголовок раздела «Ответы графа в пределах бюджета»Покрытие (coverage) больше не входит в несжимаемую часть ответа графа. Когда ответ превышает --output-budget-chars или --budget, Bee сначала сжимает сведения о покрытии (строки проектов, предупреждения и заметки о контексте — с точными числами и указателем на bee graph status --json) и только после этого отбрасывает записи результата. output.coverageSummarized сообщает, было ли покрытие сокращено; output.truncated и счётчики пропусков описывают только записи результата. JSON-ответы остаются в пределах ceil(utf16/4) <= N.
Предупреждение о неразрешённой диспетчеризации интерфейса — одна строка на ответ. Оно появляется там, где отсутствующее ребро implements может скрыть часть ответа: callers, callees, учитывающие реализации, impact и member explain, включая реализации, заявленные другим проектом. Outline больше его не несёт. Когда ответ сжимает сведения о покрытии, он указывает на bee graph status --json --compact (с --project для одного или двух проектов) — ограниченное представление пропущенной диагностики. graph explain и graph impact справедливо обрезают длинные списки, так что один список не опустошается, пока другой сохраняет много строк.
Обзоры TypeScript, Vue и Kotlin
Заголовок раздела «Обзоры TypeScript, Vue и Kotlin»Статус обзора TS/Vue и код выхода определяются для каждого файла отдельно. Чистый файл в частично разобранном проекте tsconfig завершён с кодом выхода 0 и однострочной заметкой о проекте. Файл с собственными диагностиками разбора, либо чей статус не удалось подтвердить, считается неполным с кодом выхода 5. Собственные заметки обозреваемого файла показываются всегда.
Диапазоны Kotlin теперь учитывают тела выражений, продолжающиеся операторами, raw-строки, заканчивающиеся последовательностью кавычек, и многострочные значения по умолчанию в конструкторах. Сохранённые графы Kotlin перестраиваются один раз (extractor 6).
Поиск по памяти
Заголовок раздела «Поиск по памяти»Явный поиск по ключевым словам по-прежнему находит термины в любом месте записи, но термин, найденный только после первых 400 символов, получает меньший вес, поэтому запись, определяющая тему, снова оказывается первой. Обычные строки показывают окно в 200 символов вокруг лучшего совпадения с маркером обрезки; --full выводит полное содержимое и принимается только командой search. JSON-вывод не изменился. Сообщения в stderr объясняют частичные многотерминные совпадения и пустые семантические результаты. У семантического поиска нет порога оценки по умолчанию; измеренная калибровка задокументирована.
Отчёты о покрытии и тестах
Заголовок раздела «Отчёты о покрытии и тестах»Ранее отклонявшиеся отчёты Coverlet OpenCover и Cobertura теперь импортируются: точки ветвления лямбд, делящие один offset на разных строках, очень длинные имена конструкторов, суммарные значения producer’а, превышающие его же собственные записи, и один switch, смешанный с jump’ами на одной строке. Такие несоответствия producer’а сообщаются в новом массиве warnings с заявленными и наблюдаемыми числами и никогда не меняют код выхода. importerVersion теперь равен 2, поэтому одинаковые байты отчёта дают новый importId.
Компактные сводки TRX сохраняют полные имена тестов, не завершившихся успешно.
Измеренное использование
Заголовок раздела «Измеренное использование»bee budget --measured передаёт потоком файлы rollout без ограничения на размер всего файла и сообщает о turn’ах. Снимок, заканчивающийся внутри открытого turn’а, считается неполным (код выхода 5, open_turn) и всё равно сообщает согласованное использование по уже закрытым turn’ам. usage, lastRequestUsage и requestCount заполняются, когда записи response согласуются; usageUnavailableReason объясняет, почему иначе они остаются null. По умолчанию --json — это ограниченная проекция с точными счётчиками пропусков; --full возвращает каждое наблюдение.
Журнал steering, рекомендации для агентов и инструменты контекста
Заголовок раздела «Журнал steering, рекомендации для агентов и инструменты контекста»Журнал steering теперь записывается без метки порядка байт (BOM), объединяет обрезанные элементы за одну публикацию и убирает рутинные строки перед редкими исключениями и доказательствами сбоев. Beta-читатели по-прежнему принимают новые строки.
Рекомендации для агентов называют дешёвые формы: graph outline --compact --json, test summarize <trx> --json --compact и budget --measured --compact. Они также просят агентов не перепроверять свежий, полный ответ графа с помощью grep.
bee context doctor принимает задокументированные ключи настроек Claude Code, события hook и prompt hook’и. Неизвестные ключи не приводят к отклонению файла, а называются явно; имена, похожие на учётные данные, скрываются (redacted). bee context audit --json --compact использует 12-символьные шестнадцатеричные префиксы хешей; --full-hashes возвращает полные дайджесты.
Обновление
Заголовок раздела «Обновление»dotnet tool update -g bee-ai --version 1.0.0После обновления перезапустите долгоживущие процессы Bee (worker, collaborate channel и receive, MCP-серверы). Изменения, которые могут повлиять на скрипты:
bee code coverage import --compactиbee budget --measured --compactили--fullтребуют--json; иначе они завершаются с кодом выхода 4.bee budget --measured --jsonпо умолчанию возвращает ограниченную проекцию; добавьте--fullдля получения всех наблюдений. Живая сессия внутри открытого turn’а завершается с кодом выхода 5 иopen_turn.- Обычные строки
bee remember searchобрезаются; используйте--fullили--jsonдля полного содержимого. - Значения
importIdдля покрытия меняются, потому чтоimporterVersionравен2. - Сохранённые графы Kotlin перестраиваются при следующей сборке графа.
- Формат журнала steering получил сводку обрезки на каждую публикацию; beta-читатели по-прежнему её принимают.
- Собственный набор тестов Bee больше не откатывается на настоящий домашний каталог; при разработке Bee всё равно запускайте его с изолированным
HOME.
1.0.0-beta.18
Заголовок раздела «1.0.0-beta.18»Предварительная версия
Актуальность графа, семантика и ограниченный вывод
Заголовок раздела «Актуальность графа, семантика и ограниченный вывод»Проверка актуальности графа отслеживает исходники и вычисленные зависимости. Посторонние артефакты больше не требуют проверки метаданных исходников; новые исходники, явные записи Compile и вновь созданные условные импорты по-прежнему вызывают обновление. Автономное связывание C# может использовать установленные точные версии пакетов и объявленные локальные ссылки без восстановления пакетов и запуска сборки. Анализ влияния TypeScript следует обратным статическим импортам; это не семантический граф вызовов функций.
Компактные ответы сохраняют сведения о покрытии и общее число пропусков. bee graph status --json показывает всю сохранённую диагностику. Бюджет JSON-запроса охватывает весь ответ; обзор объявлений по умолчанию ограничен 65 536 символами. При недостаточном бюджете возвращается minimumRequiredChars, если сообщение об ошибке помещается. --excerpts добавляет ограниченные строки исходника в callers и элементы importedBy команды explain только при совпадении индексированного хеша с безопасно прочитанным файлом. Ссылки expression-tree и резервный структурный путь явно обозначаются.
Диагностика контекста без записи
Заголовок раздела «Диагностика контекста без записи»Context doctor может проверить project_doc_max_bytes в выбранном входе codex-config-toml-v1 и приоритет выбранных файлов AGENTS.override.md. Это диагностика выбранных входов, а не доказательство загрузки инструкций хостом. --remediation-preview выдаёт предложения с writesPerformed: false. Context audit отклоняет сравнение файла с самим собой и поддерживает выбор до 1024 файлов через --max-files, сохраняя остальные ограничения чтения и сведения о пропусках.
Политика hook и выбор памяти
Заголовок раздела «Политика hook и выбор памяти»bee hook policy-export создаёт ограниченный локальный профиль правил и закреплённой памяти. Явный --local-policy проверяет проект, схему и хеш при каждом вызове; удалённые изменения он не отслеживает. Ошибки hook сохраняют диагностику нулевой доставки. Параллельное чтение сохраняет детерминированный вывод. Подавление повторов Hermes через --retained-context включается явно и по умолчанию выключено; неизвестный, сброшенный или изменённый контекст повторно получает инструкции. Контракт квитанции не доказывает сохранение содержимого native-Hermes или подтверждение моделью.
Поиск памяти добавляет лексический --match-all и необязательный семантический --min-score; автоматический выбор контекста остаётся ограниченным. При отсутствии совпадений обычный stdout пуст, а пояснение выводится в stderr.
Настройка CLI и чтение доказательств
Заголовок раздела «Настройка CLI и чтение доказательств»bee skill setup --json объясняет настройку соединения, не разрешая skill и не создавая квитанцию о чтении. bee howto list --builtin --json выбирает отдельные общедоступные инструкции Bee и не заполняет пользовательский каталог. bee lint --rules сообщает, когда ни один анализатор не запускался.
bee test summarize по умолчанию оставляет в тексте итог и короткие сообщения об ошибках; --full, --stack и --metadata включают подробности. Полный JSON остаётся стандартным форматом; перед удалением строк результатов пробуется компактное представление. Ограничение вывода не меняет прочитанный результат неудачного теста. Импорт LCOV сохраняет измеренные идентификаторы функций и счётчики; отсутствующие измерения остаются неизвестными. Чтение расхода поддерживает явно увеличенные ограниченные снимки, но не доказывает завершение сессии. Эти изменения не устанавливают общего ускорения, экономии токенов или расходов.
Обновление
Заголовок раздела «Обновление»dotnet tool update -g bee-ai --version 1.0.0-beta.18После обновления перезапустите длительно работающие процессы Bee. Существующий кеш графа обновится при изменении контракта извлечения. Экспорт политики и подавление повторов retained-context требуют явного выбора; обновление не включает их автоматически.
1.0.0-beta.17
Заголовок раздела «1.0.0-beta.17»Предварительная версия
Дочерние планы и сессии worker
Заголовок раздела «Дочерние планы и сессии worker»Дочерний план хранит неизменяемое происхождение в полях parentId, parentStepId и parentRevision. bee plan children показывает непосредственные дочерние планы с ограниченной пагинацией и фильтром по шагу. Создание или завершение дочернего плана не меняет родителя и не завершает его шаг. Чтение требует вашей собственной активной сессии; reported_complete остаётся отчётом владельца, отдельным от приёмки QA.
bee worker profiles перечисляет локальные профили; bee worker inspect проверяет локальную политику без запуска процесса. Проверка не доказывает аутентификацию, native-привязку или свободную ёмкость. Аутентифицированный bee collaborate launch выбирает узел, настроенный профиль и ключ рабочей области. Исполняемый файл, аргументы и окружение задаёт локальная политика принимающего узла. Запуск включается явно; worker --once и worker --json выполняют только обслуживание. Неопределённый результат блокирует новые запуски в этом узле и пространстве; повтор запроса не разрешает второй запуск.
MCP для чтения и восстановление
Заголовок раздела «MCP для чтения и восстановление»bee mcp serve предоставляет через stdio ограниченные инструменты skills и Plan, включая bee_plan_show и bee_plan_next. Он не присоединяется к сессии и не меняет планы. Возвращённое содержимое skill требуется прочитать отдельно.
Прямые клиенты Codex stdio на macOS и Linux могут передавать params._meta.threadId для выбора собственной существующей привязки. Каждый вызов проверяет владельца native-процесса и зарегистрированную сессию; одного thread ID недостаточно для доступа. Для неподдерживаемых цепочек запуска, владельцев нескольких сессий и metadata-контекстов Windows следует использовать существующий CLI. Учётные данные skills могут использовать существующие ссылки vault; вызовы чтения отклоняют небезопасные файлы ключей, не меняя разрешения. Восстановление совместной работы и ограниченная очистка сохраняют незавершённые или неопределённые результаты.
Ограничения графа и пропущенный контекст
Заголовок раздела «Ограничения графа и пропущенный контекст»bee graph explain применяет запрошенный --limit к спискам вызовов и сообщает о пропущенных записях. Обзоры объявлений показывают пропуски, в том числе в компактном формате. Диагностика парсера и разрешения вызовов интерфейсов яснее указывает на недостающий контекст; компактный вывод сохраняет предупреждения о покрытии графа.
Поиск в памяти и ограниченный контекст запроса
Заголовок раздела «Поиск в памяти и ограниченный контекст запроса»Явный bee remember search находит совпадения и в поздних частях сохранённого текста. Автоматическая выборка для запроса остаётся ограниченной; повторы удаляются в пределах одного вывода, а обрезка явно обозначается. bee handover сообщает число возвращённых записей и наличие дополнительных наблюдавшихся записей через hasMore и truncated.
Отчёты о покрытии, тестах и расходе
Заголовок раздела «Отчёты о покрытии, тестах и расходе»bee code coverage import обрабатывает больше вариантов Cobertura и OpenCover от разных генераторов, включая отчёты Coverlet. bee test summarize --json --compact сохраняет подробности ошибок в пределах бюджета вывода. Отчёты о расходе обрабатывают записи native-обёрток и проверяют скопированную историю ветвления Codex, включая границы вложенных родительских сессий и идентичность потока. Подсчёт токенов Unicode последовательно обрабатывает символы дополнительных плоскостей. Импортированные отчёты и записанные счётчики сохраняют прежние ограничения доказательств; они не подтверждают начисления, экономию или приёмку выпуска.
Обновление и совместимость
Заголовок раздела «Обновление и совместимость»Привязки Linux только со старой временной меткой процесса не подтверждают native-владение. Повторно присоединитесь к собственной сессии через обычный CLI-процесс bee collaborate join, затем перезапустите MCP-процесс. Вызовы MCP для чтения не исправляют старые привязки; старые бинарные файлы сохраняют прежнюю проверку активности Linux. Metadata-контексты Windows по-прежнему требуют существующий CLI.
dotnet tool update -g bee-ai --version 1.0.0-beta.17После обновления или повторного присоединения перезапустите долгоживущие MCP-процессы. Существующие корневые планы остаются действительными. Старые бинарные файлы не понимают происхождение дочерних планов; при откате сохраняйте данные Plan. Профили worker локальны и не распространяются через общую конфигурацию. Прежние руководства, context doctor, отчёты о передаче и оценка токенов остаются доступны.
1.0.0-beta.16
Заголовок раздела «1.0.0-beta.16»Этот выпуск объединяет проверку выбранных источников без изменений файлов и метаданные вывода, который Bee успешно записал. Используйте doctor до выбора контекста, затем изучайте наблюдения доставки, чтобы решить, что требует проверки.
Оцените известный контекст перед началом задачи
Заголовок раздела «Оцените известный контекст перед началом задачи»bee token estimate помогает сравнивать явно выбранные запросы, инструкции и фрагменты исходников перед выбором контекста. Команда читает UTF-8 файлы или явно перенаправленный stdin офлайн, без инициализации, вызова провайдера и выполнения задачи. Меньшее число само по себе не доказывает равноценное качество или достигнутую экономию токенов.
Подготовьте demo_dir, prompt.txt и context.txt по руководству проверки токенов, затем выполните:
BEE_HOME="$demo_dir/profile" bee token estimate --root "$demo_dir" \ --file prompt.txt --file context.txt --encoding cl100k_base \ --calls 3 --output-budget 2000 --jsonПример насчитывает 7 входных токенов на вызов: для трёх вызовов выделяются 21 входной токен и 6000 токенов вывода, всего 6021. --calls повторяет один выбранный вход; это не прогноз шагов задачи или растущей беседы. --output-budget — ваш бюджет на вызов, включая запланированное рассуждение, а не прогноз вывода или принудительный предел генерации. При его отсутствии выходной и общий бюджеты остаются null; явный ноль остаётся нулём.
Эвристика по умолчанию utf16-ceil-div4@1 — оценка, а не верхняя граница. Явные o200k_base и cl100k_base используют данные из пакета для подсчёта обычного текста в этой кодировке; совместимость с моделью или точность начислений за полный запрос не заявляются. Реальный будущий вывод, рассуждение, результаты инструментов, скрытое обрамление и поведение кэша остаются неизвестными. Сопоставление моделей, цены и использование провайдера не выводятся.
--limit 0 скрывает строки вкладов, сохраняя итоги входа/сценария и пропущенные вклады. Вход ограничен 64 выборками, 256 КиБ на вход и суммарно 1 МиБ; JSON — 32 КиБ. Для точных режимов сумма квадратов длин естественных фрагментов всех входов в байтах UTF-8 дополнительно должна быть ≤67108864 (один фрагмент — до 8192 байт). Превышение возвращает tokenization_limit и null-итоги без обрезки или смены метода. Справка/полная оценка дают 0, неверные аргументы — 4, отклонённый вход/ошибка выполнения/вывода — 5.
Выберите контекст, оцените его, сравните достаточность и выполните задачу отдельно. Затем используйте существующий процесс bee budget --measured с явно выбранным поддерживаемым журналом и точной идентичностью потока; см. записанный расход и его ограничения. Предварительные бюджеты, наблюдения доставки и записанный расход отвечают на разные вопросы.
Проверьте выбранный контекст до передачи ИИ
Заголовок раздела «Проверьте выбранный контекст до передачи ИИ»Агенты могут проверить размер и доступность выбранных источников контекста и правил до чтения содержимого или предложения изменений. bee context doctor изучает явный манифест и считает поддерживаемые объявления инструментов/хуков без запуска. Инициализация или подключение к БД не нужны; выбранные файлы не изменяются. Кандидаты на дублирование — отдельный результат bee context audit, а не находка doctor или разрешение удалить правило.
В руководстве context doctor приведены временные файлы только для чтения, выбор физического корня, точные измерения UTF-8/UTF-16, отсутствующие и неподдерживаемые входы, а также проверка дубликатов.
После создания синтетических файлов и переменной demo_dir по этому руководству выполните:
BEE_HOME="$demo_dir/profile" bee context doctor --helpBEE_HOME="$demo_dir/profile" bee context doctor --manifest "$demo_dir/manifest.json" --json --budget 16384В этом синтетическом примере код 0 сопровождается строкой read для rules и строкой declared для tools: Markdown-файл содержит 109 байтов UTF-8, 107 единиц UTF-16 и оценку 27 токенов. Для отсутствующего входа единицы неизвестны (null), а declaredDiskTotals также неизвестен; это не источник нулевого размера и не импортированное правило.
Выберите манифест через --manifest; для Markdown записи входов используют markdown-atx-v1, а для объявлений MCP — mcp-servers-json-v1.
Манифест выбирает относительные пути под абсолютным физическим корнем. Поддерживаются ATX Markdown, ограниченные объявления MCP и командные хуки SessionStart, UserPromptSubmit, PreToolUse. Содержимое файлов, строки команд и секретные значения не печатаются; ID и пути видны. Неизвестные или отклонённые входы остаются явными, а итоги — неизвестными. Исключённые из выбора входы не обнаруживаются автоматически и остаются неизмеренными.
Вывод — один JSON-документ с завершающим переводом строки даже без --json. --budget составляет 512–262144 байта UTF-8, включая перевод строки, а не жёсткий лимит токенов. Слишком большой отчёт заменяется полной ошибкой output_limit без скрытого исключения строк или обрезки JSON. Содержимое и перевод строки записываются отдельно; ошибка потока передаётся без повторной публикации. Десятисекундный срок использует кооперативную отмену и не гарантирует время выхода при заблокированных вызовах файловой системы или вывода.
Справка и полные наблюдения дают код 0; неверное использование — 4; неверные, неполные или отклонённые данные, отмена и лимит вывода — 5. Чтение ограничено 64 входами, 256 KiB на файл, суммарно 1 MiB выбранных байт и 64 разделами Markdown на файл. Символические ссылки, hardlinks и необычные типы файлов отклоняются; проверки согласованности не являются атомарным снимком.
declared_not_loaded описывает объявления конфигурации, не доставку или выполнение. Даже доставка не доказывает соблюдение правил моделью. Оценка utf16-ceil-div4 для каждого файла отличается от фактического потребления провайдера, счета и экономии. Предварительный просмотр, импорт, применение и восстановление правил не входят в этот набор; doctor не меняет правила автоматически.
Изучите вывод, который Bee действительно записал
Заголовок раздела «Изучите вывод, который Bee действительно записал»Учёт доставки позволяет агенту или оператору проверить успешно записанный вывод хука, прежде чем выбирать контекст для анализа. Существующий путь Claude UserPromptSubmit наблюдает обычный текст и context JSON после успешной записи и сброса буфера. Report/read изучают метаданные локально, без инициализации, базы данных или вызовов провайдера; второй хук не запускается.
delivery_store="${BEE_HOME:-$HOME}/.bee/usage/delivery-v1"bee delivery --helpbee delivery report --store "$delivery_store" --limit 100Отчёт разделяет точные байты UTF-8 окончательного вывода в формате передачи (включая оболочку и перевод строки) и именованную оценку токенов utf16-ceil-div4. Доставленные наблюдения группируются по элементу, поверхности и сессии; для выбора сессии используйте вместе --session-kind и --session. read --store PATH --event UUID изучает уже известное событие; отчёты не перечисляют ID событий. Фильтров по источнику, поверхности или интервалу времени нет.
Отчёты остаются неполными нижними границами. Проверяйте issues и omittedGroups; --limit 0..100 ограничивает группы, постраничного просмотра нет. Нативные итоги Withheld недоступны, а null-идентичности источника/рецепта не устанавливают сопоставимость. Байты и оценки не измеряют потребление провайдера, начисления, экономию, соблюдение правил или качество. Объявления context doctor и внешние счётчики budget --measured отвечают на другие вопросы.
При сбое записи учёт сохраняет основной вывод хука, диагностику и поведение при выходе. Ограниченное хранилище держит метаданные вместо тел и прекращает добавление при заполнении, сохраняя имеющиеся ID событий. Полнота или наблюдение ровно один раз не обещаются. JSON автоматический; добавление --json недопустимо. Справка или найденные наблюдения дают 0, неверные опции — 4, недостающие данные или граница вывода — 5; сам по себе код 0 не доказывает полную доставку.
В руководстве по доставке и использованию есть исполняемый пустой офлайн-отчёт, точные опции, ограничения сессий/источников и рекомендации по приватности.
В синтетическом примере пустого хранилища из руководства команда отчёта завершается с кодом 5 и полями groups: [] и totalsStatus: unknown, указывающими на недоступность данных; это не доказывает, что ничего не доставлялось. Нативные наблюдения успешной записи и сброса буфера имеют вид Delivered; ошибки записи или сброса буфера могут регистрироваться как PartialWrite и не входят в итоги доставленного вывода. Withheld недоступен, поскольку этот производитель не создаёт таких событий. Перед использованием итогов прочитайте сведения о пропусках и проблемах.
1.0.0-beta.15
Заголовок раздела «1.0.0-beta.15»Предварительный выпуск
Изучайте предоставленные QA-данные офлайн
Заголовок раздела «Изучайте предоставленные QA-данные офлайн»Агенту, изучающему QA-данные, нужно знать, чего не хватает, что противоречиво и где есть сбои, прежде чем снова открывать исходный отчёт. bee qa assess собирает эти наблюдения в один ограниченный диагностический результат с идентичностями исходников и файлов и указанной следующей проверкой. Команда читает предоставленные данные, не запуская тесты, генераторы отчётов или вложения.
Начните с предварительной оценки недостающих данных, затем оцените индекс, подготовленный вне репозитория. Задайте QA_ROOT, QA_BASE, QA_HEAD и QA_BUNDLE по практическому руководству по QA-данным, где есть минимальный корректный синтетический пакет:
bee qa assess --helpbee qa assess --root "$QA_ROOT" --base "$QA_BASE" --head "$QA_HEAD" --profile bee-cli --jsonbee qa assess --root "$QA_ROOT" --base "$QA_BASE" --head "$QA_HEAD" --profile bee-cli --evidence "$QA_BUNDLE/index.json" --limit 20 --budget 16000 --jsonОтличайте диагностическое решение от одобрения выпуска
Заголовок раздела «Отличайте диагностическое решение от одобрения выпуска»Используйте decision, reasonCounts, scopeCounts и next, чтобы выбрать, что собрать или изучить дальше. Отсутствующие результаты остаются отсутствующими, частичные отчёты сохраняют доступные сбои, а некорректные отчёты остаются неубедительными. Совпадение заявления об исходниках не удостоверяет производителя теста. Старое или несовпадающее наблюдение о сбое сохраняется, не становясь доказательством текущего дефекта.
Каждая оценка намеренно возвращает 5, включая пакет только с успешными тестами. Этот код отделён от кода выхода тестового процесса: наблюдаемый выход производителя остаётся неизвестным, а импортированная запись производителя может лишь сообщать его. Справка возвращает 0; неверные, повторные или неизвестные опции — 4. Скрипты должны явно обрабатывать 5, не считая его успешной приёмкой или ошибкой запуска теста.
Совместимость и ограничения
Заголовок раздела «Совместимость и ограничения»Эта новая офлайн-команда не требует инициализации или подключения к сервисам. Встроенный профиль bee-cli описывает интеграцию QA CLI для linux-x64, а не приёмку всего выпуска или других платформ. Результаты сохраняют mode: diagnostics, trusted: false, acceptance: false и необходимость человеческого решения. Запуск тестов, кеш результатов, выбор тестов и мутационное тестирование не добавляются; экономия не устанавливается.
Предоставляйте обычные файлы UTF-8 вне репозитория, без ссылочных компонентов в пути. Идентичность исходников, актуальность объявленного завершения и байты файлов проверяются в пределах ограничений ввода и времени; хеши показывают согласованность содержимого, а не доверенную цепочку происхождения. --limit (0–200) и --budget (2048–65536 кодовых единиц UTF-16 без завершающего перевода строки) ограничивают подробности после оценки. Проверяйте пропуски; при output_budget_exceeded увеличьте бюджет с тем же хешем данных и перепроверьте исходники и файлы. Руководство показывает продолжение, не считая пропущенные данные успешной проверкой.
1.0.0-beta.14
Заголовок раздела «1.0.0-beta.14»Предварительный выпуск
Изучайте данные о покрытии без повторного запуска тестов
Заголовок раздела «Изучайте данные о покрытии без повторного запуска тестов»Используйте имеющийся отчёт о покрытии, чтобы увидеть, какие из указанных файлов, строк и ветвей были выполнены. bee code coverage import преобразует один отчёт Cobertura, OpenCover или LCOV в структурированный результат для локального изучения или передачи агенту. Это полезно при проверке тестового артефакта без пересборки проекта и открытия исходного просмотрщика покрытия.
Выберите формат, соответствующий файлу:
bee code coverage import cobertura.xml --format cobertura --jsonbee code coverage import coverage.xml --format opencover --jsonbee code coverage import lcov.info --format lcov --jsonКоманда работает офлайн без инициализации Bee, базы данных или подключения к провайдеру. Она читает только переданный отчёт и выводит результат в stdout, не запускает тесты и скрипты сборки и не читает исходники. Несмотря на название import, отчёт не сохраняется в хранилище. Результаты тестов TRX остаются отдельным входом для bee test summarize.
Читайте результат, не завышая покрытие
Заголовок раздела «Читайте результат, не завышая покрытие»Начните с status, exitCode и issues, затем изучите каждую запись в files. Измерения строк и ветвей разделены; lineData, branchData и branchSummaries показывают сохранённые наблюдения.
Метрики lines и branches каждого файла имеют явное значение state:
known: измеренный знаменатель известен; рассматривайтеtotal,coveredиpercentвместе.unknown: измерение отсутствует или его нельзя установить.percentравен null, даже если часть наблюдений сохранилась.not-applicable: явно измеренный знаменатель равен нулю.percentравен null; пустой знаменатель не выдаётся за 100% покрытия.
Например, отчёт может устанавливать покрытие строк, оставляя покрытие ветвей неизвестным. Успешный разбор файла не делает все метрики известными. Покрытие описывает только указанные в отчёте файлы и инструментированные строки; оно ничего не говорит об остальных файлах или достаточности выбранных тестов.
Код выхода 0 означает разбор поддерживаемого отчёта, а не прохождение порога покрытия или проверки QA. Код 4 означает некорректное использование команды. Небезопасный, некорректный, противоречивый, неподдерживаемый или превышающий ограничения ввод возвращает код 5. Читайте причины результата incomplete; сохранённые частичные наблюдения нельзя считать завершённым измерением.
Отделяйте идентичность отчёта от приёмки исходного кода
Заголовок раздела «Отделяйте идентичность отчёта от приёмки исходного кода»rawSha256 идентифицирует байты переданного отчёта. Одинаковые байты, формат и декларации дают одинаковую идентичность импорта; история не объединяется и не накапливается. Необязательные --producer, --project, --source-revision, --source-snapshot и --settings-hash записывают декларации. Они не проверяют производителя, не исследуют рабочую копию и не доказывают соответствие отчёта текущим исходникам и настройкам.
Результат явно обозначает эти границы: sourceBinding: not-established, checkedSource: not-read, qaAcceptance: not-assessed и newCodeCoverage: not-measured. Актуальность исходников, доверенная приёмка QA, объединение отчётов, сохранённая история и проверки нового кода выходят за рамки этого импорта.
Ограничения ввода
Заголовок раздела «Ограничения ввода»Передайте обычный файл UTF-8 размером не более 8 MiB, без символических ссылок в пути. Действуют ограничения чтения, разбора и вывода; неподдерживаемые структуры и несогласованные наблюдения явно отмечаются, а не превращаются в успешный результат покрытия. После установки опубликованного выпуска beta.14 проверьте доступные параметры командой bee code coverage import --help.
1.0.0-beta.13
Заголовок раздела «1.0.0-beta.13»Предварительный выпуск
Beta.13 помогает выбрать нужный контекст исходников до чтения целых файлов, изучить записанное использование сессии офлайн и координировать зависимые задачи через сохранённые планы. Также исправлены вводящие в заблуждение сводки тестов, зависающие загрузки моделей и проблемы завершения процессов совместной работы.
Читайте компактные обзоры исходников
Заголовок раздела «Читайте компактные обзоры исходников»Найдите нужные объявления, затем прочитайте соответствующие диапазоны строк. Новая опция --compact убирает повторяющиеся имена полей и префиксы ID из вывода bee graph outline, сохраняя полный идентификатор, диапазон и сведения об исходнике для каждого возвращённого объявления.
Если граф репозитория уже построен, выполните:
bee graph outline src/Example.cs --compact --limit 40 --budget 8000 --jsonВ схеме 2 поле result.columns описывает столбцы строк в result.items. Полный ID восстанавливается как result.idPrefix + idSuffix; файл строки — result.path. Короткие ID — обратимое представление, а не обрезанные имена: перегрузки остаются различимыми. Без --compact прежний вывод схемы 1 не меняется.
--limit допускает 1–1000 объявлений; --budget — 2048–65536 кодовых единиц UTF-16 и ограничивает весь JSON-ответ, кроме завершающего перевода строки. Даже при коде выхода 0 проверяйте counts.omittedByLimit, counts.omittedByBudget, актуальность и охват. Завершённая проверка может вернуть ограниченную выборку. Если обязательные метаданные не помещаются, результат остаётся неполным с output_budget_exceeded, без диапазонов и с явным omittedMetadata; увеличьте бюджет.
Команда читает сохранённый граф без обновления. Отсутствующий граф или файл дают код выхода 3, неверные аргументы — 4, устаревшие, неполные или неподдерживаемые данные — 5. Явно создайте или обновите граф командой bee graph build --root .. Обзоры содержат сохранённые объявления, а не тела исходников или полный граф языка/вызовов. estimatedTokens — оценка по числу символов; меньший вывод сам по себе не доказывает изменения платы провайдера или качества модели.
Измеряйте явно выбранную сессию офлайн
Заголовок раздела «Измеряйте явно выбранную сессию офлайн»Изучите записанные счётчики одного локального rollout-файла без инициализации Bee, подключения к базе данных или вызова провайдера. Задайте THREAD_ID равным точному UUID из заголовка сессии в этом файле:
bee budget --measured --harness codex --session "$THREAD_ID" --log rollout.jsonl --jsonСхема 2 разделяет два разных вида данных:
responseсодержит наблюдения накопительных счётчиков ответов изtoken_usage_record, полнота которых не гарантирована.historyсодержит наблюденияevent_msg/token_count, которые могут включать воспроизведённую историю или синтезированные оценки контекста. Его поляlastне являются использованием на отдельный запрос.
Читайте latest и segments каждого потока вместе с SHA-256 входных данных и ограничениями. Накопительные снимки никогда не суммируются; общего итога двух потоков нет. Кешированный ввод уже входит во ввод, а вывод рассуждений — в вывод. Прежние поля usage и lastRequestUsage остаются null.
complete/код выхода 0 означает, что переданный снимок разобран; это не означает окончания сессии или записи всех запросов. Обрезанные данные, несовпадающая идентичность или неподдерживаемые данные остаются неполными/неподдерживаемыми с кодом 5; неверные параметры дают код 4. Читается только выбранный поток, без объединения дочерних агентов. Стоимость неизвестна; отчёт не измеряет, какой контекст доставила Bee, и не доказывает экономию. Обычный bee budget остаётся прогнозом контекста; measured-режим не принимает параметры прогноза.
Оценки контекста и записанное использование
Координируйте сохранённые планы и читайте результаты тестов
Заголовок раздела «Координируйте сохранённые планы и читайте результаты тестов»Основы Plan появились в этом выпуске. Сохраняйте задачи с зависимостями, ссылками на источники и критериями приёмки; находите готовую работу, берите её от имени своей сессии, фиксируйте прогресс и оставляйте комментарии. Определения используют схему 1 и неизменяемую ревизию 1. Неизвестные зависимости, циклы и некорректные определения отклоняются до сохранения.
Команды Plan требуют инициализированного профиля, настроенной MongoDB, Git-репозитория и существующей аутентифицированной сессии совместной работы в том же пространстве. plan.json должен содержать поля определения id, title, scope, sources и steps, включая критерии приёмки каждого шага. Параметры доступны через bee plan --help. Пример ниже предполагает план release-check с готовым шагом verify; каждая переменная request должна содержать отдельный UUID в нижнем регистре:
bee plan create --file plan.json --request-id "$CREATE_REQUEST_ID" --jsonbee plan show release-check --jsonbee plan next release-check --limit 2 --jsonbee plan claim release-check verify --revision 1 --lease-seconds 300 --request-id "$CLAIM_REQUEST_ID" --jsonnext возвращает готовые шаги в пределах запрошенного лимита 1–5 с полными обязательствами и явными пропусками; результат может быть пустым, команда не захватывает работу. Шаг становится готовым после перехода зависимостей в reported_complete. Claim принадлежит аутентифицированному вызывающему, действует 30–300 секунд и не может превышать срок аренды зарегистрированной сессии. Для обновления используйте возвращённое поколение claim:
bee plan update release-check verify --revision 1 --claim-generation "$CLAIM_GENERATION" --state reported_complete --summary-file summary.txt --request-id "$UPDATE_REQUEST_ID" --jsonbee plan comment release-check verify --revision 1 --file comment.txt --request-id "$COMMENT_REQUEST_ID" --jsonОбновления поддерживают running, blocked, failed, abandoned, reported_complete и renew. Сообщения о блокировке, неудаче, отказе и завершении требуют краткого отчёта. Просроченный или заменённый claim не может обновлять шаг. Необязательный --if-version отклоняет запись при параллельном изменении плана. Если запись вернула outcome_unknown, повторите её с тем же request ID и содержимым: она уже могла сохраниться. Комментарии фиксируют обсуждение без изменения состояния шага. Завершение заявляет владелец (qa.status: not_assessed); Bee не выполняет задачи, не запускает агентов и не даёт одобрения QA.
Более надёжные сводки TRX. Неверно размещённая диагностика сводки или неподдерживаемые управляющие атрибуты раньше могли пройти проверку. Теперь bee test summarize возвращает неполный отчёт, не позволяя некорректным данным подтвердить успех:
bee test summarize results.trx --jsonКоманда читает существующий отчёт офлайн; она не запускает тесты и не восстанавливает код выхода исходного тестового процесса. Вложенные результаты по-прежнему не поддерживаются.
Настройка сессии · Сводки тестов
Более надёжная отмена и проверки идентичности
Заголовок раздела «Более надёжная отмена и проверки идентичности»- Загрузки, зависающие после заголовков: настроенный тайм-аут передачи модели теперь охватывает чтение тела ответа и финальную проверку перед публикацией файла. Неудачная передача сохраняет существующие файлы. При внутреннем тайм-ауте загрузки сохранение памяти может продолжиться без эмбеддинга; явная отмена вызывающего передаётся дальше, а не поглощается.
- Некорректные сохранённые идентификаторы: читаемый, но повреждённый локальный файл идентичности теперь сразу вызывает ошибку вместо повторных попыток публикации временных файлов. Существующие байты идентичности сохраняются.
- Завершение при отмене: остановка приёмника, освобождение ресурсов и очистка канала больше не зависят от продвижения диспетчера вызывающего. Ограниченные ожидания могут завершиться даже при заблокированном диспетчере; тайм-аут не считается доказательством выхода дочернего процесса.
- Очистка приёмника в Linux: завершение следует по принадлежащему приёмнику дереву процессов с закреплёнными идентификаторами, избегая широкого сканирования процессов и уменьшая влияние изменений посторонних процессов. Владение сохраняется до фактического выхода захваченных дочерних процессов.
Совместимость и обновление
Заголовок раздела «Совместимость и обновление»Требование .NET 10 не меняется. Доступны семь пакетов NuGet: инструмент bee-ai и шесть платформенных пакетов исполнения. Приёмка исполнения beta.13 прошла на Linux x64 и macOS ARM64. Windows x64/ARM64, Linux ARM64 и macOS x64 не запускались в рамках native-приёмки этого выпуска; доступность пакетов не гарантирует исполнение на всех шести платформах.
Пакеты Windows не добавляют подключение или пробуждение native-сессии codex: подключение возвращает unsupported_platform/код 5 до создания состояния сессии. Отдельный адаптер канала поддерживает определение родительского процесса Windows с beta.10; это не новая приёмка исполнения Windows в beta.13. См. требования адаптеров.
Обновляйте Bee в существующей области установки. Для глобальной установки:
dotnet tool update --global bee-ai --version 1.0.0-beta.13 --source https://api.nuget.org/v3/index.jsondotnet tool list --globalДля локального манифеста инструментов репозитория выполните из его каталога:
dotnet tool update --local bee-ai --version 1.0.0-beta.13 --source https://api.nuget.org/v3/index.jsondotnet tool list --localДля отдельного каталога инструментов подставьте существующий путь:
dotnet tool update --tool-path ./bee-tools bee-ai --version 1.0.0-beta.13 --source https://api.nuget.org/v3/index.jsondotnet tool list --tool-path ./bee-toolsУбедитесь, что список показывает 1.0.0-beta.13. Перезапустите уже работающий Bee worker или канал через существующий менеджер процессов, чтобы загрузить обновлённый исполняемый файл. Сохраните текущий профиль и настройки сессии. Руководство по установке
1.0.0-beta.12
Заголовок раздела «1.0.0-beta.12»Предварительный выпуск
Навигация по исходникам Swift и Kotlin
Заголовок раздела «Навигация по исходникам Swift и Kotlin»bee graph build и bee graph outline теперь включают диапазоны строк объявлений Swift и Kotlin. Агент может запросить обзор файла перед чтением выбранных строк. Парсеру не нужен мобильный компилятор во время работы. Охват указывает calls:none; символические зависимости не являются разрешёнными компилятором целями вызовов. Обнаруженный неподдерживаемый синтаксис даёт частичный охват и код выхода 5.
Просмотр сессий и сообщений
Заголовок раздела «Просмотр сессий и сообщений»bee who показывает машину, ОС, среду агента и версию Bee. bee collaborate inbox и group history читают сохранённые сообщения без подтверждения, захвата или доставки. group list и group members возвращают ограниченные результаты с явными пропусками; для истории группы нужна подписка на точную тему.
Повторно используйте анализ с меньшим контекстом
Заголовок раздела «Повторно используйте анализ с меньшим контекстом»bee code analyze --engine roslyn --save-run сохраняет неизменяемый отчёт анализа компилятора. Читайте его позже офлайн через bee code runs list и bee code runs show <run-id>, не запуская компилятор повторно. --limit и --budget ограничивают выбранную сводку; целостность, исходный результат анализа и пропуски указываются явно. Целый сохранённый отчёт не доказывает актуальность исходников или сопоставимость настроек.
Обзор исходников исключает синтезированные члены C#, сохраняя написанные декларации. Диагностика steering фильтрует область до применения лимита, поэтому посторонние события не скрывают нужные результаты.
bee steering --session <session> --project <project> --surface prompt --jsonУправляйте областью действия правил
Заголовок раздела «Управляйте областью действия правил»bee hook rule rescope изменяет область и пути существующего правила. Используйте --dry-run для предварительного просмотра и --revision для отклонения конкурентного изменения. Неизменённый запрос не выполняет запись. Правила для отдельных файлов могут уменьшить лишний контекст; команды не измеряют счета провайдера и не доказывают соблюдение правил моделью.
Надёжная загрузка и явные команды
Заголовок раздела «Надёжная загрузка и явные команды»- Одновременные первые подключения публикуют одну полностью записанную локальную идентичность, сохраняя существующую.
- Загрузка модели закрывает временный файл перед публикацией и получает только отсутствующие файлы. Неудачная передача сохраняет существующие файлы.
- Неожиданное завершение получателя останавливает канал даже до инициализации; очистка использует ограниченное ожидание и проверку поколения.
- Активация Soul требует
bee soul use <имя>или явногоclaim. В настроенном профиле неизвестная команда возвращает код 4 без чтения или изменения хранилища. - В Windows подключение Codex возвращает
unsupported_platformи код 5 до создания идентичности, привязки или удалённой сессии.
Локальные персоны, текущая работа и зашифрованные секреты
Заголовок раздела «Локальные персоны, текущая работа и зашифрованные секреты»bee soul use <имя> сохраняет выбор в личном профиле этой машины. soul show указывает источник. Если локального выбора нет, применяется прежний общий выбор с предупреждением; soul clear удаляет только локальный выбор.
Опубликуйте задачу сессии через bee collaborate work set; просмотрите пространство командой bee who --json --limit 20. Повторное подключение сохраняет более новое изменение работы. Список включает устаревшие сессии, ограничивает записи и поля и сообщает о пропусках. Текстовый вывод удаляет управляющие символы терминала.
bee node init регистрирует ключ машины. bee secret set, get, list и rm управляют зашифрованными значениями для зарегистрированных машин. Передавайте значение через stdin или скрытый запрос; только secret get выводит значение. Одновременная обычная инициализация сохраняет один ключ. Новые машины получают доступ при последующих записях секретов; существующая конфигурация автоматически не переносится.
История анализа · Область правил · Совместная работа
Проверка выполнения пакетов охватывает Linux x64 и macOS ARM64. Для этой предварительной версии проверка Windows x64/ARM64, Linux ARM64 и macOS x64 ещё ожидается.
dotnet tool update --global bee-ai --version 1.0.0-beta.12 --source https://api.nuget.org/v3/index.json1.0.0-beta.11
Заголовок раздела «1.0.0-beta.11»Предварительный выпуск
Управляйте размером ответа графа
Заголовок раздела «Управляйте размером ответа графа»bee graph callers, callees, impact и explain теперь поддерживают
--compact для кратких записей JSON и --output-budget-chars N для ограничения
всего вывода JSON, включая завершающий перевод строки. Оба параметра требуют
--json. Минимальный бюджет — 256 кодовых единиц UTF-16; это не число токенов.
Без новых параметров прежний вывод сохраняется.
Успешные ответы сохраняют идентичность графа, актуальность и покрытие. Записи,
удалённые ради соблюдения бюджета, отражаются в output.omittedItems и
output.omittedByPath. Если бюджет не вмещает обязательные метаданные,
возвращается output_budget_too_small с кодом завершения 4. Проверьте пропуски,
прежде чем считать ответ полным.
bee graph callers 'OrderService.Save' --json --compact --output-budget-chars 8000Нативные пакеты проверены на Linux x64 и macOS ARM64. Проверки среды выполнения Windows x64/ARM64, Linux ARM64 и macOS x64 для этого выпуска ещё ожидаются.
dotnet tool update --global bee-ai --version 1.0.0-beta.11 --source https://api.nuget.org/v3/index.json1.0.0-beta.10
Заголовок раздела «1.0.0-beta.10»Предварительный выпуск
Краткие отчёты о тестах и навигация по исходникам
Заголовок раздела «Краткие отчёты о тестах и навигация по исходникам»bee test summarize results.trx --json читает существующий UTF-8 TRX-отчёт
офлайн, без инициализации и MongoDB. По умолчанию выводятся итоги и результаты,
не отмеченные как успешные, с ограниченной диагностикой и хешем входного файла.
Подробность задают --include-passed, --limit и --budget. Поддерживаются
плоские результаты; вложенные InnerResults явно не поддерживаются. Неполный
ввод не доказывает успех; код завершения исходного тестового процесса неизвестен.
bee graph outline src/Example.cs --json показывает диапазоны строк объявлений
из готового графа, не перестраивая его и не меняя время запроса. Языковой охват
остаётся C# и Vue/TypeScript/TSX. Проверяйте идентичность исходника, актуальность
и число пропущенных результатов. Бюджет проверки не является жёстким тайм-аутом
ввода-вывода.
Обратимое исключение правил
Заголовок раздела «Обратимое исключение правил»bee hook rule archive <id> --reason "Больше не требуется" --json прекращает
передачу правила без его удаления. bee hook rule restore <id> --revision 1 --json
сохраняет исходное состояние включения, область доставки и пути. Изменения
по умолчанию относятся к текущему проекту; глобальные правила требуют --global.
Ожидаемая --revision защищает от одновременных изменений. Эти команды требуют
настроенной MongoDB.
В начале сессии команды представляет блок не более 400 символов UTF-16 вместе с заголовком. Hermes получает его при первом запросе; обычные запросы и хуки перед записью не повторяют этот блок.
Сводки тестов · Диапазоны исходников · Жизненный цикл правил
Предварительная версия
Канал Claude Code запускается в Windows
Заголовок раздела «Канал Claude Code запускается в Windows»bee collaborate channel не мог работать как MCP-сервер Claude Code в Windows. Канал
подтверждает, какому хосту он принадлежит, прежде чем что-либо зарегистрировать:
по CLAUDE_PID, если хост даёт эту переменную, иначе — по родительскому процессу
операционной системы. Поиск родителя существовал только для Linux и macOS и в Windows
ничего не возвращал. Claude передаёт CLAUDE_PID дочерним процессам hooks и shell, но
не дочерним MCP-серверам, поэтому в Windows ни один источник не давал доказательства и
канал отказывался привязываться. Он завершался, указав причину в stderr и оставив
stdout пустым, а MCP-клиент может сообщить об этом только как о закрытом соединении.
Теперь поиск родителя читает владеющий процесс из ядра и в Windows. Ручной запуск
канала работал и раньше, потому что дочерний процесс shell получает CLAUDE_PID;
именно поэтому брешь дожила до того момента, когда на неё наткнулся MCP-клиент.
Поведение в macOS и Linux не изменилось. Команды hooks в Windows не принимают префикс
VAR=value, а шим .cmd не может служить MCP-командой: клиенты запускают
исполняемый файл напрямую, и запуск не удаётся.
Промпты, которые настроят интеграцию за вас
Заголовок раздела «Промпты, которые настроят интеграцию за вас»Новая страница содержит готовые промпты для Claude Code и Codex. Каждый из них требует от агента самому определить свои пути, остановиться, а не выдумывать брокера, пространство или credential, показать изменение до записи и в конце подтвердить регистрацию сессии, а не отчитаться о том, что файл существует.
dotnet tool update --global bee-ai --version 1.0.0-beta.10 --source https://api.nuget.org/v3/index.json1.0.0-beta.9
Заголовок раздела «1.0.0-beta.9»Предварительная версия
Размер контекста и релевантная память
Заголовок раздела «Размер контекста и релевантная память»bee budget --by-item --json показывает фактический вклад каждого элемента
контекста в символах и отдельно учитывает оформление разделов. Записи памяти,
привязанные к файлам, исключаются из общего поиска для запроса до выбора
соответствующего файлового контекста.
bee context audit --from AGENTS.md --against docs --root . --json показывает
размеры разделов Markdown и кандидатов в буквальные дубликаты с хешами и
позициями строк. Команда работает офлайн без инициализации или MongoDB и
не меняет исходники. Размеры разделов видны даже при отсутствии дубликатов.
Число токенов — оценка, а не данные использования или оплаты провайдера.
Чтение связано с открытыми каталогами и идентификаторами файлов; недоступный
или превышающий лимит ввод даёт неполный отчёт. budget требует настроенной MongoDB.
Проверка: целевые тесты macOS ARM64 и Linux x64 пройдены. Нативные проверки Windows, Linux ARM64, Intel Mac и полный набор платформенных тестов отложены.
Инструменты размера контекста →
dotnet tool update --global bee-ai --version 1.0.0-beta.9 --source https://api.nuget.org/v3/index.json1.0.0-beta.8
Заголовок раздела «1.0.0-beta.8»Предварительная версия
Статус проверки: проверки macOS ARM64 и Linux x64 пройдены. Полная проверка Windows x64/ARM64, Linux ARM64 и Intel Mac отложена, включая повторную проверку двух ранее неудачных тестов Swift на Intel Mac.
Анализ компилятора для веб- и мобильного кода
Заголовок раздела «Анализ компилятора для веб- и мобильного кода»В bee code analyze рядом с C# Roslyn появились явно выбираемые движки
typescript, vue, dart, swift и kotlin. Vue проверяет типы script и template
и показывает позиции в исходном .vue. Dart сохраняет коды правил анализатора.
Swift/iOS и Kotlin/Android используют настоящие типы SDK в явно объявленном
контексте исходников и зависимостей.
Используйте установленные доверенные компиляторы. Bee копирует входы анализа, фиксирует фактические инструменты и отпечатки исходников, отмечая отсутствующий или неподдерживаемый контекст как неполный. Он не устанавливает зависимости и не запускает скрипты сборки проекта. Swift iOS требует macOS/Xcode. Мобильный анализ не проверяет упаковку, поведение устройства или контекст, генерируемый сборкой. Проекты Flutter и пользовательские плагины компилятора пока не входят в этот этап.
Новые движки используют JSON версии 2 или текст и прежнее разделение кодов выхода: чисто, находки, неверная команда, неполный анализ. Встроенные правила C# и версия 1 сохраняются. Уведомления об обновлении продолжают давать AI-инструментам команду с точной версией.
Настройка языков и поддерживаемые контексты →
dotnet tool update --global bee-ai --version 1.0.0-beta.8 --source https://api.nuget.org/v3/index.json1.0.0-beta.7
Заголовок раздела «1.0.0-beta.7»Предварительный выпуск
Уведомления об обновлениях для пользователей и AI-инструментов
Заголовок раздела «Уведомления об обновлениях для пользователей и AI-инструментов»Bee сообщает о новом выпуске и показывает текущую и доступную версии. Если
глобальная установка подтверждена, уведомление содержит точную команду обновления,
которую AI-инструмент может выполнить в рамках имеющихся разрешений. Запускайте её
из нового пустого временного каталога, сохраняя HOME и DOTNET_CLI_HOME,
после чего продолжайте задачу.
bee update check --json возвращает структурированный результат и инструкции.
Bee проверяет опубликованные пакеты CLI и текущей платформы, которые остаются
в списке доступных. Стабильные установки видят стабильные выпуски; предварительные
могут видеть более новые предварительные и стабильные версии. Если проверка
недоступна, наличие обновления остаётся неизвестным.
Обычные команды используют проверку с ограничением времени и шестичасовой кеш.
Уведомления выводятся в stderr, а hook начала сеанса и первого хода добавляет их
в существующий контекст AI. Автономный анализ читает только кеш; отчёты JSON/SARIF
и коды выхода сохраняются. BEE_NO_UPDATE_CHECK=1 отключает проверки и уведомления.
Обычные команды не запускают установщик.
dotnet tool update --global bee-ai --version 1.0.0-beta.7 --source https://api.nuget.org/v3/index.json1.0.0-beta.6
Заголовок раздела «1.0.0-beta.6»Предварительная версия
Диагностика компилятора C# со снимком исходников
Заголовок раздела «Диагностика компилятора C# со снимком исходников»bee code analyze --engine roslyn --json возвращает настоящие сообщения
компилятора C#, включая ошибки типов вроде CS0029. Команда работает без
MongoDB, bee init и сети, не запускает сборку репозитория, восстановление
пакетов или плагины анализаторов.
Новый отчёт версии 2 связывает движок, профиль и снимок исходников с нормализованными находками, позициями, отпечатками и состоянием завершения. Незакоммиченные изменения исходников меняют идентификатор содержимого. Отсутствующие входы, неподдерживаемый контекст проекта и тайм-аут дают неполный результат вместо чистого. Охват анализа отделён от покрытия тестами.
Анализ по умолчанию и bee lint --native сохраняют отчёты версии 1 и коды
выхода. Roslyn выбирается явно. Это первый этап движка Analyze; адаптеры
Vue/TypeScript и Dart, импорт покрытия, дублирование, проверки нового кода
и анализ безопасности остаются следующими этапами.
Использовать движок компилятора →
dotnet tool update --global bee-ai --version 1.0.0-beta.61.0.0-beta.5
Заголовок раздела «1.0.0-beta.5»20 сентября 2026 · Предварительная версия
Выпуск добавляет нативные проверки качества, основания для памяти и совместную работу существующих AI-бесед через MQTT.
Механический lint и анализ C#
Заголовок раздела «Механический lint и анализ C#»bee lint --nativeпроверяет через Roslyn четыре правила именования C#. Режим линтера проекта сохраняется для семи экосистем.- Версионированные наборы правил имеют строгую валидацию, каталог и исполняемые
положительные/отрицательные тесты:
--validate-ruleset,--catalog,--self-test. bee code analyzeдобавляет длину и сложность методов. Автономные отчёты JSON и SARIF 2.1.0 показывают находки, отпечатки и фактический охват. Неполный анализ возвращает 5 даже при наличии находок.- Первые нативные правила предназначены для C#; поддержка других языков и анализ безопасности остаются следующими этапами. Измеряются методы и локальные функции с блочным телом; неподдерживаемые тела явно указаны. Compiled-область восстанавливается без запуска сборки репозитория.
Основания и история решений
Заголовок раздела «Основания и история решений»bee remember evidence, audit, supersede и retract используют коллекцию
memory_evidence с добавлением событий. Можно сохранить источник утверждения,
сравнить его с checkout и явно записать замену или отзыв. При замене сохраняются
версии обоих решений.
Аудит не изменяет базу. Старые записи без оснований остаются unknown;
совпадение байтов не доказывает истинность. Обычный context/search совместим;
remember context --with-evidence включает метаданные. Комментарии не
переписываются, а старые решения не удаляются автоматически.
Совместная работа в той же AI-сессии
Заголовок раздела «Совместная работа в той же AI-сессии»bee collaborate поддерживает подписки на темы, сообщения, вопросы и связанные
ответы через настраиваемый MQTT и общую MongoDB. Адаптеры обращаются к существующим
беседам Codex, Claude Code Channel и Hermes CLI. Для автоматической доставки
нужны worker и нативная интеграция хоста. Статусы различают продвижение через
брокер/транспорт и явное подтверждение модели.
Активация Codex проверяет владельца на macOS/Linux; Windows wake не реализован. Claude требует разрешения Channels; адаптер Hermes предназначен для CLI. MQTT-связь не гарантирует соответствие A2A или однократное исполнение модели.
Исправления и обновление
Заголовок раздела «Исправления и обновление»Исправлены проблемы именования и размещения типов по файлам; необходимые BSON mappings и контракты сохранённых данных сохранены. Реестр, память, архив и граф кода остаются доступными.
dotnet tool update --global bee-ai --version 1.0.0-beta.5Для первой установки см. Установка. Локальные embeddings на Intel
Mac по-прежнему недоступны: в osx-x64 нет совместимого ONNX runtime. Для
семантического поиска можно использовать описанный провайдер Gemini.
1.0.0-beta.4
Заголовок раздела «1.0.0-beta.4»20 сентября 2026 · Предварительный выпуск
Bee теперь помнит людей и связи между организациями, проектами и репозиториями, а также отвечает на вопросы о коде C# и Vue/TypeScript. В выпуск вошли и добавленные после beta.3 линтер проекта, память о файлах и диагностика управления агентом.
Люди, организации, проекты и репозитории
Заголовок раздела «Люди, организации, проекты и репозитории»- Четыре отдельные коллекции MongoDB:
people,organizations,projects,repos. Иерархия: Организация → Проект → Репозиторий. - Имена, псевдонимы, контакты и связи хранят источник каждого добавленного значения. Имя или контакт могут совпадать у разных людей; неоднозначный поиск возвращает кандидатов и не объединяет записи автоматически.
bee entity:create,get,lookup,enrich,list,protocol. Параллельные дополнения сохраняются; создание с тем же ID и содержимым можно повторять.- Короткий протокол в начале сессии направляет агента сначала искать, уточнять отсутствующую или неоднозначную персону и сохранять ответ с источником. Справочник запрашивается по мере необходимости, а не вставляется в каждый промпт.
Локальный граф кода
Заголовок раздела «Локальный граф кода»- C#: объявления, вызывающие и вызываемые символы, влияние изменений и пути через Roslyn, включая interface и override. Ответы указывают покрытие и актуальность.
- Vue, TypeScript и TSX: объявления и статические импорты, в том числе Vue
<script>/<script setup>, поддерживаемые пути tsconfig и литеральные alias Vite.explainпоказывает прямые и обратные импорты;pathпроходит по связям импорта. - Покрытие Vue/TS явно указывает
calls: "none". Семантические цели вызовов этих языков не определяются, конфигурация Vite не исполняется. - Граф локален для рабочей копии Git. MongoDB и
bee initне нужны; файлы в репозиторий не записываются.
Управление агентом и надёжность команд
Заголовок раздела «Управление агентом и надёжность команд»- Линтер проекта находит объявленный репозиторием линтер и использует его команду. Установка зависимостей проекта и линтера на машину — отдельные опции.
- Память о файле доставляет прошлое решение, ошибку и исправление при работе с соответствующим файлом, не добавляя их в начало каждой сессии.
- Диагностика управления объясняет, что было удержано и почему; ограничения объёма контролируют добавляемый контекст.
- JSON сохранения памяти и семантического поиска содержит структурированные результаты и ошибки. Полный текст и решения сохраняются, векторы не выдаются. Сохранение сообщает, записан ли пригодный embedding; его недоступность больше не выглядит как успешный семантический поиск без результатов.
- Диагностика недоступного сервиса не выдаётся в stdout как успешный результат.
Обновление и совместимость
Заголовок раздела «Обновление и совместимость»dotnet tool update --global bee-ai --version 1.0.0-beta.4dotnet tool list --globalДля первой установки см. Установка. Это по-прежнему предварительный выпуск.
Существующие memories и memories_archive сохранены. Миграция или автоматическая
переклассификация не нужны. Старый ключ памяти project по-прежнему обозначает
область репозитория, а не ID новой сущности Project.
Справочник хранит контакты, но не отправляет сообщения и не синхронизирует внешние каталоги. Граф shell и семантические вызовы Vue/TS в этот выпуск не входят.
Локальные embedding на Intel Mac: В пакете osx-x64 нет совместимой библиотеки ONNX Runtime, поэтому локальные embedding на Intel Mac в beta.4 недоступны. Граф кода и справочник не требуют embedding. Для семантического поиска можно использовать поддерживаемого провайдера Gemini с API-ключом; используйте одного провайдера на общее хранилище, поскольку размерности векторов различаются. См. Память.
Предыдущие выпуски
Заголовок раздела «Предыдущие выпуски»Ранние предварительные версии: 1.0.0-beta.3, 1.0.0-beta.2 и 1.0.0-beta.1. Их подробные записи не опубликованы на открытом сайте. Заметки на этой странице открыты и читаются без доступа к репозиторию.