OpenCode

Поставщик: OpenCode Имя установки: opencode Статус: Бета Нативная конфигурация: ~/.config/opencode/

УстановкаCopy Anchor Link

apothem install --harness opencode

Адаптер записывает JSON-конфигурацию OpenCode, устанавливает навыки Apothem в поверхность навыков OpenCode, преобразует промпты команд в файлы команд OpenCode в формате Markdown и нормализует определения помощников Apothem как субпомощники OpenCode.

Записываемые файлы:

~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/

Сопоставление профиля с нативной конфигурациейCopy Anchor Link

Адаптер рендерит opencode.json со списком файлов instructions, в котором указаны ваш документ профиля, четыре основных правила и индекс правил, а затем распространяет каждую общую группу Apothem либо в нативную поверхность OpenCode, либо в принадлежащее Apothem поддерево поддержки. Для существующих совпадающих дочерних элементов, управляемых Apothem, создаются резервные копии перед заменой.

Заметки о совместимостиCopy Anchor Link

OpenCode объединяет каждый файл, указанный в списке instructions, в каждую сессию (правила OpenCode). Поэтому список указывает сначала ваш документ профиля, а затем только правила, у которых alwaysApply равно true, — каждое отдельным явным путём ~/.config/opencode/.apothem/support/rules/<name>.md; OpenCode разворачивает начальный ~/ в ваш домашний каталог. Это правила agnostic-posture, authority-inquiry, context-management, session-closure и индекс правил, apothem-rule-index. OpenCode не ограничивает ни одно правило по путям, поэтому каждое другое правило читается по требованию. Оно остаётся установленным как справочный материал в ~/.config/opencode/.apothem/support/, а индекс называет каждое правило и ситуацию, которая его требует. Правило, навык или команда, которые ссылаются на правило, шаблон или промпт хука, читают его оттуда. Команды, навыки и определения помощников используют нативные расположения обнаружения.

Документ профиля ~/.config/opencode/apothem/rules/00-apothem-profile.md содержит вашу идентичность и предпочтения из общего профиля и завершается разделом о вспомогательных файлах Apothem, который называет абсолютный каталог в ~/.config/opencode/.apothem/support/, относительно которого разрешается каждая ссылка в стиле репозитория (rules/<name>.md, templates/..., hooks/...). Он является первой записью instructions, поэтому OpenCode загружает его в каждой сессии.

opencode.json, записанный более ранним релизом, содержит единственный glob ~/.config/opencode/.apothem/support/rules/*.md, который загружает все правила, или явный путь для каждого из 28 правил, которые тогда действовали всегда. apothem install и apothem update заменяют любую из этих форм приведённым выше списком, в котором больше нет 24 путей, уже не загружаемых при запуске, а apothem uninstall удаляет их все. Ваши собственные записи instructions сохраняются в любом случае.

ПроверкаCopy Anchor Link

apothem verify --harness opencode

Команда verify подтверждает, что:

1. Нативная конфигурация существует по ожидаемому пути.
2. Каждая управляемая цель существует; управляемые файлы не пусты, а конфигурации JSON или YAML разбираются. Добавьте --profile PATH, чтобы дополнительно подтвердить, что установленные файлы соответствуют этому профилю.
3. Процедура проверки, специфичная для адаптера, сообщает об успехе.

ОбновлениеCopy Anchor Link

apothem update --harness opencode

Обновляет opencode.json, нативные команды, навыки, определения помощников и поддерево поддержки Apothem.

УдалениеCopy Anchor Link

apothem uninstall --harness opencode

Удаляет записи, которые адаптер добавил в ~/.config/opencode/opencode.json (ваши собственные ключи, серверы MCP и записи instructions остаются на месте, а сам файл удаляется только тогда, когда его создал Apothem и от вас в нём ничего не осталось). Удаляет блок Apothem из документа профиля ~/.config/opencode/apothem/rules/00-apothem-profile.md и сохраняет любой другой текст в нём; этот файл удаляется только тогда, когда в нём не остаётся ничего другого. Также удаляет файлы Apothem в ~/.config/opencode/commands/, ~/.config/opencode/skills/, ~/.config/opencode/agents/ и ~/.config/opencode/.apothem/support/; остальные файлы в этих папках остаются. Перед изменением или удалением каждого файла создаётся его резервная копия в ~/.apothem/backups/. YAML общего профиля и движок Apothem не затрагиваются.

Шлюз соответствияCopy Anchor Link

python -m apothem.conformity.gate --all .

Устранение неполадокCopy Anchor Link

Параметры конфигурацииCopy Anchor Link

См. такжеCopy Anchor Link

• Все окружения — полный каталог поддерживаемых инструментов
• Руководство по установке — установка Apothem в это окружение
• Справочник по apothem harnesses — вывод списка и просмотр адаптеров из CLI