使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 1 個已知的高風險或嚴重漏洞(OSV.dev,2026年11月16日),安裝前請先考慮。
go:github.com/charmbracelet/wish v1.4.7Wish 有 SCP 路徑穿越漏洞,可任意讀寫檔案 (GHSA-xjvp-7243-rg9h,嚴重,尚無修正版本)
Linux x86_64
需要先準備
- 系統套件:
ttyd,ffmpeg
下載 vhs v0.12.1 Linux x86_64 發行版執行檔到 ~/.local/bin
cd /tmp && V=$(curl -fsSL https://api.github.com/repos/charmbracelet/vhs/releases/latest | python3 -c 'import sys,json;print(json.load(sys.stdin)["tag_name"].lstrip("v"))') && curl -fsSLO https://github.com/charmbracelet/vhs/releases/download/v$V/vhs_${V}_Linux_x86_64.tar.gz && tar xzf vhs_${V}_Linux_x86_64.tar.gz && mkdir -p ~/.local/bin && cp vhs_${V}_Linux_x86_64/vhs ~/.local/bin/安裝 ttyd 與 ffmpeg 靜態執行檔(README 列出的前置需求)到 ~/.local/bin
cd /tmp && curl -fsSL -o ~/.local/bin/ttyd https://github.com/tsl0922/ttyd/releases/latest/download/ttyd.x86_64 && chmod +x ~/.local/bin/ttyd && curl -fsSLO https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-linux64-gpl.tar.xz && tar xJf ffmpeg-master-latest-linux64-gpl.tar.xz && cp ffmpeg-master-latest-linux64-gpl/bin/ffmpeg ~/.local/bin/ && ffmpeg -version
README 與實測不符之處
- README 寫: VHS requires ttyd and ffmpeg
實際可行: VHS 首次算繪時還會在執行階段下載 Chromium(go-rod,存到 ~/.cache/rod),需要網路與系統函式庫(libnss3、libatk、libX11、libgbm、libcairo、libasound 等)。缺少這些時,算繪會失敗並顯示 'could not start browser'。
確認能用
vhs --version輸出應包含「vhs version v0.12.1」。
先試試這個
(sleep 2; printf 'echo hello\r'; sleep 1; printf 'exit\r'; sleep 2) | timeout 30 script -qec "vhs record --shell bash" /dev/null執行 vhs record --shell bash,開始將終端機操作錄成 tape 腳本。
它能做什麼
- 將終端機操作錄成 tape 檔已測試
怎麼使用
- 執行
vhs record --shell bash開始錄製。 - 照常輸入指令,輸入
exit結束。 - VHS 會將錄下的操作印成 tape 指令,例如
Type "<your text>"。
- 執行
- 將 tape 腳本轉成終端機 GIF未測試
- 發布 GIF 以便分享未測試
- 執行內建的 SSH 算繪伺服器未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以啟動
- 4 項功能中 1 項可用
- 可離線使用
macOS 和 Windows:專案說支援,但 pickfit 還沒試過。
適合用來
- 從腳本製作 CLI 工具的 GIF 展示
- 為終端機應用程式的整合測試產生 golden 檔案
- 在 CI 中持續更新示範 GIF
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月15日
- 版本 v0.12.1 (24fa225)
測試機器遇到的差異
- README: Install with go install, pacman, nix, xbps, brew or apt (all need a toolchain, root or another distro)
測試中: 從 GitHub releases 取得發行版壓縮檔 vhs_0.12.1_Linux_x86_64.tar.gz,複製到 ~/.local/bin,另加靜態 ttyd(tsl0922 releases)與 ffmpeg(BtbN builds) - README: vhs record > cassette.tape
測試中: 需要真正的 TTY:沒有終端機時會失敗並顯示 'inappropriate ioctl for device'。改在 `script` 底下執行就成功了。