Quản lý giao diện và phiên làm việc

Chương này trình bày mô hình tổ chức của VelaTerm: bố cục cửa sổ, cách quản lý cây dự án, cách hoạt động của thẻ và khung chia, chấm trạng thái và bộ lọc, lưu trữ, tìm kiếm toàn cục và lưu không gian làm việc khi thoát. Các chương khác đều dựa trên những nội dung này.

1. Bố cục

Truy cập từ xa và Kết nối máy chủ từ xa có trong ứng dụng máy tính; xem Phát triển và quản lý từ xa. Nút Phản hồi mở trang phản hồi của VelaTerm trong trình duyệt. Trên Windows và Linux, nhấn Alt để hiện thanh menu gồm Tệp, Terminal và Trợ giúp.

Có thể ẩn cả hai bảng bên bằng các nút trên thanh tiêu đề và thay đổi độ rộng bằng cách kéo cạnh của bảng.

2. Cây dự án: dự án, bộ sưu tập, nhóm, phiên

• Dự án là một thư mục trên ổ đĩa và là gốc của một nhánh cây. Có thể tạo dự án bằng “Tạo dự án” (tạo thư mục mới), “Nhập dự án” (mở thư mục có sẵn, ⌘O) hoặc “Sao chép từ Git”.
• Bộ sưu tập là vùng chứa cấp cao nhất không gắn với thư mục nào, dành cho các phiên không thuộc riêng một dự án. Tạo bộ sưu tập bằng nút “Bộ sưu tập mới” ở cuối thanh bên.
• Nhóm là nút dùng để sắp xếp và có thể lồng nhau với số cấp tùy ý.
• Phiên là đơn vị làm việc: một tác nhân, một trang web hoặc một terminal. Thư mục làm việc của phiên mặc định là thư mục gốc của dự án và có thể thay đổi trong biểu mẫu “Chỉnh sửa” của phiên.

Khi di chuột lên một dòng, nút ＋ sẽ xuất hiện (“Phiên mới” với dự án và nhóm, “Phiên con mới” với phiên); riêng dự án và nhóm còn có thêm nút tạo nhóm mới.

Phần lớn thao tác nằm trong menu ngữ cảnh:

Menu của dự án và nhóm bắt đầu bằng các mục tạo mới:

• “Trang trình duyệt mới” (ứng dụng máy tính) và “Terminal mới”; “Terminal mới” mở một terminal nháp trong thư mục tương ứng (§5).
• Ba mục “Phiên … mới” cho các tác nhân dùng gần đây, và “Thêm phiên tác nhân” chứa mọi tác nhân, các cấu hình sẵn đã lưu, “Phiên tác nhân mới” (bộ chọn có ô tìm kiếm) và “Tạo mới với đối số khởi chạy…”.
• “Phiên worktree mới…” và “Phiên lập kế hoạch/thực hiện mới…”; xem Tạo phiên và hợp tác Git và Lập kế hoạch và thực hiện.
• “Nhập phiên…” (chỉ có ở dự án) và “Tiếp tục phiên…”; xem Phiên tác nhân AI §4.

Tiếp theo, menu của dự án có “Nhóm mới”, “Dấu”, “Thử nghiệm” (Đồ thị mã nguồn và Kiểm toán mã nguồn), “Thông tin dự án” (hoặc “Thông tin bộ sưu tập”), “Đổi tên” và “Gỡ dự án” (hoặc “Xóa bộ sưu tập”). Menu của nhóm có menu con “Git”, “Nhóm con mới”, “Chuyển sang worktree…”, “Dấu”, “Đổi tên”, “Lưu trữ nhóm” và “Xóa nhóm”.

Menu của phiên hiển thị các mục phù hợp với loại và trạng thái của phiên:

• “Mở”, “Mở trong thẻ mới”, “Mở trong khung chia bên phải”, “Mở trong khung chia bên dưới”, “Mở trong khung đang chọn” (§4).
• “Phiên con mới”, “Phân nhánh phiên”, “Xuất phiên…”, “Tổng hợp vào kho kiến thức theo phiên” và menu con “Git”.
• “Dấu”, “Thông tin phiên” (giữ Option/Alt để xem toàn bộ lệnh khởi chạy), “Chỉnh sửa”, “Đổi tên”, “Di chuyển đến…”.
• “Dừng tiến trình” (khi phiên đang chạy), “Lưu trữ phiên”, “Xóa phiên”.

