Hướng dẫn sử dụng
SpinxAI Client.

Giới thiệu

SpinxAI 0.7 là ứng dụng desktop giúp bạn giao việc cho trợ lý AI, theo dõi tiến độ và dùng ngay kết quả — mọi dữ liệu công việc nằm trên máy bạn. Tài liệu này mô tả những gì đã dùng được hôm nay và những gì đang trong kế hoạch, để bạn biết trước nên kỳ vọng điều gì.

SpinxAI phù hợp với nhân viên văn phòng, người làm nghiên cứu, chăm sóc khách hàng và chủ doanh nghiệp nhỏ muốn tự động hóa việc lặp lại mà không cần lập trình.

Bạn có thể làm gì với SpinxAI:

• Trò chuyện nhiều lượt với AI, hỏi tiếp và chỉnh yêu cầu.
• Giao việc từ tài liệu PDF, Word, Excel, PowerPoint và nhận kết quả xuất ra Word, Excel, HTML, Markdown.
• Tạo trợ lý AI theo vai trò, với hướng dẫn và quyền riêng.
• Lập lịch chạy tự động theo ngày, tuần hoặc một lần.
• Để AI thao tác trình duyệt (đọc trang, điền biểu mẫu, tải tệp) dưới sự giám sát của bạn.
• Giao việc qua Telegram, Zalo cá nhân, Discord.
• Nói chuyện bằng giọng nói (Live Voice), cả trên máy lẫn qua đám mây.
• Cài thêm kỹ năng (skill) từ Thư viện SpinxAI.

Nhãn trạng thái dùng trong tài liệu:

Lộ trình là định hướng, chưa phải cam kết ngày phát hành.

Cài đặt và yêu cầu hệ thống

Bản 0.7.0 có bộ cài cho bốn nền tảng. Tải bản đúng máy của bạn từ trang chủ SpinxAI.

Cần chuẩn bị:

• Một dịch vụ AI tương thích OpenAI Chat Completions (có sẵn mẫu cho OpenAI, OpenRouter, Ollama/LM Studio; dịch vụ khác nhập tay): địa chỉ base URL, tên model và API key. Muốn AI dùng công cụ (đọc tài liệu, trình duyệt…), model phải hỗ trợ function calling.
• Không có API key vẫn thử được bằng chế độ trải nghiệm không dùng AI.
• Google Chrome hoặc Microsoft Edge nếu muốn dùng tự động hóa trình duyệt.
• Tài khoản Google nếu muốn cài kỹ năng từ Thư viện.

Dữ liệu của bạn nằm ở đâu: công việc, tài liệu đã chọn và kết quả được lưu trong thư mục dữ liệu ứng dụng trên máy, dưới quyền tài khoản hệ điều hành. Dữ liệu chưa được mã hóa ở mức ứng dụng. API key chỉ nằm trong két bảo mật của hệ điều hành (Keychain, Credential Manager, Secret Service) nếu bạn chọn nhớ khóa.

Bắt đầu nhanh

Lần mở đầu tiên, SpinxAI tự mở hướng dẫn 6 bước; xong trong vài phút là bạn giao được việc đầu tiên.

1. Chọn nhu cầu — chọn nhóm công việc gần với bạn nhất. SpinxAI dùng lựa chọn này để đặt người đọc mặc định cho kết quả.
2. Kiểm tra máy — app kiểm tra các thành phần cần thiết. Nếu có mục lỗi, mở Gateway → Chẩn đoán để xem chi tiết.
3. Kết nối AI — chọn mẫu OpenAI, OpenRouter, Ollama/LM Studio hoặc Dịch vụ khác. Nhập địa chỉ, API key, bấm Kiểm tra kết nối để lấy danh sách model, chọn model rồi Lưu kết nối. Chưa có key thì chọn Thử cục bộ.
4. AI trên máy (tùy chọn, macOS Apple Silicon) — app gợi ý model vừa RAM; bấm Tải về để tải nền, có thể Dừng tải.
5. Không gian & tiện ích — đặt tên không gian, chủ đề sáng/tối, cỡ chữ; chọn quyền công cụ cho Trợ lý cá nhân; bật Chrome Extension hoặc Live Voice nếu cần.
6. Xem lại & bắt đầu — kiểm tra tóm tắt (gồm nơi lưu key), có thể thử với tài liệu mẫu, rồi bấm bắt đầu.

