Tham chiếu thiết lập

Coppice lưu toàn bộ thiết lập trong một file, config.toml:

Hệ điều hànhĐường dẫn
Linux~/.config/Coppice/config.toml
macOS~/Library/Application Support/Coppice/config.toml

Trên Linux, nếu XDG_CONFIG_HOME được đặt, file nằm ở $XDG_CONFIG_HOME/Coppice/config.toml.

Sửa ngay trong ứng dụng

Mở Settings ở thanh bên. Trang này hiện nội dung file dạng văn bản, và các comment bạn viết vẫn được giữ.

  • Save kiểm tra file trước khi ghi. Giá trị sai sẽ không được lưu.
  • Restore last good version hoàn tác một thay đổi sai.

Có thay đổi áp dụng ngay, có thay đổi sẽ hiện “Saved. Restart Coppice to apply.” (Đã lưu. Khởi động lại Coppice để áp dụng.)

Bạn cũng có thể sửa file bằng trình soạn thảo bất kỳ. Nâng cấp Coppice không làm mất những gì bạn đã sửa.

Cập nhật

Mở System → Updates để xem phiên bản và chọn Check for updates. Automatic updates bật sẵn. Tắt đi thì Coppice sẽ không tự kiểm tra phiên bản mới nữa.

Công tắc này không nằm trong config.toml. Coppice lưu thiết lập này dưới tên automaticUpdates trong update-settings.json, cùng thư mục.

Thay khóa

Nếu đã lỡ chia sẻ bản sao lưu, tạo khóa mới và mật khẩu admin mới. Token đã lưu vẫn dùng được, nhưng mọi người sẽ bị đăng xuất.

Mở System → Backup → Replace keys, nhập mật khẩu admin mới, và xác nhận.

Log

Admin có thể mở System → Logs để lọc và theo dõi trực tiếp log của server, request, các lần chạy agent và database. Mỗi lần chạy có một liên kết View logs.

Export logs lưu các dòng khớp với bộ lọc hiện tại thành coppice-logs.zip. Coppice đã xóa các token và khóa mà nó biết, nhưng bạn vẫn nên xem lại file trước khi gửi cho người khác.

Report a problem mở một GitHub issue mới, điền sẵn phiên bản Coppice của bạn. Mô tả chuyện gì đã xảy ra và đáng lẽ phải ra sao, rồi đính kèm file zip từ Export logs.

[logs]

TrườngKiểuMặc địnhTác dụng
retention_daysinteger14Giữ log bao nhiêu ngày, tính cả hôm nay: 3, 7, 14 hoặc 30. Mặc định là 14. Coppice xóa log cũ hơn mỗi giờ, và thay đổi có hiệu lực mà không cần khởi động lại. Nếu log vượt 256 MiB, Coppice xóa log cũ nhất trước, kể cả khi chưa hết retention_days.

Log mỗi ngày được chia thành các file tối đa 32 MiB, và mọi file đều tính vào giới hạn 256 MiB, kể cả file của hôm nay. Coppice không bao giờ xóa file log hay log database mà nó đang ghi. Log database được tính vào giới hạn, và Coppice xóa chúng khi quá retention_days.

TrườngKiểuMặc địnhTác dụng
dirstring./data/logsThư mục chứa log. Ứng dụng desktop dùng thư mục riêng và bỏ qua trường này. Thay đổi cần khởi động lại.

[storage]

TrườngKiểuMặc địnhTác dụng
run_artifacts_retention_daysinteger30Số ngày giữ console và terminal log của một lần chạy đã xong. Archive một ticket sẽ xóa ngay file của các lần chạy thuộc ticket đó. Giá trị dưới 1 được tính là 1. Thay đổi cần khởi động lại.
run_console_max_bytesinteger67108864Số byte tối đa một lần chạy được giữ cho console, và giữ thêm chừng đó cho terminal log. Phần cũ nhất bị bỏ trước. Thay đổi cần khởi động lại.

Connector

CLI nào Coppice tìm thấy thì được bật sẵn, trừ khi bước kiểm tra đăng nhập cho thấy bạn đã đăng xuất. Muốn tắt một CLI, chỉ cần một dòng:

[agent.connectors.claude-code]
enabled = false

