Cài đặt và hệ thống

Nhóm System chứa cấu hình mức ứng dụng và bảo trì: gửi feedback, chỉnh settings, quản lý index analytics cục bộ, thiết kế status line, và migrate provider. Sau trang này bạn sẽ biết mỗi bề mặt thay đổi gì và điều gì vẫn nằm cục bộ.

Gửi feedback an toàn

Feedback tạo một report trong issue tracker của AgentKit. Điền loại, tiêu đề, khu vực và mô tả, tuỳ chọn đính kèm bản tóm tắt chẩn đoán đã che, và xem Redacted preview trước khi gửi.

Feedback chỉ được gửi khi bạn submit. Hãy xem trước payload, và đừng bao giờ đưa vào license key, session file hay giá trị cấu hình chưa che.

Your reports liệt kê các report đã gửi từ máy này, kể cả report gửi bằng ak feedback. Mỗi dòng hiển thị trạng thái hiện tại của issue (open hoặc closed) và số bình luận, được đọc không cần xác thực từ GitHub API công khai. Chỉ 25 report gần nhất được tra cứu, và các lần tra cứu dùng chung giới hạn 8 giây; report cũ hơn, hoặc lần tra cứu thất bại hay vượt giới hạn đó, hiển thị status unavailable. Report có link đã ghi không phải link issue GitHub hợp lệ sẽ hiển thị tiêu đề không kèm link.

Chỉnh settings ứng dụng

Settings chứa tuỳ chọn App, một config editor, phần kiểm tra effective-config, và tab database. Tuỳ chọn App gồm giao diện, theme và độ rộng sidebar, cùng với:

• Content font size, chỉ phóng to hoặc thu nhỏ vùng nội dung chính;
• Sidebar project limit (All, 5, 10 hoặc 20), vượt quá số này các project còn lại sẽ được thu gọn; project đang mở luôn hiển thị;
• Default split panes, quyết định trang có thể chia đôi có mở ở chế độ split khi ứng dụng khởi động hay không; và
• Interface language (Ngôn ngữ giao diện khi giao diện đang là tiếng Việt), chọn English hoặc Tiếng Việt. Mỗi lựa chọn hiển thị phần trăm giao diện đã được dịch; phần nào chưa dịch sẽ hiện bằng tiếng Anh. Khi bạn chưa chọn, ngôn ngữ theo locale của hệ thống nếu có bản dịch cho locale đó, nếu không thì dùng tiếng Anh.

Các thay đổi này áp dụng ngay cho máy này và được ghi nhớ trên máy đó. Desktop và browser dashboard dùng chung giao diện đã dịch. Chỉ bản thân giao diện được dịch: thông báo lỗi từ CLI hoặc backend, nội dung file và tên Kit vẫn giữ nguyên như khi được tạo ra. Ngôn ngữ agent dùng để viết plan và journal là một cài đặt riêng trong config editor. Runtime mặc định và chế độ phân phối Claude Code vẫn được đánh dấu là sẽ có sau.

Tuỳ chọn giao diện là trạng thái Desktop cục bộ. Config editor thay đổi cấu hình AgentKit, nên hãy xem giá trị hiệu lực trước khi lưu.

Quản lý index analytics cục bộ

Tab Database quản lý Local analytics index vốn hậu thuẫn cho Dashboard. Công tắc Use local index bật hoặc tắt index, và Sync now cập nhật index. Phần Troubleshooting được thu gọn chứa Rebuild from scratch, tính lại index từ các nguồn session được hỗ trợ trên thiết bị này, và Delete index data, hỏi bạn xác nhận, xoá index và giữ nó tắt cho tới khi bạn bật lại.

Bạn không cần tự thiết lập index. Desktop, và browser dashboard, sẽ bật một index chưa từng được thiết lập và dựng lại một index do AgentKit ghi mà không còn đọc được. Chúng không bao giờ ghi đè lựa chọn của bạn: index bạn đã tắt hoặc đã xoá vẫn giữ nguyên như vậy. CLI ak không bao giờ tự bật index. Index chỉ cục bộ và có thể bỏ — không có gì được tải lên.

