TÀI LIỆU HƯỚNG DẪN & BẢO MẬT KỸ THUẬT

Hướng dẫn Wizard 2 phút — và chi tiết Bảo mật kỹ thuật.

Hướng dẫn cài trợ lý AI bảo mật tại máy và nối Google Gemini miễn phí trong 2 phút, kèm thông số SHA-256, Windows DPAPI và Spend Cap.

Tải & cài trên Windows với 7 ngày dùng thử miễn phí

Bắt đầu 01 · 1 phút

Runassi chạy trực tiếp trên Windows 10 / 11 (64-bit), không yêu cầu thuê máy chủ hay cài công cụ dòng lệnh.

  1. 01Tải bộ cài Runassi-Setup-1.0.0-early-access-x64.exe tại trang Tải về (/vi/download).
  2. 02Mở file cài đặt như phần mềm thông thường và chọn thư mục làm việc trên máy của bạn.
  3. 03Đăng nhập để kích hoạt ngay 7 ngày dùng thử miễn phí — không cần thẻ ngân hàng.

Wizard nối AI 2 phút (Google Gemini Free Tier hoặc API riêng)

Bắt đầu 02 · 0đ API

Ngay lần mở đầu tiên, ứng dụng hướng dẫn bạn nối thẳng khóa Google Gemini miễn phí (0đ API) chỉ trong 2 phút.

  1. 01Bấm "Nối Google Gemini miễn phí (2 phút)" ngay trên màn hình chào — không cần thẻ thanh toán.
  2. 02Nếu muốn dùng Anthropic Claude hoặc OpenAI: dán API key bất kỳ lúc nào và bật cảnh báo + trần Spend Cap.
  3. 03Khóa được niêm phong cục bộ trong Windows DPAPI Vault, không đi qua server trung gian.

Giọng nói, file tại máy & xuất Word / Excel

Bắt đầu 03 · Thao tác

Chọn 1 trong 5 việc làm sẵn, kéo thả file PDF/bảng giá hoặc bấm micro để giao việc bằng giọng nói.

  1. 01Bấm biểu tượng micro để nói yêu cầu tiếng Việt tự nhiên ngay trên máy.
  2. 02Thả hợp đồng PDF dài, văn bản Word hoặc bảng giá vào cửa sổ Runassi.
  3. 03Xuất thẳng kết quả sang Word (.docx), Excel (.xlsx), PDF hoặc bấm Copy gửi Zalo.

Kiến trúc Local PC (Windows DPAPI, SQLite, 1-Click Backup)

Bảo mật & Kỹ thuật

Chi tiết kỹ thuật bảo mật cho dữ liệu tại máy và khả năng xuất dữ liệu mở hoàn toàn không khóa chặt.

  1. 01Lưu trữ cục bộ: Toàn bộ ghi chú, lịch nhắc và lịch sử tác vụ lưu trong SQLite trên ổ đĩa Windows cùng bộ quy trình hermes_skills.
  2. 02Bảo vệ khóa bí mật: Token phiên và khóa API được mã hóa cục bộ qua Windows DPAPI Vault — không đẩy lên proxy trung gian.
  3. 03Giọng nói tiếng Việt offline: Xử lý nhận diện và đọc giọng nói ngay tại máy thông qua Sherpa STT + Piper TTS.
  4. 04Không khóa chặt (Zero Lock-in): Tích hợp 1-Click Encrypted Backup/Restore để đổi máy Windows và Export toàn bộ sang Markdown (.md) / JSON.

Kiểm chứng toàn vẹn file cài .exe bằng Get-FileHash SHA-256

Kiểm chứng · SHA-256

Người dùng kỹ thuật có thể đối chiếu mã băm SHA-256 bằng PowerShell trước khi chạy bộ cài.

  1. 01Mở PowerShell tại thư mục Downloads sau khi tải xong file .exe.
  2. 02Chạy lệnh Get-FileHash và đối chiếu chuỗi SHA-256 tại trang /vi/download.
PowerShell — Kiểm chứng chữ ký SHA-256 cục bộ
Get-FileHash .\Runassi-Setup-1.0.0-early-access-x64.exe -Algorithm SHA256

Mặc định trần chi tiêu Spend Cap khi dùng API trả phí

Kiểm soát · Spend Cap

Thiết lập sẵn cảnh báo mềm và ngưỡng ngắt cứng Spend Cap giúp bảo vệ hóa đơn hàng tháng tuyệt đối.

  1. 01Khởi đầu miễn phí 0đ với Google Gemini Free Tier, hoặc gắn key trả phí trong Settings.
  2. 02Thiết lập ngưỡng cảnh báo mềm và ngưỡng ngắt cứng Spend Cap theo tháng.
Mẫu cấu hình Spend Cap khuyến nghị
monthly_soft_alert_usd = 2.00
monthly_hard_stop_usd  = 5.00
per_run_token_guard    = 40000

Lộ trình Stage 2: Tùy chọn nối VPS riêng (Setup Cloud) & macOS

Roadmap · Stage 2

Stage 1 chạy 100% trên Windows PC với 0đ VPS. Stage 2 bổ sung tùy chọn chạy 24/7 trên VPS Linux riêng và bản macOS.

  1. 01Stage 2A (1-Click Setup Cloud): Nhập SSH VPS Linux cục bộ trong Settings (xóa mật khẩu khỏi RAM ngay sau khi tạo key riêng).
  2. 02Stage 2A (Đồng bộ hai thư mục chống xung đột): Tách cố định runassi_pc (PC → VPS) và runassi_cloud (VPS → PC), tự giữ bản .local-edit nếu sửa trùng.
  3. 03Stage 2B (Phiên bản macOS): Đóng gói native dùng macOS Keychain thay cho Windows DPAPI.