Tệp cấu hình và thông tin đăng nhập
Vị trí và vai trò của thư mục ~/.dsh, tệp .credentials.yaml, phiên đã lưu, trạng thái daemon và tuỳ chọn giao diện ~/.rexapf của RexAPF CLI.
Trên trang này
RexAPF CLI lưu dữ liệu ở hai thư mục trong thư mục home: ~/.dsh cho thông tin đăng nhập, phiên và daemon (dùng chung với RexAPF Desktop), và ~/.rexapf cho tuỳ chọn của giao diện tương tác. Bài này giúp bạn biết tệp nào nằm ở đâu và khi nào nên đụng tới.
Thư mục dữ liệu ~/.dsh
Mặc định là ~/.dsh. Đặt biến môi trường DSH_HOME để dùng thư mục khác; giá trị rỗng hoặc chỉ có khoảng trắng bị bỏ qua.
| Đường dẫn | Nội dung |
|---|---|
~/.dsh/.credentials.yaml | Thông tin đăng nhập tài khoản và khoá suy luận |
~/.dsh/sessions/ | Phiên làm việc đã lưu (dùng cho /resume và --session-id) |
~/.dsh/remote/ | Trạng thái điều khiển từ Web: daemon.json, pin.json, status.json, daemon.log |
~/.dsh/logs/ | Báo cáo lỗi khởi động startup-<thời-gian>-<uuid>.log |
~/.dsh/AGENTS.md | Chỉ dẫn chung cho tác tử ở mọi dự án (nếu bạn tạo) |
~/.dsh/.env | Biến môi trường bổ sung (tuỳ chọn) |
~/.dsh/cordis.patch.yml | Lớp cấu hình nâng cao áp dụng cho mọi profile (tuỳ chọn) |
Khi rexapf không khởi động được, thông báo lỗi in kèm thư mục dữ liệu và phiên bản đang dùng.
Tệp .credentials.yaml
rexapf login ghi hai thứ vào ~/.dsh/.credentials.yaml:
- Bản ghi thiết bị của tài khoản (mã thiết bị, hạn dùng, thông tin người dùng).
- Khoá suy luận dưới tên
REXLLM_API_KEY, dùng cho mọi yêu cầu tới mô hình.
RexAPF Desktop đọc cùng tệp này, nên đăng nhập hay đăng xuất ở một nơi áp dụng cho cả hai.
Tệp được tạo với quyền chỉ chủ sở hữu đọc được. Trên macOS và Linux, nếu người dùng khác đọc được tệp, CLI từ chối nạp và yêu cầu chạy chmod 600. Không commit tệp này vào git và không chia sẻ nội dung. Các lệnh shell của tác tử chạy dưới quyền của bạn, nên quyền tệp không ngăn được tác tử đọc nó.
Thứ tự lấy khoá
Khoá được tìm theo thứ tự, nơi đầu tiên có giá trị sẽ thắng:
- Biến môi trường lúc chạy lệnh (ví dụ
REXLLM_API_KEY=… rexapf …). - Tệp
~/.dsh/.credentials.yaml. - Tệp
.envtrong thư mục bạn chạy lệnh. - Tệp
~/.dsh/.env.
Biến môi trường được đặt lúc chạy là chỉ đọc với CLI; muốn đổi, xoá biến đó khỏi shell.
Đặt lại đăng nhập
Đăng xuất
bash$ rexapf logoutLệnh xoá bản ghi và khoá trên máy, rồi thu hồi thiết bị ở nền.
Đăng nhập lại
bash$ rexapf loginKiểm tra
bash$ rexapf whoami
Tránh sửa tay tệp .credentials.yaml. Nếu tệp không đọc được (YAML sai, khoá lạ, quyền quá rộng), CLI báo lỗi khi khởi động.
$ ls -A ~/.dsh .credentials.yaml logs remote sessions ... $ ls ~/.dsh/remote daemon.json daemon.log pin.json status.json
Phiên đã lưu
Mỗi phiên được ghi dạng JSONL trong ~/.dsh/sessions/. Đây cũng là nơi lưu phiên của RexAPF Desktop, nên bạn có thể thấy phiên của cả hai. Phiên được nhận diện bằng id dạng session-<uuid>:
- Mở lại trong giao diện tương tác:
/resumehoặcrexapf --session-id <id>. - Giao tiếp việc một lần:
rexapf --session-id <id> "…".
Tác tử tìm được các phiên cũ có cùng thư mục làm việc qua công cụ tìm lịch sử hội thoại; việc tìm chỉ diễn ra trên máy, không gồm lịch sử RexAPF Web. Khái niệm phiên và workspace có ở Workspace & phiên.
Trạng thái điều khiển từ Web
Thư mục ~/.dsh/remote/ (quyền 0700) do rexapf connect, rexapf remote … và daemon cùng dùng:
| Tệp | Nội dung |
|---|---|
daemon.json | Đồng ý chia sẻ, tên máy, workspace đã đăng ký, trình duyệt đã ghép, chính sách truy cập |
pin.json | Mã PIN đang mở |
status.json | Trạng thái trực tiếp cho rexapf remote status |
daemon.log | Log daemon khi không chạy bằng systemd |
Hãy thay đổi các tệp này qua lệnh, ví dụ rexapf remote workspace add, thay vì sửa tay. Daemon tự đọc lại thay đổi sau vài giây. Xem rexapf connect & mã PIN.
Tuỳ chọn giao diện ~/.rexapf
Giao diện tương tác lưu tuỳ chọn và lịch sử nhập trong ~/.rexapf, tách biệt với các cài đặt dsh-TUI gốc nếu có.
| Tệp | Lưu gì |
|---|---|
model.json | Mô hình chọn bằng /model |
theme.json, themes/<tên>.json | Giao diện màu đang chọn và giao diện tuỳ chỉnh |
lang.json | Ngôn ngữ chọn bằng /lang |
agent-preset.json | Preset tác tử chọn bằng /preset |
working-activity.json | Kiểu chỉ báo trạng thái làm việc |
onboarding.json | Trạng thái hướng dẫn ban đầu |
history.jsonl | Lịch sử ô nhập (dùng cho ↑/↓ và Ctrl + R) |
extension-grants.json | Quyền cấp cho plugin giao diện |
history.jsonl chứa nguyên văn những gì bạn đã gõ, kể cả nội dung dán vào. Xoá tệp này nếu bạn lỡ dán thông tin bí mật vào ô nhập. Sau khi sửa tay một tệp tuỳ chọn, chạy /reload để áp dụng ngay.