Skip to content

Đăng sản phẩm Vibe Coding lên ModelScope

Khi trang đã chạy trên máy, bạn cần một địa chỉ mà bạn bè, bạn học hoặc người dùng thật có thể mở.

Bạn có thể thuê máy chủ rồi tự cấu hình tên miền, HTTPS và triển khai. Trong bài này, chúng ta giảm phần vận hành và đăng trang lên ModelScope Studio.

ModelScope là một cộng đồng mã nguồn mở do Alibaba khởi xướng cùng Ủy ban Phát triển Mã nguồn Mở CCF. Bên cạnh hơn 200.000 mô hình mã nguồn mở và 30.000 tập dữ liệu, cộng đồng còn cung cấp Studio để trình bày ứng dụng. Studio giúp tạo miễn phí một địa chỉ chia sẻ mà chưa cần học quản trị máy chủ trước.

Bài được kiểm tra với giao diện hiện tại, Skills chính thức và tài liệu lệnh vào 11 tháng 8 năm 2026. Vị trí nút có thể đổi, nhưng luồng vẫn là: tạo Static Studio, tải kết quả build, triển khai và kiểm tra liên kết.

Ngoài Gradio, Streamlit và Docker, Studio hỗ trợ loại static cho trang đã build. Nếu kết quả gồm index.html, CSS, JavaScript và ảnh, hãy chọn loại này.

Địa chỉ sau khi đăng có dạng:

text
https://modelscope.cn/studios/ten-cua-ban/ten-studio

Chọn đúng cách đăng

Dự ánLoại StudioChuẩn bị
HTML, CSS và JavaScriptStaticChuẩn bị tệp, không cần build
Vue, React, Vite hoặc SvelteStaticBuild trên máy và chỉ đăng nội dung dist hoặc build
GradioGradioChuẩn bị app.pyrequirements.txt
StreamlitStreamlitChuẩn bị tệp vào và thư viện
Backend hoặc gói hệ thống đặc biệtDockerViết Dockerfile và nghe ở cổng được yêu cầu

Bài này tập trung hai dòng đầu. Đừng tải mã nguồn Vue hoặc React làm trang Static. Trình duyệt của khách không chạy npm install hay npm run build giúp bạn.

Cách nên dùng: Skill chính thức

ModelScope duy trì Skills chính thức.

SkillVai tròKhi sử dụng
ms-hubCổng chung cho kho, mô hình, dữ liệu, Studio, MCP và Skills CenterKết nối lần đầu và thao tác chung
ms-studio-deployNhận diện dự án, tạo Studio, đồng bộ Git, triển khai, xem nhật ký và chẩn đoánƯu tiên khi đăng hoặc cập nhật trang trên máy

ms-studio-deploy nhận diện static khi index.html ở thư mục gốc. Static Studio không chạy npm run build, vì vậy hãy build dự án framework trên máy trước.

Cài Skills

bash
python -m pip install -U modelscope
modelscope skills add @ModelScope/ms-hub @ModelScope/ms-studio-deploy

Nếu lệnh không có skills, dùng trình cài chính thức:

bash
curl -fsSL https://modelscope.cn/skills/install.sh | bash -s -- @ModelScope/ms-hub
curl -fsSL https://modelscope.cn/skills/install.sh | bash -s -- @ModelScope/ms-studio-deploy

Skills thường được cài ở ~/.agents/skills/. Sau đó mở phiên mới trong Codex, Cursor, Claude Code hoặc công cụ tương thích để cập nhật danh sách.

Đăng bằng Skill

Theo hướng dẫn ms-studio-deploy, hãy chuẩn bị:

  1. Skill đã cài và một phiên Agent mới.
  2. Thư mục sẽ đăng, với index.html ngay ở thư mục gốc.
  3. ModelScope Access Token đã cấu hình trên máy.

Lấy token ở trang Access Tokens rồi đặt trong terminal:

bash
export MODELSCOPE_API_KEY="token-cua-ban"

Với HTML đơn giản, mở thẳng thư mục web. Với Vue, React hoặc Vite, build rồi vào thư mục đầu ra:

bash
npm run build
cd dist

Vite thường tạo dist. Nếu công cụ tạo build, hãy mở thư mục đó trong công cụ hỗ trợ Agent Skills.

Yêu cầu ngắn nhất

text
Hãy dùng Skill ms-studio-deploy để đăng trang này lên Static Studio của ModelScope. Khi chạy được, gửi địa chỉ cho tôi.

Skill kiểm tra index.html và đăng nhập. Nếu cần Studio mới, nó sẽ hỏi tên và chế độ hiển thị. Hãy bắt đầu ở chế độ riêng tư.

Bạn cũng có thể đưa đủ điều kiện:

text
Hãy dùng Skill ms-studio-deploy để đăng thư mục này lên Static Studio ở trang ModelScope Trung Quốc.
Đặt tên Studio là my-portfolio và để riêng tư lúc đầu. Sau khi triển khai, kiểm tra trạng thái và nhật ký.
Nếu thất bại, sửa nguyên nhân theo nhật ký, triển khai lại và trả về địa chỉ chạy được.

AI sẽ làm gì tiếp theo

text
nhận diện dự án → chọn trang Trung Quốc hoặc quốc tế → đọc tài khoản
→ tạo hoặc dùng lại Studio → kiểm tra tệp nhạy cảm → đồng bộ lên master
→ bắt đầu triển khai → xem trạng thái và nhật ký → chẩn đoán và sửa → trả địa chỉ

Kiểm tra riêng tư trước rồi mới chuyển công khai. Trang Static không cần phần cứng trả phí. Với tài nguyên trả phí của loại khác, Skill phải xin phép rõ ràng.