Bấm Để sau ở bất kỳ bước nào; mở lại từ Cài đặt → Chung → Mở hướng dẫn bắt đầu.

Giao việc đầu tiên: vào Không gian làm việc, gõ yêu cầu, ví dụ “Lập kế hoạch công việc tuần này”, thêm tài liệu nếu có, rồi bấm Bắt đầu công việc. Khi có kết quả, hỏi tiếp ngay trong hội thoại: “rút gọn thành 5 việc”. Mọi việc đã giao nằm trong mục Công việc.

Lưu ý về chi phí và dữ liệu: ở chế độ AI, yêu cầu, lịch sử hội thoại và tài liệu đã chọn được gửi tới dịch vụ AI bạn cấu hình và có thể phát sinh phí ở dịch vụ đó. Chế độ trải nghiệm không gửi gì ra mạng và ghi rõ kết quả chưa được AI phân tích.

Các tính năng hiện có

Mỗi mục dưới đây nêu cách dùng và giới hạn hiện tại. Tên màn hình viết đậm là mục trên thanh bên trái.

1. Giao việc và trò chuyệnĐã có

• Gõ yêu cầu ở Không gian làm việc, có hoặc không kèm tài liệu. Hoặc chọn một trong các mẫu công việc có sẵn.
• Hỏi tiếp nhiều lượt trong cùng hội thoại; bấm Dừng lượt này để hủy lượt đang chạy; chạy lại lượt cuối nếu bị lỗi.
• Khi AI cần hỏi bạn hoặc xin duyệt một công cụ, thẻ phản hồi hiện ngay trong hội thoại.
• Giới hạn: tối đa 50 lượt/hội thoại; quá giới hạn thì tạo hội thoại mới. Chưa sửa được tin đã gửi và chưa gửi nhiều tin xếp hàng khi AI đang chạy.

2. Công việc và kết quảĐã có

• Công việc gom mỗi hội thoại thành một mục, kèm kết quả mới nhất và các kết quả trước.
• Bộ lọc: Tất cả, Cần bạn (chờ trả lời, chờ duyệt, lỗi), Đang làm, Có kết quả, Đã lưu trữ. Tìm kiếm không cần gõ dấu.
• Sửa kết quả trực tiếp; mỗi lần lưu tạo phiên bản mới, xem và khôi phục được bản cũ.
• Xuất kết quả ra Word, Excel, HTML, Markdown. Khi xuất Excel, mỗi bảng thành một sheet.
• Giới hạn: chưa xuất PDF/PowerPoint từ màn hình kết quả.

Xem ảnh đầy đủ

3. Tài liệu đầu vàoĐã có

• Nhận PDF có lớp văn bản, DOCX, XLSX, PPTX, TXT, MD, CSV (UTF-8). Xem trước nội dung trích xuất kèm số trang/sheet/slide trước khi giao việc.
• Giới hạn: tối đa 10 tệp/việc, 4 MB/tệp gốc, 6 MB văn bản tổng. Chưa đọc PDF scan (chưa có OCR) và ảnh.

4. Kết nối AIĐã có

• Kết nối AI → Thêm kết nối: đặt tên, nhập địa chỉ API, model, key. Kiểm tra kết nối chỉ đọc danh sách model, không gửi tài liệu.
• Bật Nhớ API key trong kho bảo mật để không phải nhập lại sau khi mở lại app.
• Lưu nhiều hồ sơ (tối đa 50) và chuyển bằng Dùng kết nối này. Quên API key xóa key khỏi máy.
• Giới hạn: chỉ hỗ trợ giao thức tương thích OpenAI Chat Completions; chưa đăng nhập bằng tài khoản (OAuth). Mỗi lượt chạy tối đa 15 phút.

5. Trợ lý AIĐã có

