ak config prefs unset

Xoá một tuỳ chọn hook, journal.auto, worktree.root, agent model, hoặc semantic_decision theo scope, hiểu cơ chế fallback và khôi phục từ bản sao lưu config được báo cáo.

Dùng ak config prefs unset để xoá một toggle hooks.<name> đã đặt rõ ràng, leaf journal.auto, leaf worktree.root, một override agent_models.<runtime>.<tier>, hoặc một leaf semantic_decision khỏi một scope config. Sau đó preference kế thừa giá trị từ scope còn lại nếu có, hoặc dùng giá trị mặc định tích hợp (journal.auto mặc định là true; worktree.root mặc định là unset, nên ak:worktree fallback về WORKTREE_ROOT và chuỗi vị trí tích hợp sẵn; override agent model fallback về default catalog tích hợp của adapter tương ứng).

semantic_decision không theo thứ tự ưu tiên đó. Xoá semantic_decision.enabled ở user scope đưa key về giá trị mặc định false, tức là tắt provider. Xoá một giới hạn semantic_decision ở project khôi phục policy user cho project đó; thao tác này không bao giờ cấp sự đồng ý.

Cách dùng

ak config prefs unset <key>

Lệnh yêu cầu đúng một argument theo vị trí. Key phải là một trong hooks.<name> (trong đó <name> là tên script hook chữ thường theo kebab-case), literal chính xác journal.auto, literal chính xác worktree.root, hoặc agent_models.<runtime>.<tier> với <runtime> là tập đóng cursor và <tier> là một trong inherit, sonnet, opus, fable, hoặc haiku, hoặc semantic_decision.<leaf> với <leaf> là enabled, provider, model, timeout_ms, hoặc consumers.<consumer> cho domain-routing, fix-complexity, hoặc orchestration-risk. Lệnh không thể xoá credential hoặc giá trị thuộc phần config khác.

Cờ của lệnh

Cờ	Mặc định	Mô tả
`--scope <scope>`	`user`	Chọn `user` hoặc `project`.

Các cờ dùng chung như --json, --no-interactive, --quiet, --verbose và --yes được mô tả trong quy ước CLI.

Chọn scope

Scope	Tệp config	Kết quả sau khi xoá
`user`	`$AGENTKIT_HOME/config.yaml`, hoặc mặc định là `~/.agentkit/config.yaml`	Giá trị project vẫn có thể override preference; nếu không có, giá trị mặc định tích hợp được áp dụng.
`project`	`.agentkit/config.yaml` trong thư mục làm việc hiện tại	Giá trị user được áp dụng nếu có; nếu không có, giá trị mặc định tích hợp được áp dụng.

Xoá một tuỳ chọn user:

ak config prefs unset hooks.simplify-gate
ak config prefs unset journal.auto
ak config prefs unset worktree.root
ak config prefs unset agent_models.cursor.sonnet
ak config prefs unset semantic_decision.enabled --scope user

Chỉ xoá tuỳ chọn của project hiện tại:

ak config prefs unset hooks.simplify-gate --scope project
ak config prefs unset journal.auto --scope project
ak config prefs unset worktree.root --scope project
ak config prefs unset agent_models.cursor.sonnet --scope project
ak config prefs unset semantic_decision.enabled --scope project

Lệnh không tìm config project trong các thư mục cha. Hãy chạy lệnh từ thư mục project có .agentkit/config.yaml mà bạn muốn chỉnh sửa.

Tệp, bản sao lưu và ranh giới schema

Khi key đã tồn tại trong scope được chọn, AgentKit sao lưu config trước đó bên dưới AgentKit home, chỉ xoá leaf tương ứng, dọn phần cha như hooks, journal, worktree, hoặc semantic_decision nếu thao tác xoá khiến phần này trở thành rỗng, rồi ghi lại config theo cách atomic. Đầu ra thành công báo đường dẫn bản sao lưu. Các key khác, comment, thứ tự và editor directive được giữ nguyên.

Nếu key hoặc tệp config đã không tồn tại, lệnh vẫn thành công dưới dạng no-op: lệnh không tạo, ghi lại hay sao lưu tệp. Lệnh không hỏi xác nhận, không đọc stdin và không dùng mạng.

unset kiểm tra dạng key được phép và phải parse YAML cần chỉnh sửa, nhưng không chạy kiểm tra schema cho toàn bộ document. Việc xoá một leaf không thể tạo ra vi phạm schema mới. Dùng ak config prefs validate để kiểm tra phần còn lại, nhất là khi tệp đã được sửa thủ công.

Đầu ra cho tự động hoá

Với --json, khi thành công lệnh ghi một success envelope dùng chung vào stdout với kind config.prefs.unset. Các field dưới đây nằm trong data:

action: "unset"
key: string
scope: "user" or "project"
config_path: string
backup_path: string, omitted when no backup was created
found: boolean

Dùng found để phân biệt một lần xoá với no-op khi key đã vắng mặt. Lệnh không phát NDJSON.

Lỗi trong chế độ JSON, kể cả lỗi parse cờ (mã thoát 2), ghi error envelope dùng chung lên stderr. Hãy kiểm tra trạng thái process và không parse stdout như kết quả thành công sau mã thoát khác 0.

Kết quả và mã thoát

Mã thoát	Ý nghĩa	Bước tiếp theo an toàn
`0`	Key đã được xoá hoặc vốn đã vắng mặt.	Kiểm tra `found`, rồi resolve giá trị effective.
`1`	Key hoặc scope không hợp lệ, hay thao tác đọc config, sao lưu hoặc ghi thất bại.	Sửa key hoặc scope; khôi phục bản sao lưu được báo nếu bước xác minh sau đó thất bại.
`2`	Số argument hoặc cờ không hợp lệ.	Sửa cách gọi lệnh.

--yes và --no-interactive không thay đổi policy này vì unset không bao giờ hiện prompt. --quiet không ẩn stdout riêng của lệnh này, còn --verbose không thêm diagnostic riêng. Lệnh không có chế độ preview, dry-run, apply hay force.

Xác minh và khôi phục

Xác minh giá trị effective và kiểm tra các tệp còn lại:

ak config prefs resolve
ak config prefs validate

Nếu kết quả không đúng ý định, hãy đặt lại giá trị rõ ràng hoặc khôi phục đúng đường dẫn bản sao lưu mà lệnh đã in. Đừng thay thế toàn bộ AgentKit home: bản sao lưu chỉ bao phủ tệp config trước đó.

Lệnh liên quan

Quy ước CLI

On this page