Документация исходного кода; установленный выпуск может отличаться.
Обновление и откат
English · Руководство пользователя
Используйте три файла одного опубликованного выпуска: main.js, manifest.json и styles.css. Сборка для разработки или успешный автоматический прогон не подтверждают проверку версии на вашем устройстве. Перед установкой прочитайте описание выпуска.
Перед обновлением
- Сохраните резервную копию хранилища вместе со скрытой папкой настроек. Предыдущие файлы плагина и
.obsidian/plugins/obs-projects-plus/data.jsonхраните вместе: вdata.jsonнаходятся проекты и настройки представлений. Если используется другая папка конфигурации, замените.obsidianеё именем. - Завершите текущие правки. Кандидат сначала установите в копию хранилища и проверьте свои рабочие сценарии, затем обновляйте основное хранилище.
- Запишите версию плагина, Obsidian и устройство. Если кандидат сопровождается манифестом сборки или контрольной суммой, сохраните их: две сборки для разработки могут показывать одинаковую версию.
Установка обновления
- Отключите Projects Plus в настройках сторонних плагинов Obsidian.
- Замените три файла плагина в
.obsidian/plugins/obs-projects-plus/соответствующими файлами выпуска. Сохраните свойdata.json. - Включите плагин либо перезапустите Obsidian. Откройте проект и проверьте установленную версию.
Синхронизация устройств
Файлы плагина находятся в скрытой папке конфигурации, которую средство синхронизации может исключать. Проверьте, что эта папка передаётся, а принимающее устройство получает изменения. При ручном режиме запустите синхронизацию на обоих устройствах. После получения трёх файлов одной сборки перезапустите Obsidian: передача ZIP сама по себе не устанавливает плагин. Сохраняйте data.json, если не планируете намеренно сбросить конфигурацию.
Проверка рабочих сценариев
| Сценарий | Что проверить |
|---|---|
| Заметки и типы значений | Измените текст, число, дату и список. Подтвердите ввод, откройте Markdown-файл и перезагрузите вид. Проверьте значения и типы, включая пустое значение. |
| Ввод и подсказки | Наберите текст в исходном поле, выберите подсказку и подтвердите. При использовании IME сначала завершите композицию. Отмените другую правку и проверьте, что она не сохранилась. |
| Календарь и Agenda | Выберите день: каждый список должен показывать записи этого дня, удовлетворяющие также его условиям. Создайте событие и проверьте сопоставленные свойства даты, статуса и цвета в заметке. |
| Встроенные виды | Откройте два блока с разными локальными настройками. Изменение вида или фильтра одного блока должно сохранять другой блок и конфигурацию источника. |
| Диаграммы и связанные блоки | Выберите категорию диаграммы, проверьте записи в принимающих блоках, затем снимите выделение. Если используется группировка дат, включите такую категорию в проверку. |
| Доска | Перенесите карточку и колонку; другой перенос отмените. Проверьте сохранённый порядок и возврат каждой колонки в прежнее свёрнутое или раскрытое состояние. |
| Телефон и планшет | Повторите нужные сценарии с открытой и закрытой клавиатурой, в обеих ориентациях и с привычным масштабом. Исходное поле, подтверждение и подсказки должны оставаться доступны. |
Версия 3.7.2 заменяет прежние правила формул единым движком unified-v1. Сохранённые определения переходят автоматически: тексты выражений остаются прежними, но результаты могут измениться. До применения новых настроек плагин записывает и перечитывает formula-unified-*.data.json и .report.json в своей папке. Отчёт перечисляет затронутые определения и ошибки синтаксиса; сравнение результатов всех записей он не обещает. Если копию нельзя проверить, миграция блокируется. Обновляйте все устройства вместе и сверяйте известные примеры. Чрезмерные вычисления могут вернуть ошибку или предупреждение pipeline; при остановке по лимиту сохраняется последний полностью завершённый этап.
Проверка регулярных выражений действует для существующих и новых формул и фильтров. Шаблон с чрезмерной или неподтверждённой сложностью отклоняется до выполнения. Если сохранённое выражение сообщает такую ошибку, упростите шаблон: смена профиля совместимости формулы не отключает проверку. Допущенные шаблоны сохраняют нативное поведение поиска и замены.
Откат
Отключите плагин и закройте Obsidian. Отдельно сохраните настройки, изменённые после обновления. Восстановите прежний согласованный набор трёх файлов и исходный data.json из проверенной копии миграции или установки, затем откройте Obsidian. Возврат одного JSON под новым движком не возвращает удалённые правила. Миграция не переписывает заметки.
Замена файлов плагина не отменяет уже записанные изменения заметок. Если их тоже нужно отменить, восстановите соответствующие заметки из копии хранилища, предварительно проверив изменения после создания копии. Проверьте восстановленную копию до замены рабочих данных.
Сообщение об ошибке
Укажите версии плагина и Obsidian, устройство, шаги, ожидаемый и фактический результат. Для кандидата добавьте коммит или контрольную сумму сборки. Минимальный пример с переименованными или вымышленными заметками поможет воспроизвести проблему без передачи личных данных. Сообщения принимаются в трекере ошибок.