Công tắc trong System → Connectors ghi đúng dòng đó.

Kilo Code, GitHub Copilot, Qwen Code và Kimi Code được bật ngay khi Coppice tìm thấy. Coppice không kiểm tra miễn phí được trạng thái đăng nhập của các CLI này, nên nếu bạn đã đăng xuất thì lần chạy sẽ báo lỗi.

[agent]

TrườngKiểuMặc địnhTác dụng
worktrees_pathstring<data-dir>/worktreesThư mục nơi mỗi ticket có git worktree riêng.
worker_countinteger8Trần tổng số job agent trên mọi connector. Giá trị dưới 1 được tính là 1. Config cũ còn worker_count = 2 giữ trần cũ và vẫn có thể chặn connector khác cho đến khi bạn tăng hoặc xóa dòng đó.
health_check_interval_secsinteger60Số giây giữa các lần kiểm tra sức khỏe agent. Giá trị dưới 10 được tính là 10.

<data-dir> là thư mục chứa config.toml: ~/.config/Coppice trên Linux và WSL, và ~/Library/Application Support/Coppice trên macOS.

[agent.connectors.<id>]

Các id: claude-code, codex, cursor, opencode, kilo-code, copilot, qwen-code, kimi, grok. Bảng nào cũng có thể bỏ qua.

TrườngKiểuMặc địnhTác dụng
enabledboolkhông đặt: bật nếu CLI đã đăng nhậpBật hoặc tắt connector.
model_providerslist of strings[]Các nhà cung cấp model cho connector này. Được điền khi bạn bật connector này.
run_timeout_secsinteger1800 với mọi connectorChạy quá số giây này trên connector đó thì báo lỗi.
max_concurrent_runsinteger2Số job connector này được chạy cùng lúc. Job thừa giữ queued và chạy theo thứ tự cũ nhất khi có chỗ. Dưới 1 tính là 1.
commandstringcursor-agent (Cursor), codex, opencode, kilo, copilot, qwen, kimi, grokFile chạy của CLI. Claude Code luôn chạy claude và không có command.

Chỉ dành cho OpenCode:

TrườngKiểuMặc địnhTác dụng
serve_hostnamestring127.0.0.1Hostname cho tiến trình phụ của OpenCode trong lúc chạy. Cần khởi động lại.

Đổi command của OpenCode cũng cần khởi động lại.

[workflow]

TrườngKiểuMặc địnhTác dụng
auto_start_runsbooltrueKhi true, giao agent cho một ticket đã có repository là tự bắt đầu chạy. Khi false, bạn bấm Run agent.
auto_assign.defaultbooltrueBật tự giao việc cho mọi trạng thái không có thiết lập riêng.
auto_assign.<status>boolbacklog: false. Còn lại: theo defaultBật hoặc tắt tự giao việc cho một trạng thái.
auto_split.defaultboolfalseBật tự tách ticket cho mọi trạng thái không có thiết lập riêng.
auto_split.<status>booltheo defaultBật hoặc tắt tự tách ticket cho một trạng thái.

Các khóa trạng thái: backlog, ready, in_progress, in_review, in_qa, wait_for_final_review (Wait for Human Review), blocked, done.

Khi tự giao việc bật cho trạng thái đó, Coppice giao ticket cho agent mà lần chạy đề xuất. Khi tắt, ticket hiện Recommends: thay vào đó.

Khi tự tách bật cho trạng thái đó, Coppice tạo các ticket con mà lần chạy đề xuất. Khi tắt, Coppice lưu một Pending split recommendation cho đến khi bạn bấm Approve splits.

[knowledge]

