@fui-org/mlis-cli 0.0.0-stage → 0.6.0

package/skills/mlis/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: mlis
+description: Dùng cho mọi việc thiết kế giao diện website MLIS (lhu.edu.vn và các site MLIS khác) qua CLI `mlis` — xem, tải về, sửa và đẩy lên các trang .ascx/.css/.js cùng hình, font trong thư mục ViewPage, dùng các control <MLIS:NewsList>, <MLIS:CatMenu>, <MLIS:LoadPage>…, đọc/sửa bài viết (tin tức) cấp nội dung động cho trang, và upload tài liệu qua CKFinder. Kích hoạt khi người dùng nói đến ViewPage, trang ascx, giao diện MLIS, PageStyle, HeaderOfSite, hoặc gọi lệnh mlis.
+---
+
+# MLIS ViewPage với `mlis`
+
+`mlis` là CLI làm việc với API `api/viewpage/*` của website MLIS (ASP.NET). Mọi trang giao diện nằm trong thư mục `ViewPage/` trên server:
+- **.ascx, .css, .js** — sửa như văn bản, có diff.
+- **Hình, font, media, pdf** (png, jpg, gif, webp, svg, ico, avif, woff/woff2/ttf/otf/eot, mp4/webm/mp3, pdf; ≤ 10 MB) — `pull`/`push`/`rm` như file code nhưng chỉ so khác/giống. Cần server có API `UploadFile`/`DownloadFile`; server cũ sẽ báo cần deploy.
+- Tài liệu dùng trong bài viết (doc, xls, zip…) hoặc ảnh không thuộc giao diện → CKFinder (`mlis cdn`), lưu ở `/Data/...`.
+
+## Chuẩn bị (một lần)
+
+```bash
+mlis config                      # xem url, workdir, token (chỉ hiện "(set)")
+mlis token set                   # dán giá trị cookie jwtAuth (prompt ẩn, hoặc pipe qua stdin)
+mlis config set url https://lhu.edu.vn
+mlis config set cdn-cat <CatID>  # thư mục (CatID) chứa hình/tài liệu cho CKFinder
+```
+
+Token là cookie `jwtAuth` của tài khoản có SystemRight ≥ 3. **Không bao giờ** in, dán vào chat, ghi vào file hay truyền token làm tham số dòng lệnh; không `cat` file config. Lỗi "server rejected the token" → nhờ người dùng chạy lại `mlis token set`.
+
+## Người dùng đưa URL của một trang: tìm template đang vẽ trang đó
+
+Sửa "trang `https://…`" nghĩa là sửa **template trong ViewPage** mà site dùng cho URL đó (hoặc bài viết, nếu chỉ đổi chữ). Không đoán, hỏi CLI:
+
+```bash
+mlis page https://tuyensinh.lhu.edu.vn/            # tên miền → thư mục trang chủ → PageStyle
+mlis page https://lhu.edu.vn/446/3387/ten-bai.html  # /CatID/NewsID → PageRead của thư mục 446 (+ NewsID để sửa nội dung)
+mlis page https://lhu.edu.vn/more-list/21/0/0/x.html --pull   # tải template + các file nó LoadPage + HeaderOfSite về workspace
+```
+
+Kết quả: `template` (thư mục ViewPage có default.ascx), `includes` (Header/Footer… nạp bằng LoadPage — chữ nằm ở header/footer thì sửa file đó), `head` (HeaderOfSite), `shared` (**bao nhiêu thư mục cùng dùng template này** — sửa template là đổi tất cả; nếu chỉ một thư mục cần khác, báo người dùng và đề xuất template riêng), `content` (NewsID → `mlis news pull`). Một máy chủ MLIS phục vụ nhiều tên miền (lhu.edu.vn, tuyensinh.lhu.edu.vn, sinhvientuonglai.lhu.edu.vn…) với **chung một ViewPage**: dùng chung một workspace, không tạo `--workdir` mới cho tên miền khác (CLI tự nhận ra cùng máy chủ; chỉ máy chủ MLIS khác mới cần workspace riêng).
+
+## Quy trình chuẩn
+
+1. **Xem**: `mlis tree [folder] [--files]`, `mlis ls <folder>`, `mlis cat <file>`.
+2. **Tải về**: `mlis pull <folder|file>` → bản sao ở `<workdir>/<đường dẫn ViewPage>` (mặc định `C:\APP\mlis-workspaces\…`). Mỗi workspace dành cho một máy chủ MLIS (mọi tên miền của nó). Luôn pull trước khi sửa; file local lâu ngày có thể đã cũ — chạy `mlis status <folder> --remote` để kiểm.
+3. **Sửa** file trong workspace (Edit/Write trực tiếp file local).
+4. **Kiểm**: `mlis status <folder>` (new/changed/missing) và `mlis diff <file|folder>` (so với bản đang chạy trên server). Đọc kỹ diff trước khi đẩy.
+5. **Đẩy**: `mlis push <file|folder>...` (`--dry-run` để xem trước). Trước khi ghi, bản server được lưu vào `_history/`.
+6. **Xác minh**: mở trang thật trên trình duyệt. Khách chưa đăng nhập có thể thấy HTML cũ tới **60 giây** (HtmlPageCache); CSS được nạp kèm `?version` của site nên trình duyệt có thể giữ CSS cũ — tải lại cứng (Ctrl+F5) hoặc kiểm bằng `mlis cat`.
+
+Đường dẫn: dùng đường dẫn ViewPage như `LHUENB4/@HomePage/default.ascx` (có thể kèm tiền tố `ViewPage/`), hoặc đường dẫn local nằm trong workspace (`.\default.ascx` khi đang đứng trong thư mục đó).
+
+## Thiết kế một trang: dữ liệu → mã → xem nháp → đẩy
+
+1. **Biết trang phục vụ thư mục nào và lấy dữ liệu từ đâu** — không đoán CatID/Location:
+   ```bash
+   mlis category find "tuyển sinh"            # tìm CatID theo tên (bỏ dấu cũng được)
+   mlis category pages LHUENB4/DefaultPageCatalog   # thư mục nào đang dùng trang này (page/read)
+   mlis category tree 21 --depth 2            # cây con: id, kiểu, page/read, loc:Location1,2,3
+   mlis category ls 21                        # thư mục con của 21 và Location của chúng
+   mlis category show 21                      # mọi cấu hình + đường dẫn + tên miền chủ
+   ```
+   `<MLIS:NewsList CatID="21" Location="22">` lấy tin của **các thư mục con của 21 có Location1/2/3 = 22** (mỗi thư mục con một khối ListFormat). `Location="0"` lấy tin của chính CatID. `CatID="-100"` = thư mục đang mở, `0` = trang chủ tên miền. Danh sách thư mục lưu ở workspace; `mlis category sync` để làm mới (dùng chung API của trang quản trị thư mục `/api/admin/GetAllFolder`, `GetFolderList`).
+2. **Viết mã**: xem mẫu thật cùng loại (`mlis skill ref design-patterns`), thuộc tính control (`controls`), HTML control sinh ra để viết CSS (`rendered-html`). Xong thì **`mlis check <thư mục>`**: bắt đường dẫn `ViewPage/...` không tồn tại (Src, CssFolder, href/src, url()), thẻ MLIS thiếu `runat="server"`, dấu `{`/`}` lạc trong format (làm trang lỗi), directive `CodeFile`, ảnh thiếu/giữ chỗ `alt`, số `<h1>`, thẻ SEO trùng với nền tảng. Sửa hết `error` trước khi render/push (exit code 1 khi còn error).
+3. **Tự render trên máy và xem ảnh chụp trước khi đẩy** — không ghi gì lên server:
+   ```bash
+   mlis render shot LHUENB4/MyPage                 # trang thư mục; in đường dẫn ảnh desktop (1366px) + mobile (390px)
+   mlis render shot LHUENB4/@HomePage --full       # trang chủ, chụp cả trang
+   mlis render shot LHUENB4/@ReadPage              # trang đọc tin (bài mẫu)
+   mlis render shot LHUENB4/MyPage --as read       # thư mục không có "home"/"read" trong tên: chọn kiểu bằng --as
+   mlis render shot LHUENB4/_default/Box.ascx      # xem riêng một control (trang bọc + HeaderOfSite)
+   mlis render start LHUENB4/MyPage                # chỉ chạy, in http://localhost:5080/… để mở bằng trình duyệt
+   mlis render stop
+   ```
+   `mlis render` chạy chính mã nền tảng (Default.aspx, App_Code, control MLIS) từ `site-src` (mặc định `C:\APP\MLIS_2025`) trên `http://localhost:<render-port>`, thư mục ViewPage trỏ thẳng vào workspace (sửa file là thấy khi chạy lại), cơ sở dữ liệu thay bằng **dữ liệu mẫu**: thư mục mẫu cho mọi `CatID`/`Location` mà trang và các file nó `LoadPage` dùng (3 thư mục con mỗi Location, mỗi cái 2 con), tin mẫu có tiêu đề/tóm tắt/nội dung tiếng Việt, hình giữ chỗ ghi kích thước (`tin-<cat>-<k> · 800×500`). Vì ViewPage chỉ là khuôn, dữ liệu thật không cần có sẵn. File tĩnh nền tảng mà bản local thiếu được lấy từ site thật (chỉ GET, lưu đệm). Lần đầu mất ~1 phút để biên dịch site, các lần sau vài giây. Lỗi biên dịch/parse của .ascx được in ra kèm file và dòng.
+   **Mở các ảnh PNG (Read) và tự review**: bố cục, tràn ngang, chữ tiếng Việt, khoảng cách, mobile; đối chiếu yêu cầu, sửa rồi chạy lại cho tới khi đạt. Cần Windows + .NET Framework 4 và `playwright` (Chromium).
+4. **Đẩy trang thật**: `mlis check` → `mlis diff` → `mlis push` → mở trang thật kiểm lại. Trang mới cần người dùng gán PageStyle/PageRead trong /admin (CLI không làm được).
+
+## Nội dung động: đặt chữ trong bài viết, không cứng trong .ascx
+
+Chữ/hình hay đổi (giới thiệu, thông báo, số liệu, thẻ, slider, FAQ) nên lấy từ **bài viết** qua `<MLIS:NewsDetail NewsID="…" NewsFormat="{4}">` (một khối) hoặc `<MLIS:NewsList CatID="…">` (mỗi bài một khối), để người quản trị sửa trong /admin mà không đụng mã. Khi người dùng muốn **đổi nội dung** đang hiển thị: tìm CatID/NewsID trong .ascx, rồi `mlis news ls <CatID>` → `mlis news pull <NewsID>` → sửa `_news/<NewsID>.html` → `mlis news diff` → `mlis news push`. Đổi chữ thì sửa bài, không sửa .ascx. Chi tiết, định dạng file và quy tắc: `mlis skill ref news`.
+
+## Quy tắc thiết kế (SEO, AI search, truy cập)
+
+- **Một `<h1>` mỗi trang.** Trang đọc tin: h1 là tiêu đề bài (`{1}` của NewsDetail sinh `<h1 class=NTitle>`) — không thêm h1 khác. Trang chủ/trang thư mục: tự đặt một h1 (tên trang/thư mục, có thể ẩn bằng CSS chuẩn `visually-hidden` nếu thiết kế không muốn hiện); tiêu đề khối dùng h2/h3 (`CatFormat="<h2>…</h2>"`).
+- **Ảnh có ý nghĩa phải có `alt`** mô tả nội dung; ảnh trang trí đặt `alt=""` hoặc dùng CSS background. Không đưa chữ quan trọng vào ảnh.
+- Nội dung chính nằm trong HTML khi tải trang, không sinh bằng JavaScript (crawler AI không chạy JS). Không ẩn nội dung chính trong tab/accordion chỉ mở bằng JS mà không có HTML sẵn.
+- Liên kết có chữ mô tả rõ ("Thông báo tuyển sinh 2027", không "Xem tại đây"); dùng `<a href>` thật, không `onclick`.
+- Không thêm `<title>`, `meta description`, `og:*`, canonical, JSON-LD Breadcrumb/NewsArticle vào ascx/HeaderOfSite — nền tảng đã tự thêm (`viewpage-structure` → "Những gì nền tảng tự làm").
+- Kiểm tra mobile: Bootstrap grid (`col-12 col-md-…`), ảnh `max-width:100%`, không chiều rộng cố định.
+
+## An toàn
+
+- `push` dừng với **exit 3** nếu file trên server đã bị sửa sau lần pull cuối (hoặc tồn tại mà chưa từng pull). Không tự ý thêm `--force`: chạy `mlis diff <file>`, báo người dùng, rồi chọn: giữ bản mình (`push --force`, bản server vào `_history`) hoặc lấy bản server (`pull <file> --force`, bản local vào `_history`) rồi sửa lại.
+- `pull` không ghi đè file local đang sửa dở (báo `kept-local`); `--force` mới ghi đè và lưu bản local vào `_history`.
+- Xoá (`mlis rm`, `mlis rmdir`, `mlis cdn rm/rmdir`) là vĩnh viễn trên server: chỉ chạy khi người dùng đồng ý rõ ràng cho đúng file đó, kèm `--confirm-delete`. Yêu cầu "sửa trang" không bao hàm quyền xoá file.
+- Site đang chạy thật: thay đổi có hiệu lực ngay cho người xem. Sửa trang chủ/HeaderOfSite/_default (dùng chung toàn site) cần cẩn thận gấp đôi; luôn `mlis render shot` và xem ảnh trước khi `push` trang thật.
+- Một lỗi cú pháp trong .ascx làm trang lỗi ngay (redirect `/error`). Giữ thẻ `runat="server"` đóng đúng, thuộc tính dùng nháy kép bên ngoài và nháy đơn bên trong chuỗi format (`ListFormat="<div class='row'>{1}</div>"`), hoặc dùng thẻ con `<NewsFormat>…</NewsFormat>` khi format dài/phức tạp.
+- `mlis history <file>` liệt kê bản sao lưu; `mlis restore <file> [--at stamp]` đưa bản cũ về local rồi `push` để khôi phục.
+
+## Tạo trang mới
+
+```bash
+mlis new LHUENB4/MyPage/Default.ascx   # trang (LoadPage css + Header/Footer của _default) — chỉ tạo trong workspace
+mlis new LHUENB4/MyPage/StyleMain.css  # css cùng thư mục được LoadPage CssFolder nạp tự động
+mlis new LHUENB4/_default/Box.ascx     # control con, chèn bằng <MLIS:LoadPage Src="ViewPage/LHUENB4/_default/Box.ascx" runat="server" />
+# viết mã → mlis check LHUENB4/MyPage → mlis render shot LHUENB4/MyPage → xem ảnh, sửa → lặp lại
+mlis push LHUENB4/MyPage               # khi đã đạt: tạo thư mục + file trên server (bản sạch, không CodeFile)
+```
+
+`mlis new` chỉ ghi vào workspace (nội dung mẫu sạch, không có `<%@ Control CodeFile=… %>` — trang ViewPage không có code-behind); server chưa có gì cho tới `mlis push`. `--push` tạo luôn trên server — không dùng khi chưa render/review, nhất là với trang route `_<Tên>` (có URL ngay khi file tồn tại). Trang thư mục mới chỉ hiển thị khi một thư mục (category) trong /admin có PageStyle = `LHUENB4/MyPage` — việc này người dùng làm.
+
+**Đặt tên thư mục** (chi tiết: `mlis skill ref viewpage-structure`):
+- Không có `_` ở đầu → là "trang", chọn được làm PageStyle/PageRead của thư mục (chỉ cấp `<site>/<trang>` hoặc `<site>/<trang>/<con>`, tối đa 50 ký tự).
+- `_` ở đầu → thư mục hỗ trợ, bị ẩn khỏi ô chọn trang: `_default` (header/footer/css dùng chung), `_assets` (HeaderOfSite.ascx, favicon.ico, default_image.png — tên cố định), `_images`/`_fonts` (tài nguyên của trang), `_bk` (sao lưu).
+- `_<Tên>/default.ascx` còn là trang theo URL `/<Tên>/…` (`_Search`, `_Index`, `_RSS`, `_Event`, `_more-List`…): tạo `LHUENB4/_LienHe/default.ascx` là có `https://<site>/LienHe` mà không cần tạo thư mục trong /admin.
+- `@` ở đầu (`@HomePage`, `@ReadPage`) chỉ là quy ước cho trang chính, không có xử lý riêng.
+
+## Hình ảnh, font và tài liệu
+
+Hình/font của giao diện để ngay trong ViewPage, cạnh trang dùng nó:
+
+```bash
+# chép file vào workspace rồi đẩy lên như file code
+copy .\hero.webp C:\APP\mlis-workspaces\LHUENB4\MyPage\_images\hero.webp
+mlis status LHUENB4/MyPage
+mlis push LHUENB4/MyPage
+```
+
+Trong css của trang dùng đường dẫn tương đối `url(_images/hero.webp)`; trong .ascx dùng `/ViewPage/LHUENB4/MyPage/_images/hero.webp`.
+
+Tài liệu đính kèm (doc, xls, zip…) hoặc file muốn quản lý qua CKFinder:
+
+```bash
+mlis cdn info                                   # Images/Files: URL gốc, giới hạn, đuôi cho phép
+mlis cdn mkdir banner                           # thư mục trong Images
+mlis cdn upload .\logo.png --to banner          # in {"url":"/Data/Folders/<CatID>/images/banner/logo.png"}
+mlis cdn upload .\quyche.pdf --type Files       # tài liệu → Files
+mlis cdn list banner                            # liệt kê + URL
+```
+
+Dán **URL tương đối** in ra vào .ascx/.css (`<img src="/Data/Folders/…">`, `background:url(/Data/Folders/…)`). CKFinder có thể đổi tên khi trùng hoặc thu nhỏ ảnh quá khổ — luôn dùng URL mà lệnh trả về. Chi tiết: `mlis skill ref cdn-files`.
+
+## Tham khảo
+
+- `mlis skill ref controls` — thuộc tính và placeholder `{n}` của từng control MLIS (NewsList, CatMenu, CatShow, EventList, NewsDetail, …), giá trị CatID/Location/PageLink/Visibility.
+- `mlis skill ref rendered-html` — HTML mà từng control sinh ra (class, cấu trúc) để viết CSS đúng.
+- `mlis skill ref design-patterns` — mẫu trang thật đang chạy (trang chủ, trang thư mục, trang đọc tin, header/footer) và các quy ước CSS/JS của site.
+- `mlis skill ref viewpage-structure` — cách site chọn trang (PageStyle/PageRead, route `_<Tên>`), nhiều tên miền, những gì nền tảng tự thêm, quy ước tiền tố `_`/`@`, file tĩnh.
+- `mlis skill ref news` — nội dung động bằng bài viết: NewsDetail/NewsList làm khuôn, `mlis news ls|show|pull|diff|push|new`, định dạng file `_news/<NewsID>.html`, quy tắc lưu bài của server, sự kiện, xung đột.
+- `mlis skill ref cdn-files` — CKFinder: CatID, mode folder/news, Images/Files.
+
+Lệnh luôn in dữ liệu ra stdout (bảng khi ở terminal, TSV khi pipe, `--json` cho máy), ghi chú/lỗi ra stderr. Exit code: 0 ok, 1 lỗi, 2 sai cú pháp, 3 bị chặn an toàn.

