Skip to content

利用 AI 大模型和自动化工作流,根据主题或关键词一键生成高清短视频。Generate HD short videos from a topic or keyword with an automated AI workflow.

feat(webui): clarify Upload-Post setup

harry0703fd685edee562
diff --git a/test/services/test_webui_upload_post_settings.py b/test/services/test_webui_upload_post_settings.py
index 48232695..0a600731 100644
--- a/test/services/test_webui_upload_post_settings.py
+++ b/test/services/test_webui_upload_post_settings.py
@@ -15,6 +15,25 @@ def _widget_by_key(elements, key):
or str(getattr(item, "key", "")).startswith(f"{key}_")
)
+
+def test_webui_upload_post_setup_guide_links_to_required_pages():
+ # 首次使用自动发布时,API Key 和发布用户需要在 Upload-Post 的不同页面
+ # 分别配置。这里锁定两个精确入口,避免后续文案调整后再次退化成无法点击的
+ # 泛化提示,导致用户误把登录邮箱当作发布用户名称。
+ with patch.object(config, "try_save_config", return_value=True):
+ app = AppTest.from_file(str(WEBUI_MAIN), default_timeout=60)
+ app.run()
+ app.session_state["settings_dialog_open"] = True
+ app.run()
+
+ setup_guide = next(
+ item
+ for item in app.info
+ if "https://app.upload-post.com/api-keys" in item.value
+ )
+ assert "https://app.upload-post.com/manage-users" in setup_guide.value
+
+
def test_webui_upload_post_checkbox_syncs_persisted_mismatch():
# Persisted mismatch: enabled=True, auto_upload=False
test_app_config = dict(
diff --git a/webui/Main.py b/webui/Main.py
index 6e79c630..1b72afaa 100644
--- a/webui/Main.py
+++ b/webui/Main.py
@@ -98,6 +98,11 @@ VOICE_MODE_TTS = "tts"
VOICE_MODE_UPLOAD = "upload"
VOICE_MODE_NONE = "none"
LOOMLOOM_MAX_POLL_FAILURES = 5
+# Upload-Post 的 API Key 与发布用户分别在两个页面管理,并且发布用户名称
+# 不等于登录邮箱。集中维护入口可以避免多语言文案各自硬编码 URL 后发生偏差,
+# 也方便用户从 WebUI 直接完成首次配置和后续账号维护。
+UPLOAD_POST_API_KEYS_URL = "https://app.upload-post.com/api-keys"
+UPLOAD_POST_MANAGE_USERS_URL = "https://app.upload-post.com/manage-users"
# “默认”是 WebUI 专用哨兵,不会写入 config.toml,也不会传给 FFmpeg。
# 后端在 video_codec 未配置时继续采用稳定的 libx264;单独保留该哨兵可以区分
# “跟随项目默认策略”和“用户明确固定 libx264”,便于未来安全调整默认策略。
@@ -2543,6 +2548,12 @@ def _render_settings_dialog():
with publish_config_panel:
st.write(tr("Automatically publish generated videos to social media using upload-post.com"))
+ st.info(
+ tr("Upload-Post Setup Guide").format(
+ api_keys_url=UPLOAD_POST_API_KEYS_URL,
+ manage_users_url=UPLOAD_POST_MANAGE_USERS_URL,
+ )
+ )
is_enabled = config.app.get("upload_post_enabled", False)
is_auto = config.app.get("upload_post_auto_upload", False)
@@ -2561,7 +2572,9 @@ def _render_settings_dialog():
tr("Upload-Post API Key"),
value=config.app.get("upload_post_api_key", ""),
type="password",
- help="Get your API key from upload-post.com",
+ help=tr("Upload-Post API Key Help").format(
+ api_keys_url=UPLOAD_POST_API_KEYS_URL
+ ),
key="upload_post_api_key_input"
)
if upload_post_api_key != config.app.get("upload_post_api_key", ""):
@@ -2570,7 +2583,9 @@ def _render_settings_dialog():
upload_post_username = st.text_input(
tr("Upload-Post Profile Username"),
value=config.app.get("upload_post_username", ""),
- help="Your upload-post.com publishing profile username (not your account email)",
+ help=tr("Upload-Post Profile Username Help").format(
+ manage_users_url=UPLOAD_POST_MANAGE_USERS_URL
+ ),
key="upload_post_username_input"
)
if upload_post_username != config.app.get("upload_post_username", ""):
diff --git a/webui/i18n/de.json b/webui/i18n/de.json
index 28bd0d17..9e628576 100644
--- a/webui/i18n/de.json
+++ b/webui/i18n/de.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Automatisches Veröffentlichen aktivieren",
"Platforms": "Plattformen",
"Upload-Post API Key": "Upload-Post API-Schlüssel",
+ "Upload-Post API Key Help": "Erstellen und kopieren Sie einen API-Schlüssel auf der Seite [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Upload-Post Profil-Benutzername",
+ "Upload-Post Profile Username Help": "Geben Sie den unter [Manage Users]({manage_users_url}) angezeigten Benutzernamen ein, nicht die E-Mail-Adresse Ihres Upload-Post-Kontos. Dieser Veröffentlichungsbenutzer muss mit den ausgewählten Plattformen verbunden sein.",
+ "Upload-Post Setup Guide": "Bevor Sie die automatische Veröffentlichung aktivieren:\n1. Erstellen Sie unter [API Keys]({api_keys_url}) einen API-Schlüssel.\n2. Erstellen oder wählen Sie unter [Manage Users]({manage_users_url}) einen Veröffentlichungsbenutzer und verbinden Sie die Zielplattformen.\n\nGeben Sie unten dessen **Benutzernamen** ein, nicht die E-Mail-Adresse Ihres Upload-Post-Kontos.",
"YouTube Privacy Status": "YouTube-Datenschutzstatus"
}
}
diff --git a/webui/i18n/en.json b/webui/i18n/en.json
index f8815a27..55241a6f 100644
--- a/webui/i18n/en.json
+++ b/webui/i18n/en.json
@@ -392,7 +392,10 @@
"Enable Auto-Publish": "Enable Auto-Publish",
"Platforms": "Platforms",
"Upload-Post API Key": "Upload-Post API Key",
+ "Upload-Post API Key Help": "Create and copy an API key on the [Upload-Post API Keys page]({api_keys_url}).",
"Upload-Post Profile Username": "Upload-Post Profile Username",
+ "Upload-Post Profile Username Help": "Enter the Username shown on [Manage Users]({manage_users_url}), not your Upload-Post account email. This publishing user must be connected to the selected platforms.",
+ "Upload-Post Setup Guide": "Before enabling auto-publish:\n1. Create an API key on [API Keys]({api_keys_url}).\n2. Create or select a publishing user on [Manage Users]({manage_users_url}), then connect the target platforms.\n\nEnter that publishing user's **Username** below, not your Upload-Post account email.",
"YouTube Privacy Status": "YouTube Privacy Status"
}
}
diff --git a/webui/i18n/es.json b/webui/i18n/es.json
index ee02ea72..28d9088a 100644
--- a/webui/i18n/es.json
+++ b/webui/i18n/es.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Habilitar publicación automática",
"Platforms": "Plataformas",
"Upload-Post API Key": "Clave API de Upload-Post",
+ "Upload-Post API Key Help": "Crea y copia una clave API en la página [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Nombre de usuario del perfil de Upload-Post",
+ "Upload-Post Profile Username Help": "Introduce el nombre de usuario que aparece en [Manage Users]({manage_users_url}), no el correo de tu cuenta de Upload-Post. Este usuario de publicación debe estar conectado a las plataformas seleccionadas.",
+ "Upload-Post Setup Guide": "Antes de activar la publicación automática:\n1. Crea una clave API en [API Keys]({api_keys_url}).\n2. Crea o selecciona un usuario de publicación en [Manage Users]({manage_users_url}) y conecta las plataformas de destino.\n\nIntroduce abajo el **nombre de usuario** de publicación, no el correo de tu cuenta de Upload-Post.",
"YouTube Privacy Status": "Estado de privacidad de YouTube"
}
}
diff --git a/webui/i18n/fr.json b/webui/i18n/fr.json
index b187d1d9..fb996624 100644
--- a/webui/i18n/fr.json
+++ b/webui/i18n/fr.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Activer la publication automatique",
"Platforms": "Plateformes",
"Upload-Post API Key": "Clé API Upload-Post",
+ "Upload-Post API Key Help": "Créez et copiez une clé API depuis la page [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Nom d'utilisateur du profil Upload-Post",
+ "Upload-Post Profile Username Help": "Saisissez le nom d'utilisateur affiché dans [Manage Users]({manage_users_url}), et non l'adresse e-mail de votre compte Upload-Post. Cet utilisateur de publication doit être connecté aux plateformes sélectionnées.",
+ "Upload-Post Setup Guide": "Avant d'activer la publication automatique :\n1. Créez une clé API dans [API Keys]({api_keys_url}).\n2. Créez ou sélectionnez un utilisateur de publication dans [Manage Users]({manage_users_url}), puis connectez les plateformes cibles.\n\nSaisissez ci-dessous son **nom d'utilisateur**, et non l'adresse e-mail de votre compte Upload-Post.",
"YouTube Privacy Status": "Statut de confidentialité YouTube"
}
}
diff --git a/webui/i18n/id.json b/webui/i18n/id.json
index 56f900d2..118258b1 100644
--- a/webui/i18n/id.json
+++ b/webui/i18n/id.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Aktifkan Publikasi Otomatis",
"Platforms": "Platform",
"Upload-Post API Key": "Kunci API Upload-Post",
+ "Upload-Post API Key Help": "Buat dan salin kunci API di halaman [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Nama Pengguna Profil Upload-Post",
+ "Upload-Post Profile Username Help": "Masukkan Username yang ditampilkan di [Manage Users]({manage_users_url}), bukan email akun Upload-Post Anda. Pengguna penerbitan ini harus terhubung ke platform yang dipilih.",
+ "Upload-Post Setup Guide": "Sebelum mengaktifkan publikasi otomatis:\n1. Buat kunci API di [API Keys]({api_keys_url}).\n2. Buat atau pilih pengguna penerbitan di [Manage Users]({manage_users_url}), lalu hubungkan platform tujuan.\n\nMasukkan **Username** pengguna penerbitan tersebut di bawah, bukan email akun Upload-Post Anda.",
"YouTube Privacy Status": "Status Privasi YouTube"
}
}
diff --git a/webui/i18n/it.json b/webui/i18n/it.json
index 5cdc52fa..83a4ff80 100644
--- a/webui/i18n/it.json
+++ b/webui/i18n/it.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Abilita pubblicazione automatica",
"Platforms": "Piattaforme",
"Upload-Post API Key": "Chiave API Upload-Post",
+ "Upload-Post API Key Help": "Crea e copia una chiave API dalla pagina [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Nome utente del profilo Upload-Post",
+ "Upload-Post Profile Username Help": "Inserisci il nome utente mostrato in [Manage Users]({manage_users_url}), non l'email del tuo account Upload-Post. Questo utente di pubblicazione deve essere collegato alle piattaforme selezionate.",
+ "Upload-Post Setup Guide": "Prima di abilitare la pubblicazione automatica:\n1. Crea una chiave API in [API Keys]({api_keys_url}).\n2. Crea o seleziona un utente di pubblicazione in [Manage Users]({manage_users_url}), quindi collega le piattaforme di destinazione.\n\nInserisci qui sotto il suo **nome utente**, non l'email del tuo account Upload-Post.",
"YouTube Privacy Status": "Stato di privacy di YouTube"
}
}
diff --git a/webui/i18n/pt.json b/webui/i18n/pt.json
index 2c53b9cc..d4dc8a38 100644
--- a/webui/i18n/pt.json
+++ b/webui/i18n/pt.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Ativar Publicação Automática",
"Platforms": "Plataformas",
"Upload-Post API Key": "Chave API do Upload-Post",
+ "Upload-Post API Key Help": "Crie e copie uma chave API na página [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Nome de Usuário do Perfil Upload-Post",
+ "Upload-Post Profile Username Help": "Informe o nome de usuário exibido em [Manage Users]({manage_users_url}), não o e-mail da sua conta Upload-Post. Esse usuário de publicação deve estar conectado às plataformas selecionadas.",
+ "Upload-Post Setup Guide": "Antes de ativar a publicação automática:\n1. Crie uma chave API em [API Keys]({api_keys_url}).\n2. Crie ou selecione um usuário de publicação em [Manage Users]({manage_users_url}) e conecte as plataformas de destino.\n\nInforme abaixo o **nome de usuário** de publicação, não o e-mail da sua conta Upload-Post.",
"YouTube Privacy Status": "Status de Privacidade do YouTube"
}
}
diff --git a/webui/i18n/ru.json b/webui/i18n/ru.json
index 7337cf80..02e73a8d 100644
--- a/webui/i18n/ru.json
+++ b/webui/i18n/ru.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Включить автопубликацию",
"Platforms": "Платформы",
"Upload-Post API Key": "API-ключ Upload-Post",
+ "Upload-Post API Key Help": "Создайте и скопируйте API-ключ на странице [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Имя пользователя профиля Upload-Post",
+ "Upload-Post Profile Username Help": "Введите имя пользователя со страницы [Manage Users]({manage_users_url}), а не адрес электронной почты аккаунта Upload-Post. Этот пользователь публикации должен быть подключён к выбранным платформам.",
+ "Upload-Post Setup Guide": "Перед включением автопубликации:\n1. Создайте API-ключ на странице [API Keys]({api_keys_url}).\n2. Создайте или выберите пользователя публикации на странице [Manage Users]({manage_users_url}) и подключите целевые платформы.\n\nНиже введите его **имя пользователя**, а не адрес электронной почты аккаунта Upload-Post.",
"YouTube Privacy Status": "Статус конфиденциальности YouTube"
}
}
diff --git a/webui/i18n/tr.json b/webui/i18n/tr.json
index da025ef4..971d32a4 100644
--- a/webui/i18n/tr.json
+++ b/webui/i18n/tr.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Otomatik Yayınlamayı Etkinleştir",
"Platforms": "Platformlar",
"Upload-Post API Key": "Upload-Post API Anahtarı",
+ "Upload-Post API Key Help": "[Upload-Post API Keys]({api_keys_url}) sayfasında bir API anahtarı oluşturup kopyalayın.",
"Upload-Post Profile Username": "Upload-Post Profil Kullanıcı Adı",
+ "Upload-Post Profile Username Help": "Upload-Post hesap e-postanız yerine [Manage Users]({manage_users_url}) sayfasında gösterilen kullanıcı adını girin. Bu yayın kullanıcısı seçilen platformlara bağlı olmalıdır.",
+ "Upload-Post Setup Guide": "Otomatik yayınlamayı etkinleştirmeden önce:\n1. [API Keys]({api_keys_url}) sayfasında bir API anahtarı oluşturun.\n2. [Manage Users]({manage_users_url}) sayfasında bir yayın kullanıcısı oluşturun veya seçin ve hedef platformları bağlayın.\n\nAşağıya Upload-Post hesap e-postanızı değil, bu yayın kullanıcısının **kullanıcı adını** girin.",
"YouTube Privacy Status": "YouTube Gizlilik Durumu"
}
}
diff --git a/webui/i18n/vi.json b/webui/i18n/vi.json
index a8c509e5..cde6c2b9 100644
--- a/webui/i18n/vi.json
+++ b/webui/i18n/vi.json
@@ -327,7 +327,10 @@
"Enable Auto-Publish": "Bật tự động xuất bản",
"Platforms": "Nền tảng",
"Upload-Post API Key": "Khóa API Upload-Post",
+ "Upload-Post API Key Help": "Tạo và sao chép khóa API tại trang [Upload-Post API Keys]({api_keys_url}).",
"Upload-Post Profile Username": "Tên người dùng hồ sơ Upload-Post",
+ "Upload-Post Profile Username Help": "Nhập tên người dùng hiển thị tại [Manage Users]({manage_users_url}), không phải email tài khoản Upload-Post. Người dùng xuất bản này phải được kết nối với các nền tảng đã chọn.",
+ "Upload-Post Setup Guide": "Trước khi bật tự động xuất bản:\n1. Tạo khóa API tại [API Keys]({api_keys_url}).\n2. Tạo hoặc chọn người dùng xuất bản tại [Manage Users]({manage_users_url}), sau đó kết nối các nền tảng đích.\n\nNhập **tên người dùng** xuất bản đó bên dưới, không phải email tài khoản Upload-Post.",
"YouTube Privacy Status": "Trạng thái quyền riêng tư của YouTube"
}
}
diff --git a/webui/i18n/zh.json b/webui/i18n/zh.json
index 633471a3..07c78459 100644
--- a/webui/i18n/zh.json
+++ b/webui/i18n/zh.json
@@ -392,7 +392,10 @@
"Enable Auto-Publish": "启用自动发布",
"Platforms": "发布平台",
"Upload-Post API Key": "Upload-Post API Key",
- "Upload-Post Profile Username": "Upload-Post 账号名称",
+ "Upload-Post API Key Help": "在 [Upload-Post API Keys 页面]({api_keys_url})创建并复制 API Key。",
+ "Upload-Post Profile Username": "Upload-Post 发布用户名称",
+ "Upload-Post Profile Username Help": "填写 [Manage Users]({manage_users_url}) 页面显示的 Username,而不是 Upload-Post 登录邮箱;该发布用户需要已经连接所选平台。",
+ "Upload-Post Setup Guide": "启用自动发布前,请先:\n1. 在 [API Keys]({api_keys_url}) 页面创建 API Key。\n2. 在 [Manage Users]({manage_users_url}) 页面创建或选择发布用户,并连接目标平台。\n\n下方请填写该发布用户的 **Username**,而不是 Upload-Post 登录邮箱。",
"YouTube Privacy Status": "YouTube 隐私状态"
}
}