Files
unicut/scripts/localize-assets.py
T
jinghui 59241af720 本地化改造:免登录 + 本机 AI + 离线可用
在上游 gitee.com/676015863/unicut 基础上做的自托管改造,使其可脱离官方账号体系
与 CDN 独立运行。详见 CHANGELOG.md。

主要能力
- 免登录:GUEST_USER 直接使用核心功能,checkAuth 不再拦截
- 本机 AI:对话 mimo-v2.6-flash(同源 /newapi/v1)、视觉 deepseek-v4-flash-vision-exp、
  生图 /omniai、生视频 /civideo;密钥仅存服务端(nginx 占位符 + entrypoint 注入)
- AI 一键出片:图片+标题 → AI 文案 → 人声/语速/情绪 → 确认生成直接排时间轴,
  并支持转场、图片运镜、字幕位置/大小/配色/入场动画
- 离线可用:工程数据 IndexedDB + 项目文件 JSON 双写;官方素材走同源 /cdn/ 反代;
  无 OPFS 时素材回落 IndexedDB files 表

修复
- 账号类接口本地短路,不再反复弹「Header parameter [authorization] cannot be empty」
- isFSApiSupported 改取值判断,修 OPFS 判定错误导致卡在文件夹引导页
- 模板素材统一 /cdn/ 改写 + nginx 兜底转发,修缩略图全裂
- 剔除素材已失效的模板(上游 CDN 已删,点开必卡 loading 50%)
- 补齐 SDK 内置 4 张滤镜贴图,修画布卡 loading 0%
- 封面上传失败不再中断整次保存

品牌与页面
- 「云剪」改为 UniCut
- 首页删除收费标准栏目;顶部菜单移除 GitHub/Gitee;底部栏整体下线

安全
- .env 与 public/local-ai.json(含密钥)已在 .gitignore,不入库
- public/local-ai.json.example 仅含占位符
2026-10-26 18:18:41 +08:00

