使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 2 個已知的高風險或嚴重漏洞(共 4 筆,每個受影響的套件版本一筆)(OSV.dev,2026年11月16日),安裝前請先考慮。
crates:quick-xml 0.37.5檢查開始標籤的重複屬性名稱時,執行時間呈二次方成長 (RUSTSEC-2026-0194,高風險,0.41.0 已修正)
再看 3 個
crates:quick-xml 0.38.3— RUSTSEC-2026-0194(高風險),0.41.0 已修正crates:quick-xml 0.37.5— RUSTSEC-2026-0195(高風險),0.41.0 已修正crates:quick-xml 0.38.3— RUSTSEC-2026-0195(高風險),0.41.0 已修正
Linux x86_64
需要先準備
- 系統套件:
Oracle Client libraries (for the oracle driver),jq and fzf (for the install script)
setup 1、setup 2 的單引號裡還寫著 /home/sbx(那裡 $HOME 不會展開):執行前請換成你自己的家目錄。
這些步驟是在家目錄裡一個已經存在的 work 資料夾裡跑的。請先建立它,再從那裡執行:
mkdir -p "$HOME/work" && cd "$HOME/work"下載 v0.4.7 x86_64-unknown-linux-gnu release tarball 與 sha256,驗證後解壓到 ~/.local,並連結至 ~/.local/bin(步驟同 install.sh)
set -e; B=rainfrog-v0.4.7-x86_64-unknown-linux-gnu; U=https://github.com/achristmascarl/rainfrog/releases/download/v0.4.7; mkdir -p ~/tmp/rf ~/.local/bin && cd ~/tmp/rf && curl -fsSL -o $B.tar.gz $U/$B.tar.gz && curl -fsSL -o $B.sha256 $U/$B.sha256 && sha256sum -c $B.sha256 && tar -xzf $B.tar.gz -C ~/.local/ && ln -sf ~/.local/rainfrog ~/.local/bin/rainfrog
在 pickfit 驗證過的原始指令(沙盒裡實際執行的)
僅供查核:裡面是沙盒的家目錄 /home/sbx。
set -e; B=rainfrog-v0.4.7-x86_64-unknown-linux-gnu; U=https://github.com/achristmascarl/rainfrog/releases/download/v0.4.7; mkdir -p ~/tmp/rf ~/.local/bin && cd ~/tmp/rf && curl -fsSL -o $B.tar.gz $U/$B.tar.gz && curl -fsSL -o $B.sha256 $U/$B.sha256 && sha256sum -c $B.sha256 && tar -xzf $B.tar.gz -C ~/.local/ && ln -sf ~/.local/rainfrog ~/.local/bin/rainfrograinfrog --versionpip install --user pyte && python3 - <<'EOF'
import sqlite3
c=sqlite3.connect('/home/sbx/work/test.db')
c.executescript("""
create table users(id integer primary key, name text, email text);
insert into users values (1,'alice','alice@example.com'),(2,'bob','bob@example.com'),(3,'carol','carol@example.com');
create table orders(id integer primary key, user_id integer, item text);
insert into orders values (1,1,'frogspawn'),(2,2,'lilypad');
""")
c.commit()
EOF
cat > /home/sbx/work/drive.py <<'EOF'
import os, pty, sys, time, json, select, pyte
# usage: drive.py '<json list of actions>' actions: ["s", text] send, ["w", secs] wait, ["d", label] dump screen
acts = json.loads(sys.argv[1])
cols, rows = 160, 45
screen = pyte.Screen(cols, rows); stream = pyte.ByteStream(screen)
pid, fd = pty.fork()
if pid == 0:
os.environ['TERM'] = 'xterm-256color'
os.environ['COLUMNS'] = str(cols); os.environ['LINES'] = str(rows)
os.execvp('rainfrog', ['rainfrog', '--url', 'sqlite:///home/sbx/work/test.db'])
import fcntl, termios, struct
fcntl.ioctl(fd, termios.TIOCSWINSZ, struct.pack('HHHH', rows, cols, 0, 0))
def pump(t):
end = time.time() + t
while time.time() < end:
r, _, _ = select.select([fd], [], [], 0.05)
if r:
try: data = os.read(fd, 65536)
except OSError: return
stream.feed(data)
# answer cursor position queries
if b'\x1b[6n' in data: os.write(fd, b'\x1b[1;1R')
pump(3)
for a in acts:
if a[0] == 's': os.write(fd, a[1].encode()); pump(0.6)
elif a[0] == 'w': pump(a[1])
elif a[0] == 'd':
print('===== SCREEN:', a[1], '=====')
for line in screen.display:
if line.strip(): print(line.rstrip())
os.write(fd, b'\x03'); pump(1)
try: os.kill(pid, 9)
except Exception: pass
EOFpython3 - <<'EOF'
p='/home/sbx/work/drive.py'; s=open(p).read()
s=s.replace("if line.strip(): print(line.rstrip())","t=' '.join(line.translate(str.maketrans('','','│█─┌┐└┘▀↑↓←→')).split())\n if t: print(t)")
open(p,'w').write(s)
EOF
python3 /home/sbx/work/drive.py '[["d","start"]]'python3 drive.py '[["s","\u000b"],["s","j"],["s","k"],["s","G"],["s","\r"],["w",2],["d","after G + Enter on users"]]'確認能用
rainfrog --version輸出應包含「rainfrog 0.4.7」。
先試試這個
pip install --user pyte && python3 - <<'EOF'
import sqlite3
c=sqlite3.connect('/home/sbx/work/test.db')
c.executescript("""
create table users(id integer primary key, name text, email text);
insert into users values (1,'alice','alice@example.com'),(2,'bob','bob@example.com'),(3,'carol','carol@example.com');
create table orders(id integer primary key, user_id integer, item text);
insert into orders values (1,1,'frogspawn'),(2,2,'lilypad');
""")
c.commit()
EOF
cat > /home/sbx/work/drive.py <<'EOF'
import os, pty, sys, time, json, select, pyte
# usage: drive.py '<json list of actions>' actions: ["s", text] send, ["w", secs] wait, ["d", label] dump screen
acts = json.loads(sys.argv[1])
cols, rows = 160, 45
screen = pyte.Screen(cols, rows); stream = pyte.ByteStream(screen)
pid, fd = pty.fork()
if pid == 0:
os.environ['TERM'] = 'xterm-256color'
os.environ['COLUMNS'] = str(cols); os.environ['LINES'] = str(rows)
os.execvp('rainfrog', ['rainfrog', '--url', 'sqlite:///home/sbx/work/test.db'])
import fcntl, termios, struct
fcntl.ioctl(fd, termios.TIOCSWINSZ, struct.pack('HHHH', rows, cols, 0, 0))
def pump(t):
end = time.time() + t
while time.time() < end:
r, _, _ = select.select([fd], [], [], 0.05)
if r:
try: data = os.read(fd, 65536)
except OSError: return
stream.feed(data)
# answer cursor position queries
if b'\x1b[6n' in data: os.write(fd, b'\x1b[1;1R')
pump(3)
for a in acts:
if a[0] == 's': os.write(fd, a[1].encode()); pump(0.6)
elif a[0] == 'w': pump(a[1])
elif a[0] == 'd':
print('===== SCREEN:', a[1], '=====')
for line in screen.display:
if line.strip(): print(line.rstrip())
os.write(fd, b'\x03'); pump(1)
try: os.kill(pid, 9)
except Exception: pass
EOFpython3 - <<'EOF'
p='/home/sbx/work/drive.py'; s=open(p).read()
s=s.replace("if line.strip(): print(line.rstrip())","t=' '.join(line.translate(str.maketrans('','','│█─┌┐└┘▀↑↓←→')).split())\n if t: print(t)")
open(p,'w').write(s)
EOF
python3 /home/sbx/work/drive.py '[["d","start"]]'python3 drive.py '[["s","\u000b"],["s","j"],["s","k"],["s","G"],["s","\r"],["w",2],["d","after G + Enter on users"]]'執行 rainfrog --url <database-url>(例如 rainfrog --url sqlite://<file>),開啟查詢編輯器旁的資料表選單。
它能做什麼
- 用 vim 風格按鍵與滑鼠移動已測試
怎麼使用
- 按 Ctrl+k 聚焦資料表清單。
- 用
j與k上下移動,按G跳到最後一個資料表。 - 在資料表上按 Enter 載入資料列預覽。
- 撰寫 SQL 查詢,並從歷史紀錄或我的最愛重複使用已測試
怎麼使用
- 按 Alt+2 開啟查詢編輯器,按
i輸入查詢,再按 Esc 與 F5 執行。 - 按 Alt+f,輸入名稱後按 Enter,將查詢存為我的最愛。
- 按 Alt+4 查看查詢歷史,按 Alt+5 查看我的最愛。
- 按 Alt+2 開啟查詢編輯器,按
- 複製資料、篩選資料表及切換 schema已測試
怎麼使用
- 按 Ctrl+k 聚焦資料表清單。
- 按
/,輸入部分資料表名稱後按 Enter 篩選清單。
- 檢視資料表的欄位與索引等詳細資訊已測試
怎麼使用
- 按 Ctrl+k,在清單中選取資料表。
- 按
1顯示欄位,按3顯示索引。
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以啟動
- 4 項功能中 4 項可用
- 可離線使用
macOS 和 Windows:專案說支援,但 pickfit 還沒試過。
適合用來
- 在終端機瀏覽 Postgres 資料庫的 schema 並預覽資料表
- 將查詢結果匯出為 CSV
- 將常用 SQL 查詢存為我的最愛
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月15日
- 版本 0.4.7-2c7b5e6
測試機器遇到的差異
- README: curl -LSsf .../install.sh | bash (needs jq and fzf)
測試中: 沒有 jq 與 fzf,且腳本以 fzf 互動選擇執行檔,無法無人值守執行;改用 README 的「release page binaries」途徑(下載 x86_64-unknown-linux-gnu tarball、檢查 sha256、解壓、連結至 ~/.local/bin) - README: script needs jq and fzf installed to run
測試中: 腳本的 need_cmd 在缺少指令時只印出警告並繼續,沒有 jq 或 fzf 的使用者之後會遇到難以理解的錯誤 - README: terminal UI usage
測試中: 非互動測試需要 pty 驅動程式(python pty + pyte,pip install --user pyte)來送出按鍵並繪製畫面