• Trợ lý AI → Tạo trợ lý: chọn mẫu vai trò (văn phòng, nghiên cứu tài liệu, chăm sóc khách hàng) hoặc tự viết hướng dẫn; đặt avatar; thử trước khi lưu.
• Chọn kết nối và model riêng cho từng trợ lý, kèm model dự phòng khi dịch vụ chính quá tải.
• Gắn kỹ năng, tài liệu mặc định và quyền công cụ (được giải thích bằng ngôn ngữ thường).
• Thư mục & an toàn: cấp quyền đọc hoặc đọc/ghi một thư mục trên máy; mỗi lần đọc/ghi vẫn hỏi bạn. Có thể bật Chạy mã trong container riêng (Docker hoặc Podman) để AI chạy Node.js/Python tách biệt, không mạng.
• Chuyển trợ lý sang máy khác bằng tệp .spinx-agent hoặc gửi trực tiếp qua mạng LAN/VPN. API key, quyền thư mục và phiên kênh không đi theo; bản nhập ở trạng thái tạm dừng chờ bạn rà soát.

Xem ảnh đầy đủ

6. Nguồn kiến thứcMột phần

• Lưu tài liệu dùng chung theo bộ sưu tập, tìm theo tên/nội dung không dấu, chọn khi giao việc hoặc lập lịch.
• Giới hạn: chưa tìm theo ngữ nghĩa, AI chưa tự truy tìm tài liệu liên quan, chưa đồng bộ từ thư mục hoặc web. Chưa có bộ nhớ dài hạn.

7. Lịch tự độngĐã có

• Lịch tự động → Tạo lịch mới: chọn trợ lý, mô tả, tài liệu và thời điểm (một lần, hằng ngày, hằng tuần, theo khoảng thời gian, có múi giờ). Chạy ngay để thử.
• Bật/tắt, bỏ qua hoặc chạy bù một lần; lịch sử và kết quả được giữ cả khi xóa lịch.
• Lưu ý quan trọng: lịch chỉ chạy khi SpinxAI đang mở. Tài liệu là bản chụp tại lúc tạo lịch, không tự cập nhật theo tệp gốc.

8. Trình duyệt tự độngĐã có

• AI mở phiên Chrome/Edge riêng (tách khỏi hồ sơ cá nhân), đọc trang kể cả iframe, điền biểu mẫu, bấm, chọn mục, tải tệp lên/xuống.
• Theo dõi ở mục Trình duyệt, bấm Xem trực tiếp để thấy ảnh trang cập nhật; tiếp quản bất cứ lúc nào (ví dụ để tự đăng nhập).
• Hồ sơ đăng nhập: tạo hồ sơ riêng để giữ đăng nhập website giữa các lần mở.
• Hộp thoại confirm/prompt của website hiện ngay trong SpinxAI để bạn trả lời; cấp/thu hồi quyền thông báo theo từng website.
• Giới hạn: chưa điều khiển tab Chrome cá nhân của bạn; chưa tự mở khóa hồ sơ nếu app tắt đột ngột.

Xem ảnh đầy đủ

9. Chrome Companion (tiện ích mở rộng)Đã có

• Gửi nội dung trang đang đọc (hoặc đoạn đã bôi đen) từ Chrome thành công việc chờ duyệt trong SpinxAI.
• Cài: Cài đặt → Chrome Extension → Xuất gói, giải nén, mở chrome://extensions, bật Developer mode, chọn Load unpacked. Sau đó tạo mã ghép nối trong SpinxAI và dán vào Tùy chọn của extension.
• Giới hạn: chưa có trên Chrome Web Store; phải ghép nối lại mỗi khi mở lại SpinxAI hoặc Chrome.

10. Kênh giao tiếp: Telegram, Zalo, DiscordMột phần

• Kênh giao tiếp → Thêm kênh: nhập token bot Telegram/Discord hoặc quét QR Zalo cá nhân; gắn một trợ lý cho kênh.
• Người lạ nhắn tin sẽ nhận mã ghép nối 6 ký tự; bạn duyệt ở tab Ghép nối. Trong nhóm, bot chỉ trả lời khi được @nhắc tên (mặc định tắt).
• Chỉ chủ máy được dùng công cụ của trợ lý; người khác chỉ trò chuyện. Gửi được tệp PDF/DOCX/XLSX/PPTX/TXT/MD/CSV tối đa 4 MB.
• Giới hạn: kênh chỉ chạy khi SpinxAI đang mở; chưa nhận ảnh/âm thanh; trả lời là văn bản, chưa gửi tệp kết quả. Zalo cá nhân dùng API không chính thức nên tài khoản có thể bị hạn chế — nên dùng tài khoản phụ. Ba kênh đang được nghiệm thu với tài khoản thật.

