nexus-typo-mcp 1.3.1 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/luat/QUY-TAC.md CHANGED
@@ -20,6 +20,7 @@ Hình minh hoạ: `dung/minh-hoa-vung-dat-chu.jpg` (dựng bằng `dung/minh-hoa
20
20
 
21
21
  - Bỏ hẳn dòng ghi chú nhỏ dưới đáy (vd "Vị trí dự án gần đúng, minh hoạ").
22
22
  - Khối tiêu đề (kể cả dòng viết tay đè lên) phải nằm gọn trong vùng 2. Phụ đề luôn ở vùng 4, không đổi vị trí theo cảnh.
23
+ - Nhích khối tiêu đề theo cảnh (P55, Phương duyệt 03/11/2026): kịch bản ghi `"dichDoc"` ở cảnh, số điểm ảnh khung thiết kế 960 (âm là lên, dương là xuống, -60 đến 60), dời cả khối mà không đổi style, cỡ chữ. Không ghi thì khối đứng đúng chỗ style đặt. Dời xong vẫn phải gọn trong vùng 2: bước vẽ đo mực chữ, lấn quá 1 % khung là lỗi như mọi cảnh. Khối đa số style đã chiếm gần hết vùng 2 nên chỗ nhích ít. Đo trên bảng 8 style (03/11/2026, mực chữ giữa cảnh, khung 960), chỗ còn trước khi chạm mép vùng: lên M14 57 px, M8 22, M12 17, M9 14, M11 6, M3, M6, M7 2 đến 3; xuống M12 36, M14 26, M6 13, M3 11, M7 8, M11 6, M9 3, M8 1. Lấn thêm tới 1 % khung (khoảng 10 px) chỉ là cảnh báo. Cảnh có chữ sau người (mục 1c) thì phần tool tự nhích cộng thêm vào số kịch bản ghi.
23
24
 
24
25
  ## 1b. Nội dung chính đặt ở đâu (Phương duyệt)
25
26
  - Nội dung chính của clip: dự án (ghim vị trí, tag), tuyến đường chính, quy hoạch chính, điểm đến chính và nhãn thời gian/khoảng cách của nó.
package/mcp/huong-dan.md CHANGED
@@ -51,6 +51,7 @@ Nexus Typo thêm tiêu đề chữ (typo, theo bộ style đã duyệt) và ph
51
51
  - `nen`: `"sang"` khi nền sau tiêu đề sáng (trời trắng, bản đồ sáng), chữ có viền, bóng đậm; ghi ở gốc hoặc ở cảnh.
52
52
  - `loe: true` (gốc hoặc cảnh): vệt sáng lướt chữ màu chuyển một lần, cho cảnh muốn gây chú ý. Mặc định tắt.
53
53
  - `sauNguoi: true` (ở cảnh; ở gốc là cả clip, cảnh ghi `false` thì tắt riêng): chữ to nằm sau người, người đi trước chữ, phụ đề vẫn nằm trên người. Chỉ bật khi người cao tới chỗ chữ to (selfie, người đứng sát máy, quay thấp). Người che quá 25 % một dòng thì tool tự nhích khối chữ lên, vẫn che thì cảnh đó chữ ra trước người và báo. Tách người tốn thời gian (trang web: khoảng 1 s mỗi khung với card đồ hoạ, 1 đến 5 s khi chỉ có CPU tuỳ số nhân; lần đầu tải mô hình 176 MB), chỉ bật ở cảnh cần.
54
+ - `dichDoc` (ở cảnh, số nguyên -60 đến 60): nhích cả khối chữ to lên (số âm) hoặc xuống (số dương), tính bằng điểm ảnh của khung 540x960, không đổi style, cỡ chữ. Chỉ dùng khi người dùng muốn chữ xích lên, xuống chút (vd né mặt người, né chữ có sẵn trong video). Khối chữ đa số style đã gần kín vùng chữ to nên chỉ nhích được ít: lên nhiều nhất M14 (khoảng 57), M8 (22), M12 (17); xuống nhiều nhất M12 (36), M14 (26); các style khác dưới 15 mỗi chiều. Dời quá vùng chữ to thì bước dựng báo lỗi "chữ lệch vùng": giảm số rồi chạy lại.
54
55
  - `tatPhuDe: [[0, 9]]` (giây video): đoạn không cần phụ đề (đồ hoạ tự có chữ). `chuSan: [[38, 47]]`: đoạn video có chữ sẵn ở vùng tiêu đề, tool cảnh báo cảnh typo chồng lên.
55
56
  - `toi`: độ đậm nhất lớp tối nền trên, dưới (mặc định 0,15; 0 tắt; tối đa 0,6). Cảnh nền sáng thấy vệt tối ở đáy khung thì hạ, vd `0.08`.
56
57
  - `vienPhuDe`: màu viền phụ đề `#rrggbb` theo màu chủ đạo của video (mặc định xanh lá đậm).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexus-typo-mcp",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "description": "MCP server cho agent AI thêm tiêu đề chữ, phụ đề, tiếng động vào video bất động sản dọc 9:16 và xuất MP4 ngay trên máy (Nexus Typo, typo.nexusone.vn)",
5
5
  "keywords": [
6
6
  "mcp",
@@ -25,7 +25,7 @@ Sau khi nạp: `TY_STYLES` (style đã duyệt), `TY_NAMES`; nếu app có mản
25
25
 
26
26
  Tự bốc style (`typoPlan`) chạy cùng thuật toán với bộ bốc Node của Nexus Typo (thử mọi bộ ≤ 3 style, xếp cả clip một lượt): cùng kịch bản ra cùng style ở trình duyệt và ở lệnh `kiem`; style có `motLan` (M7, M8, M11) tối đa 1 lần mỗi clip.
27
27
 
28
- Kịch bản (giữ tên trường của Map, K8): `script.titleColor` (`"vang"` | `"cyan"` | `"kem-dao"`, danh sách ở `HO_MAU` của `styles.mjs`), `script.nen` (`"sang"`: nền sáng), `script.titleBg` hoặc `hud.tag` (chữ nền M8); mỗi caption: `lead`, `hook`, `extra`, `loai` (loại chi tiết: `thoi-gian`, `khoang-cach`, `quy-mo`, `gia`, `moc`, `ten`, `khac`; không ghi thì đoán theo `hook`), `nhom` (cảnh cùng loại khác ý, vd `"thue"`, `"ban"`), `titleStyle` (bỏ trống thì bốc theo luật), `titleBg`, `chuyenDong` (bỏ trống thì `truot-trai`), `loe` (vệt sáng riêng cảnh, ghi đè `script.loe`), `lead2` (dòng dẫn thứ hai, M16), `doiLuc` (giây đổi dẫn tính từ đầu caption, M16), `mauNhan` (dải màu dòng nhấn M16), `nen` (`"sang"` riêng caption, đè `script.nen`).
28
+ Kịch bản (giữ tên trường của Map, K8): `script.titleColor` (`"vang"` | `"cyan"` | `"kem-dao"`, danh sách ở `HO_MAU` của `styles.mjs`), `script.nen` (`"sang"`: nền sáng), `script.titleBg` hoặc `hud.tag` (chữ nền M8); mỗi caption: `lead`, `hook`, `extra`, `loai` (loại chi tiết: `thoi-gian`, `khoang-cach`, `quy-mo`, `gia`, `moc`, `ten`, `khac`; không ghi thì đoán theo `hook`), `nhom` (cảnh cùng loại khác ý, vd `"thue"`, `"ban"`), `titleStyle` (bỏ trống thì bốc theo luật), `titleBg`, `chuyenDong` (bỏ trống thì `truot-trai`), `loe` (vệt sáng riêng cảnh, ghi đè `script.loe`), `lead2` (dòng dẫn thứ hai, M16), `doiLuc` (giây đổi dẫn tính từ đầu caption, M16), `mauNhan` (dải màu dòng nhấn M16), `nen` (`"sang"` riêng caption, đè `script.nen`), `dichDoc` (P55: nhích cả khối tiêu đề, px khung 960, âm là lên; bỏ trống thì chỗ style đặt; nằm ngoài vùng tiêu đề 8 đến 30 % thì phía nạp tự kiểm).
29
29
 
30
30
  Đổi dẫn (M16, Phương duyệt 29/10/2026): caption có `lead2` thì bộ bốc chỉ lấy style có đổi dẫn (M16), bộ bốc không đưa M16 vào caption không có `lead2`. Từ gói 0.1.14 (P45) ghi tay `titleStyle: "M16"` cho caption một dòng dẫn cũng được: `dungDuoc('M16', ...)` luôn `true`, dòng dẫn đứng yên. App dò style đổi dẫn bằng `DOI_DAN` (hoặc `STYLES[id].doiDan`, `styles.json` `doiDan`) của `styles.mjs`, không suy từ `dungDuoc` nữa (cách suy cũ ra rỗng từ 0.1.14). Mã dải màu dòng nhấn có sẵn ở `MAU_NHAN` (`STYLES.M16.mauNhan`, `styles.json` `mauNhan`), khỏi chép từ `typo.js`. Khẩu vị, rung ngẫu nhiên tính trên bộ bỏ M16 khi kịch bản không có `lead2`: kịch bản cũ ra cùng style như gói 0.1.6. Dòng dẫn `lead` đổi thành `lead2` lúc `doiLuc`, dòng nhấn đứng yên; `doiLuc` bỏ trống thì không đổi (lệnh `kiem` của Nexus Typo tự lấy theo lời, app phải ghi). M16 bật vệt sáng sẵn lúc `doiLuc` + 0,5 s, `loe: false` để tắt.
31
31
 
@@ -12,7 +12,8 @@
12
12
  // "doiLuc": "?" (giây đổi dẫn tính từ đầu cảnh; trống: lấy theo giờ chữ đầu của lead2 trong lời),
13
13
  // "mauNhan": "?" (dải màu dòng nhấn M16, mã trong luat/styles/M16.md; trống: bước phu-de tự chọn theo nền),
14
14
  // "nen": "?" ("sang" | "toi" riêng cảnh này, đè nen cả clip),
15
- // "sauNguoi": "?" (true: chữ tiêu đề nằm sau người, P22; chỉ bật khi người cao tới vùng tiêu đề, bước ve tách người ~0,4 s mỗi khung) } ],
15
+ // "sauNguoi": "?" (true: chữ tiêu đề nằm sau người, P22; chỉ bật khi người cao tới vùng tiêu đề, bước ve tách người ~0,4 s mỗi khung),
16
+ // "dichDoc": "?" (P55: nhích cả khối tiêu đề, điểm ảnh khung 960, âm là lên, -60 đến 60; trống: chỗ style đặt) } ],
16
17
  // "loe": "?" (vệt sáng lướt chữ màu chuyển cả clip, QUY-TAC mục 5; trống: tắt),
17
18
  // "sauNguoi": "?" (true: chữ sau người mọi cảnh, P22; cảnh ghi "sauNguoi": false thì tắt riêng cảnh đó),
18
19
  // "suKien": [ { "t": 97.05, "loai": "cham", "moTa": "tay chạm màn hình" } ],
package/src/luat/kiem.mjs CHANGED
@@ -12,6 +12,8 @@ const NGUONG_THU = 0.25;
12
12
  // đổi dẫn: style có cờ doiDan (M16); doiLuc sau lúc dòng dẫn thứ nhất vào xong, còn ít nhất 1 s trước khi khối ra
13
13
  const DOI_DAN = DS_TAT_CA.filter((s) => STYLES[s].doiDan);
14
14
  const DOI_SOM = 0.6, DOI_GIU = 1.0;
15
+ /** Nhích khối tiêu đề (P55): điểm ảnh khung 960, âm là lên. Rộng hơn vùng 2 cho mọi style; bước ve đo mực chữ mới chặn thật. */
16
+ export const DICH_DOC = [-60, 60];
15
17
  // dải màu dòng nhấn (style có bangMau: M16): mauNhan ghi ở cảnh là một mã trong bảng; trống thì bước phu-de tự chọn theo nền
16
18
  const MAU_NHAN = [...new Set(DS_TAT_CA.flatMap((s) => Object.keys(STYLES[s].bangMau || {})))];
17
19
 
@@ -58,6 +60,8 @@ export function kiemKichBan(kb, loi, { T = Infinity, thu = null } = {}) {
58
60
  const n = c.i + 1;
59
61
  if (c.loiNeo) { L(n, c.loiNeo); continue; }
60
62
  if (c.nen != null && !NEN.includes(c.nen)) L(n, `nen "${c.nen}" không hợp lệ: chỉ ${NEN.map((x) => `"${x}"`).join(', ')}`);
63
+ if (c.dichDoc != null && !(Number.isInteger(c.dichDoc) && c.dichDoc >= DICH_DOC[0] && c.dichDoc <= DICH_DOC[1]))
64
+ L(n, `dichDoc ${JSON.stringify(c.dichDoc)} phải là số nguyên ${DICH_DOC[0]} đến ${DICH_DOC[1]} (điểm ảnh khung 960, âm là lên; QUY-TAC mục 1)`);
61
65
  if (c.sauNguoi != null && typeof c.sauNguoi !== 'boolean') L(n, 'sauNguoi chỉ nhận true hoặc false (P22: chữ nằm sau người, chỉ bật ở cảnh người cao tới vùng tiêu đề)');
62
66
  if (!c.loai) B(n, `chưa ghi loai (${LOAI.join(', ')}): bốc style và tính chuỗi kém chính xác`);
63
67
  else if (!LOAI.includes(c.loai)) L(n, `loai "${c.loai}" không hợp lệ (${LOAI.join(', ')})`);
@@ -121,6 +125,7 @@ export function kiemKichBan(kb, loi, { T = Infinity, thu = null } = {}) {
121
125
  ...(c.loe != null ? { loe: c.loe } : {}),
122
126
  ...(c.nen ? { nen: c.nen } : {}),
123
127
  ...((c.sauNguoi ?? kb.sauNguoi) === true ? { sauNguoi: true } : {}), // P22: cảnh ghi riêng đè cả clip
128
+ ...(c.dichDoc ? { dichDoc: c.dichDoc } : {}),
124
129
  ...(c.mauNhan != null && STYLES[st].bangMau ? { mauNhan: c.mauNhan } : {}),
125
130
  style: st, lyDo: plan.lyDo[k], thu: thu && thu[k] ? thu[k][st] : null, soDong: n, nhip: nh, loi: c.loi, tu: [c.tuDau, c.tuCuoi] };
126
131
  });
@@ -85,13 +85,13 @@ export function quyetCanh(x, khung, w, h) {
85
85
  return { i: x.i, so: x.i + 1, hook: x.c.hook, dich: kq.dich, che: pt(kq.che), cheGoc: pt(goc.che), dong: goc.chu, tran, tat: kq.tat };
86
86
  }
87
87
 
88
- /** Job sau luật 1c: cảnh nhích có dichDoc, cảnh tắt bỏ sauNguoi. Hàm thuần. */
88
+ /** Job sau luật 1c: cảnh nhích có dichDoc (cộng vào số kịch bản ghi, P55: đo trên khối đã dời), cảnh tắt bỏ sauNguoi. Hàm thuần. */
89
89
  export function jobNeNguoi(job, ne) {
90
90
  if (!ne) return job;
91
91
  const tieuDe = job.tieuDe.map((c) => ({ ...c }));
92
92
  for (const x of ne.canh) {
93
93
  if (x.tat) delete tieuDe[x.i].sauNguoi;
94
- else if (x.dich) tieuDe[x.i].dichDoc = x.dich;
94
+ else if (x.dich) tieuDe[x.i].dichDoc = (tieuDe[x.i].dichDoc || 0) + x.dich;
95
95
  }
96
96
  return { ...job, tieuDe };
97
97
  }
package/src/phude/job.mjs CHANGED
@@ -6,7 +6,7 @@ export const VIEN_MAC_DINH = '#15803d';
6
6
  export function chuJob(giai, phuDe) {
7
7
  return {
8
8
  titleColor: giai.mau, titleBg: giai.chuNen || '', toi: giai.toi ?? TOI_NEN, vien: giai.vienPhuDe || VIEN_MAC_DINH, ...(giai.loe ? { loe: giai.loe } : {}),
9
- tieuDe: giai.canh.map((c) => ({ start: c.start, end: c.end, lead: c.lead, ...(c.lead2 ? { lead2: c.lead2, doiLuc: c.doiLuc } : {}), ...(c.mauNhan ? { mauNhan: c.mauNhan } : {}), hook: c.hook, extra: c.extra, titleStyle: c.style, ...(c.chuNen ? { titleBg: c.chuNen } : {}), ...(c.chuyenDong ? { chuyenDong: c.chuyenDong } : {}), ...(c.loe != null ? { loe: c.loe } : {}), ...(c.sauNguoi ? { sauNguoi: true } : {}) })),
9
+ tieuDe: giai.canh.map((c) => ({ start: c.start, end: c.end, lead: c.lead, ...(c.lead2 ? { lead2: c.lead2, doiLuc: c.doiLuc } : {}), ...(c.mauNhan ? { mauNhan: c.mauNhan } : {}), hook: c.hook, extra: c.extra, titleStyle: c.style, ...(c.chuNen ? { titleBg: c.chuNen } : {}), ...(c.chuyenDong ? { chuyenDong: c.chuyenDong } : {}), ...(c.loe != null ? { loe: c.loe } : {}), ...(c.sauNguoi ? { sauNguoi: true } : {}), ...(c.dichDoc ? { dichDoc: c.dichDoc } : {}) })),
10
10
  phuDe: phuDe.map((c) => ({ start: c.start, end: c.end, sub: c.sub })),
11
11
  };
12
12
  }