package/skills/mlis/references/cdn-files.md

@@ -0,0 +1,38 @@
+# Hình ảnh và tài liệu qua CKFinder (`mlis cdn`)
+
+Hình/font thuộc giao diện nên để ngay trong ViewPage (`mlis push`, xem viewpage-structure). CKFinder dành cho file nằm ngoài ViewPage: tài liệu đính kèm (doc, xls, zip…), ảnh dùng chung với bài viết, hoặc khi server chưa có API `UploadFile`. CLI dùng CKFinder 2.6.3 có sẵn của MLIS (`/JScript/CKFinder/core/connector/aspx/connector.aspx`) với cùng token `jwtAuth`.
+
+## Nơi lưu file
+
+CKFinder của MLIS gắn với một **thư mục (CatID)** trong trang quản trị:
+- `--mode folder` (mặc định): `/Data/Folders/<CatID>/images/…` và `/Data/Folders/<CatID>/files/…`
+- `--mode news`: `/Data/News/<CatID>/…`
+
+Đặt CatID mặc định một lần: `mlis config set cdn-cat <CatID>` (hoặc `--cat` cho từng lệnh). Nên dùng một thư mục riêng cho tài nguyên giao diện, hỏi người dùng CatID nào nếu chưa đặt. CLI tự "mồi" session bằng `/Admin/CKFinder.aspx?CatID=…&mode=…` trước khi gọi connector.
+
+## Loại tài nguyên
+
+| type | Đuôi | Giới hạn |
+|---|---|---|
+| `Images` | gif, jpeg, jpg, png | theo Web.config (CKImagesMaxSize*); ảnh quá khổ bị CKFinder thu nhỏ |
+| `Files` | 7z, csv, doc, docx, gif, jpg, mp3, mp4, pdf, png, ppt, pptx, rar, txt, xls, xlsx, zip, … | 4 MB |
+
+`mlis cdn info` cho giá trị thật từ server. `upload` tự chọn `Images` cho ảnh, `Files` cho phần còn lại; mặc định các lệnh khác là `Images`, đổi bằng `--type Files`.
+
+## Lệnh
+
+```bash
+mlis cdn info
+mlis cdn list [folder] [--type Files] [--recursive]
+mlis cdn mkdir banner
+mlis cdn upload .\banner.jpg --to banner [--name banner-2026.jpg]
+mlis cdn url banner/banner-2026.jpg
+mlis cdn rename banner/banner-2026.jpg banner-tet.jpg
+mlis cdn download banner/banner-tet.jpg -o .\banner-tet.jpg
+mlis cdn rm banner/banner-tet.jpg --confirm-delete
+mlis cdn rmdir banner --confirm-delete [--recursive]
+```
+
+`upload` in `{"type","path","url"}`; dán `url` (tương đối, ví dụ `/Data/Folders/12/images/banner/banner-tet.jpg`) vào .ascx/.css. CKFinder có thể đổi tên file khi trùng (lệnh báo `# CKFinder renamed…`) — luôn dùng URL trả về.
+
+Xoá là vĩnh viễn và có thể làm vỡ ảnh trên trang/bài viết đang dùng: chỉ xoá khi người dùng cho phép đúng file/thư mục đó.