TrườngKiểuMặc địnhTác dụng
enabledbooltrueBật hoặc tắt việc gom gọn (compaction) knowledge.
poll_interval_msinteger500Bộ lập lịch compaction thức dậy bao lâu một lần. Giá trị dưới 100 được tính là 100.
compaction.interval_secsinteger1800Số giây giữa các vòng compaction.
compaction.batch_max_ticketsinteger10Số ticket tối đa trong một lô.
compaction.batch_max_source_bytesinteger200000Số byte nguồn tối đa trong một lô.
compaction.max_candidates_per_batchinteger20Số đề xuất tối đa một lô có thể đưa ra.
compaction.max_attemptsinteger3Số lần thử tối đa cho một lô.
auto_save.enabledboolfalseLưu các đề xuất ít rủi ro mà không hỏi bạn.
auto_save.allowed_typeslist of strings[]Các loại được tự lưu: bug_pattern, coding_convention, dependency_note, performance_note, review_feedback, test_command.
auto_save.minimum_confidencestringhighPhải giữ là high.
retrieval.top_kinteger8Số mục một lần tra cứu trả về. Từ 1 đến 20.
retrieval.allowed_typeslist of strings[] (mọi loại)Chỉ trả về các loại này: coding_convention, architecture_rule, bug_pattern, test_command, review_feedback, dependency_note, api_contract, workflow_rule, human_preference, operational_runbook, security_rule, performance_note.
retrieval.minimum_confidencestringmediumlow, medium hoặc high.
retrieval.default_page_sizeinteger25Kích thước trang mặc định.
retrieval.max_page_sizeinteger100Kích thước trang lớn nhất. Tối đa 100.
retrieval.max_active_per_boardinteger1000Số mục Knowledge nhiều nhất, đang chờ hoặc đã duyệt, mà một bảng có thể giữ. Các mục của agent trên bảng đó cũng được tính.
retrieval.max_active_workspaceinteger10000Số mục Knowledge nhiều nhất, đang chờ hoặc đã duyệt, áp dụng cho cả workspace.

Mọi giá trị số lượng và thời gian ở trên đều phải lớn hơn 0.

[git]

TrườngKiểuMặc địnhTác dụng
author_namestringCoppiceTên tác giả trên các commit Coppice tạo.
author_emailstringcoppice@localhostEmail tác giả trên các commit đó.
push_enabledboolfalse (true trong ứng dụng desktop)Cho phép Coppice push branch và mở pull request.

[plugins]

TrườngKiểuMặc địnhTác dụng
dirstring<data-dir>/pluginsThư mục plugin mặc định. Thêm thư mục khác ở trang Plugins.
allow_file_git_urlsboolfalseCho phép cài plugin từ git URL dạng file:.
git_timeout_secsinteger300Clone hoặc cập nhật plugin quá số giây này thì báo lỗi.
mcp_start_timeout_secsinteger20Số giây chờ MCP server của plugin khởi động.
mcp_list_timeout_secsinteger10Số giây chờ plugin liệt kê công cụ.
mcp_idle_shutdown_secsinteger600Số giây một MCP server của plugin còn chạy khi không được dùng.

[mcp]

TrườngKiểuMặc địnhTác dụng
builtin_plugins_dirstring<data-dir>/builtin-pluginsNơi Coppice ghi các skill có sẵn mỗi lần khởi động. Chỉnh sửa ở đó sẽ bị mất.
call_timeout_secsinteger60Một lần gọi công cụ quá số giây này thì báo lỗi.
max_output_bytesinteger32768Kết quả công cụ lớn nhất, tính bằng byte.
comment_post_limitinteger5Số bình luận tối đa một lần chạy được đăng.
token_ttl_secsinteger14400Thời hạn của token công cụ trong một lần chạy, tính bằng giây.

[keybindings]

Mỗi khóa là id của một lệnh trong Phím tắt. Phím của bạn thay cho phím mặc định của lệnh đó, và để trống thì phím tắt bị tắt.

TrườngKiểuMặc địnhTác dụng
"<command id>"string or list of stringsphím tắt có sẵnThay phím của lệnh đó. "" xóa chúng.
[keybindings]
"palette.open" = "P"
"ticket.create" = ""
"board.nextCard" = ["J", "Down"]

Mod là Cmd trên macOS và Ctrl trên Linux và WSL. Chuỗi phím được viết dạng G then B. Nhiều phím cho một lệnh được ngăn cách bằng or, hoặc viết thành danh sách. Save áp dụng thay đổi mà không cần khởi động lại. Phím tắt viết sai, id lệnh không tồn tại, phím trùng với lệnh khác, hoặc phím của trình duyệt hay hệ thống sẽ bị bỏ qua. Lệnh đó giữ phím mặc định, và Settings sẽ ghi rõ lý do.