From 02afa4dbee20ae6c1db0b431b50266e5622df18a Mon Sep 17 00:00:00 2001
From: home-dev-pookz <hysn2001@gmail.com>
Date: Wed, 25 Mar 2026 04:33:07 +0800
Subject: [PATCH] docs: clarify legacy uploader examples

---
 README.md                       |  8 +++++++-
 examples/get_kuaishou_cookie.py |  8 +++++++-
 examples/upload_to_douyin.py    |  8 ++++++++
 examples/upload_to_kuaishou.py  | 10 +++++++++-
 4 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 2e30f6d..8f171cc 100644
--- a/README.md
+++ b/README.md
@@ -120,7 +120,13 @@ sau bilibili upload-video --account creator --file videos/demo.mp4 --title "示
 
 ### 方式 2：使用 examples
 
-其他平台当前仍以 `examples/` 下的示例脚本为主，例如：
+`examples/` 目录里同时存在两类脚本：
+
+- 当前主线 CLI 包装示例
+- 历史直连 uploader 示例
+
+对抖音、快手、Bilibili 来说，当前主线优先使用上面的 `sau ...` CLI。
+下面这些脚本里，`upload_to_douyin.py` 和 `upload_to_kuaishou.py` 属于历史直连 uploader 示例：
 
 - `examples/upload_to_douyin.py`
 - `examples/upload_video_to_bilibili.py`
diff --git a/examples/get_kuaishou_cookie.py b/examples/get_kuaishou_cookie.py
index 86b7b1e..d62227a 100644
--- a/examples/get_kuaishou_cookie.py
+++ b/examples/get_kuaishou_cookie.py
@@ -1,3 +1,9 @@
+"""Legacy direct login helper for Kuaishou.
+
+Current mainline usage prefers:
+    sau kuaishou login --account creator
+"""
+
 import asyncio
 from pathlib import Path
 
@@ -6,7 +12,7 @@ from uploader.ks_uploader.main import ks_setup
 
 
 def login_to_kuaishou():
-    account_file = Path(BASE_DIR / "cookies" / "kuaishou_creator1.json")
+    account_file = Path(BASE_DIR / "cookies" / "kuaishou_creator.json")
     account_file.parent.mkdir(exist_ok=True)
     asyncio.run(ks_setup(str(account_file), handle=True))
 
diff --git a/examples/upload_to_douyin.py b/examples/upload_to_douyin.py
index ec30079..7ad5fcc 100644
--- a/examples/upload_to_douyin.py
+++ b/examples/upload_to_douyin.py
@@ -1,3 +1,11 @@
+"""Legacy direct-uploader example for Douyin.
+
+Current mainline usage prefers:
+    sau douyin login --account creator
+    sau douyin upload-video ...
+    sau douyin upload-note ...
+"""
+
 import asyncio
 from datetime import datetime
 from pathlib import Path
diff --git a/examples/upload_to_kuaishou.py b/examples/upload_to_kuaishou.py
index 8d458e1..b290363 100644
--- a/examples/upload_to_kuaishou.py
+++ b/examples/upload_to_kuaishou.py
@@ -1,3 +1,11 @@
+"""Legacy direct-uploader example for Kuaishou.
+
+Current mainline usage prefers:
+    sau kuaishou login --account creator
+    sau kuaishou upload-video ...
+    sau kuaishou upload-note ...
+"""
+
 import asyncio
 from datetime import datetime
 from pathlib import Path
@@ -35,7 +43,7 @@ def upload_video_to_kuaishou():
 
 
 def upload_note_to_kuaishou():
-    account_file = Path(BASE_DIR / "cookies" / "kuaishou_creator1.json")
+    account_file = Path(BASE_DIR / "cookies" / "kuaishou_creator.json")
     account_file.parent.mkdir(exist_ok=True)
 
     image_paths = [