Sử dụng Hermes như một Thư viện Python

Hãy nghĩ về Hermes như một trợ lý robot thân thiện mà bạn có thể sai khiến bằng mã Python thuần túy — không cần học ngôn ngữ mới hay bấm qua một bảng điều khiển cầu kỳ nào.

“Dùng như một Thư viện” Nghĩa là Gì?

Thông thường, bạn trò chuyện với Hermes qua cửa sổ chat. Nhưng khi dùng nó như một thư viện Python, bạn viết các tập lệnh Python để bảo Hermes làm việc gì đó. Điều này hoàn hảo để tự động hóa các tác vụ lặp đi lặp lại như sửa code, chạy kiểm thử, hay dọn dẹp file.

Lệnh Đầu Tiên Của Bạn: Tìm Kiếm và Vá Lỗi

Giả sử bạn có một dự án lớn với các lệnh gọi API cũ cần cập nhật. Thay vì mở từng file một cách thủ công, bạn có thể viết một tập lệnh để tìm và sửa tất cả chúng:

# Find all Python files using deprecated API and fix them
matches = search_files("old_api_call", path="src/", file_glob="*.py")
fixed = 0
for match in matches.get("matches", []):
    result = patch(
        path=match["path"],
        old_string="old_api_call(",
        new_string="new_api_call(",
        replace_all=True
    )
    if "error" not in str(result):
        fixed += 1

print(f"Fixed {fixed} files out of {len(matches.get('matches', []))} matches")

Điều gì xảy ra ở đây: Hermes tìm kiếm mọi file .py trong thư mục src/, tìm thấy old_api_call(, và thay thế nó bằng new_api_call(. Bạn vừa tự cứu mình khỏi hàng giờ làm việc thủ công.

Chạy Kiểm Thử và Nhận Báo Cáo

Muốn biết code của bạn có thực sự hoạt động không? Bạn có thể chạy bộ kiểm thử của mình và nhận một bản tóm tắt gọn gàng:

from hermes_tools import terminal, read_file
import json

# Run tests, parse results, and report
result = terminal("cd /project && python -m pytest --tb=short -q 2>&1", timeout=120)
output = result.get("output", "")

# Parse test output
passed = output.count(" passed")
failed = output.count(" failed")
errors = output.count(" error")

report = {
    "passed": passed,
    "failed": failed,
    "errors": errors,
    "exit_code": result.get("exit_code", -1),
    "summary": output[-500:] if len(output) > 500 else output
}

print(json.dumps(report, indent=2))

Tập lệnh này chạy các bài kiểm thử của bạn, đếm xem có bao nhiêu bài thành công hay thất bại, và in ra một báo cáo JSON gọn gàng. Bạn thậm chí có thể tự động gửi báo cáo này qua email cho nhóm của mình.

Hai Cách Chạy Mã Của Bạn

Hermes cung cấp cho bạn hai “chế độ” để chạy tập lệnh:

Chế độ dự án (mặc định): Tập lệnh của bạn chạy trong thư mục dự án, sử dụng cùng môi trường Python bạn đã có. Điều này tốt nhất cho công việc hàng ngày — bạn có thể import pandas hoặc đọc file bằng đường dẫn tương đối như bình thường.
Chế độ nghiêm ngặt: Tập lệnh của bạn chạy trong một thư mục riêng biệt, cách ly với Python của riêng Hermes. Dùng chế độ này khi bạn muốn khả năng tái lập tối đa — như khi bạn chia sẻ tập lệnh với người khác và muốn chắc chắn nó chạy giống nhau ở mọi nơi.

Bạn có thể chuyển đổi chế độ trong file cấu hình của mình:

# ~/.hermes/config.yaml
code_execution:
  mode: project   # or "strict"

An Toàn Là Trên Hết (Ngay Cả Khi Lập Trình)

Đừng lo lắng về bảo mật — Hermes rất cẩn thận. Trong cả hai chế độ, nó:

Loại bỏ các khóa API và mật khẩu khỏi môi trường tập lệnh của bạn
Chặn các tập lệnh gọi đến các công cụ Hermes khác một cách đệ quy
Giới hạn thời gian tập lệnh có thể chạy (tối đa 5 phút) và lượng đầu ra nó có thể in

Tổng Kết và Mẹo Chuyên Nghiệp

Dùng Hermes như một thư viện Python biến những việc vặt tẻ nhạt thành các tập lệnh một dòng. Bắt đầu nhỏ: chọn một tác vụ lặp đi lặp lại (như đổi tên biến hoặc chạy kiểm thử) và tự động hóa nó.

Mẹo thực tế: Luôn kiểm tra tập lệnh của bạn trên một bản sao dự án trước, không phải bản gốc. Bằng cách đó, nếu có sự cố xảy ra, bạn sẽ không làm hỏng bất cứ thứ gì. Khi bạn đã tự tin, hãy chạy nó trên dự án thật. Chúc bạn tự động hóa vui vẻ!