Proxyma Desktop

Tìm kiếm ngữ nghĩa và trò chuyện với AI trên chính tài liệu của bạn, chạy hoàn toàn trên máy của bạn. Không tài khoản, không máy chủ, không đám mây.

Proxyma Desktop là gì

Proxyma lập chỉ mục các thư mục và hệ thống bạn kết nối, rồi trả lời câu hỏi về chúng kèm trích dẫn những tài liệu đã dùng.

Không cần đăng nhập và tài liệu của bạn không bao giờ được tải lên. Với một mô hình AI chạy nội bộ, không có gì bạn gõ vào hay lập chỉ mục rời khỏi máy, ngoại trừ từ khóa trong các lượt tìm kiếm web của trợ lý và các trang nó mở, những gì nó hỏi các hệ thống bạn kết nối, phản hồi mà bạn chọn gửi đi, và, khi bật dữ liệu chẩn đoán, câu trả lời bạn đánh giá cùng câu hỏi của nó.

Cài đặt

Windows

1. Tải proxyma-x64-v<version>.exe từ trang phát hành.
2. Chạy tệp đó và chấp nhận Thỏa thuận cấp phép người dùng cuối. Trình cài đặt có dung lượng nhỏ.
3. Đảm bảo máy đang có mạng, rồi khởi chạy Proxyma từ trình đơn Start.
4. Trong lần khởi động đầu tiên, Proxyma tải về phần còn lại của nó, khoảng 650 MB, kèm thanh tiến trình. Sau đó nó thiết lập môi trường Python, mất khoảng một phút.
5. Proxyma mở ra trong cửa sổ ứng dụng riêng của nó. Các lần khởi động sau không cần kết nối internet.

Nếu việc tải về bị gián đoạn, hãy khởi động lại Proxyma; nó sẽ tải tiếp từ chỗ đã dừng. Mọi tệp đều được đối chiếu với mã kiểm tra đã ký của bản phát hành trước khi được cài đặt. Nếu mạng công ty dùng proxy, Proxyma dùng thiết lập proxy của Windows hoặc biến HTTPS_PROXY, cùng các tổ chức cấp chứng chỉ mà Windows tin cậy.

Linux

Proxyma được phát hành dưới dạng một gói .deb nhỏ cho Ubuntu và Debian, và tải phần còn lại về trong lần khởi động đầu tiên. Xem Proxyma Desktop trên Linux về cách cài đặt, vị trí tệp tin và cập nhật; phần còn lại của trang này áp dụng không thay đổi.

macOS

Chưa phát hành.

Yêu cầu hệ thống

Lần chạy đầu tiên

1. Chọn một nhà cung cấp AI trong Cài đặt → Nhà cung cấp AI. Không có gì hoạt động cho tới khi có một nhà cung cấp liên hệ được. Sau đó chọn mô hình trò chuyện trong Cài đặt → Tác nhân và mô hình vector nhúng trong Cài đặt → Tìm kiếm; trang Nhà cung cấp AI liệt kê những gì còn lại.
2. Thêm một thư mục trong Nguồn dữ liệu → Kết nối → Thư mục trên máy. Hãy bắt đầu với một thư mục nhỏ.
3. Đặt một câu hỏi. Nếu câu trả lời trích dẫn tài liệu của bạn, việc thiết lập đã hoàn tất.

Chọn một nhà cung cấp AI

Proxyma cần hai mô hình, có thể đến từ các nhà cung cấp khác nhau:

Chọn mô hình trò chuyện trong Cài đặt → Tác nhân và mô hình vector nhúng trong Cài đặt → Tìm kiếm.

Hoàn toàn nội bộ

