feat: 完善 MVP-2 演示和进度体验

tests/unit/test_db_stability.py

@@ -1,6 +1,6 @@
 import pytest
 
-from app.db import check_database_integrity, checkpoint_sqlite_wal, create_sqlite_engine
+from app.db import check_database_integrity, checkpoint_sqlite_wal, create_sqlite_engine, ensure_sqlite_schema_compat
 
 
 def test_check_database_integrity_returns_ok_for_valid_sqlite_database():
@@ -63,3 +63,20 @@ def test_checkpoint_sqlite_wal_skips_in_memory_database():
         assert checkpoint_sqlite_wal(engine) is False
     finally:
         engine.dispose()
+
+
+def test_ensure_sqlite_schema_compat_adds_progress_columns_to_existing_tasks_table(tmp_path):
+    db_path = tmp_path / "legacy.db"
+    engine = create_sqlite_engine(f"sqlite:///{db_path}")
+    try:
+        with engine.begin() as connection:
+            connection.exec_driver_sql("CREATE TABLE tasks (id VARCHAR(36) PRIMARY KEY, platform VARCHAR(32) NOT NULL)")
+
+        ensure_sqlite_schema_compat(engine)
+
+        with engine.connect() as connection:
+            columns = {row[1] for row in connection.exec_driver_sql("PRAGMA table_info(tasks)").all()}
+        assert "current_stage" in columns
+        assert "last_progress_at" in columns
+    finally:
+        engine.dispose()

tests/unit/test_demo_seed.py

@@ -0,0 +1,27 @@
+from sqlalchemy.orm import Session
+
+from app.demo_seed import seed_demo_data
+from app.models import Comment, ContentItem, Task
+from tests.helpers import make_test_client
+
+
+def test_seed_demo_data_is_idempotent_and_removes_sensitive_fields():
+    with make_test_client() as (_client, engine):
+        with Session(engine) as session:
+            task_id = seed_demo_data(session)
+            second_task_id = seed_demo_data(session)
+
+            task = session.get(Task, task_id)
+            comments = session.query(Comment).all()
+            items = session.query(ContentItem).all()
+
+    assert second_task_id == task_id
+    assert task is not None
+    assert task.id.startswith("demo-")
+    assert task.status == "success"
+    assert comments
+    assert all(comment.author is None for comment in comments)
+    assert all(comment.source_comment_id is None for comment in comments)
+    assert all(comment.raw_data == "{}" for comment in comments)
+    assert all(item.url is None for item in items)
+    assert all(item.raw_data == "{}" for item in items)

tests/unit/test_docs.py

@@ -17,5 +17,8 @@ def test_user_guide_covers_startup_acceptance_exports_and_troubleshooting():
         "API Key 缺失",
         "任务长期 running",
         "重置本地数据库",
+        "公网云服务器部署",
+        "python -m app.demo_seed",
+        "data/corrupt-backups",
     ]:
         assert required in content