83 lines
13 KiB
Markdown
83 lines
13 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](../windmill/README.md).
|
|
|
|
Успешный job означает завершение кода. Проверять также business result, область источника, ошибки, сохранённую версию и видимость результата в портале. `partial`, `deferred`, `already_running` и пропуск пересечения не равны обработанным данным.
|
|
|
|
## Диагностика
|
|
|
|
1. Открыть состояние системы и установить затронутый источник или расчёт, дату и run ID.
|
|
2. Сверить текущие задания Windmill и локальные квитанции. Действующий запуск не дублировать и не отменять.
|
|
3. Для source gap проверить доступность конкретного объекта и полноту страниц. Отсутствие доступа не означает отсутствие работы или ответа.
|
|
4. При неизвестном исходе внешнего запроса сначала проверить квитанцию. Автоматический повтор допустим только для заведомо не принятой операции.
|
|
5. После исправления пройти тот же пользовательский путь и отрицательный случай; обновить текущий статус проверки.
|
|
|
|
«Расчёт плана» показывает запуск, связанный с дневным планом. При сбое до первого плана «Сегодня» выводит ссылку «Посмотреть состояние обновления». «Сверка обсуждений» отдельно показывает результат последнего наблюдения. Для обеих строк «Запуск в Windmill» открывает точный запуск, если в квитанции сохранён его идентификатор.
|
|
|
|
В задаче раздел «Анализ работы» открывает квитанцию чтения Claims с причиной и временем по Бишкеку. После восстановления ссылка на последний сбой остаётся рядом с текущим результатом чтения. Адрес квитанции можно открыть повторно из карточки той же работы.
|
|
|
|
GitHub сохраняет паузу при rate limit. Повтор без ожидания не ускоряет восстановление. Удержанные Claims не разблокируются сбросом попыток или фиктивными человеческими решениями.
|
|
|
|
## Обновление локальных сервисов
|
|
|
|
Перед обновлением проверить активные HTTP-запросы и модельные задания Claims/resolve. Мягкое завершение сохраняет текущие операции; новые получают явное ожидание. Загруженный manifest `/health` сверяется с файлами релиза. Само изменение файла не доказывает загрузку новой версии.
|
|
|
|
Перед нативной проверкой убедиться, что Mac разблокирован. При блокировке продолжать серверные проверки. Outlook и EventKit не используются.
|
|
|
|
Ссылка из дневного уведомления с идентификатором расчёта открывает конкретную опубликованную версию. Для старой ссылки с одной датой архив явно показывает последний сохранённый план с действиями за эту дату. Вечерняя ссылка Telegram относится к дате сообщения и открывает её итоги после смены дня.
|
|
|
|
## Фоновые сборщики
|
|
|
|
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.
|
|
|
|
«Состояние системы» читает последнюю квитанцию Zoom My Notes. Завершение обхода списка подтверждается отдельно от доступности транскриптов. После временного пробела заметка проверяется при следующем штатном обходе. Расписание встреч берётся из Asana.
|
|
|
|
Если в списке нет даты встречи, сборщик сверяет время начала из завершённого транскрипта с точной заметкой и встречей. Существующий файл обновляется по тому же адресу.
|
|
|
|
## Резервная копия и восстановление
|
|
|
|
Проверка 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).
|
|
|
|
## Самочувствие и анализ общения
|
|
|
|
На графике «Сегодня» расчётная энергия отсчитывается от последней личной отметки. Нагрузка уменьшает оценку на 1, 2 или 3 пункта после 25, 50 или 80 наблюдаемых минут с отметки или последнего завершённого перерыва. После 15 минут активности поправка увеличивается на один пункт, если было хотя бы пять подтверждённых смен задач за час или две критические реплики в выбранном чате за 15 минут. Учитываются события после отметки или перерыва. Если дополнительной поправки нет, подтверждённое завершение вместе с фокусом не менее 20 минут и 80% рабочего отрезка возвращает один пункт в пределах личной отметки. Нижняя граница оценки составляет 1/10. Раскрытие точки показывает применённые факторы и ведёт к её интервалу ActivityWatch.
|
|
|
|
Источник выбирается явно; включение не означает разрешение читать все сессии. Настройка выбранного JSONL:
|
|
|
|
```sh
|
|
python3 scripts/agent_focus_source.py enable /полный/путь/session.jsonl
|
|
python3 scripts/agent_focus_source.py disable
|
|
```
|
|
|
|
Для оценки настроения используются сигналы выбранных чатов за 15 минут и наблюдаемая активность за час. Две критические реплики, резкий тон и не менее 25 минут активности дают оценку вероятного раздражения. Две более свежие однозначно положительные реплики и не менее 15 минут активности дают оценку положительного настроя. Новая личная отметка останавливает расчёт по предыдущим репликам. В сводке хранятся только время и категория сигналов текущей даты.
|
|
|
|
Из «Сигналов дня» ссылка «Интервалы расчёта» открывает во Work History точный диапазон для оценки энергии. В расчёт входят фактические отрезки наблюдений до отметки времени точки. Задачи, переключения, сессии и завершения показаны по моменту наблюдения. График группирует данные по получасам для чтения.
|
|
|
|
Самочувствие прошлой даты открывается из её сводки Work History. При первой записи нового дня прежние личные отметки сохраняются в `wellbeing-days`, а при очередном сборе времена и категории подтверждённых реплик сохраняются в `agent-focus-days`. История реплик доступна при активном совпадающем источнике. Обе папки входят в локальный файловый архив восстановления.
|
|
|
|
Перерыв начинается с наблюдаемого отсутствия после активности и включает минимум пять измеренных минут. Пробел наблюдения до двух минут может разделять части одного перерыва. Его длительность в сумму не входит. После 50 измеренных минут активности система предлагает перерыв, если свежий интервал активен и рабочее окно ещё открыто. Штатная страница перечитывает данные раз в 45 секунд.
|