Hướng dẫn Capri: Điều khiển tệp, dự án và mã bằng tác nhân AI trên Windows

Capri là gì?

Capri là một tác nhân AI mã nguồn mở cho Windows với chủ đề cyberpunk. Công cụ cung cấp giao diện máy tính để bàn gốc để làm việc với tệp, thư mục dự án, mã nguồn, công cụ shell, ứng dụng và web thông qua trợ lý AI. Thay vì viết lệnh terminal, bạn mô tả mục tiêu bằng ngôn ngữ tự nhiên và để Capri điều phối công việc.

Capri đóng vai trò là lớp giao diện và công cụ, còn một trợ lý bên ngoài cung cấp khả năng suy luận AI. Công cụ hỗ trợ sẵn Claude Code, Codex và Antigravity. Bạn có thể kết nối các trợ lý khác thông qua bộ điều hợp tùy chỉnh.

Capri là một dự án độc lập, không chính thức do người hâm mộ thực hiện, lấy cảm hứng từ thể loại cyberpunk và Cyberpunk: Edgerunners. Dự án không liên kết hoặc được CD PROJEKT RED, Netflix, Studio Trigger, Anthropic, OpenAI hay Google chứng nhận.

Tính năng chính

• Nhiều engine AI: Kết nối Claude Code, Codex, Antigravity hoặc một trợ lý khác thông qua bộ điều hợp tùy chỉnh.
• Giao diện Windows gốc: Sử dụng ứng dụng máy tính để bàn đã cài đặt thay vì làm việc trực tiếp trong terminal.
• Công cụ tệp và dự án: Tìm, đọc, sắp xếp và chỉnh sửa tệp hoặc toàn bộ thư mục dự án.
• Quy trình tác nhân: Capri có thể lập kế hoạch, yêu cầu công cụ, kiểm tra kết quả và báo cáo những gì đã thực hiện.
• Hỗ trợ mã nguồn: Yêu cầu engine đã chọn viết, tái cấu trúc, gỡ lỗi và chạy mã.
• Kiểm soát phê duyệt: Xem xét các hành động nhạy cảm và phê duyệt hoặc từ chối trước khi Capri thay đổi hệ thống.
• Phạm vi có thể cấu hình: Giới hạn quyền truy cập vào các thư mục đã chọn và chọn chế độ hỏi, tự động hoặc chỉ đọc.

Yêu cầu

Hiện tại Capri yêu cầu Windows 10 trở lên. Phần mềm được phân phối dưới dạng trình cài đặt Windows .exe. Các phiên bản macOS và Linux có trong lộ trình dự án nhưng hiện chưa khả dụng.

Bạn cũng cần tài khoản trợ lý AI được hỗ trợ hoặc khóa API của riêng mình. Bản thân Capri là mã nguồn mở theo Giấy phép MIT, nhưng nhà cung cấp AI được kết nối có thể tính phí sử dụng theo bảng giá riêng.

Cài đặt Capri trên Windows

1. Tải trình cài đặt

Mở bản phát hành Capri mới nhất và tải xuống Capri-Setup.exe. Hãy sử dụng trang phát hành của kho lưu trữ chính thức thay vì nguồn tải xuống bên thứ ba không rõ ràng.

2. Chạy trình hướng dẫn cài đặt

1. Mở Capri-Setup.exe.
2. Làm theo trình hướng dẫn cài đặt.
3. Sau khi cài đặt, mở Capri từ menu Start của Windows.

Vì Capri là một ứng dụng mới và có thể chưa có danh tiếng tải xuống rộng rãi, Windows SmartScreen có thể hiển thị cảnh báo. Nếu bạn tải trình cài đặt từ trang phát hành chính thức, hãy chọn More info, sau đó chọn Run anyway để tiếp tục.

3. Kết nối engine AI

Trong lần khởi chạy đầu tiên, Capri yêu cầu bạn chọn một trợ lý. Chọn Claude Code, Codex, Antigravity hoặc tùy chọn được hỗ trợ khác, sau đó đăng nhập hoặc cung cấp khóa API được yêu cầu.

Các yêu cầu của bạn được xử lý bởi trợ lý mà bạn kết nối. Do đó, điều khoản, chính sách quyền riêng tư, giá cả và quy định tài khoản của nhà cung cấp sẽ áp dụng cho quá trình xử lý đó.

Cách Capri xử lý một tác vụ

