- Мульти-провайдер: PAPAYU_LLM_PROVIDERS — сбор планов от нескольких ИИ (Claude, OpenAI), агрегация - Тренды дизайна и иконок: вкладка в модалке, поиск по безопасным доменам (Tavily include_domains) - Snyk Code: PAPAYU_SNYK_SYNC, REST API issues → snyk_findings в agent-sync - Documatic: architecture_summary из .papa-yu/architecture.md в agent-sync - Личная автоматизация: capability personal-automation (терминал git/npm/cargo, открытие URL) - agent_sync расширен: snyk_findings, architecture_summary; analyze_project_cmd и run_batch пишут sync - Документация: SNYK_AND_DOCUMATIC_SYNC.md, SECURITY_AND_PERSONAL_AUTOMATION.md, обновлён CLAUDE_AND_AGENT_SYNC Co-authored-by: Cursor <cursoragent@cursor.com>
2.9 KiB
Runbook — papa-yu
Build
Requirements
- Node.js 18+
- Rust 1.70+
- npm
One-command build
cd papa-yu
npm install
npm run tauri build
Из корня: cd src-tauri && cargo build --release (только бэкенд).
Run
Development
npm run tauri dev
Поднимает Vite и Tauri. Интерфейс доступен в окне приложения.
Важно: не открывать скомпилированный .app без dev-сервера — фронт не загрузится.
Production
Собранный бинарник: src-tauri/target/release/ (или через npm run tauri build).
Where logs are
- Traces:
.papa-yu/traces/*.json(приPAPAYU_TRACE=1) - Stderr: события LLM, apply, fallback — в консоль/терминал
- Weekly report: агрегация из traces
Common issues
Golden traces mismatch
Симптом: cargo test golden_traces падает с ошибкой schema_hash.
Причина: изменён llm_response_schema_v*.json.
Действие: пересчитать SHA256 схемы, обновить schema_hash во всех фикстурах в docs/golden_traces/v*/*.json.
LLM planner instability
Симптом: невалидный JSON, ERR_SCHEMA_VALIDATION, частые repair.
Причина: модель не держит strict JSON, или промпт перегружен.
Действие: включить PAPAYU_LLM_STRICT_JSON=1 (если провайдер поддерживает); уменьшить контекст; проверить PAPAYU_CONTEXT_MAX_*.
PATCH/EDIT conflicts
Симптом: ERR_EDIT_ANCHOR_NOT_FOUND, ERR_EDIT_BEFORE_NOT_FOUND, ERR_EDIT_AMBIGUOUS.
Причина: anchor/before не соответствуют текущему содержимому файла.
Действие: см. docs/EDIT_FILE_DEBUG.md. Убедиться, что FILE-блоки в контексте включают sha256 (v2/v3).
"Could not fetch a valid…" (UI)
Симптом: пустое окно при запуске.
Причина: фронт не загрузился (Vite не поднят).
Действие: запускать только npm run tauri dev, не открывать .app напрямую.
Diagnostics
- Проверить протокол:
PAPAYU_PROTOCOL_VERSION=3для EDIT_FILE. - Воспроизведение: включить
PAPAYU_TRACE=1, выполнить сценарий, смотреть.papa-yu/traces/. - Тесты:
cd src-tauri && cargo test— полный прогон. - CI:
cargo fmt --check,cargo clippy,cargo audit,cargo test.