Các thao tác khác trên cây:

• Di chuyển: kéo các nút, hoặc dùng “Di chuyển đến…”. Có thể di chuyển một phiên vào dưới một phiên khác để phiên đó trở thành phiên con.
• Đổi tên: “Đổi tên” cho phép sửa tên ngay tại chỗ. Phiên chưa được đặt tên sẽ lấy tên từ tin nhắn đầu tiên của bạn.
• Dấu: “Dấu” gắn một biểu tượng cảm xúc vào dự án, nhóm hoặc phiên: 🔥 Khẩn cấp, ⭐ Quan trọng, 🐛 Lỗi, ✅ Hoàn thành, 🚧 Đang làm, 📌 Ghim, 💡 Ý tưởng, ⚠️ Chú ý. Chọn lại dấu hiện tại sẽ gỡ dấu đó.
• Chọn nhiều: ⌘/Ctrl-nhấp để chọn hoặc bỏ chọn từng phiên, Shift-nhấp để chọn một dải. Khi đó, menu ngữ cảnh có “Mở các phiên đã chọn”, “Xếp các phiên đã chọn cạnh nhau” (từ hai đến bốn phiên), “Di chuyển mục đã chọn đến…”, “Lưu trữ các phiên đã chọn” và “Xóa N mục đã chọn”. Kéo phần đã chọn sẽ di chuyển toàn bộ các mục đó.
• Trạng thái thu gọn của cây được giữ nguyên sau khi khởi động lại.

3. Thẻ

Cài đặt ▸ Hành vi ▸ “Thẻ” quyết định cách mở phiên:

• Đơn (mặc định): khi nhấp vào một phiên tác nhân trong cây, VelaTerm dùng lại thẻ phiên hiện tại, giống như khi đi theo một liên kết trong trình duyệt. Thẻ vừa rời đi chuyển xuống nền cùng toàn bộ các khung của thẻ, và các tiến trình của thẻ vẫn tiếp tục chạy. Phiên terminal luôn mở trong thẻ riêng.
• Nhiều: mỗi phiên mở trong một thẻ riêng.

“Mở trong thẻ mới” luôn mở một thẻ mới. Ở cả hai chế độ, việc chuyển sang thẻ khác không dừng bất cứ thứ gì; đóng thẻ (⌘W hoặc ×) mới kết thúc các tiến trình của thẻ đó. Với phiên tác nhân, việc này an toàn: cuộc hội thoại được giữ lại, và khi mở lại nút, hội thoại sẽ tiếp tục.

Thẻ nền hiển thị trên thanh trạng thái dưới dạng “Nền N/M”; nhấp vào đó để mở lại một thẻ hoặc kết thúc thẻ. Ở chế độ Đơn, “Giới hạn nền” (mặc định 32) giới hạn số thẻ nền. Khi vượt giới hạn, thẻ nền cũ nhất không hoạt động sẽ tự động kết thúc. Nếu mọi thẻ nền đều đang làm việc hoặc đang chờ bạn, VelaTerm sẽ hỏi bạn muốn kết thúc thẻ nào.

Chi tiết về thanh thẻ:

• ⌘1–9 (Ctrl+1–9 trên Windows và Linux) chuyển tới thẻ theo vị trí. Nhấp chuột giữa để đóng thẻ.
• Nút ＋ sau các thẻ mở một terminal nháp. Các nút ở bên phải lần lượt mở terminal mới, tài liệu mới, thẻ trình duyệt tích hợp (ứng dụng máy tính) và Trung tâm trò chơi.
• Menu ngữ cảnh của thẻ có “Đóng thẻ”, “Đóng các thẻ khác”, “Đóng các thẻ bên phải”, “Đóng tất cả thẻ”, “Chuyển xuống nền” (giữ các tiến trình của thẻ tiếp tục chạy), cùng các mục của phiên giống như trong cây.

Thẻ tài liệu và thẻ trình duyệt được trình bày trong chương Thẻ tài liệu và thẻ trình duyệt.

4. Chia khung

Một thẻ có thể chứa nhiều khung:

