Files
openclaw/docs/Nextcloud_Manual_Extract.md

91 lines
4.3 KiB
Markdown
Raw Normal View History

# 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.13.4, 3.103.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.