Tham khảo

Tệp và biến môi trường

Nơi Ferret lưu các tệp của chính nó, và các biến môi trường mà Ferret đọc hoặc đặt.

#Thư mục userData

Dữ liệu ứng dụng nằm trong thư mục userData của Electron. Tên thư mục được cố định là ade-movie (không phải tên sản phẩm), nên dữ liệu vẫn còn khi sản phẩm đổi tên. Có thể ghi đè bằng --user-data-dir=<path>.

Hệ điều hành	Đường dẫn
macOS	`~/Library/Application Support/ade-movie/`
Windows	`%APPDATA%\ade-movie\`
Linux	`~/.config/ade-movie/` (hoặc `$XDG_CONFIG_HOME/ade-movie/`)

settings.json       # settings before 0.1.1, kept as a backup (now ~/.ferret/settings.json)
stt-keys.bin        # API keys, encrypted with safeStorage
models/             # downloaded whisper models (ggml-*.bin)
accounts/claude/<id>/   # CLAUDE_CONFIG_DIR for added accounts
accounts/codex/<id>/    # CODEX_HOME for added accounts

Cài đặt của bạn không nằm trong thư mục này mà ở ~/.ferret/ (xem Cấu hình bằng settings.json).

Model bạn tự chọn có thể nằm ở bất kỳ đâu. Vị trí mặc định cũ ~/.cache/ade-movie/models/ggml-small.bin vẫn được kiểm tra.

#Biến môi trường

Biến	Tác dụng
`CLAUDE_CONFIG_DIR`, `CODEX_HOME`	Ferret đặt cho các tab agent khi chọn một tài khoản đã thêm
`GH_TOKEN`, `GITHUB_TOKEN`	`gh` dùng biến này trước thông tin đăng nhập của chính nó. Ferret cảnh báo khi một trong hai biến được đặt
`FERRET_CONFIG_DIR` (hoặc tên cũ `MOVIE_ADE_CONFIG_DIR`)	Thư mục chứa `settings.json`, `state.json` và `settings.schema.json` thay cho `~/.ferret`
Các tên trong `apiKeyEnv`	API key mà bạn trỏ tới từ `settings.json`. Cũng được đọc từ `.env` của dự án và `~/.ferret/.env`
`ADE_PROJECT_DIR`	Mở (và đăng ký) thư mục này làm dự án khi khởi động
`ADE_INITIAL_URL`	Tải URL này trong trình duyệt tích hợp khi khởi động
`ADE_WHISPER_MODEL`	Đường dẫn tuyệt đối của model GGML dùng cho chuyển văn bản trên máy, thay cho model mặc định đã tải
`FERRET_SENTRY_DSN` (hoặc tên cũ `MOVIE_ADE_SENTRY_DSN`)	Nơi gửi báo cáo crash. Để trống nghĩa là không gửi gì (xem Báo cáo crash)
`OPENAI_API_KEY`	Chỉ được đọc từ `.env` khi phát triển (`pnpm dev`), không bao giờ trong bản đóng gói
`PATH`	Dùng để tìm lệnh của các agent (`claude`, `codex`, `gemini`…), `gh`, `git`, `whisper-cli`. Trên macOS và Linux, các vị trí của Homebrew, linuxbrew và snap được thêm vào

#Bên trong dự án của bạn

.ferret/reviews/<id>/: các review (xem Dữ liệu và quyền riêng tư). Các review cũ trong .ade-movie/reviews/ vẫn được đọc
.git/info/exclude: một dòng .ferret/, được thêm ở lần ghi đầu tiên

Giúp dịch trang này trên GitHub (mở trong tab mới)