Hãy cài Ollama và trỏ Proxyma tới http://localhost:11434. Không có gì bạn lập chỉ mục hay hỏi rời khỏi máy của bạn, ngoại trừ từ khóa trong các lượt tìm kiếm web của trợ lý (gửi tới DuckDuckGo nếu bạn chưa cấu hình dịch vụ tìm kiếm khác) và các trang nó mở, những gì nó hỏi các hệ thống bạn kết nối, phản hồi mà bạn chọn gửi đi, và, khi bật dữ liệu chẩn đoán, câu trả lời bạn đánh giá cùng câu hỏi của nó. Tốc độ sẽ chậm hơn và chất lượng câu trả lời thấp hơn các mô hình trực tuyến.

Trực tuyến

Dán khóa API của Anthropic, OpenAI, DeepSeek, Mistral, Azure OpenAI hoặc Google. Câu trả lời tốt hơn, nhưng các đoạn nội dung liên quan tới mỗi câu hỏi sẽ được gửi tới nhà cung cấp đó.

Xem chi phí

Cài đặt → Mức sử dụng & Chi phí cho biết chi phí các lệnh gọi mô hình trong khoảng thời gian bạn chọn: một biểu đồ theo thời gian, và tổng theo nhà cung cấp, mô hình và dịch vụ. Nhật ký bên dưới liệt kê mọi lệnh gọi: thời điểm chạy, phần nào của sản phẩm yêu cầu, mô hình, số token - kể cả ghi và đọc bộ nhớ đệm - và chi phí. Xóa nhật ký xóa mọi lệnh gọi đã ghi; giới hạn chi tiêu hàng tháng đếm các lệnh gọi này, nên tháng này được đếm lại từ 0.

Chi phí được ước tính theo đơn giá bạn đặt cho nhà cung cấp, không lấy từ hóa đơn của họ. Mô hình chưa đặt đơn giá được tính là 0 USD và được đánh dấu.

Thêm tài liệu

1. Với Jira, Confluence, Bitbucket hoặc SVN, hãy thêm một kết nối trong Cài đặt → Bộ kết nối: một tên, URL máy chủ và mã truy cập của bạn (với SVN là tên người dùng và mật khẩu). Thêm một kết nối cho mỗi máy chủ; kết nối đầu tiên của mỗi loại là mặc định.
2. Với thư mục chia sẻ mạng, hãy thêm một kết nối Thư mục chia sẻ mạng trong Cài đặt → Kết nối: máy chủ tệp tin, cùng tên người dùng miền và mật khẩu của bạn. Chỉ những tệp tin tài khoản của bạn mở được mới được lập chỉ mục, và chỉ trên máy chủ đó.
3. Mở Nguồn dữ liệu → Kết nối và chọn loại nguồn.
4. Cung cấp các thông tin bên dưới.

Với Jira, Confluence, Bitbucket hoặc SVN, hãy chọn kết nối khi kết nối nguồn; kết nối mặc định được chọn sẵn. Để chuyển một nguồn sang kết nối khác, mở hộp thoại Cấu hình của nó. Mỗi kết nối có công tắc riêng cho việc trợ lý có được đọc và ghi qua kết nối đó hay không.

Với một thư mục, kho mã SVN hoặc thư mục chia sẻ mạng, hãy chọn các loại tệp cần lập chỉ mục khi kết nối, hoặc sau này trong hộp thoại Cấu hình của nguồn đó.

SharePoint, Microsoft Teams và Outlook cần một tổ chức Microsoft 365, nên chúng thuộc về Enterprise Server và không có trên Desktop hay Home Server.

Định dạng được hỗ trợ: PDF; Word, Excel và PowerPoint (.docx, .xlsx, .xls, .pptx và các phiên bản có macro của chúng); Outlook .msg; EPUB; CSV, Markdown, văn bản thuần và HTML; mã nguồn C và C++; script shell, batch và PowerShell; cùng các tệp phần mềm nhúng và AUTOSAR (.arxml, .dbc, .a2l, linker script và hợp ngữ). Hãy lưu các tệp .doc và .ppt cũ thành .docx và .pptx trước. Bảng trong tệp PDF được trích xuất dưới dạng bảng. Tệp PDF được quét cần OCR: hãy chọn một mô hình OCR trong Cài đặt → Chuyển đổi. Trên Windows, bạn có thể chọn bộ máy Tesseract ở đó thay thế; nó được cài cùng Proxyma, chạy ngoại tuyến và đọc được tiếng Anh và tiếng Việt (đặt Ngôn ngữ Tesseract là eng+vie để dùng cả hai). Trên Linux, xem Tài liệu quét và OCR.