package/skills/mlis/references/controls.md

@@ -0,0 +1,161 @@
+# Control MLIS trong trang .ascx
+
+Nguồn: `MLIS_UserControl.doc` (tài liệu gốc của MLIS), đối chiếu với thuộc tính thật trong `App_Code/PagesControl/*.vb`. Control dùng tiền tố `MLIS` (đã đăng ký trong Web.config; nhiều trang vẫn ghi thêm `<%@ Register TagPrefix="MLIS" Namespace="MLIS" %>` ở đầu, cũng được). Mọi control cần `runat="server"`. Giá trị trong ngoặc là mặc định.
+
+## URL của site
+
+- Trang chủ: `https://lhu.edu.vn/`
+- Trang một thư mục: `https://lhu.edu.vn/40/Gioi-thieu.html` — 40 là ID thư mục (CatID).
+- Trang đọc tin: `https://lhu.edu.vn/446/3387/Bai-hat-truyen-thong.html` — 446 là thư mục (và trang ascx hiển thị tin), 3387 là ID tin (NewsID).
+- Trang theo route: `/more-list/…`, `/more-news/…`, `/more-related/…`, `/search/…` → nạp `ViewPage/<site>/_<tên>/default.ascx` (xem viewpage-structure).
+
+## Thuộc tính chung
+
+**CatID** — thư mục để lấy dữ liệu.
+- `> 0`: đúng CategoryID đó.
+- `0`: cấp lớn nhất (trang chủ, HomeID); `-1`: dưới trang chủ 1 cấp; `-X`: dưới trang chủ X cấp.
+- `-100`: thư mục đang chọn (cấp nhỏ nhất); `-101`: thư mục đang chọn lên 1 cấp; `-10X`: lên X cấp.
+
+**Location** (0) — số thứ tự vị trí: chọn các thư mục con của CatID được gán "vị trí" này trong trang quản trị; tin trong các thư mục con đó được lấy ra. `0` = lấy tin nằm ngay trong CatID (với CatMenu: lấy hết menu; với CatShow: chính thư mục đang chọn).
+
+**Visibility** (0) — `0` luôn hiển thị; `1` ẩn khi đang đọc tin (có NewsID); `2` ẩn khi không đọc tin.
+
+**Related** — dùng "Quan hệ thư mục": `0` cột "Tổng hợp tin" (bit 0), `1` "Cùng nội dung" (bit 1), `2` "Nội dung gần" (bit 2). NewsList/EventList mặc định `5` = không tổng hợp.
+
+**PageLink** (0) — thư mục nằm trong link của tin:
+- `0` ID thư mục chứa tin (`/201/50868/…`)
+- `1` ID thư mục của chính danh sách (thư mục CatID/thư mục con theo Location đang được liệt kê — dùng khi tổng hợp tin từ thư mục khác) (`/21/50868/…`)
+- `2` ID trang đang chọn (`/34/50868/…`)
+- `3` ID trang chủ đang hiển thị (`/1/50868/…`)
+
+**Skip** (0) — bỏ qua N tin đầu, lấy từ tin N+1.
+
+**CatFormat** (`<a>{1}</a>`) — hiển thị thông tin thư mục; thẻ `<a>` tự thành link, bỏ `<a></a>` nếu không muốn link.
+`{0}` Icon (class CIco) · `{1}` Tên thư mục · `{2}` Hình (class CPic) · `{3}` Mô tả · `{4}` Tên khác (Alias) · `{5}` Tài liệu HTML của thư mục · `{6}` Sub menu (thư mục con)
+
+**NewsFormat** — định dạng một tin:
+`{0}` Hình (NImg) · `{1}` Tiêu đề (NTitle) · `{2}` Ngày giờ (NTime) · `{3}` Tóm tắt (NIntro) · `{4}` Nội dung (NContent) · `{5}` Từ khoá (NKey) · `{6}` Nguồn/tác giả (NSource) · `{7}` Thời gian cập nhật (NUpdate) · `{8}` chèn class `Selected` cho bài đang xem · `{9}` Lượt xem (NCounter)
+
+**DateTimeFormat** — chuỗi định dạng .NET (`dd/MM/yyyy HH:mm:ss`, `H:mm`, …).
+**ViewMore** ("") — chữ của link "xem thêm" cuối danh sách (mở thư mục).
+**HyperFormat** ("") — ưu tiên cao nhất, thay cho ListFormat/EventFormat: khuôn bao ngoài dùng được placeholder của CatFormat (`{1}` tên, `<a>` tự thành link…) và các khối `{{NewsItem}}`, `{{OtherItem}}`, `{{EventItem}}`, `{{ViewMore}}`. Ngoặc nhọn **đôi** là bắt buộc: chuỗi đi qua `String.Format` trước (một cặp ngoặc bị nuốt) rồi mới thay `{NewsItem}`… Một dấu `{` đơn lẻ không phải placeholder trong bất kỳ format nào cũng phải viết `{{` (CSS inline trong format: dùng class thay vì `style="…{…}"`).
+**CssClass** — class CSS của khối.
+
+Format có thể viết làm thuộc tính (nháy kép bên ngoài, nháy đơn bên trong) hoặc làm thẻ con khi dài:
+
+```aspx
+<MLIS:NewsList Location="7" PageLink="0" CatFormat="" NewsNumber="2" NewsOther="0" runat="server">
+<NewsFormat>
+    <li class='row news'><div class='row'><div class='col-md-5'>{0}</div><div class="col-md-7">{1}{3}</div></div></li>
+</NewsFormat>
+<HyperFormat>
+    <ul class="">{{NewsItem}}</ul>
+</HyperFormat>
+</MLIS:NewsList>
+```
+
+## Nạp trang / css
+
+### LoadPage
+Chèn một trang .ascx vào vị trí đặt control và/hoặc nạp mọi file `*.css` trong một thư mục vào `<head>`.
+- `Src` ("") — đường dẫn .ascx, ví dụ `ViewPage/LHUENB4/_default/Header.ascx`.
+- `CssFolder` ("") — thư mục chứa các .css cần nạp, ví dụ `ViewPage/LHUENB4/@HomePage` (nạp tất cả *.css trong đó, kèm `?version`).
+
+```aspx
+<MLIS:LoadPage CssFolder="ViewPage/LHUENB4/@HomePage" runat="server" />
+<MLIS:LoadPage CssFolder="ViewPage/LHUENB4/_default" Src="ViewPage/LHUENB4/_default/Header.ascx" runat="server" />
+```
+
+## Menu và thư mục
+
+### CatMenu — các thư mục dạng menu
+`CatID` (-100: lấy thư mục con của nó) · `Location` (0 = hết menu) · `CatFormat` (`<a>{1}</a>`, không áp dụng cho sub menu) · `Visibility` · `CssClass` ("CatMenu"; mục đang chọn có class `Selected`) · `ItemClass` ("" class từng nhóm) · `ShowSubName` (false: hiện tên menu cấp 2) · `ShowSubIcon` (false) · `NewsNumber` (0: lấy thêm N tin làm menu; tin xếp từ thứ tự 20 trở đi).
+
+```aspx
+<MLIS:CatMenu ID="CatMenu1" CatID="0" Location="1" CssClass="navbar-nav navbar-left" ShowSubName="false" runat="server" />
+```
+
+### CatRelated — thư mục có "Quan hệ thư mục" dạng menu
+`CatID` (-100) · `Related` (1) · `CatFormat` · `Visibility` · `CssClass` ("CatMenu") · `ItemClass` · `ShowSubName` · `ShowSubIcon`.
+
+### CatShow — thuộc tính của một thư mục
+`CatID` (-100) · `Location` (0 = thư mục đang chọn) · `Visibility` · `CatFormat` (`<a>{1}</a>`) · `CssClass` ("CatShow").
+
+```aspx
+<MLIS:CatShow ID="CatShow1" CssClass="CatShow" CatFormat="<h2>{1}</h2>" runat="server" />
+<MLIS:CatShow ID="CatShow2" CatFormat="<div>{2}</div><div class='CatHTML'>{5}</div>" runat="server" />
+```
+
+### CatStream — chuỗi đường dẫn (breadcrumb)
+`Level` (0: từ cấp N trở đi, 0 = gốc HomeID) · `PathText` (`<span>&raquo;</span>` ký hiệu phân cách) · `UseAlias` (false) · `CssClass` ("CatStream").
+
+### IndexAZ — chỉ mục A–Z các thư mục
+`VisualPath`.
+
+## Danh sách tin
+
+### NewsList — tin dạng liệt kê có tóm tắt
+`CatID` (-100) · `Location` (0) · `Related` (5) · `PageLink` (0) · `Visibility` · `Skip` · `NewsNumber` (1 tin chính) · `NewsOther` (0 tin khác, chỉ tiêu đề) · `GetFirstNews` (false: lấy tin đầu để hiện chi tiết) · `DateTimeFormat` ("dd/MM/yyyy HH:mm:ss") · `ViewMore` · `HyperFormat` (`{{NewsItem}}`, `{{OtherItem}}`, `{{ViewMore}}`).
+- `ListFormat` (`<div>{0}<ul>{1}</ul><ul>{2}</ul>{3}</div>`): `{0}` CatFormat · `{1}` danh sách NewsFormat · `{2}` danh sách OtherFormat · `{3}` link ViewMore
+- `CatFormat` (`<h3 class=CName><a>{1}</a></h3>`)
+- `NewsFormat` (`<li class="{8}">{0}{1}{2}{3}</li>`) — placeholder như NewsFormat chung
+- `OtherFormat` (`<li>{1}{2}</li>`): `{0}` hình · `{1}` tiêu đề · `{2}` ngày giờ
+
+```aspx
+<MLIS:NewsList Location="22" PageLink="1" NewsNumber="1" NewsOther="6" Skip="0"
+    ListFormat="<div class='container NewsList'>{0}<div class='row'><div class='col-md-5'><ul class='row h-100'>{1}</ul></div><div class='col-md-7'><ul class='row h-100'>{2}</ul></div></div>{3}</div>"
+    CatFormat="<h2 class='row mb-4 mt-5 text-center'><a>{1}</a></h2>"
+    NewsFormat="<li class='mb-4'><div class='card shadow-sm h-100'>{0}<div class='card-body'><b>{1}</b><i>{3}</i></div></div></li>"
+    OtherFormat="<li class='col-md-4 mb-4'><div class='card shadow-sm h-100'>{0}<div class='card-body'>{1}</div></div></li>"
+    runat="server" />
+```
+
+### NewsRelated — tin trong các thư mục có quan hệ với thư mục đang chọn
+(không hiện tin của chính thư mục đó) — thuộc tính như NewsList, thêm `Merge` (false: để riêng từng thư mục; true: trộn hết) và `Related` mặc định 0. `ListFormat` mặc định `{0}<ul>{1}</ul><ul>{2}</ul>{3}`.
+
+### NewsOther — tin liên quan tới bài đang đọc (chỉ hiện khi có NewsID)
+- `ListFormat` (`<ul>{0}</ul><ul>{1}</ul><ul>{2}</ul>{3}`): `{0}` tin cũ hơn tin đang đọc · `{1}` tin cùng dòng sự kiện · `{2}` tin cùng từ khoá · `{3}` ViewMore
+- `NewsFormat` (`<li>{0}{1}{2}</li>`): `{0}` hình · `{1}` tiêu đề · `{2}` ngày giờ
+- `NewsOther` (5) · `NewsStream` (5) · `NewsKeyword` (5) · `Skip` · `PageLink` (0 và 1 như nhau: thư mục chứa tin) · `DateTimeFormat` · `ViewMore`.
+
+### EventList — danh sách sự kiện
+`CatID` (-100) · `Location` (0) · `Related` (5) · `Skip` · `Visibility` · `EventNumber` (5) · `DateTimeFormat` ("yyyy/MM/dd HH:mm ") · `DayFormat` ("MM/dd") · `ViewMore` · `CatFormat` (`<h3 class=CName><a>{1}</a></h3>`).
+- `EventFormat` (`{0}{1}{2}`): `{0}` CatFormat · `{1}` danh sách EventItemFormat · `{2}` link các sự kiện tiếp theo
+- `EventItemFormat` (`{1}{2}`): `{0}` hình (NImg) · `{1}` tiêu đề (NTitle) · `{2}` thời gian (DateTimeFormat)
+- `HyperFormat`: `{{EventItem}}`, `{{ViewMore}}`
+
+```aspx
+<MLIS:EventList Location="11" Skip="2" DayFormat="''<i>d</i><u>T MM</u>" DateTimeFormat="H:mm" EventNumber="1" runat="server">
+    <EventItemFormat>{0}{1}{2}</EventItemFormat>
+    <HyperFormat>
+        <div class='d-md-none d-lg-block col-lg-4 mb-4'>{{EventItem}}</div>
+    </HyperFormat>
+</MLIS:EventList>
+```
+
+## Chi tiết
+
+### NewsDetail — một tin dạng chi tiết (trang đọc tin `@ReadPage`)
+`NewsID` (0: tin của URL; >0 chỉ định một tin) · `CatName` (`<h2>{0}</h2>`, `{0}` tên thư mục) · `NewsFormat` (`{1}{4}{5}{6}`, placeholder như NewsFormat chung) · `Author` ("{0}", ví dụ "Tác giả {0}", class NSource) · `HitCounter` ("{0}", ví dụ "Lượt xem {0}", class NCount) · `DateTimeFormat` ("dd/MM/yyyy HH:mm:ss").
+
+## Khác
+
+### Attr — dữ liệu hệ thống
+`AttrFormat`: `{0}` số lần truy cập · `{1}` số người online · `{2}` tên miền · `{3}` HomeID · `{4}` số người đang xem HomeID.
+
+```aspx
+<i class="fa fa-bar-chart-o"></i> <MLIS:Attr ID="Attr4" AttrFormat="{1}" runat="server" />
+```
+
+### Search — ô tìm kiếm
+`Text` ("" tiêu đề ô) · `CssClass` ("Search") · `icon` (HTML của nút, ví dụ `<i class='fa fa-search'></i>`).
+
+### RSS — các kênh RSS 2.0
+`UseAlias` (true: dùng tên khác; false: tên thư mục).
+
+## Cấu hình thư mục liên quan (trong /admin, không sửa bằng CLI)
+
+- **Liên kết**: để trống = link tới chính thư mục; `http://…` = link ngoài; `{codien.lhu.edu.vn}` = dùng tên miền đó cho thư mục.
+- **Trang chủ (Home)**: 0 = chính nó là trang chủ; 1 = thư mục cha; 2 = ông nội; …
+- **Kiểu thư mục (CatType)**: 0 ẩn · 1 trang chủ · 2 thư mục · 3 thông báo · 4 sự kiện · 5 giới thiệu · 6 thư viện ảnh · 7 liên kết · 8 tài liệu HTML.
+- **PageStyle**: thư mục trang trong ViewPage dùng để hiển thị thư mục đó (xem viewpage-structure).

