Bắt đầu sử dụng
Bossanova là một kho kỹ thuật số lưu trữ văn bản và hình ảnh được mã hóa trên máy tính của bạn. Bạn phải đăng nhập vào ứng dụng, kể cả khi dùng tài khoản miễn phí. Việc đăng nhập tài khoản khác với mật khẩu chính dùng để mở kho.
Nếu Google báo tài khoản đã tồn tại trên thiết bị, hãy quay lại đây và chọn “Tiếp tục bằng email” với cùng địa chỉ email Google. Nếu đã đăng ký Bossanova bằng địa chỉ email đó, bạn sẽ đăng nhập vào tài khoản hiện có. Bạn cũng có thể thử trình duyệt khác.
Bộ cài hiện tại dành cho Windows 10/11 x64. Chưa có bộ cài cho Windows 32 bit hoặc ARM64 gốc. Việc cài đặt hoặc cập nhật WebView2 có thể cần kết nối Internet.
- Tải và chạy bộ cài dành cho hệ điều hành của bạn từ trang tải xuống.
- Hoàn tất cài đặt, rồi mở Bossanova từ menu Start. Ứng dụng hỗ trợ Windows 10/11 x64. Trình cài đặt sẽ thiết lập WebView2 nếu máy chưa có. Hãy liên hệ quản trị viên nếu máy tính công ty chặn việc cài đặt.
- Trên màn hình đăng nhập của ứng dụng, hãy đăng ký hoặc đăng nhập bằng Google, Apple hoặc email, rồi phê duyệt thiết bị này. Tài khoản miễn phí cho phép bạn lưu mười mục.
- Tạo kho ở màn hình đầu với mật khẩu chính dài và giữ mật khẩu an toàn. Để chuyển kho có sẵn, chọn nhập từ thiết bị khác trước khi tạo kho. Tệp sao lưu dùng chức năng khôi phục riêng.
- Trước tiên, hãy lưu một ví dụ không chứa thông tin nhạy cảm. Thử tìm kiếm, xem và sao chép ví dụ đó, sau đó thêm thông tin thật và tạo một bản sao lưu bên ngoài.
Nhà phát triển không thể khôi phục mật khẩu chính bị quên. Đăng nhập bằng Google, Apple hoặc email cũng không thể đặt lại mật khẩu này.
Lưu và sắp xếp dữ liệu
Kho Bossanova được tổ chức theo thứ tự thư mục → nhóm → mục dữ liệu. Một mục dữ liệu gồm một tên và một giá trị (văn bản hoặc hình ảnh); một nhóm tập hợp các mục dữ liệu liên quan. Thư mục chứa các nhóm và những mục dữ liệu không thuộc nhóm, còn kho là tập hợp các thư mục. Ví dụ, thư mục “Khóa API” có thể chứa nhóm “bossanova” với các mục “Khóa API Dodo” và “Ngày gia hạn”. Mỗi mục dữ liệu dạng văn bản hoặc hình ảnh được tính là một mục.
Thư mục dùng để sắp xếp các nhóm và mục dữ liệu. Kéo các tay nắm để thay đổi thứ tự. Khi xóa thư mục, bạn có thể chọn giữ lại hoặc xóa nội dung bên trong.
Bật hoặc tắt quyền truy cập AI bằng biểu tượng ngôi sao. Di chuột để xem tên; nền xanh nhạt nghĩa là đã bật; ngôi sao vẫn chỉ có nét viền. Nút giống nhau ở danh sách, chi tiết và biểu mẫu dữ liệu, nhóm. Tất cả dữ liệu và thư mục dùng chung cách sắp xếp: mặc định, mới nhất, cũ nhất, dùng nhiều nhất, dùng ít nhất, tên A–Z và Z–A. Lựa chọn cuối được lưu trong kho cho lần mở tiếp theo. Tên theo ngôn ngữ hiển thị, với 2 trước 10. Chọn mặc định để kéo đổi thứ tự trong thư mục; cách sắp xếp khác vẫn giữ thứ tự thủ công.
Trong Cài đặt → AI → Quyền truy cập AI, quyền mặc định cho dữ liệu mới ban đầu tắt. Áp dụng cho văn bản và ảnh mới, dữ liệu thêm khi tạo hoặc sửa nhóm, mẫu và nhập .env. Bạn có thể đổi từng biểu tượng AI trước khi lưu. Dữ liệu cũ, chia sẻ không bí mật và quyền thực thi không thay đổi. Lựa chọn được lưu trong kho này.
- Tạo thư mục bằng “Thêm và quản lý thư mục” trong menu bên trái, rồi kéo các tay nắm để sắp xếp lại thứ tự.
- Dùng “Thêm dữ liệu” để nhập tên, loại (văn bản hoặc hình ảnh; các mục cũ vẫn giữ loại mật khẩu, số hoặc ngày) và giá trị. Nếu không chọn nhóm, mục dữ liệu sẽ nằm trực tiếp trong thư mục. Bạn có thể kéo thả hoặc dán hình ảnh (PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, TGA, PNM, QOI, HDR, tối đa 10MiB). Nhấp vào một mục dữ liệu để mở phần chi tiết, rồi nhấp “Chỉnh sửa” để mở hộp thoại chỉnh sửa đã điền sẵn giá trị được lưu (dùng “Hiện giá trị” để kiểm tra).
- Kéo một mục dữ liệu lên mục khác để tạo nhóm, hoặc kéo một nhóm lên nhóm khác để gộp chúng. Dùng các tay nắm để sắp xếp lại mọi mục.
- Khi cần giá trị, hãy dùng thao tác xem hoặc sao chép của mục dữ liệu. Ứng dụng hoặc tài liệu đích có thể nhìn thấy giá trị đã dán, vì vậy hãy kiểm tra nơi bạn dán giá trị.
- Gói Plus và Pro có các mẫu cho những nhóm thường dùng. Bạn vẫn phải tự nhập các giá trị thực tế.
Chỉ nhập bí mật vào các ô giá trị. Tùy theo cài đặt, tên và mô tả mục dữ liệu, cũng như tên nhóm và thư mục, có thể được chia sẻ với AI.
Nhập tệp .env
Bạn có thể chuyển các bí mật trong tệp .env của dự án vào kho chỉ trong một bước. Nhấn “Nhập .env” ở góc dưới bên trái của hộp thoại “Nhóm mới”, hoặc thả tệp vào trang kho. Một tệp trở thành một nhóm, còn mỗi biến trở thành một mục dữ liệu được đặt tên theo biến đó. Dữ liệu vẫn là bí mật; quyền AI theo cài đặt mặc định cho dữ liệu mới.
- Bản xem trước chỉ hiển thị tên biến; giá trị không bao giờ xuất hiện trên màn hình. Chọn tên nhóm (ví dụ: web .env) và kiểm tra danh sách.
- Các giá trị có thể không phải bí mật, chẳng hạn số cổng hoặc URL công khai, được đánh dấu là ứng viên “Không phải bí mật”. Theo mặc định, mọi thứ đều là bí mật; chỉ những mục bạn tự chọn mới được đánh dấu “Không phải bí mật” sau khi bạn xác nhận cảnh báo.
- Nếu nhập qua hộp chọn tệp, bạn có thể chọn xóa tệp .env gốc. Các tệp được thả vào sẽ không bị xóa.
- Thao tác nhập được lưu trong một bước. Nếu vượt quá giới hạn dữ liệu của gói, không có gì được lưu và lời nhắc nâng cấp sẽ xuất hiện; thông tin hiện có không bị thay đổi.
AI có thể dùng toàn bộ nhóm đã nhập trong “Chèn vào lượt chạy”: mọi mục dữ liệu trong nhóm có bật quyền truy cập AI sẽ được chèn vào dưới dạng biến môi trường mang tên mục đó. Tệp .env còn nằm trong dự án có thể bị AI đọc, vì vậy hãy dọn dẹp tệp sau khi đã đưa nội dung vào kho.
Tìm thông tin
Khi kho đã mở khóa, hãy nhập tên hoặc từ khóa vào ô tìm kiếm. Kết quả thay đổi trước khi bạn nhấn Enter. Hãy bắt đầu bằng một phần ngắn của tên; kết quả khớp chính xác được xếp trước kết quả khớp một phần và tương tự.
Tìm kiếm chạy cục bộ bằng các thuật toán và không gửi truy vấn của bạn đến AI hay máy chủ tài khoản. Theo mặc định, tìm kiếm tên và mô tả. Bật tùy chọn tìm cả nội dung giá trị để bao gồm các giá trị văn bản; các giá trị bí mật khớp sẽ không xuất hiện trong bản xem trước kết quả. Hình ảnh không được tìm kiếm bằng OCR. Chọn một kết quả, rồi xem hoặc sao chép trường bạn cần.
Nếu không có kết quả khớp, hãy rút ngắn truy vấn hoặc điều chỉnh khoảng cách. Xóa truy vấn để quay lại danh sách đầy đủ. Không thể tìm kiếm khi kho đang bị khóa.
Ngôn ngữ
Cài đặt → Chung → Ngôn ngữ — Ngôn ngữ dùng trên màn hình. Ngôn ngữ được áp dụng ngay và lưu trong kho bảo mật này. Màn hình khóa dùng ngôn ngữ của máy tính.
Khóa và thoát
Hãy khóa kho khi bạn rời khỏi máy tính. Kho mới mặc định sẽ khóa sau năm phút không hoạt động; cài đặt của kho hiện có được giữ nguyên. Bạn có thể thay đổi thời gian trong phần Cài đặt. Các tác vụ AI sử dụng giá trị bí mật không thể tiếp tục khi kho bị khóa. Khi AI đang gửi yêu cầu, thời gian tự động khóa được kéo dài tối đa 12 giờ kể từ lúc bạn mở khóa kho; kho cũng không tự động khóa trong vòng 60 phút sau yêu cầu AI gần nhất, ngay cả khi bạn rời máy. Điều này giúp một lần dựng kéo dài không bị gián đoạn vì kho bị khóa.
Đóng cửa sổ sẽ để Bossanova tiếp tục chạy trong khay hệ thống. Nhấp vào biểu tượng Bossanova trong khay để mở lại, hoặc chọn “Thoát” trong menu khay để thoát hoàn toàn. AI không thể sử dụng kho cục bộ khi máy tính tắt hoặc Bossanova đã thoát.
Nếu tắt tự động khóa, hãy khóa kho hoặc nhấn Ctrl/Cmd+L trước khi rời máy.
Khởi động và mở khóa
Trong Cài đặt → Chung → Khởi động và mở khóa, bật “Khởi động khi bạn đăng nhập máy tính”. Bossanova sẽ mở vào lần đăng nhập tiếp theo. Tùy chọn này mặc định bị tắt.
Tự động mở kho sau khi đăng nhập máy tính là một cài đặt riêng. Đọc thông báo và xác nhận mật khẩu chính để lưu thông tin xác thực mở khóa vào bộ nhớ bảo mật của thiết bị này. Khi bật cả hai cài đặt, Bossanova sẽ khởi động trong khay mà không mở cửa sổ vào lần đăng nhập máy tính tiếp theo.
Tự động mở kho hoạt động một lần cho mỗi lần đăng nhập hệ điều hành. Khóa thủ công, chế độ ngủ, khóa màn hình và khởi động lại ứng dụng đều yêu cầu mật khẩu. Đổi mật khẩu hoặc đặt lại bảo mật sẽ tắt tính năng tự động mở. Bản sao lưu không chuyển thông tin xác thực mở khóa của thiết bị.
Tự động mở kho làm tăng nguy cơ các chương trình chạy với quyền của người dùng hệ điều hành có thể truy cập kho. Không dùng tính năng này trên máy tính dùng chung. Hãy tiếp tục giữ mật khẩu chính và các bản sao lưu được mã hóa bên ngoài.
Chuyển giữa các thiết bị và sao lưu mã hóa
Kho sử dụng thư mục dữ liệu ứng dụng của người dùng hệ điều hành và bộ nhớ bảo mật, không phải thư mục nằm cạnh tệp EXE. Chuyển tệp thực thi không chuyển theo kho. Các thiết bị không tự động đồng bộ.
Để chuyển két giữa các thiết bị thông thường, hãy dùng kết nối trực tiếp trên cùng Wi-Fi/LAN. Két và hình ảnh được mã hóa, chỉ truyền giữa các thiết bị của bạn, không qua máy chủ Bossanova. Bạn không cần mang tệp sao lưu bằng USB. Bossanova (Windows) hỗ trợ truyền dữ liệu đã mã hóa tối đa 2 GiB, bao gồm hình ảnh. Cả hai thiết bị cần dùng phiên bản hỗ trợ định dạng sao lưu này.
Thiết bị nhận két lần đầu sẽ tham gia cùng két đó. Những lần nhập sau sẽ hợp nhất thay đổi của thư mục, nhóm và dữ liệu. Bạn chỉ cần chọn phiên bản giữ lại khi cả hai thiết bị sửa cùng một mục theo cách khác nhau. Đây không phải đồng bộ tự động: hãy nhập mỗi lần muốn trao đổi thay đổi. Kết nối và phê duyệt AI không được chuyển sang.
Bản sao lưu mã hóa là bản sao riêng để phục hồi khi xảy ra sự cố hoặc mất dữ liệu. Tạo hoặc khôi phục bản sao trong ứng dụng máy tính, tại Cài đặt → Bản sao lưu. Giữ một bản riêng ở nơi an toàn, vẫn còn khi ổ đĩa hỏng. Khôi phục đưa dữ liệu về thời điểm sao lưu: hãy lưu trạng thái hiện tại trước và giữ bản gốc đến khi kiểm tra xong việc phục hồi.
Nếu ảnh bị hỏng hoặc bị thiếu khiến kho không mở được, hãy chọn Khôi phục từ bản sao lưu trên màn hình khóa. Chọn bản sao lưu nguyên vẹn của cùng kho, nhập mật khẩu chính hiện tại và mật khẩu của bản sao lưu; chúng có thể khác nhau. Ứng dụng giữ bản gốc bị hỏng và các tệp mã hóa còn lại, nhưng không thể tái tạo nội dung đã mất. Nội dung được đưa về thời điểm sao lưu và mật khẩu chính hiện tại được giữ nguyên. Sau đó, kiểm tra lại kết nối AI, quyền phê duyệt và cài đặt chia sẻ giá trị.
Bản sao lưu tự động là các bản sao được tạo trên PC này (trong thư mục dữ liệu ứng dụng) để khôi phục thông tin vô tình bị xóa. Hãy xuất lại két sau khi đổi mật khẩu hoặc thực hiện đặt lại bảo mật.
Khôi phục thông tin từ thời điểm sao lưu, thay thế các thông tin được thêm hoặc thay đổi sau đó. Trước khi khôi phục, một bản sao mã hóa của kho hiện tại sẽ tự động được lưu trên PC này. Lịch sử truy cập hiện có được giữ lại; các kết nối AI và việc chia sẻ giá trị sẽ được đặt lại.
- Kết nối cả hai thiết bị với cùng Wi-Fi/LAN thông thường và đăng nhập cùng tài khoản Bossanova. Mở cả hai ứng dụng và mở khóa các két hiện có. Nếu thiết bị nhận chưa có két, bắt đầu bằng “Nhập từ thiết bị khác” trên màn hình đầu tiên.
- Trên thiết bị gửi, chọn Cài đặt → Bản sao lưu → “Gửi két này”. Mã hiển thị chỉ dùng một lần và hết hạn sau 3 phút.
- Trên thiết bị nhận, chọn “Nhập từ thiết bị khác”, nhập mã của thiết bị gửi và mật khẩu chính của két đó. Ứng dụng tự tìm thiết bị gửi trên cùng LAN.
- Giữ cả hai ứng dụng hiển thị trên màn hình và các két hiện có mở khóa cho đến khi hoàn tất. Đưa ứng dụng vào nền hoặc khóa két có thể hủy việc truyền. Kiểm tra dữ liệu đã nhập và chọn phiên bản giữ lại nếu có xung đột.
Chế độ cách ly thiết bị của Wi-Fi khách, VPN hoặc tường lửa có thể khiến các thiết bị không tìm thấy nhau. Dùng cùng Wi-Fi thông thường trên cả hai thiết bị, cho phép truy cập mạng cục bộ rồi thử lại. Không có chuyển tiếp tự động qua internet. Việc sao chép giữa các thiết bị cũng có thể mang theo thao tác xóa hoặc lỗi, nên không thay thế bản sao lưu riêng.
Bảo mật
Cài đặt → Bảo mật → Đổi mật khẩu chính — Việc thay đổi thông thường chỉ thay đổi mật khẩu dùng để mở kho. Khóa mã hóa nội bộ và các bản sao lưu cũ không thay đổi. Nếu nghi ngờ bị lộ, hãy dùng “Ứng phó sự cố · Đặt lại bảo mật”.
Cài đặt → Bảo mật → Ứng phó sự cố · Đặt lại bảo mật — Bảo vệ thông tin hiện tại bằng khóa mã hóa mới và mật khẩu mới. Các trường và giá trị được giữ nguyên; toàn bộ kết nối AI, quyền truy cập AI và việc chia sẻ giá trị đều được đặt lại. Lịch sử truy cập mới bắt đầu; lịch sử cũ vẫn nằm trong bản sao lưu trước khi thay đổi.
Bản sao lưu được mã hóa trước khi thay đổi sẽ được giữ trên PC này. Các bản sao lưu cũ vẫn mở được bằng mật khẩu cũ và không thể ghi đè trực tiếp lên kho mới. Bạn có thể khôi phục chúng riêng trong một vị trí lưu trữ trống.
Nếu nghi ngờ PC bị nhiễm mã độc, trước tiên hãy thao tác trên thiết bị đáng tin cậy. Chỉ đổi mật khẩu trên PC bị nhiễm sẽ không bảo vệ được bạn.
Thông tin cũ đã bị lộ không thể thu hồi. Hãy thay đổi hoặc thu hồi mật khẩu dịch vụ và khóa API bị lộ tại các dịch vụ tương ứng. Sau đó, hãy tạo một bản sao lưu bên ngoài mới.
Xóa kho vĩnh viễn cần mật khẩu chính và xóa không thể hoàn tác kho cùng bản sao nội bộ trên PC này. Bản sao bên ngoài ở nơi khác vẫn còn.
Tài khoản, gói và thiết bị
Tất cả các gói, kể cả Free, đều yêu cầu đăng nhập vào ứng dụng. Đăng nhập bằng Google, Apple hoặc email rồi phê duyệt thiết bị đang hiển thị. Nếu đã đăng nhập, bạn có thể kiểm tra mục tài khoản và gói đăng ký trong Cài đặt.
Chọn Ẩn email của tôi với Apple có thể tạo một tài khoản riêng, khác với tài khoản bạn đã dùng với Google hoặc email. Để tiếp tục sử dụng gói đăng ký hiện có, hãy đăng nhập bằng phương thức bạn đã dùng cho tài khoản đó.
Giới hạn số mục của gói áp dụng khi thêm dữ liệu và chỉnh sửa nội dung. AI vẫn có thể liệt kê và sử dụng dữ liệu đã lưu mà không bị giới hạn số mục. Có thể bật hoặc tắt riêng quyền truy cập AI và chia sẻ dữ liệu không bí mật, kể cả với dữ liệu chỉ đọc. Chia sẻ vẫn cần đồng ý; thực thi vẫn cần mở khóa kho, kết nối được duyệt, thiết bị đang hoạt động và phê duyệt thao tác.
Sau khi gói đăng ký kết thúc, bạn vẫn có thể xem, tìm kiếm, sao chép, sao lưu và khôi phục thông tin hiện có. 10 trường cơ bản miễn phí được cố định vẫn có thể chỉnh sửa; các trường bổ sung chỉ đọc. Việc đổi tên hoặc sắp xếp lại không làm thay đổi phân loại này. Mẫu chỉ dành cho Plus hoặc Pro.
Đăng ký lượt dùng miễn phí trong ứng dụng tại Cài đặt → Tài khoản và gói đăng ký → Mã khuyến mãi, hoặc trong ô nhập mã trên trang tài khoản. Nhập mã giảm giá ở bước thanh toán Paddle sau khi chọn gói.
Quyền dùng miễn phí không yêu cầu thẻ và kết thúc vào ngày hiển thị, không tự động tính phí. Mã cùng cấp gói sẽ kéo dài thời gian còn lại. Nếu đang dùng gói trả phí hoặc mã của cấp khác, hãy chờ hết hạn. Nếu có giao dịch chưa hoàn tất, hãy hủy giao dịch chưa thanh toán trên trang tài khoản trước khi dùng mã.
Sau khi áp dụng mã giảm giá, chọn gói phù hợp và hoàn tất thanh toán qua Paddle. Cần có phương thức thanh toán; gói đăng ký tự động gia hạn cho đến khi bạn hủy. Kiểm tra mức giảm, số lần thanh toán được giảm và tổng giá cả năm. Khi ưu đãi kết thúc, lần gia hạn tiếp theo tính giá thông thường. Trong Quản lý thanh toán, bạn có thể đổi phương thức thanh toán, xem biên nhận và hủy đăng ký.
Đăng nhập vào trang giá để đổi gói hoặc chu kỳ thanh toán. Thay đổi có hiệu lực ngay sau khi xác nhận số tiền. Hủy gói trong phần quản lý đăng ký. Khi đang dùng thẻ miễn phí, bạn có thể chọn Plus hoặc Pro để đăng ký trước. Chưa thu tiền ngay: hãy thêm phương thức thanh toán và xác nhận ngày thu tiền đầu tiên cùng số tiền gia hạn. Gói đã chọn bắt đầu sau khi thẻ hết hạn và thanh toán lần đầu thành công. Hủy đăng ký trước vẫn giữ thời gian còn lại của thẻ ban đầu. Hãy hủy trước khi thêm thẻ khác. Một số ưu đãi giới hạn theo giá không áp dụng cho đăng ký trước. Tại các khu vực cần sự đồng ý bổ sung như Hàn Quốc, Paddle sẽ yêu cầu xác nhận trước lần gia hạn trả phí đầu tiên. Nếu không đồng ý, đăng ký đặt trước sẽ bị hủy và không bị tính phí.
Thiết bị đã đăng nhập liệt kê các ứng dụng kết nối với tài khoản. Chỉ thiết bị có quyền chỉnh sửa kho được tính vào giới hạn của gói. Tắt chỉnh sửa chuyển thiết bị sang chỉ đọc khi kiểm tra tài khoản lần tiếp theo; Đăng xuất cạnh thiết bị yêu cầu đăng nhập lại. Cả hai thao tác đều không xóa kho hay bản sao lưu.
| Gói | Số mục | Thiết bị đã kết nối |
|---|---|---|
| Free | 10 | 1 |
| Plus | 100 | 2 |
| Pro | Không giới hạn | 5 |
Đăng xuất sẽ khóa kho; hãy đăng nhập lại để sử dụng. Kho gốc và các bản sao lưu không bị xóa. Nếu không thể đăng nhập, hãy dùng Xuất bản sao lưu khẩn cấp trên màn hình đăng nhập để xuất một bản sao lưu được mã hóa bằng mật khẩu chính. Khi vẫn đang đăng nhập, gói trả phí hết hạn vẫn cho phép bạn chỉnh sửa mười trường cơ bản; các trường bổ sung vẫn được giữ ở chế độ chỉ đọc. Các tính năng trả phí hoạt động ngoại tuyến tối đa bảy ngày.
Kết nối AI
AI là tùy chọn. Sau khi kết nối, AI giao cho Bossanova mọi công việc cần giá trị mà không bao giờ nhận được giá trị đó. Khi bật quyền truy cập AI cho một mục dữ liệu, AI chỉ nhìn thấy tên, mô tả và nhóm của mục, không nhìn thấy giá trị. Bạn quyết định nơi giá trị được phép sử dụng trên thẻ phê duyệt trong ứng dụng khi AI thử sử dụng giá trị lần đầu.
Biểu tượng thùng rác ở góc trên bên phải chỉ thu hồi phê duyệt đó. Trợ giúp kết nối và thiết lập thủ công dùng để sửa kết nối hoặc thêm AI ngoài danh sách; không cần đổi khi dùng bình thường.
- Mở khóa Bossanova và bật Claude Desktop tại Cài đặt → AI → «Tìm AI trên máy tính này». Thoát hoàn toàn rồi mở lại Claude. Kết nối Chat thông thường của ChatGPT riêng tại thẻ «ChatGPT».
- Kết nối từng AI bằng công tắc. Claude Desktop cũng cài bsnv cho tab Code cục bộ: /mcp kiểm tra kết nối, /bsnv hiển thị hướng dẫn. Trong Chat, dùng + → Trình kết nối; hướng dẫn được gửi qua MCP. Sau khi cập nhật ứng dụng, mở khóa Bossanova sẽ cập nhật skill của các kết nối hiện có. Kết nối tất cả bỏ qua Claude Code gốc để tránh trùng lặp nhưng bao gồm WSL.
- Dòng «Codex» cấu hình máy khách Codex. Chỉ cấu hình đó không kết nối Chat thông thường. Chat thông thường trong ứng dụng và web sử dụng đường hầm chính thức của OpenAI.
- Với các máy chủ CLI, hãy bắt đầu một cuộc trò chuyện mới và kiểm tra xem các công cụ Bossanova có được liệt kê hay không. Bật quyền truy cập AI cho những mục dữ liệu bạn muốn dùng, rồi yêu cầu AI thực hiện công việc như bình thường (ví dụ: “Triển khai bằng mã thông báo triển khai được lưu trong Bossanova”). AI chọn mục dữ liệu dựa trên tên và mô tả.
- Lần đầu AI thử sử dụng một mục dữ liệu, một thẻ phê duyệt sẽ xuất hiện trong Bossanova. Kiểm tra dữ liệu và đích đến (một dịch vụ, hoặc tệp thực thi, thư mục, tên biến và phương thức truyền), rồi chọn Từ chối, Chỉ lần này, 24 giờ, 7 ngày, 30 ngày hoặc Luôn luôn. Sau khi cho phép, bạn sẽ không bị hỏi lại với cùng đích đến.
Điều khiển dự án hỗ trợ Chat thông thường trong ứng dụng và web ChatGPT, cùng Claude Desktop. Không hỗ trợ Claude web. Việc dùng dữ liệu kho và truy cập dự án cần các quyền riêng biệt. Bạn tự đăng nhập và chấp thuận kết nối. Nếu thiếu công cụ, làm mới danh sách hoặc mở cuộc trò chuyện mới; cuộc trò chuyện cũ có thể giữ kết nối trước đó. Không bảo đảm quyền, khả dụng hay hạn mức miễn phí của OpenAI. Kết nối WSL và Windows tách biệt.
Cách AI sử dụng giá trị
AI không bao giờ nhận được giá trị. Bossanova thực hiện thay AI những công việc cần giá trị theo một trong hai cách.
“Gửi thay bạn”: AI cung cấp một yêu cầu HTTPS (phương thức, URL, tiêu đề và nội dung) có chỗ giữ chỗ cho giá trị; Bossanova tự gửi yêu cầu và chỉ chèn giá trị vào chỗ đó. Giá trị không bao giờ xuất hiện trong mã, yêu cầu hoặc phản hồi của AI. Lần đầu sử dụng một dịch vụ, thẻ phê duyệt liệt kê dữ liệu và tập hợp máy chủ của dịch vụ đó (các dịch vụ phổ biến như GitHub sẽ gộp các máy chủ liên quan); các đường dẫn và phương thức khác của cùng dịch vụ không cần hỏi lại. Chỉ cho phép https trên cổng 443 tới các địa chỉ công khai, không đi theo chuyển hướng, và phản hồi trả về cho AI sẽ che mọi giá trị được gửi ngược lại. Đây là cách phù hợp với các bí mật được gửi đến máy chủ, chẳng hạn mã thông báo triển khai và khóa API thanh toán, email hoặc đám mây.
“Chèn vào lượt chạy”: AI chỉ định một tệp thực thi (đường dẫn tuyệt đối; với tập lệnh là chính tệp đó), thư mục làm việc, các đối số của lượt chạy này và tên biến môi trường. Thẻ phê duyệt xuất hiện khi dùng lần đầu; sau khi được cho phép, Bossanova tự khởi chạy chương trình và chỉ truyền giá trị qua phương thức truyền ghi trên thẻ. Các đối số có thể tự do thay đổi theo từng lượt chạy và không thuộc phạm vi phê duyệt; nếu tệp thực thi, thư mục, tên biến, phương thức truyền hoặc nội dung tập lệnh thay đổi, ứng dụng sẽ hỏi lại. Có bốn phương thức truyền: biến môi trường (giá trị nguyên dạng), tệp tạm thời (đường dẫn tệp trong biến, bị xóa sau lượt chạy), proxy (tiến trình chỉ nhận mã thông báo giả; proxy HTTPS theo từng lượt chạy của Bossanova chỉ đổi nó thành giá trị thật trong các yêu cầu tới các máy chủ trên thẻ) và SSH agent (khóa chỉ ký bên trong Bossanova). Với phương thức proxy và agent, tiến trình không bao giờ nhận chính giá trị đó (giá trị được phản hồi lại cũng được đổi lại thành mã thông báo giả). Khác với “Gửi thay bạn”, tiến trình nhìn thấy phản hồi trước, còn SSH agent cho phép chương trình yêu cầu bất kỳ máy chủ nào ký bằng khóa đó; thẻ phê duyệt sẽ thông báo điều này.
Những giá trị phải nằm bên trong ứng dụng, chẳng hạn khóa công cụ dựng và khóa SDK máy khách, phù hợp với phương thức biến môi trường. Khi đó giá trị nằm trong tiến trình và có thể còn lại trong chương trình, các tiến trình con và đầu ra của chúng. Các mục dữ liệu đã gắn với một dịch vụ bằng “Gửi thay bạn” không thể được chèn qua phương thức biến môi trường hoặc tệp tạm thời (để bí mật máy chủ không bao giờ lọt vào mã do AI viết). Có thể chèn toàn bộ nhóm được nhập từ .env, còn các lệnh không bao giờ kết thúc, chẳng hạn máy chủ phát triển, sẽ chạy dưới dạng một phiên để AI đọc nhật ký đang chạy và yêu cầu dừng phiên. Các đường dẫn Linux trong WSL chạy bên trong bản phân phối đó. Mỗi lượt chạy được giới hạn trong 24 giờ.
AI nhận lại mã thoát, thời lượng và nhật ký lượt chạy đã che giá trị (các dạng nguyên văn, base64 và mã hóa URL đều được che, đồng thời các chuỗi trông giống bí mật bị loại bỏ). Nếu lệnh in ra giá trị, nhật ký sẽ không được gửi cho AI và chỉ có lý do được trả về; bạn có thể đọc nhật ký đã che trong mục Lượt chạy gần đây của thẻ AI.
Có một phê duyệt cho mỗi mục dữ liệu và đích đến, bất kể AI nào yêu cầu (AI gửi yêu cầu chỉ được ghi trong nhật ký truy cập). Các thời hạn gồm Chỉ lần này, 24 giờ, 7 ngày, 30 ngày và Luôn luôn; bạn có thể thu hồi phê duyệt trong danh sách phê duyệt của thẻ AI. Thu hồi không thể hoàn tác một yêu cầu đã đến đích hoặc một giá trị đã được chuyển cho chương trình đang chạy.
Hình ảnh như con dấu và chữ ký được lưu để bạn xem và sao chép; không có tính năng cho phép AI tự động sử dụng chúng. Ứng dụng cũng không có tính năng tự điền biểu mẫu trên trình duyệt hoặc hoàn tất tài liệu thay bạn.
Với env hoặc file, tiến trình được duyệt nhận giá trị thật. Ngay cả send, proxy và agent cũng có thể làm lộ gián tiếp nếu bí mật được lưu ở dịch vụ đã duyệt rồi đọc qua đường khác. Không lưu bí mật vào tài liệu, nhật ký hay tin nhắn AI có thể đọc. Hệ điều hành, ứng dụng và đích phải đáng tin cậy.
Tắt quyền truy cập AI sẽ tạm dừng việc sử dụng giá trị bí mật và giữ các phê duyệt theo thời hạn, kể cả Luôn cho phép. Khi bật lại, yêu cầu mới có thể dùng các phê duyệt đó nếu giá trị và nơi sử dụng không đổi; thời điểm hết hạn ban đầu không được gia hạn. Các yêu cầu đang chờ trước đó và phê duyệt một lần không được tiếp tục. Chọn Thu hồi phê duyệt để hủy phê duyệt. Chia sẻ dưới dạng không bí mật là một cài đặt riêng.
Cập nhật và xác minh tệp
Trong Cài đặt → Chung → Cập nhật ứng dụng, bật tự động kiểm tra và tải xuống, hoặc kiểm tra thủ công. Bạn vẫn có thể sử dụng kho trong khi tải xuống. Bản cập nhật đã sẵn sàng sẽ được cài vào lần mở ứng dụng tiếp theo, hoặc chọn Cập nhật và khởi động lại sau khi hoàn tất chỉnh sửa. Nếu bản cập nhật đã ký chưa sẵn sàng, hãy kiểm tra trang tải xuống chính thức.
Việc cập nhật sẽ khóa kho và thay thế các tệp ứng dụng, nhưng giữ nguyên thông tin đã lưu. Để cập nhật thủ công, hãy chạy trình cài đặt chính thức mới và giữ nguyên vị trí cài đặt hiện tại. Với bản phát hành công khai đã ký, hãy kiểm tra nhà phát hành trong mục Chữ ký số của thuộc tính tệp Windows. Các bản dựng thử nghiệm nội bộ chưa ký không phải là bản phát hành công khai đã ký. SHA-256 là bước kiểm tra tính toàn vẹn bổ sung.
Từ Bossanova 0.1.41, gỡ cài đặt ứng dụng trên Windows sẽ đăng xuất tài khoản. Nếu giữ lại kho, hãy đăng nhập vào cùng tài khoản sau khi cài đặt lại và mở kho bằng mật khẩu chính. Gỡ cài đặt mặc định sẽ giữ lại dữ liệu kho. Chọn xóa dữ liệu trong trình gỡ cài đặt Windows cũng có thể xóa kho. Bản sao lưu bên ngoài là riêng biệt. Để chuyển sang PC mới, dùng xuất và nhập trong cùng Wi-Fi. Bạn cũng có thể khôi phục bản sao bên ngoài.
Bản cập nhật được chuẩn bị ở chế độ nền mà không gửi nội dung kho hay thông tin tài khoản.
Get-FileHash .\Bossanova-Setup.exe -Algorithm SHA256Không xóa thư mục dữ liệu của kho. Nếu chữ ký hoặc checksum không khớp, không chạy tệp; hãy kiểm tra bản phát hành chính thức.
Khắc phục sự cố
- Nếu ứng dụng không mở, hãy kiểm tra phiên bản Windows, hỗ trợ x64 và mọi thông báo liên quan đến WebView2. Trước khi xử lý cảnh báo bảo mật, hãy kiểm tra trạng thái phát hành và tệp trên trang tải xuống chính thức.
- Nếu tìm kiếm không có kết quả, hãy kiểm tra trạng thái khóa và truy vấn. Nếu việc thêm dữ liệu hoặc nhập .env bị chặn, hãy kiểm tra giới hạn dữ liệu của gói (10 với Free) và trạng thái gói đăng ký.
- Nếu thiếu công cụ AI, hãy đảm bảo nút gạt kết nối của AI đó đang bật trong Cài đặt → AI, rồi bắt đầu một cuộc trò chuyện mới. AI trong WSL và Windows được liệt kê riêng, vì vậy hãy kết nối phiên bản bạn thực sự sử dụng. Sau khi kết nối, cần khởi động lại ứng dụng Claude và ứng dụng ChatGPT để các công cụ xuất hiện.
- Bật kết nối trong Cài đặt → AI là cấp quyền kết nối. Không có thẻ xác nhận kết nối thứ hai; quyền sử dụng dữ liệu vẫn được cấp riêng. Hãy bật thủ công các kết nối cũ đang chờ hoặc đã bị từ chối. Khi nhận DENIED, kiểm tra reason, detail và connection. Kết nối lại không tự cấp quyền.
- Nếu AI cho biết không nhận được nhật ký lượt chạy, nghĩa là lệnh đã in ra giá trị. Đọc nhật ký đã che trong mục Lượt chạy gần đây của thẻ AI và sửa lệnh để lệnh không in giá trị.
- Windows curl dùng Schannel bỏ qua SSL_CERT_FILE. Truyền đường dẫn đó bằng --cacert trong tiến trình được duyệt. Chỉ dùng --ssl-revoke-best-effort khi danh sách thu hồi thiếu hoặc ngoại tuyến; không dùng --insecure. Cân nhắc WSL cho Windows gh. Chữ ký AWS cần carrier phù hợp như env hoặc file. Với docker login, tiến trình có thể đọc tệp của carrier file vào --password-stdin. Xóa DOCKER_CONFIG tạm sau khi dùng.
- Để được hỗ trợ, hãy gửi nội dung lỗi, hệ điều hành, phiên bản ứng dụng và các bước tái hiện. Không gửi mật khẩu, tệp kho, giá trị bí mật hoặc mã thông báo kết nối.
Bossanova không kiểm soát hệ điều hành hay các chương trình khác. Việc cấp cho AI quyền truy cập rộng vào chức năng quản trị viên, tệp, màn hình hoặc bộ nhớ, hay việc máy tính bị xâm nhập, có thể làm lộ thông tin qua các đường khác. Hãy xem hướng dẫn bảo vệ bí mật để biết chi tiết.