nexus-typo-mcp 1.2.0 → 1.3.0
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/README.md +16 -0
- package/cli/nexus-typo.mjs +50 -8
- package/mcp/huong-dan-may.md +9 -2
- package/mcp/may.mjs +33 -4
- package/package.json +1 -1
- package/src/may.mjs +8 -4
- package/src/xuat/ghep.mjs +85 -17
- package/src/xuat/soat.mjs +36 -4
package/README.md
CHANGED
|
@@ -61,6 +61,22 @@ Việc dài trả `job_id`; `job_status` với `wait_seconds` tới 55 để ch
|
|
|
61
61
|
`<tên video>.nexus-typo/` cạnh video, video ra ở `ket-qua/` cạnh video. Lần đầu bật chữ sau người, gói tự cài
|
|
62
62
|
onnxruntime và tải mô hình vào `~/.nexus-typo/` (khoảng 300 MB).
|
|
63
63
|
|
|
64
|
+
## Gửi file đi
|
|
65
|
+
|
|
66
|
+
`render` với `share: true` ra thêm bản gửi `_share.mp4` (bitrate bằng video gốc) cạnh bản chính, cùng một lượt
|
|
67
|
+
ghép; `max_mb` khai trần dung lượng (có `share` thì áp vào bản gửi). Video ra dự kiến quá 800 MB thì `render` báo
|
|
68
|
+
`goi_y`. Tải lên một lần (GitHub Release, kho nhận file qua một kết nối) chỉ hợp file dưới khoảng 500 MB.
|
|
69
|
+
|
|
70
|
+
Lệnh chạy sau khi xuất xong (tự soát ĐẠT), ghi ở `~/.nexus-typo/may.json`:
|
|
71
|
+
|
|
72
|
+
```json
|
|
73
|
+
{ "post_export_cmd": ["rclone", "copy", "{share}", "drive:video-ra"] }
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Dạng mảng chạy thẳng, `{video}` là bản chính, `{share}` là bản gửi (không có bản gửi thì bỏ tham số đó). Dạng chuỗi
|
|
77
|
+
chạy qua shell, đường file ở biến môi trường `NT_VIDEO_RA`, `NT_VIDEO_GUI`. Lệnh chỉ đọc từ file này, công cụ MCP
|
|
78
|
+
không nhận lệnh.
|
|
79
|
+
|
|
64
80
|
## Biến môi trường
|
|
65
81
|
|
|
66
82
|
| Biến | Việc |
|
package/cli/nexus-typo.mjs
CHANGED
|
@@ -14,7 +14,8 @@ import { phuDe } from '../src/phude/buoc.mjs';
|
|
|
14
14
|
import { ve, xem } from '../src/ve/buoc.mjs';
|
|
15
15
|
import { sfx } from '../src/sfx/buoc.mjs';
|
|
16
16
|
import { nhac, dsBai } from '../src/nhac/buoc.mjs';
|
|
17
|
-
import { ghep, thamSoHinh } from '../src/xuat/ghep.mjs';
|
|
17
|
+
import { ghep, thamSoHinh, coNvenc, canhBaoDungLuong, lenhSauXuat } from '../src/xuat/ghep.mjs';
|
|
18
|
+
import { spawn } from 'node:child_process';
|
|
18
19
|
import { docThietBi, canDia, kiemTruocDung, tomTatMay } from '../src/thiet-bi.mjs';
|
|
19
20
|
import { timTrinhDuyet } from '../src/trinh-duyet.mjs';
|
|
20
21
|
import { soat } from '../src/xuat/soat.mjs';
|
|
@@ -45,9 +46,12 @@ const GIUP = `nexus-typo <lệnh> [tham số]
|
|
|
45
46
|
nhac <video> [--che-do giu|them|doi] [--nhac <file>] [--nhac-tu <giây>] [--duoi <min-max>] [--bpm <nhịp>] [--voice <file>] [--nhip vua|nhanh|cham]
|
|
46
47
|
Bước 8b: nhạc (giữ, thêm, đổi) + SFX + master -> am-thanh.wav, nhac.json
|
|
47
48
|
nhac-ds [--dai <giây>] [--nhip vua] Xếp bài thư viện nhạc theo nhịp (đo phách lần đầu lâu, sau dùng lại)
|
|
48
|
-
xuat <video> [--nhe]
|
|
49
|
+
xuat <video> [--nhe] [--gui] [--max-mb <số>]
|
|
50
|
+
Bước 9: ghép lớp chữ + tiếng vào video, cùng chuẩn input (--nhe: bitrate bằng input;
|
|
51
|
+
--gui: ra thêm bản gửi _share.mp4 cùng lượt, bản chính giữ nguyên; --max-mb: trần dung
|
|
52
|
+
lượng, có --gui thì áp vào bản gửi, không thì vào bản chính)
|
|
49
53
|
soat <video> [--nhe] Bước 10: tự soát video ra -> bao-cao.md
|
|
50
|
-
dung <video> [--che-do tu-dong|duyet] [--nhac-che-do giu|them|doi] [--nhac <file>] [--nhac-tu <giây>] [--duoi <min-max>] [--bpm <nhịp>] [--voice <file>] [--nhe]
|
|
54
|
+
dung <video> [--che-do tu-dong|duyet] [--nhac-che-do giu|them|doi] [--nhac <file>] [--nhac-tu <giây>] [--duoi <min-max>] [--bpm <nhịp>] [--voice <file>] [--nhe] [--gui] [--max-mb <số>]
|
|
51
55
|
Bước 5 đến 10 liền: kiem, phu-de, (duyet: ra ảnh duyệt rồi dừng), ve, nhac, xuat, soat
|
|
52
56
|
bang [--style M3,M15] [--nen <ảnh|video>] [--tu <giây>] [--mau vang|cyan|kem-dao] [--nen-sang] [--cau "dẫn|NHẤN|bổ sung|dẫn 2"] [--mau-nhan <mã|tat-ca>] [--ra <file.jpg>]
|
|
53
57
|
Bảng style trên nền thật (gồm style chưa duyệt), cho vòng duyệt style mới
|
|
@@ -198,8 +202,9 @@ const LENH = {
|
|
|
198
202
|
async xuat({ vi, tuy }) {
|
|
199
203
|
const video = vi[0];
|
|
200
204
|
if (!video) throw new Error('Thiếu đường dẫn video: nexus-typo xuat <video>');
|
|
201
|
-
const kq = await ghep(docMay(), thuMucLamViec(video), { nhe: !!tuy.nhe, inRa: (x) => console.log(' ' + x) });
|
|
202
|
-
console.log(`Đã xuất: ${kq.ra} (${kq.hinh.boMaHoa} ${kq.hinh.bitrateM} Mbit/s, ${kq.giay} s)`);
|
|
205
|
+
const kq = await ghep(docMay(), thuMucLamViec(video), { nhe: !!tuy.nhe, gui: !!tuy.gui, maxMb: soTran(tuy), inRa: (x) => console.log(' ' + x) });
|
|
206
|
+
console.log(`Đã xuất: ${kq.ra} (${kq.hinh.boMaHoa} ${kq.hinh.bitrateM} Mbit/s, ${kq.mb} MB, ${kq.giay} s)`);
|
|
207
|
+
if (kq.gui) console.log(`Bản gửi: ${kq.gui.ra} (${kq.gui.bitrateM} Mbit/s, ${kq.gui.mb} MB)`);
|
|
203
208
|
},
|
|
204
209
|
async soat({ vi, tuy }) {
|
|
205
210
|
const video = vi[0];
|
|
@@ -225,10 +230,19 @@ const LENH = {
|
|
|
225
230
|
// P64, H29: đọc máy trước; ổ không đủ thì dừng ngay, khỏi dựng cả giờ rồi hỏng lúc ghép. Không đổi chất lượng video ra.
|
|
226
231
|
const vao = JSON.parse(fs.readFileSync(tepVao, 'utf8')), may = docMay();
|
|
227
232
|
const tb = docThietBi([thuMucLamViec(video), path.dirname(tepRa(video, '.mp4', { tao: false }))], { trinhDuyet: timTrinhDuyet(may.chrome) });
|
|
228
|
-
const
|
|
233
|
+
const gui = !!tuy.gui, maxMb = soTran(tuy);
|
|
234
|
+
const tsGui = gui ? thamSoHinh(vao, { nvenc: false, nhe: true, maxMb }) : null;
|
|
235
|
+
const can = canDia({ W: vao.hinh.rong, H: vao.hinh.cao, T: vao.dai || vao.hinh.dai || 0, bitrateM: thamSoHinh(vao, { nvenc: false, nhe: !!tuy.nhe, maxMb: gui ? null : maxMb }).bitrateM + (tsGui?.bitrateM || 0) });
|
|
229
236
|
const k = kiemTruocDung(tb, can);
|
|
230
|
-
|
|
237
|
+
// P66: dung lượng dự kiến theo đúng bộ mã hoá máy này dùng, báo trước khi dựng
|
|
238
|
+
const nv = await coNvenc(may, vao.hinh.codec === 'h264' ? 'h264' : 'hevc');
|
|
239
|
+
const ts = thamSoHinh(vao, { nvenc: nv, nhe: !!tuy.nhe, maxMb: gui ? null : maxMb });
|
|
240
|
+
const duKien = { chinhMb: ts.duKienMb, guiMb: gui ? thamSoHinh(vao, { nvenc: nv, nhe: true, maxMb }).duKienMb : null };
|
|
241
|
+
const cb = canhBaoDungLuong(ts, { gui });
|
|
242
|
+
if (cb) k.canhBao.push(cb);
|
|
243
|
+
ghiJson(path.join(thuMucLamViec(video), 'may-doc.json'), { ...tb, can, duKien, ...k });
|
|
231
244
|
console.log('máy: ' + tomTatMay(tb));
|
|
245
|
+
console.log(`video ra dự kiến: khoảng ${duKien.chinhMb} MB${gui ? `, bản gửi khoảng ${duKien.guiMb} MB` : ''}`);
|
|
232
246
|
for (const x of k.canhBao) console.log(' cảnh báo: ' + x);
|
|
233
247
|
if (k.loi.length) throw new Error('chưa dựng được:\n ' + k.loi.join('\n '));
|
|
234
248
|
}
|
|
@@ -242,8 +256,10 @@ const LENH = {
|
|
|
242
256
|
}
|
|
243
257
|
await buoc('ve', () => LENH.ve({ vi, tuy: {} }));
|
|
244
258
|
await buoc('nhac', () => LENH.nhac({ vi, tuy: { 'che-do': tuy['nhac-che-do'], nhac: tuy.nhac, 'nhac-tu': tuy['nhac-tu'], duoi: tuy.duoi, bpm: tuy.bpm, voice: tuy.voice, nhip: tuy.nhip } }));
|
|
245
|
-
await buoc('xuat', () => LENH.xuat({ vi, tuy: { nhe: tuy.nhe } }));
|
|
259
|
+
await buoc('xuat', () => LENH.xuat({ vi, tuy: { nhe: tuy.nhe, gui: tuy.gui, 'max-mb': tuy['max-mb'] } }));
|
|
246
260
|
await buoc('soat', () => LENH.soat({ vi, tuy: { nhe: tuy.nhe } }));
|
|
261
|
+
const may = docMay({ kiem: false });
|
|
262
|
+
if (may.sauXuat) { console.log('\n== sau xuất'); await chaySauXuat(may, thuMucLamViec(video)); }
|
|
247
263
|
},
|
|
248
264
|
async bang({ tuy }) {
|
|
249
265
|
const styles = typeof tuy.style === 'string' ? tuy.style.split(',').map((x) => x.trim()) : null;
|
|
@@ -290,6 +306,32 @@ const LENH = {
|
|
|
290
306
|
giup() { console.log(GIUP); },
|
|
291
307
|
};
|
|
292
308
|
|
|
309
|
+
/** --max-mb: số MB dương, không ghi thì null. */
|
|
310
|
+
function soTran(tuy) {
|
|
311
|
+
if (tuy['max-mb'] == null) return null;
|
|
312
|
+
const n = Number(tuy['max-mb']);
|
|
313
|
+
if (!(n > 0)) throw new Error('--max-mb là số MB lớn hơn 0, vd --max-mb 450');
|
|
314
|
+
return n;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/** Lệnh sau xuất (P66): chỉ chạy khi tự soát đạt; lỗi thì báo, video ra vẫn giữ. Không in nội dung lệnh (có thể chứa khoá). */
|
|
318
|
+
async function chaySauXuat(may, thuMuc) {
|
|
319
|
+
const xuat = JSON.parse(fs.readFileSync(path.join(thuMuc, 'xuat.json'), 'utf8'));
|
|
320
|
+
const l = lenhSauXuat(may.sauXuat, { video: xuat.chinh.ra, share: xuat.gui?.ra || null });
|
|
321
|
+
console.log(` chạy lệnh sau xuất (post_export_cmd ở ${may.tep})…`);
|
|
322
|
+
const bd = Date.now();
|
|
323
|
+
const ma = await new Promise((xong) => {
|
|
324
|
+
const p = spawn(l.exe, l.args, { shell: l.shell, env: { ...process.env, ...l.env }, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
|
|
325
|
+
const ghi = (d) => process.stdout.write(String(d).split(/\r?\n/).filter(Boolean).map((x) => ' | ' + x).join('\n') + '\n');
|
|
326
|
+
p.stdout.on('data', ghi); p.stderr.on('data', ghi);
|
|
327
|
+
p.on('error', (e) => { console.log(' ' + e.message); xong(-1); });
|
|
328
|
+
p.on('close', (c) => xong(c ?? -1));
|
|
329
|
+
});
|
|
330
|
+
const kq = { ma, giay: +((Date.now() - bd) / 1000).toFixed(1), video: xuat.chinh.ra, share: xuat.gui?.ra || null };
|
|
331
|
+
ghiJson(path.join(thuMuc, 'sau-xuat.json'), kq);
|
|
332
|
+
console.log(ma === 0 ? ` lệnh sau xuất xong (${kq.giay} s)` : ` cảnh báo: lệnh sau xuất lỗi (mã ${ma}); video ra vẫn ở ket-qua, gửi tay hoặc sửa lệnh rồi chạy lại`);
|
|
333
|
+
}
|
|
334
|
+
|
|
293
335
|
const [ten, ...con] = process.argv.slice(2);
|
|
294
336
|
const f = LENH[ten || 'giup'];
|
|
295
337
|
if (!f) { console.error(`Không có lệnh "${ten}".\n\n${GIUP}`); process.exit(1); }
|
package/mcp/huong-dan-may.md
CHANGED
|
@@ -33,11 +33,18 @@ Người dùng đã nói rõ thì không hỏi lại.
|
|
|
33
33
|
3. Đọc `loi_md` và ảnh tổng quan. Tên riêng nghe sai (tên dự án, chủ đầu tư, đơn vị quản lý): `fix_transcript` với `sua: [["lời nghe được chữ thường không dấu câu", "Chữ Đúng"]]`, `duAn`. Không chắc thì hỏi người dùng.
|
|
34
34
|
4. Viết kịch bản theo `get_guide` topic `kich-ban`, gọi `validate_script` với `script`. `dat: false` thì đọc các dòng `LỖI` trong `log`, sửa, gọi lại. Đọc cả bảng cảnh in ra: `nhịp bậc 2` là cảnh ngắn quá nên bỏ dòng bổ sung (nới `dau`, `cuoi`); `thu` gần 25 % thì rút gọn `hook`; cụm phụ đề dưới 0,9 s không ghi "kẹt giữa 2 cảnh typo" là neo `dau` lệch giữa câu.
|
|
35
35
|
5. Người dùng muốn xem trước: `previews`, gửi ảnh cho người dùng. Sửa cảnh nào thì `validate_script` rồi `previews` với `scenes: [số cảnh]`.
|
|
36
|
-
6. `render` (thêm `music_mode`, `music_file` nếu người dùng chọn), rồi `job_status` tới khi xong.
|
|
37
|
-
7. Đọc `bao_cao` và ảnh 24 khung: tự soát **ĐẠT** mới giao. CHƯA ĐẠT thì sửa rồi dựng lại, hoặc báo người dùng lỗi gì. Báo người dùng đường dẫn `video_ra` (thư mục `ket-qua` cạnh video), số cảnh typo, bộ style, chỗ nên xem kỹ.
|
|
36
|
+
6. `render` (thêm `music_mode`, `music_file` nếu người dùng chọn), rồi `job_status` tới khi xong. Kết quả trả ngay có `du_kien_mb` (dung lượng video ra dự kiến); có `goi_y` là file sẽ quá 800 MB, khó gửi qua mạng: hỏi người dùng có cần gửi file không, cần thì huỷ rồi `render` lại với `share: true`.
|
|
37
|
+
7. Đọc `bao_cao` và ảnh 24 khung: tự soát **ĐẠT** mới giao. CHƯA ĐẠT thì sửa rồi dựng lại, hoặc báo người dùng lỗi gì. Báo người dùng đường dẫn `video_ra` (thư mục `ket-qua` cạnh video), số cảnh typo, bộ style, chỗ nên xem kỹ. Dòng "lấn mép nhẹ" dưới 1 % khung trong báo cáo là dấu, bóng chữ chạm mép vùng, không cần sửa.
|
|
38
38
|
|
|
39
39
|
Sửa sau khi người dùng góp ý: sửa kịch bản, `validate_script`, `render` lại (không chép lời lại). Muốn file nhẹ gửi Zalo: `render` với `light: true`.
|
|
40
40
|
|
|
41
|
+
## Gửi file đi
|
|
42
|
+
|
|
43
|
+
- Bản chính giữ chất lượng cao nên nặng (video 3 phút khổ 2K có thể hơn 1 GB). Cần gửi qua mạng thì `render` với `share: true`: ra thêm `_share.mp4` (bitrate bằng video gốc) cùng lượt, bản chính không đổi, `video_share` là đường file gửi. Tốn thêm một lượt mã hoá chạy song song (máy yếu thêm vài phút).
|
|
44
|
+
- Kênh nhận có giới hạn thì thêm `max_mb` (vd 450 cho kênh nhận tới 500 MB): có `share` thì trần áp vào bản gửi; không có `share` thì hạ bitrate bản chính, kém nét hơn, nên ưu tiên `share`.
|
|
45
|
+
- Tải lên một lần (GitHub Release, kho nhận file qua một kết nối) chỉ hợp file dưới khoảng 500 MB; kết nối qua proxy hay đứt sau vài phút. Drive trên web, ứng dụng Drive trên máy tải lại được khi đứt.
|
|
46
|
+
- Máy có lệnh gửi riêng (vd rclone lên Drive) thì người dùng tự ghi `post_export_cmd` vào `~/.nexus-typo/may.json`; tool chạy lệnh đó sau khi tự soát ĐẠT, kết quả ở `post_export` (`ma` 0 là xong). Lệnh này chỉ đọc từ file cấu hình, không truyền qua công cụ, đừng tự ghi file đó thay người dùng.
|
|
47
|
+
|
|
41
48
|
## Quy tắc cứng
|
|
42
49
|
|
|
43
50
|
- Typo hiện thì không hiện phụ đề (tool tự tắt): đừng viết cảnh typo dài lê thê.
|
package/mcp/may.mjs
CHANGED
|
@@ -242,8 +242,29 @@ async function render(a) {
|
|
|
242
242
|
if (voice) t.push('--voice', voice);
|
|
243
243
|
if (a.music_start != null) t.push('--nhac-tu', String(+a.music_start));
|
|
244
244
|
if (a.light) t.push('--nhe');
|
|
245
|
-
|
|
246
|
-
|
|
245
|
+
if (a.share) t.push('--gui');
|
|
246
|
+
if (a.max_mb != null) {
|
|
247
|
+
if (!(+a.max_mb > 0)) throw new Error('max_mb là số MB lớn hơn 0');
|
|
248
|
+
t.push('--max-mb', String(+a.max_mb));
|
|
249
|
+
}
|
|
250
|
+
const duKien = await duKienRender(tm, a);
|
|
251
|
+
const viec = taoViec({ loai: 'render', video, buoc: [t], tham: { light: !!a.light, share: !!a.share } });
|
|
252
|
+
return { ...(await traViec(viec, Math.min(cho(a.wait_seconds), 5))), ...duKien };
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
/* P66: dung lượng dự kiến theo bộ mã hoá máy này dùng; vượt ngưỡng mà chưa bật bản gửi, chưa khai trần thì gợi ý */
|
|
256
|
+
async function duKienRender(tm, a) {
|
|
257
|
+
try {
|
|
258
|
+
const { thamSoHinh, coNvenc, canhBaoDungLuong } = await import('../src/xuat/ghep.mjs');
|
|
259
|
+
const vao = JSON.parse(fs.readFileSync(path.join(tm, 'vao.json'), 'utf8'));
|
|
260
|
+
const nvenc = await coNvenc(docMay(), vao.hinh.codec === 'h264' ? 'h264' : 'hevc');
|
|
261
|
+
const maxMb = a.max_mb != null ? +a.max_mb : null;
|
|
262
|
+
const chinh = thamSoHinh(vao, { nvenc, nhe: !!a.light, maxMb: a.share ? null : maxMb });
|
|
263
|
+
const gui = a.share ? thamSoHinh(vao, { nvenc, nhe: true, maxMb }) : null;
|
|
264
|
+
const cb = canhBaoDungLuong(chinh, { gui: !!a.share });
|
|
265
|
+
return { du_kien_mb: chinh.duKienMb, ...(gui ? { du_kien_share_mb: gui.duKienMb } : {}),
|
|
266
|
+
...(cb ? { goi_y: cb + '. Hỏi người dùng có cần gửi file qua mạng không; cần thì huỷ việc này (job_status cancel) rồi render lại với share: true hoặc max_mb.' } : {}) };
|
|
267
|
+
} catch { return {}; }
|
|
247
268
|
}
|
|
248
269
|
|
|
249
270
|
/* phần trả khi việc xong, dựng lại từ file việc (MCP mở lại cũng có) */
|
|
@@ -267,8 +288,13 @@ const KET_QUA = {
|
|
|
267
288
|
render: (v) => {
|
|
268
289
|
const nhe = !!v.tham?.light, tm = thuMucLamViec(v.video, { tao: false });
|
|
269
290
|
const ra = tepRa(v.video, nhe ? '_nhe.mp4' : '.mp4', { tao: false });
|
|
291
|
+
const gui = v.tham?.share ? tepRa(v.video, '_share.mp4', { tao: false }) : null;
|
|
270
292
|
const anhSoat = path.join(tm, 'soat', nhe ? 'tong-quan-ra-nhe.jpg' : 'tong-quan-ra.jpg');
|
|
271
|
-
|
|
293
|
+
const xuat = docJsonNeu(path.join(tm, 'xuat.json'));
|
|
294
|
+
return { video_ra: fs.existsSync(ra) ? ra : null, ...(gui ? { video_share: fs.existsSync(gui) ? gui : null } : {}),
|
|
295
|
+
...(xuat ? { mb: xuat.chinh?.mb, ...(xuat.gui ? { share_mb: xuat.gui.mb } : {}) } : {}),
|
|
296
|
+
...(fs.existsSync(path.join(tm, 'sau-xuat.json')) ? { post_export: docJsonNeu(path.join(tm, 'sau-xuat.json')) } : {}),
|
|
297
|
+
bao_cao: docChu(path.join(tm, nhe ? 'bao-cao-nhe.md' : 'bao-cao.md')), anh_soat: anhSoat,
|
|
272
298
|
may: docJsonNeu(path.join(tm, 'may-doc.json')),
|
|
273
299
|
ghi_chu: 'Đọc bao_cao (tự soát ĐẠT mới giao) và ảnh 24 khung. Báo người dùng đường dẫn video_ra.', __anh: [anhSoat] };
|
|
274
300
|
},
|
|
@@ -356,7 +382,10 @@ const TOOLS = [
|
|
|
356
382
|
music_file: { type: 'string', description: 'file nhạc người dùng đưa (mp3, wav, mp4)' },
|
|
357
383
|
music_start: { type: 'number', description: 'giây bắt đầu lấy trong bài nhạc' },
|
|
358
384
|
voice_file: { type: 'string', description: 'rãnh giọng đọc riêng (xuất từ CapCut) khi đổi nhạc' },
|
|
359
|
-
light: { type: 'boolean', description: 'bản nhẹ (bitrate bằng video vào) để gửi Zalo' },
|
|
385
|
+
light: { type: 'boolean', description: 'bản nhẹ (bitrate bằng video vào) để gửi Zalo' },
|
|
386
|
+
share: { type: 'boolean', description: 'ra thêm bản gửi _share.mp4 (bitrate bằng video vào, có max_mb thì theo trần) cùng lượt, bản chính giữ nguyên chất lượng; bật khi người dùng cần gửi file qua mạng hoặc du_kien_mb vượt 800' },
|
|
387
|
+
max_mb: { type: 'number', description: 'trần dung lượng MB: có share thì áp vào bản gửi, không thì hạ bitrate bản chính (kém nét hơn); vd 450 để qua kênh nhận tới 500 MB' },
|
|
388
|
+
wait_seconds: CHO } } },
|
|
360
389
|
{ name: 'job_status', handler: jobStatus,
|
|
361
390
|
description: 'Tiến độ, kết quả một việc (prepare_video, validate_script, previews, render...), cả việc mở từ lần MCP trước. wait_seconds tới 55 để chờ xong; cancel: true để huỷ. state interrupted: việc bị ngắt, gọi lại công cụ đó.',
|
|
362
391
|
inputSchema: { type: 'object', required: ['job_id'], properties: { job_id: { type: 'string' }, cancel: { type: 'boolean' }, wait_seconds: CHO } } },
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nexus-typo-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
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",
|
package/src/may.mjs
CHANGED
|
@@ -52,9 +52,11 @@ export function docKhoa(ten, tep = process.env.NT_DOTENV ? [process.env.NT_DOTEN
|
|
|
52
52
|
return null;
|
|
53
53
|
}
|
|
54
54
|
|
|
55
|
-
/** Đọc cấu hình máy. `kiem` = true thì báo lỗi nếu thiếu ffmpeg / ffprobe.
|
|
56
|
-
|
|
57
|
-
|
|
55
|
+
/** Đọc cấu hình máy. `kiem` = true thì báo lỗi nếu thiếu ffmpeg / ffprobe. Máy cài gói npm không có may.local.json
|
|
56
|
+
* (thư mục gói bị npx thay mỗi bản) nên đọc thêm ~/.nexus-typo/may.json; may.local.json ghi đè khoá trùng. */
|
|
57
|
+
export function docMay({ kiem = true, tep = path.join(GOC, 'may.local.json'), tepNha = path.join(NHA(), 'may.json') } = {}) {
|
|
58
|
+
const docTep = (f) => (f && fs.existsSync(f) ? JSON.parse(fs.readFileSync(f, 'utf8')) : {});
|
|
59
|
+
const cauHinh = { ...docTep(tepNha), ...docTep(tep) };
|
|
58
60
|
const goi = ffmpegGoi();
|
|
59
61
|
const chon = (khoa, bien, ...macDinh) => {
|
|
60
62
|
for (const x of [cauHinh[khoa], process.env[bien], ...macDinh]) if (x && chayDuoc(x)) return x;
|
|
@@ -74,7 +76,9 @@ export function docMay({ kiem = true, tep = path.join(GOC, 'may.local.json') } =
|
|
|
74
76
|
nenBang: cauHinh.nen_bang || process.env.NT_NEN_BANG || null,
|
|
75
77
|
// mô hình tách người u2net_human_seg.onnx cho chữ sau người (P22; file ở Drive _chung/mo-hinh/, không vào repo)
|
|
76
78
|
moHinhNguoi: cauHinh.mo_hinh_nguoi || process.env.NT_MO_HINH_NGUOI || null,
|
|
77
|
-
|
|
79
|
+
// lệnh sau xuất (P66): chỉ đọc từ file cấu hình, không biến môi trường, không tham số MCP (AI gọi tool không chèn lệnh được)
|
|
80
|
+
sauXuat: cauHinh.post_export_cmd || null,
|
|
81
|
+
tep: [tepNha, tep].filter((f) => f && fs.existsSync(f)).pop() || null,
|
|
78
82
|
};
|
|
79
83
|
if (kiem) {
|
|
80
84
|
const thieu = ['ffmpeg', 'ffprobe'].filter((k) => !may[k]);
|
package/src/xuat/ghep.mjs
CHANGED
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
// Máy không NVIDIA (d-1, 26/10): libx265 `slow` đạt nét nhưng video thử 176 s mất hơn 1 tiếng trên i5-12500. Đo đoạn 5 s khó:
|
|
6
6
|
// medium 35M 42,0 dB (trượt sát), medium 45M 43,8 dB SSIM 0,9949 (nét như slow 35M, nhanh ~2,5 lần), nên dùng medium và
|
|
7
7
|
// bitrate 2,6 lần input. TikTok, Facebook nén lại còn vài Mbit/s nên file nặng hơn không ảnh hưởng chất lượng đăng.
|
|
8
|
+
// Gửi file (P66, báo cáo Kiki 03/11/2026): bản chính giữ tham số trên. --max-mb kẹp bitrate theo dung lượng khai; --gui ra
|
|
9
|
+
// thêm bản gửi _share.mp4 (bitrate bằng input, có trần thì theo trần) cùng một lượt ghép, giải mã và chồng chữ một lần.
|
|
8
10
|
// File đang ghi để ngoài Drive (d-5): ghi vào .cache/xuat/ của repo (cài gói npm: ~/.nexus-typo/cache/xuat/) rồi mới chuyển vào ket-qua/, Drive chỉ đồng bộ file xong.
|
|
9
11
|
import crypto from 'node:crypto';
|
|
10
12
|
import fs from 'node:fs';
|
|
@@ -38,14 +40,35 @@ export function khungMoc(h) {
|
|
|
38
40
|
return Math.max(1, Math.round(giay * (h.fps || 30)));
|
|
39
41
|
}
|
|
40
42
|
|
|
41
|
-
/**
|
|
42
|
-
export
|
|
43
|
+
/** Dung lượng dự kiến quá mức này thì khó gửi qua các kênh phổ biến (Drive tải một lần, kho nhận file; báo cáo Kiki). */
|
|
44
|
+
export const NGUONG_GUI_MB = 800;
|
|
45
|
+
/** Phần dành cho vỏ mp4 và độ lệch bitrate của bộ mã hoá khi kẹp theo trần (MB tính 10^6 byte, nhỏ hơn cả MiB). */
|
|
46
|
+
const DU_TRAN = 0.94;
|
|
47
|
+
|
|
48
|
+
/** Mbit/s hình lớn nhất để file dưới maxMb: trừ phần tiếng. Hàm thuần. */
|
|
49
|
+
export function bitrateTheoTran(vao, maxMb) {
|
|
50
|
+
const T = vao.dai || vao.hinh.dai || 0;
|
|
51
|
+
if (!(maxMb > 0) || !(T > 0)) return null;
|
|
52
|
+
return Math.floor(((maxMb * 1e6 * 8 * DU_TRAN) / T - kbTieng(vao) * 1000) / 1e5) / 10;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** Dung lượng dự kiến (MB) theo bitrate hình và tiếng. Hàm thuần. */
|
|
56
|
+
export function duKienMb(vao, bitrateM) {
|
|
57
|
+
return Math.round(((bitrateM * 1e6 + kbTieng(vao) * 1000) * (vao.dai || vao.hinh.dai || 0)) / 8 / 1e6);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** Tham số mã hoá hình theo input. maxMb: kẹp bitrate để file dưới trần (chỉ hạ, không nâng). Hàm thuần. */
|
|
61
|
+
export function thamSoHinh(vao, { nvenc, nhe = false, maxMb = null }) {
|
|
43
62
|
const h = vao.hinh, muoi = h.doSau >= 10, codec = h.codec === 'h264' ? 'h264' : 'hevc';
|
|
44
63
|
const g = khungMoc(h);
|
|
45
64
|
const vaoBr = h.bitrate || vao.bitrate || 10e6;
|
|
46
65
|
const x265 = codec === 'hevc' && !nvenc;
|
|
47
66
|
const heSo = nhe ? 1 : x265 ? 2.6 : 2;
|
|
48
|
-
|
|
67
|
+
let br = Math.round(Math.min(80e6, Math.max(8e6, vaoBr * heSo)) / 1e5) / 10; // Mbit/s, làm tròn 0,1
|
|
68
|
+
const tran = maxMb != null ? bitrateTheoTran(vao, maxMb) : null;
|
|
69
|
+
if (maxMb != null && !(tran >= 1)) throw new Error(`trần ${maxMb} MB quá thấp cho video ${vao.dai || vao.hinh.dai} s (hình còn dưới 1 Mbit/s)`);
|
|
70
|
+
const theoTran = tran != null && tran < br;
|
|
71
|
+
if (theoTran) br = tran;
|
|
49
72
|
const rate = ['-b:v', `${br}M`, '-maxrate', `${Math.round(br * 1.5)}M`, '-bufsize', `${Math.round(br * 2)}M`];
|
|
50
73
|
const mau = [];
|
|
51
74
|
if (h.mau.primaries) mau.push('-color_primaries', h.mau.primaries);
|
|
@@ -58,16 +81,23 @@ export function thamSoHinh(vao, { nvenc, nhe = false }) {
|
|
|
58
81
|
else if (nvenc && !muoi) { bo = 'h264_nvenc'; pix = 'yuv420p'; them = ['-profile:v', 'high', '-preset', 'p7', '-tune', 'hq', '-rc', 'vbr']; }
|
|
59
82
|
else { bo = 'libx264'; pix = muoi ? 'yuv420p10le' : 'yuv420p'; them = ['-profile:v', muoi ? 'high10' : 'high', '-preset', 'slow', '-keyint_min', String(g)]; }
|
|
60
83
|
return {
|
|
61
|
-
boMaHoa: bo, pix, bitrateM: br, khungMoc: g,
|
|
84
|
+
boMaHoa: bo, pix, bitrateM: br, khungMoc: g, theoTran, maxMb: maxMb ?? null, duKienMb: duKienMb(vao, br),
|
|
62
85
|
thamSo: ['-c:v', bo, ...them, '-g', String(g), ...rate, ...mau, ...(codec === 'hevc' ? ['-tag:v', 'hvc1'] : []), '-r', h.fpsChuoi || String(h.fps)],
|
|
63
86
|
};
|
|
64
87
|
}
|
|
65
88
|
|
|
66
89
|
/** Tham số tiếng: AAC, cùng tần số, số kênh; bitrate ≥ input (tối thiểu 256 kbit/s). */
|
|
90
|
+
const kbTieng = (vao) => Math.max(256, Math.ceil((vao.tieng?.[0]?.bitrate || 0) / 32000) * 32);
|
|
67
91
|
export function thamSoTieng(vao) {
|
|
68
92
|
const t = vao.tieng[0];
|
|
69
|
-
|
|
70
|
-
|
|
93
|
+
return ['-c:a', 'aac', '-b:a', `${kbTieng(vao)}k`, '-ar', String(t.tanSo), '-ac', String(t.soKenh)];
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** Cảnh báo đầu lượt (P66): dung lượng dự kiến vượt ngưỡng mà chưa bật bản gửi, chưa khai trần. Hàm thuần. */
|
|
97
|
+
export function canhBaoDungLuong(hinh, { gui = false } = {}) {
|
|
98
|
+
if (gui || hinh.maxMb != null || hinh.duKienMb <= NGUONG_GUI_MB) return null;
|
|
99
|
+
return `video ra dự kiến khoảng ${hinh.duKienMb} MB, khó gửi qua các kênh phổ biến (tải lên một lần dễ đứt, kho nhận file hay chặn file lớn): ` +
|
|
100
|
+
'bật bản gửi (--gui, MCP share) hoặc khai trần dung lượng (--max-mb, MCP max_mb) trước khi dựng';
|
|
71
101
|
}
|
|
72
102
|
|
|
73
103
|
/**
|
|
@@ -131,24 +161,53 @@ function chuyen(tu, den) {
|
|
|
131
161
|
}
|
|
132
162
|
}
|
|
133
163
|
|
|
134
|
-
|
|
164
|
+
/** Lệnh sau xuất (P66) từ cấu hình máy: mảng [chương trình, ...tham số] chạy thẳng, thay {video}, {share} bằng đường file
|
|
165
|
+
* (tham số chỉ có {share} mà không có bản gửi thì bỏ); chuỗi thì chạy qua shell, đường file ở biến môi trường NT_VIDEO_RA,
|
|
166
|
+
* NT_VIDEO_GUI (không ghép vào chuỗi lệnh). Hàm thuần. */
|
|
167
|
+
export function lenhSauXuat(cauHinh, { video, share = null }) {
|
|
168
|
+
if (!cauHinh) return null;
|
|
169
|
+
const env = { NT_VIDEO_RA: video, NT_VIDEO_GUI: share || '' };
|
|
170
|
+
if (typeof cauHinh === 'string' && cauHinh.trim()) return { exe: cauHinh, args: [], shell: true, env };
|
|
171
|
+
if (Array.isArray(cauHinh) && cauHinh.length && cauHinh.every((x) => typeof x === 'string')) {
|
|
172
|
+
const thay = (x) => x.replaceAll('{video}', video).replaceAll('{share}', share || '');
|
|
173
|
+
const args = cauHinh.slice(1).filter((x) => share || x.trim() !== '{share}').map(thay);
|
|
174
|
+
return { exe: thay(cauHinh[0]), args, shell: false, env };
|
|
175
|
+
}
|
|
176
|
+
throw new Error('post_export_cmd trong cấu hình máy phải là chuỗi lệnh hoặc mảng [chương trình, tham số...]');
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
export async function ghep(may, thuMuc, { nhe = false, gui = false, maxMb = null, inRa = () => {} } = {}) {
|
|
135
180
|
const doc = (f, goiY) => { const p = path.join(thuMuc, f); if (!fs.existsSync(p)) throw new Error(`Thiếu ${f}: chạy ${goiY} trước`); return p; };
|
|
136
181
|
const vao = JSON.parse(fs.readFileSync(doc('vao.json', 'doc'), 'utf8'));
|
|
137
182
|
canTieng(vao);
|
|
138
183
|
const lop = doc('lop-chu.mov', 've'), am = doc('am-thanh.wav', 'nhac (hoặc sfx)');
|
|
139
184
|
const codec = vao.hinh.codec === 'h264' ? 'h264' : 'hevc';
|
|
140
185
|
if (vao.hinh.moc === undefined) vao.hinh.moc = await docMoc(may, vao.duongDan); // thư mục làm từ trước bản này
|
|
141
|
-
const
|
|
186
|
+
const nvenc = await coNvenc(may, codec);
|
|
187
|
+
// có bản gửi thì trần áp vào bản gửi, bản chính giữ nguyên tham số
|
|
188
|
+
const hinh = thamSoHinh(vao, { nvenc, nhe, maxMb: gui ? null : maxMb });
|
|
189
|
+
const hinhGui = gui ? thamSoHinh(vao, { nvenc, nhe: true, maxMb }) : null;
|
|
142
190
|
const ra = tepRa(vao.duongDan, nhe ? '_nhe.mp4' : '.mp4');
|
|
191
|
+
const raGui = gui ? tepRa(vao.duongDan, '_share.mp4') : null;
|
|
143
192
|
fs.mkdirSync(THU_MUC_TAM, { recursive: true });
|
|
144
193
|
// tên tạm gắn đường ra: hai video cùng tên ở hai thư mục trước dùng chung file tạm, báo nhầm "ffmpeg cũ, taskkill" (P25)
|
|
145
|
-
const
|
|
194
|
+
const tamCua = (f) => path.join(THU_MUC_TAM, `${crypto.createHash('sha1').update(path.resolve(f)).digest('hex').slice(0, 8)}_${path.basename(f)}`);
|
|
195
|
+
const tam = tamCua(ra), tamGui = gui ? tamCua(raGui) : null;
|
|
196
|
+
fs.rmSync(path.join(thuMuc, 'xuat.json'), { force: true });
|
|
197
|
+
fs.rmSync(path.join(thuMuc, 'sau-xuat.json'), { force: true });
|
|
146
198
|
|
|
199
|
+
const T = vao.dai || vao.hinh.dai || 0;
|
|
200
|
+
inRa(`dung lượng dự kiến: bản chính khoảng ${hinh.duKienMb} MB${hinh.theoTran ? ` (theo trần ${maxMb} MB)` : ''}` +
|
|
201
|
+
(hinhGui ? `, bản gửi khoảng ${hinhGui.duKienMb} MB (${hinhGui.bitrateM} Mbit/s${hinhGui.theoTran ? `, theo trần ${maxMb} MB` : ''})` : ''));
|
|
202
|
+
const cb = canhBaoDungLuong(hinh, { gui });
|
|
203
|
+
if (cb) inRa('cảnh báo: ' + cb);
|
|
204
|
+
const hTran = [hinh, hinhGui].find((h) => h?.theoTran), vaoM = (vao.hinh.bitrate || vao.bitrate || 0) / 1e6;
|
|
205
|
+
if (hTran && hTran.bitrateM < vaoM) inRa(`cảnh báo: trần ${maxMb} MB đưa bitrate hình xuống ${hTran.bitrateM} Mbit/s, thấp hơn video gốc ${vaoM.toFixed(1)} Mbit/s nên ${hTran === hinhGui ? 'bản gửi' : 'video ra'} kém nét hơn gốc`);
|
|
147
206
|
const kiem = danhGiaTruocGhep({
|
|
148
207
|
boNhoTrong: ramDungDuoc(),
|
|
149
208
|
oDia: [...new Set([THU_MUC_TAM, path.dirname(ra)])].map((d) => ({ thuMuc: d, trong: choTrong(d) })),
|
|
150
|
-
canByte: (hinh.bitrateM * 1.5 * 1e6 / 8) *
|
|
151
|
-
ffmpegCungTep: await ffmpegDangGhi([tam, ra]),
|
|
209
|
+
canByte: ((hinh.bitrateM + (hinhGui?.bitrateM || 0)) * 1.5 * 1e6 / 8) * T,
|
|
210
|
+
ffmpegCungTep: await ffmpegDangGhi([tam, ra, ...(gui ? [tamGui, raGui] : [])]),
|
|
152
211
|
});
|
|
153
212
|
for (const x of kiem.canhBao) inRa('cảnh báo: ' + x);
|
|
154
213
|
if (kiem.loi.length) throw new Error('chưa ghép được:\n ' + kiem.loi.join('\n '));
|
|
@@ -157,13 +216,22 @@ export async function ghep(may, thuMuc, { nhe = false, inRa = () => {} } = {}) {
|
|
|
157
216
|
let nguoi = matNaDung(thuMuc, job, vao);
|
|
158
217
|
const ne = nguoi && docNe(thuMuc, job);
|
|
159
218
|
if (ne && ne.canh.every((x) => x.tat)) nguoi = null; // luật 1c: mọi cảnh chữ ra trước người, ghép như không có mặt nạ
|
|
160
|
-
|
|
161
|
-
|
|
219
|
+
let loc = locGhep(hinh.pix, nguoi ? { W: vao.hinh.rong, H: vao.hinh.cao, tat: khoangTat(job, ne) } : null);
|
|
220
|
+
if (gui) loc += ';[v]split=2[v][vg]';
|
|
221
|
+
inRa(`ghép${nguoi ? ', chữ sau người' : ''}, mã hoá ${hinh.boMaHoa} ${hinh.pix} ${hinh.bitrateM} Mbit/s${gui ? `, bản gửi ${hinhGui.bitrateM} Mbit/s cùng lượt` : ''}, khung mốc mỗi ${hinh.khungMoc} khung…`);
|
|
162
222
|
const bd = Date.now();
|
|
163
|
-
|
|
223
|
+
const tams = [tam, tamGui].filter(Boolean);
|
|
224
|
+
for (const f of tams) fs.rmSync(f, { force: true });
|
|
164
225
|
const r = await chay(may.ffmpeg, ['-hide_banner', '-nostdin', '-v', 'error', '-i', vao.duongDan, '-i', lop, '-i', am, ...(nguoi ? ['-i', nguoi] : []),
|
|
165
|
-
'-filter_complex', loc, '-map', '[v]', '-map', '2:a', ...hinh.thamSo, ...thamSoTieng(vao), '-movflags', '+faststart', '-y', tam
|
|
166
|
-
|
|
226
|
+
'-filter_complex', loc, '-map', '[v]', '-map', '2:a', ...hinh.thamSo, ...thamSoTieng(vao), '-movflags', '+faststart', '-y', tam,
|
|
227
|
+
...(gui ? ['-map', '[vg]', '-map', '2:a', ...hinhGui.thamSo, ...thamSoTieng(vao), '-movflags', '+faststart', '-y', tamGui] : [])]);
|
|
228
|
+
if (r.ma !== 0) { for (const f of tams) fs.rmSync(f, { force: true }); throw new Error('ghép, xuất lỗi: ' + r.loi.slice(-500)); }
|
|
167
229
|
chuyen(tam, ra);
|
|
168
|
-
|
|
230
|
+
if (gui) chuyen(tamGui, raGui);
|
|
231
|
+
const mb = (f) => +(fs.statSync(f).size / 1e6).toFixed(1);
|
|
232
|
+
const ban = (f, h) => ({ ra: f, boMaHoa: h.boMaHoa, bitrateM: h.bitrateM, duKienMb: h.duKienMb, mb: mb(f), maxMb: h.maxMb });
|
|
233
|
+
const bao = { chinh: ban(ra, hinh), gui: gui ? ban(raGui, hinhGui) : null };
|
|
234
|
+
for (const x of [bao.chinh, bao.gui]) if (x?.maxMb != null && x.mb > x.maxMb) inRa(`cảnh báo: ${path.basename(x.ra)} ra ${x.mb} MB, vượt trần ${x.maxMb} MB: khai trần thấp hơn chút rồi chạy lại xuat`);
|
|
235
|
+
fs.writeFileSync(path.join(thuMuc, 'xuat.json'), JSON.stringify(bao, null, 1) + '\n');
|
|
236
|
+
return { ra, hinh, gui: bao.gui, mb: bao.chinh.mb, giay: +((Date.now() - bd) / 1000).toFixed(1) };
|
|
169
237
|
}
|
package/src/xuat/soat.mjs
CHANGED
|
@@ -107,14 +107,19 @@ async function soAmGiu(may, vao, ra, cue) {
|
|
|
107
107
|
export async function soat(may, thuMuc, tepVideo, { inRa = () => {} } = {}) {
|
|
108
108
|
const docJ = (f) => { const p = path.join(thuMuc, f); return fs.existsSync(p) ? JSON.parse(fs.readFileSync(p, 'utf8')) : null; };
|
|
109
109
|
const vao = docJ('vao.json'), nhac = docJ('nhac.json'), sfx = docJ('sfx.json'), ve = docJ('ve.bao.json'), pd = docJ('phu-de.bao.json'), giai = docJ('kich-ban.giai.json');
|
|
110
|
+
// xuat.json của đúng lượt xuất ra file này (P66): bitrate thực dùng, dung lượng, bản gửi cùng lượt
|
|
111
|
+
let xuat = docJ('xuat.json');
|
|
112
|
+
if (xuat && path.resolve(xuat.chinh?.ra || '') !== path.resolve(tepVideo)) xuat = null;
|
|
110
113
|
if (vao) canTieng(vao);
|
|
111
114
|
const nhe = /_nhe\.mp4$/.test(tepVideo);
|
|
115
|
+
// bản nhẹ, hoặc bản chính người dùng khai trần MB (P66): bitrate dưới input là chủ ý, nét chỉ cảnh báo
|
|
116
|
+
const noi = nhe || xuat?.chinh?.maxMb != null;
|
|
112
117
|
const loi = [], canhBao = [];
|
|
113
118
|
|
|
114
119
|
inRa('so thông số…');
|
|
115
120
|
const ra = await thongSo(may, tepVideo);
|
|
116
121
|
const ts = soThongSo(vao, ra);
|
|
117
|
-
for (const d of ts) if (!d.dat && !(
|
|
122
|
+
for (const d of ts) if (!d.dat && !(noi && d.muc.startsWith('bitrate hình'))) loi.push(`${d.muc}: input ${d.vao}, ra ${d.ra}`);
|
|
118
123
|
|
|
119
124
|
inRa('đo tiếng…');
|
|
120
125
|
const cheDo = nhac?.cheDo || 'giu';
|
|
@@ -147,7 +152,7 @@ export async function soat(may, thuMuc, tepVideo, { inRa = () => {} } = {}) {
|
|
|
147
152
|
const { net, kemNhat } = await doNet(may, vao.duongDan, tepVideo, thuMucSoat, [0.25, 0.5, 0.75].map((f) => +(vao.dai * f).toFixed(2)), vao.hinh.fps || 30);
|
|
148
153
|
for (const x of net) {
|
|
149
154
|
const kem = x.psnr < NGUONG.psnr || x.ssim < NGUONG.ssim;
|
|
150
|
-
if (kem) (
|
|
155
|
+
if (kem) (noi ? canhBao : loi).push(`độ nét ở ${x.t} s: PSNR ${x.psnr} dB, SSIM ${x.ssim} (cần ≥ ${NGUONG.psnr}, ≥ ${NGUONG.ssim}${nhe ? '; bản nhẹ chỉ cảnh báo' : noi ? '; có trần MB nên chỉ cảnh báo' : ''})`);
|
|
151
156
|
}
|
|
152
157
|
|
|
153
158
|
inRa('ảnh soát 24 khung…');
|
|
@@ -157,21 +162,48 @@ export async function soat(may, thuMuc, tepVideo, { inRa = () => {} } = {}) {
|
|
|
157
162
|
// P25: trước không kiểm, báo cáo vẫn ĐẠT dù thiếu ảnh soát
|
|
158
163
|
if (rAnh.ma !== 0 || !fs.existsSync(anh)) loi.push(`không ra được ảnh soát 24 khung: ${rAnh.loi.trim().slice(-200) || 'ffmpeg không ghi file'}`);
|
|
159
164
|
|
|
165
|
+
// bản gửi (P66): cùng lượt ghép, cùng khung hình với bản chính nên chỉ so thông số, không đo lại nét, tiếng
|
|
166
|
+
if (xuat?.gui) {
|
|
167
|
+
if (!fs.existsSync(xuat.gui.ra)) loi.push(`bản gửi: không thấy ${path.basename(xuat.gui.ra)}`);
|
|
168
|
+
else {
|
|
169
|
+
inRa('so thông số bản gửi…');
|
|
170
|
+
xuat.gui.thongSo = soThongSo(vao, await thongSo(may, xuat.gui.ra));
|
|
171
|
+
for (const d of xuat.gui.thongSo) if (!d.dat && !d.muc.startsWith('bitrate hình')) loi.push(`bản gửi, ${d.muc}: input ${d.vao}, ra ${d.ra}`);
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
for (const x of [xuat?.chinh, xuat?.gui]) if (x?.maxMb != null && x.mb > x.maxMb) canhBao.push(`${path.basename(x.ra)} ${x.mb} MB, vượt trần ${x.maxMb} MB`);
|
|
175
|
+
|
|
160
176
|
if (ve?.vung?.loi?.length) loi.push(`chữ lệch vùng: ${ve.vung.loi.length} chỗ`);
|
|
161
177
|
if (pd?.tranDong?.length) loi.push(`phụ đề tràn dòng: ${pd.tranDong.length} cụm`);
|
|
162
178
|
for (const x of ve?.nguoi?.bao || []) canhBao.push(`người che chữ (luật 1c): ${x}`);
|
|
163
179
|
|
|
164
|
-
const bao = { video: tepVideo, dat: !loi.length, loi, canhBao, thongSo: ts, am, quang, net, kemNhat, anh };
|
|
180
|
+
const bao = { video: tepVideo, dat: !loi.length, loi, canhBao, thongSo: ts, am, quang, net, kemNhat, anh, xuat };
|
|
165
181
|
fs.writeFileSync(path.join(thuMuc, nhe ? 'bao-cao-nhe.json' : 'bao-cao.json'), JSON.stringify(bao, null, 1));
|
|
166
182
|
fs.writeFileSync(path.join(thuMuc, nhe ? 'bao-cao-nhe.md' : 'bao-cao.md'), baoCaoMd(bao, { vao, giai, nhac, sfx, ve, pd }));
|
|
167
183
|
return bao;
|
|
168
184
|
}
|
|
169
185
|
|
|
186
|
+
/** Dòng vùng chữ của báo cáo. Lấn mép (dấu, bóng chữ chạm mép vùng) ghi kèm mức lấn lớn nhất: dưới 1 % khung là
|
|
187
|
+
* cảnh báo nhẹ, nói rõ không đáng kể để người dùng khỏi lo (P66 mục 6). Hàm thuần. */
|
|
188
|
+
export function dongVung(vung) {
|
|
189
|
+
const g = Object.values(vung.canhBao || {});
|
|
190
|
+
const so = g.reduce((t, x) => t + x.so, 0);
|
|
191
|
+
const lon = g.reduce((m, x) => Math.max(m, x.tren || 0, x.duoi || 0), 0);
|
|
192
|
+
const lan = so ? `${so} lấn mép nhẹ, lấn nhiều nhất ${String(lon).replace('.', ',')} % khung (dưới 1 % là dấu, bóng chữ chạm mép vùng, mắt không thấy, không cần sửa)` : 'không lấn mép';
|
|
193
|
+
return `- Vùng chữ (mực chữ): ${vung.soDat}/${vung.tong} đạt sạch, ${lan}, lỗi ${vung.loi.length}`;
|
|
194
|
+
}
|
|
195
|
+
|
|
170
196
|
function baoCaoMd(b, { vao, giai, nhac, sfx, ve, pd }) {
|
|
171
197
|
const d = [];
|
|
172
198
|
d.push(`# Báo cáo Nexus Typo: ${path.basename(b.video)}`, '', b.dat ? '**ĐẠT** mọi tiêu chí.' : `**CHƯA ĐẠT**: ${b.loi.length} lỗi.`, '');
|
|
173
199
|
if (b.loi.length) d.push('## Lỗi', ...b.loi.map((x) => `- ${x}`), '');
|
|
174
200
|
if (b.canhBao.length) d.push('## Cảnh báo', ...b.canhBao.map((x) => `- ${x}`), '');
|
|
201
|
+
if (b.xuat) {
|
|
202
|
+
const dong = (ten, x) => `- ${ten}: ${path.basename(x.ra)}, ${x.boMaHoa} ${x.bitrateM} Mbit/s, ${x.mb} MB${x.maxMb != null ? ` (trần ${x.maxMb} MB)` : ''}`;
|
|
203
|
+
d.push('## File ra', dong('Bản chính', b.xuat.chinh));
|
|
204
|
+
if (b.xuat.gui) d.push(dong('Bản gửi', b.xuat.gui) + (b.xuat.gui.thongSo ? `, thông số ngoài bitrate ${b.xuat.gui.thongSo.every((x) => x.dat || x.muc.startsWith('bitrate hình')) ? 'trùng input' : 'LỆCH input'}` : ''));
|
|
205
|
+
d.push('');
|
|
206
|
+
}
|
|
175
207
|
d.push('## Thông số so với input', '| Mục | Input | Ra | Đạt |', '|---|---|---|---|', ...b.thongSo.map((x) => `| ${x.muc} | ${x.vao} | ${x.ra} | ${x.dat ? 'đạt' : 'KHÔNG'} |`), '');
|
|
176
208
|
d.push('## Tiếng', `- Chế độ nhạc: ${b.am.cheDo}`, `- Độ to ${b.am.doTo.I} LUFS, LRA ${b.am.doTo.LRA}, đỉnh thật ${b.am.doTo.dinhThat} dBTP, đỉnh mẫu ${b.am.doTo.dinhMau} dBFS (input: ${vao.doTo?.I} LUFS, ${vao.doTo?.dinhThat} dBTP)`);
|
|
177
209
|
if (b.am.cheDo === 'giu') d.push(`- Ngoài ±2 s quanh SFX: khác tiếng gốc ${b.am.chenhDb} dB, lệch ${b.am.lechMau} mẫu (nhạc, voice không đổi)`);
|
|
@@ -187,7 +219,7 @@ function baoCaoMd(b, { vao, giai, nhac, sfx, ve, pd }) {
|
|
|
187
219
|
`- Khung kém nhất cả video: ${b.kemNhat.t} s, PSNR ${b.kemNhat.psnr} dB, SSIM ${b.kemNhat.ssim}`, '');
|
|
188
220
|
if (giai) d.push('## Chữ', `- ${giai.canh.length} cảnh typo, style ${giai.style.join(', ')}, họ màu ${giai.mau}`);
|
|
189
221
|
if (pd) d.push(`- Phụ đề ${pd.soCum} cụm, ngắn nhất ${pd.ngan} s, tràn dòng ${pd.tranDong.length}`);
|
|
190
|
-
if (ve?.vung) d.push(
|
|
222
|
+
if (ve?.vung) d.push(dongVung(ve.vung));
|
|
191
223
|
if (ve?.nguoi) d.push(`- Chữ sau người: ${ve.nguoi.canh.length} cảnh, ${ve.nguoi.canh.filter((x) => x.dich && !x.tat).length} nhích lên, ${ve.nguoi.canh.filter((x) => x.tat).length} ra trước người (người che quá ${ve.nguoi.nguong} %)`);
|
|
192
224
|
d.push('', `Ảnh soát 24 khung: ${b.anh}`, '');
|
|
193
225
|
return d.join('\n');
|