Cập nhật và gỡ cài đặt

Đang cập nhật

Cập nhật lên phiên bản mới nhất chỉ bằng một lệnh:

hermes update

Thao tác này sẽ lấy mã mới nhất, cập nhật các phần phụ thuộc và nhắc bạn định cấu hình mọi tùy chọn mới đã được thêm kể từ lần cập nhật gần đây nhất của bạn.

:::mẹo hermes update tự động phát hiện các tùy chọn cấu hình mới và nhắc bạn thêm chúng. Nếu bỏ qua lời nhắc đó, bạn có thể chạy hermes config check theo cách thủ công để xem các tùy chọn bị thiếu, sau đó hermes config migrate để thêm chúng một cách tương tác. :::

Điều gì xảy ra trong quá trình cập nhật

Khi bạn chạy hermes update, các bước sau sẽ xảy ra:

1. Git pull — lấy mã mới nhất từ ​​nhánh main và cập nhật các mô-đun con
2. Cài đặt phần phụ thuộc — chạy uv pip install -e ".[all]" để nhận các phần phụ thuộc mới hoặc đã thay đổi
3. Di chuyển cấu hình — phát hiện các tùy chọn cấu hình mới được thêm kể từ phiên bản của bạn và nhắc bạn thiết lập chúng
4. Tự động khởi động lại cổng — nếu dịch vụ cổng đang chạy (systemd trên Linux, launchd trên macOS), nó sẽ tự động khởi động lại sau khi cập nhật hoàn tất nên mã mới có hiệu lực ngay lập tức

Sản lượng dự kiến ​​​​có dạng:

$ hermes update
Updating Hermes Agent...
📥 Pulling latest code...
Already up to date.  (or: Updating abc1234..def5678)
📦 Updating dependencies...
✅ Dependencies updated
🔍 Checking for new config options...
✅ Config is up to date  (or: Found 2 new options — running migration...)
🔄 Restarting gateway service...
✅ Gateway restarted
✅ Hermes Agent updated successfully!

Xác thực sau cập nhật được đề xuất

hermes update xử lý đường dẫn cập nhật chính nhưng xác thực nhanh sẽ xác nhận mọi thứ đã được hạ cánh một cách rõ ràng:

1. git status --short — nếu cây bị bẩn bất ngờ, hãy kiểm tra trước khi tiếp tục
2. hermes doctor — kiểm tra cấu hình, các phần phụ thuộc và tình trạng dịch vụ
3. hermes --version — xác nhận phiên bản đã sửa lỗi như mong đợi
4. Nếu bạn sử dụng cổng: hermes gateway status
5. Nếu doctor báo cáo sự cố kiểm tra npm: hãy chạy npm audit fix trong thư mục được gắn cờ

:::cảnh báo Cây làm việc bẩn sau khi cập nhật Nếu git status --short hiển thị những thay đổi không mong muốn sau hermes update, hãy dừng lại và kiểm tra chúng trước khi tiếp tục. Điều này thường có nghĩa là các sửa đổi cục bộ đã được áp dụng lại trên đầu mã đã cập nhật hoặc các tệp khóa được làm mới ở bước phụ thuộc. :::

Kiểm tra phiên bản hiện tại của bạn

hermes version

So sánh với bản phát hành mới nhất tại trang phát hành GitHub hoặc kiểm tra các bản cập nhật có sẵn:

hermes update --check

Cập nhật từ Nền tảng nhắn tin

Bạn cũng có thể cập nhật trực tiếp từ Telegram, Discord, Slack hoặc WhatsApp bằng cách gửi:

/update

Thao tác này sẽ lấy mã mới nhất, cập nhật các phần phụ thuộc và khởi động lại cổng. Bot sẽ ngoại tuyến trong thời gian ngắn khi khởi động lại (thường là 5–15 giây) rồi tiếp tục lại.

Cập nhật thủ công

Nếu bạn cài đặt thủ công (không thông qua trình cài đặt nhanh):

cd /path/to/hermes-agent
export VIRTUAL_ENV="$(pwd)/venv"

# Pull latest code and submodules
git pull origin main
git submodule update --init --recursive

# Reinstall (picks up new dependencies)
uv pip install -e ".[all]"
uv pip install -e "./tinker-atropos"

# Check for new config options
hermes config check
hermes config migrate   # Interactively add any missing options

Hướng dẫn khôi phục

Nếu bản cập nhật gây ra sự cố, bạn có thể quay lại phiên bản trước:

cd /path/to/hermes-agent

# List recent versions
git log --oneline -10

# Roll back to a specific commit
git checkout <commit-hash>
git submodule update --init --recursive
uv pip install -e ".[all]"

# Restart the gateway if running
hermes gateway restart

Để quay lại thẻ phát hành cụ thể:

git checkout v0.6.0
git submodule update --init --recursive
uv pip install -e ".[all]"

:::cảnh báo Việc quay lại có thể gây ra sự không tương thích về cấu hình nếu các tùy chọn mới được thêm vào. Chạy hermes config check sau khi quay lại và xóa mọi tùy chọn không được nhận dạng khỏi config.yaml nếu bạn gặp lỗi. :::

Lưu ý dành cho người dùng Nix

Nếu bạn cài đặt qua Nix, các bản cập nhật sẽ được quản lý thông qua trình quản lý gói Nix:

# Update the flake input
nix flake update hermes-agent

# Or rebuild with the latest
nix profile upgrade hermes-agent

Quá trình cài đặt Nix là bất biến - việc khôi phục được xử lý bởi hệ thống tạo của Nix:

nix profile rollback

Xem Thiết lập Nix để biết thêm chi tiết.

---

Đang gỡ cài đặt

hermes uninstall

Trình gỡ cài đặt cung cấp cho bạn tùy chọn giữ lại các tệp cấu hình (~/.hermes/) để cài đặt lại trong tương lai.

Gỡ cài đặt thủ công

rm -f ~/.local/bin/hermes
rm -rf /path/to/hermes-agent
rm -rf ~/.hermes            # Optional — keep if you plan to reinstall

:::thông tin Nếu bạn đã cài đặt cổng làm dịch vụ hệ thống, trước tiên hãy dừng và tắt cổng này:

hermes gateway stop
# Linux: systemctl --user disable hermes-gateway
# macOS: launchctl remove ai.hermes.gateway

:::