nexus-typo-mcp 1.3.3 → 1.3.4
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/mcp/huong-dan-may.md +1 -0
- package/mcp/may.mjs +2 -2
- package/package.json +1 -1
package/mcp/huong-dan-may.md
CHANGED
|
@@ -56,6 +56,7 @@ Phần này cho AI chạy Nexus Typo trong máy ảo của nền tảng (vd Muse
|
|
|
56
56
|
|
|
57
57
|
- **Đầu lượt:** `check_setup`, ghi lại RAM dùng được, ổ trống, số nhân. RAM dùng được dưới mức bước ghép cần (mục Thiếu RAM) thì báo người dùng ngay, trước khi dựng.
|
|
58
58
|
- **Chỗ để file:** video và thư mục làm việc để trên ổ đĩa bền qua lần thay máy (thư mục làm việc của nền tảng), không để ở `/tmp` (thường là ổ RAM nhỏ, mất khi thay máy). Thư mục `<tên video>.nexus-typo` cạnh video giữ lời đã chép, lớp chữ đã dựng: đừng xoá, đừng dời.
|
|
59
|
+
- **Mở việc dài từ phiên chính:** `render`, `prepare_video` gọi từ phiên trò chuyện chính, không gọi từ lượt chạy theo lịch hay tác vụ nền ngắn của nền tảng. Lượt đó kết thúc thì nền tảng dọn hết tiến trình nó mở, việc thành `interrupted` dù tool đã tách việc khỏi MCP. Lịch chỉ gọi `job_status` để canh, báo người dùng. Thấy `interrupted` mà máy chưa bị thay thì gọi lại `render` từ phiên chính.
|
|
59
60
|
- **Máy bị thay giữa chừng:** việc thành `interrupted` hoặc `job_id` không còn. Gọi lại `render` cùng tham số, tool dùng lại lớp chữ, tiếng đã dựng, chỉ làm phần còn thiếu. Đừng mở việc mới khi `job_status` còn `running`.
|
|
60
61
|
- **Canh việc:** `job_status` với `wait_seconds` 50. Tự đặt lịch kiểm thì 5 đến 10 phút một lần; mỗi lần báo người dùng ngắn: đang ở bước nào, giờ còn lại (dòng giờ còn lại trong `log`).
|
|
61
62
|
- **Thiếu RAM:** tool tự chờ 15 phút rồi mới báo lỗi, đọc dòng "RAM máy ..." trong `log`. Phần "không thuộc tiến trình nào" lớn là máy ảo giữ: đừng cố dọn (`swapon`, `drop_caches`, tắt tiến trình hệ thống thường bị cấm và không giúp), đừng ghép tay bằng ffmpeg, đừng hạ thông số. Báo người dùng số đo, chờ máy mới (máy vừa lên thường còn nhiều RAM nhất); việc đầu tiên trên máy mới là `render` lại, chưa làm việc nặng khác trước.
|
package/mcp/may.mjs
CHANGED
|
@@ -360,7 +360,7 @@ const TOOLS = [
|
|
|
360
360
|
inputSchema: { type: 'object', required: ['video'], properties: { video: VIDEO,
|
|
361
361
|
scenes: { type: 'array', items: { type: 'integer' }, description: 'chỉ ra ảnh các cảnh này (số cảnh từ 1), sau khi sửa' }, wait_seconds: CHO } } },
|
|
362
362
|
{ name: 'render', handler: render,
|
|
363
|
-
description: 'Dựng video: đọc máy, lớp chữ, SFX, nhạc, ghép, tự soát. Chạy nền, tách khỏi MCP (ứng dụng AI đóng thì việc vẫn chạy; thời gian tuỳ máy, log ghi giờ còn lại): trả job_id, theo dõi bằng job_status. Gọi lại khi hỏng giữa chừng thì phần đã xong được dùng lại. Video ra ở thư mục ket-qua cạnh video.',
|
|
363
|
+
description: 'Dựng video: đọc máy, lớp chữ, SFX, nhạc, ghép, tự soát. Chạy nền, tách khỏi MCP (ứng dụng AI đóng thì việc vẫn chạy; thời gian tuỳ máy, log ghi giờ còn lại): trả job_id, theo dõi bằng job_status. Gọi lại khi hỏng giữa chừng thì phần đã xong được dùng lại. Video ra ở thư mục ket-qua cạnh video. Gọi từ phiên trò chuyện chính, không từ lượt chạy theo lịch (lượt đó kết thúc thì nền tảng dọn luôn việc).',
|
|
364
364
|
inputSchema: { type: 'object', required: ['video'], properties: { video: VIDEO,
|
|
365
365
|
music_mode: { type: 'string', enum: ['giu', 'them', 'doi'], description: 'giu: giữ tiếng video (mặc định); them: thêm nhạc (video chưa có nhạc); doi: thay nhạc cũ (cần khoá ElevenLabs để tách giọng, hoặc voice_file)' },
|
|
366
366
|
music_file: { type: 'string', description: 'file nhạc người dùng đưa (mp3, wav, mp4)' },
|
|
@@ -401,7 +401,7 @@ export async function xuLy(msg) {
|
|
|
401
401
|
capabilities: { tools: {} }, serverInfo: { name: 'nexus-typo', title: 'Nexus Typo', version: PKG.version },
|
|
402
402
|
instructions: 'Nexus Typo trên máy: thêm tiêu đề chữ (typo), phụ đề, tiếng động vào video BĐS dọc 9:16 đã dựng xong, ra video MP4 ngay trên máy. ' +
|
|
403
403
|
'Gọi get_guide (topic "may") trước. Thứ tự: prepare_video, fix_transcript nếu tên riêng sai, viết kịch bản, validate_script tới khi đạt, previews nếu người dùng muốn duyệt, render rồi job_status tới khi xong. ' +
|
|
404
|
-
'Chạy trong máy ảo trên mây không người ngồi máy (máy do nền tảng cấp, có thể bị thay giữa chừng): theo mục "Chạy trên máy ảo trên mây" của get_guide.' +
|
|
404
|
+
'Chạy trong máy ảo trên mây không người ngồi máy (máy do nền tảng cấp, có thể bị thay giữa chừng): theo mục "Chạy trên máy ảo trên mây" của get_guide; render gọi từ phiên chính, lịch chỉ gọi job_status.' +
|
|
405
405
|
(banMoi ? ` Có bản mới ${banMoi} (đang chạy ${PKG.version}): nhắc người dùng khởi động lại ứng dụng AI để npx lấy bản mới.` : '') });
|
|
406
406
|
case 'ping': return ok(id, {});
|
|
407
407
|
case 'tools/list':
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nexus-typo-mcp",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.4",
|
|
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",
|