OpenCode cập nhật 04/11–18/11: subagent chạy nền và vá prompt cache GPT-6.2
Hai tuần vừa rồi repo opencode nhận 929 commit và 9 release — trong đó có một bản minor là
v2.3.0. Nhưng chủ đề chung của cả hai tuần không phải tính năng mới, mà là bỏ thời gian chờ:
subagent chạy nền, shell quá timeout vẫn chạy tiếp, compaction viết nền, và prompt cache được vá để
không đốt token vô ích.
Nếu bạn chỉ đọc một mục, hãy đọc phần vá prompt cache GPT-6.2. Trên GitHub Copilot, input không cache mỗi step giảm từ khoảng 14.000 token xuống 3 — con số đủ lớn để thấy tiền đang đi đâu.
Còn nếu bạn viết plugin hoặc gọi SDK, có bốn breaking change cần kiểm trước khi update. Mình gom ở một bảng gần cuối bài.
Gói coding model giá rẻ
Link affiliate OpenCode Go: OpenCode Vietnam có thể nhận hoa hồng, giá bạn trả không đổi.
Tóm tắt nhanh
- v2.3.0: subagent luôn chạy nền, trả session ID ngay; transcript TUI mặc định gộp cho gọn.
- v2.3.1: shell quá timeout chuyển ra background thay vì bị kill; compaction chạy nền mặc định.
- v2.3.2: system prompt GPT-6.2 gửi bằng developer message để được cache từ step thứ hai.
- Automation thay schedule: trigger theo giờ, interval, cron hoặc MCP event.
- Video generation ra khỏi experimental, thêm 5 provider.
- Full Code Mode sau flag
full_codemode: shell, read, edit, write nằm trong runtime. - v1.19.6 mời nâng cấp V1 lên 2.0, tải nền và cài khi bạn chọn.
Subagent chạy nền: đổi cách chia việc
Trước đây giao việc cho subagent nghĩa là ngồi chờ nó xong. Từ v2.3.0, subagent luôn chạy nền: trả session ID ngay, tiếp tục làm, và báo kết quả về parent mỗi khi idle (66e2fb94, release v2.3.0). Bạn có thể chạy nhiều subagent song song và vẫn làm việc trong session cha.
Có một chi tiết đáng chú ý: nếu subagent idle nhưng việc nền của nó vẫn đang chạy, báo cáo gửi parent sẽ ghi rõ "still running" để parent chờ kết quả cuối, thay vì coi câu trả lời dở là xong (609ee05a).
Đổi lại, TUI mặc định gọn hơn: mỗi cụm tool call và thinking được gộp thành một activity row có thể
thu gọn. Muốn xem lại từng bước thì nâng Verbosity lên medium hoặc high, hoặc đặt
session.verbosity trong config
(739d2af2).
Với người mới, mặc định gọn dễ đọc hơn. Với người đang debug, nhớ chỉnh lại setting — nếu không sẽ tưởng agent bỏ bước.
Không còn chờ: shell timeout và compaction nền
Hai thay đổi nhỏ nhưng sờ thấy được mỗi ngày.
Shell quá timeout không bị kill. Lệnh còn chạy khi hết timeout giờ được chuyển ra background, nên
build hoặc test dài vẫn chạy xong và báo lại. Flag shell_timeout_background bị bỏ; config cũ vẫn
load. Một thay đổi hành vi cần nhớ: timeout: 0 ở foreground giờ hiểu là mặc định 120 giây,
không còn là "chờ tới khi lệnh xong"
(b80a3891,
release v2.3.1).
Compaction chạy nền mặc định. Khi session gần chạm ngưỡng compaction, bản summary được viết ở
background nên prompt kế tiếp không phải chờ
(edd88bd3).
Tắt bằng compaction.background: false. Lưu ý: summary viết nền mà không dùng tới vẫn tốn token.
Cả hai thay đổi đều đánh đổi "không chờ" lấy "có thể tốn thêm tài nguyên". Với máy yếu hoặc gói trả theo token, nên đo lại chi phí sau khi update.
Vá prompt cache GPT-6.2: 14.000 token xuống 3
Đây là fix đáng giá nhất tuần này. GPT-6.2 không cache system prompt gửi trong field instructions
của Responses API, nên mỗi step bị tính lại như input không cache. OpenCode chuyển sang gửi system
prompt như một developer message ở đầu, trên mọi Responses route: OpenAI (API key và ChatGPT sign-in),
GitHub Copilot, Zen, Azure và OpenRouter
(7ca7b3fe,
de291ab7,
release v2.3.2).
Kết quả đo trong release notes: trên GitHub Copilot gpt-6.2-sol, input không cache mỗi step giảm từ
khoảng 14.000 token xuống 3. Compaction qua /responses/compact cũng đọc cùng prefix đã cache.
Nếu bạn dùng GPT-6.2 qua Copilot hoặc ChatGPT sign-in, đây là lý do đủ để update ngay. Không cần đổi config.
Schedule thành automation
experimental.schedules được thay bằng automations, và đây không chỉ là đổi tên. Automation có
thêm trigger và kiểu hành động:
| Schedule cũ | Automation mới | |
|---|---|---|
| Trigger | thời gian | giờ, interval, cron hoặc MCP event |
| Hành động | gửi prompt | gửi prompt vào session tạo, session khác, subagent mới, hoặc chạy Code Mode |
| API | client.experimental.schedule.* (đã xoá) | client.experimental.automation.* |
| Cách dùng | /schedule | /automation hoặc tool automation_* |
Automation đang active hoặc đang pause dạng prompt thuần sẽ được chuyển sang. Schedule có điều kiện hoặc giới hạn số lần chạy, cùng các schedule đã xong, sẽ bị bỏ (62d06fab, PR #64160).
Điểm mình thấy hữu ích: trigger bằng MCP event. Nghĩa là một server MCP bắn sự kiện là có thể khởi động agent, không cần chờ tới giờ. Ai đang tự viết webhook để làm việc này nên xem lại.
Video generation và Full Code Mode
Video generation ra khỏi experimental với API bất đồng bộ: start, status, result, cancel; media lưu trên disk thay vì base64 trong memory (5eac2802, 9f807c77). Provider đi kèm: Google Gemini Omni, MiniMax, Seedance cho Volcengine/BytePlus, OpenRouter và xAI (63a74e7e, d0cf80c7, 98956539, e36f0c8f, 3518013b).
Full Code Mode nằm sau flag full_codemode, mặc định tắt. Khi bật, shell, read, edit, write và
patch được đưa vào runtime Code Mode; grep, glob, webfetch bị ẩn để tránh trùng. Runtime có
thêm Bun.file, Bun.write, Bun.Glob, Node path và Buffer
(77450796,
73de67fc,
2f20ba65,
bb9d4e35).
Đây là hướng đi đáng theo dõi: thay vì nhiều tool rời, agent viết một chương trình và gọi đúng thứ nó cần. Nhưng vì còn sau flag, đừng đưa vào workflow chung ngay.
Bốn breaking change cần kiểm trước khi update
| Thành phần | Thay đổi | Việc cần làm |
|---|---|---|
@opencode/ai | ImageResponse.image bị bỏ | Đọc response.images[0] |
| SDK | Nhiều endpoint thôi chờ plugin load (tối đa 5 giây trước đây) | Refresh theo event *.updated |
| Automation API | client.experimental.schedule.* bị xoá | Đổi sang client.experimental.automation.* |
| Config | experimental.background_compaction và shell_timeout_background bị bỏ | Dùng compaction.background |
Chi tiết:
ImageResponse.image— chỉ ảnh hưởng code import trực tiếp@opencode/ai(dc4a1a74).- SDK không chờ plugin —
agent.listtrả agent đã load;integration.list,usage.limits,vcs.init,rpc.call,artifact.*trả ngay. Entry do plugin cung cấp xuất hiện sau, nên code nào giả định "gọi là có đủ" sẽ thấy thiếu (PR #62796). - Schedule API bị xoá — đổi sang automation, kể cả endpoint HTTP (62d06fab).
- Config flag bị bỏ — config cũ vẫn load, nhưng nên chuyển sang key mới để khỏi bất ngờ về sau.
Riêng người dùng V1: v1.19.6 mời nâng cấp lên OpenCode 2.0. Bản 2.0 tải nền và chỉ cài khi bạn chọn Restart to upgrade, Upgrade on quit hoặc Later. Session, project và setting được giữ, nhưng plugin viết cho V1 cần update (release v1.19.6).
Desktop, MCP và bảo mật
Desktop có vài thứ đáng dùng:
- Update plugin ngay trong Settings › Extensions: Check for updates rồi Update (b03809b2).
- Jump to message bằng
Cmd+Alt+G/Ctrl+Alt+G, tìm cả prompt chưa load trong timeline (f738b32d). - Tìm text trong preview Markdown, Mermaid, CSV, HTML bằng
Cmd+F(083e3114). - Bộ icon mới thành mặc định (9bc41760).
MCP được làm chắc hơn ở hai chỗ:
- Pooling với
pool: true— dùng chung một connection giữa các project cùng cấu hình, ít process hơn (33d52e60). - Login không bị đăng xuất khi nhiều client refresh cùng lúc hoặc token endpoint lỗi tạm thời (PR #62827).
Bảo mật và ổn định:
- mTLS client certificate cho gateway yêu cầu: đặt
settings.tlsvớicert,key,passphrase(908d1402). - Từ chối permission chỉ ảnh hưởng request cùng step, không reject cả session (PR #64343).
- Server crash trả 500 JSON có
messagevàrefthay vì body rỗng; lỗi storage nói rõ nguyên nhân (PR #64022). - Session nhiều ảnh không gửi request quá lớn: quá 25 MiB thì ảnh cũ nhất bị thay bằng placeholder (release v1.19.6).
Nên làm gì với bản cập nhật này
- Bạn dùng GPT-6.2? Update lên v2.3.2 ngay — vá prompt cache là thay đổi tiết kiệm token rõ nhất.
- Bạn hay chạy build/test dài? v2.3.1 giúp lệnh quá timeout không bị kill; nhớ
timeout: 0giờ là 120 giây. - Bạn dùng subagent nhiều? Thử chạy song song vài subagent; nhớ chỉnh Verbosity nếu cần xem chi tiết.
- Bạn dùng schedule? Chuyển sang automation trước khi API cũ biến mất khỏi code bạn.
- Bạn viết plugin/SDK? Kiểm bốn breaking change ở bảng trên, đặc biệt là endpoint không còn chờ plugin load.
- Bạn còn ở V1? v1.19.6 mời lên 2.0; cập nhật plugin V1 trước khi bấm nâng cấp.
- Bạn muốn thử video? Bắt đầu với một provider đã có sẵn key, dùng API bất đồng bộ thay vì chờ trong một request dài.
Nguồn tham khảo
- Release v2.3.0 — subagent chạy nền
- Release v2.3.1 — shell timeout, compaction nền
- Release v2.3.2 — prompt cache GPT-6.2
- Release v2.2.7 — Copilot Auto, tab shortcut
- Release v2.2.6 — MCP pooling, mobile dock
- Release v1.19.6 — mời nâng cấp lên 2.0
- Danh sách commit 04/11–18/11 — nhánh
dev - OpenCode cập nhật 28/10–04/11 — kỳ trước
- OpenCode từ xa: OpenTunnel, Tailscale hay cloudflared
Bài tổng hợp từ commit message và release notes trong hai tuần (929 commit, 9 release, quét ngày 18/11/2026), chưa chạy thử từng tính năng; commit nội bộ (chore/test/ci) chỉ đếm, không liệt kê.
Bạn thấy thay đổi nào trong hai tuần này đáng dùng nhất? Vào nhóm OpenCode Vietnam thảo luận cùng mọi người.