
Tìm hiểu về canvas AIFISHER
AIFISHER là công cụ canvas dành cho sáng tạo bằng AI, đưa hình ảnh, video, âm thanh, văn bản và quy trình AI vào cùng một không gian. Bạn có thể sắp xếp ý tưởng và tài nguyên trên canvas, kết nối các dịch vụ mô hình, lập kế hoạch phân cảnh và lưu kết quả tạo, biến quá trình sáng tạo từ những thao tác rời rạc thành một quy trình có thể theo dõi.
Dự án hỗ trợ kết nối AIFISHER API, các dịch vụ mô hình khác, ComfyUI cục bộ và RunningHub, đồng thời cung cấp các tính năng như Agent hỗ trợ lập kế hoạch và thao tác, nhập quy trình API và cấu hình tham số. Dự án và tài nguyên mặc định được lưu trên máy cục bộ, nhưng khi gọi mô hình trực tuyến, prompt và tài nguyên tham chiếu sẽ được gửi đến nhà cung cấp dịch vụ bạn chọn.

Tổng quan về các tính năng cốt lõi
- Nút đa phương tiện: Kết nối các nút hình ảnh, video, âm thanh và văn bản trên cùng một canvas.
- Kết nối dịch vụ mô hình: Sử dụng AIFISHER API hoặc cấu hình các nhà cung cấp khác, ComfyUI cục bộ hay RunningHub.
- Tham chiếu và tạo nội dung: Sử dụng tài nguyên có sẵn, điều chỉnh tham số tạo và tiếp tục kết nối kết quả vào các bước sau.
- Quản lý quy trình sáng tạo: Sử dụng Agent để hỗ trợ lập kế hoạch và thao tác, đồng thời lưu ý tưởng, phân cảnh, prompt và kết quả trong dự án.
- Lưu dự án cục bộ: Dự án và tài nguyên mặc định được lưu trên máy cục bộ; workspace của bản mã nguồn nằm trong
.desktop-dev/ở thư mục chạy.
Môi trường cài đặt và chạy

Để chạy mã nguồn, cần có các môi trường sau:
- Windows x64
- Node.js 24.20.0
- npm
- Nếu cần tạo nội dung cục bộ, phải cài đặt thêm ComfyUI
- Nếu cần sử dụng mô hình trực tuyến, phải chuẩn bị API Key hợp lệ của nhà cung cấp tương ứng
Các thao tác như chuyển mã video và xử lý âm thanh cũng cần FFmpeg và ffprobe hoạt động bình thường. Bản mã nguồn snapshot không đi kèm các tệp nhị phân runtime này, cũng không tự động cài đặt ComfyUI hoặc trọng số mô hình.
Khởi động AIFISHER từ mã nguồn
Trước tiên, lấy mã nguồn dự án bằng Git và mở PowerShell tại thư mục gốc của dự án. Sau đó lần lượt chạy lệnh cài đặt phần phụ thuộc và khởi động chế độ phát triển desktop:
npm ci
npm --prefix apps/desktop ci
npm run desktop:dev
Khi khởi động lần đầu, runtime desktop Electron sẽ tải xuống dựa trên giá trị kiểm tra đi kèm gói npm, vì vậy cần duy trì kết nối mạng. Sau khi khởi động, workspace cục bộ của bản mã nguồn sẽ được lưu trong thư mục .desktop-dev/. Thư mục này chứa dữ liệu làm việc cục bộ, không nên commit vào kho lưu trữ hoặc chia sẻ với người khác.
Kiểm tra trạng thái dự án
Sau khi cài đặt xong, bạn có thể chạy lệnh kiểm tra dự án:
npm run checkLệnh này thực hiện kiểm tra kiểu, các bài kiểm tra trong phạm vi công khai, cũng như build trang khởi động frontend và desktop. Kiểm thử tự động không gọi các dịch vụ tạo nội dung tính phí, do đó quy trình kiểm tra không phát sinh phí gọi mô hình.
Cấu hình AIFISHER API

