⚡
OpenCode.io.vn
Quay lại Blog
28 tháng 10, 2026OpenCode Vietnam7 phút đọc

OpenCode cập nhật 14/10–28/10: desktop plugin và 3 breaking change

Tuần 14/10–28/10: OpenCode ra v2.2.0 với desktop plugin, API plugin mới và 3 breaking change cho dev. Session sharing chính thức dừng. Tổng hợp kèm link commit.

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

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ẻ

$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.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ầnTrướcSau
@opencode/aiRoot là Effect API, Promise ở @opencode/ai/promiseRoot là Promise API, Effect chuyển sang @opencode/ai/effect
TUI pluginOpenTUI 0.6.8+Bắt buộc OpenTUI 0.7.0; cách khai báo hook cũng đổi
GitHub ActionCó publishKhô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/client lê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/ai và 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

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.