# 01 — Самостоятельная установка proxy-client из отдельного каталога

**What to build:** пользователь может отдельно скопировать каталог
`proxy-client`, запустить пакетный `install.sh` без общего dotfiles и получить
готовые симлинки, подключённый Bash-модуль и краткую подсказку о дальнейшей
настройке. Установка даёт одинаковый результат со stow и без него, безопасно
повторяется, не трогает машинные файлы и не требует доступной сети или прокси.

**Blocked by:** None — can start immediately.

**Status:** ready-for-agent

**Completed:** 2026-07-21

- [x] При наличии stow установщик использует его, а без stow создаёт напрямую
  тот же набор симлинков и явно сообщает выбранный способ.
- [x] Управляются только CLI, Bash-модуль и шаблоны; машинный конфиг и закрытый
  профиль не создаются, не заменяются и не связываются даже при наличии в
  исходном каталоге.
- [x] Домашние каталоги остаются обычными каталогами; пакетные README и
  установщик не раскладываются в домашний каталог.
- [x] До любых изменений проверяется весь набор назначений. Любой чужой файл,
  каталог или симлинк приводит к отказу без частичной установки и без
  автоматической замены или резервной копии; пользователю показывается полный
  список конфликтующих путей.
- [x] Повторный запуск для уже правильных ссылок ничего не меняет и завершается
  успешно, а исходный каталог может находиться в произвольном пути, включая
  путь с пробелами.
- [x] По умолчанию установщик идемпотентно подключает Bash-модуль и при
  необходимости добавляет пользовательский каталог исполняемых файлов в
  `PATH`, не дублируя подключение из полного dotfiles.
- [x] Параметр `--no-shell-setup` полностью отключает изменение настроек Bash.
- [x] После раскладки проверяется только локальная исправность CLI и
  Bash-модуля; установка не выбирает режим, не устанавливает Xray, не читает
  VLESS, не проверяет сеть и не требует существующего корректного конфига.
- [x] Финальный вывод кратко объясняет, как применить изменения в текущей
  shell-сессии, предупреждает о постоянном пути исходного каталога и направляет
  к настройке режимов в основной инструкции, не дублируя её.
- [x] Автоматические проверки покрывают оба способа создания ссылок, повторный
  запуск, все виды конфликтов, защиту машинных файлов, настройку Bash и режим
  без её изменения.
- [x] Инструкция пакета описывает новый установщик, зависимость симлинков от
  постоянного пути исходного каталога и дальнейшую ручную настройку; общий
  установщик dotfiles продолжает работать по прежнему контракту.