• ⌘D chia sang phải và ⌘⇧D chia xuống dưới (Ctrl+Alt+D và Ctrl+Alt+E trên Windows và Linux); thanh tiêu đề của khung cũng có các nút tương ứng. Khung mới là một terminal nháp, khởi động trong thư mục làm việc của khung hiện tại.
• Để hiển thị một phiên có sẵn trong thẻ hiện tại, hãy dùng “Mở trong khung chia bên phải”, “Mở trong khung chia bên dưới” hoặc “Mở trong khung đang chọn” trong menu của phiên đó, hoặc kéo phiên từ thanh bên thả vào khung giữa.
• “Xếp các phiên đã chọn cạnh nhau” sắp xếp từ hai đến bốn phiên đã chọn trong cùng một thẻ.
• Các phiên đang hiển thị ở một khung khác của thẻ hiện tại được làm nổi bật trên thanh bên.

Có thể kéo các đường phân cách. Cơ chế duy trì ở nền áp dụng cho toàn bộ thẻ, nên khi rời một thẻ rồi quay lại, bố cục của thẻ vẫn được giữ nguyên. ⌘W đóng khung hiện tại; đóng khung cuối cùng sẽ đóng luôn thẻ.

5. Terminal nháp

“Terminal mới”, ⌘T và nút ＋ trên thanh thẻ đều mở một terminal nháp. Terminal nháp chỉ tồn tại dưới dạng thẻ: không bao giờ trở thành nút trong cây và bị loại bỏ khi đóng. Thẻ này được đánh dấu “nháp”. Hãy dùng terminal nháp cho các lệnh nhanh, còn công việc chạy lâu nên đặt trong phiên tác nhân. Menu của terminal nháp khá ngắn: “Mở”, “Mở trong thẻ mới”, các mục chia khung, “Đổi tên”, “Thông tin phiên” và “Đóng bản nháp”.

6. Chấm trạng thái và bộ lọc

Chấm bên cạnh mỗi phiên tác nhân cho biết trạng thái của phiên: xanh lá khi đang làm việc, vàng khi cần bạn, đỏ tím khi tác nhân đã trả lời và bạn đã xem. Bảng chú giải đầy đủ có trong chương Phiên tác nhân AI §3.

Thanh trạng thái cho biết có bao nhiêu phiên “Đang làm việc”, “Đang chờ” (cần bạn) và “Đã xem”; bộ đếm nào không có phiên sẽ bị ẩn. Nhấp vào một bộ đếm để thanh bên chỉ hiển thị các phiên đó; nhấp lần nữa để bỏ bộ lọc.

Thanh bên có các công cụ riêng:

• Ô tìm kiếm (“Tìm phiên / nhóm…”) lọc cây theo tên.
• Nút lọc (“Lọc theo trạng thái”) cho phép chọn một hoặc nhiều trạng thái, và chọn riêng một dấu.
• Bộ lọc trạng thái giữ lại những phiên khớp tại thời điểm bạn đặt bộ lọc, để danh sách không liên tục thay đổi trong lúc bạn làm việc. Khi bật “Tự động thêm vào bộ lọc trạng thái” (Cài đặt ▸ Hành vi, mặc định bật), các phiên bắt đầu khớp sau đó sẽ được thêm vào. “Làm mới bộ lọc trạng thái” ở cuối thanh bên kiểm tra lại mọi phiên; “Làm mới trạng thái” trong menu của một phiên chỉ kiểm tra riêng phiên đó.
• “Chia chế độ xem cây xuống dưới” ở cuối thanh bên thêm một chế độ xem cây thứ hai với ô tìm kiếm và bộ lọc riêng, ví dụ một chế độ xem cho các phiên cần bạn và một chế độ xem cho toàn bộ cây. Có thể đóng từng chế độ xem được thêm vào.

7. Bảng bên phải

• Files: cây tệp của thư mục làm việc của phiên. Nhấp đúp vào một tệp để mở tệp đó trong thẻ tài liệu.
• Info: chi tiết phiên, mức sử dụng tài khoản, lượt hiện tại và mức sử dụng tài nguyên; xem Phiên tác nhân AI §8.
• Git: nhánh, các thay đổi đã stage và chưa stage, tệp chưa theo dõi, tạo commit và lịch sử commit.
• Kho kiến thức: kho kiến thức theo phiên, các phiên đã lưu trữ và các cơ sở tri thức cục bộ của bạn; xem Cơ sở tri thức cục bộ và Kho kiến thức theo phiên.