11. Live VoiceĐã có

• Nói chuyện hai chiều với AI, ngắt lời được, xem transcript. Mở bằng nút Live Voice trên đầu trang; thiết lập ở Cài đặt → Giọng nói.
• Cục bộ: nhận dạng giọng nói Whisper và giọng đọc tiếng Việt VieNeu chạy trên máy, không cần key voice riêng. Không có trên macOS Intel.
• Đám mây: OpenAI Realtime hoặc xAI Grok Voice, cần API key riêng có quyền realtime (key chỉ giữ trong RAM).

12. AI trên máy (offline)Thử nghiệm

• Chỉ trên macOS Apple Silicon. Cài đặt → AI trên máy: tải và nạp Gemma hoặc Qwen, rồi chọn ở Model cho lượt này khi trò chuyện. Không cần API key, không gửi dữ liệu ra ngoài.
• App kiểm tra RAM trước khi nạp và báo nếu không đủ. Model phải nạp lại sau mỗi lần mở app. Chất lượng thấp hơn model đám mây, phù hợp việc đơn giản.

13. Thư viện kỹ năngĐã có

• Kỹ năng & mở rộng → Khám phá: đăng nhập Google, xem chi tiết và quyền, cài kỹ năng đã ký số. Giai đoạn này các kỹ năng miễn phí.
• Chọn kỹ năng khi giao việc; kỹ năng luôn qua bước xác nhận quyền trước khi chạy. Mỗi lượt dùng một kỹ năng.

Xem ảnh đầy đủ

14. Thông báo, cài đặt và sao lưuĐã có

• Hộp thông báo: việc chờ bạn, kết quả mới, lỗi, lịch bị bỏ qua. Chưa có thông báo hệ điều hành.
• Cài đặt: tên không gian, màn hình mở đầu, chủ đề sáng/tối, cỡ chữ lớn, giảm chuyển động.
• Cài đặt → Dữ liệu & sao lưu: xuất bản sao JSON (không chứa key); khôi phục bằng cách thêm vào, không ghi đè. Lịch nhập vào được tắt và quyền công cụ hạ về chỉ đọc để an toàn. Tệp sao lưu chưa mã hóa, tối đa 8 MB.
• Gateway → Chẩn đoán: xem trạng thái và xuất báo cáo JSON không chứa dữ liệu công việc, dùng khi cần gửi hỗ trợ.

Tham chiếu nhanh

Lệnh trong Telegram, Zalo, Discord

Giới hạn cần biết

Có tốn phí không?

SpinxAI và các kỹ năng trong Thư viện hiện miễn phí. Chi phí AI (nếu có) do dịch vụ AI bạn kết nối tính trực tiếp. Chế độ trải nghiệm, AI trên máy và Live Voice cục bộ không phát sinh phí dịch vụ.

Tính năng đang phát triển và lộ trình

Các tính năng dưới đây chia ba nhóm theo mức độ sẵn sàng. Đây là định hướng, chưa phải cam kết ngày phát hành; một tính năng chỉ được gắn nhãn “Sẵn sàng” khi đã dùng được từ bản cài sạch, có thao tác hủy, lỗi có hướng khắc phục và đã thử trên mọi hệ điều hành được quảng cáo.

Chi tiết từng nhóm được trình bày ngay bên dưới.

Sắp có — đã làm xong, chờ đưa vào bản cài

• 26 kỹ năng cài sẵn cho người Việt, không cần đăng nhập thư viện:
  • Văn phòng: tóm tắt tài liệu, biên bản họp, soạn văn bản hành chính theo Nghị định 30/2020 (công văn, tờ trình, quyết định…), soạn email, so sánh hợp đồng, lập báo cáo Word/PDF, tạo slide.
  • Nội dung: biên tập tiếng Việt, dịch Việt–Anh, viết nội dung marketing.
  • Dữ liệu: phân tích bảng tính, chuẩn hóa dữ liệu (số và ngày kiểu Việt Nam, số điện thoại, email).
  • Giáo dục và cá nhân: soạn giáo án và đề kiểm tra, lập kế hoạch và checklist.
