Archived
snowy-yang
095171e0b7
为什么：podcast_api.py(560 行) 与 qr_login.py(397 行) 既不属于任何包、也不是 入口脚本，却同时被 services 层与 web 层引用——`services/downloads.py` 直接 `from qr_login import ...`、`services/podcast.py` 直接 `import podcast_api`， 业务层反向依赖顶层游离模块，是本次架构体检里唯一的无争议分层倒置。 两者本就依赖 music_api（前者取 url_v1/APIConstants/APIException，后者取 QRLoginManager），与 music_api 下已有的 qr.py / compat.py 是同一层的同类物。 迁移（git 保留重命名历史）： - podcast_api.py -> music_api/podcast.py - qr_login.py -> music_api/qr_client.py **命名避让**：不叫 music_api/qr_login.py——music_api/__init__ 已经从 .compat 导出了一个**同名函数** qr_login，同名子模块会与之互相遮蔽。改叫 qr_client （其核心导出即 QRLoginClient），并在验证里专门确认 music_api.qr_login 仍是 可调用函数、music_api.podcast 是模块，两者不冲突。 内部导入顺带改为精确子模块，不再绕道包门面： - podcast.py：from music_api import APIConstants/APIException/url_v1 → from .compat import url_v1 / from .constants import ... / from .errors import ... - qr_client.py：删掉那层 try/except ImportError 包装（它给的是「请确保 music_api.py 文件存在」这类顶层脚本时代的提示，作为包内模块已无意义）， 改 from .cookies/.errors/.qr 相对导入 - CLI 用法文本 python qr_login.py → python -m music_api.qr_client （相对导入后直接跑脚本会失败，必须走 -m；全仓确认无脚本/文档引用旧入口） - 路径安全性已核对：qr_client 用的是 CWD 相对的 cookie.txt，不是 __file__ 相对， 迁移不改其解析结果 引用点全部更新（AST 扫描确认覆盖全集，替换后残留 0）： - podcast：services/podcast.py(1 + 5 处调用) · web/routers/podcast.py(1 + 6) · web/routers/download.py(2 处函数内 + 3)，导入名统一为 `podcast` - qr_login：services/downloads.py · web/routers/admin.py · web/routers/user.py(×2) - services/__init__.py 依赖自检列表去掉这两个名字（已并入 music_api） - pyproject include 去掉两个顶层文件名（music_api 目录已覆盖） 验证： - 11 + 3 个符号在新位置全部 hasattr 通过；podcast_api / qr_login 已 ModuleNotFoundError；6 个调用方模块均可 import；services 依赖自检仍生效 - 门禁：ruff 0 · pyright 0 errors/0 warnings · pytest 184 passed - 真实 uvicorn 冒烟 10/10，含 /podcast/parse 与 /podcast/hot 返回 401 （模块导入失败会是 500，路由缺失会是 404，401 证明两者都正常） - 生产 data/ 指纹 before == after
95 lines
4.2 KiB
Python
95 lines
4.2 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""重新生成部署包——在主项目目录下运行：python _mkpkg.py [--public]
|
||
|
||
- 默认：生成 owner 私有部署包（含 data/site.db、data/secret.key、cookie.txt，
|
||
供 owner 自己的服务器迁移使用，严禁对外分发）
|
||
- --public：生成可对外分发的干净包（剔除全部敏感数据——数据库/密钥/网易云 Cookie/
|
||
日志），包内另附 _pkg_ok.txt 标记
|
||
|
||
源/目标路径基于脚本自身位置推导，不再写死原作者桌面绝对路径。
|
||
"""
|
||
import glob
|
||
import os
|
||
import shutil
|
||
import sys
|
||
|
||
SRC = os.path.dirname(os.path.abspath(__file__))
|
||
DST = os.path.join(os.path.dirname(SRC), 'NeteaseUrl-部署包')
|
||
|
||
public = '--public' in sys.argv[1:]
|
||
|
||
ignore = shutil.ignore_patterns(
|
||
'venv*', '__pycache__', 'downloads', 'release*', '*.log', 'music_api.log*',
|
||
'_smoke_test_downloader.py', 'backups', '云村小助手-网站开关.bat',
|
||
'_audit_work*',
|
||
# .zcode 为 AI 工具工作目录（内部规划/会话文件），不得进任何分发包
|
||
'.zcode*',
|
||
# Cookie 备份文件（music_api.qr_client._backup_cookie 产生，含真实 MUSIC_U）：
|
||
# 'cookie.*.txt' 匹配 cookie.prewrite/backup/logout.*.txt 但不匹配 cookie.txt 本身
|
||
'cookie.*.txt', 'user_cookie.*.txt')
|
||
|
||
if os.path.exists(DST):
|
||
shutil.rmtree(DST)
|
||
shutil.copytree(SRC, DST, ignore=ignore)
|
||
|
||
# 双保险：显式删除目标里可能漏网的敏感文件（万一 ignore 模式被绕过）。
|
||
# 含轮转日志 music_api.log.1/2/3——fnmatch 的 *.log 不匹配它们，曾会随包外泄（含 IP/UA）
|
||
for _pat in ('cookie.*.txt', 'user_cookie.*.txt', 'music_api.log*'):
|
||
for _p in glob.glob(os.path.join(DST, _pat)):
|
||
try:
|
||
os.remove(_p)
|
||
except OSError:
|
||
pass
|
||
|
||
if public:
|
||
# 公开包必须剔除的敏感数据：站点库/密钥、网易云 Cookie、运行日志，以及私有包标记文件
|
||
for rel in ('data', 'cookie.txt', 'user_cookie.txt', 'music_api.log',
|
||
'_pkg_ok.txt',):
|
||
p = os.path.join(DST, rel)
|
||
try:
|
||
if os.path.isdir(p):
|
||
shutil.rmtree(p)
|
||
elif os.path.exists(p):
|
||
os.remove(p)
|
||
except OSError:
|
||
pass
|
||
# 公开包同样剔除轮转日志与 Cookie 备份（双保险与上面同集）
|
||
for _pat in ('music_api.log*', 'cookie.*.txt', 'user_cookie.*.txt'):
|
||
for _p in glob.glob(os.path.join(DST, _pat)):
|
||
try:
|
||
os.remove(_p)
|
||
except OSError:
|
||
pass
|
||
marker = 'public-clean package (no secrets)'
|
||
else:
|
||
# 私有包严禁携带《README_公开包说明.txt》——它宣称
|
||
# "不含任何敏感数据/由 --public 生成"，而私有包含 cookie.txt/site.db/secret.key，
|
||
# 接手运维按该 README 认知会整包外发造成泄露。
|
||
# 私有包写入显式警告文件替代。
|
||
_p = os.path.join(DST, 'README_公开包说明.txt')
|
||
if os.path.exists(_p):
|
||
try:
|
||
os.remove(_p)
|
||
except OSError:
|
||
pass
|
||
with open(os.path.join(DST, 'README_私有包警告.txt'), 'w', encoding='utf-8') as _f:
|
||
_f.write(
|
||
'⚠️ 私有部署包——严禁外传、严禁上传网盘/代码仓库/发给任何人。\n'
|
||
'本包包含全部敏感数据：cookie.txt（网易云 SVIP 登录态）、data/site.db（用户库）、\n'
|
||
'data/secret.key（会话与音频签名根）。\n'
|
||
'一旦泄露，请立即轮换 data/secret.key（全部存量会话与音频直链随即失效）、\n'
|
||
'吊销 cookie.txt 中的网易云登录态，并核查 data/site.db 是否已被第三方获取。\n'
|
||
'（本文件由 _mkpkg.py 私有模式自动生成；对外分发包由 --public 生成并剔除全部敏感物。）\n')
|
||
marker = None
|
||
|
||
n = 0
|
||
sz = 0
|
||
for r, _, fs in os.walk(DST):
|
||
for f in fs:
|
||
n += 1
|
||
sz += os.path.getsize(os.path.join(r, f))
|
||
with open(os.path.join(SRC, '_pkg_ok.txt'), 'w', encoding='utf-8') as f:
|
||
f.write(marker if marker else f'{n} files, {sz // 1024} KB')
|
||
shutil.copy2(os.path.join(SRC, '_pkg_ok.txt'), os.path.join(DST, '_pkg_ok.txt'))
|
||
print('ok:', 'public' if public else 'private', '-', n, 'files')
|