Thông tin đăng nhập được mã hóa khi lưu. Trên Windows, khóa được bảo vệ bằng DPAPI và gắn với tài khoản Windows của bạn; trên Linux, khóa là một tệp chỉ tài khoản của bạn đọc được (xem trang dành cho Linux).

Quan sát nó làm việc

Mỗi tài liệu đi qua các bước phát hiện, tải về, chuyển đổi và tạo vector nhúng. Thư mục lớn sẽ mất một lúc, nhất là với mô hình vector nhúng chạy nội bộ. Một tài liệu bị lỗi không làm dừng các tài liệu còn lại.

Đồng bộ lại chỉ xử lý những gì đã thay đổi.

Đóng cửa sổ không phải là thoát ứng dụng

Proxyma vẫn chạy nền sau khi bạn đóng cửa sổ của nó, với một biểu tượng ở khay hệ thống. Việc lập chỉ mục và các công việc đã hẹn lịch vẫn tiếp tục.

Sử dụng Proxyma

Đặt câu hỏi

Gõ câu hỏi bằng ngôn ngữ tự nhiên. Proxyma trả lời từ các đoạn nội dung liên quan đã lập chỉ mục và cho biết đã dùng những tài liệu nào. Nếu không có nội dung liên quan, nó nói thẳng như vậy thay vì đoán.

Các cuộc trò chuyện

Các cuộc trò chuyện được lưu trên máy bạn. Nhà cung cấp AI trực tuyến nhận cuộc trò chuyện để trả lời. Đánh giá một câu trả lời sẽ gửi câu trả lời đó và câu hỏi của nó ở dạng ẩn danh, chỉ khi Cài đặt → Giới thiệu → Gửi dữ liệu chẩn đoán tới Proxyma đang bật.

Tìm kiếm

Đối chiếu theo từ khóa và theo ý nghĩa chạy cùng lúc, nên cả một mã lỗi chính xác lẫn một mô tả mơ hồ đều tìm ra đúng tài liệu.

Đồ thị tri thức

Proxyma có thể trích xuất những thứ mà tài liệu nhắc tới - thành phần, dịch vụ, tham số, con người - cùng các mối quan hệ giữa chúng thành một đồ thị. Một thứ được nhắc trong nhiều tệp sẽ trở thành một nút duy nhất.

Tính năng này tắt theo mặc định. Hãy bật nó ở cả hai nơi:

1. Trong Cài đặt → Tìm kiếm, bật trích xuất đồ thị tri thức và chọn mô hình trích xuất. Nếu không chọn mô hình thì không có gì được trích xuất.
2. Nếu việc trích xuất liên tục hết thời gian chờ, hãy tăng Thời gian chờ trích xuất ngay tại đó. Mô hình chạy trên máy của bạn thường cần vài phút cho mỗi đoạn.
3. Trong phần cài đặt của một nguồn dữ liệu, bật Xây dựng đồ thị tri thức. Những gì nguồn đã lập chỉ mục sẽ được trích xuất ở chế độ nền. Không có gì bị lập chỉ mục lại. Chỉ những nguồn được bật mới được trích xuất.

Tắt tính năng này sẽ xóa đồ thị của nguồn đó. Chỉ mục và việc tìm kiếm của nguồn vẫn giữ nguyên.

Để xem đồ thị, hãy mở một nguồn dữ liệu và bấm biểu tượng đồ thị trên phần đầu của nó:

• Điểm càng lớn và càng sáng thì càng nhiều kết nối.
• Kéo để xoay, cuộn để phóng to, giữ Shift và kéo để di chuyển khung nhìn.
• Bấm vào một điểm để chọn nó và hiện các liên kết; bấm vào một điểm được liên kết để chuyển tới điểm đó.
• Dùng các nút điều khiển ở góc trên bên trái để đặt số bước quan hệ hiển thị, khoảng cách, tự động xoay, và đặt lại khung nhìn.
• Số sao đặt số điểm được vẽ, ưu tiên những điểm nhiều liên kết nhất. Một nguồn lớn sẽ rõ ràng và mượt hơn với vài trăm điểm; hãy nâng lên để xem phần còn lại.
• Đồ thị lớn được vẽ dần trong lúc tải, ưu tiên các điểm nhiều liên kết nhất, nên bạn có thể đọc trước khi tải xong.

Tắt tính năng này cho một nguồn sẽ xóa những gì nguồn đó đã đưa vào đồ thị. Những gì một nguồn khác cũng đóng góp vẫn được giữ lại.

Kết nối các công cụ khác

Các trình soạn thảo và trợ lý AI hỗ trợ Model Context Protocol có thể tìm kiếm trong các tài liệu đã lập chỉ mục của bạn. Trang API tìm kiếm và MCP có sẵn đoạn cấu hình để dán vào trình soạn thảo.

Bản quyền của bạn

Proxyma Desktop có gói Community miễn phí cùng các gói trả phí Personal và Professional. Mỗi gói trả phí là một lần mua cho một bản cài đặt, không có thuê bao hay gia hạn.

Tài khoản người dùng, vai trò và đăng nhập một lần không có trong gói desktop nào; chúng thuộc về Enterprise Server. Bản quyền Enterprise bị Proxyma Desktop từ chối.

Bản dùng thử miễn phí

Một bản cài đặt mới tự bắt đầu 30 ngày dùng thử gói Professional. Không cần mã hay thẻ; bản dùng thử bắt đầu ở lần đầu Proxyma kết nối được tới máy chủ bản quyền của chúng tôi, và cho tới lúc đó Proxyma thử lại vài giờ một lần. Cài đặt → Giấy phép cho biết ngày kết thúc.

• Mỗi máy tính được dùng thử một lần. Cài lại trong 30 ngày đó vẫn giữ bản dùng thử và ngày kết thúc cũ; cài lại sau đó không bắt đầu bản dùng thử mới.
• Khi hết hạn, Proxyma tiếp tục với gói Community. Bạn có thể kích hoạt mã Personal hoặc Professional bất cứ lúc nào để giữ các tính năng trả phí.

Mã bản quyền của bạn đến từ đâu

Mua trên trang bảng giá tại proxyma.ai. Lemon Squeezy là người bán: họ thu các khoản thuế áp dụng và gửi biên lai cho bạn. Mã bản quyền của bạn nằm trong thư điện tử biên lai đó, và cũng có trên trang My Orders của họ.

Kích hoạt

1. Kết nối internet. Việc kích hoạt cần mạng một lần.
2. Mở Cài đặt → Giấy phép.
3. Nhập mã bản quyền của bạn.

Sau khi kích hoạt, Proxyma kiểm tra lại bản quyền dưới nền vài giờ một lần; đây là cách một bản quyền đã hoàn tiền hoặc bị thu hồi ngừng hoạt động. Một lần kiểm tra thất bại không bao giờ chặn bạn:

• Trong 14 ngày không kiểm tra thành công, không có gì thay đổi. Vào vài ngày cuối, một biểu ngữ đề nghị bạn kết nối mạng.
• Sau 14 ngày, Proxyma chạy với các tính năng của gói Community cho tới khi kiểm tra thành công. Không mất dữ liệu đã lập chỉ mục hay thiết lập nào.
• Khi kiểm tra thành công, các tính năng trả phí quay lại mà không phải nhập lại gì.

