OpenCode cập nhật 14/10–28/10: desktop plugin và 3 breaking change
Hai tuần vừa rồi repo opencode nhận 1.116 commit và 5 release — nhưng nếu chỉ nhớ một chuyện,
hãy nhớ chuyện này: OpenCode v2.2.0 mở đường cho desktop plugin, và cùng lúc đổi ba thứ có thể
làm plugin cũ của bạn fail.
Mình tách bài này theo hai nhóm người đọc. Nếu bạn chỉ dùng OpenCode để code hằng ngày, phần lớn thay đổi là tin tốt: desktop mượt hơn, nhiều tiện ích hơn, V1 vẫn được giữ ổn định. Còn nếu bạn viết plugin hoặc SDK, danh sách breaking change ở dưới là phần phải đọc trước khi bấm update.
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.2.0 (27/10): desktop plugin ra mắt dưới dạng experimental, kèm GUI plugin API.
- Ba breaking change:
@opencode/aiđổi root, TUI plugin cần OpenTUI 0.7, GitHub Action bị bỏ. - Session sharing dừng từ v1.19.1 — link share cũ không còn dùng được.
- V1 chốt dòng 1.x từ v1.19.2 — không bị tự đẩy lên 2.x.
- v1.19.4 mang bản vá bảo mật của Bun 1.4.4 — đáng lên kể cả khi chưa sang V2.
- Plugin gắn instruction theo session mà không phá prompt cache.
- Desktop: layout Focus/Pro, rewind/fork mọi message,
@link sang session khác, model picker mới.
v2.2.0: desktop plugin và ba breaking change
Đây là release lớn nhất trong cửa sổ hai tuần. Phần được mô tả kỹ nhất là desktop plugin: bạn có thể tạo, cài và chia sẻ plugin ngay trong app, quản lý ở Settings › Extensions › Plugins (5792c3e6). Bộ API đi kèm cho phép plugin chèn toast, dialog, notification, tab, điều khiển composer và cả custom UI (dae4077a, 758cf5ad).
Nói ngắn: trước đây plugin chủ yếu sống trong TUI hoặc can thiệp vào server; giờ plugin có chỗ đứng trong giao diện desktop, giống cách extension của editor hoạt động.
Đổi lại, ba thay đổi sau là breaking:
| Thành phần | Trước | Sau |
|---|---|---|
@opencode/ai | Root là Effect API, Promise ở @opencode/ai/promise | Root là Promise API, Effect chuyển sang @opencode/ai/effect |
| TUI plugin | OpenTUI 0.6.8+ | Bắt buộc OpenTUI 0.7.0; cách khai báo hook cũng đổi |
| GitHub Action | Có publish | Không còn publish, phải gỡ khỏi workflow |
Với @opencode/ai, đoạn migrate cơ bản như sau
(dad29a89):
-import { AI } from "@opencode/ai/promise"
-import { LLM } from "@opencode/ai"
+import { AI } from "@opencode/ai"
+import { LLM } from "@opencode/ai/effect"
Với TUI plugin, không chỉ nâng version. OpenTUI 0.7 đổi cách custom renderable đọc hook: gán
renderBefore, renderAfter, onLifecyclePass trong constructor thay vì khai báo class field; gọi
refreshHooks() sau khi thêm hook bằng reflection; thay defineNativeIntegration() bằng
static nativeIntegration
(PR #59295).
Nếu plugin của bạn còn phụ thuộc OpenTUI 0.6, nó sẽ fail ngay lúc cài.
Còn GitHub Action thì đơn giản hơn: nó không còn được publish, nên xoá bước dùng nó khỏi CI (1743d1a2).
Session sharing dừng, V1 chốt dòng 1.x
Hai release nhỏ nhưng ảnh hưởng trực tiếp đến thói quen sử dụng.
v1.19.1 (15/10): session sharing chính thức dừng. Link share cũ, các lệnh chia sẻ session và việc import session từ share URL đều không còn hỗ trợ (release v1.19.1). Nếu team bạn đang gửi link cho nhau xem session, cần đổi cách làm. Với nhu cầu xem session từ xa, hướng chính thức hiện tại là remote pair; mình đã thử và viết kỹ trong bài về OpenTunnel, Tailscale và cloudflared.
v1.19.2 (16/10): V1 không bị tự đẩy lên V2. Update check chỉ đọc bản opencode-ai mới nhất trên
npm, nên máy đang chạy 1.x sẽ không nhận 2.x như một bản update thường
(release v1.19.2).
Muốn lên V2 vẫn phải chủ động chọn qua /update hoặc opencode upgrade --major. Install script
cũng từ chối cài 2.x.
Đây là thay đổi theo hướng tốt cho team thích ổn định: bạn không bị đổi major version ngoài ý muốn.
Plugin instruction API: tùy biến mà không phá cache
Một thay đổi ít được chú ý nhưng hữu ích với người viết plugin: plugin có thể gắn và cập nhật
instruction theo từng session qua ctx.session.instructions.entry với các thao tác put/list/remove
(6c74e11e,
PR #56550).
Cơ chế đáng chú ý ở chỗ: thay vì sửa system prompt và làm hỏng prompt cache, mỗi thay đổi được thêm như một update nhỏ ở bước kế tiếp. Các entry này còn sống qua compaction và revert, và không tạo thêm một lượt gọi model. Với plugin cần nhắc agent về quy ước riêng của project, đây là cách rẻ hơn nhiều so với nhồi tất cả vào prompt đầu phiên.
AI platform: image, decision, cache TTL và model mới
v2.2.0 mở thêm hai nhóm API experimental cho plugin và SDK:
- Image generation — endpoint sinh ảnh, có entry point cho catalog provider.
- Decision generation — thay cho experimental evaluation cũ, gồm OpenAI Decisions, System One và Cloudflare Run (097a93e5).
Phía provider cũng được mở rộng: Alibaba, Vercel AI Gateway và Cloudflare Workers AI đều có image generation (861a2cf4, 23cd3109, 43868389). Sign in with ChatGPT có thêm GPT-6.1 Terra và Terra Fast (4e982c08).
Với người quan tâm chi phí, có hai thứ đáng chú ý hơn:
- Prompt cache TTL chỉnh được theo provider/model — hữu ích khi bạn biết nhịp làm việc của mình (90077005).
- Cost do provider báo được ghi lại, budget Console và Go usage hiện ngay ở chỗ bị chặn (4cba1b7f, e42f6d10).
Nếu bạn đang cân nhắc gói subscription thay vì trả token từng lần, OpenCode Go là lựa chọn $10/tháng mà mình đã phân tích trong bài riêng.
Desktop: nhiều cải thiện đáng dùng
Phần desktop được làm lại khá rộng. Mình chọn những thứ thay đổi cách làm việc hằng ngày:
- Rewind hoặc fork từ bất kỳ message — không còn phải quay về đầu session (6a495480).
- Gắn
@để link sang session khác — hữu ích khi một task kéo qua nhiều session (db6999e2). - Model picker có favorites và recent, chọn bằng dialog tìm kiếm (ac0fa47e).
- Prompt history picker — tìm lại prompt cũ thay vì nhớ mang máng (3449855d).
- Chọn layout Focus hoặc Pro, và có setting giảm motion nếu bạn không thích animation (release v2.2.0).
- Mermaid render nhanh hơn, vừa cột — diagram trong câu trả lời dễ đọc hơn (06dc6a0c).
Ngoài ra còn một loạt fix về focus, tab, side panel và memory. Không cái nào lớn, nhưng cộng lại thì cảm giác dùng app đỡ vướng hơn rõ rệt.
Hiệu năng, Windows và bảo mật
Hiệu năng — 13 commit perf trong hai tuần, đáng chú ý:
- Convert tool schema một lần thay vì mỗi lần gọi (13a615b9).
- Cache Git discovery theo metadata fingerprint (e573115f).
- Resize ảnh trong worker và trả memory khi idle (787811f6).
- Giảm memory khi code search gặp dòng rất dài (d641fc45).
Windows — nhóm này được chăm khá kỹ:
- Persistent PTY được bật trên Windows (92242b55).
- Service mặc định cổng 45278 và né dải port WSL mirrored (3943b84e, e441dafb).
- Update desktop cài trong khoảng một giây (8d5e6e23).
Bảo mật — v1.19.4 nâng Bun runtime đi kèm lên 1.4.4, gồm bản vá cho Brotli, TLS, HTTP/1.1,
HTTP/2, HTTP/3, WebSocket và fetch, đồng thời cập nhật root certificate lên NSS 3.131.1
(release v1.19.4).
Ngoài ra, GitHub App installation token được scope theo repository đã xác minh
(f9098c96),
và một dependency lỗi thời (seroval) bị gỡ khỏi @solidjs/start
(d93568f3).
Remote access và MCP
Hai thay đổi nhỏ nhưng liên quan đến cách làm việc từ xa:
- OpenTunnel đi qua HTTP proxy.
@opentunnel/clientlên 0.6.1, nên remote access hoạt động được cả khi máy nằm sau proxy công ty (3fda0e39). - MCP OAuth ổn định hơn. Credential refresh được phối hợp giữa nhiều location và process; login không còn bị cắt bởi callback lạ; request MCP dài không bị Bun fetch idle timeout cắt ngang (94353780).
Còn một hướng mới đang ở mức experimental: client-hosted MCP qua websocket, cho phép tool chạy phía client thay vì server (4a6dacec).
Nên làm gì với bản cập nhật này
- Bạn chỉ dùng OpenCode để code? Lên v1.19.4 nếu còn ở dòng 1.x, vì có bản vá bảo mật của Bun. Nếu đã ở V2, update lên v2.2.0 để có desktop plugin và loạt cải thiện desktop.
- Bạn viết plugin hoặc SDK? Đọc ba breaking change trước, đặc biệt là OpenTUI 0.7. Sửa import
@opencode/aivà gỡ GitHub Action khỏi workflow trước khi update. - Team đang dùng share link? Chuyển sang remote pair hoặc cách khác; session sharing đã dừng.
- Team muốn ổn định? Ở lại dòng 1.x là lựa chọn hợp lệ — v1.19.2 đảm bảo không bị tự đẩy lên 2.x.
- Máy Windows hoặc WSL? Update vì loạt fix PTY và port service.
- Quan tâm chi phí? Thử prompt cache TTL và xem cost/budget trong desktop thay vì đoán.
Nguồn tham khảo
- Release v2.2.0 — opencode
- Release v1.19.4 — bản vá bảo mật Bun
- Release v1.19.2 — chốt dòng 1.x
- Release v1.19.1 — dừng session sharing
- Danh sách commit 14/10–28/10 — nhánh
dev - OpenCode từ xa: OpenTunnel, Tailscale hay cloudflared
- OpenCode cập nhật 07/10–14/10 — kỳ trước
Bài tổng hợp từ commit message và release notes trong hai tuần (1.116 commit, 5 release, quét ngày 28/10/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.