[测试回复机器人] 如何部署到本地

[CharlesPikachu]

[测试回复机器人] 如何部署到本地

[github-actions]

@CharlesPikachu
感谢关注，这里给你一个快速本地部署的流程。MusicSquare 纯静态页面，完全可以直接用浏览器打开，或者通过常见的本地服务器来体验。

---

1️⃣ 直接打开

1. 克隆或下载仓库

   git clone https://github.com/CharlesPikachu/musicsquare.git
   cd musicsquare

2. 用浏览器直接打开 index.html（双击或右键 在浏览器中打开）。

如有 CORS 报错，① 直接打开即可，因为页面不访问外部跨域资源；② 若你改动了 API 代理，需要本地启动对应的后端。

---

2️⃣ 启动本地 HTTP 服务器

(1) 直接用浏览器（推荐，最简）

• 直接双击 index.html → 这已经是完整的静态站点，几乎不需要服务器。

(2) 使用 Node / NPM

npm install -g serve  # 只需一次
serve .              # 访问 http://localhost:5000

(3) 使用 Python（适用于已安装 Python 的用户）

# Python 3.x
python -m http.server 8000
# Python 2.x
python -m SimpleHTTPServer 8000

浏览器访问 http://localhost:8000。

---

3️⃣ 需要本地 API（如模拟 Migu、Netease 等）

如果你想做本地代理或桥接，保持 api 的路径不变即可。例如：

/api/v1/...   → 你本地的 Node / FastAPI / Flask 代理

只需在本地启动对应后端并保证 index.html 中的 api.setProxyUrl() 指向正确地址，即可在本地完整体验搜索/播放功能。

---

4️⃣ 常见问题

现象	可能原因	解决方案
404 音乐文件	静态文件路径错误	检查 source.js 配置 & 本地文件夹结构
浏览器弹出安全提示	随机定位到 localhost 但文件未被正确加载	使用 serve / http.server 而非直接文件打开

---

小贴士

• index.html、assets/、js/ 等文件夹都属于静态资源，无需编译。
• 如需自定义主题或替换 API，只需改 src/ 下相应文件，直接预览即可。

祝你部署顺利 🚀
遇到具体报错随时提 issue 或直接在评论区交流。

---

🤖 This is an automatic reply generated from the issue content. It may be inaccurate; please wait for a maintainer if needed.
To skip automatic replies, add one of these labels: no-bot, ai-ignore, bot-ignore, skip-ai.