Это старая версия документа!
Содержание
Подготовка архива знаний для публикации (инструкция ИИ)
Область: Open. Состояние документа: проект для обсуждения (review).
Назначение
Готовьте публикационный sharix.knowledge.bundle формата 1. Это не установочный ZIP DokuWiki-плагина и не ZIP контекста TZ.
Содержимое
В корне ZIP находятся только manifest.json и documents/<id>.txt для каждой записи. manifest.json содержит format, version: 1 и массив documents. У документа обязательны id, page, area, type, title, status, schema_version: 1, path, sha256. Пути documents/<id>.txt, кодировка UTF-8, хеш SHA-256 точных байтов текста.
area=open → sharixopen:*; area=platform → sharixplatform:platform:*; area=joint → sharixplatform:joint:*.
Обновление
Для существующей страницы не создавайте новый ID и URL. Скачайте её актуальные данные (или получите через утверждённый интерфейс). Добавьте base_sha256 именно текущего текста. Сохраните page и id, замените содержимое новым текстом. DokuWiki сама хранит историю. previous_id применяют только для разовой миграции ошибочного старого стабильного ID, не для обычного обновления.
Удаление старого мусора
Не используйте пустой файл как скрытое удаление. После обновления плагина и Platform выполняйте явное operation: delete с файлом ровно 0 байт, sha256 пустой строки, текущим base_sha256 и delete_confirmation равным полному page. Операция проходит отдельный preview/модерацию и требует ACL_DELETE. Нельзя удалить главный каталог. При несовпадении хеша отмените удаление, а не подменяйте хеш.
Машинные связи
relations: related_to, depends_on, applies_to, verified_by, supersedes, conflicts_with. extensions.taxonomy: domain, lifecycle, component, parents, terms; extensions.glossary: словарь определений. ID целевых документов должны быть существующими и разрешёнными для этой области.
Обязательная самопроверка
- Никаких версий и дат в постоянных адресах (если нет реально разных версий API).
- Не меньше одной стартовой страницы раздела с графом, каталогом и текстовыми ссылками.
- Все дочерние документы имеют родителя, ссылки и RELATED.
- Все внутренние сведения перенесены только в
platform/jointи не появляются в Open. - Проверены фактические SHA и
base_sha256; нельзя придумывать последние. - Удаления изолированы от массовой публикации и явно видны при preview.
- Архив проходит парсер Platform до отправки модератору.