release: v0.8.5 URL下载中心与极简交互优化

Author: ChanMo

README.md

@@ -76,6 +76,29 @@ Options for `dedupe`:
 - `--execute`: Execute actual deletion
 - `--auto-confirm`: Skip confirmation prompt
 
+### URL Download (Web)
+
+TikLocal includes a `/download` page where you can paste a media URL and enqueue a background download job.
+
+Requirements:
+- `yt-dlp` (required)
+- `ffmpeg` (recommended for format merge)
+
+Cookie for login-only content (optional):
+- Put exported cookie files in `~/.tiklocal/cookies`
+- Filename should include domain, e.g. `x.com.txt`, `youtube.com.cookies`
+- The download page supports `Auto match` or manual file selection per task
+- The download page also supports cookie file upload/replace, history delete/clear, and retry for failed tasks
+
+Example installs:
+```bash
+# macOS (Homebrew)
+brew install yt-dlp ffmpeg
+
+# Ubuntu / Debian
+sudo apt install yt-dlp ffmpeg
+```
+
 ### Configuration
 
 TikLocal provides some configuration options that you can adjust to your needs.

README_zh.md

@@ -74,6 +74,29 @@ tiklocal dedupe /path --keep newest         # 保留最新的文件
 - `--execute`: 执行实际删除
 - `--auto-confirm`: 跳过确认提示
 
+### URL 下载（Web）
+
+TikLocal 新增了 `/download` 页面，可粘贴媒体 URL 并创建后台下载任务。
+
+依赖要求：
+- `yt-dlp`（必需）
+- `ffmpeg`（建议，用于格式合并）
+
+登录态内容（可选）：
+- 将导出的 cookie 文件放到 `~/.tiklocal/cookies`
+- 文件名建议包含域名，例如 `x.com.txt`、`youtube.com.cookies`
+- 下载页面支持“自动匹配”或按任务手动指定 cookie 文件
+- 下载页面也支持凭据文件上传/覆盖、历史删除/清空，以及失败任务重试
+
+安装示例：
+```bash
+# macOS (Homebrew)
+brew install yt-dlp ffmpeg
+
+# Ubuntu / Debian
+sudo apt install yt-dlp ffmpeg
+```
+
 ### 配置
 
 TikLocal 提供了一些配置选项，您可以根据自己的需要进行调整。