8. Lưu trữ: cất đi, không xóa

Công việc đã xong không cần phải xóa. Nhấp chuột phải vào một phiên → “Lưu trữ phiên” để ẩn phiên đó: phiên và các phiên con rời khỏi cây, các tiến trình của chúng kết thúc, nhưng toàn bộ dữ liệu vẫn được giữ lại. “Lưu trữ nhóm” lưu trữ mọi phiên trong một nhóm, còn “Lưu trữ các phiên đã chọn” lưu trữ các phiên đang được chọn.

Phiên đã lưu trữ nằm trong kho kiến thức. Mở chúng bằng nút “Phiên đã lưu trữ” ở đầu thanh bên. Phiên đã lưu trữ được nhóm theo dự án, và ô tìm kiếm (“Tìm nội dung đã lưu trữ…”) tìm trong nội dung của chúng. Với mỗi phiên đã lưu trữ:

• Có thể đọc lại cuộc hội thoại. Phiên tác nhân hiển thị các tin nhắn; khi không có hội thoại, bản ghi terminal sẽ được hiển thị nếu có. Thẻ thứ hai liệt kê các mục kiến thức được tạo từ phiên này.
• “Khôi phục thành phiên thường” đưa phiên về đúng vị trí cũ trong cây và giữ nguyên ID hội thoại, nên khi mở phiên, cuộc hội thoại ban đầu sẽ được tiếp tục.
• “Tổng hợp vào kho kiến thức theo phiên” trích xuất những kiến thức có thể tái sử dụng từ phiên.
• “Xuất toàn bộ ngữ cảnh dưới dạng Markdown” (Claude và Codex) ghi toàn bộ cuộc hội thoại ra một tệp.
• “Xóa vĩnh viễn (kèm bản ghi)” là thao tác duy nhất xóa dữ liệu.

9. Tìm kiếm toàn cục (⌘⇧F)

“Tìm mọi phiên” (⌘⇧F; Ctrl+Alt+G trên Windows và Linux) tìm trong nội dung của mọi phiên: hội thoại của tác nhân và đầu ra terminal đã được ghi lại, không chỉ tên phiên.

• Có thể kết hợp nhiều từ theo thứ tự bất kỳ; từ chưa đầy đủ và văn bản tiếng Trung, tiếng Nhật hoặc tiếng Hàn cũng được tìm thấy. Kết quả được xếp theo mức độ liên quan.
• Kết quả được nhóm theo phiên ở bên trái; phần xem trước ở bên phải làm nổi bật kết quả khớp hiện tại. ↑/↓ và Enter chuyển qua các kết quả khớp trên nhiều phiên.
• “Mở phiên” mở phiên trong không gian làm việc.
• Phiên đã lưu trữ không được tìm, trừ khi bạn đánh dấu “Bao gồm đã lưu trữ”.

Chỉ có thể tìm trong đầu ra terminal khi tính năng ghi phiên được bật (Cài đặt ▸ Nâng cao ▸ “Ghi nhật ký phiên”, mặc định tắt). Hội thoại của tác nhân thì luôn tìm được.

10. Xóa an toàn

Xóa một phiên sẽ xóa vĩnh viễn phiên đó cùng bản ghi của phiên. Khi bạn xóa một nhóm hoặc dự án có chứa phiên đã lưu trữ, các phiên đã lưu trữ đó vẫn được giữ lại, và khi khôi phục một phiên, dự án và nhóm của phiên cũng được khôi phục. Nếu còn phân vân, hãy lưu trữ trước: nội dung đã lưu trữ luôn có thể khôi phục.

11. Thoát và khôi phục không gian làm việc

Khi thoát, VelaTerm hỏi “Thoát VelaTerm?” và dừng các phiên terminal và phiên tác nhân đang chạy. Nếu đánh dấu “Lưu không gian làm việc”, lần khởi động sau sẽ mở lại đúng các thẻ và khung chia đó. Các phiên được khôi phục không tự khởi động: mỗi khung hiển thị “Đã khôi phục từ không gian làm việc đã lưu. Chưa có tiến trình nào chạy.” cùng nút “Khởi động”. Ô đánh dấu này ghi nhớ lựa chọn gần nhất của bạn.