59 lines
5.9 KiB
Markdown
59 lines
5.9 KiB
Markdown
# Эксплуатация Personal OS
|
|
|
|
## Входы и источники состояния
|
|
|
|
- Портал: [Сегодня](http://127.0.0.1:4317/#/today), [состояние системы](http://127.0.0.1:4317/#/plan-health).
|
|
- Windmill: [workspace personal_os](http://localhost:8000/?workspace=personal_os).
|
|
- PostgreSQL `personal_os` — рабочие источники и выводы. Секреты остаются в локальной конфигурации и хранилище учётных данных, не в документации.
|
|
- Приложение обслуживают `scripts/db-browser.js` и аутентифицированный host runner `scripts/work-evidence-service.js`. Сбор и расчёты запускаются процессами из [Windmill](personal-os-windmill-workflows.md).
|
|
|
|
Успешный job означает завершение кода. Проверять также business result, область источника, ошибки, сохранённую версию и видимость результата в портале. `partial`, `deferred`, `already_running` и пропуск пересечения не равны обработанным данным.
|
|
|
|
## Диагностика
|
|
|
|
1. Открыть состояние системы и установить затронутый источник или расчёт, дату и run ID.
|
|
2. Сверить текущие задания Windmill и локальные квитанции. Действующий запуск не дублировать и не отменять.
|
|
3. Для source gap проверить доступность конкретного объекта и полноту страниц. Отсутствие доступа не означает отсутствие работы или ответа.
|
|
4. При неизвестном исходе внешнего запроса сначала проверить квитанцию. Автоматический повтор допустим только для заведомо не принятой операции.
|
|
5. После исправления пройти тот же пользовательский путь и отрицательный случай; обновить текущий статус проверки.
|
|
|
|
GitHub сохраняет паузу при rate limit. Повтор без ожидания не ускоряет восстановление. Удержанные Claims не разблокируются сбросом попыток или фиктивными человеческими решениями.
|
|
|
|
## Обновление локальных сервисов
|
|
|
|
Перед обновлением проверить активные HTTP-запросы и модельные задания Claims/resolve. Мягкое завершение сохраняет текущие операции; новые получают явное ожидание. Загруженный manifest `/health` сверяется с файлами релиза. Само изменение файла не доказывает загрузку новой версии.
|
|
|
|
Перед нативной проверкой убедиться, что Mac разблокирован. При блокировке продолжать серверные проверки. Outlook и EventKit не используются.
|
|
|
|
## Резервная копия и восстановление
|
|
|
|
Проверка PostgreSQL и локальных данных:
|
|
|
|
```sh
|
|
node scripts/work-evidence-restore-check.js
|
|
```
|
|
|
|
Оператор читает согласованный snapshot, создаёт частный архив, восстанавливает отдельную тестовую БД и проверяет таблицы. Локальные планы, обсуждения, квитанции, SQLite и Work History сохраняются рядом. Последняя квитанция находится в `.local/work-evidence/restore-check-latest.json`.
|
|
|
|
Проверка и восстановление файлового архива:
|
|
|
|
```sh
|
|
python3 scripts/personal-os-local-backup.py verify ПАПКА_АРХИВА
|
|
python3 scripts/personal-os-local-backup.py restore ПАПКА_АРХИВА --target НОВАЯ_ПАПКА
|
|
```
|
|
|
|
До применения команды сверить её `--help` и выбранный архив. Существующая папка не перезаписывается. С восстановленной копией работать отдельно от оригинала. Старые источники остаются старыми; перед возвратом к работе перепроверяются доступность источников, актуальность плана и конфигурация сервисов. Задания и уведомления из архива автоматически не запускаются.
|
|
|
|
Граница подтверждённого восстановления: проверены данные и обычные экраны на отдельной копии; перенос всего хоста, ключей и Windmill-конфигурации не принят. [Квитанция](personal-os-evidence/2026-11-18/restore-recovery-validation.json).
|
|
|
|
## Анализ общения
|
|
|
|
Источник выбирается явно; включение не означает разрешение читать все сессии. Настройка выбранного JSONL:
|
|
|
|
```sh
|
|
python3 scripts/agent_focus_source.py enable /полный/путь/session.jsonl
|
|
python3 scripts/agent_focus_source.py disable
|
|
```
|
|
|
|
Статус виден в локальных сигналах. Настроение и энергия остаются самооценкой; интерпретация отдельных слов не заменяет подтверждённое состояние.
|