Thuật ngữ cơ bản

Tài liệu Orca ADE dùng khá nhiều thuật ngữ từ thế giới git, terminal, và AI coding agent. Nếu bạn mới bắt đầu, trang này giải thích ngắn gọn từng khái niệm hay gặp nhất, kèm link tới trang nói chi tiết hơn.

A

ADE (Agent Development Environment)

Cách Orca tự gọi bản thân - một môi trường phát triển được thiết kế xoay quanh AI coding agent, khác với IDE truyền thống vốn thiết kế cho người viết code trực tiếp. Ý tưởng cốt lõi: một ADE cần điều phối nhiều agent chạy song song (mỗi cái trong một worktree riêng), chứ không chỉ hỗ trợ một người gõ phím.

Xem thêm: Orca ADE là gì?

Agent (AI coding agent)

Một chương trình AI có thể tự đọc file, chạy lệnh, và sửa code trong một vòng lặp - khác với chatbot chỉ trả lời văn bản. Trong ngữ cảnh Orca, “agent” thường chỉ một CLI cụ thể như Claude Code, Codex, hay Cursor CLI, chạy trong một terminal và thao tác trực tiếp lên file trên đĩa.

Xem thêm: Agent & session · Các agent được hỗ trợ

B

Base ref

Branch hoặc commit mà một repository dùng làm điểm gốc mặc định - thường là origin/main. Mỗi worktree mới sẽ branch ra từ base ref của repo đó (hoặc từ một start-from ref khác nếu bạn chỉ định).

Xem thêm: Worktree trong Orca

Branch

Một nhánh phát triển độc lập trong git, cho phép nhiều dòng thay đổi tồn tại song song trên cùng một repository mà không đụng vào nhau cho tới khi merge. Mỗi worktree trong Orca gắn với một branch riêng.

C

CLI (Command-Line Interface)

Giao diện dòng lệnh - chương trình bạn điều khiển bằng cách gõ lệnh vào terminal, thay vì click chuột. Claude Code, Codex, và Cursor CLI đều là các CLI agent; Orca CLI (orca) là CLI riêng để script hoá chính app Orca.

Xem thêm: Tổng quan Orca CLI

D

Diff

Bản so sánh hiển thị chính xác dòng nào đã được thêm, xoá, hoặc sửa giữa hai phiên bản của một file (thường là giữa working tree hiện tại và một commit/branch gốc). Đọc diff kỹ là cách chính để review code do agent viết trước khi commit.

Xem thêm: Diff viewer

G

Git

Hệ thống quản lý phiên bản (version control) mà hầu hết codebase hiện đại dùng để theo dõi lịch sử thay đổi. Git là nền tảng cho hầu hết mọi khái niệm khác trong trang này - branch, commit, diff, worktree, stash đều là các khái niệm của git.

Git stash

Một lệnh git (git stash) tạm cất các thay đổi chưa commit sang một chỗ riêng, đưa working tree về trạng thái sạch, để bạn có thể chuyển branch hoặc làm việc khác rồi quay lại “lấy ra” (git stash pop) sau. Orca hạn chế nhu cầu dùng stash vì mỗi task đã có worktree riêng - bạn không cần cất thay đổi để chuyển sang việc khác, chỉ cần mở một worktree khác.

I

IDE (Integrated Development Environment)

Môi trường phát triển tích hợp - một ứng dụng gộp chung editor code, debugger, và các công cụ khác vào một chỗ (ví dụ VS Code, JetBrains). IDE truyền thống thiết kế cho một người viết code trực tiếp; xem ADE để biết Orca khác gì.

M

MCP (Model Context Protocol)

Một chuẩn mở để kết nối AI agent với các nguồn dữ liệu và dịch vụ bên ngoài - Slack, Jira, database, trình duyệt, v.v. Orca có registry skill riêng và cũng hỗ trợ đăng ký MCP server để các agent CLI hỗ trợ MCP có thể dùng.

Xem thêm: Orca skills registry & MCP

Merge conflict

