⚡
OpenCode.io.vn
Quay lại Blog
18 tháng 11, 2026OpenCode Vietnam8 phút đọc

OpenCode cập nhật 04/11–18/11: subagent chạy nền và vá prompt cache GPT-6.2

Hai tuần 04/11–18/11: OpenCode ra v2.3.0 với subagent chạy nền, v2.3.1 cho shell quá timeout chạy tiếp, v2.3.2 vá prompt cache GPT-6.2. Tổng hợp kèm link commit.

#opencode#cap-nhat#v2#cli#plugins#ai-coding

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ẻ

$10/tháng
OpenCode Go27 model open source · dùng với mọi agent
Xem gói →

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
Triggerthời giangiờ, interval, cron hoặc MCP event
Hành độnggửi promptgửi prompt vào session tạo, session khác, subagent mới, hoặc chạy Code Mode
APIclient.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ầnThay đổiViệc cần làm
@opencode/aiImageResponse.image bị bỏĐọc response.images[0]
SDKNhiều endpoint thôi chờ plugin load (tối đa 5 giây trước đây)Refresh theo event *.updated
Automation APIclient.experimental.schedule.* bị xoáĐổi sang client.experimental.automation.*
Configexperimental.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.list trả 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.tls với cert, 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ó message và ref thay 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: 0 giờ 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

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.