使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 4 個已知的高風險或嚴重漏洞(OSV.dev,2026年11月3日),安裝前請先考慮。
npm:undici 6.29.0undici 因 Agent 中遺失 tls 選項而容易受到 TLS 憑證驗證繞過影響 (GHSA-2m5v-pch6-74hx,高風險,6.29.1 已修正)npm:zod 4.4.3Zod 在驗證過大的受限集合時可能耗盡記憶體 (GHSA-mrhx-c7xc-m3w5,高風險,4.6.6 已修正)
再看 2 個
npm:undici 6.29.0— GHSA-qrxm-fqhp-jwvm(高風險),6.29.1 已修正npm:undici 6.29.0— GHSA-xjj6-f33q-929c(高風險),6.29.1 已修正
Linux x86_64
需要先準備
- 執行環境:
Node.js 22.19+
透過 npm 全域安裝 martty
npm install --global martty
確認能用
which martty-cli; ls -la ~/.local/bin/martty* ; martty-cli --help輸出應包含「martty — terminal-native ACP client UI」。
先試試這個
martty-cli --dump-frame在終端機執行 martty 開啟介面,會出現詢問你想建構什麼的提示。
Windows x86_64
需要先準備
- 執行環境:
Node.js 22.19+
npm install --global martty
npm install --global martty
README 與實測不符之處
- README 寫: npm install --global martty then martty --demo
實際可行: 套件只安裝 martty-cli 執行檔;首次透過 martty-cli 啟動會建立 martty shim——但在此工作階段多次執行 martty-cli 後仍找不到 martty 指令
確認能用
$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User'); martty-cli --version輸出應包含「martty 0.3.3」。
先試試這個
$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User'); martty-cli harness list 2>&1在終端機執行 martty 開啟介面,會出現詢問你想建構什麼的提示。
它能做什麼
- 在終端機查看代理工作過程沒有看到它可用
- 連接 DSH 與其他 ACP 代理沒有看到它可用
- 排入訊息並引導代理未測試
- 以 Cordis 外掛組成介面未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以啟動
- 4 項功能中 1 項可用
- 可離線使用
Windows x86_64
- 可以安裝
- 可以啟動
- 4 項功能中 0 項可用
- 可離線使用
其他系統
macOS:專案說支援,但 pickfit 還沒試過。
適合用來
- 在終端機中檢視串流 agent 回覆、推理過程與工具呼叫
- 選擇模型與 agent 預設集
- 切換 harness 並開始新工作階段
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月30日
- 版本 0.3.3
測試機器遇到的差異
- README: npm install --global martty then run martty
測試中: 全域安裝只提供 martty-cli;martty shim 會在首次執行 martty-cli 時自動建立 - README: martty --demo and martty --demo-skin to see the UI
測試中: headless 沙箱沒有 TTY 可執行互動式 TUI;martty --dump-frame(及 --dump-frame --demo-skin)會以文字繪製一個示範畫面並以 0 結束
Windows x86_64
主要功能可用
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月31日
- 版本 0.3.3
測試機器遇到的差異
- README: martty --dump-frame renders one frame
測試中: martty-cli --dump-frame 確實會繪製畫面(工具呼叫、思考、輸入框),但隨後出現錯誤:martty exited before connecting (code=0),結束代碼為 1 - README: (Windows steps)
測試中: pickfit 以一般使用者身分在 PowerShell 7(pwsh 7.6.9)中執行這些步驟;內建的 Windows PowerShell 5.1 未經驗證,且不支援 `&&`。 - README: (Windows steps)
測試中: 在 Windows 上,安裝後請開啟新的終端機,讓 PATH 包含此工具;沙箱則是在同一工作階段中重新整理 PATH。