Phiên bản
Phiên bản chính xác của từng thư viện trong stack cố định của manh.run, cách bản mới đến với app đã deploy, và các thay đổi gần đây của framework.
Mọi app dùng chung một bộ phiên bản. Agent không chọn phiên bản cho các thư viện này và không ghi phiên bản trong import. Lý do có stack cố định xem ở Vì sao stack cố định.
Giao diện (.tsx)
| Thư viện | Phiên bản |
|---|---|
react, react-dom | 19.2.4 |
react-router | 7.13.2 |
antd | 6.7.0 |
@ant-design/pro-components | 2.8.10 |
@ant-design/icons | 6.3.4 |
@ant-design/x, @ant-design/x-markdown, @ant-design/x-sdk | 2.10.0 |
@ant-design/charts | 2.6.7 |
@ant-design/graphs | 2.1.1 |
axios | 1.21.1 |
dayjs | 1.11.20 |
ahooks | 3.9.7 |
lucide-react | 1.72.0 |
@xyflow/react | 12.12.1 |
@dnd-kit/core · @dnd-kit/sortable · @dnd-kit/utilities | 6.3.1 · 10.0.0 · 3.2.2 |
@monaco-editor/react | 4.7.0 |
Tailwind (chỉ class tiện ích trong className) | 4.3.5 |
Server (.ts)
| Thư viện | Phiên bản |
|---|---|
hono | 4.13.17 |
@hono/zod-openapi | 0.18.4 |
zod | 3.25.76 |
drizzle-orm | 0.44.2 |
papaparse | 5.7.0 |
xlsx | 0.18.5 |
Database của mỗi app là SQLite. Email, AI, kho file, Telegram và PDF đi qua module trong app/std, không qua package npm.
Server dùng package trong danh sách trên. Package lạ bị check chặn hoặc cảnh báo; khi chặn, thông báo code.backend-package-not-allowed liệt kê các package được phép. Xem Mã lỗi.
Cố định nghĩa là gì
- Một phiên bản cho mọi app. Project không có
package.json. Agent import bằng tên package (import { Hono } from "hono"), không ghi@phiên-bản. Package npm khác cho giao diện, ví dụqrcode, được manh.run ghim phiên bản khi agent ghi file. - Không có thư viện thay thế. Không MUI, shadcn, styled-components hay file CSS.
checkchặn các import này trước khi deploy. - Tài liệu và
checkkhớp đúng phiên bản. Ví dụ antd v6 bỏ propvisible, nêncheckbáocode.antd-v6-no-visible-propvà tài liệu chỉ dùngopen.
Bản mới đến app thế nào
manh.run nâng phiên bản sau khi đọc changelog của thư viện. Bản nâng gần nhất là antd 6.7.0 ngày 12/11/2026, một bản phụ không có thay đổi phá vỡ.
- Xem trước trong không gian làm việc dùng bản mới ngay.
- App đã deploy giữ nguyên bộ thư viện của lần deploy đó. App nhận bản mới ở lần deploy kế tiếp. Không có gì tự đổi trên app đang chạy.
- Luật
checkmới áp dụng ngay cho lần ghi file và lầnchecktiếp theo. Một cây file đã deploy thành công vẫn deploy lại được, kể cả khi luật mới báo lỗi, nên việc quay lại bản cũ không bị chặn. - Dịch vụ có sẵn (email, AI, kho file) chạy phía manh.run, nên bản sửa ở đó áp dụng ngay cho mọi app.
Sau khi manh.run nâng một thư viện giao diện, hãy mở bản xem trước và thử các màn hình chính trước khi deploy lại.
Thay đổi gần đây
Các thay đổi ảnh hưởng tới cách viết app, mới nhất ở trên.
- 19/11/2026.
manh/ui(giao diện) định dạng tiền, số, ngày và số điện thoại theo ngôn ngữ và tiền tệ của app, kèm màu trạng thái, token thiết kế và theme antd. App không import thì không đổi gì. - 16/11/2026. Mỗi lần agent deploy, manh.run chạy bài kiểm tra trên một bản thử của app. Bản thử có database riêng, dữ liệu thật không bị đụng tới. Chưa có
spec/acceptance.jsonthì manh.run tự tạo bài kiểm tra từ các file. - 16/11/2026. Secret chỉ còn một cách đọc:
import { env } from "manh/env". Cách import cũ không còn được build. - 16/11/2026.
manh/shellcóResourceListvàResourceDetail: khai báo các màn hình danh sách và chi tiết của một tài nguyên thay vì viết tay từng trang. - 15/11/2026. Bỏ chế độ một app nhiều tenant. Mỗi app có đúng một database. Khách cần dữ liệu tách riêng thì nhân bản app cho từng khách.
- 15/11/2026. Handler ghi dữ liệu để công khai bị giới hạn 30 lần trong 10 phút cho mỗi IP và route. Đổi bằng
export const rateLimit, tắt bằngrateLimit = falsecho webhook. - 15/11/2026. Quyền được kiểm tra trước
schema: người sai vai nhận 403FORBIDDEN, không còn nhận 400 kèm chi tiết schema. - 15/11/2026.
checktừ chối tên icon không có trong@ant-design/icons(ui.unknown-icon). Trước đó trang hiện dấu ”?” ở chỗ icon. - 15/11/2026.
manh/pdftạo file PDF tiếng Việt. Thay chopdf-lib, thư viện từng làm app không khởi động được. - 15/11/2026.
app/hookscótableRequest,optionsFromvàsubmit. Lần đọc lỗi tự thử lại, thông báo lỗi do khung trang hiện. - 14/11/2026. Sai mật khẩu quá nhiều lần trả 429
TOO_MANY_ATTEMPTS. Tài khoản quản trị đầu tiên chỉ tạo được từ bản xem trước trong không gian làm việc của chủ app. - 14/11/2026. Deploy chạy cả bước kiểm kiểu TypeScript. Lỗi kiểu chặn deploy, trừ khi agent gọi
deploy({ force: true, reason }). - 14/11/2026. manh.run không còn sao lưu database trước mỗi lần deploy. Đổi schema chỉ theo kiểu thêm vào: thêm cột mới, chép dữ liệu, rồi mới bỏ cột cũ khi chủ app đồng ý.
- 14/11/2026.
manh/vnđịnh dạng tiền, đọc số thành chữ, ngày giờ Việt Nam (UTC+7), số điện thoại và mã số thuế. - 13/11/2026. Handler khai báo
export const accessvàschema. Hàm nhận tham số thứ hai{ body, query, param, user }đã kiểm tra.fail()từmanh/errorsdừng request với mã lỗi.app/auth.tssinh sẵn đăng ký và đăng nhập. - 12/11/2026. antd 6.7.0 và @ant-design/x 2.10.0. Class tiện ích Tailwind dùng được trong
className.
Bước tiếp theo
- Vì sao stack cố định: lý do không có thư viện thay thế.
- Mã lỗi: lỗi khi import package ngoài danh sách.
- Quy tắc check: các luật gắn với từng phiên bản.