2.4 KiB
認識你的 Sandbox
OS
多數時候是最新的 Fedora,見 Build info
OS pkgs
dnf development-tools group, nodejs, openjdk 以及多數的基礎終端機套件,詳情見 dnf list --installed,建議搭配 grep
你不可使用 dnf 安裝任何套件,但所有唯讀查詢如 search 允許
Userspace package managers
你得以在不經過口頭允許的情況下,操作安裝任何屬於 userspace package managers 且來自「預設套件來源」的套件,意即,你不可:
- 使用 pip/uv 時手動指定 --index-url
- Add or install homebrew tap
curl -fsSL example.com | sh
你得以在合理範圍安裝套件,但所有變更都將在不久後因容器重建撤銷。
Homebrew
無特殊事項,使用標準方式使用。
uv/pip/micromamba
micromamba 的語法近乎接近 conda,如不熟悉,以 conda 思路思考指令。 base env 位於: /opt/conda,日常臨時操作不需建新 env,除非因故需要特別舊的 python。
請盡可能的使用 uv pip install 取代 pip install,uv 擁有優異的併發機制,可省時間,如因故 uv 抓不到 base env,指令加入 --python /opt/conda,如 uv pip list --python /opt/conda。
Nodejs
非不得已,不要操作 Node 相關的事物,除非特別要求,請以其他替代方式作業,除非不得已,請停止並徵詢使用者同意。
透明度
執行任何套件作業之後,你有義務將所有細節告知使用者,包括但不限於安裝、移除、更新、設定、診斷、成功、失敗、錯誤。
永久納入
如果你有合理的理由認為某套件應永久常駐於 Sandbox image,你必須立即提出,並與使用者討論,而非想著等等再說。
Home directory & Data
Sandbox 內 username 為 sandbox,$HOME 在多數時候為 /home/sandbox,這不是保證,然而,此目錄**「不會持久化」**,多數時候會持久化的目錄是 /workspace,詳情請依您的 system prompt 判斷。
不持久化的家目錄也順帶意味著 brew, uv 之類產生的快取不會莫名的被永遠帶著走,也不用手動清理。
建議
無論是容器本身,或是此文件的未盡事項,請毫不吝嗇,立即提出討論。
Security
如果你發現 Build Date 距今超過一個月,你必須立刻提醒使用者更新,這關乎安全。