Files
dotfiles/.scratch/proxy-client-installer/issues/01-standalone-install.md
T
ddadmin 43404d374f docs(proxy-client): добавлен тикет самостоятельной установки
- Зачем:
  - согласованный дизайн нужно передать агенту одной готовой вертикальной задачей.
- Что:
  - опубликован тикет самостоятельного установщика без блокирующих зависимостей.
  - зафиксированы критерии безопасности, совместимости, проверки и документации.
- Проверка:
  - git diff --cached --check.
2026-07-21 21:57:13 +03:00

4.2 KiB

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

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

Blocked by: None — can start immediately.

Status: ready-for-agent

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