[English](../../../../updates/releases/v0.1.50-release-guide.md) | [Tiếng Việt](./v0.1.50-release-guide.md) | [简体中文](../../../../updates/releases/v0.1.50-release-guide.md) | [한국어](../../../../updates/releases/v0.1.50-release-guide.md)

# Hướng dẫn phát hành clisbot v0.1.50

Ngày: `2026-04-28`

## Hãy đọc phần này nếu

- Bạn đang chạy một bản cài `clisbot` ở `0.1.43` và định update.
- Bạn dùng Slack hoặc Telegram group, Telegram topic, loops, hoặc streaming preview.
- Bạn dựa vào clisbot agent để đổi route, auth, lịch, hoặc runtime config ngay từ chat.

## TL;DR

Bản này làm cho clisbot an toàn hơn khi dùng thật trong group và topic: quyền truy cập trên ngữ cảnh chat dùng chung rõ hơn, update config là tự động, scheduled loop và durable queue control đáng tin hơn, prompt context dễ đọc hơn, và truthfulness ở startup/restart giữ chặt hơn quanh đúng session cần dùng.

## Chọn đường đi của bạn

### Nếu bạn chạy bot cá nhân

- điều nên quan tâm nhất: `/queue`, long-run continuity tốt hơn, recovery tốt hơn khi gặp trust-prompt, và Telegram media attachment
- việc nên làm sau khi update: chạy một tác vụ coding bình thường, rồi kiểm tra `/status` và một queued follow-up

### Nếu bạn sở hữu một shared team bot

- điều nên quan tâm nhất: model `group:*` rõ hơn, route inheritance an toàn hơn, và cô lập thread/topic chặt hơn
- việc nên làm sau khi update: inspect các shared route quan trọng, rồi verify một cuộc hội thoại thật trong group hoặc topic

### Nếu bạn vận hành runtime

- điều nên quan tâm nhất: nâng cấp trực tiếp từ bản cài cũ, `clisbot queues`, các chỉ dấu `sessionId` trung thực hơn, và khả năng chịu false-failure tốt hơn của restart
- việc nên làm sau khi update: chạy `clisbot status`, `clisbot queues list`, và một lượt kiểm tra restart có chủ đích

## Có gì thay đổi

- Quyền truy cập group dùng chung dễ suy luận hơn: multi-user admission của ngữ cảnh chat và sender policy giờ là hai thứ tách nhau.
- Config từ `0.1.43` được backup và tự update lên schema `0.1.50`.
- Wall-clock loop có timezone handling tốt hơn và độ tin cậy tốt hơn cho prompt đầu tiên.
- Durable same-session queue control giờ có mặt qua `clisbot queues` và chat `/queue`, với giới hạn pending theo từng session.
- Prompt giờ gồm sender và ngữ cảnh chat gọn hơn trên các đường chat thường, queue, steering, và loop.
- File Telegram dạng voice/audio giờ đi vào workspace của agent như attachment.
- Telegram topic và streaming preview có session isolation mạnh hơn, nên pane content cũ hay update của topic khác không bị render như câu trả lời hiện tại.
- Session continuity và runner truth chặt hơn: các lỗi resume hoặc `/new` nhập nhằng sẽ giữ stored session id, trust prompt đến trễ được chấp nhận lại trước khi submit prompt, và restart chấp nhận được false failure của stop-timeout khi worker thực ra đã thoát.

## Những cải thiện dễ nhận ra nhất

### Người dùng chat hằng ngày

- queued follow-up giờ cho cảm giác là một tính năng thật, không còn giống workaround mong manh
- sender và ngữ cảnh chat dễ hơn cho agent khi cần hiểu đúng ngữ cảnh
- workflow mobile trên Telegram tốt hơn vì `voice` và `audio` trở thành file bình thường trong workspace

### Admin của ngữ cảnh chat dùng chung

- việc phơi bot ra group và topic dễ suy luận an toàn hơn
- route inheritance rõ hơn khi muốn exact surface đi theo `group:*`
- shape config cũ có thể nâng cấp tại chỗ mà không cần một vòng rewrite bằng tay

### Operator debug

- cảnh báo của restart bớt ồn hơn vì clisbot giờ phân biệt được “stop đến trễ” với “runtime thực ra vẫn còn chạy”
- session continuity ít khả năng âm thầm drift hơn sau các lỗi stale resume hoặc `/new`
- việc trust prompt xuất hiện lại sau khi CLI upstream thay đổi được xử lý có chủ đích hơn trước lúc submit prompt

## Bây giờ nên dùng gì

- Dùng `topic:<chatId>:<topicId>` cho Telegram topic route.
- Dùng `group:*` như default shared sender policy node cho một bot.
- Dùng exact group hoặc topic route không có route-local `policy` nếu chúng nên kế thừa từ `group:*`.
- Dùng `clisbot timezone get|set|clear|doctor` cho timezone ở mức app.
- Dùng `clisbot queues list|status|create|clear` cho durable queue operation thay vì các lời nhắc follow-up kiểu ad hoc.
- Nhắc agent chạy `clisbot auth get-permissions --sender <principal> --agent <id> --json` trước khi làm thay đổi config nhạy cảm.

## Điều cần để ý

- Các exact shared route hiện có không nên bất ngờ mang `policy: disabled`.
- Calendar loop sẽ đóng băng resolved timezone khi được tạo; việc đổi app timezone về sau không nên làm dời lịch hiện có.
- Việc làm giàu display trên Slack cần các lookup scope đã được ghi trong Slack manifest guide.
- Các sửa lỗi streaming được làm rất chặt ở ranh giới prompt; hãy báo mọi trường hợp nội dung pane cũ hoặc output của topic khác xuất hiện trong câu trả lời mới.
- Nếu restart in ra cảnh báo stop-timeout trong lúc update, bản hiện tại vẫn nên tiếp tục sạch nếu status cho thấy worker đã thoát; chỉ báo lỗi nếu restart thực sự làm runtime bị down.
- Nếu workspace trust prompt xuất hiện lại sau một lần cập nhật CLI, routed prompt vẫn nên đi tiếp; hãy báo lỗi nếu trust vẫn còn lộ ra sau prompt đầu tiên theo route hoặc sau một steering attempt.

## Cập nhật / rollout

- Cài hoặc chạy package `0.1.50`.
- Restart clisbot và để automatic config update chạy.
- Xác nhận `clisbot status` báo schema/runtime health.
- Kiểm tra các Telegram topic route và những Slack shared route quan trọng.
- Nếu bạn dùng workflow nặng về queue, hãy verify `clisbot queues list` cùng một queued prompt trên route thật.
- Giữ bản backup trong `~/.clisbot/backups/` cho tới khi runtime sau update ổn định.

## Các bước kiểm tra đầu tiên tốt

- Bot Telegram cá nhân: một prompt bình thường, một `/queue ...`, một `/status`
- Shared surface trên Slack hoặc Telegram: một message thật trong đúng thread hoặc topic, cộng với một route-permission check
- Runtime operator: một `clisbot restart`, một `clisbot runner list`, một `clisbot queues list`

## Liên kết

- [Ghi chú phát hành](../../releases/v0.1.50.md)
- [Hướng dẫn update](../update-guide.md)
- [Migration index](../../../../../docs/migrations/index.md)
- [Changelog](../../../../../CHANGELOG.md)
