[ { "path": ".gitattributes", "content": "# 指定 Python 为主要语言\n*.py linguist-detectable=true\n\n# 将 HTML 和 JavaScript 归类为文档或前端资源，降低权重\n*.html linguist-vendored\n*.js linguist-vendored\n*.css linguist-vendored\n\n# 如果有前端框架（如 Vue 或 React），也可以添加：\n*.vue linguist-vendored\n*.tsx linguist-vendored\n*.jsx linguist-vendored\n" }, { "path": ".github/FUNDING.yml", "content": "github: [hanxi]\ncustom: ['https://afdian.com/a/imhanxi']\n" }, { "path": ".github/workflows/ci.yml", "content": "name: CI Workflow\n\non:\n push:\n branches:\n - \"*\" # 所有分支触发\n tags:\n - \"v*\"\n workflow_dispatch:\n\nenv:\n VERSION_TAG: ${{ secrets.DOCKERHUB_USERNAME }}/xiaomusic:${{ github.ref_name }}\n LATEST_TAG: ${{ secrets.DOCKERHUB_USERNAME }}/xiaomusic:latest\n STABLE_TAG: ${{ secrets.DOCKERHUB_USERNAME }}/xiaomusic:stable\n\npermissions:\n contents: write\n id-token: write\n\njobs:\n # 构建多架构 Docker 镜像并在所有平台上运行基本测试\n build:\n runs-on: ubuntu-latest\n strategy:\n matrix:\n platform: [amd64, arm64, armv7]\n include:\n - platform: amd64\n arch: amd64\n - platform: arm64\n arch: arm64\n - platform: armv7\n arch: arm/v7\n steps:\n - uses: actions/checkout@v4\n with:\n fetch-depth: 0\n submodules: true\n\n - name: Set up QEMU\n uses: docker/setup-qemu-action@v3\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v3\n\n - name: Login to Docker Hub\n uses: docker/login-action@v3\n with:\n username: ${{ secrets.DOCKERHUB_USERNAME }}\n password: ${{ secrets.DOCKERHUB_TOKEN }}\n\n - name: Build Docker image for ${{ matrix.platform }}\n uses: docker/build-push-action@v6\n with:\n platforms: linux/${{ matrix.arch }}\n context: .\n push: false\n load: true\n tags: ${{ env.VERSION_TAG }}\n cache-from: type=gha,scope=${{ matrix.platform }}\n cache-to: type=gha,mode=max,scope=${{ matrix.platform }}\n\n - name: Test Docker image for ${{ matrix.platform }}\n run: |\n docker run --rm ${{ env.VERSION_TAG }} /app/.venv/bin/python3 /app/xiaomusic.py -h\n\n - name: Save ${{ matrix.platform }} image to tar\n run: |\n docker save ${{ env.VERSION_TAG }} -o xiaomusic-${{ github.ref_name }}-${{ matrix.platform }}.tar\n\n - name: Upload Docker images as artifacts\n uses: actions/upload-artifact@v4\n with:\n name: docker-images-${{ matrix.platform }}\n path: xiaomusic-${{ github.ref_name }}-${{ matrix.platform }}.tar\n retention-days: 1\n\n # 推送多架构 Docker 镜像到 Docker Hub\n push-docker:\n runs-on: ubuntu-latest\n needs: build\n if: github.ref_name == 'main' || startsWith(github.ref, 'refs/tags/v')\n steps:\n - uses: actions/checkout@v4\n\n - name: Set up QEMU\n uses: docker/setup-qemu-action@v3\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v3\n\n - name: Login to Docker Hub\n uses: docker/login-action@v3\n with:\n username: ${{ secrets.DOCKERHUB_USERNAME }}\n password: ${{ secrets.DOCKERHUB_TOKEN }}\n\n - name: Publish to Docker Hub\n if: github.ref_name == 'main'\n uses: docker/build-push-action@v6\n with:\n platforms: linux/amd64,linux/arm64,linux/arm/v7\n context: .\n push: true\n tags: ${{ env.VERSION_TAG }}\n cache-from: |\n type=gha,scope=amd64\n type=gha,scope=arm64\n type=gha,scope=armv7\n\n - name: Publish to Docker Hub latest and stable\n if: startsWith(github.ref, 'refs/tags/v')\n uses: docker/build-push-action@v6\n with:\n platforms: linux/amd64,linux/arm64,linux/arm/v7\n context: .\n push: true\n tags: |\n ${{ env.VERSION_TAG }}\n ${{ env.LATEST_TAG }}\n ${{ env.STABLE_TAG }}\n cache-from: |\n type=gha,scope=amd64\n type=gha,scope=arm64\n type=gha,scope=armv7\n\n # 推送镜像到 GitHub Release\n publish-release:\n runs-on: ubuntu-latest\n needs: build\n if: github.ref_name == 'main' || startsWith(github.ref, 'refs/tags/v')\n steps:\n - uses: actions/checkout@v4\n\n - name: Download all platform artifacts\n uses: actions/download-artifact@v4\n with:\n pattern: docker-images-*\n merge-multiple: true\n\n - name: Install GitHub CLI\n run: |\n sudo apt update\n sudo apt install -y gh\n\n - name: Create or update Release tag\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: |\n RELEASE_NAME=${{ github.ref_name }}\n RELEASE_BODY=\"This release is automatically updated from the ${RELEASE_NAME} branch.\"\n\n EXISTING_RELEASE=$(gh release view \"${RELEASE_NAME}\" --json id --jq .id || echo \"\")\n\n if [[ -n \"${EXISTING_RELEASE}\" ]]; then\n echo \"release exist\"\n else\n gh release create \"${RELEASE_NAME}\" \\\n --prerelease=false \\\n --title \"${RELEASE_NAME}\" \\\n --notes \"${RELEASE_BODY}\"\n fi\n\n - name: Upload assets to Release tag\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: |\n RELEASE_NAME=${{ github.ref_name }}\n\n FILES=$(find . -type f -name \"xiaomusic-*.tar\")\n for FILE in ${FILES}; do\n echo \"type upload ${FILE}\"\n gh release upload \"${RELEASE_NAME}\" \"${FILE}\" --clobber\n done\n\n # 推送 PyPI 包\n publish-pypi:\n runs-on: ubuntu-latest\n needs: build\n if: startsWith(github.ref, 'refs/tags/v')\n steps:\n - uses: actions/checkout@v4\n with:\n fetch-depth: 0\n submodules: true\n\n - uses: actions/setup-node@v4\n with:\n registry-url: https://registry.npmjs.org/\n node-version: lts/*\n\n - name: Generate changelog\n run: npx changelogithub\n continue-on-error: true\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n - uses: pdm-project/setup-pdm@v3\n\n - name: Publish package distributions to PyPI\n run: pdm publish\n continue-on-error: true\n" }, { "path": ".github/workflows/dockerhub-description.yml", "content": "name: Update Docker Hub Description\n\npermissions:\n contents: read\n\non:\n push:\n branches:\n - main\n paths:\n - 'README.md'\n - '.github/workflows/dockerhub-description.yml'\n workflow_dispatch:\n\njobs:\n update-description:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n\n - name: Docker Hub Description\n uses: peter-evans/dockerhub-description@v4\n with:\n username: ${{ secrets.DOCKERHUB_USERNAME }}\n password: ${{ secrets.DOCKERHUB_TOKEN }}\n repository: hanxi/xiaomusic\n" }, { "path": ".github/workflows/fmt.yml", "content": "name: fmt\n\non:\n push:\n branches:\n - \"*\"\n workflow_dispatch:\n\npermissions:\n contents: read\n\njobs:\n format:\n runs-on: ubuntu-latest\n permissions:\n contents: write\n steps:\n - uses: actions/checkout@v4\n with:\n fetch-depth: 0\n submodules: true\n\n - name: Setup PDM\n uses: pdm-project/setup-pdm@v4\n - name: install ruff\n run: pip install ruff\n - name: Format code\n run: pdm lintfmt\n\n - name: Check for changes\n id: check_changes\n run: |\n if [ -n \"$(git diff)\" ]; then\n echo \"changed=true\" >> $GITHUB_OUTPUT\n else\n echo \"changed=false\" >> $GITHUB_OUTPUT\n fi\n continue-on-error: true\n \n # Optionally, customize the user name and commit message, and can add an email as well such as Github Actions' email\n - name: Set up Git and Commit Changes\n run: |\n if [ \"${{ steps.check_changes.outputs.changed }}\" == \"true\" ]; then\n git config --local user.name \"Formatter [BOT]\"\n git add .\n git commit -m \"Auto-format code 🧹🌟🤖\"\n git push\n fi\n" }, { "path": ".github/workflows/static.yml", "content": "# Simple workflow for deploying static content to GitHub Pages\nname: Deploy static content to Pages\n\non:\n # Runs on pushes targeting the default branch\n push:\n branches: [\"main\"]\n paths:\n - 'docs/**'\n - 'README.md'\n - 'CHANGELOG.md'\n - '.github/workflows/static.yml'\n # Runs on issue events\n issues:\n types: [opened, edited, reopened] # Specify events you're interested in\n\n release:\n types:\n - uploaded\n\n workflow_run:\n workflows:\n - CI Workflow\n types:\n - completed\n\n # Allows you to run this workflow manually from the Actions tab\n workflow_dispatch:\n\n# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages\npermissions:\n contents: write\n pages: write\n id-token: write\n\n# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.\n# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.\nconcurrency:\n group: \"pages\"\n cancel-in-progress: false\n\njobs:\n # Single deploy job since we're just deploying\n deploy:\n environment:\n name: github-pages\n url: ${{ steps.deployment.outputs.page_url }}\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v4\n with:\n fetch-depth: 0\n submodules: true\n\n - name: Set up Node.js\n uses: actions/setup-node@v2\n with:\n node-version: '20'\n - name: Install dependencies\n working-directory: ./docs # 指定工作目录为 docs\n run: |\n npm install\n\n - name: Build VitePress\n env:\n VITE_GITHUB_ISSUES_TOKEN: ${{ secrets.VITE_GITHUB_ISSUES_TOKEN }}\n working-directory: ./docs # 指定工作目录为 docs\n run: | # 有点小问题，得执行2次\n npm run docs:build\n npm run docs:build\n\n - uses: pdm-project/setup-pdm@v3\n\n - name: pdm\n run: pdm install --prod --frozen-lockfile\n\n - name: generate versions.json\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: pdm run get_release.py\n\n - name: Check for changes\n id: check_changes\n run: |\n if [ -n \"$(git diff docs)\" ]; then\n echo \"changed=true\" >> $GITHUB_OUTPUT\n else\n echo \"changed=false\" >> $GITHUB_OUTPUT\n fi\n continue-on-error: true\n\n # Optionally, customize the user name and commit message, and can add an email as well such as Github Actions' email\n - name: Set up Git and Commit Changes\n run: |\n if [ \"${{ steps.check_changes.outputs.changed }}\" == \"true\" ]; then\n git config --local user.name \"Issues Docs [BOT]\"\n git config --local user.email \"github-actions[bot]@users.noreply.github.com\"\n git add .\n git commit -m \"Auto-Generate docs 🤖\"\n git push\n fi\n\n - name: Setup Pages\n uses: actions/configure-pages@v5\n - name: Upload artifact\n uses: actions/upload-pages-artifact@v3\n with:\n # Upload entire repository\n path: './docs/.vitepress/dist'\n - name: Deploy to GitHub Pages\n id: deployment\n uses: actions/deploy-pages@v4\n" }, { "path": ".gitignore", "content": "# Byte-compiled / optimized / DLL files\n__pycache__/\n*.py[cod]\n*$py.class\n\n# C extensions\n*.so\n\n# Distribution / packaging\n.Python\nbuild/\ndevelop-eggs/\ndist/\ndownloads/\neggs/\n.eggs/\nlib/\nlib64/\nparts/\nsdist/\nvar/\nwheels/\nshare/python-wheels/\n*.egg-info/\n.installed.cfg\n*.egg\nMANIFEST\n*_bak/\n# PyInstaller\n# Usually these files are written by a python script from a template\n# before PyInstaller builds the exe, so as to inject date/other infos into it.\n*.manifest\n*.spec\n\n# Installer logs\npip-log.txt\npip-delete-this-directory.txt\n\n# Unit test / coverage reports\nhtmlcov/\n.tox/\n.nox/\n.coverage\n.coverage.*\n.cache\nnosetests.xml\ncoverage.xml\n*.cover\n*.py,cover\n.hypothesis/\n.pytest_cache/\ncover/\n\n# Translations\n*.mo\n*.pot\n\n# Django stuff:\n*.log\nlocal_settings.py\ndb.sqlite3\ndb.sqlite3-journal\n\n# Flask stuff:\ninstance/\n.webassets-cache\n\n# Scrapy stuff:\n.scrapy\n\n# Sphinx documentation\ndocs/_build/\n\n# PyBuilder\n.pybuilder/\ntarget/\n\n# Jupyter Notebook\n.ipynb_checkpoints\n\n# IPython\nprofile_default/\nipython_config.py\n\n# pyenv\n# For a library or package, you might want to ignore these files since the code is\n# intended to run in multiple environments; otherwise, check them in:\n# .python-version\n\n# pipenv\n# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.\n# However, in case of collaboration, if having platform-specific dependencies or dependencies\n# having no cross-platform support, pipenv may install dependencies that don't work, or not\n# install all needed dependencies.\n#Pipfile.lock\n\n# poetry\n# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.\n# This is especially recommended for binary packages to ensure reproducibility, and is more\n# commonly ignored for libraries.\n# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control\n#poetry.lock\n\n# pdm\n# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.\npdm.lock\n# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it\n# in version control.\n# https://pdm.fming.dev/#use-with-ide\n.pdm.toml\n.pdm-python\n.pdm-build/\n\n# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm\n__pypackages__/\n\n# Celery stuff\ncelerybeat-schedule\ncelerybeat.pid\n\n# SageMath parsed files\n*.sage.py\n\n# Environments\n.env\n.venv\nenv/\nvenv/\nENV/\nenv.bak/\nvenv.bak/\n\n# Spyder project settings\n.spyderproject\n.spyproject\n\n# Rope project settings\n.ropeproject\n\n# mkdocs documentation\n/site\n\n# mypy\n.mypy_cache/\n.dmypy.json\ndmypy.json\n\n# Pyre type checker\n.pyre/\n\n# pytype static type analyzer\n.pytype/\n\n# Cython debug symbols\ncython_debug/\n\n# PyCharm\n# JetBrains specific template is maintained in a separate JetBrains.gitignore that can\n# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore\n# and can be added to the global gitignore or merged into this file. For a more nuclear\n# option (not recommended) you can uncomment the following to ignore the entire idea folder.\n#.idea/\n\nffmpeg\nmusic\ntest.sh\nconf\nsetting.json\n.DS_Store\ncache\ntmp/\nxiaomusic.log.txt*\nnode_modules\nreference/\n.aone_copilot/\n.idea/\n" }, { "path": ".gitmodules", "content": "" }, { "path": ".pre-commit-config.yaml", "content": "repos:\n- hooks:\n - id: commitizen\n - id: commitizen-branch\n stages:\n - push\n repo: https://github.com/commitizen-tools/commitizen\n rev: v3.27.0\n" }, { "path": "CHANGELOG.md", "content": "## v0.4.26 (2026-03-20)\n\n### Fix\n\n- proxy handler CDN safeguard & content-type based FFmpeg routing (#791)\n\n## v0.4.25 (2026-03-19)\n\n### Fix\n\n- proxy url too long for xiaomi speaker (#786)\n- 无法上传音乐 close #783\n\n## v0.4.24 (2026-03-13)\n\n### Feat\n\n- 新增适配iPhone主题 (#775)\n- Add 肉肉音乐TV link to index.html (#773)\n\n### Fix\n\n- 修复无法收藏歌曲的问题\n\n## v0.4.23 (2026-02-17)\n\n### Feat\n\n- **api**: support playlist_name in downloadonemusic (#756)\n- **api**: support downloadonemusic dirname under music_path (#751)\n- 二维码登录功能 (#750)\n- add dirname parameter to /downloadonemusic API (#749)\n- add /getplayerstatus API to get full player status (#747)\n\n### Fix\n\n- 漏提交base64 (#761)\n- **playlist**: avoid custom/folder name collisions (#752)\n- 点击 本地端口-自动填功能 报错 #742\n\n## v0.4.22 (2026-01-26)\n\n### Feat\n\n- 新增 HMusic 客户端\n\n### Fix\n\n- 修复播放歌曲口令问题 close #731\n- 修复nodejs进程无限重启的问题 see #728\n\n## v0.4.21 (2026-01-24)\n\n### Feat\n\n- 优化首页\n\n### Fix\n\n- 修复定时任务播放临时歌单报错问题\n\n## v0.4.20 (2026-01-23)\n\n### Feat\n\n- 优化默认主题的无障碍使用\n- 完善默认主题本机播放功能\n- 优化默认主题界面布局\n- 添加测试口令入口\n\n## v0.4.19 (2026-01-23)\n\n### Feat\n\n- 默认主题支持无障碍使用\n\n### Fix\n\n- 修复收藏歌曲报错\n- 修复 playlist相关接口报错问题\n\n## v0.4.18 (2026-01-21)\n\n### Feat\n\n- 默认口令都允许唤醒\n- 优化默认主题设置页面\n\n### Fix\n\n- 修复插件获取最后一条命令的问题\n- 修复 /proxy 接口问题\n\n## v0.4.17 (2026-01-20)\n\n### Fix\n\n- 支持代理 m3u8 格式链接 close #711\n- 兼容旧配置 hostname 报错 close #713\n- 修复下载歌曲报错 close #709\n- 修复报错 close #708\n\n## v0.4.16 (2026-01-18)\n\n### Feat\n\n- 新增【风花雪乐】手机APP入口\n- 优化获取时长卡顿问题\n- 删除怀旧主题\n\n### Fix\n\n- 只有一单音乐，同时不在播放列表中时更新播放列表 (#703)\n\n## v0.4.15 (2026-01-17)\n\n### Feat\n\n- TTS默认值修改\n\n## v0.4.14 (2026-01-16)\n\n### Fix\n\n- 修复报错 close #696\n\n## v0.4.13 (2026-01-16)\n\n### Feat\n\n- 登录支持仅填 cookie #688\n- 网络歌单插件功能更新 (#690)\n- 编译出 arm/v7 架构的镜像\n\n### Fix\n\n- 修复网络歌曲 proxy 处理问题\n\n## v0.4.12 (2026-01-15)\n\n### Fix\n\n- 修复启动报错\n\n## v0.4.11 (2026-01-15)\n\n### Fix\n\n- 修复报错 close #684\n- 修复登陆报错问题\n- 修复保存报错\n\n## v0.4.10 (2026-01-15)\n\n### Feat\n\n- 主页新增获取对话记录开关\n\n### Fix\n\n- 设置token到account，解决登陆问题 (#680)\n- 把cookie到.mi.token，解决登录报错问题 (#676)\n- 修复ws连接错误\n\n## v0.4.9 (2026-01-15)\n\n### Feat\n\n- 新增清空临时目录接口，优化tts接口\n\n### Fix\n\n- 修复刷新列表问题 close #621\n- 修复定时器关闭问题\n\n### Refactor\n\n- 修改api接口\n\n## v0.4.8 (2026-01-13)\n\n### Feat\n\n- 支持配置 cookie\n- 接入 edge-tts 解决文字转语音的问题 close #642\n\n### Fix\n\n- 修复关机慢的问题，关机改完接口 close #479\n- 修复一直循环播放一首歌曲的问题 close #519\n\n## v0.4.7 (2026-01-12)\n\n### Feat\n\n- 默认关闭语音口令\n- 修复同一个时间不能执行多个定时任务的问题\n- 打包docker镜像并上传github\n- 重构播放时长获取规则 see #668\n\n### Fix\n\n- 修改cache目录，修复播放时长问题\n- 修复异常未加载插件无法禁用bug (#666)\n\n## v0.4.6 (2026-01-12)\n\n### Feat\n\n- 定时任务支持选多个歌曲组成一个歌单播放\n\n### Fix\n\n- 修复【启用】网络歌曲过代理后，在线歌曲播放链接被base编码两次bug (#664)\n- 修复报错 #660\n- 修复在线推送发出设置成循环播放回复的问题\n\n## v0.4.5 (2026-01-10)\n\n### Feat\n\n- 在线播放功能优化，新增AI智能提取用户口令 (#654)\n\n### Fix\n\n- 修复重构后的问题\n- 修复部分网络歌曲无法播放的问题\n- 解决在线歌曲链接转换问题\n- 修复重构引起的问题\n- 修复重构后遇到的问题\n\n## v0.4.4 (2026-01-07)\n\n### Fix\n\n- 修复无法关闭的问题\n- 修复无法关闭的问题\n- 修复关闭不了的问题\n- self.log.inf缺少o\n\n### Refactor\n\n- lint code\n\n## v0.4.3 (2026-01-07)\n\n### Fix\n\n- 定时播放报错\n\n## v0.4.2 (2026-01-06)\n\n### Fix\n\n- 修复不能播放的问题\n\n## v0.4.1 (2026-01-06)\n\n### Fix\n\n- 修复不能播放的问题\n\n## v0.4.0 (2026-01-06)\n\n### Feat\n\n- 移除第三方设备播放功能\n- 新增定时任务刷新网络歌单 #616\n- add last_cmd to store latest query (#635)\n- 增加musicfree插件集成功能\n\n### Fix\n\n- 修复 python3.14 中无法运行的问题\n- 修复顺序播放上一首失效的问题\n- 修复本地歌曲无法播放的问题\n\n### Refactor\n\n- 重构 xiaomusic.py 模块\n- 重构 xiaomusic.py 模块\n- 重构 xiaomusic.py 模块\n- 优化日志\n- 优化日志\n- 重构拆分 httpserver 文件\n- 重构拆分 utils 文件\n- 优化日志输出\n- 清理 httpserver.py 中的无效代码\n\n## v0.3.102 (2025-12-21)\n\n### Feat\n\n- 支持记录每个播放列表上次播放的歌曲 close #613\n\n## v0.3.101 (2025-12-01)\n\n### Fix\n\n- hostname 不允许填 127.0.0.1 和 localhost\n- 修复自动填端口为0的问题\n- SoundSpace随机播放模式失效 #578 (#585)\n- 下线失效的统计服务 close #579\n\n## v0.3.100 (2025-11-09)\n\n### Feat\n\n- soundSpace兼容移动端 (#577)\n\n## v0.3.99 (2025-11-02)\n\n### Feat\n\n- 新增 SoundScape 主题\n- add path aliases and base URL configuration in Vite（SoundSpace） (#569)\n- SoundSpace Theme (#568)\n\n## v0.3.98 (2025-11-02)\n\n## v0.3.97 (2025-11-01)\n\n### Feat\n\n- 升级 miservice\n\n### Fix\n\n- 优化登录问题\n\n## v0.3.96 (2025-10-28)\n\n### Fix\n\n- tts问题临时处理\n\n## v0.3.95 (2025-10-26)\n\n### Fix\n\n- 修复型号M01不能播放问题\n\n## v0.3.94 (2025-10-25)\n\n### Fix\n\n- 尝试修复登录问题\n\n## v0.3.93 (2025-10-25)\n\n### Fix\n\n- 尝试修复登录问题\n\n## v0.3.92 (2025-10-25)\n\n### Fix\n\n- 尝试解决登录失败问题\n\n## v0.3.91 (2025-10-24)\n\n### Feat\n\n- 删掉没用的网页更新功能\n- 获取对话记录接口修改\n\n### Fix\n\n- 尝试修复登录问题\n\n## v0.3.90 (2025-10-22)\n\n### Fix\n\n- 修复登录问题 see #547\n\n## v0.3.89 (2025-10-21)\n\n### Fix\n\n- 修复缺失库报错\n\n## v0.3.88 (2025-09-16)\n\n### Feat\n\n- 新增歌单合并工具\n- 兼容 X6A 型号\n\n## v0.3.87 (2025-09-11)\n\n### Feat\n\n- 新增 websocket 接口获取当前播放状态\n\n### Fix\n\n- 修复本地播放失败问题\n\n## v0.3.86 (2025-09-08)\n\n### Feat\n\n- LX音源支持http_proxy\n- 支持LX歌单\n- 代理播放模式使用原始地址获取歌曲时长\n- 网络歌曲支持使用代理的方式播放\n- 新增代理播放链接功能 see: #525\n\n## v0.3.85 (2025-08-08)\n\n### Fix\n\n- 修复延迟关机按钮失效问题\n\n## v0.3.84 (2025-08-03)\n\n### Feat\n\n- 下一首歌延迟播放秒数支持负数，用于解决播放下一首时会播放上一首的开头几秒的问题\n\n### Fix\n\n- 修复谷歌字体问题\n- 文件监控: 忽略非文件创建、删除和移动事件 (#514)\n- 修复中文定时关机无法识别的BUG (#510)\n- 修复日志文件删除失败的问题\n\n## v0.3.83 (2025-06-12)\n\n### Feat\n\n- 新增开关控制是否开始谷歌统计 see #473\n- 支持b站合集和收藏下载 (#487)\n\n### Fix\n\n- 修复安全问题\n- 修复安全问题\n\n## v0.3.82 (2025-05-30)\n\n### Fix\n\n- 修复节假日文件没有打包到 docker 镜像里的问题\n\n## v0.3.81 (2025-05-28)\n\n### Feat\n\n- 定时任务支持工作日和休息日 see #182\n\n### Fix\n\n- 动态小程序码生成接口 (#478)\n- 指定日志编码,避免中文乱码 (#475)\n\n## v0.3.80 (2025-05-18)\n\n### Feat\n\n- 新增 OH2 型号的支持\n- 支持配置最大搜索歌曲数量 see #462\n\n### Fix\n\n- 修复获取在线歌曲长度 (#469)\n\n## v0.3.79 (2025-04-29)\n\n### Fix\n\n- 修复型号LX05不能播放问题\n\n## v0.3.78 (2025-04-09)\n\n### Feat\n\n- 优化获取时长的方式\n\n### Fix\n\n- 修复部分型号单曲播放功能无效的问题\n- 监控文件夹仅对音乐格式生效，减少不必要的刷新 (#441)\n- 修复型号X4B不能播放问题\n\n## v0.3.77 (2025-03-13)\n\n### Feat\n\n- OH2P 型号支持打断说话\n\n### Fix\n\n- 修复首页看不到设备的问题\n\n## v0.3.76 (2025-03-11)\n\n### Feat\n\n- 整理第三方播放设备的代码\n- 删除歌曲口令默认关闭\n- 新增删除歌曲口令 see #402\n- 增加音量控制for -3thplay.html by socketio.emit (#404)\n- 增加大声,音量,继续的指令,用于3thplay (#401)\n- 不用再手动配置 tts command, 优先使用已知的 tts command\n- 新增重新初始的定时任务 #182\n- 新增定时任务用于开启和关闭拉取对话记录 #182\n- 加入了遥控网页播放，用于实现电视上使用 (#395)\n\n### Fix\n\n- tailwind播放页面有报错，暂时禁用\n- tailwind 主题问题\n- 修复下载后不自动播放的问题\n- 修复每次打开页面都是随机播放的问题\n\n## v0.3.75 (2025-02-18)\n\n### Feat\n\n- 监测音乐文件夹变化更新歌曲列表 (#394)\n- 添加正在播放页面 (#386)\n- 更新tailwind主题 (#383)\n\n### Fix\n\n- 未开启模糊匹配播放错误问题 (#393)\n- 修复tailwind主题样式问题 (#384)\n\n## v0.3.74 (2025-01-21)\n\n### Feat\n\n- 新增 Tailwind 主题\n- 修改设置页面文档链接\n\n### Fix\n\n- 修复下载歌单重命名问题\n\n## v0.3.73 (2025-01-16)\n\n### Fix\n\n- 当前歌曲不在列表中时才切换列表 close #359\n- 修复默认主题播放进度时间问题\n- 尝试修复获取对话记录失败的问题 close #362\n\n## v0.3.72 (2025-01-11)\n\n### Feat\n\n- 新增播放文字功能\n\n### Fix\n\n- 修复默认主题没有单曲循环的问题 see #355\n\n## v0.3.71 (2025-01-07)\n\n### Feat\n\n- 支持自动填 ip 和端口\n\n### Fix\n\n- 搜索歌曲窗口不自动关闭 see #351\n- 解决歌词信息写入失败的问题\n- 修复一些小问题\n- 非播放中也返回歌曲时长 see #340\n\n## v0.3.70 (2025-01-04)\n\n### Fix\n\n- 尝试修复部分设备无法启动的问题\n- 解决首页提示翻译英文问题\n- 尝试解决 supervisor 启动报错\n\n## v0.3.69 (2025-01-01)\n\n### Feat\n\n- 支持关闭获取对话记录功能\n\n### Fix\n\n- 尝试解决网络卡顿问题\n\n## v0.3.68 (2024-12-31)\n\n### Feat\n\n- umami 脚本改为异步加载\n- 支持 python3.13 版本\n- 增加均衡歌曲响度（可选） (#338)\n\n### Fix\n\n- 修复保存设置时可能出现报错的情况\n\n## v0.3.67 (2024-12-29)\n\n### Feat\n\n- 简化设置，不允许修改监听端口\n\n### Fix\n\n- 修复默认主题搜索问题\n\n## v0.3.66 (2024-12-26)\n\n### Fix\n\n- 修复歌曲批量重命名的问题\n- 修复自定义歌单删除后没刷新歌单列表\n- 尝试修复更新失败问题\n\n## v0.3.65 (2024-12-24)\n\n### Fix\n\n- 处理图像报错\n- 修改歌单名字漏更新歌单列表\n- 修复获取自定义歌单接口报错\n\n## v0.3.64 (2024-12-22)\n\n### Fix\n\n- 使用自己架设的 sentry 服务，解决 Cloudflare 额度超量问题\n\n## v0.3.63 (2024-12-22)\n\n### Perf\n\n- 只监控报错信息\n\n## v0.3.62 (2024-12-21)\n\n### Fix\n\n- 修复首次配置时，默认主题只有一个设备的问题。\n- 修复一些报错问题\n\n## v0.3.61 (2024-12-19)\n\n### Fix\n\n- 尝试修复更新问题\n\n### Refactor\n\n- 重构更新流程\n\n## v0.3.60 (2024-12-19)\n\n## v0.3.59 (2024-12-19)\n\n### Feat\n\n- 新增更多的歌单编辑相关接口\n- 一键更新功能\n- 接入 sentry 平台\n- 实现更新接口\n- 下载完成之后修改文件权限为755 close #316\n\n### Fix\n\n- 解决飞牛平台报错问题\n\n### Refactor\n\n- 优化代码日志级别\n- 更新等消息推送到客户端再重启\n- 更新接口修改\n\n## v0.3.58 (2024-12-15)\n\n### Fix\n\n- 尝试解决七牛设备问题\n- 修复 umami 统计函数报错，解决七牛环境问题\n\n## v0.3.57 (2024-12-14)\n\n### Feat\n\n- 优化批量下载工具命名和下载高码率音频\n- 新增搜索播放口令用于生成临时播放列表\n- 新增设置项 ignore_tag_dirs 用于忽略读取目录下的标签信息，解决挂载 alist 目录的问题\n- 新主题 Material (#299)\n\n### Fix\n\n- 默认主题刷新时选中当前播放歌曲\n- 修复当前播放列表没更新的问题\n- 修复搜索时不显示保存输入框问题\n- 收藏 (#301)\n- 修复收藏歌曲失败的问题\n- 小屏幕设备主页显示问题 (#300)\n\n### Refactor\n\n- 修改默认主题\n- 后端也加入 umami 统计\n- 新增自托管 umami 统计\n- XIAOMUSIC_HOSTNAME 携带端口号友好提醒并处理 (#303)\n- 修改标题\n- 冲突解决错误\n\n## v0.3.56 (2024-12-07)\n\n### Feat\n\n- tag 信息支持写入到歌曲文件 see #266\n- 开启gzip压缩\n\n### Fix\n\n- 播放失败设置重试次数10次，解决设备失联后无限重试的问题\n- 修复最近新增歌单问题\n- 小程序码移动端布局兼容 (#293)\n\n## v0.3.55 (2024-12-04)\n\n### Fix\n\n- 修复播放接口报错问题\n\n## v0.3.54 (2024-12-04)\n\n### Feat\n\n- 新增最近新增歌单 close #273\n\n### Fix\n\n- 安卓低版本webview对audio的src为空值的报错 (#289)\n- 修复M01语音播放问题，X08C X08E X8F 型号默认采用型号兼容模式 see #30\n\n## v0.3.53 (2024-12-03)\n\n### Fix\n\n- 解决播放接口修改后播放失败的问题\n\n## v0.3.52 (2024-12-03)\n\n### Fix\n\n- 修复播放接口参数错误的问题\n\n## v0.3.51 (2024-12-03)\n\n### Fix\n\n- 修复空配置启动失败问题 close #284\n\n## v0.3.50 (2024-12-03)\n\n### Feat\n\n- 修改日志文件的默认值\n- 新增修改tag缓存信息的接口 close #266\n- 新增专用的播放歌曲和播放歌单接口，解决默认口令提示词被修改了导致后台失效的问题\n- 统计设备型号\n- 页面与设置中的HOST不一致时弹窗提醒 (#281)\n- 未发现小爱设备时给予提示 (#278)\n- 优化设置页面提示\n\n### Fix\n\n- 更新 yt-dlp ，解决 B 站下载问题 close #279\n- 网页播放audio获取到错误url无法播放时提醒用户 (#280)\n- input标签自闭合\n\n### Refactor\n\n- 调整设置页面\n\n## v0.3.49 (2024-11-28)\n\n### Feat\n\n- 临时文件目录支持配置 #99\n- 新增单曲播放和顺序播放功能 close #277\n- 设置播放类型支持配置语音提示词，定时任务支持设置播放类型\n\n### Fix\n\n- 修复中文数字转换函数对'十、十一'等数字的处理 (#275)\n\n## v0.3.48 (2024-11-20)\n\n### Feat\n\n- 支持替换默认口令，而不是追加 close #259\n- 新增自定义个歌单接口 #242\n\n### Fix\n\n- 锁定 PWA 应用旋转方向\n\n## v0.3.47 (2024-11-14)\n\n### Feat\n\n- 支持 PWA 应用安装\n- 新增模糊匹配测试用例\n\n### Fix\n\n- 修复 PWA 应用有密码时报错的问题\n- 修复播放顺序没有按数字排序的问题 close #249\n\n## v0.3.46 (2024-11-08)\n\n### Feat\n\n- 升级依赖库\n\n### Fix\n\n- 添加依赖库 requests\n\n### Refactor\n\n- 依赖库已经支持分段获取静态文件，重构代码\n\n## v0.3.45 (2024-11-08)\n\n### Feat\n\n- 定时任务支持设置音量\n- 播放歌单口令支持配置\n\n### Fix\n\n- 修复定时任务报错问题\n\n## v0.3.44 (2024-11-01)\n\n### Feat\n\n- 日志时间里加上日期\n\n### Fix\n\n- 修复搜索失败的问题\n\n## v0.3.43 (2024-10-30)\n\n### Feat\n\n- 播放列表可以删除当前歌曲(!危险操作，请在设置中心开启相关功能) (#250)\n- 插件自定义口令支持获取语音输入内容 #105\n\n### Fix\n\n- 修复谷歌统计导致的卡顿问题\n- 解决挂载网盘卡死的问题\n\n## v0.3.42 (2024-10-24)\n\n### Fix\n\n- 尝试修复缺少 libtiff.so.6 文件的问题 #244\n- 修复默认主题播放歌曲输入框空的情况\n- 尝试修复停止后自动播放的问题\n\n## v0.3.41 (2024-10-17)\n\n### Feat\n\n- 设置默认时区为东八区 closed #236\n\n### Fix\n\n- 修复获取标签信息报错问题\n- remove_id3_tags return None if no id3 tag (#238)\n- bug in del_music (#237)\n\n## v0.3.40 (2024-10-16)\n\n### Feat\n\n- 默认主题的播放列表上显示歌曲数量\n\n### Fix\n\n- 修复播放卡顿问题（谷歌统计地址无法访问的情况）\n\n## v0.3.39 (2024-10-15)\n\n### Feat\n\n- 固定的播放列表全部初始化\n- 生产环境与开发环境接口分离、关于页面增加返回到主页的链接\nupdate: 支持https页面未及时更新的问题\n\n### Fix\n\n- pure主题 当前设备与远程设备未正确区分的问题 (#234)\n- static和doc添加basic auth (#231)\n\n### Refactor\n\n- 修改默认UI播放提示词 (#233)\n\n## v0.3.38 (2024-10-14)\n\n### Feat\n\n- 播放状态接口返回当前播放列表 (#229)\n- 新增口令收藏歌曲用来收藏当前播放的歌曲\n- 默认UI搜索框动态显示 (#228)\n- 文件转换逻辑延迟到读取文件的时候 see #218\n- 重写播放组件，现在支持歌词显示了\n- 使用 /cmdstatus 接口来判断异步任务是否完成\n- 新增接口 /cmdstatus 用于查询异步任务是否执行完毕\n- XMusicPlayer播放器主题优化 (#216)\n- XMusicPlayer播放器主题 (#214)\n- 新增 yt-dlp cookies 文件参数支持\n- 新增批量下载歌曲工具\n- 新增后台网站图标\n- 加密音乐和图片访问链接 (#200)\n- 歌曲信息中的图片改为url #190\n- 新增更新提醒\n- 定时任务新增刷新播放列表接口\n- 后台设置名称优化\n- 新增按钮刷新 tag 信息\n- 新增 musicinfos 接口用于批量查询歌曲信息\n- 增加 tags 缓存 (#193)\n- 使用 opencc 将歌曲名转化为简体 (#192)\n- 搜索的歌曲存成列表供前端显示,实现额外索引 (#188)\n- 搜索多个结果，并更新“当前”播放列表 (#185)\n- musicinfo接口新增musictag参数，用于返回歌曲额外信息\n- 新增口令【播放列表第几个+列表名】来播放列表里的第几个 #158\n- 新增定时任务功能 #182\n- hostname can take protocol，域名支持 https 格式 (#181)\n\n### Fix\n\n- xplayer 收藏歌曲、取消收藏 (#230)\n- 修复型号M01获取对话记录时间戳的问题\n- 修复型号M01无法获取到对话记录的问题\n- 使用小爱设备播放时组件异常的问题 (#217)\n- 修复图片获取失败的问题\n- 修复 yt-dlp-cookies 报错\n- 修复自定义口令末尾多余逗号的情况\n- 修复windows下路径问题\n- 解决 L05C 无提示音问题 support MiIOService tts (#198)\n- 解决歌曲信息乱码问题\n- 修复搜索补全不生效的问题\n- 修复默认主题没有选中上次播放列表的问题\n- ffmpeg only output audio (#184)\n\n### Refactor\n\n- 新增清理缓存按钮\n- 优化默认UI的搜索框#226 (#227)\n- 修复告警\n- 体验优化，音乐列表缓存 (#222)\n- 修改为播放选中歌曲\n- 更新静态文件\n\n### Perf\n\n- 对歌曲信息中的图片缩小到300 #190\n\n## v0.3.37 (2024-09-20)\n\n### Feat\n\n- Pure主题更新 设置中心新增主题音乐列表样式选择、夜间模式、其他多项优化 (#180)\n\n## v0.3.36 (2024-09-19)\n\n### Feat\n\n- Pure 主题更新 (#178)\n- 支持配置获取对话记录间隔时间 #169\n- 允许在后台设置监听端口\n\n### Fix\n\n- 修复开启继续播放时歌曲播放不完整问题 (#177)\n\n## v0.3.35 (2024-09-18)\n\n### Feat\n\n- 允许跨域访问 #172\n\n### Fix\n\n- 修复 Pure 主题白屏无法打开的问题 (#176)\n\n## v0.3.34 (2024-09-18)\n\n### Feat\n\n- 新增 pure 主题 vue + elementUI (#172)\n\n### Fix\n\n- 主页适配移动端\n- 修复网页播放点击后没有关闭旧声音的问题 #166\n- 修复单曲循环的情况下歌曲不在当前播放列表时失效的情况\n\n### Refactor\n\n- 优化代码:输入框处理抖动问题，网页播放修改实现方式 see #166\n\n## v0.3.33 (2024-09-15)\n\n### Feat\n\n- 调整页面布局\n- 支持继续播放 (#171)\n\n### Fix\n\n- #168 安全优化: 设置数据接口密码隐藏处理\n- 修复谷歌统计报错问题\n\n### Refactor\n\n- 优化谷歌统计\n\n## v0.3.32 (2024-09-14)\n\n### Feat\n\n- 新增谷歌统计\n- 增加播放进度 (#160)\n\n### Fix\n\n- 优化audio_id查询方式 (#165)\n- 播放链接接口支持复杂的链接\n\n## v0.3.31 (2024-09-10)\n\n### Feat\n\n- 新增播放上一首歌曲功能 #90\n- 新增所有歌曲列表\n- 触屏版显示歌曲名称 (#156)\n\n### Fix\n\n- 修复插件示例报错 #105\n- 修复当前播放歌曲没保存的问题 #90\n\n## v0.3.30 (2024-09-07)\n\n### Feat\n\n- 修改设置按钮位置\n- 新增网页播放接口 #138\n\n## v0.3.29 (2024-09-06)\n\n### Feat\n\n- 设置页面新增接口文档入口\n\n### Fix\n\n- 修复网页开启秘密验证无法播歌的问题 #149\n\n## v0.3.28 (2024-09-03)\n\n### Feat\n\n- 新增歌曲收藏功能 #87\n\n### Fix\n\n- docker下minetypes无法判断m4a\n\n### Refactor\n\n- ffmpeg_location 从配置里读取\n\n## v0.3.27 (2024-09-02)\n\n### Feat\n\n- Add feature as requested in issue #143\n\n### Fix\n\n- 默认下载目录修改\n\n### Refactor\n\n- 处理 code review 问题'\n\n## v0.3.26 (2024-08-17)\n\n### Feat\n\n- 删除网关模式\n\n## v0.3.25 (2024-08-16)\n\n### Feat\n\n- 设置页面支持配置 use_music_api 选项\n\n## v0.3.24 (2024-08-01)\n\n### Fix\n\n- #131 修复多设备切换时播放模式显示错误问题\n\n## v0.3.23 (2024-08-01)\n\n### Fix\n\n- 修复部分文件获取不到播放时长问题\n- 处理安全问题\n\n## v0.3.22 (2024-08-01)\n\n### Feat\n\n- 网关模式支持配置，默认关闭\n\n### Fix\n\n- 继续优化延迟问题\n\n## v0.3.21 (2024-07-30)\n\n### Feat\n\n- 尝试加个网关在前面处理静态文件来加速文件获取\n\n### Fix\n\n- 使用前置网关处理静态文件来加速，尝试解决延迟的问题\n- 播放前先立即暂停之前的音乐\n\n## v0.3.20 (2024-07-30)\n\n### Fix\n\n- 尝试修复延迟问题，修复播放停止不了的问题\n\n## v0.3.19 (2024-07-30)\n\n### Fix\n\n- 调整配置，优化获取歌曲时长接口\n\n## v0.3.18 (2024-07-29)\n\n### Fix\n\n- #135 修复获取不到播放时长时只播放3秒的问题\n\n## v0.3.17 (2024-07-28)\n\n### Fix\n\n- 优化日志输出，尝试排查延迟播放的问题\n\n## v0.3.16 (2024-07-28)\n\n## v0.3.15 (2024-07-28)\n\n### Fix\n\n- 修复自定义口令重复的问题\n- 修复日志输出问题\n- 修复退出异常问题\n\n## v0.3.14 (2024-07-28)\n\n### Feat\n\n- 优化播放延迟问题，并新增配置下一首播放的延迟秒数\n\n## v0.3.13 (2024-07-24)\n\n### Fix\n\n- 解决 docker 镜像问题\n\n## v0.3.12 (2024-07-24)\n\n### Feat\n\n- 优化获取文件播放时长接口，尝试解决播放延迟和操作面板卡顿的问题\n\n## v0.3.11 (2024-07-22)\n\n### Feat\n\n- Add remove mp3 id3 tag function\n\n### Fix\n\n- #130 单曲循环的模式下，播放列表的指令不生效\n\n### Refactor\n\n- 优化代码\n\n## v0.3.10 (2024-07-19)\n\n### Feat\n\n- 支持软连接的接口直接用os.walk即可\n\n### Fix\n\n- 修复软连接目录不能播放的问题\n- 修复自定义语音口令设置不生效的问题\n\n## v0.3.9 (2024-07-17)\n\n### Feat\n\n- #119 音乐目录支持软连接\n\n### Fix\n\n- 修复日志下载报错问题\n- 兼容旧的setting.json文件中conf_path为空的情况\n- 修复设置页面可能打不开的问题\n\n## v0.3.8 (2024-07-16)\n\n### Fix\n\n- 修复播放url接口问题\n\n## v0.3.7 (2024-07-16)\n\n### Feat\n\n- 播放链接按钮对应给个默认的链接用于测试\n- Uvicorn 的日志信息合并到 xiaomusic 日志里显示\n\n## v0.3.6 (2024-07-15)\n\n### Fix\n\n- #126 修复pip安装时主页打不开的问题\n\n## v0.3.5 (2024-07-15)\n\n### Fix\n\n- #116 播放失败自动切下首歌\n\n## v0.3.4 (2024-07-15)\n\n### Fix\n\n- #125 修复本地英文歌曲匹大小写字母配不到的问题\n\n## v0.3.3 (2024-07-15)\n\n### Fix\n\n- 尝试修复播放卡顿问题 see #124\n\n## v0.3.2 (2024-07-15)\n\n### Fix\n\n- #122 pip安装方式下，static目录找不到报错\n- 版本更新时更新页面缓存\n\n## v0.3.1 (2024-07-15)\n\n### Fix\n\n- 修复主页选择设备不生效的问题 see #120\n\n## v0.3.0 (2024-07-14)\n\n### Feat\n\n- 建议音乐目录和配置目录分开不同目录\n- 优化后台网络设置，同时支持ipv4和ipv6\n- 使用fastapi替换flask,解决多线程问题\n- #106 网页上显示音箱当前状态（播放中or空闲中）以及当前的播放模式\n- 优化首页加载慢的问题\n- 优化设置页面布局，方便配置必须项\n- 优化配置界面，支持配置分组\n- 支持多设备分开播放 see #65\n\n### Fix\n\n- #114 修复部分 mp3 文件长度识别错误\n- 删除 armv6 的支持\n- 修复编译问题\n- 修复音乐路径设置后找不到音乐的问题\n- 修复启动报错的问题\n- 修复CI警告问题\n\n## v0.2.0 (2024-07-09)\n\n### Feat\n\n- 触屏版可以不用设置 XIAOMUSIC_USE_MUSIC_API\n- 升级依赖库\n- 唤醒口令配置支持配语音词，简化自定义口令配置 see #105\n\n## v0.1.101 (2024-07-07)\n\n### Fix\n\n- #81 修复播放列表时，当前歌曲不在列表没有更换歌曲的问题\n- #110 修复配置加载问题\n\n## v0.1.100 (2024-07-07)\n\n### Fix\n\n- 日志代码写错\n\n## v0.1.99 (2024-07-07)\n\n### Fix\n\n- #81 修复播放列表没有继续播放上次播放的歌曲，并把随机播放，全部循环，单曲循环状态落地\n\n## v0.1.98 (2024-07-07)\n\n### Fix\n\n- 修复多设备获取不到对话记录的问题 see #65\n- #93 修复目录深度设置后导致目录下的歌曲无法加到播放列表里的问题\n\n## v0.1.97 (2024-07-06)\n\n### Fix\n\n- 修复网页控制台设置页面保存报错\n\n## v0.1.96 (2024-07-06)\n\n### Feat\n\n- 使用commitizen管理版本号\n- 页面版本号链接到CHANGELOG页面\n- 规范版本管理\n\n## v0.1.95 (2024-07-06)\n\n## v0.1.94 (2024-07-06)\n\n### Feat\n\n- 优化多设备接口执行效果，尽量做到同时执行\n\n### Fix\n\n- 新增参数配置强制打断小爱说话\n- 修复多设备获取对话记录的问题\n- 修复windows下路径分隔符被视为转移符导致音箱无法播放音乐的问题\n- 修复播放链接报错\n- 修复配置页面默认配置被置空的问题\n\n## v0.1.93 (2024-07-05)\n\n### Feat\n\n- 访问账号密码默认为空\n- 支持下载的目录与本地音乐目录分开 see #98\n- 新增m4a文件格式支持\n- 设置页面支持配置多设备\n- 默认用空的后台账号和密码\n- 支持多个设备同时播放 see #65\n- 新增自定义口令功能 #105\n\n### Fix\n\n- 修复设置页面没成功初始化设置问题\n- 修复镜像缺少文件问题\n- 尝试解决插件路径问题\n- 设置页面日志路径写错了\n- 修复口令导致异常关闭的问题\n\n## v0.1.92 (2024-07-04)\n\n### Feat\n\n- 启动参数新增 --port 配置监听端口\n- 外网访问端口可独立配置\n- 优化设置页面，新增更多配置项\n- 首次保存设置后不需要重启容器\n\n### Fix\n\n- 日志文件配置的环境变量写错了\n\n## v0.1.91 (2024-07-03)\n\n### Fix\n\n- 尝试解决触屏版不能播放的问题\n\n## v0.1.90 (2024-07-02)\n\n### Feat\n\n- 优化触屏版播放页面显示歌曲\n\n## v0.1.89 (2024-07-02)\n\n### Feat\n\n- 尝试解决触屏版无法播放的问题\n\n### Fix\n\n- 播放歌曲写成固定的了\n- 播放歌曲时被其他指令打断后没有继续播放\n\n## v0.1.88 (2024-07-02)\n\n### Feat\n\n- 日志里不要输出敏感信息\n- 优化下载 ffmpeg 脚本，尝试解决 armv7 环境问题\n- 优化日志输出信息\n- 尝试解决触屏版无法播放的问题\n\n### Fix\n\n- 是否下载中判断错误导致播放无法自动重新开始播放\n- 升级yt-dlp到2024.07.01\n- 修复部分型号关机失败的问题\n\n## v0.1.87 (2024-07-01)\n\n### Fix\n\n- 修复XIAOMUSIC_USE_MUSIC_API=true时播放不了的问题\n\n## v0.1.86 (2024-07-01)\n\n### Feat\n\n- 优化 ffmpeg 安装脚本\n- 新增调试工具用来调试 player_play_music 接口\n- 升级依赖库 MiService\n\n### Fix\n\n- 尝试修复 armv7 的 ffmpeg 问题\n- 尝试修复关机失败的问题\n- 修复口令不能播放的问题\n\n## v0.1.85 (2024-06-30)\n\n### Feat\n\n- 版本号链接到github的release页面，方便查看版本更新日志\n\n### Fix\n\n- 修复电台删除后没有从电台列表中删除的问题\n\n## v0.1.84 (2024-06-30)\n\n### Feat\n\n- config.json 支持更多配置选项\n- 新增 XIAOMUSIC_STOP_TTS_MSG 配置关机提示音\n\n## v0.1.83 (2024-06-30)\n\n## v0.1.82 (2024-06-30)\n\n### Feat\n\n- 优化指令匹配规则\n\n## v0.1.81 (2024-06-30)\n\n## v0.1.80 (2024-06-30)\n\n### Fix\n\n- #91 修复下载歌曲报错\n\n## v0.1.79 (2024-06-29)\n\n## v0.1.77 (2024-06-29)\n\n### Fix\n\n- #52 支持配置模糊匹配本地歌曲\n\n## v0.1.76 (2024-06-28)\n\n## v0.1.75 (2024-06-28)\n\n## v0.1.74 (2024-06-28)\n\n## v0.1.73 (2024-06-28)\n\n## v0.1.72 (2024-06-28)\n\n## v0.1.71 (2024-06-28)\n\n### Fix\n\n- #83\n\n## v0.1.70 (2024-06-27)\n\n## v0.1.69 (2024-06-26)\n\n## v0.1.67 (2024-06-26)\n\n## v0.1.66 (2024-06-26)\n\n## v0.1.65 (2024-06-26)\n\n## v0.1.64 (2024-06-26)\n\n## v0.1.62 (2024-06-25)\n\n## v0.1.61 (2024-06-25)\n\n## v0.1.60 (2024-06-25)\n\n## v0.1.58 (2024-06-25)\n\n### Fix\n\n- 登陆失败不阻塞启动\n\n## v0.1.57 (2024-06-24)\n\n## v0.1.56 (2024-06-24)\n\n## v0.1.55 (2024-06-23)\n\n### Fix\n\n- #47 支持配置基础的BaseAuth登录\n\n## v0.1.54 (2024-06-23)\n\n### Fix\n\n- #76 新增XIAOMUSIC_MUSIC_PATH_DEPTH配置生成播放列表的目录深度，默认10\n- #74 配置目录可以和下载目录分开配置, 新增XIAOMUSIC_CONF_PATH用来设置配置目录，不配置时使用下载目录\n\n## v0.1.53 (2024-06-23)\n\n## v0.1.52 (2024-06-21)\n\n## v0.1.51 (2024-06-20)\n\n## v0.1.49 (2024-06-20)\n\n## v0.1.48 (2024-06-16)\n\n## v0.1.47 (2024-06-16)\n\n## v0.1.46 (2024-06-15)\n\n## v0.1.45 (2024-06-15)\n\n## v0.1.44 (2024-06-14)\n\n## v0.1.43 (2024-06-14)\n\n## v0.1.41 (2024-06-14)\n\n## v0.1.40 (2024-06-12)\n\n## v0.1.39 (2024-06-12)\n\n## v0.1.38 (2024-06-12)\n\n### Fix\n\n- #70 下一首歌曲不存在时从播放列表中删除并继续找下一首\n\n## v0.1.37 (2024-06-04)\n\n## v0.1.36 (2024-05-30)\n\n## v0.1.35 (2024-05-30)\n\n### Fix\n\n- #67 没配置did时也允许启动 http 服务\n\n## v0.1.34 (2024-05-19)\n\n## v0.1.33 (2024-05-19)\n\n### Fix\n\n- #50 新增配置页面\n- #62\n\n## v0.1.32 (2024-05-17)\n\n## v0.1.31 (2024-05-16)\n\n## v0.1.30 (2024-05-16)\n\n### Fix\n\n- 控制台显示版本号 #59\n\n## v0.1.29 (2024-05-16)\n\n### Fix\n\n- #57 #55\n\n## v0.1.28 (2024-05-16)\n\n## v0.1.27 (2024-05-16)\n\n## v0.1.26 (2024-05-08)\n\n## v0.1.25 (2024-05-06)\n\n## v0.1.24 (2024-04-30)\n\n## v0.1.23 (2024-04-30)\n\n## v0.1.22 (2024-04-30)\n\n## v0.1.21 (2024-04-08)\n\n## v0.1.20 (2024-04-08)\n\n## v0.1.19 (2024-04-04)\n\n## v0.1.18 (2024-02-24)\n\n## v0.1.16 (2024-02-24)\n\n## v0.1.15 (2024-02-03)\n\n## v0.1.14 (2024-02-03)\n\n## v0.1.13 (2024-02-02)\n\n## v0.1.12 (2024-01-30)\n\n### Fix\n\n- set volume failed\n\n## v0.1.11 (2024-01-29)\n\n## v0.1.10 (2024-01-29)\n\n## v0.1.9 (2024-01-28)\n\n### Fix\n\n- arg1 漏修改\n\n## v0.1.8 (2024-01-28)\n\n### Fix\n\n- http server listen host\n\n## v0.1.7 (2024-01-28)\n\n## v0.1.6 (2024-01-28)\n\n## v0.1.5 (2024-01-27)\n\n## v0.1.4 (2024-01-27)\n\n### Fix\n\n- error when play next\n\n## v0.1.3 (2023-10-15)\n\n## v0.1.2 (2023-10-15)\n\n## v0.1.1 (2023-10-14)\n" }, { "path": "Dockerfile", "content": "# 定义构建参数，用于指定架构和基础镜像\nARG PYTHON_VERSION=3.14\n\n# 根据不同架构选择对应的基础镜像\nFROM python:${PYTHON_VERSION}-alpine AS base-linux-amd64\nFROM python:${PYTHON_VERSION}-alpine AS base-linux-arm64\nFROM python:${PYTHON_VERSION}-bookworm AS base-linux-arm-v7\n\nFROM python:${PYTHON_VERSION}-alpine AS run-linux-amd64\nFROM python:${PYTHON_VERSION}-alpine AS run-linux-arm64\nFROM python:${PYTHON_VERSION}-bookworm AS run-linux-arm-v7\n\nFROM --platform=$BUILDPLATFORM alpine AS shelf\n# 这里的逻辑是关键：接收标准的 TARGETPLATFORM (如 linux/amd64)\n# 并将其转换为我们定义的别名格式 (如 linux-amd64)\nARG TARGETPLATFORM\nRUN echo ${TARGETPLATFORM//\\//-} > /platform_id\n\n# 根据TARGETPLATFORM自动选择对应的builder阶段\nARG TARGETPLATFORM\nFROM base-${TARGETPLATFORM//\\//-} AS builder\n\n# 安装构建依赖（根据基础镜像类型区分）\nRUN if [ -f /etc/alpine-release ]; then \\\n # Alpine系统依赖\n apk add --no-cache \\\n build-base \\\n nodejs \\\n npm \\\n zlib-dev \\\n jpeg-dev \\\n freetype-dev \\\n lcms2-dev \\\n openjpeg-dev \\\n tiff-dev \\\n libwebp-dev; \\\n else \\\n # Debian系统依赖\n apt-get update && apt-get install -y --no-install-recommends \\\n build-essential \\\n nodejs \\\n npm \\\n zlib1g-dev \\\n libjpeg-dev \\\n libfreetype6-dev \\\n liblcms2-dev \\\n libopenjp2-7-dev \\\n libtiff5-dev \\\n libwebp-dev \\\n && rm -rf /var/lib/apt/lists/*; \\\n fi\n\n# 安装PDM\nRUN pip install -U pdm\nENV PDM_CHECK_UPDATE=false\n\nWORKDIR /app\nCOPY pyproject.toml README.md package.json ./\n\n# 安装Python和Node.js依赖\nRUN pdm install --prod --no-editable -v\nRUN npm install --loglevel=verbose\n\n# 复制应用代码\nCOPY xiaomusic/ ./xiaomusic/\nCOPY plugins/ ./plugins/\nCOPY holiday/ ./holiday/\nCOPY xiaomusic.py .\n\n# -------------------------- 运行阶段 --------------------------\n# 根据TARGETPLATFORM自动选择对应的runner阶段\nARG TARGETPLATFORM\nFROM run-${TARGETPLATFORM//\\//-} AS runner\n\n# 安装运行时依赖（区分Alpine和Debian）\nRUN if [ -f /etc/alpine-release ]; then \\\n # Alpine运行时依赖\n apk add --no-cache \\\n ffmpeg \\\n nodejs \\\n npm; \\\n else \\\n # Debian运行时依赖\n apt-get update && apt-get install -y --no-install-recommends \\\n ffmpeg \\\n nodejs \\\n npm \\\n && rm -rf /var/lib/apt/lists/*; \\\n fi\n\n# 设置工作目录\nWORKDIR /app\n\n# 从构建阶段复制产物\nCOPY --from=builder /app/.venv ./.venv\nCOPY --from=builder /app/node_modules ./node_modules/\nCOPY --from=builder /app/xiaomusic/ ./xiaomusic/\nCOPY --from=builder /app/plugins/ ./plugins/\nCOPY --from=builder /app/holiday/ ./holiday/\nCOPY --from=builder /app/xiaomusic.py .\nCOPY --from=builder /app/xiaomusic/__init__.py /base_version.py\nCOPY --from=builder /app/package.json .\n\n# 创建FFmpeg软链接目录（兼容不同系统的ffmpeg路径）\nRUN mkdir -p /app/ffmpeg/bin \\\n && ln -s $(which ffmpeg) /app/ffmpeg/bin/ffmpeg \\\n && ln -s $(which ffprobe) /app/ffmpeg/bin/ffprobe\n\nRUN touch /app/.dockerenv\n\n# 设置卷和暴露端口\nVOLUME /app/conf\nVOLUME /app/music\nEXPOSE 8090\n\n# 设置环境变量\nENV TZ=Asia/Shanghai\nENV PATH=/app/.venv/bin:/usr/local/bin:$PATH\n\n# 直接启动xiaomusic应用\nCMD [\"/app/.venv/bin/python3\", \"/app/xiaomusic.py\"]\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2023 涵曦\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# XiaoMusic: 无限听歌，解放小爱音箱\n\n[![GitHub License](https://img.shields.io/github/license/hanxi/xiaomusic)](https://github.com/hanxi/xiaomusic)\n[![Docker Image Version](https://img.shields.io/docker/v/hanxi/xiaomusic?sort=semver&label=docker%20image)](https://hub.docker.com/r/hanxi/xiaomusic)\n[![Docker Pulls](https://img.shields.io/docker/pulls/hanxi/xiaomusic)](https://hub.docker.com/r/hanxi/xiaomusic)\n[![PyPI - Version](https://img.shields.io/pypi/v/xiaomusic)](https://pypi.org/project/xiaomusic/)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/xiaomusic)](https://pypi.org/project/xiaomusic/)\n[![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fhanxi%2Fxiaomusic%2Fmain%2Fpyproject.toml)](https://pypi.org/project/xiaomusic/)\n[![GitHub Release](https://img.shields.io/github/v/release/hanxi/xiaomusic)](https://github.com/hanxi/xiaomusic/releases)\n[![Visitors](https://api.visitorbadge.io/api/daily?path=hanxi%2Fxiaomusic&label=daily%20visitor&countColor=%232ccce4&style=flat)](https://visitorbadge.io/status?path=hanxi%2Fxiaomusic)\n[![Visitors](https://api.visitorbadge.io/api/visitors?path=hanxi%2Fxiaomusic&label=total%20visitor&countColor=%232ccce4&style=flat)](https://visitorbadge.io/status?path=hanxi%2Fxiaomusic)\n\n---\n\n

\n 🎵 使用小爱音箱播放音乐，音乐使用 yt-dlp 下载\n

\n\n

\n 🏠 GitHub •\n 📖 文档 •\n 💬 FAQ •\n 💭 讨论区\n

\n\n---\n\n> [!TIP]\n> **新手指南**：初次安装遇到问题请查阅 [💬 FAQ问题集合](https://github.com/hanxi/xiaomusic/issues/99)，一般遇到的问题都已经有解决办法。\n\n## 👋 快速入门指南\n\n已经支持在 web 设置页面配置其他参数，不再需要设置环境变量， docker compose 配置如下（选一个即可）：\n\n```yaml\nservices:\n xiaomusic:\n image: hanxi/xiaomusic\n container_name: xiaomusic\n restart: always\n ports:\n - 58090:8090\n volumes:\n - /xiaomusic_music:/app/music\n - /xiaomusic_conf:/app/conf\n```\n\n🔥 国内：\n\n```yaml\nservices:\n xiaomusic:\n image: docker.hanxi.cc/hanxi/xiaomusic\n container_name: xiaomusic\n restart: always\n ports:\n - 58090:8090\n volumes:\n - /xiaomusic_music:/app/music\n - /xiaomusic_conf:/app/conf\n```\n\n测试版：\n\n```yaml\nservices:\n xiaomusic:\n image: hanxi/xiaomusic:main\n container_name: xiaomusic\n restart: always\n ports:\n - 58090:8090\n volumes:\n - /xiaomusic_music:/app/music\n - /xiaomusic_conf:/app/conf\n```\n\n对应的 docker 启动命令如下:\n\n```bash\ndocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic\n```\n\n🔥 国内：\n\n```bash\ndocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf docker.hanxi.cc/hanxi/xiaomusic\n```\n\n测试版：\n\n```\ndocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic:main\n```\n\n- 其中 conf 目录为配置文件存放目录，music 目录为音乐存放目录，建议分开配置为不同的目录。\n- /xiaomusic_music 和 /xiaomusic_conf 是 docker 所在的主机的目录，可以修改为其他目录。如果报错找不到 /xiaomusic_music 目录，可以先执行 `mkdir -p /xiaomusic_{music,conf}` 命令新建目录。\n- /app/music 和 /app/conf 是 docker 容器里的目录，不要去修改。\n- 58090 是 NAS 本地端口的。8090 是容器端口，不要去修改。\n- 后台访问地址为： http://NAS_IP:58090\n\n> [!NOTE]\n> docker 和 docker compose 二选一即可，启动成功后，在 web 页面可以配置其他参数，带有 `*` 号的配置是必须要配置的，其他的用不上时不用修改。初次配置时需要在页面上输入小米账号和密码保存后才能获取到设备列表。\n\n> [!TIP]\n> 目前安装步骤已经是最简化了，如果还是嫌安装麻烦，可以微信或者 QQ 约我远程安装，我一般周末和晚上才有时间，需要赞助个辛苦费 :moneybag: 50 元一次。\n\n遇到问题可以去 web 设置页面底部点击【下载日志文件】按钮，然后搜索一下日志文件内容确保里面没有账号密码信息后(有就删除这些敏感信息)，然后在提 issues 反馈问题时把下载的日志文件带上。\n\n> [!TIP]\n> 作者新写了一个更简洁的个人音乐服务器，支持更强的插件扩展 \n\n> [!TIP]\n> 作者写的一个游戏服务器开发实战课程 ，购买时记得使用优惠码: `2CZ2UA5u` 。\n\n> [!TIP]\n> - 适用于 NAS 上安装的开源工具： \n> - 适用于 NAS 上安装的网页打印机： \n> - PVE 移动端 UI 界面：\n> - 喜欢听书的可以配合这个工具使用 \n\n> [!TIP]\n>\n> - 🔥【广告:可用于安装 frp 实现内网穿透】\n> - 🔥 海外 RackNerd VPS 机器推荐，可支付宝付款。\n> - \"RackNerd\n> - 不知道选哪个套餐可以直接买这个最便宜的 \n> - 也可以用来部署代理，docker 部署方法见 \n\n> [!TIP]\n>\n> - 🔥【广告: 搭建您的专属大模型主页\n告别繁琐配置难题，一键即可畅享稳定流畅的AI体验！】\n\n> [!TIP]\n> - 免费主机\n> - \"Powered\n\n\n## 🎤 功能特性\n\n### 🤐 支持语音口令\n\n#### 基础播放控制\n- **播放歌曲** - 播放本地的歌曲\n- **播放歌曲+歌名** - 例如：播放歌曲周杰伦晴天\n- **上一首** / **下一首** - 切换歌曲\n- **关机** / **停止播放** - 停止播放\n\n#### 播放模式\n- **单曲循环** - 重复播放当前歌曲\n- **全部循环** - 循环播放所有歌曲\n- **随机播放** - 随机顺序播放\n\n#### 歌单管理\n- **播放歌单+目录名** - 例如：播放歌单其他\n- **播放歌单第几个+列表名** - 详见 [#158](https://github.com/hanxi/xiaomusic/issues/158)\n- **播放歌单收藏** - 播放收藏歌单\n\n#### 收藏功能\n- **加入收藏** - 将当前播放的歌曲加入收藏歌单\n- **取消收藏** - 将当前播放的歌曲从收藏歌单移除\n\n> [!TIP]\n> **隐藏玩法**：对小爱同学说\"播放歌曲小猪佩奇的故事\"，会先下载小猪佩奇的故事，然后再播放。\n\n## 📦 安装方式\n\n### 方式一：Docker Compose（推荐）\n\n详见 [👋 快速入门指南](#-快速入门指南)\n\n### 方式二：Pip 安装\n\n```shell\n# 安装\npip install -U xiaomusic\n\n# 查看帮助\nxiaomusic --help\n\n# 启动（使用配置文件）\nxiaomusic --config config.json\n\n# 启动（使用默认端口 8090）\nxiaomusic\n```\n\n> [!NOTE]\n> `config.json` 文件可以参考 `config-example.json` 文件配置。详见 [#94](https://github.com/hanxi/xiaomusic/issues/94)\n\n## 👨‍💻 开发指南\n\n### 🔩 开发环境运行\n\n1. **下载依赖**\n ```shell\n ./install_dependencies.sh\n ```\n\n2. **安装环境**\n ```shell\n pdm install\n ```\n\n3. **启动服务**\n ```shell\n pdm run xiaomusic.py\n ```\n 默认监听端口 8090，使用其他端口请自行修改。\n\n4. **查看 API 文档**\n \n 访问 查看接口文档。\n\n> [!NOTE]\n> 目前的 web 控制台非常简陋，欢迎有兴趣的朋友帮忙实现一个漂亮的前端，需要什么接口可以随时提需求。\n\n### 🚦 代码提交规范\n\n提交前请执行以下命令检查代码和格式化代码：\n\n```shell\npdm lintfmt\n```\n\n### 🐳 本地编译 Docker Image\n\n```shell\ndocker build -t xiaomusic .\n```\n\n### 🛠️ 技术栈\n\n- **后端**：Python + FastAPI 框架\n- **容器化**：Docker\n- **前端**：jQuery\n\n## 📱 设备支持\n\n### 已测试支持的设备\n\n| 型号 | 设备名称 |\n|------|---------|\n| **L06A** | [小爱音箱](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l06a) |\n| **L07A** | [Redmi小爱音箱 Play](https://home.mi.com/webapp/content/baike/product/index.html?model=xiaomi.wifispeaker.l7a) |\n| **S12/S12A/MDZ-25-DA** | [小米AI音箱](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.s12) |\n| **LX5A** | [小爱音箱 万能遥控版](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx5a) |\n| **LX05** | [小爱音箱Play（2019款）](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx05) |\n| **L15A** | [小米AI音箱（第二代）](https://home.mi.com/webapp/content/baike/product/index.html?model=xiaomi.wifispeaker.l15a#/) |\n| **L16A** | [Xiaomi Sound](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l16a) |\n| **L17A** | [Xiaomi Sound Pro](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l17a) |\n| **LX06** | [小爱音箱Pro](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx06) |\n| **LX01** | [小爱音箱mini](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx01) |\n| **L05B** | [小爱音箱Play](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l05b) |\n| **L05C** | [小米小爱音箱Play 增强版](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l05c) |\n| **L09A** | [小米音箱Art](https://home.mi.com/webapp/content/baike/product/index.html?model=xiaomi.wifispeaker.l09a) |\n| **LX04/X10A/X08A** | 触屏版音箱 |\n| **X08C/X08E/X8F** | 触屏版音箱 |\n| **M01/XMYX01JY** | 小米小爱音箱HD |\n| **OH2P** | XIAOMI 智能音箱 Pro |\n| **OH2** | XIAOMI 智能音箱 |\n\n> [!NOTE]\n> - 型号与产品名称对照可在 [小米IoT平台](https://home.miot-spec.com/s/xiaomi.wifispeaker) 查询\n> - 如果你的设备支持播放，请反馈给我添加到支持列表里，谢谢\n> - 目前应该所有设备类型都已经支持播放，有问题可随时反馈\n\n### 🎵 支持音乐格式\n\n- **mp3** - 标准音频格式\n- **flac** - 无损音频格式\n- **wav** - 无损音频格式\n- **ape** - 无损音频格式\n- **ogg** - 开源音频格式\n- **m4a** - AAC 音频格式\n\n> [!NOTE]\n> - 本地音乐会搜索目录下上面格式的文件，下载的歌曲是 mp3 格式\n> - 已知 L05B、L05C、LX06、L16A 不支持 flac 格式\n> - 如果格式不能播放可以打开【转换为MP3】和【型号兼容模式】选项，详见 [#153](https://github.com/hanxi/xiaomusic/issues/153#issuecomment-2328168689)\n\n## 🌏 网络歌单功能\n\n可以配置一个 json 格式的歌单，支持电台和歌曲，也可以直接用别人分享的链接。同时配备了 m3u 文件格式转换工具，可以很方便地把 m3u 电台文件转换成网络歌单格式的 json 文件。\n\n详细用法见 [#78](https://github.com/hanxi/xiaomusic/issues/78)\n\n> [!NOTE]\n> 欢迎有想法的朋友们制作更多的歌单转换工具，一起完善项目功能！\n\n## ⚠️ 安全提醒\n\n> [!IMPORTANT]\n>\n> 1. 如果配置了公网访问 xiaomusic ，请一定要开启密码登陆，并设置复杂的密码。且不要在公共场所的 WiFi 环境下使用，否则可能造成小米账号密码泄露。\n> 2. 强烈不建议将小爱音箱的小米账号绑定摄像头，代码难免会有 bug ，一旦小米账号密码泄露，可能监控录像也会泄露。\n\n## 💬 社区与支持\n\n### 📢 讨论区\n\n

\n 💬 GitHub Issues •\n 🎮 QQ频道 •\n 👥 QQ交流群 •\n 💬 微信群\n

\n\n### 🤝 如何贡献\n\n我们欢迎所有形式的贡献，包括但不限于：\n\n- 🐛 **报告 Bug**：在 [Issues](https://github.com/hanxi/xiaomusic/issues) 中提交问题\n- 💡 **功能建议**：分享你的想法和建议\n- 📝 **改进文档**：帮助完善文档和教程\n- 🎨 **前端美化**：优化 Web 控制台界面\n- 🔧 **代码贡献**：提交 Pull Request\n\n> [!TIP]\n> 提交代码前请确保运行 `pdm lintfmt` 检查代码规范\n\n## 📚 相关资源\n\n### 👉 更多教程\n\n更多功能见 [📝 文档汇总](https://github.com/hanxi/xiaomusic/issues/211)\n\n### 🎨 第三方主题\n\n- [pure 主题 xiaomusicUI](https://github.com/52fisher/xiaomusicUI)\n- [移动端的播放器主题](https://github.com/52fisher/XMusicPlayer)\n- [Tailwind主题](https://github.com/clarencejh/xiaomusic)\n- [SoundScape主题](https://github.com/jhao0413/SoundScape)\n- [第三方主题](https://github.com/DarrenWen/xiaomusicui)\n\n### 📱 配套应用\n\n- [微信小程序: 卯卯音乐](https://github.com/F-loat/xiaoplayer)\n- [手机APP: 风花雪乐](https://github.com/jokezc/mi_music)\n- [JS在线播放插件](https://github.com/boluofan/xiaomusic-online)\n- [手机APP: HMusic](https://github.com/hpcll/HMusic)\n- [安卓TV: 肉肉音乐TV](https://github.com/GanHuaLin/rouroumusic-tv)\n\n### ❤️ 致谢\n\n**核心依赖**\n- [xiaomi](https://www.mi.com/) - 小米智能设备\n- [xiaogpt](https://github.com/yihong0618/xiaogpt) - 项目灵感来源\n- [MiService](https://github.com/yihong0618/MiService) - 小米服务接口\n- [yt-dlp](https://github.com/yt-dlp/yt-dlp) - 音乐下载工具\n\n**开发工具**\n- [PDM](https://pdm.fming.dev/latest/) - Python 包管理\n- [FastAPI](https://fastapi.tiangolo.com/) - Web 框架\n- [Umami](https://github.com/umami-software/umami) - 统计分析\n- [Sentry](https://github.com/getsentry/sentry) - 报错监控\n\n**参考资料**\n- [实现原理](https://github.com/yihong0618/gitblog/issues/258)\n- [awesome-xiaoai](https://github.com/zzz6519003/awesome-xiaoai)\n\n**特别感谢**\n- 所有帮忙调试和测试的朋友\n- 所有反馈问题和建议的朋友\n- 所有贡献代码和文档的开发者\n\n## 🚨 免责声明\n\n本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。\n本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。\n作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。\n使用本项目即表示您已阅读并同意本免责声明的全部内容。\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=hanxi/xiaomusic&type=Date)](https://star-history.com/#hanxi/xiaomusic&Date)\n\n## 💖 支持项目\n\n如果这个项目对你有帮助，欢迎通过以下方式支持：\n\n### ⭐ Star 项目\n点击右上角的 ⭐ Star 按钮，让更多人发现这个项目\n\n### 💰 赞赏支持\n- [💝 爱发电](https://afdian.com/a/imhanxi) - 持续支持项目发展\n- 扫码请作者喝杯奶茶 ☕\n\n

\n \"赞赏码\"\n

\n\n### 🎁 其他支持方式\n- 分享给更多需要的朋友\n- 提交 Bug 报告和功能建议\n- 贡献代码和文档\n\n---\n\n

\n 感谢你的支持！❤️\n

\n\n## License\n\n[MIT](https://github.com/hanxi/xiaomusic/blob/main/LICENSE) License © 2024 涵曦\n" }, { "path": "check_plugins.py", "content": "#!/usr/bin/env python3\n\"\"\"\n检查所有插件的加载状态\n\"\"\"\n\nimport sys\n\nsys.path.append(\".\")\n\nfrom xiaomusic.config import Config\nfrom xiaomusic.js_plugin_manager import JSPluginManager\n\n\ndef check_all_plugins():\n print(\"=== 检查所有插件加载状态 ===\\n\")\n\n config = Config()\n config.verbose = True\n\n class SimpleLogger:\n def info(self, msg):\n print(f\"[INFO] {msg}\")\n\n def error(self, msg):\n print(f\"[ERROR] {msg}\")\n\n def debug(self, msg):\n print(f\"[DEBUG] {msg}\")\n\n print(\"1. 创建插件管理器...\")\n manager = JSPluginManager(None)\n manager.config = config\n manager.log = SimpleLogger()\n\n import time\n\n time.sleep(3) # 等待插件加载\n\n print(\"\\n2. 获取所有插件状态...\")\n plugins = manager.refresh_plugin_list()\n print(f\" 总共找到 {len(plugins)} 个插件\")\n\n # 分类插件状态\n working_plugins = []\n failed_plugins = []\n\n for plugin in plugins:\n if plugin.get(\"loaded\", False) and plugin.get(\"enabled\", False):\n working_plugins.append(plugin)\n else:\n failed_plugins.append(plugin)\n\n print(f\"\\n 正常工作的插件 ({len(working_plugins)} 个):\")\n for plugin in working_plugins:\n print(f\" ✓ {plugin['name']}\")\n\n print(f\"\\n 失败的插件 ({len(failed_plugins)} 个):\")\n for plugin in failed_plugins:\n print(f\" ✗ {plugin['name']}: {plugin.get('error', 'Unknown error')}\")\n\n # 清理\n if hasattr(manager, \"node_process\") and manager.node_process:\n manager.node_process.terminate()\n\n\nif __name__ == \"__main__\":\n check_all_plugins()\n" }, { "path": "config-example.json", "content": "{\n \"account\": \"\",\n \"password\": \"\",\n \"mi_did\": \"\",\n \"cookie\": \"\",\n \"verbose\": false,\n \"music_path\": \"music\",\n \"temp_path\": \"music/tmp\",\n \"download_path\": \"music/download\",\n \"conf_path\": \"conf\",\n \"cache_dir\": \"music/cache\",\n \"hostname\": \"http://192.168.2.5\",\n \"port\": 8090,\n \"public_port\": 58090,\n \"proxy\": null,\n \"loudnorm\": null,\n \"search_prefix\": \"bilisearch:\",\n \"ffmpeg_location\": \"./ffmpeg/bin\",\n \"get_duration_type\": \"ffprobe\",\n \"active_cmd\": \"play,set_play_type_rnd,playlocal,play_music_list,play_music_list_index,stop_after_minute,stop,play_next,play_prev,set_play_type_one,set_play_type_all,set_play_type_sin,set_play_type_seq,gen_music_list,add_to_favorites,del_from_favorites,cmd_del_music,online_play,singer_play\",\n \"exclude_dirs\": \"@eaDir,tmp\",\n \"ignore_tag_dirs\": \"\",\n \"music_path_depth\": 10,\n \"disable_httpauth\": true,\n \"httpauth_username\": \"\",\n \"httpauth_password\": \"\",\n \"music_list_url\": \"\",\n \"music_list_json\": \"\",\n \"custom_play_list_json\": \"\",\n \"disable_download\": false,\n \"key_word_dict\": {\n \"下一首\": \"play_next\",\n \"上一首\": \"play_prev\",\n \"单曲循环\": \"set_play_type_one\",\n \"全部循环\": \"set_play_type_all\",\n \"随机播放\": \"set_play_type_rnd\",\n \"单曲播放\": \"set_play_type_sin\",\n \"顺序播放\": \"set_play_type_seq\",\n \"分钟后关机\": \"stop_after_minute\",\n \"刷新列表\": \"gen_music_list\",\n \"加入收藏\": \"add_to_favorites\",\n \"收藏歌曲\": \"add_to_favorites\",\n \"取消收藏\": \"del_from_favorites\",\n \"播放列表第\": \"play_music_list_index\",\n \"删除歌曲\": \"cmd_del_music\",\n \"播放本地歌曲\": \"playlocal\",\n \"本地播放歌曲\": \"playlocal\",\n \"播放歌曲\": \"play\",\n \"放歌曲\": \"play\",\n \"在线播放\": \"online_play\",\n \"播放歌手\": \"singer_play\",\n \"关机\": \"stop\",\n \"暂停\": \"stop\",\n \"停止\": \"stop\",\n \"停止播放\": \"stop\",\n \"播放列表\": \"play_music_list\",\n \"播放歌单\": \"play_music_list\",\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\n },\n \"key_match_order\": [\n \"分钟后关机\",\n \"下一首\",\n \"上一首\",\n \"单曲循环\",\n \"全部循环\",\n \"随机播放\",\n \"单曲播放\",\n \"顺序播放\",\n \"关机\",\n \"刷新列表\",\n \"播放列表第\",\n \"播放列表\",\n \"加入收藏\",\n \"收藏歌曲\",\n \"取消收藏\",\n \"删除歌曲\",\n \"播放本地歌曲\",\n \"本地播放歌曲\",\n \"播放歌曲\",\n \"放歌曲\",\n \"在线播放\",\n \"播放歌手\",\n \"暂停\",\n \"停止\",\n \"停止播放\",\n \"播放歌单\",\n \"测试自定义口令\",\n \"测试链接\"\n ],\n \"use_music_api\": false,\n \"use_music_audio_id\": \"1582971365183456177\",\n \"use_music_id\": \"355454500\",\n \"log_file\": \"xiaomusic.log.txt\",\n \"fuzzy_match_cutoff\": 0.6,\n \"enable_fuzzy_match\": true,\n \"stop_tts_msg\": \"收到,再见\",\n \"enable_config_example\": true,\n \"keywords_playlocal\": \"播放本地歌曲,本地播放歌曲\",\n \"keywords_play\": \"播放歌曲,放歌曲\",\n \"keywords_online_play\": \"在线播放\",\n \"keywords_singer_play\": \"播放歌手\",\n \"keywords_stop\": \"关机,暂停,停止,停止播放\",\n \"keywords_playlist\": \"播放列表,播放歌单\",\n \"user_key_word_dict\": {\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\n },\n \"enable_force_stop\": false,\n \"devices\": {},\n \"group_list\": \"\",\n \"remove_id3tag\": false,\n \"convert_to_mp3\": false,\n \"delay_sec\": 0,\n \"continue_play\": false,\n \"enable_file_watch\": false,\n \"file_watch_debounce\": 10,\n \"pull_ask_sec\": 1,\n \"enable_pull_ask\": false,\n \"crontab_json\": \"\",\n \"enable_yt_dlp_cookies\": false,\n \"enable_save_tag\": false,\n \"enable_analytics\": true,\n \"get_ask_by_mina\": false,\n \"play_type_one_tts_msg\": \"已经设置为单曲循环\",\n \"play_type_all_tts_msg\": \"已经设置为全部循环\",\n \"play_type_rnd_tts_msg\": \"已经设置为随机播放\",\n \"play_type_sin_tts_msg\": \"已经设置为单曲播放\",\n \"play_type_seq_tts_msg\": \"已经设置为顺序播放\",\n \"recently_added_playlist_len\": 50,\n \"enable_cmd_del_music\": false,\n \"web_music_proxy\": true,\n \"edge_tts_voice\": \"zh-CN-XiaoyiNeural\",\n \"enable_auto_clean_temp\": true\n}" }, { "path": "docs/.vitepress/config.mts", "content": "import { loadEnv, defineConfig } from 'vitepress'\nimport AutoSidebar from 'vite-plugin-vitepress-auto-sidebar';\nimport GitHubIssuesPlugin from './vitepress-plugin-github-issues.mts';\n\nexport default async ({ mode }) => {\n const env = loadEnv(mode || '', process.cwd())\n return defineConfig({\n title: \"XiaoMusic\",\n description: \"XiaoMusic doc\",\n themeConfig: {\n // https://vitepress.dev/reference/default-theme-config\n nav: [\n { text: 'Guide', link: '/issues' },\n { text: 'Admin', link: 'https://x.hanxi.cc' },\n ],\n\n socialLinks: [\n { icon: 'github', link: 'https://github.com/hanxi/xiaomusic' }\n ],\n\n footer: {\n message: '基于 MIT 许可发布',\n copyright: `版权所有 © 2023-${new Date().getFullYear()} 涵曦`\n },\n },\n sitemap: {\n hostname: 'https://xdocs.hanxi.cc'\n },\n head: [\n ['script', { defer: true, src: 'https://umami.hanxi.cc/script.js', 'data-website-id': '29cca3f5-e420-432b-adc7-8a1325d31c68' }]\n ],\n lastUpdated: true,\n markdown: {\n lineNumbers: false, // 关闭代码块行号显示\n // 自定义 markdown-it 插件\n config: (md) => {\n md.renderer.rules.link_open = (tokens, idx, options, env, self) => {\n const aIndex = tokens[idx].attrIndex('target');\n if (aIndex < 0) {\n tokens[idx].attrPush(['target', '_self']); // 将默认行为改为不使用 _blank\n } else {\n tokens[idx].attrs![aIndex][1] = '_self'; // 替换 _blank 为 _self\n }\n return self.renderToken(tokens, idx, options);\n };\n },\n },\n logLevel: 'warn',\n vite: {\n plugins: [\n AutoSidebar({\n path: '.',\n collapsed: true,\n titleFromFile: true,\n }),\n GitHubIssuesPlugin({\n repo: 'hanxi/xiaomusic',\n token: env.VITE_GITHUB_ISSUES_TOKEN,\n replaceRules: [\n {\n baseUrl: 'https://github.com/hanxi/xiaomusic/issues',\n targetUrl: '/issues',\n },\n ],\n githubProxy: 'https://gproxy.hanxi.cc/proxy',\n }),\n ],\n }\n })\n}\n" }, { "path": "docs/.vitepress/vitepress-plugin-github-issues.mts", "content": "import axios from 'axios';\nimport fs from 'fs';\nimport path from 'path';\nimport type { Plugin } from 'vitepress';\n\ninterface ReplaceRule {\n baseUrl: string;\n targetUrl: string;\n}\n\ninterface GitHubIssuesPluginOptions {\n repo: string;\n token: string;\n replaceRules: ReplaceRule[];\n githubProxy: string;\n}\n\n// 增强超时 + 重试\naxios.defaults.timeout = 15000;\n\nasync function fetchAllIssues(repo: string, token: string): Promise {\n const maxRetries = 5;\n let attempt = 0;\n const allIssues: any[] = [];\n let page = 1;\n\n while (true) {\n try {\n const response = await axios.get(`https://api.github.com/repos/${repo}/issues`, {\n headers: { Authorization: `token ${token}` },\n params: { page, per_page: 100 },\n });\n\n if (response.data.length === 0) break;\n allIssues.push(...response.data);\n page++;\n attempt = 0;\n } catch (error: any) {\n attempt++;\n console.error(`[Issue 获取失败] page ${page}, 重试 ${attempt}/${maxRetries}`);\n if (attempt >= maxRetries) {\n console.error(`❌ 终止获取 Issue，已获取数量：${allIssues.length}`);\n break;\n }\n await new Promise(r => setTimeout(r, 3000 * attempt));\n }\n }\n return allIssues;\n}\n\nasync function fetchIssueComments(repo: string, issueNumber: number, token: string): Promise {\n const maxRetries = 3;\n let attempt = 0;\n const allComments: any[] = [];\n let page = 1;\n\n while (attempt < maxRetries) {\n try {\n const res = await axios.get(\n `https://api.github.com/repos/${repo}/issues/${issueNumber}/comments`,\n {\n headers: { Authorization: `token ${token}` },\n params: { page, per_page: 100 },\n }\n );\n if (res.data.length === 0) break;\n allComments.push(...res.data);\n page++;\n } catch (err) {\n attempt++;\n if (attempt >= maxRetries) break;\n await new Promise(r => setTimeout(r, 2000));\n }\n }\n return allComments;\n}\n\nfunction clearDirectory(dir: string) {\n if (fs.existsSync(dir)) {\n fs.readdirSync(dir).forEach(file => {\n const p = path.join(dir, file);\n fs.lstatSync(p).isDirectory() ? clearDirectory(p) : fs.unlinkSync(p);\n });\n }\n}\n\nfunction copyFile(src: string, dest: string) {\n if (fs.existsSync(src)) fs.copyFileSync(src, dest);\n}\n\nfunction prependToFile(file: string, text: string) {\n if (!fs.existsSync(file)) return;\n const c = fs.readFileSync(file, 'utf8');\n fs.writeFileSync(file, `${text}\\n\\n${c}`);\n}\n\nfunction replaceGithubAssetUrls(content: string, proxy: string): string {\n return content\n .replace(/https:\\/\\/github\\.com\\/[^\\/]+\\/[^\\/]+\\/assets\\/[\\w-]+/g, m => m.replace('https://github.com', proxy))\n .replace(/https:\\/\\/github\\.com\\/user-attachments\\/assets\\/[\\w-]+/g, m => m.replace('https://github.com', proxy));\n}\n\n// 核心修复：生成空文件占位，防止构建报错\nfunction ensureIssueFile(number: number, dir: string, htmlUrl: string) {\n const file = path.join(dir, `${number}.md`);\n if (fs.existsSync(file)) return;\n\n const content = `---\ntitle: Issue #${number} (加载失败)\n---\n# Issue #${number} 加载失败\n\n原因：GitHub API 请求失败 / 网络超时\n\n[前往查看](${htmlUrl})\n`;\n fs.writeFileSync(file, content, 'utf8');\n console.log(`⚠️ 自动生成占位文件：${file}`);\n}\n\nexport default function GitHubIssuesPlugin(options: GitHubIssuesPluginOptions): Plugin {\n const { repo, token, replaceRules, githubProxy } = options;\n\n return {\n name: 'vitepress-plugin-github-issues',\n\n async buildStart() {\n console.log('🚀 开始从 GitHub Issues 生成文档...');\n\n try {\n const issues = await fetchAllIssues(repo, token);\n console.log(`✅ 成功获取 Issue 数量：${issues.length}`);\n\n const issuesDir = path.join(process.cwd(), 'issues');\n clearDirectory(issuesDir);\n if (!fs.existsSync(issuesDir)) fs.mkdirSync(issuesDir);\n\n // 复制 README / CHANGELOG\n copyFile(path.join(process.cwd(), '../README.md'), path.join(issuesDir, 'index.md'));\n copyFile(path.join(process.cwd(), '../CHANGELOG.md'), path.join(issuesDir, 'changelog.md'));\n prependToFile(path.join(issuesDir, 'changelog.md'), '# 版本日志');\n\n // 遍历处理 Issue\n for (const issue of issues) {\n try {\n const hasDocLabel = issue.labels?.some(l => l.name === '文档');\n if (!hasDocLabel) continue;\n\n const comments = await fetchIssueComments(repo, issue.number, token);\n const title = issue.title.replace(/[\\/\\\\?%*:|\"<>]/g, '-');\n const fileName = `${issue.number}.md`;\n\n let content = `---\ntitle: ${issue.title}\n---\n# ${title}\n${issue.body || '无内容'}\n## 评论\n`;\n\n comments.forEach((c, i) => {\n content += `\\n### 评论 ${i + 1} - ${c.user.login}\\n${c.body}\\n---\\n`;\n });\n\n replaceRules.forEach(({ baseUrl, targetUrl }) => {\n const reg = new RegExp(`${baseUrl.replace(/[-/\\\\^$*+?.()|[\\]{}]/g, '\\\\$&')}(/\\\\d+)`, 'g');\n content = content.replace(reg, `${targetUrl}$1.html`);\n });\n\n content = replaceGithubAssetUrls(content, githubProxy);\n content += `\\n[Issue 链接](${issue.html_url})\\n`;\n\n fs.writeFileSync(path.join(issuesDir, fileName), content, 'utf8');\n console.log(`✅ 生成：${fileName}`);\n } catch (e) {\n console.error(`❌ 处理 Issue #${issue.number} 失败：`, e);\n ensureIssueFile(issue.number, issuesDir, issue.html_url); // 自动生成占位文件\n }\n }\n\n console.log('🎉 所有 Issue 文档生成完成（失败项已自动占位）');\n } catch (e) {\n console.error('💥 整体流程异常：', e);\n }\n },\n };\n}\n" }, { "path": "docs/CNAME", "content": "xdocs.hanxi.cc" }, { "path": "docs/index.md", "content": "---\n# https://vitepress.dev/reference/default-theme-home-page\nlayout: home\n\nhero:\n name: \"XiaoMusic\"\n text: \"无限听歌
解放小爱音箱\"\n tagline: 使用小爱音箱播放音乐，音乐使用 yt-dlp 下载\n actions:\n - theme: brand\n text: 快速开始\n link: /issues/index\n - theme: alt\n text: FAQ\n link: /issues/99\n - theme: alt\n text: GitHub\n link: https://github.com/hanxi/xiaomusic\n\nfeatures:\n - title: MIT 开源\n details: 完全开源，自主可控\n - title: 一键部署\n details: 支持 Docker 部署，兼容各大 NAS 平台\n - title: 口令自定义\n details: 可以完全自定义语音口令，可以写自己的插件\n---\n\n" }, { "path": "docs/issues/101.md", "content": "---\ntitle: 群晖docker安装 xiaomusic\n---\n# 群晖docker安装 xiaomusic\n由于现在群晖已经无法正常下载 docker 里的镜像了，绕了好多弯；现在用 ssh 服务命令拉取镜像来创建容器；\n\n## 1. ssh 输入账号密码进入群晖\n## 2. 输入 sudo -i 再次输入密码进入 root 权限\n## 3. 输入 docker search xiaomusic来查找到该镜像名；\n## 4. 然后输入 docker pull xiaomusic 试试是否能安装，如果不能；就得在命令前加个代理地址；下面列了一些代理地址可以一个个的试\n\n```\ndocker.fxxk.dedyn.iodocker.io\nregistry-docker-hub-latest-9vgc.onrender.com\ndocker.chenby.cn\ndockerproxy.com\nhub.uuuadc.top\ndocker.jsdelivr.fyi\ndocker.registry.cyou\ndockerhub.anzu.vip\n```\n\n我是用的最下面这个成功的\n\n```\ndocker pull dockerhub.anzu.vip/hanxi/xiaomusic:latest\n```\n\n## 5. 安装完成后就进入群晖 DOCKER 配置 xiaomusic\n\n\"image\"\n\n- MI_HARDWARE=型号 前面第4 步骤获取的\n- XIAOMUSIC_SEARCH=搜索方式，我填写的bilisearch: 意思是通过 bilibili 搜索\n- MI_DID=前面第4 步骤获取的\n- MI_USER=小米账号\n- MI_PASS=小米密码\n- XIAOMUSIC_FUZZY_MATCH_CUTOFF=模糊匹配，最小为 0.1 最大为 1，越小越模糊，越大越精准\n\n## 6. 配置端口\n\n\"image\n\n## 7. 映射路径\n\n\"image\n\n\n## 评论\n\n### 评论 1 - kiwi5656\nMI_DID=前面第4 步骤获取的，第4步骤在哪？\n---\n\n### 评论 2 - hanxi\n> MI_DID=前面第4 步骤获取的，第4步骤在哪？\r\n\r\n不用设置 MI_DID \n---\n\n### 评论 3 - hanxi\n国内 docker 镜像\r\n\r\n```\r\ndocker pull m.daocloud.io/docker.io/hanxi/xiaomusic:latest\r\ndocker tag m.daocloud.io/docker.io/hanxi/xiaomusic:latest hanxi/xiaomusic:latest\r\n```\n---\n\n### 评论 4 - SenyFish\n如果手头上有能科学上网的机器，直接把群辉的代理服务器IP填写成可以科学上网的机器IP+端口，翻墙软件打开允许局域网连接就可以\n---\n\n### 评论 5 - SmartElec\n文档中 `docker pull dockerhub.anzu.vip/xiaomusic:latest`这句命令写错了\n修改为\n```\ndocker pull dockerhub.anzu.vip/hanxi/xiaomusic:latest\n```\n---\n\n### 评论 6 - hanfz123\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/045ae64b-d8d8-4f1d-9ed1-412af011df0c)\n你好。为什么我这个地方的文字不是中文的?求解\n---\n\n### 评论 7 - hanxi\n@hanfz123 你是不是屏蔽了谷歌的某些域名？\n---\n\n### 评论 8 - hanfz123\n> [@hanfz123](https://github.com/hanfz123) 你是不是屏蔽了谷歌的某些域名？\n\n不确定，但是我访问谷歌啥的都正常啊\n---\n\n### 评论 9 - 22555642\n你好，我在群辉DOCKER上部署运行后，一直打不开设置页面，点开日志里面写的是这个，请问要怎么办呢？\n2025/07/18 17:15:55 | stdout | [2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n-- | -- | --\n2025/07/18 17:15:55 | stdout | [2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:55 | stdout | ==> /app/xiaomusic.log.txt <==\n2025/07/18 17:15:55 | stdout |  \n2025/07/18 17:15:55 | stderr | tail: /app/xiaomusic.log.txt has been replaced; following end of new file\n2025/07/18 17:15:52 | stdout | 2025-07-18 17:15:51,292 INFO spawned: 'xiaomusic' with pid 21\n2025/07/18 17:15:48 | stdout | 2025-07-18 17:15:47,284 WARN exited: xiaomusic (exit status 1; not expected)\n2025/07/18 17:15:48 | stdout | ==> /app/supervisord.log <==\n2025/07/18 17:15:48 | stdout |  \n2025/07/18 17:15:43 | stderr | tail: /app/xiaomusic.log.txt has been replaced; following end of new file\n2025/07/18 17:15:43 | stdout | [2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:43 | stdout | [2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:43 | stdout | ==> /app/xiaomusic.log.txt <==\n2025/07/18 17:15:43 | stdout |  \n2025/07/18 17:15:40 | stdout | 2025-07-18 17:15:39,479 INFO spawned: 'xiaomusic' with pid 18\n2025/07/18 17:15:37 | stdout | 2025-07-18 17:15:36,473 WARN exited: xiaomusic (exit status 1; not expected)\n2025/07/18 17:15:37 | stdout | ==> /app/supervisord.log <==\n2025/07/18 17:15:37 | stdout |  \n2025/07/18 17:15:33 | stdout | [2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:33 | stdout | [2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:33 | stdout | ==> /app/xiaomusic.log.txt <==\n---\n\n### 评论 10 - hanxi\n> 你好，我在群辉DOCKER上部署运行后，一直打不开设置页面，点开日志里面写的是这个，请问要怎么办呢？\n> \n> 2025/07/18 17:15:55\tstdout\t[2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n> 2025/07/18 17:15:55\tstdout\t[2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n> 2025/07/18 17:15:55\tstdout\t==> /app/xiaomusic.log.txt <==\n> 2025/07/18 17:15:55\tstdout\t \n> 2025/07/18 17:15:55\tstderr\ttail: /app/xiaomusic.log.txt has been replaced; following end of new file\n> 2025/07/18 17:15:52\tstdout\t2025-07-18 17:15:51,292 INFO spawned: 'xiaomusic' with pid 21\n> 2025/07/18 17:15:48\tstdout\t2025-07-18 17:15:47,284 WARN exited: xiaomusic (exit status 1; not expected)\n> 2025/07/18 17:15:48\tstdout\t==> /app/supervisord.log <==\n> 2025/07/18 17:15:48\tstdout\t \n> 2025/07/18 17:15:43\tstderr\ttail: /app/xiaomusic.log.txt has been replaced; following end of new file\n> 2025/07/18 17:15:43\tstdout\t[2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n> 2025/07/18 17:15:43\tstdout\t[2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n> 2025/07/18 17:15:43\tstdout\t==> /app/xiaomusic.log.txt <==\n> 2025/07/18 17:15:43\tstdout\t \n> 2025/07/18 17:15:40\tstdout\t2025-07-18 17:15:39,479 INFO spawned: 'xiaomusic' with pid 18\n> 2025/07/18 17:15:37\tstdout\t2025-07-18 17:15:36,473 WARN exited: xiaomusic (exit status 1; not expected)\n> 2025/07/18 17:15:37\tstdout\t==> /app/supervisord.log <==\n> 2025/07/18 17:15:37\tstdout\t \n> 2025/07/18 17:15:33\tstdout\t[2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n> 2025/07/18 17:15:33\tstdout\t[2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n> 2025/07/18 17:15:33\tstdout\t==> /app/xiaomusic.log.txt <==\n\n看不出来为啥\n---\n\n### 评论 11 - 22555642\n我把日志发给您，您可以帮我看看嘛？\r\n\r\n\r\n\r\n\r\n\r\n------------------ 原始邮件 ------------------\r\n发件人: \"hanxi/xiaomusic\" ***@***.***>;\r\n发送时间: 2025年7月19日(星期六) 凌晨1:31\r\n***@***.***>;\r\n***@***.******@***.***>;\r\n主题: Re: [hanxi/xiaomusic] 群晖docker安装 xiaomusic (Issue #101)\r\n\r\n\r\n\r\nhanxi left a comment (hanxi/xiaomusic#101)\r\n \r\n你好，我在群辉DOCKER上部署运行后，一直打不开设置页面，点开日志里面写的是这个，请问要怎么办呢？\r\n \r\n2025/07/18 17:15:55\tstdout\t[2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\r\n 2025/07/18 17:15:55\tstdout\t[2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\r\n 2025/07/18 17:15:55\tstdout\t==> /app/xiaomusic.log.txt <==\r\n 2025/07/18 17:15:55\tstdout\t \r\n 2025/07/18 17:15:55\tstderr\ttail: /app/xiaomusic.log.txt has been replaced; following end of new file\r\n 2025/07/18 17:15:52\tstdout\t2025-07-18 17:15:51,292 INFO spawned: 'xiaomusic' with pid 21\r\n 2025/07/18 17:15:48\tstdout\t2025-07-18 17:15:47,284 WARN exited: xiaomusic (exit status 1; not expected)\r\n 2025/07/18 17:15:48\tstdout\t==> /app/supervisord.log <==\r\n 2025/07/18 17:15:48\tstdout\t \r\n 2025/07/18 17:15:43\tstderr\ttail: /app/xiaomusic.log.txt has been replaced; following end of new file\r\n 2025/07/18 17:15:43\tstdout\t[2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\r\n 2025/07/18 17:15:43\tstdout\t[2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\r\n 2025/07/18 17:15:43\tstdout\t==> /app/xiaomusic.log.txt <==\r\n 2025/07/18 17:15:43\tstdout\t \r\n 2025/07/18 17:15:40\tstdout\t2025-07-18 17:15:39,479 INFO spawned: 'xiaomusic' with pid 18\r\n 2025/07/18 17:15:37\tstdout\t2025-07-18 17:15:36,473 WARN exited: xiaomusic (exit status 1; not expected)\r\n 2025/07/18 17:15:37\tstdout\t==> /app/supervisord.log <==\r\n 2025/07/18 17:15:37\tstdout\t \r\n 2025/07/18 17:15:33\tstdout\t[2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\r\n 2025/07/18 17:15:33\tstdout\t[2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\r\n 2025/07/18 17:15:33\tstdout\t==> /app/xiaomusic.log.txt <==\r\n \r\n看不出来为啥\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/101)\n" }, { "path": "docs/issues/105.md", "content": "---\ntitle: 【插件】自定义口令功能\n---\n# 【插件】自定义口令功能\n自定义口令配置需要配置到 config.json 文件里，使用 config.json 方式启动。参考 。\r\n\r\n口令的配置方式见 config-example.json 文件。口令对应的代码需要写到 `plugins/` 目录下面，如果是容器启动，则需要把这个目录挂载出来。\r\n\r\nconfig.json 格式是下面这样的。\r\n\r\n```json\r\n{\r\n \"hardware\": \"L07A\",\r\n \"account\": \"\",\r\n \"password\": \"\",\r\n \"mi_did\": \"\",\r\n \"cookie\": \"\",\r\n \"verbose\": false,\r\n \"music_path\": \"music\",\r\n \"conf_path\": null,\r\n \"hostname\": \"192.168.2.5\",\r\n \"port\": 8090,\r\n \"public_port\": 0,\r\n \"proxy\": null,\r\n \"search_prefix\": \"bilisearch:\",\r\n \"ffmpeg_location\": \"./ffmpeg/bin\",\r\n \"active_cmd\": \"play,random_play,playlocal,play_music_list,stop\",\r\n \"exclude_dirs\": \"@eaDir\",\r\n \"music_path_depth\": 10,\r\n \"disable_httpauth\": true,\r\n \"httpauth_username\": \"admin\",\r\n \"httpauth_password\": \"admin\",\r\n \"music_list_url\": \"\",\r\n \"music_list_json\": \"\",\r\n \"disable_download\": false,\r\n \"key_word_dict\": {\r\n \"播放歌曲\": \"play\",\r\n \"播放本地歌曲\": \"playlocal\",\r\n \"关机\": \"stop\",\r\n \"下一首\": \"play_next\",\r\n \"单曲循环\": \"set_play_type_one\",\r\n \"全部循环\": \"set_play_type_all\",\r\n \"随机播放\": \"random_play\",\r\n \"分钟后关机\": \"stop_after_minute\",\r\n \"播放列表\": \"play_music_list\",\r\n \"刷新列表\": \"gen_music_list\",\r\n \"set_volume#\": \"set_volume\",\r\n \"get_volume#\": \"get_volume\",\r\n \"本地播放歌曲\": \"playlocal\",\r\n \"放歌曲\": \"play\",\r\n \"暂停\": \"stop\",\r\n \"停止\": \"stop\",\r\n \"停止播放\": \"stop\",\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\r\n },\r\n \"key_match_order\": [\r\n \"set_volume#\",\r\n \"get_volume#\",\r\n \"分钟后关机\",\r\n \"播放歌曲\",\r\n \"下一首\",\r\n \"单曲循环\",\r\n \"全部循环\",\r\n \"随机播放\",\r\n \"关机\",\r\n \"刷新列表\",\r\n \"播放列表\",\r\n \"播放本地歌曲\",\r\n \"本地播放歌曲\",\r\n \"放歌曲\",\r\n \"暂停\",\r\n \"停止\",\r\n \"停止播放\",\r\n \"测试自定义口令\",\r\n \"测试链接\"\r\n ],\r\n \"use_music_api\": false,\r\n \"use_music_audio_id\": \"1582971365183456177\",\r\n \"use_music_id\": \"355454500\",\r\n \"log_file\": \"/tmp/xiaomusic.txt\",\r\n \"fuzzy_match_cutoff\": 0.6,\r\n \"enable_fuzzy_match\": true,\r\n \"stop_tts_msg\": \"收到,再见\",\r\n \"keywords_playlocal\": \"播放本地歌曲,本地播放歌曲\",\r\n \"keywords_play\": \"播放歌曲,放歌曲\",\r\n \"keywords_stop\": \"关机,暂停,停止,停止播放\",\r\n \"user_key_word_dict\": {\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\r\n }\r\n}\r\n```\r\n\r\n配置自定义口令时，只需要配置 user_key_word_dict 即可，会自动插入到 key_word_dict 里的。配置格式是：\r\n\r\n```\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n```\r\n\r\n其中 \"测试自定义口令\" 就是对小爱音箱说的，`\"exec#code1(\\\"hello\\\")\"` 就是要执行的插件代码，代码以 `exec#` 开头，后面紧跟着执行代码。这里 code1 是一个插件函数，插件函数需要在 plugin 目录里实现，一个文件只会导出一个与文件名相同的插件函数。所以 code1 函数是在 plugin/code1.py 里实现的。\r\n\r\n```\r\nasync def code1(arg1):\r\n global log, xiaomusic\r\n log.info(f\"code1:{arg1}\")\r\n await xiaomusic.do_tts(\"你好，我是自定义的测试口令\")\r\n```\r\n\r\n这里只是演示了打印日志和让小爱音箱说话。还有一个示例插件是 httpget ，可以用来访问 url 。\r\n\r\n比如下面这样配置的话，当对小爱音箱说测试链接时，会去访问 url ，可以用来很多其他的事情。\r\n\r\n```\r\n\"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\r\n```\r\n\r\n最后还需要在 `active_cmd` 中配上口令用于唤醒：\r\n\r\n```\r\n \"active_cmd\": \"play,set_random_play,playlocal,play_music_list,play_music_list_index,stop_after_minute,stop,测试自定义口令\",\r\n```\r\n\r\n感兴趣的可以体验一下，写了有什么好玩的插件也可以在这里分享，或者提 pr 合并进官方库里作为自带插件。\r\n\n## 评论\n\n### 评论 1 - carson512\n如果开启服务的状态下 如何唤醒才能调用原有的播放QQ 网易云？而特定唤醒词调用xiaoai播放？\n---\n\n### 评论 2 - hanxi\n> 如果开启服务的状态下 如何唤醒才能调用原有的播放QQ 网易云？而特定唤醒词调用xiaoai播放？\r\n\r\n不使用 xiaomusic 的唤醒词就会调用音箱自带的，比如说播放音乐\n---\n\n### 评论 3 - shellingford37\n```\r\n[23:26:12] [0.3.30] [INFO] xiaomusic.py:531: 收到消息:测试自定义口令 控制面板:False did:290874427\r\n[23:26:12] [0.3.30] [INFO] xiaomusic.py:577: 完全匹配指令. query:测试自定义口令 opvalue:exec#code1(\"hello\")\r\n[23:26:12] [0.3.30] [INFO] code1.py:3: code1:hello\r\n[23:26:12] [0.3.30] [ERROR] xiaomusic.py:542: Execption XiaoMusic.do_tts() missing 1 required positional argument: 'value'\r\nTraceback (most recent call last):\r\n File \"/app/xiaomusic/xiaomusic.py\", line 540, in do_check_cmd\r\n await func(did=did, arg1=oparg)\r\n File \"/app/xiaomusic/xiaomusic.py\", line 890, in exec\r\n await self.plugin_manager.execute_plugin(code)\r\n File \"/app/xiaomusic/plugin.py\", line 66, in execute_plugin\r\n await coroutine\r\n File \"/app/plugins/code1.py\", line 4, in code1\r\n await xiaomusic.do_tts(\"你好，我是自定义的测试口令\")\r\nTypeError: XiaoMusic.do_tts() missing 1 required positional argument: 'value'\r\n```\r\n\r\n我用code1的代码执行报错，有大佬知道为什么吗？\n---\n\n### 评论 4 - hanxi\n@shellingford37 重构后漏改了，修复了。\n---\n\n### 评论 5 - guoxiangke\n先说播放歌曲，再说 测试自定义口令 就行 \n---\n\n### 评论 6 - CZJCC\n想请教下插件那个功能，如何把用户的语音输入作为参数内容传到自定义函数里\n---\n\n### 评论 7 - hanxi\n> 想请教下插件那个功能，如何把用户的语音输入作为参数内容传到自定义函数里\r\n\r\n现在获取不到，等我加个接口获取吧。\n---\n\n### 评论 8 - CZJCC\n666,支持以后我可以贡献一个接入通义模型的插件\n---\n\n### 评论 9 - hanxi\n@CZJCC 你可以更新看看 plugins/code1.py 的测试代码，我测试了是可以拿到语音输入的原始内容的。\n---\n\n### 评论 10 - hanxi\n文档更新了下，active_cmd 也需要配置一下才能正常唤醒。\n---\n\n### 评论 11 - CZJCC\n> @CZJCC 你可以更新看看 plugins/code1.py 的测试代码，我测试了是可以拿到语音输入的原始内容的。\r\n\r\n我原先设想的事用户的话术是”通义提问为什么地球是圆的“，指令匹配的时候通义提问前缀匹配到类似于code1方法，为什么地球是圆的作为参数传入这个函数，但我看现在是拿历史记录实现的\n---\n\n### 评论 12 - hanxi\n是的，插件函数里面再切割一下前缀就行。last_record就是当前的那条语音数据。\n---\n\n### 评论 13 - hanxi\n> > @CZJCC 你可以更新看看 plugins/code1.py 的测试代码，我测试了是可以拿到语音输入的原始内容的。\r\n> \r\n> 我原先设想的事用户的话术是”通义提问为什么地球是圆的“，指令匹配的时候通义提问前缀匹配到类似于code1方法，为什么地球是圆的作为参数传入这个函数，但我看现在是拿历史记录实现的\r\n\r\n是的，这样比较简单，交给插件里面处理也比较自由。\n---\n\n### 评论 14 - mogeqian\nkey_word_dict中的“播放歌曲”口令是不能修改的是吧？因为以前用小爱同学播放歌曲说习惯了，总是触发xiaomusic自动下载歌曲，我想把口令改成“查找歌曲”，这样我当说播放歌曲的时候就调用网易云音乐或者QQ音乐，当我说查找歌曲的时候就先看本地有没有歌曲，没有话就自动下载到本地。\r\n当我先按照config-example.json的模板写好如下配置并重命名为config.json\r\n```\r\n \"key_word_dict\": {\r\n \"查找歌曲\": \"play\",\r\n \"播放本地歌曲\": \"playlocal\",\r\n \"关机\": \"stop\",\r\n \"下一首\": \"play_next\",\r\n \"单曲循环\": \"set_play_type_one\",\r\n \"全部循环\": \"set_play_type_all\",\r\n \"随机播放\": \"set_random_play\",\r\n \"分钟后关机\": \"stop_after_minute\",\r\n \"播放列表\": \"play_music_list\",\r\n \"刷新列表\": \"gen_music_list\",\r\n \"本地播放歌曲\": \"playlocal\",\r\n \"下载歌曲\": \"play\",\r\n \"暂停\": \"stop\",\r\n \"停止\": \"stop\",\r\n \"停止播放\": \"stop\",\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\r\n },\r\n \"key_match_order\": [\r\n \"分钟后关机\",\r\n \"查找歌曲\",\r\n \"下一首\",\r\n \"单曲循环\",\r\n \"全部循环\",\r\n \"随机播放\",\r\n \"关机\",\r\n \"刷新列表\",\r\n \"播放列表\",\r\n \"播放本地歌曲\",\r\n \"本地播放歌曲\",\r\n \"下载歌曲\",\r\n \"暂停\",\r\n \"停止\",\r\n \"停止播放\",\r\n \"测试自定义口令\",\r\n \"测试链接\"\r\n ],\r\n```\r\n\r\n用以下命令安装docker\r\n`docker run --name xiaomusic -p 5488:5488 -v /mnt/sharedata/audiodata/musci/xiaomusic:/app/music -v /mnt/data_sdb1/docker/xiaomusic/config.json:/app/config.json -e XIAOMUSIC_PORT=5488 hanxi/xiaomusic --config /app/config.json`\r\n日志里提示的依然是：\r\n\r\n` key_word_dict={'播放歌曲': 'play', '播放本地歌曲': 'playlocal', '关机': 'stop', '下一首': 'play_next', '上一首': 'play_prev', '单曲循环': 'set_play_type_one', '全部循环': 'set_play_type_all', '随机播放': 'set_random_play', '分钟后关机': 'stop_after_minute', '播放列表': 'play_music_list', '刷新列表': 'gen_music_list', '加入收藏': 'add_to_favorites', '收藏歌曲': 'add_to_favorites', '取消收藏': 'del_from_favorites', '播放列表第': 'play_music_list_index', '本地播放歌曲': 'playlocal', '查找歌曲': 'play', '下载歌曲': 'play', '暂停': 'stop', '停止': 'stop', '停止播放': 'stop', '播放歌单': 'play_music_list', '测试自定义口令': 'exec#code1(\"hello\")', '测试链接': 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")'}, key_match_order=['分钟后关机', '播放歌曲', '下一首', '上一首', '单曲循环', '全部循环', '随机播放', '关机', '刷新列表', '播放列表第', '播放列表', '加入收藏', '收藏歌曲', '取消收藏', '播放本地歌曲', '本地播放歌曲', '查找歌曲', '下载歌曲', '暂停', '停止', '停止播放', '播放歌单', '测试自定义口令', '测试链接']`\r\n\r\n似乎自定义的口令只能以插入的方式添加上去，并不能替换掉原来的口令\r\n\r\n\r\n\n---\n\n### 评论 15 - hanxi\n> key_word_dict中的“播放歌曲”口令是不能修改的是吧？因为以前用小爱同学播放歌曲说习惯了，总是触发xiaomusic自动下载歌曲，我想把口令改成“查找歌曲”，这样我当说播放歌曲的时候就调用网易云音乐或者QQ音乐，当我说查找歌曲的时候就先看本地有没有歌曲，没有话就自动下载到本地。 当我先按照config-example.json的模板写好如下配置并重命名为config.json\r\n> \r\n> ```\r\n> \"key_word_dict\": {\r\n> \"查找歌曲\": \"play\",\r\n> \"播放本地歌曲\": \"playlocal\",\r\n> \"关机\": \"stop\",\r\n> \"下一首\": \"play_next\",\r\n> \"单曲循环\": \"set_play_type_one\",\r\n> \"全部循环\": \"set_play_type_all\",\r\n> \"随机播放\": \"set_random_play\",\r\n> \"分钟后关机\": \"stop_after_minute\",\r\n> \"播放列表\": \"play_music_list\",\r\n> \"刷新列表\": \"gen_music_list\",\r\n> \"本地播放歌曲\": \"playlocal\",\r\n> \"下载歌曲\": \"play\",\r\n> \"暂停\": \"stop\",\r\n> \"停止\": \"stop\",\r\n> \"停止播放\": \"stop\",\r\n> \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n> \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\r\n> },\r\n> \"key_match_order\": [\r\n> \"分钟后关机\",\r\n> \"查找歌曲\",\r\n> \"下一首\",\r\n> \"单曲循环\",\r\n> \"全部循环\",\r\n> \"随机播放\",\r\n> \"关机\",\r\n> \"刷新列表\",\r\n> \"播放列表\",\r\n> \"播放本地歌曲\",\r\n> \"本地播放歌曲\",\r\n> \"下载歌曲\",\r\n> \"暂停\",\r\n> \"停止\",\r\n> \"停止播放\",\r\n> \"测试自定义口令\",\r\n> \"测试链接\"\r\n> ],\r\n> ```\r\n> \r\n> 用以下命令安装docker `docker run --name xiaomusic -p 5488:5488 -v /mnt/sharedata/audiodata/musci/xiaomusic:/app/music -v /mnt/data_sdb1/docker/xiaomusic/config.json:/app/config.json -e XIAOMUSIC_PORT=5488 hanxi/xiaomusic --config /app/config.json` 日志里提示的依然是：\r\n> \r\n> ` key_word_dict={'播放歌曲': 'play', '播放本地歌曲': 'playlocal', '关机': 'stop', '下一首': 'play_next', '上一首': 'play_prev', '单曲循环': 'set_play_type_one', '全部循环': 'set_play_type_all', '随机播放': 'set_random_play', '分钟后关机': 'stop_after_minute', '播放列表': 'play_music_list', '刷新列表': 'gen_music_list', '加入收藏': 'add_to_favorites', '收藏歌曲': 'add_to_favorites', '取消收藏': 'del_from_favorites', '播放列表第': 'play_music_list_index', '本地播放歌曲': 'playlocal', '查找歌曲': 'play', '下载歌曲': 'play', '暂停': 'stop', '停止': 'stop', '停止播放': 'stop', '播放歌单': 'play_music_list', '测试自定义口令': 'exec#code1(\"hello\")', '测试链接': 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")'}, key_match_order=['分钟后关机', '播放歌曲', '下一首', '上一首', '单曲循环', '全部循环', '随机播放', '关机', '刷新列表', '播放列表第', '播放列表', '加入收藏', '收藏歌曲', '取消收藏', '播放本地歌曲', '本地播放歌曲', '查找歌曲', '下载歌曲', '暂停', '停止', '停止播放', '播放歌单', '测试自定义口令', '测试链接']`\r\n> \r\n> 似乎自定义的口令只能以插入的方式添加上去，并不能替换掉原来的口令\r\n\r\n可以在网页后台设置页面改。\n---\n\n### 评论 16 - mogeqian\n不行，后台设置如图\r\n![QQ截图20241111181411](https://gproxy.hanxi.cc/proxy/user-attachments/assets/cc89512f-cab9-488d-b0d6-5b2a3a720ac2)\r\n日志如下：\r\n```\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:1130: update_config_from_setting ok. data:Config(account='**', password='**', mi_did='726577518,570867755', miio_tts_command='', cookie='', verbose=False, music_path='music', download_path='music/download', conf_path='conf', cache_dir='cache', hostname='192.168.22.4', port=8090, public_port=0, proxy='', search_prefix='bilisearch:', ffmpeg_location='./ffmpeg/bin', active_cmd='play,set_random_play,playlocal,play_music_list,stop', exclude_dirs='@eaDir', music_path_depth=10, disable_httpauth=True, httpauth_username='******', httpauth_password='******', music_list_url='', music_list_json='', custom_play_list_json='', disable_download=False, key_word_dict={'播放歌曲': 'play', '播放本地歌曲': 'playlocal', '关机': 'stop', '下一首': 'play_next', '上一首': 'play_prev', '单曲循环': 'set_play_type_one', '全部循环': 'set_play_type_all', '随机播放': 'set_random_play', '分钟后关机': 'stop_after_minute', '播放列表': 'play_music_list', '刷新列表': 'gen_music_list', '加入收藏': 'add_to_favorites', '收藏歌曲': 'add_to_favorites', '取消收藏': 'del_from_favorites', '播放列表第': 'play_music_list_index', '本地播放歌曲': 'playlocal', '查找歌曲': 'play', '下载歌曲': 'play', '暂停': 'stop', '停止': 'stop', '停止播放': 'stop', '播放歌单': 'play_music_list', '测试自定义口令': 'exec#code1(\"hello\")', '测试链接': 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")'}, key_match_order=['分钟后关机', '播放歌曲', '下一首', '上一首', '单曲循环', '全部循环', '随机播放', '关机', '刷新列表', '播放列表第', '播放列表', '加入收藏', '收藏歌曲', '取消收藏', '播放本地歌曲', '本地播放歌曲', '查找歌曲', '下载歌曲', '暂停', '停止', '停止播放', '播放歌单', '测试自定义口令', '测试链接'], use_music_api=False, use_music_audio_id='1582971365183456177', use_music_id='355454500', log_file='/tmp/xiaomusic.txt', fuzzy_match_cutoff=0.6, enable_fuzzy_match=True, stop_tts_msg='收到,再见', enable_config_example=False, keywords_playlocal='播放本地歌曲,本地播放歌曲', keywords_play='查找歌曲,下载歌曲', keywords_stop='关机,暂停,停止,停止播放', keywords_playlist='播放列表,播放歌单', user_key_word_dict={'测试自定义口令': 'exec#code1(\"hello\")', '测试链接': 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")'}, enable_force_stop=False, devices={'726577518': Device(did='726577518', device_id='******', hardware='LX06', name='小爱音箱Pro', play_type='', cur_music='', cur_playlist='全部'), '570867755': Device(did='570867755', device_id='*********', hardware='L15A', name='小米AI音箱(第二代)', play_type='', cur_music='', cur_playlist='全部')}, group_list='', remove_id3tag=False, convert_to_mp3=False, delay_sec=3, continue_play=False, pull_ask_sec=1, crontab_json='', enable_yt_dlp_cookies=False, get_ask_by_mina=False)\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:1133: 语音控制已启动, 用【分钟后关机/播放歌曲/下一首/上一首/单曲循环/全部循环/随机播放/关机/刷新列表/播放列表第/播放列表/加入收藏/收藏歌曲/取消收藏/播放本地歌曲/本地播放歌曲/查找歌曲/下载歌曲/暂停/停止/停止播放/播放歌单/测试自定义口令/测试链接】开头来控制\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:543: 协程时间循环未启动\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:1250: 没打乱 全部 ['乌兰托娅 火红的萨日朗', '凤凰传奇麝香夫人'] ... ['罗大佑童年', '阿嬷'] with len: 7\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:1250: 没打乱 全部 ['乌兰托娅 火红的萨日朗', '凤凰传奇麝香夫人'] ... ['罗大佑童年', '阿嬷'] with len: 7\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] analytics.py:28: analytics init ok\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:104: Startup OK. Config(account='***', password='***', mi_did='726577518,570867755', miio_tts_command='', cookie='', verbose=False, music_path='music', download_path='music/download', conf_path='conf', cache_dir='cache', hostname='192.168.22.4', port=8090, public_port=0, proxy='', search_prefix='bilisearch:', ffmpeg_location='./ffmpeg/bin', active_cmd='play,set_random_play,playlocal,play_music_list,stop', exclude_dirs='@eaDir', music_path_depth=10, disable_httpauth=True, httpauth_username='******', httpauth_password='******', music_list_url='', music_list_json='', custom_play_list_json='', disable_download=False, key_word_dict={'播放歌曲': 'play', '播放本地歌曲': 'playlocal', '关机': 'stop', '下一首': 'play_next', '上一首': 'play_prev', '单曲循环': 'set_play_type_one', '全部循环': 'set_play_type_all', '随机播放': 'set_random_play', '分钟后关机': 'stop_after_minute', '播放列表': 'play_music_list', '刷新列表': 'gen_music_list', '加入收藏': 'add_to_favorites', '收藏歌曲': 'add_to_favorites', '取消收藏': 'del_from_favorites', '播放列表第': 'play_music_list_index', '本地播放歌曲': 'playlocal', '查找歌曲': 'play', '下载歌曲': 'play', '暂停': 'stop', '停止': 'stop', '停止播放': 'stop', '播放歌单': 'play_music_list', '测试自定义口令': 'exec#code1(\"hello\")', '测试链接': 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")'}, key_match_order=['分钟后关机', '播放歌曲', '下一首', '上一首', '单曲循环', '全部循环', '随机播放', '关机', '刷新列表', '播放列表第', '播放列表', '加入收藏', '收藏歌曲', '取消收藏', '播放本地歌曲', '本地播放歌曲', '查找歌曲', '下载歌曲', '暂停', '停止', '停止播放', '播放歌单', '测试自定义口令', '测试链接'], use_music_api=False, use_music_audio_id='1582971365183456177', use_music_id='355454500', log_file='/tmp/xiaomusic.txt', fuzzy_match_cutoff=0.6, enable_fuzzy_match=True, stop_tts_msg='收到,再见', enable_config_example=False, keywords_playlocal='播放本地歌曲,本地播放歌曲', keywords_play='查找歌曲,下载歌曲', keywords_stop='关机,暂停,停止,停止播放', keywords_playlist='播放列表,播放歌单', user_key_word_dict={'测试自定义口令': 'exec#code1(\"hello\")', '测试链接': 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")'}, enable_force_stop=False, devices={'726577518': Device(did='726577518', device_id='*****', hardware='LX06', name='小爱音箱Pro', play_type='', cur_music='', cur_playlist='全部'), '570867755': Device(did='570867755', device_id='*********', hardware='L15A', name='小米AI音箱(第二代)', play_type='', cur_music='', cur_playlist='全部')}, group_list='', remove_id3tag=False, convert_to_mp3=False, delay_sec=3, continue_play=False, pull_ask_sec=1, crontab_json='', enable_yt_dlp_cookies=False, get_ask_by_mina=False)\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] httpserver.py:111: disable_httpauth:True\r\n[18:08:04] [0.3.46] [INFO] Started server process [1]\r\n[18:08:04] [0.3.46] [INFO] Waiting for application startup.\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:541: 启动后台构建 tag cache\r\n[18:08:04] [0.3.46] [INFO] Application startup complete.\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:513: 已从【cache/tag_cache.json】加载 tag cache\r\n[18:08:04] [0.3.46] [INFO] Uvicorn running on http://['0.0.0.0', '::']:8090 (Press CTRL+C to quit)\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:527: 保存：tag cache 已保存到【cache/tag_cache.json】\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:577: tag 更新完成\r\n[2024-11-11 18:08:04] [0.3.46] [INFO] xiaomusic.py:248: 选中的设备: {'726577518': Device(did='726577518', device_id='******', hardware='LX06', name='小爱音箱Pro', play_type='', cur_music='', cur_playlist='全部'), '570867755': Device(did='570867755', device_id='*********', hardware='L15A', name='小米AI音箱(第二代)', play_type='', cur_music='', cur_playlist='全部')}\r\n[18:08:34] [0.3.46] [INFO] 172.20.0.1:35058 - \"GET /static/default/setting.html HTTP/1.1\" 304\r\n[18:08:34] [0.3.46] [INFO] 172.20.0.1:35058 - \"GET /getversion HTTP/1.1\" 200\r\n```\r\n使用的docker-compose命令安装\r\nservices:\r\n xiaomusic:\r\n image: hanxi/xiaomusic\r\n container_name: xiaomusic\r\n restart: unless-stopped\r\n ports:\r\n - 8090:8090\r\n volumes:\r\n - /mnt/sharedata/audiodata/musci/xiaomusic:/app/music\r\n - /mnt/data_sdb1/docker/xiaomusic/config.json:/app/config.json\r\n command: ['--config', '/app/config.json']\r\n\r\n根据日志的提示，'播放歌曲': 'play'依然存在，只是增加了 '查找歌曲': 'play', '下载歌曲': 'play', 这两个关于play的自定义口令，所以实际上play有三条口令 “播放歌曲、查找歌曲、下载歌曲”，能否删除掉'播放歌曲': 'play'这个系统默认的口令？只使用 '查找歌曲': 'play', '下载歌曲': 'play', 这两个关于play的自定义口令\n---\n\n### 评论 17 - hanxi\n@mogeqian 另外提个 issue 吧，现在应该是不支持删除默认的口令。\n---\n\n### 评论 18 - mogeqian\n好的，已经重开了一个issue #259 \n---\n\n### 评论 19 - wjcroom\n@hanxi 你好大神 , 自定义口令基本搞定了,还有些不确定对不对\n在项目命令中只有停止,没有继续. \n能把stop.做成, 乒乓吗.继续. 暂停的切换.pause play\n \"active_cmd\": \"play,set_random_play,playlocal,play_music_list,play_music_list_index,stop_after_minute,stop,测试自定义口令\",\n这个激活cmd是什么作用呢, 怎么看着默认的是函数,只有最后一个是中文呢? \n \n已经把自定义3thplay音量加入了. 其他的大点声小点声, 大点音,小点音.,还有好多.\n好的好像是激活xiaomusic的 但是为啥前面的是单词?\nconfig.json, 已经被setting.json替换了的. \n\n```\nasync def set_myvolume(self, did=\"\", arg1=0, **kwargs):\n if did not in self.devices:\n self.log.info(f\"设备 did:{did} 不存在, 不能设置音量\")\n return\n if arg1==\"up\":\n await self.devices[did].thdplay('up')\n elif arg1==\"down\":\n await self.devices[did].thdplay('dow')\n \n else:\n volume = chinese_to_number(arg1) \n await self.devices[did].thdplay('volume',str(volume))\n\n```\n---\n\n### 评论 20 - hanxi\n激活cmd支持配置 key 和 value，用于决定是否能在 xiaomusic 不播放的时候能否唤醒 xiaomusic 。\n\nconfig.json 是基本废弃了，作为一个初始化配置存在。\n\n暂停不方便做，没有好的接口控制音箱暂停，所以就没加这个口令。\n---\n\n### 评论 21 - wjcroom\n> 激活cmd支持配置 key 和 value，用于决定是否能在 xiaomusic 不播放的时候能否唤醒 xiaomusic 。\n> \n> config.json 是基本废弃了，作为一个初始化配置存在。\n> \n> 暂停不方便做，没有好的接口控制音箱暂停，所以就没加这个口令。\n1.现在有了停止，我觉得继续可以是重启最近一首歌，在停止前把正在播放存放在某处。存 stop 里的name可以吗。感觉会有重名呢？\n\n2. 有没有可能让小爱在技能中心增加自己的【小音乐】技能，进入xiaomusic对话模式，直到退出。这样不再互相干扰。 \n\n---\n\n### 评论 22 - hanxi\n1. 目前会记录最后一次播放的歌曲，正常说播放歌曲，不带歌曲名字应该就会重头播放的。\n2. 对话模式有些设备不支持，实现也比较复杂，xiaogpt那些项目是支持对话模式的，我就懒得支持了。\n---\n\n### 评论 23 - thefreezoo\n我想写个可以读小说的，现在就是可以读不能关闭了，只能一次读完，我本想重新发送一条关闭命令，上一个自定义命令没有结束，似乎不能接受新的命令，包括关机，有什么语音控制接口可以关闭这个运行中的任务吗\n---\n\n### 评论 24 - hanxi\n> 我想写个可以读小说的，现在就是可以读不能关闭了，只能一次读完，我本想重新发送一条关闭命令，上一个自定义命令没有结束，似乎不能接受新的命令，包括关机，有什么语音控制接口可以关闭这个运行中的任务吗\n\n可以看看你是怎么写的？估计得用 asyncio 异步的写法。\n---\n\n### 评论 25 - thefreezoo\n> > 我想写个可以读小说的，现在就是可以读不能关闭了，只能一次读完，我本想重新发送一条关闭命令，上一个自定义命令没有结束，似乎不能接受新的命令，包括关机，有什么语音控制接口可以关闭这个运行中的任务吗\n> \n> 可以看看你是怎么写的？估计得用 asyncio 异步的写法。\n\npython我用的不很熟，基本逻辑都是用服务器实现的，好像python不能直接这样开启异步线程：import json\nimport threading\nimport requests\nimport asyncio\n\nasync def getbook(xiaomusic):\n # global log, xiaomusic\n offset = '0'\n did = xiaomusic._cur_did\n \n requests.get(\"http://192.168.1.16:8001/note/off?off=N\",timeout=100)\n while True:\n url=\"http://192.168.1.16:8001/note/list?name=test&offset=\" + offset\n try:\n response=requests.get(url,timeout=100)\n if response.status_code==200:\n print(response.text)\n res = json.loads(response.text)\n await xiaomusic.do_tts(did, res['data'])\n offset=str(res[\"offset\"])\n if res['off'] == 1:\n break\n else:\n print(f\"no 200\")\n break\n except requests.exceptions.RequestException as e:\n print(f\"{e}\")\n break\n\ndef read():\n global log, xiaomusic\n loop=asyncio.get_event_loop()\n loop.run_until_complete(getbook(xiaomusic))\n---\n\n### 评论 26 - hanxi\n@thefreezoo 你用了个死循环，把整个服务卡住了。你可以在死循环里加个 asyncio.sleep ，然后再写一个自定义口令杀掉你的这个 task 。\n---\n\n### 评论 27 - thefreezoo\n> [@thefreezoo](https://github.com/thefreezoo) 你用了个死循环，把整个服务卡住了。你可以在死循环里加个 asyncio.sleep ，然后再写一个自定义口令杀掉你的这个 task 。\n似乎还是不行，不能识别其他口令\nimport json\nimport threading\nimport requests\nimport asyncio\n\nasync def read():\n global log, xiaomusic\n offset = '0'\n did = xiaomusic._cur_did\n \n requests.get(\"http://192.168.1.16:8001/note/off?off=N\",timeout=100)\n while True:\n url=\"http://192.168.1.16:8001/note/list?name=test&offset=\" + offset\n try:\n response=requests.get(url,timeout=100)\n if response.status_code==200:\n print(response.text)\n res = json.loads(response.text)\n await xiaomusic.do_tts(did, res['data'])\n offset=str(res[\"offset\"])\n if res['off'] == 1:\n break\n else:\n print(f\"no 200\")\n break\n except requests.exceptions.RequestException as e:\n print(f\"{e}\")\n break\n await asyncio.sleep(1)\n---\n\n### 评论 28 - hanxi\n要不你问问ai吧，你缺少一个自定义指令干掉你这个死循环。\n---\n\n### 评论 29 - thefreezoo\n> 要不你问问ai吧，你缺少一个自定义指令干掉你这个死循环。\n\n插件是同步调用的，需要把插件包装成任务放回当前事件循环，我把plugins.py异步调用那里直接改成在事件循环中执行，然后放回running_task，stop的时候在终止任务,这样就可以用关机命令了\n---\n\n### 评论 30 - hu847266\n能不能实现播放玩一个歌曲自动暂停\n---\n\n### 评论 31 - hanxi\n> 能不能实现播放玩一个歌曲自动暂停\n\n设置为单曲播放模式就行。\n---\n\n### 评论 32 - hu847266\n问一下这个如果设置了离家后停止播放音乐，改了这个还能实现吗\n---\n\n### 评论 33 - hu847266\n用服务器配置，容器端口和ip填什么，ip填公网ip吗\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/105)\n" }, { "path": "docs/issues/182.md", "content": "---\ntitle: 定时任务配置格式\n---\n# 定时任务配置格式\n支持采用 crontab 的格式配置定时任务，已经支持下面的任务类型:\n\n- stop 关机\n- play 播放歌曲\n- play_music_list 播放列表\n- tts 文字转语音\n- refresh_music_list 刷新播放列表\n- set_volume 设置音量\n- set_play_type 设置播放类型，单曲循环 0 , 全部循环 1 , 随机播放 2 , 单曲播放 3 , 顺序播放 4\n- set_pull_ask 设置是否拉取对话记录，每天定时关闭，可缓解风控问题\n- reinit 重新初始化，每天执行一次可缓解登录失效问题\n- play_music_tmp_list 播放自定义列表任务，将多个歌曲组成一个临时歌单播放\n\n### 示例\n\n```json\n[\n {\n \"expression\": \"0 8 * * 0-4\",\n \"name\": \"play\",\n \"did\": \"123456789\",\n \"arg1\": \"周杰伦晴天\"\n },\n {\n \"expression\": \"10 8 * * 0-4\",\n \"name\": \"stop\",\n \"did\": \"123456789\"\n },\n {\n \"expression\": \"0 9 * * *\",\n \"name\": \"play\",\n \"did\": \"123456789\",\n \"arg1\": \"周杰伦晴天\"\n },\n {\n \"expression\": \"0 10 * * *\",\n \"name\": \"play_music_list\",\n \"did\": \"123456789\",\n \"arg1\": \"周杰伦\"\n },\n {\n \"expression\": \"30 10 * * *\",\n \"name\": \"play_music_list\",\n \"did\": \"123456789\",\n \"arg1\": \"周杰伦|晴天\"\n },\n {\n \"expression\": \"0 7 * * *\",\n \"name\": \"tts\",\n \"did\": \"123456789\",\n \"arg1\": \"早上好！该起床了！\"\n },\n {\n \"expression\": \"0 3 * * *\",\n \"name\": \"refresh_music_list\"\n },\n {\n \"expression\": \"* * * * *\",\n \"name\": \"set_volume\",\n \"did\": \"123456789\",\n \"arg1\": \"25\"\n },\n {\n \"expression\": \"* * * * *\",\n \"name\": \"set_play_type\",\n \"did\": \"123456789\",\n \"arg1\": \"2\"\n },\n {\n \"expression\": \"0 6 * * *\",\n \"name\": \"set_pull_ask\",\n \"arg1\": \"enable\"\n },\n {\n \"expression\": \"0 0 * * *\",\n \"name\": \"set_pull_ask\",\n \"arg1\": \"disable\"\n },\n {\n \"expression\": \"0 1 * * *\",\n \"name\": \"reinit\"\n },\n {\n \"expression\": \"33 20 * * *\",\n \"name\": \"play_music_tmp_list\",\n \"did\": \"978479727\",\n \"arg1\": \"临时列表1\",\n \"music_list\": [\n \"1大青树下的小学\",\n \"7听听秋的声音\",\n \"11宝葫芦的秘密\"\n ],\n \"first\": \"11宝葫芦的秘密\"\n }\n]\n```\n\n示例中的意思是：\n\n- 周一到周五每天 8 点播放歌曲 \"周杰伦晴天\"\n- 周一到周五每天 8 点 10 分执行关机指令\n- 每天 9 点播放歌曲 \"周杰伦晴天\"\n- 每天 10 点播放列表 \"周杰伦\"\n- 每天 10 点 30 分播放列表 \"周杰伦\" 里的 \"晴天\"\n- 每天 7 点发出语音 \"早上好！该起床了！\"\n- 每天 3 点刷新播放列表，用于自动更新目录下的歌曲到播放列表里。\n- 每分钟设置音量为 25\n- 每分钟设置为随机播放\n- 每天早上6点开启拉取对话记录\n- 每天晚上12点关闭拉取对话记录\n- 每天1点重新初始化\n- 晚上8点33将3个歌曲组成名为【临时列表1】的歌单并从【11宝葫芦的秘密】开始播放，`arg1` 可选，`first` 可选\n\n> 注意星期一是0，星期二是1，星期日是6。\n> (0-6 or mon,tue,wed,thu,fri,sat,sun)\n> The first weekday is always monday.\n\n### 参数意思\n\n- expression 的格式是标准的 crontab 的格式，用于配置任务的执行时机，如何配置可以直接用下面的 crontab ai 工具生成\n - \n - \n- name 是任务名，目前只支持上面那几种。\n- did 是小爱音箱的设备ID，就是设置页面的音箱型号后面的那串数字。\n- arg1 根据任务不同而不同。\n - play 的 arg1 表示要播放的歌曲名。\n - play_music_list 的 arg1 表示要播放的播放目录名，可以加 `|` 符合加上目录下面的歌曲名，也可不加。\n - tts 的 arg1 表示要说的语音文字。\n\n可以去 里检查 json 配置是否合法。 \n## 评论\n\n### 评论 1 - hanxi\n0.3.38版本功能。\n---\n\n### 评论 2 - F-loat\n\n\n小程序已支持可视化配置定时任务\n---\n\n### 评论 3 - hanxi\n有想法增加一个参数来决定法定工作日，法定节假日执行。\n---\n\n### 评论 4 - hanxi\n计划这样配工作日或者休息日，末尾加上 ` #workday` 表示工作日才执行，末尾加上 ` #offday` 表示休息日才执行。\n```json\n[\n {\n \"expression\": \"0 8 * * * #workday\",\n \"name\": \"play\",\n \"did\": \"123456789\",\n \"arg1\": \"周杰伦晴天\"\n },\n {\n \"expression\": \"0 10 * * * #offday\",\n \"name\": \"play\",\n \"did\": \"123456789\",\n \"arg1\": \"周杰伦晴天\"\n }\n]\n```\n---\n\n### 评论 5 - sycflash\n想问下这个怎么配置？修改哪个配置文件？\n---\n\n### 评论 6 - xcysy32\n蹲，请问要定时从歌单地址获取歌单列表json并更新应该怎么写\n---\n\n### 评论 7 - fc1250\n定时播放失效了\n---\n\n### 评论 8 - dumashsu\n超小白請問\n範例做好了, 要放在那個檔案內 才會生效\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/182)\n" }, { "path": "docs/issues/19.md", "content": "---\ntitle: 如何修改默认的8090端口\n---\n# 如何修改默认的8090端口\ndocker-compose 修改映射端口会播放失败\r\n\r\n```\r\nports:\r\n - 80:8090\r\n```\r\n\r\n从日志看继续调用了 http://10.0.0.4:8090 而不是修改映射的80，还原成\r\n\r\n```\r\nports:\r\n - 8090:8090\r\n```\r\n则一切正常\r\n\r\n```\r\nxiaomusic | [BiliBiliSearch] Playlist 安河桥北: Downloading 1 items of 1\r\nxiaomusic | [download] Downloading item 1 of 1\r\nxiaomusic | [BiliBili] Extracting URL: http://www.bilibili.com/video/av319943893\r\nxiaomusic | [BiliBili] 319943893: Downloading webpage\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | [BiliBili] BV1tw411X7Rr: Extracting videos in anthology\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | [BiliBili] 319943893: Extracting chapters\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | [BiliBili] Format(s) 1080P 高码率, 1080P 高清, 720P 高清, 4K 超清 are missing; you have to login or become premium member to download them. Use --cookies-from-browser or --cookies for the authentication. See https://github.com/yt-dlp/yt-dlp/wiki/FAQ#how-do-i-pass-cookies-to-yt-dlp for how to manually pass cookies\r\nxiaomusic | [info] BV1tw411X7Rr: Downloading 1 format(s): 30280\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | 10.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\nxiaomusic | [download] Destination: music/安河桥北.m4a\r\n[download] 0.3% of 5.61MiB at 6.24MiB/s ETA 00:0010.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\n[download] 0.5% of 5.61MiB at 2.42MiB/s ETA 00:0210.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\n[download] 1.1% of 5.61MiB at 1.50MiB/s ETA 00:0310.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\n[download] 4.4% of 5.61MiB at 2.35MiB/s ETA 00:0210.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\n[download] 8.9% of 5.61MiB at 3.59MiB/s ETA 00:0110.0.0.118 - - [21/Feb/2024 15:29:24] \"POST /cmd HTTP/1.1\" 200 -\r\n[download] 100% of 5.61MiB in 00:00:00 at 10.83MiB/s \r\nxiaomusic | [ExtractAudio] Destination: music/安河桥北.mp3\r\nxiaomusic | Deleting original file music/安河桥北.m4a (pass -k to keep)\r\nxiaomusic | [download] Finished downloading playlist: 安河桥北\r\nxiaomusic | [02/21/24 15:29:29] INFO 播放 xiaomusic.py:461\r\nxiaomusic | http://10.0.0.4:8090/music/%E5%AE% \r\nxiaomusic | 89%E6%B2%B3%E6%A1%A5%E5%8C%97.mp3 \r\nxiaomusic | INFO 已经开始播放了 xiaomusic.py:464\r\nxiaomusic | INFO 歌曲music/安河桥北.mp3的时长251秒 xiaomusic.py:371\r\nxiaomusic | INFO 251秒后将会播放下一首 xiaomusic.py:385\r\nxiaomusic | INFO 匹配到指令. opkey:set_volume# xiaomusic.py:441\r\nxiaomusic | opvalue:set_volume oparg:24 \r\n```\n## 评论\n\n### 评论 1 - hanxi\n需要添加环境变量\r\n```\r\nenvironment:\r\n XIAOMUSIC_PORT:80\r\nports:\r\n - 80:80\r\n ```\n---\n\n### 评论 2 - newrookie001\n> 需要添加环境变量\r\n> \r\n> ```\r\n> environment:\r\n> XIAOMUSIC_PORT:80\r\n> ports:\r\n> - 80:80\r\n> ```\r\n\r\n自己走了点弯路，半天才搞明白。补充说明：\r\n> environment:\r\n> XIAOMUSIC_PORT: 5678 #就是“5678”可以根据自己要求设置，但要求上下的5678都设置成一个\r\n> ports:\r\n> - 5678:5678 \n---\n\n### 评论 3 - hanxi\n如果换端口，需要3个数字一致，比如\r\n\r\n```\r\nenvironment:\r\n XIAOMUSIC_PORT:6874\r\nports:\r\n - 6874:6874\r\n```\n---\n\n### 评论 4 - hanxi\n文档类型的我都打开下，方便其他人看到。\n---\n\n### 评论 5 - flymin\ndocker-compose 中对应关系应该是\r\n```yaml\r\nports:\r\n - aaaa:bbbb\r\nenvironment:\r\n XIAOMUSIC_PORT: bbbb # 配置文件中的 port，后台：监听端口(修改后需要重启)\r\n XIAOMUSIC_PUBLIC_PORT: aaaa # 配置文件中的 public_port，后台：外网访问端口(0表示跟监听端口一致)\r\n```\r\n\r\n以上，docker 环境中基本不存在需要修改 bbbb 的情况，也就是不用设置 XIAOMUSIC_PORT。如果需要修改端口，只需要修改两处 aaaa\r\n如果使用反向代理，则转发 localhost:aaaa，XIAOMUSIC_PUBLIC_PORT 设置成代理的监听端口 cccc\r\n\r\n另外，setting 文件存在会覆盖环境变量。启动过之后需要直接修改 settings.json 或者在后台修改\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/19)\n" }, { "path": "docs/issues/210.md", "content": "---\ntitle: yt-dlp cookies 文件上传功能\n---\n# yt-dlp cookies 文件上传功能\n此功能用于解决 yt-dlp 下载资源失败时使用，比如 **ip 被 B站或者 youtube 加入黑名单**后才需要使用。\n\n上传的文件用于 yt-dlp 的 `--cookies` 参数。\n```\n--cookies FILE Netscape formatted file to read cookies from\n and dump cookie jar in\n```\n\n## 获取 cookies.txt 文件\n\n1. 下载插件 [Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/cclelndahbckbenkjhflpdbgdldlbecc)\n2. 给予插件访问权限和无痕模式允许使用\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/89f6ce94-bb51-4805-8c16-a867ba41e5d2)\n3. 打开无痕窗口\n4. 打开 youtube.com\n5. 登陆 youtube.com\n6. 打开新标签页\n7. 关闭 youtube.com 的标签页\n8. 保存 cookies.txt\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/64242595-7b5c-4159-a8bc-4fc922d5de9e)\n\n原因见 https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies\n\n## 上传 cookies.txt\n\n1. 打开设置页面\n2. 设置启用yt-dlp-cookies 选项为 true\n![Screenshot_2024-09-29-22-31-40-134_com android chrome-edit](https://gproxy.hanxi.cc/proxy/user-attachments/assets/49760905-475b-493c-9ff4-271c5e797b2f)\n3. 点击保存\n4. 再点击选择文件，选择前面保存好的 cookies.txt 文件，点击上传。\n![Screenshot_2024-09-29-22-33-21-361_com android chrome-edit](https://gproxy.hanxi.cc/proxy/user-attachments/assets/838bfd1c-f19f-4690-86b0-8208d596fbf1)\n\n\n## 后续用途\n\n1. 语音下载歌曲都会带上前面上传的 cookies.txt 文件去搜索下载歌曲。\n2. 歌曲批量下载工具下载歌曲或者歌单时也会带上 cookies.txt 文件。\n\n\n## 评论\n\n### 评论 1 - kingfly2016\n0.3.37的版本并没有发现可以开启yt-dlp-cookies 并上传cookies文件的地方,尝试把导出的cookies.txt手工上传到conf目录下,没有生效.\r\n![屏幕截图_11-10-2024_183725_192 168 6 202](https://gproxy.hanxi.cc/proxy/user-attachments/assets/9b8b9750-b616-4fd3-8a3c-216b2f99d02c)\r\n\n---\n\n### 评论 2 - hanxi\n需要等38版本，或者用测试版本，镜像名后面加 :main\n---\n\n### 评论 3 - kingfly2016\n\r\n\r\n> 需要等38版本，或者用测试版本，镜像名后面加 :main\r\n\r\n谢谢\n---\n\n### 评论 4 - sunmiao0301\n20250117实测可用\n---\n\n### 评论 5 - Lonely-Sit\n> 20250117实测可用\n\n佬你今天还可以使用吗？我按照教程操作了但是下载不下来歌曲\n---\n\n### 评论 6 - sunmiao0301\n> > 20250117实测可用\n> \n> 佬你今天还可以使用吗？我按照教程操作了但是下载不下来歌曲\n\n用cookie的方式可能会被封号，ytb限制的是ip，更好的办法是，切换一下梯子节点，多试几个。\n---\n\n### 评论 7 - Lonely-Sit\n> > > 20250117实测可用\n> > \n> > \n> > 大佬你今天还可以用吗？我按照教程操作了但是下载不下来歌曲\n> \n> 用cookie限制的方式可能会被封号，ytb是ip，更好的办法是，切换一下梯子节点，多试几个。\n\n我使用相同ip在电脑端下载歌曲就没有问题 我无法理解\n---\n\n### 评论 8 - wyyang1978-debug\n现在的提示显示formats缺失\nstdout: [youtube] Extracting URL: https://www.youtube.com/watch?v=KqjgLbKZ1h0\nstdout: [youtube] KqjgLbKZ1h0: Downloading webpage\nstdout: [youtube] KqjgLbKZ1h0: Downloading tv downgraded player API JSON\nstdout: [youtube] KqjgLbKZ1h0: Downloading web safari player API JSON\nstderr: WARNING: [youtube] KqjgLbKZ1h0: Signature solving failed: Some formats may be missing. Ensure you have a supported JavaScript runtime and challenge solver script distribution installed. Review any warnings presented before this message. For more details, refer to https://github.com/yt-dlp/yt-dlp/wiki/EJS\nstderr: WARNING: [youtube] KqjgLbKZ1h0: n challenge solving failed: Some formats may be missing. Ensure you have a supported JavaScript runtime and challenge solver script distribution installed. Review any warnings presented before this message. For more details, refer to https://github.com/yt-dlp/yt-dlp/wiki/EJS\n\n---\n\n### 评论 9 - hanxi\n没办法的，yt限制越来越厉害了\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/210)\n" }, { "path": "docs/issues/211.md", "content": "---\ntitle: 📝 文档汇总\n---\n# 📝 文档汇总\n## 1️⃣ 基础文档\n\n- [💬 FAQ问题集合](/issues/99.html)\n- [如何修改默认的8090端口](/issues/19.html)\n- [如何配置网络歌单](/issues/78.html)\n- [如何添加m3u格式文件的电台](/issues/88.html)\n- [xiaomusic极空间安装教程](/issues/297.html)\n- [docker compose 命令行安装教程 ](/issues/360.html)\n- [1Panel 安装运行 xiaomusic 教程](/issues/600.html)\n- [使用cookie登陆](/issues/688.html)\n\n## 2️⃣ 进阶文档\n\n- [设置项功能介绍](/issues/333.html)\n- [采用config.json配置方式](/issues/94.html)\n- [ios系统上的捷径配置](/issues/96.html)\n- [【插件】自定义口令功能](/issues/105.html)\n- [定时任务配置格式](/issues/182.html)\n- [yt-dlp cookies 文件上传功能](/issues/210.html)\n- [如何批量下载歌曲](/issues/212.html)\n- [设备分组播放](/issues/65.html#issuecomment-2215736529)\n- [如何播放小雅alist里的歌曲](/issues/128.html#issuecomment-2232867180)\n- [如何添加 网易云音乐playlist](/issues/269.html)\n- [相关工具推荐](/issues/285.html)\n\n## 3️⃣ 其他安装文档\n\n> [!NOTE]\n> 下面教程可能比较旧，只供参考\n\n- [群晖docker安装 xiaomusic](/issues/101.html)\n- [NAS部署教程](https://post.m.smzdm.com/p/avpe7n99/)\n- [群晖部署教程](https://post.m.smzdm.com/p/a7px7dol/)\n- [QNAS部署教程](https://post.smzdm.com/p/a5xz5x63/)\n- [视频教程-群晖1](https://www.bilibili.com/video/BV1ZZpweHEtT/)\n- [视频教程-群晖2](https://www.bilibili.com/video/BV1JXxXeBEdY/)\n- [视频教程-拾光坞N3](https://www.bilibili.com/video/BV1q629YMEG6/)\n- [TechHive](https://mp.weixin.qq.com/s/4a41muFtPaFKtHeZYu795w)\n- [弹个AI](https://mp.weixin.qq.com/s/sIsKxB7Y8b83AhnvaWiMog)\n- [简单免费！教你用绿联NAS联动小爱音箱，私人音乐库也能语音点播](https://post.m.smzdm.com/p/a8pldgg7/)\n- [飞牛教程](https://mp.weixin.qq.com/s?t=pages/image_detail&__biz=MzkxODc1NDMwOA==&mid=2247483725&idx=1&sn=2d615f14733b9bf989557fa766b4e1fc)\n\n## 评论\n\n### 评论 1 - sghuenn\nredmi小爱触屏音箱8，仍然需要打开“型号兼容模式”才能播放\r\n打开兼容模式后的问题有：每首歌曲播放完毕后都要再从头播放4、5秒才播放下一曲；语音命令小爱同学播放下一曲，它会从头开始播放当前歌曲。\n---\n\n### 评论 2 - hanxi\n> redmi小爱触屏音箱8，仍然需要打开“型号兼容模式”才能播放 打开兼容模式后的问题有：每首歌曲播放完毕后都要再从头播放4、5秒才播放下一曲；语音命令小爱同学播放下一曲，它会从头开始播放当前歌曲。\r\n\r\n播放歌曲的接口应该是有点问题，等有设备有开发能力的人来搞吧。\n---\n\n### 评论 3 - zhoukk37\n想问下如何利用反向代理，完成使得小爱外网访问nas呢，您能提供一下关键词，我自己去检索学下一下吗\n---\n\n### 评论 4 - hanxi\n> 想问下如何利用反向代理，完成使得小爱外网访问nas呢，您能提供一下关键词，我自己去检索学下一下吗\r\n\r\n内网穿透，frp能实现，就是把局域网的端口映射成公网的端口。\n---\n\n### 评论 5 - Justlook99\n按照飞牛的教程，部署成功了，一直没有设备显示出来，然后我也按照相应的问题集去处理：关闭本地代理。\r\n如果是nas运行的，网络由bridge改为host。\r\n米家app重新登陆。\r\nmi.com官网重新登陆。\r\n但是还是没有办法显示设备出来，请问到底是什么原因？最新的37版本。\n---\n\n### 评论 6 - hanxi\n> 按照飞牛的教程，部署成功了，一直没有设备显示出来，然后我也按照相应的问题集去处理：关闭本地代理。 如果是nas运行的，网络由bridge改为host。 米家app重新登陆。 mi.com官网重新登陆。 但是还是没有办法显示设备出来，请问到底是什么原因？最新的37版本。\r\n\r\n目前反馈的都是飞牛的用户，可能是飞牛有问题。\n---\n\n### 评论 7 - 3794313569\n在同一个容器内，前后分别启动了mi-gpt和xiaomusic两个应用，现在通过日志发现，mi-gpt的日志一直在记录，语音需求基本都在mi-gpt这个应用响应了，请问下按照您现在设计的框架内，有没有办法可以实现这两个应用同时生效，或者稍后类似应用会有专用的通讯协议，保证多项应用在同一台机器上的响应。\r\n类似：语音命令-“播放本地歌曲”触发xiaomusic，“召唤”（mi-gpt配置的唤醒词）触发mi-gpt，等等。。。。。。\r\n暂时的办法就是买两个小爱音箱，不同的命名，然后一个应用配置一个did。\n---\n\n### 评论 8 - hanxi\n> 在同一个容器内，前后分别启动了mi-gpt和xiaomusic两个应用，现在通过日志发现，mi-gpt的日志一直在记录，语音需求基本都在mi-gpt这个应用响应了，请问下按照您现在设计的框架内，有没有办法可以实现这两个应用同时生效，或者稍后类似应用会有专用的通讯协议，保证多项应用在同一台机器上的响应。 类似：语音命令-“播放本地歌曲”触发xiaomusic，“召唤”（mi-gpt配置的唤醒词）触发mi-gpt，等等。。。。。。 暂时的办法就是买两个小爱音箱，不同的命名，然后一个应用配置一个did。\r\n\r\n可以分别部署到两个不同的容器里，两个应用的唤醒词是不同的，不会互相干扰。\n---\n\n### 评论 9 - Tranceboox\n如果网页端主页内能显示播放曲目的封面就太牛了，我知道实现起来很难，就是臆想一下\n---\n\n### 评论 10 - hanxi\n> 如果网页端主页内能显示播放曲目的封面就太牛了，我知道实现起来很难，就是臆想一下\r\n\r\nxplayer 和 pure 主题就可以，你试试。\n---\n\n### 评论 11 - aries0311\nPure主题中，设备列表中只有本机，不显示小米音箱\r\n![01](https://gproxy.hanxi.cc/proxy/user-attachments/assets/ca231b5f-ee4f-430b-a2b3-aca5aa395081)\r\n![02](https://gproxy.hanxi.cc/proxy/user-attachments/assets/a3a83d1f-a822-42d0-bea9-b88bb1f5fd76)\r\n\n---\n\n### 评论 12 - fanyan1026\n电视的小爱同学可以播放nas音乐吗\n---\n\n### 评论 13 - hanxi\n> 电视的小爱同学可以播放nas音乐吗\n\n应该是不行的\n---\n\n### 评论 14 - alililala\n这个部署在了旁路由里，能否将下载目录设置成同网络的nas里呢\n---\n\n### 评论 15 - hanxi\n> 这个部署在了旁路由里，能否将下载目录设置成同网络的nas里呢\n\n配公网访问吧，局域网互通不会配的话很难教会的。\n---\n\n### 评论 16 - wjcroom\n> 这个部署在了旁路由里，能否将下载目录设置成同网络的nas里呢\n\n旁路由视同本地网络. 只要是同网段,如果有子路由. 小爱和主机尽量在主路由. 如果小爱在子路由,应该问题不大.但是 xiaomusic 和 nas,网络共享.必须在主路由.然后,xiaomusic所在地方,可以映射成本地目录.这也挺麻烦. 网络共享,和目录还是有差别的. \n\nNFS文件服务 , linux本地挂载远程NFS为目录.这个我曾搞过. 是不是有一定原因,nas不能跑docker呢.不是太耗费资源,普通nas都有的 吧.\n---\n\n### 评论 17 - rainman5170\n要怎样屏蔽外网？我的nas有域名解析，发现加上后缀外网居然也能连上xiaomusic，或者加下登陆窗口也是好的，不然直接暴露在外网了\n---\n\n### 评论 18 - hanxi\n> 要怎样屏蔽外网？我的nas有域名解析，发现加上后缀外网居然也能连上xiaomusic，或者加下登陆窗口也是好的，不然直接暴露在外网了\n\n设置访问密码就行\n---\n\n### 评论 19 - rainman5170\n> > 要怎样屏蔽外网？我的nas有域名解析，发现加上后缀外网居然也能连上xiaomusic，或者加下登陆窗口也是好的，不然直接暴露在外网了\n> \n> 设置访问密码就行\n\n要怎样设置？麻烦说一下在哪设置\n---\n\n### 评论 20 - hanxi\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6423fa6b-293a-45b6-9482-b1e42f94a31f)\n\n@rainman5170 \n---\n\n### 评论 21 - rainman5170\n\n\n\n\n> ![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6423fa6b-293a-45b6-9482-b1e42f94a31f)\n> \n> [@rainman5170](https://github.com/rainman5170)\n\n好的，谢谢\n---\n\n### 评论 22 - xiayuxingtian\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6c0fbd9d-6f15-4f48-93cd-77a16ab36cdb)\n安装好后无法识别本地文件夹歌曲，下载的歌曲也不知道在哪个文件夹\n\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/96966106-6d43-4480-9d85-8ddef67f7267)\n下载的这些歌曲也没找到在哪里，有没有大神帮忙解答一下\n\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/ccb86f62-4140-4a65-8242-69c41615965b)\n---\n\n### 评论 23 - hanxi\n路径挂载错了，删掉最后一个试试。\n---\n\n### 评论 24 - wjjjw2150\n之前在群辉docker上部署的xiaomusic一直使用正常，今天群辉开机掉了硬盘，恢复正常后容器就无法启动，重置后正常启动，但默认主题和Tailwind主题出现显示问题，刷新等按钮变成了英文字符显示，如图，另外两个主题没问题。清空浏览器缓存，换其他电脑和手机访问都是如此。然后删掉xiaomusic容器和镜像（0.37），重新拉了最新镜像（0.378）部署，问题依旧。虽然功能都正常但强迫症表示实在是难受。请教大神这是怎么回事呀？\n抱歉不知道怎么插图，看这个链接\nhttps://tutu.to/image/1.N0FHK\n https://tutu.to/image/N0Jwj\n---\n\n### 评论 25 - hanxi\n估计是网络问题\n---\n\n### 评论 26 - s493321320\n有办法添加到homeassistant里吗？\n---\n\n### 评论 27 - Chill-26\n> 按照飞牛的教程，部署成功了，一直没有设备显示出来，然后我也按照相应的问题集去处理：关闭本地代理。 如果是nas运行的，网络由bridge改为host。 米家app重新登陆。 mi.com官网重新登陆。 但是还是没有办法显示设备出来，请问到底是什么原因？最新的37版本。\n\n同样问题，但我重新使用 [视频教程-群晖1]进行部署就正常了\n---\n\n### 评论 28 - davedday\n这个支持在远程VPS上docker部署，然后本地小爱同学使用吗？\n---\n\n### 评论 29 - hanxi\n> 这个支持在远程VPS上docker部署，然后本地小爱同学使用吗？\n\n支持的，请不要在不相关的话题下面问。\n---\n\n### 评论 30 - zhendery\n> 要怎样屏蔽外网？我的nas有域名解析，发现加上后缀外网居然也能连上xiaomusic，或者加下登陆窗口也是好的，不然直接暴露在外网了\n\n 你这问题重点不在于设置访问密码吧，你端口暴露在公网，走http的话就算设置密码也是明文传输的呀，你得防火墙关了对应端口，或者上https+访问密码。\n---\n\n### 评论 31 - maomaovip\n每次拔2秒钟以后就没有声音了，但是网页后台上面显示还在播放\n---\n\n### 评论 32 - nick-tru\n> ![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6c0fbd9d-6f15-4f48-93cd-77a16ab36cdb) 安装好后无法识别本地文件夹歌曲，下载的歌曲也不知道在哪个文件夹\n> \n\n\n@xiayuxingtian 破案了！\n在群晖部署的时候，路径映射不能用/app/music和/app/conf，直接用/music和/conf，实测完美识别本地歌曲，下载路径正常不需要映射，也能工作并看到下载的歌曲。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/211)\n" }, { "path": "docs/issues/212.md", "content": "---\ntitle: 如何批量下载歌曲\n---\n# 如何批量下载歌曲\n批量下载歌曲依赖的是 yt-dlp 批量下载播放列表里的视频并转为 mp3 实现的。\r\n\r\n先进入到歌曲下载工具页面:\r\n\r\n> 默认主题 => 设置 => 歌曲下载工具\r\n\r\n![Screenshot_2024-09-29-22-36-12-178_com android chrome-edit](https://gproxy.hanxi.cc/proxy/user-attachments/assets/ddd2af00-cd9e-4938-9450-56503453807c)\r\n\r\n\r\n已经测试过 B 站和 youtube 两种播放列表，播放列表的链接是有要求，不能有其他多余参数。\r\n\r\n比如 B 站的是这样的\r\n\r\nhttps://m.bilibili.com/video/BV1WUsDezE88\r\n\r\nyoutube 的是这样的\r\n\r\nhttps://m.youtube.com/playlist?list=PLUD2d-pqyvT6_ztf31hx-5SsUUvY5UsQn\r\n\r\n输入歌单名字是用于保存的文件夹名字，最好不是已经存在的名字，每次下载歌单都取个新名字比较合适。\r\n\r\n已知 youtube 需要上传无痕模式下的 cookies.txt 文件才能正常下载。具体步骤见 /issues/210.html 。\r\n\r\n\r\n也支持单独下载一个链接只有一首歌曲的。\n## 评论\n\n### 评论 1 - lazybabyz\n 默认主题 => 设置 =>没有显示找到 歌曲下载工具,\r\n有一个 歌单地址 歌单内容: 输入B站测试地址显示返回无效\r\n\r\n![aaa](https://gproxy.hanxi.cc/proxy/user-attachments/assets/31e224cb-fcbd-4841-b545-bfbd2496061b)\r\n\n---\n\n### 评论 2 - hanxi\n等0.3.38版本。\n---\n\n### 评论 3 - hzqgogogo\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6751adf0-fea6-40b9-8d4b-48696a3100b3)下载音乐报错\n---\n\n### 评论 4 - hanxi\n> ![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6751adf0-fea6-40b9-8d4b-48696a3100b3)下载音乐报错\n\n下载b站歌曲不用配proxy\n---\n\n### 评论 5 - MakiseKurisu\n是必须要下载下来么？那有没有什么方法限定最大占用的磁盘空间？文档没有网页接口的介绍不太清楚具体有哪些功能\n---\n\n### 评论 6 - hanxi\n> 是必须要下载下来么？那有没有什么方法限定最大占用的磁盘空间？文档没有网页接口的介绍不太清楚具体有哪些功能\n\n没有这功能。\n---\n\n### 评论 7 - sagadc\n請問一下YT下載失敗，因為我是在台灣不需要加proxy\n看了一下log也看不出原因來\n\nyt-dlp應該不用在自己額外安裝吧？\n\n[yt-dl.txt](https://github.com/user-attachments/files/19379757/yt-dl.txt)\n---\n\n### 评论 8 - hanxi\n> 請問一下YT下載失敗，因為我是在台灣不需要加proxy 看了一下log也看不出原因來\n> \n> yt-dlp應該不用在自己額外安裝吧？\n> \n> [yt-dl.txt](https://github.com/user-attachments/files/19379757/yt-dl.txt)\n\n你打开调试模式再复现一下，可能需要上传 cookie 才能下载 yt 的。\n---\n\n### 评论 9 - sagadc\n> > 請問一下YT下載失敗，因為我是在台灣不需要加proxy 看了一下log也看不出原因來\n> > yt-dlp應該不用在自己額外安裝吧？\n> > [yt-dl.txt](https://github.com/user-attachments/files/19379757/yt-dl.txt)\n> \n> 你打开调试模式再复现一下，可能需要上传 cookie 才能下载 yt 的。\n\n感謝，看來要安裝那邊要說明一下要開啟yt-dlp下載最好是上傳cookie比較保險\n---\n\n### 评论 10 - nfzsh\n看日志好像只获取到了第一首？\n---\n\n### 评论 11 - hzqgogogo\n已收到你的邮件！\n---\n\n### 评论 12 - nfzsh\n> 已收到你的邮件！\n\n哦我知道了，你这个是针对分P的，我这个是个合集，我看看哪天我提个PR吧\n---\n\n### 评论 13 - liaowuyichu\n批量下载歌曲，每次只能下载21首，如何调整这个数量值\n---\n\n### 评论 14 - hzqgogogo\n已收到你的邮件！\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/212)\n" }, { "path": "docs/issues/235.md", "content": "---\ntitle: xiaomusic立体声\n---\n# xiaomusic立体声\n有多个不同版本的小爱，怎么能选择多个音箱一起播放？\n## 评论\n\n### 评论 1 - hanxi\n参考这个文档，配到一个组里就能同时播放，但是会有播放进度不一致的情况。 /issues/65.html#issuecomment-2215736529\n---\n\n### 评论 2 - F-loat\n我这边先用一个音箱播放，然后米家里设置全屋播放，就能多个音箱同时播了，进度也同步，而且后续会自动全屋播放\n---\n\n### 评论 3 - zazhi4\n我遇到双音箱播放问题，没法立体声，没法全屋播放，详述如下：\r\n1、基本情况：原有小爱音箱Pro，LX06，用xiaomusic，0.3.69版本，播放正常。看到issue里提及了立体声，打算尝试，新购了小爱音箱,L06A。将新音箱通过米家APP加入到自家的wifi里。\r\n2、尝试：\r\n2.1，在xiaomusic里，默认面板，设置，发现可以在小爱音箱设置面板里有两个音箱供选择，我都勾选了，在设备分组配置里，两个音箱的did输入，配为1个组，能实现同时驱动两个音箱发声，但是不同步，时间上差了不到1秒钟，但是听起来不舒服。\r\n2.2 在xiaomusic里，默认面板，设置，只勾选1个音箱；设备分组配置里，删除原先配置，清空。播放，只有一只音箱有声音。然后回到米家APP。将两个音箱设置，组成立体声。完成后，依然只有一只音箱有声音。设置后，对播放没有影响。\r\n2.3 在米家APP中，取消立体声配对，改为“全屋播放”。设置好后，依然只有一只音箱有声音。换言之，设置后对播放没有影响。\r\n3、检查版本，在小米音箱app中，检查两只音箱的版本，均为最新稳定版。\r\n![1736217346124](https://gproxy.hanxi.cc/proxy/user-attachments/assets/1fa61ded-0044-4577-8b3f-76d03bfe2453)\r\n![1736217346117](https://gproxy.hanxi.cc/proxy/user-attachments/assets/ad3d13ea-0070-4fee-a2d8-814242efd9f8)\r\n![1736217346120](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6b43db2f-80fd-4aa7-97c7-3edaee304a5f)\r\n![1736217346108](https://gproxy.hanxi.cc/proxy/user-attachments/assets/a274b712-d15b-4e6f-b036-c16e291b841f)\r\n![1736217346113](https://gproxy.hanxi.cc/proxy/user-attachments/assets/194deb50-c0f6-4c09-a241-ab2360301c51)\r\n![1736217346103](https://gproxy.hanxi.cc/proxy/user-attachments/assets/675e53fb-2f33-4c9f-9db2-39a969d549bf)\r\n\r\n\r\n\n---\n\n### 评论 4 - zazhi4\n再补充一点信息，我做的尝试，以及网上都到的信息。\r\n1、配立体声，配好以后，我用了当前页面的“立体声音效测试”，两个音箱都能发声，声音有先后，有不同，有联系，形成了立体声效果。\r\n2、配立体声，配好以后，还在米家app，用qq音乐放了一首歌，两个音箱都能发声，有立体声效果。\r\n3、网上查询，一些信息均表明，只有qq或其他在米家里播放的，换言之，网络来的信息，通过米家，向音箱播音，能实现立体声。其他方法，比如蓝牙，或AUX，都没法实现立体声。推测，是米家主动发音的时候，内部拆解了左右声道的声音，发往左右音箱。\r\n4、原本猜想，两个音箱，会一主一从，主音箱拆分声音，发往从音箱。但是在米家APP里配置立体声时，未发现主从之分。\n---\n\n### 评论 5 - hanxi\n全屋播放，控制两个音箱中的任意一个都不行吗？\n---\n\n### 评论 6 - zazhi4\n全屋播放，设置音箱A（设置界面只选A，当然只能选一个。共有3个选项，音箱A，音箱B，手机）播放，音箱B没声音；设置音箱B播放，音箱A没声音。\n---\n\n### 评论 7 - Bazinga-git\n组立体声是刚需，大佬加油\n---\n\n### 评论 8 - zazhi4\n立体声，想了几个路径：1，xiaomusic能不能拆分声音为左右两个声道，分别发往两个音箱，难题在于，怎么保证两个音箱同时接到信息，发声；2，能不能搞定米家app的接口，发送声音给米家app，由米家app发给音箱；3，或是搞定模拟米家app与音箱的接口，通过米家接口，发给音箱，让音箱以为声音来自米家app。方法2，3，要搞清楚，米家app播音，为什么能实现立体声，然后在方法2,3中选一个方向。\n---\n\n### 评论 9 - hanxi\n@zazhi4 思路是对的，感兴趣可以抓包玩玩的。目前协议是没加密的。\n---\n\n### 评论 10 - winsel\n我有两个l06a，在米家app里打开dlan并且两个音箱组立体声后，用安卓手机上面的椒盐音乐播放器，推送到小爱音箱dlan的时候显示的是立体声名字，推送后立体声播放，左右延迟很小，几乎察觉不到，相对群组功能好太多了。xiaomusic能不能增加一个立体声选项，采用dlan推送模式播放呢？\n这样应该是立体声最优解了\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/3f77e6a3-f65f-407a-84d4-481182994992)\n\n---\n\n### 评论 11 - lgcscu\n全屋播放并不是立体声，同时勾选两个设备做组合会出现声音不同步的情况，都不理想。我自己目前用的是立体声，两个音箱都是小爱音箱SOUNDPRO，组合立体声的时候有一个是主音箱一个是副音箱，看你组合的顺序，我的是左边的音箱为主音箱，所以我每次都是命令左边的音箱播放音乐，右边的就会同步播放，没有偏差，用到的就是小米自己的立体声组合，不需要xiaomusic单独支持。另外我启用了连续播放，soundPRO的灯光效果就可以正常使用（立体声），如果不勾选这个连续播放，xiaomusic触发的音乐播放就没有灯光效果，小爱音箱自己的就有，所以我的解决方式就是这样，推荐给有立体声需要的朋友，感谢hanxi的xiaomusic项目！\n\n\"Image\"\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/235)\n" }, { "path": "docs/issues/269.md", "content": "---\ntitle: 如何添加 网易云音乐playlist\n---\n# 如何添加 网易云音乐playlist\n利用 NeteaseCloudMusicApi 获取歌单和播放地址\r\n我在你基础上改了一下，但是我的逻辑不合理\r\nhttps://github.com/dissipator/xiaomusic\n## 评论\n\n### 评论 1 - hanxi\n建议通过插件实现或者新增一个页面工具把歌单导出 json 。\r\n歌单的 json 格式见 /issues/78.html\n---\n\n### 评论 2 - qiujie8092916\n> 利用 NeteaseCloudMusicApi 获取歌单和播放地址 我在你基础上改了一下，但是我的逻辑不合理 [dissipator/xiaomusic](https://github.com/dissipator/xiaomusic)\r\n\r\n老哥在实现插件了吗？我也急需播放歌单\r\n我诉求是：我用网易云音乐单独新建了一个歌单，我往里面扔歌曲，以更新歌单。希望创建一个自定义的语音命令，让小爱同学随机播放这个歌单里的音乐。然后我通过在米家里执行，比如触发了「我回来了」的智能场景时，就让小爱音箱执行这个自定义的语音命令，就会自动播放我新建的这个歌单里的音乐了。\r\n现在的小爱音箱虽然能勉强实现，但是很垃圾。随机播放的随机性有问题，并且只能选择歌单里的 30 首歌。\r\n（老哥如果没实现的话，我可以尝试搞搞）\n---\n\n### 评论 3 - dissipator\n我都能直接利用这个直接播放NeteaseCloudMusicApi这上的歌了。在配合unblk,无敌。我就是没设备，还在路上\r\n通过插件实现，非常好，就是不知道怎么开发，有文档我可以尝试一下。\n---\n\n### 评论 4 - dissipator\n> 建议通过插件实现或者新增一个页面工具把歌单导出 json 。 歌单的 json 格式见 #78\r\n\r\n\r\n配置处直接填了api的接口\r\nhttp://127.0.0.1:3000/playlist/detail?id=12758992226\r\n我是直接再你歌单保存上强改的。\r\n\r\n```python\r\nasync def downloadjson(data: UrlInfo, Verifcation=Depends(verification)):\r\n log.info(data)\r\n url = data.url\r\n content = \"[{\"\r\n host = f\"{url.split('/')[0]}//{url.split('/')[2]}\"\r\n try:\r\n ret = \"OK\"\r\n jsons = await downloadfile(url,\"json\")\r\n # print(jsons)\r\n list_name = jsons['playlist']['name']\r\n content += '\"name\":\"'+list_name+'\",\"musics\":['\r\n for song in jsons['playlist']['tracks']:\r\n content += f\"{{\\\"name\\\":\\\"{song['name']}\\\",\\\"url\\\": \\\"{host}/song/url?br=999000&proxy=http:%2F%2F127.0.0.1:8080&realIP=211.161.244.70&id={song['id']}\\\"}}\"\r\n except Exception as e:\r\n log.exception(f\"Execption {e}\")\r\n ret = \"Download JSON file failed.\"\r\n content = content[:-1] + \"]}]\"\r\n```\r\n照着你的说明。而且能成功播发\r\n\r\n```python\r\n@app.get(\"/musicinfo\")\r\nasync def musicinfo(\r\n name: str, musictag: bool = False, Verifcation=Depends(verification)\r\n):\r\n url = xiaomusic.get_music_url(name)\r\n if(\"song/url\" in url):\r\n jsons = await downloadfile(url,\"json\")\r\n url = jsons['data'][0]['url']\r\n```\r\n播放处加了一个判断\n---\n\n### 评论 5 - hanxi\n> > 建议通过插件实现或者新增一个页面工具把歌单导出 json 。 歌单的 json 格式见 #78\r\n\r\n你的修改我看了，不太通用。生成json，再用现有的接口提交json更通用。\n---\n\n### 评论 6 - dissipator\n是的，不通用。最好是用插件实现。\r\n1. 就是不知道你插件的逻辑。\r\n2. 如果用插件就考虑直接读取网易账号下所有歌单。然后选择一个导入，或者全部导入。\r\n3. 等你完善文档后我可以尝试写一个。同理，qq等其他平台的歌单也就都可以弄了\n---\n\n### 评论 7 - hanxi\n等有空我写个修改歌单内容的插件示例吧。\n---\n\n### 评论 8 - dissipator\n```\r\nimport requests\r\n\r\ndef getmy_playlist(type=\"netease\",api_host=\"http://127.0.0.1/api\", playlist_id=None,uid=None):\r\n \"\"\"\r\n Purpose: \r\n \"\"\"\r\n global log, xiaomusic\r\n if type == \"netease\":\r\n if uid:\r\n api_url = f\"{api_host}/user/playlist?uid={uid}\"\r\n # 发起请求\r\n response = requests.get(api_url, timeout=5) # 增加超时以避免长时间挂起\r\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\r\n # log.info(f\"getmy_playlist url:{api_url} response:{response.text}\")\r\n\r\n music_list = response.json()\r\n for item in music_list['playlist']:\r\n list_name = item.get(\"name\")\r\n\r\n log.info(f\"getmy_playlist name:{list_name}\")\r\n # if item.get(\"id\") in [12709941656,]:\r\n songs_url = f\"{api_host}/playlist/detail?id={item['id']}\"\r\n # 发起请求\r\n response = requests.get(songs_url, timeout=5) # 增加超时以避免长时间挂起\r\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\r\n # log.info(f\"getmy_playlist url:{api_url} response:{response.text}\")\r\n musics = response.json()\r\n one_music_list = []\r\n for music in musics['playlist']['tracks']:\r\n if (not music):\r\n continue\r\n # try:\r\n name = music['name']\r\n picUrl = music['al']['picUrl']\r\n artist = music['ar'][0]['name']\r\n album = music['al']['name']\r\n\r\n name = music.get(\"name\")\r\n url = f\"{api_host}/song/url?id={music['id']}&br=350000&realIP=211.161.244.70&proxy=HTTP:%2F%2F127.0.0.1:8080\"\r\n if (not name) or (not url):\r\n continue\r\n xiaomusic.all_music[name] = url\r\n xiaomusic.all_music_tags[name] = {\r\n \"title\": name,\r\n \"artist\": artist,\r\n \"album\": album,\r\n \"year\": \"\",\r\n \"genre\": \"\",\r\n \"picture\": picUrl,\r\n \"lyrics\": \"\"\r\n }\r\n \r\n one_music_list.append(name)\r\n log.debug(f\"getmy_playlist name:{list_name}\")\r\n log.debug(one_music_list)\r\n # 歌曲名字相同会覆盖\r\n xiaomusic.music_list[list_name] = one_music_list\r\n xiaomusic.try_save_tag_cache()\r\n log.debug(xiaomusic.all_music)\r\n log.debug(xiaomusic.music_list)\r\n\r\n return\r\n if playlist_id:\r\n songs_url = f\"{api_host}/playlist/detail?id={playlist_id}\"\r\n # 发起请求\r\n response = requests.get(songs_url, timeout=5) # 增加超时以避免长时间挂起\r\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\r\n # log.info(f\"getmy_playlist url:{api_url} response:{response.text}\")\r\n musics = response.json()\r\n list_name = musics['playlist']['name']\r\n one_music_list = []\r\n for music in musics['playlist']['tracks']:\r\n if (not music):\r\n continue\r\n # try:\r\n name = music['name']\r\n picUrl = music['al']['picUrl']\r\n artist = music['ar'][0]['name']\r\n album = music['al']['name']\r\n\r\n name = music.get(\"name\")\r\n url = f\"{api_host}/song/url?id={music['id']}&br=350000&realIP=211.161.244.70&proxy=HTTP:%2F%2F127.0.0.1:8080\"\r\n if (not name) or (not url):\r\n continue\r\n xiaomusic.all_music[name] = url\r\n xiaomusic.all_music_tags[name] = {\r\n \"title\": name,\r\n \"artist\": artist,\r\n \"album\": album,\r\n \"year\": \"\",\r\n \"genre\": \"\",\r\n \"picture\": picUrl,\r\n \"lyrics\": \"\"\r\n }\r\n one_music_list.append(name)\r\n log.debug(f\"getmy_playlist name:{list_name}\")\r\n log.debug(one_music_list)\r\n # 歌曲名字相同会覆盖\r\n xiaomusic.music_list[list_name] = one_music_list\r\n xiaomusic.try_save_tag_cache()\r\n log.debug(xiaomusic.all_music)\r\n log.debug(xiaomusic.music_list)\r\n return\r\n else:\r\n log.error(f\"getmy_playlist type:{type} not support\")\r\n\r\n\r\n```\r\n \n---\n\n### 评论 9 - dissipator\n> 等有空我写个修改歌单内容的插件示例吧。\r\n\r\n不用拉，插件我已经写出来了\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/53e593e7-1439-4968-9549-8c84b2fee42c)\r\n\r\n\n---\n\n### 评论 10 - hanxi\n发下你的 setting.json 配置吧，方便他人知道怎么配。\n---\n\n### 评论 11 - dissipator\n我还在测试，设备到了能用了再发吧\n---\n\n### 评论 12 - guitarbug\n也需要网易歌单功能, 坐等教程\n---\n\n### 评论 13 - dissipator\n# 成功了\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/33e22665-b1cc-4069-9e8c-46e466679b30)\r\n# 最好是在setting.json里去配置，我测试老是不匹配，在setting.json里去配置终于成功。可以直接调用 [NeteaseCloudMusicApi](http://localhost:3000/docs/#/?id=neteasecloudmusicapi) 接口，甚至使用UnblockNeteaseMusic 解锁灰色，但是代码需要小调整。\r\n\r\nsetting.json\r\n\r\n```json\r\n{\r\n \"account\": \"\",\r\n \"password\": \"\",\r\n \"mi_did\": \"\",\r\n \"miio_tts_command\": \"\",\r\n \"cookie\": \"\",\r\n \"verbose\": false,\r\n \"music_path\": \"music\",\r\n \"download_path\": \"music/download\",\r\n \"conf_path\": \"conf\",\r\n \"cache_dir\": \"cache\",\r\n \"hostname\": \"192.168.2.5\",\r\n \"port\": 8090,\r\n \"public_port\": 0,\r\n \"proxy\": \"\",\r\n \"search_prefix\": \"bilisearch:\",\r\n \"ffmpeg_location\": \"./ffmpeg/bin\",\r\n \"active_cmd\": \"play,set_random_play,playlocal,play_music_list,play_music_list_index,stop_after_minute,stop,获取歌单\",\r\n \"exclude_dirs\": \"@eaDir,tmp\",\r\n \"music_path_depth\": 10,\r\n \"disable_httpauth\": true,\r\n \"httpauth_username\": \"\",\r\n \"httpauth_password\": \"\",\r\n \"music_list_url\": \"\",\r\n \"music_list_json\": \"\",\r\n \"custom_play_list_json\": \"\",\r\n \"disable_download\": false,\r\n \"key_word_dict\": {\r\n \"播放歌曲\": \"play\",\r\n \"播放本地歌曲\": \"playlocal\",\r\n \"关机\": \"stop\",\r\n \"下一首\": \"play_next\",\r\n \"上一首\": \"play_prev\",\r\n \"单曲循环\": \"set_play_type_one\",\r\n \"全部循环\": \"set_play_type_all\",\r\n \"随机播放\": \"set_random_play\",\r\n \"分钟后关机\": \"stop_after_minute\",\r\n \"播放列表\": \"play_music_list\",\r\n \"刷新列表\": \"gen_music_list\",\r\n \"加入收藏\": \"add_to_favorites\",\r\n \"收藏歌曲\": \"add_to_favorites\",\r\n \"取消收藏\": \"del_from_favorites\",\r\n \"播放列表第\": \"play_music_list_index\",\r\n \"本地播放歌曲\": \"playlocal\",\r\n \"放歌曲\": \"play\",\r\n \"暂停\": \"stop\",\r\n \"停止\": \"stop\",\r\n \"停止播放\": \"stop\",\r\n \"播放歌单\": \"play_music_list\",\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\",\r\n \"获取歌单\": \"exec#getmy_playlist(playlist_id=12758992225)\"\r\n },\r\n \"key_match_order\": [\r\n \"分钟后关机\",\r\n \"播放歌曲\",\r\n \"下一首\",\r\n \"上一首\",\r\n \"单曲循环\",\r\n \"全部循环\",\r\n \"随机播放\",\r\n \"关机\",\r\n \"刷新列表\",\r\n \"播放列表第\",\r\n \"播放列表\",\r\n \"加入收藏\",\r\n \"收藏歌曲\",\r\n \"取消收藏\",\r\n \"播放本地歌曲\",\r\n \"本地播放歌曲\",\r\n \"放歌曲\",\r\n \"暂停\",\r\n \"停止\",\r\n \"停止播放\",\r\n \"播放歌单\",\r\n \"测试自定义口令\",\r\n \"测试链接\",\r\n \"获取歌单\"\r\n ],\r\n \"use_music_api\": false,\r\n \"use_music_audio_id\": \"1582971365183456177\",\r\n \"use_music_id\": \"355454500\",\r\n \"log_file\": \"/tmp/xiaomusic.txt\",\r\n \"fuzzy_match_cutoff\": 0.6,\r\n \"enable_fuzzy_match\": true,\r\n \"stop_tts_msg\": \"收到,再见\",\r\n \"enable_config_example\": false,\r\n \"keywords_playlocal\": \"播放本地歌曲,本地播放歌曲\",\r\n \"keywords_play\": \"播放歌曲,放歌曲\",\r\n \"keywords_stop\": \"关机,暂停,停止,停止播放\",\r\n \"keywords_playlist\": \"播放列表,播放歌单\",\r\n \"user_key_word_dict\": {\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\",\r\n \"获取歌单\": \"exec#getmy_playlist(playlist_id=12758992225)\"\r\n },\r\n \"enable_force_stop\": false,\r\n \"devices\": {\r\n \" \": {\r\n \"did\": \" \",\r\n \"device_id\": \" -17c6-4204- - \",\r\n \"hardware\": \"L05C\",\r\n \"name\": \"小黑你好\",\r\n \"play_type\": \"\",\r\n \"cur_music\": \"\",\r\n \"cur_playlist\": \"\"\r\n }\r\n },\r\n \"group_list\": \"\",\r\n \"remove_id3tag\": false,\r\n \"convert_to_mp3\": false,\r\n \"delay_sec\": 3,\r\n \"continue_play\": false,\r\n \"pull_ask_sec\": 1,\r\n \"crontab_json\": \"\",\r\n \"enable_yt_dlp_cookies\": false,\r\n \"get_ask_by_mina\": false\r\n}\r\n```\r\n\r\ngetmy_playlist.py\r\n\r\n```python\r\nimport requests\r\n\r\nasync def getmy_playlist(type=\"netease\",api_host=\"http://127.0.0.1/api\", playlist_id=None,uid=None):\r\n \"\"\"\r\n Purpose: \r\n \"\"\"\r\n global log, xiaomusic\r\n if type == \"netease\":\r\n if uid:\r\n api_url = f\"{api_host}/user/playlist?uid={uid}\"\r\n # 发起请求\r\n response = requests.get(api_url, timeout=5) # 增加超时以避免长时间挂起\r\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\r\n # log.info(f\"getmy_playlist url:{api_url} response:{response.text}\")\r\n\r\n music_list = response.json()\r\n for item in music_list['playlist']:\r\n list_name = item.get(\"name\")\r\n\r\n log.info(f\"getmy_playlist name:{list_name}\")\r\n # if item.get(\"id\") in [12709941656,]:\r\n songs_url = f\"{api_host}/playlist/detail?id={item['id']}\"\r\n # 发起请求\r\n response = requests.get(songs_url, timeout=5) # 增加超时以避免长时间挂起\r\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\r\n # log.info(f\"getmy_playlist url:{api_url} response:{response.text}\")\r\n musics = response.json()\r\n one_music_list = []\r\n for music in musics['playlist']['tracks']:\r\n if (not music):\r\n continue\r\n # try:\r\n name = music['name']\r\n picUrl = music['al']['picUrl']\r\n artist = music['ar'][0]['name']\r\n album = music['al']['name']\r\n\r\n name = music.get(\"name\")\r\n url = f\"{api_host}/song/url?id={music['id']}&br=350000&realIP=211.161.244.70&proxy=HTTP:%2F%2F127.0.0.1:8080\"\r\n if (not name) or (not url):\r\n continue\r\n xiaomusic.all_music[name] = url\r\n xiaomusic.all_music_tags[name] = {\r\n \"title\": name,\r\n \"artist\": artist,\r\n \"album\": album,\r\n \"year\": \"\",\r\n \"genre\": \"\",\r\n \"picture\": picUrl,\r\n \"lyrics\": \"\"\r\n }\r\n\r\n one_music_list.append(name)\r\n log.debug(f\"getmy_playlist name:{list_name}\")\r\n log.debug(one_music_list)\r\n # 歌曲名字相同会覆盖\r\n xiaomusic.music_list[list_name] = one_music_list\r\n xiaomusic.try_save_tag_cache()\r\n log.debug(xiaomusic.all_music)\r\n log.debug(xiaomusic.music_list)\r\n return\r\n if playlist_id:\r\n songs_url = f\"{api_host}/playlist/detail?id={playlist_id}\"\r\n # 发起请求\r\n response = requests.get(songs_url, timeout=5) # 增加超时以避免长时间挂起\r\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\r\n \r\n musics = response.json()\r\n list_name = musics['playlist']['name']\r\n log.info(f\"getmy_playlist list_name:{list_name} \")\r\n one_music_list = []\r\n for music in musics['playlist']['tracks']:\r\n if (not music):\r\n continue\r\n # try:\r\n name = music['name']\r\n picUrl = music['al']['picUrl']\r\n artist = music['ar'][0]['name']\r\n album = music['al']['name']\r\n\r\n name = music.get(\"name\")\r\n url = f\"{api_host}/song/url?id={music['id']}&br=350000&proxy=HTTP:%2F%2F127.0.0.1:8080\"\r\n if (not name) or (not url):\r\n continue\r\n xiaomusic.all_music[name] = url\r\n xiaomusic.all_music_tags[name] = {\r\n \"title\": name,\r\n \"artist\": artist,\r\n \"album\": album,\r\n \"year\": \"\",\r\n \"genre\": \"\",\r\n \"picture\": picUrl,\r\n \"lyrics\": \"\"\r\n }\r\n one_music_list.append(name)\r\n log.debug(f\"getmy_playlist name:{list_name}\")\r\n log.debug(one_music_list)\r\n # 歌曲名字相同会覆盖\r\n xiaomusic.music_list[list_name] = one_music_list\r\n xiaomusic.try_save_tag_cache()\r\n return\r\n else:\r\n log.error(f\"getmy_playlist type:{type} not support\")\r\n\r\n```\r\n\n---\n\n### 评论 14 - dissipator\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/7412eec4-f7d3-4a86-b186-0118d6f331ff)\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/2215e520-0d40-4c2c-8d46-d3106d65fc51)\r\n\n---\n\n### 评论 15 - dludream\nNeteaseCloudMusicApi似乎获取不到播放地址？其他信息倒是有。\r\n\r\n![2024-11-28_151952](https://gproxy.hanxi.cc/proxy/user-attachments/assets/c7e7a748-aa82-47f0-8784-f6469cc3e99b)\r\n\n---\n\n### 评论 16 - hanxi\n看代码是另一个接口获取url的： `url = f\"{api_host}/song/url?id={music['id']}&br=350000&realIP=211.161.244.70&proxy=HTTP:%2F%2F127.0.0.1:8080\"`\n---\n\n### 评论 17 - dludream\n> 看代码是另一个接口获取url的： `url = f\"{api_host}/song/url?id={music['id']}&br=350000&realIP=211.161.244.70&proxy=HTTP:%2F%2F127.0.0.1:8080\"`\r\n\r\n是的，我用的是这个接口，https://registry.hub.docker.com/r/gnehs/neteasecloudmusicapi-docker/\r\n\r\n可能网易修改了api，这些获取不了播放地址了。\r\n\r\n我倒不是要这个功能，只是感兴趣看看。我不获取，我直接用yt把歌全下载下来播放。\n---\n\n### 评论 18 - dissipator\n这个不是网易的接口，是[NeteaseCloudMusicApi](http://localhost:3000/docs/#/?id=neteasecloudmusicapi) 接口。proxy=HTTP:%2F%2F127.0.0.1:8080\"是UnblockNeteaseMusic 解锁灰色；\r\n完整的使用方式和docker 可以到 https://github.com/dissipator/xiaomusic/tree/dev 看README.md；目前没有教程。本人就在群2，有问题可以找我。\n---\n\n### 评论 19 - beibei2a\n> ![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/7412eec4-f7d3-4a86-b186-0118d6f331ff) ![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/2215e520-0d40-4c2c-8d46-d3106d65fc51)\n\n“请问 registry.cn-chengdu.aliyuncs.com/dissipator/xiaomusic:dev 有没有 ARM64 版本？我用 ARMv8 设备运行时遇到 exec format error。”\n---\n\n### 评论 20 - hanxi\n我的镜像是有的，他的镜像没试过。\n---\n\n### 评论 21 - dissipator\n没有\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/269)\n" }, { "path": "docs/issues/285.md", "content": "---\ntitle: 相关工具推荐\n---\n# 相关工具推荐\n- [xhongc/music-tag-web 刮削音乐歌词图片](https://github.com/xhongc/music-tag-web)\n- [onlyLTY/dockerCopilot 一键更新容器](https://github.com/onlyLTY/dockerCopilot)\n- [tiny-nav 非常简单的导航网站，NAS部署](https://github.com/hanxi/tiny-nav)\n## 评论\n\n### 评论 1 - F-loat\n借楼加个小程序的图 :partying_face: https://github.com/F-loat/xiaoplayer\r\n\r\n### 小程序码\r\n\r\n

\r\n \"weapp\"\r\n

\r\n\r\n### 截图\r\n\r\n

\r\n \r\n \r\n \r\n \r\n

\n---\n\n### 评论 2 - hanxi\n@F-loat 可以在欢迎页加个链接显示小程序码。\n---\n\n### 评论 3 - F-loat\n@hanxi 可以的，这样还能自动把 ip 用参数带过来，我有空搞一下\n---\n\n### 评论 4 - sparkyuanquan\n> 借楼加个小程序的图 🥳 https://github.com/F-loat/xiaoplayer\n> \n> ### 小程序码\n> \"weapp\"\n> \n> ### 截图\n> \"\" \"\" \"\" \"\"\n\n你好，麻烦问一下，只能内网播放吗？我在路由上映射了8090端口， 在家外小程序可以看到NAS上的歌曲，也能控制音箱进行播放，，但是手机本机直接播放失败，麻烦问一下，是否可以在外面直接小程序播放NAS音乐，这样就不用安装像音流 DS Audio那些NAS的那些音乐播放器了。\n---\n\n### 评论 5 - F-loat\n@sparkyuanquan 可以本机直接播放的，之前部分场景判断有问题，应该已经修复了，重启下小程序试试\n---\n\n### 评论 6 - sparkyuanquan\n小程序删了，重开，我用手机的5G网络微信小程序登录后可以看到歌曲，在手机上播放音乐就转圈，过差不多一分钟左右，显示 INNERERRCODE:-1001，ERRMSG:请求超时。我在路由上把xiaomusic的8090端口映射到了外网60000。\n---\n\n### 评论 7 - sparkyuanquan\n发现问题在哪了，如果直接映射8090到外网8090，就可以播放，但是如果8090映射到60000不行。我继续试试nginx反代https看看\n---\n\n### 评论 8 - sparkyuanquan\n原来是要内网服务器地址和公网服务器地址都要填写， 内网写8090端口，公网写60000端口才行，单写公网服务器地址不写内网服务器地址就会有上面的问题。\n---\n\n### 评论 9 - F-loat\n@sparkyuanquan 我有空再看一下，应该只写公网也要可以的\n---\n\n### 评论 10 - wyyang1978-debug\n支持IPV6 外网访问么？ 地址格式是怎样的?我用http://[ ]:port 格式无法访问\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/285)\n" }, { "path": "docs/issues/294.md", "content": "---\ntitle: 关于M01型号的注意事项\n---\n# 关于M01型号的注意事项\nM01:在0.3.55版本【型号兼容模式】与【特殊型号获取对话记录】都设为false或true，都可以语音了。\r\n 如果【型号兼容模式】为 true，默认UI显示播放中，但音箱没声音。\r\n\r\n型号:S12A、LX04、S12 在米家APP可以联动，比如客厅有人自定义指令:播放歌曲、关机...等\r\n 而M01无论【型号兼容模式】与【特殊型号获取对话记录】设为false或true，都无法执行任何自定义指令…\r\n\r\n![IMG_6460](https://gproxy.hanxi.cc/proxy/user-attachments/assets/0913e3fa-1f1a-47b0-b8b9-d308bd7793df)\r\n\n## 评论\n\n### 评论 1 - hanxi\nM01 保持默认设置应该是能语音和播放的吧。自定义指令的功能应该是 M01 本身就不支持，可能属于放弃维护的产品吧。\n---\n\n### 评论 2 - bj803\n> M01 保持默认设置应该是能语音和播放的吧。自定义指令的功能应该是 M01 本身就不支持，可能属于放弃维护的产品吧。\r\n\r\n刚试了用:pause是可以暂停(不过只暂2分钟左右又自己播放了)\n---\n\n### 评论 3 - hanxi\n只能网页里点关机按钮，或者语音关机。所有型号都一样。\n---\n\n### 评论 4 - bj803\n> 型号:S12A、LX04、S12\r\n\r\n\r\n\r\n> 只能网页里点关机按钮，或者语音关机。所有型号都一样。\r\n\r\n在型号:S12A、LX04、S12 除了能网页里点关机按钮或者语音开关机外，能在米家APP自定义指令进行播放与关机(例如当客厅客有人自定义指令\"播放歌曲\"，无人自定义指令\"关机\"。M01自定义指令\"pause\"可以暂停，其他口令不行。\n---\n\n### 评论 5 - bj803\n刚又试了一下，用自定义play stop、power off可以停止播放关机，用自定义play music可以播放音乐，可能M01不需要下划线\n---\n\n### 评论 6 - hanxi\n感谢你的反馈。\n---\n\n### 评论 7 - CrazyJasonwell\nLX04不能识别，为找到小爱音箱。。。\n---\n\n### 评论 8 - hanxi\n> LX04不能识别，为找到小爱音箱。。。\n\n找不到设备是登录问题。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/294)\n" }, { "path": "docs/issues/297.md", "content": "---\ntitle: xiaomusic极空间安装教程（2024/12/28更新）\n---\n# xiaomusic极空间安装教程（2024-12-28更新）\n> 本教程同步更新于最新版的xiaomusic\r\n\r\n看不懂/嫌麻烦/懒 但有点小钱，找 hanxi 预约微信或者 QQ 远程安装，他便宜，收费50一次，作法不成功不要钱\r\n\r\n**ARM架构自己想办法获取镜像 点名Z2PRO**\r\n\r\n# 获取镜像\r\n\r\n## 科学环境：\r\n\r\n1. 在 **搜索框** 中输入 `hanxi/xiaomusic`，在搜索的结果中直接选择第一个，点击**下载**\r\n\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/ef18b479-aef3-4e76-a299-6f220fc9e549)\r\n\r\n2. 在新弹出的版本选择窗口中，根据你的情况选择。\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/20dd0b64-9223-47ae-a3e4-0b0af05796f8)\r\n\r\n### 版本说明\r\n- 获取 **最新版** 直接点击 **下载** 即可，建议使用默认的 `latest`\r\n- 获取 **特定版本** [点击此处可查看](https://github.com/hanxi/xiaomusic/releases) 用于回退出现功能不兼容、恶性bug等情况，一般建议反馈开发者，修复很及时，尽量不要回退版本 请输入如 `v0.3.55`\r\n- 获取 **实验版本**（已修复部分bug但未推送）请输入 `main` \r\n\r\n\r\n3. 接着弹出如图所示的页面，耐心等待下载完成。\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/5ea2621a-bba5-4269-b896-0e6ca323beb8)\r\n\r\n\r\n4. 下载完成后切换到 **本地镜像** 选项卡\r\n\r\n剩余步骤与国内环境相同，见 [部署镜像](#部署镜像)\r\n\r\n## 国内环境：\r\n1. 打开docker，在左侧的菜单中选择 **镜像** 切换到 **仓库** 选项卡，点击 **自定义拉取** 按钮\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/bf4ac64e-ce50-4456-bc7b-05530b5abc1b)\r\n2. 在弹出的对话框中输入 ` m.daocloud.io/docker.io/hanxi/xiaomusic ` ，点击 **拉取** 按钮\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/a8f91db7-eac9-472d-a920-a77c280bbc5e)\r\n3. 下载完成后切换到 **本地镜像** 选项卡\r\n\r\n# 部署镜像\r\n1. 找到刚才已经拉取好的镜像，*单击选中*，点击 **添加到容器**\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6e0bcf60-d1aa-46ac-9053-5ad957f3d509)\r\n2. 在弹出的 **创建容器** 菜单中，切换到 **文件夹路径** 选项卡中，按图中的提示进行配置。\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/cca8bc1c-de8f-4d03-81eb-a0f2b06c121e)\r\n\r\n**注意：**\r\n* 装载路径中的 **配置文件目录** 和 **音乐目录** 必须进行配置，**其他目录非必要请勿配置**\r\n* 主题目录为方便开发主题调试时的配置选项，普通用户不能理解明确用途请**不要配置主题目录**，否则会报**HTTP Status 500 – Internal Server Error** 错误\r\n* 如有多个音乐目录，请按照下面的格式进行配置\r\n\r\n| 文件/文件夹 | 装载路径 | \r\n| :----------: | :----------: |\r\n| /data/music1 | /app/music/music1 |\r\n| /data/music2 | /app/music/music2 |\r\n\r\n3. 切换到 **端口** 选项卡，修改成与你的极空间 *不冲突* 的本地端口号，如 `5678` （示例按照本地端口号5678来进行配置，下同）\r\n> 友情提醒: 尽量不要修改容器端口号，否则要到配置文件目录修改对应的`setting.json`文件中的配置，会增加很多麻烦\r\n\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/182b32ef-d91f-47c5-ba9d-7ef3542ebf40)\r\n\r\n5. 切换到 **环境** 选项卡，将`XIAOMUSIC_HOSTNAME` 修改为你的 **极空间的IP地址** \r\n> 友情提醒：\r\n> 1. 此处不可忽略，否则后续播放音乐会出现问题\r\n> 2. 不要尝试修改XIAOMUSIC_PORT！除非你没有看上一条的友情提醒\r\n> 3. 不要在此处配置`ACCOUNT`和`PASSWORD`，没有过风控仍然无法使用！上古时代的教程不要再看了，容易走火入魔！\r\n\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/b41b7359-f2b9-4ad8-b2a2-0ce2a1601739)\r\n\r\n6. 点击 **应用**按钮，此时容器已经配置完成了，切换到左侧的 **容器概况** 菜单，可查看容器详情\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/5c5b3497-49d8-4f17-9acb-6d1e551caf4f)\r\n\r\n# 进入xiaomusic网页端进行配置\r\n1.请关闭代理，打开浏览器，地址栏输入 **极空间IP:本地端口号** 如`192.168.2.5:5678`，打开网页后点击 **默认主题**\r\n\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/1b286d0f-f10e-46ff-89a0-cdff9e192f9b)\r\n\r\n **注意：** \r\n* 不要复制此处的地址，必须输入极空间的IP地址。不知道的建议上咸鱼50块换个不锈钢盆\r\n* 不要输入容器的端口号8090，极空间不能使用这个端口号。\r\n\r\n2. 点击 **设置** 按钮进入设置页面\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/f3aca07a-3663-4bb6-bb93-0329b2d4c433)\r\n\r\n3. 输入**小米账号**、**小米密码**、**XIAOMUSIC_HOSTNAME(IP或域名):**、**外网访问端口**，滑到页面最下方点击 **保存**\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/db03af0c-851a-4185-a7fd-b5b02b6d8d2b)\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/dd42a653-d364-4eec-9f87-efb3c52e57a7)\r\n\r\n**注意:**\r\n* 小米账号非手机号，请在手机设置-个人中心中查看小米ID\r\n* 密码不要输错，账号密码错误在上面会弹出提醒，不要假装看不见上面的提醒文字\r\n* XIAOMUSIC_HOSTNAME(IP或域名): 可以输入当前页面的IP地址（在地址栏），**不要在此处输入端口号！！！**，如果域名需要使用https协议，请加上https://\r\n\r\n4.如果以上步骤没错，你将在设置中心看见设备列表\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/04074894-6599-4b35-95ea-0618ed906d15)\r\n\r\n5. 回到首页，出现设备列表，切换对应设备即可畅享\r\n![图片](https://gproxy.hanxi.cc/proxy/user-attachments/assets/1ce4791f-7ae7-40b4-8c90-eca6b0799e19)\r\n\n## 评论\n\n### 评论 1 - xiaohuobanhahaha\n[xiaomusic.txt](https://github.com/user-attachments/files/18011572/xiaomusic.txt)\r\n\r\n\"截屏2024-12-05\r\nan'zh\r\n无法使用语音播放歌曲，小爱s12a。极空间z4pro。\r\n1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090.\r\n2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传\n---\n\n### 评论 2 - 52fisher\n> [xiaomusic.txt](https://github.com/user-attachments/files/18011572/xiaomusic.txt)\r\n> \"截屏2024-12-05 an'zh 无法使用语音播放歌曲，小爱s12a。极空间z4pro。 1. 按照教程，点击播放本地歌曲，提示hostname和设置的端口映射不匹配。映射5678，容器端口8090. 2.网络host模式，能够本地播放，无法使用语音控制，提示“下载app”。日志已上传\r\n\r\n既然你映射的5678，为什么你又在那把监听端口改成11999? 我的教程里面全程没有写要修改监听端口\n---\n\n### 评论 3 - xiaohuobanhahaha\n我没讲清楚。我试了两种极空间的桥接和host模式。桥接模式。我按照教程走的。报错如图\r\n\"截屏2024-12-05\r\n\"截屏2024-12-05\r\n\"截屏2024-12-05\r\n\"截屏2024-12-05\r\n\r\n提到的第二个问题和日志，是我将网络模式改为host的情况，能连上音箱，但是没法使用语音控制。\r\n\n---\n\n### 评论 4 - 52fisher\n> 我没讲清楚。我试了两种极空间的桥接和host模式。桥接模式。我按照教程走的。报错如图 \"截屏2024-12-05 \"截屏2024-12-05 \"截屏2024-12-05 \"截屏2024-12-05\r\n> \r\n> 提到的第二个问题和日志，是我将网络模式改为host的情况，能连上音箱，但是没法使用语音控制。\r\n\r\n把外网访问端口改成5678\n---\n\n### 评论 5 - xiaohuobanhahaha\n可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。\r\n这是日志，\r\n[xiaomusic.txt](https://github.com/user-attachments/files/18012369/xiaomusic.txt)\n---\n\n### 评论 6 - 52fisher\n> 可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， [xiaomusic.txt](https://github.com/user-attachments/files/18012369/xiaomusic.txt)\r\n\r\n\r\n你的设置 hostname='192.168.31.165', port=8090, public_port=5678, \r\n后台的ip 192.168.31.143 检查一下你的地址 有可能是你的ip地址改变了\n---\n\n### 评论 7 - xiaohuobanhahaha\n> > 可以连接上网页控制了，但是语音控制仍然不行。已经按照FAQ问题集合 #99 重启docker。 这是日志， [xiaomusic.txt](https://github.com/user-attachments/files/18012369/xiaomusic.txt)\r\n> \r\n> 你的设置 hostname='192.168.31.165', port=8090, public_port=5678, 后台的ip 192.168.31.143 检查一下你的地址 有可能是你的ip地址改变了\r\n\r\n确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。\n---\n\n### 评论 8 - 52fisher\n> 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。\r\n\r\n容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧\n---\n\n### 评论 9 - xiaohuobanhahaha\n\"截屏2024-12-05\r\n\"截屏2024-12-05\r\n\r\n\r\n> > 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。\r\n> \r\n> 容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧\r\n\r\n辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。\n---\n\n### 评论 10 - 52fisher\n> \"截屏2024-12-05 \"截屏2024-12-05\r\n> \r\n> > > 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。\r\n> > \r\n> > \r\n> > 容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧\r\n> \r\n> 辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。\r\n\r\n[readme](https://github.com/hanxi/xiaomusic?tab=readme-ov-file#-%E8%AE%A8%E8%AE%BA%E5%8C%BA)\n---\n\n### 评论 11 - xiaohuobanhahaha\n> > \"截屏2024-12-05 \"截屏2024-12-05\r\n> > > > 确实是变了。192.168.31.143是我电脑的ip。 hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主路由dhcp都绑定了。 大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。\r\n> > > \r\n> > > \r\n> > > 容器的网络模式改成bridge试试呢 没解决的话你加群明天再详聊吧\r\n> > \r\n> > \r\n> > 辛苦了，这么晚还在回复。我一直用的bridge。大佬，群号多少，不行我明天群里问吧。\r\n> \r\n> [readme](https://github.com/hanxi/xiaomusic?tab=readme-ov-file#-%E8%AE%A8%E8%AE%BA%E5%8C%BA)\r\n\r\n已自查解决。问题是账号问题。绑定设备的一定是创建者，不能是管理员。\n---\n\n### 评论 12 - McCree2020\n这个主题目录不能设置吧？没人遇到这个issue？我原来用的张大妈平台的教程设置的，能用，后来看到这个教程后就修改了后台的路径映射，但是dockers启动正常，网页不能打开提示internal sever error，后来ssh进docker看了日志文件 提示static那个路径有问题，下边的index什么的文件找不到， 删除主题映射以后，重启docker后，网页正常显示了\n---\n\n### 评论 13 - 52fisher\n> 这个主题目录不能设置吧？没人遇到这个issue？我原来用的张大妈平台的教程设置的，能用，后来看到这个教程后就修改了后台的路径映射，但是dockers启动正常，网页不能打开提示internal sever error，后来ssh进docker看了日志文件 提示static那个路径有问题，下边的index什么的文件找不到， 删除主题映射以后，重启docker后，网页正常显示了\r\n\r\n要注意看提示：\r\n装载路径中的 配置文件目录 和 音乐目录 必须进行配置。\r\n\r\n其他的路径非必要不要配置，主题目录路径是方便开发调试的时候用的，普通用户不要映射主题目录。我已经把这个提示更新到文档中了\n---\n\n### 评论 14 - zxhans\n就不能让xiaomusic支持服务器部署吗？服务器部署为啥设备不能读取呢？home assistant 通过xiaomi home assistant都可以读取呀\n---\n\n### 评论 15 - hanxi\n> 就不能让xiaomusic支持服务器部署吗？服务器部署为啥设备不能读取呢？home assistant 通过xiaomi home assistant都可以读取呀\r\n\r\n支持服务器部署的，你需要在服务器上装个浏览器登陆过风控。\n---\n\n### 评论 16 - Lunder-R\n> > > \"截屏2024-12-05 \"截屏2024-12-05\n> > > > > 确实是变了。192.168.31.143是我电脑的ip。hostname='192.168.31.165'是极空间的。小爱是192.168.31.77。现在我的网络结构是电脑连nas上的istoreos旁路由。nas直连主路由，小爱直连主路由。主dhcp都绑定了。大佬，这种情况该怎么解决呢。所有设置都是默认，没修改哈。\n> > > > \n> > > > \n> > > > 容器的网络模式改成桥试用呢没解决的话你加群明天再详聊吧\n> > > \n> > > \n> > > 辛苦了，今天晚上还在回复。我一直用的桥。大佬，群号多少，不行我明天群里问吧。\n> > \n> > \n> > [自述](https://github.com/hanxi/xiaomusic?tab=readme-ov-file#-%E8%AE%A8%E8%AE%BA%E5%8C%BA)\n> \n> 自查解决。问题是已账号问题。绑定设备的一定是创建者，不能是管理员。\n\n能不能分享一下解决大概过程，我也是这种情况，谢谢了\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/297)\n" }, { "path": "docs/issues/312.md", "content": "---\ntitle: 同步网易云歌单\n---\n# 同步网易云歌单\n推广一波 [netease-playlist](https://github.com/qiujie8092916/netease-playlist) \r\n通过网易云音乐歌单 ID，下载歌曲或[生成歌单配置](/issues/269.html) \r\n本程序为独立模块，可 docker 部署，可作为不用[插件](/issues/105.html)的另外实现方式\n## 评论\n\n### 评论 1 - Ghost-Sam1222\n什么时候可以同步apple music歌单就真好了\n---\n\n### 评论 2 - fxchby\n试了一下，似乎用不了\n---\n\n### 评论 3 - qiujie8092916\n> 试了一下，似乎用不了\n\n哪里有问题\n---\n\n### 评论 4 - xcysy32\n这能实时同步吗🌹\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/312)\n" }, { "path": "docs/issues/333.md", "content": "---\ntitle: 设置项功能介绍\n---\n# 设置项功能介绍\n- XIAOMUSIC_ACTIVE_CMD 环境变量，对应后台的 【允许唤醒的命令】，用于唤醒口令，配置成'play,random_play'，在非播放状态下，只有这两个指令（播放歌曲和随机播放）可以触发，触发后，xiaomusic进入playing状态，其他指令则可以正常触发。具体见 \r\n- XIAOMUSIC_EXCLUDE_DIRS 配置歌曲目录里需要忽略的目录，对应后台的 【忽略目录】\r\n- XIAOMUSIC_MUSIC_PATH_DEPTH 配置歌曲目录搜索深度，对应后台的 【目录深度】，具体见 \r\n- XIAOMUSIC_DISABLE_HTTPAUTH 配置成 false 表示开启密码访问web控制台，对应后台的 【关闭密码验证】，具体见 \r\n- XIAOMUSIC_HTTPAUTH_USERNAME 配置 web 控制台用户，对应后台的 【控制台账户】\r\n- XIAOMUSIC_HTTPAUTH_PASSWORD 配置 web 控制台密码，对应后台的 【控制台密码】\r\n- XIAOMUSIC_CONF_PATH 用来存放配置文件的目录，对应后台的 【配置文件目录】，记得把目录映射到主机，默认为 `/app/config` ，具体见 \r\n- XIAOMUSIC_CACHE_DIR 用来音乐 tag 缓存，默认为 `/app/cache`，对应后台的 【缓存文件目录】。\r\n- XIAOMUSIC_DISABLE_DOWNLOAD 设为 true 时关闭下载功能，对应后台的 【关闭下载功能】，见 \r\n- XIAOMUSIC_USE_MUSIC_API 设为 true 时使用 player_play_music 接口播放音乐，对应后台的 【型号兼容模式】，用于兼容不能播放的型号，如果发现需要设置这个选项的时候请告知我加一下设备型号，方便以后不用设置。 见 \r\n- XIAOMUSIC_KEYWORDS_PLAY 用来播放歌曲的口令前缀，对应后台的 【播放歌曲口令】，默认是 \"播放歌曲,放歌曲\" ，可以用英文逗号分割配置多个\r\n- XIAOMUSIC_KEYWORDS_STOP 用来关机的口令，对应后台的 【停止口令】，默认是 \"关机,暂停,停止\" ，可以用英文逗号分割配置多个。\r\n- XIAOMUSIC_KEYWORDS_PLAYLOCAL 用来播放本地歌曲的口令前缀，对应后台的 【播放本地歌曲口令】，本地找不到时不会下载歌曲，默认是 \"播放本地歌曲,本地播放歌曲\" ，可以用英文逗号分割配置多个。\r\n- XIAOMUSIC_ENABLE_FUZZY_MATCH 设为 true 时开启模糊匹配（默认），设为 false 时关闭模糊匹配，对应后台的 【开启模糊搜索】，支持模糊匹配歌名和歌单名。 具体见 \r\n- XIAOMUSIC_FUZZY_MATCH_CUTOFF 设置模糊搜索匹配的最低相似度阈值（默认0.6，可以配0到1直接的小数），越小越模糊，越大越精准，对应后台的 【模糊匹配阈值】。具体见 \r\n- XIAOMUSIC_PUBLIC_PORT 用于设置外网端口，对应后台的 【外网访问端口】，当使用反向代理时可以设置为外网端口，XIAOMUSIC_HOSTNAME 设为外网IP或者域名即可。\r\n- XIAOMUSIC_DOWNLOAD_PATH 变量可以配置下载目录，默认为空，表示使用 music 目录为下载目录，对应后台的 【音乐下载目录】。设置这个目录必须是 music 的子目录，否则刷新列表后会找不到歌曲。具体见 \r\n- XIAOMUSIC_PROXY 用于配置国内使用 youtube 源下载歌曲时使用的代理，参数格式参考 yt-dlp 文档说明。 见 和 \r\n- MIIO_TTS_CMD 用于部分机型（如：`L05C`）使用 MiIO 支持 tts 能力，默认为空，命令选择见 [MiService-fork 文档](https://github.com/yihong0618/MiService)\r\n\n## 评论\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/333)\n" }, { "path": "docs/issues/350.md", "content": "---\ntitle: 播放本地歌曲无法切歌\n---\n# 播放本地歌曲无法切歌\n播放本地歌曲时，通过语音控制小爱音箱切歌（测试指令：小爱同学，切歌；小爱同学，播放下一首；），每次都是重新播放上一首歌曲；版本为docker最新版本[0.3.70]\n## 评论\n\n### 评论 1 - Leenshady\n测试出来了，只有“小爱同学，下一首”指令才能正常切歌\n---\n\n### 评论 2 - sam0773\n可以在conf文件夹的setting.json中把自己习惯的命令添加进去...\n---\n\n### 评论 3 - hanxi\n楼上正解。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/350)\n" }, { "path": "docs/issues/360.md", "content": "---\ntitle: docker compose 命令行安装教程\n---\n# docker compose 命令行安装教程\n本教程针对于有命令行环境，且已经安装好 docker compose 的用户。步骤超级简单，基本只要复制粘贴就能跑起来。如果需要修改路径或者端口，可以复制到编辑器，修改后再复制粘贴到命令行执行。编辑时注意不要修改到文件格式，包括缩进。\r\n\r\n## 创建 docker-compose.yml 文件\r\n\r\n假设 `docker-compose.yml` 文件的存放到路径为 `/xiaomusic/docker-compose.yml` 。执行下面的命令即可：\r\n\r\n```shell\r\nmkdir -p /xiaomusic\r\ncat < /xiaomusic/docker-compose.yml\r\nservices:\r\n xiaomusic:\r\n image: docker.hanxi.cc/hanxi/xiaomusic\r\n container_name: xiaomusic\r\n restart: unless-stopped\r\n ports:\r\n - 58090:8090\r\n environment:\r\n XIAOMUSIC_PUBLIC_PORT: 58090\r\n volumes:\r\n - /xiaomusic_conf:/app/conf\r\n - /xiaomusic_music:/app/music\r\nEOF\r\n```\r\n\r\n- `/xiaomusic_conf` 为配置文件存放目录，一般不需要修改。\r\n- `/xiaomusic_music` 为音乐存放目录，你可以替换为自己想要存放的目录，注意填绝对路径，在 Linux 下是 `/` 开头的，在 Windows 下是盘符开头，比如： `D:/music`。\r\n- 端口 8090 不要修改，是容器内的端口。\r\n- 端口 58090 可以修改，如果想要修改，两个 58090 都需要同时修改，这个端口是访问 web 后台的端口。\r\n\r\n## 启动\r\n\r\n```shell\r\ncd /xiaomusic\r\ndocker compose up -d\r\n```\r\n\r\n启动后，就能使用 来访问 web 后台了，把 nasip 替换成你的 nas 的 IP 。\r\n\r\n## 后台设置\r\n\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/424c45af-6937-4fee-bb7d-855973ef0d5d)\r\n\r\n填好账号密码，和自动填 IP 和端口，然后滚动到页面最下面，点击保存按钮。然后刷新设置页面，再勾选小爱音箱，再保存即可。\r\n\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/c63c3ff1-3a80-4f47-971e-761eb9187ae0)\r\n\r\n\r\n## 更新\r\n\r\n想要更新镜像，只需要复制粘贴下面的命令就行，注意 `/xiaomusic` 目录是 `docker-compose.yml` 文件所在的目录。\r\n\r\n```shell\r\ncd /xiaomusic\r\ndocker compose pull\r\ndocker compose up -d\r\n```\r\n\r\n## 关闭\r\n\r\n```shell\r\ncd /xiaomusic\r\ndocker compose down\r\n```\n## 评论\n\n### 评论 1 - tiger326\n我用这个是可以正常启动和搭建好xiaomusic, 一切都OK.\n不过我的NAS是qnap, 已禁用默认的admin用户, 使用自建的管理员账户登录.\n但这个配置会默认使用admin用户执行, 导致一旦产生tmp和download目录以及相关文件, 都归属于admin用户.\n结果我自建的用户在NAS上无法删除和编辑这些下载的文件.\n\nxiaomusic是否支持创建时指定用户和用户组? \n---\n\n### 评论 2 - hanxi\n@tiger326 把下面的 username 换成普通的用户名即可，换成 uid 数字也行，一般是 1000 \n\n```shell\nmkdir -p /xiaomusic\ncat < /xiaomusic/docker-compose.yml\nservices:\n xiaomusic:\n image: docker.hanxi.cc/hanxi/xiaomusic\n container_name: xiaomusic\n restart: unless-stopped\n user: username\n ports:\n - 58090:8090\n environment:\n XIAOMUSIC_PUBLIC_PORT: 58090\n volumes:\n - /xiaomusic_conf:/app/conf\n - /xiaomusic_music:/app/music\nEOF\n```\n---\n\n### 评论 3 - worrywast\n为啥我的播放完一首音乐之后，还会播放该歌曲开头一点点才会放下一首呢？\n---\n\n### 评论 4 - hanxi\n> 为啥我的播放完一首音乐之后，还会播放该歌曲开头一点点才会放下一首呢？\n\n正常现象。可以把延迟设置为0试试。\n\n---\n\n### 评论 5 - worrywast\n> > 为啥我的播放完一首音乐之后，还会播放该歌曲开头一点点才会放下一首呢？\n> \n> 正常现象。可以把延迟设置为0试试。\n\n是这个选项吗：“下一首歌延迟播放秒数:”\n我设置为0，也会有这个现象，只是没有之前播放开头那么多\n---\n\n### 评论 6 - hanxi\n@worrywast 等下个版本我优化一下，允许设置成负数吧。\n---\n\n### 评论 7 - worrywast\n> [@worrywast](https://github.com/worrywast) 等下个版本我优化一下，允许设置成负数吧。\n\n辛苦大佬~\n---\n\n### 评论 8 - hanxi\n@worrywast 现在就是可以填负数的，你可以试试看。\n---\n\n### 评论 9 - jkjoy\n我的一直 暂不支持下载本地 音乐。测试啥的都没问题\n---\n\n### 评论 10 - pjlpl\n为什么在控制面板可以手动播放本地歌曲，口令点播本地歌曲的时候不管加什么歌名，都回复本地不存在这个歌，但是口令说播放本地歌曲就会随机播放歌曲\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/360)\n" }, { "path": "docs/issues/365.md", "content": "---\ntitle: 已知 ttsCommand\n---\n# 已知 ttsCommand\n参考： https://github.com/idootop/mi-gpt/blob/main/docs/compatibility.md\n\n- 小爱音箱 Pro\tLX06\t`5-1`\n- 小爱音箱 mini\tLX01\t`5-1`\n- 小爱音箱 Play（2019 款）\tLX05\t`5-1`\n- 小爱音箱 万能遥控版\tLX5A\t`5-1`\n- 小米 AI 音箱\tS12\t `5-1`\n- 小米 AI 音箱（第二代）\tL15A\t`7-3`\n- 小爱智能家庭屏 10\tX10A\t`7-3`\n- Xiaomi Sound Pro\tL17A\t`7-3`\n- 小爱音箱\tL06A\t`5-1`\n- 小爱音箱 Play\tL05B\t`5-3`\n- 小米小爱音箱 Play 增强版\tL05C\t`5-3`\n- Xiaomi 智能家庭屏 6\tX6A\t`7-3`\n- Redmi 小爱触屏音箱 Pro 8 英寸\tX08E\t`7-3`\n- 小爱音箱 Art\tL09A\t`3-1`\n- 小爱触屏音箱\tLX04\t`5-1`\n\n如果你是其他型号的小爱音箱，且不能语音转文字播放，欢迎分享你的型号的 ttsCommand 。\n## 评论\n\n### 评论 1 - hanxi\n可以不用手动配置了，写到代码里了。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/365)\n" }, { "path": "docs/issues/366.md", "content": "---\ntitle: 多设备单独播放功能设计\n---\n# 多设备单独播放功能设计\n## 分组功能\n\n为设备设计分组功能，可以把一个或者多个设备加入到一个分组，一个分组内的设备会被控制同时播放。设备的音量需要支持独立配置。\n\n分组用 group_list 字段配置，比如 `did1:客厅,did2:客厅` 表示 did1和did2用同一个组名。不配置这个参数就说明一个设备一个分组。后台勾选设备的意图改为哪些设备可以接入。比如: \n\n`319762914:a,319518426:a,1236547:b`\n\n单个设备的存储配置结构如下:\n\n```json\n{\n \"devices\": {\n \"10086\": {\n \"cur_music\": \"当前播放的歌曲\",\n \"cur_playlist\": \"当前播放的列表\",\n \"name\": \"客厅的小爱1\",\n \"play_type\": 1\n },\n \"10087\": {\n \"cur_music\": \"当前播放的歌曲\",\n \"cur_playlist\": \"当前播放的列表\",\n \"name\": \"客厅的小爱2\",\n \"play_type\": 1\n }\n }\n}\n```\n\n设备名字从音箱app设置里读取过来，不用在后台修改。\n\n配置采用组名相同为一组，可以考虑不设置组名就用设备名作为组名，也就是一个设备为一组。\n\n后端提供的接口都改为支持操作多个设备，\n\n单曲循环，随机播放这些操作都会同步修改同一个组里的其他设备。\n\n歌单列表所有设备共享，当前选择的歌单和当前播放的歌曲组内共享，一个组共用一份播放列表，也就是共用一个定时器。\n\n## 主页设备切换\n\n主页主要是用于播放操作的，所有操作都是针对于单个设备的，所以在顶部加入一个切换设备的功能。除了修改声音不会同步修改组内设备，其他操作都会同时操作组内所有设备。\n\n> /issues/65.html#issuecomment-2215736529\n## 评论\n\n### 评论 1 - jason856856842388\n请问家里有多个小爱，如何让每个小爱都可以拥有这个功能\n---\n\n### 评论 2 - hanxi\n> 请问家里有多个小爱，如何让每个小爱都可以拥有这个功能\n\n没理解哪个功能？\n---\n\n### 评论 3 - jason856856842388\n做得好\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/366)\n" }, { "path": "docs/issues/389.md", "content": "---\ntitle: 搞了个入门配置教程\n---\n# 搞了个入门配置教程\n官方文档不直观啊，得摸索好久才搞定，第一步怎么设置我找了好久，哈哈哈。\n\n写了个分3步的教程，希望有帮助吧： [xiaomusic 安装、配置和使用教程，免费用小爱音箱无限播放音乐](https://garymeng.com/cn/3317.html)。\n## 评论\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/389)\n" }, { "path": "docs/issues/398.md", "content": "---\ntitle: docker 镜像源收集\n---\n# docker 镜像源收集\n- https://docker.1ms.run/\n- https://dockermirror.com\n## 评论\n\n### 评论 1 - coolxy\n自建代理：\n* https://docker.coolxy.cn/\n* https://docker.qqai.ren/\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/398)\n" }, { "path": "docs/issues/417.md", "content": "---\ntitle: Jellyfin歌单同步到映射目录\n---\n# Jellyfin歌单同步到映射目录\n因为我一直是用jellyfin 听歌, 下载的都是在Pt网站 按照歌手几十张cd一起下载,所以有非常多不想听的歌,于是歌单功能非常重要,既然Jellyfin本上就创建了歌单,我就写一个Python 来同步这个歌单,大家放在 C:\\ProgramData\\Jellyfin\\Server\\data\\playlists 或者自定义的playlists文件夹中.\n\n\n```\nimport os\nimport xml.etree.ElementTree as ET\nimport shutil\n\n#这个文件要放在Jellyfin的C:\\ProgramData\\Jellyfin\\Server\\data\\playlists 中\n#这里要改成想要硬链接到的目录地址\nfolder_path = r'E:\\music2\\歌曲列表'\n\ndef create_hard_links_from_xml(file_path):\n # 解析 XML 文件\n tree = ET.parse(file_path)\n root = tree.getroot()\n\n # 获取 LocalTitle 标签的值\n local_title = root.find('LocalTitle').text\n # 构建目标目录路径\n target_dir = os.path.join(folder_path, local_title)\n\n # 检查目标目录是否存在，如果不存在则创建\n if not os.path.exists(target_dir):\n os.makedirs(target_dir)\n\n # 遍历所有 PlaylistItem 节点\n for playlist_item in root.findall('.//PlaylistItem'):\n # 获取 Path 标签的值\n file_path = playlist_item.find('Path').text\n if os.path.exists(file_path):\n # 获取文件名\n file_name = os.path.basename(file_path)\n target_file = os.path.join(target_dir, file_name)\n try:\n # 创建硬链接\n os.link(file_path, target_file)\n print(f\"成功为 {file_path} 创建硬链接到 {target_file}\")\n except FileExistsError:\n print(f\"目标文件 {target_file} 已存在，跳过。\")\n except Exception as e:\n print(f\"为 {file_path} 创建硬链接时出错: {e}\")\n else:\n print(f\"源文件 {file_path} 不存在，跳过。\")\n\nshutil.rmtree(folder_path)\n\n# 检查文件夹是否存在\nif not os.path.exists(folder_path):\n # 创建单层或多层文件夹\n os.makedirs(folder_path)\n print(f\"文件夹 '{folder_path}' 创建成功\")\n\ndef print_xml_content():\n # 获取当前目录\n current_dir = os.getcwd()\n # 遍历当前目录及其所有子目录\n for root, dirs, files in os.walk(current_dir):\n for file in files:\n # 检查文件扩展名是否为 .xml\n if file.lower().endswith('.xml'):\n file_path = os.path.join(root, file)\n create_hard_links_from_xml(file_path)\n\nif __name__ == \"__main__\":\n print_xml_content()\n```\n\n\n\n\n\n## 评论\n\n### 评论 1 - colaKot\n创建一个xmllink.py 文件 然后把代码放进去,双击运行就行,当然要装python\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/417)\n" }, { "path": "docs/issues/520.md", "content": "---\ntitle: 局域网 ip 问题，排查了两个小时。希望能对大家有所帮助\n---\n# 局域网 ip 问题，排查了两个小时。希望能对大家有所帮助\n家里使用了两个路由器 \n\n- A 路由器 192.168.1.x\n- B 路由器 192.168.31.x\n\n- 在电脑上 docker 启动，连接`B路由器的网络` 要将 `XIAOMUSIC_HOSTNAME(IP或域名):`这一项设置为`B路由器的网络` 也就是`192.168.1.x`\n- A路由器同理\n\n## 评论\n\n### 评论 1 - hanxi\nFAQ有写的，不会配跨网段访问的话，就保持在同一个网段的同局域网就没问题的。会配多网段互通自然就没啥问题。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/520)\n" }, { "path": "docs/issues/533.md", "content": "---\ntitle: 反向代理因为html中绝对路径导致超链接失效\n---\n# 反向代理因为html中绝对路径导致超链接失效\n反向代理因为html中绝对路径导致超链接失效\n## 评论\n\n### 评论 1 - wuxinyumrx\n更新一下解决方案，nginx反向代理配置如下（需要nginx包含http_sub_module）：\n\n```\n proxy_http_version 1.1;\n proxy_pass http://xx.xx.xx.xx:58090/;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n add_header Access-Control-Allow-Origin *;\n add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';\n add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';\n proxy_set_header Accept-Encoding \"\";\n sub_filter_types *;\n sub_filter_once off;\n sub_filter '/ws/' '/xm/ws/';\n sub_filter '/static/' '/xm/static/';\n sub_filter '/musiclist' '/xm/musiclist';\n sub_filter '/musicinfo' '/xm/musicinfo';\n sub_filter '/curplaylist' '/xm/curplaylist';\n sub_filter '/generate_ws_token' '/xm/generate_ws_token';\n sub_filter '/getversion' '/xm/getversion';\n sub_filter '/getsetting' '/xm/getsetting';\n sub_filter '/getvolume' '/xm/getvolume';\n sub_filter '/setvolume' '/xm/setvolume';\n sub_filter '/playingmusic' '/xm/playingmusic';\n sub_filter '/searchmusic' '/xm/searchmusic';\n sub_filter '/latestversion' '/xm/latestversion';\n sub_filter '/cmd' '/xm/cmd';\n sub_filter '\"musiclist' '\"xm/musiclist';\n sub_filter '\"musicinfo' '\"xm/musicinfo';\n sub_filter '\"curplaylist' '\"xm/curplaylist';\n sub_filter '\"generate_ws_token' '\"xm/generate_ws_token';\n sub_filter '\"getversion' '\"xm/getversion';\n sub_filter '\"getsetting' '\"xm/getsetting';\n sub_filter '\"getvolume' '\"xm/getvolume';\n sub_filter '\"setvolume' '\"xm/setvolume';\n sub_filter '\"playingmusic' '\"xm/playingmusic';\n sub_filter '\"searchmusic' '\"xm/searchmusic';\n sub_filter '\"latestversion' '\"xm/latestversion';\n sub_filter '\"cmd' '\"xm/cmd';\n sub_filter '/manifest.json' '/xm/manifest.json';\n sub_filter '\"start_url\": \"/\"' '\"start_url\": \"/xm/\"';\n sub_filter '\"scope\": \"/\"' '\"scope\": \"/xm/\"';\n```\n---\n\n### 评论 2 - wooodxi\n首先感谢各位大佬辛苦的付出。\n我是家庭使用的威联通NAS部署的xiaomusic,NAS上也是使用的docker部署的是frpc客户端（nas上填写对应的端口号），在云服务使用docker部署的frps服务端（填写二级ssl域名）这样的反向代理，部署好以后外网通过链接https:xxx.xxx.xx是可以访问xiaomusic，播放歌曲音箱却没有声音，但是你们的测试播放连接是可以播放音乐， 包括点击停止播放音箱也是可以回应听到音箱发出再见收到的声音，就是播放歌曲音箱不出声。希望可以得到解答。 谢谢大佬\n---\n\n### 评论 3 - hanxi\n@wooodxi 需要改设置页面的ip和端口。\n---\n\n### 评论 4 - 13267740993\nnginx 502 要关闭浏览器再打开才行 帮忙看下啥原因\nserver {\n listen 80;\n server_name www.music.cn;\n\n # ================================\n # 根路径：原始反向代理（不做路径替换）\n # ================================\n location / {\n\n # 反向代理到本机 58090 服务\n proxy_pass http://127.0.0.1:58090;\n\n # 使用 HTTP/1.1，避免 keep-alive / chunked 问题\n proxy_http_version 1.1;\n\n # 清空 Connection 头，交由 Nginx 自动管理\n proxy_set_header Connection \"\";\n\n # 转发客户端真实信息\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n\n # 连接 / 读取 / 发送超时设置，防止 502\n proxy_connect_timeout 60s;\n proxy_send_timeout 60s;\n proxy_read_timeout 60s;\n send_timeout 60s;\n\n # 上传文件大小限制\n client_max_body_size 100m;\n }\n\n # =================================================\n # /xm/ 路径：子路径部署（带 WebSocket + sub_filter）\n # =================================================\n location /xm/ {\n\n # 反向代理到后端服务根路径\n proxy_pass http://127.0.0.1:58090/;\n\n # 使用 HTTP/1.1（WebSocket 必须）\n proxy_http_version 1.1;\n\n # WebSocket 升级头\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n\n # 转发客户端信息\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n\n # 禁用 gzip，否则 sub_filter 无法生效\n proxy_set_header Accept-Encoding \"\";\n\n # ========== sub_filter 内容替换 ==========\n # 对所有响应类型生效（HTML / JS / JSON）\n sub_filter_types *;\n\n # 页面中出现多次也全部替换\n sub_filter_once off;\n\n # 接口路径统一加 /xm 前缀\n sub_filter '\"/' '\"/xm/';\n sub_filter \"'/\" \"'/xm/\";\n\n # WebSocket 路径修正\n sub_filter '/ws/' '/xm/ws/';\n\n # 静态资源路径修正\n sub_filter '/static/' '/xm/static/';\n\n # PWA / manifest 相关路径修正\n sub_filter '/manifest.json' '/xm/manifest.json';\n sub_filter '\"start_url\": \"/\"' '\"start_url\": \"/xm/\"';\n sub_filter '\"scope\": \"/\"' '\"scope\": \"/xm/\"';\n\n # ========== CORS 跨域配置 ==========\n add_header Access-Control-Allow-Origin $http_origin always;\n add_header Access-Control-Allow-Credentials true always;\n add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS' always;\n add_header Access-Control-Allow-Headers\n 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization'\n always;\n\n # OPTIONS 预检请求直接返回\n if ($request_method = OPTIONS) {\n return 204;\n }\n\n # 超时配置\n proxy_connect_timeout 60s;\n proxy_send_timeout 60s;\n proxy_read_timeout 60s;\n send_timeout 60s;\n\n # 上传大小限制\n client_max_body_size 100m;\n }\n\n # ================================\n # 502 错误页\n # ================================\n error_page 502 /502.html;\n}\n\n\n---\n\n### 评论 5 - hanxi\n我也不熟 nginx 配置，建议使用 https://github.com/jc21/nginx-proxy-manager 配置 proxy ，简单的 GUI 操作就行。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/533)\n" }, { "path": "docs/issues/595.md", "content": "---\ntitle: Docker 镜像推荐\n---\n# Docker 镜像推荐\n监控网站：https://status.anye.xyz/\n\n\"Image\"\n## 评论\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/595)\n" }, { "path": "docs/issues/600.md", "content": "---\ntitle: 1Panel 安装运行 xiaomusic 教程\n---\n# 1Panel 安装运行 xiaomusic 教程\n## 1Panel 安装运行\n\n本教程将指导您如何在 1Panel 面板中安装和配置 XiaoMusic。\n\n### 前提条件\n\n在开始安装前，请确保您已完成以下准备工作：\n\n- 已安装并运行 1Panel 面板\n\n如需详细安装 1Panel 面板，请参考 [1Panel 官方安装文档](https://1panel.cn/docs/v2/installation/online_installation/)\n\n安装完成后，通过提示的**访问地址**和**初始账号密码**登录 1Panel。\n\n### 安装 XiaoMusic\n\n登录 1Panel，进入 **应用商店**，搜索 **xiaomusic**，点击**安装**即可。\n\n#### 配置参数说明\n\n安装时请根据实际需求配置以下参数：\n\n- **高级设置**：根据实际需要勾选**端口外部访问**，勾选后即可通过外部 IP 访问 XiaoMusic。\n\n> 保持**默认配置**也可以完成安装，但建议根据实际需求调整。\n\n### 访问 XiaoMusic\n\n安装完成后，进入 1Panel 的 **已安装** 页面，点击 **跳转** 即可进入 XiaoMusic 的 **WebUI** 页面。\n\n> 使用前建议在 **面板设置** 页面设置好**默认访问地址**。\n\n> 如果后续配置了**反向代理**，可以在 `已安装 → 参数` 页面修改 **Web 访问地址**。\n## 评论\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/600)\n" }, { "path": "docs/issues/637.md", "content": "---\ntitle: Jellyfin 插件将音乐歌单转成支持xiaomusic的网络歌单\n---\n# Jellyfin 插件将音乐歌单转成支持xiaomusic的网络歌单\nJellyfin插件安装仓库地址：https://raw.githubusercontent.com/shaoqilan/jellyfin-plugin-xiaomusic/refs/heads/main/10.11/manifest.json\n使用方式：https://github.com/shaoqilan/jellyfin-plugin-xiaomusic\n\n希望 #616 能尽早支持，这样可以避免手动更新歌单，歌单可以实时和Jellyfin音乐库保持一致\n## 评论\n\n### 评论 1 - hanxi\n测试版已经实现了，可以体验一下看看效果。\n---\n\n### 评论 2 - Akari787\n使用这个插件播放jellyfin的歌单时，如果是m4a格式的音乐文件会被识别成mp4，导致无法正常播放。\n`wget -S -O /dev/null \"http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true\"\n--2026-01-12 14:19:32-- http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true\nConnecting to 192.168.7.4:30013... connected.\nHTTP request sent, awaiting response... \n HTTP/1.1 200 OK\n Content-Length: 16503536\n Content-Type: audio/mp4\n Date: Mon, 12 Jan 2026 05:19:32 GMT\n Server: Kestrel\n Accept-Ranges: bytes\n Last-Modified: Sun, 16 Mar 2025 23:01:54 GMT\n X-Response-Time-ms: 1.9493\nLength: 16503536 (16M) [audio/mp4]\nSaving to: '/dev/null'\n\n/dev/null 100%[===============================================================================================================================================>] 15.74M --.-KB/s in 0.01s \n\n2026-01-12 14:19:32 (1.51 GB/s) - '/dev/null' saved [16503536/16503536]`\n---\n\n### 评论 3 - shaoqilan\n> 使用这个插件播放jellyfin的歌单时，如果是m4a格式的音乐文件会被识别成mp4，导致无法正常播放。 `wget -S -O /dev/null \"http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true\" --2026-01-12 14:19:32-- http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true Connecting to 192.168.7.4:30013... connected. HTTP request sent, awaiting response... HTTP/1.1 200 OK Content-Length: 16503536 Content-Type: audio/mp4 Date: Mon, 12 Jan 2026 05:19:32 GMT Server: Kestrel Accept-Ranges: bytes Last-Modified: Sun, 16 Mar 2025 23:01:54 GMT X-Response-Time-ms: 1.9493 Length: 16503536 (16M) [audio/mp4] Saving to: '/dev/null'\n> \n> /dev/null 100%[===============================================================================================================================================>] 15.74M --.-KB/s in 0.01s\n> \n> 2026-01-12 14:19:32 (1.51 GB/s) - '/dev/null' saved [16503536/16503536]`\n\n这可能和源文件m4a内封装的编码有关系，能否提供一下源文件？\n---\n\n### 评论 4 - Akari787\n> > 使用此插件播放jellyfin的歌曲单时，如果是m4a格式的音乐文件会被识别成mp4，导致无法正常播放。 `wget -S -O /dev/null \" http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true \" --2026-01-12 14:19:32-- http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true正在连接到 192.168.7.4:30013...已连接。已发送 HTTP 请求，正在等待响应... HTTP/1.1 200 OK Content-Length: 16503536 Content-Type: audio/mp4 Date: Mon, 12 Jan 2026 05:19:32 GMT Server: Kestrel Accept-Ranges: bytes Last-Modified: Sun, 16 Mar 2025 23:01:54 GMT X-Response-Time-ms: 1.9493 Length: 16503536 (16M) [audio/mp4] Saving to: '/dev/null'\n> > /dev/null 100%[=================================================================================================================================================================================>] 15.74M --.-KB/s 用时 0.01s\n> > 2026-01-12 14:19:32 (1.51 GB/s) - '/dev/null' 已保存 [16503536/16503536]\n> \n> 这可能和源文件m4a内部封装的编码有关系，能否提供一下源文件？\n\n以这首【Alice in 冷凍庫】为例。这整个专辑里面的歌曲都无法播放。\n链接可能打开比较慢，如果有IPv6会稍微快一点。\nhttps://nextcl.asilante.xyz/s/3pX326jHfrcwJKY\n---\n\n### 评论 5 - shaoqilan\n> > > 使用此插件播放jellyfin的歌曲单时，如果是m4a格式的音乐文件会被识别成mp4，导致无法正常播放。 `wget -S -O /dev/null \" http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true \" --2026-01-12 14:19:32-- [http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true正在连接到](http://192.168.7.4:30013/Audio/d7d0d9f6-a856-ab68-7725-ab03419eef59/stream?static=true%E6%AD%A3%E5%9C%A8%E8%BF%9E%E6%8E%A5%E5%88%B0) 192.168.7.4:30013...已连接。已发送 HTTP 请求，正在等待响应... HTTP/1.1 200 OK Content-Length: 16503536 Content-Type: audio/mp4 Date: Mon, 12 Jan 2026 05:19:32 GMT Server: Kestrel Accept-Ranges: bytes Last-Modified: Sun, 16 Mar 2025 23:01:54 GMT X-Response-Time-ms: 1.9493 Length: 16503536 (16M) [audio/mp4] Saving to: '/dev/null'\n> > > /dev/null 100%[=================================================================================================================================================================================>] 15.74M --.-KB/s 用时 0.01s\n> > > 2026-01-12 14:19:32 (1.51 GB/s) - '/dev/null' 已保存 [16503536/16503536]\n> > \n> > \n> > 这可能和源文件m4a内部封装的编码有关系，能否提供一下源文件？\n> \n> 以这首【Alice in 冷凍庫】为例。这整个专辑里面的歌曲都无法播放。 链接可能打开比较慢，如果有IPv6会稍微快一点。 https://nextcl.asilante.xyz/s/3pX326jHfrcwJKY\n\n我用该文件做了测试，是可以正常播放的\n\n\"Image\"\n以上是测试的版本\n音响是L05B\n\n如果音响不支持音频格式需要jellyfin做转码，可以将插件升级到1.0.0.2版本。在插件设置中做一下配置：\n\n\"Image\"\n以上设置示例，是会将*.m4a后缀的文件以mp3格式进行输出\n\n\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/637)\n" }, { "path": "docs/issues/688.md", "content": "---\ntitle: 使用cookie登陆\n---\n# 使用cookie登陆\n> 使用 cookie 登录时不要写填账号密码\n\n## 步骤\n\n1. 在电脑上使用 Chrome 浏览器登录小米账号官网 👉 \n2. 按 `F12` 打开网络工具，点击 `Network` 标签页。\n3. 点击左上角小圆点使其变红色。\n4. 按 `F5` 刷新页面。\n5. 在过滤框里输入 `account?` 过滤出下面的连接，点击连接查看 `cookie` ，复制完整的 `cookie` 值。需要确保复制的 `cookie` 中有 `userId` 和 `passToken` 两个值。\n6. 粘贴到设置页面。\n\n## 步骤截图\n\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/681a027f-2007-4e2b-9dda-9046ae79c263)\n\n\"Image\"\n## 评论\n\n### 评论 1 - seryte\n0.4.12版本测试了使用cookie也无效，是不是cookie还未正确读取？\n\n\"Image\"\n\n\"Image\"\n---\n\n### 评论 2 - WGKER\n局域网内电脑获取完整cookie填入，并且也填写账户密码，仍然无法获取设备。\n可行的话还是换成跳转小米账户授权登录的方式吧，类似小米官方HA插件，目前太折腾了。\n---\n\n### 评论 3 - gdzjy\n0.4.12登录无效，找不到音箱设备。\n\n\"Image\"\n\n---\n\n### 评论 4 - swxk521\n0.4.12一样不行\n---\n\n### 评论 5 - gdzjy\n发现回到旧版本也找不到设备了，不知是不是小米有ban账号的机制，日志如下：\n\n\"Image\"\n\n\"Image\"\n---\n\n### 评论 6 - hanxi\n文档更新了，截图还没更新，可以先看。\n---\n\n### 评论 7 - hanxi\n下个版本可以不用填账号密码，目前0.4.12版本有点bug需要填。\n---\n\n### 评论 8 - seryte\n> 文档更新了，截图还没更新，可以先看。\n\n也还是不行 😂\n\n\"Image\"\n\n\"Image\"\n---\n\n### 评论 9 - hanxi\n需要填账号，或者用测试版本。\n---\n\n### 评论 10 - seryte\n> 需要填账号，或者用测试版本。\n\n`hanxi/xiaomusic main d1d275ae0e98 About an hour ago 341MB`\n测试版本能发现设备，但是还是无法播放本地歌曲，播放歌曲时会再次登录失败, 然后没过2分钟，设备再次消失，日志出现需要验证码的信息\n\n\"Image\"\n\n\"Image\"\n\n\"Image\"\n---\n\n### 评论 11 - sam0773\n填写cookies时候要加上_utm_data={\"\"}吗？直接复制进去保存时候会弹出[object object]\n---\n\n### 评论 12 - figsong\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/b52cb3ca-ffb2-4c85-92be-0803ebb2d252)\n0.4.13版单用cookies、cookies加上账号密码依然不能发现设备\n---\n\n### 评论 13 - hanxi\n需要确保复制的 cookie 中有 userId 和 passToken 两个值。\n---\n\n### 评论 14 - hanxi\n需要确保复制的 cookie 中有 userId 和 passToken 两个值。\n---\n\n### 评论 15 - dyz312\n仅使用cookie找的设备了，感谢！\n---\n\n### 评论 16 - xpeagle\n4.14也是显示不能找到设备，不知道咋回事，cookie也是填了的， cookie 中有 userId 和 passToken 两个值的，但是还是不能找到设备哦\n\n\"Image\"\n---\n\n### 评论 17 - xpeagle\n> 仅使用cookie找的设备了，感谢！\n\n我也是试了下仅用cookie，但是还是找不到设备，郁闷了\n---\n\n### 评论 18 - zzfca\n使用仅cookie登陆,终于链接到小爱音箱了! 谢谢谢谢\n---\n\n### 评论 19 - TangTang0812\n有个问题大概播放几首歌后，会触发账号安全机制，控制台会提示“验证码输入错误”，然后就需要再次去官网过下人机验证，再到xiaomusic中重新配置cookie，是不是cookie容易被Mi ban 导致生命周期挂了，总的来说还是不错，能正常识别设备了；感谢大佬的倾情奉献 ❤\n---------------------------------\n。。。。。。。。。\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] device_player.py:226: play. names:['告白气球周杰伦'] 1\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] device_player.py:912: cancel_group_next_timer {'981327057': }\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] device_player.py:897: cancel_next_timer did: 981327057\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] device_player.py:907: 下一曲定时器不见了 did: 981327057\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] device_player.py:357: cur_music 告白气球周杰伦\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] music_url.py:60: get_music_url name:告白气球周杰伦\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] music_library.py:586: try get_filename. filename:music/download/告白气球周杰伦.mp3\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] music_url.py:139: _get_local_music_url local music. name:告白气球周杰伦, filename:music/download/告白气球周杰伦.mp3\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] music_url.py:162: _get_file_url filepath:music/download/告白气球周杰伦.mp3, filename:download/告白气球周杰伦.mp3\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] music_url.py:53: get_music_sec_url. name:告白气球周杰伦 url:http://192.168.6.167:58090/music/download/%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83%E5%91%A8%E6%9D%B0%E4%BC%A6.mp3 origin_url:None\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:46] [0.4.12] [INFO] device_player.py:872: group_force_stop_xiaoai Xiaomi 智能音箱 Pro ['70ba747b-af44-4e41-bc49-b9da586cf770']\n1Panel-xiaomusic-1n74 | Exception on login 2340782246: {'code': 87001, 'desc': '验证码输入错误', 'captchaUrl': '/pass/getCode?icodeType=login&0.754211913663798', 'type': 'manMachine'}\n1Panel-xiaomusic-1n74 | Traceback (most recent call last):\n1Panel-xiaomusic-1n74 | File \"/app/.venv/lib/python3.14/site-packages/miservice/miaccount.py\", line 72, in login\n1Panel-xiaomusic-1n74 | raise Exception(resp)\n1Panel-xiaomusic-1n74 | Exception: {'code': 87001, 'desc': '验证码输入错误', 'captchaUrl': '/pass/getCode?icodeType=login&0.754211913663798', 'type': 'manMachine'}\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:47] [0.4.12] [WARNING] device_player.py:424: Execption Error https://api2.mina.mi.com/remote/ubus: Login failed\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:47] [0.4.12] [INFO] device_player.py:875: group_force_stop_xiaoai ['70ba747b-af44-4e41-bc49-b9da586cf770'] [None]\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:47] [0.4.12] [INFO] device_player.py:362: 播放 http://192.168.6.167:58090/music/download/%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83%E5%91%A8%E6%9D%B0%E4%BC%A6.mp31Panel-xiaomusic-1n74 | Exception on login 2340782246: {'code': 87001, 'desc': '验证码输入错误', 'captchaUrl': '/pass/getCode?icodeType=login&0.38010189998178023', 'type': 'manMachine'}\n1Panel-xiaomusic-1n74 | Traceback (most recent call last):\n1Panel-xiaomusic-1n74 | File \"/app/.venv/lib/python3.14/site-packages/miservice/miaccount.py\", line 72, in login\n1Panel-xiaomusic-1n74 | raise Exception(resp)\n1Panel-xiaomusic-1n74 | Exception: {'code': 87001, 'desc': '验证码输入错误', 'captchaUrl': '/pass/getCode?icodeType=login&0.38010189998178023', 'type': 'manMachine'}\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:47] [0.4.12] [ERROR] device_player.py:730: Execption Error https://api2.mina.mi.com/remote/ubus: Login failed\n1Panel-xiaomusic-1n74 | Traceback (most recent call last):\n1Panel-xiaomusic-1n74 | File \"/app/xiaomusic/device_player.py\", line 718, in play_one_url\n1Panel-xiaomusic-1n74 | ret = await self.auth_manager.mina_service.play_by_music_url(\n1Panel-xiaomusic-1n74 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n1Panel-xiaomusic-1n74 | device_id, url, audio_id=audio_id\n1Panel-xiaomusic-1n74 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n1Panel-xiaomusic-1n74 | )\n1Panel-xiaomusic-1n74 | ^\n1Panel-xiaomusic-1n74 | File \"/app/.venv/lib/python3.14/site-packages/miservice/minaservice.py\", line 206, in play_by_music_url\n1Panel-xiaomusic-1n74 | return await self.ubus_request(\n1Panel-xiaomusic-1n74 | ^^^^^^^^^^^^^^^^^^^^^^^^\n1Panel-xiaomusic-1n74 | ...<4 lines>...\n1Panel-xiaomusic-1n74 | )\n1Panel-xiaomusic-1n74 | ^\n1Panel-xiaomusic-1n74 | File \"/app/.venv/lib/python3.14/site-packages/miservice/minaservice.py\", line 47, in ubus_request\n1Panel-xiaomusic-1n74 | result = await self.mina_request(\n1Panel-xiaomusic-1n74 | ^^^^^^^^^^^^^^^^^^^^^^^^\n1Panel-xiaomusic-1n74 | ...<2 lines>...\n1Panel-xiaomusic-1n74 | )\n1Panel-xiaomusic-1n74 | ^\n1Panel-xiaomusic-1n74 | File \"/app/.venv/lib/python3.14/site-packages/miservice/minaservice.py\", line 37, in mina_request\n1Panel-xiaomusic-1n74 | return await self.account.mi_request(\n1Panel-xiaomusic-1n74 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n1Panel-xiaomusic-1n74 | \"micoapi\", \"https://api2.mina.mi.com\" + uri, data, headers\n1Panel-xiaomusic-1n74 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n1Panel-xiaomusic-1n74 | )\n1Panel-xiaomusic-1n74 | ^\n1Panel-xiaomusic-1n74 | File \"/app/.venv/lib/python3.14/site-packages/miservice/miaccount.py\", line 155, in mi_request\n1Panel-xiaomusic-1n74 | raise Exception(f\"Error {url}: {resp}\")\n1Panel-xiaomusic-1n74 | Exception: Error https://api2.mina.mi.com/remote/ubus: Login failed\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:47] [0.4.12] [INFO] device_player.py:700: group_player_play http://192.168.6.167:58090/music/download/%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83%E5%91%A8%E6%9D%B0%E4%BC%A6.mp3 ['70ba747b-af44-4e41-bc49-b9da586cf770'] [None]\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:47] [0.4.12] [INFO] device_player.py:366: 播放 告白气球周杰伦 失败. 失败次数: 10\n1Panel-xiaomusic-1n74 | [2026-01-17 13:06:48] [0.4.12] [INFO] 192.168.6.205:2582 - \"POST /playmusiclist HTTP/1.1\" 200\n。。。。。。。。\n---------------------------------\n\n\"Image\"\n\n\n\"Image\"\n\n\"Image\"\n---\n\n### 评论 20 - hanxi\n@TangTang0812 把对话记录关掉会好一点。\n---\n\n### 评论 21 - ideajoker\n\"Image\"\n\n\"Image\"\n\n0.4.16版本还是无法识别设备。\n\n按照/issues/99.html里面的方法试了\n\n1、官网重新登陆过了\n2、小米音响APP也重新登录过了\n3、cookie也填入了\n\n群辉NAS里面不知道怎么把网络由bridge改为host，这个还没试。 有没有类似的情况？\n---\n\n### 评论 22 - zmz163\n试了很多次都不能查找设备，局域网内电脑获取完整cookie填入，并且也填写账户密码，仍然无法获取设备。\n\n[xiaomusic (1).txt](https://github.com/user-attachments/files/24761966/xiaomusic.1.txt)\n---\n\n### 评论 23 - sam0773\n如果用cookies就不要填写账号和密码\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n---原始邮件---\r\n发件人: ***@***.***>\r\n发送时间: 2026年1月21日(周三) 下午5:13\r\n收件人: ***@***.***>;\r\n抄送: ***@***.******@***.***>;\r\n主题: Re: [hanxi/xiaomusic] 使用cookie登陆 (Issue #688)\r\n\r\n\r\nzmz163 left a comment (hanxi/xiaomusic#688)\r\n \r\n试了很多次都不能查找设备，局域网内电脑获取完整cookie填入，并且也填写账户密码，仍然无法获取设备。\r\n \r\nxiaomusic (1).txt\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n### 评论 24 - zmz163\n> 如果用cookies就不要填写账号和密码\n> […](#)\n\n只用cookie登录也不行\n---\n\n### 评论 25 - w0000dy\n> > 如果用cookies就不要填写账号和密码\n> > […](#)\n> \n> 只用cookie登录也不行\n\n填账号密码 账号别用手机号，我一开始手机号不行 使用ID号 然后去网页登录验证 刷新就有了，可以的话 先去你docker配置的config文件夹下东西都删除 登陆账号后再重新配置下\n---\n\n### 评论 26 - zmz163\n> > > 如果用cookies就不要填写账号和密码\n> > > […](#)\n> > \n> > \n> > 只用cookie登录也不行\n> \n> 填账号密码 账号别用手机号，我一开始手机号不行 使用ID号 然后去网页登录验证 刷新就有了，可以的话 先去你docker配置的config文件夹下东西都删除 登陆账号后再重新配置下\n\n试了很多次，还是不行\n---\n\n### 评论 27 - ideajoker\n\"Image\"\n2026年1月22日12:30测试反馈：\n群辉NAS，把项目docker配置目录config文件夹下的内容全都删除，\n重新拉取最新版本构建一下，再登录后台，可以先Ctrl+F5一下刷新出新版后台。\n账号登录页面删掉手机号，换成ID，密码留空。\n然后使用cookie登录，保存之后，就能识别到设备了。\n---\n\n### 评论 28 - yangjianxun36\n大佬现在有个新问题，不知道是我的个例还是设备问题。家里有两台小米设备，一台米家音箱，一台触屏音箱，都是初版。米家音箱各项功能都正常，包括用风花雪月app控制播放暂停。但是触屏音箱有问题，在网页后台控制，点击播放暂停都可以正常用，但是停止的时候音箱没有停止语音反馈（米家音箱是有的），但是用着也还是没问题，用风花雪月app就有问题了，点播放可以放歌，但是一点就没反应，而且点了以后再网页后台也无法控制了，播放时间会开始一直跳，后台两个音箱都无法被发现，只能重启容器后正常。但是一通过风花雪月控制就会重复出现上面的问题。只能再次重启容器\n---\n\n### 评论 29 - b2522\n用这个网址的token可以登录， 里面的userid换成自己的\nhttps://account.xiaomi.com/fe/service/account?userId=11111&_locale=zh_CN\n---\n\n### 评论 30 - chenxixian\n我用的pip instal方式安装和更新xiaomusic在Mac上的，之前帐号密码也是时不时有问题，改用cookie登录会正常，但Mac的IP有时会变，所以又加了个启动脚本，IP没变直接启动xiaomusic，IP变了修改好conf/setting.json后，再启动xiaomusic。\n\nstart_xiaomusic.sh\n```\n#!/bin/bash\n\n# xiaomusic启动脚本\n# 功能：检查IP配置，如不一致则更新，然后启动xiaomusic\n\n# 设置脚本目录\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nSETTING_FILE=\"$SCRIPT_DIR/conf/setting.json\"\n\n# 颜色输出\nRED='\\033[0;31m'\nGREEN='\\033[0;32m'\nYELLOW='\\033[1;33m'\nNC='\\033[0m' # No Color\n\n# 日志函数\nlog_info() {\n echo -e \"${GREEN}[INFO]${NC} $1\"\n}\n\nlog_warn() {\n echo -e \"${YELLOW}[WARN]${NC} $1\"\n}\n\nlog_error() {\n echo -e \"${RED}[ERROR]${NC} $1\"\n}\n\n# 检查配置文件是否存在\nif [ ! -f \"$SETTING_FILE\" ]; then\n log_error \"配置文件不存在: $SETTING_FILE\"\n exit 1\nfi\n\n# 获取当前无线网卡IP (en0)\nget_current_ip() {\n # 尝试获取en0的IPv4地址\n local ip=$(ifconfig en0 2>/dev/null | grep \"inet \" | awk '{print $2}' | head -1)\n if [ -z \"$ip\" ]; then\n # 如果en0没有IP，尝试其他网络接口\n ip=$(ifconfig | grep \"inet \" | grep -v \"127.0.0.1\" | awk '{print $2}' | head -1)\n fi\n echo \"$ip\"\n}\n\n# 获取配置文件中的hostname IP\nget_config_ip() {\n local ip=$(grep '\"hostname\"' \"$SETTING_FILE\" | sed 's/.*\"hostname\": *\"http:\\/\\///' | sed 's/\".*//' | tr -d ' ')\n echo \"$ip\"\n}\n\n# 更新配置文件中的IP\nupdate_config_ip() {\n local new_ip=\"$1\"\n log_info \"更新配置文件中的IP为: $new_ip\"\n\n # 使用Python来更新JSON文件，更可靠\n python3 -c \"\nimport json\nimport sys\n\ntry:\n with open('$SETTING_FILE', 'r', encoding='utf-8') as f:\n data = json.load(f)\n\n data['hostname'] = 'http://$new_ip'\n\n with open('$SETTING_FILE', 'w', encoding='utf-8') as f:\n json.dump(data, f, ensure_ascii=False, indent=2)\n\n print('更新成功')\nexcept Exception as e:\n print(f'更新失败: {e}')\n sys.exit(1)\n\"\n\n if [ $? -eq 0 ]; then\n log_info \"IP配置更新成功\"\n return 0\n else\n log_error \"IP配置更新失败\"\n return 1\n fi\n}\n\n# 启动xiaomusic\nstart_xiaomusic() {\n log_info \"启动xiaomusic...\"\n\n # 检查xiaomusic命令是否存在\n if ! command -v xiaomusic &> /dev/null; then\n log_error \"未找到xiaomusic命令，请确保已正确安装\"\n exit 1\n fi\n\n # 获取xiaomusic命令路径\n local xiaomusic_cmd=$(command -v xiaomusic)\n log_info \"xiaomusic命令: $xiaomusic_cmd\"\n log_info \"配置文件: $SETTING_FILE\"\n\n # 切换到脚本目录并启动\n cd \"$SCRIPT_DIR\" || exit 1\n\n # 执行xiaomusic命令\n exec xiaomusic\n}\n\n# 主程序\nmain() {\n log_info \"=== xiaomusic启动脚本 ===\"\n\n # 获取当前IP\n current_ip=$(get_current_ip)\n if [ -z \"$current_ip\" ]; then\n log_error \"无法获取当前IP地址\"\n exit 1\n fi\n log_info \"当前IP地址: $current_ip\"\n\n # 获取配置文件中的IP\n config_ip=$(get_config_ip)\n if [ -z \"$config_ip\" ]; then\n log_error \"无法从配置文件中获取hostname IP\"\n exit 1\n fi\n log_info \"配置文件IP: $config_ip\"\n\n # 比较IP\n if [ \"$current_ip\" = \"$config_ip\" ]; then\n log_info \"IP配置一致，直接启动xiaomusic\"\n else\n log_warn \"IP配置不一致，需要更新配置\"\n if ! update_config_ip \"$current_ip\"; then\n log_error \"更新IP配置失败\"\n exit 1\n fi\n fi\n\n # 启动xiaomusic\n start_xiaomusic\n}\n\n# 捕获中断信号\ntrap 'log_info \"脚本被中断\"; exit 130' INT TERM\n\n# 执行主程序\nmain \"$@\"\n```\n---\n\n### 评论 31 - zhagn4\n> 用这个网址的token可以登录， 里面的userid换成自己的 https://account.xiaomi.com/fe/service/account?userId=11111&_locale=zh_CN\n\n亲测可用，谢谢\n---\n\n### 评论 32 - zhagn4\n> > 用这个网址的token可以登录， 里面的userid换成自己的 https://account.xiaomi.com/fe/service/account?userId=11111&_locale=zh_CN\n> \n> 亲测可用，谢谢\n \n可用一天后，失效\n\n\n---\n\n### 评论 33 - b2522\n> > > 用这个网址的token可以登录， 里面的userid换成自己的 https://account.xiaomi.com/fe/service/account?userId=11111&_locale=zh_CN\n> > \n> > \n> > 亲测可用，谢谢\n> \n> 可用一天后，失效\n\n重启一下容器~如果不行，就更新下ck，再重启下容器\n---\n\n### 评论 34 - zhagn4\n> > > > 用这个网址的token可以登录， 里面的userid换成自己的 https://account.xiaomi.com/fe/service/account?userId=11111&_locale=zh_CN\n> > > \n> > > \n> > > 亲测可用，谢谢\n> > \n> > \n> > 可用一天后，失效\n> \n> 重启一下容器~如果不行，就更新下ck，再重启下容器\n\n重启可以了，但今天又不行了，我让容器每天定时重启试试\n---\n\n### 评论 35 - ideajoker\n> > > > > 用这个网址的token可以登录， 里面的userid换成自己的 https://account.xiaomi.com/fe/service/account?userId=11111&_locale=zh_CN\n> > > > \n> > > > \n> > > > 亲测可用，谢谢\n> > > \n> > > \n> > > 可用一天后，失效\n> > \n> > \n> > 重启一下容器~如果不行，就更新下ck，再重启下容器\n> \n> 重启可以了，但今天又不行了，我让容器每天定时重启试试\n\n我现在也是每天定时重启才行，找不到规律啥时候就掉了登录。。。\n---\n\n### 评论 36 - wyyang1978-debug\n我的也是需要重启，一般一到两天就会找不到设备，重启就好了\n---\n\n### 评论 37 - JasonSupertramp\n还有一个就是需要把账号的二次验证关掉，不然连不上\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/688)\n" }, { "path": "docs/issues/764.md", "content": "---\ntitle: 酷狗歌单导出工具，可快速导入 xiaomusic\n---\n# 酷狗歌单导出工具，可快速导入 xiaomusic\n开发了一个酷狗音乐歌单导出工具，可以将酷狗音乐的歌单导出为 xiaomusic 兼容的 JSON 格式。\n\n项目地址： https://github.com/Steven-Qiang/kugou-exporter\n\n主要功能：\n\n支持手机验证码、二维码扫码登录\n\n一键导出个人收藏歌单为 xiaomusic 格式\n\n自动获取歌曲播放链接\n\n技术实现：\n基于 [KuGouMusicApi](https://github.com/MakcRe/KuGouMusicApi) 开发，提供了完整的 Web 界面和可执行文件。\n\n支持docker部署\n\n导出的 JSON 文件可直接在 xiaomusic 设置页面导入使用。\n## 评论\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/764)\n" }, { "path": "docs/issues/767.md", "content": "---\ntitle: 自己用的Android TV上连接xiaomusic的播放软件\n---\n# 自己用的Android TV上连接xiaomusic的播放软件\n一直没找到TV上用的播放软件，自己整了一个，分享给大家\n[https://github.com/GanHuaLin/rouroumusic-tv](https://github.com/GanHuaLin/rouroumusic-tv)\n## 评论\n\n### 评论 1 - boluofan\n卧槽，牛掰\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/767)\n" }, { "path": "docs/issues/78.md", "content": "---\ntitle: 已支持配置自定义网络歌单，在这里分享你的歌单\n---\n# 已支持配置自定义网络歌单，在这里分享你的歌单\n设置页面新增一个输入框配置json格式，可以定义配置音乐源，可以是电台或者其他的m3u8格式的。\n再加一个输入框配置这个json文件的url，点击获取按钮把url对应的json内容填充到json输入框，方便直接使用别人分享的歌单。\n\n比如这样的链接\n- https://lhttp.qtfm.cn/live/4915/64k.mp3\n- http://ngcdn001.cnr.cn/live/zgzs/index.m3u8\n\n已经测试能播放出来:\n```\npython3 micli.py play http://ngcdn001.cnr.cn/live/zgzs/index.m3u8\n```\n\n预计歌单格式是这样的, type 为 radio 作为电台的设定，会一直播放当前电台，不会播放下一首。\n```json\n[\n {\n \"name\":\"歌单1\",\n \"musics\":[\n {\n \"name\":\"歌名1\",\n \"url\":\"http://ngcdn001.cnr.cn/live/zgzs/index.m3u8\",\n \"type\":\"radio\"\n },\n {\n \"name\":\"歌名2\",\n \"url\":\"https://lhttp.qtfm.cn/live/4915/64k.mp3\"\n }\n ]\n },\n {\n \"name\":\"歌单2\",\n \"musics\":[\n {\n \"name\":\"歌名3\",\n \"url\":\"https://lhttp.qtfm.cn/live/4915/64k.mp3\"\n },\n {\n \"name\":\"花海\",\n \"url\":\"http://192.168.2.5:58090/proxy?urlb64=aHR0cHM6Ly93cy5zdHJlYW0ucXFtdXNpYy5xcS5jb20vTTgwMDAwM29rV3ZvMXFadTljLm1wMz9mcm9tdGFnPTAmZ3VpZD1mZmZmZmZmZmM4MWU2ZjVhZmZmZmZmZmZlZGZmZWI3ZiZ1aW49MzMxMjkzOTI1NCZ2a2V5PTc1MURBOEQ5RkRFNTkwOEQ5MjVCNUZFMTNBODhEREUyQkI3MzZGNDQ3NDU4MTA1OTk2Q0Q3QTEyMTQ2ODFGRUZERjNBQURDMkY0OTY2NjJEMDM1OUVDRkE0RjQwMkM2M0RDOTk4NzdDOENGMkM3OUJfX3YyMWUyYTE3MzM=\"\n }\n ]\n }\n]\n```\n\n这里分享一个让 chatgpt 写 python 脚本来生成歌单的例子 。\n\n## 代理访问链接\n\n上面的 是经过代理播放的链接。可以通过其他的工具来生成。其中 是自己的 xiaomusic 地址。\n## 评论\n\n### 评论 1 - hanxi\n可以使用 gist 来配置和分享 json 文件，比如 https://gist.github.com/hanxi/dda82d964a28f8110f8fba81c3ff8314\r\n\r\n点击 raw 得到 json 文件的链接 https://gist.githubusercontent.com/hanxi/dda82d964a28f8110f8fba81c3ff8314/raw/8787844d81c39dbfaad4e37954dd449d8bba5728/example.json\r\n\r\n当然还可以用其他工具分享json文件，比如 github 和国内的 gitee 。\n---\n\n### 评论 2 - hanxi\n已经有工具支持将 m3u 格式的电台文件转为网络歌单格式，见 /issues/88.html\r\n\r\n欢迎有兴趣的朋友制作其他格式转换工具，比如网易歌单那一类的。\n---\n\n### 评论 3 - hanxi\n设备掉线了\n---\n\n### 评论 4 - hanxi\n> 怎么获取 他正在播放什么？或者是播放进度 ？播放列表？我想给他加进去 ![233333](https://private-user-images.githubusercontent.com/100142519/372926296-013cd952-69e9-4754-870f-2d5321865179.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Mjc4ODY3MzUsIm5iZiI6MTcyNzg4NjQzNSwicGF0aCI6Ii8xMDAxNDI1MTkvMzcyOTI2Mjk2LTAxM2NkOTUyLTY5ZTktNDc1NC04NzBmLTJkNTMyMTg2NTE3OS5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQxMDAyJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MTAwMlQxNjI3MTVaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0wNzI5OTdhOTAxMmIwMDkxZTBjOGNhYTZkOWVjY2MwZTRmNGE0YTYzNDFhNGY1YzNjNTI4ZWY0YzYzYzc0Nzk3JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.4-5nGDdkDv9FRp9bAnwN4dzmf4wqKHnG4bW44BhVyRQ)\r\n\r\n这个接口 `/playingmusic`\n---\n\n### 评论 5 - 114514thD\n加不加\"type\":\"radio\"都会一直播放不切换到下一首歌是为什么呢\n---\n\n### 评论 6 - hanxi\n> 加不加\"type\":\"radio\"都会一直播放不切换到下一首歌是为什么呢\r\n\r\n发出来看看？\n---\n\n### 评论 7 - 114514thD\n> > 加不加\"type\":\"radio\"都会一直播放不切换到下一首歌是为什么呢\r\n> \r\n> 发出来看看？\r\n\r\n~~本地开服务器，生成的m3u列表\r\n格式如下\r\n`#EXTINF:247,周传雄 - 临别一眼.mp3\r\nhttp://192.168.1.147:8000/%E5%91%A8%E4%BC%A0%E9%9B%84%20-%20%E4%B8%B4%E5%88%AB%E4%B8%80%E7%9C%BC.mp3`\r\n包含了时长信息\r\n版本是0.3.46\r\npotplayer里播放完全正常~~\r\n\r\n仔细研究了一下，发现确实存在问题，不过是另一种情况，下面单说\n---\n\n### 评论 8 - 114514thD\n> > 加不加\"type\":\"radio\"都会一直播放不切换到下一首歌是为什么呢\r\n> \r\n> 发出来看看？\r\n\r\n这几天再仔细研究了一下，发现一个可能的原因：这样获取到的是m4a文件，我尝试着在json里配置获取到的m4a链接，发现播放同样也是无时长\n---\n\n### 评论 9 - hanxi\n获取歌曲时长确实有些格式获取不到。\n---\n\n### 评论 10 - 114514thD\n> 获取歌曲时长确实有些格式获取不到。\r\n\r\nhttp://m7.music.126.net/20241216093525/75c9080afa2929d7eec8e1cdbcbc0a92/yyaac/0709/535a/5358/0c6e2dcac3d0e9fa4415d22e1eca1337.m4a\r\n以这个文件为例，我用ffmpeg可以获取时长等元数据\r\n`\r\nInput #0, mov,mp4,m4a,3gp,3g2,mj2, from 'http://m7.music.126.net/20241216093525/75c9080afa2929d7eec8e1cdbcbc0a92/yyaac/0709/535a/5358/0c6e2dcac3d0e9fa4415d22e1eca1337.m4a':\r\n Metadata:\r\n major_brand : mp42\r\n minor_version : 0\r\n compatible_brands: M4A mp42isom\r\n creation_time : 2019-02-21T02:51:36.000000Z\r\n iTunSMPB : 00000000 00000920 000003E8 00000000004BE2F8 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000\r\n encoder : Nero AAC codec / 1.5.4.0\r\n Duration: 00:03:45.70, start: 0.052971, bitrate: 64 kb/s\r\n Chapters:\r\n Chapter #0:0: start 0.105941, end 225.750930\r\n Metadata:\r\n title :\r\n Stream #0:0[0x1](und): Audio: aac (HE-AAC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 63 kb/s (default)\r\n Metadata:\r\n creation_time : 2019-02-21T02:51:36.000000Z\r\n handler_name : Sound Media Handler\r\n vendor_id : [0][0][0][0]`\r\n那是为什么播放就不行呢\n---\n\n### 评论 11 - hanxi\n因为代码有问题。\n---\n\n### 评论 12 - 114514thD\n> 因为代码有问题。\r\n\r\n好吧😂😂，大佬真是直接😁\n---\n\n### 评论 13 - hanxi\n重构方案 #314 \n---\n\n### 评论 14 - LiyuTian-web\n下指令后会重新播放歌曲。比如正在播放晴天，下指令声音小一点，这时会重新从头开始播放晴天这首歌，而不会继续播放。\n---\n\n### 评论 15 - hanxi\nv0.3.86 版本支持 LX 歌单，歌单导出工具地址： \n---\n\n### 评论 16 - airroy888\nhttps://github.com/airroy888/xiaomusic\n插件工具特点： \n1、解锁网易云灰色音乐，网易云歌单实现秒同步。同步歌曲时仅将歌名保存在播放列表中，无需等待播放链接更新，歌单保存内存配置中，不修改setting.json避免影响系统开机加载速度。\n2、当播放歌单时，系统才会实时更新查询播放链接，并调用xiaomusic的API下载播放。\n3、歌单播放采取播1备1方式随时待命状态，当用户喊“切歌”可以实现快速播放歌单的下一首歌曲。\n---\n\n### 评论 17 - 382263999\n播放电台提示：Failed to play music: API Error: 500 Internal Server Error\n---\n\n### 评论 18 - hanxi\n`v0.4.15` 版本已经支持在线歌单格式， `url` 是 `self:///api/proxy/plugin-url?data=` 开头的，需要配合【OnlineSearch】在线音乐里的 JS 插件使用，下面是一个歌单示例，如果想合并多个歌单，可以配合【歌单合并工具】把多个 json 歌单合并成一个。同时需要打开 【网络歌曲过代理】开关。\n\n\"Image\"\n\n\"Image\"\n\n```json\n[\n {\n \"name\": \"经典老歌\",\n \"musics\": [\n {\n \"name\": \"黄昏-周传雄\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICI3REU5QTlDRDA0MTE1N0Y2QkYzRkU5RkZCQ0YxMjBFMyIsICJ0aXRsZSI6ICJcdTllYzRcdTY2MGYiLCAiYXJ0aXN0IjogIlx1NTQ2OFx1NGYyMFx1OTZjNCIsICJhbGJ1bSI6ICJ0cmFuc2ZlciIsICJhbGJ1bV9pZCI6ICI5NjQ2MTIiLCAiYWxidW1fYXVkaW9faWQiOiAwLCAiZHVyYXRpb24iOiAzNDQsICJhcnR3b3JrIjogImh0dHA6Ly9pbWdlLmt1Z291LmNvbS9zdGRtdXNpYy8xMDgwLzIwMjAwMjEwLzIwMjAwMjEwMTEyODE1Mzk1MzEwLmpwZyIsICIzMjBoYXNoIjogIjNFOUM5NUZDRDFGNTgyRkMwMDYxQjgyOUQ0MThEN0U3IiwgInNxaGFzaCI6ICI4QzY0Nzc1QTU1QTJCRkREMDRFMjk3NTM0MDU0OUI3RiIsICJSZXNGaWxlSGFzaCI6ICJEM0UzRUJCM0IwN0U5RTM2QzQwMjZCRDFBNkU5ODc3QiIsICJwbGF0Zm9ybSI6ICJrZyIsICJzb3VyY2UiOiAicGx1Z2luIn0=\",\n \"type\": \"music\"\n },\n {\n \"name\": \"寂寞沙洲冷-周传雄\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIzNkE0RjVFQUE3NDgzMjRBNUQ1MDlEOEVEQzQ3Njk5RiIsICJ0aXRsZSI6ICJcdTViYzJcdTViZGVcdTZjOTlcdTZkMzJcdTUxYjciLCAiYXJ0aXN0IjogIlx1NTQ2OFx1NGYyMFx1OTZjNCIsICJhbGJ1bSI6ICJcdTY2MWZcdTdhN2FcdTRlMGJcdTc2ODRcdTRmMjBcdThiZjQiLCAiYWxidW1faWQiOiAiOTg0Mzc3IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjc0LCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDI0MTIwNi8yMDI0MTIwNjE3NTU0OTE5NDkyMC5qcGciLCAiMzIwaGFzaCI6ICJGMzY4NzUyNUI0Q0RCMkNFMUQwNzBBMkRBQjYyMTg2NSIsICJzcWhhc2giOiAiMjM4N0NGREExNTU1NkQ2NjA1QUNENjQyMkFFMTUwQUUiLCAiUmVzRmlsZUhhc2giOiAiM0NGMjc4NDBFODhERUNFM0NGRUY5ODdEOUVDQjExNzAiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"记事本-陈慧琳\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIyNjY4NDg3MEUyQ0UzOTM2QTNENzI1NTlGNjdDMDYwNiIsICJ0aXRsZSI6ICJcdThiYjBcdTRlOGJcdTY3MmMiLCAiYXJ0aXN0IjogIlx1OTY0OFx1NjE2N1x1NzQzMyIsICJhbGJ1bSI6ICJcdTcyMzFcdTYyMTFcdTRlMGRcdTcyMzEiLCAiYWxidW1faWQiOiAiMjk5NjY1MSIsICJhbGJ1bV9hdWRpb19pZCI6IDAsICJkdXJhdGlvbiI6IDI1MSwgImFydHdvcmsiOiAiaHR0cDovL2ltZ2Uua3Vnb3UuY29tL3N0ZG11c2ljLzEwODAvMjAyNTA4MDIvMjAyNTA4MDIwODQ4MTIyMDc3NzYuanBnIiwgIjMyMGhhc2giOiAiNDYxMUU0Mjg2QUE4QUNBODdFQzY1Q0QyQUVFQzVEMTYiLCAic3FoYXNoIjogIjhEMDM4MTEyMjdFOTc1ODc3RjBBMzk3NDhENkM0RThBIiwgIlJlc0ZpbGVIYXNoIjogIiIsICJwbGF0Zm9ybSI6ICJrZyIsICJzb3VyY2UiOiAicGx1Z2luIn0=\",\n \"type\": \"music\"\n },\n {\n \"name\": \"香水有毒-胡杨林\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJBOTdBOTgyMENEMzI3RDNDRUY5NTFFQUM2M0Y5MkI5NSIsICJ0aXRsZSI6ICJcdTk5OTlcdTZjMzRcdTY3MDlcdTZiZDIiLCAiYXJ0aXN0IjogIlx1ODBlMVx1Njc2OFx1Njc5NyIsICJhbGJ1bSI6ICJcdTk5OTlcdTZjMzRcdTY3MDlcdTZiZDIoXHU1YmEzXHU0ZjIwXHU1MzU1XHU2NmYyKSIsICJhbGJ1bV9pZCI6ICIzOTEyOTg1IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjkwLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDI1MDEyNS8yMDI1MDEyNTEyMTcwMjM2NjY3My5qcGciLCAiMzIwaGFzaCI6ICJBMTgxNjE5NDA3NDhFQzAyNkFFNjRGNEU5NjM0NURBNCIsICJzcWhhc2giOiAiRDcwNjRCQUQ0RUNDNThDN0Q4NDgxMUUzOERCMzgzRDEiLCAiUmVzRmlsZUhhc2giOiAiMjRCQUYxRjFCNzZEM0U5NkY1NEVBNUQ1QkJFQUM4QUIiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"求佛-誓言\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICI3QjcxNDBCMjNBODM2REM2RUU2M0I2Q0Q0ODQ4MjQwMiIsICJ0aXRsZSI6ICJcdTZjNDJcdTRmNWIiLCAiYXJ0aXN0IjogIlx1OGE5M1x1OGEwMCIsICJhbGJ1bSI6ICJcdTYyMTFcdTc2ODRcdThhOTNcdThhMDAiLCAiYWxidW1faWQiOiAiNzYxNCIsICJhbGJ1bV9hdWRpb19pZCI6IDAsICJkdXJhdGlvbiI6IDI4NiwgImFydHdvcmsiOiAiaHR0cDovL2ltZ2Uua3Vnb3UuY29tL3N0ZG11c2ljLzEwODAvMjAyMDA2MjAvMjAyMDA2MjAwNjQ1MDE2OTA0NzEuanBnIiwgIjMyMGhhc2giOiAiMUJGRkRCNkZFRUZFM0Q1NDQ2N0UyMDQ2RjFDMEM0ODciLCAic3FoYXNoIjogIjlBMTBDQzRDQTQ5MEMyN0NCNjRDMEY5RThBRUE5Njc2IiwgIlJlc0ZpbGVIYXNoIjogIjZFODlFQTZGRUI2MjA2RjY0NEJBRDQ0MkEzNERBNUUyIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"不得不爱-潘玮柏、弦子\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICI4RjlFM0ZENDc0RUE2MTJDNjFFQjIwRDE0MTU3NjdCRiIsICJ0aXRsZSI6ICJcdTRlMGRcdTVmOTdcdTRlMGRcdTcyMzEiLCAiYXJ0aXN0IjogIlx1NmY1OFx1NzNhZVx1NjdjZlx1MzAwMVx1NWYyNlx1NWI1MCIsICJhbGJ1bSI6ICJcdTlhZDhcdTYyNGIiLCAiYWxidW1faWQiOiAiOTcyODA5IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjgxLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDI0MTIwNi8yMDI0MTIwNjE3NTU1ODQ4MTM5OS5qcGciLCAiMzIwaGFzaCI6ICI4QUUwNjU3QjY0ODY2OEY4MzFBMDYwM0U0RTNCRUQzOCIsICJzcWhhc2giOiAiRjEwMDJFNUM3N0ZGMUMyQzlDRDgzNDhGMzlDNTk4N0MiLCAiUmVzRmlsZUhhc2giOiAiNDk0REM0MkQ2OTk2ODQ5N0RDQzRBRjNBNTE3RjExNjAiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"后来-刘若英\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICI1RkU3ODc5NkIxMjY5REI4NDY1NUNENjk2Mzg4MDk2QiIsICJ0aXRsZSI6ICJcdTU0MGVcdTY3NjUiLCAiYXJ0aXN0IjogIlx1NTIxOFx1ODJlNVx1ODJmMSIsICJhbGJ1bSI6ICJcdTYyMTFcdTdiNDlcdTRmNjAiLCAiYWxidW1faWQiOiAiOTgyMDg4IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMzQxLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIzMTAyNS8yMDIzMTAyNTExMDkwMjU4Mzg3Ny5qcGciLCAiMzIwaGFzaCI6ICI5Q0NBQzNFNzc2MTY0NTYzMUY3ODQ3N0U3Q0Q3MENFMyIsICJzcWhhc2giOiAiMkEzODdGRjY4MjIxREIwNkFENEMzMjZFRjQ1ODVFRUYiLCAiUmVzRmlsZUhhc2giOiAiNzY2OTY3QTgzMUE5MkY0NEI0NDhFMTA0MEVDMUJGQ0EiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"有一种爱叫做放手-阿木\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICI4QUNFMkQ0NTEwRTI2RkJEQzQ3MzYwNTVDNUFFNEIwMyIsICJ0aXRsZSI6ICJcdTY3MDlcdTRlMDBcdTc5Y2RcdTcyMzFcdTUzZWJcdTUwNWFcdTY1M2VcdTYyNGIiLCAiYXJ0aXN0IjogIlx1OTYzZlx1NjcyOCIsICJhbGJ1bSI6ICJcdTY3MDlcdTRlMDBcdTc5Y2RcdTcyMzFcdTUzZWJcdTUwNWFcdTY1M2VcdTYyNGIiLCAiYWxidW1faWQiOiAiOTcxNTA5IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjYzLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIwMDgxMi8yMDIwMDgxMjE3NTA1MTk5ODY1MS5qcGciLCAiMzIwaGFzaCI6ICI1NDgyODI2NkE0MTJDNDFGN0Q5NEE2MEJEQkRDNDMwMSIsICJzcWhhc2giOiAiRTNBQTE1M0IyRDg4QzkyOTU2OUE0NkREQzJDRjBERjkiLCAiUmVzRmlsZUhhc2giOiAiNUVGRDE2QUY4M0YwREQ3NTE0OUU5OTAzMUYwRTJCODYiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"丁香花-唐磊\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICI2MUJCODU2MEQ3RkI5NzlFQjcwRUM1MDUwOTkwREI5NSIsICJ0aXRsZSI6ICJcdTRlMDFcdTk5OTlcdTgyYjEiLCAiYXJ0aXN0IjogIlx1NTUxMFx1NzhjYSIsICJhbGJ1bSI6ICJcdTRlMDFcdTk5OTlcdTgyYjEiLCAiYWxidW1faWQiOiAiOTgxNzY4IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjY1LCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIwMDkyNy8yMDIwMDkyNzE0MjgzMDgwNDAwNy5qcGciLCAiMzIwaGFzaCI6ICI3Qzc3MDVGNzRCRTVGMTNCODNENjEwQUJDMjlFOTU2MiIsICJzcWhhc2giOiAiRkU3Q0E0RjA2OTQ1MjYwOThGRTYzOUU0RDdDREZCOEMiLCAiUmVzRmlsZUhhc2giOiAiQkM0MDM1QTVDQ0JBNjM3MTNDMUVDQzFCM0NCRTJCNDQiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"爱如潮水-张信哲\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIwMzU0MjgxMjg0NEVFNzdBMjJFMDk2QTlENjk3NDg1OCIsICJ0aXRsZSI6ICJcdTcyMzFcdTU5ODJcdTZmNmVcdTZjMzQiLCAiYXJ0aXN0IjogIlx1NWYyMFx1NGZlMVx1NTRmMiIsICJhbGJ1bSI6ICJcdTZjMzhcdTYwNTJcdTkxZDFcdTY2ZjIgXHU1ZjcxXHU5N2YzXHU1MTc4XHU4NWNmXHU3Y2JlXHU5MDA5IiwgImFsYnVtX2lkIjogIjUzODAzMCIsICJhbGJ1bV9hdWRpb19pZCI6IDAsICJkdXJhdGlvbiI6IDI3MCwgImFydHdvcmsiOiAiaHR0cDovL2ltZ2Uua3Vnb3UuY29tL3N0ZG11c2ljLzEwODAvMjAyNTAyMDcvMjAyNTAyMDcxNjEzMjc3ODMwNjAuanBnIiwgIjMyMGhhc2giOiAiNzBBRTM0NjEyQjhCQkE0ODY2NDkwRkUwRjhEOTAzMDYiLCAic3FoYXNoIjogIjlEMTE4MTkyMDk2MjBBNjFGNTE4REZBNzZEODM2NDk5IiwgIlJlc0ZpbGVIYXNoIjogIjUxNzZCNUNGQ0M0NTAxODk0NDJDNTA5RTA0RTY3NENCIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"晴天-周杰伦\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJCM0E1MkE3QTk1OEJGMEFFRDBFQkZCQTJFOUE4MThCNyIsICJ0aXRsZSI6ICJcdTY2NzRcdTU5MjkiLCAiYXJ0aXN0IjogIlx1NTQ2OFx1Njc3MFx1NGYyNiIsICJhbGJ1bSI6ICJcdTUzZjZcdTYwZTBcdTdmOGUiLCAiYWxidW1faWQiOiAiOTY2ODQ2IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjY5LCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIzMDkyMC8yMDIzMDkyMDE0MjUwMzYzMjAxMy5qcGciLCAiMzIwaGFzaCI6ICIxQjU2MTI2QThBMDM5MjRGMUREMDY2MjU5QzA5NUNCQyIsICJzcWhhc2giOiAiNzhFMTI1RDA5MzgzN0M0NjMyNzBFQUMwM0JCOUQ4QTkiLCAiUmVzRmlsZUhhc2giOiAiRDY2N0JDNUVFOTNGMjAxMTI2Njk3Q0IzQkE3NDUwMDkiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"爱错-王力宏\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJFQzI1NjAyQjU2RDVEQUUzNkIyN0U4Mjc4MEZDNkEyMiIsICJ0aXRsZSI6ICJcdTcyMzFcdTk1MTkiLCAiYXJ0aXN0IjogIlx1NzM4Ylx1NTI5Ylx1NWI4ZiIsICJhbGJ1bSI6ICJcdTVmYzNcdTRlMmRcdTc2ODRcdTY1ZTVcdTY3MDgiLCAiYWxidW1faWQiOiAiMjk5NjQ2MiIsICJhbGJ1bV9hdWRpb19pZCI6IDAsICJkdXJhdGlvbiI6IDIzOCwgImFydHdvcmsiOiAiaHR0cDovL2ltZ2Uua3Vnb3UuY29tL3N0ZG11c2ljLzEwODAvMjAyNTAxMjUvMjAyNTAxMjUxMjE2MDc3MjQ1MjMuanBnIiwgIjMyMGhhc2giOiAiREM0MkQzODMzRTdDMTBDQzRFQkU1Mjg0OTk5M0ZERTIiLCAic3FoYXNoIjogIjNGNUEzNTgxQ0E2NEIxQzNBRkFCQTUxNTQyRTFERDdCIiwgIlJlc0ZpbGVIYXNoIjogIjM3QTMxRTI4MzNDNkE2N0Q1QkNDRUE0OENBNDMwODM4IiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"其实-薛之谦\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIyQTg5MTFFQUQ0ODM4QkY5NjdDRjVBMzAwRDc4N0U1MyIsICJ0aXRsZSI6ICJcdTUxNzZcdTViOWUiLCAiYXJ0aXN0IjogIlx1ODU5Ylx1NGU0Ylx1OGMyNiIsICJhbGJ1bSI6ICJcdTYxMGZcdTU5MTYiLCAiYWxidW1faWQiOiAiOTYwMzI3IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjQyLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIwMDQwNy8yMDIwMDQwNzE1MTgxODg2MjA4Mi5qcGciLCAiMzIwaGFzaCI6ICI1NDY0REYxMzNBNzAyNkUzMTVCNkM2N0UwNEVFNkY0NiIsICJzcWhhc2giOiAiMzc4QzNCRTY3NkQ3OURCNTAwNjRCNjM1Mjg1MTM5RDMiLCAiUmVzRmlsZUhhc2giOiAiODdCQjdCMUM2QzVDMDBBMUJCRDRBRDAwRTk0REM4MEUiLCAicGxhdGZvcm0iOiAia2ciLCAic291cmNlIjogInBsdWdpbiJ9\",\n \"type\": \"music\"\n },\n {\n \"name\": \"花海-周杰伦\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIzMzI4ODA4Q0VDQkQxQTEwMzgxNjYwMDM4NDBGRERENyIsICJ0aXRsZSI6ICJcdTgyYjFcdTZkNzciLCAiYXJ0aXN0IjogIlx1NTQ2OFx1Njc3MFx1NGYyNiIsICJhbGJ1bSI6ICJcdTliNTRcdTY3NzBcdTVlYTciLCAiYWxidW1faWQiOiAiOTYwMzk5IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjY0LCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDI0MTExOC8yMDI0MTExODE2MDYyMjUwODQyOS5qcGciLCAiMzIwaGFzaCI6ICI4RTM5RUNBMzY0MzYxRTRBMDY1MkU3N0I4QjNFNjYxNyIsICJzcWhhc2giOiAiRTk0RDMyMDEzQjRFNUU2MjAwMDc1QkNDQUI5Njc4N0MiLCAiUmVzRmlsZUhhc2giOiAiIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"不将就-李荣浩\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJFNUYwOTA1QzY2Mjg3MkE5QjA1QTQyM0ZEMUVENDhCNSIsICJ0aXRsZSI6ICJcdTRlMGRcdTVjMDZcdTVjMzEiLCAiYXJ0aXN0IjogIlx1Njc0ZVx1ODM2M1x1NmQ2OSIsICJhbGJ1bSI6ICJcdTY3MDlcdTc0MDZcdTYwZjMiLCAiYWxidW1faWQiOiAiMTAwNDA0MCIsICJhbGJ1bV9hdWRpb19pZCI6IDAsICJkdXJhdGlvbiI6IDMxMiwgImFydHdvcmsiOiAiaHR0cDovL2ltZ2Uua3Vnb3UuY29tL3N0ZG11c2ljLzEwODAvMjAyNTA4MDgvMjAyNTA4MDgxODE4MjM5NjI0ODAuanBnIiwgIjMyMGhhc2giOiAiNzE4NENGRDA3NUU2NEIxMkI5MUFDNDdBRThENTExRDUiLCAic3FoYXNoIjogIjBDNDY3MTk0MzJDNDJCRjlFRTMwOTgxRUM1NUREMEI3IiwgIlJlc0ZpbGVIYXNoIjogIjg4NjA1MEJDM0QyREJCODY3MkQzRjIxNjAwRDRCMjFBIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"爱情讯息-郭静\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJEOEU4NTcyNTBEOEVFQTlDNUZBRkRBRjc4NTc2NDBBNSIsICJ0aXRsZSI6ICJcdTcyMzFcdTYwYzVcdThiYWZcdTYwNmYiLCAiYXJ0aXN0IjogIlx1OTBlZFx1OTc1OSIsICJhbGJ1bSI6ICJcdTRlMGJcdTRlMDBcdTRlMmFcdTU5MjlcdTRlYWUiLCAiYWxidW1faWQiOiAiOTcxMTM5IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjgwLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIxMDExNC8yMDIxMDExNDEwNDk0MDgyOTk4OC5qcGciLCAiMzIwaGFzaCI6ICI3RTkxRDE3MTBFQzBEQTdGNDQ5QzVGQjk0RjkyNUMyNSIsICJzcWhhc2giOiAiOEJFRDE5ODM4RDEyRTdDNjY3NDBGM0U5OEUxRDM5ODUiLCAiUmVzRmlsZUhhc2giOiAiIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"搁浅-周杰伦\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJGQkMyMzQ1MjBGRUQ3MTNDMzBDMUMwMjZFNzM1Mjc3MCIsICJ0aXRsZSI6ICJcdTY0MDFcdTZkNDUiLCAiYXJ0aXN0IjogIlx1NTQ2OFx1Njc3MFx1NGYyNiIsICJhbGJ1bSI6ICJcdTRlMDNcdTkxY2NcdTk5OTkiLCAiYWxidW1faWQiOiAiOTcxNzgzIiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjQwLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDI1MDEyNS8yMDI1MDEyNTEyMTc0NTYyODQzMC5qcGciLCAiMzIwaGFzaCI6ICI1ODFDNTJFMTE5QzhGMjVBOTY1QzdDMkYzRkI3M0RCRCIsICJzcWhhc2giOiAiRDFENzgzNUY5QkVEMjU3RTYxM0EyQzg1NDMzMzY2N0IiLCAiUmVzRmlsZUhhc2giOiAiIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"演员-薛之谦\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIwOTdFNzc3MTcxRjY5Mjg1NUVBRTk4QjY5NjVGOTQ3NyIsICJ0aXRsZSI6ICJcdTZmMTRcdTU0NTgiLCAiYXJ0aXN0IjogIlx1ODU5Ylx1NGU0Ylx1OGMyNiIsICJhbGJ1bSI6ICJcdTdlYzVcdTU4ZWIiLCAiYWxidW1faWQiOiAiMTQ0NTY5MDkiLCAiYWxidW1fYXVkaW9faWQiOiAwLCAiZHVyYXRpb24iOiAyNjEsICJhcnR3b3JrIjogImh0dHA6Ly9pbWdlLmt1Z291LmNvbS9zdGRtdXNpYy8xMDgwLzIwMjUwMjA3LzIwMjUwMjA3MTYxMzI4NzMxNjQzLmpwZyIsICIzMjBoYXNoIjogIjA2MTU2RDEzRTYyOEUyMDA3MjhFREFBNUU1OEVGOUVDIiwgInNxaGFzaCI6ICI2MUQxQURGODBGNTNCNUVGRTc0QTE3RUI3NTFEMDNEQSIsICJSZXNGaWxlSGFzaCI6ICI2NTMzNDA2NTEyNDcxRUY1NEE5NkNBRDg0NjVEMzkzQiIsICJwbGF0Zm9ybSI6ICJrZyIsICJzb3VyY2UiOiAicGx1Z2luIn0=\",\n \"type\": \"music\"\n },\n {\n \"name\": \"特别的人-方大同\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICIwRjdBNzlBREFBRUVCNkVBMURBM0UxOURENjM3RkQ3MyIsICJ0aXRsZSI6ICJcdTcyNzlcdTUyMmJcdTc2ODRcdTRlYmEiLCAiYXJ0aXN0IjogIlx1NjViOVx1NTkyN1x1NTQwYyIsICJhbGJ1bSI6ICJcdTUzNzFcdTk2NjlcdTRlMTZcdTc1NGMiLCAiYWxidW1faWQiOiAiOTY1MDk3IiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjU5LCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDIxMDkwMS8yMDIxMDkwMTE3MjUwMjgzOTE1Mi5qcGciLCAiMzIwaGFzaCI6ICIyMUEwMzg2N0FBRkU5ODFEQThGMEE3RTVFRUFERDY3OCIsICJzcWhhc2giOiAiQzc5NzgyNTM4MjE2MDJGN0E0NEMzRkQ2MjQ2QkI0RUEiLCAiUmVzRmlsZUhhc2giOiAiIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n },\n {\n \"name\": \"烟花易冷-周杰伦\",\n \"url\": \"self:///api/proxy/plugin-url?data=eyJpZCI6ICJCOUZDMDNERjkwMTVENkJGRjA1NTRBMTEwQkYyQzg0RiIsICJ0aXRsZSI6ICJcdTcwZGZcdTgyYjFcdTY2MTNcdTUxYjciLCAiYXJ0aXN0IjogIlx1NTQ2OFx1Njc3MFx1NGYyNiIsICJhbGJ1bSI6ICJcdThkZThcdTY1ZjZcdTRlZTMiLCAiYWxidW1faWQiOiAiOTU4ODEyIiwgImFsYnVtX2F1ZGlvX2lkIjogMCwgImR1cmF0aW9uIjogMjYzLCAiYXJ0d29yayI6ICJodHRwOi8vaW1nZS5rdWdvdS5jb20vc3RkbXVzaWMvMTA4MC8yMDI1MDEyNS8yMDI1MDEyNTEyMTYyODc5OTk2OC5qcGciLCAiMzIwaGFzaCI6ICIxMURDODNBNjk0RTBFNDUxREJFMjFDREZBREJFQzkxNyIsICJzcWhhc2giOiAiM0Q5MTM5NTMyMUVEMTQ1MzFCRUYzMDRENjUzQjJGRkYiLCAiUmVzRmlsZUhhc2giOiAiIiwgInBsYXRmb3JtIjogImtnIiwgInNvdXJjZSI6ICJwbHVnaW4ifQ==\",\n \"type\": \"music\"\n }\n ]\n }\n]\n```\n\n也支持这种格式的网络歌单，歌单内容来自于 ：\n\n```json\n[\n {\n \"name\": \"经典老歌\",\n \"musics\": [\n {\n \"name\": \"爱如潮水-张信哲\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=186345&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"海阔天空-BEYOND\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=qq&id=001yS0N33yPm1B&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"吻别-张学友\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=kuwo&id=157908&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"香水有毒-胡杨林\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=240515&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"千千阕歌-陈慧娴\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=qq&id=000E8jPw26JFub&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"爱拼才会赢-叶启田\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=kuwo&id=564059&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"日不落-蔡依林\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=209643&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"雨蝶-李翊君\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=qq&id=002SPCDg3NAAsY&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"鬼迷心窍-李宗盛\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=kuwo&id=29530546&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"挪威的森林-伍佰\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=5255631&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"爱错-王力宏\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=qq&id=004fneUm24gD2c&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"过火-张信哲\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=423406145&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"夜曲-周杰伦\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=qq&id=001zMQr71F1Qo8&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"美丽的神话-韩红、孙楠\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=kuwo&id=45830172&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"漂洋过海来看你-诗酒趁年华\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=2016124823&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"搁浅-周杰伦\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=qq&id=001Bbywq2gicae&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"突然的自我-伍佰 、 China Blue\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=kuwo&id=4390529&type=url\",\n \"type\": \"music\"\n },\n {\n \"name\": \"西海情歌-刀郎\",\n \"url\": \"https://music-dl.sayqz.com/api/?source=netease&id=77098&type=url\",\n \"type\": \"music\"\n }\n ]\n }\n]\n```\n\n---\n\n### 评论 19 - lowtianwei\n请问自定义网络歌单需要在哪里配置啊？\n---\n\n### 评论 20 - hanxi\n#786 现已经支持B站在线播放形式的歌单，无需下载，适合小机器部署：\n\n```json\n[\n {\n \"name\": \"英文电台\",\n \"musics\": [\n {\n \"name\": \"BBC NEWS\",\n \"url\": \"https://stream.live.vc.bbcmedia.co.uk/bbc_world_service\",\n \"type\": \"radio\"\n },\n {\n \"name\": \"CGTN ENGLISH\",\n \"url\": \"https://english-livetx.cgtn.com/hls/yypdyyctzb_sd.m3u8\",\n \"type\": \"radio\"\n },\n {\n \"name\": \"CGTN BEIJING HOUR\",\n \"url\": \"https://sk.cri.cn/am846.m3u8\",\n \"type\": \"radio\"\n }\n ]\n },\n {\n \"name\": \"B站测试歌单\",\n \"musics\": [\n {\n \"name\": \"晴天\",\n \"url\": \"https://www.bilibili.com/video/BV1U44y1G7a6\"\n }\n ]\n }\n]\n```\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/78)\n" }, { "path": "docs/issues/86.md", "content": "---\ntitle: 微信交流群二维码\n---\n# 微信交流群二维码\n\"Image\"\n## 评论\n\n### 评论 1 - DarrenWen\n群满200人，没法加入了\n---\n\n### 评论 2 - hanxi\n没想到这么快就满了，新建了一个。\n---\n\n### 评论 3 - hanxi\n![mm_reward_qrcode_1726365700471](https://gproxy.hanxi.cc/proxy/user-attachments/assets/7863e361-7e61-48a7-bd71-8f8f609f11b4)\r\n\n---\n\n### 评论 4 - weplayro\n二维码过期了\n\n---\n\n### 评论 5 - hanxi\n> 二维码过期了\n\n更新了\n---\n\n### 评论 6 - JmsWang\n来晚了，又过期了\n---\n\n### 评论 7 - hanxi\n> 来晚了，又过期了\n\n更新了\n---\n\n### 评论 8 - scrawld\n二维码过期了\n---\n\n### 评论 9 - hanxi\n> 二维码过期了\n\n更新了\n---\n\n### 评论 10 - hanlinwangluo\n二维码过期了\n---\n\n### 评论 11 - hanxi\n> 二维码过期了\n\n更新了\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/86)\n" }, { "path": "docs/issues/88.md", "content": "---\ntitle: 如何添加m3u格式文件的电台\n---\n# 如何添加m3u格式文件的电台\n比如可以找到这样的 m3u 电台文件: https://github.com/YueChan/Live/blob/main/Radio.m3u\r\n\r\n1. 复制文件内容，粘贴到 m3u 转换工具里，点击转换为 json 格式:\r\n\r\n![Screenshot_2024-06-29-11-28-58-904_com android chrome](https://gproxy.hanxi.cc/proxy/hanxi/xiaomusic/assets/1185757/bb812a47-17c5-4483-9234-4cf33367b181)\r\n\r\n2. 然后复制 json 内容，粘贴到歌单内容里，点击保存，再返回首页:\r\n\r\n![Screenshot_2024-06-29-11-29-22-248_com android chrome](https://gproxy.hanxi.cc/proxy/hanxi/xiaomusic/assets/1185757/2fb4ca44-6b79-4438-9bc6-cfbd01272f20)\r\n\r\n3. 在首页点击刷新列表，选择所有电台，再点击播放列表歌曲:\r\n\r\n![Screenshot_2024-06-29-11-29-55-621_com android chrome](https://gproxy.hanxi.cc/proxy/hanxi/xiaomusic/assets/1185757/c94e4667-f83e-4cd5-9662-e680316cb5b4)\r\n\r\n4. 也可以用口令播放电台: `播放列表所有电台` ，或者口令: `播放歌曲北京城市广播`\n## 评论\n\n### 评论 1 - guoxiangke\n转换m3u链接： http://127.0.0.1:8090/static/m3u.html \n---\n\n### 评论 2 - guoxiangke\nhttp://127.0.0.1:8090/playurl?did=mydid&url=https://a.com/test.m3u 如果能支持 这么播放m3u 就太完美了 \r\n希望能够支持，谢谢作者。\n---\n\n### 评论 3 - hanxi\n> http://127.0.0.1:8090/playurl?did=mydid&url=https://a.com/test.m3u 如果能支持 这么播放m3u 就太完美了 希望能够支持，谢谢作者。\r\n\r\n不想破坏现有接口，可以考虑用插件的方式来实现。\n---\n\n### 评论 4 - lazybabyz\npotplayer 测试 https://raw.githubusercontent.com/YueChan/Live/refs/heads/main/Radio.m3u 部分可以听\r\nxiaomusic测试 https://github.com/YueChan/Live/blob/main/Radio.m3u 复制raw文件转换 全部失败不停转台\r\n\r\n以下potplayer测试 可以听，xiaomusic测试 复制raw文件转换 全部失败不停转台\r\n\r\nhttps://raw.githubusercontent.com/kaige-cai/live/refs/heads/main/radio.m3u\r\nhttps://raw.githubusercontent.com/imDazui/Tvlist-awesome-m3u-m3u8/master/m3u/%E5%B9%BF%E6%92%AD%E7%94%B5%E5%8F%B02021.m3u \r\n\r\n\n---\n\n### 评论 5 - hanxi\n检查一下是不是 ipv6 的地址？小米音箱不支持 ipv6\n---\n\n### 评论 6 - lazybabyz\n> 检查一下是不是 ipv6 的地址？小米音箱不支持 ipv6\r\n\r\n是我硬件设置的问题 重新安装了 解决!\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/88)\n" }, { "path": "docs/issues/94.md", "content": "---\ntitle: 采用config.json配置方式\n---\n# 采用config.json配置方式\ndocker 方式部署默认推荐使用环境变量的方式来配置参数，如果是自己用命令行启动，目前支持的参数配置比较少，但是是支持 `--config` 参数。\r\n\r\n使用 pip 安装 xiaomusic 【0.1.83版本才支持 pip 安装】\r\n\r\n```shell\r\npip install xiaomusic\r\n```\r\n\r\n依赖的 ffmpeg 需要自己安装。\r\n\r\n![image](https://gproxy.hanxi.cc/proxy/hanxi/xiaomusic/assets/1185757/6912e3ec-c42f-42de-b027-a296f5a26ba1)\r\n\r\n仓库中有个 config-example.json 文件，可以把这个文件拷贝为 config.json 然后修改 config.json 里的配置，再用下面的命令启动。\r\n\r\n```shell\r\nxiaomusic --config ./config.json\r\n```\r\n\r\n默认的 config.json 模板如下：\r\n\r\n```json\r\n{\r\n \"hardware\": \"L07A\",\r\n \"account\": \"\",\r\n \"password\": \"\",\r\n \"mi_did\": \"\",\r\n \"cookie\": \"\",\r\n \"verbose\": false,\r\n \"music_path\": \"music\",\r\n \"conf_path\": null,\r\n \"hostname\": \"192.168.2.5\",\r\n \"port\": 8090,\r\n \"proxy\": null,\r\n \"search_prefix\": \"ytsearch:\",\r\n \"ffmpeg_location\": \"./ffmpeg/bin\",\r\n \"active_cmd\": \"play,random_play,playlocal,play_music_list,stop\",\r\n \"exclude_dirs\": \"@eaDir\",\r\n \"music_path_depth\": 10,\r\n \"disable_httpauth\": true,\r\n \"httpauth_username\": \"admin\",\r\n \"httpauth_password\": \"admin\",\r\n \"music_list_url\": \"\",\r\n \"music_list_json\": \"\",\r\n \"disable_download\": false,\r\n \"use_music_api\": false,\r\n \"log_file\": \"/tmp/xiaomusic.txt\",\r\n \"fuzzy_match_cutoff\": 0.6,\r\n \"enable_fuzzy_match\": true\r\n}\r\n```\r\n\r\n如果采用 docker compose 启动想用 config.json 的配置方式，可以这样配: \r\n\r\n```yaml\r\nservices:\r\n xiaomusic:\r\n image: hanxi/xiaomusic\r\n container_name: xiaomusic\r\n restart: unless-stopped\r\n ports:\r\n - 8090:8090\r\n volumes:\r\n - ./music:/app/music\r\n - ./config.json:/app/config.json\r\n command: ['--config', '/app/config.json']\r\n```\r\n主要就是把 config.json 文件映射进容器和传 `--config` 参数。\n## 评论\n\n### 评论 1 - alitime\n正需要，有配置文件方便多了\n---\n\n### 评论 2 - hanxi\nffmpeg 如果是用 apt install 这类系统工具安装的，默认会在 /usr/bin 目录下，ffmpeg_location 这个参数就需要设置为 /usr/bin .\r\n\r\n目前 armv7 cpu 的 docker 镜像里的 ffmpeg 有问题，最好是用 pip 方式安装运行。\n---\n\n### 评论 3 - hanxi\n> ffmpeg 如果是用 apt install 这类系统工具安装的，默认会在 /usr/bin 目录下，ffmpeg_location 这个参数就需要设置为 /usr/bin .\r\n> \r\n> 目前 armv7 cpu 的 docker 镜像里的 ffmpeg 有问题，最好是用 pip 方式安装运行。\r\n\r\narmv7 问题已经解决。\n---\n\n### 评论 4 - wuqiang0720\npip 部署完了然后怎么操作呢，有配置文件参数解释的文档吗？\n---\n\n### 评论 5 - hanxi\n> pip 部署完了然后怎么操作呢，有配置文件参数解释的文档吗？\n\n可以不需要的，直接一样在web后台设置即可。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/94)\n" }, { "path": "docs/issues/96.md", "content": "---\ntitle: ios系统上的捷径配置\n---\n# ios系统上的捷径配置\n下面是播放音乐和关机两个示例。只要在 web 页面上能看到的功能，都有对应的 http 请求接口，都可以用来配置捷径。\r\n\r\n![mmexport1719767452647](https://gproxy.hanxi.cc/proxy/hanxi/xiaomusic/assets/1185757/db0a1856-e1ed-47cb-972d-d997f71bf92b)\r\n\r\n![mmexport1719767449742](https://gproxy.hanxi.cc/proxy/hanxi/xiaomusic/assets/1185757/92b7bc4b-9699-49cc-956a-4bddb6bd50fa)\r\n\n## 评论\n\n### 评论 1 - Yumega\n为什么我的捷径设置无效\nhttp://192.168.11.1:5678/cmd 这个电脑可以打开 显示 {\"detail\":\"Method Not Allowed\"}\n\n参照楼主的方法 用iOS捷径无效\n---\n\n### 评论 2 - hanxi\n方便截图看看怎么填的吗？\n---\n\n### 评论 3 - Yumega\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/448e0837-665a-4c46-9598-9c747bdbc422)\n---\n\n### 评论 4 - Yumega\n> 方便截图看看怎么填的吗？\n\n😏什么原因\n---\n\n### 评论 5 - hanxi\n@Yumega 等有空我试试，目前没时间。\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/96)\n" }, { "path": "docs/issues/99.md", "content": "---\ntitle: 💬 FAQ问题集合\n---\n# 💬 FAQ问题集合\n> [!NOTE]\n> 这个 issue 用来总结报错日志和对应的解决方法。\n\n## Login Failed 登陆失败\n\n表现就是 **后台看不到设备列表** ，日志中会有对应的报错。\n\n可以试试用 cookie 登陆: \n\n这个有专门的讨论，见 ，一般是因为开了加速代理，关代理再尝试即可。也可以试试在局域网设备里的米家app上退出再重新登录一下。\n\n在小米官网 www.mi.com 登陆过人脸或滑块验证基本上能解决 99%的 login failed 问题。\n\n来自 @yilikun 的友情提示：\n> 1. 关闭本地代理。\n> 2. 如果是nas运行的，网络由bridge改为host。\n> 3. 米家app重新登陆。\n> 4. mi.com官网重新登陆。\n> 5. 检查 setting.json 文件里的账号密码是否正确。\n\n如果是在 openwrt 类路由器系统上安装的，请检查路由器的防火墙设置。\n\n## 用一段时间就看不到设备\n\n- 获取对话记录太频繁，不用的时候请关闭【语音口令】开关。\n\n\"Image\"\n\n- 不使用小米的TTS，改完 Edge-TTS，在设置界面选一个 Edge-TTS 音色。\n\n\"Image\"\n\n## 网页后台可以播放，语音控制无效\n\n语音口令功能默认关闭，需要去设置页面打开【获取对话记录】开关 / 也就是主页的【语音口令】开关。请谨慎打开这个功能，可能会因为频繁请求导致登陆失败的问题，建议不使用的时候随手关闭。\n\n这种情况是拉取不到对话记录导致的。\n如果是首次在网页后台保存 did 后需要重启一次容器。\n其他情况可能是被限制拉取对话记录次数，也可以尝试重启容器。\n还有一种情况是配错了唤醒口令，可以在小爱音箱app里查看对话记录，也可以查看 xiaomusic 的日志。默认口令前缀是【播放歌曲】，没有这个前缀是无法识别的，说播放音乐是没用的，除非自己设置其他口令词。\n已知 `M01/XMYX01JY 小米小爱音箱HD` 获取对话记录的接口比较特殊，需要开启【特殊型号获取对话记录:】开关才能正常语音控制。\n\n## 语音提示音无效\n\n一般是因为 TTS 登陆失败，可以配置 【Edge-TTS 语音角色:】来解决，只是无法使用音箱自带的 TTS 语音。\n\n## 日志显示正在播放，却没有声音\n\n可以点击播放链接按钮，看看默认的那个链接能否播放。\n\n已知部分触屏版不能播放可以在后台设置 【型号兼容模式】为 true 试试。如果你的设备型号需要手动设置这个选项，请在 /issues/453.html 中反馈。\n\n其他情况可能是 XIAOMUSIC_HOSTNAME 配错了地址，不是 docker 主机地址会导致小爱音箱无法访问到，而且需要和小爱音箱在同一个**局域网**下的地址。还有可能是端口配错了，**修改了默认 8090 端口映射**，需要同步修改其他参数，可以翻阅端口修改的文档。\n\n如果端口不是8090，首次启动没配好端口的话，需要手动修改setting.json文件里的端口，或者把setting.json文件删除重新配置，或者在后台修改监听端口后重启。\n\n可以点击播放歌曲后，查看日志里的歌曲链接，放到浏览器里打开试试，不能访问说明是端口或者hostname问题，如果是异地访问，需要把 hostname 修改为外网ip或者域名，需要注意音箱只支持访问ipv4，不能是ipv6的公网。\n\n如果是配了公网反代端口，注意区分是 http 还是 https ，如果是 https 的，配置 XIAOMUSIC_HOSTNAME 时需要加上 `https:// ` 前缀。\n\n如果是在 openwrt 类路由器系统上安装的，请检查路由器的防火墙设置。\n\n如果是在 windows 上安装的，请关闭防火墙。另外ip别填localhost，填192开头的那个ip.\n\n## 无法播放 flac 格式歌曲\n\n因设备差异和文件格式差异，已知部分设备不支持 flac 格式，比如 L05B L05C 。建议提前用其他工具批量把文件格式转为 mp3 ，也可以在后台设置里打开【转换为MP3】，但是会比较消耗 CPU ，会影响体验。\n\n## docker 镜像拉取失败\n\n请更换镜像源或者使用代理。不同环境更换镜像源的方式不一样，可以网上搜索自己的 NAS 如何更换镜像源。\n\n已经可以通过 [DaoCloud](https://github.com/DaoCloud/public-image-mirror) 拉取镜像。\n\n```\ndocker pull m.daocloud.io/docker.io/hanxi/xiaomusic:latest\ndocker tag m.daocloud.io/docker.io/hanxi/xiaomusic:latest hanxi/xiaomusic:latest\n```\n\n更多镜像源见 \n\n## 启动失败，日志中出现 RuntimeError: can't start new thread\n\n一般是 docker 版本太低，或者系统限制了 docker 使用的 cpu 数量，可以尝试升级 docker 到最新版本。\n\n## DNS 解析错误\n\n一般会出现下面这样的日志，表现就是设置页面看不到设备列表。\n\n```\naiohttp.client_ _exceptions. ClientConnectorError: Cannot connect to host account.xiaomi.com:443 ssl:False [Temporary failure in name resolution]\n```\n\n可以尝试把主机的 DNS 设为 223.5.5.5 之后重启 docker 主机。\n\n如果还是不行可以把 docker 的网络模式改成 host 模式。\n\n## 如何配置多个歌曲目录\n\n```yaml\nservices:\n xiaomusic:\n image: hanxi/xiaomusic\n container_name: xiaomusic\n restart: unless-stopped\n ports:\n - 8090:8090\n volumes:\n - /data/music1:/app/music/music1\n - /data/music2:/app/music/music2\n - /data/download:/app/music/download\n - /data/xiaomusic/conf:/app/conf\n```\n\n冒号左边的 `/data/music1` 和 `/data/music2` 改成你的目录即可。如果你是 windows 的 docker ，可以改成 `D:/music1` 和 `D:/music2`，盘符号开头，用 `/` 分割。配置多个歌曲目录时，冒号右边不要有单独的 `/app/music` ，都只能是 `/app/music/` 的子目录。\n\n另外如果是 docker 部署的，建议不要去修改 web 后台里的音乐路径和配置路径等等所有路径除非你熟悉 docker 的目录映射机制。\n\n## 能不能中文名\n\n```yaml\nservices:\n xiaomusic:\n image: hanxi/xiaomusic\n container_name: xiaomusic\n restart: unless-stopped\n ports:\n - 8090:8090\n volumes:\n - /data/music1:/app/music/歌曲目录1\n - /data/music2:/app/music/歌曲目录2\n - /data/download:/app/music/download\n - /data/xiaomusic/conf:/app/conf\n```\n\n## 能不能多层目录\n\n可以，每层的每个目录会识别为一个播放列表。\n\n## 是否需要手动获取 did\n\n不需要手动获取配置 did，不需要配置环境变量，直接在 web 后台填入小米账号密码保存后会自动获取到 did ，然后勾选对应的设备即可。\n\n## 报错 601\n\n报错日志大致如下:\n\n```txt\nException: Error https://api2.mina.mi.com/remote/ubus: {\"code\":601,\"message\":\"illegal argument exception\",\"data\":\"IllegalArgumentException: ubus call format illegal!\"}\n```\n\n原因是没有配置 did ，或者 did 配置错误。可以到设置页面选择正确的设备类型和 did 然后保存。\n\n## 新功能没有生效\n\n在设置页面重新保存一下，或者删除 setting.json 文件，重新在后台设置一次。\n\n## 为什么会先说小爱音箱自带的回答，再说下载中或者过一会儿才播放本地歌曲\n\n设计原理就是每秒不停的抓取对话记录，然后再打断小爱音箱自带的处理流程。整个过程下来会有延时，所以打断不会很及时，做不到无缝衔接。\n\n## 云服务器上能否安装\n\n可以安装，登录 mi.com 这个步骤可以使用终端里的浏览器 [carbonyl](https://github.com/fathyb/carbonyl) 来操作：\n\n```shell\ndocker run --rm -ti fathyb/carbonyl https://mi.com\n```\n\n或者使用 [browsh](https://github.com/browsh-org/browsh)\n\n```shell\ndocker run --rm -it browsh/browsh --startup-url https://mi.com\n```\n\n## 在播放歌曲时，问小爱查询天气，小爱查询天气时，中途会断掉。\n\n播放中会被xiaomusic接管，会跟原有功能冲突，需要先说关机来关闭xiaomusic的功能，再问小爱查询天气。\n\n## 我家有个奇怪的问题，你给它暂停了，它过一会儿又自己开始唱了，不勘其扰。小爱重启都没用。\n\n要说【关机】才能关掉 xiaomusic ，否则下一曲定时器到了会继续播放下一曲。\n\n## 为什么播放进度条不能拖动\n\n没有接口，目前做不到。\n\n## 小爱触屏能不能显示本地的歌名歌词封面\n\n可以，设置页面打开【启用继续播放】开关。\n\n## 看不到歌曲列表\n\n1. 检查目录挂载是否正确\n2. 检查目录权限是否正确\n3. 检查文件夹名字是否是 UTF-8 格式\n\n\n## 本机有声音，小爱音箱没声音，请问什么原因？\n\n排查步骤:\n\n1. 测试链接是否能播放，能播放说明小爱音箱控制没问题，继续下一步排查。不能播放说明控制不了你的小爱音箱，一般是【型号兼容模式】设置问题。\n3. 小爱音箱和 NAS 是否在同一个局域网，检查 NAS 的 IP 和音箱的 IP 是否在同一个网段，不在同一个网段会导致音箱无法访问到 NAS 。如果在同一个局域网，检查 NAS 上的防火墙配置，关闭防火墙再测试，如果还是不行就继续下一步。\n4. 查看容器日志中的歌曲链接是否正常，点击后台页面上的播放歌曲时，容器中会有歌曲链接，一般是 http 开头的链接，复制完整链接到浏览器试试看能否打开，能打开说明网络没问题，继续下一步排查。不能打开有可能是 ip 和端口配置错误，请使用设置页面的自动填按钮自动填 ip 和端口。\n5. 歌曲文件格式是否是 mp3 格式，有些型号无法播放 flac 格式的歌曲，请使用 mp3 格式的歌曲文件测试，一个不行就多找几个文件测试。\n\n## 在安装好第一次用语音正常，第二天就不能用语音了\n\n拉取对话记录的问题。拉取对话记录太频繁了，可以使用[定时任务功能](/issues/182.html)，设置晚上关闭拉取对话记录。比如这样设置是早上6点开启拉取对话记录，晚上12点关闭：\n```\n[\n {\n \"expression\": \"0 6 * * *\",\n \"name\": \"set_pull_ask\",\n \"arg1\": \"enable\"\n },\n {\n \"expression\": \"0 0 * * *\",\n \"name\": \"set_pull_ask\",\n \"arg1\": \"disable\"\n }\n]\n```\n\n## 播放下一首歌曲时会重复播放上一首歌曲的前几秒\n\n时间延迟问题，可以把【下一首歌延迟播放秒数】设置成负数，表示提前几秒结束播放。\n\n## 启动不了，报错 supervisord not found\n\n```\n/bin/sh: /usr/bin/supervisord: not found\n```\n 清除 docker 镜像缓存，重启 docker 。 见 #695 \n## 评论\n\n### 评论 1 - shissx\n安装的最新版本，即使没有使用，日志一直在不停的刷新，示例：\r\n[10:20:36] [0.1.101] [DEBUG] Polling_event, timestamp: {'eeb70da5-baa9-4b56-b2f3-7ee01276a18a': 1720430457236}\r\n[10:20:36] [0.1.101] [DEBUG] Sleep 0.0003166699898429215, timestamp: {'eeb70da5-baa9-4b56-b2f3-7ee01276a18a': 1720430457236}\r\n[10:20:37] [0.1.101] [DEBUG] Listening new message, timestamp: {'eeb70da5-baa9-4b56-b2f3-7ee01276a18a\r\n\r\n之前的版本没有这个问题，这个是设置错误？还是本来就如此呢？\n---\n\n### 评论 2 - hanxi\n> 安装的最新版本，即使没有使用，日志一直在不停的刷新，示例： [10:20:36] [0.1.101] [DEBUG] Polling_event, timestamp: {'eeb70da5-baa9-4b56-b2f3-7ee01276a18a': 1720430457236} [10:20:36] [0.1.101] [DEBUG] Sleep 0.0003166699898429215, timestamp: {'eeb70da5-baa9-4b56-b2f3-7ee01276a18a': 1720430457236} [10:20:37] [0.1.101] [DEBUG] Listening new message, timestamp: {'eeb70da5-baa9-4b56-b2f3-7ee01276a18a\r\n> \r\n> 之前的版本没有这个问题，这个是设置错误？还是本来就如此呢？\r\n\r\n正常现象，现在默认把调试日志打开了，可以在后台设置关闭调试日志的。\n---\n\n### 评论 3 - Dx0123\n大佬，docker安装提示缺少很多module，我一个个在dockerfilie里加上，最后卡在miservice装不上了~\n---\n\n### 评论 4 - hanxi\n@Dx0123 其实不用手动安装依赖的，直接一行应该就行。\r\n```\r\nRUN pip install -U xiaomusic\r\n```\r\n\r\n\n---\n\n### 评论 5 - Dx0123\n> @Dx0123 其实不用手动安装依赖的，直接一行应该就行。\r\n> \r\n> ```\r\n> RUN pip install -U xiaomusic\r\n> ```\r\n\r\n我直接用pip安装好之后，执行仍然有缺少的依赖，和docker里缺的一样。截图的module安装了之后还会有其他依赖缺失\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/9fb182e2-ad41-488d-8633-4bae06202f73)\r\n\n---\n\n### 评论 6 - hanxi\n@Dx0123 你的python版本是不是有问题？你参考下项目里的Dockerfile，用同一个From镜像试试。\n---\n\n### 评论 7 - hanxi\n> 有时候指令已停止，可是一会儿，又自动播放下一首，根本就停不下来。需要重启容器才能正常\r\n\r\n点关机按钮也不行吗？\n---\n\n### 评论 8 - hanxi\n> > > 有时候指令已停止，可是一会儿，又自动播放下一首，根本就停不下来。需要重启容器才能正常\r\n> > \r\n> > \r\n> > 点关机按钮也不行吗？\r\n> \r\n> 是的，说关机，点关机，暂停都不行。只能重启容器。\r\n\r\n有没有日志看看？\n---\n\n### 评论 9 - sqmcool\n为什么我的没有显示设备？\r\n![Snipaste_2024-09-14_15-51-00](https://gproxy.hanxi.cc/proxy/user-attachments/assets/245d9a85-4ee1-4c82-be0d-865a29827072)\r\n\n---\n\n### 评论 10 - hanxi\n> 为什么我的没有显示设备？ ![Snipaste_2024-09-14_15-51-00](https://private-user-images.githubusercontent.com/14977818/367498420-245d9a85-4ee1-4c82-be0d-865a29827072.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYzMDQ4NjksIm5iZiI6MTcyNjMwNDU2OSwicGF0aCI6Ii8xNDk3NzgxOC8zNjc0OTg0MjAtMjQ1ZDlhODUtNGVlMS00YzgyLWJlMGQtODY1YTI5ODI3MDcyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MTQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTE0VDA5MDI0OVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPThjNzJkYTQyYzVhMmU2N2Y3M2MwZjc4ZjE5MDg4ODFlMGVhYjdmZGYxMGFjYmI2N2ViN2JlOGUzZTEwYWMxZmUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.4EaUyKhUmE1KNVseE_b25oJGnWSeKDsKpjzViAeltHY)\r\n\r\n应该是登陆失败，可以查看一下日志。\n---\n\n### 评论 11 - schppd\n楼主您好，请问这个我需要怎么处理？\r\n![微信截图_20240915225040](https://gproxy.hanxi.cc/proxy/user-attachments/assets/d4ecb7fb-6a47-4c66-bbab-72babf4afb9c)\r\n\n---\n\n### 评论 12 - hanxi\n> 楼主您好，请问这个我需要怎么处理？ ![微信截图_20240915225040](https://private-user-images.githubusercontent.com/108209415/367590244-d4ecb7fb-6a47-4c66-bbab-72babf4afb9c.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY0MTI0NjcsIm5iZiI6MTcyNjQxMjE2NywicGF0aCI6Ii8xMDgyMDk0MTUvMzY3NTkwMjQ0LWQ0ZWNiN2ZiLTZhNDctNGM2Ni1iYmFiLTcyYmFiZjRhZmI5Yy5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwOTE1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDkxNVQxNDU2MDdaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02Yjg5ZTU4MDAzNDc5YmI2OTdlM2MxYjM0MGIwY2U4YmExOTk2MmIyMTM0MGIxNmFjYmZmMDIxYzc1Mjk5YTE5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.zTAh3m7_AxAIS00LTRHrX23zDD1tVWuXD6wDPsiia9g)\r\n\r\n删掉重新配置一下试试。\n---\n\n### 评论 13 - schppd\n会不会跟网络不稳定有关系？我都弄了几次还是这样子\r\n\r\n\r\n\r\n\r\n------------------ 原始邮件 ------------------\r\n发件人: \"hanxi/xiaomusic\" ***@***.***>;\r\n发送时间: 2024年9月15日(星期天) 晚上10:57\r\n***@***.***>;\r\n***@***.******@***.***>;\r\n主题: Re: [hanxi/xiaomusic] FAQ问题集合 (Issue #99)\r\n\r\n\r\n\r\n\r\n\r\n \r\n楼主您好，请问这个我需要怎么处理？ \r\n \r\n删掉重新配置一下试试。\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n### 评论 14 - hanxi\n> 会不会跟网络不稳定有关系？我都弄了几次还是这样子\r\n> […](#)\r\n> ------------------ 原始邮件 ------------------ 发件人: \"hanxi/xiaomusic\" ***@***.***>; 发送时间: 2024年9月15日(星期天) 晚上10:57 ***@***.***>; ***@***.******@***.***>; 主题: Re: [hanxi/xiaomusic] FAQ问题集合 (Issue #99) 楼主您好，请问这个我需要怎么处理？ 删掉重新配置一下试试。 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***>\r\n\r\n有可能的，用代理试试。\n---\n\n### 评论 15 - guoxiangke\n定制的时候，\"全部\"和”所有歌曲\"的区别，帮助有需要的朋友：\r\n歌单中 \"全部\" 指的是 所有歌单中歌曲，但不包括“歌单内容”配置（http://127.0.0.1:8090/static/setting.html）中的电台 \"type\": \"radio\",的\r\n”所有歌曲\" 指的是下载的歌曲，在download文件夹里\r\n\r\n\n---\n\n### 评论 16 - agigogo\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/4fed0748-5497-47b5-ac9c-9cbc1d826a94)\r\n在docker里可以运行，但是没法播放设置页面中的播放链接，选中设备那里是空的，是不是没成功？怎么调整？\r\n\n---\n\n### 评论 17 - hanxi\n> ![image](https://private-user-images.githubusercontent.com/73272860/369268116-4fed0748-5497-47b5-ac9c-9cbc1d826a94.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4MTQ0MzksIm5iZiI6MTcyNjgxNDEzOSwicGF0aCI6Ii83MzI3Mjg2MC8zNjkyNjgxMTYtNGZlZDA3NDgtNTQ5Ny00N2I1LWFjOWMtOWNiYzFkODI2YTk0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MjAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTIwVDA2MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFkNzg5MDQ1ZDQ5N2VmODg5MWQzYzM4MWY5OTI1ZDRhNzQ3ZjNjM2VmOTA1MDQwNGU3ZGM0Y2I1MDkwY2MzNWUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.GlUL5Oqk9-SqLH9chSQxxm9sI3tkbqNoQ8To8UjrawE) 在docker里可以运行，但是没法播放设置页面中的播放链接，选中设备那里是空的，是不是没成功？怎么调整？\r\n\r\n设置页面输入小米的账号密码后，再勾选一个设备。\n---\n\n### 评论 18 - agigogo\n> > ![image](https://private-user-images.githubusercontent.com/73272860/369268116-4fed0748-5497-47b5-ac9c-9cbc1d826a94.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4MTQ0MzksIm5iZiI6MTcyNjgxNDEzOSwicGF0aCI6Ii83MzI3Mjg2MC8zNjkyNjgxMTYtNGZlZDA3NDgtNTQ5Ny00N2I1LWFjOWMtOWNiYzFkODI2YTk0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MjAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTIwVDA2MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFkNzg5MDQ1ZDQ5N2VmODg5MWQzYzM4MWY5OTI1ZDRhNzQ3ZjNjM2VmOTA1MDQwNGU3ZGM0Y2I1MDkwY2MzNWUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.GlUL5Oqk9-SqLH9chSQxxm9sI3tkbqNoQ8To8UjrawE) 在docker里可以运行，但是没法播放设置页面中的播放链接，选中设备那里是空的，是不是没成功？怎么调整？\r\n> \r\n> 设置页面输入小米的账号密码后，再勾选一个设备。\r\n\r\n设置页面里没有勾选的选项\r\n\r\n> > ![image](https://private-user-images.githubusercontent.com/73272860/369268116-4fed0748-5497-47b5-ac9c-9cbc1d826a94.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4MTQ0MzksIm5iZiI6MTcyNjgxNDEzOSwicGF0aCI6Ii83MzI3Mjg2MC8zNjkyNjgxMTYtNGZlZDA3NDgtNTQ5Ny00N2I1LWFjOWMtOWNiYzFkODI2YTk0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MjAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTIwVDA2MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFkNzg5MDQ1ZDQ5N2VmODg5MWQzYzM4MWY5OTI1ZDRhNzQ3ZjNjM2VmOTA1MDQwNGU3ZGM0Y2I1MDkwY2MzNWUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.GlUL5Oqk9-SqLH9chSQxxm9sI3tkbqNoQ8To8UjrawE) 在docker里可以运行，但是没法播放设置页面中的播放链接，选中设备那里是空的，是不是没成功？怎么调整？\r\n> \r\n> 设置页面输入小米的账号密码后，再勾选一个设备。\r\n\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/a4185b88-89b2-4682-b931-47fa39463c0c)\r\n设置页面没有可勾选项？\n---\n\n### 评论 19 - agigogo\n> > > ![image](https://private-user-images.githubusercontent.com/73272860/369268116-4fed0748-5497-47b5-ac9c-9cbc1d826a94.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4MTQ0MzksIm5iZiI6MTcyNjgxNDEzOSwicGF0aCI6Ii83MzI3Mjg2MC8zNjkyNjgxMTYtNGZlZDA3NDgtNTQ5Ny00N2I1LWFjOWMtOWNiYzFkODI2YTk0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MjAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTIwVDA2MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFkNzg5MDQ1ZDQ5N2VmODg5MWQzYzM4MWY5OTI1ZDRhNzQ3ZjNjM2VmOTA1MDQwNGU3ZGM0Y2I1MDkwY2MzNWUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.GlUL5Oqk9-SqLH9chSQxxm9sI3tkbqNoQ8To8UjrawE) 在docker里可以运行，但是没法播放设置页面中的播放链接，选中设备那里是空的，是不是没成功？怎么调整？\r\n> > \r\n> > \r\n> > 设置页面输入小米的账号密码后，再勾选一个设备。\r\n> \r\n> 设置页面里没有勾选的选项\r\n> \r\n> > > ![image](https://private-user-images.githubusercontent.com/73272860/369268116-4fed0748-5497-47b5-ac9c-9cbc1d826a94.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4MTQ0MzksIm5iZiI6MTcyNjgxNDEzOSwicGF0aCI6Ii83MzI3Mjg2MC8zNjkyNjgxMTYtNGZlZDA3NDgtNTQ5Ny00N2I1LWFjOWMtOWNiYzFkODI2YTk0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MjAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTIwVDA2MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFkNzg5MDQ1ZDQ5N2VmODg5MWQzYzM4MWY5OTI1ZDRhNzQ3ZjNjM2VmOTA1MDQwNGU3ZGM0Y2I1MDkwY2MzNWUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.GlUL5Oqk9-SqLH9chSQxxm9sI3tkbqNoQ8To8UjrawE) 在docker里可以运行，但是没法播放设置页面中的播放链接，选中设备那里是空的，是不是没成功？怎么调整？\r\n> > \r\n> > \r\n> > 设置页面输入小米的账号密码后，再勾选一个设备。\r\n> \r\n> ![image](https://private-user-images.githubusercontent.com/73272860/369589185-a4185b88-89b2-4682-b931-47fa39463c0c.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjY4ODUzMzgsIm5iZiI6MTcyNjg4NTAzOCwicGF0aCI6Ii83MzI3Mjg2MC8zNjk1ODkxODUtYTQxODViODgtODliMi00NjgyLWI5MzEtNDdmYTM5NDYzYzBjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA5MjElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwOTIxVDAyMTcxOFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTA3NzU1YjcwYWY2ZTNmYTRiZTY4NGU0MDMyZGIxNDBjYjE3ZThhNzdjMmJhYWEzYjE4MjJjMjgyNzk4OWVlODUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.0MwpJNlNUU9XhjwOFcLisXQHFTAjsU8lscTm5-sfZpw) 设置页面没有可勾选项？\r\n\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6bdf44b1-03cd-436f-a222-4889301affaa)\r\n\r\n显示未检测到设备，设备型号是MDZ-25-DA\n---\n\n### 评论 20 - hanxi\n@agigogo 应该是登陆失败了，局域网的手机重新登陆一下小爱音箱app吧。\n---\n\n### 评论 21 - agigogo\n> @agigogo 应该是登陆失败了，局域网的手机重新登陆一下小爱音箱app吧。\r\n\r\n一直都是用米家APP来控制小爱音箱，那要下个小爱音响APP试一试 \n---\n\n### 评论 22 - agigogo\n> @agigogo 应该是登陆失败了，局域网的手机重新登陆一下小爱音箱app吧。\r\n\r\n搞定了，小爱音箱app重新绑定就可以了。真6~\n---\n\n### 评论 23 - Tueafternoon\n一首歌结束不能自动切到下一首，随机播放模式，日志中显示下一曲定时器不见了....这个是咋回事啊\n---\n\n### 评论 24 - hanxi\n> 一首歌结束不能自动切到下一首，随机播放模式，日志中显示下一曲定时器不见了....这个是咋回事啊\r\n\r\n可能是音乐文件有问题，获取歌曲长度失败，你可以把歌曲文件上传一下给我测试。\n---\n\n### 评论 25 - hanxi\n或者搜下日志里有没有 不会设置下一首歌的定时器 这个\n---\n\n### 评论 26 - Tueafternoon\n> 或者搜下日志里有没有 不会设置下一首歌的定时器 这个\r\n\r\n有这个，应该是我的文件格式问题，晚上我处理一下再试试\n---\n\n### 评论 27 - zealler9560\n![Screenshot_2024-10-31-23-28-57-903_com.android.chrome.jpg](https://gproxy.hanxi.cc/proxy/user-attachments/assets/541ff644-0dcd-4bda-a142-2eb4a0f94b9d)\n\nistore系统可以拉取创建镜像，但是无法启动，错误提示见图一，求助大佬！路由器信息见图二![Screenshot_2024-10-31-23-36-42-846-edit_com.android.chrome.jpg](https://gproxy.hanxi.cc/proxy/user-attachments/assets/767383a5-8f84-471b-ab15-61e0fe9cbb22)\n\n\n---\n\n### 评论 28 - adidas004\n在群晖使用docker安装的，只能通过重装来升级到最新版本吗？有快捷的一键升级吗\n---\n\n### 评论 29 - hanxi\n> 在群晖使用docker安装的，只能通过重装来升级到最新版本吗？有快捷的一键升级吗\r\n\r\n不会命令行，就用这个工具吧。 https://github.com/onlyLTY/dockerCopilot\n---\n\n### 评论 30 - adidas004\n谢谢您的工具，我刚去群晖的docker上有提示直接升级，还是非常的感觉你的回答\r\n\r\n\r\n\r\n\r\n------------------ 原始邮件 ------------------\r\n发件人: ***@***.***>; \r\n发送时间: 2024年11月11日(星期一) 下午4:20\r\n收件人: ***@***.***>; \r\n抄送: ***@***.***>; ***@***.***>; \r\n主题: Re: [hanxi/xiaomusic] 💬 FAQ问题集合 (Issue #99)\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n \r\n在群晖使用docker安装的，只能通过重装来升级到最新版本吗？有快捷的一键升级吗\r\n \r\n不会命令行，就用这个工具吧。 https://github.com/onlyLTY/dockerCopilot\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n### 评论 31 - sinojelly\n运行时遇到下面问题，请问要怎么排查？\r\n```\r\n2024/11/21 19:27:00 xiaomusic.py: error: unrecognized arguments: .venv/bin/python3 xiaomusic.py\r\n2024/11/21 19:27:00 [--enable_config_example]\r\n2024/11/21 19:27:00 [--ffmpeg_location FFMPEG_LOCATION]\r\n2024/11/21 19:27:00 [--config CONFIG]\r\n2024/11/21 19:27:00 [--verbose]\r\n2024/11/21 19:27:00 [--cookie COOKIE]\r\n2024/11/21 19:27:00 [--password PASSWORD]\r\n2024/11/21 19:27:00 [--account ACCOUNT]\r\n2024/11/21 19:27:00 [--hardware HARDWARE]\r\n2024/11/21 19:27:00 [--port PORT]\r\n2024/11/21 19:27:00 [-h]\r\n2024/11/21 19:27:00 usage: xiaomusic.py\r\n```\n---\n\n### 评论 32 - hanxi\n> 运行时遇到下面问题，请问要怎么排查？\r\n> \r\n> ```\r\n> 2024/11/21 19:27:00 xiaomusic.py: error: unrecognized arguments: .venv/bin/python3 xiaomusic.py\r\n> 2024/11/21 19:27:00 [--enable_config_example]\r\n> 2024/11/21 19:27:00 [--ffmpeg_location FFMPEG_LOCATION]\r\n> 2024/11/21 19:27:00 [--config CONFIG]\r\n> 2024/11/21 19:27:00 [--verbose]\r\n> 2024/11/21 19:27:00 [--cookie COOKIE]\r\n> 2024/11/21 19:27:00 [--password PASSWORD]\r\n> 2024/11/21 19:27:00 [--account ACCOUNT]\r\n> 2024/11/21 19:27:00 [--hardware HARDWARE]\r\n> 2024/11/21 19:27:00 [--port PORT]\r\n> 2024/11/21 19:27:00 [-h]\r\n> 2024/11/21 19:27:00 usage: xiaomusic.py\r\n> ```\r\n\r\n看不出来\n---\n\n### 评论 33 - sinojelly\n请问登录验证失败要怎么定位？小米登录邮箱，还是小米id 都报同样的错。\r\n```\r\n2024/11/25 0:50:44 [2024-11-25 00:50:44] [0.3.48] [ERROR] xiaomusic.py:259: /root/.mi.token file not exist\r\n2024/11/25 0:50:44 Exception: Error https://api2.mina.mi.com/admin/v2/device_list?master=0&requestId=app_ios_: Login failed\r\n2024/11/25 0:50:44 raise Exception(f\"Error {url}: {resp}\")\r\n2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/miaccount.py\", line 150, in mi_request\r\n2024/11/25 0:50:44 return await self.account.mi_request(\r\n2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py\", line 49, in mina_request\r\n2024/11/25 0:50:44 result = await self.mina_request(\"/admin/v2/device_list?master=\" + str(master))\r\n2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py\", line 54, in device_list\r\n2024/11/25 0:50:44 hardware_data = await self.mina_service.device_list()\r\n2024/11/25 0:50:44 File \"/app/xiaomusic/xiaomusic.py\", line 232, in try_update_device_id\r\n2024/11/25 0:50:44 Traceback (most recent call last):\r\n2024/11/25 0:50:44 [2024-11-25 00:50:44] [0.3.48] [ERROR] xiaomusic.py:251: Execption Error https://api2.mina.mi.com/admin/v2/device_list?master=0&requestId=app_ios_xx: Login failed\r\n2024/11/25 0:50:44 Exception: {'qs': '%3Fsid%3Dmicoapi%26_json%3Dtrue', 'code': 70016, 'description': '登录验证失败', 'securityStatus': 0, '_sign': 'xxx', 'sid': 'micoapi', 'result': 'error', 'captchaUrl': None, 'callback': 'https://api2.mina.mi.com/sts', 'location': '', 'pwd': 0, 'child': 0, 'desc': '登录验证失败'}\r\n2024/11/25 0:50:44 raise Exception(resp)\r\n2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/miaccount.py\", line 69, in login\r\n```\n---\n\n### 评论 34 - hanxi\n> 请问登录验证失败要怎么定位？小米登录邮箱，还是小米id 都报同样的错。\r\n> \r\n> ```\r\n> 2024/11/25 0:50:44 [2024-11-25 00:50:44] [0.3.48] [ERROR] xiaomusic.py:259: /root/.mi.token file not exist\r\n> 2024/11/25 0:50:44 Exception: Error https://api2.mina.mi.com/admin/v2/device_list?master=0&requestId=app_ios_: Login failed\r\n> 2024/11/25 0:50:44 raise Exception(f\"Error {url}: {resp}\")\r\n> 2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/miaccount.py\", line 150, in mi_request\r\n> 2024/11/25 0:50:44 return await self.account.mi_request(\r\n> 2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py\", line 49, in mina_request\r\n> 2024/11/25 0:50:44 result = await self.mina_request(\"/admin/v2/device_list?master=\" + str(master))\r\n> 2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/minaservice.py\", line 54, in device_list\r\n> 2024/11/25 0:50:44 hardware_data = await self.mina_service.device_list()\r\n> 2024/11/25 0:50:44 File \"/app/xiaomusic/xiaomusic.py\", line 232, in try_update_device_id\r\n> 2024/11/25 0:50:44 Traceback (most recent call last):\r\n> 2024/11/25 0:50:44 [2024-11-25 00:50:44] [0.3.48] [ERROR] xiaomusic.py:251: Execption Error https://api2.mina.mi.com/admin/v2/device_list?master=0&requestId=app_ios_xx: Login failed\r\n> 2024/11/25 0:50:44 Exception: {'qs': '%3Fsid%3Dmicoapi%26_json%3Dtrue', 'code': 70016, 'description': '登录验证失败', 'securityStatus': 0, '_sign': 'xxx', 'sid': 'micoapi', 'result': 'error', 'captchaUrl': None, 'callback': 'https://api2.mina.mi.com/sts', 'location': '', 'pwd': 0, 'child': 0, 'desc': '登录验证失败'}\r\n> 2024/11/25 0:50:44 raise Exception(resp)\r\n> 2024/11/25 0:50:44 File \"/app/.venv/lib/python3.10/site-packages/miservice/miaccount.py\", line 69, in login\r\n> ```\r\n\r\n上面给出了4个办法都试过了吗？局域网登陆mi.com了？\n---\n\n### 评论 35 - wusemao\n设置web访问登录时，账号密码设置完之后登不进去了，账号名称用的中文的可以么\n---\n\n### 评论 36 - hanxi\n> 设置web访问登录时，账号密码设置完之后登不进去了，账号名称用的中文的可以么\r\n\r\n不确定是否可以，你可以考虑setting.json里的内容，不行就修改再重启。\n---\n\n### 评论 37 - quanmao\n运行后会在音乐目录下生成一个tmp文件夹，如何指定路径，因为还有其应用访问音乐路径，不希望其识别tmp目录下的音乐。\n---\n\n### 评论 38 - hanxi\n> 运行后会在音乐目录下生成一个tmp文件夹，如何指定路径，因为还有其应用访问音乐路径，不希望其识别tmp目录下的音乐。\r\n\r\n忽略目录(逗号分割) 改成 `@eaDir,tmp` 即可。\n---\n\n### 评论 39 - quanmao\n> > 运行后会在音乐目录下生成一个tmp文件夹，如何指定路径，因为还有其应用访问音乐路径，不希望其识别tmp目录下的音乐。\r\n> \r\n> 忽略目录(逗号分割) 改成 `@eaDir,tmp` 即可。\r\n\r\n抱歉，是我没有说清楚，是运行xiaomusic后会在音乐路径下生成tmp文件夹， 但我同时还在用navidrome,也会访问音乐目录，他会把tmp目录下的歌曲也扫描进去，所以想移动tmp目录。 navidrome没找到在哪里可以设置，忽略这个文件夹\n---\n\n### 评论 40 - hanxi\n> > > 运行后会在音乐目录下生成一个tmp文件夹，如何指定路径，因为还有其应用访问音乐路径，不希望其识别tmp目录下的音乐。\r\n> > \r\n> > \r\n> > 忽略目录(逗号分割) 改成 `@eaDir,tmp` 即可。\r\n> \r\n> 抱歉，是我没有说清楚，是运行xiaomusic后会在音乐路径下生成tmp文件夹， 但我同时还在用navidrome,也会访问音乐目录，他会把tmp目录下的歌曲也扫描进去，所以想移动tmp目录。 navidrome没找到在哪里可以设置，忽略这个文件夹\r\n\r\n提个新 issue 吧，有空加下配置项。\n---\n\n### 评论 41 - CallEdison\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/6724300b-ce48-44e6-9729-7b844bc0751e)\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/e7e87adb-a54d-42dd-bfc9-f84a01116a48)\r\n问题一：能进控制面板，进不了设置页面，容器没有log生成，我昨天已经设置好了，现在功能能正常使用，但是进不了设置页面了问题二：昨天能进的时候发现本地下载目录有歌曲，但是设置里面的全部歌曲里面没有，搜索框搜索又能搜的到。\n---\n\n### 评论 42 - hanxi\n> ![image](https://private-user-images.githubusercontent.com/49771101/390617216-6724300b-ce48-44e6-9729-7b844bc0751e.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzI3NjIzOTQsIm5iZiI6MTczMjc2MjA5NCwicGF0aCI6Ii80OTc3MTEwMS8zOTA2MTcyMTYtNjcyNDMwMGItY2U0OC00NGU2LTk3MjktN2I4NDRiYzA3NTFlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDExMjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQxMTI4VDAyNDgxNFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWM3NWNkOTc4MzI2OTUxY2JkMzg2OGU1NGQ3ZWVkODA2MTIyYzE0YmY4MTRiMmVjMTAwYWJkMjBhNDc4MjgwOWMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.BFuNPM9Ihxe0V3qhE_9JIbgt9rn_u5dC542hOLckwT8) ![image](https://private-user-images.githubusercontent.com/49771101/390617294-e7e87adb-a54d-42dd-bfc9-f84a01116a48.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzI3NjIzOTQsIm5iZiI6MTczMjc2MjA5NCwicGF0aCI6Ii80OTc3MTEwMS8zOTA2MTcyOTQtZTdlODdhZGItYTU0ZC00MmRkLWJmYzktZjg0YTAxMTE2YTQ4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDExMjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQxMTI4VDAyNDgxNFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTA3OTA5YTQwODQ4ZmM0Nzg2ZGYwZTc4YmQyMWU5MDgwYjhjZTRiNzRkYzI0NDE2MzI4M2JhOWYxZDlhYjNlYzMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.8JMoNWDzq-C9pnJy1Ru51LZbP_G5g1fAKYqSppCLKa4) 问题一：能进控制面板，进不了设置页面，容器没有log生成，我昨天已经设置好了，现在功能能正常使用，但是进不了设置页面了问题二：昨天能进的时候发现本地下载目录有歌曲，但是设置里面的全部歌曲里面没有，搜索框搜索又能搜的到。\r\n\r\n问题一：打不开的地址是哪个？\r\n问题二：可以点击刷新列表按钮试试。\n---\n\n### 评论 43 - huahua-er\n是关闭了网络搜索了吗？现在的搜索只有本地数据没有网络歌曲了?\n---\n\n### 评论 44 - CallEdison\n默认主题有歌曲\r\n\r\n\r\npure主题没有歌曲\r\n\r\nxmusicPlayer也没有歌曲\r\n\r\n\r\n \r\n\r\n\r\nEdison\r\n***@***.***\r\n\r\n\r\n\r\n \r\n\r\n\r\n\r\n\r\n------------------ 原始邮件 ------------------\r\n发件人: ***@***.***>; \r\n发送时间: 2024年11月30日(星期六) 上午6:26\r\n收件人: ***@***.***>; \r\n抄送: ***@***.***>; ***@***.***>; \r\n主题: Re: [hanxi/xiaomusic] 💬 FAQ问题集合 (Issue #99)\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n \r\n是关闭了网络搜索了吗？现在的搜索只有本地数据没有网络歌曲了?\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n### 评论 45 - hanxi\n> 是关闭了网络搜索了吗？现在的搜索只有本地数据没有网络歌曲了?\r\n\r\n等 yt-dlp 修复。\n---\n\n### 评论 46 - hanxi\n> 默认主题有歌曲 pure主题没有歌曲 xmusicPlayer也没有歌曲   Edison ***@***.***  \r\n> […](#)\r\n> ------------------ 原始邮件 ------------------ 发件人: ***@***.***>; 发送时间: 2024年11月30日(星期六) 上午6:26 收件人: ***@***.***>; 抄送: ***@***.***>; ***@***.***>; 主题: Re: [hanxi/xiaomusic] 💬 FAQ问题集合 (Issue #99) 是关闭了网络搜索了吗？现在的搜索只有本地数据没有网络歌曲了? — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***>\r\n\r\n需要刷新缓存\n---\n\n### 评论 47 - like1020\n![Screenshot_2024-12-03-06-58-52-853_com yjllq kito](https://gproxy.hanxi.cc/proxy/user-attachments/assets/5d37bfa6-d63a-46b1-b5a8-554814fc7dce)\r\n请教一下，本地列表歌单里的歌曲即便设置为全部循环或随机播放，依然是不断地单曲循环，只能自己手动点下一首，请问是什么情况？\n---\n\n### 评论 48 - tchgtr\n请问网络搜索功能修复了吗？感谢！\n---\n\n### 评论 49 - hanxi\n> 请问网络搜索功能修复了吗？感谢！\r\n\r\n修复了。\n---\n\n### 评论 50 - tchgtr\n> > 请问网络搜索功能修复了吗？感谢！\r\n> \r\n> 修复了。\r\n\r\n我已经更新到最新版0.3.55，音箱是LX04触屏音箱，但是使用指令对小爱说“播放歌曲。。。“还是通过音箱绑定的QQ音乐播放，解绑了QQ音乐账号，就会提示先让我绑定账号（包括播放本地歌曲指令），感觉音箱还没跟docker连接上（已经重启过容器）。但是通过8090端口进入后台，搜索歌曲，播放，调节声音大小，单曲、随机所有的功能都可以通过按键实现，唯独不能通过语音跟小爱对话播放我指定的内容，请问这个是什么问题，感谢！\n---\n\n### 评论 51 - hanxi\n> > > 请问网络搜索功能修复了吗？感谢！\r\n> > \r\n> > \r\n> > 修复了。\r\n> \r\n> 我已经更新到最新版0.3.55，音箱是LX04触屏音箱，但是使用指令对小爱说“播放歌曲。。。“还是通过音箱绑定的QQ音乐播放，解绑了QQ音乐账号，就会提示先让我绑定账号（包括播放本地歌曲指令），感觉音箱还没跟docker连接上（已经重启过容器）。但是通过8090端口进入后台，搜索歌曲，播放，调节声音大小，单曲、随机所有的功能都可以通过按键实现，唯独不能通过语音跟小爱对话播放我指定的内容，请问这个是什么问题，感谢！\r\n\r\n贴下你的 setting.json 文件看看吧，把里面的账号密码删除。\n---\n\n### 评论 52 - tchgtr\n> > > > 请问网络搜索功能修复了吗？感谢！\r\n> > > \r\n> > > \r\n> > > 修复了。\r\n> > \r\n> > \r\n> > 我已经更新到最新版0.3.55，音箱是LX04触屏音箱，但是使用指令对小爱说“播放歌曲。。。“还是通过音箱绑定的QQ音乐播放，解绑了QQ音乐账号，就会提示先让我绑定账号（包括播放本地歌曲指令），感觉音箱还没跟docker连接上（已经重启过容器）。但是通过8090端口进入后台，搜索歌曲，播放，调节声音大小，单曲、随机所有的功能都可以通过按键实现，唯独不能通过语音跟小爱对话播放我指定的内容，请问这个是什么问题，感谢！\r\n> \r\n> 贴下你的 setting.json 文件看看吧，把里面的账号密码删除。\r\n\r\n{\r\n \"account\": \"\",\r\n \"password\": \"\",\r\n \"mi_did\": \"603807070\",\r\n \"miio_tts_command\": \"\",\r\n \"cookie\": \"\",\r\n \"verbose\": false,\r\n \"music_path\": \"music\",\r\n \"temp_path\": \"music/tmp\",\r\n \"download_path\": \"music/download\",\r\n \"conf_path\": \"conf\",\r\n \"cache_dir\": \"cache\",\r\n \"hostname\": \"192.168.31.159\",\r\n \"port\": 8090,\r\n \"public_port\": 0,\r\n \"proxy\": \"\",\r\n \"search_prefix\": \"bilisearch:\",\r\n \"ffmpeg_location\": \"./ffmpeg/bin\",\r\n \"active_cmd\": \"play,set_play_type_rnd,playlocal,play_music_list,play_music_list_index,stop_after_minute,stop\",\r\n \"exclude_dirs\": \"@eaDir,tmp\",\r\n \"music_path_depth\": 10,\r\n \"disable_httpauth\": true,\r\n \"httpauth_username\": \"\",\r\n \"httpauth_password\": \"\",\r\n \"music_list_url\": \"\",\r\n \"music_list_json\": \"\",\r\n \"custom_play_list_json\": \"\",\r\n \"disable_download\": false,\r\n \"key_word_dict\": {\r\n \"下一首\": \"play_next\",\r\n \"上一首\": \"play_prev\",\r\n \"单曲循环\": \"set_play_type_one\",\r\n \"全部循环\": \"set_play_type_all\",\r\n \"随机播放\": \"set_play_type_rnd\",\r\n \"单曲播放\": \"set_play_type_sin\",\r\n \"顺序播放\": \"set_play_type_seq\",\r\n \"分钟后关机\": \"stop_after_minute\",\r\n \"刷新列表\": \"gen_music_list\",\r\n \"加入收藏\": \"add_to_favorites\",\r\n \"收藏歌曲\": \"add_to_favorites\",\r\n \"取消收藏\": \"del_from_favorites\",\r\n \"播放列表第\": \"play_music_list_index\",\r\n \"播放本地歌曲\": \"playlocal\",\r\n \"本地播放歌曲\": \"playlocal\",\r\n \"播放歌曲\": \"play\",\r\n \"放歌曲\": \"play\",\r\n \"关机\": \"stop\",\r\n \"暂停\": \"stop\",\r\n \"停止\": \"stop\",\r\n \"停止播放\": \"stop\",\r\n \"播放列表\": \"play_music_list\",\r\n \"播放歌单\": \"play_music_list\",\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\r\n },\r\n \"key_match_order\": [\r\n \"分钟后关机\",\r\n \"下一首\",\r\n \"上一首\",\r\n \"单曲循环\",\r\n \"全部循环\",\r\n \"随机播放\",\r\n \"单曲播放\",\r\n \"顺序播放\",\r\n \"关机\",\r\n \"刷新列表\",\r\n \"播放列表第\",\r\n \"播放列表\",\r\n \"加入收藏\",\r\n \"收藏歌曲\",\r\n \"取消收藏\",\r\n \"播放本地歌曲\",\r\n \"本地播放歌曲\",\r\n \"播放歌曲\",\r\n \"放歌曲\",\r\n \"暂停\",\r\n \"停止\",\r\n \"停止播放\",\r\n \"播放歌单\",\r\n \"测试自定义口令\",\r\n \"测试链接\"\r\n ],\r\n \"use_music_api\": false,\r\n \"use_music_audio_id\": \"1582971365183456177\",\r\n \"use_music_id\": \"355454500\",\r\n \"log_file\": \"xiaomusic.log.txt\",\r\n \"fuzzy_match_cutoff\": 0.6,\r\n \"enable_fuzzy_match\": true,\r\n \"stop_tts_msg\": \"收到,再见\",\r\n \"enable_config_example\": false,\r\n \"keywords_playlocal\": \"播放本地歌曲,本地播放歌曲\",\r\n \"keywords_play\": \"播放歌曲,放歌曲\",\r\n \"keywords_stop\": \"关机,暂停,停止,停止播放\",\r\n \"keywords_playlist\": \"播放列表,播放歌单\",\r\n \"user_key_word_dict\": {\r\n \"测试自定义口令\": \"exec#code1(\\\"hello\\\")\",\r\n \"测试链接\": \"exec#httpget(\\\"https://github.com/hanxi/xiaomusic\\\")\"\r\n },\r\n \"enable_force_stop\": false,\r\n \"devices\": {\r\n \"603807070\": {\r\n \"did\": \"603807070\",\r\n \"device_id\": \"60b8f875-4101-416a-9278-4d4170929b4d\",\r\n \"hardware\": \"LX04\",\r\n \"name\": \"小爱触屏音箱\",\r\n \"play_type\": 1,\r\n \"cur_music\": \"七里香\",\r\n \"cur_playlist\": \"临时搜索列表\"\r\n }\r\n },\r\n \"group_list\": \"\",\r\n \"remove_id3tag\": false,\r\n \"convert_to_mp3\": false,\r\n \"delay_sec\": 3,\r\n \"continue_play\": false,\r\n \"pull_ask_sec\": 1,\r\n \"crontab_json\": \"\",\r\n \"enable_yt_dlp_cookies\": false,\r\n \"get_ask_by_mina\": true,\r\n \"play_type_one_tts_msg\": \"已经设置为单曲循环\",\r\n \"play_type_all_tts_msg\": \"已经设置为全部循环\",\r\n \"play_type_rnd_tts_msg\": \"已经设置为随机播放\",\r\n \"play_type_sin_tts_msg\": \"已经设置为单曲播放\",\r\n \"play_type_seq_tts_msg\": \"已经设置为顺序播放\",\r\n \"recently_added_playlist_len\": 50\r\n}\n---\n\n### 评论 53 - hanxi\nget_ask_by_mina 【特殊型号获取对话记录】这个需要设置为 false\n---\n\n### 评论 54 - tchgtr\n> get_ask_by_mina 【特殊型号获取对话记录】这个需要设置为 false\r\n\r\n已经重新设置并重启容器，尝试还是不行，会不会是这个触屏音箱不支持？\n---\n\n### 评论 55 - tchgtr\n> > get_ask_by_mina 【特殊型号获取对话记录】这个需要设置为 false\r\n> \r\n> 已经重新设置并重启容器，尝试还是不行，会不会是这个触屏音箱不支持？\r\n\r\n或者是在创建容器的时候，我的小米账号填写了我的手机号码，应该需要填写实际的小米账号？因为手机号码对应的小米账号，和输入对应的密码，都是可以登陆的，但是我不知道有什么区别，就把手机号码输入进去了\n---\n\n### 评论 56 - tchgtr\n> > > get_ask_by_mina 【特殊型号获取对话记录】这个需要设置为 false\r\n> > \r\n> > \r\n> > 已经重新设置并重启容器，尝试还是不行，会不会是这个触屏音箱不支持？\r\n> \r\n> 或者是在创建容器的时候，我的小米账号填写了我的手机号码，应该需要填写实际的小米账号？因为手机号码对应的小米账号，和输入对应的密码，都是可以登陆的，但是我不知道有什么区别，就把手机号码输入进去了\r\n\r\n我重新创建容器，问题解决了，主要是两个地方改变了，一个是上面的小米账号的问题，另外一个是关于conf和music这两个文件夹，这次我都把他们放在/container/xiaomusic下，即/container/xiaomusic/conf(music)，分别对应两个容器和主机app/conf(music)，问题就解决了。之前我是分开在两个文件夹的。\n---\n\n### 评论 57 - tianting123\n0 B的APE文件， 建议直接跳过播放\n---\n\n### 评论 58 - oklrc\n新人请教：使用DOCKER镜像 或者 composer安装 如何升级到最新版本呢？是删除镜像再重新拉取吗\n---\n\n### 评论 59 - hanxi\n> 新人请教：使用DOCKER镜像 或者 composer安装 如何升级到最新版本呢？是删除镜像再重新拉取吗\r\n\r\n```\r\ndocker compose pull\r\ndocker compose up -d\r\n```\n---\n\n### 评论 60 - oklrc\n更新到最新版后，找不到小爱同学了\r\n\r\n日志：\r\n[2024-12-14 11:34:54] [0.3.57] [ERROR] xiaomusic.py:1283: Execption 'NoneType' object has no attribute 'device_list'\r\nTraceback (most recent call last):\r\n File \"/app/xiaomusic/xiaomusic.py\", line 1281, in getalldevices\r\n device_list = await self.mina_service.device_list()\r\nAttributeError: 'NoneType' object has no attribute 'device_list'\r\n[2024-12-14 11:34:54] [0.3.57] [INFO] httpserver.py:246: getsetting device_list: []\r\n[2024-12-14 11:34:54] [0.3.57] [INFO] httpserver.py:246: getsetting device_list: []\r\n[2024-12-14 11:34:54] [0.3.57] [INFO] httpserver.py:246: getsetting device_list: []\r\n\n---\n\n### 评论 61 - hanxi\n> 更新到最新版后，找不到小爱同学了\r\n> \r\n> 日志： [2024-12-14 11:34:54] [0.3.57] [ERROR] xiaomusic.py:1283: Execption 'NoneType' object has no attribute 'device_list' Traceback (most recent call last): File \"/app/xiaomusic/xiaomusic.py\", line 1281, in getalldevices device_list = await self.mina_service.device_list() AttributeError: 'NoneType' object has no attribute 'device_list' [2024-12-14 11:34:54] [0.3.57] [INFO] httpserver.py:246: getsetting device_list: [] [2024-12-14 11:34:54] [0.3.57] [INFO] httpserver.py:246: getsetting device_list: [] [2024-12-14 11:34:54] [0.3.57] [INFO] httpserver.py:246: getsetting device_list: []\r\n\r\n登陆掉了吧，重新登陆一下。\n---\n\n### 评论 62 - sprout-cooler\n登录后，显示无设备；上面提到的方法都试过了。没有用，日志显示\r\n File \"/app/xiaomusic/xiaomusic.py\", line 1270, in reinit\r\n\r\n await self.init_all_data(self.session)\r\n\r\nAttributeError: 'XiaoMusic' object has no attribute 'session'\n---\n\n### 评论 63 - fu-yuming\n今天更新后，找不到设备了。重新输账号密码保存了，怎么都不行。重新部署也找不到。\n---\n\n### 评论 64 - zhiquanchi\n> 今天更新后，找不到设备了。重新输账号密码保存了，怎么都不行。重新部署也找不到。\r\n\r\n用默认主题试下\n---\n\n### 评论 65 - hanxi\n可以更新试试。\n---\n\n### 评论 66 - lijichao2018\n我点保存，网页显示[object Object]，不知道啥情况\n---\n\n### 评论 67 - hanxi\n> 我点保存，网页显示[object Object]，不知道啥情况\r\n\r\n0.3.58版本吗？\n---\n\n### 评论 68 - lijichao2018\n0.3.57\r\n\r\n\r\n\r\n\r\n \r\n\r\n\r\n该邮件从移动设备发送\r\n\r\n\r\n \r\n\r\n\r\n\r\n\r\n------------------ 原始邮件 ------------------\r\n发件人: ***@***.***>; \r\n发送时间: 2024年12月15日(星期天) 中午12:17\r\n收件人: ***@***.***>; \r\n抄送: ***@***.***>; ***@***.***>; \r\n主题: Re: [hanxi/xiaomusic] 💬 FAQ问题集合 (Issue #99)\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n \r\n我点保存，网页显示[object Object]，不知道啥情况\r\n \r\n0.3.58版本吗？\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n### 评论 69 - hanxi\n那你更新吧。58应该是修复了。\n---\n\n### 评论 70 - oklrc\n> 那你更新吧。58应该是修复了。\r\n\r\n新版本确实好了，我昨天遇到的问题和楼上是一样的\n---\n\n### 评论 71 - lijichao2018\n绿联的NAS怎么更新到58版本啊，没找到，要用口令吗？\n---\n\n### 评论 72 - zjzj52\n容器一直重启，网页后台也进不去\n---\n\n### 评论 73 - hanxi\n> 容器一直重启，网页后台也进不去\r\n\r\n这种情况有日志吗？可能是端口冲突？\n---\n\n### 评论 74 - BladPit\n不知道有没有用unraid系统NAS的朋友？\r\n我这里使用docker安装xiaomusic有一个很奇怪的现象，不知道有没有大佬能够解惑：\r\n\r\n我的unraid系统版本是6.8.2，通过docker安装后发现，如果没有开启特权模式（Privileged），那么（从内网）访问webGUI的时候，在首页选择了主题之后会直接网页报错【Internal Server Error】+显示空白页面，查看docker运行日志，是正常的，没有什么相关的报错：\r\n`2025-01-04 00:29:06,055 CRIT Supervisor is running as root. Privileges were not dropped because no user is specified in the config file. If you intend to run as root, you can set user=root in the config file to avoid this message.\r\n\r\n2025-01-04 00:29:06,064 INFO RPC interface 'supervisor' initialized\r\n\r\n2025-01-04 00:29:06,064 CRIT Server 'unix_http_server' running without any HTTP authentication checking\r\n\r\n2025-01-04 00:29:06,065 INFO supervisord started with pid 1\r\n\r\n2025-01-04 00:29:07,068 INFO spawned: 'xiaomusic' with pid 6`\r\n\r\n然而如果开启特权模式运行docker，则会完全正常，webGUI能够正常访问。感觉非常疑惑，不知道是什么原因。\r\n这个问题之前在安装docker版迅雷的时候有类似情况，必须开启特权模式迅雷的docker才能启动，但迅雷的docker应该是所有人都如此，但xiaomusic的这种情况，我询问过其他unraid群友，似乎没有遇到该问题。\n---\n\n### 评论 75 - ZYT1601\n容器一直重启，日志一直循环一段\r\nUnlinking stale socket /var/run/supervisor.sock\r\n\r\n/usr/lib/python3/dist-packages/supervisor/options.py:474: UserWarning: Supervisord is running as root and it is searching for its configuration file in default locations (including its current working directory); you probably want to specify a \"-c\" argument specifying an absolute path to a configuration file for improved security.\r\n\r\n self.warnings.warn(\r\n\r\nUnlinking stale socket /var/run/supervisor.sock\n---\n\n### 评论 76 - hanxi\n@ZYT1601 试试看这个方法： /issues/348.html#issuecomment-2568722472\n---\n\n### 评论 77 - ZYT1601\n可以了，飞牛把容器设置里面的命令全部删掉也是一个道理\r\n\n---\n\n### 评论 78 - ZYT1601\n> 可以了，飞牛把容器设置里面的命令全部删掉也是一个道理\r\n\r\n好像不能一劳永逸\r\n\n---\n\n### 评论 79 - hanxi\n> > 可以了，飞牛把容器设置里面的命令全部删掉也是一个道理\r\n> \r\n> 好像不能一劳永逸\r\n\r\n等后续版本吧。\n---\n\n### 评论 80 - Ivysaur-91\n有个问题请教下，建立容器的时候指定了nas本地的位置映射到容器的音乐路径，但是在nas路径防止文件无法被识别出来。\r\n![屏幕截图 2025-01-05 183306](https://gproxy.hanxi.cc/proxy/user-attachments/assets/c3a8a107-1fb9-456d-8f03-da0d03b3d770)\r\n直接在xiaomusic里面下载音乐是可以播放的，进入到docker里面的路径也是有音乐文件的\r\n![image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/fdb6ea7a-8ccf-4580-a983-b793c591869b)\r\n\r\n建容器的命令如下：\r\ndocker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /Public/Music/[[xiaomusic]]:/app/music -v /Public/Music/[[xiaomusic]]:/app/conf m.daocloud.io/docker.io/hanxi/xiaomusic\r\n\n---\n\n### 评论 81 - hanxi\n> 有个问题请教下，建立容器的时候指定了nas本地的位置映射到容器的音乐路径，但是在nas路径防止文件无法被识别出来。 ![屏幕截图 2025-01-05 183306](https://private-user-images.githubusercontent.com/193787091/400193889-c3a8a107-1fb9-456d-8f03-da0d03b3d770.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYwNzY2MDYsIm5iZiI6MTczNjA3NjMwNiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwMTkzODg5LWMzYThhMTA3LTFmYjktNDU2ZC04ZjAzLWRhMGQwM2IzZDc3MC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNVQxMTI1MDZaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kMTA2YmM4ZDI4MTk1OWFjZTAxZTZlODE1YmYwMTk4ZDE3NmMyNzI1ZDVmYjNhOWVhMTdhZTJjMDEzYjM2NjllJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.45ZS_c09oRK43CTcgUJTEbzXNDRUW0fSpWtw4PMUn3g) 直接在xiaomusic里面下载音乐是可以播放的，进入到docker里面的路径也是有音乐文件的 ![image](https://private-user-images.githubusercontent.com/193787091/400194129-fdb6ea7a-8ccf-4580-a983-b793c591869b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYwNzY2MDYsIm5iZiI6MTczNjA3NjMwNiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwMTk0MTI5LWZkYjZlYTdhLThjY2YtNDU4MC1hOTgzLWI3OTNjNTkxODY5Yi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNVQxMTI1MDZaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mMWMyYmZmNWFjMzU5Yzg3MDk5N2M5MTMyMmE0ZDJlYmY5YWY4OGU3MzhiYmVkMDYyNjFjZGQzNTUyYWM4MzI0JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.AmsxpldZ738tCXE2y_2AQuN14I4FERkOjn23JFrnRuM)\r\n> \r\n> 建容器的命令如下： docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /Public/Music/[[xiaomusic]]:/app/music -v /Public/Music/[[xiaomusic]]:/app/conf m.daocloud.io/docker.io/hanxi/xiaomusic\r\n\r\n为啥路径要加方括号？另外两个路径不能重复。\n---\n\n### 评论 82 - Ivysaur-91\n> > 有个问题请教下，建立容器的时候指定了nas本地的位置映射到容器的音乐路径，但是在nas路径防止文件无法被识别出来。 ![屏幕截图 2025-01-05 183306](https://private-user-images.githubusercontent.com/193787091/400193889-c3a8a107-1fb9-456d-8f03-da0d03b3d770.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYwNzY2MDYsIm5iZiI6MTczNjA3NjMwNiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwMTkzODg5LWMzYThhMTA3LTFmYjktNDU2ZC04ZjAzLWRhMGQwM2IzZDc3MC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNVQxMTI1MDZaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kMTA2YmM4ZDI4MTk1OWFjZTAxZTZlODE1YmYwMTk4ZDE3NmMyNzI1ZDVmYjNhOWVhMTdhZTJjMDEzYjM2NjllJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.45ZS_c09oRK43CTcgUJTEbzXNDRUW0fSpWtw4PMUn3g) 直接在xiaomusic里面下载音乐是可以播放的，进入到docker里面的路径也是有音乐文件的 ![image](https://private-user-images.githubusercontent.com/193787091/400194129-fdb6ea7a-8ccf-4580-a983-b793c591869b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYwNzY2MDYsIm5iZiI6MTczNjA3NjMwNiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwMTk0MTI5LWZkYjZlYTdhLThjY2YtNDU4MC1hOTgzLWI3OTNjNTkxODY5Yi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNVQxMTI1MDZaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mMWMyYmZmNWFjMzU5Yzg3MDk5N2M5MTMyMmE0ZDJlYmY5YWY4OGU3MzhiYmVkMDYyNjFjZGQzNTUyYWM4MzI0JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.AmsxpldZ738tCXE2y_2AQuN14I4FERkOjn23JFrnRuM)\r\n> > 建容器的命令如下： docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /Public/Music/[[xiaomusic]]:/app/music -v /Public/Music/[[xiaomusic]]:/app/conf m.daocloud.io/docker.io/hanxi/xiaomusic\r\n> \r\n> 为啥路径要加方括号？另外两个路径不能重复。\r\n\r\n方括号是为了让文件夹在第一位，重新安装容器，路径不一样后还是一样的问题：\r\n\r\n![屏幕截图 2025-01-06 214204](https://gproxy.hanxi.cc/proxy/user-attachments/assets/3bf283cc-c951-433b-95d9-dda6abeea7b4)\r\n\r\n\r\n语句：\r\ndocker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /Public/Music/xiaomusic/music:/app/music -v /Public/Music/xiaomusic/config:/app/conf m.daocloud.io/docker.io/hanxi/xiaomusic\n---\n\n### 评论 83 - Ivysaur-91\n> > > 有个问题请教下，建立容器的时候指定了nas本地的位置映射到容器的音乐路径，但是在nas路径防止文件无法被识别出来。 ![屏幕截图 2025-01-05 183306](https://private-user-images.githubusercontent.com/193787091/400193889-c3a8a107-1fb9-456d-8f03-da0d03b3d770.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYwNzY2MDYsIm5iZiI6MTczNjA3NjMwNiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwMTkzODg5LWMzYThhMTA3LTFmYjktNDU2ZC04ZjAzLWRhMGQwM2IzZDc3MC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNVQxMTI1MDZaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kMTA2YmM4ZDI4MTk1OWFjZTAxZTZlODE1YmYwMTk4ZDE3NmMyNzI1ZDVmYjNhOWVhMTdhZTJjMDEzYjM2NjllJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.45ZS_c09oRK43CTcgUJTEbzXNDRUW0fSpWtw4PMUn3g) 直接在xiaomusic里面下载音乐是可以播放的，进入到docker里面的路径也是有音乐文件的 ![image](https://private-user-images.githubusercontent.com/193787091/400194129-fdb6ea7a-8ccf-4580-a983-b793c591869b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYwNzY2MDYsIm5iZiI6MTczNjA3NjMwNiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwMTk0MTI5LWZkYjZlYTdhLThjY2YtNDU4MC1hOTgzLWI3OTNjNTkxODY5Yi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA1JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNVQxMTI1MDZaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mMWMyYmZmNWFjMzU5Yzg3MDk5N2M5MTMyMmE0ZDJlYmY5YWY4OGU3MzhiYmVkMDYyNjFjZGQzNTUyYWM4MzI0JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.AmsxpldZ738tCXE2y_2AQuN14I4FERkOjn23JFrnRuM)\r\n> > > 建容器的命令如下： docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /Public/Music/[[xiaomusic]]:/app/music -v /Public/Music/[[xiaomusic]]:/app/conf m.daocloud.io/docker.io/hanxi/xiaomusic\r\n> > \r\n> > \r\n> > 为啥路径要加方括号？另外两个路径不能重复。\r\n> \r\n> 方括号是为了让文件夹在第一位，重新安装容器，路径不一样后还是一样的问题：\r\n> \r\n> ![屏幕截图 2025-01-06 214204](https://private-user-images.githubusercontent.com/193787091/400439202-3bf283cc-c951-433b-95d9-dda6abeea7b4.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzYxNzEzMjIsIm5iZiI6MTczNjE3MTAyMiwicGF0aCI6Ii8xOTM3ODcwOTEvNDAwNDM5MjAyLTNiZjI4M2NjLWM5NTEtNDMzYi05NWQ5LWRkYTZhYmVlYTdiNC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjUwMTA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI1MDEwNlQxMzQzNDJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02MTExNDE3MmFkMDFlYzFlZTRlMTg0OTdiMTQ3ODY0MjIxODlmMjEzMjUyMWUwYmNjYWNkZGEzNTA0MDIyYWIxJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.cdKynorOPxYE9nBrETp-_E98B6D1cVpITIUzRdEu49M)\r\n> \r\n> 语句： docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /Public/Music/xiaomusic/music:/app/music -v /Public/Music/xiaomusic/config:/app/conf m.daocloud.io/docker.io/hanxi/xiaomusic\r\n\r\n![屏幕截图 2025-01-06 215510](https://gproxy.hanxi.cc/proxy/user-attachments/assets/cc7e218c-f215-4c54-9c2e-aea7be692e22)\r\nyi以为是文件夹关联失败了，但是进入容器看应该是成功的\n---\n\n### 评论 84 - kern111\n本地歌曲如何创建歌单？我的歌曲全在/volumeUSB1/usbshare/Music/这个目录下，想手动设置类别播放\n---\n\n### 评论 85 - hanxi\n> 本地歌曲如何创建歌单？我的歌曲全在/volumeUSB1/usbshare/Music/这个目录下，想手动设置类别播放\n\n目前的方法就是自己整理分类好目录，或者去小程序里建歌单。\n---\n\n### 评论 86 - wjcroom\n说, 加入收藏, 或 收藏歌曲 指令. 小爱说没有播放歌曲, 当前肯定在播放.\n但是无法执行这个操作\n---\n\n### 评论 87 - hanxi\n> 说, 加入收藏, 或 收藏歌曲 指令. 小爱说没有播放歌曲, 当前肯定在播放. 但是无法执行这个操作\n\n那个是小爱自带的回答，没影响。\n---\n\n### 评论 88 - wjcroom\n> > 说, 加入收藏, 或 收藏歌曲 指令. 小爱说没有播放歌曲, 当前肯定在播放. 但是无法执行这个操作\n> \n> 那个是小爱自带的回答，没影响。\n\n但是无法起到效果,收藏夹不会加入当前歌曲. 只能在web端,点一下收藏,才能加入.\n语音命令,都是忽略的, setting.json能看到,这两个命令,定义\n \"加入收藏\": \"add_to_favorites\",\n \"收藏歌曲\": \"add_to_favorites\",\n后面需要在附加歌名吗. \n\nZZZZZZ最后发现是没刷新页面, 收藏没刷新出来. 语音命令是有效的.\n---\n\n### 评论 89 - alvin1234579\n網頁播放正常,但是語音口令無法正常搜尋撥放本地音樂,還是會撥QQ音樂試聽版.偶而會亂撥不相干的歌,docker和小米音箱都重啟過了\n\n[xiaomusic (13).txt](https://github.com/user-attachments/files/18867950/xiaomusic.13.txt)\n---\n\n### 评论 90 - hanxi\n@alvin1234579 看日志是没啥问题的，多试几次，用播放歌曲开头。\n---\n\n### 评论 91 - alvin1234579\n抱歉剛剛有語音撥放歌曲成功但是撥幾秒就停止了,如果搜尋不到本地音樂不是應該yt-dlp下載嗎,一直會跳QQ音樂試聽版\n\n[xiaomusic (16).txt](https://github.com/user-attachments/files/18868240/xiaomusic.16.txt)\n\n\n---\n\n### 评论 92 - hanxi\n@alvin1234579 下载歌曲是需要时间的，看日志是在下载中了。QQ音乐试听只是会语音提示，下载成功后会播放下载的歌曲的。\n---\n\n### 评论 93 - alvin1234579\n> 抱歉剛剛有語音撥放歌曲成功但是撥幾秒就停止了,如果搜尋不到本地音樂不是應該yt-dlp下載嗎,一直會跳QQ音樂試聽版\n> \n> [xiaomusic (16).txt](https://github.com/user-attachments/files/18868240/xiaomusic.16.txt)\n\n已經找到原因了語音搜索會用簡體搜尋,曲名如果是繁體會搜尋不到,還有數字會用中文搜尋像是說2024會搜尋二零二四的檔名所以2024搜尋不到,這有修正的方法嗎\n---\n\n### 评论 94 - hanxi\n@alvin1234579 你提个issue吧，算是个bug吧，应该处理了简体和繁体才对。\n---\n\n### 评论 95 - laolihb\n我的安装运行都很顺利，但目前只能播放本地（nas音乐文件夹）的音乐，本地没有的无法播放，可以看到歌词滚动和“下载中”的语音提示，但之后就静默无声，下载文件夹空白，折腾了很多次没有解决，实在弄不好了，请楼主指导一哈，谢谢啦。\n（我平时无法登录这里，只能借用朋友的饿饭临时用一哈）\n---\n\n### 评论 96 - hanxi\n> 我的安装运行都很顺利，但目前只能播放本地（nas音乐文件夹）的音乐，本地没有的无法播放，可以看到歌词滚动和“下载中”的语音提示，但之后就静默无声，下载文件夹空白，折腾了很多次没有解决，实在弄不好了，请楼主指导一哈，谢谢啦。 （我平时无法登录这里，只能借用朋友的饿饭临时用一哈）\n\n可以加微信群或者QQ群。\n---\n\n### 评论 97 - wjcroom\n@hanxi 我做了一个 自定义语音播放nas电影的HA自动化。 怎么样 取消小爱不能执行的操作。这种默认回答呢。 我的指令搜电视* 。虽然后台执行了。 但是小爱的默认回复总是出现。 个人训练，无法通配符\n---\n\n### 评论 98 - hanxi\n> [@hanxi](https://github.com/hanxi) 我做了一个 自定义语音播放nas电影的HA自动化。 怎么样 取消小爱不能执行的操作。这种默认回答呢。 我的指令搜电视* 。虽然后台执行了。 但是小爱的默认回复总是出现。 个人训练，无法通配符\n\n没啥办法，有些型号就是无法打断小爱说话。\n---\n\n### 评论 99 - wjcroom\n> > [@hanxi](https://github.com/hanxi) 我做了一个 自定义语音播放nas电影的HA自动化。 怎么样 取消小爱不能执行的操作。这种默认回答呢。 我的指令搜电视* 。虽然后台执行了。 但是小爱的默认回复总是出现。 个人训练，无法通配符\n> \n> 没啥办法，有些型号就是无法打断小爱说话。\n\n我也用搜索播放，这样类似的指令呢？ 它就不会随便带来干涉。 只是这和 xiaomusic重合了啊。 还有类似的这样开始的吗。\n---\n\n### 评论 100 - eleght2000\n能不能播放网络磁盘的歌曲 比如FTP 或者SMB共享的磁盘内的歌曲\n---\n\n### 评论 101 - hanxi\n> 能不能播放网络磁盘的歌曲 比如FTP 或者SMB共享的磁盘内的歌曲\n\n可以用rclone挂载\n---\n\n### 评论 102 - KagurazakaAsahi\n作者你好，我出现了上述“本机有声音，小爱音箱没声音，请问什么原因？”这个问题，按顺序排查，默认测试链接正常，容器日志中音乐链接也正常播放，但测试链接中如果填写我的容器日志中音乐链接，也就是本地音源就无法播放，换了十几个mp3音源，均无法正常播放，小爱总说网络错误\n`[2025-04-26 00:24:09] [0.3.78] [INFO] analytics.py:105: umami Status: 400\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[2025-04-26 00:25:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n\n\n[2025-04-26 00:25:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48064 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:25:03] [0.3.78] [INFO] 172.17.0.1:48064 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39316 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39332 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39334 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39316 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[2025-04-26 00:26:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n\n\n[2025-04-26 00:26:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39332 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39354 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39344 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:26:03] [0.3.78] [INFO] 172.17.0.1:39370 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[2025-04-26 00:27:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n\n\n[2025-04-26 00:27:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51676 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n\n\n[00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200`\n---\n\n### 评论 103 - hanxi\n> 作者你好，我出现了上述“本机有声音，小爱音箱没声音，请问什么原因？”这个问题，按顺序排查，默认测试链接正常，容器日志中音乐链接也正常播放，但测试链接中如果填写我的容器日志中音乐链接，也就是本地音源就无法播放，换了十几个mp3音源，均无法正常播放，小爱总说网络错误 `[2025-04-26 00:24:09] [0.3.78] [INFO] analytics.py:105: umami Status: 400\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [2025-04-26 00:25:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n> \n> [2025-04-26 00:25:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48064 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:25:03] [0.3.78] [INFO] 172.17.0.1:48064 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39316 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39332 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39334 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39316 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [2025-04-26 00:26:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n> \n> [2025-04-26 00:26:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39332 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39354 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39344 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:26:03] [0.3.78] [INFO] 172.17.0.1:39370 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [2025-04-26 00:27:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n> \n> [2025-04-26 00:27:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51676 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> \n> [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200`\n\n你部署在哪里的？是不是防火墙的问题？\n---\n\n### 评论 104 - KagurazakaAsahi\n> > 作者你好，我出现了上述“本机有声音，小爱音箱没声音，请问什么原因？”这个问题，按顺序排查，默认测试链接正常，容器日志中音乐链接也正常播放，但测试链接中如果填写我的容器日志中音乐链接，也就是本地音源就无法播放，换了十几个mp3音源，均无法正常播放，小爱总说网络错误 `[2025-04-26 00:24:09] [0.3.78] [INFO] analytics.py:105: umami Status: 400\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48048 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [2025-04-26 00:25:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n> > [2025-04-26 00:25:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48064 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48054 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:25:03] [0.3.78] [INFO] 172.17.0.1:48064 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39316 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39332 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39334 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39316 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [2025-04-26 00:26:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n> > [2025-04-26 00:26:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39332 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39354 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39344 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:26:03] [0.3.78] [INFO] 172.17.0.1:39370 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51656 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [2025-04-26 00:27:03] [0.3.78] [INFO] xiaomusic.py:430: try get_filename. filename:music/Kalafina - oblivious.mp3\n> > [2025-04-26 00:27:03] [0.3.78] [INFO] xiaomusic.py:536: get_music_url local music. name:Kalafina - oblivious, filename:Kalafina - oblivious.mp3\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /musicinfo?name=Kalafina%20-%20oblivious&musictag=true HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51676 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200\n> > [00:27:03] [0.3.78] [INFO] 172.17.0.1:51664 - \"GET /playingmusic?did=725574603 HTTP/1.1\" 200`\n> \n> 你部署在哪里的？是不是防火墙的问题？\n\n部署在我台式机上，关闭了防火墙，台式机与小爱音箱连接了同一个热点\n---\n\n### 评论 105 - ocean412257013\n请教 在build的时候报错，是哪个意思\n\n![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/8e6df9f7-0dd1-4bea-b584-c271073a7411)\n---\n\n### 评论 106 - hanxi\n> 请教 在build的时候报错，是哪个意思\n> \n> ![Image](https://gproxy.hanxi.cc/proxy/user-attachments/assets/8e6df9f7-0dd1-4bea-b584-c271073a7411)\n\n换个国内的镜像。\n---\n\n### 评论 107 - quickflash2\n我用DOCKER布署的，语音可以正常播放本地音乐，但是说“本地搜索播放”始终无法执行，都是小爱本身的的语音提示，网页里的搜索和下载是正常使用的，想问下怎么解决\n---\n\n### 评论 108 - hanxi\n> 我用DOCKER布署的，语音可以正常播放本地音乐，但是说“本地搜索播放”始终无法执行，都是小爱本身的的语音提示，网页里的搜索和下载是正常使用的，想问下怎么解决\n\n播放歌曲口令是否正常？\n---\n\n### 评论 109 - quickflash2\n> > 我用DOCKER布署的，语音可以正常播放本地音乐，但是说“本地搜索播放”始终无法执行，都是小爱本身的的语音提示，网页里的搜索和下载是正常使用的，想问下怎么解决\n> \n> 播放歌曲口令是否正常？\n\n播放口令正常，使用网页版搜索功能正常，就是“本地搜索播放”和“小爱搜索播放”语音不能使用\n---\n\n### 评论 110 - wtyeoh\n我在设置里勾选了两台小爱音箱，叫任意一台播放的时候两台都会一起播放，是不是只能勾选一个？\n---\n\n### 评论 111 - quickflash2\n> > 我用DOCKER布署的，语音可以正常播放本地音乐，但是说“本地搜索播放”始终无法执行，都是小爱本身的的语音提示，网页里的搜索和下载是正常使用的，想问下怎么解决\n> \n> 播放歌曲口令是否正常？\n\n楼主，我问题解决了，命令调用里不知道怎么回事这个搜索播放的命令没有了，重新加上就可以了，谢谢大佬\n---\n\n### 评论 112 - 22555642\n你好，我在群辉DOCKER上部署运行后，一直打不开设置页面，点开日志里面写的是这个，请问要怎么办呢？\n2025/07/18 17:15:55 | stdout | [2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n-- | -- | --\n2025/07/18 17:15:55 | stdout | [2025-07-18 17:15:54] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:55 | stdout | ==> /app/xiaomusic.log.txt <==\n2025/07/18 17:15:55 | stdout |  \n2025/07/18 17:15:55 | stderr | tail: /app/xiaomusic.log.txt has been replaced; following end of new file\n2025/07/18 17:15:52 | stdout | 2025-07-18 17:15:51,292 INFO spawned: 'xiaomusic' with pid 21\n2025/07/18 17:15:48 | stdout | 2025-07-18 17:15:47,284 WARN exited: xiaomusic (exit status 1; not expected)\n2025/07/18 17:15:48 | stdout | ==> /app/supervisord.log <==\n2025/07/18 17:15:48 | stdout |  \n2025/07/18 17:15:43 | stderr | tail: /app/xiaomusic.log.txt has been replaced; following end of new file\n2025/07/18 17:15:43 | stdout | [2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:43 | stdout | [2025-07-18 17:15:42] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:43 | stdout | ==> /app/xiaomusic.log.txt <==\n2025/07/18 17:15:43 | stdout |  \n2025/07/18 17:15:40 | stdout | 2025-07-18 17:15:39,479 INFO spawned: 'xiaomusic' with pid 18\n2025/07/18 17:15:37 | stdout | 2025-07-18 17:15:36,473 WARN exited: xiaomusic (exit status 1; not expected)\n2025/07/18 17:15:37 | stdout | ==> /app/supervisord.log <==\n2025/07/18 17:15:37 | stdout |  \n2025/07/18 17:15:33 | stdout | [2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:33 | stdout | [2025-07-18 17:15:32] [0.3.83] [INFO] xiaomusic.py:1373: The file conf/setting.json does not exist.\n2025/07/18 17:15:33 | stdout | ==> /app/xiaomusic.log.txt <==\n---\n\n### 评论 113 - daheiniu851\n播放歌曲时一会停止，一会又继续播放 ，怎么办\n---\n\n### 评论 114 - hanxi\n> 播放歌曲时一会停止，一会又继续播放 ，怎么办\n\n是不是歌曲文件太大了？\n---\n\n### 评论 115 - 15700085709\nnalytics.py:111: Execption Cannot connect to host umami.hanxi.cc:443 ssl:default [Connection reset by peer]\n请问这个是什么问题\n---\n\n### 评论 116 - daheiniu851\n弄好了 再群晖里安装不可以  换飞牛正常了  \r\n\r\n\r\n\r\n---原始邮件---\r\n发件人: ***@***.***>\r\n发送时间: 2025年8月13日(周三) 中午1:49\r\n收件人: ***@***.***>;\r\n抄送: ***@***.******@***.***>;\r\n主题: Re: [hanxi/xiaomusic] 💬 FAQ问题集合 (Issue #99)\r\n\r\n\r\n15700085709 left a comment (hanxi/xiaomusic#99)\r\n \r\nnalytics.py:111: Execption Cannot connect to host umami.hanxi.cc:443 ssl:default [Connection reset by peer]\r\n 请问这个是什么问题\r\n \r\n—\r\nReply to this email directly, view it on GitHub, or unsubscribe.\r\nYou are receiving this because you commented.Message ID: ***@***.***>\n---\n\n### 评论 117 - 467815891a\nBilibili现在也需要cookies，建议作者大大改一下改一下说明。按照youtube那样上传cookies就行了\n---\n\n### 评论 118 - leonardwillian13-qwe\n在绿联nas上部署了下，测试连接可以播放，但语言指令不能执行，说了指令后就一直卡在那，本地音乐也播放不了，请问这个问题有人碰到过吗\n\n[xiaomusic.txt](https://github.com/user-attachments/files/22310884/xiaomusic.txt)\n---\n\n### 评论 119 - alex13by\n怎么语音控制播放子目录中的歌曲？\n---\n\n### 评论 120 - hanxi\n> 怎么语音控制播放子目录中的歌曲？\n\n播放歌曲加上文件名就行\n---\n\n### 评论 121 - alex13by\n> > 怎么语音控制播放子目录中的歌曲？\n> \n> 播放歌曲加上文件名就行\n\n我的意思是语音控制播放子目录中歌，并且只在这个目录中循环，UI控制选目录播放那种效果，比如轻音乐的子目录，睡觉时直接控制只循环这些\n---\n\n### 评论 122 - hanxi\n> > > 怎么语音控制播放子目录中的歌曲？\n> > \n> > \n> > 播放歌曲加上文件名就行\n> \n> 我的意思是语音控制播放子目录中歌，并且只在这个目录中循环，UI控制选目录播放那种效果，比如轻音乐的子目录，睡觉时直接控制只循环这些\n\n播放歌单加上目录名\n---\n\n### 评论 123 - liaowuyichu\n\"Image\"\n未匹配到指令怎么解决啊\n---\n\n### 评论 124 - hanxi\n@liaowuyichu 口令说错了\n---\n\n### 评论 125 - liaowuyichu\n@hanxi 如果要特定某人的歌曲要怎么说呢，我刚刚输入的是播放黄龄歌曲牵丝戏\n---\n\n### 评论 126 - liaowuyichu\n请问：批量下载歌曲，每次只能下载21首歌，怎么调整这个数量\n---\n\n### 评论 127 - cnchef\n最新版镜像在面板填写小米账号密码无法获取设备 需要重启才可以看到设备，我的小米S12A 使用语音口令无效不知道什么原因\n---\n\n### 评论 128 - wbbaxb\n请问：客户端考虑开发手机app吗？web操作不太方便。\n---\n\n### 评论 129 - hanxi\n> 请问：客户端考虑开发手机app吗？web操作不太方便。\n\n微信群里有人开发了个手机app。\n---\n\n### 评论 130 - jszx55\n> > 请问：客户端考虑开发手机app吗？web操作不太方便。\n> \n> 微信群里有人开发了个手机app。\n\n大佬可以进个群吗？\n---\n\n### 评论 131 - lucklyday2023\nL06A 测试-播放文字无效，web界面和语音控制，无提示音\n---\n\n### 评论 132 - Tomasno1\n所有设置都对的，但是始终无法获取到设备列表。点击保存后，在滑动上去又是什么都没有。搞了5天，终于搞好了 我一个小白 从刷N1盒子到部署容器，再到排除故障，定位故障。问了kimi5天。终于定位到问题所在，我的小米账号有问题，不知道为啥小米始终不给我通过。今天kimi提示让我换个账号 重新绑定小爱，我K 直接一次就成了。如果有和我一样的情况 也可以换一个账号试一试。\n---\n\n### 评论 133 - dsbajyp\n> 为什么我的没有显示设备？ ![Snipaste_2024-09-14_15-51-00](https://gproxy.hanxi.cc/proxy/user-attachments/assets/245d9a85-4ee1-4c82-be0d-865a29827072)\n\n在手机米家APP退出登陆重新用人脸登陆就可用弄\n---\n\n### 评论 134 - zhzyjb\n1、本地播放没问题，测试歌曲小米音箱也可以播放;\n2、选择小米音箱播放时，提示\"播放失败请检查网络或换一个试试吧\";\n3、都在同一个网段；\n还是存在以上问题，麻烦不忙的时候回复一下吧，谢谢\n---\n\n### 评论 135 - zhzyjb\n\"Image\"\n---\n\n### 评论 136 - hanxi\n> 1、本地播放没问题，测试歌曲小米音箱也可以播放; 2、选择小米音箱播放时，提示\"播放失败请检查网络或换一个试试吧\"; 3、都在同一个网段； 还是存在以上问题，麻烦不忙的时候回复一下吧，谢谢\n\nip端口有没有填对？\n---\n\n### 评论 137 - zhzyjb\n谢谢你，祝你开心每一天……\n---\n\n### 评论 138 - zhzyjb\n我用windows系统安装的docker，IP地址是自动获取的；是不是要修改一下，修改为下面哪个呢\n\n1、电脑的192.168……\n2、WSL的172.\n\n---\n\n### 评论 139 - zhzyjb\n可以了，大佬，我把IP改为电脑的就好了\n---\n\n### 评论 140 - deepcoldy\n专门创建了个小号,把音响共享给小号,想以此做安全隔离,但貌似是不支持共享设备的?这种方式找不到音响设备\n---\n\n### 评论 141 - zhzyjb\n谢谢你，祝你开心每一天……\n---\n\n### 评论 142 - hanxi\n> 专门创建了个小号,把音响共享给小号,想以此做安全隔离,但貌似是不支持共享设备的?这种方式找不到音响设备\n\n反过来使用，把音箱设备放到小号，分享给大号。\n---\n\n### 评论 143 - pengpeng221\n最新版本0.45解决无法发现音箱问题，又出现无法发现本地音乐库问题，不知道是不是版本问题？\n---\n\n### 评论 144 - zhzyjb\n谢谢你，祝你开心每一天……\n---\n\n### 评论 145 - vttv88888888\n0.45版本提示：未发现可用的小爱设备。日志很多行都是：\n[0.4.5] [WARNING] conversation.py:200: Request failed with status 400\n[0.4.5] [WARNING] conversation.py:224: get_latest_ask_from_xiaoai. All retries failed.\n---\n\n### 评论 146 - alililala\n> 0.45版本提示：未发现可用的小爱设备。日志很多行都是： [0.4.5] [WARNING] conversation.py:200: Request failed with status 400 [0.4.5] [WARNING] conversation.py:224: get_latest_ask_from_xiaoai. All retries failed.\n\n0.47也是一样\n---\n\n### 评论 147 - ChaunceyGu\n提示\n/bin/sh: /usr/bin/supervisord: not found\n---\n\n### 评论 148 - hanxi\n@ChaunceyGu 清空docker镜像缓存，重启系统。\n---\n\n### 评论 149 - wangzhan333a\n总是在0.38版，怎么升级到最新版\n---\n\n### 评论 150 - turuiheng\n1-27日最新版本0.4.22有个UBG，让播放歌手，不会自动创建本地歌曲搜索到的歌曲列表自动播放，上个版本0.4.21都可以完美完成这条命令，比如我本地歌曲文件夹里的歌曲都 刘德华 - 1 刘德华 - 2 刘德华 - 3 刘德华 - 4，就会自动创建临时播放列表，刘德华的歌曲列出来，然后开始自动播放\n---\n\n### 评论 151 - coco0948\n未发现可用的小爱设备，请检查账号密码是否输错，并关闭加速代理或在[小米官网](https://www.mi.com/)登陆过人脸或滑块验证。如仍未解决。请根据[FAQ](/issues/99.html)的内容解决问题。近期经常提示这样？怎么解决\n---\n\n### 评论 152 - cowcanfly\n我也是这样，log里提示登录失败。以前是正常的\n---\n\n### 评论 153 - Steohen126\n我发现w4a格式，日志一直出现这个\n\n[2026-02-11 22:15:31] [0.4.22] [INFO] 192.168.2.1:34358 - \"GET /music/%E8%BD%BB%E9%9F%B3%E4%B9%90/%E8%88%92%E7%BC%93%E7%A5%9E%E7%BB%8F%E9%9F%B3%E4%B9%90%F0%9F%8C%BF%E8%B0%83%E8%8A%82%E5%BF%83%E8%84%8F%E5%92%8C%E8%A1%80%E7%AE%A1%E7%9A%84%E6%94%BE%E6%9D%BE%E9%9F%B3%E4%B9%90%EF%BC%8C%E6%94%BE%E6%9D%BE%EF%BC%8C%E8%87%AA%E5%9C%A8.m4a HTTP/1.1\" 206\n\n\n直到结束了才能播放，如果是3-4分钟的还好，大概这个出现10个，但是如果是40多分钟的就很久了\n---\n\n### 评论 154 - zjs820\n我用一个很老的账号可以识别设备L05C，为了安全新注册了一个，结果就识别不到设备了\n---\n\n### 评论 155 - zhzyjb\n谢谢你，祝你开心每一天……\n---\n\n[Issue 链接](https://github.com/hanxi/xiaomusic/issues/99)\n" }, { "path": "docs/issues/changelog.md", "content": "# 版本日志\n\n## v0.4.26 (2026-03-20)\n\n### Fix\n\n- proxy handler CDN safeguard & content-type based FFmpeg routing (#791)\n\n## v0.4.25 (2026-03-19)\n\n### Fix\n\n- proxy url too long for xiaomi speaker (#786)\n- 无法上传音乐 close #783\n\n## v0.4.24 (2026-03-13)\n\n### Feat\n\n- 新增适配iPhone主题 (#775)\n- Add 肉肉音乐TV link to index.html (#773)\n\n### Fix\n\n- 修复无法收藏歌曲的问题\n\n## v0.4.23 (2026-02-17)\n\n### Feat\n\n- **api**: support playlist_name in downloadonemusic (#756)\n- **api**: support downloadonemusic dirname under music_path (#751)\n- 二维码登录功能 (#750)\n- add dirname parameter to /downloadonemusic API (#749)\n- add /getplayerstatus API to get full player status (#747)\n\n### Fix\n\n- 漏提交base64 (#761)\n- **playlist**: avoid custom/folder name collisions (#752)\n- 点击 本地端口-自动填功能 报错 #742\n\n## v0.4.22 (2026-01-26)\n\n### Feat\n\n- 新增 HMusic 客户端\n\n### Fix\n\n- 修复播放歌曲口令问题 close #731\n- 修复nodejs进程无限重启的问题 see #728\n\n## v0.4.21 (2026-01-24)\n\n### Feat\n\n- 优化首页\n\n### Fix\n\n- 修复定时任务播放临时歌单报错问题\n\n## v0.4.20 (2026-01-23)\n\n### Feat\n\n- 优化默认主题的无障碍使用\n- 完善默认主题本机播放功能\n- 优化默认主题界面布局\n- 添加测试口令入口\n\n## v0.4.19 (2026-01-23)\n\n### Feat\n\n- 默认主题支持无障碍使用\n\n### Fix\n\n- 修复收藏歌曲报错\n- 修复 playlist相关接口报错问题\n\n## v0.4.18 (2026-01-21)\n\n### Feat\n\n- 默认口令都允许唤醒\n- 优化默认主题设置页面\n\n### Fix\n\n- 修复插件获取最后一条命令的问题\n- 修复 /proxy 接口问题\n\n## v0.4.17 (2026-01-20)\n\n### Fix\n\n- 支持代理 m3u8 格式链接 close #711\n- 兼容旧配置 hostname 报错 close #713\n- 修复下载歌曲报错 close #709\n- 修复报错 close #708\n\n## v0.4.16 (2026-01-18)\n\n### Feat\n\n- 新增【风花雪乐】手机APP入口\n- 优化获取时长卡顿问题\n- 删除怀旧主题\n\n### Fix\n\n- 只有一单音乐，同时不在播放列表中时更新播放列表 (#703)\n\n## v0.4.15 (2026-01-17)\n\n### Feat\n\n- TTS默认值修改\n\n## v0.4.14 (2026-01-16)\n\n### Fix\n\n- 修复报错 close #696\n\n## v0.4.13 (2026-01-16)\n\n### Feat\n\n- 登录支持仅填 cookie #688\n- 网络歌单插件功能更新 (#690)\n- 编译出 arm/v7 架构的镜像\n\n### Fix\n\n- 修复网络歌曲 proxy 处理问题\n\n## v0.4.12 (2026-01-15)\n\n### Fix\n\n- 修复启动报错\n\n## v0.4.11 (2026-01-15)\n\n### Fix\n\n- 修复报错 close #684\n- 修复登陆报错问题\n- 修复保存报错\n\n## v0.4.10 (2026-01-15)\n\n### Feat\n\n- 主页新增获取对话记录开关\n\n### Fix\n\n- 设置token到account，解决登陆问题 (#680)\n- 把cookie到.mi.token，解决登录报错问题 (#676)\n- 修复ws连接错误\n\n## v0.4.9 (2026-01-15)\n\n### Feat\n\n- 新增清空临时目录接口，优化tts接口\n\n### Fix\n\n- 修复刷新列表问题 close #621\n- 修复定时器关闭问题\n\n### Refactor\n\n- 修改api接口\n\n## v0.4.8 (2026-01-13)\n\n### Feat\n\n- 支持配置 cookie\n- 接入 edge-tts 解决文字转语音的问题 close #642\n\n### Fix\n\n- 修复关机慢的问题，关机改完接口 close #479\n- 修复一直循环播放一首歌曲的问题 close #519\n\n## v0.4.7 (2026-01-12)\n\n### Feat\n\n- 默认关闭语音口令\n- 修复同一个时间不能执行多个定时任务的问题\n- 打包docker镜像并上传github\n- 重构播放时长获取规则 see #668\n\n### Fix\n\n- 修改cache目录，修复播放时长问题\n- 修复异常未加载插件无法禁用bug (#666)\n\n## v0.4.6 (2026-01-12)\n\n### Feat\n\n- 定时任务支持选多个歌曲组成一个歌单播放\n\n### Fix\n\n- 修复【启用】网络歌曲过代理后，在线歌曲播放链接被base编码两次bug (#664)\n- 修复报错 #660\n- 修复在线推送发出设置成循环播放回复的问题\n\n## v0.4.5 (2026-01-10)\n\n### Feat\n\n- 在线播放功能优化，新增AI智能提取用户口令 (#654)\n\n### Fix\n\n- 修复重构后的问题\n- 修复部分网络歌曲无法播放的问题\n- 解决在线歌曲链接转换问题\n- 修复重构引起的问题\n- 修复重构后遇到的问题\n\n## v0.4.4 (2026-01-07)\n\n### Fix\n\n- 修复无法关闭的问题\n- 修复无法关闭的问题\n- 修复关闭不了的问题\n- self.log.inf缺少o\n\n### Refactor\n\n- lint code\n\n## v0.4.3 (2026-01-07)\n\n### Fix\n\n- 定时播放报错\n\n## v0.4.2 (2026-01-06)\n\n### Fix\n\n- 修复不能播放的问题\n\n## v0.4.1 (2026-01-06)\n\n### Fix\n\n- 修复不能播放的问题\n\n## v0.4.0 (2026-01-06)\n\n### Feat\n\n- 移除第三方设备播放功能\n- 新增定时任务刷新网络歌单 #616\n- add last_cmd to store latest query (#635)\n- 增加musicfree插件集成功能\n\n### Fix\n\n- 修复 python3.14 中无法运行的问题\n- 修复顺序播放上一首失效的问题\n- 修复本地歌曲无法播放的问题\n\n### Refactor\n\n- 重构 xiaomusic.py 模块\n- 重构 xiaomusic.py 模块\n- 重构 xiaomusic.py 模块\n- 优化日志\n- 优化日志\n- 重构拆分 httpserver 文件\n- 重构拆分 utils 文件\n- 优化日志输出\n- 清理 httpserver.py 中的无效代码\n\n## v0.3.102 (2025-12-21)\n\n### Feat\n\n- 支持记录每个播放列表上次播放的歌曲 close #613\n\n## v0.3.101 (2025-12-01)\n\n### Fix\n\n- hostname 不允许填 127.0.0.1 和 localhost\n- 修复自动填端口为0的问题\n- SoundSpace随机播放模式失效 #578 (#585)\n- 下线失效的统计服务 close #579\n\n## v0.3.100 (2025-11-09)\n\n### Feat\n\n- soundSpace兼容移动端 (#577)\n\n## v0.3.99 (2025-11-02)\n\n### Feat\n\n- 新增 SoundScape 主题\n- add path aliases and base URL configuration in Vite（SoundSpace） (#569)\n- SoundSpace Theme (#568)\n\n## v0.3.98 (2025-11-02)\n\n## v0.3.97 (2025-11-01)\n\n### Feat\n\n- 升级 miservice\n\n### Fix\n\n- 优化登录问题\n\n## v0.3.96 (2025-10-28)\n\n### Fix\n\n- tts问题临时处理\n\n## v0.3.95 (2025-10-26)\n\n### Fix\n\n- 修复型号M01不能播放问题\n\n## v0.3.94 (2025-10-25)\n\n### Fix\n\n- 尝试修复登录问题\n\n## v0.3.93 (2025-10-25)\n\n### Fix\n\n- 尝试修复登录问题\n\n## v0.3.92 (2025-10-25)\n\n### Fix\n\n- 尝试解决登录失败问题\n\n## v0.3.91 (2025-10-24)\n\n### Feat\n\n- 删掉没用的网页更新功能\n- 获取对话记录接口修改\n\n### Fix\n\n- 尝试修复登录问题\n\n## v0.3.90 (2025-10-22)\n\n### Fix\n\n- 修复登录问题 see #547\n\n## v0.3.89 (2025-10-21)\n\n### Fix\n\n- 修复缺失库报错\n\n## v0.3.88 (2025-09-16)\n\n### Feat\n\n- 新增歌单合并工具\n- 兼容 X6A 型号\n\n## v0.3.87 (2025-09-11)\n\n### Feat\n\n- 新增 websocket 接口获取当前播放状态\n\n### Fix\n\n- 修复本地播放失败问题\n\n## v0.3.86 (2025-09-08)\n\n### Feat\n\n- LX音源支持http_proxy\n- 支持LX歌单\n- 代理播放模式使用原始地址获取歌曲时长\n- 网络歌曲支持使用代理的方式播放\n- 新增代理播放链接功能 see: #525\n\n## v0.3.85 (2025-08-08)\n\n### Fix\n\n- 修复延迟关机按钮失效问题\n\n## v0.3.84 (2025-08-03)\n\n### Feat\n\n- 下一首歌延迟播放秒数支持负数，用于解决播放下一首时会播放上一首的开头几秒的问题\n\n### Fix\n\n- 修复谷歌字体问题\n- 文件监控: 忽略非文件创建、删除和移动事件 (#514)\n- 修复中文定时关机无法识别的BUG (#510)\n- 修复日志文件删除失败的问题\n\n## v0.3.83 (2025-06-12)\n\n### Feat\n\n- 新增开关控制是否开始谷歌统计 see #473\n- 支持b站合集和收藏下载 (#487)\n\n### Fix\n\n- 修复安全问题\n- 修复安全问题\n\n## v0.3.82 (2025-05-30)\n\n### Fix\n\n- 修复节假日文件没有打包到 docker 镜像里的问题\n\n## v0.3.81 (2025-05-28)\n\n### Feat\n\n- 定时任务支持工作日和休息日 see #182\n\n### Fix\n\n- 动态小程序码生成接口 (#478)\n- 指定日志编码,避免中文乱码 (#475)\n\n## v0.3.80 (2025-05-18)\n\n### Feat\n\n- 新增 OH2 型号的支持\n- 支持配置最大搜索歌曲数量 see #462\n\n### Fix\n\n- 修复获取在线歌曲长度 (#469)\n\n## v0.3.79 (2025-04-29)\n\n### Fix\n\n- 修复型号LX05不能播放问题\n\n## v0.3.78 (2025-04-09)\n\n### Feat\n\n- 优化获取时长的方式\n\n### Fix\n\n- 修复部分型号单曲播放功能无效的问题\n- 监控文件夹仅对音乐格式生效，减少不必要的刷新 (#441)\n- 修复型号X4B不能播放问题\n\n## v0.3.77 (2025-03-13)\n\n### Feat\n\n- OH2P 型号支持打断说话\n\n### Fix\n\n- 修复首页看不到设备的问题\n\n## v0.3.76 (2025-03-11)\n\n### Feat\n\n- 整理第三方播放设备的代码\n- 删除歌曲口令默认关闭\n- 新增删除歌曲口令 see #402\n- 增加音量控制for -3thplay.html by socketio.emit (#404)\n- 增加大声,音量,继续的指令,用于3thplay (#401)\n- 不用再手动配置 tts command, 优先使用已知的 tts command\n- 新增重新初始的定时任务 #182\n- 新增定时任务用于开启和关闭拉取对话记录 #182\n- 加入了遥控网页播放，用于实现电视上使用 (#395)\n\n### Fix\n\n- tailwind播放页面有报错，暂时禁用\n- tailwind 主题问题\n- 修复下载后不自动播放的问题\n- 修复每次打开页面都是随机播放的问题\n\n## v0.3.75 (2025-02-18)\n\n### Feat\n\n- 监测音乐文件夹变化更新歌曲列表 (#394)\n- 添加正在播放页面 (#386)\n- 更新tailwind主题 (#383)\n\n### Fix\n\n- 未开启模糊匹配播放错误问题 (#393)\n- 修复tailwind主题样式问题 (#384)\n\n## v0.3.74 (2025-01-21)\n\n### Feat\n\n- 新增 Tailwind 主题\n- 修改设置页面文档链接\n\n### Fix\n\n- 修复下载歌单重命名问题\n\n## v0.3.73 (2025-01-16)\n\n### Fix\n\n- 当前歌曲不在列表中时才切换列表 close #359\n- 修复默认主题播放进度时间问题\n- 尝试修复获取对话记录失败的问题 close #362\n\n## v0.3.72 (2025-01-11)\n\n### Feat\n\n- 新增播放文字功能\n\n### Fix\n\n- 修复默认主题没有单曲循环的问题 see #355\n\n## v0.3.71 (2025-01-07)\n\n### Feat\n\n- 支持自动填 ip 和端口\n\n### Fix\n\n- 搜索歌曲窗口不自动关闭 see #351\n- 解决歌词信息写入失败的问题\n- 修复一些小问题\n- 非播放中也返回歌曲时长 see #340\n\n## v0.3.70 (2025-01-04)\n\n### Fix\n\n- 尝试修复部分设备无法启动的问题\n- 解决首页提示翻译英文问题\n- 尝试解决 supervisor 启动报错\n\n## v0.3.69 (2025-01-01)\n\n### Feat\n\n- 支持关闭获取对话记录功能\n\n### Fix\n\n- 尝试解决网络卡顿问题\n\n## v0.3.68 (2024-12-31)\n\n### Feat\n\n- umami 脚本改为异步加载\n- 支持 python3.13 版本\n- 增加均衡歌曲响度（可选） (#338)\n\n### Fix\n\n- 修复保存设置时可能出现报错的情况\n\n## v0.3.67 (2024-12-29)\n\n### Feat\n\n- 简化设置，不允许修改监听端口\n\n### Fix\n\n- 修复默认主题搜索问题\n\n## v0.3.66 (2024-12-26)\n\n### Fix\n\n- 修复歌曲批量重命名的问题\n- 修复自定义歌单删除后没刷新歌单列表\n- 尝试修复更新失败问题\n\n## v0.3.65 (2024-12-24)\n\n### Fix\n\n- 处理图像报错\n- 修改歌单名字漏更新歌单列表\n- 修复获取自定义歌单接口报错\n\n## v0.3.64 (2024-12-22)\n\n### Fix\n\n- 使用自己架设的 sentry 服务，解决 Cloudflare 额度超量问题\n\n## v0.3.63 (2024-12-22)\n\n### Perf\n\n- 只监控报错信息\n\n## v0.3.62 (2024-12-21)\n\n### Fix\n\n- 修复首次配置时，默认主题只有一个设备的问题。\n- 修复一些报错问题\n\n## v0.3.61 (2024-12-19)\n\n### Fix\n\n- 尝试修复更新问题\n\n### Refactor\n\n- 重构更新流程\n\n## v0.3.60 (2024-12-19)\n\n## v0.3.59 (2024-12-19)\n\n### Feat\n\n- 新增更多的歌单编辑相关接口\n- 一键更新功能\n- 接入 sentry 平台\n- 实现更新接口\n- 下载完成之后修改文件权限为755 close #316\n\n### Fix\n\n- 解决飞牛平台报错问题\n\n### Refactor\n\n- 优化代码日志级别\n- 更新等消息推送到客户端再重启\n- 更新接口修改\n\n## v0.3.58 (2024-12-15)\n\n### Fix\n\n- 尝试解决七牛设备问题\n- 修复 umami 统计函数报错，解决七牛环境问题\n\n## v0.3.57 (2024-12-14)\n\n### Feat\n\n- 优化批量下载工具命名和下载高码率音频\n- 新增搜索播放口令用于生成临时播放列表\n- 新增设置项 ignore_tag_dirs 用于忽略读取目录下的标签信息，解决挂载 alist 目录的问题\n- 新主题 Material (#299)\n\n### Fix\n\n- 默认主题刷新时选中当前播放歌曲\n- 修复当前播放列表没更新的问题\n- 修复搜索时不显示保存输入框问题\n- 收藏 (#301)\n- 修复收藏歌曲失败的问题\n- 小屏幕设备主页显示问题 (#300)\n\n### Refactor\n\n- 修改默认主题\n- 后端也加入 umami 统计\n- 新增自托管 umami 统计\n- XIAOMUSIC_HOSTNAME 携带端口号友好提醒并处理 (#303)\n- 修改标题\n- 冲突解决错误\n\n## v0.3.56 (2024-12-07)\n\n### Feat\n\n- tag 信息支持写入到歌曲文件 see #266\n- 开启gzip压缩\n\n### Fix\n\n- 播放失败设置重试次数10次，解决设备失联后无限重试的问题\n- 修复最近新增歌单问题\n- 小程序码移动端布局兼容 (#293)\n\n## v0.3.55 (2024-12-04)\n\n### Fix\n\n- 修复播放接口报错问题\n\n## v0.3.54 (2024-12-04)\n\n### Feat\n\n- 新增最近新增歌单 close #273\n\n### Fix\n\n- 安卓低版本webview对audio的src为空值的报错 (#289)\n- 修复M01语音播放问题，X08C X08E X8F 型号默认采用型号兼容模式 see #30\n\n## v0.3.53 (2024-12-03)\n\n### Fix\n\n- 解决播放接口修改后播放失败的问题\n\n## v0.3.52 (2024-12-03)\n\n### Fix\n\n- 修复播放接口参数错误的问题\n\n## v0.3.51 (2024-12-03)\n\n### Fix\n\n- 修复空配置启动失败问题 close #284\n\n## v0.3.50 (2024-12-03)\n\n### Feat\n\n- 修改日志文件的默认值\n- 新增修改tag缓存信息的接口 close #266\n- 新增专用的播放歌曲和播放歌单接口，解决默认口令提示词被修改了导致后台失效的问题\n- 统计设备型号\n- 页面与设置中的HOST不一致时弹窗提醒 (#281)\n- 未发现小爱设备时给予提示 (#278)\n- 优化设置页面提示\n\n### Fix\n\n- 更新 yt-dlp ，解决 B 站下载问题 close #279\n- 网页播放audio获取到错误url无法播放时提醒用户 (#280)\n- input标签自闭合\n\n### Refactor\n\n- 调整设置页面\n\n## v0.3.49 (2024-11-28)\n\n### Feat\n\n- 临时文件目录支持配置 #99\n- 新增单曲播放和顺序播放功能 close #277\n- 设置播放类型支持配置语音提示词，定时任务支持设置播放类型\n\n### Fix\n\n- 修复中文数字转换函数对'十、十一'等数字的处理 (#275)\n\n## v0.3.48 (2024-11-20)\n\n### Feat\n\n- 支持替换默认口令，而不是追加 close #259\n- 新增自定义个歌单接口 #242\n\n### Fix\n\n- 锁定 PWA 应用旋转方向\n\n## v0.3.47 (2024-11-14)\n\n### Feat\n\n- 支持 PWA 应用安装\n- 新增模糊匹配测试用例\n\n### Fix\n\n- 修复 PWA 应用有密码时报错的问题\n- 修复播放顺序没有按数字排序的问题 close #249\n\n## v0.3.46 (2024-11-08)\n\n### Feat\n\n- 升级依赖库\n\n### Fix\n\n- 添加依赖库 requests\n\n### Refactor\n\n- 依赖库已经支持分段获取静态文件，重构代码\n\n## v0.3.45 (2024-11-08)\n\n### Feat\n\n- 定时任务支持设置音量\n- 播放歌单口令支持配置\n\n### Fix\n\n- 修复定时任务报错问题\n\n## v0.3.44 (2024-11-01)\n\n### Feat\n\n- 日志时间里加上日期\n\n### Fix\n\n- 修复搜索失败的问题\n\n## v0.3.43 (2024-10-30)\n\n### Feat\n\n- 播放列表可以删除当前歌曲(!危险操作，请在设置中心开启相关功能) (#250)\n- 插件自定义口令支持获取语音输入内容 #105\n\n### Fix\n\n- 修复谷歌统计导致的卡顿问题\n- 解决挂载网盘卡死的问题\n\n## v0.3.42 (2024-10-24)\n\n### Fix\n\n- 尝试修复缺少 libtiff.so.6 文件的问题 #244\n- 修复默认主题播放歌曲输入框空的情况\n- 尝试修复停止后自动播放的问题\n\n## v0.3.41 (2024-10-17)\n\n### Feat\n\n- 设置默认时区为东八区 closed #236\n\n### Fix\n\n- 修复获取标签信息报错问题\n- remove_id3_tags return None if no id3 tag (#238)\n- bug in del_music (#237)\n\n## v0.3.40 (2024-10-16)\n\n### Feat\n\n- 默认主题的播放列表上显示歌曲数量\n\n### Fix\n\n- 修复播放卡顿问题（谷歌统计地址无法访问的情况）\n\n## v0.3.39 (2024-10-15)\n\n### Feat\n\n- 固定的播放列表全部初始化\n- 生产环境与开发环境接口分离、关于页面增加返回到主页的链接\nupdate: 支持https页面未及时更新的问题\n\n### Fix\n\n- pure主题 当前设备与远程设备未正确区分的问题 (#234)\n- static和doc添加basic auth (#231)\n\n### Refactor\n\n- 修改默认UI播放提示词 (#233)\n\n## v0.3.38 (2024-10-14)\n\n### Feat\n\n- 播放状态接口返回当前播放列表 (#229)\n- 新增口令收藏歌曲用来收藏当前播放的歌曲\n- 默认UI搜索框动态显示 (#228)\n- 文件转换逻辑延迟到读取文件的时候 see #218\n- 重写播放组件，现在支持歌词显示了\n- 使用 /cmdstatus 接口来判断异步任务是否完成\n- 新增接口 /cmdstatus 用于查询异步任务是否执行完毕\n- XMusicPlayer播放器主题优化 (#216)\n- XMusicPlayer播放器主题 (#214)\n- 新增 yt-dlp cookies 文件参数支持\n- 新增批量下载歌曲工具\n- 新增后台网站图标\n- 加密音乐和图片访问链接 (#200)\n- 歌曲信息中的图片改为url #190\n- 新增更新提醒\n- 定时任务新增刷新播放列表接口\n- 后台设置名称优化\n- 新增按钮刷新 tag 信息\n- 新增 musicinfos 接口用于批量查询歌曲信息\n- 增加 tags 缓存 (#193)\n- 使用 opencc 将歌曲名转化为简体 (#192)\n- 搜索的歌曲存成列表供前端显示,实现额外索引 (#188)\n- 搜索多个结果，并更新“当前”播放列表 (#185)\n- musicinfo接口新增musictag参数，用于返回歌曲额外信息\n- 新增口令【播放列表第几个+列表名】来播放列表里的第几个 #158\n- 新增定时任务功能 #182\n- hostname can take protocol，域名支持 https 格式 (#181)\n\n### Fix\n\n- xplayer 收藏歌曲、取消收藏 (#230)\n- 修复型号M01获取对话记录时间戳的问题\n- 修复型号M01无法获取到对话记录的问题\n- 使用小爱设备播放时组件异常的问题 (#217)\n- 修复图片获取失败的问题\n- 修复 yt-dlp-cookies 报错\n- 修复自定义口令末尾多余逗号的情况\n- 修复windows下路径问题\n- 解决 L05C 无提示音问题 support MiIOService tts (#198)\n- 解决歌曲信息乱码问题\n- 修复搜索补全不生效的问题\n- 修复默认主题没有选中上次播放列表的问题\n- ffmpeg only output audio (#184)\n\n### Refactor\n\n- 新增清理缓存按钮\n- 优化默认UI的搜索框#226 (#227)\n- 修复告警\n- 体验优化，音乐列表缓存 (#222)\n- 修改为播放选中歌曲\n- 更新静态文件\n\n### Perf\n\n- 对歌曲信息中的图片缩小到300 #190\n\n## v0.3.37 (2024-09-20)\n\n### Feat\n\n- Pure主题更新 设置中心新增主题音乐列表样式选择、夜间模式、其他多项优化 (#180)\n\n## v0.3.36 (2024-09-19)\n\n### Feat\n\n- Pure 主题更新 (#178)\n- 支持配置获取对话记录间隔时间 #169\n- 允许在后台设置监听端口\n\n### Fix\n\n- 修复开启继续播放时歌曲播放不完整问题 (#177)\n\n## v0.3.35 (2024-09-18)\n\n### Feat\n\n- 允许跨域访问 #172\n\n### Fix\n\n- 修复 Pure 主题白屏无法打开的问题 (#176)\n\n## v0.3.34 (2024-09-18)\n\n### Feat\n\n- 新增 pure 主题 vue + elementUI (#172)\n\n### Fix\n\n- 主页适配移动端\n- 修复网页播放点击后没有关闭旧声音的问题 #166\n- 修复单曲循环的情况下歌曲不在当前播放列表时失效的情况\n\n### Refactor\n\n- 优化代码:输入框处理抖动问题，网页播放修改实现方式 see #166\n\n## v0.3.33 (2024-09-15)\n\n### Feat\n\n- 调整页面布局\n- 支持继续播放 (#171)\n\n### Fix\n\n- #168 安全优化: 设置数据接口密码隐藏处理\n- 修复谷歌统计报错问题\n\n### Refactor\n\n- 优化谷歌统计\n\n## v0.3.32 (2024-09-14)\n\n### Feat\n\n- 新增谷歌统计\n- 增加播放进度 (#160)\n\n### Fix\n\n- 优化audio_id查询方式 (#165)\n- 播放链接接口支持复杂的链接\n\n## v0.3.31 (2024-09-10)\n\n### Feat\n\n- 新增播放上一首歌曲功能 #90\n- 新增所有歌曲列表\n- 触屏版显示歌曲名称 (#156)\n\n### Fix\n\n- 修复插件示例报错 #105\n- 修复当前播放歌曲没保存的问题 #90\n\n## v0.3.30 (2024-09-07)\n\n### Feat\n\n- 修改设置按钮位置\n- 新增网页播放接口 #138\n\n## v0.3.29 (2024-09-06)\n\n### Feat\n\n- 设置页面新增接口文档入口\n\n### Fix\n\n- 修复网页开启秘密验证无法播歌的问题 #149\n\n## v0.3.28 (2024-09-03)\n\n### Feat\n\n- 新增歌曲收藏功能 #87\n\n### Fix\n\n- docker下minetypes无法判断m4a\n\n### Refactor\n\n- ffmpeg_location 从配置里读取\n\n## v0.3.27 (2024-09-02)\n\n### Feat\n\n- Add feature as requested in issue #143\n\n### Fix\n\n- 默认下载目录修改\n\n### Refactor\n\n- 处理 code review 问题'\n\n## v0.3.26 (2024-08-17)\n\n### Feat\n\n- 删除网关模式\n\n## v0.3.25 (2024-08-16)\n\n### Feat\n\n- 设置页面支持配置 use_music_api 选项\n\n## v0.3.24 (2024-08-01)\n\n### Fix\n\n- #131 修复多设备切换时播放模式显示错误问题\n\n## v0.3.23 (2024-08-01)\n\n### Fix\n\n- 修复部分文件获取不到播放时长问题\n- 处理安全问题\n\n## v0.3.22 (2024-08-01)\n\n### Feat\n\n- 网关模式支持配置，默认关闭\n\n### Fix\n\n- 继续优化延迟问题\n\n## v0.3.21 (2024-07-30)\n\n### Feat\n\n- 尝试加个网关在前面处理静态文件来加速文件获取\n\n### Fix\n\n- 使用前置网关处理静态文件来加速，尝试解决延迟的问题\n- 播放前先立即暂停之前的音乐\n\n## v0.3.20 (2024-07-30)\n\n### Fix\n\n- 尝试修复延迟问题，修复播放停止不了的问题\n\n## v0.3.19 (2024-07-30)\n\n### Fix\n\n- 调整配置，优化获取歌曲时长接口\n\n## v0.3.18 (2024-07-29)\n\n### Fix\n\n- #135 修复获取不到播放时长时只播放3秒的问题\n\n## v0.3.17 (2024-07-28)\n\n### Fix\n\n- 优化日志输出，尝试排查延迟播放的问题\n\n## v0.3.16 (2024-07-28)\n\n## v0.3.15 (2024-07-28)\n\n### Fix\n\n- 修复自定义口令重复的问题\n- 修复日志输出问题\n- 修复退出异常问题\n\n## v0.3.14 (2024-07-28)\n\n### Feat\n\n- 优化播放延迟问题，并新增配置下一首播放的延迟秒数\n\n## v0.3.13 (2024-07-24)\n\n### Fix\n\n- 解决 docker 镜像问题\n\n## v0.3.12 (2024-07-24)\n\n### Feat\n\n- 优化获取文件播放时长接口，尝试解决播放延迟和操作面板卡顿的问题\n\n## v0.3.11 (2024-07-22)\n\n### Feat\n\n- Add remove mp3 id3 tag function\n\n### Fix\n\n- #130 单曲循环的模式下，播放列表的指令不生效\n\n### Refactor\n\n- 优化代码\n\n## v0.3.10 (2024-07-19)\n\n### Feat\n\n- 支持软连接的接口直接用os.walk即可\n\n### Fix\n\n- 修复软连接目录不能播放的问题\n- 修复自定义语音口令设置不生效的问题\n\n## v0.3.9 (2024-07-17)\n\n### Feat\n\n- #119 音乐目录支持软连接\n\n### Fix\n\n- 修复日志下载报错问题\n- 兼容旧的setting.json文件中conf_path为空的情况\n- 修复设置页面可能打不开的问题\n\n## v0.3.8 (2024-07-16)\n\n### Fix\n\n- 修复播放url接口问题\n\n## v0.3.7 (2024-07-16)\n\n### Feat\n\n- 播放链接按钮对应给个默认的链接用于测试\n- Uvicorn 的日志信息合并到 xiaomusic 日志里显示\n\n## v0.3.6 (2024-07-15)\n\n### Fix\n\n- #126 修复pip安装时主页打不开的问题\n\n## v0.3.5 (2024-07-15)\n\n### Fix\n\n- #116 播放失败自动切下首歌\n\n## v0.3.4 (2024-07-15)\n\n### Fix\n\n- #125 修复本地英文歌曲匹大小写字母配不到的问题\n\n## v0.3.3 (2024-07-15)\n\n### Fix\n\n- 尝试修复播放卡顿问题 see #124\n\n## v0.3.2 (2024-07-15)\n\n### Fix\n\n- #122 pip安装方式下，static目录找不到报错\n- 版本更新时更新页面缓存\n\n## v0.3.1 (2024-07-15)\n\n### Fix\n\n- 修复主页选择设备不生效的问题 see #120\n\n## v0.3.0 (2024-07-14)\n\n### Feat\n\n- 建议音乐目录和配置目录分开不同目录\n- 优化后台网络设置，同时支持ipv4和ipv6\n- 使用fastapi替换flask,解决多线程问题\n- #106 网页上显示音箱当前状态（播放中or空闲中）以及当前的播放模式\n- 优化首页加载慢的问题\n- 优化设置页面布局，方便配置必须项\n- 优化配置界面，支持配置分组\n- 支持多设备分开播放 see #65\n\n### Fix\n\n- #114 修复部分 mp3 文件长度识别错误\n- 删除 armv6 的支持\n- 修复编译问题\n- 修复音乐路径设置后找不到音乐的问题\n- 修复启动报错的问题\n- 修复CI警告问题\n\n## v0.2.0 (2024-07-09)\n\n### Feat\n\n- 触屏版可以不用设置 XIAOMUSIC_USE_MUSIC_API\n- 升级依赖库\n- 唤醒口令配置支持配语音词，简化自定义口令配置 see #105\n\n## v0.1.101 (2024-07-07)\n\n### Fix\n\n- #81 修复播放列表时，当前歌曲不在列表没有更换歌曲的问题\n- #110 修复配置加载问题\n\n## v0.1.100 (2024-07-07)\n\n### Fix\n\n- 日志代码写错\n\n## v0.1.99 (2024-07-07)\n\n### Fix\n\n- #81 修复播放列表没有继续播放上次播放的歌曲，并把随机播放，全部循环，单曲循环状态落地\n\n## v0.1.98 (2024-07-07)\n\n### Fix\n\n- 修复多设备获取不到对话记录的问题 see #65\n- #93 修复目录深度设置后导致目录下的歌曲无法加到播放列表里的问题\n\n## v0.1.97 (2024-07-06)\n\n### Fix\n\n- 修复网页控制台设置页面保存报错\n\n## v0.1.96 (2024-07-06)\n\n### Feat\n\n- 使用commitizen管理版本号\n- 页面版本号链接到CHANGELOG页面\n- 规范版本管理\n\n## v0.1.95 (2024-07-06)\n\n## v0.1.94 (2024-07-06)\n\n### Feat\n\n- 优化多设备接口执行效果，尽量做到同时执行\n\n### Fix\n\n- 新增参数配置强制打断小爱说话\n- 修复多设备获取对话记录的问题\n- 修复windows下路径分隔符被视为转移符导致音箱无法播放音乐的问题\n- 修复播放链接报错\n- 修复配置页面默认配置被置空的问题\n\n## v0.1.93 (2024-07-05)\n\n### Feat\n\n- 访问账号密码默认为空\n- 支持下载的目录与本地音乐目录分开 see #98\n- 新增m4a文件格式支持\n- 设置页面支持配置多设备\n- 默认用空的后台账号和密码\n- 支持多个设备同时播放 see #65\n- 新增自定义口令功能 #105\n\n### Fix\n\n- 修复设置页面没成功初始化设置问题\n- 修复镜像缺少文件问题\n- 尝试解决插件路径问题\n- 设置页面日志路径写错了\n- 修复口令导致异常关闭的问题\n\n## v0.1.92 (2024-07-04)\n\n### Feat\n\n- 启动参数新增 --port 配置监听端口\n- 外网访问端口可独立配置\n- 优化设置页面，新增更多配置项\n- 首次保存设置后不需要重启容器\n\n### Fix\n\n- 日志文件配置的环境变量写错了\n\n## v0.1.91 (2024-07-03)\n\n### Fix\n\n- 尝试解决触屏版不能播放的问题\n\n## v0.1.90 (2024-07-02)\n\n### Feat\n\n- 优化触屏版播放页面显示歌曲\n\n## v0.1.89 (2024-07-02)\n\n### Feat\n\n- 尝试解决触屏版无法播放的问题\n\n### Fix\n\n- 播放歌曲写成固定的了\n- 播放歌曲时被其他指令打断后没有继续播放\n\n## v0.1.88 (2024-07-02)\n\n### Feat\n\n- 日志里不要输出敏感信息\n- 优化下载 ffmpeg 脚本，尝试解决 armv7 环境问题\n- 优化日志输出信息\n- 尝试解决触屏版无法播放的问题\n\n### Fix\n\n- 是否下载中判断错误导致播放无法自动重新开始播放\n- 升级yt-dlp到2024.07.01\n- 修复部分型号关机失败的问题\n\n## v0.1.87 (2024-07-01)\n\n### Fix\n\n- 修复XIAOMUSIC_USE_MUSIC_API=true时播放不了的问题\n\n## v0.1.86 (2024-07-01)\n\n### Feat\n\n- 优化 ffmpeg 安装脚本\n- 新增调试工具用来调试 player_play_music 接口\n- 升级依赖库 MiService\n\n### Fix\n\n- 尝试修复 armv7 的 ffmpeg 问题\n- 尝试修复关机失败的问题\n- 修复口令不能播放的问题\n\n## v0.1.85 (2024-06-30)\n\n### Feat\n\n- 版本号链接到github的release页面，方便查看版本更新日志\n\n### Fix\n\n- 修复电台删除后没有从电台列表中删除的问题\n\n## v0.1.84 (2024-06-30)\n\n### Feat\n\n- config.json 支持更多配置选项\n- 新增 XIAOMUSIC_STOP_TTS_MSG 配置关机提示音\n\n## v0.1.83 (2024-06-30)\n\n## v0.1.82 (2024-06-30)\n\n### Feat\n\n- 优化指令匹配规则\n\n## v0.1.81 (2024-06-30)\n\n## v0.1.80 (2024-06-30)\n\n### Fix\n\n- #91 修复下载歌曲报错\n\n## v0.1.79 (2024-06-29)\n\n## v0.1.77 (2024-06-29)\n\n### Fix\n\n- #52 支持配置模糊匹配本地歌曲\n\n## v0.1.76 (2024-06-28)\n\n## v0.1.75 (2024-06-28)\n\n## v0.1.74 (2024-06-28)\n\n## v0.1.73 (2024-06-28)\n\n## v0.1.72 (2024-06-28)\n\n## v0.1.71 (2024-06-28)\n\n### Fix\n\n- #83\n\n## v0.1.70 (2024-06-27)\n\n## v0.1.69 (2024-06-26)\n\n## v0.1.67 (2024-06-26)\n\n## v0.1.66 (2024-06-26)\n\n## v0.1.65 (2024-06-26)\n\n## v0.1.64 (2024-06-26)\n\n## v0.1.62 (2024-06-25)\n\n## v0.1.61 (2024-06-25)\n\n## v0.1.60 (2024-06-25)\n\n## v0.1.58 (2024-06-25)\n\n### Fix\n\n- 登陆失败不阻塞启动\n\n## v0.1.57 (2024-06-24)\n\n## v0.1.56 (2024-06-24)\n\n## v0.1.55 (2024-06-23)\n\n### Fix\n\n- #47 支持配置基础的BaseAuth登录\n\n## v0.1.54 (2024-06-23)\n\n### Fix\n\n- #76 新增XIAOMUSIC_MUSIC_PATH_DEPTH配置生成播放列表的目录深度，默认10\n- #74 配置目录可以和下载目录分开配置, 新增XIAOMUSIC_CONF_PATH用来设置配置目录，不配置时使用下载目录\n\n## v0.1.53 (2024-06-23)\n\n## v0.1.52 (2024-06-21)\n\n## v0.1.51 (2024-06-20)\n\n## v0.1.49 (2024-06-20)\n\n## v0.1.48 (2024-06-16)\n\n## v0.1.47 (2024-06-16)\n\n## v0.1.46 (2024-06-15)\n\n## v0.1.45 (2024-06-15)\n\n## v0.1.44 (2024-06-14)\n\n## v0.1.43 (2024-06-14)\n\n## v0.1.41 (2024-06-14)\n\n## v0.1.40 (2024-06-12)\n\n## v0.1.39 (2024-06-12)\n\n## v0.1.38 (2024-06-12)\n\n### Fix\n\n- #70 下一首歌曲不存在时从播放列表中删除并继续找下一首\n\n## v0.1.37 (2024-06-04)\n\n## v0.1.36 (2024-05-30)\n\n## v0.1.35 (2024-05-30)\n\n### Fix\n\n- #67 没配置did时也允许启动 http 服务\n\n## v0.1.34 (2024-05-19)\n\n## v0.1.33 (2024-05-19)\n\n### Fix\n\n- #50 新增配置页面\n- #62\n\n## v0.1.32 (2024-05-17)\n\n## v0.1.31 (2024-05-16)\n\n## v0.1.30 (2024-05-16)\n\n### Fix\n\n- 控制台显示版本号 #59\n\n## v0.1.29 (2024-05-16)\n\n### Fix\n\n- #57 #55\n\n## v0.1.28 (2024-05-16)\n\n## v0.1.27 (2024-05-16)\n\n## v0.1.26 (2024-05-08)\n\n## v0.1.25 (2024-05-06)\n\n## v0.1.24 (2024-04-30)\n\n## v0.1.23 (2024-04-30)\n\n## v0.1.22 (2024-04-30)\n\n## v0.1.21 (2024-04-08)\n\n## v0.1.20 (2024-04-08)\n\n## v0.1.19 (2024-04-04)\n\n## v0.1.18 (2024-02-24)\n\n## v0.1.16 (2024-02-24)\n\n## v0.1.15 (2024-02-03)\n\n## v0.1.14 (2024-02-03)\n\n## v0.1.13 (2024-02-02)\n\n## v0.1.12 (2024-01-30)\n\n### Fix\n\n- set volume failed\n\n## v0.1.11 (2024-01-29)\n\n## v0.1.10 (2024-01-29)\n\n## v0.1.9 (2024-01-28)\n\n### Fix\n\n- arg1 漏修改\n\n## v0.1.8 (2024-01-28)\n\n### Fix\n\n- http server listen host\n\n## v0.1.7 (2024-01-28)\n\n## v0.1.6 (2024-01-28)\n\n## v0.1.5 (2024-01-27)\n\n## v0.1.4 (2024-01-27)\n\n### Fix\n\n- error when play next\n\n## v0.1.3 (2023-10-15)\n\n## v0.1.2 (2023-10-15)\n\n## v0.1.1 (2023-10-14)\n" }, { "path": "docs/issues/index.md", "content": "# XiaoMusic: 无限听歌，解放小爱音箱\n\n[![GitHub License](https://img.shields.io/github/license/hanxi/xiaomusic)](https://github.com/hanxi/xiaomusic)\n[![Docker Image Version](https://img.shields.io/docker/v/hanxi/xiaomusic?sort=semver&label=docker%20image)](https://hub.docker.com/r/hanxi/xiaomusic)\n[![Docker Pulls](https://img.shields.io/docker/pulls/hanxi/xiaomusic)](https://hub.docker.com/r/hanxi/xiaomusic)\n[![PyPI - Version](https://img.shields.io/pypi/v/xiaomusic)](https://pypi.org/project/xiaomusic/)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/xiaomusic)](https://pypi.org/project/xiaomusic/)\n[![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fhanxi%2Fxiaomusic%2Fmain%2Fpyproject.toml)](https://pypi.org/project/xiaomusic/)\n[![GitHub Release](https://img.shields.io/github/v/release/hanxi/xiaomusic)](https://github.com/hanxi/xiaomusic/releases)\n[![Visitors](https://api.visitorbadge.io/api/daily?path=hanxi%2Fxiaomusic&label=daily%20visitor&countColor=%232ccce4&style=flat)](https://visitorbadge.io/status?path=hanxi%2Fxiaomusic)\n[![Visitors](https://api.visitorbadge.io/api/visitors?path=hanxi%2Fxiaomusic&label=total%20visitor&countColor=%232ccce4&style=flat)](https://visitorbadge.io/status?path=hanxi%2Fxiaomusic)\n\n---\n\n

\n 🎵 使用小爱音箱播放音乐，音乐使用 yt-dlp 下载\n

\n\n

\n 🏠 GitHub •\n 📖 文档 •\n 💬 FAQ •\n 💭 讨论区\n

\n\n---\n\n> [!TIP]\n> **新手指南**：初次安装遇到问题请查阅 [💬 FAQ问题集合](https://github.com/hanxi/xiaomusic/issues/99)，一般遇到的问题都已经有解决办法。\n\n## 👋 快速入门指南\n\n已经支持在 web 设置页面配置其他参数，不再需要设置环境变量， docker compose 配置如下（选一个即可）：\n\n```yaml\nservices:\n xiaomusic:\n image: hanxi/xiaomusic\n container_name: xiaomusic\n restart: always\n ports:\n - 58090:8090\n volumes:\n - /xiaomusic_music:/app/music\n - /xiaomusic_conf:/app/conf\n```\n\n🔥 国内：\n\n```yaml\nservices:\n xiaomusic:\n image: docker.hanxi.cc/hanxi/xiaomusic\n container_name: xiaomusic\n restart: always\n ports:\n - 58090:8090\n volumes:\n - /xiaomusic_music:/app/music\n - /xiaomusic_conf:/app/conf\n```\n\n测试版：\n\n```yaml\nservices:\n xiaomusic:\n image: hanxi/xiaomusic:main\n container_name: xiaomusic\n restart: always\n ports:\n - 58090:8090\n volumes:\n - /xiaomusic_music:/app/music\n - /xiaomusic_conf:/app/conf\n```\n\n对应的 docker 启动命令如下:\n\n```bash\ndocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic\n```\n\n🔥 国内：\n\n```bash\ndocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf docker.hanxi.cc/hanxi/xiaomusic\n```\n\n测试版：\n\n```\ndocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic:main\n```\n\n- 其中 conf 目录为配置文件存放目录，music 目录为音乐存放目录，建议分开配置为不同的目录。\n- /xiaomusic_music 和 /xiaomusic_conf 是 docker 所在的主机的目录，可以修改为其他目录。如果报错找不到 /xiaomusic_music 目录，可以先执行 `mkdir -p /xiaomusic_{music,conf}` 命令新建目录。\n- /app/music 和 /app/conf 是 docker 容器里的目录，不要去修改。\n- 58090 是 NAS 本地端口的。8090 是容器端口，不要去修改。\n- 后台访问地址为： http://NAS_IP:58090\n\n> [!NOTE]\n> docker 和 docker compose 二选一即可，启动成功后，在 web 页面可以配置其他参数，带有 `*` 号的配置是必须要配置的，其他的用不上时不用修改。初次配置时需要在页面上输入小米账号和密码保存后才能获取到设备列表。\n\n> [!TIP]\n> 目前安装步骤已经是最简化了，如果还是嫌安装麻烦，可以微信或者 QQ 约我远程安装，我一般周末和晚上才有时间，需要赞助个辛苦费 :moneybag: 50 元一次。\n\n遇到问题可以去 web 设置页面底部点击【下载日志文件】按钮，然后搜索一下日志文件内容确保里面没有账号密码信息后(有就删除这些敏感信息)，然后在提 issues 反馈问题时把下载的日志文件带上。\n\n> [!TIP]\n> 作者新写了一个更简洁的个人音乐服务器，支持更强的插件扩展 \n\n> [!TIP]\n> 作者写的一个游戏服务器开发实战课程 ，购买时记得使用优惠码: `2CZ2UA5u` 。\n\n> [!TIP]\n> - 适用于 NAS 上安装的开源工具： \n> - 适用于 NAS 上安装的网页打印机： \n> - PVE 移动端 UI 界面：\n> - 喜欢听书的可以配合这个工具使用 \n\n> [!TIP]\n>\n> - 🔥【广告:可用于安装 frp 实现内网穿透】\n> - 🔥 海外 RackNerd VPS 机器推荐，可支付宝付款。\n> - \"RackNerd\n> - 不知道选哪个套餐可以直接买这个最便宜的 \n> - 也可以用来部署代理，docker 部署方法见 \n\n> [!TIP]\n>\n> - 🔥【广告: 搭建您的专属大模型主页\n告别繁琐配置难题，一键即可畅享稳定流畅的AI体验！】\n\n> [!TIP]\n> - 免费主机\n> - \"Powered\n\n\n## 🎤 功能特性\n\n### 🤐 支持语音口令\n\n#### 基础播放控制\n- **播放歌曲** - 播放本地的歌曲\n- **播放歌曲+歌名** - 例如：播放歌曲周杰伦晴天\n- **上一首** / **下一首** - 切换歌曲\n- **关机** / **停止播放** - 停止播放\n\n#### 播放模式\n- **单曲循环** - 重复播放当前歌曲\n- **全部循环** - 循环播放所有歌曲\n- **随机播放** - 随机顺序播放\n\n#### 歌单管理\n- **播放歌单+目录名** - 例如：播放歌单其他\n- **播放歌单第几个+列表名** - 详见 [#158](https://github.com/hanxi/xiaomusic/issues/158)\n- **播放歌单收藏** - 播放收藏歌单\n\n#### 收藏功能\n- **加入收藏** - 将当前播放的歌曲加入收藏歌单\n- **取消收藏** - 将当前播放的歌曲从收藏歌单移除\n\n> [!TIP]\n> **隐藏玩法**：对小爱同学说\"播放歌曲小猪佩奇的故事\"，会先下载小猪佩奇的故事，然后再播放。\n\n## 📦 安装方式\n\n### 方式一：Docker Compose（推荐）\n\n详见 [👋 快速入门指南](#-快速入门指南)\n\n### 方式二：Pip 安装\n\n```shell\n# 安装\npip install -U xiaomusic\n\n# 查看帮助\nxiaomusic --help\n\n# 启动（使用配置文件）\nxiaomusic --config config.json\n\n# 启动（使用默认端口 8090）\nxiaomusic\n```\n\n> [!NOTE]\n> `config.json` 文件可以参考 `config-example.json` 文件配置。详见 [#94](https://github.com/hanxi/xiaomusic/issues/94)\n\n## 👨‍💻 开发指南\n\n### 🔩 开发环境运行\n\n1. **下载依赖**\n ```shell\n ./install_dependencies.sh\n ```\n\n2. **安装环境**\n ```shell\n pdm install\n ```\n\n3. **启动服务**\n ```shell\n pdm run xiaomusic.py\n ```\n 默认监听端口 8090，使用其他端口请自行修改。\n\n4. **查看 API 文档**\n \n 访问 查看接口文档。\n\n> [!NOTE]\n> 目前的 web 控制台非常简陋，欢迎有兴趣的朋友帮忙实现一个漂亮的前端，需要什么接口可以随时提需求。\n\n### 🚦 代码提交规范\n\n提交前请执行以下命令检查代码和格式化代码：\n\n```shell\npdm lintfmt\n```\n\n### 🐳 本地编译 Docker Image\n\n```shell\ndocker build -t xiaomusic .\n```\n\n### 🛠️ 技术栈\n\n- **后端**：Python + FastAPI 框架\n- **容器化**：Docker\n- **前端**：jQuery\n\n## 📱 设备支持\n\n### 已测试支持的设备\n\n| 型号 | 设备名称 |\n|------|---------|\n| **L06A** | [小爱音箱](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l06a) |\n| **L07A** | [Redmi小爱音箱 Play](https://home.mi.com/webapp/content/baike/product/index.html?model=xiaomi.wifispeaker.l7a) |\n| **S12/S12A/MDZ-25-DA** | [小米AI音箱](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.s12) |\n| **LX5A** | [小爱音箱 万能遥控版](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx5a) |\n| **LX05** | [小爱音箱Play（2019款）](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx05) |\n| **L15A** | [小米AI音箱（第二代）](https://home.mi.com/webapp/content/baike/product/index.html?model=xiaomi.wifispeaker.l15a#/) |\n| **L16A** | [Xiaomi Sound](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l16a) |\n| **L17A** | [Xiaomi Sound Pro](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l17a) |\n| **LX06** | [小爱音箱Pro](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx06) |\n| **LX01** | [小爱音箱mini](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.lx01) |\n| **L05B** | [小爱音箱Play](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l05b) |\n| **L05C** | [小米小爱音箱Play 增强版](https://home.mi.com/baike/index.html#/detail?model=xiaomi.wifispeaker.l05c) |\n| **L09A** | [小米音箱Art](https://home.mi.com/webapp/content/baike/product/index.html?model=xiaomi.wifispeaker.l09a) |\n| **LX04/X10A/X08A** | 触屏版音箱 |\n| **X08C/X08E/X8F** | 触屏版音箱 |\n| **M01/XMYX01JY** | 小米小爱音箱HD |\n| **OH2P** | XIAOMI 智能音箱 Pro |\n| **OH2** | XIAOMI 智能音箱 |\n\n> [!NOTE]\n> - 型号与产品名称对照可在 [小米IoT平台](https://home.miot-spec.com/s/xiaomi.wifispeaker) 查询\n> - 如果你的设备支持播放，请反馈给我添加到支持列表里，谢谢\n> - 目前应该所有设备类型都已经支持播放，有问题可随时反馈\n\n### 🎵 支持音乐格式\n\n- **mp3** - 标准音频格式\n- **flac** - 无损音频格式\n- **wav** - 无损音频格式\n- **ape** - 无损音频格式\n- **ogg** - 开源音频格式\n- **m4a** - AAC 音频格式\n\n> [!NOTE]\n> - 本地音乐会搜索目录下上面格式的文件，下载的歌曲是 mp3 格式\n> - 已知 L05B、L05C、LX06、L16A 不支持 flac 格式\n> - 如果格式不能播放可以打开【转换为MP3】和【型号兼容模式】选项，详见 [#153](https://github.com/hanxi/xiaomusic/issues/153#issuecomment-2328168689)\n\n## 🌏 网络歌单功能\n\n可以配置一个 json 格式的歌单，支持电台和歌曲，也可以直接用别人分享的链接。同时配备了 m3u 文件格式转换工具，可以很方便地把 m3u 电台文件转换成网络歌单格式的 json 文件。\n\n详细用法见 [#78](https://github.com/hanxi/xiaomusic/issues/78)\n\n> [!NOTE]\n> 欢迎有想法的朋友们制作更多的歌单转换工具，一起完善项目功能！\n\n## ⚠️ 安全提醒\n\n> [!IMPORTANT]\n>\n> 1. 如果配置了公网访问 xiaomusic ，请一定要开启密码登陆，并设置复杂的密码。且不要在公共场所的 WiFi 环境下使用，否则可能造成小米账号密码泄露。\n> 2. 强烈不建议将小爱音箱的小米账号绑定摄像头，代码难免会有 bug ，一旦小米账号密码泄露，可能监控录像也会泄露。\n\n## 💬 社区与支持\n\n### 📢 讨论区\n\n

\n 💬 GitHub Issues •\n 🎮 QQ频道 •\n 👥 QQ交流群 •\n 💬 微信群\n

\n\n### 🤝 如何贡献\n\n我们欢迎所有形式的贡献，包括但不限于：\n\n- 🐛 **报告 Bug**：在 [Issues](https://github.com/hanxi/xiaomusic/issues) 中提交问题\n- 💡 **功能建议**：分享你的想法和建议\n- 📝 **改进文档**：帮助完善文档和教程\n- 🎨 **前端美化**：优化 Web 控制台界面\n- 🔧 **代码贡献**：提交 Pull Request\n\n> [!TIP]\n> 提交代码前请确保运行 `pdm lintfmt` 检查代码规范\n\n## 📚 相关资源\n\n### 👉 更多教程\n\n更多功能见 [📝 文档汇总](https://github.com/hanxi/xiaomusic/issues/211)\n\n### 🎨 第三方主题\n\n- [pure 主题 xiaomusicUI](https://github.com/52fisher/xiaomusicUI)\n- [移动端的播放器主题](https://github.com/52fisher/XMusicPlayer)\n- [Tailwind主题](https://github.com/clarencejh/xiaomusic)\n- [SoundScape主题](https://github.com/jhao0413/SoundScape)\n- [第三方主题](https://github.com/DarrenWen/xiaomusicui)\n\n### 📱 配套应用\n\n- [微信小程序: 卯卯音乐](https://github.com/F-loat/xiaoplayer)\n- [手机APP: 风花雪乐](https://github.com/jokezc/mi_music)\n- [JS在线播放插件](https://github.com/boluofan/xiaomusic-online)\n- [手机APP: HMusic](https://github.com/hpcll/HMusic)\n- [安卓TV: 肉肉音乐TV](https://github.com/GanHuaLin/rouroumusic-tv)\n\n### ❤️ 致谢\n\n**核心依赖**\n- [xiaomi](https://www.mi.com/) - 小米智能设备\n- [xiaogpt](https://github.com/yihong0618/xiaogpt) - 项目灵感来源\n- [MiService](https://github.com/yihong0618/MiService) - 小米服务接口\n- [yt-dlp](https://github.com/yt-dlp/yt-dlp) - 音乐下载工具\n\n**开发工具**\n- [PDM](https://pdm.fming.dev/latest/) - Python 包管理\n- [FastAPI](https://fastapi.tiangolo.com/) - Web 框架\n- [Umami](https://github.com/umami-software/umami) - 统计分析\n- [Sentry](https://github.com/getsentry/sentry) - 报错监控\n\n**参考资料**\n- [实现原理](https://github.com/yihong0618/gitblog/issues/258)\n- [awesome-xiaoai](https://github.com/zzz6519003/awesome-xiaoai)\n\n**特别感谢**\n- 所有帮忙调试和测试的朋友\n- 所有反馈问题和建议的朋友\n- 所有贡献代码和文档的开发者\n\n## 🚨 免责声明\n\n本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。\n本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。\n作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。\n使用本项目即表示您已阅读并同意本免责声明的全部内容。\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=hanxi/xiaomusic&type=Date)](https://star-history.com/#hanxi/xiaomusic&Date)\n\n## 💖 支持项目\n\n如果这个项目对你有帮助，欢迎通过以下方式支持：\n\n### ⭐ Star 项目\n点击右上角的 ⭐ Star 按钮，让更多人发现这个项目\n\n### 💰 赞赏支持\n- [💝 爱发电](https://afdian.com/a/imhanxi) - 持续支持项目发展\n- 扫码请作者喝杯奶茶 ☕\n\n

\n \"赞赏码\"\n

\n\n### 🎁 其他支持方式\n- 分享给更多需要的朋友\n- 提交 Bug 报告和功能建议\n- 贡献代码和文档\n\n---\n\n

\n 感谢你的支持！❤️\n

\n\n## License\n\n[MIT](https://github.com/hanxi/xiaomusic/blob/main/LICENSE) License © 2024 涵曦\n" }, { "path": "docs/package.json", "content": "{\n \"devDependencies\": {\n \"vitepress\": \"^1.6.4\"\n },\n \"scripts\": {\n \"docs:dev\": \"vitepress dev --host=0.0.0.0 --port=3030\",\n \"docs:build\": \"vitepress build\",\n \"docs:preview\": \"vitepress preview\"\n },\n \"dependencies\": {\n \"axios\": \"^1.7.9\",\n \"vite-plugin-vitepress-auto-sidebar\": \"^1.7.0\"\n }\n}\n" }, { "path": "get_release.py", "content": "import json\nimport os\n\nimport requests\n\n# 替换为你的 GitHub 仓库信息\nGITHUB_OWNER = \"hanxi\"\nGITHUB_REPO = \"xiaomusic\"\nGITHUB_API_URL = f\"https://api.github.com/repos/{GITHUB_OWNER}/{GITHUB_REPO}/releases\"\n\n\ndef fetch_releases():\n headers = {}\n github_token = os.getenv(\"GITHUB_TOKEN\")\n if github_token:\n headers[\"Authorization\"] = f\"token {github_token}\"\n\n try:\n response = requests.get(GITHUB_API_URL, headers=headers)\n response.raise_for_status()\n return response.json()\n except requests.RequestException as e:\n print(f\"请求 GitHub API 失败: {e}\")\n return []\n\n\ndef extract_tar_gz_files(releases):\n versions = []\n for release in releases:\n version = release.get(\"tag_name\")\n if not version:\n continue\n\n files = []\n for asset in release.get(\"assets\", []):\n if asset.get(\"name\", \"\").endswith(\".tar.gz\"):\n files.append(asset[\"name\"])\n\n if files:\n versions.append({\"version\": version, \"files\": files})\n return versions\n\n\ndef save_to_json(data, filename=\"versions.json\"):\n try:\n with open(filename, \"w\") as f:\n json.dump(data, f, indent=4)\n print(f\"数据已保存到 {filename}\")\n except OSError as e:\n print(f\"保存文件失败: {e}\")\n\n\ndef main():\n releases = fetch_releases()\n if not releases:\n print(\"未获取到任何 release 数据\")\n return\n\n versions = extract_tar_gz_files(releases)\n save_to_json(versions, \"docs/.vitepress/dist/versions.json\")\n\n\nif __name__ == \"__main__\":\n main()\n" }, { "path": "holiday/2007.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2007.json\",\n \"year\": 2007,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2008-03/28/content_1761.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2006-12-30\",\n \"isOffDay\": false\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2006-12-31\",\n \"isOffDay\": false\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2007-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2007-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2007-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-17\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-18\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2007-02-25\",\n \"isOffDay\": false\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-04-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-04-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”\",\n \"date\": \"2007-05-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-09-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-09-30\",\n \"isOffDay\": false\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“十一”\",\n \"date\": \"2007-10-07\",\n \"isOffDay\": true\n }\n ]\n}" }, { "path": "holiday/2008.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2008.json\",\n \"year\": 2008,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2008-03/28/content_1645.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2007-12-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2007-12-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2007-12-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2008-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-02\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-03\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-09\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2008-02-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2008-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2008-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2008-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”国际劳动节\",\n \"date\": \"2008-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”国际劳动节\",\n \"date\": \"2008-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”国际劳动节\",\n \"date\": \"2008-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"“五一”国际劳动节\",\n \"date\": \"2008-05-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2008-06-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2008-06-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2008-06-09\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2008-09-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2008-09-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2008-09-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-09-27\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-09-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-09-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-09-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2008-10-05\",\n \"isOffDay\": true\n }\n ]\n}" }, { "path": "holiday/2009.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2009.json\",\n \"year\": 2009,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2008-12/10/content_1572.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2009-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2009-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2009-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2009-01-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-24\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-25\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-26\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-01-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2009-02-01\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2009-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2009-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2009-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2009-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2009-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2009-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2009-05-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2009-05-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2009-05-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2009-05-31\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-09-27\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2009-10-10\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2010.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2010.json\",\n \"year\": 2010,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2009-12/08/content_1476.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2010-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2010-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2010-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-18\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-20\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2010-02-21\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2010-04-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2010-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2010-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2010-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2010-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2010-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2010-06-12\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2010-06-13\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2010-06-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2010-06-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2010-06-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2010-09-19\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2010-09-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2010-09-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2010-09-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2010-09-25\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-09-26\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2010-10-09\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2011.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2011.json\",\n \"year\": 2011,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2010-12/10/content_1423.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2011-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2011-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2011-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-01-30\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2011-02-12\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2011-04-02\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2011-04-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2011-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2011-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2011-04-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2011-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2011-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2011-06-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2011-06-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2011-06-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2011-09-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2011-09-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2011-09-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2011-10-09\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2012.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2012.json\",\n \"year\": 2012,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2011-12/06/content_1411.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2011-12-31\",\n \"isOffDay\": false\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2012-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2012-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2012-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-21\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-25\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-26\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2012-01-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2012-03-31\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2012-04-01\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2012-04-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2012-04-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2012-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2012-04-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2012-04-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2012-04-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2012-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2012-06-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2012-06-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2012-06-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-09-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-09-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2012-10-07\",\n \"isOffDay\": true\n }\n ]\n}" }, { "path": "holiday/2013.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2013.json\",\n \"year\": 2013,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2012-12/10/content_1353.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2013-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2013-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2013-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2013-01-05\",\n \"isOffDay\": false\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2013-01-06\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-09\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-16\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2013-02-17\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2013-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2013-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2013-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2013-04-07\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2013-04-27\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2013-04-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2013-04-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2013-04-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2013-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2013-06-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2013-06-09\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2013-06-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2013-06-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2013-06-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2013-09-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2013-09-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2013-09-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2013-09-22\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-09-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2013-10-12\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2014.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2014.json\",\n \"year\": 2014,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2014-01/02/content_1194.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2014-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-01-26\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-01-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2014-02-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2014-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2014-04-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2014-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2014-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2014-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2014-05-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2014-06-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2014-09-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-09-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2014-10-11\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2015.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2015.json\",\n \"year\": 2015,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2014-12/16/content_9302.htm\",\n \"http://www.gov.cn/zhengce/zhengceku/2015-05/13/content_9742.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2015-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2015-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2015-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2015-01-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-15\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-18\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2015-02-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2015-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2015-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2015-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2015-06-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2015-06-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"抗日战争暨世界反法西斯战争胜利70周年纪念日\",\n \"date\": \"2015-09-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"抗日战争暨世界反法西斯战争胜利70周年纪念日\",\n \"date\": \"2015-09-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"抗日战争暨世界反法西斯战争胜利70周年纪念日\",\n \"date\": \"2015-09-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"抗日战争暨世界反法西斯战争胜利70周年纪念日\",\n \"date\": \"2015-09-06\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2015-09-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2015-10-10\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2016.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2016.json\",\n \"year\": 2016,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2015-12/10/content_10394.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2016-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-06\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-09\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2016-02-14\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2016-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2016-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2016-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2016-06-09\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2016-06-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2016-06-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2016-06-12\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2016-09-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2016-09-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2016-09-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2016-09-18\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2016-10-09\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2017.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2017.json\",\n \"year\": 2017,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2016-12/01/content_5141603.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2017-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2017-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-01-22\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-01-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-01-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-01-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-01-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-01-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-02-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-02-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2017-02-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2017-04-01\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2017-04-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2017-04-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2017-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2017-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2017-05-27\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2017-05-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2017-05-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2017-05-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-09-30\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2017-10-08\",\n \"isOffDay\": true\n }\n ]\n}" }, { "path": "holiday/2018.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2018.json\",\n \"year\": 2018,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2017-11/30/content_5243579.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2018-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-11\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-18\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2018-02-24\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2018-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2018-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2018-04-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2018-04-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2018-04-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2018-04-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2018-04-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2018-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2018-06-18\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2018-09-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-09-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-09-30\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2018-10-07\",\n \"isOffDay\": true\n }\n ]\n}" }, { "path": "holiday/2019.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2019.json\",\n \"year\": 2019,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2018-12/06/content_5346276.htm\",\n \"http://www.gov.cn/zhengce/zhengceku/2019-03/22/content_5375877.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2018-12-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2018-12-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2018-12-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2019-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-02\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-03\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-09\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2019-02-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2019-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2019-04-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2019-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2019-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2019-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2019-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2019-05-05\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2019-06-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2019-09-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-09-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2019-10-12\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2020.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2020.json\",\n \"year\": 2020,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2019-11/21/content_5454164.htm\",\n \"http://www.gov.cn/zhengce/zhengceku/2020-01/27/content_5472352.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2020-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-19\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-25\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-26\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-01-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-02-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-02-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2020-02-03\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2020-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2020-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2020-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-04-26\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-05-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2020-05-09\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2020-06-25\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2020-06-26\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2020-06-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2020-06-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-09-27\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2020-10-10\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2021.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2021.json\",\n \"year\": 2021,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2020-11/25/content_5564127.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2021-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2021-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2021-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-07\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2021-02-20\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2021-04-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2021-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2021-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-04-25\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-05-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2021-05-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2021-06-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2021-06-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2021-06-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2021-09-18\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2021-09-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2021-09-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2021-09-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-09-26\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2021-10-09\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2022.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2022.json\",\n \"year\": 2022,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2021-10/25/content_5644835.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2022-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2022-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2022-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-01-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-01-30\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-01-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-02-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-02-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-02-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-02-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-02-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2022-02-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2022-04-02\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2022-04-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2022-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2022-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-04-24\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-04-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2022-05-07\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2022-06-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2022-06-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2022-06-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2022-09-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2022-09-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2022-09-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2022-10-09\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2023.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2023.json\",\n \"year\": 2023,\n \"papers\": [\n \"http://www.gov.cn/zhengce/zhengceku/2022-12/08/content_5730844.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2022-12-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2023-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2023-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-25\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-26\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2023-01-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2023-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-04-23\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-04-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-04-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2023-05-06\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2023-06-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2023-06-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2023-06-24\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2023-06-25\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-09-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-09-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-07\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节、国庆节\",\n \"date\": \"2023-10-08\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2024.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2024.json\",\n \"year\": 2024,\n \"papers\": [\n \"https://www.gov.cn/zhengce/zhengceku/202310/content_6911528.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2024-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-11\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-12\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-13\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-14\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2024-02-18\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2024-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2024-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2024-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2024-04-07\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-04-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-05-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2024-05-11\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2024-06-10\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2024-09-14\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2024-09-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2024-09-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2024-09-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-09-29\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2024-10-12\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2025.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2025.json\",\n \"year\": 2025,\n \"papers\": [\n \"https://www.gov.cn/zhengce/zhengceku/202411/content_6986383.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2025-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-01-26\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-01-28\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-01-29\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-01-30\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-01-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-02-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-02-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-02-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-02-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2025-02-08\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2025-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2025-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2025-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2025-04-27\",\n \"isOffDay\": false\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2025-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2025-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2025-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2025-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2025-05-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2025-05-31\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2025-06-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2025-06-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-09-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-08\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节、中秋节\",\n \"date\": \"2025-10-11\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2026.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2026.json\",\n \"year\": 2026,\n \"papers\": [\n \"https://www.gov.cn/zhengce/zhengceku/202511/content_7047091.htm\"\n ],\n \"days\": [\n {\n \"name\": \"元旦\",\n \"date\": \"2026-01-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2026-01-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2026-01-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"元旦\",\n \"date\": \"2026-01-04\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-14\",\n \"isOffDay\": false\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-15\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-16\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-17\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-18\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-22\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-23\",\n \"isOffDay\": true\n },\n {\n \"name\": \"春节\",\n \"date\": \"2026-02-28\",\n \"isOffDay\": false\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2026-04-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2026-04-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"清明节\",\n \"date\": \"2026-04-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2026-05-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2026-05-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2026-05-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2026-05-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2026-05-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"劳动节\",\n \"date\": \"2026-05-09\",\n \"isOffDay\": false\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2026-06-19\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2026-06-20\",\n \"isOffDay\": true\n },\n {\n \"name\": \"端午节\",\n \"date\": \"2026-06-21\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-09-20\",\n \"isOffDay\": false\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2026-09-25\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2026-09-26\",\n \"isOffDay\": true\n },\n {\n \"name\": \"中秋节\",\n \"date\": \"2026-09-27\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-01\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-02\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-03\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-04\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-05\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-06\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-07\",\n \"isOffDay\": true\n },\n {\n \"name\": \"国庆节\",\n \"date\": \"2026-10-10\",\n \"isOffDay\": false\n }\n ]\n}" }, { "path": "holiday/2027.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/2027.json\",\n \"year\": 2027,\n \"papers\": [],\n \"days\": []\n}" }, { "path": "holiday/renovate.json", "content": "{\n \"extends\": [\n \"config:best-practices\",\n \":automergeMinor\",\n \":disableDependencyDashboard\"\n ]\n}\n" }, { "path": "holiday/schema.json", "content": "{\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n \"$id\": \"https://raw.githubusercontent.com/NateScarlet/holiday-cn/master/schema.json\",\n \"type\": \"object\",\n \"properties\": {\n \"year\": {\n \"type\": \"number\",\n \"description\": \"年份\"\n },\n \"papers\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"所用国务院文件网址列表\"\n },\n \"days\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"name\": { \"type\": \"string\", \"description\": \"节日名称\" },\n \"date\": { \"type\": \"string\", \"description\": \"ISO 8601 日期\" },\n \"isOffDay\": { \"type\": \"boolean\", \"description\": \"是否为休息日\" }\n },\n \"required\": [\"name\", \"date\", \"isOffDay\"]\n }\n }\n },\n \"required\": [\"year\", \"papers\", \"days\"]\n}\n" }, { "path": "install_dependencies.sh", "content": "#!/bin/bash\n\n# yt-dlp 依赖 ffmpeg\n# https://github.com/yt-dlp/yt-dlp#dependencies\n\n# 判断系统架构\narch=$(uname -m)\n\n# 输出架构信息\necho \"当前系统架构是：$arch\"\n\ninstall_from_github() {\n\tpkg=$1\n\twget https://github.com/yt-dlp/FFmpeg-Builds/releases/download/latest/$pkg.tar.xz\n\ttar -xvJf $pkg.tar.xz\n\tmkdir -p ffmpeg/bin\n\tmv $pkg/bin/ffmpeg ffmpeg/bin/\n\tmv $pkg/bin/ffprobe ffmpeg/bin/\n \trm -rf $pkg $pkg.tar.xz\n}\n\ninstall_from_ffmpeg() {\n\tpkg=$1\n\twget https://johnvansickle.com/ffmpeg/builds/$pkg.tar.xz\n\tmkdir -p $pkg\n\ttar -xvJf $pkg.tar.xz -C $pkg\n\tmkdir -p ffmpeg/bin\n\tmv $pkg/*/ffmpeg ffmpeg/bin/\n\tmv $pkg/*/ffprobe ffmpeg/bin/\n \trm -rf $pkg $pkg.tar.xz\n}\n\n# 基于架构执行不同的操作\ncase \"$arch\" in\nx86_64)\n\techo \"64位 x86 架构\"\n\tinstall_from_github ffmpeg-master-latest-linux64-gpl\n\t#install_from_ffmpeg ffmpeg-git-amd64-static\n\t;;\narm64 | aarch64)\n\techo \"64位 ARM 架构\"\n\tinstall_from_github ffmpeg-master-latest-linuxarm64-gpl\n\t#install_from_ffmpeg ffmpeg-git-arm64-static\n\t;;\narmv7l)\n\techo \"armv7l 架构\"\n\tinstall_from_ffmpeg ffmpeg-git-armhf-static\n\t;;\n*)\n\techo \"未知架构 $arch\"\n\t;;\nesac\n" }, { "path": "newpatch.sh", "content": "#!/bin/bash\n\n./update-static-version.py\n./update-holiday.sh\ngit add xiaomusic/static\ngit commit -m 'build: update static version'\ngit pull --rebase\n\ncz bump --check-consistency --increment patch\n\ngit push\ngit push --tags\n" }, { "path": "newversion.sh", "content": "#!/bin/bash\n\n./update-static-version.py\n./update-holiday.sh\ngit add xiaomusic/static\ngit commit -m 'build: update static version'\ngit pull --rebase\n\ncz bump --check-consistency\n\ngit push\ngit push --tags\n" }, { "path": "package.json", "content": "{\n \"name\": \"xiaomusic-js-plugins\",\n \"version\": \"1.0.0\",\n \"description\": \"JS plugins for xiaomusic\",\n \"main\": \"xiaomusic/js_plugin_runner.js\",\n \"dependencies\": {\n \"axios\": \"^1.6.0\",\n \"big-integer\": \"^1.6.52\",\n \"cheerio\": \"^1.0.0-rc.12\",\n \"crypto-js\": \"^4.2.0\",\n \"dayjs\": \"^1.11.10\",\n \"he\": \"^1.2.0\",\n \"qs\": \"^6.14.0\"\n }\n}\n" }, { "path": "plugins/__init__.py", "content": "" }, { "path": "plugins/code1.py", "content": "async def code1(arg1):\n global log, xiaomusic\n log.info(f\"code1:{arg1}\")\n did = xiaomusic.get_cur_did()\n await xiaomusic.do_tts(did, \"你好，我是自定义的测试口令\")\n\n query = xiaomusic.command_handler.last_cmd.strip()\n await xiaomusic.do_tts(did, f\"你说的是: {query}\")\n" }, { "path": "plugins/httpget.py", "content": "import requests\n\n\ndef httpget(url):\n global log\n\n # 发起请求\n response = requests.get(url, timeout=5) # 增加超时以避免长时间挂起\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\n log.info(f\"httpget url:{url} response:{response.text}\")\n" }, { "path": "plugins/httppost.py", "content": "import requests\n\ntarget = \"HTTP://192.168.1.10:58091/items/\"\n\n\ndef httppost(data, url=target):\n global log\n # 发起请求,\n with requests.post(\n url, json=data, timeout=5\n ) as response: # 增加超时以避免长时间挂起\n response.raise_for_status() # 如果响应不是200，引发HTTPError异常\n log.info(f\"httppost url:{url} data :{data} response:{response.text}\")\n" }, { "path": "pyproject.toml", "content": "[project]\nname = \"xiaomusic\"\nversion = \"0.4.26\"\ndescription = \"Play Music with xiaomi AI speaker\"\nauthors = [\n{name = \"涵曦\", email = \"im.hanxi@gmail.com\"},\n]\ndependencies = [\n \"aiohttp>=3.8.6\",\n \"watchdog>=6.0.0\",\n \"mutagen>=1.47.0\",\n \"yt-dlp[default]>=2024.12.1.232904.dev0\",\n \"uvicorn>=0.30.1\",\n \"fastapi>=0.115.4\",\n \"starlette>=0.37.2\",\n \"aiofiles>=24.1.0\",\n \"ga4mp>=2.0.4\",\n \"apscheduler>=3.10.4\",\n \"opencc-python-reimplemented==0.1.7\",\n \"pillow>=10.4.0\",\n \"python-multipart>=0.0.12\",\n \"requests>=2.32.3\",\n \"sentry-sdk[fastapi]==1.45.1\",\n \"pyjwt>=2.10.1\",\n \"fake-useragent>=2.2.0\",\n \"miservice-fork\",\n \"edge-tts>=7.2.3\",\n \"psutil>=5.9.0\",\n \"pycryptodome>=3.23.0\",\n \"qrcode>=8.2\"\n]\nrequires-python = \">=3.10\"\nreadme = \"README.md\"\nlicense = {text = \"MIT\"}\n\n[project.urls]\nHomepage = \"https://github.com/hanxi/xiaomusic\"\n\n[project.scripts]\nxiaomusic = \"xiaomusic.cli:main\"\n\n[build-system]\nrequires = [\"pdm-backend\"]\nbuild-backend = \"pdm.backend\"\n\n[tool.pdm]\n[tool.pdm.dev-dependencies]\nlint = [\n \"ruff>=0.4.8\",\n]\ndev = [\n \"commitizen>=3.27.0\",\n]\n[tool.ruff]\nlint.select = [\n \"B\", # flake8-bugbear\n \"C4\", # flake8-comprehensions\n \"E\", # pycodestyle - Error\n \"F\", # Pyflakes\n \"I\", # isort\n \"W\", # pycodestyle - Warning\n \"UP\", # pyupgrade\n]\nlint.ignore = [\n \"E501\", # line-too-long\n \"W191\", # tab-indentation\n]\ninclude = [\"**/*.py\", \"**/*.pyi\", \"**/pyproject.toml\"]\n\n[tool.ruff.lint.pydocstyle]\nconvention = \"google\"\n\n[tool.ruff.lint.flake8-bugbear]\nextend-immutable-calls = [\n \"fastapi.Depends\",\n \"fastapi.params.Depends\",\n \"fastapi.Query\",\n \"fastapi.params.Query\",\n \"fastapi.File\"\n]\n\n[tool.pdm.scripts]\nlint = \"ruff check . --exclude MiService\"\nfmt = \"ruff format . --exclude MiService\"\nlintfmt = {composite = [\"ruff check --fix . --exclude MiService\", \"ruff format . --exclude MiService\"]}\n\n[tool.commitizen]\nname = \"cz_conventional_commits\"\ntag_format = \"v$version\"\nversion_scheme = \"pep440\"\nversion_provider = \"pep621\"\nupdate_changelog_on_bump = true\nmajor_version_zero = true\nversion_files = [\n \"xiaomusic/__init__.py\",\n]\n" }, { "path": "test/test_difflib.py", "content": "import difflib\n\nfrom xiaomusic.utils.text_utils import find_best_match, keyword_detection\n\nif __name__ == \"__main__\":\n user_input = \"八年的爱\"\n s1 = \"冰冰超人 - 八年的爱新版\"\n s2 = \"冰冰超人 - 八年的爱\"\n r1 = difflib.SequenceMatcher(None, s1, user_input).ratio()\n r2 = difflib.SequenceMatcher(None, s2, user_input).ratio()\n print(s1, r1)\n print(s2, r2)\n\n s3 = \"其他\"\n str_list = [s2, s1, s3]\n matches, remains = keyword_detection(user_input, str_list, n=10)\n print(matches, remains)\n\n extra_search_index = {}\n extra_search_index[\"1\"] = s1\n extra_search_index[\"2\"] = s2\n extra_search_index[\"3\"] = s3\n real_names = find_best_match(\n user_input,\n str_list,\n cutoff=0.4,\n n=100,\n extra_search_index=extra_search_index,\n )\n print(real_names)\n" }, { "path": "test/test_music_duration.py", "content": "import math\n\nfrom xiaomusic.const import SUPPORT_MUSIC_TYPE\nfrom xiaomusic.utils.file_utils import traverse_music_directory\nfrom xiaomusic.utils.music_utils import get_local_music_duration\n\n\nasync def test_one_music(filename):\n # 获取播放时长\n duration = await get_local_music_duration(filename)\n sec = math.ceil(duration)\n print(f\"本地歌曲 : {filename} 的时长 {duration} {sec} 秒\")\n\n\nasync def main(directory):\n # 获取所有歌曲文件\n local_musics = traverse_music_directory(directory, 10, [], SUPPORT_MUSIC_TYPE)\n print(local_musics)\n for _, files in local_musics.items():\n for file in files:\n await test_one_music(file)\n\n\nif __name__ == \"__main__\":\n import asyncio\n\n directory = \"./music\" # 替换为你的音乐目录路径\n asyncio.run(main(directory))\n" }, { "path": "test/test_music_tags.py", "content": "import traceback\n\nfrom xiaomusic.const import SUPPORT_MUSIC_TYPE\nfrom xiaomusic.utils.file_utils import traverse_music_directory\nfrom xiaomusic.utils.music_utils import extract_audio_metadata\n\n# title 标题\n# artist 艺术家\n# album 影集\n# year 年\n# genre 性\n# picture 图片\n# lyrics 歌词\n\n\nasync def test_one_music(filename):\n # 获取播放时长\n try:\n metadata = extract_audio_metadata(filename, \"cache/picture_cache\")\n print(metadata)\n except Exception as e:\n print(f\"歌曲 : {filename} no tag {e}\")\n traceback.print_exc()\n\n\nasync def main(directory):\n # 获取所有歌曲文件\n local_musics = traverse_music_directory(directory, 10, [], SUPPORT_MUSIC_TYPE)\n for _, files in local_musics.items():\n for file in files:\n print(file)\n # await test_one_music(file)\n pass\n\n await test_one_music(\"music/4 In Love - 一千零一个愿望.mp3\")\n # await test_one_music(\"./music/程响-人间烟火.flac\")\n\n\nif __name__ == \"__main__\":\n import asyncio\n\n directory = \"./music\" # 替换为你的音乐目录路径\n asyncio.run(main(directory))\n" }, { "path": "test/test_remove_common_prefix.py", "content": "import re\n\n\ndef removepre(filename):\n match = re.search(r\"^[pP]?(\\d+)\\s+\\d*(.+?)\\.(.*$)\", filename.strip())\n new_filename = filename\n if match:\n num = match.group(1)\n name = match.group(2).replace(\".\", \" \").strip()\n suffix = match.group(3)\n # print(name)\n # print(num)\n # print(suffix)\n new_filename = f\"{num}.{name}.{suffix}\"\n\n print(filename, \"=>\", new_filename)\n\n\nif __name__ == \"__main__\":\n removepre(\" 17 《白色风车》.mp3\")\n removepre(\" 17 《白色风车》.mp3\")\n removepre(\" 17 17 《白色风车》.mp3\")\n removepre(\" 17 17 《白色风车》.mp3\")\n\n removepre(\" 18 风车.mp3\")\n removepre(\" 18 色风车.mp3\")\n removepre(\" 18 18 你好.mp3\")\n removepre(\" 18 18 我好.mp3\")\n removepre(\"p09 009. 梁静茹-亲亲.mp3\")\n" }, { "path": "test/test_update.py", "content": "from xiaomusic.utils.system_utils import download_and_extract\n\nif __name__ == \"__main__\":\n import asyncio\n\n url = \"https://github.hanxi.cc/proxy/hanxi/xiaomusic/releases/download/main/app-amd64-lite.tar.gz\"\n target_directory = \"./tmp/app\"\n asyncio.run(download_and_extract(url, target_directory))\n" }, { "path": "update-holiday.sh", "content": "#!/bin/bash\n\nrm -rf holiday-cn\ngit clone https://github.com/NateScarlet/holiday-cn.git\nmkdir -p holiday\ncp holiday-cn/*.json holiday/\nrm -rf holiday-cn\n" }, { "path": "update-static-version.py", "content": "#!/usr/bin/env python3\n\nimport re\nfrom pathlib import Path\n\n\ndef get_html_files(directory):\n \"\"\"\n 获取指定目录下所有HTML文件的列表。\n\n :param directory: 搜索HTML文件的目录。\n :return: 搜索到的HTML文件的路径列表。\n \"\"\"\n return list(Path(directory).rglob(\"*.html\"))\n\n\ndef update_html_version(html_files, version):\n \"\"\"\n 更新HTML文件中所有以 ./ 开头的CSS和JS文件引用的版本号。\n\n :param html_files: 需要更新的HTML文件路径的列表。\n :param version: 新的版本号字符串。\n \"\"\"\n pattern = re.compile(r'(\\./.*(css|js))\\?version=[^\"]*\"')\n\n for html_file in html_files:\n if not html_file.exists():\n print(f\"文件 {html_file} 不存在。\")\n continue\n\n html_content = html_file.read_text()\n\n # 更新CSS和JS版本号\n html_content = pattern.sub(rf'\\g<1>?version={version}\"', html_content)\n # html_content = pattern.sub(fr'\\g<1>\"', html_content)\n\n # 保存更改到HTML文件\n html_file.write_text(html_content)\n\n print(f\"文件 {html_file} 已更新为使用新的版本号: {version}\")\n\n\n# 使用案例\nif __name__ == \"__main__\":\n import time\n\n t = str(int(time.time()))\n\n # 指定目录\n html_directory = \"xiaomusic/static/default\" # 修改为实际的HTML文件目录路径\n\n # 获取HTML文件列表\n html_files_to_update = get_html_files(html_directory)\n\n # 执行更新\n update_html_version(html_files_to_update, t)\n" }, { "path": "xiaomusic/__init__.py", "content": "__version__ = \"0.4.26\"\n" }, { "path": "xiaomusic/analytics.py", "content": "import asyncio\nimport copy\nimport platform\nimport traceback\nfrom datetime import datetime\n\nimport aiohttp\nfrom ga4mp import GtagMP\n\nfrom xiaomusic import __version__\n\nMAX_PARAM_LENGTH = 100\n\n\nclass Analytics:\n def __init__(self, log, config):\n self.gtag = None\n self.current_date = None\n self.log = log\n self.config = config\n self.init()\n\n def init(self):\n if self.gtag is not None:\n return\n\n gtag = GtagMP(\n api_secret=\"sVRsf3T9StuWc-ZiWZxDVA\",\n measurement_id=\"G-Z09NC1K7ZW\",\n client_id=\"\",\n )\n gtag.client_id = gtag.random_client_id()\n gtag.store.set_user_property(name=\"version\", value=__version__)\n self.gtag = gtag\n self.log.info(\"analytics init ok\")\n\n async def send_startup_event(self):\n event = self.gtag.create_new_event(name=\"startup\")\n event.set_event_param(name=\"version\", value=__version__)\n await self._send(event)\n\n async def send_daily_event(self):\n current_date = datetime.now().strftime(\"%Y-%m-%d\")\n if self.current_date == current_date:\n return\n\n event = self.gtag.create_new_event(name=\"daily_active_user\")\n event.set_event_param(name=\"version\", value=__version__)\n event.set_event_param(name=\"date\", value=current_date)\n await self._send(event)\n self.current_date = current_date\n\n async def send_play_event(self, name, sec, hardware):\n event = self.gtag.create_new_event(name=\"play\")\n event.set_event_param(name=\"version\", value=__version__)\n truncated_name = name[:MAX_PARAM_LENGTH]\n event.set_event_param(name=\"music\", value=truncated_name)\n event.set_event_param(name=\"sec\", value=sec)\n event.set_event_param(name=\"hardware\", value=hardware)\n await self._send(event)\n\n async def _send(self, event):\n if self.config.enable_analytics:\n # asyncio.create_task(self.post_to_umami(event))\n await self.run_with_cancel(self._google_send, [event])\n else:\n self.log.info(\"analytics is disabled, skip sending event\")\n\n def _google_send(self, events):\n try:\n self.gtag.send(events)\n except Exception as e:\n self.log.warning(f\"google analytics run_with_cancel failed {e}\")\n\n async def run_with_cancel(self, func, *args, **kwargs):\n try:\n asyncio.create_task(asyncio.to_thread(func, *args, **kwargs))\n self.log.info(\"analytics run_with_cancel success\")\n except Exception as e:\n self.log.warning(f\"analytics run_with_cancel failed {e}\")\n return None\n\n async def post_to_umami(self, event):\n try:\n url = \"https://umami.hanxi.cc/api/send\"\n user_agent = self._get_user_agent()\n params = copy.copy(event.get_event_params())\n params[\"useragent\"] = user_agent\n data = {\n \"payload\": {\n \"hostname\": self.config.hostname,\n \"language\": \"zh-CN\",\n \"referrer\": \"\",\n \"screen\": \"430x932\",\n \"title\": \"后端统计\",\n \"url\": \"/backend\",\n \"website\": \"7bfb0890-4115-4260-8892-b391513e7e99\",\n \"name\": event.get_event_name(),\n \"data\": params,\n },\n \"type\": \"event\",\n }\n\n self.log.info(f\"umami data: {data}\")\n async with aiohttp.ClientSession() as session:\n headers = {\n \"User-Agent\": user_agent,\n }\n # self.log.info(f\"headers {headers}, {data}\")\n async with session.post(url, json=data, headers=headers) as response:\n self.log.info(f\"umami Status: {response.status}\")\n await response.text()\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n def _get_user_agent(self):\n try:\n # 获取系统信息\n os_name = platform.system() # 操作系统名称，如 'Windows', 'Linux', 'Darwin'\n os_version = platform.version() # 操作系统版本号\n architecture = \"unknow\"\n try:\n architecture = platform.architecture()[0] # '32bit' or '64bit'\n except Exception as e:\n architecture = f\"Error {e}\"\n pass\n machine = platform.machine() # 机器类型，如 'x86_64', 'arm64'\n\n # 获取 Python 版本信息\n python_version = platform.python_version() # Python 版本\n\n # 组合 User-Agent 字符串\n user_agent = (\n f\"XiaoMusic/{__version__} \"\n f\"({os_name} {os_version}; {architecture}; {machine}) \"\n f\"Python/{python_version}\"\n )\n except Exception as e:\n # 获取报错的堆栈信息\n error_info = traceback.format_exc()\n user_agent = f\"Error: {e} {error_info}\"\n\n return user_agent\n" }, { "path": "xiaomusic/api/__init__.py", "content": "\"\"\"API 模块统一入口\"\"\"\n\nfrom xiaomusic.api.app import (\n HttpInit,\n app,\n)\n\n__all__ = [\"app\", \"HttpInit\"]\n" }, { "path": "xiaomusic/api/app.py", "content": "\"\"\"FastAPI 应用实例和中间件配置\"\"\"\n\nimport asyncio\nimport os\nfrom contextlib import asynccontextmanager\nfrom typing import TYPE_CHECKING\n\nfrom fastapi import FastAPI\nfrom fastapi.middleware.cors import CORSMiddleware\nfrom starlette.middleware.gzip import GZipMiddleware\n\nfrom xiaomusic import __version__\nfrom xiaomusic.api.dependencies import (\n AuthStaticFiles,\n reset_http_server,\n)\n\nif TYPE_CHECKING:\n from xiaomusic.xiaomusic import XiaoMusic\n\n# 导入内部状态管理器\nfrom xiaomusic.api.dependencies import _state\n\n\n@asynccontextmanager\nasync def app_lifespan(app):\n \"\"\"应用生命周期管理\"\"\"\n task = None\n if _state.is_initialized():\n task = asyncio.create_task(_state._xiaomusic.run_forever())\n try:\n yield\n except asyncio.CancelledError:\n # 正常关闭时的取消，不需要记录\n pass\n finally:\n # 关闭时取消后台任务\n if task is not None and not task.done():\n task.cancel()\n try:\n await task\n except asyncio.CancelledError:\n if _state.is_initialized():\n _state._log.info(\"Background task cleanup: CancelledError\")\n except Exception as e:\n if _state.is_initialized():\n _state._log.error(f\"Background task cleanup error: {e}\")\n\n\n# 创建 FastAPI 应用实例\napp = FastAPI(\n lifespan=app_lifespan,\n version=__version__,\n docs_url=None,\n redoc_url=None,\n openapi_url=None,\n)\n\n# 添加 CORS 中间件\napp.add_middleware(\n CORSMiddleware,\n allow_origins=[\"*\"], # 允许访问的源\n allow_credentials=False, # 支持 cookie\n allow_methods=[\"*\"], # 允许使用的请求方法\n allow_headers=[\"*\"], # 允许携带的 Headers\n)\n\n# 添加 GZip 中间件\napp.add_middleware(GZipMiddleware, minimum_size=500)\n\n\ndef HttpInit(_xiaomusic: \"XiaoMusic\"):\n \"\"\"初始化 HTTP 服务器\n\n Args:\n _xiaomusic: XiaoMusic 实例\n \"\"\"\n # 初始化应用状态\n _state.initialize(_xiaomusic)\n\n # 挂载静态文件\n folder = os.path.dirname(os.path.dirname(__file__)) # xiaomusic 目录\n app.mount(\"/static\", AuthStaticFiles(directory=f\"{folder}/static\"), name=\"static\")\n\n # 注册所有路由\n from xiaomusic.api.routers import register_routers\n\n register_routers(app)\n\n # 重置 HTTP 服务器配置\n reset_http_server(app)\n" }, { "path": "xiaomusic/api/dependencies.py", "content": "\"\"\"依赖注入和认证相关功能\"\"\"\n\nimport hashlib\nimport secrets\nfrom typing import (\n TYPE_CHECKING,\n Annotated,\n)\n\nfrom fastapi import (\n Depends,\n HTTPException,\n Request,\n status,\n)\nfrom fastapi.security import (\n HTTPBasic,\n HTTPBasicCredentials,\n)\nfrom fastapi.staticfiles import StaticFiles\n\nif TYPE_CHECKING:\n import logging\n\n from xiaomusic.config import Config\n from xiaomusic.xiaomusic import XiaoMusic\n\nsecurity = HTTPBasic()\n\n\nclass _AppStateProxy:\n \"\"\"应用状态代理类\n\n 提供类似全局变量的访问方式，但实际上是动态获取的。\n 这样既保持了代码的简洁性，又避免了真正的全局变量。\n \"\"\"\n\n def __init__(self):\n self._xiaomusic: XiaoMusic | None = None\n self._config: Config | None = None\n self._log: logging.Logger | None = None\n\n def initialize(self, xiaomusic_instance: \"XiaoMusic\"):\n \"\"\"初始化应用状态\n\n Args:\n xiaomusic_instance: XiaoMusic 实例\n \"\"\"\n self._xiaomusic = xiaomusic_instance\n self._config = xiaomusic_instance.config\n self._log = xiaomusic_instance.log\n\n def is_initialized(self) -> bool:\n \"\"\"检查是否已初始化\"\"\"\n return self._xiaomusic is not None\n\n\n# 创建内部状态管理器\n_state = _AppStateProxy()\n\n\nclass _LazyProxy:\n \"\"\"延迟代理类，用于模拟全局变量\"\"\"\n\n def __init__(self, attr_name: str):\n self._attr_name = attr_name\n\n def __getattr__(self, name):\n \"\"\"代理所有属性访问\"\"\"\n obj = getattr(_state, self._attr_name)\n if obj is None:\n raise RuntimeError(\n f\"{self._attr_name} not initialized. Call initialize() first.\"\n )\n return getattr(obj, name)\n\n def __call__(self, *args, **kwargs):\n \"\"\"代理函数调用\"\"\"\n obj = getattr(_state, self._attr_name)\n if obj is None:\n raise RuntimeError(\n f\"{self._attr_name} not initialized. Call initialize() first.\"\n )\n return obj(*args, **kwargs)\n\n def __bool__(self):\n \"\"\"支持布尔判断\"\"\"\n obj = getattr(_state, self._attr_name)\n return obj is not None and bool(obj)\n\n def __repr__(self):\n obj = getattr(_state, self._attr_name)\n return repr(obj) if obj is not None else f\"\"\n\n\n# 创建代理对象，可以像普通变量一样使用\n# 添加类型注解以支持 IDE 代码跳转和补全\nxiaomusic: \"XiaoMusic\" = _LazyProxy(\"_xiaomusic\") # type: ignore\nconfig: \"Config\" = _LazyProxy(\"_config\") # type: ignore\nlog: \"logging.Logger\" = _LazyProxy(\"_log\") # type: ignore\n\n\ndef verification(\n credentials: Annotated[HTTPBasicCredentials, Depends(security)],\n):\n \"\"\"HTTP Basic 认证\"\"\"\n current_username_bytes = credentials.username.encode(\"utf8\")\n correct_username_bytes = config.httpauth_username.encode(\"utf8\")\n is_correct_username = secrets.compare_digest(\n current_username_bytes, correct_username_bytes\n )\n current_password_bytes = credentials.password.encode(\"utf8\")\n correct_password_bytes = config.httpauth_password.encode(\"utf8\")\n is_correct_password = secrets.compare_digest(\n current_password_bytes, correct_password_bytes\n )\n if not (is_correct_username and is_correct_password):\n raise HTTPException(\n status_code=status.HTTP_401_UNAUTHORIZED,\n detail=\"Incorrect username or password\",\n headers={\"WWW-Authenticate\": \"Basic\"},\n )\n return True\n\n\ndef no_verification():\n \"\"\"无认证模式\"\"\"\n return True\n\n\ndef access_key_verification(file_path: str, key: str, code: str) -> bool:\n \"\"\"访问密钥验证\"\"\"\n if config.disable_httpauth:\n return True\n\n log.debug(f\"访问限制接收端[{file_path}, {key}, {code}]\")\n if key is not None:\n current_key_bytes = key.encode(\"utf8\")\n correct_key_bytes = (\n config.httpauth_username + config.httpauth_password\n ).encode(\"utf8\")\n is_correct_key = secrets.compare_digest(correct_key_bytes, current_key_bytes)\n if is_correct_key:\n return True\n\n if code is not None:\n current_code_bytes = code.encode(\"utf8\")\n correct_code_bytes = (\n hashlib.sha256(\n (\n file_path + config.httpauth_username + config.httpauth_password\n ).encode(\"utf-8\")\n )\n .hexdigest()\n .encode(\"utf-8\")\n )\n is_correct_code = secrets.compare_digest(correct_code_bytes, current_code_bytes)\n if is_correct_code:\n return True\n\n return False\n\n\nclass AuthStaticFiles(StaticFiles):\n \"\"\"需要认证的静态文件服务\"\"\"\n\n def __init__(self, *args, **kwargs) -> None:\n super().__init__(*args, **kwargs)\n\n async def __call__(self, scope, receive, send) -> None:\n request = Request(scope, receive)\n if not config.disable_httpauth:\n assert verification(await security(request))\n await super().__call__(scope, receive, send)\n\n\ndef reset_http_server(app):\n \"\"\"重置 HTTP 服务器配置\"\"\"\n log.info(f\"disable_httpauth:{config.disable_httpauth}\")\n if config.disable_httpauth:\n app.dependency_overrides[verification] = no_verification\n else:\n app.dependency_overrides = {}\n" }, { "path": "xiaomusic/api/models.py", "content": "\"\"\"Pydantic 数据模型定义\"\"\"\n\nfrom pydantic import BaseModel\n\n\nclass Did(BaseModel):\n did: str\n\n\nclass DidVolume(BaseModel):\n did: str\n volume: int = 0\n\n\nclass DidCmd(BaseModel):\n did: str\n cmd: str\n\n\nclass MusicInfoObj(BaseModel):\n musicname: str\n title: str = \"\"\n artist: str = \"\"\n album: str = \"\"\n year: str = \"\"\n genre: str = \"\"\n lyrics: str = \"\"\n picture: str = \"\" # base64\n\n\nclass MusicItem(BaseModel):\n name: str\n\n\nclass UrlInfo(BaseModel):\n url: str\n\n\nclass DidPlayMusic(BaseModel):\n did: str\n musicname: str = \"\"\n searchkey: str = \"\"\n\n\nclass DidPlayMusicList(BaseModel):\n did: str\n listname: str = \"\"\n musicname: str = \"\"\n\n\nclass DownloadPlayList(BaseModel):\n dirname: str\n url: str\n\n\nclass DownloadOneMusic(BaseModel):\n name: str = \"\"\n url: str\n dirname: str = \"\"\n playlist_name: str = \"\"\n\n\nclass PlayListObj(BaseModel):\n name: str = \"\" # 歌单名\n\n\nclass PlayListUpdateObj(BaseModel):\n oldname: str # 旧歌单名字\n newname: str # 新歌单名字\n\n\nclass PlayListMusicObj(BaseModel):\n name: str = \"\" # 歌单名\n music_list: list[str] # 歌曲名列表\n" }, { "path": "xiaomusic/api/routers/__init__.py", "content": "\"\"\"路由注册\"\"\"\n\nfrom xiaomusic.api import websocket\nfrom xiaomusic.api.routers import (\n device,\n file,\n music,\n playlist,\n plugin,\n system,\n)\n\n\ndef register_routers(app):\n \"\"\"注册所有路由到应用\n\n Args:\n app: FastAPI 应用实例\n \"\"\"\n # 注册各个路由模块\n app.include_router(system.router, tags=[\"系统管理\"])\n app.include_router(device.router, tags=[\"设备控制\"])\n app.include_router(music.router, tags=[\"音乐管理\"])\n app.include_router(playlist.router, tags=[\"播放列表\"])\n app.include_router(plugin.router, tags=[\"插件管理\"])\n app.include_router(file.router, tags=[\"文件操作\"])\n app.include_router(websocket.router, tags=[\"WebSocket\"])\n" }, { "path": "xiaomusic/api/routers/device.py", "content": "\"\"\"设备控制路由\"\"\"\n\nimport asyncio\nimport urllib.parse\n\nfrom fastapi import (\n APIRouter,\n Depends,\n)\n\nfrom xiaomusic.api.dependencies import (\n log,\n verification,\n xiaomusic,\n)\nfrom xiaomusic.api.models import (\n Did,\n DidCmd,\n DidVolume,\n)\n\nrouter = APIRouter(dependencies=[Depends(verification)])\n\n\n@router.get(\"/device_list\")\nasync def device_list():\n \"\"\"获取设备列表\"\"\"\n devices = await xiaomusic.getalldevices()\n return {\"devices\": devices}\n\n\n@router.get(\"/getvolume\")\nasync def getvolume(did: str = \"\"):\n \"\"\"获取音量\"\"\"\n if not xiaomusic.did_exist(did):\n return {\"volume\": 0}\n\n volume = await xiaomusic.get_volume(did=did)\n return {\"volume\": volume}\n\n\n@router.get(\"/getplayerstatus\")\nasync def getplayerstatus(did: str = \"\"):\n \"\"\"获取完整播放状态\n\n 返回小米音箱的完整播放状态，包括：\n - status: 播放状态 (0=停止, 1=播放)\n - volume: 音量\n - play_song_detail: 播放详情\n - position: 当前播放位置（毫秒）\n - duration: 总时长（毫秒）\n \"\"\"\n if not xiaomusic.did_exist(did):\n return {\"status\": 0, \"volume\": 0}\n\n return await xiaomusic.get_player_status(did=did)\n\n\n@router.post(\"/setvolume\")\nasync def setvolume(data: DidVolume):\n \"\"\"设置音量\"\"\"\n did = data.did\n volume = data.volume\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n log.info(f\"set_volume {did} {volume}\")\n await xiaomusic.set_volume(did=did, arg1=volume)\n return {\"ret\": \"OK\", \"volume\": volume}\n\n\n@router.post(\"/cmd\")\nasync def do_cmd(data: DidCmd):\n \"\"\"执行命令\"\"\"\n did = data.did\n cmd = data.cmd\n log.info(f\"docmd. did:{did} cmd:{cmd}\")\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n if len(cmd) > 0:\n try:\n await xiaomusic.cancel_all_tasks()\n task = asyncio.create_task(xiaomusic.do_check_cmd(did=did, query=cmd))\n xiaomusic.append_running_task(task)\n except Exception as e:\n log.warning(f\"Execption {e}\")\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Unknow cmd\"}\n\n\n@router.get(\"/cmdstatus\")\nasync def cmd_status():\n \"\"\"命令状态\"\"\"\n finish = await xiaomusic.is_task_finish()\n if finish:\n return {\"ret\": \"OK\", \"status\": \"finish\"}\n return {\"ret\": \"OK\", \"status\": \"running\"}\n\n\n@router.get(\"/playurl\")\nasync def playurl(did: str, url: str):\n \"\"\"播放 URL\"\"\"\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n decoded_url = urllib.parse.unquote(url)\n log.info(f\"playurl did: {did} url: {decoded_url}\")\n return await xiaomusic.play_url(did=did, arg1=decoded_url)\n\n\n@router.get(\"/playtts\")\nasync def playtts(did: str, text: str):\n \"\"\"播放 TTS\"\"\"\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n log.info(f\"tts {did} {text}\")\n await xiaomusic.do_tts(did=did, value=text)\n return {\"ret\": \"OK\"}\n\n\n@router.post(\"/device/stop\")\nasync def stop(data: Did):\n \"\"\"关机\"\"\"\n did = data.did\n log.info(f\"stop did:{did}\")\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n try:\n await xiaomusic.stop(did, \"notts\")\n except Exception as e:\n log.warning(f\"Execption {e}\")\n return {\"ret\": \"OK\"}\n" }, { "path": "xiaomusic/api/routers/file.py", "content": "import asyncio\nimport base64\nimport os\nimport shutil\nfrom urllib.parse import urlparse\n\nimport aiohttp\nfrom fastapi import (\n APIRouter,\n Depends,\n File,\n Form,\n HTTPException,\n Request,\n UploadFile,\n)\nfrom fastapi.responses import (\n FileResponse,\n RedirectResponse,\n Response,\n StreamingResponse,\n)\nfrom starlette.background import BackgroundTask\n\nfrom xiaomusic.api.dependencies import (\n access_key_verification,\n config,\n log,\n verification,\n xiaomusic,\n)\nfrom xiaomusic.api.models import (\n DownloadOneMusic,\n DownloadPlayList,\n UrlInfo,\n)\nfrom xiaomusic.music_library import get_proxy_token\nfrom xiaomusic.utils.file_utils import (\n chmoddir,\n clean_temp_dir,\n remove_common_prefix,\n safe_join_path,\n)\nfrom xiaomusic.utils.music_utils import convert_file_to_mp3, is_mp3, remove_id3_tags\nfrom xiaomusic.utils.network_utils import (\n check_bili_fav_list,\n download_one_music,\n download_playlist,\n downloadfile,\n)\nfrom xiaomusic.utils.system_utils import try_add_access_control_param\n\nrouter = APIRouter()\n\n\ndef _process_m3u8_content(m3u8_content: str, base_url: str, is_radio: bool) -> str:\n \"\"\"处理 m3u8 文件内容，将资源 URL 替换为代理 URL\n\n Args:\n m3u8_content: m3u8 文件内容\n base_url: m3u8 文件的 URL（用于解析相对路径）\n is_radio: 是否为电台直播流\n\n Returns:\n str: 处理后的 m3u8 内容\n \"\"\"\n from urllib.parse import urljoin\n\n lines = m3u8_content.split(\"\\n\")\n processed_lines = []\n\n for line in lines:\n stripped_line = line.strip()\n\n # 跳过注释行和空行\n if not stripped_line or stripped_line.startswith(\"#\"):\n processed_lines.append(line)\n continue\n\n # 处理资源行（.ts、.m3u8 等）\n # 判断是否为 URL（包含协议或以 / 开头）\n if stripped_line.startswith((\"http://\", \"https://\", \"/\")):\n # 绝对 URL，直接使用\n resource_url = stripped_line\n else:\n # 相对 URL，需要拼接\n resource_url = urljoin(base_url, stripped_line)\n\n # 将资源 URL 替换为代理 URL，使用路径参数方式\n urlb64 = base64.b64encode(resource_url.encode(\"utf-8\")).decode(\"utf-8\")\n proxy_type = \"radio\" if is_radio else \"music\"\n proxy_url = f\"/proxy/{proxy_type}?urlb64={urlb64}\"\n\n processed_lines.append(proxy_url)\n\n return \"\\n\".join(processed_lines)\n\n\n@router.post(\"/api/file/cleantempdir\")\nasync def cleantempdir(Verifcation=Depends(verification)):\n await clean_temp_dir(xiaomusic.config)\n log.info(\"clean_temp_dir ok\")\n return {\"ret\": \"OK\"}\n\n\n@router.post(\"/downloadjson\")\nasync def downloadjson(data: UrlInfo, Verifcation=Depends(verification)):\n \"\"\"下载 JSON\"\"\"\n log.info(data)\n url = data.url\n content = \"\"\n try:\n ret = \"OK\"\n content = await downloadfile(url)\n except Exception as e:\n log.exception(f\"Execption {e}\")\n ret = \"Download JSON file failed.\"\n return {\n \"ret\": ret,\n \"content\": content,\n }\n\n\n@router.post(\"/downloadplaylist\")\nasync def downloadplaylist(data: DownloadPlayList, Verifcation=Depends(verification)):\n \"\"\"下载歌单\"\"\"\n try:\n bili_fav_list = await check_bili_fav_list(data.url)\n download_proc_list = []\n if bili_fav_list:\n for bvid, title in bili_fav_list.items():\n bvurl = f\"https://www.bilibili.com/video/{bvid}\"\n download_proc_list[title] = await download_one_music(\n config, bvurl, os.path.join(data.dirname, title)\n )\n for title, download_proc_sigle in download_proc_list.items():\n exit_code = await download_proc_sigle.wait()\n log.info(f\"Download completed {title} with exit code {exit_code}\")\n dir_path = safe_join_path(config.download_path, data.dirname)\n log.debug(f\"Download dir_path: {dir_path}\")\n # 可能只是部分失败，都需要整理下载目录\n remove_common_prefix(dir_path)\n chmoddir(dir_path)\n return {\"ret\": \"OK\"}\n else:\n download_proc = await download_playlist(config, data.url, data.dirname)\n\n async def check_download_proc():\n # 等待子进程完成\n exit_code = await download_proc.wait()\n log.info(f\"Download completed with exit code {exit_code}\")\n\n dir_path = safe_join_path(config.download_path, data.dirname)\n log.debug(f\"Download dir_path: {dir_path}\")\n # 可能只是部分失败，都需要整理下载目录\n remove_common_prefix(dir_path)\n chmoddir(dir_path)\n\n asyncio.create_task(check_download_proc())\n return {\"ret\": \"OK\"}\n except Exception as e:\n log.exception(f\"Execption {e}\")\n\n return {\"ret\": \"Failed download\"}\n\n\n@router.post(\"/downloadonemusic\")\nasync def downloadonemusic(data: DownloadOneMusic, Verifcation=Depends(verification)):\n \"\"\"下载单首歌曲\n\n Args:\n data.name: 文件名（可选）\n data.url: 下载链接（必填）\n data.dirname: 子目录名（可选，兼容字段），相对于 music 根目录\n data.playlist_name: 下载成功后要关联的歌单名（可选）\n \"\"\"\n try:\n pre_all_music_names = set(xiaomusic.music_library.all_music.keys())\n playlist_name = (data.playlist_name or \"\").strip()\n\n download_root = config.download_path\n if data.dirname:\n download_root = safe_join_path(config.music_path, data.dirname)\n os.makedirs(download_root, exist_ok=True)\n\n download_proc = await download_one_music(\n config,\n data.url,\n data.name,\n download_root=download_root,\n )\n\n async def check_download_proc():\n # 等待子进程完成\n exit_code = await download_proc.wait()\n log.info(f\"Download completed with exit code {exit_code}\")\n\n if exit_code != 0:\n return\n\n try:\n chmoddir(download_root)\n except Exception:\n pass\n\n try:\n xiaomusic.music_library.gen_all_music_list()\n xiaomusic.update_all_playlist()\n except Exception as e:\n log.exception(f\"refresh music list failed after download: {e}\")\n return\n\n if not playlist_name:\n return\n\n resolved_music_name = \"\"\n if data.name and data.name in xiaomusic.music_library.all_music:\n resolved_music_name = data.name\n else:\n new_music_names = [\n name\n for name in xiaomusic.music_library.all_music.keys()\n if name not in pre_all_music_names\n ]\n if len(new_music_names) == 1:\n resolved_music_name = new_music_names[0]\n elif data.name:\n for name in new_music_names:\n if name.startswith(data.name):\n resolved_music_name = name\n break\n\n if not resolved_music_name:\n log.warning(\n f\"download succeeded but failed to resolve music name for playlist: {playlist_name}\"\n )\n return\n\n added = xiaomusic.music_library.play_list_add_music(\n playlist_name, [resolved_music_name]\n )\n if added:\n xiaomusic.update_all_playlist()\n log.info(\n f\"downloadonemusic auto add success: {resolved_music_name} -> {playlist_name}\"\n )\n else:\n log.warning(\n f\"downloadonemusic auto add failed: {resolved_music_name} -> {playlist_name}\"\n )\n\n asyncio.create_task(check_download_proc())\n return {\"ret\": \"OK\"}\n except Exception as e:\n log.exception(f\"Execption {e}\")\n\n return {\"ret\": \"Failed download\"}\n\n\n@router.post(\"/uploadytdlpcookie\")\nasync def upload_yt_dlp_cookie(file: UploadFile = File(...)):\n \"\"\"上传 yt-dlp cookies\"\"\"\n with open(config.yt_dlp_cookies_path, \"wb\") as buffer:\n shutil.copyfileobj(file.file, buffer)\n return {\n \"ret\": \"OK\",\n \"filename\": file.filename,\n \"file_location\": config.yt_dlp_cookies_path,\n }\n\n\n@router.post(\"/uploadmusic\")\nasync def upload_music(playlist: str = Form(...), file: UploadFile = File(...)):\n \"\"\"上传音乐文件到当前播放列表对应的目录\"\"\"\n try:\n # 选择目标目录：优先尝试由播放列表中已有歌曲推断目录\n dest_dir = config.music_path\n # 特殊歌单映射\n if playlist == \"下载\":\n dest_dir = config.download_path\n elif playlist == \"其他\":\n dest_dir = config.music_path\n else:\n # 如果播放列表中存在歌曲，从其中任意一首推断目录\n musics = xiaomusic.music_list.get(playlist, [])\n if musics and len(musics) > 0:\n first = musics[0]\n filepath = xiaomusic.music_library.all_music.get(first, \"\")\n if filepath:\n dest_dir = os.path.dirname(filepath)\n\n # 确保目录存在\n if not os.path.exists(dest_dir):\n os.makedirs(dest_dir, exist_ok=True)\n\n # 保存文件，避免路径穿越\n filename = os.path.basename(file.filename)\n if filename == \"\":\n raise HTTPException(status_code=400, detail=\"Invalid filename\")\n\n dest_path = os.path.join(dest_dir, filename)\n # 避免覆盖已有文件，简单地添加序号后缀\n base, ext = os.path.splitext(filename)\n counter = 1\n while os.path.exists(dest_path):\n filename = f\"{base}_{counter}{ext}\"\n dest_path = os.path.join(dest_dir, filename)\n counter += 1\n\n with open(dest_path, \"wb\") as buffer:\n shutil.copyfileobj(file.file, buffer)\n\n # 修复权限并刷新列表索引\n try:\n chmoddir(dest_dir)\n except Exception:\n pass\n\n # 重新生成音乐列表索引\n try:\n xiaomusic.music_library.gen_all_music_list()\n except Exception:\n pass\n\n return {\"ret\": \"OK\", \"filename\": filename}\n except HTTPException:\n raise\n except Exception as e:\n log.exception(f\"upload music failed: {e}\")\n raise HTTPException(status_code=500, detail=\"Upload failed\") from e\n\n\ndef safe_redirect(url):\n \"\"\"安全重定向\"\"\"\n url = try_add_access_control_param(config, url)\n url = url.replace(\"\\\\\", \"\")\n if not urlparse(url).netloc and not urlparse(url).scheme:\n log.debug(f\"redirect to {url}\")\n return RedirectResponse(url=url)\n return None\n\n\n@router.get(\"/music/{file_path:path}\")\nasync def music_file(request: Request, file_path: str, key: str = \"\", code: str = \"\"):\n \"\"\"音乐文件访问\"\"\"\n if not access_key_verification(f\"/music/{file_path}\", key, code):\n raise HTTPException(status_code=404, detail=\"File not found\")\n\n absolute_path = os.path.abspath(config.music_path)\n absolute_file_path = os.path.normpath(os.path.join(absolute_path, file_path))\n if not absolute_file_path.startswith(absolute_path):\n raise HTTPException(status_code=404, detail=\"File not found\")\n if not os.path.exists(absolute_file_path):\n raise HTTPException(status_code=404, detail=\"File not found\")\n\n # 移除MP3 ID3 v2标签和填充\n if config.remove_id3tag and is_mp3(file_path):\n log.info(f\"remove_id3tag:{config.remove_id3tag}, is_mp3:True \")\n temp_mp3_file = remove_id3_tags(absolute_file_path, config)\n if temp_mp3_file:\n log.info(f\"ID3 tag removed {absolute_file_path} to {temp_mp3_file}\")\n redirect = safe_redirect(f\"/music/{temp_mp3_file}\")\n if redirect:\n return redirect\n else:\n log.info(f\"No ID3 tag remove needed: {absolute_file_path}\")\n\n if config.convert_to_mp3 and not is_mp3(file_path):\n temp_mp3_file = convert_file_to_mp3(absolute_file_path, config)\n if temp_mp3_file:\n log.info(f\"Converted file: {absolute_file_path} to {temp_mp3_file}\")\n redirect = safe_redirect(f\"/music/{temp_mp3_file}\")\n if redirect:\n return redirect\n else:\n log.warning(f\"Failed to convert file to MP3 format: {absolute_file_path}\")\n\n return FileResponse(absolute_file_path)\n\n\n@router.options(\"/music/{file_path:path}\")\nasync def music_options():\n \"\"\"音乐文件 OPTIONS\"\"\"\n headers = {\n \"Accept-Ranges\": \"bytes\",\n }\n return Response(headers=headers)\n\n\n@router.get(\"/picture/{file_path:path}\")\nasync def get_picture(request: Request, file_path: str, key: str = \"\", code: str = \"\"):\n \"\"\"图片文件访问\"\"\"\n if not access_key_verification(f\"/picture/{file_path}\", key, code):\n raise HTTPException(status_code=404, detail=\"File not found\")\n\n absolute_path = os.path.abspath(config.picture_cache_path)\n absolute_file_path = os.path.normpath(os.path.join(absolute_path, file_path))\n if not absolute_file_path.startswith(absolute_path):\n raise HTTPException(status_code=404, detail=\"File not found\")\n if not os.path.exists(absolute_file_path):\n raise HTTPException(status_code=404, detail=\"File not found\")\n\n return FileResponse(absolute_file_path)\n\n\n# bilibili CDN 精确域名后缀列表，避免 mcdn 等子串误伤其他插件\n_BILI_CDN_SUFFIXES = (\"bilivideo.com\", \"bilivideo.cn\", \"hdslb.com\")\n\n\ndef _is_bili_cdn(netloc: str) -> bool:\n \"\"\"精确匹配 bilibili CDN 域名（含子域名），不做宽泛子串匹配\"\"\"\n return any(netloc == s or netloc.endswith(\".\" + s) for s in _BILI_CDN_SUFFIXES)\n\n\nasync def _ffmpeg_mp3_stream(url: str, extra_headers: dict = None):\n \"\"\"下载音视频流，pipe 给 FFmpeg stdin 转码为 MP3\n\n Args:\n url: 音视频直链 URL\n extra_headers: 附加请求头（如 bilibili 需要的 Referer/Origin）\n \"\"\"\n import asyncio as _asyncio\n\n headers = {\n \"user-agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\n }\n if extra_headers:\n headers.update(extra_headers)\n cmd = [\n \"ffmpeg\",\n \"-y\",\n \"-i\",\n \"pipe:0\",\n \"-vn\",\n \"-acodec\",\n \"libmp3lame\",\n \"-b:a\",\n \"128k\",\n \"-f\",\n \"mp3\",\n \"pipe:1\",\n ]\n proc = await _asyncio.create_subprocess_exec(\n *cmd,\n stdin=_asyncio.subprocess.PIPE,\n stdout=_asyncio.subprocess.PIPE,\n stderr=_asyncio.subprocess.DEVNULL,\n )\n\n async def _feed_ffmpeg():\n try:\n async with aiohttp.ClientSession(\n timeout=aiohttp.ClientTimeout(total=600, sock_read=60),\n connector=aiohttp.TCPConnector(ssl=True),\n ) as session:\n async with session.get(url, headers=headers) as resp:\n async for chunk in resp.content.iter_chunked(65536):\n if proc.stdin.is_closing():\n break\n proc.stdin.write(chunk)\n await proc.stdin.drain()\n except Exception as _fe:\n log.exception(f\"[bili-ffmpeg] _feed_ffmpeg error: {_fe}\")\n finally:\n try:\n proc.stdin.close()\n except Exception:\n pass\n\n _asyncio.create_task(_feed_ffmpeg())\n\n async def _gen():\n try:\n while True:\n chunk = await proc.stdout.read(4096)\n if not chunk:\n break\n yield chunk\n finally:\n try:\n proc.kill()\n except Exception:\n pass\n await proc.wait()\n\n return StreamingResponse(\n _gen(),\n media_type=\"audio/mpeg\",\n headers={\"Content-Disposition\": 'inline; filename=\"output.mp3\"'},\n )\n\n\nasync def _proxy_handler(urlb64: str, is_radio: bool):\n \"\"\"代理处理核心逻辑\n\n Args:\n urlb64: Base64编码的URL\n is_radio: 是否为电台直播流\n\n Returns:\n Response: 代理响应\n \"\"\"\n try:\n # 将Base64编码的URL解码为字符串\n url_bytes = base64.b64decode(urlb64)\n url = url_bytes.decode(\"utf-8\")\n print(f\"解码后的代理请求: {url}\")\n except Exception as e:\n raise HTTPException(status_code=400, detail=f\"Base64解码失败: {str(e)}\") from e\n\n log.info(f\"代理请求: {url}\")\n\n parsed_url, url = xiaomusic.music_library.expand_self_url(url)\n log.info(f\"链接处理后 ${parsed_url}\")\n if not parsed_url.scheme or not parsed_url.netloc:\n invalid_url_exc = ValueError(\"URL缺少协议或域名\")\n raise HTTPException(\n status_code=400, detail=\"无效的URL格式\"\n ) from invalid_url_exc\n\n # bilibili CDN URL → FFmpeg 转码为 MP3，避免 LX06 固件格式不兼容\n # 使用精确域名后缀匹配，避免 mcdn 等子串误伤其他插件；电台流不走 FFmpeg\n if not is_radio and _is_bili_cdn(parsed_url.netloc):\n log.info(f\"bilibili CDN URL 检测到，使用 FFmpeg 转码: {url}\")\n return await _ffmpeg_mp3_stream(\n url,\n extra_headers={\n \"referer\": \"https://www.bilibili.com\",\n \"origin\": \"https://www.bilibili.com\",\n },\n )\n\n # 直播流使用更长的超时时间（24小时），普通文件使用10分钟\n timeout_seconds = 86400 if is_radio else 600\n log.info(\n f\"代理模式: {'电台直播流' if is_radio else '普通文件'}, 超时时间: {timeout_seconds}秒\"\n )\n\n session = aiohttp.ClientSession(\n timeout=aiohttp.ClientTimeout(total=timeout_seconds, sock_read=300),\n connector=aiohttp.TCPConnector(ssl=True),\n )\n\n # 复用经过验证的请求头配置\n def gen_headers(parsed_url):\n headers = {\n \"accept\": \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7\",\n \"accept-language\": \"zh-CN,zh;q=0.9,en;q=0.8\",\n \"cache-control\": \"no-cache\",\n \"pragma\": \"no-cache\",\n \"priority\": \"u=0, i\",\n \"sec-ch-ua\": '\"Google Chrome\";v=\"143\", \"Chromium\";v=\"143\", \"Not A(Brand\";v=\"24\"',\n \"sec-ch-ua-mobile\": \"?0\",\n \"sec-ch-ua-platform\": '\"macOS\"',\n \"sec-fetch-dest\": \"document\",\n \"sec-fetch-mode\": \"navigate\",\n \"sec-fetch-site\": \"none\",\n \"sec-fetch-user\": \"?1\",\n \"upgrade-insecure-requests\": \"1\",\n \"user-agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36\",\n }\n if parsed_url.netloc == config.get_self_netloc():\n headers[\"Authorization\"] = config.get_basic_auth()\n # bilibili CDN 防盗链需要 Referer（精确匹配，避免误伤其他插件）\n if _is_bili_cdn(parsed_url.netloc):\n headers[\"referer\"] = \"https://www.bilibili.com\"\n headers[\"origin\"] = \"https://www.bilibili.com\"\n return headers\n\n async def close_session():\n if not session.closed:\n await session.close()\n\n try:\n # 复用download_file中的请求逻辑\n headers = gen_headers(parsed_url)\n # 手动处理重定向，确保 bilibili CDN 重定向后仍携带 Referer\n resp = await session.get(url, headers=headers, allow_redirects=False)\n max_redirects = 5\n redirect_count = 0\n while (\n resp.status in (301, 302, 303, 307, 308) and redirect_count < max_redirects\n ):\n redirect_url = resp.headers.get(\"Location\", \"\")\n if not redirect_url:\n break\n await resp.release()\n redirect_count += 1\n import urllib.parse as _urlparse\n\n redirect_parsed = _urlparse.urlparse(redirect_url)\n redirect_headers = gen_headers(redirect_parsed)\n # bilibili CDN 防盗链；LX06 固件不兼容 MP4/AAC，切换 FFmpeg 转码\n # 精确匹配域名后缀，电台流不走 FFmpeg\n if not is_radio and _is_bili_cdn(redirect_parsed.netloc):\n log.info(\n f\"[bili-ffmpeg] redirect to bilibili CDN detected: {redirect_url[:80]}\"\n )\n await close_session()\n return await _ffmpeg_mp3_stream(\n redirect_url,\n extra_headers={\n \"referer\": \"https://www.bilibili.com\",\n \"origin\": \"https://www.bilibili.com\",\n },\n )\n resp = await session.get(\n redirect_url, headers=redirect_headers, allow_redirects=False\n )\n\n log.info(f\"proxy status: {resp.status}\")\n if resp.status not in (200, 206):\n await close_session()\n status_exc = ValueError(f\"服务器返回状态码: {resp.status}\")\n raise HTTPException(\n status_code=resp.status, detail=f\"下载失败，状态码: {resp.status}\"\n ) from status_exc\n\n # 提取文件名，根据URL扩展名智能判断\n filename = parsed_url.path.split(\"/\")[-1].split(\"?\")[0]\n content_type = resp.headers.get(\"Content-Type\", \"\").lower()\n\n # Content-Type 兜底：非 bilibili CDN 的 MP4/AAC 响应同样需要 FFmpeg 转码\n # （LX06 固件不支持 MP4/AAC 容器，需转为 MP3；电台流不转码）\n if not is_radio and not _is_bili_cdn(parsed_url.netloc):\n if any(\n ct in content_type for ct in (\"video/mp4\", \"audio/mp4\", \"audio/aac\")\n ):\n final_url = str(resp.url)\n await close_session()\n log.info(\n f\"[content-type] 检测到 {content_type}，切换 FFmpeg 转码: {final_url[:80]}\"\n )\n return await _ffmpeg_mp3_stream(final_url)\n\n # 判断是否为 m3u8 文件\n is_m3u8 = (\n url.lower().endswith(\".m3u8\")\n or \"mpegurl\" in content_type\n or \"m3u8\" in content_type\n )\n\n if not filename:\n # 根据URL扩展名或Content-Type设置默认文件名\n path_lower = parsed_url.path.lower()\n if path_lower.endswith(\".m3u8\") or is_m3u8:\n filename = \"stream.m3u8\"\n elif path_lower.endswith(\".m3u\"):\n filename = \"stream.m3u\"\n else:\n filename = \"output.mp3\"\n\n # 如果是 m3u8 文件，需要处理内容，将相对路径替换为代理 URL\n if is_m3u8:\n try:\n # 读取完整的 m3u8 内容\n m3u8_content = await resp.text()\n await close_session()\n\n # 处理 m3u8 内容，替换资源 URL\n processed_content = _process_m3u8_content(m3u8_content, url, is_radio)\n\n # 返回处理后的内容\n return Response(\n content=processed_content,\n media_type=\"application/vnd.apple.mpegurl\",\n headers={\"Content-Disposition\": f'inline; filename=\"{filename}\"'},\n )\n except Exception as e:\n log.exception(f\"处理 m3u8 文件失败: {e}\")\n # 失败时返回原始内容\n await close_session()\n raise\n\n # 非 m3u8 文件，使用流式传输\n async def stream_generator():\n try:\n async for data in resp.content.iter_chunked(4096):\n yield data\n finally:\n await close_session()\n\n return StreamingResponse(\n stream_generator(),\n media_type=resp.headers.get(\"Content-Type\", \"audio/mpeg\"),\n headers={\"Content-Disposition\": f'inline; filename=\"{filename}\"'},\n background=BackgroundTask(close_session),\n )\n\n except aiohttp.ClientConnectionError as e:\n await close_session()\n raise HTTPException(status_code=502, detail=f\"连接错误: {str(e)}\") from e\n except asyncio.TimeoutError as e:\n await close_session()\n raise HTTPException(status_code=504, detail=\"下载超时\") from e\n except Exception as e:\n await close_session()\n raise HTTPException(status_code=500, detail=f\"发生错误: {str(e)}\") from e\n\n\n@router.get(\"/proxy/{type}\", summary=\"类型化代理接口\")\nasync def proxy_with_type(type: str, urlb64: str = \"\", token: str = \"\"):\n \"\"\"支持路径参数的代理接口\n\n Args:\n type: 类型，music 或 radio\n urlb64: Base64编码的URL\n \"\"\"\n if type not in (\"music\", \"radio\"):\n raise HTTPException(status_code=400, detail=\"type 参数必须是 music 或 radio\")\n\n is_radio = type == \"radio\"\n\n # token 短链模式\n if token:\n cached = get_proxy_token(token)\n if cached is None:\n raise HTTPException(status_code=404, detail=\"token 已过期或不存在\")\n real_url, is_radio = cached\n # 不删除 token，允许音箱和 ffprobe 多次请求同一首歌\n import base64 as _b64\n\n urlb64 = _b64.b64encode(real_url.encode(\"utf-8\")).decode(\"utf-8\")\n\n return await _proxy_handler(urlb64, is_radio=is_radio)\n\n\n@router.get(\"/proxy\", summary=\"基于正常下载逻辑的代理接口\")\nasync def proxy(urlb64: str):\n \"\"\"代理接口（向后兼容）\n\n Args:\n urlb64: Base64编码的URL\n \"\"\"\n return await _proxy_handler(urlb64, is_radio=False)\n" }, { "path": "xiaomusic/api/routers/music.py", "content": "\"\"\"音乐管理路由\"\"\"\n\nimport base64\nimport json\nimport urllib.parse\n\nfrom fastapi import (\n APIRouter,\n Depends,\n HTTPException,\n Query,\n Request,\n)\nfrom fastapi.responses import RedirectResponse\n\nfrom xiaomusic.api.dependencies import (\n log,\n verification,\n xiaomusic,\n)\nfrom xiaomusic.api.models import (\n DidPlayMusic,\n MusicInfoObj,\n MusicItem,\n)\n\nrouter = APIRouter(dependencies=[Depends(verification)])\n\n\n@router.get(\"/searchmusic\")\ndef searchmusic(name: str = \"\"):\n \"\"\"搜索音乐\"\"\"\n return xiaomusic.music_library.searchmusic(name)\n\n\n\"\"\"======================在线搜索相关接口=============================\"\"\"\n\n\n@router.get(\"/api/search/online\")\nasync def search_online_music(\n keyword: str = Query(..., description=\"搜索关键词\"),\n plugin: str = Query(\"all\", description=\"指定插件名称，all表示搜索所有插件\"),\n page: int = Query(1, description=\"页码\"),\n limit: int = Query(20, description=\"每页数量\"),\n):\n \"\"\"在线音乐搜索API\"\"\"\n try:\n if not keyword:\n return {\"success\": False, \"error\": \"Keyword required\"}\n\n return await xiaomusic.get_music_list_online(\n keyword=keyword, plugin=plugin, page=page, limit=limit\n )\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.get(\"/api/proxy/real-url\")\nasync def get_real_music_url(url: str = Query(..., description=\"原始url\")):\n \"\"\"通过服务端代理获取真实的URL，不止是音频url,可能还有图片url\"\"\"\n try:\n # 获取真实的URL\n real_url = await xiaomusic.get_real_url_of_openapi(url)\n # 直接重定向到真实URL\n return RedirectResponse(url=real_url)\n\n except Exception as e:\n log.error(f\"获取真实URL失败: {e}\")\n # 如果代理获取失败，重定向到原始URL\n return RedirectResponse(url=url)\n\n\n@router.get(\"/api/proxy/plugin-url\")\nasync def get_plugin_source_url(\n data: str = Query(..., description=\"json对象压缩的base64\"),\n):\n try:\n # 获取请求数据\n # 将Base64编码的URL解码为Json字符串\n json_str = base64.b64decode(data).decode(\"utf-8\")\n # 将json字符串转换为json对象\n json_data = json.loads(json_str)\n # 调用公共函数处理\n media_source = await xiaomusic.online_music_service.get_media_source_url(\n json_data\n )\n if media_source and media_source.get(\"url\"):\n source_url = media_source.get(\"url\")\n else:\n source_url = xiaomusic.default_url()\n log.info(f\"plugin-url {json_data} {source_url}\")\n # 直接重定向到真实URL\n return RedirectResponse(url=source_url)\n except Exception as e:\n log.error(f\"获取真实音乐URL失败: {e}\")\n # 如果代理获取失败，重定向到原始URL\n source_url = xiaomusic.default_url()\n return RedirectResponse(url=source_url)\n\n\n@router.post(\"/api/play/getMediaSource\")\nasync def get_media_source(request: Request):\n \"\"\"获取音乐真实播放URL\"\"\"\n try:\n # 获取请求数据\n data = await request.json()\n # 调用公共函数处理\n return await xiaomusic.online_music_service.get_media_source_url(data)\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/play/getLyric\")\nasync def get_media_lyric(request: Request):\n \"\"\"获取音乐歌词\"\"\"\n try:\n # 获取请求数据\n data = await request.json()\n # 调用公共函数处理\n return await xiaomusic.get_media_lyric(data)\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/device/pushUrl\")\nasync def device_push_url(request: Request):\n \"\"\"推送url给设备端播放\"\"\"\n try:\n # 获取请求数据\n data = await request.json()\n did = data.get(\"did\")\n openapi_info = xiaomusic.js_plugin_manager.get_openapi_info()\n if openapi_info.get(\"enabled\", False):\n url = data.get(\"url\")\n else:\n # 调用公共函数处理,获取音乐真实播放URL\n url = xiaomusic.get_plugin_proxy_url(data)\n decoded_url = urllib.parse.unquote(url)\n return await xiaomusic.play_url(did=did, arg1=decoded_url)\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/device/pushList\")\nasync def device_push_list(request: Request):\n \"\"\"WEB前端推送歌单给设备端播放\"\"\"\n try:\n # 获取请求数据\n data = await request.json()\n did = data.get(\"did\")\n song_list = data.get(\"songList\")\n list_name = data.get(\"playlistName\")\n # 调用公共函数处理,处理歌曲信息 -> 添加歌单 -> 播放歌单\n return await xiaomusic.push_music_list_play(\n did=did, song_list=song_list, list_name=list_name\n )\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n\"\"\"======================在线搜索相关接口END=============================\"\"\"\n\n\n@router.get(\"/playingmusic\")\ndef playingmusic(did: str = \"\"):\n \"\"\"当前播放音乐\"\"\"\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n is_playing = xiaomusic.isplaying(did)\n cur_music = xiaomusic.playingmusic(did)\n cur_playlist = xiaomusic.get_cur_play_list(did)\n # 播放进度\n offset, duration = xiaomusic.get_offset_duration(did)\n return {\n \"ret\": \"OK\",\n \"is_playing\": is_playing,\n \"cur_music\": cur_music,\n \"cur_playlist\": cur_playlist,\n \"offset\": offset,\n \"duration\": duration,\n }\n\n\n@router.get(\"/musiclist\")\nasync def musiclist():\n \"\"\"音乐列表\"\"\"\n return xiaomusic.music_library.get_music_list()\n\n\n@router.get(\"/musicinfo\")\nasync def musicinfo(name: str, musictag: bool = False):\n \"\"\"音乐信息\"\"\"\n url, _ = await xiaomusic.music_library.get_music_url(name)\n info = {\n \"ret\": \"OK\",\n \"name\": name,\n \"url\": url,\n }\n if musictag:\n info[\"tags\"] = await xiaomusic.music_library.get_music_tags(name)\n return info\n\n\n@router.get(\"/musicinfos\")\nasync def musicinfos(\n name: list[str] = Query(None),\n musictag: bool = False,\n):\n \"\"\"批量音乐信息\"\"\"\n ret = []\n for music_name in name:\n url, _ = await xiaomusic.music_library.get_music_url(music_name)\n info = {\n \"name\": music_name,\n \"url\": url,\n }\n if musictag:\n info[\"tags\"] = await xiaomusic.music_library.get_music_tags(music_name)\n ret.append(info)\n return ret\n\n\n@router.post(\"/setmusictag\")\nasync def setmusictag(info: MusicInfoObj):\n \"\"\"设置音乐标签\"\"\"\n ret = xiaomusic.music_library.set_music_tag(info.musicname, info)\n return {\"ret\": ret}\n\n\n@router.post(\"/delmusic\")\nasync def delmusic(data: MusicItem):\n \"\"\"删除音乐\"\"\"\n log.info(data)\n await xiaomusic.del_music(data.name)\n return \"success\"\n\n\n@router.post(\"/playmusic\")\nasync def playmusic(data: DidPlayMusic):\n \"\"\"播放音乐\"\"\"\n did = data.did\n musicname = data.musicname\n searchkey = data.searchkey\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n log.info(f\"playmusic {did} musicname:{musicname} searchkey:{searchkey}\")\n await xiaomusic.do_play(did, musicname, searchkey)\n return {\"ret\": \"OK\"}\n\n\n@router.post(\"/refreshmusictag\")\nasync def refreshmusictag(Verifcation=Depends(verification)):\n \"\"\"刷新音乐标签\"\"\"\n xiaomusic.music_library.refresh_music_tag()\n return {\n \"ret\": \"OK\",\n }\n\n\n@router.post(\"/debug_play_by_music_url\")\nasync def debug_play_by_music_url(request: Request, Verifcation=Depends(verification)):\n \"\"\"调试播放音乐URL\"\"\"\n try:\n data = await request.body()\n data_dict = json.loads(data.decode(\"utf-8\"))\n log.info(f\"data:{data_dict}\")\n return await xiaomusic.debug_play_by_music_url(arg1=data_dict)\n except json.JSONDecodeError as err:\n raise HTTPException(status_code=400, detail=\"Invalid JSON\") from err\n\n\n@router.post(\"/api/music/refreshlist\")\nasync def refreshlist(Verifcation=Depends(verification)):\n \"\"\"刷新歌曲列表\"\"\"\n await xiaomusic.gen_music_list()\n return {\n \"ret\": \"OK\",\n }\n" }, { "path": "xiaomusic/api/routers/playlist.py", "content": "\"\"\"播放列表路由\"\"\"\n\nfrom fastapi import (\n APIRouter,\n Depends,\n)\n\nfrom xiaomusic.api.dependencies import (\n log,\n verification,\n xiaomusic,\n)\nfrom xiaomusic.api.models import (\n DidPlayMusicList,\n PlayListMusicObj,\n PlayListObj,\n PlayListUpdateObj,\n)\n\nrouter = APIRouter(dependencies=[Depends(verification)])\n\n\n@router.get(\"/curplaylist\")\nasync def curplaylist(did: str = \"\"):\n \"\"\"当前播放列表\"\"\"\n if not xiaomusic.did_exist(did):\n return \"\"\n return xiaomusic.get_cur_play_list(did)\n\n\n@router.post(\"/playmusiclist\")\nasync def playmusiclist(data: DidPlayMusicList):\n \"\"\"播放音乐列表\"\"\"\n did = data.did\n listname = data.listname\n musicname = data.musicname\n if not xiaomusic.did_exist(did):\n return {\"ret\": \"Did not exist\"}\n\n log.info(f\"playmusiclist {did} listname:{listname} musicname:{musicname}\")\n await xiaomusic.do_play_music_list(did, listname, musicname)\n return {\"ret\": \"OK\"}\n\n\n@router.post(\"/playlistadd\")\nasync def playlistadd(data: PlayListObj):\n \"\"\"新增歌单\"\"\"\n ret = xiaomusic.music_library.play_list_add(data.name)\n if ret:\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Add failed, may be already exist.\"}\n\n\n@router.post(\"/playlistdel\")\nasync def playlistdel(data: PlayListObj):\n \"\"\"移除歌单\"\"\"\n ret = xiaomusic.music_library.play_list_del(data.name)\n if ret:\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Del failed, may be not exist.\"}\n\n\n@router.post(\"/playlistupdatename\")\nasync def playlistupdatename(data: PlayListUpdateObj):\n \"\"\"修改歌单名字\"\"\"\n ret = xiaomusic.music_library.play_list_update_name(data.oldname, data.newname)\n if ret:\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Update failed, may be not exist.\"}\n\n\n@router.get(\"/playlistnames\")\nasync def getplaylistnames():\n \"\"\"获取所有自定义歌单\"\"\"\n names = xiaomusic.music_library.get_play_list_names()\n log.info(f\"names {names}\")\n return {\n \"ret\": \"OK\",\n \"names\": names,\n }\n\n\n@router.post(\"/playlistaddmusic\")\nasync def playlistaddmusic(data: PlayListMusicObj):\n \"\"\"歌单新增歌曲\"\"\"\n ret = xiaomusic.music_library.play_list_add_music(data.name, data.music_list)\n if ret:\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Add failed, may be playlist not exist.\"}\n\n\n@router.post(\"/playlistdelmusic\")\nasync def playlistdelmusic(data: PlayListMusicObj):\n \"\"\"歌单移除歌曲\"\"\"\n ret = xiaomusic.music_library.play_list_del_music(data.name, data.music_list)\n if ret:\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Del failed, may be playlist not exist.\"}\n\n\n@router.post(\"/playlistupdatemusic\")\nasync def playlistupdatemusic(data: PlayListMusicObj):\n \"\"\"歌单更新歌曲\"\"\"\n ret = xiaomusic.music_library.play_list_update_music(data.name, data.music_list)\n if ret:\n return {\"ret\": \"OK\"}\n return {\"ret\": \"Del failed, may be playlist not exist.\"}\n\n\n@router.get(\"/playlistmusics\")\nasync def getplaylist(name: str):\n \"\"\"获取歌单中所有歌曲\"\"\"\n ret, musics = xiaomusic.music_library.play_list_musics(name)\n return {\n \"ret\": \"OK\",\n \"musics\": musics,\n }\n" }, { "path": "xiaomusic/api/routers/plugin.py", "content": "\"\"\"插件管理路由\"\"\"\n\nimport os\n\nimport aiofiles\nfrom fastapi import (\n APIRouter,\n Depends,\n File,\n HTTPException,\n Query,\n Request,\n UploadFile,\n)\n\nfrom xiaomusic.api.dependencies import (\n verification,\n xiaomusic,\n)\n\nrouter = APIRouter(dependencies=[Depends(verification)])\n\n\n@router.get(\"/api/js-plugins\")\ndef get_js_plugins(\n enabled_only: bool = Query(False, description=\"是否只返回启用的插件\"),\n):\n \"\"\"获取插件列表\"\"\"\n try:\n if (\n not hasattr(xiaomusic, \"js_plugin_manager\")\n or not xiaomusic.js_plugin_manager\n ):\n return {\"success\": False, \"error\": \"JS Plugin Manager not available\"}\n\n if enabled_only:\n plugins = xiaomusic.js_plugin_manager.get_enabled_plugins()\n else:\n plugins = xiaomusic.js_plugin_manager.refresh_plugin_list()\n return {\"success\": True, \"data\": plugins}\n\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.put(\"/api/js-plugins/{plugin_name}/enable\")\ndef enable_js_plugin(plugin_name: str):\n \"\"\"启用插件\"\"\"\n try:\n if (\n not hasattr(xiaomusic, \"js_plugin_manager\")\n or not xiaomusic.js_plugin_manager\n ):\n return {\"success\": False, \"error\": \"JS Plugin Manager not available\"}\n\n success = xiaomusic.js_plugin_manager.enable_plugin(plugin_name)\n return {\"success\": success}\n\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.put(\"/api/js-plugins/{plugin_name}/disable\")\ndef disable_js_plugin(plugin_name: str):\n \"\"\"禁用插件\"\"\"\n try:\n if (\n not hasattr(xiaomusic, \"js_plugin_manager\")\n or not xiaomusic.js_plugin_manager\n ):\n return {\"success\": False, \"error\": \"JS Plugin Manager not available\"}\n\n success = xiaomusic.js_plugin_manager.disable_plugin(plugin_name)\n return {\"success\": success}\n\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.delete(\"/api/js-plugins/{plugin_name}/uninstall\")\ndef uninstall_js_plugin(plugin_name: str):\n \"\"\"卸载插件\"\"\"\n try:\n if (\n not hasattr(xiaomusic, \"js_plugin_manager\")\n or not xiaomusic.js_plugin_manager\n ):\n return {\"success\": False, \"error\": \"JS Plugin Manager not available\"}\n\n success = xiaomusic.js_plugin_manager.uninstall_plugin(plugin_name)\n return {\"success\": success}\n\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/js-plugins/upload\")\nasync def upload_js_plugin(file: UploadFile = File(...)):\n \"\"\"上传 JS 插件\"\"\"\n try:\n # 验证文件扩展名\n if not file.filename.endswith(\".js\"):\n raise HTTPException(status_code=400, detail=\"只允许上传 .js 文件\")\n\n # 使用 JSPluginManager 中定义的插件目录\n if (\n not hasattr(xiaomusic, \"js_plugin_manager\")\n or not xiaomusic.js_plugin_manager\n ):\n raise HTTPException(\n status_code=500, detail=\"JS Plugin Manager not available\"\n )\n\n plugin_dir = xiaomusic.js_plugin_manager.plugins_dir\n os.makedirs(plugin_dir, exist_ok=True)\n # 校验命名是否是保留字段【ALL/all/OpenAPI】，是的话抛错\n sys_files = [\"ALL.js\", \"all.js\", \"OpenAPI.js\", \"OPENAPI.js\"]\n if file.filename in sys_files:\n raise HTTPException(\n status_code=409,\n detail=f\"插件名非法，不能命名为： {sys_files} ，请修改后再上传！\",\n )\n file_path = os.path.join(plugin_dir, file.filename)\n # 校验是否已存在同名js插件 存在则提示，停止上传\n if os.path.exists(file_path):\n raise HTTPException(\n status_code=409,\n detail=f\"插件 {file.filename} 已存在，请重命名后再上传！\",\n )\n file_path = os.path.join(plugin_dir, file.filename)\n\n # 写入文件内容\n async with aiofiles.open(file_path, \"wb\") as f:\n content = await file.read()\n await f.write(content)\n\n # 更新插件配置文件\n plugin_name = os.path.splitext(file.filename)[0]\n xiaomusic.js_plugin_manager.update_plugin_config(plugin_name, file.filename)\n\n # 重新加载插件\n xiaomusic.js_plugin_manager.reload_plugins()\n\n return {\"success\": True, \"message\": \"插件上传成功\"}\n\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n# ----------------------------开放接口相关函数---------------------------------------\n\n\n@router.get(\"/api/openapi/load\")\ndef get_openapi_info():\n \"\"\"获取开放接口配置信息\"\"\"\n try:\n openapi_info = xiaomusic.js_plugin_manager.get_openapi_info()\n return {\"success\": True, \"data\": openapi_info}\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/openapi/toggle\")\ndef toggle_openapi():\n \"\"\"开放接口状态切换\"\"\"\n try:\n return xiaomusic.js_plugin_manager.toggle_openapi()\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/openapi/updateUrl\")\nasync def update_openapi_url(request: Request):\n \"\"\"更新开放接口地址\"\"\"\n try:\n request_json = await request.json()\n search_url = request_json.get(\"search_url\")\n if not request_json or \"search_url\" not in request_json:\n return {\"success\": False, \"error\": \"Missing 'search_url' in request body\"}\n return xiaomusic.js_plugin_manager.update_openapi_url(search_url)\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n# ----------------------------插件源接口---------------------------------------\n\n\n@router.get(\"/api/plugin-source/load\")\ndef get_plugin_source_info():\n \"\"\"获取插件源配置信息\"\"\"\n try:\n plugin_source = xiaomusic.js_plugin_manager.get_plugin_source()\n return {\"success\": True, \"data\": plugin_source}\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/plugin-source/refresh\")\ndef refresh_plugin_source():\n \"\"\"更新订阅源\"\"\"\n try:\n return xiaomusic.js_plugin_manager.refresh_plugin_source()\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n\n\n@router.post(\"/api/plugin-source/updateUrl\")\nasync def update_plugin_source(request: Request):\n \"\"\"更新插件源地址\"\"\"\n try:\n request_json = await request.json()\n source_url = request_json.get(\"source_url\")\n if not request_json or \"source_url\" not in request_json:\n return {\"success\": False, \"error\": \"Missing 'search_url' in request body\"}\n return xiaomusic.js_plugin_manager.update_plugin_source_url(source_url)\n except Exception as e:\n return {\"success\": False, \"error\": str(e)}\n" }, { "path": "xiaomusic/api/routers/system.py", "content": "\"\"\"系统管理路由\"\"\"\n\nimport asyncio\nimport base64\nimport io\nimport json\nimport os\nimport shutil\nimport tempfile\nfrom dataclasses import (\n asdict,\n)\n\nfrom fastapi import (\n APIRouter,\n Depends,\n HTTPException,\n Request,\n)\nfrom fastapi.openapi.docs import (\n get_redoc_html,\n get_swagger_ui_html,\n)\nfrom fastapi.openapi.utils import (\n get_openapi,\n)\nfrom fastapi.responses import (\n FileResponse,\n)\nfrom qrcode.main import QRCode\nfrom starlette.background import (\n BackgroundTask,\n)\n\nfrom xiaomusic import (\n __version__,\n)\nfrom xiaomusic.api.dependencies import (\n config,\n log,\n verification,\n xiaomusic,\n)\nfrom xiaomusic.qrcode_login import MiJiaAPI\nfrom xiaomusic.utils.system_utils import (\n deepcopy_data_no_sensitive_info,\n get_latest_version,\n restart_xiaomusic,\n update_version,\n)\n\nrouter = APIRouter(dependencies=[Depends(verification)])\nauth_data_path = config.conf_path if config.conf_path else None\nmi_jia_api = MiJiaAPI(auth_data_path=auth_data_path)\n\n\n@router.get(\"/\")\nasync def read_index():\n \"\"\"首页\"\"\"\n folder = os.path.dirname(\n os.path.dirname(os.path.dirname(__file__))\n ) # xiaomusic 目录\n return FileResponse(f\"{folder}/static/index.html\")\n\n\n@router.get(\"/api/get_qrcode\")\nasync def get_qrcode():\n \"\"\"生成小米账号扫码登录用二维码，返回 base64 图片 URL。\"\"\"\n try:\n qrcode_data = mi_jia_api.get_qrcode()\n # 已登录时 get_qrcode 返回 False，无需扫码\n if qrcode_data is False:\n return {\n \"success\": True,\n \"already_logged_in\": True,\n \"qrcode_url\": \"\",\n \"message\": \"已登录，无需扫码\",\n }\n\n # 优先使用小米返回的官方二维码图片 URL，与扫码内容一致且最可靠\n print(qrcode_data)\n if qrcode_data.get(\"qr\"):\n qrcode_url = qrcode_data[\"qr\"]\n else:\n # 无 qr 时用 loginUrl 本地生成二维码图\n qr = QRCode(version=1, box_size=8, border=2)\n qr.add_data(qrcode_data[\"loginUrl\"])\n qr.make(fit=True)\n img = qr.make_image(fill_color=\"black\", back_color=\"white\")\n buf = io.BytesIO()\n img.save(buf, \"PNG\")\n buf.seek(0)\n b64 = base64.b64encode(buf.read()).decode(\"ascii\")\n qrcode_url = f\"data:image/png;base64,{b64}\"\n # 返回二维码的同时，在后台启动 get_logint_status，不阻塞本次响应\n asyncio.create_task(get_logint_status(qrcode_data[\"lp\"]))\n return {\n \"success\": True,\n \"qrcode_url\": qrcode_url,\n \"status_url\": qrcode_data.get(\"lp\", \"\"),\n \"expire_seconds\": config.qrcode_timeout,\n }\n except Exception as e:\n log.exception(\"get_qrcode failed: %s\", e)\n return {\"success\": False, \"message\": str(e)}\n\n\nasync def get_logint_status(lp: str):\n \"\"\"轮询获取扫码登录状态\"\"\"\n try:\n await asyncio.to_thread(mi_jia_api.get_logint_status, lp)\n except ValueError as e:\n log.exception(\"get_logint_status failed: %s\", e)\n\n\n@router.get(\"/getversion\")\ndef getversion():\n \"\"\"获取版本\"\"\"\n log.debug(\"getversion %s\", __version__)\n return {\"version\": __version__}\n\n\n@router.get(\"/getsetting\")\nasync def getsetting(need_device_list: bool = False):\n \"\"\"获取设置\"\"\"\n config_data = xiaomusic.getconfig()\n data = asdict(config_data)\n data[\"password\"] = \"******\"\n data[\"httpauth_password\"] = \"******\"\n if need_device_list:\n device_list = await xiaomusic.getalldevices()\n log.info(f\"getsetting device_list: {device_list}\")\n data[\"device_list\"] = device_list\n return data\n\n\n@router.post(\"/savesetting\")\nasync def savesetting(request: Request):\n \"\"\"保存设置\"\"\"\n try:\n data_json = await request.body()\n data = json.loads(data_json.decode(\"utf-8\"))\n debug_data = deepcopy_data_no_sensitive_info(data)\n log.info(f\"saveconfig: {debug_data}\")\n config_obj = xiaomusic.getconfig()\n if data.get(\"password\") == \"******\" or data.get(\"password\", \"\") == \"\":\n data[\"password\"] = config_obj.password\n if (\n data.get(\"httpauth_password\") == \"******\"\n or data.get(\"httpauth_password\", \"\") == \"\"\n ):\n data[\"httpauth_password\"] = config_obj.httpauth_password\n await xiaomusic.saveconfig(data)\n\n # 重置 HTTP 服务器配置\n from xiaomusic.api.app import app\n from xiaomusic.api.dependencies import reset_http_server\n\n reset_http_server(app)\n\n return \"save success\"\n except json.JSONDecodeError as err:\n raise HTTPException(status_code=400, detail=\"Invalid JSON\") from err\n\n\n@router.post(\"/api/system/modifiysetting\")\nasync def modifiysetting(request: Request):\n \"\"\"修改部分设置\"\"\"\n try:\n data_json = await request.body()\n data = json.loads(data_json.decode(\"utf-8\"))\n debug_data = deepcopy_data_no_sensitive_info(data)\n log.info(f\"modifiysetting: {debug_data}\")\n\n config_obj = xiaomusic.getconfig()\n\n # 处理密码字段，如果是 ****** 或空字符串则保持原值\n if \"password\" in data and (\n data[\"password\"] == \"******\" or data[\"password\"] == \"\"\n ):\n data[\"password\"] = config_obj.password\n if \"httpauth_password\" in data and (\n data[\"httpauth_password\"] == \"******\" or data[\"httpauth_password\"] == \"\"\n ):\n data[\"httpauth_password\"] = config_obj.httpauth_password\n\n # 检查是否有HTTP服务器相关配置被修改\n has_http_config_changed = any(\n config_obj.is_http_server_config(key) for key in data.keys()\n )\n\n # 更新配置\n config_obj.update_config(data)\n\n # 如果有HTTP配置变更，重置HTTP服务器\n if has_http_config_changed:\n from xiaomusic.api.app import app\n from xiaomusic.api.dependencies import reset_http_server\n\n reset_http_server(app)\n log.info(\"HTTP server configuration has been reset\")\n\n # 保存配置到文件\n xiaomusic.save_cur_config()\n\n return {\"success\": True, \"message\": \"Configuration updated successfully\"}\n except json.JSONDecodeError as err:\n raise HTTPException(status_code=400, detail=\"Invalid JSON\") from err\n except Exception as err:\n log.error(f\"Error updating configuration: {err}\")\n raise HTTPException(status_code=500, detail=str(err)) from err\n\n\n@router.get(\"/downloadlog\")\ndef downloadlog():\n \"\"\"下载日志\"\"\"\n file_path = config.log_file\n if os.path.exists(file_path):\n # 创建一个临时文件来保存日志的快照\n temp_file = tempfile.NamedTemporaryFile(delete=False)\n try:\n with open(file_path, \"rb\") as f:\n shutil.copyfileobj(f, temp_file)\n temp_file.close()\n\n # 使用BackgroundTask在响应发送完毕后删除临时文件\n def cleanup_temp_file(tmp_file_path):\n os.remove(tmp_file_path)\n\n background_task = BackgroundTask(cleanup_temp_file, temp_file.name)\n return FileResponse(\n temp_file.name,\n media_type=\"text/plain\",\n filename=\"xiaomusic.txt\",\n background=background_task,\n )\n except Exception as e:\n os.remove(temp_file.name)\n raise HTTPException(\n status_code=500, detail=\"Error capturing log file\"\n ) from e\n else:\n return {\"message\": \"File not found.\"}\n\n\n@router.get(\"/latestversion\")\nasync def latest_version():\n \"\"\"获取最新版本\"\"\"\n version = await get_latest_version(\"xiaomusic\")\n if version:\n return {\"ret\": \"OK\", \"version\": version}\n else:\n return {\"ret\": \"Fetch version failed\"}\n\n\n@router.post(\"/updateversion\")\nasync def updateversion(version: str = \"\", lite: bool = True):\n \"\"\"更新版本\"\"\"\n import asyncio\n\n ret = await update_version(version, lite)\n if ret != \"OK\":\n return {\"ret\": ret}\n\n asyncio.create_task(restart_xiaomusic())\n return {\"ret\": \"OK\"}\n\n\n@router.get(\"/docs\", include_in_schema=False)\nasync def get_swagger_documentation():\n \"\"\"Swagger 文档\"\"\"\n return get_swagger_ui_html(openapi_url=\"/openapi.json\", title=\"docs\")\n\n\n@router.get(\"/redoc\", include_in_schema=False)\nasync def get_redoc_documentation():\n \"\"\"ReDoc 文档\"\"\"\n return get_redoc_html(openapi_url=\"/openapi.json\", title=\"docs\")\n\n\n@router.get(\"/openapi.json\", include_in_schema=False)\nasync def openapi():\n \"\"\"OpenAPI 规范\"\"\"\n from xiaomusic.api.app import app\n\n return get_openapi(title=app.title, version=app.version, routes=app.routes)\n" }, { "path": "xiaomusic/api/websocket.py", "content": "\"\"\"WebSocket 相关功能\"\"\"\n\nimport asyncio\nimport json\nimport secrets\nimport time\n\nimport jwt\nfrom fastapi import (\n APIRouter,\n Depends,\n WebSocket,\n WebSocketDisconnect,\n)\n\nfrom xiaomusic.api.dependencies import (\n verification,\n xiaomusic,\n)\n\nrouter = APIRouter()\n\n# JWT 配置\n# 使用固定的 secret 避免重启后 token 失效\n# 在生产环境中应该从环境变量或配置文件读取\nJWT_SECRET = secrets.token_urlsafe(32)\nJWT_ALGORITHM = \"HS256\"\nJWT_EXPIRE_SECONDS = 60 * 5 # 5 分钟有效期（足够前端连接和重连）\n\n\n@router.get(\"/generate_ws_token\")\ndef generate_ws_token(\n did: str = \"\",\n _: bool = Depends(verification), # 复用 HTTP Basic 验证\n):\n # 允许空 did，用于全局监控\n payload = {\n \"did\": did,\n \"exp\": time.time() + JWT_EXPIRE_SECONDS,\n \"iat\": time.time(),\n }\n\n token = jwt.encode(payload, JWT_SECRET, algorithm=JWT_ALGORITHM)\n\n return {\n \"token\": token,\n \"expire_in\": JWT_EXPIRE_SECONDS,\n }\n\n\n@router.websocket(\"/ws/playingmusic\")\nasync def ws_playingmusic(websocket: WebSocket):\n \"\"\"WebSocket 播放状态推送\"\"\"\n token = websocket.query_params.get(\"token\")\n if not token:\n await websocket.close(code=1008, reason=\"Missing token\")\n return\n\n try:\n # 解码 JWT（自动校验签名 + 是否过期）\n payload = jwt.decode(token, JWT_SECRET, algorithms=[JWT_ALGORITHM])\n did = payload.get(\"did\", \"\")\n\n # 允许空 did（用于全局监控），但需要检查设备是否存在\n if did and not xiaomusic.did_exist(did):\n await websocket.close(code=1003, reason=\"Did not exist\")\n return\n\n await websocket.accept()\n\n # 开始推送状态\n while True:\n is_playing = xiaomusic.isplaying(did)\n cur_music = xiaomusic.playingmusic(did)\n cur_playlist = xiaomusic.get_cur_play_list(did)\n offset, duration = xiaomusic.get_offset_duration(did)\n\n await websocket.send_text(\n json.dumps(\n {\n \"ret\": \"OK\",\n \"is_playing\": is_playing,\n \"cur_music\": cur_music,\n \"cur_playlist\": cur_playlist,\n \"offset\": offset,\n \"duration\": duration,\n }\n )\n )\n await asyncio.sleep(1)\n\n except jwt.ExpiredSignatureError:\n await websocket.close(code=1008, reason=\"Token expired\")\n except jwt.InvalidTokenError:\n await websocket.close(code=1008, reason=\"Invalid token\")\n except WebSocketDisconnect:\n print(f\"WebSocket disconnected: {did}\")\n except Exception as e:\n print(f\"Error: {e}\")\n await websocket.close()\n" }, { "path": "xiaomusic/auth.py", "content": "\"\"\"认证管理模块\n\n本模块负责小米账号认证与会话管理，包括：\n- 小米账号登录\n- Cookie管理\n- 会话维护\n- 设备ID更新\n\"\"\"\n\nimport json\nimport os\n\nfrom aiohttp import ClientSession\nfrom miservice import MiAccount, MiIOService, MiNAService\n\nfrom xiaomusic.config import Device\nfrom xiaomusic.const import COOKIE_TEMPLATE\nfrom xiaomusic.utils.system_utils import (\n get_random,\n parse_cookie_string,\n parse_cookie_string_to_dict,\n)\n\n\nclass AuthManager:\n \"\"\"认证管理器\n\n 负责处理小米账号的登录、认证和会话管理。\n \"\"\"\n\n def __init__(self, config, log, device_manager):\n \"\"\"初始化认证管理器\n\n Args:\n config: 配置对象\n log: 日志对象\n \"\"\"\n self.config = config\n self.log = log\n self.mi_token_home = os.path.join(self.config.conf_path, \".mi.token\")\n\n # 认证状态\n self.mina_service = None\n self.miio_service = None\n self.login_acount = None\n self.login_password = None\n self.cookie_jar = None\n\n # 当前设备DID（用于设备ID更新）\n self._cur_did = None\n self.device_id = get_random(16).upper()\n self.mi_session = ClientSession()\n self.device_manager = device_manager\n\n async def init_all_data(self):\n \"\"\"初始化所有数据\n\n 检查登录状态，如需要则登录，然后更新设备ID和Cookie。\n\n \"\"\"\n self.mi_token_home = os.path.join(self.config.conf_path, \".mi.token\")\n is_need_login = await self.need_login()\n is_can_login = await self.can_login()\n if is_need_login and is_can_login:\n self.log.info(\"try login\")\n await self.login_miboy()\n else:\n self.log.info(\n f\"Maybe already logined is_need_login:{is_need_login} is_can_login:{is_can_login}\"\n )\n await self.device_manager.update_device_info(self)\n cookie_jar = self.get_cookie()\n if cookie_jar:\n self.mi_session.cookie_jar.update_cookies(cookie_jar)\n self.cookie_jar = self.mi_session.cookie_jar\n\n async def can_login(self):\n if self.config.account and self.config.password:\n return True\n if self.get_cookie():\n return True\n if os.path.isfile(os.path.join(self.config.conf_path, \"auth.json\")):\n return True\n self.log.warning(\"没有账号密码 或 cookies 无法登陆\")\n return False\n\n async def need_login(self):\n \"\"\"检查是否需要登录\n\n Returns:\n bool: True表示需要登录，False表示已登录\n \"\"\"\n if self.mina_service is None:\n return True\n if self.login_acount != self.config.account:\n return True\n if self.login_password != self.config.password:\n return True\n\n try:\n await self.mina_service.device_list()\n except Exception as e:\n self.log.warning(f\"可能登录失败. {e}\")\n return True\n return False\n\n async def login_miboy(self):\n \"\"\"登录小米账号\n\n 使用配置的账号密码登录小米账号，并初始化相关服务。\n \"\"\"\n try:\n mi_account = MiAccount(\n self.mi_session,\n self.config.account,\n self.config.password,\n str(self.mi_token_home),\n )\n # Forced login to refresh to refresh token\n self.set_token(mi_account)\n await mi_account.login(\"micoapi\")\n self.mina_service = MiNAService(mi_account)\n self.miio_service = MiIOService(mi_account)\n self.login_acount = self.config.account\n self.login_password = self.config.password\n self.log.info(f\"登录完成. {self.login_acount}\")\n except Exception as e:\n self.mina_service = None\n self.miio_service = None\n self.log.warning(f\"可能登录失败. {e}\")\n\n async def try_update_device_id(self):\n \"\"\"更新设备ID\n\n 从小米服务获取设备列表，更新配置中的设备信息。\n\n Returns:\n dict: 更新后的设备字典 {did: Device}\n \"\"\"\n try:\n mi_dids = self.config.mi_did.split(\",\")\n hardware_data = await self.mina_service.device_list()\n devices = {}\n for h in hardware_data:\n device_id = h.get(\"deviceID\", \"\")\n hardware = h.get(\"hardware\", \"\")\n did = h.get(\"miotDID\", \"\")\n name = h.get(\"alias\", \"\")\n if not name:\n name = h.get(\"name\", \"未知名字\")\n if device_id and hardware and did and (did in mi_dids):\n device = self.config.devices.get(did, Device())\n device.did = did\n # 将did存一下 方便其他地方调用\n self._cur_did = did\n device.device_id = device_id\n device.hardware = hardware\n device.name = name\n devices[did] = device\n self.config.devices = devices\n self.log.info(f\"选中的设备: {devices}\")\n return devices\n except Exception as e:\n self.log.warning(f\"可能登录失败. {e}\")\n return {}\n\n def set_token(self, account):\n \"\"\"\n 设置token到account\n \"\"\"\n auth_path = os.path.join(self.config.conf_path, \"auth.json\")\n if os.path.isfile(auth_path):\n with open(auth_path, encoding=\"utf-8\") as f:\n user_data = json.loads(f.read())\n self.device_id = user_data[\"deviceId\"]\n account.token = {\n \"passToken\": user_data[\"passToken\"],\n \"userId\": user_data[\"userId\"],\n \"deviceId\": self.device_id,\n }\n elif self.config.cookie:\n cookies_dict = parse_cookie_string_to_dict(self.config.cookie)\n account.token = {\n \"passToken\": cookies_dict[\"passToken\"],\n \"userId\": cookies_dict[\"userId\"],\n \"deviceId\": self.device_id,\n }\n else:\n return\n\n def get_cookie(self):\n \"\"\"获取Cookie\n\n 从配置或token文件中获取Cookie。\n\n Returns:\n CookieJar: Cookie容器，失败返回None\n \"\"\"\n if self.config.cookie:\n cookie_jar = parse_cookie_string(self.config.cookie)\n return cookie_jar\n\n if not os.path.exists(self.mi_token_home):\n self.log.warning(f\"{self.mi_token_home} file not exist\")\n return None\n\n with open(self.mi_token_home, encoding=\"utf-8\") as f:\n user_data = json.loads(f.read())\n self.log.info(\"get_cookie user_data loaded\")\n user_id = user_data.get(\"userId\")\n service_token = user_data.get(\"micoapi\")[1]\n device_id = self.config.get_one_device_id()\n cookie_string = COOKIE_TEMPLATE.format(\n device_id=device_id, service_token=service_token, user_id=user_id\n )\n return parse_cookie_string(cookie_string)\n" }, { "path": "xiaomusic/cli.py", "content": "#!/usr/bin/env python3\nimport argparse\nimport json\nimport logging\nimport os\nimport signal\n\nimport sentry_sdk\nfrom sentry_sdk.integrations.asyncio import AsyncioIntegration\nfrom sentry_sdk.integrations.logging import (\n LoggingIntegration,\n ignore_logger,\n)\n\nLOGO = r\"\"\"\n __ __ _ __ __ _\n \\ \\/ / (_) __ _ ___ | \\/ | _ _ ___ (_) ___\n \\ / | | / _` | / _ \\ | |\\/| | | | | | / __| | | / __|\n / \\ | | | (_| | | (_) | | | | | | |_| | \\__ \\ | | | (__\n /_/\\_\\ |_| \\__,_| \\___/ |_| |_| \\__,_| |___/ |_| \\___|\n {}\n\"\"\"\n\n\nsentry_sdk.init(\n dsn=\"https://ffe4962642d04b29afe62ebd1a065231@glitchtip.hanxi.cc/1\",\n integrations=[\n AsyncioIntegration(),\n LoggingIntegration(\n level=logging.WARNING,\n event_level=logging.ERROR,\n ),\n ],\n # debug=True,\n)\nignore_logger(\"miservice\")\n\n\ndef main():\n from xiaomusic import __version__\n from xiaomusic.api import (\n HttpInit,\n )\n from xiaomusic.api import (\n app as HttpApp,\n )\n from xiaomusic.config import Config\n from xiaomusic.xiaomusic import XiaoMusic\n\n parser = argparse.ArgumentParser()\n parser.add_argument(\n \"--port\",\n dest=\"port\",\n help=\"监听端口\",\n )\n parser.add_argument(\n \"--hardware\",\n dest=\"hardware\",\n help=\"小爱音箱型号\",\n )\n parser.add_argument(\n \"--account\",\n dest=\"account\",\n help=\"xiaomi account\",\n )\n parser.add_argument(\n \"--password\",\n dest=\"password\",\n help=\"xiaomi password\",\n )\n parser.add_argument(\n \"--cookie\",\n dest=\"cookie\",\n help=\"xiaomi cookie\",\n )\n parser.add_argument(\n \"--verbose\",\n dest=\"verbose\",\n action=\"store_true\",\n default=None,\n help=\"show info\",\n )\n parser.add_argument(\n \"--config\",\n dest=\"config\",\n help=\"config file path\",\n )\n parser.add_argument(\n \"--ffmpeg_location\",\n dest=\"ffmpeg_location\",\n help=\"ffmpeg bin path\",\n )\n parser.add_argument(\n \"--enable_config_example\",\n dest=\"enable_config_example\",\n help=\"是否输出示例配置文件\",\n action=\"store_true\",\n )\n\n print(LOGO.format(f\"XiaoMusic v{__version__} by: github.com/hanxi\"), flush=True)\n\n options = parser.parse_args()\n config = Config.from_options(options)\n\n # 自定义过滤器，过滤掉关闭时的 CancelledError\n class CancelledErrorFilter(logging.Filter):\n def filter(self, record):\n if record.exc_info:\n exc_type = record.exc_info[0]\n if exc_type and exc_type.__name__ == \"CancelledError\":\n return False\n return True\n\n LOGGING_CONFIG = {\n \"version\": 1,\n \"disable_existing_loggers\": False,\n \"formatters\": {\n \"default\": {\n \"format\": f\"%(asctime)s [{__version__}] [%(levelname)s] %(message)s\",\n \"datefmt\": \"[%Y-%m-%d %H:%M:%S]\",\n \"use_colors\": False,\n },\n \"access\": {\n \"format\": f\"%(asctime)s [{__version__}] [%(levelname)s] %(message)s\",\n \"datefmt\": \"[%Y-%m-%d %H:%M:%S]\",\n },\n },\n \"filters\": {\n \"cancelled_error\": {\n \"()\": CancelledErrorFilter,\n },\n },\n \"handlers\": {\n \"default\": {\n \"formatter\": \"default\",\n \"class\": \"logging.StreamHandler\",\n \"stream\": \"ext://sys.stderr\",\n \"filters\": [\"cancelled_error\"],\n },\n \"access\": {\n \"formatter\": \"access\",\n \"class\": \"logging.StreamHandler\",\n \"stream\": \"ext://sys.stdout\",\n },\n \"file\": {\n \"level\": \"INFO\",\n \"class\": \"logging.handlers.RotatingFileHandler\",\n \"formatter\": \"access\",\n \"filename\": config.log_file,\n \"maxBytes\": 10 * 1024 * 1024,\n \"backupCount\": 1,\n \"filters\": [\"cancelled_error\"],\n },\n },\n \"loggers\": {\n \"uvicorn\": {\n \"handlers\": [\n \"default\",\n \"file\",\n ],\n \"level\": \"INFO\",\n },\n \"uvicorn.error\": {\n \"level\": \"INFO\",\n },\n \"uvicorn.access\": {\n \"handlers\": [\n \"access\",\n \"file\",\n ],\n \"level\": \"INFO\",\n \"propagate\": False,\n },\n },\n }\n\n try:\n filename = config.getsettingfile()\n if not os.path.exists(filename):\n with open(filename, encoding=\"utf-8\") as f:\n data = json.loads(f.read())\n config.update_config(data)\n except Exception as e:\n print(f\"Execption {e}\")\n\n import asyncio\n\n import uvicorn\n\n async def async_main(config: Config) -> None:\n xiaomusic = XiaoMusic(config)\n HttpInit(xiaomusic)\n port = int(config.port)\n\n # 创建 uvicorn 配置，禁用其信号处理\n uvicorn_config = uvicorn.Config(\n HttpApp,\n host=[\"0.0.0.0\", \"::\"],\n port=port,\n log_config=LOGGING_CONFIG,\n )\n server = uvicorn.Server(uvicorn_config)\n\n # 自定义信号处理\n shutdown_initiated = False\n\n def handle_exit(signum, frame):\n nonlocal shutdown_initiated\n if not shutdown_initiated:\n shutdown_initiated = True\n print(\"\\n正在关闭服务器...\")\n server.should_exit = True\n\n signal.signal(signal.SIGINT, handle_exit)\n signal.signal(signal.SIGTERM, handle_exit)\n\n # 运行服务器\n await server.serve()\n\n asyncio.run(async_main(config))\n\n\nif __name__ == \"__main__\":\n main()\n" }, { "path": "xiaomusic/command_handler.py", "content": "\"\"\"命令处理模块\n\n负责语音指令的解析、匹配和路由。\n\"\"\"\n\nimport asyncio\nimport re\nfrom typing import TYPE_CHECKING\n\nif TYPE_CHECKING:\n from xiaomusic.xiaomusic import XiaoMusic\nfrom xiaomusic.config import KEY_WORD_ARG_BEFORE_DICT\n\nif TYPE_CHECKING:\n pass\n\n\nclass CommandHandler:\n \"\"\"命令处理器\n\n 负责解析用户的语音指令，匹配对应的命令，并路由到相应的处理方法。\n \"\"\"\n\n def __init__(self, config, log, xiaomusic_instance: \"XiaoMusic\"):\n \"\"\"初始化命令处理器\n\n Args:\n config: 配置对象\n log: 日志对象\n xiaomusic_instance: XiaoMusic 主类实例，用于调用命令执行方法\n \"\"\"\n self.config = config\n self.log = log\n self.xiaomusic = xiaomusic_instance\n self.last_cmd = \"\"\n\n async def do_check_cmd(self, did=\"\", query=\"\", ctrl_panel=True, **kwargs):\n \"\"\"检查并执行命令\n 这是命令处理的入口方法，负责：\n 1. 记录命令\n 2. 匹配命令\n 3. 执行对应的方法\n 4. 处理未匹配的情况\n\n Args:\n did: 设备ID\n query: 用户查询/命令\n ctrl_panel: 是否来自控制面板\n **kwargs: 其他参数\n \"\"\"\n self.log.info(f\"收到消息:{query} 控制面板:{ctrl_panel} did:{did}\")\n\n # 记录最后一条命令\n self.last_cmd = query\n\n try:\n device = self.xiaomusic.device_manager.devices[did]\n # 匹配命令\n opvalue, oparg = self.match_cmd(device, query, ctrl_panel)\n if not opvalue:\n # 未匹配到命令，等待后检查是否需要重播\n await asyncio.sleep(1)\n await device.check_replay()\n return\n\n # 执行命令\n func = getattr(self.xiaomusic, opvalue)\n await func(did=did, arg1=oparg)\n\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n def match_cmd(self, device, query, ctrl_panel):\n \"\"\"匹配命令\n\n 根据用户输入的查询字符串，匹配对应的命令和参数。\n\n 匹配策略：\n 1. 优先完全匹配\n 2. 然后按配置的优先级顺序进行模糊匹配\n 3. 检查是否在激活命令列表中\n\n Args:\n device: 设备\n query: 用户查询字符串\n ctrl_panel: 是否来自控制面板\n\n Returns:\n tuple: (命令值, 命令参数)，未匹配返回 (None, None)\n \"\"\"\n # 优先处理完全匹配\n opvalue = self.check_full_match_cmd(device, query, ctrl_panel)\n if opvalue:\n self.log.info(f\"完全匹配指令. query:{query} opvalue:{opvalue}\")\n # 自定义口令\n if opvalue.startswith(\"exec#\"):\n code = opvalue.split(\"#\", 1)[1]\n return \"exec\", code\n return opvalue, \"\"\n\n # 按优先级顺序进行模糊匹配\n for opkey in self.config.key_match_order:\n patternarg = rf\"(.*){opkey}(.*)\"\n # 匹配参数\n matcharg = re.match(patternarg, query)\n if not matcharg:\n continue\n\n argpre = matcharg.groups()[0]\n argafter = matcharg.groups()[1]\n self.log.debug(\n \"matcharg. opkey:%s, argpre:%s, argafter:%s\",\n opkey,\n argpre,\n argafter,\n )\n\n # 根据配置决定参数位置\n oparg = argafter\n if opkey in KEY_WORD_ARG_BEFORE_DICT:\n oparg = argpre\n\n opvalue = self.config.key_word_dict.get(opkey)\n\n # 检查是否在激活命令中\n active_cmd_arr = self.config.get_active_cmd_arr()\n if (\n not ctrl_panel\n and not device.is_playing\n and active_cmd_arr\n and opvalue not in active_cmd_arr\n and opkey not in active_cmd_arr\n ):\n self.log.info(f\"不在激活命令中 {opvalue}\")\n continue\n\n self.log.info(f\"匹配到指令. opkey:{opkey} opvalue:{opvalue} oparg:{oparg}\")\n\n # 自定义口令\n if opvalue.startswith(\"exec#\"):\n code = opvalue.split(\"#\", 1)[1]\n return \"exec\", code\n return opvalue, oparg\n\n self.log.info(f\"未匹配到指令 {query} {ctrl_panel}\")\n return None, None\n\n def check_full_match_cmd(self, device, query, ctrl_panel):\n \"\"\"检查是否完全匹配命令\n\n 检查查询字符串是否与配置的命令关键词完全一致。\n\n Args:\n device: 设备\n query: 用户查询字符串\n ctrl_panel: 是否来自控制面板\n\n Returns:\n str: 匹配的命令值，未匹配返回 None\n \"\"\"\n if query not in self.config.key_match_order:\n return None\n\n active_cmd_arr = self.config.get_active_cmd_arr()\n opvalue = self.config.key_word_dict.get(query)\n # 控制面板/正在播放时允许执行/是否在激活命令中\n if (\n ctrl_panel\n or device.is_playing\n or not active_cmd_arr\n or opvalue in active_cmd_arr\n ):\n return opvalue\n" }, { "path": "xiaomusic/config.py", "content": "from __future__ import annotations\n\nimport argparse\nimport base64\nimport json\nimport os\nfrom dataclasses import asdict, dataclass, field\nfrom typing import get_type_hints\n\nfrom xiaomusic.const import (\n PLAY_TYPE_ALL,\n PLAY_TYPE_ONE,\n PLAY_TYPE_RND,\n PLAY_TYPE_SEQ,\n PLAY_TYPE_SIN,\n)\nfrom xiaomusic.utils.system_utils import validate_proxy\n\n\n# 默认口令\ndef default_key_word_dict():\n return {\n \"下一首\": \"play_next\",\n \"上一首\": \"play_prev\",\n \"单曲循环\": \"set_play_type_one\",\n \"全部循环\": \"set_play_type_all\",\n \"随机播放\": \"set_play_type_rnd\",\n \"单曲播放\": \"set_play_type_sin\",\n \"顺序播放\": \"set_play_type_seq\",\n \"分钟后关机\": \"stop_after_minute\",\n \"刷新列表\": \"gen_music_list\",\n \"加入收藏\": \"add_to_favorites\",\n \"收藏歌曲\": \"add_to_favorites\",\n \"取消收藏\": \"del_from_favorites\",\n \"播放列表第\": \"play_music_list_index\",\n \"删除歌曲\": \"cmd_del_music\",\n }\n\n\ndef default_user_key_word_dict():\n return {\n \"测试自定义口令\": 'exec#code1(\"hello\")',\n \"测试链接\": 'exec#httpget(\"https://github.com/hanxi/xiaomusic\")',\n }\n\n\n# 命令参数在前面\nKEY_WORD_ARG_BEFORE_DICT = {\n \"分钟后关机\": True,\n}\n\n\n# 口令匹配优先级\ndef default_key_match_order():\n return [\n \"分钟后关机\",\n \"下一首\",\n \"上一首\",\n \"单曲循环\",\n \"全部循环\",\n \"随机播放\",\n \"单曲播放\",\n \"顺序播放\",\n \"关机\",\n \"刷新列表\",\n \"播放列表第\",\n \"播放列表\",\n \"加入收藏\",\n \"收藏歌曲\",\n \"取消收藏\",\n \"删除歌曲\",\n ]\n\n\n@dataclass\nclass Device:\n did: str = \"\"\n device_id: str = \"\"\n hardware: str = \"\"\n name: str = \"\"\n play_type: int = PLAY_TYPE_RND\n cur_music: str = \"\"\n cur_playlist: str = \"\"\n playlist2music: dict[str, str] = field(default_factory=dict)\n\n\n@dataclass\nclass Config:\n account: str = os.getenv(\"MI_USER\", \"\")\n password: str = os.getenv(\"MI_PASS\", \"\")\n mi_did: str = os.getenv(\"MI_DID\", \"\") # 逗号分割支持多设备\n cookie: str = \"\"\n verbose: bool = os.getenv(\"XIAOMUSIC_VERBOSE\", \"\").lower() == \"true\"\n music_path: str = os.getenv(\"XIAOMUSIC_MUSIC_PATH\", \"music\")\n temp_path: str = os.getenv(\"XIAOMUSIC_TEMP_PATH\", \"music/tmp\")\n download_path: str = os.getenv(\"XIAOMUSIC_DOWNLOAD_PATH\", \"music/download\")\n conf_path: str = os.getenv(\"XIAOMUSIC_CONF_PATH\", \"conf\")\n cache_dir: str = os.getenv(\"XIAOMUSIC_CACHE_DIR\", \"music/cache\")\n hostname: str = os.getenv(\"XIAOMUSIC_HOSTNAME\", \"http://192.168.2.5\")\n port: int = int(os.getenv(\"XIAOMUSIC_PORT\", \"8090\")) # 监听端口\n public_port: int = int(os.getenv(\"XIAOMUSIC_PUBLIC_PORT\", 58090)) # 歌曲访问端口\n proxy: str = os.getenv(\"XIAOMUSIC_PROXY\", None)\n loudnorm: str = os.getenv(\"XIAOMUSIC_LOUDNORM\", None) # 均衡音量参数\n search_prefix: str = os.getenv(\n \"XIAOMUSIC_SEARCH\", \"bilisearch:\"\n ) # \"bilisearch:\" or \"ytsearch:\"\n ffmpeg_location: str = os.getenv(\"XIAOMUSIC_FFMPEG_LOCATION\", \"./ffmpeg/bin\")\n get_duration_type: str = os.getenv(\n \"XIAOMUSIC_GET_DURATION_TYPE\", \"ffprobe\"\n ) # mutagen or ffprobe\n active_cmd: str = os.getenv(\n \"XIAOMUSIC_ACTIVE_CMD\",\n \"play,set_play_type_rnd,playlocal,play_music_list,play_music_list_index,stop_after_minute,stop,play_next,play_prev,set_play_type_one,set_play_type_all,set_play_type_sin,set_play_type_seq,gen_music_list,add_to_favorites,del_from_favorites,cmd_del_music,online_play,singer_play\",\n )\n exclude_dirs: str = os.getenv(\"XIAOMUSIC_EXCLUDE_DIRS\", \"@eaDir,tmp\")\n ignore_tag_dirs: str = os.getenv(\"XIAOMUSIC_IGNORE_TAG_DIRS\", \"\")\n music_path_depth: int = int(os.getenv(\"XIAOMUSIC_MUSIC_PATH_DEPTH\", \"10\"))\n disable_httpauth: bool = (\n os.getenv(\"XIAOMUSIC_DISABLE_HTTPAUTH\", \"true\").lower() == \"true\"\n )\n httpauth_username: str = os.getenv(\"XIAOMUSIC_HTTPAUTH_USERNAME\", \"\")\n httpauth_password: str = os.getenv(\"XIAOMUSIC_HTTPAUTH_PASSWORD\", \"\")\n music_list_url: str = os.getenv(\"XIAOMUSIC_MUSIC_LIST_URL\", \"\")\n music_list_json: str = os.getenv(\"XIAOMUSIC_MUSIC_LIST_JSON\", \"\")\n custom_play_list_json: str = os.getenv(\"XIAOMUSIC_CUSTOM_PLAY_LIST_JSON\", \"\")\n disable_download: bool = (\n os.getenv(\"XIAOMUSIC_DISABLE_DOWNLOAD\", \"false\").lower() == \"true\"\n )\n key_word_dict: dict[str, str] = field(default_factory=default_key_word_dict)\n key_match_order: list[str] = field(default_factory=default_key_match_order)\n use_music_api: bool = (\n os.getenv(\"XIAOMUSIC_USE_MUSIC_API\", \"false\").lower() == \"true\"\n )\n use_music_audio_id: str = os.getenv(\n \"XIAOMUSIC_USE_MUSIC_AUDIO_ID\", \"1582971365183456177\"\n )\n use_music_id: str = os.getenv(\"XIAOMUSIC_USE_MUSIC_ID\", \"355454500\")\n log_file: str = os.getenv(\"XIAOMUSIC_LOG_FILE\", \"xiaomusic.log.txt\")\n # 模糊搜索匹配的最低相似度阈值\n fuzzy_match_cutoff: float = float(os.getenv(\"XIAOMUSIC_FUZZY_MATCH_CUTOFF\", \"0.6\"))\n # 开启模糊搜索\n enable_fuzzy_match: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_FUZZY_MATCH\", \"true\").lower() == \"true\"\n )\n stop_tts_msg: str = os.getenv(\"XIAOMUSIC_STOP_TTS_MSG\", \"收到,再见\")\n enable_config_example: bool = False\n\n keywords_playlocal: str = os.getenv(\n \"XIAOMUSIC_KEYWORDS_PLAYLOCAL\", \"播放本地歌曲,本地播放歌曲\"\n )\n keywords_play: str = os.getenv(\"XIAOMUSIC_KEYWORDS_PLAY\", \"播放歌曲,放歌曲\")\n keywords_online_play: str = os.getenv(\"XIAOMUSIC_KEYWORDS_ONLINE_PLAY\", \"在线播放\")\n keywords_singer_play: str = os.getenv(\"XIAOMUSIC_KEYWORDS_SINGER_PLAY\", \"播放歌手\")\n keywords_stop: str = os.getenv(\"XIAOMUSIC_KEYWORDS_STOP\", \"关机,暂停,停止,停止播放\")\n keywords_playlist: str = os.getenv(\n \"XIAOMUSIC_KEYWORDS_PLAYLIST\", \"播放列表,播放歌单\"\n )\n user_key_word_dict: dict[str, str] = field(\n default_factory=default_user_key_word_dict\n )\n enable_force_stop: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_FORCE_STOP\", \"false\").lower() == \"true\"\n )\n devices: dict[str, Device] = field(default_factory=dict)\n group_list: str = os.getenv(\n \"XIAOMUSIC_GROUP_LIST\", \"\"\n ) # did1:group_name,did2:group_name\n remove_id3tag: bool = (\n os.getenv(\"XIAOMUSIC_REMOVE_ID3TAG\", \"false\").lower() == \"true\"\n )\n convert_to_mp3: bool = os.getenv(\"CONVERT_TO_MP3\", \"false\").lower() == \"true\"\n delay_sec: int = int(os.getenv(\"XIAOMUSIC_DELAY_SEC\", 0)) # 下一首歌延迟播放秒数\n continue_play: bool = (\n os.getenv(\"XIAOMUSIC_CONTINUE_PLAY\", \"false\").lower() == \"true\"\n )\n # 目录监控配置\n enable_file_watch: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_FILE_WATCH\", \"false\").lower() == \"true\"\n )\n file_watch_debounce: int = int(\n os.getenv(\"XIAOMUSIC_FILE_WATCH_DEBOUNCE\", 10)\n ) # 监控刷新延迟时间(秒)\n pull_ask_sec: int = int(os.getenv(\"XIAOMUSIC_PULL_ASK_SEC\", \"1\"))\n enable_pull_ask: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_PULL_ASK\", \"false\").lower() == \"true\"\n )\n crontab_json: str = os.getenv(\"XIAOMUSIC_CRONTAB_JSON\", \"\") # 定时任务\n enable_yt_dlp_cookies: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_YT_DLP_COOKIES\", \"false\").lower() == \"true\"\n )\n enable_save_tag: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_SAVE_TAG\", \"false\").lower() == \"true\"\n )\n enable_analytics: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_ANALYTICS\", \"true\").lower() == \"true\"\n )\n get_ask_by_mina: bool = (\n os.getenv(\"XIAOMUSIC_GET_ASK_BY_MINA\", \"false\").lower() == \"true\"\n )\n play_type_one_tts_msg: str = os.getenv(\n \"XIAOMUSIC_PLAY_TYPE_ONE_TTS_MSG\", \"已经设置为单曲循环\"\n )\n play_type_all_tts_msg: str = os.getenv(\n \"XIAOMUSIC_PLAY_TYPE_ALL_TTS_MSG\", \"已经设置为全部循环\"\n )\n play_type_rnd_tts_msg: str = os.getenv(\n \"XIAOMUSIC_PLAY_TYPE_RND_TTS_MSG\", \"已经设置为随机播放\"\n )\n play_type_sin_tts_msg: str = os.getenv(\n \"XIAOMUSIC_PLAY_TYPE_SIN_TTS_MSG\", \"已经设置为单曲播放\"\n )\n play_type_seq_tts_msg: str = os.getenv(\n \"XIAOMUSIC_PLAY_TYPE_SEQ_TTS_MSG\", \"已经设置为顺序播放\"\n )\n recently_added_playlist_len: int = int(\n os.getenv(\"XIAOMUSIC_RECENTLY_ADDED_PLAYLIST_LEN\", \"50\")\n )\n # 开启语音删除歌曲\n enable_cmd_del_music: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_CMD_DEL_MUSIC\", \"false\").lower() == \"true\"\n )\n # 网络歌曲使用proxy\n web_music_proxy: bool = (\n os.getenv(\"XIAOMUSIC_WEB_MUSIC_PROXY\", \"true\").lower() == \"true\"\n )\n # edge-tts 语音角色\n edge_tts_voice: str = os.getenv(\"XIAOMUSIC_EDGE_TTS_VOICE\", \"zh-CN-XiaoyiNeural\")\n # 是否启用定时清理临时文件\n enable_auto_clean_temp: bool = (\n os.getenv(\"XIAOMUSIC_ENABLE_AUTO_CLEAN_TEMP\", \"true\").lower() == \"true\"\n )\n qrcode_timeout: int = os.getenv(\"QRCODE_TIMEOUT\", 120)\n\n def append_keyword(self, keys, action):\n for key in keys.split(\",\"):\n if key:\n self.key_word_dict[key] = action\n if key not in self.key_match_order:\n self.key_match_order.append(key)\n\n def append_user_keyword(self):\n for k, v in self.user_key_word_dict.items():\n self.key_word_dict[k] = v\n if k not in self.key_match_order:\n self.key_match_order.append(k)\n\n def init(self):\n self.key_match_order = default_key_match_order()\n self.key_word_dict = default_key_word_dict()\n self.append_keyword(self.keywords_playlocal, \"playlocal\")\n self.append_keyword(self.keywords_play, \"play\")\n self.append_keyword(self.keywords_online_play, \"online_play\")\n self.append_keyword(self.keywords_singer_play, \"singer_play\")\n self.append_keyword(self.keywords_stop, \"stop\")\n self.append_keyword(self.keywords_playlist, \"play_music_list\")\n self.append_user_keyword()\n self.key_match_order = [\n x for x in self.key_match_order if x in self.key_word_dict\n ]\n\n # 转换数据\n self._active_cmd_arr = self.active_cmd.split(\",\") if self.active_cmd else []\n self._exclude_dirs_set = set(self.exclude_dirs.split(\",\"))\n\n def __post_init__(self) -> None:\n if self.proxy:\n validate_proxy(self.proxy)\n if self.hostname:\n if not self.hostname.startswith((\"http://\", \"https://\")):\n self.hostname = f\"http://{self.hostname}\" # 默认 http\n\n self.init()\n # 保存配置到 config-example.json 文件\n if self.enable_config_example:\n with open(\"config-example.json\", \"w\") as f:\n data = asdict(self)\n json.dump(data, f, ensure_ascii=False, indent=2)\n\n @classmethod\n def from_options(cls, options: argparse.Namespace) -> Config:\n config = {}\n if options.config:\n config = cls.read_from_file(options.config)\n for key, value in vars(options).items():\n if value is not None and key in cls.__dataclass_fields__:\n config[key] = value\n return cls(**config)\n\n @classmethod\n def convert_value(cls, k, v, type_hints):\n if v is not None and k in type_hints:\n expected_type = type_hints[k]\n try:\n if expected_type is bool:\n converted_value = False\n if str(v).lower() == \"true\":\n converted_value = True\n elif expected_type == dict[str, Device]:\n converted_value = {}\n for kk, vv in v.items():\n converted_value[kk] = Device(**vv)\n else:\n converted_value = expected_type(v)\n return converted_value\n except (ValueError, TypeError) as e:\n print(f\"Error converting {k}:{v} to {expected_type}: {e}\")\n return None\n\n @classmethod\n def read_from_file(cls, config_path: str) -> dict:\n result = {}\n with open(config_path, \"rb\") as f:\n data = json.load(f)\n type_hints = get_type_hints(cls)\n\n for k, v in data.items():\n converted_value = cls.convert_value(k, v, type_hints)\n if converted_value is not None:\n result[k] = converted_value\n return result\n\n def update_config(self, data):\n type_hints = get_type_hints(self, globals(), locals())\n\n for k, v in data.items():\n converted_value = self.convert_value(k, v, type_hints)\n if converted_value is not None:\n setattr(self, k, converted_value)\n self.init()\n\n def get_active_cmd_arr(self):\n return self._active_cmd_arr\n\n def get_exclude_dirs_set(self):\n return self._exclude_dirs_set\n\n # 获取设置文件\n def getsettingfile(self):\n # 兼容旧配置空的情况\n if not self.conf_path:\n self.conf_path = \"conf\"\n if not os.path.exists(self.conf_path):\n os.makedirs(self.conf_path)\n filename = os.path.join(self.conf_path, \"setting.json\")\n return filename\n\n @property\n def tag_cache_path(self):\n if (len(self.cache_dir) > 0) and (not os.path.exists(self.cache_dir)):\n os.makedirs(self.cache_dir)\n filename = os.path.join(self.cache_dir, \"tag_cache.json\")\n return filename\n\n @property\n def picture_cache_path(self):\n cache_path = os.path.join(self.cache_dir, \"picture_cache\")\n if not os.path.exists(cache_path):\n os.makedirs(cache_path)\n return cache_path\n\n @property\n def yt_dlp_cookies_path(self):\n if not os.path.exists(self.conf_path):\n os.makedirs(self.conf_path)\n cookies_path = os.path.join(self.conf_path, \"yt-dlp-cookie.txt\")\n return cookies_path\n\n @property\n def temp_dir(self):\n if not os.path.exists(self.temp_path):\n os.makedirs(self.temp_path)\n return self.temp_path\n\n def get_play_type_tts(self, play_type):\n if play_type == PLAY_TYPE_ONE:\n return self.play_type_one_tts_msg\n if play_type == PLAY_TYPE_ALL:\n return self.play_type_all_tts_msg\n if play_type == PLAY_TYPE_RND:\n return self.play_type_rnd_tts_msg\n if play_type == PLAY_TYPE_SIN:\n return self.play_type_sin_tts_msg\n if play_type == PLAY_TYPE_SEQ:\n return self.play_type_seq_tts_msg\n return \"\"\n\n def get_ignore_tag_dirs(self):\n ignore_tag_absolute_dirs = []\n for ignore_tag_dir in self.ignore_tag_dirs.split(\",\"):\n if ignore_tag_dir:\n ignore_tag_absolute_path = os.path.abspath(ignore_tag_dir)\n ignore_tag_absolute_dirs.append(ignore_tag_absolute_path)\n return ignore_tag_absolute_dirs\n\n def get_one_device_id(self):\n \"\"\"获取一个设备ID\n\n Returns:\n str: 第一个设备的device_id，如果没有设备则返回空字符串\n \"\"\"\n device = next(iter(self.devices.values()), None)\n return device.device_id if device else \"\"\n\n def is_http_server_config(self, key: str) -> bool:\n \"\"\"判断配置键是否影响HTTP服务器\n\n Args:\n key: 配置键名\n\n Returns:\n bool: True表示该配置会影响HTTP服务器，False表示不影响\n \"\"\"\n http_server_keys = {\n \"disable_httpauth\",\n \"httpauth_username\",\n \"httpauth_password\",\n \"port\",\n \"hostname\",\n }\n return key in http_server_keys\n\n def get_basic_auth(self):\n credentials = f\"{self.httpauth_username}:{self.httpauth_password}\"\n encoded_credentials = base64.b64encode(credentials.encode()).decode()\n return f\"Basic {encoded_credentials}\"\n\n def get_self_netloc(self):\n \"\"\"获取网络地址\"\"\"\n host = self.hostname.split(\"//\", 1)[1]\n return f\"{host}:{self.public_port}\"\n" }, { "path": "xiaomusic/config_manager.py", "content": "\"\"\"配置管理模块\n\n负责配置的加载、保存、更新和管理。\n\"\"\"\n\nimport json\nfrom dataclasses import asdict\n\n\nclass ConfigManager:\n \"\"\"配置管理类\n\n 负责管理应用配置，包括：\n - 从文件加载配置\n - 保存配置到文件\n - 更新配置\n - 配置变更通知\n \"\"\"\n\n def __init__(self, config, log):\n \"\"\"初始化配置管理器\n\n Args:\n config: 配置对象\n log: 日志对象\n \"\"\"\n self.config = config\n self.log = log\n\n def try_init_setting(self):\n \"\"\"尝试从设置文件加载配置\n\n 从配置文件中读取设置并更新当前配置。\n 如果文件不存在或格式错误，会记录日志但不会抛出异常。\n \"\"\"\n try:\n filename = self.config.getsettingfile()\n with open(filename, encoding=\"utf-8\") as f:\n data = json.loads(f.read())\n return data\n except FileNotFoundError:\n self.log.info(f\"The file {filename} does not exist.\")\n return None\n except json.JSONDecodeError:\n self.log.warning(f\"The file {filename} contains invalid JSON.\")\n return None\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n return None\n\n def do_saveconfig(self, data):\n \"\"\"配置文件落地\n\n 将配置数据写入文件。\n\n Args:\n data: 要保存的配置数据（字典格式）\n \"\"\"\n filename = self.config.getsettingfile()\n with open(filename, \"w\", encoding=\"utf-8\") as f:\n json.dump(data, f, ensure_ascii=False, indent=2)\n self.log.info(f\"Configuration saved to {filename}\")\n\n def save_cur_config(self, devices):\n \"\"\"把当前配置落地\n\n 将当前运行时的配置保存到文件。\n 会同步设备配置到 config 对象中。\n\n Args:\n devices: 设备字典 {did: XiaoMusicDevice}\n \"\"\"\n # 同步设备配置\n for did in self.config.devices.keys():\n deviceobj = devices.get(did)\n if deviceobj is not None:\n self.config.devices[did] = deviceobj.device\n\n # 转换为字典并保存\n data = asdict(self.config)\n self.do_saveconfig(data)\n self.log.info(\"save_cur_config ok\")\n\n def update_config(self, data):\n \"\"\"更新配置\n\n 从字典数据更新配置对象。\n\n Args:\n data: 配置数据字典\n \"\"\"\n # 自动赋值相同字段的配置\n self.config.update_config(data)\n\n def get_config(self):\n \"\"\"获取当前配置\n\n Returns:\n Config: 当前配置对象\n \"\"\"\n return self.config\n\n def get_setting_filename(self):\n \"\"\"获取配置文件路径\n\n Returns:\n str: 配置文件的完整路径\n \"\"\"\n return self.config.getsettingfile()\n" }, { "path": "xiaomusic/const.py", "content": "SUPPORT_MUSIC_TYPE = [\n \".mp3\",\n \".flac\",\n \".wav\",\n \".ape\",\n \".ogg\",\n \".m4a\",\n \".wma\",\n]\n\nLATEST_ASK_API = \"https://userprofile.mina.mi.com/device_profile/v2/conversation?source=dialogu&hardware={hardware}×tamp={timestamp}&limit=2\"\nCOOKIE_TEMPLATE = \"deviceId={device_id}; serviceToken={service_token}; userId={user_id}\"\n\nPLAY_TYPE_ONE = 0 # 单曲循环\nPLAY_TYPE_ALL = 1 # 全部循环\nPLAY_TYPE_RND = 2 # 随机播放\nPLAY_TYPE_SIN = 3 # 单曲播放\nPLAY_TYPE_SEQ = 4 # 顺序播放\n\n# 需要采用 mina 获取对话记录的设备型号\nGET_ASK_BY_MINA = [\n \"M01\",\n]\n\n# 需要使用 play_musci 接口的设备型号\nNEED_USE_PLAY_MUSIC_API = [\n \"X08C\",\n \"X08E\",\n \"X8F\",\n \"X4B\",\n \"LX05\",\n \"OH2\",\n \"OH2P\",\n \"X6A\",\n]\n\n# 有 tts command 的设备型号\nTTS_COMMAND = {\n \"OH2\": \"5-3\",\n \"OH2P\": \"7-3\",\n \"LX06\": \"5-1\",\n \"S12\": \"5-1\",\n \"L15A\": \"7-3\",\n \"LX5A\": \"5-1\",\n \"LX01\": \"5-1\",\n \"LX05\": \"5-1\",\n \"X10A\": \"7-3\",\n \"L17A\": \"7-3\",\n \"ASX4B\": \"5-3\",\n \"L06A\": \"5-1\",\n \"L05B\": \"5-3\",\n \"L05C\": \"5-3\",\n \"X6A\": \"7-3\",\n \"X08E\": \"7-3\",\n \"L09A\": \"3-1\",\n \"LX04\": \"5-1\",\n}\n" }, { "path": "xiaomusic/conversation.py", "content": "\"\"\"对话记录拉取模块\n\n本模块负责从小爱音箱拉取对话记录，包括：\n- 轮询最新对话记录\n- 从小爱API获取对话\n- 通过Mina服务获取对话\n- 解析和验证对话记录\n\"\"\"\n\nimport asyncio\nimport json\nimport time\n\nfrom aiohttp import ClientSession, ClientTimeout\n\nfrom xiaomusic.const import GET_ASK_BY_MINA, LATEST_ASK_API\n\n\nclass ConversationPoller:\n \"\"\"对话记录轮询器\n\n 负责定期从小爱音箱拉取最新的对话记录，支持两种方式：\n 1. 通过小爱API直接获取（LATEST_ASK_API）\n 2. 通过Mina服务获取（适用于特定硬件）\n \"\"\"\n\n def __init__(\n self,\n config,\n log,\n auth_manager,\n device_manager,\n ):\n \"\"\"初始化对话轮询器\n\n Args:\n config: 配置对象\n log: 日志对象\n auth_manager: 认证管理器实例\n device_manager: 设备管理器实例\n \"\"\"\n self.config = config\n self.log = log\n self.auth_manager = auth_manager\n self.device_manager = device_manager\n self.last_timestamp = {} # key为 did. timestamp last call mi speaker\n\n # 存储最新的对话记录\n self.last_record = None\n\n # 内部事件管理\n self.polling_event = asyncio.Event()\n self.new_record_event = asyncio.Event()\n\n async def run_conversation_loop(self, do_check_cmd_callback, reset_timer_callback):\n \"\"\"运行对话循环\n\n 持续运行的主循环，负责：\n 1. 启动对话轮询任务\n 2. 等待新对话记录\n 3. 调用回调处理对话命令\n\n Args:\n do_check_cmd_callback: 处理命令的回调函数 async def(did, query, ctrl_panel)\n reset_timer_callback: 重置计时器的回调函数 async def(answer_length, did)\n \"\"\"\n # 启动轮询任务\n async with ClientSession() as session:\n task = asyncio.create_task(self.poll_latest_ask(session))\n assert task is not None # to keep the reference to task, do not remove this\n\n try:\n while True:\n self.polling_event.set()\n await self.new_record_event.wait()\n self.new_record_event.clear()\n new_record = self.last_record\n self.polling_event.clear() # stop polling when processing the question\n\n query = new_record.get(\"query\", \"\").strip()\n did = new_record.get(\"did\", \"\").strip()\n await do_check_cmd_callback(did, query, False)\n\n answer = new_record.get(\"answer\")\n answers = new_record.get(\"answers\", [{}])\n if answers:\n answer = answers[0].get(\"tts\", {}).get(\"text\", \"\").strip()\n await reset_timer_callback(len(answer), did)\n self.log.debug(f\"query:{query} did:{did} answer:{answer}\")\n except asyncio.CancelledError:\n self.log.info(\"Conversation loop cancelled, cleaning up...\")\n task.cancel()\n try:\n await task\n except asyncio.CancelledError:\n pass\n raise\n\n async def poll_latest_ask(self, session):\n \"\"\"轮询最新对话记录\n\n 持续运行的协程，定期从所有设备拉取最新对话记录。\n 根据配置的拉取间隔和硬件类型选择合适的获取方式。\n\n Args:\n session: aiohttp客户端会话\n \"\"\"\n try:\n while True:\n if not self.config.enable_pull_ask:\n self.log.debug(\"Listening new message disabled\")\n await asyncio.sleep(5)\n continue\n\n self.log.debug(\n f\"Listening new message, timestamp: {self.last_timestamp}\"\n )\n # 动态获取最新的 cookie_jar\n if self.auth_manager.cookie_jar is not None:\n session._cookie_jar = self.auth_manager.cookie_jar\n\n # 拉取所有音箱的对话记录\n tasks = []\n for device_id in self.device_manager.device_id_did:\n # 首次用当前时间初始化\n did = self.device_manager.get_did(device_id)\n if did not in self.last_timestamp:\n self.last_timestamp[did] = int(time.time() * 1000)\n\n hardware = self.device_manager.get_hardward(device_id)\n if (hardware in GET_ASK_BY_MINA) or self.config.get_ask_by_mina:\n tasks.append(self.get_latest_ask_by_mina(device_id))\n else:\n tasks.append(\n self.get_latest_ask_from_xiaoai(session, device_id)\n )\n await asyncio.gather(*tasks)\n\n start = time.perf_counter()\n await self.polling_event.wait()\n if self.config.pull_ask_sec <= 1:\n if (d := time.perf_counter() - start) < 1:\n await asyncio.sleep(1 - d)\n else:\n sleep_sec = 0\n while True:\n await asyncio.sleep(1)\n sleep_sec = sleep_sec + 1\n if sleep_sec >= self.config.pull_ask_sec:\n break\n except asyncio.CancelledError:\n self.log.info(\"Polling task cancelled\")\n raise\n\n async def get_latest_ask_from_xiaoai(self, session, device_id):\n \"\"\"从小爱API获取最新对话\n\n 通过HTTP请求小爱API获取指定设备的最新对话记录。\n 包含重试机制和错误处理。\n\n Args:\n session: aiohttp客户端会话\n device_id: 设备ID\n\n Returns:\n None - 通过 _check_last_query 更新内部状态\n \"\"\"\n cookies = {\"deviceId\": device_id}\n retries = 3\n for i in range(retries):\n try:\n timeout = ClientTimeout(total=15)\n hardware = self.device_manager.get_hardward(device_id)\n url = LATEST_ASK_API.format(\n hardware=hardware,\n timestamp=str(int(time.time() * 1000)),\n )\n # self.log.debug(f\"url:{url} device_id:{device_id} hardware:{hardware}\")\n r = await session.get(url, timeout=timeout, cookies=cookies)\n\n # 检查响应状态码\n if r.status != 200:\n self.log.warning(f\"Request failed with status {r.status}\")\n # fix #362\n if i == 2 and r.status == 401:\n await self.auth_manager.init_all_data()\n continue\n\n except asyncio.CancelledError:\n self.log.warning(\"Task was cancelled.\")\n return None\n\n except Exception as e:\n self.log.warning(f\"Execption {e}\")\n continue\n\n try:\n data = await r.json()\n except Exception as e:\n self.log.warning(f\"Execption {e}\")\n if i == 2:\n # tricky way to fix #282 #272 # if it is the third time we re init all data\n self.log.info(\"Maybe outof date trying to re init it\")\n await self.auth_manager.init_all_data()\n else:\n return self._get_last_query(device_id, data)\n self.log.warning(\"get_latest_ask_from_xiaoai. All retries failed.\")\n\n async def get_latest_ask_by_mina(self, device_id):\n \"\"\"通过Mina服务获取最新对话\n\n 使用Mina服务API获取对话记录，适用于特定硬件类型。\n\n Args:\n device_id: 设备ID\n\n Returns:\n None - 通过 _check_last_query 更新内部状态\n \"\"\"\n try:\n did = self.device_manager.get_did(device_id)\n # 动态获取最新的 mina_service\n if self.auth_manager.mina_service is None:\n self.log.warning(\n f\"mina_service is None, skip get_latest_ask_by_mina for device {device_id}\"\n )\n return\n messages = await self.auth_manager.mina_service.get_latest_ask(device_id)\n self.log.debug(\n f\"get_latest_ask_by_mina device_id:{device_id} did:{did} messages:{messages}\"\n )\n for message in messages:\n query = message.response.answer[0].question\n answer = message.response.answer[0].content\n last_record = {\n \"time\": message.timestamp_ms,\n \"did\": did,\n \"query\": query,\n \"answer\": answer,\n }\n self._check_last_query(last_record)\n except Exception as e:\n self.log.warning(f\"get_latest_ask_by_mina {e}\")\n return\n\n def _get_last_query(self, device_id, data):\n \"\"\"从API响应数据中提取最后一条对话\n\n 解析小爱API返回的JSON数据，提取最新的对话记录。\n\n Args:\n device_id: 设备ID\n data: API响应数据\n\n Returns:\n None - 通过 _check_last_query 更新内部状态\n \"\"\"\n did = self.device_manager.get_did(device_id)\n self.log.debug(f\"_get_last_query device_id:{device_id} did:{did} data:{data}\")\n if d := data.get(\"data\"):\n records = json.loads(d).get(\"records\")\n if not records:\n return\n last_record = records[0]\n last_record[\"did\"] = did\n answers = last_record.get(\"answers\", [{}])\n if answers:\n answer = answers[0].get(\"tts\", {}).get(\"text\", \"\").strip()\n last_record[\"answer\"] = answer\n self._check_last_query(last_record)\n\n def _check_last_query(self, last_record):\n \"\"\"检查并更新最后一条对话记录\n\n 验证对话记录的时间戳，如果是新记录则更新并触发事件。\n\n Args:\n last_record: 对话记录字典，包含 did、time、query、answer 等字段\n \"\"\"\n did = last_record[\"did\"]\n timestamp = last_record.get(\"time\")\n query = last_record.get(\"query\", \"\").strip()\n self.log.debug(f\"{did} 获取到最后一条对话记录：{query} {timestamp}\")\n\n if timestamp > self.last_timestamp[did]:\n self.last_timestamp[did] = timestamp\n self.last_record = last_record\n self.new_record_event.set()\n" }, { "path": "xiaomusic/crontab.py", "content": "import json\n\nfrom apscheduler.schedulers.asyncio import AsyncIOScheduler\nfrom apscheduler.triggers.base import BaseTrigger\nfrom apscheduler.triggers.cron import CronTrigger\n\nfrom xiaomusic.holiday import is_off_day, is_working_day\nfrom xiaomusic.utils.file_utils import clean_temp_dir\n\n\nclass CustomCronTrigger(BaseTrigger):\n \"\"\"自定义触发器，支持workday/offday特殊值\"\"\"\n\n def __init__(self, cron_expression, holiday_checker=None):\n self.cron_expression = cron_expression\n self.holiday_checker = holiday_checker\n\n # 分离表达式和注释\n expr_parts = cron_expression.split(\"#\", 1)\n self.base_expression = expr_parts[0].strip()\n self.annotation = expr_parts[1].strip().lower() if len(expr_parts) > 1 else \"\"\n\n # 检查注释中是否包含特殊值\n self.check_workday = \"workday\" in self.annotation\n self.check_offday = \"offday\" in self.annotation\n\n # 构建基础Cron触发器\n try:\n self.base_trigger = CronTrigger.from_crontab(self.base_expression)\n except Exception as e:\n raise ValueError(f\"无效的Cron表达式: {self.base_expression}\") from e\n\n def get_next_fire_time(self, previous_fire_time, now):\n # 获取基础Cron表达式的下一个触发时间\n next_time = self.base_trigger.get_next_fire_time(previous_fire_time, now)\n\n if not next_time:\n return None\n\n # 如果需要检查工作日/休息日\n if self.check_workday or self.check_offday:\n year = next_time.year\n month = next_time.month\n day = next_time.day\n\n if self.check_workday:\n valid = is_working_day(year, month, day)\n else: # check_offday\n valid = is_off_day(year, month, day)\n\n # 如果日期有效，返回时间；否则寻找下一个有效时间\n if valid:\n return next_time\n else:\n return self.get_next_fire_time(next_time, next_time)\n\n return next_time\n\n\nclass Crontab:\n def __init__(self, log):\n self.log = log\n self.scheduler = AsyncIOScheduler()\n\n def start(self):\n self.scheduler.start()\n\n def add_job(self, expression, job, coalesce=True):\n try:\n # 检查表达式中是否包含注释标记\n if \"#\" in expression and (\n \"workday\" in expression.lower() or \"offday\" in expression.lower()\n ):\n trigger = CustomCronTrigger(expression)\n else:\n trigger = CronTrigger.from_crontab(expression)\n\n # 添加任务配置：\n # coalesce: 如果任务错过了多次执行，是否只执行一次（默认True，适合播放类任务）\n # max_instances=30: 允许同时运行最多30个实例，支持多设备并发\n # misfire_grace_time=60: 任务延迟60秒内仍然执行\n self.scheduler.add_job(\n job, trigger, coalesce=coalesce, max_instances=30, misfire_grace_time=60\n )\n except ValueError as e:\n self.log.error(f\"Invalid crontab expression {e}\")\n except Exception as e:\n self.log.exception(f\"Exception {e}\")\n\n # 添加关机任务\n def add_job_stop(self, expression, xiaomusic, did, **kwargs):\n async def job():\n await xiaomusic.stop(did, \"notts\")\n\n self.add_job(expression, job)\n\n # 添加播放任务\n def add_job_play(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n await xiaomusic.play(did, arg1)\n\n self.add_job(expression, job)\n\n # 添加播放列表任务\n def add_job_play_music_list(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n await xiaomusic.play_music_list(did, arg1)\n\n self.add_job(expression, job)\n\n # 添加播放自定义列表任务\n def add_job_play_music_tmp_list(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n name = arg1 or \"crontab_tmp_list\"\n cron = kwargs[\"cron\"]\n music_list = cron[\"music_list\"]\n music_name = cron.get(\"first\", \"\")\n ret = xiaomusic.music_library.play_list_update_music(name, music_list)\n if not ret:\n self.log.warning(f\"crontb play_list_update_music failed name:{name}\")\n await xiaomusic.do_play_music_list(did, name, music_name)\n\n self.add_job(expression, job)\n\n # 添加语音播放任务\n def add_job_tts(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n await xiaomusic.do_tts(did, arg1)\n\n self.add_job(expression, job)\n\n # 刷新播放列表任务\n def add_job_refresh_music_list(self, expression, xiaomusic, **kwargs):\n async def job():\n await xiaomusic.gen_music_list()\n\n self.add_job(expression, job)\n\n # 设置音量任务\n def add_job_set_volume(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n await xiaomusic.set_volume(did, arg1)\n\n self.add_job(expression, job)\n\n # 设置播放类型任务\n def add_job_set_play_type(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n play_type = int(arg1)\n await xiaomusic.set_play_type(did, play_type, False)\n\n self.add_job(expression, job)\n\n # 开启或关闭获取对话记录\n def add_job_set_pull_ask(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n if arg1 == \"enable\":\n xiaomusic.config.enable_pull_ask = True\n else:\n xiaomusic.config.enable_pull_ask = False\n\n self.add_job(expression, job)\n\n # 更新网络歌单\n def add_job_refresh_web_music_list(self, expression, xiaomusic, **kwargs):\n async def job():\n await xiaomusic.refresh_web_music_list()\n await xiaomusic.gen_music_list()\n\n self.add_job(expression, job)\n\n # 重新初始化\n def add_job_reinit(self, expression, xiaomusic, did, arg1, **kwargs):\n async def job():\n xiaomusic.reinit()\n\n self.add_job(expression, job)\n\n def add_job_cron(self, xiaomusic, cron):\n expression = cron[\"expression\"] # cron 计划格式\n name = cron[\"name\"] # stop, play, play_music_list, tts\n did = cron.get(\"did\", \"\")\n arg1 = cron.get(\"arg1\", \"\")\n jobname = f\"add_job_{name}\"\n func = getattr(self, jobname, None)\n if callable(func):\n func(expression, xiaomusic, did=did, arg1=arg1, cron=cron)\n self.log.info(\n f\"crontab add_job_cron ok. did:{did}, name:{name}, arg1:{arg1} expression:{expression}\"\n )\n else:\n self.log.error(\n f\"'{self.__class__.__name__}' object has no attribute '{jobname}'\"\n )\n\n # 清空任务\n def clear_jobs(self):\n for job in self.scheduler.get_jobs():\n try:\n job.remove()\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n # 重新加载计划任务\n def reload_config(self, xiaomusic):\n self.clear_jobs()\n\n crontab_json = xiaomusic.config.crontab_json\n if not crontab_json:\n return\n\n try:\n cron_list = json.loads(crontab_json)\n for cron in cron_list:\n self.add_job_cron(xiaomusic, cron)\n self.log.info(\"crontab reload_config ok\")\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n # 添加定时清理临时文件任务\n if xiaomusic.config.enable_auto_clean_temp:\n\n async def clean_temp_job():\n clean_temp_dir(xiaomusic.config)\n\n self.add_job(\"0 3 * * *\", clean_temp_job)\n self.log.info(\"已添加每日凌晨3点定时清理临时文件任务\")\n" }, { "path": "xiaomusic/device_manager.py", "content": "\"\"\"设备管理模块\n\n本模块负责小米音箱设备的管理，包括：\n- 设备列表管理\n- 设备分组管理\n- 设备信息查询\n\"\"\"\n\nfrom typing import TYPE_CHECKING, Optional\n\nfrom xiaomusic.device_player import XiaoMusicDevice\nfrom xiaomusic.utils.text_utils import parse_str_to_dict\n\nif TYPE_CHECKING:\n from xiaomusic.xiaomusic import XiaoMusic\n\n\nclass DeviceManager:\n \"\"\"设备管理器\n\n 负责管理小米音箱设备列表、分组和设备信息查询。\n \"\"\"\n\n def __init__(self, config, log, xiaomusic: Optional[\"XiaoMusic\"] = None):\n \"\"\"初始化设备管理器\n\n Args:\n config: 配置对象\n log: 日志对象\n xiaomusic: XiaoMusic实例（可选，用于延迟设置）\n \"\"\"\n self.config = config\n self.log = log\n self.xiaomusic = xiaomusic\n\n # 设备相关数据结构\n self.devices: dict[str, XiaoMusicDevice] = {}\n self.device_id_did = {} # device_id 到 did 的映射\n self.groups = {} # 设备分组，key 为组名，value 为 device_id 列表\n\n def _update_devices(self):\n \"\"\"更新设备列表\n\n 根据配置中的设备信息和分组信息，更新设备列表和分组映射。\n 这个方法需要在设备信息已经从小米服务器获取后调用。\n \"\"\"\n XiaoMusicDevice.dict_clear(self.devices)\n\n self.device_id_did = {}\n self.groups = {}\n\n # 遍历配置中的设备，构建基本映射\n did2group = parse_str_to_dict(self.config.group_list, d1=\",\", d2=\":\")\n for did, device in self.config.devices.items():\n # 构建 device_id 到 did 的映射\n self.device_id_did[device.device_id] = did\n group_name = did2group.get(did)\n if not group_name or group_name is None:\n group_name = device.name\n self.groups.setdefault(group_name, []).append(device.device_id)\n self.devices[did] = XiaoMusicDevice(self.xiaomusic, device, group_name)\n\n self.log.info(f\"设备列表已更新: device_id_did={self.device_id_did}\")\n self.log.info(f\"设备分组已更新: groups={self.groups}\")\n\n def get_did(self, device_id):\n \"\"\"根据device_id获取did\n\n Args:\n device_id: 设备ID\n\n Returns:\n str: 设备的did，如果不存在则返回空字符串\n \"\"\"\n return self.device_id_did.get(device_id, \"\")\n\n def get_hardward(self, device_id):\n \"\"\"获取设备硬件信息\n\n Args:\n device_id: 设备ID\n\n Returns:\n str: 设备的硬件型号，如果设备不存在则返回空字符串\n \"\"\"\n device = self.get_device_by_device_id(device_id)\n if not device:\n return \"\"\n return device.hardware\n\n def get_device_by_device_id(self, device_id):\n \"\"\"根据device_id获取设备配置\n\n Args:\n device_id: 设备ID\n\n Returns:\n Device: 设备配置对象，如果不存在则返回None\n \"\"\"\n did = self.device_id_did.get(device_id)\n if not did:\n return None\n return self.config.devices.get(did)\n\n def get_group_device_id_list(self, group_name):\n \"\"\"获取分组的设备ID列表\n\n Args:\n group_name: 分组名称\n\n Returns:\n list: 设备ID列表\n \"\"\"\n return self.groups.get(group_name, [])\n\n def get_group_devices(self, group_name):\n \"\"\"获取分组的设备字典\n\n Args:\n group_name: 分组名称\n\n Returns:\n dict: 设备字典，key为did，value为XiaoMusicDevice实例\n \"\"\"\n device_id_list = self.groups.get(group_name, [])\n devices = {}\n for device_id in device_id_list:\n did = self.device_id_did.get(device_id, \"\")\n if did and did in self.devices:\n devices[did] = self.devices[did]\n return devices\n\n async def update_device_info(self, auth_manager):\n \"\"\"更新设备信息并刷新设备列表\n\n 从认证管理器获取最新的设备信息，然后更新设备列表。\n\n Args:\n auth_manager: 认证管理器实例\n \"\"\"\n await auth_manager.try_update_device_id()\n self._update_devices()\n\n def set_devices(self, devices: dict[str, XiaoMusicDevice]):\n \"\"\"设置设备实例字典\n\n 这个方法用于在主类中设置实际的设备实例。\n\n Args:\n devices: 设备实例字典，key为did，value为XiaoMusicDevice实例\n \"\"\"\n self.devices = devices\n" }, { "path": "xiaomusic/device_player.py", "content": "\"\"\"设备播放控制模块\n\n负责单个设备的播放控制、下载管理、TTS处理等功能。\n\"\"\"\n\nimport asyncio\nimport copy\nimport json\nimport os\nimport random\nimport time\nfrom typing import TYPE_CHECKING\n\nfrom miservice import miio_command\n\nfrom xiaomusic.config import Device\n\nif TYPE_CHECKING:\n from xiaomusic.xiaomusic import XiaoMusic\nfrom xiaomusic.const import (\n NEED_USE_PLAY_MUSIC_API,\n PLAY_TYPE_ALL,\n PLAY_TYPE_ONE,\n PLAY_TYPE_RND,\n PLAY_TYPE_SEQ,\n PLAY_TYPE_SIN,\n TTS_COMMAND,\n)\nfrom xiaomusic.events import DEVICE_CONFIG_CHANGED\nfrom xiaomusic.utils.file_utils import chmodfile\nfrom xiaomusic.utils.text_utils import custom_sort_key, list2str\n\n\nclass XiaoMusicDevice:\n \"\"\"设备播放控制类\n\n 负责单个小爱设备的播放控制，包括：\n - 播放控制（播放、暂停、上一首、下一首）\n - 播放列表管理\n - 下载管理\n - TTS（文字转语音）\n - 定时器管理\n - 设备状态管理\n \"\"\"\n\n def __init__(self, xiaomusic: \"XiaoMusic\", device: Device, group_name: str):\n \"\"\"初始化设备播放控制器\n\n Args:\n xiaomusic: XiaoMusic 主类实例\n device: 设备配置对象\n group_name: 设备组名\n \"\"\"\n self.group_name = group_name\n self.device = device\n self.config = xiaomusic.config\n self.device_id = device.device_id\n self.log = xiaomusic.log\n self.xiaomusic = xiaomusic\n self.auth_manager = xiaomusic.auth_manager\n self.ffmpeg_location = self.config.ffmpeg_location\n self.event_bus = getattr(xiaomusic, \"event_bus\", None)\n\n self._download_proc = None # 下载对象\n self._next_timer = None\n self.is_playing = False\n # 播放进度\n self._start_time = 0\n self._duration = 0\n self._paused_time = 0\n self._play_failed_cnt = 0\n\n self._play_list = []\n\n # 关机定时器\n self._stop_timer = None\n self._last_cmd = None\n self.update_playlist()\n\n # 添加歌曲定时器\n self._add_song_timer = None\n # TTS 播放定时器\n self._tts_timer = None\n\n @property\n def did(self):\n \"\"\"获取设备DID\"\"\"\n return self.device.did\n\n @property\n def hardware(self):\n \"\"\"获取设备硬件型号\"\"\"\n return self.device.hardware\n\n def get_cur_music(self):\n \"\"\"获取当前播放的音乐名称\"\"\"\n return self.device.cur_music\n\n def get_offset_duration(self):\n \"\"\"获取播放偏移量和总时长\"\"\"\n duration = self._duration\n if not self.is_playing:\n return 0, duration\n offset = time.time() - self._start_time - self._paused_time\n return offset, duration\n\n # 自动搜歌并加入当前歌单\n async def auto_add_song(self, cur_list_name, sleep_sec=20):\n if self.xiaomusic.js_plugin_manager is None:\n return\n # 是否启用自动添加\n auto_add_song = self.xiaomusic.js_plugin_manager.get_auto_add_song()\n is_online = self.xiaomusic.music_library.is_online_music(cur_list_name)\n # 歌单循环方式：播放全部\n play_all = self.device.play_type == PLAY_TYPE_ALL\n # 当前播放的歌曲是歌单中的最后一曲\n is_last_song = False\n cur_playlist = self._play_list\n cur_music = self.get_cur_music()\n play_list_len = len(cur_playlist)\n if play_list_len != 0:\n index = self._play_list.index(cur_music)\n is_last_song = index == play_list_len - 1\n # 四个条件都满足，才自动添加下一首\n if auto_add_song and is_online and play_all and is_last_song:\n await self._add_singer_song(cur_list_name, cur_music, sleep_sec)\n\n # 启用延时器，搜索当前歌曲歌手的其他不在歌单内的歌曲\n async def _add_singer_song(self, list_name, cur_music, sleep_sec):\n # 取消之前的定时器（如果存在）\n # self.cancel_add_song_timer()\n # 以 '-' 分割，获取歌手名称\n singer_name = cur_music.split(\"-\")[1]\n # 创建新的定时器，20秒后执行\n self._add_song_timer = asyncio.create_task(\n self._delayed_add_singer_song(list_name, singer_name, sleep_sec)\n )\n\n async def _delayed_add_singer_song(self, list_name, singer_name, sleep_sec):\n \"\"\"延迟执行添加歌手歌曲的操作\"\"\"\n try:\n await asyncio.sleep(sleep_sec)\n await self.xiaomusic.add_singer_song(list_name, singer_name)\n except asyncio.CancelledError:\n return\n finally:\n # 执行完毕后清除定时器引用\n if self._add_song_timer: # 确保是当前任务\n self._add_song_timer = None\n\n def cancel_add_song_timer(self):\n \"\"\"取消添加歌曲的定时器\"\"\"\n self.log.info(\"添加歌手歌曲的定时器已被取消\")\n if self._add_song_timer:\n self._add_song_timer.cancel()\n self._add_song_timer = None\n return True\n return False\n\n async def play_music(self, name):\n \"\"\"播放音乐（外部接口）\"\"\"\n return await self._playmusic(name)\n\n def update_playlist(self):\n \"\"\"初始化/更新播放列表\"\"\"\n # 没有重置 list 且非初始化\n if self.device.cur_playlist not in self.xiaomusic.music_library.music_list:\n self.device.cur_playlist = \"全部\"\n\n list_name = self.device.cur_playlist\n self._play_list = copy.copy(self.xiaomusic.music_library.music_list[list_name])\n\n if self.device.play_type == PLAY_TYPE_RND:\n random.shuffle(self._play_list)\n self.log.info(\n f\"随机打乱 {list_name} {list2str(self._play_list, self.config.verbose)}\"\n )\n else:\n is_online = self.xiaomusic.music_library.is_online_music(list_name)\n if not is_online and len(self._play_list) > 0:\n self._play_list.sort(key=custom_sort_key)\n self.log.info(\n f\"没打乱 {list_name} {list2str(self._play_list, self.config.verbose)}\"\n )\n\n async def play(self, name=\"\", search_key=\"\"):\n \"\"\"播放歌曲（外部接口）\"\"\"\n self._last_cmd = \"play\"\n return await self._play(name=name, search_key=search_key)\n\n async def _check_and_download_music(self, name, search_key, allow_download):\n \"\"\"检查本地歌曲是否存在，如果不存在则根据参数决定是否下载\n\n Args:\n name: 歌曲名称\n search_key: 搜索关键词\n allow_download: 是否允许下载\n\n Returns:\n bool: True表示歌曲存在或下载成功，False表示歌曲不存在且不允许下载\n \"\"\"\n if self.xiaomusic.music_library.is_music_exist(name):\n return True\n\n self.log.info(f\"本地不存在歌曲{name}\")\n\n # 根据 allow_download 参数决定行为\n if not allow_download:\n # playlocal 的行为：不下载，直接提示\n await self.do_tts(f\"本地不存在歌曲{name}\")\n return False\n\n # _play 的行为：检查配置决定是否下载\n if self.config.disable_download:\n await self.do_tts(f\"本地不存在歌曲{name}\")\n return False\n\n # 下载歌曲\n await self.download(search_key, name)\n # 把文件插入到播放列表里\n await self.add_download_music(name)\n return True\n\n async def _play_internal(self, name=\"\", search_key=\"\", allow_download=True):\n \"\"\"播放歌曲的内部统一实现\n\n Args:\n name: 歌曲名称\n search_key: 搜索关键词\n allow_download: 是否允许下载（True: _play行为，False: playlocal行为）\n \"\"\"\n # 初始检查逻辑\n if not search_key and not name:\n if self.check_play_next():\n await self._play_next()\n return\n else:\n name = self.get_cur_music()\n\n self.log.info(\n f\"play_internal. search_key:{search_key} name:{name} allow_download:{allow_download}\"\n )\n\n if not name:\n self.log.info(f\"没有歌曲播放了 name:{name} search_key:{search_key}\")\n return\n\n # 模糊搜索\n names = self.xiaomusic.music_library.find_real_music_name(name, n=1)\n self.log.info(f\"play_internal. names:{names} {len(names)}\")\n\n if not names:\n # 检查本地是否存在歌曲，不存在则根据参数决定是否下载\n if not await self._check_and_download_music(\n name, search_key, allow_download\n ):\n return\n\n # 播放歌曲\n await self._playmusic(name)\n return\n\n name = names[0]\n if name not in self._play_list:\n # 根据当前歌曲匹配歌曲列表\n self.device.cur_playlist = self.find_cur_playlist(name)\n self.update_playlist()\n\n self.log.debug(\n f\"当前播放列表为：{list2str(self._play_list, self.config.verbose)}\"\n )\n # 本地存在歌曲，直接播放\n await self._playmusic(name)\n\n async def _play(self, name=\"\", search_key=\"\"):\n \"\"\"播放歌曲（内部实现）- 支持下载\"\"\"\n return await self._play_internal(\n name=name,\n search_key=search_key,\n allow_download=True,\n )\n\n async def play_next(self):\n \"\"\"播放下一首（外部接口）\"\"\"\n return await self._play_next()\n\n async def _play_next(self):\n \"\"\"播放下一首（内部实现）\"\"\"\n self.log.info(\"开始播放下一首\")\n name = self.get_cur_music()\n if (\n self.device.play_type == PLAY_TYPE_ALL\n or self.device.play_type == PLAY_TYPE_RND\n or self.device.play_type == PLAY_TYPE_SEQ\n or name == \"\"\n or (\n (name not in self._play_list) and self.device.play_type != PLAY_TYPE_ONE\n )\n ):\n name = self.get_next_music()\n self.log.info(f\"get_next_music {name}\")\n self.log.info(f\"_play_next. name:{name}, cur_music:{self.get_cur_music()}\")\n if name == \"\":\n self.log.info(\"本地没有歌曲\")\n return\n await self._play(name)\n\n async def play_prev(self):\n \"\"\"播放上一首（外部接口）\"\"\"\n return await self._play_prev()\n\n async def _play_prev(self):\n \"\"\"播放上一首（内部实现）\"\"\"\n self.log.info(\"开始播放上一首\")\n name = self.get_cur_music()\n if (\n self.device.play_type == PLAY_TYPE_ALL\n or self.device.play_type == PLAY_TYPE_RND\n or self.device.play_type == PLAY_TYPE_SEQ\n or name == \"\"\n or (name not in self._play_list)\n ):\n name = self.get_prev_music()\n self.log.info(f\"_play_prev. name:{name}, cur_music:{self.get_cur_music()}\")\n if name == \"\":\n await self.do_tts(\"本地没有歌曲\")\n return\n await self._play(name)\n\n async def playlocal(self, name=\"\"):\n \"\"\"播放本地歌曲 - 不下载\"\"\"\n self._last_cmd = \"playlocal\"\n return await self._play_internal(name=name, search_key=\"\", allow_download=False)\n\n async def _playmusic(self, name):\n \"\"\"播放音乐的核心实现\"\"\"\n # 取消组内所有的下一首歌曲的定时器\n await self.cancel_group_next_timer()\n\n self.is_playing = True\n self.device.cur_music = name\n self.device.playlist2music[self.device.cur_playlist] = name\n cur_playlist = self.device.cur_playlist\n self.log.info(f\"cur_music {self.get_cur_music()}\")\n url, _ = await self.xiaomusic.music_library.get_music_url(name)\n await self.group_force_stop_xiaoai()\n self.log.info(f\"播放 {url}\")\n\n results = await self.group_player_play(url, name)\n if all(ele is None for ele in results):\n self.log.info(f\"播放 {name} 失败. 失败次数: {self._play_failed_cnt}\")\n await asyncio.sleep(1)\n if (\n self.is_playing\n and self._last_cmd != \"stop\"\n and self._play_failed_cnt < 10\n ):\n self._play_failed_cnt = self._play_failed_cnt + 1\n await self._play_next()\n return\n # 重置播放失败次数\n self._play_failed_cnt = 0\n\n self.log.info(f\"【{name}】已经开始播放了\")\n\n # 记录歌曲开始播放的时间\n self._start_time = time.time()\n self._paused_time = 0\n\n sec = await self.xiaomusic.music_library.get_music_duration(name)\n # 存储真实歌曲时长\n self._duration = sec\n await self.xiaomusic.analytics.send_play_event(name, sec, self.hardware)\n\n # 设置下一首歌曲的播放定时器\n if sec <= 0.1:\n self.log.info(f\"【{name}】不会设置下一首歌的定时器\")\n return\n\n # 计算自动添加歌曲的延迟时间，为当前歌曲时长的一半，但不超过60秒\n if sec > 30:\n sleep_sec = min(sec / 2, 60)\n await self.auto_add_song(cur_playlist, sleep_sec)\n\n # 计算获取时长的执行耗时\n duration_execution_time = time.time() - self._start_time\n self.log.info(f\"获取音乐时长耗时: {duration_execution_time:.3f} 秒\")\n # 调整定时器时长，减去获取音乐时长的执行时间\n adjusted_sec = sec + self.config.delay_sec - duration_execution_time\n # 确保调整后的时长不会过小，最小保留0.1秒\n adjusted_sec = max(adjusted_sec, 0.1)\n self.log.info(\n f\"原始歌曲时长: {sec:.3f} 秒, 调整后定时器时长: {adjusted_sec:.3f} 秒\"\n )\n await self.set_next_music_timeout(adjusted_sec)\n # 发布设备配置变更事件\n if self.event_bus:\n self.event_bus.publish(DEVICE_CONFIG_CHANGED)\n\n async def do_tts(self, value):\n \"\"\"执行TTS（文字转语音）\"\"\"\n self.log.info(f\"try do_tts value:{value}\")\n if not value:\n self.log.info(\"do_tts no value\")\n return\n\n # await self.group_force_stop_xiaoai()\n await self.text_to_speech(value)\n\n # 最大等8秒\n sec = min(8, int(len(value) / 3))\n await asyncio.sleep(sec)\n self.log.info(f\"do_tts ok. cur_music:{self.get_cur_music()}\")\n await self.check_replay()\n\n async def force_stop_xiaoai(self, device_id):\n \"\"\"强制停止小爱播放\"\"\"\n try:\n ret = await self.auth_manager.mina_service.player_pause(device_id)\n self.log.info(\n f\"force_stop_xiaoai player_pause device_id:{device_id} ret:{ret}\"\n )\n await self.stop_if_xiaoai_is_playing(device_id)\n except Exception as e:\n self.log.warning(f\"Execption {e}\")\n\n async def get_if_xiaoai_is_playing(self):\n \"\"\"检查小爱是否正在播放\"\"\"\n playing_info = await self.auth_manager.mina_service.player_get_status(\n self.device_id\n )\n self.log.info(playing_info)\n # WTF xiaomi api\n is_playing = (\n json.loads(playing_info.get(\"data\", {}).get(\"info\", \"{}\")).get(\"status\", -1)\n == 1\n )\n return is_playing\n\n async def stop_if_xiaoai_is_playing(self, device_id):\n \"\"\"如果小爱正在播放则停止\"\"\"\n is_playing = await self.get_if_xiaoai_is_playing()\n if is_playing or self.config.enable_force_stop:\n # stop it\n ret = await self.auth_manager.mina_service.player_stop(device_id)\n self.log.info(\n f\"stop_if_xiaoai_is_playing player_stop device_id:{device_id} enable_force_stop:{self.config.enable_force_stop} ret:{ret}\"\n )\n\n def isdownloading(self):\n \"\"\"检查是否正在下载\"\"\"\n if not self._download_proc:\n return False\n\n if self._download_proc.returncode is not None:\n self.log.info(\n f\"Process exited with returncode:{self._download_proc.returncode}\"\n )\n return False\n\n self.log.info(\"Download Process is still running.\")\n return True\n\n async def download(self, search_key, name):\n \"\"\"下载歌曲\"\"\"\n if self._download_proc:\n try:\n self._download_proc.kill()\n except ProcessLookupError:\n pass\n\n sbp_args = (\n \"yt-dlp\",\n f\"{self.config.search_prefix}{search_key}\",\n \"-x\",\n \"--audio-format\",\n \"mp3\",\n \"--audio-quality\",\n \"0\",\n \"--paths\",\n self.config.download_path,\n \"-o\",\n f\"{name}.mp3\",\n \"--ffmpeg-location\",\n f\"{self.ffmpeg_location}\",\n \"--no-playlist\",\n )\n\n if self.config.proxy:\n sbp_args += (\"--proxy\", f\"{self.config.proxy}\")\n\n if self.config.enable_yt_dlp_cookies:\n sbp_args += (\"--cookies\", f\"{self.config.yt_dlp_cookies_path}\")\n\n if self.config.loudnorm:\n sbp_args += (\"--postprocessor-args\", f\"-af {self.config.loudnorm}\")\n\n cmd = \" \".join(sbp_args)\n self.log.info(f\"download cmd: {cmd}\")\n self._download_proc = await asyncio.create_subprocess_exec(*sbp_args)\n await self.do_tts(f\"正在下载歌曲{search_key}\")\n self.log.info(f\"正在下载中 {search_key} {name}\")\n await self._download_proc.wait()\n # 下载完成后，修改文件权限\n file_path = os.path.join(self.config.download_path, f\"{name}.mp3\")\n chmodfile(file_path)\n\n async def check_replay(self):\n \"\"\"检查是否需要继续播放被打断的歌曲\"\"\"\n if self.is_playing and not self.isdownloading():\n if not self.config.continue_play:\n # 重新播放歌曲\n self.log.info(\"现在重新播放歌曲\")\n await self._play()\n else:\n self.log.info(\n f\"继续播放歌曲. self.config.continue_play:{self.config.continue_play}\"\n )\n else:\n self.log.info(\n f\"不会继续播放歌曲. isplaying:{self.is_playing} isdownloading:{self.isdownloading()}\"\n )\n\n async def add_download_music(self, name):\n \"\"\"把下载的音乐加入播放列表\"\"\"\n filepath = os.path.join(self.config.download_path, f\"{name}.mp3\")\n self.xiaomusic.music_library.all_music[name] = filepath\n # 应该很快，阻塞运行\n await self.xiaomusic.music_library._gen_all_music_tag({name: filepath})\n if name not in self._play_list:\n self._play_list.append(name)\n self.log.info(f\"add_download_music add_music {name}\")\n self.log.debug(self._play_list)\n\n def get_music(self, direction=\"next\"):\n \"\"\"获取下一首或上一首音乐\"\"\"\n self.update_playlist()\n play_list_len = len(self._play_list)\n if play_list_len == 0:\n self.log.warning(\"当前播放列表没有歌曲\")\n return \"\"\n index = 0\n try:\n index = self._play_list.index(self.get_cur_music())\n except ValueError:\n pass\n\n if play_list_len == 1:\n new_index = index # 当只有一首歌曲时保持当前索引不变\n else:\n if direction == \"next\":\n new_index = index + 1\n if (\n self.device.play_type == PLAY_TYPE_SEQ\n and new_index >= play_list_len\n ):\n self.log.info(\"顺序播放结束\")\n return \"\"\n if new_index >= play_list_len:\n new_index = 0\n elif direction == \"prev\":\n new_index = index - 1\n if new_index < 0:\n new_index = play_list_len - 1\n else:\n self.log.error(\"无效的方向参数\")\n return \"\"\n\n name = self._play_list[new_index]\n if not self.xiaomusic.music_library.is_music_exist(name):\n self._play_list.pop(new_index)\n self.log.info(f\"pop not exist music: {name}\")\n return self.get_music(direction)\n return name\n\n def get_next_music(self):\n \"\"\"获取下一首音乐\"\"\"\n return self.get_music(direction=\"next\")\n\n def get_prev_music(self):\n \"\"\"获取上一首音乐\"\"\"\n return self.get_music(direction=\"prev\")\n\n def check_play_next(self):\n \"\"\"判断是否需要播放下一首歌曲\"\"\"\n # 当前歌曲不在当前播放列表\n if self.get_cur_music() not in self._play_list:\n self.log.info(f\"当前歌曲 {self.get_cur_music()} 不在当前播放列表\")\n return True\n\n # 当前没我在播放的歌曲\n if self.get_cur_music() == \"\":\n self.log.info(\"当前没我在播放的歌曲\")\n return True\n else:\n # 当前播放的歌曲不存在了\n if not self.xiaomusic.music_library.is_music_exist(self.get_cur_music()):\n self.log.info(f\"当前播放的歌曲 {self.get_cur_music()} 不存在了\")\n return True\n return False\n\n async def text_to_speech(self, value):\n \"\"\"文字转语音\"\"\"\n try:\n # 检查是否配置了 edge-tts 语音角色\n if self.config.edge_tts_voice:\n await self._text_to_speech_edge_tts(value)\n else:\n # 使用原有的 TTS 逻辑\n # 有 tts command 优先使用 tts command 说话\n if self.hardware in TTS_COMMAND:\n tts_cmd = TTS_COMMAND[self.hardware]\n self.log.info(\"Call MiIOService tts.\")\n value = value.replace(\" \", \",\") # 不能有空格\n await miio_command(\n self.auth_manager.miio_service,\n self.did,\n f\"{tts_cmd} {value}\",\n )\n else:\n self.log.debug(\"Call MiNAService tts.\")\n await self.auth_manager.mina_service.text_to_speech(\n self.device_id, value\n )\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n async def _text_to_speech_edge_tts(self, value):\n \"\"\"使用 edge-tts 进行文字转语音\"\"\"\n from xiaomusic.utils.music_utils import get_local_music_duration\n from xiaomusic.utils.network_utils import text_to_mp3\n\n self.log.info(f\"_text_to_speech_edge_tts {value}\")\n try:\n # 取消之前的 TTS 定时器\n if self._tts_timer:\n self._tts_timer.cancel()\n self._tts_timer = None\n self.log.info(\"已取消之前的 TTS 定时器\")\n\n # 使用 edge-tts 生成 MP3 文件\n self.log.info(\n f\"使用 edge-tts 生成语音: {value}, voice: {self.config.edge_tts_voice}\"\n )\n mp3_path = await text_to_mp3(\n text=value,\n save_dir=self.config.temp_dir,\n voice=self.config.edge_tts_voice,\n )\n self.log.info(f\"edge-tts 生成的文件路径: {mp3_path}\")\n\n # 生成播放 URL\n url = self.xiaomusic.music_library._get_file_url(mp3_path)\n self.log.info(f\"TTS 播放 URL: {url}\")\n\n # 播放 TTS 音频\n await self.group_player_play(url)\n\n # 获取 MP3 时长\n duration = await get_local_music_duration(mp3_path, self.config)\n self.log.info(f\"TTS 音频时长: {duration} 秒\")\n\n # 创建定时器，时长到后停止\n if duration > 0:\n\n async def _tts_timeout():\n await asyncio.sleep(duration)\n try:\n self.log.info(\"TTS 播放定时器时间到\")\n current_timer = self._tts_timer\n if current_timer:\n # 取消任务（防止任务被重复触发，即使sleep已结束）\n current_timer.cancel()\n try:\n await current_timer # 等待任务取消完成，避免警告\n except asyncio.CancelledError:\n pass\n # 再置空引用\n self._tts_timer = None\n await self.stop(arg1=\"notts\")\n except Exception as e:\n self.log.error(f\"TTS 定时器异常: {e}\")\n\n self._tts_timer = asyncio.create_task(_tts_timeout())\n self.log.info(f\"已设置 TTS 定时器，{duration} 秒后停止\")\n\n except Exception as e:\n self.log.exception(f\"edge-tts 播放失败: {e}\")\n\n async def group_player_play(self, url, name=\"\"):\n \"\"\"同一组设备播放\"\"\"\n device_id_list = self.xiaomusic.device_manager.get_group_device_id_list(\n self.group_name\n )\n tasks = [\n self.play_one_url(device_id, url, name) for device_id in device_id_list\n ]\n results = await asyncio.gather(*tasks)\n self.log.info(f\"group_player_play {url} {device_id_list} {results}\")\n return results\n\n async def play_one_url(self, device_id, url, name):\n \"\"\"在单个设备上播放URL\"\"\"\n ret = None\n try:\n audio_id = await self._get_audio_id(name)\n if self.config.continue_play:\n ret = await self.auth_manager.mina_service.play_by_music_url(\n device_id, url, _type=1, audio_id=audio_id\n )\n self.log.info(\n f\"play_one_url continue_play device_id:{device_id} ret:{ret} url:{url} audio_id:{audio_id}\"\n )\n elif self.config.use_music_api or (\n self.hardware in NEED_USE_PLAY_MUSIC_API\n ):\n ret = await self.auth_manager.mina_service.play_by_music_url(\n device_id, url, audio_id=audio_id\n )\n self.log.info(\n f\"play_one_url play_by_music_url device_id:{device_id} ret:{ret} url:{url} audio_id:{audio_id}\"\n )\n else:\n ret = await self.auth_manager.mina_service.play_by_url(device_id, url)\n self.log.info(\n f\"play_one_url play_by_url device_id:{device_id} ret:{ret} url:{url}\"\n )\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n return ret\n\n async def _get_audio_id(self, name):\n \"\"\"获取音频ID\"\"\"\n audio_id = self.config.use_music_audio_id or \"1582971365183456177\"\n if not (self.config.use_music_api or self.config.continue_play):\n return str(audio_id)\n try:\n params = {\n \"query\": name,\n \"queryType\": 1,\n \"offset\": 0,\n \"count\": 6,\n \"timestamp\": int(time.time_ns() / 1000),\n }\n response = await self.auth_manager.mina_service.mina_request(\n \"/music/search\", params\n )\n for song in response[\"data\"][\"songList\"]:\n if song[\"originName\"] == \"QQ音乐\":\n audio_id = song[\"audioID\"]\n break\n # 没找到QQ音乐的歌曲，取第一个\n if audio_id == 1582971365183456177:\n audio_id = response[\"data\"][\"songList\"][0][\"audioID\"]\n self.log.debug(f\"_get_audio_id. name: {name} songId:{audio_id}\")\n except Exception as e:\n self.log.error(f\"_get_audio_id {e}\")\n return str(audio_id)\n\n async def reset_timer_when_answer(self, answer_length):\n \"\"\"重置计时器（当小爱回答时）\"\"\"\n if not (self.is_playing and self.config.continue_play):\n return\n pause_time = answer_length / 5 + 1\n offset, duration = self.get_offset_duration()\n self._paused_time += pause_time\n new_time = duration - offset + pause_time\n await self.set_next_music_timeout(new_time)\n self.log.info(\n f\"reset_timer 延长定时器. answer_length:{answer_length} pause_time:{pause_time}\"\n )\n\n async def set_next_music_timeout(self, sec):\n \"\"\"设置下一首歌曲的播放定时器\"\"\"\n await self.cancel_next_timer()\n\n async def _do_next():\n await asyncio.sleep(sec)\n try:\n self.log.info(f\"定时器时间到了 did: {self.did}\")\n current_timer = self._next_timer\n if current_timer:\n # 取消任务（防止任务被重复触发，即使sleep已结束）\n current_timer.cancel()\n try:\n await current_timer # 等待任务取消完成，避免警告\n except asyncio.CancelledError:\n pass\n # 再置空引用\n self._next_timer = None\n if self.device.play_type == PLAY_TYPE_SIN:\n self.log.info(f\"单曲播放不继续播放下一首 did: {self.did}\")\n await self.stop(arg1=\"notts\")\n else:\n await self._play_next()\n else:\n self.log.info(f\"定时器时间到了但是不见了 did: {self.did}\")\n await self.stop(arg1=\"notts\")\n\n except Exception as e:\n self.log.error(f\"Execption {e}\")\n\n self._next_timer = asyncio.create_task(_do_next())\n self.log.info(f\"{sec} 秒后将会播放下一首歌曲 did: {self.did}\")\n\n async def set_volume(self, volume: int):\n \"\"\"设置音量\"\"\"\n self.log.info(f\"set_volume. did: {self.did} volume: {volume}\")\n try:\n await self.auth_manager.mina_service.player_set_volume(\n self.device_id, volume\n )\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n async def get_volume(self):\n \"\"\"获取音量\"\"\"\n volume = 0\n try:\n playing_info = await self.auth_manager.mina_service.player_get_status(\n self.device_id\n )\n self.log.info(f\"get_volume. playing_info:{playing_info}\")\n volume = json.loads(playing_info.get(\"data\", {}).get(\"info\", \"{}\")).get(\n \"volume\", 0\n )\n except Exception as e:\n self.log.warning(f\"Execption {e}\")\n volume = int(volume)\n self.log.info(\"get_volume. volume:%d\", volume)\n return volume\n\n async def get_player_status(self):\n \"\"\"获取完整播放状态\"\"\"\n try:\n playing_info = await self.auth_manager.mina_service.player_get_status(\n self.device_id\n )\n self.log.info(f\"get_player_status. playing_info:{playing_info}\")\n info = json.loads(playing_info.get(\"data\", {}).get(\"info\", \"{}\"))\n return info\n except Exception as e:\n self.log.warning(f\"Execption {e}\")\n return {\"volume\": 0, \"status\": 0}\n\n async def set_play_type(self, play_type, dotts=True):\n \"\"\"设置播放类型\"\"\"\n self.device.play_type = play_type\n # 发布设备配置变更事件\n if self.event_bus:\n self.event_bus.publish(DEVICE_CONFIG_CHANGED)\n if dotts:\n tts = self.config.get_play_type_tts(play_type)\n await self.do_tts(tts)\n self.update_playlist()\n\n async def play_music_list(self, list_name, music_name):\n \"\"\"播放指定播放列表\"\"\"\n self._last_cmd = \"play_music_list\"\n self.device.cur_playlist = list_name\n self.update_playlist()\n if not music_name:\n music_name = self.device.playlist2music.get(list_name, \"\")\n self.log.info(f\"开始播放列表{list_name} {music_name}\")\n await self._play(music_name)\n\n async def stop(self, arg1=\"\"):\n \"\"\"停止播放\"\"\"\n self._last_cmd = \"stop\"\n self.is_playing = False\n if arg1 != \"notts\":\n await self.do_tts(self.config.stop_tts_msg)\n await asyncio.sleep(3) # 等它说完\n # 取消组内所有的下一首歌曲的定时器\n await self.cancel_group_next_timer()\n await self.group_force_stop_xiaoai()\n self.log.info(\"stop now\")\n\n async def group_force_stop_xiaoai(self):\n \"\"\"强制停止组内所有设备\"\"\"\n device_id_list = self.xiaomusic.device_manager.get_group_device_id_list(\n self.group_name\n )\n self.log.info(f\"group_force_stop_xiaoai {self.group_name} {device_id_list}\")\n tasks = [self.force_stop_xiaoai(device_id) for device_id in device_id_list]\n results = await asyncio.gather(*tasks)\n self.log.info(f\"group_force_stop_xiaoai {device_id_list} {results}\")\n return results\n\n async def stop_after_minute(self, minute: int):\n \"\"\"定时关机\"\"\"\n if self._stop_timer:\n self._stop_timer.cancel()\n self._stop_timer = None\n self.log.info(\"关机定时器已取消\")\n\n async def _do_stop():\n await asyncio.sleep(minute * 60)\n try:\n await self.stop(arg1=\"notts\")\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n self._stop_timer = asyncio.create_task(_do_stop())\n await self.do_tts(f\"收到,{minute}分钟后将关机\")\n\n async def cancel_next_timer(self):\n \"\"\"取消下一首定时器\"\"\"\n self.log.info(f\"cancel_next_timer did: {self.did}\")\n if self._next_timer:\n self._next_timer.cancel()\n try:\n await self._next_timer\n except asyncio.CancelledError:\n pass\n self.log.info(f\"下一曲定时器已取消 did: {self.did}\")\n self._next_timer = None\n else:\n self.log.info(f\"下一曲定时器不见了 did: {self.did}\")\n\n async def cancel_group_next_timer(self):\n \"\"\"取消组内所有设备的下一首定时器\"\"\"\n devices = self.xiaomusic.device_manager.get_group_devices(self.group_name)\n self.log.info(f\"cancel_group_next_timer {devices}\")\n for device in devices.values():\n await device.cancel_next_timer()\n\n def get_cur_play_list(self):\n \"\"\"获取当前播放列表名称\"\"\"\n return self.device.cur_playlist\n\n def cancel_all_timer(self):\n \"\"\"清空所有定时器\"\"\"\n self.log.info(\"in cancel_all_timer\")\n if self._next_timer:\n self._next_timer.cancel()\n self._next_timer = None\n self.log.info(\"cancel_all_timer _next_timer.cancel\")\n\n if self._stop_timer:\n self._stop_timer.cancel()\n self._stop_timer = None\n self.log.info(\"cancel_all_timer _stop_timer.cancel\")\n\n if self._tts_timer:\n self._tts_timer.cancel()\n self._tts_timer = None\n self.log.info(\"cancel_all_timer _tts_timer.cancel\")\n\n @classmethod\n def dict_clear(cls, d):\n \"\"\"清空设备字典并取消所有定时器\"\"\"\n for key in list(d):\n val = d.pop(key)\n val.cancel_all_timer()\n\n def find_cur_playlist(self, name):\n \"\"\"根据当前歌曲匹配歌曲列表\n\n 匹配顺序：\n 1. 收藏\n 2. 最近新增\n 3. 排除（全部,所有歌曲,所有电台）\n 4. 所有歌曲\n 5. 所有电台\n 6. 全部\n \"\"\"\n music_list = self.xiaomusic.music_library.music_list\n if name in music_list.get(\"收藏\", []):\n return \"收藏\"\n if name in music_list.get(\"最近新增\", []):\n return \"最近新增\"\n for list_name, play_list in music_list.items():\n if (list_name not in [\"全部\", \"所有歌曲\", \"所有电台\"]) and (\n name in play_list\n ):\n return list_name\n if name in music_list.get(\"所有歌曲\", []):\n return \"所有歌曲\"\n if name in music_list.get(\"所有电台\", []):\n return \"所有电台\"\n return \"全部\"\n" }, { "path": "xiaomusic/events.py", "content": "\"\"\"事件系统模块\n\n提供简单的事件发布-订阅机制，用于模块间的解耦通信。\n\"\"\"\n\nfrom collections.abc import Callable\n\n# 事件类型常量\nCONFIG_CHANGED = \"config_changed\"\nDEVICE_CONFIG_CHANGED = \"device_config_changed\"\n\n\nclass EventBus:\n \"\"\"事件总线类\n\n 实现简单的发布-订阅模式，支持事件的订阅、取消订阅和发布。\n \"\"\"\n\n def __init__(self):\n \"\"\"初始化事件总线\"\"\"\n self._subscribers: dict[str, list[Callable]] = {}\n\n def subscribe(self, event_type: str, callback: Callable) -> None:\n \"\"\"订阅事件\n\n Args:\n event_type: 事件类型\n callback: 回调函数\n \"\"\"\n if event_type not in self._subscribers:\n self._subscribers[event_type] = []\n if callback not in self._subscribers[event_type]:\n self._subscribers[event_type].append(callback)\n\n def unsubscribe(self, event_type: str, callback: Callable) -> None:\n \"\"\"取消订阅事件\n\n Args:\n event_type: 事件类型\n callback: 回调函数\n \"\"\"\n if event_type in self._subscribers:\n if callback in self._subscribers[event_type]:\n self._subscribers[event_type].remove(callback)\n\n def publish(self, event_type: str, **kwargs) -> None:\n \"\"\"发布事件\n\n Args:\n event_type: 事件类型\n **kwargs: 事件参数\n \"\"\"\n if event_type in self._subscribers:\n for callback in self._subscribers[event_type]:\n try:\n callback(**kwargs)\n except Exception as e:\n # 避免某个订阅者的异常影响其他订阅者\n print(f\"Error in event callback for {event_type}: {e}\")\n" }, { "path": "xiaomusic/file_watcher.py", "content": "\"\"\"文件监控模块\n\n提供音乐目录的文件变化监控功能，支持防抖延迟处理。\n\"\"\"\n\nimport os\n\nfrom watchdog.events import (\n FileCreatedEvent,\n FileDeletedEvent,\n FileMovedEvent,\n FileSystemEventHandler,\n)\nfrom watchdog.observers import Observer\n\nfrom xiaomusic.const import SUPPORT_MUSIC_TYPE\n\n\nclass XiaoMusicPathWatch(FileSystemEventHandler):\n \"\"\"音乐目录监控类\n\n 使用延迟防抖机制，仅监控音乐文件的创建、删除和移动事件。\n\n Attributes:\n callback: 文件变化时的回调函数\n debounce_delay: 防抖延迟时间（秒）\n loop: asyncio 事件循环\n \"\"\"\n\n def __init__(self, callback, debounce_delay, loop):\n \"\"\"初始化文件监控器\n\n Args:\n callback: 文件变化时的回调函数\n debounce_delay: 防抖延迟时间（秒）\n loop: asyncio 事件循环对象\n \"\"\"\n self.callback = callback\n self.debounce_delay = debounce_delay\n self.loop = loop\n self._debounce_handle = None\n\n def on_any_event(self, event):\n \"\"\"处理文件系统事件\n\n 只处理音乐文件的创建、删除和移动事件，忽略目录事件。\n\n Args:\n event: 文件系统事件对象\n \"\"\"\n # 只处理文件的创建、删除和移动事件\n if not isinstance(event, FileCreatedEvent | FileDeletedEvent | FileMovedEvent):\n return\n\n if event.is_directory:\n return # 忽略目录事件\n\n # 处理文件事件\n src_ext = os.path.splitext(event.src_path)[1].lower()\n # 处理移动事件的目标路径\n if hasattr(event, \"dest_path\"):\n dest_ext = os.path.splitext(event.dest_path)[1].lower()\n if dest_ext in SUPPORT_MUSIC_TYPE:\n self.schedule_callback()\n return\n\n if src_ext in SUPPORT_MUSIC_TYPE:\n self.schedule_callback()\n\n def schedule_callback(self):\n \"\"\"调度回调函数执行\n\n 使用防抖机制，在延迟时间内如果有新的事件，会取消之前的调度。\n \"\"\"\n\n def _execute_callback():\n self._debounce_handle = None\n self.callback()\n\n if self._debounce_handle:\n self._debounce_handle.cancel()\n self._debounce_handle = self.loop.call_later(\n self.debounce_delay, _execute_callback\n )\n\n\nclass FileWatcherManager:\n \"\"\"文件监控管理器\n\n 负责启动和停止文件监控服务。\n \"\"\"\n\n def __init__(self, config, log, on_change_callback):\n \"\"\"初始化文件监控管理器\n\n Args:\n config: 配置对象\n log: 日志对象\n on_change_callback: 文件变化时的回调函数\n \"\"\"\n self.config = config\n self.log = log\n self.on_change_callback = on_change_callback\n self._observer = None\n self._file_watch_handler = None\n\n def start(self, loop):\n \"\"\"启动文件监控（支持重入）\n\n 如果监控器已在运行，会先停止再重新启动。\n\n Args:\n loop: asyncio 事件循环对象\n \"\"\"\n # 如果已经在运行，先停止\n if self._observer:\n self.stop()\n\n if not self.config.enable_file_watch:\n self.log.info(\"目录监控功能已关闭\")\n return\n\n if not loop:\n self.log.warning(\"无法获取运行中的事件循环，目录监控功能可能无法正常工作\")\n return\n\n # 创建文件监控处理器\n self._file_watch_handler = XiaoMusicPathWatch(\n callback=self.on_change_callback,\n debounce_delay=self.config.file_watch_debounce,\n loop=loop,\n )\n\n # 创建并启动监控器\n self._observer = Observer()\n self._observer.schedule(\n self._file_watch_handler, self.config.music_path, recursive=True\n )\n self._observer.start()\n self.log.info(f\"已启动对 {self.config.music_path} 的目录监控。\")\n\n def stop(self):\n \"\"\"停止文件监控（支持重入）\n\n 如果监控器未运行，不做任何操作。\n \"\"\"\n if self._observer:\n self._observer.stop()\n self._observer.join()\n self.log.info(\"已停止目录监控。\")\n self._observer = None\n self._file_watch_handler = None\n" }, { "path": "xiaomusic/holiday.py", "content": "import json\nimport logging\nimport os\nfrom datetime import date\n\nlog = logging.getLogger(__package__)\n\n# 用于存储已加载的年份数据\nloaded_years = {}\n\n\ndef load_year_data(year):\n \"\"\"加载指定年份的节假日数据\"\"\"\n global loaded_years\n\n if year in loaded_years:\n return True\n\n file_path = f\"holiday/{year}.json\"\n if not os.path.exists(file_path):\n log.warning(f\"未找到 {file_path} 文件。\")\n return False\n\n try:\n with open(file_path, encoding=\"utf-8\") as file:\n data = json.load(file)\n loaded_years[year] = {\n day_info[\"date\"]: day_info[\"isOffDay\"]\n for day_info in data.get(\"days\", [])\n }\n log.info(f\"成功加载 {year} 年数据。\")\n log.debug(f\"加载的日期数据: {loaded_years[year]}\")\n return True\n except Exception as e:\n log.error(f\"加载 {year} 年数据失败: {e}\")\n return False\n\n\ndef is_valid_date(year, month, day):\n \"\"\"检查日期是否有效\"\"\"\n try:\n date(year, month, day)\n return True\n except ValueError:\n return False\n\n\ndef is_weekend(year, month, day):\n \"\"\"判断是否为周末\"\"\"\n weekday = date(year, month, day).isoweekday()\n return weekday >= 6 # 周六或周日\n\n\ndef is_off_day(year, month, day):\n \"\"\"判断是否为休息日（包括法定节假日和周末）\"\"\"\n # 检查日期有效性\n if not is_valid_date(year, month, day):\n log.warning(f\"无效日期: {year}-{month:02d}-{day:02d}\")\n return None\n\n # 加载年份数据\n if not load_year_data(year):\n return None\n\n date_str = f\"{year}-{month:02d}-{day:02d}\"\n\n # 检查是否为特殊日期\n special_day = loaded_years[year].get(date_str)\n if special_day is not None:\n return special_day\n\n # 检查是否为周末\n return is_weekend(year, month, day)\n\n\ndef is_working_day(year, month, day):\n \"\"\"判断是否为工作日（非休息日）\"\"\"\n off_day = is_off_day(year, month, day)\n return False if off_day is None else not off_day\n" }, { "path": "xiaomusic/js_adapter.py", "content": "#!/usr/bin/env python3\n\"\"\"\nJS 插件适配器\n将 MusicFree JS 插件的数据格式转换为 xiaomusic 接口规范\n\"\"\"\n\nimport logging\n\n\nclass JSAdapter:\n \"\"\"JS 插件数据适配器\"\"\"\n\n def __init__(self, xiaomusic):\n self.xiaomusic = xiaomusic\n self.log = logging.getLogger(__name__)\n\n def format_search_results(\n self, plugin_results: list[dict], plugin_name: str\n ) -> list[str]:\n \"\"\"格式化搜索结果为 xiaomusic 格式，返回 ID 列表\"\"\"\n formatted_ids = []\n for item in plugin_results:\n if not isinstance(item, dict):\n self.log.warning(f\"Invalid item format in plugin {plugin_name}: {item}\")\n continue\n\n # 构造符合 xiaomusic 格式的音乐项\n music_id = self._generate_music_id(\n plugin_name, item.get(\"id\", \"\"), item.get(\"songmid\", \"\")\n )\n music_item = {\n \"id\": music_id,\n \"title\": item.get(\"title\", item.get(\"name\", \"\")),\n \"artist\": self._extract_artists(item),\n \"album\": item.get(\"album\", item.get(\"albumName\", \"\")),\n \"source\": \"online\",\n \"plugin_name\": plugin_name,\n \"original_data\": item,\n \"duration\": item.get(\"duration\", 0),\n \"cover\": item.get(\n \"artwork\", item.get(\"cover\", item.get(\"albumPic\", \"\"))\n ),\n \"url\": item.get(\"url\", \"\"),\n \"lyric\": item.get(\"lyric\", item.get(\"lrc\", \"\")),\n \"quality\": item.get(\"quality\", \"\"),\n }\n\n # 添加到 all_music 字典中\n self.xiaomusic.music_library.all_music[music_id] = music_item\n formatted_ids.append(music_id)\n\n return formatted_ids\n\n def format_media_source_result(\n self, media_source_result: dict, music_item: dict\n ) -> dict:\n \"\"\"格式化媒体源结果\"\"\"\n if not media_source_result:\n return {}\n\n formatted = {\n \"url\": media_source_result.get(\"url\", \"\"),\n \"headers\": media_source_result.get(\"headers\", {}),\n \"userAgent\": media_source_result.get(\n \"userAgent\", media_source_result.get(\"user_agent\", \"\")\n ),\n }\n\n return formatted\n\n def format_lyric_result(self, lyric_result: dict) -> str:\n \"\"\"格式化歌词结果为 lrc 格式字符串\"\"\"\n if not lyric_result:\n return \"\"\n\n # 获取原始歌词和翻译\n raw_lrc = lyric_result.get(\"rawLrc\", lyric_result.get(\"raw_lrc\", \"\"))\n translation = lyric_result.get(\"translation\", \"\")\n\n # 如果有翻译，合并歌词和翻译\n if translation and raw_lrc:\n # 这里可以实现歌词和翻译的合并逻辑\n return f\"{raw_lrc}\\n{translation}\"\n\n return raw_lrc or translation or \"\"\n\n def format_album_info_result(self, album_info_result: dict) -> dict:\n \"\"\"格式化专辑信息结果\"\"\"\n if not album_info_result:\n return {}\n\n album_item = album_info_result.get(\"albumItem\", {})\n formatted = {\n \"isEnd\": album_info_result.get(\"isEnd\", True),\n \"musicList\": self.format_search_results(\n album_info_result.get(\"musicList\", []), \"album\"\n ),\n \"albumItem\": {\n \"title\": album_item.get(\"title\", \"\"),\n \"artist\": album_item.get(\"artist\", \"\"),\n \"cover\": album_item.get(\"cover\", \"\"),\n \"description\": album_item.get(\"description\", \"\"),\n },\n }\n\n return formatted\n\n def format_music_sheet_info_result(self, music_sheet_result: dict) -> dict:\n \"\"\"格式化音乐单信息结果\"\"\"\n if not music_sheet_result:\n return {}\n sheet_item = music_sheet_result.get(\"sheetItem\", {})\n formatted = {\n \"isEnd\": music_sheet_result.get(\"isEnd\", True),\n \"musicList\": self.format_search_results(\n music_sheet_result.get(\"musicList\", []), \"playlist\"\n ),\n \"sheetItem\": {\n \"title\": sheet_item.get(\"title\", \"\"),\n \"cover\": sheet_item.get(\"cover\", \"\"),\n \"description\": sheet_item.get(\"description\", \"\"),\n },\n }\n\n return formatted\n\n def format_artist_works_result(self, artist_works_result: dict) -> dict:\n \"\"\"格式化艺术家作品结果\"\"\"\n if not artist_works_result:\n return {}\n\n formatted = {\n \"isEnd\": artist_works_result.get(\"isEnd\", True),\n \"data\": self.format_search_results(\n artist_works_result.get(\"data\", []), \"artist\"\n ),\n }\n\n return formatted\n\n def format_top_lists_result(self, top_lists_result: list[dict]) -> list[dict]:\n \"\"\"格式化榜单列表结果\"\"\"\n if not top_lists_result:\n return []\n\n formatted = []\n for group in top_lists_result:\n formatted_group = {\"title\": group.get(\"title\", \"\"), \"data\": []}\n\n for item in group.get(\"data\", []):\n formatted_item = {\n \"id\": item.get(\"id\", \"\"),\n \"title\": item.get(\"title\", \"\"),\n \"description\": item.get(\"description\", \"\"),\n \"coverImg\": item.get(\"coverImg\", item.get(\"cover\", \"\")),\n }\n formatted_group[\"data\"].append(formatted_item)\n\n formatted.append(formatted_group)\n\n return formatted\n\n def format_top_list_detail_result(self, top_list_detail_result: dict) -> dict:\n \"\"\"格式化榜单详情结果\"\"\"\n if not top_list_detail_result:\n return {}\n\n formatted = {\n \"isEnd\": top_list_detail_result.get(\"isEnd\", True),\n \"musicList\": self.format_search_results(\n top_list_detail_result.get(\"musicList\", []), \"toplist\"\n ),\n \"topListItem\": top_list_detail_result.get(\"topListItem\", {}),\n }\n\n return formatted\n\n def _generate_music_id(\n self, plugin_name: str, item_id: str, fallback_id: str = \"\"\n ) -> str:\n \"\"\"生成唯一音乐ID\"\"\"\n if item_id:\n return f\"online_{plugin_name}_{item_id}\"\n else:\n # 如果没有 id，尝试使用其他标识符\n return f\"online_{plugin_name}_{fallback_id}\"\n\n def _extract_artists(self, item: dict) -> str:\n \"\"\"提取艺术家信息\"\"\"\n # 尝试多种可能的艺术家字段\n artist_fields = [\"artist\", \"artists\", \"singer\", \"author\", \"creator\", \"singers\"]\n\n for field in artist_fields:\n if field not in item:\n continue\n value = item[field]\n if isinstance(value, list):\n # 如果是艺术家列表，连接为字符串\n artists = []\n for artist in value:\n if isinstance(artist, dict):\n artists.append(artist.get(\"name\", str(artist)))\n else:\n artists.append(str(artist))\n return \", \".join(artists)\n elif isinstance(value, dict):\n # 如果是艺术家对象\n return value.get(\"name\", str(value))\n elif value:\n return str(value)\n\n # 如果没有找到艺术家信息，返回默认值\n return \"未知艺术家\"\n\n def convert_music_item_for_plugin(self, music_item: dict) -> dict:\n \"\"\"将 xiaomusic 音乐项转换为插件兼容格式\"\"\"\n # 如果原始数据存在，优先使用原始数据\n if isinstance(music_item, dict) and \"original_data\" in music_item:\n return music_item[\"original_data\"]\n\n # 否则构造一个基本的音乐项\n converted = {\n \"id\": music_item.get(\"id\", \"\"),\n \"title\": music_item.get(\"title\", \"\"),\n \"artist\": music_item.get(\"artist\", \"\"),\n \"album\": music_item.get(\"album\", \"\"),\n \"url\": music_item.get(\"url\", \"\"),\n \"duration\": music_item.get(\"duration\", 0),\n \"artwork\": music_item.get(\"cover\", \"\"),\n \"lyric\": music_item.get(\"lyric\", \"\"),\n \"quality\": music_item.get(\"quality\", \"\"),\n }\n\n return converted\n" }, { "path": "xiaomusic/js_plugin_manager.py", "content": "#!/usr/bin/env python3\n\"\"\"\nJS 插件管理器\n负责加载、管理和运行 MusicFree JS 插件\n\"\"\"\n\nimport json\nimport logging\nimport os\nimport shutil\nimport subprocess\nimport threading\nimport time\nfrom typing import Any\n\n\nclass JSPluginManager:\n \"\"\"JS 插件管理器\"\"\"\n\n def __init__(self, xiaomusic):\n self.xiaomusic = xiaomusic\n base_path = self.xiaomusic.config.conf_path\n self.log = logging.getLogger(__name__)\n # JS插件文件夹：\n self.plugins_dir = os.path.join(base_path, \"js_plugins\")\n # 插件配置Json：\n self.plugins_config_path = os.path.join(base_path, \"plugins-config.json\")\n self.plugins = {} # 插件状态信息\n self.node_process = None\n self.message_queue = []\n self.response_handlers = {}\n self._lock = threading.Lock()\n self.request_id = 0\n self.pending_requests = {}\n self._is_shutting_down = False # 添加关闭标志\n\n # 进程重启控制\n self._restart_count = 0 # 重启计数器\n self._last_restart_time = 0 # 上次重启时间戳\n self._restart_window = 60 # 重启时间窗口（秒）\n self._max_restarts_in_window = 1 # 时间窗口内最大重启次数\n\n # ... 配置文件相关 ...\n self._config_cache = None\n self._config_cache_time = 0\n self._config_cache_ttl = 3 * 60 # 缓存有效期5秒，可根据需要调整\n\n # 启动 Node.js 子进程\n self._start_node_process()\n\n # 启动消息处理线程\n self._start_message_handler()\n\n # 加载插件\n self._load_plugins()\n\n def _start_node_process(self):\n \"\"\"启动 Node.js 子进程\"\"\"\n runner_path = os.path.join(os.path.dirname(__file__), \"js_plugin_runner.js\")\n\n try:\n self.node_process = subprocess.Popen(\n [\"node\", \"--max-old-space-size=128\", runner_path],\n stdin=subprocess.PIPE,\n stdout=subprocess.PIPE,\n stderr=subprocess.PIPE,\n text=True,\n encoding=\"utf-8\",\n errors=\"replace\",\n bufsize=1, # 行缓冲\n )\n\n self.log.info(\"Node.js process started successfully\")\n\n # 启动进程监控线程\n threading.Thread(target=self._monitor_node_process, daemon=True).start()\n\n except Exception as e:\n self.log.error(f\"Failed to start Node.js process: {e}\")\n raise\n\n def _monitor_node_process(self):\n \"\"\"监控 Node.js 进程状态\"\"\"\n while True:\n if self._is_shutting_down:\n break\n if self.node_process and self.node_process.poll() is not None:\n if not self._is_shutting_down:\n self._attempt_restart_node_process()\n time.sleep(5)\n\n def _attempt_restart_node_process(self):\n \"\"\"尝试重启 Node.js 进程，带有限制机制\"\"\"\n current_time = time.time()\n\n # 检查是否在重启时间窗口内\n if current_time - self._last_restart_time < self._restart_window:\n # 在时间窗口内，检查重启次数\n if self._restart_count >= self._max_restarts_in_window:\n self.log.error(\n f\"Node.js process restart limit exceeded: {self._restart_count} restarts in {self._restart_window} seconds. \"\n \"Manual intervention required.\"\n )\n return False\n else:\n # 超出时间窗口，重置计数器\n self._restart_count = 0\n\n # 执行重启\n self._restart_count += 1\n self._last_restart_time = current_time\n\n remaining_attempts = self._max_restarts_in_window - self._restart_count\n self.log.warning(\n f\"Node.js process died, attempting restart ({self._restart_count}/{self._max_restarts_in_window}). \"\n f\"Remaining attempts in current window: {remaining_attempts}\"\n )\n\n try:\n self._start_node_process()\n return True\n except Exception as e:\n self.log.error(f\"Failed to restart Node.js process: {e}\")\n return False\n\n def _start_message_handler(self):\n \"\"\"启动消息处理线程\"\"\"\n\n def stdout_handler():\n while True:\n if self.node_process and self.node_process.stdout:\n try:\n line = self.node_process.stdout.readline()\n if line:\n response = json.loads(line.strip())\n self._handle_response(response)\n except json.JSONDecodeError as e:\n # 捕获非 JSON 输出（可能是插件的调试信息或错误信息）\n self.log.warning(\n f\"Non-JSON output from Node.js process: {line.strip()}, error: {e}\"\n )\n except Exception as e:\n self.log.error(f\"Message handler error: {e}\")\n time.sleep(0.1)\n\n def stderr_handler():\n \"\"\"处理 Node.js 进程的错误输出\"\"\"\n while True:\n if self.node_process and self.node_process.stderr:\n try:\n error_line = self.node_process.stderr.readline()\n if error_line:\n self.log.error(\n f\"Node.js process error output: {error_line.strip()}\"\n )\n except Exception as e:\n self.log.error(f\"Error handler error: {e}\")\n time.sleep(0.1)\n\n threading.Thread(target=stdout_handler, daemon=True).start()\n threading.Thread(target=stderr_handler, daemon=True).start()\n\n def _send_message(\n self, message: dict[str, Any], timeout: int = 30\n ) -> dict[str, Any]:\n \"\"\"发送消息到 Node.js 子进程\"\"\"\n with self._lock:\n # 检查进程状态，必要时尝试重启\n if not self.node_process or self.node_process.poll() is not None:\n self.log.warning(\n \"Node.js process not available, checking restart possibility...\"\n )\n # 尝试重启进程\n if not self._attempt_restart_node_process():\n raise Exception(\"Node.js process not available and restart failed\")\n\n # 等待进程稳定\n time.sleep(1)\n\n # 再次检查进程状态\n if not self.node_process or self.node_process.poll() is not None:\n raise Exception(\n \"Node.js process not available after restart attempt\"\n )\n\n message_id = f\"msg_{int(time.time() * 1000)}\"\n message[\"id\"] = message_id\n\n # 记录发送的消息\n self.log.info(\n f\"JS Plugin Manager sending message: {message.get('action', 'unknown')} for plugin: {message.get('pluginName', 'unknown')}\"\n )\n if \"params\" in message:\n self.log.info(f\"JS Plugin Manager search params: {message['params']}\")\n elif \"musicItem\" in message:\n self.log.info(f\"JS Plugin Manager music item: {message['musicItem']}\")\n\n # 发送消息\n self.node_process.stdin.write(json.dumps(message) + \"\\n\")\n self.node_process.stdin.flush()\n\n # 等待响应\n response = self._wait_for_response(message_id, timeout)\n self.log.info(\n f\"JS Plugin Manager received response for message {message_id}: {response.get('success', 'unknown')}\"\n )\n return response\n\n def _wait_for_response(self, message_id: str, timeout: int) -> dict[str, Any]:\n \"\"\"等待特定消息的响应\"\"\"\n start_time = time.time()\n\n while time.time() - start_time < timeout:\n if message_id in self.response_handlers:\n response = self.response_handlers.pop(message_id)\n return response\n time.sleep(0.1)\n\n raise TimeoutError(f\"Message {message_id} timeout\")\n\n def _handle_response(self, response: dict[str, Any]):\n \"\"\"处理 Node.js 进程的响应\"\"\"\n message_id = response.get(\"id\")\n self.log.debug(\n f\"JS Plugin Manager received raw response: {response}\"\n ) # 添加原始响应日志\n\n # 添加更严格的数据验证\n if not isinstance(response, dict):\n self.log.error(\n f\"JS Plugin Manager received invalid response type: {type(response)}, value: {response}\"\n )\n return\n\n if \"id\" not in response:\n self.log.error(\n f\"JS Plugin Manager received response without id: {response}\"\n )\n return\n\n # 确保 success 字段存在\n if \"success\" not in response:\n self.log.warning(\n f\"JS Plugin Manager received response without success field: {response}\"\n )\n response[\"success\"] = False\n\n # 如果有 result 字段，验证其结构\n if \"result\" in response and response[\"result\"] is not None:\n result = response[\"result\"]\n if isinstance(result, dict):\n # 对搜索结果进行特殊处理\n if \"data\" in result and not isinstance(result[\"data\"], list):\n self.log.warning(\n f\"JS Plugin Manager received result with invalid data type: {type(result['data'])}, setting to empty list\"\n )\n result[\"data\"] = []\n\n if message_id:\n self.response_handlers[message_id] = response\n\n \"\"\"------------------------------开放接口相关函数----------------------------------------\"\"\"\n\n def get_aiapi_info(self) -> dict[str, Any]:\n \"\"\"获取AI接口配置信息\n Returns:\n Dict[str, Any]: 包含 OpenAPI 配置信息的字典，包括启用状态和搜索 URL\n \"\"\"\n try:\n # 读取配置文件中的 OpenAPI 配置信息\n config_data = self._get_config_data()\n if config_data:\n return config_data.get(\"aiapi_info\", {})\n else:\n return {\"enabled\": False}\n except Exception as e:\n self.log.error(f\"Failed to read OpenAPI info from config: {e}\")\n return {}\n\n def get_openapi_info(self) -> dict[str, Any]:\n \"\"\"获取开放接口配置信息\n Returns:\n Dict[str, Any]: 包含 OpenAPI 配置信息的字典，包括启用状态和搜索 URL\n \"\"\"\n try:\n # 读取配置文件中的 OpenAPI 配置信息\n config_data = self._get_config_data()\n if config_data:\n # 返回 openapi_info 配置项\n return config_data.get(\"openapi_info\", {})\n else:\n return {\"enabled\": False}\n except Exception as e:\n self.log.error(f\"Failed to read OpenAPI info from config: {e}\")\n return {}\n\n def toggle_openapi(self) -> dict[str, Any]:\n \"\"\"切换开放接口配置状态\"\"\"\n try:\n if os.path.exists(self.plugins_config_path):\n with open(self.plugins_config_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n openapi_info = config_data.get(\"openapi_info\", {})\n current_enabled = openapi_info.get(\"enabled\", False)\n openapi_info[\"enabled\"] = not current_enabled\n config_data[\"openapi_info\"] = openapi_info\n\n with open(self.plugins_config_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n # 使缓存失效\n self._invalidate_config_cache()\n return {\"success\": True}\n else:\n return {\"success\": False}\n except Exception as e:\n self.log.error(f\"Failed to toggle OpenAPI config: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n def update_openapi_url(self, openapi_url: str) -> dict[str, Any]:\n \"\"\"更新开放接口地址\"\"\"\n try:\n if os.path.exists(self.plugins_config_path):\n with open(self.plugins_config_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n openapi_info = config_data.get(\"openapi_info\", {})\n openapi_info[\"search_url\"] = openapi_url\n config_data[\"openapi_info\"] = openapi_info\n\n with open(self.plugins_config_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n\n # 使缓存失效\n self._invalidate_config_cache()\n return {\"success\": True}\n else:\n return {\"success\": False}\n except Exception as e:\n self.log.error(f\"Failed to update OpenAPI config: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n def get_plugin_source(self) -> dict[str, Any]:\n \"\"\"获取插件源配置信息\n Returns:\n Dict[str, Any]: 包含 OpenAPI 配置信息的字典，包括启用状态和搜索 URL\n \"\"\"\n try:\n # 读取配置文件中的 OpenAPI 配置信息\n config_data = self._get_config_data()\n if config_data:\n # 返回 openapi_info 配置项\n return config_data.get(\"plugin_source\", {})\n else:\n return {\"enabled\": False}\n except Exception as e:\n self.log.error(f\"Failed to read plugin source info from config: {e}\")\n return {}\n\n def refresh_plugin_source(self) -> dict[str, Any]:\n \"\"\"更新订阅源\"\"\"\n try:\n if os.path.exists(self.plugins_config_path):\n with open(self.plugins_config_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n plugin_source = config_data.get(\"plugin_source\", {})\n source_url = plugin_source.get(\"source_url\", \"\")\n if source_url:\n import requests\n\n # 请求源地址\n response = requests.get(source_url, timeout=30)\n response.raise_for_status() # 抛出HTTP错误\n # 解析响应JSON\n json_data = response.json()\n # 校验响应格式 - 检查是否包含 plugins 数组\n if not isinstance(json_data, dict) or \"plugins\" not in json_data:\n return {\"success\": False, \"error\": \"无效订阅源！\"}\n plugins_array = json_data[\"plugins\"]\n if not isinstance(plugins_array, list):\n return {\"success\": False, \"error\": \"无效订阅源！\"}\n # 写入插件文本\n self.download_and_save_plugin(plugins_array)\n # 使缓存失效\n self._invalidate_config_cache()\n self.reload_plugins()\n return {\"success\": True}\n else:\n return {\"success\": False, \"error\": \"未找到配置订阅源！\"}\n else:\n return {\"success\": False}\n except Exception as e:\n self.log.error(f\"Failed to toggle OpenAPI config: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n def download_and_save_plugin(self, plugins_array: list) -> bool:\n \"\"\"下载并保存插件数组中的所有插件\n\n Args:\n plugins_array: 插件信息列表，格式如 [{\"name\": \"plugin_name\", \"url\": \"plugin_url\", \"version\": \"version\"}, ...]\n\n Returns:\n bool: 所有插件下载保存是否全部成功\n \"\"\"\n if not plugins_array or not isinstance(plugins_array, list):\n self.log.warning(\"Empty or invalid plugins array provided\")\n return False\n\n all_success = True\n\n for plugin_info in plugins_array:\n if (\n not isinstance(plugin_info, dict)\n or \"name\" not in plugin_info\n or \"url\" not in plugin_info\n ):\n self.log.warning(f\"Invalid plugin entry: {plugin_info}\")\n all_success = False\n continue\n\n plugin_name = plugin_info[\"name\"]\n plugin_url = plugin_info[\"url\"]\n\n if not plugin_name or not plugin_url:\n self.log.warning(f\"Invalid plugin entry: {plugin_name} -> {plugin_url}\")\n all_success = False\n continue\n\n # 调用单个插件下载方法\n success = self.download_single_plugin(plugin_name, plugin_url)\n if not success:\n all_success = False\n self.log.error(f\"Failed to download plugin: {plugin_name}\")\n\n return all_success\n\n def download_single_plugin(self, plugin_name: str, plugin_url: str) -> bool:\n \"\"\"下载并保存单个插件\n\n Args:\n plugin_name: 插件名称\n plugin_url: 插件下载URL\n\n Returns:\n bool: 下载保存是否成功\n \"\"\"\n import requests\n\n # 检查插件名称是否合法\n sys_files = [\"ALL\", \"all\", \"OpenAPI\", \"OPENAPI\"]\n if plugin_name in sys_files:\n self.log.error(f\"Plugin name {plugin_name} is reserved and cannot be used\")\n return False\n\n # 创建插件目录\n os.makedirs(self.plugins_dir, exist_ok=True)\n\n # 生成文件路径\n plugin_filename = f\"{plugin_name}.js\"\n file_path = os.path.join(self.plugins_dir, plugin_filename)\n\n # 检查是否已存在同名插件\n if os.path.exists(file_path):\n self.log.warning(f\"Plugin {plugin_name} already exists, will overwrite\")\n\n try:\n # 下载插件内容\n response = requests.get(plugin_url, timeout=30)\n response.raise_for_status()\n\n # 验证下载的内容是否为有效的JS代码（简单检查是否以有意义的JS字符开头）\n content = response.text.strip()\n if not content:\n self.log.error(f\"Downloaded plugin {plugin_name} has empty content\")\n return False\n\n # 保存插件文件\n with open(file_path, \"w\", encoding=\"utf-8\") as f:\n f.write(content)\n\n self.log.info(f\"Successfully downloaded and saved plugin: {plugin_name}\")\n\n # 更新插件配置\n self.update_plugin_config(plugin_name, plugin_filename)\n return True\n\n except requests.exceptions.RequestException as e:\n self.log.error(\n f\"Failed to download plugin {plugin_name} from {plugin_url}: {e}\"\n )\n return False\n except Exception as e:\n self.log.error(f\"Failed to save plugin {plugin_name}: {e}\")\n return False\n\n def update_plugin_source_url(self, source_url: str) -> dict[str, Any]:\n \"\"\"更新开放接口地址\"\"\"\n try:\n if os.path.exists(self.plugins_config_path):\n with open(self.plugins_config_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n plugin_source = config_data.get(\"plugin_source\", {})\n plugin_source[\"source_url\"] = source_url\n config_data[\"plugin_source\"] = plugin_source\n\n with open(self.plugins_config_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n\n # 使缓存失效\n self._invalidate_config_cache()\n return {\"success\": True}\n else:\n return {\"success\": False}\n except Exception as e:\n self.log.error(f\"Failed to update plugin source config: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n \"\"\"----------------------------------------------------------------------\"\"\"\n\n def _get_config_data(self):\n \"\"\"获取配置数据，使用缓存机制\"\"\"\n current_time = time.time()\n # 检查缓存是否有效\n if (\n self._config_cache is not None\n and current_time - self._config_cache_time < self._config_cache_ttl\n ):\n return self._config_cache\n\n # 重新读取配置文件\n if os.path.exists(self.plugins_config_path):\n with open(self.plugins_config_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n else:\n config_data = {}\n\n # 更新缓存\n self._config_cache = config_data\n self._config_cache_time = current_time\n return config_data\n\n def _invalidate_config_cache(self):\n \"\"\"使配置缓存失效\"\"\"\n self._config_cache = None\n self._config_cache_time = 0\n\n def _load_plugins(self):\n \"\"\"加载所有插件\"\"\"\n if not os.path.exists(self.plugins_dir):\n os.makedirs(self.plugins_dir)\n\n # 读取、加载插件配置Json\n if not os.path.exists(self.plugins_config_path):\n # 复制 plugins-config-example.json 模板，创建插件配置Json文件\n example_config_path = os.path.join(\n os.path.dirname(__file__), \"plugins-config-example.json\"\n )\n if os.path.exists(example_config_path):\n shutil.copy2(example_config_path, self.plugins_config_path)\n else:\n base_config = {\n \"account\": \"\",\n \"password\": \"\",\n \"auto_add_song\": True,\n \"aiapi_info\": {\"enabled\": False, \"api_key\": \"\"},\n \"enabled_plugins\": [],\n \"openapi_info\": {\"enabled\": False, \"search_url\": \"\"},\n \"plugin_source\": {\"source_url\": \"\"},\n \"plugins_info\": [],\n }\n with open(self.plugins_config_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(base_config, f, ensure_ascii=False, indent=2)\n # 输出文件夹、配置文件地址\n self.log.info(f\"Plugins directory: {self.plugins_dir}\")\n self.log.info(f\"Plugins config file: {self.plugins_config_path}\")\n # 只加载指定的插件，避免加载所有插件导致超时\n # enabled_plugins = ['kw', 'qq-yuanli'] # 可以根据需要添加更多\n # 读取配置文件配置\n enabled_plugins = self.get_enabled_plugins()\n for filename in os.listdir(self.plugins_dir):\n if filename.endswith(\".js\"):\n plugin_name = os.path.splitext(filename)[0]\n try:\n # 如果是重要插件或没有指定重要插件列表，则加载\n if not enabled_plugins or plugin_name in enabled_plugins:\n try:\n self.log.info(f\"Loading plugin: {plugin_name}\")\n self.load_plugin(plugin_name)\n except Exception as e:\n self.log.error(\n f\"Failed to load important plugin {plugin_name}: {e}\"\n )\n # 即使加载失败也记录插件信息\n self.plugins[plugin_name] = {\n \"name\": plugin_name,\n \"enabled\": False,\n \"loaded\": False,\n \"error\": str(e),\n }\n else:\n self.log.debug(\n f\"Skipping plugin (not in important list): {plugin_name}\"\n )\n # 标记为未加载但可用\n self.plugins[plugin_name] = {\n \"name\": plugin_name,\n \"enabled\": False,\n \"loaded\": False,\n \"error\": \"Not loaded (not in important plugins list)\",\n }\n except Exception as e:\n self.log.error(f\"Failed to load plugin {filename}: {e}\")\n # 即使加载失败也记录插件信息\n self.plugins[plugin_name] = {\n \"name\": plugin_name,\n \"enabled\": False,\n \"loaded\": False,\n \"error\": str(e),\n }\n\n def load_plugin(self, plugin_name: str) -> bool:\n \"\"\"加载单个插件\"\"\"\n plugin_file = os.path.join(self.plugins_dir, f\"{plugin_name}.js\")\n\n if not os.path.exists(plugin_file):\n raise FileNotFoundError(f\"Plugin file not found: {plugin_file}\")\n\n try:\n with open(plugin_file, encoding=\"utf-8\") as f:\n js_code = f.read()\n\n response = self._send_message(\n {\"action\": \"load\", \"name\": plugin_name, \"code\": js_code}\n )\n\n if response[\"success\"]:\n self.plugins[plugin_name] = {\n \"status\": \"loaded\",\n \"load_time\": time.time(),\n \"enabled\": True,\n }\n self.log.info(f\"Loaded JS plugin: {plugin_name}\")\n return True\n else:\n self.log.error(\n f\"Failed to load JS plugin {plugin_name}: {response['error']}\"\n )\n return False\n\n except Exception as e:\n self.log.error(f\"Failed to load JS plugin {plugin_name}: {e}\")\n return False\n\n def refresh_plugin_list(self) -> list[dict[str, Any]]:\n \"\"\"刷新插件列表，强制重新加载配置数据\"\"\"\n # 强制使缓存失效，重新加载配置\n self._invalidate_config_cache()\n self.reload_plugins()\n # 返回最新的插件列表\n return self.get_plugin_list()\n\n def get_plugin_list(self) -> list[dict[str, Any]]:\n \"\"\"获取启用的插件列表\"\"\"\n result = []\n try:\n # 读取配置文件中的启用插件列表\n config_data = self._get_config_data()\n if config_data:\n plugin_infos = config_data.get(\"plugins_info\", [])\n enabled_plugins = config_data.get(\"enabled_plugins\", [])\n\n # 创建一个映射，用于快速查找插件在 enabled_plugins 中的位置\n enabled_order = {name: i for i, name in enumerate(enabled_plugins)}\n\n # 先按 enabled 属性排序（True 在前）\n # 再按 enabled_plugins 顺序排序（启用的插件才参与此排序）\n def sort_key(plugin_info):\n name = plugin_info[\"name\"]\n is_enabled = plugin_info.get(\"enabled\", False)\n order = (\n enabled_order.get(name, len(enabled_plugins))\n if is_enabled\n else len(enabled_plugins)\n )\n # (-is_enabled) 将 True(1) 放到前面，False(0) 放到后面\n # order 控制启用插件间的相对顺序\n return -is_enabled, order\n\n result = sorted(plugin_infos, key=sort_key)\n except Exception as e:\n self.log.error(f\"Failed to read enabled plugins from config: {e}\")\n return result\n\n def get_enabled_plugins(self) -> list[str]:\n \"\"\"获取启用的插件列表\"\"\"\n try:\n # 读取配置文件中的启用插件列表\n config_data = self._get_config_data()\n if config_data:\n enabled_plugins = config_data.get(\"enabled_plugins\", [])\n # 追加开放接口名称\n openapi_info = config_data.get(\"openapi_info\", {})\n enabled_openapi = openapi_info.get(\"enabled\", False)\n if enabled_openapi and \"OpenAPI\" not in enabled_plugins:\n enabled_plugins.insert(0, \"OpenAPI\")\n return enabled_plugins\n else:\n return []\n except Exception as e:\n self.log.error(f\"Failed to read enabled plugins from config: {e}\")\n return []\n\n def get_auto_add_song(self) -> bool:\n \"\"\"获取是否启用自动添加歌曲\"\"\"\n try:\n # 读取配置文件\n config_data = self._get_config_data()\n if config_data:\n return config_data.get(\"auto_add_song\", False)\n else:\n return False\n except Exception as e:\n self.log.error(f\"Failed to read enabled plugins from config: {e}\")\n return False\n\n def search(self, plugin_name: str, keyword: str, page: int = 1, limit: int = 20):\n \"\"\"搜索音乐\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.info(\n f\"JS Plugin Manager starting search in plugin {plugin_name} for keyword: {keyword}\"\n )\n response = self._send_message(\n {\n \"action\": \"search\",\n \"pluginName\": plugin_name,\n \"params\": {\"keywords\": keyword, \"page\": page, \"limit\": limit},\n }\n )\n\n self.log.debug(\n f\"JS Plugin Manager search response: {response}\"\n ) # 使用 debug 级别，减少日志量\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager search failed in plugin {plugin_name}: {response['error']}\"\n )\n # 添加详细的错误信息\n self.log.error(f\"JS Plugin Manager full error response: {response}\")\n raise Exception(f\"Search failed: {response['error']}\")\n else:\n # 检查返回的数据结构\n result_data = response[\"result\"]\n self.log.debug(\n f\"JS Plugin Manager search raw result: {result_data}\"\n ) # 使用 debug 级别\n data_list = result_data.get(\"data\", [])\n is_end = result_data.get(\"isEnd\", True)\n self.log.info(\n f\"JS Plugin Manager search completed in plugin {plugin_name}, isEnd: {is_end}, found {len(data_list)} results\"\n )\n # 检查数据类型是否正确\n if not isinstance(data_list, list):\n self.log.error(\n f\"JS Plugin Manager search returned invalid data type: {type(data_list)}, value: {data_list}\"\n )\n else:\n self.log.debug(\n f\"JS Plugin Manager search data sample: {data_list[:2] if len(data_list) > 0 else 'No results'}\"\n )\n return result_data\n\n async def openapi_search(\n self, url: str, keyword: str, artist: str, limit: int = 20\n ):\n \"\"\"直接调用在线接口进行音乐搜索\n\n Args:\n url (str): 在线搜索接口地址\n keyword (str): 搜索关键词，歌名/歌手名\n artist (str): 搜索的歌手名，可能为空\n limit (int): 每页数量，默认为5\n Returns:\n Dict[str, Any]: 搜索结果，数据结构与search函数一致\n \"\"\"\n import asyncio\n\n import aiohttp\n\n try:\n # 构造请求参数\n params = {\"type\": \"aggregateSearch\", \"keyword\": keyword, \"limit\": limit}\n # 使用aiohttp发起异步HTTP GET请求\n connector = aiohttp.TCPConnector(ssl=False) # 跳过 SSL 验证\n async with aiohttp.ClientSession(connector=connector) as session:\n async with session.get(\n url, params=params, timeout=aiohttp.ClientTimeout(total=10)\n ) as response:\n response.raise_for_status() # 抛出HTTP错误\n # 解析响应数据\n raw_data = await response.json()\n\n self.log.info(f\"在线接口返回Json: {raw_data}\")\n\n # 检查API调用是否成功\n if raw_data.get(\"code\") != 200:\n raise Exception(\n f\"API request failed with code: {raw_data.get('code', 'unknown')}\"\n )\n\n # 提取实际的搜索结果\n api_data = raw_data.get(\"data\", {})\n results = api_data.get(\"results\", [])\n\n # 转换数据格式以匹配插件系统的期望格式\n converted_data = []\n for item in results:\n url = item.get(\"url\", \"\")\n self.log.info(f\"openapi_search url: {url}\")\n converted_item = {\n \"id\": item.get(\"id\", \"\"),\n \"title\": item.get(\"name\", \"\"),\n \"artist\": item.get(\"artist\", \"\"),\n \"album\": item.get(\"album\", \"\"),\n \"platform\": \"OpenAPI-\" + item.get(\"platform\"),\n \"isOpenAPI\": True,\n \"url\": url,\n \"artwork\": item.get(\"pic\", \"\"),\n \"lrc\": item.get(\"lrc\", \"\"),\n }\n converted_data.append(converted_item)\n # 排序筛选\n unified_result = {\"data\": converted_data}\n # 调用优化函数\n optimized_result = self.optimize_search_results(\n unified_result,\n search_keyword=keyword,\n limit=limit,\n search_artist=artist,\n )\n results = optimized_result.get(\"data\", [])\n # 返回统一格式的数据\n return {\n \"success\": True,\n \"isOpenAPI\": True,\n \"data\": results,\n \"total\": len(results),\n \"sources\": {\"OpenAPI\": len(results)},\n \"page\": 1,\n \"limit\": limit,\n }\n\n except asyncio.TimeoutError as e:\n self.log.error(f\"OpenAPI search timeout at URL {url}: {e}\")\n return {\n \"success\": False,\n \"isOpenAPI\": True,\n \"error\": f\"OpenAPI search timeout: {str(e)}\",\n \"data\": [],\n \"total\": 0,\n \"sources\": {},\n \"page\": 1,\n \"limit\": limit,\n }\n except Exception as e:\n self.log.error(f\"OpenAPI search error at URL {url}: {e}\")\n return {\n \"success\": False,\n \"isOpenAPI\": True,\n \"error\": f\"OpenAPI search error: {str(e)}\",\n \"data\": [],\n \"total\": 0,\n \"sources\": {},\n \"page\": 1,\n \"limit\": limit,\n }\n\n def optimize_search_results(\n self,\n result_data: dict[str, Any], # 搜索结果数据，字典类型，包含任意类型的值\n search_keyword: str = \"\", # 搜索关键词，默认为空字符串\n search_artist: str = \"\", # 搜索歌手名，默认为空字符串\n limit: int = 1, # 返回结果数量限制，默认为1\n ) -> dict[str, Any]: # 返回优化后的搜索结果，字典类型，包含任意类型的值\n \"\"\"\n 优化搜索结果，根据关键词、歌手名和平台权重对结果进行排序\n 参数:\n result_data: 原始搜索结果数据\n search_keyword: 搜索的关键词\n search_artist: 搜索的歌手名\n limit: 返回结果的最大数量\n 返回:\n 优化后的搜索结果数据，已根据匹配度和平台权重排序\n \"\"\"\n if not result_data or \"data\" not in result_data or not result_data[\"data\"]:\n return result_data\n\n # 清理搜索关键词和歌手名，去除首尾空格\n search_keyword = search_keyword.strip()\n search_artist = search_artist.strip()\n\n # 如果关键词和歌手名都为空，则不进行排序\n if not search_keyword and not search_artist:\n return result_data # 两者都空才不排序\n\n # 获取待处理的数据列表\n data_list = result_data[\"data\"]\n # 预计算平台权重，启用插件列表中的前9个插件有权重，排名越靠前权重越高\n enabled_plugins = self.get_enabled_plugins()\n plugin_weights = {p: 9 - i for i, p in enumerate(enabled_plugins[:9])}\n\n def calculate_match_score(item):\n \"\"\"\n 计算单个搜索结果的匹配分数\n 参数:\n item: 单个搜索结果项\n 返回:\n 匹配分数，包含标题匹配分、艺术家匹配分和平台加分\n \"\"\"\n # 获取并标准化标题、艺术家和平台信息\n title = item.get(\"title\", \"\").lower()\n artist = item.get(\"artist\", \"\").lower()\n platform = item.get(\"platform\", \"\")\n\n # 标准化搜索关键词和艺术家名\n kw = search_keyword.lower()\n ar = search_artist.lower()\n\n # 歌名匹配分\n title_score = 0\n if kw:\n if kw == title:\n title_score = 400\n elif title.startswith(kw):\n title_score = 300\n elif kw in title:\n title_score = 200\n\n # 歌手匹配分\n artist_score = 0\n if ar:\n if ar == artist:\n artist_score = 1000\n elif artist.startswith(ar):\n artist_score = 800\n elif ar in artist:\n artist_score = 600\n # 开放接口的平台权重最高 20\n if platform.startswith(\"OpenAPI-\"):\n platform_bonus = 20\n else:\n platform_bonus = plugin_weights.get(platform, 0)\n return title_score + artist_score + platform_bonus\n\n sorted_data = sorted(data_list, key=calculate_match_score, reverse=True)\n self.log.info(f\"排序后列表信息：：{sorted_data}\")\n if 0 < limit < len(sorted_data):\n sorted_data = sorted_data[:limit]\n result_data[\"data\"] = sorted_data\n return result_data\n\n def get_media_source(self, plugin_name: str, music_item: dict[str, Any], quality):\n \"\"\"获取媒体源\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting media source in plugin {plugin_name} for item: {music_item.get('title', 'unknown')} by {music_item.get('artist', 'unknown')}\"\n )\n response = self._send_message(\n {\n \"action\": \"getMediaSource\",\n \"pluginName\": plugin_name,\n \"musicItem\": music_item,\n \"quality\": quality,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getMediaSource failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getMediaSource failed: {response['error']}\")\n else:\n self.log.debug(\n f\"JS Plugin Manager getMediaSource completed in plugin {plugin_name}, URL length: {len(response['result'].get('url', '')) if response['result'] else 0}\"\n )\n\n return response[\"result\"]\n\n def get_lyric(self, plugin_name: str, music_item: dict[str, Any]):\n \"\"\"获取歌词\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting lyric in plugin {plugin_name} for music: {music_item.get('title', 'unknown')}\"\n )\n response = self._send_message(\n {\"action\": \"getLyric\", \"pluginName\": plugin_name, \"musicItem\": music_item}\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getLyric failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getLyric failed: {response['error']}\")\n\n return response[\"result\"]\n\n def get_music_info(self, plugin_name: str, music_item: dict[str, Any]):\n \"\"\"获取音乐详情\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting music info in plugin {plugin_name} for music: {music_item.get('title', 'unknown')}\"\n )\n response = self._send_message(\n {\n \"action\": \"getMusicInfo\",\n \"pluginName\": plugin_name,\n \"musicItem\": music_item,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getMusicInfo failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getMusicInfo failed: {response['error']}\")\n\n return response[\"result\"]\n\n def get_album_info(\n self, plugin_name: str, album_info: dict[str, Any], page: int = 1\n ):\n \"\"\"获取专辑详情\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting album info in plugin {plugin_name} for album: {album_info.get('title', 'unknown')}\"\n )\n response = self._send_message(\n {\n \"action\": \"getAlbumInfo\",\n \"pluginName\": plugin_name,\n \"albumInfo\": album_info,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getAlbumInfo failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getAlbumInfo failed: {response['error']}\")\n\n return response[\"result\"]\n\n def get_music_sheet_info(\n self, plugin_name: str, playlist_info: dict[str, Any], page: int = 1\n ):\n \"\"\"获取歌单详情\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting music sheet info in plugin {plugin_name} for playlist: {playlist_info.get('title', 'unknown')}\"\n )\n response = self._send_message(\n {\n \"action\": \"getMusicSheetInfo\",\n \"pluginName\": plugin_name,\n \"playlistInfo\": playlist_info,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getMusicSheetInfo failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getMusicSheetInfo failed: {response['error']}\")\n\n return response[\"result\"]\n\n def get_artist_works(\n self,\n plugin_name: str,\n artist_item: dict[str, Any],\n page: int = 1,\n type_: str = \"music\",\n ):\n \"\"\"获取作者作品\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting artist works in plugin {plugin_name} for artist: {artist_item.get('title', 'unknown')}\"\n )\n response = self._send_message(\n {\n \"action\": \"getArtistWorks\",\n \"pluginName\": plugin_name,\n \"artistItem\": artist_item,\n \"page\": page,\n \"type\": type_,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getArtistWorks failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getArtistWorks failed: {response['error']}\")\n\n return response[\"result\"]\n\n def import_music_item(self, plugin_name: str, url_like: str):\n \"\"\"导入单曲\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager importing music item in plugin {plugin_name} from: {url_like}\"\n )\n response = self._send_message(\n {\n \"action\": \"importMusicItem\",\n \"pluginName\": plugin_name,\n \"urlLike\": url_like,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager importMusicItem failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"importMusicItem failed: {response['error']}\")\n\n return response[\"result\"]\n\n def import_music_sheet(self, plugin_name: str, url_like: str):\n \"\"\"导入歌单\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager importing music sheet in plugin {plugin_name} from: {url_like}\"\n )\n response = self._send_message(\n {\n \"action\": \"importMusicSheet\",\n \"pluginName\": plugin_name,\n \"urlLike\": url_like,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager importMusicSheet failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"importMusicSheet failed: {response['error']}\")\n\n return response[\"result\"]\n\n def get_top_lists(self, plugin_name: str):\n \"\"\"获取榜单列表\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(f\"JS Plugin Manager getting top lists in plugin {plugin_name}\")\n response = self._send_message(\n {\"action\": \"getTopLists\", \"pluginName\": plugin_name}\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getTopLists failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getTopLists failed: {response['error']}\")\n\n return response[\"result\"]\n\n def get_top_list_detail(\n self, plugin_name: str, top_list_item: dict[str, Any], page: int = 1\n ):\n \"\"\"获取榜单详情\"\"\"\n if plugin_name not in self.plugins:\n raise ValueError(f\"Plugin {plugin_name} not found or not loaded\")\n\n self.log.debug(\n f\"JS Plugin Manager getting top list detail in plugin {plugin_name} for list: {top_list_item.get('title', 'unknown')}\"\n )\n response = self._send_message(\n {\n \"action\": \"getTopListDetail\",\n \"pluginName\": plugin_name,\n \"topListItem\": top_list_item,\n \"page\": page,\n }\n )\n\n if not response[\"success\"]:\n self.log.error(\n f\"JS Plugin Manager getTopListDetail failed in plugin {plugin_name}: {response['error']}\"\n )\n raise Exception(f\"getTopListDetail failed: {response['error']}\")\n\n return response[\"result\"]\n\n # 启用插件\n def enable_plugin(self, plugin_name: str) -> bool:\n if plugin_name in self.plugins:\n self.plugins[plugin_name][\"enabled\"] = True\n # 读取、修改 插件配置json文件：① 将plugins_info属性中对于的插件状态改为禁用、2：将 enabled_plugins中对应插件移除\n # 同步更新配置文件\n try:\n # 使用自定义的配置文件路径\n config_file_path = self.plugins_config_path\n\n # 读取现有配置\n if os.path.exists(config_file_path):\n with open(config_file_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n # 更新plugins_info中对应插件的状态\n for plugin_info in config_data.get(\"plugins_info\", []):\n if plugin_info.get(\"name\") == plugin_name:\n plugin_info[\"enabled\"] = True\n\n # 添加到enabled_plugins中（如果不存在）\n if \"enabled_plugins\" not in config_data:\n config_data[\"enabled_plugins\"] = []\n\n if plugin_name not in config_data[\"enabled_plugins\"]:\n # 追加到list的第一个\n config_data[\"enabled_plugins\"].insert(0, plugin_name)\n\n # 写回配置文件\n with open(config_file_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n\n # 清空缓存：\n self._invalidate_config_cache()\n self.log.info(\n f\"Plugin config updated for enabled plugin {plugin_name}\"\n )\n # 更新插件引擎\n self.reload_plugins()\n\n except Exception as e:\n self.log.error(\n f\"Failed to update plugin config when enabling {plugin_name}: {e}\"\n )\n return True\n return False\n\n # 禁用插件\n def disable_plugin(self, plugin_name: str) -> bool:\n # 读取、修改 插件配置json文件：① 将plugins_info属性中对于的插件状态改为禁用、2：将 enabled_plugins中对应插件移除\n if plugin_name in self.plugins:\n self.plugins[plugin_name][\"enabled\"] = False\n # 同步更新配置文件\n try:\n # 使用自定义的配置文件路径\n config_file_path = self.plugins_config_path\n\n # 读取现有配置\n if os.path.exists(config_file_path):\n with open(config_file_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n # 更新plugins_info中对应插件的状态\n for plugin_info in config_data.get(\"plugins_info\", []):\n if plugin_info.get(\"name\") == plugin_name:\n plugin_info[\"enabled\"] = False\n\n # 添加到enabled_plugins中（如果不存在）\n if \"enabled_plugins\" not in config_data:\n config_data[\"enabled_plugins\"] = []\n\n if plugin_name in config_data[\"enabled_plugins\"]:\n # 移除对应的插件名\n config_data[\"enabled_plugins\"].remove(plugin_name)\n\n # 写回配置文件\n with open(config_file_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n # 清空缓存：\n self._invalidate_config_cache()\n self.log.info(f\"Plugin config updated for enabled plugin {plugin_name}\")\n # 更新插件引擎\n self.reload_plugins()\n except Exception as e:\n self.log.error(\n f\"Failed to update plugin config when enabling {plugin_name}: {e}\"\n )\n return False\n return True\n\n # 卸载插件\n def uninstall_plugin(self, plugin_name: str) -> bool:\n \"\"\"卸载插件：移除配置信息并删除插件文件\"\"\"\n if plugin_name in self.plugins:\n try:\n # 从内存中移除插件\n self.plugins.pop(plugin_name)\n\n # 使用自定义的配置文件路径\n config_file_path = self.plugins_config_path\n\n # 读取现有配置\n if os.path.exists(config_file_path):\n with open(config_file_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n # 移除plugins_info属性中对应的插件项目\n if \"plugins_info\" in config_data:\n config_data[\"plugins_info\"] = [\n plugin_info\n for plugin_info in config_data[\"plugins_info\"]\n if plugin_info.get(\"name\") != plugin_name\n ]\n\n # 从enabled_plugins中移除插件（如果存在）\n if (\n \"enabled_plugins\" in config_data\n and plugin_name in config_data[\"enabled_plugins\"]\n ):\n config_data[\"enabled_plugins\"].remove(plugin_name)\n\n # 回写配置文件\n with open(config_file_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n # 清空缓存：\n self._invalidate_config_cache()\n self.log.info(\n f\"Plugin config updated for uninstalled plugin {plugin_name}\"\n )\n\n # 删除插件文件夹中的指定插件文件\n plugin_file_path = os.path.join(self.plugins_dir, f\"{plugin_name}.js\")\n if os.path.exists(plugin_file_path):\n os.remove(plugin_file_path)\n self.log.info(f\"Plugin file removed: {plugin_file_path}\")\n else:\n self.log.warning(f\"Plugin file not found: {plugin_file_path}\")\n\n return True\n except Exception as e:\n self.log.error(f\"Failed to uninstall plugin {plugin_name}: {e}\")\n return False\n return False\n\n def reload_plugins(self):\n \"\"\"重新加载所有插件\"\"\"\n self.log.info(\"Reloading all plugins...\")\n # 清空现有插件状态\n self.plugins.clear()\n # 重新加载插件\n self._load_plugins()\n self.log.info(f\"最新插件信息：{self.plugins}\")\n\n def update_plugin_config(self, plugin_name: str, plugin_file: str):\n \"\"\"更新插件配置文件\"\"\"\n try:\n # 使用自定义的配置文件路径\n config_file_path = self.plugins_config_path\n # 如果配置文件不存在，创建一个基础配置\n if not os.path.exists(config_file_path):\n base_config = {\n \"account\": \"\",\n \"password\": \"\",\n \"enabled_plugins\": [],\n \"plugins_info\": [],\n }\n with open(config_file_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(base_config, f, ensure_ascii=False, indent=2)\n\n # 读取现有配置\n with open(config_file_path, encoding=\"utf-8\") as f:\n config_data = json.load(f)\n\n # 检查是否已存在该插件信息\n plugin_exists = False\n for plugin_info in config_data.get(\"plugins_info\", []):\n if plugin_info.get(\"name\") == plugin_name:\n plugin_exists = True\n break\n\n # 如果不存在，则添加新的插件信息\n if not plugin_exists:\n new_plugin_info = {\n \"name\": plugin_name,\n \"file\": plugin_file,\n \"enabled\": False, # 默认不启用\n }\n if \"plugins_info\" not in config_data:\n config_data[\"plugins_info\"] = []\n config_data[\"plugins_info\"].append(new_plugin_info)\n # 写回配置文件\n with open(config_file_path, \"w\", encoding=\"utf-8\") as f:\n json.dump(config_data, f, ensure_ascii=False, indent=2)\n\n self.log.info(f\"Plugin config updated for {plugin_name}\")\n\n except Exception as e:\n self.log.error(f\"Failed to update plugin config: {e}\")\n\n def reset_restart_limit(self):\n \"\"\"重置重启限制计数器，允许重新开始重启尝试\"\"\"\n self._restart_count = 0\n self._last_restart_time = 0\n self.log.info(\"Node.js process restart limit has been reset\")\n\n def get_restart_status(self) -> dict[str, Any]:\n \"\"\"获取重启状态信息\"\"\"\n current_time = time.time()\n time_since_last_restart = (\n current_time - self._last_restart_time if self._last_restart_time > 0 else 0\n )\n time_until_reset = max(0, self._restart_window - time_since_last_restart)\n\n return {\n \"restart_count\": self._restart_count,\n \"max_restarts_in_window\": self._max_restarts_in_window,\n \"restart_window\": self._restart_window,\n \"time_since_last_restart\": time_since_last_restart,\n \"time_until_reset\": time_until_reset,\n \"can_restart\": self._restart_count < self._max_restarts_in_window\n or time_since_last_restart >= self._restart_window,\n }\n\n def shutdown(self):\n \"\"\"关闭插件管理器\"\"\"\n if self.node_process:\n self.node_process.terminate()\n self.node_process.wait()\n" }, { "path": "xiaomusic/js_plugin_runner.js", "content": "#!/usr/bin/env node\n\n/**\n * JS 插件运行器\n * 在安全的沙箱环境中运行 MusicFree JS 插件\n */\n\nconst vm = require('vm');\nconst fs = require('fs');\n\n// 设置编码\nprocess.stdin.setEncoding('utf8');\nprocess.stdout.setDefaultEncoding('utf8');\n\nclass PluginRunner {\n constructor() {\n this.plugins = new Map();\n this.requestId = 0;\n this.pendingRequests = new Map();\n this.setupMessageHandler();\n }\n\n setupMessageHandler() {\n let buffer = '';\n process.stdin.on('data', (data) => {\n buffer += data.toString();\n\n // 按行分割并处理完整的消息\n let lines = buffer.split('\\n');\n buffer = lines.pop(); // 保留最后一行（可能不完整）\n\n for (const line of lines) {\n if (line.trim() === '') continue;\n try {\n const message = JSON.parse(line.trim());\n console.log(`[JS_PLUGIN_RUNNER] Raw message received: ${line.trim()}`);\n this.handleMessage(message);\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] Failed to parse message: ${line.trim()}`);\n console.error(`[JS_PLUGIN_RUNNER] Error: ${error.message}`);\n this.sendResponse('unknown', {\n success: false,\n error: `JSON parse error: ${error.message}`\n });\n }\n }\n });\n }\n\n async handleMessage(message) {\n const { id, action } = message;\n // 只在必要时输出日志以避免干扰通信\n // console.debug(`[JS_PLUGIN_RUNNER] Received message: ${action} with id: ${id}`);\n // if (message.pluginName) console.debug(`[JS_PLUGIN_RUNNER] Plugin: ${message.pluginName}`);\n // if (message.params) console.debug(`[JS_PLUGIN_RUNNER] Params:`, message.params);\n // if (message.musicItem) console.debug(`[JS_PLUGIN_RUNNER] Music Item:`, message.musicItem);\n\n try {\n let result;\n switch (action) {\n case 'load':\n console.log(`[JS_PLUGIN_RUNNER] Loading plugin: ${message.name}`);\n result = this.loadPlugin(message.name, message.code);\n break;\n case 'search':\n result = await this.search(message.pluginName, message.params);\n break;\n case 'getMediaSource':\n result = await this.getMediaSource(message.pluginName, message.musicItem, message.quality);\n break;\n case 'getLyric':\n result = await this.getLyric(message.pluginName, message.musicItem);\n break;\n case 'getMusicInfo':\n result = await this.getMusicInfo(message.pluginName, message.musicItem);\n break;\n case 'getAlbumInfo':\n result = await this.getAlbum(message.pluginName, message.albumInfo);\n break;\n case 'getMusicSheetInfo':\n result = await this.getPlaylist(message.pluginName, message.playlistInfo);\n break;\n case 'getArtistWorks':\n result = await this.getArtistWorks(message.pluginName, message.artistItem, message.page, message.type);\n break;\n case 'importMusicItem':\n result = await this.importMusicItem(message.pluginName, message.urlLike);\n break;\n case 'importMusicSheet':\n result = await this.importMusicSheet(message.pluginName, message.urlLike);\n break;\n case 'getTopLists':\n result = await this.getTopLists(message.pluginName);\n break;\n case 'getTopListDetail':\n result = await this.getTopListDetail(message.pluginName, message.topListItem, message.page);\n break;\n case 'unload':\n console.log(`[JS_PLUGIN_RUNNER] Unloading plugin: ${message.name}`);\n result = this.unloadPlugin(message.name);\n break;\n default:\n throw new Error(`Unknown action: ${action}`);\n }\n\n this.sendResponse(id, { success: true, result });\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] Action ${action} failed:`, error.message);\n this.sendResponse(id, { success: false, error: error.message });\n }\n }\n\n sendResponse(id, response) {\n response.id = id;\n process.stdout.write(JSON.stringify(response) + '\\n');\n }\n\n loadPlugin(name, code) {\n try {\n // 创建安全的沙箱环境\n const sandbox = this.createSandbox();\n\n // 创建上下文\n const context = vm.createContext(sandbox);\n\n // 包装代码以支持 ES6 模块语法\n const wrappedCode = `\n (function() {\n ${code}\n // 如果是 TypeScript 编译的代码，需要处理 exports\n if (typeof module !== 'undefined' && module.exports) {\n return module.exports;\n }\n // 如果是 ES6 模块，需要处理 exports\n if (typeof exports !== 'undefined' && exports.__esModule) {\n return exports.default || exports;\n }\n return module.exports;\n })();\n `;\n\n // 执行插件代码\n const options = {\n timeout: 10000,\n displayErrors: true,\n breakOnSigint: false\n };\n\n const plugin = vm.runInContext(wrappedCode, context, options);\n\n // 验证插件接口\n if (!plugin || typeof plugin !== 'object') {\n throw new Error('Plugin must export an object');\n }\n\n this.plugins.set(name, plugin);\n\n // 记录插件信息\n this.plugins.set(name + '_meta', {\n loadTime: Date.now(),\n capabilities: this.detectCapabilities(plugin)\n });\n\n return true;\n } catch (error) {\n console.error(`Failed to load plugin ${name}:`, error.message);\n throw error;\n }\n }\n\n createSandbox() {\n const safeConsole = {\n log: (...args) => {}, // 禁用插件的 console.log 避免干扰主进程通信\n warn: (...args) => console.warn(`[PLUGIN]`, ...args), // 保留警告，但添加标识\n error: (...args) => console.error(`[PLUGIN]`, ...args), // 保留错误，但添加标识\n debug: (...args) => {} // 禁用调试输出\n };\n\n const safeFetch = async (url, options = {}) => {\n // 代理网络请求到主进程\n return await this.proxyFetch(url, options);\n };\n\n const safeTimer = (callback, delay) => {\n if (delay > 10000) { // 最大10秒\n throw new Error('Timer delay too long');\n }\n return setTimeout(callback, delay);\n };\n\n // 支持的模块列表\n const allowedModules = {\n 'axios': require('axios'),\n 'crypto-js': require('crypto-js'),\n 'he': require('he'),\n 'dayjs': require('dayjs'),\n 'cheerio': require('cheerio'),\n 'qs': require('qs'),\n 'big-integer': require('big-integer')\n };\n\n const safeRequire = (moduleName) => {\n if (allowedModules[moduleName]) {\n return allowedModules[moduleName];\n }\n throw new Error(`Module '${moduleName}' is not allowed or not installed`);\n };\n\n const module = { exports: {} };\n const exports = module.exports;\n\n // 模拟 env 对象\n const env = {\n getUserVariables: () => ({\n music_u: '',\n ikun_key: '',\n source: ''\n })\n };\n\n return {\n // 基础对象\n console: safeConsole,\n Buffer: Buffer,\n Math: Math,\n Date: Date,\n JSON: JSON,\n\n // 受限的全局对象\n global: undefined,\n process: undefined,\n\n // 受限的网络访问\n fetch: safeFetch,\n XMLHttpRequest: undefined,\n\n // 受限的定时器\n setTimeout: safeTimer,\n setInterval: undefined,\n clearTimeout: clearTimeout,\n clearInterval: clearInterval,\n\n // 模块系统\n module: module,\n exports: exports,\n require: safeRequire,\n\n // MusicFree 环境对象\n env: env\n };\n }\n\n detectCapabilities(plugin) {\n const capabilities = [];\n if (typeof plugin.search === 'function') capabilities.push('search');\n if (typeof plugin.getMediaSource === 'function') capabilities.push('getMediaSource');\n if (typeof plugin.getLyric === 'function') capabilities.push('getLyric');\n if (typeof plugin.getAlbum === 'function') capabilities.push('getAlbum');\n if (typeof plugin.getPlaylist === 'function') capabilities.push('getPlaylist');\n return capabilities;\n }\n\n async search(pluginName, params) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 search 方法 - 参考 MusicFreeDesktop 实现\n if (!plugin.search || typeof plugin.search !== 'function') {\n // 只在详细模式下输出调试信息\n console.debug(`[JS_PLUGIN_RUNNER] Plugin ${pluginName} does not have a search function`);\n return {\n isEnd: true,\n data: []\n };\n }\n\n try {\n let query, page, type;\n if (typeof params === 'string') {\n // 兼容旧的字符串格式\n query = params;\n page = 1;\n type = 'music';\n } else if (typeof params === 'object') {\n // 新的对象格式，参考 MusicFreeDesktop\n query = params.keywords || params.query || '';\n page = params.page || 1;\n type = params.type || 'music';\n } else {\n throw new Error('Invalid search parameters');\n }\n\n // 移除调试输出，避免干扰 JSON 通信\n // console.debug(`[JS_PLUGIN_RUNNER] Calling search with query: ${query}, page: ${page}, type: ${type}`);\n const result = await plugin.search(query, page, type);\n\n // 将调试信息写入日志文件而不是控制台\n fs.appendFileSync('00-plugin_debug.log', `===========================${pluginName}插件原始返回结果：===================================\\n`);\n fs.appendFileSync('00-plugin_debug.log', `${JSON.stringify(result, null, 2)}\\n`);\n // 严格验证返回结果 - 参考 MusicFreeDesktop 实现\n if (!result || typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid search result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid search result`);\n }\n\n // 确保返回正确的数据结构 - 参考 MusicFreeDesktop 实现\n const validatedResult = {\n isEnd: result.isEnd !== false, // 默认为 true，除非明确设置为 false\n data: Array.isArray(result.data) ? result.data : [] // 确保 data 是数组\n };\n //为 validatedResult中data的 每个元素添加一个 platform 属性\n validatedResult.data.forEach(item => {\n item.platform = pluginName;\n });\n // 不输出调试信息以避免干扰通信\n return validatedResult;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] Search error in plugin ${pluginName}:`, error.message);\n // console.error(`[JS_PLUGIN_RUNNER] Full error:`, error); // 避免输出可能包含非JSON的对象\n throw new Error(`Search failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n\n async getMediaSource(pluginName, musicItem, quality) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getMediaSource 方法 - 参考 MusicFreeDesktop 实现\n if (!plugin.getMediaSource || typeof plugin.getMediaSource !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.getMediaSource(musicItem,quality);\n // 参考 MusicFreeDesktop 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid media source result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid media source result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getMediaSource error in plugin ${pluginName}:`, error.message);\n throw new Error(`getMediaSource failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getLyric(pluginName, songId) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getLyric 方法 - 参考 MusicFreeDesktop 实现\n if (!plugin.getLyric || typeof plugin.getLyric !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.getLyric(songId);\n // 参考 MusicFreeDesktop 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid lyric result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid lyric result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getLyric error in plugin ${pluginName}:`, error.message);\n throw new Error(`getLyric failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getAlbum(pluginName, albumInfo) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getAlbumInfo 方法 (按照官方文档标准)\n if (!plugin.getAlbumInfo || typeof plugin.getAlbumInfo !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n // 使用默认页码 1（从MusicFree官方文档得知默认为1）\n const result = await plugin.getAlbumInfo(albumInfo, 1);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid album result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid album result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getAlbumInfo error in plugin ${pluginName}:`, error.message);\n throw new Error(`getAlbumInfo failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getPlaylist(pluginName, playlistInfo) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getMusicSheetInfo 方法 (按照官方文档标准)\n if (!plugin.getMusicSheetInfo || typeof plugin.getMusicSheetInfo !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n // 使用默认页码 1（从MusicFree官方文档得知默认为1）\n const result = await plugin.getMusicSheetInfo(playlistInfo, 1);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid playlist result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid playlist result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getMusicSheetInfo error in plugin ${pluginName}:`, error.message);\n throw new Error(`getMusicSheetInfo failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getMusicInfo(pluginName, musicItem) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getMusicInfo 方法 (按照官方文档标准)\n if (!plugin.getMusicInfo || typeof plugin.getMusicInfo !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.getMusicInfo(musicItem);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid music info result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid music info result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getMusicInfo error in plugin ${pluginName}:`, error.message);\n throw new Error(`getMusicInfo failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getArtistWorks(pluginName, artistItem, page = 1, type = 'music') {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getArtistWorks 方法 (按照官方文档标准)\n if (!plugin.getArtistWorks || typeof plugin.getArtistWorks !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.getArtistWorks(artistItem, page, type);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid artist works result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid artist works result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getArtistWorks error in plugin ${pluginName}:`, error.message);\n throw new Error(`getArtistWorks failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async importMusicItem(pluginName, urlLike) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 importMusicItem 方法 (按照官方文档标准)\n if (!plugin.importMusicItem || typeof plugin.importMusicItem !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.importMusicItem(urlLike);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid import music item result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid import music item result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] importMusicItem error in plugin ${pluginName}:`, error.message);\n throw new Error(`importMusicItem failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async importMusicSheet(pluginName, urlLike) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 importMusicSheet 方法 (按照官方文档标准)\n if (!plugin.importMusicSheet || typeof plugin.importMusicSheet !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.importMusicSheet(urlLike);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (!Array.isArray(result)) {\n console.error(`[JS_PLUGIN_RUNNER] Invalid import music sheet result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid import music sheet result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] importMusicSheet error in plugin ${pluginName}:`, error.message);\n throw new Error(`importMusicSheet failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getTopLists(pluginName) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getTopLists 方法 (按照官方文档标准)\n if (!plugin.getTopLists || typeof plugin.getTopLists !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.getTopLists();\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (!Array.isArray(result)) {\n console.error(`[JS_PLUGIN_RUNNER] Invalid top lists result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid top lists result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getTopLists error in plugin ${pluginName}:`, error.message);\n throw new Error(`getTopLists failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n async getTopListDetail(pluginName, topListItem, page = 1) {\n const plugin = this.plugins.get(pluginName);\n if (!plugin) {\n throw new Error(`Plugin ${pluginName} not found`);\n }\n\n // 检查插件是否有 getTopListDetail 方法 (按照官方文档标准)\n if (!plugin.getTopListDetail || typeof plugin.getTopListDetail !== 'function') {\n // 不输出调试信息以避免干扰通信\n return null;\n }\n\n try {\n const result = await plugin.getTopListDetail(topListItem, page);\n // 参考 MusicFree 实现，验证结果\n if (result === null || result === undefined) {\n return null;\n }\n if (typeof result !== 'object') {\n console.error(`[JS_PLUGIN_RUNNER] Invalid top list detail result from plugin ${pluginName}:`, typeof result);\n throw new Error(`Plugin ${pluginName} returned invalid top list detail result`);\n }\n return result;\n } catch (error) {\n console.error(`[JS_PLUGIN_RUNNER] getTopListDetail error in plugin ${pluginName}:`, error.message);\n throw new Error(`getTopListDetail failed in plugin ${pluginName}: ${error.message}`);\n }\n }\n\n unloadPlugin(name) {\n const deleted = this.plugins.delete(name);\n this.plugins.delete(name + '_meta');\n return deleted;\n }\n\n async proxyFetch(url, options) {\n // 代理网络请求到主进程\n const requestId = ++this.requestId;\n\n return new Promise((resolve, reject) => {\n // 发送请求到主进程\n this.sendResponse('fetch_' + requestId, {\n action: 'fetch',\n requestId: requestId,\n url: url,\n options: options\n });\n\n // 等待响应（简化实现）\n setTimeout(() => {\n reject(new Error('Fetch proxy not implemented'));\n }, 1000);\n });\n }\n}\n\n// 启动插件运行器\nconst runner = new PluginRunner();\n\n// 处理进程退出\nprocess.on('SIGINT', () => {\n // 不输出任何内容，避免干扰 JSON 通信\n process.exit(0);\n});\n\nprocess.on('SIGTERM', () => {\n // 不输出任何内容，避免干扰 JSON 通信\n process.exit(0);\n});\n" }, { "path": "xiaomusic/music_library.py", "content": "\"\"\"音乐库管理模块\n\n负责音乐库的管理、播放列表操作、音乐搜索和标签管理。\n\"\"\"\n\nimport asyncio\nimport base64\nimport copy\nimport json\nimport os\nimport random\nimport time\nimport urllib.parse\nfrom collections import OrderedDict\nfrom dataclasses import asdict\nfrom urllib.parse import urlparse\n\nfrom xiaomusic.const import SUPPORT_MUSIC_TYPE\nfrom xiaomusic.events import CONFIG_CHANGED\nfrom xiaomusic.utils.file_utils import not_in_dirs, traverse_music_directory\nfrom xiaomusic.utils.music_utils import (\n Metadata,\n extract_audio_metadata,\n get_local_music_duration,\n get_web_music_duration,\n save_picture_by_base64,\n set_music_tag_to_file,\n)\nfrom xiaomusic.utils.network_utils import MusicUrlCache\nfrom xiaomusic.utils.system_utils import try_add_access_control_param\nfrom xiaomusic.utils.text_utils import custom_sort_key, find_best_match, fuzzyfinder\n\n# 短 token 缓存，避免长 URL 超出小爱音箱固件限制\n_proxy_token_cache: dict = {} # token -> (origin_url, is_radio)\n\n\ndef set_proxy_token(token: str, origin_url: str, is_radio: bool) -> None:\n \"\"\"存储 token -> (origin_url, is_radio) 映射\"\"\"\n _proxy_token_cache[token] = (origin_url, bool(is_radio))\n\n\ndef get_proxy_token(token: str):\n \"\"\"查询 token 对应的 (origin_url, is_radio)，不存在返回 None\"\"\"\n return _proxy_token_cache.get(token)\n\n\nclass MusicLibrary:\n \"\"\"音乐库管理类\n\n 负责管理本地和网络音乐库，包括：\n - 音乐列表生成和管理\n - 播放列表的增删改查\n - 音乐搜索和模糊匹配\n - 音乐标签的读取和更新\n \"\"\"\n\n def __init__(\n self,\n config,\n log,\n event_bus=None,\n ):\n \"\"\"初始化音乐库\n\n Args:\n config: 配置对象\n log: 日志对象\n event_bus: 事件总线对象（可选）\n \"\"\"\n self.config = config\n self.log = log\n self.event_bus = event_bus\n\n # 音乐库数据\n self.all_music = {} # 所有音乐 {name: filepath/url}\n self.music_list = {} # 播放列表 {list_name: [music_names]}\n self.default_music_list_names = [] # 非自定义歌单名称列表\n self.custom_play_list = None # 自定义播放列表缓存\n\n # 网络音乐相关\n self._all_radio = {} # 所有电台\n self._web_music_api = {} # 需要通过API获取的网络音乐\n\n # 搜索索引\n self._extra_index_search = {} # 额外搜索索引 {filepath: name}\n\n # 标签管理\n self.all_music_tags = {} # 音乐标签缓存\n self._tag_generation_task = False # 标签生成任务标志\n self._web_music_duration_cache = {} # 网络音乐时长缓存（仅内存）\n\n # URL处理相关\n self.url_cache = MusicUrlCache() # URL缓存\n\n def gen_all_music_list(self):\n \"\"\"生成所有音乐列表\n\n 扫描音乐目录，生成本地音乐列表和播放列表。\n \"\"\"\n self.all_music = {}\n all_music_by_dir = {}\n\n # 扫描本地音乐目录\n exclude_dirs_set = self.config.get_exclude_dirs_set()\n local_musics = traverse_music_directory(\n self.config.music_path,\n depth=self.config.music_path_depth,\n exclude_dirs=exclude_dirs_set,\n support_extension=SUPPORT_MUSIC_TYPE,\n )\n\n for dir_name, files in local_musics.items():\n if len(files) == 0:\n continue\n\n # 处理目录名称\n if dir_name == os.path.basename(self.config.music_path):\n dir_name = \"其他\"\n if (\n self.config.music_path != self.config.download_path\n and dir_name == os.path.basename(self.config.download_path)\n ):\n dir_name = \"下载\"\n\n if dir_name not in all_music_by_dir:\n all_music_by_dir[dir_name] = {}\n\n for file in files:\n # 歌曲名字相同会覆盖\n filename = os.path.basename(file)\n (name, _) = os.path.splitext(filename)\n self.all_music[name] = file\n all_music_by_dir[dir_name][name] = True\n self.log.debug(f\"gen_all_music_list {name}:{dir_name}:{file}\")\n\n # 初始化播放列表（使用 OrderedDict 保持顺序）\n self.music_list = OrderedDict(\n {\n \"所有歌曲\": [],\n \"所有电台\": [],\n \"全部\": [], # 包含所有歌曲和所有电台\n \"下载\": [], # 下载目录下的\n \"其他\": [], # 主目录下的\n \"最近新增\": [], # 按文件时间排序\n }\n )\n\n # 最近新增(不包含网络歌单)\n self.music_list[\"最近新增\"] = sorted(\n self.all_music.keys(),\n key=lambda x: os.path.getmtime(self.all_music[x]),\n reverse=True,\n )[: self.config.recently_added_playlist_len]\n\n # 补充网络歌单\n try:\n # NOTE: 函数内会更新 self.all_music, self.music_list；重建 self._all_radio\n self._append_music_list()\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n # 全部，所有歌曲（排除电台）\n self.music_list[\"全部\"] = list(self.all_music.keys())\n self.music_list[\"所有歌曲\"] = [\n name for name in self.all_music.keys() if name not in self._all_radio\n ]\n\n # 文件夹歌单\n for dir_name, musics in all_music_by_dir.items():\n self.music_list[dir_name] = list(musics.keys())\n\n # 歌单排序\n for list_name, play_list in self.music_list.items():\n if not self.is_online_music(list_name):\n play_list.sort(key=custom_sort_key)\n\n # 非自定义歌单\n self.default_music_list_names = list(self.music_list.keys())\n\n # 刷新自定义歌单\n self.refresh_custom_play_list()\n\n # 重建索引\n self._extra_index_search = {}\n for name, filepath in self.all_music.items():\n # 如果不是 radio，则增加索引\n if not self.is_web_radio_music(name):\n self._extra_index_search[filepath] = name\n\n # all_music 更新，重建 tag（仅在事件循环启动后才会执行）\n self.try_gen_all_music_tag()\n\n def _append_music_list(self):\n \"\"\"给歌单里补充网络歌单\"\"\"\n if not self.config.music_list_json:\n return\n\n self._all_radio = {}\n self._web_music_api = {}\n music_list = json.loads(self.config.music_list_json)\n\n try:\n for item in music_list:\n list_name = item.get(\"name\")\n musics = item.get(\"musics\")\n if (not list_name) or (not musics):\n continue\n\n one_music_list = []\n for music in musics:\n name = music.get(\"name\")\n url = music.get(\"url\")\n music_type = music.get(\"type\")\n if (not name) or (not url):\n continue\n\n self.all_music[name] = url\n one_music_list.append(name)\n\n # 处理电台列表\n if music_type == \"radio\":\n self._all_radio[name] = url\n if music.get(\"api\"):\n self._web_music_api[name] = music\n\n self.log.debug(one_music_list)\n # 歌曲名字相同会覆盖\n self.music_list[list_name] = one_music_list\n\n if self._all_radio:\n self.music_list[\"所有电台\"] = list(self._all_radio.keys())\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n def refresh_custom_play_list(self):\n \"\"\"刷新自定义歌单\"\"\"\n try:\n # 删除旧的自定义歌单\n for k in list(self.music_list.keys()):\n if k not in self.default_music_list_names:\n del self.music_list[k]\n\n # 合并新的自定义歌单\n custom_play_list = self.get_custom_play_list()\n custom_play_list, changed = self._normalize_custom_playlist_conflicts(\n custom_play_list\n )\n if changed:\n self.custom_play_list = custom_play_list\n self.config.custom_play_list_json = json.dumps(\n custom_play_list, ensure_ascii=False\n )\n\n for k, v in custom_play_list.items():\n self.music_list[k] = list(v)\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n def _is_reserved_playlist_name(self, name):\n \"\"\"判断是否与系统/目录歌单冲突（自定义歌单不可占用）\"\"\"\n return name in self.default_music_list_names\n\n def _build_custom_conflict_name(self, base_name, existed_names):\n \"\"\"为冲突的自定义歌单生成可用的新名称\"\"\"\n suffix = \"(自定义)\"\n candidate = f\"{base_name}{suffix}\"\n if candidate not in existed_names:\n return candidate\n\n index = 2\n while True:\n candidate = f\"{base_name}{suffix}{index}\"\n if candidate not in existed_names:\n return candidate\n index += 1\n\n def _normalize_custom_playlist_conflicts(self, custom_play_list):\n \"\"\"清理历史同名冲突：目录/系统歌单名被自定义占用时自动改名\"\"\"\n normalized = {}\n changed = False\n\n reserved_names = set(self.default_music_list_names)\n occupied_names = set(reserved_names)\n\n for name, musics in custom_play_list.items():\n final_name = name\n if final_name in reserved_names or final_name in occupied_names:\n final_name = self._build_custom_conflict_name(name, occupied_names)\n changed = True\n self.log.info(\n \"自定义歌单名与系统/目录歌单冲突，已自动改名: %s -> %s\",\n name,\n final_name,\n )\n\n occupied_names.add(final_name)\n normalized[final_name] = list(musics)\n\n return normalized, changed\n\n def get_custom_play_list(self):\n \"\"\"获取自定义播放列表\n\n Returns:\n dict: 自定义播放列表字典\n \"\"\"\n if self.custom_play_list is None:\n self.custom_play_list = {}\n if self.config.custom_play_list_json:\n self.custom_play_list = json.loads(self.config.custom_play_list_json)\n return self.custom_play_list\n\n def save_custom_play_list(self):\n \"\"\"保存自定义播放列表\"\"\"\n custom_play_list = self.get_custom_play_list()\n self.refresh_custom_play_list()\n self.config.custom_play_list_json = json.dumps(\n custom_play_list, ensure_ascii=False\n )\n # 发布配置变更事件\n if self.event_bus:\n self.event_bus.publish(CONFIG_CHANGED)\n\n # ==================== 播放列表管理 ====================\n\n def play_list_add(self, name):\n \"\"\"新增歌单\n\n Args:\n name: 歌单名称\n\n Returns:\n bool: 是否成功\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n if self._is_reserved_playlist_name(name):\n self.log.info(f\"歌单名字与系统/目录歌单冲突 {name}\")\n return False\n if name in custom_play_list:\n return False\n custom_play_list[name] = []\n self.save_custom_play_list()\n return True\n\n def play_list_del(self, name):\n \"\"\"移除歌单\n\n Args:\n name: 歌单名称\n\n Returns:\n bool: 是否成功\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n if name not in custom_play_list:\n return False\n custom_play_list.pop(name)\n self.save_custom_play_list()\n return True\n\n def play_list_update_name(self, oldname, newname):\n \"\"\"修改歌单名字\n\n Args:\n oldname: 旧歌单名称\n newname: 新歌单名称\n\n Returns:\n bool: 是否成功\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n if oldname not in custom_play_list:\n self.log.info(f\"旧歌单名字不存在 {oldname}\")\n return False\n if self._is_reserved_playlist_name(newname):\n self.log.info(f\"新歌单名字与系统/目录歌单冲突 {newname}\")\n return False\n if newname in custom_play_list:\n self.log.info(f\"新歌单名字已存在 {newname}\")\n return False\n\n play_list = custom_play_list[oldname]\n custom_play_list.pop(oldname)\n custom_play_list[newname] = play_list\n self.save_custom_play_list()\n return True\n\n def get_play_list_names(self):\n \"\"\"获取所有自定义歌单名称\n\n Returns:\n list: 歌单名称列表\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n return list(custom_play_list.keys())\n\n def play_list_musics(self, name):\n \"\"\"获取歌单中所有歌曲\n\n Args:\n name: 歌单名称\n\n Returns:\n tuple: (状态消息, 歌曲列表)\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n if name not in custom_play_list:\n return \"歌单不存在\", []\n play_list = custom_play_list[name]\n return \"OK\", play_list\n\n def play_list_update_music(self, name, music_list):\n \"\"\"歌单更新歌曲（覆盖）\n\n Args:\n name: 歌单名称\n music_list: 歌曲列表\n\n Returns:\n bool: 是否成功\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n if name not in custom_play_list:\n # 歌单不存在则新建\n if not self.play_list_add(name):\n return False\n\n play_list = []\n for music_name in music_list:\n if (music_name in self.all_music) and (music_name not in play_list):\n play_list.append(music_name)\n\n # 直接覆盖\n custom_play_list[name] = play_list\n self.save_custom_play_list()\n return True\n\n def update_music_list_json(self, list_name, update_list, append=False):\n \"\"\"\n 更新配置的音乐歌单Json，如果歌单存在则根据 append：False:覆盖； True:追加\n Args:\n list_name: 更新的歌单名称\n update_list: 更新的歌单列表\n append: 追加歌曲，默认 False\n\n Returns:\n list: 转换后的音乐项目列表\n \"\"\"\n # 更新配置中的音乐列表\n if self.config.music_list_json:\n music_list = json.loads(self.config.music_list_json)\n else:\n music_list = []\n\n # 检查是否已存在同名歌单\n existing_index = None\n for i, item in enumerate(music_list):\n if item.get(\"name\") == list_name:\n existing_index = i\n break\n\n # 构建新歌单数据\n new_music_items = [\n {\"name\": item[\"name\"], \"url\": item[\"url\"], \"type\": item[\"type\"]}\n for item in update_list\n ]\n\n if existing_index is not None:\n if append:\n # 追加模式：将新项目添加到现有歌单中，避免重复\n existing_musics = music_list[existing_index][\"musics\"]\n existing_names = {music[\"name\"] for music in existing_musics}\n\n # 只添加不存在的项目\n for new_item in new_music_items:\n if new_item[\"name\"] not in existing_names:\n existing_musics.append(new_item)\n\n music_list[existing_index][\"musics\"] = existing_musics\n else:\n # 覆盖模式：替换整个歌单\n music_list[existing_index] = {\n \"name\": list_name,\n \"musics\": new_music_items,\n }\n else:\n # 添加新歌单\n new_music_list = {\"name\": list_name, \"musics\": new_music_items}\n music_list.append(new_music_list)\n\n # 保存更新后的配置\n self.config.music_list_json = json.dumps(music_list, ensure_ascii=False)\n\n def _resolve_play_list(self, name, create_if_missing=False):\n \"\"\"获取歌单列表引用，同时返回是否需要持久化自定义歌单\n\n 系统/目录歌单直接返回 music_list 中的引用（无需持久化）；\n 自定义歌单返回 custom_play_list 中的引用（需要持久化）。\n\n Args:\n name: 歌单名称\n create_if_missing: 自定义歌单不存在时是否自动新建\n\n Returns:\n tuple: (play_list, need_save) 或 (None, False) 表示失败\n \"\"\"\n custom_play_list = self.get_custom_play_list()\n\n # 系统/目录歌单：直接操作 music_list，无需持久化\n if name in self.music_list and name not in custom_play_list:\n return self.music_list[name], False\n\n # 自定义歌单不存在时按需新建\n if name not in custom_play_list:\n if not create_if_missing or not self.play_list_add(name):\n return None, False\n\n return custom_play_list[name], True\n\n def play_list_add_music(self, name, music_list):\n \"\"\"歌单新增歌曲\n\n Args:\n name: 歌单名称\n music_list: 歌曲列表\n\n Returns:\n bool: 是否成功\n \"\"\"\n play_list, need_save = self._resolve_play_list(name, create_if_missing=True)\n if play_list is None:\n return False\n\n for music_name in music_list:\n if music_name in self.all_music and music_name not in play_list:\n play_list.append(music_name)\n\n if need_save:\n self.save_custom_play_list()\n return True\n\n def play_list_del_music(self, name, music_list):\n \"\"\"歌单移除歌曲\n\n Args:\n name: 歌单名称\n music_list: 歌曲列表\n\n Returns:\n bool: 是否成功\n \"\"\"\n play_list, need_save = self._resolve_play_list(name)\n if play_list is None:\n return False\n\n for music_name in music_list:\n if music_name in play_list:\n play_list.remove(music_name)\n\n if need_save:\n self.save_custom_play_list()\n return True\n\n # ==================== 音乐搜索 ====================\n\n def find_real_music_name(self, name, n):\n \"\"\"模糊搜索音乐名称\n\n Args:\n name: 搜索关键词\n n: 返回结果数量\n\n Returns:\n list: 匹配的音乐名称列表\n \"\"\"\n if not self.config.enable_fuzzy_match:\n self.log.debug(\"没开启模糊匹配\")\n return []\n\n all_music_list = list(self.all_music.keys())\n real_names = find_best_match(\n name,\n all_music_list,\n cutoff=self.config.fuzzy_match_cutoff,\n n=n,\n extra_search_index=self._extra_index_search,\n )\n if not real_names:\n self.log.info(f\"没找到歌曲【{name}】\")\n return []\n self.log.info(f\"根据【{name}】找到歌曲【{real_names}】\")\n if name in real_names:\n return [name]\n\n # 音乐不在查找结果同时n大于1, 模糊匹配模式，扩大范围再找，最后保留随机 n 个\n if n > 1:\n real_names = find_best_match(\n name,\n all_music_list,\n cutoff=self.config.fuzzy_match_cutoff,\n n=n * 2,\n extra_search_index=self._extra_index_search,\n )\n random.shuffle(real_names)\n self.log.info(f\"没找到歌曲【{name}】\")\n return real_names[:n]\n\n def find_real_music_list_name(self, list_name):\n \"\"\"模糊搜索播放列表名称\n\n Args:\n list_name: 播放列表名称\n\n Returns:\n str: 匹配的播放列表名称\n \"\"\"\n if not self.config.enable_fuzzy_match:\n self.log.debug(\"没开启模糊匹配\")\n return list_name\n\n # 模糊搜一个播放列表（只需要一个，不需要 extra index）\n real_name = find_best_match(\n list_name,\n self.music_list,\n cutoff=self.config.fuzzy_match_cutoff,\n n=1,\n )[0]\n\n if real_name:\n self.log.info(f\"根据【{list_name}】找到播放列表【{real_name}】\")\n list_name = real_name\n else:\n self.log.info(f\"没找到播放列表【{list_name}】\")\n\n return list_name\n\n def searchmusic(self, name):\n \"\"\"搜索音乐\n\n Args:\n name: 搜索关键词\n\n Returns:\n list: 搜索结果列表\n \"\"\"\n all_music_list = list(self.all_music.keys())\n search_list = fuzzyfinder(name, all_music_list, self._extra_index_search)\n self.log.debug(f\"searchmusic. name:{name} search_list:{search_list}\")\n return search_list\n\n # ==================== 音乐信息 ====================\n\n def get_filename(self, name):\n \"\"\"获取音乐文件路径\n\n Args:\n name: 音乐名称\n\n Returns:\n str: 文件路径，不存在返回空字符串\n \"\"\"\n if name not in self.all_music:\n self.log.info(f\"get_filename not in. name:{name}\")\n return \"\"\n\n filename = self.all_music[name]\n self.log.info(f\"try get_filename. filename:{filename}\")\n\n if os.path.exists(filename):\n return filename\n return \"\"\n\n def is_music_exist(self, name):\n \"\"\"判断本地音乐是否存在，网络歌曲不判断\n\n Args:\n name: 音乐名称\n\n Returns:\n bool: 是否存在\n \"\"\"\n if name not in self.all_music:\n return False\n if self.is_web_music(name):\n return True\n filename = self.get_filename(name)\n if filename:\n return True\n return False\n\n def is_web_radio_music(self, name):\n \"\"\"是否是网络电台\n\n Args:\n name: 音乐名称\n\n Returns:\n bool: 是否是网络电台\n \"\"\"\n return name in self._all_radio\n\n # 是否是在线音乐\n @staticmethod\n def is_online_music(cur_playlist):\n # cur_playlist 开头是 '_online_' 则表示online\n return cur_playlist.startswith(\"_online_\")\n\n def is_web_music(self, name):\n \"\"\"是否是网络歌曲\n\n Args:\n name: 音乐名称\n\n Returns:\n bool: 是否是网络歌曲\n \"\"\"\n if name not in self.all_music:\n return False\n url = self.all_music[name]\n return url.startswith((\"http://\", \"https://\", \"self://\"))\n\n def is_need_use_play_music_api(self, name):\n \"\"\"是否是需要通过api获取播放链接的网络歌曲\n\n Args:\n name: 音乐名称\n\n Returns:\n bool: 是否需要通过API获取\n \"\"\"\n return name in self._web_music_api\n\n # ==================== 标签管理 ====================\n\n async def get_music_tags(self, name):\n \"\"\"获取音乐标签信息\n\n Args:\n name: 音乐名称\n\n Returns:\n dict: 标签信息字典\n \"\"\"\n tags = copy.copy(self.all_music_tags.get(name, asdict(Metadata())))\n picture = tags[\"picture\"]\n\n if picture:\n if picture.startswith(self.config.picture_cache_path):\n picture = picture[len(self.config.picture_cache_path) :]\n picture = picture.replace(\"\\\\\", \"/\")\n if picture.startswith(\"/\"):\n picture = picture[1:]\n encoded_name = urllib.parse.quote(picture)\n tags[\"picture\"] = try_add_access_control_param(\n self.config,\n f\"{self.config.hostname}:{self.config.public_port}/picture/{encoded_name}\",\n )\n\n # 如果是网络音乐，获取时长\n if self.is_web_music(name):\n try:\n duration = await self.get_music_duration(name)\n if duration > 0:\n tags[\"duration\"] = duration\n except Exception as e:\n self.log.exception(f\"获取网络音乐 {name} 时长失败: {e}\")\n return tags\n\n def set_music_tag(self, name, info):\n \"\"\"修改标签信息\n\n Args:\n name: 音乐名称\n info: 标签信息对象\n\n Returns:\n str: 操作结果消息\n \"\"\"\n if self._tag_generation_task:\n self.log.info(\"tag 更新中，请等待\")\n return \"Tag generation task running\"\n\n tags = copy.copy(self.all_music_tags.get(name, asdict(Metadata())))\n tags[\"title\"] = info.title\n tags[\"artist\"] = info.artist\n tags[\"album\"] = info.album\n tags[\"year\"] = info.year\n tags[\"genre\"] = info.genre\n tags[\"lyrics\"] = info.lyrics\n\n file_path = self.all_music[name]\n if info.picture:\n tags[\"picture\"] = save_picture_by_base64(\n info.picture, self.config.picture_cache_path, file_path\n )\n\n if self.config.enable_save_tag and (not self.is_web_music(name)):\n set_music_tag_to_file(file_path, Metadata(tags))\n\n self.all_music_tags[name] = tags\n self.try_save_tag_cache()\n return \"OK\"\n\n async def get_music_duration(self, name: str) -> float:\n \"\"\"获取歌曲时长\n\n 优先从缓存中读取，如果缓存中没有则获取并缓存\n 注意：此方法不处理在线音乐，在线音乐的时长获取在 music_url 中处理\n\n Args:\n name: 歌曲名称\n\n Returns:\n float: 歌曲时长（秒），失败返回 0\n \"\"\"\n # 检查歌曲是否存在\n if name not in self.all_music:\n self.log.warning(f\"歌曲 {name} 不存在\")\n return 0\n\n # 电台直接返回 0\n if self.is_web_radio_music(name):\n self.log.info(f\"电台 {name} 不会有播放时长\")\n return 0\n\n # 网络音乐：使用内存缓存\n if self.is_web_music(name):\n # 先检查内存缓存\n if name in self._web_music_duration_cache:\n duration = self._web_music_duration_cache[name]\n self.log.debug(f\"从内存缓存读取网络音乐 {name} 时长: {duration} 秒\")\n return duration\n\n # 缓存中没有，获取时长\n try:\n url, _ = await self._get_web_music_url(name)\n duration, _ = await get_web_music_duration(url, self.config)\n self.log.info(f\"网络音乐 {name} 时长: {duration} 秒\")\n\n # 存入内存缓存（不持久化）\n if duration > 0:\n self._web_music_duration_cache[name] = duration\n self.log.info(f\"已缓存网络音乐 {name} 时长到内存: {duration} 秒\")\n\n return duration\n except Exception as e:\n self.log.exception(f\"获取网络音乐 {name} 时长失败: {e}\")\n return 0\n\n # 本地音乐：使用持久化缓存\n # 先检查缓存中是否有时长信息\n if name in self.all_music_tags:\n duration = self.all_music_tags[name].get(\"duration\", 0)\n if duration > 0:\n self.log.debug(f\"从缓存读取本地音乐 {name} 时长: {duration} 秒\")\n return duration\n\n # 缓存中没有，需要获取时长\n duration = 0\n try:\n filename = self.all_music[name]\n if os.path.exists(filename):\n duration = await get_local_music_duration(filename, self.config)\n self.log.info(f\"本地音乐 {name} 时长: {duration} 秒\")\n else:\n self.log.warning(f\"本地音乐文件 {filename} 不存在\")\n\n # 获取到时长后，更新到缓存并持久化\n if duration > 0:\n if name not in self.all_music_tags:\n self.all_music_tags[name] = asdict(Metadata())\n self.all_music_tags[name][\"duration\"] = duration\n # 保存缓存\n self.try_save_tag_cache()\n self.log.info(f\"已缓存本地音乐 {name} 时长: {duration} 秒\")\n\n except Exception as e:\n self.log.exception(f\"获取本地音乐 {name} 时长失败: {e}\")\n\n return duration\n\n def refresh_music_tag(self):\n \"\"\"刷新音乐标签（给前端调用）\"\"\"\n if not self.ensure_single_thread_for_tag():\n return\n\n filename = self.config.tag_cache_path\n if filename is not None:\n # 清空 cache\n with open(filename, \"w\", encoding=\"utf-8\") as f:\n json.dump({}, f, ensure_ascii=False, indent=2)\n self.log.info(\"刷新：已清空 tag cache\")\n else:\n self.log.info(\"刷新：tag cache 未启用\")\n\n # TODO: 优化性能？\n # TODO 如何安全的清空 picture_cache_path\n self.all_music_tags = {} # 需要清空内存残留\n self.clear_web_music_duration_cache() # 清空网络音乐时长缓存\n self.try_gen_all_music_tag()\n self.log.info(\"刷新：已启动重建 tag cache\")\n\n def try_load_from_tag_cache(self):\n \"\"\"从缓存加载标签\n\n Returns:\n dict: 标签缓存字典\n \"\"\"\n filename = self.config.tag_cache_path\n tag_cache = {}\n\n try:\n if filename is not None:\n if os.path.exists(filename):\n with open(filename, encoding=\"utf-8\") as f:\n tag_cache = json.load(f)\n self.log.info(f\"已从【{filename}】加载 tag cache\")\n else:\n self.log.info(f\"【{filename}】tag cache 已启用，但文件不存在\")\n else:\n self.log.info(\"加载：tag cache 未启用\")\n except Exception as e:\n self.log.exception(f\"Execption {e}\")\n\n return tag_cache\n\n def try_save_tag_cache(self):\n \"\"\"保存标签缓存\"\"\"\n filename = self.config.tag_cache_path\n if filename is not None:\n with open(filename, \"w\", encoding=\"utf-8\") as f:\n json.dump(self.all_music_tags, f, ensure_ascii=False, indent=2)\n self.log.info(f\"保存：tag cache 已保存到【{filename}】\")\n else:\n self.log.info(\"保存：tag cache 未启用\")\n\n def ensure_single_thread_for_tag(self):\n \"\"\"确保标签生成任务单线程执行\n\n Returns:\n bool: 是否可以执行新任务\n \"\"\"\n if self._tag_generation_task:\n self.log.info(\"tag 更新中，请等待\")\n return not self._tag_generation_task\n\n def try_gen_all_music_tag(self, only_items=None):\n \"\"\"尝试生成所有音乐标签\n\n Args:\n only_items: 仅更新指定的音乐项，None表示更新全部\n \"\"\"\n if self.ensure_single_thread_for_tag():\n try:\n asyncio.get_running_loop()\n except RuntimeError:\n # 没有运行中的事件循环，跳过\n self.log.info(\"协程时间循环未启动\")\n return\n asyncio.ensure_future(self._gen_all_music_tag(only_items))\n self.log.info(\"启动后台构建 tag cache\")\n\n async def _gen_all_music_tag(self, only_items=None):\n \"\"\"生成所有音乐标签（异步）\n\n Args:\n only_items: 仅更新指定的音乐项，None表示更新全部\n \"\"\"\n self._tag_generation_task = True\n if only_items is None:\n only_items = self.all_music # 默认更新全部\n\n all_music_tags = self.try_load_from_tag_cache()\n all_music_tags.update(self.all_music_tags) # 保证最新\n\n ignore_tag_absolute_dirs = self.config.get_ignore_tag_dirs()\n self.log.info(f\"ignore_tag_absolute_dirs: {ignore_tag_absolute_dirs}\")\n\n for name, file_or_url in only_items.items():\n # 跳过网络音乐\n if self.is_web_music(name):\n continue\n start = time.perf_counter()\n if name not in all_music_tags:\n try:\n if os.path.exists(file_or_url) and not_in_dirs(\n file_or_url, ignore_tag_absolute_dirs\n ):\n all_music_tags[name] = extract_audio_metadata(\n file_or_url, self.config.picture_cache_path\n )\n else:\n self.log.info(f\"{name} {file_or_url} 无法更新 tag\")\n except BaseException as e:\n self.log.exception(f\"{e} {file_or_url} error {type(file_or_url)}!\")\n\n # 获取并缓存歌曲时长（仅本地音乐）\n if name in all_music_tags and \"duration\" not in all_music_tags[name]:\n try:\n duration = await self.get_music_duration(name)\n if duration > 0:\n all_music_tags[name][\"duration\"] = duration\n except Exception as e:\n self.log.warning(f\"获取歌曲 {name} 时长失败: {e}\")\n\n if (time.perf_counter() - start) < 1:\n await asyncio.sleep(0.001)\n else:\n # 处理一首歌超过1秒，则等1秒，解决挂载网盘卡死的问题\n await asyncio.sleep(1)\n\n # 全部更新结束后，一次性赋值\n self.all_music_tags = all_music_tags\n # 刷新 tag cache\n self.try_save_tag_cache()\n self._tag_generation_task = False\n self.log.info(\"tag 更新完成\")\n\n # ==================== 辅助方法 ====================\n\n def get_music_list(self):\n \"\"\"获取所有播放列表\n\n Returns:\n dict: 播放列表字典\n \"\"\"\n return self.music_list\n\n def get_all_music(self):\n \"\"\"获取所有音乐\n\n Returns:\n dict: 所有音乐字典\n \"\"\"\n return self.all_music\n\n def get_web_music_api(self):\n \"\"\"获取网络音乐API配置\n\n Returns:\n dict: 网络音乐API配置字典\n \"\"\"\n return self._web_music_api\n\n def get_all_radio(self):\n \"\"\"获取所有电台\n\n Returns:\n dict: 所有电台字典\n \"\"\"\n return self._all_radio\n\n def clear_web_music_duration_cache(self):\n \"\"\"清空网络音乐时长缓存\n\n 清空内存中的网络音乐时长缓存，不影响本地音乐的缓存\n \"\"\"\n self._web_music_duration_cache = {}\n self.log.info(\"已清空网络音乐时长缓存\")\n\n # ==================== URL处理方法 ====================\n\n async def get_music_url(self, name):\n \"\"\"获取音乐播放地址\n\n Args:\n name: 歌曲名称\n\n Returns:\n tuple: (播放地址, 原始地址) - 网络音乐时可能有原始地址\n \"\"\"\n self.log.info(f\"get_music_url name:{name}\")\n if self.is_web_music(name):\n return await self._get_web_music_url(name)\n return self._get_local_music_url(name), None\n\n async def _get_web_music_url(self, name):\n \"\"\"获取网络音乐播放地址\n\n Args:\n name: 歌曲名称\n\n Returns:\n tuple: (播放地址, 原始地址)\n \"\"\"\n self.log.info(\"in _get_web_music_url\")\n url = self.all_music[name]\n self.log.info(f\"get_music_url web music. name:{name}, url:{url}\")\n\n # 需要通过API获取真实播放地址\n if self.is_need_use_play_music_api(name):\n url = await self._get_url_from_api(name, url)\n if not url:\n return \"\", None\n\n # 是否需要代理\n if self.config.web_music_proxy or url.startswith(\"self://\"):\n # 判断是否为电台，传入 radio 参数\n is_radio = self.is_web_radio_music(name)\n proxy_url = self._get_proxy_url(url, is_radio=is_radio)\n return proxy_url, url\n\n return url, None\n\n async def _get_url_from_api(self, name, url):\n \"\"\"通过API获取真实播放地址\n\n Args:\n name: 歌曲名称\n url: 原始URL\n\n Returns:\n str: 真实播放地址，失败返回空字符串\n \"\"\"\n headers = self._web_music_api[name].get(\"headers\", {})\n url = await self.url_cache.get(url, headers, self.config)\n if not url:\n self.log.error(f\"_get_url_from_api use api fail. name:{name}, url:{url}\")\n return url\n\n def _get_proxy_url(self, origin_url, is_radio=None):\n \"\"\"获取代理URL\n\n 使用短 token 替代完整 base64 URL，避免 URL 过长超出小爱音箱等设备固件的\n HTTP 客户端 URL 长度限制（通常约 1024 字节），导致请求被截断返回 400。\n\n Args:\n origin_url: 原始URL\n is_radio: 是否为电台直播流\n\n Returns:\n str: 代理URL\n \"\"\"\n import secrets\n\n try:\n proxy_type = \"radio\" if is_radio else \"music\"\n token = secrets.token_urlsafe(8)\n set_proxy_token(token, origin_url, bool(is_radio))\n proxy_url = f\"{self.config.hostname}:{self.config.public_port}/proxy/{proxy_type}?token={token}\"\n self.log.info(f\"Using token proxy url: {proxy_url}\")\n return proxy_url\n except Exception as e:\n # fallback: 兼容旧方式\n self.log.warning(f\"token proxy failed, fallback to urlb64: {e}\")\n urlb64 = base64.b64encode(origin_url.encode(\"utf-8\")).decode(\"utf-8\")\n proxy_type = \"radio\" if is_radio else \"music\"\n proxy_url = f\"{self.config.hostname}:{self.config.public_port}/proxy/{proxy_type}?urlb64={urlb64}\"\n self.log.info(f\"Using proxy url: {proxy_url}\")\n return proxy_url\n\n def _get_local_music_url(self, name):\n \"\"\"获取本地音乐播放地址\n\n Args:\n name: 歌曲名称\n\n Returns:\n str: 本地音乐播放URL\n \"\"\"\n filename = self.get_filename(name)\n self.log.info(\n f\"_get_local_music_url local music. name:{name}, filename:{filename}\"\n )\n return self._get_file_url(filename)\n\n def _get_file_url(self, filepath):\n \"\"\"根据文件路径生成可访问的URL\n\n Args:\n filepath: 文件的完整路径\n\n Returns:\n str: 文件访问URL\n \"\"\"\n filename = filepath\n\n # 处理文件路径\n if filename.startswith(self.config.music_path):\n filename = filename[len(self.config.music_path) :]\n filename = filename.replace(\"\\\\\", \"/\")\n if filename.startswith(\"/\"):\n filename = filename[1:]\n\n self.log.info(f\"_get_file_url filepath:{filepath}, filename:{filename}\")\n\n # 构造URL\n encoded_name = urllib.parse.quote(filename)\n url = f\"{self.config.hostname}:{self.config.public_port}/music/{encoded_name}\"\n return try_add_access_control_param(self.config, url)\n\n @staticmethod\n async def get_play_url(proxy_url):\n \"\"\"获取播放URL\n\n Args:\n proxy_url: 代理URL\n\n Returns:\n str: 最终重定向的URL\n \"\"\"\n import aiohttp\n\n async with aiohttp.ClientSession() as session:\n async with session.get(proxy_url) as response:\n # 获取最终重定向的 URL\n return str(response.url)\n\n def expand_self_url(self, origin_url):\n parsed_url = urlparse(origin_url)\n self.log.info(f\"链接处理前 ${parsed_url}\")\n if parsed_url.scheme != \"self\":\n return parsed_url, origin_url\n\n url = f\"{self.config.hostname}:{self.config.public_port}{parsed_url.path}\"\n if parsed_url.query:\n url += f\"?{parsed_url.query}\"\n if parsed_url.fragment:\n url += f\"#{parsed_url.fragment}\"\n\n return urlparse(url), url\n" }, { "path": "xiaomusic/online_music.py", "content": "\"\"\"在线音乐服务模块\n\n负责MusicFree插件集成、在线音乐搜索和播放链接获取。\n\"\"\"\n\nimport asyncio\nimport base64\nimport ipaddress\nimport json\nimport socket\nfrom urllib.parse import urlparse\n\nimport aiohttp\n\nfrom xiaomusic.const import PLAY_TYPE_ALL\n\n\ndef _build_keyword(song_name, artist):\n \"\"\"\n 根据歌名和艺术家构建关键词\n\n Args:\n song_name: 歌名\n artist: 艺术家\n\n Returns:\n str: 构建后的关键词\n \"\"\"\n if song_name and artist:\n return f\"{song_name}-{artist}\"\n elif song_name:\n return song_name\n elif artist:\n return artist\n return \"\"\n\n\ndef _parse_keyword_by_dash(keyword):\n if \"-\" in keyword:\n parts = keyword.split(\"-\", 1) # 只分割第一个 `-`\n return parts[0].strip(), parts[1].strip()\n return keyword, \"\"\n\n\nclass OnlineMusicService:\n \"\"\"在线音乐服务\n\n 负责处理在线音乐搜索、插件调用和播放链接获取。\n \"\"\"\n\n def __init__(self, log, js_plugin_manager, xiaomusic_instance=None):\n \"\"\"初始化在线音乐服务\n\n Args:\n log: 日志对象\n js_plugin_manager: JS插件管理器\n \"\"\"\n self.log = log\n self.js_plugin_manager = js_plugin_manager\n self.xiaomusic = xiaomusic_instance\n\n async def get_music_list_online(\n self, plugin=\"all\", keyword=\"\", page=1, limit=20, **kwargs\n ):\n \"\"\"在线获取歌曲列表\n\n Args:\n plugin: 插件名称，\"OpenAPI\"表示通过开放接口获取，其他为插件在线搜索\n keyword: 搜索关键词\n page: 页码\n limit: 每页数量\n **kwargs: 其他参数\n\n Returns:\n dict: 搜索结果\n \"\"\"\n self.log.info(\"在线获取歌曲列表!\")\n if not self.js_plugin_manager:\n return {\"success\": False, \"error\": \"JS Plugin Manager not available\"}\n\n # 解析关键词和艺术家\n keyword, artist = await self._parse_keyword_and_artist(keyword)\n\n # 获取API配置信息\n openapi_info = self.js_plugin_manager.get_openapi_info()\n\n if plugin == \"all\":\n # 并发执行插件搜索和OpenAPI搜索\n return await self._execute_concurrent_searches(\n keyword, artist, page, limit, openapi_info\n )\n elif plugin == \"OpenAPI\":\n # OpenAPI搜索\n return await self._execute_openapi_search(openapi_info, keyword, artist)\n else:\n # 插件在线搜索\n return await self._execute_plugin_search(\n plugin, keyword, artist, page, limit\n )\n\n async def _parse_keyword_and_artist(self, keyword):\n \"\"\"解析关键词和艺术家\"\"\"\n parsed_keyword, parsed_artist = await self._parse_keyword_with_ai(keyword)\n keyword = parsed_keyword or keyword\n artist = parsed_artist or \"\"\n return keyword, artist\n\n async def _execute_concurrent_searches(\n self, keyword, artist, page, limit, openapi_info\n ):\n \"\"\"执行并发搜索 - 插件和OpenAPI\"\"\"\n tasks = []\n\n # 插件在线搜索任务\n plugin_task = asyncio.create_task(\n self.get_music_list_mf(\n \"all\", keyword=keyword, artist=artist, page=page, limit=limit\n )\n )\n tasks.append(plugin_task)\n\n # OpenAPI搜索任务（只有在配置正确时才创建）\n if (\n openapi_info.get(\"enabled\", False)\n and openapi_info.get(\"search_url\", \"\") != \"\"\n ):\n openapi_task = asyncio.create_task(\n self.js_plugin_manager.openapi_search(\n url=openapi_info.get(\"search_url\"), keyword=keyword, artist=artist\n )\n )\n tasks.append(openapi_task)\n\n # 并发执行任务\n results = await asyncio.gather(*tasks, return_exceptions=True)\n\n plugin_result = results[0]\n openapi_result = results[1] if len(results) > 1 else None\n\n # 处理异常情况\n plugin_result = self._handle_search_exception(plugin_result, \"插件\")\n openapi_result = self._handle_search_exception(openapi_result, \"OpenAPI\")\n\n # 合并结果\n combined_result = self._merge_search_results(\n plugin_result, openapi_result, keyword, artist, limit\n )\n combined_result[\"artist\"] = artist or \"佚名\"\n return combined_result\n\n def _handle_search_exception(self, result, source_name):\n \"\"\"处理搜索异常\"\"\"\n if result and isinstance(result, Exception):\n self.log.error(f\"{source_name}搜索发生异常: {result}\")\n return {\"success\": False, \"error\": str(result)}\n return result\n\n async def _execute_openapi_search(self, openapi_info, keyword, artist):\n \"\"\"执行OpenAPI搜索\"\"\"\n if (\n openapi_info.get(\"enabled\", False)\n and openapi_info.get(\"search_url\", \"\") != \"\"\n ):\n # 开放接口获取\n result_data = await self.js_plugin_manager.openapi_search(\n url=openapi_info.get(\"search_url\"), keyword=keyword, artist=artist\n )\n else:\n return {\"success\": False, \"error\": \"OpenAPI未启用或配置错误\"}\n\n result_data[\"artist\"] = artist or \"佚名\"\n return result_data\n\n async def _execute_plugin_search(self, plugin, keyword, artist, page, limit):\n \"\"\"执行插件搜索\"\"\"\n result_data = await self.get_music_list_mf(\n plugin, keyword=keyword, artist=artist, page=page, limit=limit\n )\n result_data[\"artist\"] = artist or \"佚名\"\n return result_data\n\n def _merge_search_results(\n self, plugin_result, openapi_result, keyword, artist, limit\n ):\n merged_data = []\n sources = {}\n\n # 先处理 OpenAPI 结果\n if openapi_result and openapi_result.get(\"success\"):\n openapi_data = openapi_result.get(\"data\", [])\n if openapi_data:\n for item in openapi_data:\n item[\"source\"] = \"openapi\"\n merged_data.extend(openapi_data)\n if \"sources\" in openapi_result:\n sources.update(openapi_result[\"sources\"])\n\n # 再处理插件结果\n if plugin_result and plugin_result.get(\"success\"):\n plugin_data = plugin_result.get(\"data\", [])\n if plugin_data:\n for item in plugin_data:\n item[\"source\"] = \"plugin\"\n merged_data.extend(plugin_data)\n sources.update(plugin_result.get(\"sources\", {}))\n\n # 如果都没有成功结果，返回错误\n if not plugin_result.get(\"success\") and not (\n openapi_result and openapi_result.get(\"success\")\n ):\n # 优先返回第一个错误\n error_result = (\n plugin_result if not plugin_result.get(\"success\") else openapi_result\n )\n return error_result\n\n # 优化合并后的结果\n optimized_result = self.js_plugin_manager.optimize_search_results(\n {\"data\": merged_data},\n search_keyword=keyword,\n limit=limit,\n search_artist=artist,\n )\n\n return {\n \"success\": True,\n \"data\": optimized_result.get(\"data\", []),\n \"total\": len(optimized_result.get(\"data\", [])),\n \"sources\": sources,\n \"merged\": True, # 标识这是合并结果\n }\n\n async def get_music_list_mf(\n self, plugin=\"all\", keyword=\"\", artist=\"\", page=1, limit=20, **kwargs\n ):\n self.log.info(\"通过MusicFree插件搜索音乐列表!\")\n \"\"\"\n 通过MusicFree插件搜索音乐列表\n\n Args:\n plugin: 插件名称，\"all\"表示所有插件\n keyword: 搜索关键词\n page: 页码\n limit: 每页数量\n **kwargs: 其他参数\n\n Returns:\n dict: 搜索结果\n \"\"\"\n # 检查JS插件管理器是否可用\n if not self.js_plugin_manager:\n return {\"success\": False, \"error\": \"JS插件管理器不可用\"}\n try:\n if plugin == \"all\":\n # 搜索所有启用的插件\n return await self._search_all_plugins(keyword, artist, page, limit)\n else:\n # 搜索指定插件\n return await self._search_specific_plugin(\n plugin, keyword, artist, page, limit\n )\n except Exception as e:\n self.log.error(f\"搜索音乐时发生错误: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n # 调用在线搜索歌手，添加歌手歌单并播放\n async def search_singer_play(self, did, search_key, name):\n try:\n # 解析歌手名，可能通过AI或直接分割\n parsed_keyword, parsed_artist = await self._parse_keyword_with_ai(name)\n list_name = \"_online_\" + parsed_artist\n artist_song_list = self.xiaomusic.music_library.get_music_list().get(\n list_name, []\n )\n if len(artist_song_list) > 0:\n # 如果歌单存在，则直接播放\n song_name = artist_song_list[0]\n await self.xiaomusic.do_play_music_list(did, list_name, song_name)\n else:\n # 获取歌曲列表\n result = await self.get_music_list_online(keyword=name, limit=10)\n self.log.info(f\"在线搜索歌手的歌曲列表: {result}\")\n\n if result.get(\"success\") and result.get(\"total\") > 0:\n # 打印输出 result.data\n self.log.info(f\"歌曲列表: {result.get('data')}\")\n list_name = \"_online_\" + result.get(\"artist\")\n # 调用公共函数,处理歌曲信息 -> 添加歌单 -> 播放歌单\n return await self.push_music_list_play(\n did=did, song_list=result.get(\"data\"), list_name=list_name\n )\n else:\n return {\"success\": False, \"error\": \"未找到歌曲\"}\n\n except Exception as e:\n # 记录错误日志\n self.log.error(f\"searchKey {search_key} get media source failed: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n # 调用在线搜索歌手，追加歌手歌曲\n async def add_singer_song(self, list_name, name):\n try:\n # 获取歌曲列表\n result = await self.get_music_list_online(keyword=name, limit=10)\n if result.get(\"success\") and result.get(\"total\") > 0:\n self._handle_music_list(result.get(\"data\"), list_name, True)\n else:\n return {\"success\": False, \"error\": \"未找到歌曲\"}\n except Exception as e:\n # 记录错误日志\n return {\"success\": False, \"error\": str(e)}\n\n \"\"\"------------------------私有--------------------------\"\"\"\n\n async def _parse_keyword_with_ai(self, keyword):\n \"\"\"\n 使用AI解析关键词，如果AI不可用则使用传统分割方式\n Args:\n keyword: 原始关键词\n Returns:\n tuple: (parsed_keyword, parsed_artist)\n \"\"\"\n # 获取AI配置信息\n ai_info = self.js_plugin_manager.get_aiapi_info()\n # 如果AI启用且配置完整\n if ai_info.get(\"enabled\", False) and ai_info.get(\"api_key\", \"\") != \"\":\n try:\n from xiaomusic.utils.openai_utils import (\n analyze_music_command as utils_analyze_music_command,\n )\n\n params = {\"command\": keyword, \"api_key\": ai_info.get(\"api_key\")}\n\n # 添加可选参数\n if \"base_url\" in ai_info:\n params[\"base_url\"] = ai_info[\"base_url\"]\n if \"model\" in ai_info:\n params[\"model\"] = ai_info[\"model\"]\n\n result = await utils_analyze_music_command(**params)\n\n if result and (result.get(\"name\") or result.get(\"artist\")):\n song_name = result.get(\"name\", \"\")\n artist = result.get(\"artist\", \"\")\n # 构建新的关键词\n # keyword = _build_keyword(song_name, artist)\n keyword = song_name\n self.log.info(f\"AI提取到的信息: {result}\")\n return keyword, artist\n\n except Exception as e:\n self.log.error(f\"AI提取报错: {e}\")\n\n # 如果AI不可用或处理失败，使用传统分割方式\n return _parse_keyword_by_dash(keyword)\n\n # 处理推送的歌单\n def _handle_music_list(\n self, song_list=None, list_name=\"_online_play\", append=False\n ):\n \"\"\"\n 数据转换：将外部歌单格式转换为后端支持的格式\n 保存配置：将歌单数据保存到配置中\n 更新列表：触发后端重新生成音乐列表\n Args:\n song_list: 歌曲列表\n list_name: 列表名称\n append: 是否追加\n Returns:\n dict: 操作结果\n \"\"\"\n try:\n if len(song_list) > 1:\n # 对歌单 歌名+歌手名进行去重\n song_list = self._deduplicate_song_list(song_list)\n # 转换外部歌单格式为内部支持的格式\n converted_music_list = self._convert_song_list_to_music_items(song_list)\n if not converted_music_list:\n return {\"success\": False, \"error\": \"没有有效的歌曲可以添加\"}\n music_library = self.xiaomusic.music_library\n # 更新配置中的音乐歌单Json\n music_library.update_music_list_json(\n list_name, converted_music_list, append\n )\n # 重新生成音乐列表\n music_library.gen_all_music_list()\n except Exception as e:\n self.log.error(f\"推送歌单失败: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n # 在线播放：在线搜索、播放\n async def online_play(self, did=\"\", arg1=\"\", **kwargs):\n await self._before_play()\n # 获取搜索关键词\n parts = arg1.split(\"|\")\n search_key = parts[0]\n name = parts[1] if len(parts) > 1 else search_key\n if not name:\n name = search_key\n self.log.info(f\"搜索关键字{search_key},提取的歌名{name}\")\n await self.search_top_one_play(did, search_key, name)\n\n # 播放歌手：在线搜索歌手并存为列表播放\n async def singer_play(self, did=\"\", arg1=\"\", **kwargs):\n await self._before_play()\n # 获取搜索关键词\n parts = arg1.split(\"|\")\n search_key = parts[0]\n name = parts[1] if len(parts) > 1 else search_key\n if not name:\n name = search_key\n self.log.info(f\"搜索关键字{search_key},搜索歌手名{name}\")\n await self.search_singer_play(did, search_key, name)\n\n # 处理推送的歌单并播放\n async def push_music_list_play(\n self, did=\"web_device\", song_list=None, list_name=\"_online_play\", **kwargs\n ):\n \"\"\"\n 处理推送的歌单信息 -> 添加歌单 -> 播放歌单\n\n Args:\n did: 设备ID\n song_list: 歌曲列表\n list_name: 列表名称\n **kwargs: 其他参数\n Returns:\n dict: 操作结果\n \"\"\"\n if song_list is None:\n song_list = []\n\n self.log.info(\n f\"推送歌单播放, 歌单名称: {list_name}, 歌曲数量: {len(song_list)}, 设备ID: {did}\"\n )\n # 验证输入参数\n if not song_list and len(song_list) > 0:\n return {\"success\": False, \"error\": \"歌曲列表不能为空\"}\n try:\n self._handle_music_list(song_list, list_name)\n # 如果指定了特定设备，播放歌单\n if did != \"web_device\" and self.xiaomusic.did_exist(did):\n # 歌单推送应该是全部播放，不随机打乱\n await self.xiaomusic.set_play_type(did, PLAY_TYPE_ALL, False)\n push_playlist = self.xiaomusic.music_library.get_music_list()[list_name]\n song_name = push_playlist[0]\n await self.xiaomusic.do_play_music_list(did, list_name, song_name)\n return {\n \"success\": True,\n \"message\": f\"成功推送歌单 {list_name}\",\n \"list_name\": list_name,\n }\n else:\n return {\"success\": False, \"error\": \"设备不存在！\"}\n except Exception as e:\n self.log.error(f\"推送歌单播放失败: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n # 在线搜索搜索最符合的一首歌并播放\n async def search_top_one_play(self, did, search_key, name):\n try:\n # 获取歌曲列表\n result = await self.get_music_list_online(keyword=name, limit=10)\n\n if result.get(\"success\") and result.get(\"total\") > 0:\n # 打印输出 result.data\n self.log.info(f\"在线搜索的歌曲列表: {result.get('data')}\")\n # 根据搜素关键字，智能搜索出最符合的一条music_item\n top_one_list = await self._search_top_one(\n result.get(\"data\"), search_key, name\n )\n list_name = \"_online_play\"\n # 调用公共函数,处理歌曲信息 -> 添加歌单 -> 播放歌单\n return await self.push_music_list_play(\n did=did, song_list=top_one_list, list_name=list_name\n )\n else:\n return {\"success\": False, \"error\": \"未找到歌曲\"}\n except Exception as e:\n # 记录错误日志\n self.log.error(f\"searchKey {search_key} get media source failed: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n def default_url(self):\n # 先推送默认【搜索中】音频，搜索到播放url后推送给小爱\n config = self.xiaomusic.config\n if config and hasattr(config, \"hostname\") and hasattr(config, \"public_port\"):\n proxy_base = f\"{config.hostname}:{config.public_port}\"\n else:\n proxy_base = \"http://192.168.31.241:8090\"\n # return proxy_base + \"/static/search.mp3\"\n return proxy_base + \"/static/silence.mp3\"\n\n async def _before_play(self):\n # 先推送默认【搜索中】音频，搜索到播放url后推送给小爱\n before_url = self.default_url()\n await self.xiaomusic.play_url(self.xiaomusic.get_cur_did(), before_url)\n\n def _convert_song_list_to_music_items(self, song_list):\n \"\"\"\n 将外部歌单格式转换为内部支持的格式\n\n Args:\n song_list: 外部歌单数据\n\n Returns:\n list: 转换后的音乐项目列表\n \"\"\"\n converted_music_list = []\n for item in song_list:\n if isinstance(item, dict):\n source_url = item.get(\"url\", \"\")\n music_item = {}\n if source_url:\n music_item[\"url\"] = source_url\n else:\n # 返回插件源的代理接口\n music_item[\"url\"] = self._get_plugin_proxy_url(item)\n # 其他信息\n music_item[\"name\"] = item.get(\"title\") + \"-\" + item.get(\"artist\")\n music_item[\"type\"] = item.get(\"type\", \"music\")\n else:\n continue\n\n if music_item[\"name\"]:\n converted_music_list.append(music_item)\n\n return converted_music_list\n\n def _get_plugin_proxy_url(self, origin_data):\n \"\"\"获取插件源代理URL\"\"\"\n origin_data = json.dumps(origin_data)\n datab64 = base64.b64encode(origin_data.encode(\"utf-8\")).decode(\"utf-8\")\n plugin_source_url = f\"self:///api/proxy/plugin-url?data={datab64}\"\n self.log.info(f\"plugin_source_url : {plugin_source_url}\")\n return plugin_source_url\n\n async def _search_all_plugins(self, keyword, artist, page, limit):\n \"\"\"搜索所有启用的插件\n\n Args:\n keyword: 搜索关键词\n artist: 艺术家名称\n page: 页码\n limit: 每页数量\n\n Returns:\n dict: 搜索结果\n \"\"\"\n enabled_plugins = self.js_plugin_manager.get_enabled_plugins()\n if not enabled_plugins:\n return {\"success\": False, \"error\": \"没有可用的接口和插件，请先进行配置！\"}\n\n results = []\n sources = {}\n\n # 计算每个插件的限制数量\n plugin_count = len(enabled_plugins)\n item_limit = max(1, limit // plugin_count) if plugin_count > 0 else limit\n\n # 并行搜索所有插件\n search_tasks = [\n self._search_plugin_task(plugin_name, keyword, page, item_limit)\n for plugin_name in enabled_plugins\n ]\n\n plugin_results = await asyncio.gather(*search_tasks, return_exceptions=True)\n\n # 处理搜索结果\n for i, result in enumerate(plugin_results):\n plugin_name = list(enabled_plugins)[i]\n\n # 检查是否为异常对象\n if isinstance(result, Exception):\n self.log.error(f\"插件 {plugin_name} 搜索失败: {result}\")\n continue\n\n # 检查是否为有效的搜索结果\n if result and isinstance(result, dict):\n # 检查是否有错误信息\n if \"error\" in result:\n self.log.error(\n f\"插件 {plugin_name} 搜索失败: {result.get('error', '未知错误')}\"\n )\n continue\n\n # 处理成功的搜索结果\n data_list = result.get(\"data\", [])\n if data_list:\n results.extend(data_list)\n sources[plugin_name] = len(data_list)\n # 如果没有data字段但有其他数据，也认为是成功的结果\n elif result: # 非空字典\n results.append(result)\n sources[plugin_name] = 1\n\n # 统一排序并提取前limit条数据\n if results:\n unified_result = {\"data\": results}\n optimized_result = self.js_plugin_manager.optimize_search_results(\n unified_result,\n search_keyword=keyword,\n limit=limit,\n search_artist=artist,\n )\n results = optimized_result.get(\"data\", [])\n\n return {\n \"success\": True,\n \"data\": results,\n \"total\": len(results),\n \"sources\": sources,\n \"page\": page,\n \"limit\": limit,\n }\n\n async def _search_specific_plugin(self, plugin, keyword, artist, page, limit):\n \"\"\"搜索指定插件\n\n Args:\n plugin: 插件名称\n keyword: 搜索关键词\n artist: 艺术家名称\n page: 页码\n limit: 每页数量\n\n Returns:\n dict: 搜索结果\n \"\"\"\n try:\n results = self.js_plugin_manager.search(plugin, keyword, page, limit)\n\n # 额外检查 resources 字段\n data_list = results.get(\"data\", [])\n if data_list:\n # 优化搜索结果排序\n results = self.js_plugin_manager.optimize_search_results(\n results, search_keyword=keyword, limit=limit, search_artist=artist\n )\n\n return {\n \"success\": True,\n \"data\": results.get(\"data\", []),\n \"total\": results.get(\"total\", 0),\n \"page\": page,\n \"limit\": limit,\n }\n except Exception as e:\n self.log.error(f\"插件 {plugin} 搜索失败: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n async def _search_plugin_task(self, plugin_name, keyword, page, limit):\n \"\"\"单个插件搜索任务\"\"\"\n try:\n return self.js_plugin_manager.search(plugin_name, keyword, page, limit)\n except Exception as e:\n # 直接抛出异常，让 asyncio.gather 处理\n raise e\n\n # 调用MusicFree插件获取真实播放url\n async def get_media_source_url(self, music_item, quality: str = \"standard\"):\n \"\"\"获取音乐项的媒体源URL\n Args:\n music_item : MusicFree插件定义的 IMusicItem\n quality: 音质参数\n Returns:\n dict: 包含成功状态和URL信息的字典\n \"\"\"\n # kwargs可追加\n kwargs = {\"quality\": quality}\n return await self._call_plugin_method(\n plugin_name=music_item.get(\"platform\"),\n method_name=\"get_media_source\",\n music_item=music_item,\n result_key=\"url\",\n required_field=\"url\",\n **kwargs,\n )\n\n async def get_media_lyric(self, music_item):\n \"\"\"获取音乐项的歌词 Lyric\n\n Args:\n music_item: MusicFree插件定义的 IMusicItem\n\n Returns:\n dict: 包含成功状态和歌词信息的字典\n \"\"\"\n return await self._call_plugin_method(\n plugin_name=music_item.get(\"platform\"),\n method_name=\"get_lyric\",\n music_item=music_item,\n result_key=\"rawLrc\",\n required_field=\"rawLrc\",\n )\n\n def _deduplicate_song_list(self, song_list):\n \"\"\"\n 根据歌名+歌手名对歌单中歌曲进行去重\n Args:\n song_list: 原始歌曲列表\n Returns:\n unique_songs: 去重后的歌曲列表\n \"\"\"\n seen = set()\n unique_songs = []\n\n for song in song_list:\n # 构建唯一标识：歌名+歌手名\n song_title = song.get(\"title\", \"\")\n song_artist = song.get(\"artist\", \"\")\n\n # 创建唯一标识符\n unique_key = f\"{song_title.lower()}_{song_artist.lower()}\"\n\n # 如果未见过此唯一标识，则添加到结果中\n if unique_key not in seen:\n seen.add(unique_key)\n unique_songs.append(song)\n\n self.log.info(\n f\"歌单去重完成，原始数量: {len(song_list)}, 去重后数量: {len(unique_songs)}\"\n )\n return unique_songs\n\n async def _search_top_one(self, music_items, search_key, name):\n \"\"\"智能搜索出最符合的一条music_item\"\"\"\n try:\n if not music_items:\n return []\n\n self.log.info(f\"搜索关键字: {search_key}；歌名：{name}\")\n\n # 使用更高效的算法进行匹配\n if len(music_items) == 1:\n return music_items\n\n # 计算每个项目的匹配分数\n keyword = search_key.lower().strip()\n if not keyword:\n return [music_items[0]] # 如果没有搜索词，返回第一首\n\n def calculate_match_score(item):\n \"\"\"计算匹配分数\"\"\"\n title = (item.get(\"title\", \"\") or \"\").lower()\n artist = (item.get(\"artist\", \"\") or \"\").lower()\n\n score = 0\n # 歌曲名匹配权重\n if keyword in title:\n # 完全匹配得最高分\n if title == keyword:\n score += 90\n # 开头匹配\n elif title.startswith(keyword):\n score += 70\n # 结尾匹配\n elif title.endswith(keyword):\n score += 50\n # 包含匹配\n else:\n score += 30\n # 部分字符匹配\n elif any(char in title for char in keyword.split()):\n score += 10\n\n # 艺术家名匹配权重\n if keyword in artist:\n # 完全匹配\n if artist == keyword:\n score += 9\n # 开头匹配\n elif artist.startswith(keyword):\n score += 7\n # 结尾匹配\n elif artist.endswith(keyword):\n score += 5\n # 包含匹配\n else:\n score += 3\n # 部分字符匹配\n elif any(char in artist for char in keyword.split()):\n score += 1\n\n return score\n\n # 按匹配分数排序，返回分数最高的项目\n sorted_items = sorted(music_items, key=calculate_match_score, reverse=True)\n return [sorted_items[0]]\n\n except Exception as e:\n self.log.error(f\"_search_top_one error: {e}\")\n # 出现异常时返回第一个项目\n return [music_items[0]] if music_items else []\n\n async def _call_plugin_method(\n self,\n plugin_name: str,\n method_name: str,\n music_item: dict,\n result_key: str,\n required_field: str = None,\n **kwargs,\n ):\n \"\"\"通用方法：调用 JS 插件的方法并返回结果\n\n Args:\n plugin_name: 插件名称\n method_name: 插件方法名（如 get_media_source 或 get_lyric）\n music_item: 音乐项数据\n result_key: 返回结果中的字段名（如 'url' 或 'rawLrc'）\n required_field: 必须存在的字段（用于校验）\n **kwargs: 传递给插件方法的额外参数\n\n Returns:\n dict: 包含 success 和对应字段的字典\n \"\"\"\n if not music_item:\n return {\"success\": False, \"error\": \"Music item required\"}\n\n # 检查插件管理器是否可用\n if not self.js_plugin_manager:\n return {\"success\": False, \"error\": \"JS Plugin Manager not available\"}\n\n enabled_plugins = self.js_plugin_manager.get_enabled_plugins()\n if plugin_name not in enabled_plugins:\n return {\"success\": False, \"error\": f\"Plugin {plugin_name} not enabled\"}\n\n try:\n # 调用插件方法，传递额外参数\n result = getattr(self.js_plugin_manager, method_name)(\n plugin_name, music_item, **kwargs\n )\n if (\n not result\n or not result.get(result_key)\n or result.get(result_key) == \"None\"\n ):\n return {\"success\": False, \"error\": f\"Failed to get {result_key}\"}\n\n # 如果指定了必填字段，则额外校验\n if required_field and not result.get(required_field):\n return {\n \"success\": False,\n \"error\": f\"Missing required field: {required_field}\",\n }\n # 追加属性后返回\n result[\"success\"] = True\n return result\n\n except Exception as e:\n self.log.error(f\"Plugin {plugin_name} {method_name} failed: {e}\")\n return {\"success\": False, \"error\": str(e)}\n\n @staticmethod\n async def _make_request_with_validation(\n url: str, timeout: int, convert_m4s: bool = False\n ) -> str:\n \"\"\"\n 通用的URL请求和验证方法\n\n Args:\n url (str): 原始音乐URL\n timeout (int): 请求超时时间(秒)\n\n Returns:\n str: 最终的真实播放URL，如果代理不成功则返回原始URL\n \"\"\"\n\n # 内部辅助函数：检查主机解析到的IP是否安全，防止访问内网/本地地址\n def _is_safe_hostname(parsed) -> bool:\n hostname = parsed.hostname\n if not hostname:\n return False\n try:\n # 解析主机名对应的所有地址\n addrinfo_list = socket.getaddrinfo(hostname, None)\n except Exception:\n return False\n for family, _, _, _, sockaddr in addrinfo_list:\n ip_str = (\n sockaddr[0] if family in (socket.AF_INET, socket.AF_INET6) else None\n )\n if not ip_str:\n continue\n try:\n ip_obj = ipaddress.ip_address(ip_str)\n except ValueError:\n return False\n # 拒绝内网、回环、链路本地、多播和保留地址\n if (\n ip_obj.is_private\n or ip_obj.is_loopback\n or ip_obj.is_link_local\n or ip_obj.is_multicast\n or ip_obj.is_reserved\n ):\n return False\n return True\n\n try:\n # 验证URL格式\n parsed_url = urlparse(url)\n if not parsed_url.scheme or not parsed_url.netloc:\n return url # 返回原始URL\n # 仅允许 http/https\n if parsed_url.scheme not in (\"http\", \"https\"):\n return url # 返回原始URL\n # 检查主机是否安全，防止SSRF到内网\n if not _is_safe_hostname(parsed_url):\n return url # 返回原始URL\n\n # 创建aiohttp客户端会话\n async with aiohttp.ClientSession() as session:\n # 发送HEAD请求跟随重定向\n async with session.head(\n url,\n allow_redirects=True,\n timeout=aiohttp.ClientTimeout(total=timeout),\n ) as response:\n # 获取最终重定向后的URL\n final_url = str(response.url)\n return final_url\n except Exception:\n return url # 返回原始URL\n" }, { "path": "xiaomusic/plugin.py", "content": "import importlib\nimport inspect\nimport pkgutil\nfrom typing import TYPE_CHECKING\n\nif TYPE_CHECKING:\n from xiaomusic.xiaomusic import XiaoMusic\n\n\nclass PluginManager:\n def __init__(self, xiaomusic: \"XiaoMusic\", plugin_dir=\"plugins\"):\n self.xiaomusic = xiaomusic\n self.log = xiaomusic.log\n self._funcs = {}\n self._load_plugins(plugin_dir)\n\n def _load_plugins(self, plugin_dir):\n # 假设 plugins 已经在搜索路径上\n package_name = plugin_dir\n package = importlib.import_module(package_name)\n\n # 遍历 package 中所有模块并动态导入它们\n for _, modname, _ in pkgutil.iter_modules(package.__path__, package_name + \".\"):\n # 跳过__init__文件\n if modname.endswith(\"__init__\"):\n continue\n module = importlib.import_module(modname)\n # 将 log 和 xiaomusic 注入模块的命名空间\n module.log = self.log\n module.xiaomusic = self.xiaomusic\n\n # 动态获取模块中与文件名同名的函数\n function_name = modname.split(\".\")[-1] # 从模块全名提取函数名\n if hasattr(module, function_name):\n self._funcs[function_name] = getattr(module, function_name)\n else:\n self.log.error(\n f\"No function named '{function_name}' found in module {modname}\"\n )\n\n def get_func(self, plugin_name):\n \"\"\"根据插件名获取插件函数\"\"\"\n return self._funcs.get(plugin_name)\n\n def get_local_namespace(self):\n \"\"\"返回包含所有插件函数的字典，可以用作 exec 要执行的代码的命名空间\"\"\"\n return self._funcs.copy()\n\n async def execute_plugin(self, code):\n \"\"\"\n 执行指定的插件代码。插件函数可以是同步或异步。\n :param code: 需要执行的插件函数代码（例如 'plugin1(\"hello\")'）\n \"\"\"\n # 分解代码字符串以获取函数名\n func_name = code.split(\"(\")[0]\n\n # 根据解析出的函数名从插件字典中获取函数\n plugin_func = self.get_func(func_name)\n\n if not plugin_func:\n raise ValueError(f\"No plugin function named '{func_name}' found.\")\n\n # 检查函数是否是异步函数\n global_namespace = globals().copy()\n local_namespace = self.get_local_namespace()\n if inspect.iscoroutinefunction(plugin_func):\n # 如果是异步函数，构建执行用的协程对象\n coroutine = eval(code, global_namespace, local_namespace)\n # 等待协程执行\n await coroutine\n else:\n # 如果是普通函数，直接执行代码\n eval(code, global_namespace, local_namespace)\n" }, { "path": "xiaomusic/plugins-config-example.json", "content": "{\n \"account\": \"\",\n \"password\": \"\",\n \"openapi_info\": {\n \"search_url\": \"\",\n \"enabled\": false\n },\n \"enabled_plugins\": [],\n \"plugins_info\": []\n}\n" }, { "path": "xiaomusic/qrcode_login.py", "content": "import base64\nimport hashlib\nimport json\nimport locale\nimport os\nimport random\nimport time\nfrom datetime import datetime, timedelta\nfrom gzip import GzipFile\nfrom io import BytesIO\nfrom pathlib import Path\nfrom urllib import parse\n\nimport requests\nimport tzlocal\nfrom Crypto.Cipher import ARC4\nfrom qrcode import QRCode\n\n\ndef gen_nonce():\n millis = int(round(time.time() * 1000))\n b = (random.getrandbits(64) - 2**63).to_bytes(8, \"big\", signed=True)\n part2 = int(millis / 60000)\n b += part2.to_bytes(((part2.bit_length() + 7) // 8), \"big\")\n return base64.b64encode(b).decode(\"utf-8\")\n\n\ndef get_signed_nonce(ssecret, nonce):\n m = hashlib.sha256()\n m.update(base64.b64decode(bytes(ssecret, \"utf-8\")))\n m.update(base64.b64decode(bytes(nonce, \"utf-8\")))\n base64_bytes = base64.b64encode(m.digest())\n return base64_bytes.decode(\"utf-8\")\n\n\ndef gen_enc_signature(uri, method, signed_nonce, params):\n signature_params = [\n str(method).upper(),\n uri,\n ]\n\n for k, v in params.items():\n signature_params.append(f\"{k}={v}\")\n\n signature_params.append(signed_nonce)\n signature_string = \"&\".join(signature_params)\n return base64.b64encode(\n hashlib.sha1(signature_string.encode(\"utf-8\")).digest()\n ).decode()\n\n\ndef generate_enc_params(uri, method, signed_nonce, nonce, params, ssecurity):\n params[\"rc4_hash__\"] = gen_enc_signature(uri, method, signed_nonce, params)\n\n for k, v in params.items():\n params[k] = encrypt_rc4(signed_nonce, v)\n\n params.update(\n {\n \"signature\": gen_enc_signature(uri, method, signed_nonce, params),\n \"ssecurity\": ssecurity,\n \"_nonce\": nonce,\n }\n )\n return params\n\n\ndef encrypt_rc4(password, payload):\n r = ARC4.new(base64.b64decode(password))\n r.encrypt(bytes(1024))\n return base64.b64encode(r.encrypt(payload.encode())).decode()\n\n\ndef decrypt_rc4(password, payload):\n r = ARC4.new(base64.b64decode(password))\n r.encrypt(bytes(1024))\n return r.encrypt(base64.b64decode(payload))\n\n\ndef decrypt(ssecurity, nonce, payload):\n decrypted = decrypt_rc4(get_signed_nonce(ssecurity, nonce), payload)\n try:\n return decrypted.decode(\"utf-8\")\n except UnicodeDecodeError:\n compressed_file = BytesIO(decrypted)\n return GzipFile(fileobj=compressed_file, mode=\"rb\").read().decode(\"utf-8\")\n\n\nclass MiJiaAPI:\n def __init__(self, auth_data_path: str | None = None):\n self.locale = locale.getlocale()[0] if locale.getlocale()[0] else \"zh_CN\"\n if \"_\" not in self.locale: # #57, make sure locale is in correct format\n self.locale = \"zh_CN\"\n self.api_base_url = \"https://api.mijia.tech/app\"\n self.login_url = \"https://account.xiaomi.com/longPolling/loginUrl\"\n self.service_login_url = f\"https://account.xiaomi.com/pass/serviceLogin?_json=true&sid=mijia&_locale={self.locale}\"\n\n if auth_data_path is None:\n self.auth_data_path = Path.home() / \".config\" / \"mijia-api\" / \"auth.json\"\n elif Path(auth_data_path).is_dir():\n self.auth_data_path = Path(auth_data_path) / \"auth.json\"\n else:\n self.auth_data_path = Path(auth_data_path)\n\n self._available_cache = None\n self._available_cache_time = 0\n\n if self.auth_data_path.exists():\n with open(self.auth_data_path) as f:\n self.auth_data = json.load(f)\n self._init_session()\n else:\n self.auth_data = {}\n\n def _init_session(self):\n self.session = requests.Session()\n self.session.headers.update(\n {\n \"User-Agent\": self.user_agent,\n \"accept-encoding\": \"identity\",\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n \"miot-accept-encoding\": \"GZIP\",\n \"miot-encrypt-algorithm\": \"ENCRYPT-RC4\",\n \"x-xiaomi-protocal-flag-cli\": \"PROTOCAL-HTTP2\",\n \"Cookie\": f\"cUserId={self.auth_data['cUserId']};\"\n f\"yetAnotherServiceToken={self.auth_data['serviceToken']};\"\n f\"serviceToken={self.auth_data['serviceToken']};\"\n f\"timezone_id={tzlocal.get_localzone_name()};\"\n f\"timezone=GMT{datetime.now().astimezone().strftime('%z')[:3]}:{datetime.now().astimezone().strftime('%z')[3:]};\"\n f\"is_daylight={time.daylight};\"\n f\"dst_offset={time.localtime().tm_isdst * 60 * 60 * 1000};\"\n f\"channel=MI_APP_STORE;\"\n f\"countryCode={self.locale.split('_')[1] if self.locale else 'CN'};\"\n f\"PassportDeviceId={self.device_id};\"\n f\"locale={self.locale}\",\n }\n )\n\n @property\n def available(self) -> bool:\n if not self.auth_data:\n return False\n if any(\n key not in self.auth_data\n for key in [\"ua\", \"ssecurity\", \"userId\", \"cUserId\", \"serviceToken\"]\n ):\n return False\n\n current_time = int(time.time())\n if current_time - self._available_cache_time < 60:\n print(f\"使用缓存的available结果: {self._available_cache}\")\n return self._available_cache\n\n try:\n self.check_new_msg(refresh_token=False)\n except Exception:\n self._available_cache = None\n self._available_cache_time = 0\n return False\n\n self._available_cache = True\n self._available_cache_time = current_time\n return True\n\n @property\n def pass_o(self) -> str:\n if \"pass_o\" in self.auth_data:\n return self.auth_data[\"pass_o\"]\n self.auth_data[\"pass_o\"] = \"\".join(random.choices(\"0123456789abcdef\", k=16))\n return self.auth_data[\"pass_o\"]\n\n @property\n def user_agent(self) -> str:\n if \"ua\" in self.auth_data:\n return self.auth_data[\"ua\"]\n ua_id1 = \"\".join(random.choices(\"0123456789ABCDEF\", k=40))\n ua_id2 = \"\".join(random.choices(\"0123456789ABCDEF\", k=32))\n ua_id3 = \"\".join(random.choices(\"0123456789ABCDEF\", k=32))\n ua_id4 = \"\".join(random.choices(\"0123456789ABCDEF\", k=40))\n self.auth_data[\"ua\"] = (\n f\"Android-15-11.0.701-Xiaomi-23046RP50C-OS2.0.212.0.VMYCNXM-\"\n f\"{ua_id1}-{self.locale.split('_')[1] if self.locale else 'CN'}-\"\n f\"{ua_id3}-{ua_id2}-SmartHome-MI_APP_STORE-{ua_id1}|{ua_id4}|{self.pass_o}-64\"\n )\n return self.auth_data[\"ua\"]\n\n @property\n def device_id(self) -> str:\n if \"deviceId\" in self.auth_data:\n return self.auth_data[\"deviceId\"]\n self.auth_data[\"deviceId\"] = \"\".join(\n random.choices(\n \"0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-\", k=16\n )\n )\n return self.auth_data[\"deviceId\"]\n\n def _parse_service_ret(self, service_ret: requests.Response) -> dict:\n text = service_ret.text.replace(\"&&&START&&&\", \"\")\n service_data = json.loads(text)\n return service_data\n\n def _handle_ret(\n self, fetch_ret: requests.Response, verify_code: bool = True\n ) -> dict:\n if fetch_ret.status_code != 200:\n raise ValueError(\n f\"请求失败，状态码: {fetch_ret.status_code}, 响应: {fetch_ret.text}\"\n )\n fetch_data = self._parse_service_ret(fetch_ret)\n if verify_code and fetch_data.get(\"code\", 0) != 0:\n raise ValueError(\n f\"验证码错误，状态码: {fetch_data['code']}, 响应: {fetch_data.get('desc', '未知错误')}\"\n )\n return fetch_data\n\n @staticmethod\n def _print_qr(loginurl: str, box_size: int = 10):\n print(f\"请使用米家APP扫描下方二维码: {loginurl}\")\n\n qr = QRCode(border=1, box_size=box_size)\n qr.add_data(loginurl)\n try:\n qr.print_ascii(invert=True, tty=True)\n except OSError:\n qr.print_ascii(invert=True, tty=False)\n print(\"如果无法扫描二维码，请更改终端字体，如`Maple Mono`、`Fira Code`等。\")\n\n def _save_auth_data(self):\n self.auth_data[\"saveTime\"] = int(time.time() * 1000)\n self.auth_data_path.parent.mkdir(parents=True, exist_ok=True)\n with open(self.auth_data_path, \"w\") as f:\n json.dump(self.auth_data, f, indent=2, ensure_ascii=False)\n os.chmod(self.auth_data_path, 0o600)\n print(f\"已保存认证数据到 {self.auth_data_path}\")\n\n def _get_location(self) -> dict:\n headers = {\n \"User-Agent\": self.user_agent,\n \"Connection\": \"keep-alive\",\n \"Accept-Encoding\": \"gzip\",\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n \"Cookie\": f\"deviceId={self.device_id};\"\n f\"pass_o={self.pass_o};\"\n f\"passToken={self.auth_data.get('passToken', '')};\"\n f\"userId={self.auth_data.get('userId', '')};\"\n f\"cUserId={self.auth_data.get('cUserId', '')};\"\n f\"uLocale={self.locale};\",\n }\n service_ret = requests.get(self.service_login_url, headers=headers)\n service_data = self._handle_ret(service_ret, verify_code=False)\n location = service_data[\"location\"]\n if service_data[\"code\"] == 0:\n ret = self.session.get(location)\n if ret.status_code == 200 and ret.text == \"ok\":\n cookies = self.session.cookies.get_dict()\n self.auth_data.update(cookies)\n self.auth_data[\"ssecurity\"] = service_data[\"ssecurity\"]\n return {\"code\": 0, \"message\": \"刷新Token成功\"}\n location_data = parse.parse_qs(parse.urlparse(location).query)\n return {k: v[0] for k, v in location_data.items()}\n\n def _refresh_token(self) -> dict:\n if self.available:\n print(\"Token 有效，无需刷新\")\n return self.auth_data\n location_data = self._get_location()\n if (\n location_data.get(\"code\", -1) == 0\n and location_data.get(\"message\", \"\") == \"刷新Token成功\"\n ):\n self._save_auth_data()\n self._init_session()\n print(\"刷新Token成功\")\n return self.auth_data\n else:\n raise ValueError(\"刷新Token失败，请重新登录\")\n\n def get_qrcode(self):\n # Step 1: 从 serviceLogin 获取登录链接参数\n location_data = self._get_location()\n if (\n location_data.get(\"code\", -1) == 0\n and location_data.get(\"message\", \"\") == \"刷新Token成功\"\n ):\n self._save_auth_data()\n self._init_session()\n print(\"刷新Token成功，无需登录\")\n return False\n\n # Step 2: 获取并打印二维码\n location_data.update(\n {\n \"theme\": \"\",\n \"bizDeviceType\": \"\",\n \"_hasLogo\": \"false\",\n \"_qrsize\": \"240\",\n \"_dc\": str(int(time.time() * 1000)),\n }\n )\n url = self.login_url + \"?\" + parse.urlencode(location_data)\n headers = {\n \"User-Agent\": self.user_agent,\n \"Accept-Encoding\": \"gzip\",\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n \"Connection\": \"keep-alive\",\n }\n login_ret = requests.get(url, headers=headers)\n return self._handle_ret(login_ret)\n\n def get_logint_status(self, status_url):\n # Step 3: 轮询等待扫码登录\n session = requests.Session()\n headers = {\n \"User-Agent\": self.user_agent,\n \"Accept-Encoding\": \"gzip\",\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n \"Connection\": \"keep-alive\",\n }\n try:\n lp_ret = session.get(status_url, headers=headers, timeout=120)\n lp_data = self._handle_ret(lp_ret)\n except requests.exceptions.Timeout as err:\n raise ValueError(\"超时，请重试\") from err\n\n # Step 4: 处理登录结果\n auth_keys = [\n \"psecurity\",\n \"nonce\",\n \"ssecurity\",\n \"passToken\",\n \"userId\",\n \"cUserId\",\n ]\n for key in auth_keys:\n self.auth_data[key] = lp_data[key]\n callback_url = lp_data[\"location\"]\n session.get(callback_url, headers=headers)\n cookies = session.cookies.get_dict()\n self.auth_data.update(cookies)\n self.auth_data.update(\n {\n \"expireTime\": int(\n (datetime.now() + timedelta(days=30)).timestamp() * 1000\n ),\n }\n )\n self._save_auth_data()\n print(\"登录成功\")\n self._init_session()\n\n def qr_login(self) -> dict:\n \"\"\"\n 二维码登录方法\n\n 通过米家账号二维码登录，使用米家APP扫描二维码完成身份验证。\n 如果Token有效，会直接返回并保存认证数据。\n\n 参数:\n 无\n\n 返回值:\n dict: 包含认证信息的字典，包括以下关键字段: [\"psecurity\", \"nonce\", \"ssecurity\", \"passToken\", \"userId\", \"cUserId\", \"serviceToken\", \"expireTime\", ...]\n\n 异常:\n LoginError: 当登录超时或服务器返回错误时抛出\n \"\"\"\n # Step 1: 从 serviceLogin 获取登录链接参数\n location_data = self._get_location()\n if (\n location_data.get(\"code\", -1) == 0\n and location_data.get(\"message\", \"\") == \"刷新Token成功\"\n ):\n self._save_auth_data()\n self._init_session()\n print(\"刷新Token成功，无需登录\")\n return self.auth_data\n\n # Step 2: 获取并打印二维码\n location_data.update(\n {\n \"theme\": \"\",\n \"bizDeviceType\": \"\",\n \"_hasLogo\": \"false\",\n \"_qrsize\": \"240\",\n \"_dc\": str(int(time.time() * 1000)),\n }\n )\n url = self.login_url + \"?\" + parse.urlencode(location_data)\n headers = {\n \"User-Agent\": self.user_agent,\n \"Accept-Encoding\": \"gzip\",\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n \"Connection\": \"keep-alive\",\n }\n login_ret = requests.get(url, headers=headers)\n login_data = self._handle_ret(login_ret)\n self._print_qr(login_data[\"loginUrl\"])\n print(f\"也可以访问链接查看二维码图片: {login_data['qr']}\")\n\n # Step 3: 轮询等待扫码登录\n session = requests.Session()\n try:\n lp_ret = session.get(login_data[\"lp\"], headers=headers, timeout=120)\n lp_data = self._handle_ret(lp_ret)\n except requests.exceptions.Timeout as err:\n raise ValueError(\"超时，请重试\") from err\n\n # Step 4: 处理登录结果\n auth_keys = [\n \"psecurity\",\n \"nonce\",\n \"ssecurity\",\n \"passToken\",\n \"userId\",\n \"cUserId\",\n ]\n for key in auth_keys:\n self.auth_data[key] = lp_data[key]\n callback_url = lp_data[\"location\"]\n session.get(callback_url, headers=headers)\n cookies = session.cookies.get_dict()\n self.auth_data.update(cookies)\n self.auth_data.update(\n {\n \"expireTime\": int(\n (datetime.now() + timedelta(days=30)).timestamp() * 1000\n ),\n }\n )\n self._save_auth_data()\n print(\"登录成功\")\n self._init_session()\n return self.auth_data\n\n def _request(self, uri: str, data: dict, refresh_token: bool = True) -> dict:\n if refresh_token:\n self._refresh_token()\n url = self.api_base_url + uri\n params = {\"data\": json.dumps(data, separators=(\",\", \":\"))}\n nonce = gen_nonce()\n signed_nonce = get_signed_nonce(self.auth_data[\"ssecurity\"], nonce)\n params = generate_enc_params(\n uri, \"POST\", signed_nonce, nonce, params, self.auth_data[\"ssecurity\"]\n )\n ret = self.session.post(url, data=params)\n try:\n ret_data = json.loads(ret.text)\n except json.JSONDecodeError:\n dec_data = decrypt(self.auth_data[\"ssecurity\"], nonce, ret.text)\n ret_data = json.loads(dec_data)\n if ret_data.get(\"code\", 0) != 0 or \"result\" not in ret_data:\n raise ValueError(\n f\"API错误，状态码: {ret_data['code']}, 响应: {ret_data.get('message', ret_data.get('desc', '未知错误'))}\"\n )\n return ret_data[\"result\"]\n\n def check_new_msg(\n self, begin_at: int = int(time.time()) - 3600, refresh_token: bool = True\n ) -> dict:\n uri = \"/v2/message/v2/check_new_msg\"\n data = {\"begin_at\": begin_at}\n return self._request(uri, data, refresh_token=refresh_token)\n\n\nif __name__ == \"__main__\":\n mi_jia_api = MiJiaAPI()\n mi_jia_api.qr_login()\n" }, { "path": "xiaomusic/static/default/debug.html", "content": "\n\n \n \n \n \n Debug For XiaoMusic\n\n \n \n \n\n \n \n \n\n \n \n\n \n \n \n

Debug For XiaoMusic

\n
\n
\n
\n
\n
\n
\n \n
\n
\n\n \n\n \n\n" }, { "path": "xiaomusic/static/default/downloadtool.html", "content": "\n\n\t\n\t\t\n \n\t\t歌曲下载工具\n \n \n\n \n \n \n\n \n \n\n\t\n\t\n\n\t\t

歌曲下载工具

\n\n\t\t
\n\t\t\t\n\t\t\t\n\t\t\t\n\n\t\t\t\n\t\t\t\n\n\t\t\t\n\n
\n\n\t\t
\n\n\t\t
\n\n\t\t\t\n\t\t\t\n\t\t\t\n\n\t\t\t\n\t\t\t\n\n\t\t\t\n\t\t
\n\n\n\t\t\n\n\t\n\n\n" }, { "path": "xiaomusic/static/default/index.html", "content": "\n\n\n\n \n \n 小爱音箱操控面板\n \n \n \n \n \n \n\n \n \n \n\n \n \n\n\n\n
\n

小爱音箱播放器\n 0.4.0\n

\n\n \n \n\n \n \n\n \n \n\n \n\n
\n \n
\n 0:00\n
当前播放歌曲：无
\n 00:00\n
\n
\n \n\n
\n
\n
\n shuffle\n 切换播放模式\n
\n
\n skip_previous\n 上一首\n
\n
\n play_circle_outline\n 播放\n
\n
\n skip_next\n 下一首\n
\n
\n stop\n 关机\n
\n\n
\n
\n
\n favorite\n

收藏

\n
\n
\n volume_up\n

音量

\n
\n
\n search\n

搜索

\n
\n
\n timer\n

定时

\n
\n
\n emoji_nature\n

测试

\n
\n
\n settings\n

设置

\n
\n
\n music_note\n

在线搜索

\n
\n
\n
\n
\n\n \n
\n\n \n
\n

搜索歌曲

\n \n \n
\n \n
\n \n \n
\n
\n\n \n
\n

定时关机

\n\n \n \n \n 已发送指令\n
\n \n
\n
\n\n \n \n\n\n \n
\n

调节音量

\n \n
\n \n
\n
\n \n
\n

警告

\n

你确定要删除歌曲 吗？

\n

注意：该操作会永久删除该歌曲且不可撤销

\n
\n \n \n
\n
\n \n
\n

警告

\n

当前页面的HOST与设置中的HOST不一致，请检查是否设置错误

\n

当前HOST:

\n

设置中的HOST:

\n
\n \n \n \n
\n
\n
\n Powered by XiaoMusic\n
\n\n \n
\n\n \n \n\n\n\n" }, { "path": "xiaomusic/static/default/m3u.html", "content": "\n\n \n \n \n \n M3U to JSON Converter\n \n\n \n \n \n\n \n \n\n \n \n \n \n

M3U to JSON Converter

\n
\n
\n
\n \n \n \n\n\n" }, { "path": "xiaomusic/static/default/main.css", "content": "/* ==================== CSS 变量系统 ==================== */\n:root {\n /* 主色调 - 与 setting.html 保持一致 */\n --primary-color: #007bff;\n --primary-hover: #0056b3;\n --primary-light: rgba(0, 123, 255, 0.1);\n\n /* 功能色 */\n --success-color: #28a745;\n --warning-color: #ffc107;\n --error-color: #dc3545;\n --info-color: #17a2b8;\n\n /* 中性色 */\n --text-primary: #333;\n --text-secondary: #555;\n --text-tertiary: #999;\n --text-inverse: #ffffff;\n\n /* 背景色 */\n --bg-primary: #ffffff;\n --bg-secondary: #f8f9fa;\n --bg-tertiary: #f0f0f0;\n --bg-overlay: rgba(0, 0, 0, 0.5);\n --bg-page: #f5f5f5;\n\n /* 边框色 */\n --border-color: #ddd;\n --border-hover: #ccc;\n\n /* 阴影 */\n --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.08);\n --shadow-md: 0 2px 8px rgba(0, 0, 0, 0.1);\n --shadow-lg: 0 4px 12px rgba(0, 0, 0, 0.12);\n --shadow-xl: 0 4px 20px rgba(0, 0, 0, 0.15);\n\n /* 间距系统 (4px 基准) */\n --spacing-xs: 4px;\n --spacing-sm: 8px;\n --spacing-md: 12px;\n --spacing-lg: 16px;\n --spacing-xl: 20px;\n --spacing-2xl: 24px;\n --spacing-3xl: 32px;\n --spacing-4xl: 40px;\n\n /* 圆角 */\n --radius-sm: 6px;\n --radius-md: 8px;\n --radius-lg: 12px;\n --radius-full: 9999px;\n\n /* 字体 */\n --font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif;\n --font-size-xs: 12px;\n --font-size-sm: 14px;\n --font-size-base: 16px;\n --font-size-lg: 18px;\n --font-size-xl: 20px;\n --font-size-2xl: 24px;\n --font-size-3xl: 28px;\n\n /* 过渡动画 */\n --transition-fast: 0.15s ease;\n --transition-base: 0.3s ease;\n --transition-slow: 0.5s ease;\n}\n\n/* ==================== 基础样式 ==================== */\n* {\n box-sizing: border-box;\n}\n\nhtml {\n height: 100%;\n overflow-x: hidden;\n}\n\nbody {\n font-family: var(--font-family);\n background-color: var(--bg-page);\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n min-height: 100vh;\n height: auto;\n margin: 0;\n padding: 20px 0;\n color: var(--text-primary);\n overflow-x: hidden;\n width: 100%;\n}\n\n.index_page {\n min-height: 100vh;\n height: auto;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: flex-start;\n width: 100%;\n overflow-x: hidden;\n padding-top: 20px;\n padding-bottom: 80px;\n}\n\n.player {\n background-color: var(--bg-primary);\n padding: var(--spacing-xl);\n border-radius: var(--radius-lg);\n box-shadow: var(--shadow-xl);\n text-align: center;\n max-width: 400px;\n width: calc(100% - 40px);\n margin: 20px;\n position: relative;\n transition: box-shadow var(--transition-base);\n box-sizing: border-box;\n}\n\n.player:hover {\n box-shadow: 0 6px 24px rgba(0, 0, 0, 0.18);\n}\n\nh1 {\n font-size: var(--font-size-3xl);\n margin-bottom: var(--spacing-xl);\n color: var(--text-primary);\n display: flex;\n justify-content: center;\n align-items: center;\n font-weight: 600;\n}\n\n.component h2 {\n font-size: var(--font-size-xl);\n color: var(--text-primary);\n margin: 0 0 var(--spacing-xl) 0;\n padding-bottom: var(--spacing-md);\n border-bottom: 2px solid var(--border-color);\n text-align: center;\n font-weight: 700;\n}\n\n.card-section {\n background: var(--bg-secondary);\n border-radius: var(--radius-md);\n padding: var(--spacing-lg);\n margin-bottom: var(--spacing-md);\n transition: all var(--transition-base);\n border: 2px solid transparent;\n}\n\n.card-section:last-of-type {\n margin-bottom: var(--spacing-sm);\n}\n\n.card-section:hover {\n background: var(--bg-tertiary);\n border-color: var(--border-hover);\n box-shadow: var(--shadow-sm);\n}\n\n.card-title {\n font-size: var(--font-size-base);\n font-weight: 600;\n color: var(--text-secondary);\n margin: 0 0 var(--spacing-md) 0;\n display: flex;\n align-items: center;\n gap: var(--spacing-sm);\n}\n\n.close-button {\n background: var(--text-secondary) !important;\n}\n\n.close-button:hover {\n background: var(--text-primary) !important;\n}\n\nh1 a {\n margin-left: var(--spacing-md);\n font-size: var(--font-size-sm);\n color: var(--primary-color);\n text-decoration: none;\n transition: color var(--transition-fast);\n}\n\nh1 a:hover {\n color: var(--primary-hover);\n text-decoration: underline;\n}\n\n.new-badge {\n position: absolute;\n top: -8px;\n right: -35px;\n background: var(--error-color);\n color: var(--text-inverse);\n border-radius: var(--radius-full);\n padding: 3px 8px;\n font-size: 11px;\n font-weight: bold;\n display: none;\n z-index: 10;\n box-shadow: var(--shadow-sm);\n animation: pulse 2s infinite;\n}\n\n@keyframes pulse {\n\n 0%,\n 100% {\n transform: scale(1);\n }\n\n 50% {\n transform: scale(1.05);\n }\n}\n\nlabel {\n font-size: var(--font-size-sm);\n color: var(--text-secondary);\n margin: var(--spacing-sm) 0;\n display: block;\n text-align: left;\n font-weight: 500;\n}\n\nselect,\ninput[type=\"range\"],\ninput[type=\"text\"],\ninput[type=\"password\"],\ninput[type=\"number\"] {\n width: 100%;\n padding: var(--spacing-md) var(--spacing-lg);\n border: 2px solid var(--border-color);\n border-radius: var(--radius-md);\n margin-bottom: var(--spacing-md);\n font-size: var(--font-size-sm);\n transition: all var(--transition-base);\n box-sizing: border-box;\n background: var(--bg-secondary);\n color: var(--text-primary);\n font-family: var(--font-family);\n max-width: 100%;\n}\n\nselect:hover,\ninput[type=\"text\"]:hover,\ninput[type=\"password\"]:hover,\ninput[type=\"number\"]:hover {\n border-color: var(--border-hover);\n}\n\nselect:focus,\ninput[type=\"text\"]:focus,\ninput[type=\"password\"]:focus,\ninput[type=\"number\"]:focus {\n border-color: var(--primary-color);\n outline: none;\n background: var(--bg-primary);\n box-shadow: 0 0 0 3px var(--primary-light);\n}\n\nselect {\n overflow: hidden;\n}\n\nbutton {\n background-color: var(--primary-color);\n color: var(--text-inverse);\n border: none;\n border-radius: var(--radius-sm);\n padding: 10px 20px;\n cursor: pointer;\n margin: var(--spacing-sm);\n font-size: var(--font-size-sm);\n font-weight: 500;\n transition: background-color var(--transition-base);\n position: relative;\n font-family: var(--font-family);\n}\n\nbutton:hover {\n background-color: var(--primary-hover);\n}\n\nbutton:active {\n transform: translateY(1px);\n}\n\n.tooltip {\n visibility: hidden;\n background: var(--text-primary);\n color: var(--text-inverse);\n text-align: center;\n border-radius: var(--radius-sm);\n padding: var(--spacing-xs) var(--spacing-sm);\n position: absolute;\n z-index: 10;\n bottom: 150%;\n left: 50%;\n margin-left: -50px;\n width: 80px;\n white-space: nowrap;\n opacity: 0;\n transition: opacity var(--transition-base);\n font-size: var(--font-size-xs);\n box-shadow: var(--shadow-md);\n pointer-events: none;\n}\n\n.tooltip::after {\n content: '';\n position: absolute;\n top: 100%;\n left: 50%;\n margin-left: -4px;\n border-width: 4px;\n border-style: solid;\n border-color: var(--text-primary) transparent transparent transparent;\n}\n\nbutton:hover .tooltip,\n.option-inline:hover .tooltip,\n.control-button:hover .tooltip {\n visibility: visible;\n opacity: 1;\n}\n\n.option-inline {\n display: flex;\n margin-left: auto;\n position: relative;\n align-items: center;\n padding: var(--spacing-xs);\n border-radius: var(--radius-md);\n cursor: pointer;\n transition: all var(--transition-fast);\n}\n\n.option-inline:hover {\n background: var(--primary-light);\n}\n\n.option-inline .material-icons {\n color: var(--text-secondary);\n transition: color var(--transition-fast);\n font-size: 20px;\n}\n\n.option-inline:hover .material-icons {\n color: var(--primary-color);\n}\n\n.option-inline:hover .tooltip {\n left: -50px;\n bottom: 0;\n}\n\n.progress {\n width: 100%;\n height: 8px;\n background: var(--bg-tertiary);\n border-radius: var(--radius-full);\n margin: var(--spacing-xl) 0;\n cursor: pointer;\n overflow: hidden;\n position: relative;\n transition: height var(--transition-fast);\n}\n\n.progress:hover {\n height: 10px;\n}\n\nprogress::-webkit-progress-bar {\n background: var(--bg-tertiary);\n border-radius: var(--radius-full);\n}\n\nprogress::-moz-progress-bar {\n background-color: var(--primary-color);\n border-radius: var(--radius-full);\n transition: all var(--transition-base);\n}\n\nprogress::-webkit-progress-value {\n background-color: var(--primary-color);\n border-radius: var(--radius-full);\n transition: all var(--transition-base);\n}\n\n.current-song {\n color: var(--text-primary);\n margin: var(--spacing-md) 0;\n font-weight: 600;\n text-align: center;\n font-size: var(--font-size-sm);\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n}\n\n.current-time,\n.duration {\n font-size: var(--font-size-xs);\n color: var(--text-tertiary);\n font-weight: 500;\n}\n\n.component {\n display: none;\n position: fixed;\n top: 50%;\n left: 50%;\n transform: translate(-50%, -50%) scale(0.9);\n background: var(--bg-primary);\n padding: var(--spacing-2xl);\n border-radius: var(--radius-lg);\n box-shadow: var(--shadow-xl);\n z-index: 1000;\n width: 360px;\n max-width: calc(100vw - 40px);\n max-height: 85vh;\n overflow-y: auto;\n overflow-x: hidden;\n opacity: 0;\n transition: all var(--transition-base);\n border: 1px solid var(--border-color);\n box-sizing: border-box;\n margin: 0 auto;\n}\n\n.component.show {\n opacity: 1;\n transform: translate(-50%, -50%) scale(1);\n}\n\n/* 确保弹窗在所有情况下都水平居中 */\n.component {\n right: auto;\n}\n\n/* 弹窗遮罩 */\n.component-overlay {\n display: none;\n position: fixed;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background: var(--bg-overlay);\n z-index: 999;\n opacity: 0;\n transition: opacity var(--transition-base);\n}\n\n.component-overlay.show {\n opacity: 1;\n}\n\n/* 美化滚动条 */\n.component::-webkit-scrollbar {\n width: 6px;\n}\n\n.component::-webkit-scrollbar-track {\n background: #f1f1f1;\n border-radius: 10px;\n}\n\n.component::-webkit-scrollbar-thumb {\n background: #c1c1c1;\n border-radius: 10px;\n}\n\n.component::-webkit-scrollbar-thumb:hover {\n background: #a8a8a8;\n}\n\n.component input {\n width: 100%;\n max-width: 100%;\n height: 42px;\n box-sizing: border-box;\n transition: all var(--transition-base);\n font-size: var(--font-size-sm);\n}\n\n.component input:focus {\n border-color: var(--primary-color);\n box-shadow: 0 0 0 3px var(--primary-light);\n}\n\n.component input::placeholder {\n color: var(--text-tertiary);\n}\n\n.component-button-group {\n display: flex;\n gap: var(--spacing-sm);\n justify-content: space-between;\n margin-top: var(--spacing-lg);\n}\n\n.component-button-group button {\n flex: 1;\n height: 42px;\n font-size: var(--font-size-sm);\n padding: var(--spacing-sm) var(--spacing-md);\n margin: 0;\n transition: all var(--transition-base);\n}\n\n.component-button-group button:hover {\n transform: translateY(-2px);\n box-shadow: var(--shadow-md);\n}\n\n.component-button-one {\n display: flex;\n justify-content: center;\n margin-top: var(--spacing-lg);\n padding-top: var(--spacing-md);\n border-top: 1px solid var(--border-color);\n}\n\n.component-button-one button {\n width: 100%;\n height: 42px;\n font-size: var(--font-size-sm);\n margin: 0;\n}\n\n#warning-component p span {\n color: var(--primary-color);\n font-weight: 600;\n}\n\n.warning-text {\n font-weight: bold;\n word-wrap: break-word;\n overflow-wrap: break-word;\n}\n\n\n.button-group {\n display: flex;\n\n margin: 5px 0;\n}\n\n.player-controls {\n display: flex;\n justify-content: center;\n align-items: center;\n gap: var(--spacing-lg);\n margin-top: var(--spacing-2xl);\n margin-bottom: var(--spacing-2xl);\n padding: var(--spacing-lg) 0;\n}\n\n.control-button {\n display: flex;\n align-items: center;\n justify-content: center;\n width: 48px;\n height: 48px;\n border-radius: var(--radius-full);\n background: var(--bg-secondary);\n cursor: pointer;\n transition: all var(--transition-base);\n border: 2px solid transparent;\n}\n\n.control-button:hover {\n background: var(--primary-light);\n border-color: var(--primary-color);\n transform: scale(1.05);\n}\n\n.control-button:active {\n transform: scale(0.95);\n}\n\n.control-button .material-icons,\n.control-button .material-icons-outlined {\n color: var(--text-primary);\n transition: color var(--transition-fast);\n}\n\n.control-button:hover .material-icons,\n.control-button:hover .material-icons-outlined {\n color: var(--primary-color);\n}\n\n.play {\n font-size: 56px !important;\n}\n\n.control-button:has(.play) {\n width: 64px;\n height: 64px;\n background-color: var(--primary-color);\n box-shadow: var(--shadow-md);\n}\n\n.control-button:has(.play):hover {\n background-color: var(--primary-hover);\n box-shadow: var(--shadow-lg);\n transform: scale(1.08);\n}\n\n.control-button:has(.play) .material-icons-outlined {\n color: var(--text-inverse) !important;\n}\n\n.footer {\n position: fixed;\n bottom: var(--spacing-lg);\n left: 50%;\n transform: translateX(-50%);\n font-size: var(--font-size-sm);\n color: var(--text-tertiary);\n user-select: none;\n font-weight: 500;\n z-index: 10;\n background-color: var(--bg-page);\n padding: var(--spacing-xs) var(--spacing-lg);\n border-radius: var(--radius-sm);\n}\n\n\n\n\n\n\n}\n\n.timer-tooltip {\n bottom: 50%;\n}\n\n.timer-tooltip.show {\n visibility: visible !important;\n opacity: 1 !important;\n display: inline-block !important;\n}\n\n.favorite.favorite-active {\n background: rgba(255, 99, 71, 0.1);\n border-color: #ff6347;\n}\n\n.favorite.favorite-active .material-icons {\n color: #ff6347;\n}\n\n.favorite.favorite-active p {\n color: #ff6347;\n}\n\n/* Audio 元素已通过 .hidden-audio 类隐藏 */\n\n/* 无障碍样式 - 屏幕阅读器专用类 */\n.sr-only {\n position: absolute;\n width: 1px;\n height: 1px;\n padding: 0;\n margin: -1px;\n overflow: hidden;\n clip: rect(0, 0, 0, 0);\n white-space: nowrap;\n border-width: 0;\n}\n\n.sr-only-focusable:focus {\n position: static;\n width: auto;\n height: auto;\n overflow: visible;\n clip: auto;\n white-space: normal;\n}\n\n/* ==================== 无障碍样式增强 ==================== */\n*:focus {\n outline: 2px solid var(--primary-color);\n outline-offset: 2px;\n}\n\nbutton:focus,\nselect:focus,\ninput:focus,\n.control-button:focus,\n.icon-item:focus,\n.option-inline:focus,\n.toggle-switch:focus {\n box-shadow: 0 0 0 3px var(--primary-light);\n}\n\n[role=\"button\"]:focus,\n[role=\"switch\"]:focus {\n outline: 2px solid var(--primary-color);\n outline-offset: 2px;\n box-shadow: 0 0 0 3px var(--primary-light);\n}\n\n.debug {\n display: flex;\n flex-direction: column;\n align-items: center;\n\n}\n\n/* ==================== 响应式设计 ==================== */\n@media screen and (max-width: 640px) {\n\n html,\n body {\n height: auto;\n min-height: 100vh;\n }\n\n body {\n padding: 10px 0;\n justify-content: flex-start;\n }\n\n .index_page {\n justify-content: flex-start;\n padding-top: 10px;\n padding-bottom: 60px;\n }\n\n .player {\n width: calc(100% - 20px);\n max-width: 100%;\n padding: var(--spacing-lg);\n margin: 10px auto;\n border-radius: var(--radius-md);\n }\n\n h1 {\n font-size: var(--font-size-xl);\n flex-wrap: wrap;\n margin-bottom: var(--spacing-md);\n }\n\n label {\n font-size: var(--font-size-sm);\n margin: var(--spacing-xs) 0;\n }\n\n select,\n input[type=\"text\"],\n input[type=\"password\"],\n input[type=\"number\"] {\n padding: var(--spacing-sm) var(--spacing-md);\n margin-bottom: var(--spacing-sm);\n font-size: var(--font-size-sm);\n }\n\n .audio-section {\n margin: var(--spacing-md) 0;\n }\n\n .control-button {\n width: 42px;\n height: 42px;\n }\n\n .control-button:has(.play) {\n width: 54px;\n height: 54px;\n }\n\n .play {\n font-size: 46px !important;\n }\n\n .player-controls {\n gap: var(--spacing-sm);\n margin-top: var(--spacing-lg);\n margin-bottom: var(--spacing-lg);\n padding: var(--spacing-sm) 0;\n }\n\n .mode-controls {\n grid-template-columns: repeat(3, 1fr);\n gap: var(--spacing-sm);\n padding: var(--spacing-md) 0 var(--spacing-sm);\n margin-top: var(--spacing-sm);\n }\n\n .icon-item {\n padding: var(--spacing-sm);\n min-height: 60px;\n }\n\n .icon-item .material-icons {\n font-size: 22px;\n }\n\n .icon-item p {\n font-size: 11px;\n margin-top: 2px;\n }\n\n .component {\n width: calc(100% - 20px);\n max-width: calc(100vw - 20px);\n padding: var(--spacing-lg);\n margin: 0;\n left: 50%;\n right: auto;\n }\n\n .footer {\n font-size: var(--font-size-xs);\n bottom: var(--spacing-sm);\n padding: 2px var(--spacing-md);\n }\n}\n\n@media screen and (min-width: 641px) and (max-width: 1024px) {\n .player {\n max-width: 480px;\n }\n}\n\n@media screen and (min-width: 1025px) {\n .player {\n max-width: 420px;\n }\n}\n\n.mini-button {\n padding: 0px 0px;\n margin: 0px;\n font-size: 14px;\n margin-left: auto;\n}\n\n.playlist-selector,\n.device-selector,\n.song-selector {\n width: 100%;\n}\n\n.mode-controls {\n display: grid;\n grid-template-columns: repeat(3, 1fr);\n gap: var(--spacing-md);\n padding: var(--spacing-xl) 0 var(--spacing-md);\n border-top: 1px solid var(--border-color);\n margin-top: var(--spacing-lg);\n}\n\n.icon-item {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n padding: var(--spacing-md);\n border-radius: var(--radius-md);\n background: var(--bg-secondary);\n cursor: pointer;\n transition: all var(--transition-base);\n border: 2px solid transparent;\n min-height: 72px;\n}\n\n.icon-item:hover {\n background: var(--primary-light);\n border-color: var(--primary-color);\n transform: translateY(-2px);\n box-shadow: var(--shadow-sm);\n}\n\n.icon-item:active {\n transform: translateY(0);\n}\n\n.icon-item .material-icons {\n color: var(--text-secondary);\n transition: color var(--transition-fast);\n font-size: 28px;\n}\n\n.icon-item:hover .material-icons {\n color: var(--primary-color);\n}\n\n.icon-item p {\n font-size: var(--font-size-xs);\n margin: var(--spacing-xs) 0 0;\n color: var(--text-secondary);\n font-weight: 500;\n transition: color var(--transition-fast);\n}\n\n.icon-item:hover p {\n color: var(--primary-color);\n}\n\n.disabled {\n color: var(--text-tertiary);\n pointer-events: none;\n opacity: 0.5;\n}\n\n.device-enable {\n /* 设备可用时的样式 */\n}\n\nspan,\np {\n cursor: pointer;\n user-select: none;\n}\n\n.changelog-button {\n padding: 0px 0px;\n margin: 0px;\n font-size: 14px;\n margin-left: auto;\n text-decoration: none;\n}\n\n.setting-label {\n display: flex;\n align-items: center;\n}\n\n/* fallback */\n@font-face {\n font-family: 'Material Icons';\n font-style: normal;\n font-weight: 400;\n font-display: block;\n src: url(./materialicons.woff2) format('woff2');\n}\n\n/* fallback */\n@font-face {\n font-family: 'Material Icons Outlined';\n font-style: normal;\n font-weight: 400;\n font-display: block;\n src: url(./materialiconsoutlined.woff2) format('woff2');\n}\n\n.material-icons {\n font-family: 'Material Icons';\n font-weight: normal;\n font-style: normal;\n font-size: 24px;\n line-height: 1;\n letter-spacing: normal;\n text-transform: none;\n display: inline-block;\n white-space: nowrap;\n word-wrap: normal;\n direction: ltr;\n -webkit-font-feature-settings: 'liga';\n -webkit-font-smoothing: antialiased;\n visibility: hidden;\n}\n\n.material-icons-outlined {\n font-family: 'Material Icons Outlined';\n font-weight: normal;\n font-style: normal;\n font-size: 24px;\n line-height: 1;\n letter-spacing: normal;\n text-transform: none;\n display: inline-block;\n white-space: nowrap;\n word-wrap: normal;\n direction: ltr;\n -webkit-font-feature-settings: 'liga';\n -webkit-font-smoothing: antialiased;\n visibility: hidden;\n}\n\n/* 字体加载完成后显示图标 */\n.fonts-loaded .material-icons,\n.fonts-loaded .material-icons-outlined {\n visibility: visible;\n}\n\n\n/* 胶囊开关容器 */\n/* ==================== Label 布局样式 ==================== */\n.label-with-toggle,\n.label-with-action {\n display: flex;\n align-items: center;\n}\n\n.action-buttons {\n display: flex;\n align-items: center;\n margin-left: auto;\n gap: var(--spacing-xs);\n}\n\n.toggle-switch-container {\n display: flex;\n align-items: center;\n margin-left: auto;\n gap: var(--spacing-sm);\n}\n\n.toggle-label {\n font-size: var(--font-size-sm);\n color: var(--text-secondary);\n margin: 0;\n font-weight: 500;\n}\n\n/* ==================== 音频播放区域 ==================== */\n.audio-section {\n margin: var(--spacing-xl) 0;\n}\n\n.time-info {\n display: flex;\n justify-content: space-between;\n align-items: center;\n width: 100%;\n margin-top: var(--spacing-sm);\n}\n\n/* ==================== 隐藏元素 ==================== */\n.hidden-input,\n.hidden-audio,\n.hidden-element {\n display: none !important;\n}\n\n.version-link {\n position: relative;\n}\n\n/* 胶囊开关样式 */\n.toggle-switch {\n position: relative;\n width: 48px;\n height: 26px;\n background-color: var(--bg-tertiary);\n border-radius: var(--radius-full);\n cursor: pointer;\n transition: all var(--transition-base);\n border: 2px solid var(--border-color);\n}\n\n.toggle-switch:hover {\n border-color: var(--border-hover);\n}\n\n.toggle-switch.active {\n background-color: var(--primary-color);\n border-color: var(--primary-color);\n}\n\n.toggle-slider {\n position: absolute;\n top: 2px;\n left: 2px;\n width: 18px;\n height: 18px;\n background: var(--bg-primary);\n border-radius: 50%;\n transition: transform var(--transition-base);\n box-shadow: var(--shadow-sm);\n}\n\n.toggle-switch.active .toggle-slider {\n transform: translateX(22px);\n}\n\n/* 搜索结果样式 */\n.search-results {\n max-height: 300px;\n overflow-y: auto;\n border: 2px solid var(--border-color);\n border-radius: var(--radius-md);\n background: var(--bg-secondary);\n margin-bottom: var(--spacing-md);\n}\n\n.search-result-item {\n padding: var(--spacing-md);\n cursor: pointer;\n transition: all var(--transition-fast);\n border-bottom: 1px solid var(--border-color);\n}\n\n.search-result-item:last-child {\n border-bottom: none;\n}\n\n.search-result-item:hover {\n background: var(--primary-light);\n}\n\n.search-result-item.selected {\n background: var(--primary-color);\n color: var(--text-inverse);\n}\n\n.search-result-item.keyword-option {\n font-weight: 600;\n color: var(--primary-color);\n}\n\n.search-result-item.keyword-option.selected {\n color: var(--text-inverse);\n}\n\n.search-result-empty {\n padding: var(--spacing-xl);\n text-align: center;\n color: var(--text-tertiary);\n font-size: var(--font-size-sm);\n}" }, { "path": "xiaomusic/static/default/md.js", "content": "// ============ 字体加载检测 ============\n// 检测字体加载完成，避免图标文字闪烁\n(function () {\n // 使用 Promise.race 实现超时保护\n const fontLoadTimeout = new Promise((resolve) => {\n setTimeout(() => {\n console.warn(\"字体加载超时，强制显示图标\");\n resolve(\"timeout\");\n }, 3000);\n });\n\n const fontLoadReady = document.fonts.ready.then(() => \"loaded\");\n\n Promise.race([fontLoadReady, fontLoadTimeout])\n .then((result) => {\n document.body.classList.add(\"fonts-loaded\");\n if (result === \"loaded\") {\n console.log(\"Material Icons 字体加载完成\");\n }\n })\n .catch((error) => {\n console.error(\"字体加载检测失败:\", error);\n // 出错时也显示图标，避免永久隐藏\n document.body.classList.add(\"fonts-loaded\");\n });\n})();\n\n// $(function () {\n\n// })\n\n// ============ 无障碍辅助函数 ============\n\n// 屏幕阅读器状态通知函数\nfunction announceToScreenReader(message) {\n const announcer = document.getElementById(\"sr-announcer\");\n if (announcer) {\n announcer.textContent = \"\";\n setTimeout(() => {\n announcer.textContent = message;\n }, 100);\n }\n}\n\n// 批量填充 select 选项（优化读屏性能）\nfunction fillSelectOptions(\n selectElement,\n options,\n selectedValue,\n announceMessage,\n) {\n const $select = $(selectElement);\n\n // 设置忙碌状态，告知读屏软件正在加载\n $select.attr(\"aria-busy\", \"true\");\n\n // 构建所有 option 的 HTML 字符串\n const optionsHtml = options\n .map((opt) => {\n const isSelected = opt.value === selectedValue;\n const selectedAttr = isSelected ? \" selected\" : \"\";\n // 转义 HTML 特殊字符\n const escapedText = $(\"
\").text(opt.text).html();\n const escapedValue = $(\"
\").text(opt.value).html();\n return ``;\n })\n .join(\"\");\n\n // 一次性设置所有选项\n $select.html(optionsHtml);\n\n // 恢复状态\n $select.attr(\"aria-busy\", \"false\");\n\n // 通知读屏软件加载完成\n if (announceMessage) {\n announceToScreenReader(announceMessage);\n }\n}\n\n// 弹窗焦点管理\nlet lastFocusedElement = null;\nconst openDialogs = new Set();\n\nfunction openDialog(dialogId) {\n const dialog = document.getElementById(dialogId);\n if (!dialog) return;\n\n // 保存当前焦点元素\n lastFocusedElement = document.activeElement;\n\n // 显示遮罩层\n const overlay = document.getElementById(\"component-overlay\");\n if (overlay) {\n overlay.style.display = \"block\";\n setTimeout(() => overlay.classList.add(\"show\"), 10);\n }\n\n // 显示弹窗\n dialog.style.display = \"block\";\n setTimeout(() => dialog.classList.add(\"show\"), 10);\n openDialogs.add(dialogId);\n\n // 将焦点移到弹窗内第一个可交互元素\n setTimeout(() => {\n const firstFocusable = dialog.querySelectorAll(\n 'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])',\n )[0];\n if (firstFocusable) {\n firstFocusable.focus();\n }\n }, 100);\n}\n\nfunction closeDialog(dialogId) {\n const dialog = document.getElementById(dialogId);\n if (!dialog) return;\n\n // 隐藏弹窗动画\n dialog.classList.remove(\"show\");\n openDialogs.delete(dialogId);\n\n // 如果没有其他打开的弹窗，隐藏遮罩层\n if (openDialogs.size === 0) {\n const overlay = document.getElementById(\"component-overlay\");\n if (overlay) {\n overlay.classList.remove(\"show\");\n setTimeout(() => (overlay.style.display = \"none\"), 300);\n }\n }\n\n // 延迟隐藏弹窗以显示动画\n setTimeout(() => {\n dialog.style.display = \"none\";\n }, 300);\n\n // 恢复焦点到触发按钮\n if (lastFocusedElement) {\n lastFocusedElement.focus();\n lastFocusedElement = null;\n }\n}\n\n// 关闭所有弹窗\nfunction closeAllDialogs() {\n const dialogs = Array.from(openDialogs);\n dialogs.forEach((dialogId) => closeDialog(dialogId));\n}\n\n// 更新进度条 ARIA 属性\nfunction updateProgressAria(currentTime, totalTime) {\n const progress = document.getElementById(\"progress\");\n if (progress) {\n const percentage =\n totalTime > 0 ? Math.round((currentTime / totalTime) * 100) : 0;\n progress.setAttribute(\"aria-valuenow\", percentage);\n\n const currentMin = Math.floor(currentTime / 60);\n const currentSec = Math.floor(currentTime % 60);\n const totalMin = Math.floor(totalTime / 60);\n const totalSec = Math.floor(totalTime % 60);\n progress.setAttribute(\n \"aria-valuetext\",\n `已播放 ${currentMin} 分 ${currentSec} 秒，共 ${totalMin} 分 ${totalSec} 秒`,\n );\n }\n}\n\n// 更新音量滑块 ARIA 属性\nfunction updateVolumeAria(volume) {\n const volumeSlider = document.getElementById(\"volume\");\n if (volumeSlider) {\n volumeSlider.setAttribute(\"aria-valuenow\", volume);\n }\n}\n\n// 更新收藏按钮 ARIA 属性\nfunction updateFavoriteAria(isFavorited) {\n const favoriteBtn = document.querySelector(\".favorite\");\n if (favoriteBtn) {\n favoriteBtn.setAttribute(\n \"aria-label\",\n isFavorited ? \"取消收藏\" : \"收藏歌曲\",\n );\n }\n}\n\n// 更新语音口令开关 ARIA 属性\nfunction updatePullAskAria(isEnabled) {\n const toggle = document.getElementById(\"pullAskToggle\");\n if (toggle) {\n toggle.setAttribute(\"aria-checked\", isEnabled ? \"true\" : \"false\");\n }\n}\n\n// ============ 原有代码 ============\n\nlet isPlaying = false;\nlet playModeIndex = 2;\n//重新设计playModes\nconst playModes = {\n 0: {\n icon: \"repeat_one\",\n cmd: \"单曲循环\",\n },\n 1: {\n icon: \"repeat\",\n cmd: \"全部循环\",\n },\n 2: {\n icon: \"shuffle\",\n cmd: \"随机播放\",\n },\n 3: {\n icon: \"filter_1\",\n cmd: \"单曲播放\",\n },\n 4: {\n icon: \"playlist_play\",\n cmd: \"顺序播放\",\n },\n};\n\nlet favoritelist = []; //收藏列表\n\n// ============ 本机播放器状态管理 ============\n\n// 本机播放器状态管理对象\nconst WebPlayer = {\n // 获取当前播放列表名称\n getPlaylist: function () {\n return localStorage.getItem(\"web_playlist\") || \"全部\";\n },\n\n // 设置当前播放列表\n setPlaylist: function (playlist) {\n localStorage.setItem(\"web_playlist\", playlist);\n },\n\n // 获取当前播放歌曲\n getCurrentMusic: function () {\n return localStorage.getItem(\"web_current_music\") || \"\";\n },\n\n // 设置当前播放歌曲\n setCurrentMusic: function (music) {\n localStorage.setItem(\"web_current_music\", music);\n },\n\n // 获取播放模式\n getPlayMode: function () {\n const mode = localStorage.getItem(\"web_play_mode\");\n return mode !== null ? parseInt(mode) : 2; // 默认随机播放\n },\n\n // 设置播放模式\n setPlayMode: function (mode) {\n localStorage.setItem(\"web_play_mode\", mode.toString());\n },\n\n // 获取播放列表数组\n getPlayList: function () {\n const list = localStorage.getItem(\"web_play_list\");\n return list ? JSON.parse(list) : [];\n },\n\n // 设置播放列表数组\n setPlayList: function (list) {\n localStorage.setItem(\"web_play_list\", JSON.stringify(list));\n },\n\n // 获取当前播放索引\n getCurrentIndex: function () {\n const index = localStorage.getItem(\"web_current_index\");\n return index !== null ? parseInt(index) : -1;\n },\n\n // 设置当前播放索引\n setCurrentIndex: function (index) {\n localStorage.setItem(\"web_current_index\", index.toString());\n },\n\n // 获取音量\n getVolume: function () {\n const volume = localStorage.getItem(\"web_volume\");\n return volume !== null ? parseInt(volume) : 50;\n },\n\n // 设置音量\n setVolume: function (volume) {\n localStorage.setItem(\"web_volume\", volume.toString());\n },\n\n // 检查是否已收藏（直接使用全局 favoritelist，数据来源于服务器）\n isFavorited: function (music) {\n return favoritelist.includes(music);\n },\n};\n\n// 本机播放：加载并播放指定歌曲\nfunction loadAndPlayMusic(musicName) {\n console.log(\"loadAndPlayMusic:\", musicName);\n\n $.get(`/musicinfo?name=${musicName}`, function (data, status) {\n console.log(data);\n if (data.ret == \"OK\") {\n const audioElement = document.getElementById(\"audio\");\n\n // 设置音频源\n audioElement.src = data.url;\n\n // 播放音频\n audioElement\n .play()\n .then(() => {\n console.log(\"播放成功:\", musicName);\n\n // 更新本机播放状态\n WebPlayer.setCurrentMusic(musicName);\n\n // 更新播放列表和索引\n const playlist = $(\"#music_list\").val();\n WebPlayer.setPlaylist(playlist);\n\n const playList = WebPlayer.getPlayList();\n const index = playList.indexOf(musicName);\n if (index !== -1) {\n WebPlayer.setCurrentIndex(index);\n }\n\n // 更新 UI\n updateWebPlayingUI();\n\n // 更新收藏按钮状态\n updateWebFavoriteButton();\n })\n .catch((error) => {\n console.error(\"播放失败:\", error);\n alert(\"播放失败: \" + error.message);\n });\n }\n });\n}\n\nfunction webPlay() {\n console.log(\"webPlay\");\n const music_name = $(\"#music_name\").val();\n\n if (!music_name) {\n alert(\"请选择要播放的歌曲\");\n return;\n }\n\n // 获取当前播放列表\n const playlist = $(\"#music_list\").val();\n const playlistData = $(\"#music_name option\")\n .map(function () {\n return $(this).val();\n })\n .get();\n\n // 保存播放列表到 localStorage\n WebPlayer.setPlayList(playlistData);\n WebPlayer.setPlaylist(playlist);\n\n // 加载并播放歌曲\n loadAndPlayMusic(music_name);\n}\n\nfunction play() {\n var did = $(\"#did\").val();\n if (did == \"web_device\") {\n webPlay();\n } else {\n playOnDevice();\n }\n}\n\nfunction playOnDevice() {\n console.log(\"playOnDevice\");\n var music_list = $(\"#music_list\").val();\n var music_name = $(\"#music_name\").val();\n if (no_warning) {\n do_play_music_list(music_list, music_name);\n return;\n }\n $.get(`/musicinfo?name=${music_name}`, function (data, status) {\n console.log(data);\n if (data.ret == \"OK\") {\n console.log(\n \"%cmd.js:42 validHost(data.url) \",\n \"color: #007acc;\",\n validHost(data.url),\n );\n validHost(data.url) && do_play_music_list(music_list, music_name);\n }\n });\n}\nfunction stopPlay() {\n var did = $(\"#did\").val();\n\n if (did == \"web_device\") {\n // 本机播放：停止播放\n const audioElement = document.getElementById(\"audio\");\n audioElement.pause();\n audioElement.currentTime = 0;\n\n // 更新 UI\n updateWebPlayingUI();\n\n console.log(\"本机停止播放\");\n } else {\n // 设备播放：调用后端接口\n $.ajax({\n type: \"POST\",\n url: \"/device/stop\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({\n did: did,\n }),\n success: () => {\n console.log(\"stop play succ\");\n },\n error: () => {\n console.log(\"stop play failed\");\n },\n });\n }\n}\n\nfunction prevTrack() {\n var did = $(\"#did\").val();\n\n if (did == \"web_device\") {\n // 本机播放：播放上一首\n webPlayPrevious();\n } else {\n // 设备播放：发送命令\n sendcmd(\"上一首\");\n }\n}\n\nfunction nextTrack() {\n var did = $(\"#did\").val();\n\n if (did == \"web_device\") {\n // 本机播放：播放下一首\n webPlayNext();\n } else {\n // 设备播放：发送命令\n sendcmd(\"下一首\");\n }\n}\n\n// 本机播放：播放上一首\nfunction webPlayPrevious() {\n const playList = WebPlayer.getPlayList();\n const currentIndex = WebPlayer.getCurrentIndex();\n\n if (playList.length === 0) {\n alert(\"播放列表为空\");\n return;\n }\n\n let prevIndex;\n const playMode = WebPlayer.getPlayMode();\n\n if (playMode === 2) {\n // 随机播放：随机选择一首（不包括当前）\n const availableIndices = playList\n .map((_, i) => i)\n .filter((i) => i !== currentIndex);\n if (availableIndices.length > 0) {\n prevIndex =\n availableIndices[Math.floor(Math.random() * availableIndices.length)];\n } else {\n prevIndex = 0;\n }\n } else {\n // 其他模式：播放前一首\n prevIndex = currentIndex - 1;\n if (prevIndex < 0) {\n prevIndex = playList.length - 1;\n }\n }\n\n const prevMusic = playList[prevIndex];\n if (prevMusic) {\n loadAndPlayMusic(prevMusic);\n }\n}\n\n// 本机播放：播放下一首\nfunction webPlayNext() {\n const playList = WebPlayer.getPlayList();\n const currentIndex = WebPlayer.getCurrentIndex();\n\n if (playList.length === 0) {\n alert(\"播放列表为空\");\n return;\n }\n\n let nextIndex;\n const playMode = WebPlayer.getPlayMode();\n\n switch (playMode) {\n case 0: // 单曲循环\n nextIndex = currentIndex;\n break;\n\n case 1: // 全部循环\n nextIndex = (currentIndex + 1) % playList.length;\n break;\n\n case 2: // 随机播放\n const availableIndices = playList\n .map((_, i) => i)\n .filter((i) => i !== currentIndex);\n if (availableIndices.length > 0) {\n nextIndex =\n availableIndices[Math.floor(Math.random() * availableIndices.length)];\n } else {\n nextIndex = Math.floor(Math.random() * playList.length);\n }\n break;\n\n case 3: // 单曲播放\n // 不自动播放下一首\n return;\n\n case 4: // 顺序播放\n nextIndex = currentIndex + 1;\n if (nextIndex >= playList.length) {\n // 到末尾停止\n return;\n }\n break;\n\n default:\n nextIndex = (currentIndex + 1) % playList.length;\n }\n\n const nextMusic = playList[nextIndex];\n if (nextMusic) {\n loadAndPlayMusic(nextMusic);\n }\n}\n\nfunction togglePlayMode(isSend = true) {\n var did = $(\"#did\").val();\n const modeBtnIcon = $(\"#modeBtn .material-icons\");\n\n if (did == \"web_device\") {\n // 本机播放：使用 localStorage 管理播放模式\n let currentMode = WebPlayer.getPlayMode();\n\n // 切换到下一个模式\n const nextMode = (currentMode + 1) % Object.keys(playModes).length;\n WebPlayer.setPlayMode(nextMode);\n\n // 更新图标和提示（显示新的模式）\n modeBtnIcon.text(playModes[nextMode].icon);\n $(\"#modeBtn .tooltip\").text(playModes[nextMode].cmd);\n\n console.log(`播放模式已切换为: ${nextMode} ${playModes[nextMode].cmd}`);\n\n // 更新 audio 元素的 loop 属性\n const audioElement = document.getElementById(\"audio\");\n if (nextMode === 0) {\n // 单曲循环\n audioElement.loop = true;\n } else {\n audioElement.loop = false;\n }\n\n announceToScreenReader(`播放模式已切换为${playModes[nextMode].cmd}`);\n } else {\n // 设备播放：使用原有逻辑\n if (playModeIndex === \"\") {\n playModeIndex = 2;\n }\n modeBtnIcon.text(playModes[playModeIndex].icon);\n $(\"#modeBtn .tooltip\").text(playModes[playModeIndex].cmd);\n\n isSend && sendcmd(playModes[playModeIndex].cmd);\n console.log(\n `当前播放模式: ${playModeIndex} ${playModes[playModeIndex].cmd}`,\n );\n playModeIndex = (playModeIndex + 1) % Object.keys(playModes).length;\n }\n}\n\n// 调用后端接口将歌曲加入指定歌单\nfunction playlistAddMusic(playlistName, musicName) {\n return $.ajax({\n type: \"POST\",\n url: \"/playlistaddmusic\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({ name: playlistName, music_list: [musicName] }),\n });\n}\n\n// 调用后端接口将歌曲从指定歌单移除\nfunction playlistDelMusic(playlistName, musicName) {\n return $.ajax({\n type: \"POST\",\n url: \"/playlistdelmusic\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({ name: playlistName, music_list: [musicName] }),\n });\n}\n\nfunction addToFavorites() {\n const isLiked = $(\".favorite\").hasClass(\"favorite-active\");\n const musicName = WebPlayer.getCurrentMusic() || $(\"#music_name\").val();\n\n if (!musicName) {\n alert(\"请先选择或播放一首歌曲\");\n return;\n }\n\n if (isLiked) {\n $(\".favorite\").removeClass(\"favorite-active\");\n favoritelist = favoritelist.filter((item) => item !== musicName);\n updateFavoriteAria(false);\n announceToScreenReader(`已取消收藏 ${musicName}`);\n playlistDelMusic(\"收藏\", musicName)\n .done((data) => {\n console.log(\"取消收藏成功:\", musicName, data);\n })\n .fail(() => {\n console.error(\"取消收藏失败:\", musicName);\n });\n } else {\n $(\".favorite\").addClass(\"favorite-active\");\n favoritelist.push(musicName);\n updateFavoriteAria(true);\n announceToScreenReader(`已收藏 ${musicName}`);\n playlistAddMusic(\"收藏\", musicName)\n .done((data) => {\n console.log(\"收藏成功:\", musicName, data);\n })\n .fail(() => {\n console.error(\"收藏失败:\", musicName);\n });\n }\n}\n\nfunction openSettings() {\n console.log(\"打开设置\");\n window.location.href = \"setting.html\";\n}\nfunction toggleVolume() {\n const isVisible = $(\"#volume-component\").is(\":visible\");\n if (isVisible) {\n closeDialog(\"volume-component\");\n } else {\n openDialog(\"volume-component\");\n }\n}\n\nfunction toggleSearch() {\n const isVisible = $(\"#search-component\").is(\":visible\");\n if (isVisible) {\n closeDialog(\"search-component\");\n } else {\n openDialog(\"search-component\");\n }\n}\n\nfunction toggleTimer() {\n const isVisible = $(\"#timer-component\").is(\":visible\");\n if (isVisible) {\n closeDialog(\"timer-component\");\n } else {\n openDialog(\"timer-component\");\n }\n}\n\nfunction togglePlayLink() {\n const isVisible = $(\"#playlink-component\").is(\":visible\");\n if (isVisible) {\n closeDialog(\"playlink-component\");\n } else {\n openDialog(\"playlink-component\");\n }\n}\n\nfunction toggleLocalPlay() {\n $(\"#audio\").fadeIn();\n}\n\nfunction toggleWarning() {\n const isVisible = $(\"#warning-component\").is(\":visible\");\n if (isVisible) {\n closeDialog(\"warning-component\");\n } else {\n openDialog(\"warning-component\");\n }\n}\n\nfunction toggleDelete() {\n var del_music_name = $(\"#music_name\").val();\n $(\"#delete-music-name\").text(del_music_name);\n const isVisible = $(\"#delete-component\").is(\":visible\");\n if (isVisible) {\n closeDialog(\"delete-component\");\n } else {\n openDialog(\"delete-component\");\n }\n}\nfunction confirmDelete() {\n var del_music_name = $(\"#music_name\").val();\n console.log(`删除歌曲 ${del_music_name}`);\n $(\"#delete-component\").hide(); // 隐藏删除框\n $.ajax({\n type: \"POST\",\n url: \"/delmusic\",\n data: JSON.stringify({ name: del_music_name }),\n contentType: \"application/json; charset=utf-8\",\n success: () => {\n alert(`删除 ${del_music_name} 成功`);\n refresh_music_list();\n },\n error: () => {\n alert(`删除 ${del_music_name} 失败`);\n },\n });\n}\nfunction formatTime(seconds) {\n // 处理无效值\n if (!isFinite(seconds) || isNaN(seconds) || seconds < 0) {\n return \"0:00\";\n }\n\n const minutes = Math.floor(seconds / 60);\n const secs = Math.floor(seconds % 60);\n return `${minutes}:${secs < 10 ? \"0\" : \"\"}${secs}`; // Format time as mm:ss\n}\n\nvar offset = 0;\nvar duration = 0;\nlet no_warning = localStorage.getItem(\"no-warning\");\n\n// 全局 did 变量初始化，默认为本机播放\nvar did = localStorage.getItem(\"cur_did\") || \"web_device\";\n\n// 拉取现有配置\n$.get(\"/getsetting\", function (data, status) {\n console.log(data, status);\n localStorage.setItem(\"mi_did\", data.mi_did);\n\n did = localStorage.getItem(\"cur_did\") || \"web_device\";\n var dids = [];\n if (data.mi_did != null) {\n dids = data.mi_did.split(\",\");\n }\n console.log(\"cur_did\", did);\n console.log(\"dids\", dids);\n\n // 如果当前 did 不是 web_device，且配置了设备列表，但 did 不在列表中，则使用第一个设备\n if (did != \"web_device\" && dids.length > 0 && !dids.includes(did)) {\n did = dids[0];\n localStorage.setItem(\"cur_did\", did);\n }\n\n // 如果 did 仍然为空或未设置，默认使用 web_device\n if (!did || did === \"\") {\n did = \"web_device\";\n localStorage.setItem(\"cur_did\", did);\n }\n\n window.did = did;\n $.get(`/getvolume?did=${did}`, function (data, status) {\n console.log(data, status, data[\"volume\"]);\n $(\"#volume\").val(data.volume);\n });\n refresh_music_list();\n\n $(\"#did\").empty();\n var dids = data.mi_did.split(\",\");\n\n // 收集所有设备选项\n var deviceOptions = [];\n $.each(dids, function (index, value) {\n var cur_device = Object.values(data.devices).find(\n (device) => device.did === value,\n );\n if (cur_device) {\n deviceOptions.push({\n value: value,\n text: cur_device.name,\n });\n\n if (value === did) {\n playModeIndex = cur_device.play_type;\n console.log(\n \"%c当前设备播放模式: \",\n \"color: #007acc;\",\n cur_device.play_type,\n );\n togglePlayMode(false);\n }\n }\n });\n\n // 添加本机选项\n deviceOptions.push({\n value: \"web_device\",\n text: \"本机\",\n });\n\n // 批量填充设备选项\n fillSelectOptions(\n \"#did\",\n deviceOptions,\n did,\n `设备列表已加载，共 ${deviceOptions.length} 个设备`,\n );\n\n console.log(\"cur_did\", did);\n $(\"#did\").change(function () {\n did = $(this).val();\n localStorage.setItem(\"cur_did\", did);\n window.did = did;\n console.log(\"cur_did\", did);\n location.reload();\n });\n\n if (did == \"web_device\") {\n // 本机播放：显示 audio 控件和进度条\n $(\"#audio\").fadeIn();\n $(\"#device-audio\").fadeIn(); // 保持显示，因为进度条在这里\n\n // 本机播放：禁用设备相关按钮，启用本机按钮\n // 搜索、定时、测试按钮禁用\n $(\".icon-item\").each(function () {\n const text = $(this).find(\"p\").text();\n if (text === \"搜索\" || text === \"定时\" || text === \"测试\") {\n $(this).addClass(\"disabled\");\n $(this).css(\"opacity\", \"0.5\");\n $(this).css(\"pointer-events\", \"none\");\n }\n });\n\n // 其他按钮启用（播放模式、上一曲、播放、下一曲、停止、收藏、音量、设置）\n $(\"#modeBtn\").removeClass(\"disabled\");\n $(\".favorite\").removeClass(\"disabled\");\n } else {\n // 设备播放：隐藏 audio 控件，显示进度条\n $(\"#audio\").fadeOut();\n $(\"#device-audio\").fadeIn();\n\n // 设备播放：恢复所有按钮\n $(\".device-enable\").removeClass(\"disabled\");\n $(\".icon-item\").removeClass(\"disabled\");\n $(\".icon-item\").css(\"opacity\", \"\");\n $(\".icon-item\").css(\"pointer-events\", \"\");\n }\n\n // 初始化对话记录开关状态\n updatePullAskUI(data.enable_pull_ask);\n});\n\nfunction compareVersion(version1, version2) {\n const v1 = version1.split(\".\").map(Number);\n const v2 = version2.split(\".\").map(Number);\n const len = Math.max(v1.length, v2.length);\n\n for (let i = 0; i < len; i++) {\n const num1 = v1[i] || 0;\n const num2 = v2[i] || 0;\n if (num1 > num2) return 1;\n if (num1 < num2) return -1;\n }\n return 0;\n}\n\n// 拉取版本\n$.get(\"/getversion\", function (data, status) {\n console.log(data, status, data[\"version\"]);\n $(\"#version\").text(`${data.version}`);\n\n $.get(\"/latestversion\", function (ret, status) {\n console.log(ret, status);\n if (ret.ret == \"OK\") {\n const result = compareVersion(ret.version, data.version);\n if (result > 0) {\n console.log(`${ret.version} is greater than ${data.version}`);\n $(\"#versionnew\").text(\"new\").css(\"display\", \"inline-block\");\n }\n }\n });\n});\n\nfunction _refresh_music_list(callback) {\n $(\"#music_list\").empty();\n $.get(\"/musiclist\", function (data, status) {\n console.log(data, status);\n favoritelist = data[\"收藏\"];\n\n // 收集所有播放列表选项\n var playlistOptions = [];\n $.each(data, function (key, value) {\n let cnt = value.length;\n playlistOptions.push({\n value: key,\n text: `${key} (${cnt})`,\n });\n });\n\n // 批量填充播放列表选项\n fillSelectOptions(\n \"#music_list\",\n playlistOptions,\n null, // 选中值将在后面通过 trigger('change') 设置\n `播放列表已加载，共 ${playlistOptions.length} 个列表`,\n );\n\n $(\"#music_list\").change(function () {\n const selectedValue = $(this).val();\n localStorage.setItem(\"cur_playlist\", selectedValue);\n $(\"#music_name\").empty();\n const cur_music = localStorage.getItem(\"cur_music\");\n console.log(\"#music_name cur_music\", cur_music);\n\n // 收集所有歌曲选项\n var songOptions = [];\n $.each(data[selectedValue], function (index, item) {\n songOptions.push({\n value: item,\n text: item,\n });\n });\n\n // 批量填充歌曲选项\n fillSelectOptions(\n \"#music_name\",\n songOptions,\n cur_music,\n `歌曲列表已加载，共 ${songOptions.length} 首歌曲`,\n );\n\n // 本机播放：更新播放列表\n var did = $(\"#did\").val();\n if (did == \"web_device\") {\n const playlistData = $(\"#music_name option\")\n .map(function () {\n return $(this).val();\n })\n .get();\n WebPlayer.setPlayList(playlistData);\n WebPlayer.setPlaylist(selectedValue);\n console.log(\"本机播放列表已更新:\", selectedValue);\n }\n });\n\n // 监听歌曲选择变化（本机播放）\n $(\"#music_name\").on(\"change\", function () {\n var did = $(\"#did\").val();\n if (did == \"web_device\") {\n const selectedMusic = $(this).val();\n // 保存用户选择的歌曲（不自动播放）\n if (selectedMusic) {\n WebPlayer.setCurrentMusic(selectedMusic);\n console.log(\"本机选择歌曲已保存:\", selectedMusic);\n }\n }\n });\n\n // 本机模式：直接使用 WebPlayer 的状态，不调用后端接口\n if (did == \"web_device\") {\n const savedPlaylist = WebPlayer.getPlaylist();\n const savedMusic = WebPlayer.getCurrentMusic();\n\n console.log(\n \"恢复本机播放状态 - 歌单:\",\n savedPlaylist,\n \"歌曲:\",\n savedMusic,\n );\n\n // 恢复歌单选择\n if (savedPlaylist && data.hasOwnProperty(savedPlaylist)) {\n $(\"#music_list\").val(savedPlaylist);\n $(\"#music_list\").trigger(\"change\");\n\n // 等待歌单切换完成后，恢复歌曲选择\n setTimeout(function () {\n if (\n savedMusic &&\n $(\"#music_name option[value='\" + savedMusic + \"']\").length > 0\n ) {\n $(\"#music_name\").val(savedMusic);\n console.log(\"已恢复歌曲选择:\", savedMusic);\n }\n }, 100);\n } else {\n // 没有保存的歌单，使用默认\n $(\"#music_list\").trigger(\"change\");\n }\n callback();\n } else {\n // 设备模式：使用原有逻辑\n $(\"#music_list\").trigger(\"change\");\n\n // 获取当前播放列表\n $.get(`/curplaylist?did=${did}`, function (playlist, status) {\n if (playlist != \"\") {\n $(\"#music_list\").val(playlist);\n $(\"#music_list\").trigger(\"change\");\n } else {\n // 使用本地记录的\n playlist = localStorage.getItem(\"cur_playlist\");\n if (data.hasOwnProperty(playlist)) {\n $(\"#music_list\").val(playlist);\n $(\"#music_list\").trigger(\"change\");\n }\n }\n });\n callback();\n }\n });\n}\n\n// 拉取播放列表\nfunction refresh_music_list() {\n // 刷新列表时清空并临时禁用搜索框\n const searchInput = document.getElementById(\"search\");\n const oriPlaceHolder = searchInput.placeholder;\n const oriValue = searchInput.value;\n const inputEvent = new Event(\"input\", { bubbles: true });\n searchInput.value = \"\";\n // 分发事件，让其他控件改变状态\n searchInput.dispatchEvent(inputEvent);\n searchInput.disabled = true;\n searchInput.placeholder = \"请等待...\";\n\n _refresh_music_list(() => {\n // 刷新完成再启用\n searchInput.disabled = false;\n searchInput.value = oriValue;\n searchInput.dispatchEvent(inputEvent);\n searchInput.placeholder = oriPlaceHolder;\n // 获取下正在播放的音乐\n if (did != \"web_device\") {\n connectWebSocket(did);\n }\n });\n}\n\nfunction do_play_music_list(listname, musicname) {\n $.ajax({\n type: \"POST\",\n url: \"/playmusiclist\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({\n did: did,\n listname: listname,\n musicname: musicname,\n }),\n success: () => {\n console.log(\"do_play_music_list succ\", listname, musicname);\n },\n error: () => {\n console.log(\"do_play_music_list failed\", listname, musicname);\n },\n });\n}\n\n$(\"#play_music_list\").on(\"click\", () => {\n var music_list = $(\"#music_list\").val();\n var music_name = $(\"#music_name\").val();\n if (no_warning) {\n do_play_music_list(music_list, music_name);\n return;\n }\n $.get(`/musicinfo?name=${music_name}`, function (data, status) {\n console.log(data);\n if (data.ret == \"OK\") {\n validHost(data.url) && do_play_music_list(music_list, music_name);\n }\n });\n});\n\nfunction playUrl() {\n var url = $(\"#music-url\").val();\n const encoded_url = encodeURIComponent(url);\n $.get(`/playurl?url=${encoded_url}&did=${did}`, function (data, status) {\n console.log(data);\n });\n}\n\nfunction playProxyUrl() {\n const origin_url = $(\"#music-url\").val();\n const protocol = window.location.protocol;\n const host = window.location.host;\n const baseUrl = `${protocol}//${host}`;\n const urlb64 = btoa(origin_url);\n const url = `${baseUrl}/proxy?urlb64=${urlb64}`;\n const encoded_url = encodeURIComponent(url);\n $.get(`/playurl?url=${encoded_url}&did=${did}`, function (data, status) {\n console.log(data);\n });\n}\n\nfunction playTts() {\n var value = $(\"#text-tts\").val();\n $.get(`/playtts?text=${value}&did=${did}`, function (data, status) {\n console.log(data);\n });\n}\n\nfunction sendCustomCmd() {\n var cmd = $(\"#custom-cmd\").val();\n if (!cmd || cmd.trim() === \"\") {\n alert(\"请输入自定义口令\");\n return;\n }\n $.ajax({\n type: \"POST\",\n url: \"/cmd\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({ did: did, cmd: cmd }),\n success: () => {\n console.log(\"发送自定义口令成功:\", cmd);\n alert(`口令 \"${cmd}\" 已发送`);\n },\n error: () => {\n console.log(\"发送自定义口令失败:\", cmd);\n alert(`口令 \"${cmd}\" 发送失败`);\n },\n });\n}\n\nfunction do_play_music(musicname, searchkey) {\n $.ajax({\n type: \"POST\",\n url: \"/playmusic\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({\n did: did,\n musicname: musicname,\n searchkey: searchkey,\n }),\n success: () => {\n console.log(\"do_play_music succ\", musicname, searchkey);\n },\n error: () => {\n console.log(\"do_play_music failed\", musicname, searchkey);\n },\n });\n}\n\n// 上传功能：触发文件选择并提交到后端\nfunction triggerUpload() {\n const uploadInput = document.getElementById(\"upload-file\");\n if (uploadInput) {\n uploadInput.value = null;\n uploadInput.click();\n }\n}\n\ndocument.addEventListener(\"DOMContentLoaded\", function () {\n const uploadInput = document.getElementById(\"upload-file\");\n if (uploadInput) {\n uploadInput.addEventListener(\"change\", async function (e) {\n const files = e.target.files;\n if (!files || files.length === 0) return;\n const file = files[0];\n const playlist = $(\"#music_list\").val();\n const form = new FormData();\n form.append(\"playlist\", playlist);\n form.append(\"file\", file);\n try {\n const resp = await fetch(\"/uploadmusic\", {\n method: \"POST\",\n body: form,\n });\n if (!resp.ok) throw new Error(\"网络错误\");\n const data = await resp.json();\n if (data && data.ret === \"OK\") {\n alert(\"上传成功: \" + data.filename);\n refresh_music_list();\n } else {\n alert(\"上传失败\");\n }\n } catch (err) {\n console.error(err);\n alert(\"上传失败\");\n }\n });\n }\n});\n\n$(\"#play\").on(\"click\", () => {\n var search_key = $(\"#music-name\").val();\n if (search_key == null) {\n search_key = \"\";\n }\n var filename = $(\"#music-filename\").val();\n if (filename == null || filename == \"\") {\n filename = search_key;\n }\n do_play_music(filename, search_key);\n});\n\n$(\"#volume\").on(\"change\", function () {\n var value = $(this).val();\n var did = $(\"#did\").val();\n\n updateVolumeAria(value);\n\n if (did == \"web_device\") {\n // 本机播放：直接控制 audio 元素音量\n const audioElement = document.getElementById(\"audio\");\n audioElement.volume = value / 100; // audio.volume 范围是 0-1\n\n // 保存到 localStorage\n WebPlayer.setVolume(value);\n\n console.log(\"本机音量已设置为:\", value);\n } else {\n // 设备播放：调用后端接口\n $.ajax({\n type: \"POST\",\n url: \"/setvolume\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({ did: did, volume: value }),\n success: () => {},\n error: () => {},\n });\n }\n});\n\nfunction check_status_refresh_music_list(retries) {\n $.get(\"/cmdstatus\", function (data) {\n if (data.status === \"finish\") {\n refresh_music_list();\n } else if (retries > 0) {\n setTimeout(function () {\n check_status_refresh_music_list(retries - 1);\n }, 1000); // 等待1秒后重试\n }\n });\n}\n\nfunction refreshlist() {\n $.ajax({\n type: \"POST\",\n url: \"/api/music/refreshlist\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({}),\n success: () => {\n check_status_refresh_music_list(3); // 最多重试3次\n },\n error: () => {\n // 请求失败时执行的操作\n },\n });\n}\n\nfunction sendcmd(cmd) {\n $.ajax({\n type: \"POST\",\n url: \"/cmd\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({ did: did, cmd: cmd }),\n success: () => {\n if (cmd == \"刷新列表\") {\n check_status_refresh_music_list(3); // 最多重试3次\n }\n if (\n [\"全部循环\", \"单曲循环\", \"随机播放\", \"单曲播放\", \"顺序播放\"].includes(\n cmd,\n )\n ) {\n location.reload();\n }\n },\n error: () => {\n // 请求失败时执行的操作\n },\n });\n}\n\n// 监听输入框的输入事件\nfunction debounce(func, delay) {\n let timeout;\n return function (...args) {\n clearTimeout(timeout);\n timeout = setTimeout(() => func.apply(this, args), delay);\n };\n}\n\nlet selectedSearchResult = null;\n\nfunction handleSearch() {\n const searchInput = document.getElementById(\"search\");\n const resultsContainer = document.getElementById(\"music-name\");\n const musicFilenameInput = document.getElementById(\"music-filename\");\n\n searchInput.addEventListener(\n \"input\",\n debounce(function () {\n const query = searchInput.value.trim();\n\n if (query.length === 0) {\n resultsContainer.innerHTML =\n '
请输入搜索关键词
';\n selectedSearchResult = null;\n musicFilenameInput.style.display = \"none\";\n return;\n }\n\n // 显示加载状态\n resultsContainer.innerHTML =\n '
搜索中...
';\n\n fetch(`/searchmusic?name=${encodeURIComponent(query)}`)\n .then((response) => response.json())\n .then((data) => {\n resultsContainer.innerHTML = \"\"; // 清空现有内容\n\n // 添加用户输入作为关键词选项（始终显示在第一位）\n const keywordItem = document.createElement(\"div\");\n keywordItem.className = \"search-result-item keyword-option\";\n keywordItem.textContent = `🔍 使用关键词播放: ${query}`;\n keywordItem.dataset.value = query;\n keywordItem.dataset.isKeyword = \"true\";\n keywordItem.onclick = function () {\n selectSearchResult(this);\n };\n resultsContainer.appendChild(keywordItem);\n\n // 找到的歌曲结果\n if (data.length > 0) {\n data.forEach((song) => {\n const item = document.createElement(\"div\");\n item.className = \"search-result-item\";\n item.textContent = song;\n item.dataset.value = song;\n item.dataset.isKeyword = \"false\";\n item.onclick = function () {\n selectSearchResult(this);\n };\n resultsContainer.appendChild(item);\n });\n } else {\n // 没有找到本地歌曲\n const emptyItem = document.createElement(\"div\");\n emptyItem.className = \"search-result-empty\";\n emptyItem.textContent = \"没有找到本地歌曲，可使用关键词在线播放\";\n resultsContainer.appendChild(emptyItem);\n }\n\n // 默认选中关键词选项\n selectSearchResult(keywordItem);\n })\n .catch((error) => {\n console.error(\"Error fetching data:\", error);\n resultsContainer.innerHTML =\n '
搜索失败，请重试
';\n });\n }, 600),\n );\n}\n\nfunction selectSearchResult(element) {\n // 移除所有选中状态\n const allItems = document.querySelectorAll(\".search-result-item\");\n allItems.forEach((item) => item.classList.remove(\"selected\"));\n\n // 添加选中状态\n element.classList.add(\"selected\");\n selectedSearchResult = {\n value: element.dataset.value,\n isKeyword: element.dataset.isKeyword === \"true\",\n };\n\n // 根据是否是关键词选项决定是否显示文件名输入框\n const musicFilenameInput = document.getElementById(\"music-filename\");\n if (selectedSearchResult.isKeyword) {\n musicFilenameInput.style.display = \"block\";\n musicFilenameInput.placeholder = `请输入保存为的文件名称(默认: ${selectedSearchResult.value})`;\n } else {\n musicFilenameInput.style.display = \"none\";\n }\n}\n\nhandleSearch();\n\nfunction formatTime(seconds) {\n var minutes = Math.floor(seconds / 60);\n var remainingSeconds = Math.floor(seconds % 60);\n return `${minutes.toString().padStart(2, \"0\")}:${remainingSeconds\n .toString()\n .padStart(2, \"0\")}`;\n}\n\n$(\"audio\").on(\"error\", (e) => {\n //如果audio标签的src为空，则不做任何操作，兼容安卓端的低版本webview\n if ($(\"audio\").attr(\"src\") === \"\") {\n return;\n }\n console.log(\n \"%c网页播放出现错误: \",\n \"color: #007acc;\",\n e.currentTarget.error.code,\n e.currentTarget.error.message,\n );\n alert(\n e.currentTarget.error.code == 4\n ? \"无法打开媒体文件，XIAOMUSIC_HOSTNAME或端口地址错误，请重新设置\"\n : \"在线播放失败，请截图反馈: \" + e.currentTarget.error.message,\n );\n});\nfunction validHost(url) {\n //如果 localStorage 中有 no-warning 则直接返回true\n if (no_warning) {\n return true;\n }\n const local = location.host;\n const host = new URL(url).host;\n // 如果当前页面的Host与设置中的XIAOMUSIC_HOSTNAME、PORT一致, 不再提醒\n if (local === host) {\n return true;\n }\n\n $(\"#local-host\").text(local);\n $(\"#setting-host\").text(host);\n $(\"#warning-component\").show();\n console.log(\"%c 验证返回false\", \"color: #007acc;\");\n return false;\n}\n\nfunction nowarning() {\n localStorage.setItem(\"no-warning\", \"true\");\n no_warning = true;\n $(\"#warning-component\").hide();\n}\nfunction timedShutDown(cmd) {\n $(\".timer-tooltip\").toggle();\n sendcmd(cmd);\n setTimeout(() => {\n $(\".timer-tooltip\").fadeOut();\n }, 3000);\n}\n\nfunction confirmSearch() {\n if (!selectedSearchResult) {\n alert(\"请先选择一个搜索结果\");\n return;\n }\n\n var search_key = $(\"#search\").val();\n var filename = selectedSearchResult.value;\n var musicfilename = $(\"#music-filename\").val();\n\n // 如果是关键词选项且用户输入了自定义文件名\n if (\n selectedSearchResult.isKeyword &&\n musicfilename &&\n musicfilename.trim() !== \"\"\n ) {\n filename = musicfilename.trim();\n }\n\n console.log(\"confirmSearch\", filename, search_key);\n do_play_music(filename, search_key);\n toggleSearch();\n}\n\nlet ws = null;\nlet wsReconnectTimer = null;\nlet currentDid = null;\nlet isConnecting = false;\n\n// 清理 WebSocket 连接\nfunction cleanupWebSocket() {\n // 清除重连定时器\n if (wsReconnectTimer) {\n clearTimeout(wsReconnectTimer);\n wsReconnectTimer = null;\n }\n\n // 关闭现有连接\n if (ws) {\n try {\n // 移除事件监听器，避免触发 onclose 重连\n ws.onclose = null;\n ws.onerror = null;\n ws.onmessage = null;\n\n if (\n ws.readyState === WebSocket.OPEN ||\n ws.readyState === WebSocket.CONNECTING\n ) {\n ws.close();\n }\n } catch (e) {\n console.error(\"关闭 WebSocket 失败:\", e);\n }\n ws = null;\n }\n\n isConnecting = false;\n}\n\n// 启动 WebSocket 连接\nfunction connectWebSocket(did) {\n // 如果正在连接中，直接返回\n if (isConnecting) {\n console.log(\"WebSocket 正在连接中，跳过重复连接\");\n return;\n }\n\n // 如果 did 改变了，需要重新连接\n if (currentDid !== did) {\n console.log(`设备切换: ${currentDid} -> ${did}`);\n cleanupWebSocket();\n currentDid = did;\n }\n\n isConnecting = true;\n\n fetch(`/generate_ws_token?did=${did}`)\n .then((res) => res.json())\n .then((data) => {\n const token = data.token;\n startWebSocket(did, token);\n })\n .catch((err) => {\n console.error(\"获取 token 失败:\", err);\n isConnecting = false;\n // 5秒后重试\n wsReconnectTimer = setTimeout(() => connectWebSocket(did), 5000);\n });\n}\n\nfunction startWebSocket(did, token) {\n // 再次检查，确保没有重复连接\n if (\n ws &&\n (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING)\n ) {\n console.log(\"WebSocket 已存在，跳过创建\");\n isConnecting = false;\n return;\n }\n\n const protocol = window.location.protocol === \"https:\" ? \"wss\" : \"ws\";\n const wsUrl = `${protocol}://${window.location.host}/ws/playingmusic?token=${token}`;\n\n try {\n ws = new WebSocket(wsUrl);\n\n ws.onopen = () => {\n console.log(\"WebSocket 连接成功\");\n isConnecting = false;\n };\n\n ws.onmessage = (event) => {\n const data = JSON.parse(event.data);\n if (data.ret !== \"OK\") return;\n\n isPlaying = data.is_playing;\n let cur_music = data.cur_music || \"\";\n\n $(\"#playering-music\").text(\n isPlaying ? `【播放中】 ${cur_music}` : `【空闲中】 ${cur_music}`,\n );\n\n offset = data.offset || 0;\n duration = data.duration || 0;\n\n if (favoritelist.includes(cur_music)) {\n $(\".favorite\").addClass(\"favorite-active\");\n } else {\n $(\".favorite\").removeClass(\"favorite-active\");\n }\n\n localStorage.setItem(\"cur_music\", cur_music);\n updateProgressUI();\n };\n\n ws.onclose = (event) => {\n console.log(\"WebSocket 已断开\", event.code, event.reason);\n ws = null;\n isConnecting = false;\n\n // 只有在非主动关闭的情况下才重连\n if (event.code !== 1000) {\n console.log(\"3秒后尝试重连...\");\n wsReconnectTimer = setTimeout(() => connectWebSocket(did), 3000);\n }\n };\n\n ws.onerror = (err) => {\n console.error(\"WebSocket 错误:\", err);\n isConnecting = false;\n // onerror 后会触发 onclose，所以这里不需要重连\n };\n } catch (e) {\n console.error(\"创建 WebSocket 失败:\", e);\n isConnecting = false;\n wsReconnectTimer = setTimeout(() => connectWebSocket(did), 3000);\n }\n}\n\n// 每秒更新播放进度\nfunction updateProgressUI() {\n const progressPercent = duration > 0 ? (offset / duration) * 100 : 0;\n $(\"#progress\").val(progressPercent);\n $(\"#current-time\").text(formatTime(offset));\n\n // 更新进度条 ARIA 属性\n updateProgressAria(offset, duration);\n $(\"#duration\").text(formatTime(duration));\n}\n\nsetInterval(() => {\n if (duration > 0 && isPlaying) {\n offset++;\n if (offset > duration) offset = duration;\n updateProgressUI();\n }\n}, 1000);\n\nfunction togglePullAsk() {\n console.log(\"切换对话记录状态\");\n $.get(\"/getsetting\", function (data, status) {\n const currentState = data.enable_pull_ask;\n const newState = !currentState;\n\n $.ajax({\n type: \"POST\",\n url: \"/api/system/modifiysetting\",\n contentType: \"application/json; charset=utf-8\",\n data: JSON.stringify({\n enable_pull_ask: newState,\n }),\n success: (response) => {\n console.log(\"对话记录状态切换成功\", response);\n updatePullAskUI(newState);\n alert(newState ? \"对话记录已开启\" : \"对话记录已关闭\");\n },\n error: (error) => {\n console.error(\"对话记录状态切换失败\", error);\n alert(\"切换失败，请重试\");\n },\n });\n });\n}\n\nfunction updatePullAskUI(enabled) {\n const pullAskToggle = $(\"#pullAskToggle\");\n if (enabled) {\n pullAskToggle.addClass(\"active\");\n } else {\n pullAskToggle.removeClass(\"active\");\n }\n // 更新 ARIA 属性\n updatePullAskAria(enabled);\n}\n\n// ============ 无障碍功能初始化 ============\n\n// 键盘事件监听\n$(document).on(\"keydown\", function (e) {\n // 如果焦点在输入框、文本域或选择框中，不处理快捷键\n const tagName = document.activeElement.tagName.toLowerCase();\n if (tagName === \"input\" || tagName === \"textarea\" || tagName === \"select\") {\n return;\n }\n\n // ESC 键 - 关闭当前打开的弹窗\n if (e.key === \"Escape\") {\n if (openDialogs.size > 0) {\n const dialogId = Array.from(openDialogs)[openDialogs.size - 1];\n closeDialog(dialogId);\n e.preventDefault();\n }\n }\n\n // 空格键 - 播放\n if (e.key === \" \" || e.code === \"Space\") {\n play();\n e.preventDefault();\n }\n});\n\n// 为自定义按钮添加键盘支持（Enter 和 Space 键）\n$(document).on(\"keydown\", '[role=\"button\"], [role=\"switch\"]', function (e) {\n if (e.key === \"Enter\" || e.key === \" \") {\n $(this).click();\n e.preventDefault();\n }\n});\n\n// 初始化收藏按钮的 ARIA 状态\n$(document).ready(function () {\n const isFavorited = $(\".favorite\").hasClass(\"favorite-active\");\n updateFavoriteAria(isFavorited);\n});\n\n// ============ 本机播放器 UI 更新函数 ============\n\n// 更新本机播放状态 UI\nfunction updateWebPlayingUI() {\n const audioElement = document.getElementById(\"audio\");\n const currentMusic = WebPlayer.getCurrentMusic();\n\n if (!audioElement) return;\n\n const isPlaying = !audioElement.paused;\n const statusText = isPlaying ? \"【播放中】\" : \"【暂停】\";\n\n $(\"#playering-music\").text(statusText + (currentMusic || \"无\"));\n}\n\n// 更新本机收藏按钮状态\nfunction updateWebFavoriteButton() {\n const currentMusic = WebPlayer.getCurrentMusic();\n\n if (!currentMusic) return;\n\n // 直接使用全局 favoritelist，数据来源于服务器\n const isFavorited = favoritelist.includes(currentMusic);\n\n if (isFavorited) {\n $(\".favorite\").addClass(\"favorite-active\");\n } else {\n $(\".favorite\").removeClass(\"favorite-active\");\n }\n\n updateFavoriteAria(isFavorited);\n}\n\n// ============ 本机播放器事件监听器 ============\n\n// 初始化本机播放器\nfunction initWebPlayer() {\n const audioElement = document.getElementById(\"audio\");\n\n if (!audioElement) {\n console.error(\"Audio element not found\");\n return;\n }\n\n // 从 localStorage 恢复音量\n const savedVolume = WebPlayer.getVolume();\n audioElement.volume = savedVolume / 100;\n $(\"#volume\").val(savedVolume);\n updateVolumeAria(savedVolume);\n\n // 从 localStorage 恢复播放模式\n const savedMode = WebPlayer.getPlayMode();\n const modeBtnIcon = $(\"#modeBtn .material-icons\");\n modeBtnIcon.text(playModes[savedMode].icon);\n $(\"#modeBtn .tooltip\").text(playModes[savedMode].cmd);\n\n // 设置单曲循环模式\n if (savedMode === 0) {\n audioElement.loop = true;\n }\n\n // 监听播放事件\n audioElement.addEventListener(\"play\", function () {\n console.log(\"Audio play event\");\n updateWebPlayingUI();\n });\n\n // 监听暂停事件\n audioElement.addEventListener(\"pause\", function () {\n console.log(\"Audio pause event\");\n updateWebPlayingUI();\n });\n\n // 监听播放结束事件\n audioElement.addEventListener(\"ended\", function () {\n console.log(\"Audio ended event triggered\");\n\n const playMode = WebPlayer.getPlayMode();\n console.log(\"Current play mode:\", playMode, playModes[playMode].cmd);\n\n // 单曲循环模式下，loop 属性会自动处理，不需要手动处理\n if (playMode === 0) {\n console.log(\"Single loop mode, audio.loop will handle it\");\n return;\n }\n\n // 单曲播放模式：不自动播放下一首\n if (playMode === 3) {\n console.log(\"Single play mode, stop after current song\");\n updateWebPlayingUI();\n return;\n }\n\n // 顺序播放模式：到末尾停止\n if (playMode === 4) {\n const playList = WebPlayer.getPlayList();\n const currentIndex = WebPlayer.getCurrentIndex();\n console.log(\n \"Sequential play mode, current index:\",\n currentIndex,\n \"playlist length:\",\n playList.length,\n );\n if (currentIndex >= playList.length - 1) {\n console.log(\"Reached end of playlist, stop playing\");\n updateWebPlayingUI();\n return;\n }\n }\n\n // 其他模式：自动播放下一首\n console.log(\"Auto playing next song...\");\n webPlayNext();\n });\n\n // 监听时间更新事件\n audioElement.addEventListener(\"timeupdate\", function () {\n const currentTime = audioElement.currentTime;\n const duration = audioElement.duration;\n\n // 检查是否为流媒体（duration 为 Infinity）\n const isStream = !isFinite(duration);\n\n if (isStream) {\n // 流媒体：只显示当前播放时间，不显示进度条\n $(\"#current-time\").text(formatTime(currentTime));\n $(\"#duration\").text(\"直播流\");\n $(\"#progress\").val(0); // 进度条设为 0\n console.log(\"Stream playing, current time:\", currentTime);\n } else if (duration > 0) {\n // 普通音频：显示进度条和时长\n const progressPercent = (currentTime / duration) * 100;\n $(\"#progress\").val(progressPercent);\n $(\"#current-time\").text(formatTime(currentTime));\n $(\"#duration\").text(formatTime(duration));\n\n // 更新 ARIA 属性\n updateProgressAria(currentTime, duration);\n }\n });\n\n // 监听元数据加载事件\n audioElement.addEventListener(\"loadedmetadata\", function () {\n const duration = audioElement.duration;\n console.log(\"Audio metadata loaded, duration:\", duration);\n\n // 检查是否为流媒体\n const isStream = !isFinite(duration);\n\n if (isStream) {\n // 流媒体：显示特殊标识\n $(\"#duration\").text(\"直播流\");\n $(\"#progress\").val(0);\n $(\"#current-time\").text(\"0:00\");\n console.log(\"Stream detected\");\n } else if (duration > 0) {\n // 普通音频文件\n $(\"#duration\").text(formatTime(duration));\n $(\"#progress\").val(0);\n $(\"#current-time\").text(\"0:00\");\n } else {\n // 无效的 duration\n $(\"#duration\").text(\"0:00\");\n $(\"#progress\").val(0);\n $(\"#current-time\").text(\"0:00\");\n }\n });\n\n // 监听错误事件（已有，但确保本机播放也能正确处理）\n // 原有的 error 事件监听器已经存在，不需要重复添加\n\n console.log(\"Web player initialized\");\n}\n\n// 页面加载完成后初始化本机播放器\n$(document).ready(function () {\n // 等待设备选择器初始化完成后再执行\n setTimeout(function () {\n var did = $(\"#did\").val();\n\n if (did == \"web_device\") {\n initWebPlayer();\n\n // 恢复上次播放的歌曲信息（仅显示，不自动播放）\n const lastMusic = WebPlayer.getCurrentMusic();\n if (lastMusic) {\n updateWebPlayingUI();\n updateWebFavoriteButton();\n }\n }\n }, 100);\n});\n" }, { "path": "xiaomusic/static/default/merge/index.html", "content": "\n\n\n \n 歌单导出工具\n \n \n\n\n
\n \n\n\n" }, { "path": "xiaomusic/static/default/merge/main.js", "content": "var xF=Object.create;var{getPrototypeOf:kF,defineProperty:Nz,getOwnPropertyNames:vF}=Object;var bF=Object.prototype.hasOwnProperty;var W0=(B,O,H)=>{H=B!=null?xF(kF(B)):{};let j=O||!B||!B.__esModule?Nz(H,\"default\",{value:B,enumerable:!0}):H;for(let U of vF(B))if(!bF.call(j,U))Nz(j,U,{get:()=>B[U],enumerable:!0});return j};var Y1=(B,O)=>()=>(O||B((O={exports:{}}).exports,O),O.exports);var B4=Y1((RF,CY)=>{(function(){if(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__!==\"undefined\"&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart===\"function\")__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(new Error);var B=\"18.3.1\",O=Symbol.for(\"react.element\"),H=Symbol.for(\"react.portal\"),j=Symbol.for(\"react.fragment\"),U=Symbol.for(\"react.strict_mode\"),F=Symbol.for(\"react.profiler\"),A=Symbol.for(\"react.provider\"),C=Symbol.for(\"react.context\"),S=Symbol.for(\"react.forward_ref\"),q=Symbol.for(\"react.suspense\"),x=Symbol.for(\"react.suspense_list\"),k=Symbol.for(\"react.memo\"),l=Symbol.for(\"react.lazy\"),GZ=Symbol.for(\"react.offscreen\"),zZ=Symbol.iterator,DZ=\"@@iterator\";function d(K){if(K===null||typeof K!==\"object\")return null;var E=zZ&&K[zZ]||K[DZ];if(typeof E===\"function\")return E;return null}var g={current:null},p={transition:null},i={current:null,isBatchingLegacy:!1,didScheduleLegacyUpdate:!1},MZ={current:null},HZ={},S0=null;function x0(K){S0=K}HZ.setExtraStackFrame=function(K){S0=K},HZ.getCurrentStack=null,HZ.getStackAddendum=function(){var K=\"\";if(S0)K+=S0;var E=HZ.getCurrentStack;if(E)K+=E()||\"\";return K};var r0=!1,IZ=!1,Q0=!1,_0=!1,gZ=!1,yZ={ReactCurrentDispatcher:g,ReactCurrentBatchConfig:p,ReactCurrentOwner:MZ};yZ.ReactDebugCurrentFrame=HZ,yZ.ReactCurrentActQueue=i;function q0(K){{for(var E=arguments.length,I=new Array(E>1?E-1:0),b=1;b1?E-1:0),b=1;b1){var J0=Array(aZ);for(var G0=0;G01){var B0=Array(G0);for(var D0=0;D0 is not supported and will be removed in a future major release. Did you mean to render instead?\");return E.Provider},set:function(XZ){E.Provider=XZ}},_currentValue:{get:function(){return E._currentValue},set:function(XZ){E._currentValue=XZ}},_currentValue2:{get:function(){return E._currentValue2},set:function(XZ){E._currentValue2=XZ}},_threadCount:{get:function(){return E._threadCount},set:function(XZ){E._threadCount=XZ}},Consumer:{get:function(){if(!I)I=!0,FZ(\"Rendering is not supported and will be removed in a future major release. Did you mean to render instead?\");return E.Consumer}},displayName:{get:function(){return E.displayName},set:function(XZ){if(!u)q0(\"Setting `displayName` on Context.Consumer has no effect. You should set it directly on the context with Context.displayName = '%s'.\",XZ),u=!0}}}),E.Consumer=_Z}return E._currentRenderer=null,E._currentRenderer2=null,E}var u7=-1,g8=0,y8=1,A7=2;function F7(K){if(K._status===u7){var E=K._result,I=E();if(I.then(function(_Z){if(K._status===g8||K._status===u7){var XZ=K;XZ._status=y8,XZ._result=_Z}},function(_Z){if(K._status===g8||K._status===u7){var XZ=K;XZ._status=A7,XZ._result=_Z}}),K._status===u7){var b=K;b._status=g8,b._result=I}}if(K._status===y8){var u=K._result;if(u===void 0)FZ(`lazy: Expected the result of a dynamic import() call. Instead received: %s\n\nYour code should look like: \n const MyComponent = lazy(() => import('./MyComponent'))\n\nDid you accidentally put curly braces around the import?`,u);if(!(\"default\"in u))FZ(`lazy: Expected the result of a dynamic import() call. Instead received: %s\n\nYour code should look like: \n const MyComponent = lazy(() => import('./MyComponent'))`,u);return u.default}else throw K._result}function l7(K){var E={_status:u7,_result:K},I={$$typeof:l,_payload:E,_init:F7};{var b,u;Object.defineProperties(I,{defaultProps:{configurable:!0,get:function(){return b},set:function(_Z){FZ(\"React.lazy(...): It is not supported to assign `defaultProps` to a lazy component import. Either specify them where the component is defined, or create a wrapping component around it.\"),b=_Z,Object.defineProperty(I,\"defaultProps\",{enumerable:!0})}},propTypes:{configurable:!0,get:function(){return u},set:function(_Z){FZ(\"React.lazy(...): It is not supported to assign `propTypes` to a lazy component import. Either specify them where the component is defined, or create a wrapping component around it.\"),u=_Z,Object.defineProperty(I,\"propTypes\",{enumerable:!0})}}})}return I}function N(K){{if(K!=null&&K.$$typeof===k)FZ(\"forwardRef requires a render function but received a `memo` component. Instead of forwardRef(memo(...)), use memo(forwardRef(...)).\");else if(typeof K!==\"function\")FZ(\"forwardRef requires a render function but was given %s.\",K===null?\"null\":typeof K);else if(K.length!==0&&K.length!==2)FZ(\"forwardRef render functions accept exactly two parameters: props and ref. %s\",K.length===1?\"Did you forget to use the ref parameter?\":\"Any additional parameter will be undefined.\");if(K!=null){if(K.defaultProps!=null||K.propTypes!=null)FZ(\"forwardRef render functions do not support propTypes or defaultProps. Did you accidentally pass a React component?\")}}var E={$$typeof:S,render:K};{var I;Object.defineProperty(E,\"displayName\",{enumerable:!1,configurable:!0,get:function(){return I},set:function(b){if(I=b,!K.name&&!K.displayName)K.displayName=b}})}return E}var h=Symbol.for(\"react.module.reference\");function s(K){if(typeof K===\"string\"||typeof K===\"function\")return!0;if(K===j||K===F||gZ||K===U||K===q||K===x||_0||K===GZ||r0||IZ||Q0)return!0;if(typeof K===\"object\"&&K!==null){if(K.$$typeof===l||K.$$typeof===k||K.$$typeof===A||K.$$typeof===C||K.$$typeof===S||K.$$typeof===h||K.getModuleId!==void 0)return!0}return!1}function BZ(K,E){if(!s(K))FZ(\"memo: The first argument must be a component. Instead received: %s\",K===null?\"null\":typeof K);var I={$$typeof:k,type:K,compare:E===void 0?null:E};{var b;Object.defineProperty(I,\"displayName\",{enumerable:!1,configurable:!0,get:function(){return b},set:function(u){if(b=u,!K.name&&!K.displayName)K.displayName=u}})}return I}function WZ(){var K=g.current;if(K===null)FZ(`Invalid hook call. Hooks can only be called inside of the body of a function component. This could happen for one of the following reasons:\n1. You might have mismatching versions of React and the renderer (such as React DOM)\n2. You might be breaking the Rules of Hooks\n3. You might have more than one copy of React in the same app\nSee https://reactjs.org/link/invalid-hook-call for tips about how to debug and fix this problem.`);return K}function mZ(K){var E=WZ();if(K._context!==void 0){var I=K._context;if(I.Consumer===K)FZ(\"Calling useContext(Context.Consumer) is not supported, may cause bugs, and will be removed in a future major release. Did you mean to call useContext(Context) instead?\");else if(I.Provider===K)FZ(\"Calling useContext(Context.Provider) is not supported. Did you mean to call useContext(Context) instead?\")}return E.useContext(K)}function CZ(K){var E=WZ();return E.useState(K)}function qZ(K,E,I){var b=WZ();return b.useReducer(K,E,I)}function lZ(K){var E=WZ();return E.useRef(K)}function U0(K,E){var I=WZ();return I.useEffect(K,E)}function O0(K,E){var I=WZ();return I.useInsertionEffect(K,E)}function e0(K,E){var I=WZ();return I.useLayoutEffect(K,E)}function c7(K,E){var I=WZ();return I.useCallback(K,E)}function q7(K,E){var I=WZ();return I.useMemo(K,E)}function c0(K,E,I){var b=WZ();return b.useImperativeHandle(K,E,I)}function h8(K,E){{var I=WZ();return I.useDebugValue(K,E)}}function _1(){var K=WZ();return K.useTransition()}function w7(K){var E=WZ();return E.useDeferredValue(K)}function xZ(){var K=WZ();return K.useId()}function N9(K,E,I){var b=WZ();return b.useSyncExternalStore(K,E,I)}var m8=0,O1,H1,j1,E1,N1,L1,D1;function U6(){}U6.__reactDisabledLog=!0;function bY(){{if(m8===0){O1=console.log,H1=console.info,j1=console.warn,E1=console.error,N1=console.group,L1=console.groupCollapsed,D1=console.groupEnd;var K={configurable:!0,enumerable:!0,value:U6,writable:!0};Object.defineProperties(console,{info:K,log:K,warn:K,error:K,group:K,groupCollapsed:K,groupEnd:K})}m8++}}function A1(){{if(m8--,m8===0){var K={configurable:!0,enumerable:!0,writable:!0};Object.defineProperties(console,{log:A4({},K,{value:O1}),info:A4({},K,{value:H1}),warn:A4({},K,{value:j1}),error:A4({},K,{value:E1}),group:A4({},K,{value:N1}),groupCollapsed:A4({},K,{value:L1}),groupEnd:A4({},K,{value:D1})})}if(m8<0)FZ(\"disabledDepth fell below zero. This is a bug in React. Please file an issue.\")}}var L9=yZ.ReactCurrentDispatcher,$7;function d8(K,E,I){{if($7===void 0)try{throw Error()}catch(u){var b=u.stack.trim().match(/\\n( *(at )?)/);$7=b&&b[1]||\"\"}return`\n`+$7+K}}var p8=!1,$X;{var F1=typeof WeakMap===\"function\"?WeakMap:Map;$X=new F1}function B6(K,E){if(!K||p8)return\"\";{var I=$X.get(K);if(I!==void 0)return I}var b;p8=!0;var u=Error.prepareStackTrace;Error.prepareStackTrace=void 0;var _Z;_Z=L9.current,L9.current=null,bY();try{if(E){var XZ=function(){throw Error()};if(Object.defineProperty(XZ.prototype,\"props\",{set:function(){throw Error()}}),typeof Reflect===\"object\"&&Reflect.construct){try{Reflect.construct(XZ,[])}catch(cZ){b=cZ}Reflect.construct(K,[],XZ)}else{try{XZ.call()}catch(cZ){b=cZ}K.call(XZ.prototype)}}else{try{throw Error()}catch(cZ){b=cZ}K()}}catch(cZ){if(cZ&&b&&typeof cZ.stack===\"string\"){var jZ=cZ.stack.split(`\n`),kZ=b.stack.split(`\n`),aZ=jZ.length-1,J0=kZ.length-1;while(aZ>=1&&J0>=0&&jZ[aZ]!==kZ[J0])J0--;for(;aZ>=1&&J0>=0;aZ--,J0--)if(jZ[aZ]!==kZ[J0]){if(aZ!==1||J0!==1)do if(aZ--,J0--,J0<0||jZ[aZ]!==kZ[J0]){var G0=`\n`+jZ[aZ].replace(\" at new \",\" at \");if(K.displayName&&G0.includes(\"\"))G0=G0.replace(\"\",K.displayName);if(typeof K===\"function\")$X.set(K,G0);return G0}while(aZ>=1&&J0>=0);break}}}finally{p8=!1,L9.current=_Z,A1(),Error.prepareStackTrace=u}var B0=K?K.displayName||K.name:\"\",D0=B0?d8(B0):\"\";if(typeof K===\"function\")$X.set(K,D0);return D0}function q1(K,E,I){return B6(K,!1)}function RY(K){var E=K.prototype;return!!(E&&E.isReactComponent)}function u8(K,E,I){if(K==null)return\"\";if(typeof K===\"function\")return B6(K,RY(K));if(typeof K===\"string\")return d8(K);switch(K){case q:return d8(\"Suspense\");case x:return d8(\"SuspenseList\")}if(typeof K===\"object\")switch(K.$$typeof){case S:return q1(K.render);case k:return u8(K.type,E,I);case l:{var b=K,u=b._payload,_Z=b._init;try{return u8(_Z(u),E,I)}catch(XZ){}}}return\"\"}var K6={},w1=yZ.ReactDebugCurrentFrame;function WX(K){if(K){var E=K._owner,I=u8(K.type,K._source,E?E.type:null);w1.setExtraStackFrame(I)}else w1.setExtraStackFrame(null)}function z6(K,E,I,b,u){{var _Z=Function.call.bind(G7);for(var XZ in K)if(_Z(K,XZ)){var jZ=void 0;try{if(typeof K[XZ]!==\"function\"){var kZ=Error((b||\"React class\")+\": \"+I+\" type `\"+XZ+\"` is invalid; it must be a function, usually from the `prop-types` package, but received `\"+typeof K[XZ]+\"`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.\");throw kZ.name=\"Invariant Violation\",kZ}jZ=K[XZ](E,XZ,b,I,null,\"SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED\")}catch(aZ){jZ=aZ}if(jZ&&!(jZ instanceof Error))WX(u),FZ(\"%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).\",b||\"React class\",I,XZ,typeof jZ),WX(null);if(jZ instanceof Error&&!(jZ.message in K6))K6[jZ.message]=!0,WX(u),FZ(\"Failed %s type: %s\",I,jZ.message),WX(null)}}}function hZ(K){if(K){var E=K._owner,I=u8(K.type,K._source,E?E.type:null);x0(I)}else x0(null)}var _6=!1;function T1(){if(MZ.current){var K=l0(MZ.current.type);if(K)return`\n\nCheck the render method of \\``+K+\"`.\"}return\"\"}function wZ(K){if(K!==void 0){var E=K.fileName.replace(/^.*[\\\\\\/]/,\"\"),I=K.lineNumber;return`\n\nCheck your code at `+E+\":\"+I+\".\"}return\"\"}function O6(K){if(K!==null&&K!==void 0)return wZ(K.__source);return\"\"}var H4={};function D9(K){var E=T1();if(!E){var I=typeof K===\"string\"?K:K.displayName||K.name;if(I)E=`\n\nCheck the top-level render call using <`+I+\">.\"}return E}function l8(K,E){if(!K._store||K._store.validated||K.key!=null)return;K._store.validated=!0;var I=D9(E);if(H4[I])return;H4[I]=!0;var b=\"\";if(K&&K._owner&&K._owner!==MZ.current)b=\" It was passed a child from \"+l0(K._owner.type)+\".\";hZ(K),FZ('Each child in a list should have a unique \"key\" prop.%s%s See https://reactjs.org/link/warning-keys for more information.',I,b),hZ(null)}function H6(K,E){if(typeof K!==\"object\")return;if(w0(K))for(var I=0;I\",u=\" Did you accidentally export a JSX literal instead of a component?\";else XZ=typeof K;FZ(\"React.createElement: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s\",XZ,u)}var jZ=p4.apply(this,arguments);if(jZ==null)return jZ;if(b)for(var kZ=2;kZ10)q0(\"Detected a large number of updates inside startTransition. If this is due to a subscription please re-write it to use React provided hooks. Otherwise concurrent mode guarantees are off the table.\");b._updatedFibers.clear()}}}var VX=!1,A9=null;function E6(K){if(A9===null)try{var E=(\"require\"+Math.random()).slice(0,7),I=CY&&CY[E];A9=I.call(CY,\"timers\").setImmediate}catch(b){A9=function(u){if(VX===!1){if(VX=!0,typeof MessageChannel===\"undefined\")FZ(\"This browser does not have a MessageChannel implementation, so enqueuing tasks via await act(async () => ...) will fail. Please file an issue at https://github.com/facebook/react/issues if you encounter this warning.\")}var _Z=new MessageChannel;_Z.port1.onmessage=u,_Z.port2.postMessage(void 0)}}return A9(K)}var c8=0,N6=!1;function L6(K){{var E=c8;if(c8++,i.current===null)i.current=[];var I=i.isBatchingLegacy,b;try{if(i.isBatchingLegacy=!0,b=K(),!I&&i.didScheduleLegacyUpdate){var u=i.current;if(u!==null)i.didScheduleLegacyUpdate=!1,BX(u)}}catch(B0){throw B8(E),B0}finally{i.isBatchingLegacy=I}if(b!==null&&typeof b===\"object\"&&typeof b.then===\"function\"){var _Z=b,XZ=!1,jZ={then:function(B0,D0){XZ=!0,_Z.then(function(cZ){if(B8(E),c8===0)UX(cZ,B0,D0);else B0(cZ)},function(cZ){B8(E),D0(cZ)})}};if(!N6&&typeof Promise!==\"undefined\")Promise.resolve().then(function(){}).then(function(){if(!XZ)N6=!0,FZ(\"You called act(async () => ...) without await. This could lead to unexpected testing behaviour, interleaving multiple act calls and mixing their scopes. You should - await act(async () => ...);\")});return jZ}else{var kZ=b;if(B8(E),c8===0){var aZ=i.current;if(aZ!==null)BX(aZ),i.current=null;var J0={then:function(B0,D0){if(i.current===null)i.current=[],UX(kZ,B0,D0);else B0(kZ)}};return J0}else{var G0={then:function(B0,D0){B0(kZ)}};return G0}}}}function B8(K){{if(K!==c8-1)FZ(\"You seem to have overlapping act() calls, this is not supported. Be sure to await previous act() calls before making a new one. \");c8=K}}function UX(K,E,I){{var b=i.current;if(b!==null)try{BX(b),E6(function(){if(b.length===0)i.current=null,E(K);else UX(K,E,I)})}catch(u){I(u)}else E(K)}}var i8=!1;function BX(K){if(!i8){i8=!0;var E=0;try{for(;E{(function(){if(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__!==\"undefined\"&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart===\"function\")__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(new Error);var B=!1,O=!1,H=5;function j(a,QZ){var AZ=a.length;a.push(QZ),A(a,QZ,AZ)}function U(a){return a.length===0?null:a[0]}function F(a){if(a.length===0)return null;var QZ=a[0],AZ=a.pop();if(AZ!==QZ)a[0]=AZ,C(a,AZ,0);return QZ}function A(a,QZ,AZ){var nZ=AZ;while(nZ>0){var X0=nZ-1>>>1,b0=a[X0];if(S(b0,QZ)>0)a[X0]=QZ,a[nZ]=b0,nZ=X0;else return}}function C(a,QZ,AZ){var nZ=AZ,X0=a.length,b0=X0>>>1;while(nZAZ&&(!a||G7()))break;var nZ=gZ.callback;if(typeof nZ===\"function\"){gZ.callback=null,yZ=gZ.priorityLevel;var X0=gZ.expirationTime<=AZ,b0=nZ(X0);if(AZ=fF.unstable_now(),typeof b0===\"function\")gZ.callback=b0;else if(gZ===U(IZ))F(IZ);P4(AZ)}else F(IZ);gZ=U(IZ)}if(gZ!==null)return!0;else{var V0=U(Q0);if(V0!==null)d7(K4,V0.startTime-AZ);return!1}}function E7(a,QZ){switch(a){case q:case x:case k:case l:case GZ:break;default:a=k}var AZ=yZ;yZ=a;try{return QZ()}finally{yZ=AZ}}function N7(a){var QZ;switch(yZ){case q:case x:case k:QZ=k;break;default:QZ=yZ;break}var AZ=yZ;yZ=QZ;try{return a()}finally{yZ=AZ}}function u0(a){var QZ=yZ;return function(){var AZ=yZ;yZ=QZ;try{return a.apply(this,arguments)}finally{yZ=AZ}}}function y4(a,QZ,AZ){var nZ=fF.unstable_now(),X0;if(typeof AZ===\"object\"&&AZ!==null){var b0=AZ.delay;if(typeof b0===\"number\"&&b0>0)X0=nZ+b0;else X0=nZ}else X0=nZ;var V0;switch(a){case q:V0=MZ;break;case x:V0=HZ;break;case GZ:V0=r0;break;case l:V0=x0;break;case k:default:V0=S0;break}var O4=X0+V0,RZ={id:_0++,callback:QZ,priorityLevel:a,startTime:X0,expirationTime:O4,sortIndex:-1};if(X0>nZ){if(RZ.sortIndex=X0,j(Q0,RZ),U(IZ)===null&&RZ===U(Q0)){if(C0)p7();else C0=!0;d7(K4,X0-nZ)}}else if(RZ.sortIndex=O4,j(IZ,RZ),!FZ&&!q0)FZ=!0,t0(Z7);return RZ}function z4(){}function X7(){if(!FZ&&!q0)FZ=!0,t0(Z7)}function w0(){return U(IZ)}function h4(a){a.callback=null}function J7(){return yZ}var k0=!1,j0=null,S4=-1,L7=H,l0=-1;function G7(){var a=fF.unstable_now()-l0;if(a125){console.error(\"forceFrameRate takes a positive int between 0 and 125, forcing frame rates higher than 125 fps is not supported\");return}if(a>0)L7=Math.floor(1000/a);else L7=H}var d4=function(){if(j0!==null){var a=fF.unstable_now();l0=a;var QZ=!0,AZ=!0;try{AZ=j0(QZ,a)}finally{if(AZ)v0();else k0=!1,j0=null}}else k0=!1},v0;if(typeof h7===\"function\")v0=function(){h7(d4)};else if(typeof MessageChannel!==\"undefined\"){var Y7=new MessageChannel,_4=Y7.port2;Y7.port1.onmessage=d4,v0=function(){_4.postMessage(null)}}else v0=function(){H7(d4,0)};function t0(a){if(j0=a,!k0)k0=!0,v0()}function d7(a,QZ){S4=H7(function(){a(fF.unstable_now())},QZ)}function p7(){j7(S4),S4=-1}var D7=R8,p4=null;if(fF.unstable_IdlePriority=GZ,fF.unstable_ImmediatePriority=q,fF.unstable_LowPriority=l,fF.unstable_NormalPriority=k,fF.unstable_Profiling=p4,fF.unstable_UserBlockingPriority=x,fF.unstable_cancelCallback=h4,fF.unstable_continueExecution=X7,fF.unstable_forceFrameRate=m4,fF.unstable_getCurrentPriorityLevel=J7,fF.unstable_getFirstCallbackNode=w0,fF.unstable_next=N7,fF.unstable_pauseExecution=z4,fF.unstable_requestPaint=D7,fF.unstable_runWithPriority=E7,fF.unstable_scheduleCallback=y4,fF.unstable_shouldYield=G7,fF.unstable_wrapCallback=u0,typeof __REACT_DEVTOOLS_GLOBAL_HOOK__!==\"undefined\"&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop===\"function\")__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(new Error)})()});var Dz=Y1((gF)=>{var Y6=W0(B4(),1),Z0=W0(Lz(),1);(function(){if(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__!==\"undefined\"&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart===\"function\")__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(new Error);var B=Y6.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,O=!1;function H(Z){O=Z}function j(Z){if(!O){for(var X=arguments.length,J=new Array(X>1?X-1:0),G=1;G1?X-1:0),G=1;G2&&(Z[0]===\"o\"||Z[0]===\"O\")&&(Z[1]===\"n\"||Z[1]===\"N\"))return!0;return!1}function b0(Z,X,J,G){if(J!==null&&J.type===d4)return!1;switch(typeof X){case\"function\":case\"symbol\":return!0;case\"boolean\":{if(G)return!1;if(J!==null)return!J.acceptsBooleans;else{var Y=Z.toLowerCase().slice(0,5);return Y!==\"data-\"&&Y!==\"aria-\"}}default:return!1}}function V0(Z,X,J,G){if(X===null||typeof X===\"undefined\")return!0;if(b0(Z,X,J,G))return!0;if(G)return!1;if(J!==null)switch(J.type){case _4:return!X;case t0:return X===!1;case d7:return isNaN(X);case p7:return isNaN(X)||X<1}return!1}function O4(Z){return uZ.hasOwnProperty(Z)?uZ[Z]:null}function RZ(Z,X,J,G,Y,Q,$){this.acceptsBooleans=X===Y7||X===_4||X===t0,this.attributeName=G,this.attributeNamespace=Y,this.mustUseProperty=J,this.propertyName=Z,this.type=X,this.sanitizeURL=Q,this.removeEmptyString=$}var uZ={},U8=[\"children\",\"dangerouslySetInnerHTML\",\"defaultValue\",\"defaultChecked\",\"innerHTML\",\"suppressContentEditableWarning\",\"suppressHydrationWarning\",\"style\"];U8.forEach(function(Z){uZ[Z]=new RZ(Z,d4,!1,Z,null,!1,!1)}),[[\"acceptCharset\",\"accept-charset\"],[\"className\",\"class\"],[\"htmlFor\",\"for\"],[\"httpEquiv\",\"http-equiv\"]].forEach(function(Z){var X=Z[0],J=Z[1];uZ[X]=new RZ(X,v0,!1,J,null,!1,!1)}),[\"contentEditable\",\"draggable\",\"spellCheck\",\"value\"].forEach(function(Z){uZ[Z]=new RZ(Z,Y7,!1,Z.toLowerCase(),null,!1,!1)}),[\"autoReverse\",\"externalResourcesRequired\",\"focusable\",\"preserveAlpha\"].forEach(function(Z){uZ[Z]=new RZ(Z,Y7,!1,Z,null,!1,!1)}),[\"allowFullScreen\",\"async\",\"autoFocus\",\"autoPlay\",\"controls\",\"default\",\"defer\",\"disabled\",\"disablePictureInPicture\",\"disableRemotePlayback\",\"formNoValidate\",\"hidden\",\"loop\",\"noModule\",\"noValidate\",\"open\",\"playsInline\",\"readOnly\",\"required\",\"reversed\",\"scoped\",\"seamless\",\"itemScope\"].forEach(function(Z){uZ[Z]=new RZ(Z,_4,!1,Z.toLowerCase(),null,!1,!1)}),[\"checked\",\"multiple\",\"muted\",\"selected\"].forEach(function(Z){uZ[Z]=new RZ(Z,_4,!0,Z,null,!1,!1)}),[\"capture\",\"download\"].forEach(function(Z){uZ[Z]=new RZ(Z,t0,!1,Z,null,!1,!1)}),[\"cols\",\"rows\",\"size\",\"span\"].forEach(function(Z){uZ[Z]=new RZ(Z,p7,!1,Z,null,!1,!1)}),[\"rowSpan\",\"start\"].forEach(function(Z){uZ[Z]=new RZ(Z,d7,!1,Z.toLowerCase(),null,!1,!1)});var Q7=/[\\-\\:]([a-z])/g,f8=function(Z){return Z[1].toUpperCase()};[\"accent-height\",\"alignment-baseline\",\"arabic-form\",\"baseline-shift\",\"cap-height\",\"clip-path\",\"clip-rule\",\"color-interpolation\",\"color-interpolation-filters\",\"color-profile\",\"color-rendering\",\"dominant-baseline\",\"enable-background\",\"fill-opacity\",\"fill-rule\",\"flood-color\",\"flood-opacity\",\"font-family\",\"font-size\",\"font-size-adjust\",\"font-stretch\",\"font-style\",\"font-variant\",\"font-weight\",\"glyph-name\",\"glyph-orientation-horizontal\",\"glyph-orientation-vertical\",\"horiz-adv-x\",\"horiz-origin-x\",\"image-rendering\",\"letter-spacing\",\"lighting-color\",\"marker-end\",\"marker-mid\",\"marker-start\",\"overline-position\",\"overline-thickness\",\"paint-order\",\"panose-1\",\"pointer-events\",\"rendering-intent\",\"shape-rendering\",\"stop-color\",\"stop-opacity\",\"strikethrough-position\",\"strikethrough-thickness\",\"stroke-dasharray\",\"stroke-dashoffset\",\"stroke-linecap\",\"stroke-linejoin\",\"stroke-miterlimit\",\"stroke-opacity\",\"stroke-width\",\"text-anchor\",\"text-decoration\",\"text-rendering\",\"underline-position\",\"underline-thickness\",\"unicode-bidi\",\"unicode-range\",\"units-per-em\",\"v-alphabetic\",\"v-hanging\",\"v-ideographic\",\"v-mathematical\",\"vector-effect\",\"vert-adv-y\",\"vert-origin-x\",\"vert-origin-y\",\"word-spacing\",\"writing-mode\",\"xmlns:xlink\",\"x-height\"].forEach(function(Z){var X=Z.replace(Q7,f8);uZ[X]=new RZ(X,v0,!1,Z,null,!1,!1)}),[\"xlink:actuate\",\"xlink:arcrole\",\"xlink:role\",\"xlink:show\",\"xlink:title\",\"xlink:type\"].forEach(function(Z){var X=Z.replace(Q7,f8);uZ[X]=new RZ(X,v0,!1,Z,\"http://www.w3.org/1999/xlink\",!1,!1)}),[\"xml:base\",\"xml:lang\",\"xml:space\"].forEach(function(Z){var X=Z.replace(Q7,f8);uZ[X]=new RZ(X,v0,!1,Z,\"http://www.w3.org/XML/1998/namespace\",!1,!1)}),[\"tabIndex\",\"crossOrigin\"].forEach(function(Z){uZ[Z]=new RZ(Z,v0,!1,Z.toLowerCase(),null,!1,!1)});var z1=\"xlinkHref\";uZ[z1]=new RZ(\"xlinkHref\",v0,!1,\"xlink:href\",\"http://www.w3.org/1999/xlink\",!0,!1),[\"src\",\"href\",\"action\",\"formAction\"].forEach(function(Z){uZ[Z]=new RZ(Z,v0,!1,Z.toLowerCase(),null,!0,!0)});var YX=/^[\\u0000-\\u001F ]*j[\\r\\n\\t]*a[\\r\\n\\t]*v[\\r\\n\\t]*a[\\r\\n\\t]*s[\\r\\n\\t]*c[\\r\\n\\t]*r[\\r\\n\\t]*i[\\r\\n\\t]*p[\\r\\n\\t]*t[\\r\\n\\t]*\\:/i,QX=!1;function E9(Z){if(!QX&&YX.test(Z))QX=!0,U(\"A future version of React will block javascript: URLs as a security precaution. Use event handlers instead if you can. If you need to generate unsafe HTML try using dangerouslySetInnerHTML instead. React was passed %s.\",JSON.stringify(Z))}function u7(Z,X,J,G){if(G.mustUseProperty){var Y=G.propertyName;return Z[Y]}else{if(S4(J,X),G.sanitizeURL)E9(\"\"+J);var Q=G.attributeName,$=null;if(G.type===t0){if(Z.hasAttribute(Q)){var W=Z.getAttribute(Q);if(W===\"\")return!0;if(V0(X,J,G,!1))return W;if(W===\"\"+J)return J;return W}}else if(Z.hasAttribute(Q)){if(V0(X,J,G,!1))return Z.getAttribute(Q);if(G.type===_4)return J;$=Z.getAttribute(Q)}if(V0(X,J,G,!1))return $===null?J:$;else if($===\"\"+J)return J;else return $}}function g8(Z,X,J,G){{if(!nZ(X))return;if(!Z.hasAttribute(X))return J===void 0?void 0:null;var Y=Z.getAttribute(X);if(S4(J,X),Y===\"\"+J)return J;return Y}}function y8(Z,X,J,G){var Y=O4(X);if(X0(X,Y,G))return;if(V0(X,J,Y,G))J=null;if(G||Y===null){if(nZ(X)){var Q=X;if(J===null)Z.removeAttribute(Q);else S4(J,X),Z.setAttribute(Q,\"\"+J)}return}var $=Y.mustUseProperty;if($){var W=Y.propertyName;if(J===null){var V=Y.type;Z[W]=V===_4?!1:\"\"}else Z[W]=J;return}var{attributeName:z,attributeNamespace:_}=Y;if(J===null)Z.removeAttribute(z);else{var D=Y.type,L;if(D===_4||D===t0&&J===!0)L=\"\";else if(S4(J,z),L=\"\"+J,Y.sanitizeURL)E9(L.toString());if(_)Z.setAttributeNS(_,z,L);else Z.setAttribute(z,L)}}var A7=Symbol.for(\"react.element\"),F7=Symbol.for(\"react.portal\"),l7=Symbol.for(\"react.fragment\"),N=Symbol.for(\"react.strict_mode\"),h=Symbol.for(\"react.profiler\"),s=Symbol.for(\"react.provider\"),BZ=Symbol.for(\"react.context\"),WZ=Symbol.for(\"react.forward_ref\"),mZ=Symbol.for(\"react.suspense\"),CZ=Symbol.for(\"react.suspense_list\"),qZ=Symbol.for(\"react.memo\"),lZ=Symbol.for(\"react.lazy\"),U0=Symbol.for(\"react.scope\"),O0=Symbol.for(\"react.debug_trace_mode\"),e0=Symbol.for(\"react.offscreen\"),c7=Symbol.for(\"react.legacy_hidden\"),q7=Symbol.for(\"react.cache\"),c0=Symbol.for(\"react.tracing_marker\"),h8=Symbol.iterator,_1=\"@@iterator\";function w7(Z){if(Z===null||typeof Z!==\"object\")return null;var X=h8&&Z[h8]||Z[_1];if(typeof X===\"function\")return X;return null}var xZ=Object.assign,N9=0,m8,O1,H1,j1,E1,N1,L1;function D1(){}D1.__reactDisabledLog=!0;function U6(){{if(N9===0){m8=console.log,O1=console.info,H1=console.warn,j1=console.error,E1=console.group,N1=console.groupCollapsed,L1=console.groupEnd;var Z={configurable:!0,enumerable:!0,value:D1,writable:!0};Object.defineProperties(console,{info:Z,log:Z,warn:Z,error:Z,group:Z,groupCollapsed:Z,groupEnd:Z})}N9++}}function bY(){{if(N9--,N9===0){var Z={configurable:!0,enumerable:!0,writable:!0};Object.defineProperties(console,{log:xZ({},Z,{value:m8}),info:xZ({},Z,{value:O1}),warn:xZ({},Z,{value:H1}),error:xZ({},Z,{value:j1}),group:xZ({},Z,{value:E1}),groupCollapsed:xZ({},Z,{value:N1}),groupEnd:xZ({},Z,{value:L1})})}if(N9<0)U(\"disabledDepth fell below zero. This is a bug in React. Please file an issue.\")}}var A1=B.ReactCurrentDispatcher,L9;function $7(Z,X,J){{if(L9===void 0)try{throw Error()}catch(Y){var G=Y.stack.trim().match(/\\n( *(at )?)/);L9=G&&G[1]||\"\"}return`\n`+L9+Z}}var d8=!1,p8;{var $X=typeof WeakMap===\"function\"?WeakMap:Map;p8=new $X}function F1(Z,X){if(!Z||d8)return\"\";{var J=p8.get(Z);if(J!==void 0)return J}var G;d8=!0;var Y=Error.prepareStackTrace;Error.prepareStackTrace=void 0;var Q;Q=A1.current,A1.current=null,U6();try{if(X){var $=function(){throw Error()};if(Object.defineProperty($.prototype,\"props\",{set:function(){throw Error()}}),typeof Reflect===\"object\"&&Reflect.construct){try{Reflect.construct($,[])}catch(P){G=P}Reflect.construct(Z,[],$)}else{try{$.call()}catch(P){G=P}Z.call($.prototype)}}else{try{throw Error()}catch(P){G=P}Z()}}catch(P){if(P&&G&&typeof P.stack===\"string\"){var W=P.stack.split(`\n`),V=G.stack.split(`\n`),z=W.length-1,_=V.length-1;while(z>=1&&_>=0&&W[z]!==V[_])_--;for(;z>=1&&_>=0;z--,_--)if(W[z]!==V[_]){if(z!==1||_!==1)do if(z--,_--,_<0||W[z]!==V[_]){var D=`\n`+W[z].replace(\" at new \",\" at \");if(Z.displayName&&D.includes(\"\"))D=D.replace(\"\",Z.displayName);if(typeof Z===\"function\")p8.set(Z,D);return D}while(z>=1&&_>=0);break}}}finally{d8=!1,A1.current=Q,bY(),Error.prepareStackTrace=Y}var L=Z?Z.displayName||Z.name:\"\",M=L?$7(L):\"\";if(typeof Z===\"function\")p8.set(Z,M);return M}function B6(Z,X,J){return F1(Z,!0)}function q1(Z,X,J){return F1(Z,!1)}function RY(Z){var X=Z.prototype;return!!(X&&X.isReactComponent)}function u8(Z,X,J){if(Z==null)return\"\";if(typeof Z===\"function\")return F1(Z,RY(Z));if(typeof Z===\"string\")return $7(Z);switch(Z){case mZ:return $7(\"Suspense\");case CZ:return $7(\"SuspenseList\")}if(typeof Z===\"object\")switch(Z.$$typeof){case WZ:return q1(Z.render);case qZ:return u8(Z.type,X,J);case lZ:{var G=Z,Y=G._payload,Q=G._init;try{return u8(Q(Y),X,J)}catch($){}}}return\"\"}function K6(Z){var X=Z._debugOwner?Z._debugOwner.type:null,J=Z._debugSource;switch(Z.tag){case k:return $7(Z.type);case S0:return $7(\"Lazy\");case i:return $7(\"Suspense\");case IZ:return $7(\"SuspenseList\");case A:case S:case HZ:return q1(Z.type);case g:return q1(Z.type.render);case C:return B6(Z.type);default:return\"\"}}function w1(Z){try{var X=\"\",J=Z;do X+=K6(J),J=J.return;while(J);return X}catch(G){return`\nError generating stack: `+G.message+`\n`+G.stack}}function WX(Z,X,J){var G=Z.displayName;if(G)return G;var Y=X.displayName||X.name||\"\";return Y!==\"\"?J+\"(\"+Y+\")\":J}function z6(Z){return Z.displayName||\"Context\"}function hZ(Z){if(Z==null)return null;if(typeof Z.tag===\"number\")U(\"Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue.\");if(typeof Z===\"function\")return Z.displayName||Z.name||null;if(typeof Z===\"string\")return Z;switch(Z){case l7:return\"Fragment\";case F7:return\"Portal\";case h:return\"Profiler\";case N:return\"StrictMode\";case mZ:return\"Suspense\";case CZ:return\"SuspenseList\"}if(typeof Z===\"object\")switch(Z.$$typeof){case BZ:var X=Z;return z6(X)+\".Consumer\";case s:var J=Z;return z6(J._context)+\".Provider\";case WZ:return WX(Z,Z.render,\"ForwardRef\");case qZ:var G=Z.displayName||null;if(G!==null)return G;return hZ(Z.type)||\"Memo\";case lZ:{var Y=Z,Q=Y._payload,$=Y._init;try{return hZ($(Q))}catch(W){return null}}}return null}function _6(Z,X,J){var G=X.displayName||X.name||\"\";return Z.displayName||(G!==\"\"?J+\"(\"+G+\")\":J)}function T1(Z){return Z.displayName||\"Context\"}function wZ(Z){var{tag:X,type:J}=Z;switch(X){case yZ:return\"Cache\";case DZ:var G=J;return T1(G)+\".Consumer\";case d:var Y=J;return T1(Y._context)+\".Provider\";case r0:return\"DehydratedFragment\";case g:return _6(J,J.render,\"ForwardRef\");case GZ:return\"Fragment\";case k:return J;case x:return\"Portal\";case q:return\"Root\";case l:return\"Text\";case S0:return hZ(J);case zZ:if(J===N)return\"StrictMode\";return\"Mode\";case _0:return\"Offscreen\";case p:return\"Profiler\";case Q0:return\"Scope\";case i:return\"Suspense\";case IZ:return\"SuspenseList\";case q0:return\"TracingMarker\";case C:case A:case x0:case S:case MZ:case HZ:if(typeof J===\"function\")return J.displayName||J.name||null;if(typeof J===\"string\")return J;break}return null}var O6=B.ReactDebugCurrentFrame,H4=null,D9=!1;function l8(){{if(H4===null)return null;var Z=H4._debugOwner;if(Z!==null&&typeof Z!==\"undefined\")return wZ(Z)}return null}function H6(){{if(H4===null)return\"\";return w1(H4)}}function i0(){O6.getCurrentStack=null,H4=null,D9=!1}function E0(Z){O6.getCurrentStack=Z===null?null:H6,H4=Z,D9=!1}function j6(){return H4}function u4(Z){D9=Z}function x4(Z){return\"\"+Z}function i7(Z){switch(typeof Z){case\"boolean\":case\"number\":case\"string\":case\"undefined\":return Z;case\"object\":return m4(Z),Z;default:return\"\"}}var fY={button:!0,checkbox:!0,image:!0,hidden:!0,radio:!0,reset:!0,submit:!0};function VX(Z,X){{if(!(fY[X.type]||X.onChange||X.onInput||X.readOnly||X.disabled||X.value==null))U(\"You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.\");if(!(X.onChange||X.readOnly||X.disabled||X.checked==null))U(\"You provided a `checked` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultChecked`. Otherwise, set either `onChange` or `readOnly`.\")}}function A9(Z){var{type:X,nodeName:J}=Z;return J&&J.toLowerCase()===\"input\"&&(X===\"checkbox\"||X===\"radio\")}function E6(Z){return Z._valueTracker}function c8(Z){Z._valueTracker=null}function N6(Z){var X=\"\";if(!Z)return X;if(A9(Z))X=Z.checked?\"true\":\"false\";else X=Z.value;return X}function L6(Z){var X=A9(Z)?\"checked\":\"value\",J=Object.getOwnPropertyDescriptor(Z.constructor.prototype,X);m4(Z[X]);var G=\"\"+Z[X];if(Z.hasOwnProperty(X)||typeof J===\"undefined\"||typeof J.get!==\"function\"||typeof J.set!==\"function\")return;var{get:Y,set:Q}=J;Object.defineProperty(Z,X,{configurable:!0,get:function(){return Y.call(this)},set:function(W){m4(W),G=\"\"+W,Q.call(this,W)}}),Object.defineProperty(Z,X,{enumerable:J.enumerable});var $={getValue:function(){return G},setValue:function(W){m4(W),G=\"\"+W},stopTracking:function(){c8(Z),delete Z[X]}};return $}function B8(Z){if(E6(Z))return;Z._valueTracker=L6(Z)}function UX(Z){if(!Z)return!1;var X=E6(Z);if(!X)return!0;var J=X.getValue(),G=N6(Z);if(G!==J)return X.setValue(G),!0;return!1}function i8(Z){if(Z=Z||(typeof document!==\"undefined\"?document:void 0),typeof Z===\"undefined\")return null;try{return Z.activeElement||Z.body}catch(X){return Z.body}}var BX=!1,D6=!1,A6=!1,F6=!1;function q6(Z){var X=Z.type===\"checkbox\"||Z.type===\"radio\";return X?Z.checked!=null:Z.value!=null}function K(Z,X){var J=Z,G=X.checked,Y=xZ({},X,{defaultChecked:void 0,defaultValue:void 0,value:void 0,checked:G!=null?G:J._wrapperState.initialChecked});return Y}function E(Z,X){{if(VX(\"input\",X),X.checked!==void 0&&X.defaultChecked!==void 0&&!D6)U(\"%s contains an input of type %s with both checked and defaultChecked props. Input elements must be either controlled or uncontrolled (specify either the checked prop, or the defaultChecked prop, but not both). Decide between using a controlled or uncontrolled input element and remove one of these props. More info: https://reactjs.org/link/controlled-components\",l8()||\"A component\",X.type),D6=!0;if(X.value!==void 0&&X.defaultValue!==void 0&&!BX)U(\"%s contains an input of type %s with both value and defaultValue props. Input elements must be either controlled or uncontrolled (specify either the value prop, or the defaultValue prop, but not both). Decide between using a controlled or uncontrolled input element and remove one of these props. More info: https://reactjs.org/link/controlled-components\",l8()||\"A component\",X.type),BX=!0}var J=Z,G=X.defaultValue==null?\"\":X.defaultValue;J._wrapperState={initialChecked:X.checked!=null?X.checked:X.defaultChecked,initialValue:i7(X.value!=null?X.value:G),controlled:q6(X)}}function I(Z,X){var J=Z,G=X.checked;if(G!=null)y8(J,\"checked\",G,!1)}function b(Z,X){var J=Z;{var G=q6(X);if(!J._wrapperState.controlled&&G&&!F6)U(\"A component is changing an uncontrolled input to be controlled. This is likely caused by the value changing from undefined to a defined value, which should not happen. Decide between using a controlled or uncontrolled input element for the lifetime of the component. More info: https://reactjs.org/link/controlled-components\"),F6=!0;if(J._wrapperState.controlled&&!G&&!A6)U(\"A component is changing a controlled input to be uncontrolled. This is likely caused by the value changing from a defined to undefined, which should not happen. Decide between using a controlled or uncontrolled input element for the lifetime of the component. More info: https://reactjs.org/link/controlled-components\"),A6=!0}I(Z,X);var Y=i7(X.value),Q=X.type;if(Y!=null){if(Q===\"number\"){if(Y===0&&J.value===\"\"||J.value!=Y)J.value=x4(Y)}else if(J.value!==x4(Y))J.value=x4(Y)}else if(Q===\"submit\"||Q===\"reset\"){J.removeAttribute(\"value\");return}if(X.hasOwnProperty(\"value\"))jZ(J,X.type,Y);else if(X.hasOwnProperty(\"defaultValue\"))jZ(J,X.type,i7(X.defaultValue));if(X.checked==null&&X.defaultChecked!=null)J.defaultChecked=!!X.defaultChecked}function u(Z,X,J){var G=Z;if(X.hasOwnProperty(\"value\")||X.hasOwnProperty(\"defaultValue\")){var Y=X.type,Q=Y===\"submit\"||Y===\"reset\";if(Q&&(X.value===void 0||X.value===null))return;var $=x4(G._wrapperState.initialValue);if(!J){if($!==G.value)G.value=$}G.defaultValue=$}var W=G.name;if(W!==\"\")G.name=\"\";if(G.defaultChecked=!G.defaultChecked,G.defaultChecked=!!G._wrapperState.initialChecked,W!==\"\")G.name=W}function _Z(Z,X){var J=Z;b(J,X),XZ(J,X)}function XZ(Z,X){var J=X.name;if(X.type===\"radio\"&&J!=null){var G=Z;while(G.parentNode)G=G.parentNode;S4(J,\"name\");var Y=G.querySelectorAll(\"input[name=\"+JSON.stringify(\"\"+J)+'][type=\"radio\"]');for(var Q=0;Q.\")});else if(X.dangerouslySetInnerHTML!=null){if(!J0)J0=!0,U(\"Pass a `value` prop if you set dangerouslyInnerHTML so React knows which value should be selected.\")}}if(X.selected!=null&&!kZ)U(\"Use the `defaultValue` or `value` props on must be a scalar value if `multiple` is false.%s\",J,KX())}}}function K8(Z,X,J,G){var Y=Z.options;if(X){var Q=J,$={};for(var W=0;W.\");var G=xZ({},X,{value:void 0,defaultValue:void 0,children:x4(J._wrapperState.initialValue)});return G}function BW(Z,X){var J=Z;if(VX(\"textarea\",X),X.value!==void 0&&X.defaultValue!==void 0&&!UW)U(\"%s contains a textarea with both value and defaultValue props. Textarea elements must be either controlled or uncontrolled (specify either the value prop, or the defaultValue prop, but not both). Decide between using a controlled or uncontrolled textarea and remove one of these props. More info: https://reactjs.org/link/controlled-components\",l8()||\"A component\"),UW=!0;var G=X.value;if(G==null){var{children:Y,defaultValue:Q}=X;if(Y!=null){U(\"Use the `defaultValue` or `value` props instead of setting children on \n\n \n \n
\n
\n \n\n
\n
\n
\n \n \n\n \n \n\n \n \n
\n
\n
\n\n
\n
\n
\n \n \n\n \n \n\n \n \n
\n
\n
\n \n \n \n\n
\n
\n
\n

功能操作

\n ▼\n
\n
\n
\n \n \n \n \n \n \n
\n
\n
\n\n
\n
\n

工具链接

\n ▼\n
\n
\n
\n \n
\n description\n
\n
\n
接口文档
\n
查看 API 接口文档
\n
\n \n \n
\n swap_horiz\n
\n
\n
m3u转换
\n
转换 m3u 播放列表格式
\n
\n \n \n
\n cloud_download\n
\n
\n
歌曲下载工具
\n
在线搜索并下载歌曲
\n
\n \n \n
\n merge_type\n
\n
\n
歌单合并工具
\n
合并多个歌单文件
\n
\n \n
\n
\n
\n\n
\n

社区支持

\n
\n
\n \n \n \n \n \n \n
\n
\n \"请涵曦喝奶茶🧋\"\n
\n
\n
\n
\n \n\n\n\n" }, { "path": "xiaomusic/static/default/setting.js", "content": "// 获取二维码的函数（点击「获取二维码」后再请求并显示）\nlet qrcodeCountdownTimer = null;\nconst DEFAULT_QRCODE_EXPIRE_SECONDS = 120;\n\nfunction stopQRCodeCountdown() {\n if (qrcodeCountdownTimer) {\n clearInterval(qrcodeCountdownTimer);\n qrcodeCountdownTimer = null;\n }\n}\n\nfunction startQRCodeCountdown($qrcodeStatus, $qrcodeImage, expireSeconds) {\n stopQRCodeCountdown();\n\n let remainSeconds = Number(expireSeconds);\n if (!Number.isFinite(remainSeconds) || remainSeconds <= 0) {\n remainSeconds = DEFAULT_QRCODE_EXPIRE_SECONDS;\n }\n remainSeconds = Math.floor(remainSeconds);\n\n const updateCountdownText = function () {\n if (remainSeconds <= 0) {\n stopQRCodeCountdown();\n $qrcodeImage.addClass(\"qrcode-image-hidden\");\n $qrcodeStatus.text(\"二维码已过期，请点击“刷新二维码”重新获取\");\n return;\n }\n $qrcodeStatus.text(\n \"请使用米家App扫码登录，二维码将在 \" + remainSeconds + \" 秒后过期\"\n );\n remainSeconds -= 1;\n };\n\n updateCountdownText();\n qrcodeCountdownTimer = setInterval(updateCountdownText, 1000);\n}\n\nfunction fetchQRCode() {\n var $qrcodeImage = $(\"#qrcode-image\");\n var $qrcodeStatus = $(\"#qrcode-status\");\n var $refreshBtn = $(\"#refresh-qrcode\");\n\n if (!$qrcodeImage.length || !$qrcodeStatus.length) return;\n stopQRCodeCountdown();\n\n $qrcodeImage.attr(\"src\", \"\");\n $qrcodeStatus.text(\"正在生成二维码...\");\n $refreshBtn.text(\"刷新二维码\");\n\n $.get(\"/api/get_qrcode\")\n .done(function (data) {\n if (data.success) {\n if (data.already_logged_in) {\n $qrcodeStatus.text(data.message || \"已登录，无需更新\");\n $qrcodeImage.addClass(\"qrcode-image-hidden\");\n } else {\n $qrcodeImage.attr(\"src\", data.qrcode_url || \"\").removeClass(\"qrcode-image-hidden\");\n startQRCodeCountdown($qrcodeStatus, $qrcodeImage, data.expire_seconds);\n }\n } else {\n $qrcodeStatus.text(data.message || \"二维码生成失败，请稍后重试\");\n }\n })\n .fail(function (xhr) {\n console.error(\"获取二维码失败:\", xhr);\n $qrcodeStatus.text(\"网络错误，请检查连接\");\n });\n}\n\n// ============ 字体加载检测 ============\n// 检测字体加载完成，避免图标文字闪烁\n(function () {\n // 使用 Promise.race 实现超时保护\n const fontLoadTimeout = new Promise(resolve => {\n setTimeout(() => {\n console.warn('字体加载超时，强制显示图标');\n resolve('timeout');\n }, 3000);\n });\n\n const fontLoadReady = document.fonts.ready.then(() => 'loaded');\n\n Promise.race([fontLoadReady, fontLoadTimeout]).then((result) => {\n document.body.classList.add('fonts-loaded');\n if (result === 'loaded') {\n console.log('Material Icons 字体加载完成');\n }\n }).catch((error) => {\n console.error('字体加载检测失败:', error);\n // 出错时也显示图标，避免永久隐藏\n document.body.classList.add('fonts-loaded');\n });\n})();\n\n$(function () {\n $(\"#refresh-qrcode\").on(\"click\", fetchQRCode);\n\n // 拉取版本\n $.get(\"/getversion\", function (data, status) {\n console.log(data, status, data[\"version\"]);\n $(\"#version\").text(`${data.version}`);\n });\n\n // 遍历所有的select元素，默认选中只有1个选项的\n const autoSelectOne = () => {\n $(\"select\").each(function () {\n // 如果select元素仅有一个option子元素\n if ($(this).children(\"option\").length === 1) {\n // 选中这个option\n $(this).find(\"option\").prop(\"selected\", true);\n }\n });\n };\n\n function updateCheckbox(selector, mi_did, device_list, accountPassValid) {\n // 清除现有的内容\n $(selector).empty();\n\n // 将 mi_did 字符串通过逗号分割转换为数组，以便于判断默认选中项\n var selected_dids = mi_did.split(\",\");\n\n //如果device_list为空，则可能是未设置小米账号密码或者已设置密码，但是没有过小米验证，此处需要提示用户\n if (device_list.length == 0) {\n const loginTips = accountPassValid\n ? `
未发现可用的小爱设备，请检查账号密码是否输错，并关闭加速代理或在小米官网登陆过人脸或滑块验证。如仍未解决。请根据FAQ的内容解决问题。
`\n : `
未发现可用的小爱设备，请先在下面的输入框中设置小米的账号、密码或者cookie
`;\n $(selector).append(loginTips);\n return;\n }\n $.each(device_list, function (index, device) {\n var did = device.miotDID;\n var hardware = device.hardware;\n var name = device.name;\n // 创建复选框元素\n var checkbox = $(\"\", {\n type: \"checkbox\",\n id: did,\n value: `${did}`,\n class: \"custom-checkbox\", // 添加样式类\n // 如果mi_did中包含了该did，则默认选中\n checked: selected_dids.indexOf(did) !== -1,\n });\n\n // 创建标签元素\n var label = $(\"