Các dịch vụ mô hình trực tuyến cần được đăng ký và cấu hình riêng. Hãy thực hiện theo các bước sau:
- Mở AIFISHER API, đăng ký hoặc đăng nhập tài khoản.
- Tạo và sao chép API Key của bạn trên trang API.
- Khởi động canvas AIFISHER và vào Cài đặt.
- Mở Dịch vụ độc quyền và chọn AIFISHER API.
- Dán API Key rồi lưu lại.
- Quay lại canvas và chọn dịch vụ mô hình trực tuyến tương ứng theo nhu cầu.
Tài khoản canvas và tài khoản trên trang API được quản lý riêng biệt. Canvas cục bộ có thể sử dụng mà không cần đăng nhập; việc tạo nội dung trực tuyến sẽ được tính phí theo quy định thực tế của nhà cung cấp dịch vụ, phần mềm không kèm hạn mức mô hình miễn phí. Chỉ nên lưu khóa thông qua giao diện cài đặt, không ghi API Key thật vào cấu hình mẫu hoặc commit vào kho Git.
Tổ chức một quy trình sáng tạo trên canvas
Một cách làm cơ bản là trước tiên nhập hoặc tạo các nút tài nguyên như văn bản và hình ảnh, sau đó kết nối dịch vụ mô hình theo mục tiêu sáng tạo, cuối cùng lưu kết quả tạo. Bạn có thể đặt prompt, hình ảnh tham chiếu và tham số trong cùng một quy trình để dễ tiếp tục lặp lại và cải tiến.
- Xác định chủ đề: Sử dụng nút văn bản để ghi lại mục tiêu sáng tạo, thiết lập nhân vật, mô tả bối cảnh hoặc thông tin phân cảnh.
- Thêm tài nguyên tham chiếu: Kết nối các nút hình ảnh, video hoặc âm thanh làm tham chiếu cho định hướng hình ảnh, chuyển động hoặc âm thanh.
- Kết nối mô hình: Chọn AIFISHER API, dịch vụ trực tuyến khác, ComfyUI hoặc RunningHub đã được cấu hình.
- Điều chỉnh tham số: Sửa các tham số tạo theo những tùy chọn do mô hình và nhà cung cấp dịch vụ cung cấp.
- Kiểm tra kết quả: Giữ kết quả tạo trên canvas để so sánh cùng prompt và tài nguyên tham chiếu ban đầu.
- Tiếp tục lặp lại: Sửa prompt, thay tài nguyên tham chiếu hoặc điều chỉnh tham số rồi tạo phiên bản mới.


Dự án cung cấp thư viện tài nguyên về phong cách và chuyển động camera trên canvas, có thể dùng để tham khảo định hướng hình ảnh. Ví dụ, thư viện bao gồm các hướng như phong cách hoạt hình, chân dung đời thường và hình ảnh khoa học viễn tưởng, đồng thời cung cấp các tham khảo về chuyển động camera như xoay quanh đi lên và zoom kiểu Hitchcock. Hiệu quả tạo thực tế vẫn phụ thuộc vào mô hình, prompt và tài nguyên tham chiếu được sử dụng.
Kết nối quy trình cục bộ và bên thứ ba
Sử dụng ComfyUI cục bộ
Nếu muốn kết nối ComfyUI cục bộ, trước tiên cần cài đặt và chạy ComfyUI riêng trên hệ thống, sau đó cấu hình kết nối tương ứng trong AIFISHER. Khi gặp vấn đề với ComfyUI, phản hồi nên kèm theo API JSON tối thiểu có thể tái hiện để thuận tiện xác định lỗi trong quy trình hoặc tham số.
Sử dụng RunningHub hoặc nhà cung cấp khác
AIFISHER cũng hỗ trợ RunningHub và các dịch vụ mô hình khác. Trước khi sử dụng, cần chuẩn bị API Key hợp lệ của từng dịch vụ và cấu hình theo quy định về phí, quyền riêng tư và điều kiện sử dụng của nhà cung cấp. Có thể nhập quy trình API và tiếp tục cấu hình tham số, nhưng khả năng cụ thể phụ thuộc vào dịch vụ được kết nối.