Tình huống git không thể tự động gộp hai tập thay đổi vì chúng sửa cùng một chỗ theo hai cách khác nhau, đòi hỏi con người (hoặc agent) chọn giữ bản nào. Orca có UI ba chiều (three-way view) để resolve conflict trực quan, và có thể giao việc này cho agent qua Resolve with AI.

Xem thêm: Diff viewer · Commit & push từ Orca

P

Pane

Một ô chia trong cửa sổ Orca - có thể chứa terminal, editor, trình duyệt, hay diff. Kéo một tab ra cạnh của cửa sổ sẽ split thành nhiều pane hiển thị cùng lúc, hữu ích khi bạn muốn theo dõi nhiều agent song song.

Xem thêm: Tab, pane & split layout

PR (Pull Request) / MR (Merge Request)

Yêu cầu gộp thay đổi từ một branch vào branch khác (thường là vào base ref), kèm theo review, comment, và các check tự động trước khi merge. GitHub gọi là Pull Request (PR); GitLab gọi là Merge Request (MR). Orca có thể tạo, theo dõi, và review PR/MR ngay trong app.

Xem thêm: Hosted review, issue & Actions

PTY (pseudo-terminal)

Lớp giả lập terminal ở cấp hệ điều hành mà mọi ứng dụng dòng lệnh (kể cả agent CLI) chạy bên trong. Orca giữ các PTY sống ở một daemon nền, nên đóng cửa sổ app không giết agent đang chạy dở.

Xem thêm: Khôi phục session

R

Rate limit

Giới hạn số lượng request một tài khoản (GitHub, Claude, Codex…) được phép gọi trong một khoảng thời gian. Chạm giới hạn thường gây ra lỗi HTTP 403; Orca có bảng theo dõi usage riêng để cảnh báo trước khi bạn chạm ngưỡng.

Xem thêm: Usage & rate-limit tracking · Xử lý sự cố lỗi GitHub

Repo (repository)

Thư mục chứa toàn bộ lịch sử git của một dự án. Trong Orca, một repo có thể có nhiều worktree - mỗi task một bản checkout riêng - cùng trỏ về một repo gốc.

S

SSH (Secure Shell)

Giao thức kết nối an toàn tới một máy tính khác qua mạng, cho phép chạy lệnh từ xa như đang ngồi trước máy đó. Orca dùng SSH để chạy agent trên một máy remote (dev box mạnh hơn, GPU host…) trong khi editor và diff vẫn hiển thị local trên laptop của bạn.

Xem thêm: Worktree SSH · Các cách chạy Orca

Start-from ref

Branch, commit, hay ref cụ thể mà một worktree mới sẽ branch ra từ đó. Mặc định là base ref của repo, nhưng bạn có thể chọn một branch khác hoặc một commit SHA cụ thể - hữu ích khi xếp chồng công việc lên trên một PR đang review.

Xem thêm: Worktree trong Orca

T

Terminal

Cửa sổ dòng lệnh nơi bạn (hoặc một agent) gõ và chạy lệnh. Mỗi worktree trong Orca có terminal riêng, và một worktree có thể mở nhiều terminal cùng lúc (một cho agent, một để chạy npm run dev, v.v.).

Xem thêm: Terminal

W

Worktree

Đơn vị làm việc cốt lõi của Orca: một bản checkout git độc lập, trên đĩa riêng, với branch riêng - được tạo bằng lệnh git worktree chuẩn của git (không phải khái niệm riêng của Orca). Vì mỗi worktree là một thư mục thật sự tách biệt, nhiều agent có thể làm việc song song trên cùng một repo mà không giẫm chân lên file của nhau, và bạn không cần git stash khi chuyển qua lại giữa các task.

Xem thêm: Worktree trong Orca · Phiên làm việc 3 agent đầu tiên

Ghi chú của người dịch

Trang này do người biên soạn trang tổng hợp riêng cho bộ tài liệu Orca ADE, không dịch từ một trang cụ thể nào trên onorca.dev, mà rút ra từ các thuật ngữ xuất hiện xuyên suốt các trang đã dịch.