package/skills/mlis/references/design-patterns.md

@@ -0,0 +1,94 @@
+# Mẫu thiết kế thật trên lhu.edu.vn (site `LHUVNB4`)
+
+Rút ra từ các trang đang chạy (đọc bằng `mlis pull`, 10/2026). Site `LHUVNB4` phục vụ lhu.edu.vn và nhiều tên miền con; `LHUENB4` là bản tiếng Anh. Trước khi làm trang mới, `mlis pull` trang cùng loại gần nhất và theo đúng khung của nó.
+
+## Khung chung của mọi trang
+
+```aspx
+<%@ Register TagPrefix="MLIS" Namespace="MLIS" %>
+<link href="/ViewPage/LHUVNB4/<TrangNay>/StyleMain.css" rel="stylesheet" type="text/css" />   <%-- hoặc LoadPage CssFolder --%>
+<MLIS:LoadPage ID="LoadPage1" CssFolder="ViewPage/LHUVNB4/_default" Src="ViewPage/LHUVNB4/_default/Header.ascx" runat="server" />
+<div id="TimeLineImage"></div>          <%-- chừa chỗ dưới header cố định; trang nào cũng có --%>
+
+<div class="container"> … nội dung … </div>
+
+<br />
+<MLIS:LoadPage ID="LoadPage2" Src="ViewPage/LHUVNB4/_default/Footer.ascx" runat="server" />
+```
+
+- `_default/Header.ascx` + `_default/StyleDefault21.css`, `StyleHeaderFooter21.css` (nạp qua `CssFolder="ViewPage/LHUVNB4/_default"`). Header có: menu "Thông tin cho" (`<MLIS:CatMenu CatID="94">`), menu chính (`<MLIS:CatMenu CatID="0" Location="1">`), ô tìm kiếm (`<MLIS:Search icon="<i class='fa fa-search'></i>">` → trang `_Search` dùng Google Custom Search), logo có `alt`, chat widget `https://cdn.lhu.edu.vn/scripts/chat-widget.min.js` (ai.lhu.edu.vn).
+- `_default` còn nhiều biến thể (`Header25.ascx`, `Header-ASU.ascx`, `Footer_2026.ascx`, `Footer_CareerFair.ascx`…): trang đặc biệt chọn header/footer riêng bằng `Src`.
+- HeaderOfSite (`_assets/HeaderOfSite.ascx`) đã nạp: Source Sans Pro, Font Awesome **4.2 và 6.4** (`fa fa-…` và `fa-solid fa-…`), Bootstrap + MDB (`/assets/mdb/`), owlCarousel, Google Tag Manager; và tự khởi chạy owlCarousel cho mọi phần tử `.Carousel` có từ 2 con trở lên.
+
+## Trang chủ (`@HomePage/default.ascx`)
+
+- Banner: `<MLIS:CatShow ID="CatShow1" CatFormat="{5}" CssClass="Carousel" runat="server" />` — **nội dung banner là HTMLDoc của thư mục trang chủ**, nhân viên sửa trong /admin, không cần designer; class `Carousel` để owlCarousel chạy.
+- Các khối tin: `NewsList` với **Location** (13, 10, 12, 7, 19…) — mỗi số là vị trí gán cho thư mục con của trang chủ. Kiểm tra số nào dùng cho thư mục nào: `mlis category ls <CatID trang chủ>`.
+  ```aspx
+  <MLIS:NewsList Related="0" Location="13" PageLink="0" CatFormat="" NewsNumber="1" NewsOther="0" runat="server">
+      <NewsFormat><li><div class="NewsTitle">{0}{1}</div></li></NewsFormat>
+      <HyperFormat><ul class="News">{{NewsItem}}</ul></HyperFormat>
+  </MLIS:NewsList>
+  <%-- cùng nguồn, bỏ qua tin đã hiện: Skip="1" --%>
+  ```
+- Sự kiện: `<MLIS:EventList Location="11" Skip="0" DayFormat="''<i>d</i><u>T MM</u>" …>` lặp 3 lần với Skip 0/1/2 để chia cột.
+- Khối liên kết cuối trang: `<MLIS:CatMenu CatID="0" Location="20" CatFormat="{6}" CssClass="CatMenu row" ItemClass="col-md col-sm-6" ShowSubName="true">` — mỗi thư mục Location 20 là một cột, `{6}` in menu con.
+- Tiêu đề khối dùng `<div class="TitleGroup">` + `<div class="SubTitle">` (CSS `@HomePage/StyleMain.css`), nút `<button class="Nut">`. **Trang chủ hiện không có `<h1>`** — trang mới nên có một h1 (có thể ẩn bằng CSS) và dùng h2 cho TitleGroup.
+- Hình của trang chủ nằm trong `@HomePage/_images/` (và bản cũ `@HomePage/Image/`); `_default.ascx` trong thư mục là bản lưu cũ (tên có `_` nên không ai chọn nhầm).
+
+## Trang thư mục
+
+**Dải tiêu đề + breadcrumb** (DefaultPage2Column, DefaultPageCatalog):
+```aspx
+<div class="HeaderSubContent"><div class="container"><div class="HeaderSub">
+    <MLIS:CatShow ID="CatShow1" CatFormat="<h2>{1}</h2>" runat="server" />
+    <MLIS:CatStream ID="CatStream01" Level="0" PathText="<span>&nbsp; &raquo; &nbsp;</span>" runat="server" />
+</div></div></div>
+```
+Hiện dùng `<h2>` cho tên thư mục và trang không có h1 — trang mới nên dùng `CatFormat="<h1>{1}</h1>"` (giữ class/CSS như cũ).
+
+- **DefaultPage2Column** — mỗi thư mục con (Location 2) một thẻ card liệt kê 5 tin:
+  `<MLIS:NewsList Location="2" Visibility="1" NewsNumber="0" NewsOther="5" ViewMore="Xem thêm" ListFormat="<div class='col-sm-6 d-flex'><div class='card padding mb-5'><div class='text-uppercase CatName'>{0}</div><ul class='more-news'>{2}</ul><div class='view-more'><i class='fa fa-chevron-circle-right'></i>{3}</div></div></div>" OtherFormat="<li>{1}</li>"/>`
+- **DefaultPageCatalog** — cột trái danh sách tiêu đề (tối đa 30) của thư mục, cột phải chi tiết tin đầu tiên: `NewsList … GetFirstNews="true" NewsFormat="<li class='{8}'>{1}</li>"` + `<MLIS:NewsDetail NewsFormat="<div class='NewsDetail'>{1}{4}</div>" CatName="" />`. `{8}` tô tin đang xem. Menu trái thu gọn trên mobile bằng `navbar-collapse`.
+- **DefaultPageCat** — mô tả thư mục `{3}`, danh sách thư mục con, cột phải hình `{2}` + HTMLDoc `{5}`. ⚠ Bản đang chạy còn trỏ site cũ `ViewPage/LHUVN/...` (không tồn tại → mất CSS, header, footer). `mlis check LHUVNB4/DefaultPageCat` báo lỗi này.
+
+## Trang đọc tin (`@ReadPage/Default.ascx`)
+
+```aspx
+<div class="container"><div class="row">
+  <div class="col-md-9">
+    <MLIS:NewsDetail ID="NewsDetail1" NewsFormat="<div class='NewsDetail'>{1}{4}{6}{5}</div>"
+        DateTimeFormat="'Lạc Hồng', dd/MM/yyyy - HH:mm:ss" HitCounter="Lượt xem {0}" runat="server" />
+    <MLIS:NewsOther ID="NewsOther1" PageLink="0" NewsOther="3" NewsKeyword="0" NewsStream="0" ViewMore="Tin khác"
+        ListFormat="<ul class='row NewsList'>{0}</ul>…<div class='view-more'>…{3}</div>" NewsFormat="<li class='col-md-4'>{0}{1}</li>" runat="server"/>
+  </div>
+  <div class="col-md-3">   <%-- cột phải: tin của thư mục cố định --%>
+    <MLIS:NewsList PageLink="1" CatID="118" NewsNumber="5" … NewsFormat="<li class='col-md-12'>{0}{1}</li>" runat="server"/>
+    <MLIS:NewsList PageLink="1" CatID="21"  NewsNumber="5" … runat="server"/>
+  </div>
+</div></div>
+```
+`{1}` của NewsDetail là `<h1 class=NTitle>` — h1 duy nhất của trang. Biến thể: `@ReadPageEvent`, `@ReadPageHomePage`, `@ReadPageNNTH` (gán qua PageRead).
+
+## Trang nội dung tĩnh / landing
+
+- **@LandingPage**: toàn bộ nội dung là HTMLDoc của thư mục: `<div class="container NewsDetail"><div class="NContent"><MLIS:CatShow CatFormat="{5}" runat="server" /></div></div>` — nhân viên soạn trong /admin, designer chỉ làm khung + CSS. Nên thêm h1 (`CatShow CatFormat="<h1>{1}</h1>"`) phía trên.
+- **GioiThieu**: trang viết tay dài (card, ảnh trong `GioiThieu/_Images/`, ảnh 360 ở `/Data/img360/...`) kèm `NewsList Location="25"` cho danh sách bài. ⚠ Nhiều ảnh `alt="Card image cap"`/`"smaple image"` hoặc thiếu alt — trang mới phải mô tả ảnh thật.
+- **Trang theo route** `_TuyenSinhDaiHoc` (URL `/TuyenSinhDaiHoc`): landing tuyển sinh tự chứa (CSS riêng, JS bundle), dùng `CatShow CatID="0" CatFormat="{4}"` (tên khác của trang chủ tên miền) và `CatFormat="{5}"`. ⚠ Bản đang chạy nạp CSS từ `ViewPage/LHUVNB4/TuyenSinhDaiHoc/` (thiếu dấu `_`) — `mlis check` báo.
+
+## Trang hệ thống
+
+- `_more-List`: `NewsList PageLink="1" NewsNumber="100"` — danh sách "xem thêm" phân trang theo `Skip` trên URL.
+- `_Search`: Google CSE (`cse.google.com`, `queryParameterName="q"`) + `<form runat="server">` (vì vậy trang không được cache).
+
+## Lớp CSS hay dùng (StyleDefault21.css / StyleMain.css)
+
+`#TimeLineImage`, `.mobile-fluid`, `.Carousel`, `.TitleGroup`, `.SubTitle`, `.Nut`, `.News`, `.News2`, `.boxNews`, `.NewsList`, `.NewsTitleList`, `.more-news`, `.view-more`, `.HeaderSubContent`, `.HeaderSub`, `.CatName`, `.NewsDetail`, `.NContent`, `.btn-action`, `.no-hover`, cùng các class do control sinh (`NImg`, `NTitle`, `NTime`… — xem `rendered-html`). Bootstrap: `container`, `row`, `col-md-*`, `col-lg-*`, `d-flex`, `py-5`, `card`.
+
+## Lỗi thường gặp đã thấy trên site (tránh lặp lại)
+
+1. Trỏ site cũ `ViewPage/LHUVN/...` sau khi đổi tên site → mất CSS/header không báo lỗi. Luôn `mlis check` trước khi push.
+2. Chép thư mục trang nhưng quên đổi đường dẫn `ViewPage/<thư mục>` bên trong (ví dụ `TuyenSinhDaiHoc` ↔ `_TuyenSinhDaiHoc`).
+3. Alt giữ chỗ từ mẫu Bootstrap; ảnh không alt.
+4. Không có h1 / dùng h2 cho tên trang.
+5. File thừa trong thư mục trang (`Default - Copy.ascx`, `_BK…`): vô hại nhưng gây nhầm; bản lưu nên để trong `_bk` hoặc dùng `mlis history`.