Lưu ý về dữ liệu, quyền riêng tư và chẩn đoán
AIFISHER mặc định lưu dự án trên máy cục bộ, nhưng “canvas cục bộ” không có nghĩa mọi mô hình đều chạy cục bộ, cũng không đảm bảo tài nguyên sẽ không bao giờ được tải lên. Khi chủ động gọi mô hình trực tuyến, prompt và tài nguyên tham chiếu liên quan sẽ được gửi đến nhà cung cấp dịch vụ đã chọn. Hãy kiểm tra trước chính sách về phí, quyền riêng tư và việc sử dụng nội dung của họ.
Dịch vụ tài khoản chính thức và nhận diện thiết bị sẽ kết nối mạng. Ngay cả khi chưa đăng nhập, ứng dụng vẫn có thể gửi mã nhận diện thiết bị và thông tin chẩn đoán cuộc gọi đến dịch vụ chính thức. Thông tin chẩn đoán bao gồm phiên bản ứng dụng, mô hình và nhà cung cấp dịch vụ, trạng thái cuộc gọi, thời gian xử lý, giai đoạn xảy ra lỗi, trạng thái HTTP, mã nhận diện yêu cầu hoặc tác vụ, cùng bản tóm tắt lỗi đã được khử nhận dạng. Việc gửi chẩn đoán không nhằm thu thập API Key, prompt đầy đủ hoặc tài nguyên gốc; các tệp được đính kèm chủ động khi gửi phản hồi sẽ được chuyển đến dịch vụ tiếp nhận phản hồi.
Gợi ý sử dụng nâng cao
- Bảo vệ khóa: Luôn lưu API Key qua giao diện cài đặt, tránh ghi khóa thật vào cấu hình, nhật ký hoặc mã mẫu.
- Quản lý workspace: Không commit hoặc chia sẻ
.desktop-dev/, vì thư mục này có thể chứa dữ liệu làm việc cục bộ. - Kiểm tra quy mô nhỏ trước: Dùng
npm run checkđể kiểm tra môi trường mã nguồn; kiểm thử tự động không gọi dịch vụ tạo nội dung tính phí. - Phân biệt mô hình cục bộ và trực tuyến: Trước khi gửi tài nguyên tham chiếu, hãy xác nhận dịch vụ mô hình đang kết nối và phạm vi truyền dữ liệu.
- Chuẩn bị phản hồi có thể tái hiện: Khi báo cáo vấn đề, cung cấp phiên bản, các bước tái hiện và nhật ký đã khử nhận dạng; xóa tài khoản, API Key, đường dẫn riêng tư và tài nguyên riêng tư.
- Xử lý phần phụ thuộc phương tiện: Khi cần chuyển mã video hoặc xử lý âm thanh, hãy xác nhận FFmpeg và ffprobe khả dụng.
Bản cài đặt và giấy phép
Nếu không cần chạy mã nguồn, hãy truy cập trang phát hành phiên bản hoặc mở kho tải xuống chính thức để tải bản cài đặt. Bản chính thức đã cài đặt sẽ tiếp tục nhận các bản cập nhật tự động có chữ ký từ nhà cung cấp.
Mã nguồn dự án chỉ dành cho mục đích phi thương mại. Được phép học tập, nghiên cứu, sửa đổi và phân phối lại miễn phí cho mục đích phi thương mại, nhưng nghiêm cấm nhận đơn, sản xuất thương mại, bán lại gói cài đặt, phát triển thứ cấp thương mại hoặc lưu trữ có thu phí. Dự án sử dụng AIFISHER Noncommercial Source License 1.0 và không thuộc giấy phép nguồn mở theo định nghĩa của OSI. Các thành phần bên thứ ba tuân theo giấy phép ban đầu của chúng; SKILL độc quyền, mẫu chia sẻ riêng tư, tài khoản cá nhân và khóa không thuộc phạm vi công khai.
Trước khi sử dụng AIFISHER, hãy đọc LICENSE, SOURCE-SCOPE.md và THIRD-PARTY-NOTICES.md trong kho lưu trữ, đồng thời xác nhận cách sử dụng của bạn phù hợp với các điều khoản giấy phép.
Tổng kết
Canvas AIFISHER phù hợp để quản lý tập trung tài nguyên đa phương tiện, prompt, dịch vụ mô hình và các bước sáng tạo bằng AI. Khi bắt đầu, bạn có thể triển khai bản mã nguồn hoặc bản cài đặt trên môi trường Windows, sau đó cấu hình API Key trong phần cài đặt và xây dựng quy trình từ các nút văn bản cùng tài nguyên tham chiếu. Khi sử dụng mô hình trực tuyến, cần đặc biệt chú ý đến chi phí, quyền riêng tư, bảo vệ khóa và phạm vi của giấy phép phi thương mại.