1. Bạn mô tả mục tiêu: Nhập yêu cầu bằng ngôn ngữ tự nhiên trong ứng dụng máy tính để bàn.
2. Capri chọn engine: Yêu cầu được chuyển đến trợ lý AI đã cấu hình.
3. Engine tạo kế hoạch: Trợ lý xác định các bước và công cụ cần thiết.
4. Capri hiển thị các hành động nhạy cảm: Tùy thuộc vào quyền của bạn, bạn có thể xem xét các thao tác tệp hoặc hệ thống được yêu cầu.
5. Bạn phê duyệt hoặc từ chối: Các hành động được phê duyệt sẽ được thực hiện thông qua lớp công cụ của Capri.
6. Capri báo cáo kết quả: Tác nhân kiểm tra kết quả và tóm tắt những gì đã thực hiện.

Ví dụ sử dụng cơ bản

Sắp xếp một thư mục

Để dọn dẹp một thư mục, hãy xác định vị trí mục tiêu và mô tả cách sắp xếp mong muốn:

Dọn dẹp thư mục Downloads của tôi và nhóm các tệp theo loại. Hiển thị kế hoạch trước khi di chuyển bất kỳ tệp nào.

Capri có thể quét thư mục, đề xuất kế hoạch và yêu cầu phê duyệt trước khi di chuyển tệp. Hãy xem xét cẩn thận các thư mục đích và tên tệp trước khi chấp nhận thao tác.

Điều tra và sửa mã nguồn

Mở hoặc cấp quyền truy cập vào thư mục dự án liên quan, sau đó gửi cho Capri một yêu cầu cụ thể:

Tìm lỗi trong dự án này, giải thích nguyên nhân, sửa lỗi và chạy các bước kiểm tra hiện có.

Engine AI đã chọn có thể kiểm tra mã nguồn, xác định vấn đề có khả năng xảy ra, chỉnh sửa các tệp liên quan và chạy các bước kiểm tra. Để xem xét an toàn hơn, hãy yêu cầu Capri giải thích thay đổi được đề xuất trước khi cho phép công cụ sửa đổi dự án.

Tóm tắt tài liệu

Capri có thể làm việc với nhiều tệp trong một thư mục được cấp phép. Ví dụ:

Tóm tắt mọi tệp PDF trong thư mục này và viết một tài liệu tóm tắt tổng hợp.

Trước khi phê duyệt tác vụ, hãy xác minh thư mục mà Capri sẽ đọc và vị trí dự kiến lưu tài liệu được tạo.

Tạo một dự án web

Bạn cũng có thể yêu cầu một quy trình phát triển hoàn chỉnh:

Thiết lập một ứng dụng web mới trong thư mục này, cài đặt các phần phụ thuộc và khởi chạy ứng dụng.

Loại yêu cầu này có thể bao gồm việc tạo tệp, tải gói, chạy lệnh shell và khởi chạy một tiến trình. Hãy kiểm tra framework, các lệnh và thư mục đích được đề xuất trước khi phê duyệt.

Cấu hình quyền và phạm vi

README cung cấp cấu hình mẫu sau:

engine: claude-code

permissions:
  mode: ask
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

Giá trị engine chọn trợ lý được kết nối. Các giá trị được ghi nhận gồm claude-code, codex, antigravity và custom.

Phần quyền truy cập hỗ trợ ba chế độ được ghi nhận:

• ask: Capri hỏi trước khi thực hiện. Đây là lựa chọn khởi đầu tốt nhất khi tìm hiểu cách tác nhân hoạt động.
• auto: Các tác vụ có thể tự động tiếp tục. Chỉ sử dụng khi bạn hiểu rõ nhiệm vụ và đã giới hạn chặt chẽ phạm vi của nó.
• read-only: Sử dụng Capri để kiểm tra và phân tích mà không cho phép chỉnh sửa.

Danh sách allowed_folders giới hạn các vị trí mà tác nhân có thể truy cập. Nên cấp quyền cho một thư mục làm việc cụ thể thay vì toàn bộ ổ đĩa hoặc hồ sơ người dùng.

Mẹo nâng cao

Viết lời nhắc với ranh giới rõ ràng

Nêu rõ thư mục đích, kết quả mong muốn, phương thức xác thực và các thao tác cần xác nhận. Một yêu cầu chính xác sẽ giảm sự mơ hồ:

Review the project in my Projects folder. Identify the cause of the failing tests, explain your proposed edits, and wait for approval before changing files. After approval, run the existing test suite.

Bắt đầu ở chế độ chỉ đọc

Đối với một kho lưu trữ hoặc bộ tài liệu chưa quen thuộc, hãy bắt đầu với quyền read-only. Yêu cầu Capri kiểm tra tài liệu và đề xuất kế hoạch. Chỉ thay đổi chế độ quyền khi bạn sẵn sàng cho phép chỉnh sửa.

Sử dụng thư mục dự án biệt lập

