@iola_adm/iola-cli 0.1.63 → 0.1.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -33,10 +33,3 @@ iola cron delete 1
33
33
  ```
34
34
 
35
35
  `cron tick` проверяет задачи, которые пора выполнить. Его можно запускать вручную, через Windows Task Scheduler или другой планировщик.
36
-
37
- Для Госуслуг на Windows лучше использовать готовую системную задачу без висящего окна терминала:
38
-
39
- ```bash
40
- iola gosuslugi install-keepalive
41
- iola gosuslugi keepalive-status
42
- ```
package/wiki/Home.md CHANGED
@@ -26,6 +26,7 @@ iola ask "найди школу 29"
26
26
 
27
27
  - [Установка](Установка)
28
28
  - [Первый запуск](Первый-запуск)
29
+ - [Мастер настройки](Мастер-настройки)
29
30
  - [AI-профили](AI-профили)
30
31
  - [Локальный инструментальный агент](Локальный-инструментальный-агент)
31
32
  - [Skills и toolsets](Skills-и-toolsets)
@@ -33,7 +34,6 @@ iola ask "найди школу 29"
33
34
  - [Рабочая среда агента](Рабочая-среда-агента)
34
35
  - [Платформа агента](Платформа-агента)
35
36
  - [Браузерный агент](Браузерный-агент)
36
- - [Подключение Госуслуг](Подключение-Госуслуг)
37
37
  - [Расширения и локальные данные](Расширения-и-локальные-данные)
38
38
  - [Архивы и мастер настройки](Архивы-и-мастер-настройки)
39
39
  - [Daemon, RPC и cron](Daemon-RPC-и-cron)
@@ -42,4 +42,6 @@ iola onboard
42
42
 
43
43
  В списке компонентов есть отдельный пункт `7-Zip / архивы`. Если выбрать его, CLI установит архиватор сразу из мастера настройки.
44
44
 
45
- Мастер также предлагает подключить workspace, policy, Ollama, OpenAI, OpenRouter, Codex CLI, MCP, browser runtime, Госуслуги и индекс локальных документов.
45
+ Мастер также предлагает подключить workspace, policy, Ollama, OpenAI, OpenRouter, Codex CLI, MCP, browser runtime и индекс локальных документов.
46
+
47
+ Подробное описание пунктов мастера вынесено на страницу [Мастер настройки](Мастер-настройки).
@@ -94,26 +94,6 @@ iola context init
94
94
  iola context list
95
95
  iola settings list
96
96
  iola settings validate
97
- iola gosuslugi status
98
- iola gosuslugi check
99
- iola gosuslugi keepalive
100
- iola gosuslugi install-keepalive
101
- iola gosuslugi keepalive-status
102
- iola gosuslugi uninstall-keepalive
103
- iola gosuslugi terms
104
- iola gosuslugi consent
105
- iola gosuslugi connect
106
- iola gosuslugi open
107
- iola gosuslugi text https://www.gosuslugi.ru/
108
- iola gosuslugi screenshot https://www.gosuslugi.ru/ --output gosuslugi.png
109
- iola gosuslugi whoami
110
- iola gosuslugi debt
111
- iola gosuslugi notifications --unread
112
- iola gosuslugi mark-read
113
- iola gosuslugi logout --all
114
- iola gosuslugi configure --auth-url URL --token-url URL --client-id ID --scope openid
115
- iola gosuslugi login
116
- iola gosuslugi userinfo --json
117
97
  iola cron add "каждый день 09:00 -- quality"
118
98
  iola cron tick
119
99
  iola daemon status
@@ -0,0 +1,69 @@
1
+ # Мастер настройки
2
+
3
+ Мастер запускается при первом старте CLI и повторно командой:
4
+
5
+ ```bash
6
+ iola master
7
+ ```
8
+
9
+ Мастер обновляет только выбранные компоненты и не сбрасывает остальные настройки.
10
+
11
+ Перед выбором компонентов CLI проверяет окружение и показывает статус каждого пункта: `готово` или `не настроено`.
12
+
13
+ ## Компоненты
14
+
15
+ ### 1. workspace и контекст
16
+
17
+ Создает рабочую среду текущей папки: `.iola/`, `IOLA.md` и `.iola/context.md`.
18
+
19
+ Нужно, если агент будет работать с локальными файлами, документами, задачами, артефактами и контекстом проекта.
20
+
21
+ ### 2. policy analyst
22
+
23
+ Включает профиль разрешений для аналитической работы: открытые данные, отчеты, безопасные локальные операции.
24
+
25
+ ### 3. Ollama + локальная модель
26
+
27
+ Проверяет Ollama и локальные модели. Если Ollama не установлена, мастер может установить ее и предложить модель под возможности ПК.
28
+
29
+ Если модель уже скачана и доступна, пункт показывается как `готово`.
30
+
31
+ ### 4. OpenAI API
32
+
33
+ Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
34
+
35
+ ### 5. OpenRouter API
36
+
37
+ Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
38
+
39
+ ### 6. Codex CLI
40
+
41
+ Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
42
+
43
+ ### 7. MCP для Codex
44
+
45
+ Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
46
+
47
+ ### 8. 7-Zip / архивы
48
+
49
+ Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
50
+
51
+ Нужен для чтения, распаковки, сборки и индексирования архивов.
52
+
53
+ ### 9. Индекс локальных документов
54
+
55
+ Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
56
+
57
+ ```bash
58
+ iola index folder ./docs
59
+ ```
60
+
61
+ ### 10. Browser runtime
62
+
63
+ Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
64
+
65
+ Если runtime уже установлен, пункт показывается как `готово`.
66
+
67
+ ## Повторный запуск
68
+
69
+ Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.
@@ -34,12 +34,13 @@ iola commands
34
34
  Повторный запуск мастера:
35
35
 
36
36
  ```bash
