Golden Flow Engine

Агент-независимый движок для создания, проверки и запуска специфичного для проекта Golden Pack. Он даёт Codex, OpenClaw и другим десктопным агентам детерминированную основу для понимания репозитория, проектирования собственных золотых флоу, сбора доказательств, возобновления длительных запусков и поддержания этих золотых флоу в актуальном состоянии вместе с продуктом.

Engine — это не жёстко прописанный HTTP-тест-раннер, и он не вызывает никаких LLM. Агент-хост читает проект и записывает .golden-flow/; Engine предоставляет факты, безопасные инструменты, валидацию и исполнение.

Быстрый старт

python -m pip install -e ".[mcp]"
golden-flow inspect /path/to/project
golden-flow init /path/to/project
golden-flow validate /path/to/project
golden-flow plan /path/to/project
golden-flow run /path/to/project --mode strict

Фоновый режим использует локальную очередь SQLite в проекте:

golden-flow job-start /path/to/project
golden-flow worker /path/to/project --once
golden-flow job-status /path/to/project JOB_ID

Запустите golden-flow-mcp, чтобы предоставить через STDIO MCP инструменты инспекции, управления Pack, планирования и асинхронного запуска. О фиксированном рабочем процессе агента см. AGENT_GUIDE.md.

Related MCP server: agent-orchestrator

Встроенные адаптеры

• file: чтение, ограниченное корнем проекта, перечисление файлов, хэши и проверки существования.

• shell: argv-команды, явно зарегистрированные в policies/safety.yaml.

• http: запросы и фиксация ответов в качестве доказательств с использованием стандартной библиотеки Python.

• playwright: опциональная навигация в браузере, ввод данных, скриншоты и ошибки консоли.

• sql-observer: наблюдение за SQLite в режиме только для чтения; операции записи, прагмы и множественные операторы отклоняются.

• minium: опциональная поддержка WeChat mini-program с протокольным режимом Mock для CI.

• command-bridge: мост «один JSON на вход / один JSON на выход» для TypeScript, Java, Go и пользовательских инструментов.

Протокол адаптеров сохраняет независимость возможностей, предварительных проверок, исполнения, сбора доказательств, проверок безопасности, классов ошибок и закрытия ресурсов от ядра Engine.

Китайское описание

golden-flow-engine — это движок построения и запуска золотых флоу проекта для Codex, OpenClaw/龙虾 и других десктопных агентов. Сначала он выполняет детерминированное сканирование репозитория в режиме только для чтения, затем агент-хост на основе документации, кода, страниц, моделей состояний и источников истины для данных пишет для этого проекта .golden-flow/. Engine отвечает за формат каталогов, топологию зависимостей, безопасность инструментов, целостность доказательств, выполнение на переднем плане и в фоне, результаты контрольных точек и классификацию ошибок; он не предустанавливает бизнес-логику какого-либо реального продукта и не включает встроенных API моделей.

По умолчанию в коммит попадают: профиль проекта, список главной ветки и веток, Python Journey, объявления инструментов, политики и правила Fixture; по умолчанию игнорируются: учётные записи, токены, состояние SQLite во время выполнения, скриншоты, логи, отчёты, кэш и реальные бизнес-данные.

Статус

v0.1.0 — это альфа-версия. Имена протокола и схем версионируются, но API могут измениться до v1. Обычный CI использует протокольный Mock.

Лицензия MIT. См. SECURITY.md и CONTRIBUTING.md.