• Tạo tệp Office thật: AI ghi trực tiếp Word (có thể đúng thể thức hành chính), Excel (ô số, ngày đúng kiểu), PowerPoint 16:9 và PDF vào thư mục bạn cấp; mỗi lần ghi đều hỏi bạn.
• Email và lịch: kết nối Gmail, Yahoo, Zoho (mật khẩu ứng dụng) và lịch CalDAV/Google Lịch (iCal). AI đọc thư, soạn nháp, gửi thư (duyệt từng thư), tìm giờ trống và tạo lịch họp.
• Bản tin hằng ngày: mỗi sáng tóm tắt thư và lịch, gửi về Telegram/Zalo/Discord của bạn. Bạn có thể duyệt trước các quyền chỉ đọc để lịch chạy khi vắng mặt; gửi thư cho người khác và ghi tệp không bao giờ được duyệt trước.

Đang phát triển — ưu tiên cho bản dùng hằng ngày

• Chạy nền: biểu tượng trên khay hệ thống, khởi động cùng máy, thông báo của hệ điều hành — để lịch và kênh vẫn chạy khi đóng cửa sổ.
• Hộp thư kênh 24/7: máy chủ SpinxAI giữ tin Telegram khi máy bạn tắt, xử lý khi bật lại. Máy chủ không gọi AI và không giữ API key của bạn.
• Lịch gửi kết quả ra ngoài: gửi qua kênh/email, lịch cron nâng cao, kích hoạt khi có tệp mới hoặc webhook, giờ yên tĩnh.
• Kênh đầy đủ hơn: nhận ảnh, gửi tệp kết quả, nút trả lời nhanh, duyệt công cụ ngay trong kênh; Zalo Bot chính thức.
• Tài liệu: đọc PDF scan và ảnh (OCR); xuất PDF và PowerPoint từ màn hình kết quả; nhiều tệp kết quả cho một việc.
• Nguồn kiến thức thông minh: tìm theo ngữ nghĩa, AI tự truy tìm và trích dẫn trang/sheet, bộ nhớ dài hạn mà bạn xem, sửa, xóa được.
• Quy trình nhiều bước: ghép các bước, rẽ nhánh, bước chờ người duyệt, chạy tiếp từ điểm dừng. Hiện là Bản thiết kế tương tác.
• Thống kê chi phí và ngân sách: token và chi phí theo lượt, model, trợ lý; tự dừng khi vượt hạn mức bạn đặt.
• Cập nhật tự động trong app, có sao lưu trước khi nâng cấp và khôi phục khi lỗi; bản Windows có chữ ký số.
• Trình duyệt: cho AI dùng tab Chrome mà bạn chủ động chia sẻ; phục hồi hồ sơ đăng nhập sau sự cố.
• Giọng nói và AI trên máy: ổn định hơn với tai nghe/loa, thêm model cục bộ và hệ điều hành.

Kế hoạch dài hạn — nền tảng mở rộng

• Ứng dụng AI: công cụ có giao diện riêng và kết quả tương tác, cài/gỡ như plugin.
• Tạo và chỉnh ảnh, sau đó là video.
• Nhóm và truy cập từ xa: dùng trên nhiều thiết bị, nhiều thành viên, hạn mức theo người.
• Agent API và LLM Proxy: tích hợp SpinxAI vào hệ thống khác bằng API key có phạm vi, webhook ký số.
• Thêm kênh theo nhu cầu (ví dụ WhatsApp, Slack, Microsoft Teams, Facebook Page); mỗi kênh chỉ công bố sau khi nghiệm thu với tài khoản thật.
• Kỹ năng trả phí trong Thư viện và kỹ năng có script chạy trong môi trường kiểm soát.
• Email Outlook/Microsoft 365 (cần đăng nhập OAuth).

Câu hỏi thường gặp và khắc phục sự cố

Cần hỗ trợ: mở Gateway → Chẩn đoán, bấm xuất báo cáo JSON (không chứa nội dung công việc hay key) và gửi kèm mô tả lỗi cho đội SpinxAI. Nếu app không khởi động được, gửi tệp nhật ký runtime.log:

• macOS: ~/Library/Logs/net.spinxai.desktop/runtime.log
• Windows: %LOCALAPPDATA%\net.spinxai.desktop\logs\runtime.log
• Linux: ~/.local/share/net.spinxai.desktop/logs/runtime.log