package/skills/mlis/references/news.md

@@ -0,0 +1,65 @@
+# Nội dung động: bài viết (news) thay cho chữ cứng trong .ascx
+
+Trang .ascx là **khuôn**. Chữ, hình, danh sách hay đổi (giới thiệu, thông báo, số liệu, khối "Vì sao chọn…", slider, liên hệ…) nên nằm trong **bài viết** để người quản trị sửa ngay trong /admin → Bài viết (hoặc AI sửa bằng `mlis news`), không phải sửa mã và đẩy lại ViewPage.
+
+## Ba cách đưa nội dung vào trang
+
+| Cần | Viết trong .ascx | Sửa nội dung ở đâu |
+|---|---|---|
+| Một khối nội dung cố định (đoạn giới thiệu, bảng học phí, hướng dẫn) | `<MLIS:NewsDetail NewsID="3387" NewsFormat="{4}" CatName="" runat="server" />` — `{4}` là nội dung HTML của bài; `{1}` tiêu đề, `{0}` hình, `{3}` tóm tắt | bài 3387: `mlis news pull 3387` |
+| Một nhóm khối giống nhau (thẻ, slider, lý do, đối tác, câu hỏi thường gặp) | `<MLIS:NewsList CatID="512" NewsNumber="6" NewsFormat="<div class='card'>{0}<h3>{1}</h3>{3}</div>" runat="server" />` — mỗi bài là một khối, thứ tự theo thứ tự sắp trong /admin | thêm/sửa/ẩn bài trong thư mục 512: `mlis news ls 512` |
+| Mô tả/HTML gắn với chính thư mục | `<MLIS:CatShow CatFormat="{3}">` (mô tả), `{5}` (Tài liệu HTML của thư mục) | /admin → Thư mục → Tài liệu HTML (chưa có lệnh mlis) |
+
+Placeholder đầy đủ: `mlis skill ref controls` (NewsFormat chung: `{0}` hình · `{1}` tiêu đề · `{2}` ngày · `{3}` tóm tắt · `{4}` nội dung · `{5}` từ khoá · `{6}` nguồn). Thư mục dùng làm kho nội dung cho trang thường để **không** cho hiện trong menu/RSS (cấu hình trong /admin).
+
+Khi thiết kế trang mới có nội dung động: đề xuất với người dùng thư mục/bài sẽ chứa nội dung (CatID/NewsID phải có sẵn hoặc tạo trong /admin — CLI không tạo thư mục), viết khuôn bằng NewsList/NewsDetail, rồi đưa nội dung vào bài bằng `mlis news`. `mlis render` dùng dữ liệu mẫu nên khuôn xem được cả khi bài chưa có.
+
+## Tìm bài đang cấp nội dung cho một trang
+
+1. Đọc .ascx (`mlis pull <thư mục>`), tìm `CatID="…"`/`NewsID="…"` trong `<MLIS:NewsList|NewsDetail|NewsRelated|EventList>`. `CatID="-100"` = thư mục đang mở, `0` = trang chủ tên miền; `Location="n"` = các thư mục con có Location n (`mlis category ls <CatID>`).
+2. `mlis news ls <CatID> [--search chữ]` → NewsID, tiêu đề, từ khoá, người tạo/sửa (giống danh sách trong /admin: tài khoản chỉ có quyền đóng góp thì chỉ thấy bài của mình).
+3. Có URL thì `mlis page <url>`: trang đọc tin `/<CatID>/<NewsID>/<tên>.html` cho biết NewsID và template.
+
+## Lệnh
+
+```bash
+mlis news ls 512 [--search "học phí"] [--from 2026/01/01] [--to 2026/12/31] [--skip 20] [--limit 50] [--trash]
+mlis news show 3387                 # in bài (không ghi file); --json: mọi cột
+mlis news pull 3387 3388            # → <workspace>/_news/3387.html
+mlis news diff 3387                 # local ↔ server
+mlis news push 3387 [--dry-run]     # lưu; exit 3 nếu bài đã bị sửa trên server sau lần pull
+mlis news new 512 --title "Học bổng 2027"   # tạo _news/new-512-<giờ>.html (newsId 0); push mới tạo bài
+```
+
+File bài: header là chú thích HTML, dưới là nội dung HTML của bài:
+```html
+<!--mlis-news
+newsId: 3387
+catId: 512
+title: Học phí năm học 2026-2027
+intro: Tóm tắt một dòng
+images: /Data/News/512/images/hoc-phi.jpg
+keyword: học phí, tuyển sinh
+source: Phòng Tài chính
+# news trong thư mục Thông tin tuyển sinh      ← dòng # chỉ để đọc
+-->
+<p>Nội dung…</p>
+```
+- Giá trị nhiều dòng hoặc có khoảng trắng đầu/cuối, bắt đầu bằng `"` → viết dạng chuỗi JSON (`intro: "dòng 1\ndòng 2"`).
+- **Sự kiện** (thư mục kiểu sự kiện): có `orderTime: yyyy-MM-dd HH:mm` (thời gian diễn ra), không có `intro`/`keyword`.
+- **Thư viện ảnh**: chỉ đọc; sửa trong /admin.
+- `catId` chỉ có ý nghĩa khi tạo bài mới; bài đã có giữ thư mục của nó (chuyển thư mục: kéo bài trong /admin → Bài viết).
+
+## Quy tắc của server (giống trang sửa bài trong /admin — App_Code\NewsEditor.vb)
+
+- Tiêu đề bắt buộc, ≤ 150 ký tự, không HTML (`<` `>` bị đổi thành `&lt;` `&gt;`), khoảng trắng thừa bị gộp.
+- Nội dung ≥ 30 ký tự, ≤ 50.000 (sự kiện 500.000); không nhúng ảnh base64 (`data:image`) — upload ảnh trước bằng `mlis cdn upload --mode news --cat <CatID>` rồi dùng URL `/Data/News/<CatID>/…`.
+- Từ khoá được chuẩn hoá thành `a, b, c`. Sau push, file được ghi lại đúng như server lưu (thông báo "server normalised").
+- Quyền: chỉ bài trong thư mục tài khoản có quyền; không có quyền → lỗi 404/403 từ server.
+
+## An toàn
+
+- Bài viết hiển thị **ngay** trên site thật (sau tối đa 60 giây cache). Chỉ sửa bài người dùng yêu cầu; đọc `mlis news diff` trước khi push và báo người dùng nội dung thay đổi.
+- Exit 3 = bài đã bị sửa trên web sau lần pull: chạy `mlis news diff`, hỏi người dùng giữ bản nào — `mlis news pull <id> --force` (lấy bản server, bản local vào `_history/_news/`) hoặc `mlis news push <id> --force` (ghi đè, bản server vào `_history/_news/`).
+- Không có lệnh xoá/ẩn bài: việc đó làm trong /admin.
+- Nội dung bài là HTML do người biên tập soạn bằng CKEditor: giữ cấu trúc đơn giản (p, h2/h3, ul/ol, table, img có alt, a), không đưa `<script>`, `<style>` hay class bố cục vào bài — bố cục thuộc về .ascx/.css.