Xem giới hạn sử dụng theo provider

Badge và popover trên thanh trên cùng hiển thị cùng dữ liệu giới hạn sử dụng cục bộ như ak usage limits và card Usage limits trên Dashboard. Mở badge đó, chọn provider (claude, codex, cursor, grok hoặc all) và chọn cửa sổ (5h, week, monthly hoặc all). Hàng của Claude Code và Codex được đếm từ index analytics cục bộ; Cursor và Grok không giữ transcript cục bộ, nên hàng của chúng chỉ có số liệu khi advanced polling đang bật cho chúng.

Bản thân badge đọc là một trong bốn trạng thái — ok, warn, danger hoặc stale. Mặc định popover tự làm mới mỗi 60 giây và các hàng mang provenance raw_only: số đếm lấy thẳng từ index cục bộ, không có phần trăm quota bịa đặt. Hàng của Claude Code và Codex còn hiển thị chi phí API tương đương xấp xỉ cho số token của chúng, dựa trên giá công khai tại ngày được ghi; gói subscription không tính tiền theo token. Badge và popover vẫn rỗng cho tới khi index cục bộ đã đếm được usage; nếu bạn đã tắt index, hãy bật lại trong tab Database.

Index trống hoặc chưa dựng trả về các cửa sổ bằng 0 kèm trạng thái index, nên màn hình giải thích trạng thái rỗng thay vì hiển thị số 0 gây hiểu nhầm. Trừ khi bạn bật advanced polling, không có gì rời khỏi máy này; hãy dựng lại index từ tab Database khi các cửa sổ số liệu có vẻ cũ.

Advanced provider polling (thử nghiệm)

Advanced polling mặc định tắt. Khi bạn bật, AgentKit hỏi từng provider đang bật về phần trăm sử dụng do chính provider báo và thêm vào cùng các hàng đó. Panel Advanced polling xuất hiện trong Settings ở mọi bản build có mã polling; các bản release đều có. Không cần biến môi trường nào. Bản build được biên dịch không có advanced polling sẽ ẩn panel, và không thể bật polling ở đó.

Chuyển Advanced provider polling sang On sẽ mở hộp thoại xác nhận rủi ro. Nút Enable polling chỉ bật khi bạn đã tích cả ba mục:

• Các usage endpoint này không được công bố chính thức, và việc polling chúng có thể vi phạm điều khoản dịch vụ của provider.
• Provider có thể thay đổi hoặc gỡ bỏ endpoint bất cứ lúc nào, và khi đó polling ngừng hoạt động mà không báo trước.
• Polling có thể khiến provider giới hạn tốc độ, hạn chế hoặc tạm khoá tài khoản của bạn.

Xác nhận không được ghi nhớ: tắt rồi bật lại polling sẽ hiện lại hộp thoại, với mọi ô đều bỏ trống. Khi polling đang bật, panel hiển thị thời điểm bạn xác nhận gần nhất. Tắt polling có hiệu lực ngay lập tức.

Khi polling bật, panel hiển thị một công tắc cho từng provider — Claude Code và Codex (mặc định bật), và Cursor và Grok (mặc định tắt, vì mọi số liệu của chúng đều đến từ polling) — và Refresh interval gồm 30 s, 60 s (mặc định), 2 min hoặc 5 min. Badge, popover và card trên Dashboard làm mới theo khoảng thời gian đó. Giữa hai lần poll, mọi bề mặt đọc kết quả đã cache, và mỗi provider bị giới hạn ở mức tối đa ba request liên tiếp mỗi phút.

AgentKit dùng lại access token mà CLI chính thức đã lưu. Nó không bao giờ yêu cầu, làm mới hay ghi token.