37
- iola wizard
38
- iola setup wizard
37
+ iola master
39
38
  ```
40
39
 
41
40
  Мастер обновляет только выбранные разделы и не сбрасывает остальные настройки.
42
41
 
42
+ Подробное описание всех пунктов: [Мастер настройки](Мастер-настройки).
43
+
43
44
  Диагностика:
44
45
 
45
46
  ```bash
@@ -1,16 +0,0 @@
1
- ---
2
- name: gosuslugi
3
- description: Работа с личным аккаунтом Госуслуг пользователя через локальный браузерный профиль.
4
- ---
5
-
6
- Используй этот skill только когда пользователь явно спрашивает про свой личный аккаунт Госуслуг: ФИО, дату рождения, задолженности, штрафы, налоги, платежи, уведомления или госпочту.
7
-
8
- Доступные read-only tools:
9
-
10
- - `gosuslugi_whoami` - получить ФИО, дату рождения и краткие данные профиля.
11
- - `gosuslugi_debt` - получить задолженности и суммы к оплате.
12
- - `gosuslugi_notifications` - получить уведомления, включая новые непрочитанные.
13
-
14
- Не выполняй юридически значимые действия автоматически. Оплата, отправка заявлений, изменение персональных данных, удаление учетной записи, согласия и отметка уведомлений прочитанными требуют отдельного явного подтверждения пользователя.
15
-
16
- Если сохраненная сессия Госуслуг протухла или требуется повторная двухфакторная аутентификация, попроси пользователя выполнить `iola gosuslugi connect`.
@@ -1,138 +0,0 @@
1
- # Личное подключение Госуслуг
2
-
3
- `iola-cli` подключает личный аккаунт Госуслуг через отдельный локальный браузерный профиль на компьютере пользователя.
4
-
5
- Это не официальный API ЕСИА и не встраивание ключей организации. Пользователь сам открывает окно браузера, сам вводит логин, пароль и код подтверждения. CLI сохраняет только локальный браузерный профиль в домашней папке пользователя.
6
-
7
- ## Первый вход
8
-
9
- ```bash
10
- iola gosuslugi connect
11
- ```
12
-
13
- Что происходит:
14
-
15
- 1. CLI показывает согласие пользователя.
16
- 2. Устанавливает browser runtime, если он еще не установлен.
17
- 3. Открывает Госуслуги в отдельном профиле Chromium.
18
- 4. Пользователь сам проходит вход.
19
- 5. После завершения пользователь закрывает окно браузера.
20
- 6. CLI сохраняет локальное состояние профиля.
21
- 7. При подключении через мастер настройки CLI автоматически создает keepalive-задачу на 30 минут.
22
-
23
- Профиль хранится в:
24
-
25
- ```text
26
- ~/.iola/gosuslugi-browser-profile
27
- ```
28
-
29
- ## Работа с открытым профилем
30
-
31
- Открыть Госуслуги:
32
-
33
- ```bash
34
- iola gosuslugi open
35
- ```
36
-
37
- Прочитать видимый текст страницы:
38
-
39
- ```bash
40
- iola gosuslugi text https://www.gosuslugi.ru/
41
- ```
42
-
43
- Сделать скриншот:
44
-
45
- ```bash
46
- iola gosuslugi screenshot https://www.gosuslugi.ru/ --output gosuslugi.png
47
- ```
48
-
49
- ## Read-only данные
50
-
51
- Краткие данные профиля:
52
-
53
- ```bash
54
- iola gosuslugi whoami
55
- ```
56
-
57
- Задолженности и платежи к оплате:
58
-
59
- ```bash
60
- iola gosuslugi debt
61
- ```
62
-
63
- Уведомления:
64
-
65
- ```bash
66
- iola gosuslugi notifications
67
- iola gosuslugi notifications --unread
68
- ```
69
-
70
- Отметить уведомления прочитанными можно только отдельной командой с подтверждением:
71
-
72
- ```bash
73
- iola gosuslugi mark-read
74
- ```
75
-
76
- AI-агент может использовать read-only tools Госуслуг, если пользователь спрашивает про ФИО, дату рождения, задолженности, штрафы, налоги, платежи или уведомления.
77
-
78
- ## Статус
79
-
80
- ```bash
81
- iola gosuslugi status
82
- iola gosuslugi check
83
- ```
84
-
85
- Команда показывает, принято ли согласие, где лежит локальный профиль и когда он был создан.
86
-
87
- ## Keepalive
88
-
89
- Сессию Госуслуг нельзя сделать вечной: портал сам управляет сроком жизни входа и может попросить повторную двухфакторную аутентификацию. CLI может только мягко проверять сохраненный профиль.
90
-
91
- Запуск проверки каждые 30 минут:
92
-
93
- ```bash
94
- iola gosuslugi keepalive
95
- ```
96
-
97
- Однократная проверка:
98
-
99
- ```bash
100
- iola gosuslugi keepalive --once
101
- ```
102
-
103
- Полностью автоматический режим через системный планировщик Windows:
104
-
105
- ```bash
106
- iola gosuslugi install-keepalive
107
- iola gosuslugi keepalive-status
108
- ```
109
-
110
- На Windows создается задача Task Scheduler `iola-gosuslugi-keepalive`, которая каждые 30 минут выполняет `iola gosuslugi check --silent` без постоянно открытого окна терминала.
111
-
112
- Удалить задачу:
113
-
114
- ```bash
115
- iola gosuslugi uninstall-keepalive
116
- ```
117
-
118
- Если сессия протухла, CLI запишет это в лог и при следующей ручной команде попросит выполнить `iola gosuslugi connect`.
119
-
120
- ## Отключение
121
-
122
- Удалить локальное подключение:
123
-
124
- ```bash
125
- iola gosuslugi logout --all
126
- ```
127
-
128
- `--all` удаляет сохраненный браузерный профиль.
129
-
130
- ## Ограничения
131
-
132
- - CLI работает только с тем, что доступно пользователю в локальном браузере.
133
- - CLI не извлекает cookies, session tokens или внутренние токены Госуслуг.
134
- - Юридически значимые действия должны требовать отдельного подтверждения пользователя.
135
- - Сессия браузерного профиля может протухнуть. Если Госуслуги попросят повторный вход или 2FA, выполните `iola gosuslugi connect`.
136
- - Если Госуслуги попросят повторный вход, код или подтверждение, пользователь проходит его сам в открытом окне.
137
-
138
- OAuth/OIDC-команды `configure`, `login`, `userinfo` оставлены для случая, если у пользователя есть официально зарегистрированное подключение ЕСИА.