Tổng quan giao diện

Sau trang này bạn sẽ nhận ra các vùng chính của cửa sổ Desktop, biết nhóm sidebar nào chứa từng bề mặt, và hiểu các con số trên Dashboard có nghĩa gì và không có nghĩa gì.

Đọc bố cục cửa sổ

Cửa sổ có ba vùng cố định: sidebar bên trái để điều hướng, thanh trên cùng cho vị trí hiện tại và bộ lọc, và panel chính cho bề mặt đang chọn. Hàng trạng thái ở đáy sidebar hiển thị phiên bản App và CLI cùng chỉ báo sync cục bộ. Khi cửa sổ đủ rộng, rail Assistant có thể thu gọn nằm ở mép phải để chat theo kiểu bring-your-own-key về usage cục bộ của bạn.

Sidebar nhóm các bề mặt theo mục đích:

Thanh trên cùng hiển thị breadcrumb của bề mặt hiện tại, một bộ lọc runtime và ô tìm kiếm. Chọn một project đã đăng ký trong sidebar sẽ mở project dashboard của nó thay vì hiển thị dạng tổng thể.

Nhấn Cmd+K trên macOS hoặc Ctrl+K trên Windows và Linux, hoặc chọn ô tìm kiếm, để mở bảng tìm kiếm. Bảng này tìm các trang, gồm Tổng quan (Overview) và Bảng điều khiển (Dashboard), cùng project, agent, command và skill, theo ngôn ngữ giao diện bạn đã chọn. Dùng phím mũi tên để di chuyển, Enter để mở kết quả và Esc để đóng. Nếu một trong các nguồn đó không đọc được, bảng hiển thị Không thể tải một số nguồn tìm kiếm và vẫn hiện kết quả từ các nguồn còn lại.

Biểu tượng chuông trên thanh trên cùng mở Notifications. Nó báo khi có bản cập nhật AgentKit, khi file của một project lệch khỏi manifest của kit, và khi có run hoặc thao tác ghi thất bại trong 50 sự kiện Activity mới nhất; một badge đỏ đếm số mục chưa đọc. Chọn một mục sẽ đánh dấu đã đọc và mở Settings, Projects hoặc Activity để bạn xử lý. Dismiss ẩn mục đó. Trạng thái đã đọc và đã ẩn được lưu dưới AGENTKIT_HOME, nên Desktop và browser dashboard dùng chung. Khi không có gì cần xử lý, panel hiển thị Nothing to flag.

Secrets chỉ xuất hiện trong ứng dụng Desktop, không có trong browser dashboard. Một vài trang khác có chi tiết đáng biết:

• Profile hiển thị một Builder card với số liệu tổng hợp (Sessions, Tokens, Skill runs, Active days, skill hàng đầu và agent hàng đầu) cùng một lưới hoạt động trong 26 tuần gần nhất. Card được làm ra để chia sẻ, nên không bao giờ chứa email, tên project, đường dẫn hay nội dung session. Skill hàng đầu chỉ hiện tên khi một kit AgentKit đã cài cung cấp skill đó; skill tuỳ chỉnh và skill của project vẫn giữ số đếm nhưng hiển thị dưới nhãn chung Skill tùy chỉnh. Download PNG lưu card thành ảnh và Copy image sao chép nó.
• Feedback liệt kê các report bạn đã gửi từ máy này trong Your reports; xem Cài đặt và hệ thống.
• Activity có hai chế độ xem Events và Stats. Events liệt kê các lần chạy skill và thao tác ghi, gồm sự kiện write.completed và write.failed từ việc cài và cập nhật kit, migration, ghi config, bật/tắt hook và liên kết MCP; bạn có thể lọc theo loại sự kiện. Bên dưới, Snapshots liệt kê các snapshot runtime home được tạo trước một số thao tác ghi, như cài, cập nhật và gỡ kit, migration, ak new và redaction session. Mỗi dòng hiển thị thời điểm, số file và dung lượng. Khôi phục vẫn là thao tác CLI vì nó ghi đè mọi thay đổi kể từ snapshot, nên Copy restore command sao chép đúng lệnh để bạn xem lại rồi chạy. Snapshot không có đường khôi phục bằng CLI sẽ hiển thị nơi lưu dữ liệu đã chụp. Ghi config và liên kết MCP giữ bản sao lưu một file riêng nên không nằm trong danh sách.
• Chi tiết của một session hiển thị Git branch, Working directory và Worktree, hoặc not recorded khi session file không ghi thông tin đó. Danh sách Applied kits hiển thị các Kit đang được cài hiện tại, không phải bộ Kit đang hoạt động khi session bắt đầu, vì session file không ghi lại điều đó.

Bắt đầu từ Tổng quan

Desktop mở trang Tổng quan (Overview), nơi gom các bước tiếp theo của bạn từ bản ghi cục bộ. Số liệu usage đã chuyển sang Bảng điều khiển (Dashboard), ngay bên dưới trong sidebar. Tổng quan có năm panel:

Mỗi dòng hiển thị project, hoặc Toàn máy · chưa gắn với dự án, runtime và Trạng thái đã ghi nhận. Kết quả chưa xác minh nghĩa là automation tự báo kết quả của nó và chưa có gì kiểm tra độc lập, nên một thành công đã ghi nhận không chứng minh vấn đề đã được khắc phục. Lần tự động cập nhật kế tiếp chạy ở lệnh CLI hợp lệ đầu tiên sau khi đến hạn, không phải vào một thời điểm được bảo đảm.

Dùng Phạm vi dự án để thu hẹp trang về một project; bộ lọc runtime trên thanh trên cùng thu hẹp theo các runtime đã chọn. Plan không gắn runtime nên bộ lọc runtime không ẩn chúng, và số đo Insights thuộc toàn máy nên phạm vi dự án không lọc chúng.

Nguồn dữ liệu ở cuối trang liệt kê từng nguồn với Khả dụng, Chưa hỗ trợ, Không thể tải hoặc Nguồn chưa báo cáo bản ghi phù hợp, kèm thời điểm kiểm tra. Một nguồn lỗi không làm ẩn các nguồn khác. Connected runtime schedules luôn hiển thị Chưa hỗ trợ: AgentKit không đọc được lịch chạy mà coding agent tự giữ, và điều đó không có nghĩa là không có lịch nào. Chọn Làm mới nguồn để đọc lại mọi nguồn.

Tổng quan chỉ đọc bản ghi có sẵn. Mở trang này không bao giờ khởi động cập nhật hay một lần chạy, và không thêm automation hay quyền nào; lịch chạy chỉ xuất hiện khi bạn đã bật chúng, ví dụ bằng ak update.

Hiểu các con số trên Dashboard

Dashboard tổng hợp usage cục bộ: token trong khoảng đã chọn, session mỗi ngày, heatmap hoạt động theo ngày, các bucket độ dài session, và phân tách theo ngày, model cùng project. Dùng nút 7d / 30d / 90d và khoảng ngày để đổi cửa sổ thời gian.

Panel Token theo subagent (Tokens by subagent) phân bổ lượng token đã dùng cho loại subagent mà một lượt ủy quyền Task hoặc Agent đã nêu tên. Các lượt ngoài một lần ủy quyền không được tính ở đó, và panel rỗng nghĩa là không có lượt ủy quyền nào được ghi nhận trong khoảng thời gian. Như mọi con số trên Dashboard, panel này được tính ngay trên máy này từ transcript session cục bộ và index analytics; AgentKit không gửi telemetry cho nó.

Card Session length được phục vụ từ cùng index analytics với các card Dashboard khác. AgentKit xếp một duration đã index cho mỗi session vào bucket khi đọc cửa sổ thời gian đã chọn, nên card không còn quét transcript riêng với giới hạn số project. Session không có duration dương đo được sẽ không nằm trong bucket nào.

Card Usage limits liệt kê các hàng theo provider (claude, codex, cursor, grok) và cửa sổ (5h, week, và monthly cho Cursor), mỗi hàng có một provenance badge và một quota bar, và tự làm mới mỗi 60 giây. Khi không có advanced polling, các hàng mang provenance raw_only — chỉ đếm token cục bộ, không có phần trăm quota bịa đặt. Hàng của Claude Code và Codex có thêm chi phí API tương đương xấp xỉ; Cursor và Grok không giữ transcript cục bộ, nên hàng của chúng hiển thị dấu gạch cho token và chỉ có số liệu từ advanced polling. Card vẫn rỗng cho tới khi index cục bộ đã đếm được usage. Desktop tự thiết lập index trừ khi bạn đã tắt nó trong tab Database của Cài đặt và hệ thống, trang này cũng nói về advanced polling cùng badge và popover trên thanh trên cùng đọc cùng dữ liệu này.

Các con số này đến từ index analytics cục bộ, không phải nguồn tính phí. Chúng reconcile bằng chứng session Claude Code và Codex được hỗ trợ khi cửa sổ đang mở, nên hãy xem đó là góc nhìn usage cục bộ chứ không phải hoá đơn.

Lọc theo runtime

Bộ lọc runtime giới hạn Subagents, Skills, MCP, Hooks, Sessions và Activity theo một coding agent. Kits, command và các con số Dashboard không được quy cho runtime nên bỏ qua bộ lọc này. Ghi chú served from index kèm nhãn generation-mismatch nghĩa là index đang lạc hậu so với trạng thái hiện tại. Desktop tự cập nhật index; để làm mới ngay, dùng Sync now trong tab Database của Settings.

Nhận biết trạng thái rỗng

Trước khi có Kit nào được cài hoặc index, Dashboard hiển thị trạng thái rỗng với Install a kit to get started và các chỉ số bằng 0. Banner Some figures could not be read nghĩa là một panel không vẽ được từ index; hãy reload để thử lại. Cả hai trạng thái đều không phải lỗi — chúng phản ánh thiết lập cục bộ chưa tạo ra dữ liệu.

Tiếp theo, tìm hiểu cách làm việc với các khối cấu thành đã cài trong Quản lý entities.