91 lines
4.3 KiB
Markdown
91 lines
4.3 KiB
Markdown
# Nextcloud User Manual — выжимка для работы (по PDF)
|
||
|
||
Источник: `docs/Nextcloud_User_Manual.pdf` (Release latest, Feb 26, 2026).
|
||
|
||
## Что важно для повседневной работы
|
||
|
||
### 1) Веб-интерфейс
|
||
|
||
- Поддерживаемые браузеры: Chrome/Chromium, Firefox, Safari, Edge.
|
||
- Internet Explorer не поддерживается.
|
||
- Ключевые зоны интерфейса: меню приложений, поиск, контакты, меню профиля/настроек, список файлов.
|
||
|
||
Практика: для ручной проверки проблем всегда сначала подтверждай, что пользователь работает в поддерживаемом браузере.
|
||
|
||
### 2) Файлы и синхронизация
|
||
|
||
Блок 3.x — основной:
|
||
|
||
- Файлы в web UI: загрузка, папки, фильтры, перемещение, предпросмотр, комментарии, теги.
|
||
- WebDAV: доступ к файлам сторонними клиентами (Linux/macOS/Windows/cURL/WinSCP/Cyberduck).
|
||
- Deleted files: восстановление/очистка, влияние квот.
|
||
- Версии: история версий, переименование/удаление версий.
|
||
- Шаринг: публичные ссылки, внутренние шары, федеративные шары.
|
||
- Anonymous uploads (file drop).
|
||
- Большие файлы, квоты, transfer ownership.
|
||
|
||
Практика:
|
||
- Для автоматизации использовать `files list/search/get/upload/delete`.
|
||
- Для межсистемного доступа — WebDAV + app password.
|
||
- При проблемах «нет места» проверять квоты + deleted files + versions.
|
||
|
||
### 3) Контакты и календари
|
||
|
||
Блок 4.x:
|
||
|
||
- Contacts app
|
||
- Calendar app
|
||
- Синхронизация с Android/iOS/macOS/Thunderbird/KDE/GNOME/Windows
|
||
|
||
Практика:
|
||
- В автоматизации контакты вести через CardDAV-команды (`contacts ...`, `addressbooks list`).
|
||
- События — через CalDAV-команды (`calendar ...`, `calendars list`).
|
||
- Для стабильности всегда использовать явный календарь/адресную книгу.
|
||
|
||
### 4) Безопасность
|
||
|
||
Блок 9.x и 10.x:
|
||
|
||
- 2FA
|
||
- Recovery codes
|
||
- Device-specific passwords
|
||
- Управление подключёнными браузерами/устройствами
|
||
|
||
Практика:
|
||
- Для CLI интеграции использовать app password (device-specific), не основной пароль.
|
||
- При ошибках авторизации первым делом проверять токен/срок действия app password.
|
||
|
||
### 5) Desktop Client
|
||
|
||
Блок 6.x:
|
||
|
||
- Установка
|
||
- Синхронизация
|
||
- Конфликты
|
||
- Обновления
|
||
|
||
Практика:
|
||
- Если файлы «пропали» только локально — сначала проверять статус sync-клиента и конфликтные копии.
|
||
|
||
---
|
||
|
||
## Карта соответствия PDF ↔ рабочие команды skill
|
||
|
||
- Файлы (Manual 3.1–3.4, 3.10–3.12) → `files *`
|
||
- Шаринг/федерация (Manual 3.7, 3.8, 3.15) → частично через web UI/серверные API (в текущем CLI прямых команд шаринга нет)
|
||
- Контакты (Manual 4.1) → `contacts *`, `addressbooks list`
|
||
- Календарь (Manual 4.2) → `calendar *`, `calendars list`
|
||
- Задачи (CalDAV VTODO, смежно с календарным стеком) → `tasks *`
|
||
- WebDAV доступ (Manual 3.2) → используется CLI внутри `files *`
|
||
|
||
---
|
||
|
||
## Что не покрыто текущим skill напрямую
|
||
|
||
- Nextcloud Talk (глава 5)
|
||
- UI-темы/Accessibility (глава 8)
|
||
- Полное управление шэрингом на уровне тонких прав (link expiry/password и т.п.)
|
||
- 2FA-администрирование через отдельные команды
|
||
|
||
Для этих сценариев: либо web UI, либо отдельный специализированный инструмент/API.
|