217 lines
9.5 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
把 UniCut 站点依赖的远程素材下载到 public/ 下并改写成同源路径,
让站点在断网环境下依然完整可用(音色试听、AI 头像、字体、404 占位图等)。
可重复执行:已存在的文件默认跳过(--force 重新下载)。
输出:data-quality/reports/site/assets-localize.json
"""
import argparse
import concurrent.futures as cf
import json
import os
import re
import shutil
import subprocess
import sys
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
PUBLIC = os.path.join(ROOT, 'public')
REPORT = os.path.join(ROOT, 'data-quality', 'reports', 'site', 'assets-localize.json')
CDN = 'https://cdn.h5ds.com'
BYTED = 'https://lf3-static.bytednsdoc.com'
DL_ICON = BYTED + '/obj/eden-cn/ptlz_zlp/ljhwZthlaukjlkulzlp/docs-icon.png'
ASSISTANT_LOGO = BYTED + '/obj/eden-cn/ptlz_zlp/ljhwZthlaukjlkulzlp/other/logo.png'
SIYUAN_FONT = CDN + '/assets/fonts/siYuanHeiTi/font.woff'
DEMO_APP = CDN + '/video-mix/u/9715/apps/960593364739022848.json'
jobs = [] # (rel_path, url_or_callable, note)
results = []
def add(rel_path, url, note=''):
jobs.append((rel_path, url, note))
def safe_name(s, maxlen=48):
s = re.sub(r'[^0-9A-Za-z一-鿿._-]+', '_', s or '')
return s[:maxlen] or 'unnamed'
def prepare_voices():
"""zijieVoices.json:121 个音色,头像 + 试听音频各一,共 242 个远程文件。"""
src = os.path.join(PUBLIC, 'assets', 'zijieVoices.json')
if not os.path.exists(src):
print('[skip] public/assets/zijieVoices.json 不存在')
return None
data = json.load(open(src, encoding='utf-8'))
changed = 0
for i, item in enumerate(data):
vt = safe_name(item.get('voice_type') or item.get('name') or str(i))
for key, sub in (('avatar', 'avatar'), ('audio', 'audio')):
url = item.get(key)
if not isinstance(url, str) or not url.startswith('http'):
continue
ext = os.path.splitext(url.split('?')[0])[1] or ('.png' if key == 'avatar' else '.mp3')
rel = 'assets/voices/%s/%03d-%s%s' % (sub, i, vt, ext)
add(rel, url, 'zijieVoices[%d].%s' % (i, key))
item[key] = '/' + rel
changed += 1
if changed:
json.dump(data, open(src, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
print('[plan] zijieVoices.json:%d 个远程地址改写为本地' % changed)
return changed
def prepare_fonts():
"""字体:思源黑体上游可下载;aConfused 上游 404,用思源黑体兜底并登记 TODO。"""
add('assets/fonts/siYuanHeiTi/font.woff', SIYUAN_FONT, 'SDK loadFont 默认字体')
add('assets/fonts/aConfused/font.woff', '__COPY__assets/fonts/siYuanHeiTi/font.woff',
'TODO 上游 aConfused/font.woff 已 404,先用思源黑体兜底(模板 fontFamily=aConfused)')
# 演示工程 /editor/test 的文字用的是这个字体(相对路径,reURL 后落在同源根)
add('assets/fonts/抖音美好体.otf',
CDN + '/assets/fonts/' + '%E6%8A%96%E9%9F%B3%E7%BE%8E%E5%A5%BD%E4%BD%93.otf',
'演示工程字体(缺失时文字回退系统字体)')
def prepare_misc():
add('assets/ai-chat/user.png', DL_ICON, 'AI 对话用户头像')
add('assets/ai-chat/assistant.png', ASSISTANT_LOGO, 'AI 对话助手头像')
add('assets/images/404.png', CDN + '/assets/images/404.png', 'SDK config.img404')
add('assets/images/qrcode-loading.png', CDN + '/static/images/qrcode-loading.png', '二维码占位图')
add('assets/demo/test-app.json', DEMO_APP, '编辑器 /editor/test 演示工程')
# SDK 启动时用 pixi Assets.load 一次性加载这 4 张滤镜贴图(reURL(相对路径) + cdnHost 拼接)。
# cdnHost 改成同源后必须本地存在,否则 loader 报
# “InvalidStateError: The source image could not be decoded”,编辑器卡在 loading 0.0%。
for _f in ('colormap.png', 'displacement_map.png', 'lightmap.png', 'overlay.png'):
add('assets/images/' + _f, CDN + '/assets/images/' + _f, 'SDK 启动滤镜贴图(缺失会卡 loading)')
# /editor/test 演示工程里引用的两个素材是根相对路径,resourcesHost 改同源后必须本地存在,
# 否则 nginx 回退到 index.html,媒体解码失败会卡在 loading
add('video-mix/u/uploads/9715/20260324/960586355482419200/convert.mp4',
CDN + '/video-mix/u/uploads/9715/20260324/960586355482419200/convert.mp4', '演示工程视频')
add('video/uploads/1/20260318/958639279878656000.mp3',
CDN + '/video/uploads/1/20260318/958639279878656000.mp3', '演示工程音频')
def gen_font_family_json():
"""字体下拉改用本地清单,不再依赖官方 materials 接口。"""
out = os.path.join(PUBLIC, 'assets', 'fontFamily.json')
entries = [
{'name': 'siYuanHeiTi', 'label': '思源黑体'},
{'name': 'aConfused', 'label': '杂体(思源黑体兜底)'},
]
data = [{
'name': e['name'],
'label': e['label'],
'urls': {
'url': '/assets/fonts/%s/font.woff' % e['name'],
'thumb': '/assets/fonts/%s/thumb.png' % e['name'],
},
} for e in entries]
json.dump(data, open(out, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
print('[gen] public/assets/fontFamily.json')
def gen_font_thumbs():
"""字体缩略图:PIL 画一张简单卡片,离线可用。"""
from PIL import Image, ImageDraw
for name, label in (('siYuanHeiTi', '思源黑体'), ('aConfused', '杂体 Aa')):
d = os.path.join(PUBLIC, 'assets', 'fonts', name)
os.makedirs(d, exist_ok=True)
p = os.path.join(d, 'thumb.png')
if os.path.exists(p):
continue
img = Image.new('RGB', (160, 64), (245, 246, 250))
dr = ImageDraw.Draw(img)
dr.rectangle([0, 0, 159, 63], outline=(210, 214, 224))
dr.text((14, 12), 'Aa', fill=(32, 33, 36))
dr.text((14, 36), label[:6], fill=(96, 99, 108))
img.save(p)
print('[gen] 字体缩略图 thumb.png x2')
def gen_effectcanvas_stub():
"""官方 effectcanvas 远端目录已失效(返回 SPA index.html),本地放占位清单 + TODO 说明。"""
d = os.path.join(PUBLIC, 'assets', 'effectcanvas')
os.makedirs(d, exist_ok=True)
stub = {'version': 'local-stub', 'note': '官方 CDN /assets/effectcanvas/ 已失效,特效画布模块暂不可用', 'modules': []}
json.dump(stub, open(os.path.join(d, 'manifest.json'), 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
open(os.path.join(d, 'README.md'), 'w', encoding='utf-8').write(
'# effectcanvas 本地占位\n\n'
'官方 `https://cdn.h5ds.com/assets/effectcanvas/` 目前返回站点 index.html(目录已下线),'
'无法下载真实模块。\n\n'
'- SDK `window.EModuleEffectSourcePath` 已改指向本目录(`/assets/effectcanvas/`);\n'
'- 这里只放 `manifest.json` 占位,特效画布(EModule)功能在拿到真实模块前不可用(TODO);\n'
'- 若上游恢复,把模块文件按原目录结构放进来即可,无需改代码。\n')
print('[gen] public/assets/effectcanvas/ 占位')
def download_one(rel, url):
dest = os.path.join(PUBLIC, rel)
if os.path.exists(dest) and os.path.getsize(dest) > 0:
return (rel, 'exists', 0)
os.makedirs(os.path.dirname(dest), exist_ok=True)
if url.startswith('__COPY__'):
src = os.path.join(PUBLIC, url[len('__COPY__'):])
if not os.path.exists(src):
return (rel, 'src-missing', 0)
shutil.copyfile(src, dest)
return (rel, 'copy', os.path.getsize(dest))
for attempt in range(3):
p = subprocess.run(['curl', '-sL', '--max-time', '60', '-o', dest, url],
capture_output=True, text=True)
if p.returncode == 0 and os.path.exists(dest) and os.path.getsize(dest) > 0:
head = open(dest, 'rb').read(200).lower()
if b'<html' in head and not url.endswith(('.html', '.md')):
status = 'html-error'
break
return (rel, 'ok', os.path.getsize(dest))
if os.path.exists(dest):
os.remove(dest)
return (rel, 'fail', 0)
def main():
ap = argparse.ArgumentParser()
ap.add_argument('--workers', type=int, default=8)
ap.add_argument('--limit', type=int, default=0, help='只下载前 N 个(调试用)')
args = ap.parse_args()
prepare_voices()
prepare_fonts()
prepare_misc()
gen_effectcanvas_stub()
todo = jobs[:]
if args.limit:
todo = todo[:args.limit]
print('[download] 待处理 %d 个文件,并发 %d' % (len(todo), args.workers))
ok = exists = fail = 0
with cf.ThreadPoolExecutor(max_workers=args.workers) as ex:
for rel, status, size in ex.map(lambda j: download_one(j[0], j[1]), todo):
results.append({'path': rel, 'status': status, 'bytes': size})
if status in ('ok', 'copy'):
ok += 1
elif status == 'exists':
exists += 1
else:
fail += 1
print('[fail]', rel, status)
gen_font_thumbs()
gen_font_family_json()
os.makedirs(os.path.dirname(REPORT), exist_ok=True)
json.dump({'total': len(todo), 'downloaded': ok, 'existed': exists, 'failed': fail,
'items': results},
open(REPORT, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
print('[done] downloaded=%d existed=%d failed=%d -> %s' % (ok, exists, fail, REPORT))
return 1 if fail else 0
if __name__ == '__main__':
sys.exit(main())