OpenCode และ PATH ที่ไม่สมบูรณ์: ทำไมเครื่องมือของคุณจึงไม่อยู่ใน shell ของเอเจนต์

# Dans votre terminal interactif (tout fonctionne)
echo $PATH | tr ':' '\n' | grep -v '^/usr' | sort

/home/cheroliv/apps
/home/cheroliv/.nvm/versions/node/v22.19.0/bin
/home/cheroliv/.sdkman/candidates/java/current/bin
/home/cheroliv/.sdkman/candidates/gradle/current/bin
/home/cheroliv/.local/share/pnpm
/home/cheroliv/.local/bin

# Shell non-interactif : pas de .zshrc
zsh -c 'echo $PATH' | tr ':' '\n' | grep -v '^/usr' | sort

/home/cheroliv/.local/bin

grep -n 'apps\|SDKMAN\|NVM\|PNPM\|PATH' ~/.zshrc

119: PATH="/usr/bin/python3:$HOME/apps:$PATH"           # ← pas exporté !
171: export NVM_DIR="$HOME/.nvm"
172: [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"   # ← NVM init
176: nvm use --lts --silent                              # ← active une version
179: export PNPM_HOME="/home/cheroliv/.local/share/pnpm"
187: export SDKMAN_DIR="$HOME/.sdkman"
188: [[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"

cat ~/.zshenv 2>/dev/null || echo "FICHIER ABSENT"

export SDKMAN_DIR="$HOME/.sdkman"
export NVM_DIR="$HOME/.nvm"
export PNPM_HOME="$HOME/.local/share/pnpm"
export PATH="$HOME/apps:$HOME/.sdkman/candidates/java/current/bin:$HOME/.sdkman/candidates/gradle/current/bin:$HOME/.nvm/current/bin:$PNPM_HOME:$HOME/.local/bin:$HOME/.local/share/JetBrains/Toolbox/scripts:/usr/bin/python3:$PATH"

# ❌ MAUVAISE IDÉE
[[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"

@startuml
skinparam backgroundColor #FEFEFE

rectangle "แนวทางแบบช้า\n(source sdkman-init.sh)" as slow {
  card ".zshenv source sdkman-init.sh\n2-3 วินาทีต่อเชลล์\nการตรวจสอบเครือข่าย\nความเสี่ยงที่จะล้มเหลว" as s1 #FDEDEC
}

rectangle "แนวทางแบบเร็ว\n(ซิมลิงก์โดยตรง)" as fast {
  card ".zshenv export PATH=...current/bin\n0 ms\nไม่ใช้เครือข่าย\nไม่มีการเริ่มต้น" as s2 #E8F8E8
}

slow --> fast : Même résultat final\nLe PATH pointe sur current/bin\ndans les deux cas

@enduml

~/.sdkman/candidates/java/current -> ~/.sdkman/candidates/java/25.0.2-tem

~/.nvm/versions/node/v22.19.0/bin/node

@startuml
skinparam backgroundColor #FEFEFE

package "SDKMAN ✅" {
  [~/.sdkman/candidates/java/current] as sdk_current
  [~/.sdkman/candidates/java/25.0.2-tem/] as java_25
  [~/.sdkman/candidates/java/21.0.7-tem/] as java_21

  sdk_current --> java_25 : symlink
}

package "NVM ❌ (ก่อนแก้ไข)" as nvm_before {
  [~/.nvm/versions/node/v22.19.0/] as node_22
  [~/.nvm/versions/node/v20.16.0/] as node_20
  note right of node_22
ไม่มี symlink current! .zshenv ต้องชี้แบบฮาร์ดโค้ด จะพังเมื่อ nvm install ครั้งถัดไป
  end note
}

package "NVM ✅ (หลังแก้ไข)" as nvm_after {
  [~/.nvm/current] as nvm_current
  [~/.nvm/versions/node/v22.19.0/] as node_22b
  [~/.nvm/versions/node/v20.16.0/] as node_20b

  nvm_current --> node_22b : symlink\n(mis à jour auto)
}

@enduml

# Créer le symlink initial
ln -sfn "$HOME/.nvm/versions/node/v22.19.0" "$HOME/.nvm/current"

$HOME/.nvm/current/bin

# ❌ Chemin en dur — cassé au prochain changement de version
$HOME/.nvm/versions/node/v22.19.0/bin

# À la fin de .zshrc, APRÈS le chargement de NVM
nvm use --lts --silent
ln -sfn "$(nvm_version_path "$(nvm current)")" "$NVM_DIR/current"

_nvm() {
  command nvm "$@"
  local rc=$?
  ln -sfn "$(nvm_version_path "$(nvm current)")" "$NVM_DIR/current"
  return $rc
}
alias nvm='_nvm'

@startuml
skinparam backgroundColor #FEFEFE

actor Développeur
participant "wrapper ของ nvm\n(_nvm)" as wrapper
participant "nvm ตัวจริง\n(คำสั่ง nvm)" as realnvm
participant "~/.nvm/current\n(ซิมลิงก์)" as symlink

Développeur -> wrapper : nvm use 20
wrapper -> realnvm : command nvm use 20
realnvm --> wrapper : version activée
wrapper -> symlink : ln -sfn .../v20.16.0 ~/.nvm/current
wrapper --> Développeur : retour

note right of symlink
อัปเดตอยู่เสมอ!
ใช้โดย .zshenv
→ เข้าถึงได้ผ่าน OpenCode
end note

@enduml