Dvina MCP

Sử dụng lệnh dvina

Tìm hiểu lệnh dvina làm gì khi Dvina chạy mã cho bạn, các lệnh có sẵn và những lệnh cần bạn phê duyệt.

Xem dạng Markdown

Khi Dvina chạy mã hoặc lệnh cho bạn, Dvina có một lệnh riêng: dvina. Với lệnh này, một tập lệnh hoặc một chuỗi bước có thể tìm kiếm trong Dvina của bạn, đọc và thêm tài liệu, bộ nhớ và tác vụ, cũng như kiểm tra ai có quyền truy cập vào một mục, dưới danh tính của bạn.

Bạn không cần cài đặt hay đăng nhập. Dvina dùng lệnh này khi yêu cầu của bạn cần đến, và bạn cũng có thể yêu cầu trực tiếp, chẳng hạn: "Dùng dvina để liệt kê các tác vụ của tôi và viết bản tóm tắt dưới dạng ghi chú."

Cách hoạt động

  • dvina hoạt động trên Dvina của bạn, dưới danh tính của bạn, trong phạm vi quyền mà vai trò của bạn cho phép và các giới hạn thông thường của bạn.
  • Quyền truy cập chỉ có hiệu lực trong thời gian Dvina xử lý yêu cầu của bạn. Khi câu trả lời kết thúc, lệnh không còn truy cập được Dvina của bạn.
  • Lệnh chỉ đọc tệp hoặc thư mục khi tên tệp hoặc thư mục đó được chỉ định trong lệnh, chẳng hạn như tệp cần tải lên.

Các lệnh

Các lệnh được chia thành nhóm: dvina <group> <command>, theo sau là các đối số và cờ của lệnh.

Nhóm Các lệnh
search dvina search <query>: tìm kiếm đồng thời trong các cuộc trò chuyện, tài liệu, bộ nhớ và thế giới của bạn.
memory ls, show, add, edit: liệt kê, đọc, thêm hoặc thay đổi các tệp bộ nhớ của bạn.
world topics, topic, recall, feed: các chủ đề của bạn, những gì Dvina biết về một điều gì đó và Bảng tin của bạn.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: các tài liệu và thư mục trong Thư viện của bạn.
canvas ls, show, create, write-page: liệt kê, đọc, tạo hoặc viết lại các trang canvas.
tasks ls, show, start, continue, stop: các tác vụ chạy nền của bạn.
goals show, start: các tác vụ hướng đến một mục tiêu.
schedule ls, add, cancel: tin nhắn và lời nhắc được lên lịch, một lần hoặc lặp lại.
agents ls, show, create, update: các tác nhân của bạn.
skills ls, show, add, edit: các kỹ năng của bạn.
projects ls, show: các dự án của bạn.
settings get, set: các tùy chọn của bạn, như bật hoặc tắt bộ nhớ.
share state, with-me, add, rm: ai có quyền truy cập vào một mục, những gì người khác đã chia sẻ với bạn, và việc cấp hoặc thu hồi quyền truy cập.

dvina không thể xóa vĩnh viễn bất cứ thứ gì, mở liên kết công khai, kết nối hoặc ngắt kết nối ứng dụng, hay thay đổi cài đặt quản trị hoặc thanh toán.

Trợ giúp và đầu ra

  • dvina --help liệt kê các nhóm, dvina <group> --help liệt kê các lệnh trong một nhóm, và dvina <group> <command> --help liệt kê các đối số và cờ của một lệnh.
  • Đầu ra là văn bản ngắn gọn. Thêm --json để nhận JSON, hoặc --fields kèm danh sách phân cách bằng dấu phẩy, như --fields id,title, để chỉ giữ lại một số trường.
  • Danh sách dài kết thúc bằng next: --cursor <c>. Chạy lại lệnh với --cursor đó để lấy trang tiếp theo.
  • Để đọc một giá trị từ tệp, thêm -file vào cờ tương ứng, như --content-file notes.md. dvina docs upload <file> tải một tệp lên, và dvina skills add <folder> thêm một thư mục kỹ năng cùng với tệp SKILL.md của thư mục đó.

Mã thoát

Mã Ý nghĩa
0 Hoàn tất.
1 Đã xảy ra lỗi khác.
2 Lệnh không đúng. Kiểm tra --help của lệnh.
3 Không tìm thấy.
4 Bị từ chối: quyền truy cập của bạn, quy định của công ty hoặc cơ chế bảo vệ dữ liệu không cho phép.
5 Cần bạn phê duyệt.
6 Bạn đã đạt giới hạn sử dụng.

Phê duyệt thay đổi

  • Các lệnh đọc chạy mà không cần hỏi bạn.
  • Các lệnh thêm nội dung mới, như docs create, memory add hoặc tasks start, chạy mà không cần hỏi bạn. Các lệnh này không bao giờ thay đổi nội dung đã có.
  • Các lệnh thay đổi hoặc xóa nội dung sẽ hỏi bạn trước: di chuyển, đổi tên, chuyển vào thùng rác, thay thế ghi chú hoặc tệp bộ nhớ, viết lại trang canvas, thay đổi tác nhân hoặc kỹ năng, dừng tác vụ, hủy tin nhắn đã lên lịch và chia sẻ. Dvina hiển thị một thẻ phê duyệt trong cuộc trò chuyện kèm bản tóm tắt thay đổi do Dvina viết, và hỏi bạn mỗi lần. Nếu bạn từ chối, sẽ không có gì thay đổi.

Những gì dvina thêm hoặc thay đổi đều được kiểm tra theo quy định bảo vệ dữ liệu của công ty bạn và được ghi vào nhật ký kiểm tra của bạn, giống như các hành động khác của Dvina.