67 lines
9.0 KiB
Markdown
67 lines
9.0 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 не используются.
|
|
|
|
## Фоновые сборщики
|
|
|
|
Zoom My Notes, Mattermost и Asana Inbox используют отдельный Chrome Headless Shell и существующие локальные профили. Для рабочего Mac с Apple Silicon установлена версия 157.0.8103.79. Путь прописан в `scripts/personal-os-headless-browser.js`. При установке распаковать официальный архив, проверить исполняемый файл через `codesign --verify --strict` и поместить каталог архива в `.local/browser/chrome-headless-shell-157.0.8103.79/`. [Chrome for Testing для Apple Silicon](https://storage.googleapis.com/chrome-for-testing-public/157.0.8103.79/mac-arm64/chrome-headless-shell-mac-arm64.zip)
|
|
|
|
Окно входа открывается по ручной команде `node scripts/zoom-browser-sync.js --login`, `node scripts/asana-inbox-shadow.js --login` или `node mattermost-client.js login https://chat.duckduckgo.com`. Для Zoom штатный запуск вернёт запрос на повторный вход, если сессия закончилась. Сборы идут через LaunchAgent каждые 30 минут для Zoom и каждые 15 минут для Mattermost и Asana Inbox.
|
|
|
|
## Резервная копия и восстановление
|
|
|
|
Проверка 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
|
|
```
|
|
|
|
Статус виден в локальных сигналах. Карточка «Сегодня» хранит самооценки отдельно от расчётных точек. Оценка энергии уменьшается на один, два или три балла после 25, 50 и 80 наблюдаемых минут активности, накопленных после последнего перерыва или более поздней личной отметки. Для оценки настроения используются сигналы выбранных чатов за 15 минут и наблюдаемая активность за час. Две критические реплики, резкий тон и не менее 25 минут активности дают оценку вероятного раздражения. Две более свежие однозначно положительные реплики и не менее 15 минут активности дают оценку положительного настроя. Новая личная отметка останавливает расчёт по предыдущим репликам. В сводке хранятся только время и категория сигналов текущей даты.
|
|
|
|
Перерыв начинается с наблюдаемого отсутствия после активности и включает минимум пять измеренных минут. Пробел наблюдения до двух минут может разделять части одного перерыва. Его длительность в сумму не входит. После 50 измеренных минут активности система предлагает перерыв, если свежий интервал активен и рабочее окно ещё открыто. Штатная страница перечитывает данные раз в 45 секунд.
|