89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
|
# Nextcloud — операторский минимум (чеклист)
|
|||
|
|
|
|||
|
|
Короткий порядок действий при любой заявке по Nextcloud.
|
|||
|
|
|
|||
|
|
## 0) Перед началом
|
|||
|
|
|
|||
|
|
- Подтвердить, что используется поддерживаемый браузер (Chrome/Firefox/Safari/Edge).
|
|||
|
|
- Проверить доступы:
|
|||
|
|
- `NEXTCLOUD_URL`
|
|||
|
|
- `NEXTCLOUD_USER`
|
|||
|
|
- `NEXTCLOUD_TOKEN` (app password)
|
|||
|
|
|
|||
|
|
## 1) Определить тип проблемы
|
|||
|
|
|
|||
|
|
- Файлы (не видно, не грузится, не скачивается, нет места)
|
|||
|
|
- Календарь/события
|
|||
|
|
- Задачи
|
|||
|
|
- Контакты
|
|||
|
|
- Доступ/авторизация
|
|||
|
|
|
|||
|
|
## 2) Базовая диагностика по типу
|
|||
|
|
|
|||
|
|
### Файлы
|
|||
|
|
|
|||
|
|
1. Проверить наличие/путь:
|
|||
|
|
- `files list --path "/..."`
|
|||
|
|
- `files search --query "..."`
|
|||
|
|
2. Если файл есть — проверить чтение:
|
|||
|
|
- `files get --path "/..."`
|
|||
|
|
3. Если проблемы с загрузкой — тестовый upload в безопасный путь.
|
|||
|
|
4. Если «нет места»:
|
|||
|
|
- проверить квоту
|
|||
|
|
- проверить Deleted files
|
|||
|
|
- проверить версии файлов
|
|||
|
|
|
|||
|
|
### Календарь
|
|||
|
|
|
|||
|
|
1. Проверить список календарей:
|
|||
|
|
- `calendars list --type events`
|
|||
|
|
2. Проверить окно дат:
|
|||
|
|
- `calendar list --from "ISO" --to "ISO"`
|
|||
|
|
3. Для правок всегда использовать точный `uid` из свежего списка.
|
|||
|
|
|
|||
|
|
### Задачи
|
|||
|
|
|
|||
|
|
1. Проверить список календарей задач:
|
|||
|
|
- `calendars list --type tasks`
|
|||
|
|
2. Проверить список задач в нужном календаре:
|
|||
|
|
- `tasks list --calendar "..."`
|
|||
|
|
3. Для правок/complete/delete — только по свежему `uid`.
|
|||
|
|
|
|||
|
|
### Контакты
|
|||
|
|
|
|||
|
|
1. Проверить адресные книги:
|
|||
|
|
- `addressbooks list`
|
|||
|
|
2. Поиск контакта:
|
|||
|
|
- `contacts search --query "..."`
|
|||
|
|
3. Правки/удаление — только по свежему `uid`.
|
|||
|
|
|
|||
|
|
### Доступ/авторизация
|
|||
|
|
|
|||
|
|
- 401/403: проверить пользователя и app password.
|
|||
|
|
- 404: проверить точные имена календаря/адресной книги/пути.
|
|||
|
|
- После ротации пароля пользователя — перевыпустить app password.
|
|||
|
|
|
|||
|
|
## 3) Правила безопасных изменений
|
|||
|
|
|
|||
|
|
1. Сначала `list/get/search`, потом `edit/delete`.
|
|||
|
|
2. Не делать массовые изменения без теста на 1 объекте.
|
|||
|
|
3. Для календаря всегда задавать явные `--start` и `--end` в ISO.
|
|||
|
|
4. Фиксировать, что именно изменено: сущность, uid/id, время, результат.
|
|||
|
|
|
|||
|
|
## 4) Быстрый smoke-test после фикса
|
|||
|
|
|
|||
|
|
- Файлы: создать тестовый файл → прочитать → удалить.
|
|||
|
|
- Календарь: создать короткое тест-событие → проверить в списке → удалить.
|
|||
|
|
- Контакты: создать тест-контакт → найти → удалить.
|
|||
|
|
- Задачи: создать тест-задачу → complete → удалить.
|
|||
|
|
|
|||
|
|
## 5) Команда запуска
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
node skills/openclaw-nextcloud/scripts/nextcloud.js <section> <command> [options]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Справка по разделам:
|
|||
|
|
- `docs/Nextcloud_Work_Instructions.md`
|
|||
|
|
- `docs/Nextcloud_Manual_Extract.md`
|