Sao chép công việc thử nghiệm vào một thư mục riêng và chỉ cấp cho Capri quyền truy cập thư mục đó. Điều này hạn chế các thay đổi ngoài ý muốn và giúp dễ dàng xem xét những khác biệt trong các tệp kết quả.

Tách biệt lập kế hoạch và thực thi

Đối với các nhiệm vụ lớn, trước tiên hãy yêu cầu lập kế hoạch mà không chỉnh sửa. Xem xét các bước, sau đó đưa ra chỉ dẫn thứ hai chỉ cho phép phần đã được phê duyệt. Cách này đặc biệt hữu ích đối với các thao tác hàng loạt trên tệp, cài đặt dependency hoặc tái cấu trúc trên diện rộng.

Chuyển đổi engine khi phù hợp

Capri cho phép bạn lựa chọn giữa các engine AI được hỗ trợ. Nếu bạn có tài khoản của nhiều trợ lý, hãy chọn trợ lý phù hợp nhất với nhiệm vụ hiện tại. Hãy nhớ rằng mỗi nhà cung cấp có khả năng, chi phí và điều khoản bảo mật riêng.

Thận trọng khi sử dụng adapter tùy chỉnh

Các trợ lý khác có thể được tích hợp thông qua adapter tùy chỉnh. Khi sử dụng một adapter, hãy kiểm tra cách nó xử lý thông tin xác thực, yêu cầu, lệnh gọi công cụ và dữ liệu trả về. README không cung cấp hướng dẫn triển khai adapter, vì vậy hãy tham khảo tài liệu hiện tại của dự án hoặc tài nguyên dành cho người đóng góp trước khi xây dựng tích hợp.

Đừng cho rằng mọi tính năng trong lộ trình đều đã có

Lộ trình liệt kê hệ thống plugin, điều khiển bằng giọng nói, bộ lập lịch tác vụ, thư viện giao diện và các phiên bản macOS và Linux là những tính năng dự kiến chứ chưa hoàn thiện. Hãy kiểm tra ghi chú phát hành mới nhất trước khi thiết kế quy trình dựa trên các tính năng đó.

Hướng dẫn an toàn

• Xem xét mọi thao tác nhạy cảm: Đặc biệt chú ý đến việc xóa, di chuyển, thay thế, chạy lệnh shell và cài đặt dependency.
• Giới hạn quyền truy cập thư mục: Chỉ cung cấp các tệp cần thiết cho nhiệm vụ hiện tại.
• Duy trì bản sao lưu: Sao lưu dữ liệu quan trọng trước khi tổ chức hàng loạt, chỉnh sửa tự động hoặc thực hiện các thao tác lớn khác.
• Bảo vệ thông tin xác thực: Không bao giờ chia sẻ khóa API, token tài khoản hoặc các bí mật khác.
• Kiểm tra lệnh được tạo: Hiểu rõ một lệnh shell trước khi cho phép Capri chạy lệnh đó.
• Sử dụng hệ thống kiểm soát phiên bản: Đối với các dự án mã nguồn, hãy commit hoặc lưu giữ trạng thái hiện tại theo cách khác trước khi yêu cầu chỉnh sửa đáng kể.

Nếu phát hiện vấn đề bảo mật, hãy làm theo hướng dẫn báo cáo bảo mật của dự án và báo cáo riêng tư.

Khắc phục sự cố và tài nguyên dự án

Nếu trình cài đặt, kết nối engine hoặc quy trình tác nhân không hoạt động như mong đợi, hãy kiểm tra kho Capri trên GitHub và ghi chú phát hành mới nhất. Bạn có thể gửi lỗi và ý tưởng tính năng thông qua biểu mẫu issue của dự án.

Dự án hoan nghênh các đóng góp trong những lĩnh vực như báo cáo lỗi, tài liệu, giao diện, đề xuất tính năng và adapter engine. Hãy xem hướng dẫn đóng góp của kho lưu trữ trước khi gửi thay đổi.

Kết luận

Capri cung cấp cho người dùng Windows một giao diện máy tính để điều khiển các trợ lý AI được hỗ trợ làm việc với tệp, dự án và mã nguồn. Hãy cài đặt ứng dụng, kết nối engine bạn muốn, giới hạn quyền truy cập vào những thư mục cần thiết và bắt đầu với quyền yêu cầu phê duyệt hoặc chỉ đọc. Lời nhắc rõ ràng, việc xem xét cẩn thận, bản sao lưu và ranh giới truy cập hẹp là những yếu tố thiết yếu khi cho phép bất kỳ tác nhân AI nào thực hiện thao tác trên máy tính của bạn.