Token dùng cho API và Git push. Không ghi nó vào frontend, README, yêu cầu hay ảnh chia sẻ.

Cách thủ công: Bước 0 — chuẩn bị trang

Dùng Skill thuận tiện hơn, nhưng cách thủ công giúp hiểu giao diện Studio và dùng được khi không có công cụ Agent.

Trường hợp A: HTML đơn giản

index.html phải ở thư mục gốc của nội dung sẽ đăng:

text
my-site/
├── index.html
├── styles.css
├── app.js
└── images/
    └── cover.jpg

Kiểm tra qua HTTP trước khi đăng:

bash
cd my-site
python3 -m http.server 8000

Mở http://localhost:8000. Chỉ nhấp đúp index.html là chưa đủ vì file:// và HTTP xử lý module, CORS và đường dẫn khác nhau.

Trường hợp B: Vue, React, Vite và tương tự

bash
npm install
npm run build
Công cụĐầu ra thường gặp
Vite / Vue + Vite / React + Vitedist/
Create React Appbuild/
Vue CLIdist/

Đăng nội dung đầu ra để index.html nằm ngay ở gốc Studio.

text
Đúng: index.html
Sai: dist/index.html

Nếu CSS, JavaScript hoặc ảnh trả về 404, thử base tương đối trong Vite:

js
// vite.config.js / vite.config.ts
export default {
  base: './'
}

Build lại. Host tĩnh có thể không chuyển mọi đường dẫn về index.html; SPA có thể dùng router Hash như /#/about.

Cách thủ công: Bước 1 — mở Studio và đăng nhập

Mở ModelScope Studio. Phần đầu trang trình bày luồng tạo, xây dựng, đăng và chia sẻ.

Trang chủ ModelScope Studio với quy trình tạo và đăng

Chọn tạo hoặc mở Tạo Studio. Trang Trung Quốc modelscope.cn và quốc tế modelscope.ai không dùng chung tài khoản, token hay nội dung.

Cách thủ công: Bước 2 — điền thông tin cơ bản

Biểu mẫu chủ sở hữu, tên, giấy phép, hiển thị và mô tả

  1. Chủ sở hữu hoặc tổ chức: quyết định phần chủ sở hữu trong địa chỉ.
  2. Tên: dùng chữ thường, số và dấu gạch, ví dụ my-portfolio.
  3. Tên hiển thị và mô tả: viết để khách hiểu.
  4. Hiển thị: bắt đầu riêng tư, chuyển công khai sau khi kiểm tra.
  5. Giấy phép: chọn theo dự án.

Xác nhận và chờ Studio mở.

Cách thủ công: Bước 3 — tải tệp lên

Trong Static Studio đang chạy, index.htmlREADME.md nằm ngay ở thư mục gốc.

Trang tệp Static Studio có index.html ở gốc

Tải index.html, CSS, JavaScript và ảnh trong Files. Đừng bọc chúng trong thư mục dist, build hay dự án khác.

Tải thủ công phù hợp khi ít tệp. Khi nhiều tệp hoặc cập nhật thường xuyên, dùng ms-studio-deploy để đồng bộ Git.

Cách thủ công: Bước 4 — chọn Static trong cài đặt triển khai

Sau khi tải tệp lên, mở cài đặt triển khai của Studio và chọn Static làm loại SDK. Static phù hợp với trang HTML đã chuẩn bị sẵn; cùng khu vực này cũng có Gradio, Streamlit và Docker.

Chọn Static trong cài đặt triển khai

Kiểm tra lại rằng index.html nằm ở thư mục gốc của kho mã rồi lưu cài đặt triển khai.

Nếu trang cần cơ sở dữ liệu, khóa bí mật hoặc xử lý máy chủ, nó không hoàn toàn tĩnh. Hãy dùng Gradio, Streamlit, Docker hoặc backend riêng. Khóa trong JavaScript frontend không thể giữ bí mật.

Cách thủ công: Bước 5 — chờ triển khai và kiểm tra

Lưu cài đặt thường bắt đầu triển khai. Nếu chưa, chọn triển khai, khởi động lại hoặc chạy lại. Khi hoạt động, mở:

text
https://modelscope.cn/studios/ten-cua-ban/ten-studio
  • Trang chủ có mở không?
  • CSS, JavaScript và ảnh có tải không?
  • Console có lỗi 404, CORS hoặc JavaScript không?
  • Trang có dùng được ở chiều rộng điện thoại không?
  • Studio công khai có mở trong cửa sổ chưa đăng nhập không?

Kiểm tra riêng tư trước, sau đó công khai và thử lại khi chưa đăng nhập.

Cách thủ công: Bước 6 — cập nhật trang

Sau khi sửa nguồn, kiểm tra trên máy và build lại. Trong Files, thay tệp cũ bằng nội dung dist hoặc build mới rồi triển khai lại.

text
sửa nguồn → kiểm tra trên máy → build lại → thay tệp Studio
→ triển khai lại → kiểm tra địa chỉ cuối

Không tải node_modules, cấu hình phát triển hoặc toàn bộ dự án nguồn. Nếu cập nhật nhiều, hãy dùng Skill.

Dùng Skill để xử lý lỗi

ms-studio-deploy · 排障助手

网页哪里不对?

选择最接近的现象,复制提示词交给 AI;Skill 会继续检查、修复和部署。

404
当前现象页面 404 或空白
最可能的原因

发布目录选错,或创空间仓库根目录没有 index.html。

Skill 会怎么处理

检查当前发布目录和远端文件结构,修正后重新同步并部署。

直接发给 AI

请使用 ms-studio-deploy 检查当前创空间为什么出现 404 或空白页。确认仓库根目录是否有 index.html,修正发布目录后重新同步、部署,并把最终链接发给我。

Nguồn