Trên macOS, lần fetch đầu tiên sẽ hỏi bạn cho phép truy cập mục keychain của Claude Code. Nếu bạn từ chối, Claude tiếp tục hiển thị số đếm cục bộ và polling vẫn bật; bạn có thể cho phép sau trong Keychain Access, hoặc đặt ANTHROPIC_OAUTH_TOKEN thay thế.

Các hàng mà provider đã trả lời chuyển sang provenance provider_reported và hiển thị phần trăm đã dùng do provider báo; số token cục bộ vẫn giữ nguyên. Hàng của Cursor và Grok còn hiển thị thời điểm chu kỳ thanh toán được gia hạn. Khi một lần poll thất bại, các hàng giữ số đếm cục bộ và hiển thị lý do, chẳng hạn thiếu hoặc hết hạn token, bị giới hạn tốc độ, hoặc lỗi endpoint. Provider đã từng trả lời sẽ tiếp tục hiển thị giá trị gần nhất, được đánh dấu là cũ. Nếu provider từ chối token đã lưu, AgentKit tắt polling cho provider đó và đánh dấu auto-disabled; hãy làm mới token trong Claude Code hoặc Codex CLI, rồi bật lại provider. Bản build được biên dịch không có advanced polling vẫn chỉ hiển thị số đếm cục bộ.

Plan detection, mặc định bật và chỉ có tác dụng khi polling đang bật, gắn nhãn các hàng của provider bằng gói mà provider nêu trong phản hồi usage (Codex, Cursor và Grok có nêu; Claude thì không). Card thông báo gói được phát hiện thay vì âm thầm áp dụng.

Các thiết lập này nằm dưới usage_limits trong config AgentKit (~/.agentkit/config.yaml), gồm cả usage_limits.advanced.auto_detect_plan cho plan detection, và được dùng chung với ak usage limits.

Xem insight về Skill và agent

Trang Insights đọc cùng kho bằng chứng cục bộ đó: thu thập nguồn native có giới hạn, ghi lại đánh giá kết quả, so sánh một baseline với một candidate, và xem bằng chứng phía sau một bản ghi. Đồng thuận cho việc thu thập và chia sẻ là tường minh và tách khỏi bằng chứng cục bộ, và phần đóng góp theo tháng được đóng băng cùng lọc riêng tư ngay trên máy này để bạn xem payload trước khi gửi. Để đồng thuận ở trạng thái chưa đặt thì mọi insight vẫn nằm cục bộ.

Một đề xuất có bằng chứng có thể trở thành công việc cải thiện có phạm vi. Từ một đề xuất, bạn có thể tạo kế hoạch cải thiện trong một project đích, hoãn, bỏ qua, đánh dấu sẵn sàng để xác minh, và xác minh kết quả dựa trên bằng chứng baseline và candidate đã ghi. Mỗi đề xuất hiển thị một trạng thái: Proposed, Deferred, Dismissed, Planned, Awaiting verification, Insufficient evidence, Improved hoặc Not improved. Các thao tác này chỉ ghi disposition cục bộ và một kế hoạch có phạm vi; chúng không gọi provider hay model. Cùng vòng đời này có trong CLI dưới dạng ak insights work, trong đó list chỉ đọc và verify chỉ dùng bằng chứng benchmark cục bộ.

Thiết kế status line

Trình thiết kế Status Line dựng status line của Claude Code bằng kéo-thả: chọn color theme, đặt ngưỡng context-window và usage-quota, và sắp xếp các section Model, Directory, Git, Cost cùng các section khác trên nhiều dòng với preview trực tiếp. Save ghi lại cấu hình status line.

Migrate provider

Wizard Migrate chuyển một stack Claude Code sang các provider khác qua bốn bước — Discover, Reconcile, Execute và Summary. Discover liệt kê các nguồn migration (như ~/.claude, ~/.claudekit và ~/.agentkit) kèm số file và dung lượng để bạn chọn những gì đưa vào.

Hãy xem kỹ từng bước trước khi execute, vì migration thay đổi thiết lập provider trên thiết bị này.