Редактировать профиль

Цель: изменить значение в общем профиле и распространить его в каждое установленное вами окружение.

Предварительные требованияCopy Anchor Link

• CLI apothem в вашем PATH (или самодостаточная форма: префикс PYTHONPATH="$HOME/.apothem/src" и запуск python -m apothem, или npx @ahmed-g-gad/apothem).
• Профиль по адресу ~/.config/apothem/profile.yaml. Создайте его с помощью apothem profile init, если он отсутствует.

Форма профиляCopy Anchor Link

Профиль — это единый YAML-документ. Его ключи верхнего уровня:

• identity (обязательно) — name, плюс опциональные role, email, website, github.
• preferences — language, style (concise / verbose / balanced), formatter, test_framework.
• rules — список дополнительных строк правил, разделяемых со способными окружениями.
• seriousness — один из EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH.
• enforcement — переключатели подключения по выбору (sprints, agent_teams, multitasking, continuous_execution, learning_loop), каждый флаг по умолчанию выключен.
• harnesses — переопределения по окружениям, ключ — идентификатор окружения.
• exclude_harnesses — идентификаторы окружений, пропускаемые пакетными командами (--harness all).
• mcp_servers — определения серверов MCP, ключ — имя сервера.
• agent_mcp_servers — для каждого имени помощника серверы MCP, которые этот помощник может вызывать (см. Предоставление помощнику доступа к серверам MCP). По умолчанию пусто, поэтому ни один помощник не обращается к инструментам MCP.
• workspace — где Apothem хранит свой общий рабочий каталог (directory_name, scope).
• schema_version — необязательная версия схемы профиля; профиль без неё читается как версия 1.

Каждое поле перечислено в разделе Поля профиля.

ШагиCopy Anchor Link

1. Изучите текущий профиль:

   Copy Text

   apothem profile show

2. Отредактируйте его. Откройте его в системном редакторе:

   Copy Text

   apothem profile edit

   Или задайте один ключ через точку из командной строки. Значение сохраняется буквально (за исключением true/false и явного ввода [..]/{..}, которые разбираются), и профиль проверяется по схеме перед записью — недопустимое присвоение отклоняется, а профиль на диске остаётся неизменным:

   Copy Text

   apothem profile set seriousness SHARED
   apothem profile set identity.name "Ada Lovelace"

3. Повторно материализуйте окружения, чтобы изменение достигло их нативной конфигурации. Для окружения пользовательского уровня:

   Copy Text

   apothem update --harness claude-code

   Для окружения уровня проекта передайте корень проекта; используйте all, чтобы обновить каждое установленное окружение:

   Copy Text

   apothem update --harness cursor --project /path/to/project
   apothem update --harness all --project /path/to/project

ПроверкаCopy Anchor Link

apothem profile show
apothem verify --harness all

profile show отражает ваше изменение.

apothem verify --harness all проверяет каждое зарегистрированное окружение, кроме перечисленных в exclude_harnesses профиля, поэтому команда завершается с ненулевым кодом, если установлены не все остальные. Окружениям с областью проекта также нужен --project PATH; без него пакетная проверка останавливается с ошибкой project.required. Чтобы проверить только окружение, которое вы обновили, выполните ту же команду с его именем:

apothem verify --harness <name>

Для общесистемного обзора, который допускает окружения, не установленные у вас, выполните apothem doctor.

СвязанноеCopy Anchor Link

• Добавьте окружение, чтобы перевести новое окружение под управление профиля перед повторной материализацией.
• Обновление охватывает обновление движка вместе с шагом повторной материализации.