Lần kiểm tra chỉ gửi mã bản quyền và một định danh ngẫu nhiên của bản cài đặt, cộng thêm tên máy tính ở lần kích hoạt. Không bao giờ gửi nội dung tài liệu, thông tin phần cứng, dữ liệu sử dụng hay nội dung tìm kiếm.

Gói Community không cần bản quyền và không thực hiện lời gọi nào trong số này.

Chuyển sang một máy tính khác

1. Trên máy cũ, mở Cài đặt → Giấy phép → Giải phóng, rồi Xác nhận. Bản cài đặt đó trở về gói Community.
2. Kích hoạt cùng mã đó trên máy mới.

Nếu không dùng được máy cũ, hãy liên hệ bộ phận hỗ trợ kèm mã bản quyền để giải phóng nó.

Cập nhật

Cài đặt → Cập nhật hiển thị phiên bản của bạn, lần kiểm tra gần nhất, nút kiểm tra ngay và lịch sử cập nhật.

Bản dựng Windows và Linux cập nhật ngay tại chỗ:

• Proxyma tìm bản phát hành mới theo lịch bên dưới (mặc định: khi khởi động, rồi mỗi ngày một lần), và chỉ tải về dưới nền những phần đã thay đổi.
• Mọi tệp tải về đều được đối chiếu với mã kiểm tra đã ký của bản phát hành; tệp không khớp bị xóa chứ không được cài.
• Khi bản cập nhật sẵn sàng, Proxyma báo cho bạn rồi chờ. Chọn Khởi động lại và cài đặt để áp dụng.
• Nếu phiên bản mới không khởi động được, Proxyma tự quay về phiên bản trước.
• Chỉ mục, các cuộc trò chuyện, thiết lập và thông tin đăng nhập của bạn không bị động tới.

Quyết định tần suất, hoặc không kiểm tra gì cả

Chuyển thiết lập sang nơi khác

Cài đặt → Nhập & Xuất dữ liệu sao chép cấu hình của bạn sang một bản cài đặt Proxyma khác dưới dạng một tệp JSON. Đây không phải là bản sao lưu: tệp không chứa các cuộc trò chuyện, tài liệu hay chỉ mục.

Xuất

1. Trong Nội dung đưa vào, đánh dấu các nhóm cần xuất. Mỗi nhóm mang tên một thẻ trong Cài đặt.
2. Để mang theo thông tin đăng nhập, giữ đánh dấu Kèm theo thông tin đăng nhập, được mã hóa bằng một cụm mật khẩu và nhập một cụm mật khẩu dài ít nhất 12 ký tự. Cụm mật khẩu này không thể khôi phục. Bỏ đánh dấu để không đưa thông tin đăng nhập vào tệp.
3. Nhấn Xuất cấu hình.

Nhập

1. Nếu tệp được xuất kèm thông tin đăng nhập, hãy nhập cụm mật khẩu của nó trước.
2. Nhấn Chọn tệp tin. Với tệp có thông tin đăng nhập, nhấn tiếp Đọc tệp này.
3. Bỏ đánh dấu những nhóm bạn không muốn, và xem danh sách những gì sẽ thay đổi.
4. Nhấn Nhập tệp này. Nếu phần Mạng thay đổi, hãy khởi động lại khi được hỏi.

Việc nhập chỉ thêm mới và cập nhật. Nó không bao giờ xóa hay đặt lại thứ gì, và nhà cung cấp, kỹ năng hoặc kết nối có tên đã tồn tại ở đây được giữ nguyên.

Bản quyền, giao diện và các công tắc Đọc và Ghi của từng kết nối không bao giờ được xuất. Một kết nối được nhập vào bắt đầu với Đọc bật và Ghi tắt.

Dữ liệu của bạn nằm ở đâu

Hãy sao lưu thư mục Proxyma để giữ chỉ mục và lịch sử trò chuyện. Mất thư mục này nghĩa là phải lập chỉ mục lại, và thông tin đăng nhập đã lưu cùng bản quyền đã kích hoạt không còn đọc được. Tài liệu của bạn không bị mất.