@@ -106,5 +129,3 @@ TikLocal 是一个开源项目，您可以通过以下方式进行贡献：
 
 * GitHub 项目地址：[https://github.com/ChanMo/TikLocal/](https://github.com/ChanMo/TikLocal/)
 * 邮箱：[chan.mo@outlook.com]
-
-

docs/release_notes.md

@@ -1,5 +1,12 @@
 # Release Notes
 
+## v0.8.5 (2026-02-20)
+- 新增 URL 下载中心（`/download`）与后台任务队列：支持任务创建、取消、删除、清空历史与失败重试。
+- 新增 cookie 文件方案：支持 `~/.tiklocal/cookies` 自动匹配/手动指定、页面上传即同名覆盖更新。
+- 下载链路增强网络容错：启用 `yt-dlp` 继续下载与重试参数，提升断网恢复能力。
+- 完成下载页交互重构：单主操作流、上传入口收敛、状态标签降饱和、Toast 反馈替代 alert。
+- 新增 `tests/test_download.py`，覆盖下载配置、cookie 处理、重试与历史清理接口。
+
 ## v0.8.4 (2026-02-20)
 - 新增 AI Prompt 配置能力：支持在设置页自定义 system/user prompt、temperature、tags_limit，并支持重置默认值。
 - 新增 LLM 运行时配置：支持在设置页配置 `base_url`、`model_name`，并展示 API Key 是否已配置。

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "tiklocal",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "A local media server that combines the features of TikTok and Pinterest",
   "scripts": {
     "build-css": "tailwindcss -i ./tiklocal/static/input.css -o ./tiklocal/static/output.css --watch",

package.json

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "TikLocal"
-version = "0.8.4"
+version = "0.8.5"
 description = "A local media server that combines the features of TikTok and Pinterest"
 authors = ["ChanMo <chan.mo@outlook.com>"]
 readme = "README.md"

pyproject.toml

@@ -0,0 +1,241 @@
+import time
+from io import BytesIO
+
+import pytest
+
+from tiklocal.app import create_app
+
+
+@pytest.fixture
+def client(tmp_path, monkeypatch):
+    media_root = tmp_path / "media"
+    media_root.mkdir(parents=True, exist_ok=True)
+    cookie_root = tmp_path / "cookies"
+    cookie_root.mkdir(parents=True, exist_ok=True)
+    (cookie_root / "x.com.txt").write_text("# Netscape HTTP Cookie File\n", encoding="utf-8")
+    (cookie_root / "youtube.com.cookies").write_text("# Netscape HTTP Cookie File\n", encoding="utf-8")
+
+    data_root = tmp_path / "tiklocal-data"
+    monkeypatch.setenv("MEDIA_ROOT", str(media_root))
+    monkeypatch.setenv("TIKLOCAL_INSTANCE", str(data_root))
+    monkeypatch.setenv("TIKLOCAL_COOKIE_DIR", str(cookie_root))
+
+    def fake_execute_download(self, job_id):  # noqa: ARG001
+        return 0, "", "mock-output.mp4"
+
+    monkeypatch.setattr("tiklocal.services.downloader.DownloadManager._execute_download", fake_execute_download)
+
+    app = create_app({"TESTING": True, "MEDIA_ROOT": media_root})
+    return app.test_client()
+
+
+def _wait_for_job(client, job_id, timeout=2.0):
+    end = time.time() + timeout
+    while time.time() < end:
+        res = client.get(f"/api/download/jobs/{job_id}")
+        assert res.status_code == 200
+        data = res.get_json()
+        job = data["data"]["job"]
+        if job["status"] in {"success", "failed", "canceled"}:
+            return job
+        time.sleep(0.05)
+    return job
+
+
+def test_download_config_api(client):
+    res = client.get("/api/download/config")
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    assert data["data"]["effective"]["max_concurrent"] == 2
+
+    res = client.post(
+        "/api/download/config",
+        json={
+            "enabled": True,
+            "default_to_root": True,
+            "allow_playlist": False,
+            "max_concurrent": 0,
+        },
+    )
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    assert data["data"]["effective"]["max_concurrent"] == 0
+
+
+def test_download_config_validation(client):
+    res = client.post(
+        "/api/download/config",
+        json={
+            "enabled": True,
+            "default_to_root": True,
+            "allow_playlist": False,
+            "max_concurrent": -1,
+        },
+    )
+    data = res.get_json()
+    assert res.status_code == 400
+    assert data["success"] is False
+    assert "max_concurrent" in data["error"]
+
+
+def test_create_download_job_success(client):
+    res = client.post("/api/download/jobs", json={"url": "https://example.com/video"})
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    job_id = data["data"]["job"]["id"]
+
+    final_job = _wait_for_job(client, job_id)
+    assert final_job["status"] == "success"
+    assert final_job["output_path_rel"] == "mock-output.mp4"
+    assert final_job["cookie_match_mode"] == "none"
+
+
+def test_create_download_job_validation(client):
+    res = client.post("/api/download/jobs", json={"url": "file:///tmp/a.mp4"})
+    data = res.get_json()
+    assert res.status_code == 400
+    assert data["success"] is False
+    assert "http/https" in data["error"]
+
+
+def test_cancel_download_job(client, monkeypatch):
+    def slow_execute_download(self, job_id):  # noqa: ARG001
+        time.sleep(0.25)
+        return 0, "", "mock-output.mp4"
+
+    monkeypatch.setattr("tiklocal.services.downloader.DownloadManager._execute_download", slow_execute_download)
+
+    res = client.post("/api/download/jobs", json={"url": "https://example.com/video2"})
+    data = res.get_json()
+    assert res.status_code == 200
+    job_id = data["data"]["job"]["id"]
+
+    cancel_res = client.post(f"/api/download/jobs/{job_id}/cancel")
+    cancel_data = cancel_res.get_json()
+    assert cancel_res.status_code == 200
+    assert cancel_data["success"] is True
+
+    final_job = _wait_for_job(client, job_id)
+    assert final_job["status"] in {"canceled", "success"}
+
+
+def test_download_probe_api(client):
+    res = client.post("/api/download/probe")
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    assert "yt_dlp_available" in data["data"]
+    assert "ffmpeg_available" in data["data"]
+
+
+def test_download_cookie_files_api(client):
+    res = client.get("/api/download/cookies")
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    assert "x.com.txt" in data["data"]["files"]
+    assert "youtube.com.cookies" in data["data"]["files"]
+
+
+def test_download_job_auto_cookie_match(client):
+    res = client.post("/api/download/jobs", json={"url": "https://m.x.com/video/123"})
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    job = data["data"]["job"]
+    assert job["cookie_match_mode"] == "auto"
+    assert job["cookie_file"] == "x.com.txt"
+
+
+def test_download_job_manual_cookie_file(client):
+    res = client.post(
+        "/api/download/jobs",
+        json={"url": "https://example.com/private", "cookie_mode": "manual", "cookie_file": "youtube.com.cookies"},
+    )
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    job = data["data"]["job"]
+    assert job["cookie_match_mode"] == "manual"
+    assert job["cookie_file"] == "youtube.com.cookies"
+
+
+def test_download_job_rejects_invalid_cookie_file(client):
+    res = client.post(
+        "/api/download/jobs",
+        json={"url": "https://example.com/private", "cookie_mode": "manual", "cookie_file": "../secrets.txt"},
+    )
+    data = res.get_json()
+    assert res.status_code == 400
+    assert data["success"] is False
+    assert "cookie_file" in data["error"]
+
+
+def test_upload_cookie_file_and_replace(client):
+    res = client.post(
+        "/api/download/cookies/upload",
+        data={"file": (BytesIO(b"# Netscape HTTP Cookie File\n"), "instagram.com.txt")},
+        content_type="multipart/form-data",
+    )
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+    assert data["data"]["filename"] == "instagram.com.txt"
+
+    res = client.post(
+        "/api/download/cookies/upload",
+        data={"file": (BytesIO(b"# Netscape HTTP Cookie File\n"), "instagram.com.txt")},
+        content_type="multipart/form-data",
+    )
+    data = res.get_json()
+    assert res.status_code == 200
+    assert data["success"] is True
+
+
+def test_retry_failed_job(client, monkeypatch):
+    def fail_execute(self, job_id):  # noqa: ARG001
+        return 1, "network", ""
+
+    monkeypatch.setattr("tiklocal.services.downloader.DownloadManager._execute_download", fail_execute)
+    res = client.post("/api/download/jobs", json={"url": "https://example.com/fail"})
+    data = res.get_json()
+    assert res.status_code == 200
+    failed_job = _wait_for_job(client, data["data"]["job"]["id"])
+    assert failed_job["status"] == "failed"
+
+    def ok_execute(self, job_id):  # noqa: ARG001
+        return 0, "", "retry-ok.mp4"
+
+    monkeypatch.setattr("tiklocal.services.downloader.DownloadManager._execute_download", ok_execute)
+    retry_res = client.post(f"/api/download/jobs/{failed_job['id']}/retry")
+    retry_data = retry_res.get_json()
+    assert retry_res.status_code == 200
+    new_job_id = retry_data["data"]["job"]["id"]
+    assert new_job_id != failed_job["id"]
+    assert retry_data["data"]["job"]["retry_of"] == failed_job["id"]
+    final = _wait_for_job(client, new_job_id)
+    assert final["status"] == "success"
+
+
+def test_delete_and_clear_history(client):
+    res1 = client.post("/api/download/jobs", json={"url": "https://example.com/a"})
+    res2 = client.post("/api/download/jobs", json={"url": "https://example.com/b"})
+    j1 = _wait_for_job(client, res1.get_json()["data"]["job"]["id"])
+    _wait_for_job(client, res2.get_json()["data"]["job"]["id"])
+
+    del_res = client.delete(f"/api/download/jobs/{j1['id']}")
+    del_data = del_res.get_json()
+    assert del_res.status_code == 200
+    assert del_data["success"] is True
+
+    check_res = client.get(f"/api/download/jobs/{j1['id']}")
+    assert check_res.status_code == 404
+
+    clear_res = client.post("/api/download/jobs/clear")
+    clear_data = clear_res.get_json()
+    assert clear_res.status_code == 200
+    assert clear_data["success"] is True
+    assert clear_data["data"]["deleted"] >= 0