Инструменты пользователя

Инструменты сайта


sharixopen:knowledge:standards:bundles

Это старая версия документа!


Подготовка архива знаний для публикации (инструкция ИИ)

Область: 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 целевых документов должны быть существующими и разрешёнными для этой области.

Обязательная самопроверка

  1. Никаких версий и дат в постоянных адресах (если нет реально разных версий API).
  2. Не меньше одной стартовой страницы раздела с графом, каталогом и текстовыми ссылками.
  3. Все дочерние документы имеют родителя, ссылки и RELATED.
  4. Все внутренние сведения перенесены только в platform/joint и не появляются в Open.
  5. Проверены фактические SHA и base_sha256; нельзя придумывать последние.
  6. Удаления изолированы от массовой публикации и явно видны при preview.
  7. Архив проходит парсер Platform до отправки модератору.

См. Маршрутизация и модерация, Шаблон страницы.

sharixopen/knowledge/standards/bundles.1792227098.txt.gz · Последнее изменение: — sx_knowledge_api_open

© 2022 ShariX