Xử lý sự cố

Nó không khởi động được

Hãy kiểm tra xem phần mềm diệt virus hay phần mềm bảo vệ điểm cuối có đang chặn các tệp thực thi của Proxyma trong thư mục cài đặt hoặc trong %LOCALAPPDATA%\proxyma\parts\ hay không.

Nếu lần khởi động đầu tiên dừng lại khi đang tải về, hãy kiểm tra máy có kết nối được tới GitHub không, rồi khởi động lại Proxyma.

"Không có nhà cung cấp AI nào phản hồi"

Mở Cài đặt → Nhà cung cấp AI. Với Ollama, mở http://localhost:11434 trong trình duyệt và xác nhận nó phản hồi.

Dịch vụ AI của công ty báo lỗi chứng chỉ

Proxyma tin cậy các tổ chức cấp chứng chỉ mà hệ điều hành của bạn tin cậy. Nếu lỗi ghi PKIX path building failed, hãy nhờ bộ phận IT cài chứng chỉ gốc của công ty lên máy này, rồi khởi động lại Proxyma.

Việc lập chỉ mục rất chậm

Bước tạo vector nhúng là nút thắt, nhất là với mô hình nội bộ trên CPU máy tính xách tay. Hãy dùng nhà cung cấp vector nhúng trực tuyến, lập chỉ mục ít thư mục hơn, hoặc cứ để nó chạy; nó sẽ tiếp tục từ chỗ đang dở.

Tìm kiếm không ra thứ tôi biết chắc là có ở đó

1. Kiểm tra trong Nguồn dữ liệu rằng tài liệu đã lập chỉ mục xong.
2. Với tài liệu quét, kết quả phụ thuộc vào chất lượng OCR.
3. Nếu bạn đã đổi mô hình vector nhúng, hãy lập chỉ mục lại.

Câu trả lời sai hoặc mơ hồ

Proxyma chỉ trả lời từ những gì đã lập chỉ mục. Hãy bổ sung tài liệu nguồn tốt hơn, hoặc dùng mô hình trò chuyện lớn hơn.

Mã bản quyền của tôi bị từ chối

Proxyma ngừng hoạt động sau khi tôi ngắt mạng

Tìm kiếm, trò chuyện và tài liệu đã lập chỉ mục hoạt động ngoại tuyến không giới hạn thời gian. Nếu một trong số đó ngừng chạy, nguyên nhân là một bộ kết nối hoặc nhà cung cấp AI đám mây cần mạng.

Các tính năng trả phí lùi về giới hạn của gói Community sau 14 ngày không kiểm tra bản quyền thành công. Hãy kết nối internet rồi bấm Thử lại trong biểu ngữ, hoặc mở lại Proxyma. Mọi thứ quay lại ngay lập tức.

Biểu ngữ báo rằng bản quyền của tôi đã bị thu hồi

Điều này thường có nghĩa là đơn hàng đã được hoàn tiền hoặc bị khiếu nại đòi tiền. Nếu bạn không yêu cầu hoàn tiền, hãy gửi thư tới contact@proxyma.ai kèm mã bản quyền của bạn.

Gỡ cài đặt

Tài liệu của chính bạn không bị động tới trong cả hai trường hợp.

Windows

1. Gỡ Proxyma trong Add or remove programs. Trình gỡ cài đặt luôn xóa các phần ứng dụng đã tải về. Để xóa luôn chỉ mục và các cuộc trò chuyện, hãy chọn Yes khi trình gỡ cài đặt đề nghị xóa dữ liệu của bạn.
2. Để xóa kỹ năng và tệp của các cuộc trò chuyện, hãy xóa %USERPROFILE%\.proxyma\.

Linux

1. Chạy sudo apt remove proxyma. Các phần ứng dụng đã tải về vẫn nằm trong ~/.local/share/proxyma/.
2. Để xóa chúng cùng dữ liệu của bạn, hãy xóa ~/.local/share/proxyma/ và ~/.proxyma/.