ellmos-ai Русский — Официальная русская версия
migrate-rename.
Переименование файлов с помощью оберток (Эволюционная миграция) (Русский)
Позволяет переименовывать файлы БЕЗ жестких сбоев. Ссылки органично обновляются в процессе ежедневного использования.
Принцип: Эволюционная миграция
BEFORE: AFTER:
old_file.md new_file.md (renamed)
| |
+-- Reference A +-- old_file.md (wrapper)
+-- Reference B |
+-- Reference C +-- Log table
+-- Instructions
+-- Link to new_file.md
Когда кто-то обращается по старому пути:
- Попадает в файл-обертку
- Добавляет запись в журнал (лог)
- Исправляет ссылку, которая привела его сюда
- Переходит к фактическому файлу
Пошаговое руководство
1. Переименуйте файл
mv old_file.md new_file.md
2. Создайте файл-обертку
Создайте old_file.md со следующим содержимым:
# OLD_FILE.md - REDIRECTED (Deutsch)
**Status:** This file has been renamed to `new_file.md`
---
## Migration Log
| Date | Who | Origin | Reference corrected? |
|------|-----|--------|---------------------|
| YYYY-MM-DD | [Name] | Initial migration | n/a (wrapper created) |
---
## Instructions
1. **Leave a log entry** (in table above)
2. **Check origin**: What sent you here?
3. **Correct reference**: Change `old_file.md` -> `new_file.md`
4. **Go to the actual file**: [new_file.md](new_file.md)
---
**Target file:** [new_file.md](new_file.md)
3. Немедленно исправьте критические ссылки
- Файлы справки (основная документация)
- Ссылки в системных промптах
- Код CLI, непосредственно использующий путь
4. Эволюционная миграция остальных ссылок
Остальное автоматически исправляется по мере использования.
Когда использовать метод обертки?
ДА - Обертка полезна:
- Множество потенциальных ссылок
- Файл ссылается различными партнерами/инструментами
- Не является критически важным системным файлом
НЕТ - Изменить все напрямую:
- Немногочисленные, известные ссылки
- Критические системные файлы (конфигурация, схема БД)
- Критичные к производительности пути
Очистка
Примерно через 30 дней или когда в журнале перестанут появляться новые записи:
- Переместите файл-обертку в
_archive/deprecated/ - Или удалите полностью (если новых записей больше нет)
История изменений
1.0.0 (2026-03-15)
- Перенесено из BACH v3.8.0
Перенесено из BACH v3.8.0 | Автономная версия