rednote-cli 0.1.0__tar.gz

rednote_cli-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: rednote-cli
+Version: 0.1.0
+Summary: Rednote platform CLI
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: playwright==1.57.0
+Requires-Dist: playwright-stealth==2.0.0
+Requires-Dist: yt-dlp==2025.12.8
+Requires-Dist: pydantic==2.12.2
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: loguru==0.7.3
+Requires-Dist: croniter==6.0.0
+Requires-Dist: fake_useragent==2.2.0
+
+# rednote-cli
+
+Rednote 平台专用 CLI 包（独立安装、独立升级）。
+
+## 安装
+
+```bash
+pipx install rednote-cli
+```
+
+## 快速开始
+
+```bash
+rednote-cli init runtime
+rednote-cli doctor run --format json
+rednote-cli account login
+rednote-cli account status --format json
+rednote-cli account list --only-active true
+rednote-cli account list --only-active false
+rednote-cli search note --keyword 旅行 --size 10 --sort-by latest --note-type image_text --format json
+rednote-cli publish --target image --account user_001 --image-list /abs/a.jpg,/abs/b.jpg --title 标题 --content 正文 --format json
+rednote-cli publish --target video --account user_001 --video /abs/demo.mp4 --title 标题 --content 正文 --format json
+```
+
+命令结构（当前版本）：
+- `note` / `user` 作为详情查询入口，`search note|user` 作为统一搜索入口。
+- 旧层级 `note get|search`、`user get|search` 已移除。
+
+空参数行为（统一约定）：
+- `rednote-cli note`、`rednote-cli publish`、`rednote-cli account activate` 等缺少业务参数时，输出帮助文本并返回退出码 `0`。
+- 非空调用但参数非法时，返回 JSON `INVALID_ARGS`（退出码 `2`）。
+
+`account status` 会实时打开浏览器检查登录态并刷新账号存储（`is_logged_in/check_time/storage_state`），输出结构与 `account list --only-active false` 对齐。
+
+`account list` 的 `--only-active` 支持显式 `true|false`（默认 `true`）。
+
+发布能力说明：
+- `publish --target image`：图文发布，支持本地/URL 图片，`--account` 必填。
+- `publish --target video`：视频发布，支持本地/URL 视频（仅 `mp4/mov`），`--account` 必填。
+
+## 自动化建议
+
+```bash
+rednote-cli --format json --trace-id req-001 <command> ...
+```
+
+`--input`（面向 AI/Agent）：
+- 作用：从 JSON 文件或 stdin 读取参数，适合复杂命令的程序化调用。
+- 优先级：显式 CLI 参数 > `--input` JSON > 默认值。
+- 范围：`--input` 不是全局参数，仅 `search note|user`、`note`、`user`、`publish` 支持。
+
+示例：
+
+```bash
+rednote-cli --format json --trace-id req-001 search note --input payload.json
+cat payload.json | rednote-cli --format json --trace-id req-002 publish --input - --account user_001
+```
+
+## 文档
+
+完整文档请查看仓库根目录：
+- `README.md`
+- `DESIGN.md`
+- `DEV.md`
+- `USER_GUIDE.md`

rednote_cli-0.1.0/README.md

@@ -0,0 +1,65 @@
+# rednote-cli
+
+Rednote 平台专用 CLI 包（独立安装、独立升级）。
+
+## 安装
+
+```bash
+pipx install rednote-cli
+```
+
+## 快速开始
+
+```bash
+rednote-cli init runtime
+rednote-cli doctor run --format json
+rednote-cli account login
+rednote-cli account status --format json
+rednote-cli account list --only-active true
+rednote-cli account list --only-active false
+rednote-cli search note --keyword 旅行 --size 10 --sort-by latest --note-type image_text --format json
+rednote-cli publish --target image --account user_001 --image-list /abs/a.jpg,/abs/b.jpg --title 标题 --content 正文 --format json
+rednote-cli publish --target video --account user_001 --video /abs/demo.mp4 --title 标题 --content 正文 --format json
+```
+
+命令结构（当前版本）：
+- `note` / `user` 作为详情查询入口，`search note|user` 作为统一搜索入口。
+- 旧层级 `note get|search`、`user get|search` 已移除。
+
+空参数行为（统一约定）：
+- `rednote-cli note`、`rednote-cli publish`、`rednote-cli account activate` 等缺少业务参数时，输出帮助文本并返回退出码 `0`。
+- 非空调用但参数非法时，返回 JSON `INVALID_ARGS`（退出码 `2`）。
+
+`account status` 会实时打开浏览器检查登录态并刷新账号存储（`is_logged_in/check_time/storage_state`），输出结构与 `account list --only-active false` 对齐。
+
+`account list` 的 `--only-active` 支持显式 `true|false`（默认 `true`）。
+
+发布能力说明：
+- `publish --target image`：图文发布，支持本地/URL 图片，`--account` 必填。
+- `publish --target video`：视频发布，支持本地/URL 视频（仅 `mp4/mov`），`--account` 必填。
+
+## 自动化建议
+
+```bash
+rednote-cli --format json --trace-id req-001 <command> ...
+```
+
+`--input`（面向 AI/Agent）：
+- 作用：从 JSON 文件或 stdin 读取参数，适合复杂命令的程序化调用。
+- 优先级：显式 CLI 参数 > `--input` JSON > 默认值。
+- 范围：`--input` 不是全局参数，仅 `search note|user`、`note`、`user`、`publish` 支持。
+
+示例：
+
+```bash
+rednote-cli --format json --trace-id req-001 search note --input payload.json
+cat payload.json | rednote-cli --format json --trace-id req-002 publish --input - --account user_001
+```
+
+## 文档
+
+完整文档请查看仓库根目录：
+- `README.md`
+- `DESIGN.md`
+- `DEV.md`
+- `USER_GUIDE.md`

rednote_cli-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = [
+  "setuptools>=68",
+  "wheel",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rednote-cli"
+version = "0.1.0"
+description = "Rednote platform CLI"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "playwright==1.57.0",
+  "playwright-stealth==2.0.0",
+  "yt-dlp==2025.12.8",
+  "pydantic==2.12.2",
+  "typer>=0.12.0",
+  "rich>=13.7.0",
+  "loguru==0.7.3",
+  "croniter==6.0.0",
+  "fake_useragent==2.2.0",
+]
+
+[project.scripts]
+rednote-cli = "rednote_cli.cli.main:run"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["rednote_cli*"]

rednote_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rednote_cli-0.1.0/src/rednote_cli/__init__.py

@@ -0,0 +1,5 @@
+"""Rednote Operator CLI package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

rednote_cli-0.1.0/src/rednote_cli/_runtime/common/app_utils.py

@@ -0,0 +1,77 @@
+import os
+import platform
+import sys
+from datetime import datetime
+
+
+def get_app_path(relative_path):
+    """
+    获取资源绝对路径（兼容 Dev 和 Frozen 环境）
+    
+    在 PyInstaller --onedir 模式下，macOS .app 的结构通常是：
+    OperatorRuntime.app/
+        Contents/
+            MacOS/
+                OperatorRuntime (可执行文件)
+                assets/       (如果 spec 中配置在同级)
+            Resources/        (标准 Mac 资源目录)
+            
+    我们现在的 spec 配置是将 assets 放在可执行文件同级目录。
+    """
+    if getattr(sys, 'frozen', False):
+        # 打包后的环境
+        bundle_dir = os.path.dirname(sys.executable)
+        return os.path.join(bundle_dir, relative_path)
+    else:
+        # 开发环境
+        return os.path.join(os.path.abspath("."), relative_path)
+
+
+def get_system_chrome_path():
+    """
+    获取系统已安装的 Chrome/Edge 路径，避免打包几百兆的浏览器。
+    优先查找 Chrome，其次 Edge。
+    """
+    system = platform.system()
+    paths = []
+
+    if system == "Darwin":  # macOS
+        paths = [
+            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+            "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+            # 用户可能安装在用户目录下
+            os.path.expanduser("~/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"),
+        ]
+    elif system == "Windows":
+        paths = [
+            r"C:\Program Files\Google\Chrome\Application\chrome.exe",
+            r"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe",
+            r"C:\Program Files\Microsoft\Edge\Application\msedge.exe",
+            r"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe",
+        ]
+
+    for p in paths:
+        if os.path.exists(p):
+            return p
+
+    return None
+
+
+def timestamp_to_str(ts, fmt='%Y-%m-%d %H:%M:%S', tz=None):
+    """
+    自动识别10位或13位时间戳并转为日期字符串
+    """
+    if not ts: return ts
+
+    # 如果是字符串类型的输入，先转为数字
+    try:
+        ts = int(ts)
+    except Exception:
+        return ts
+
+    # 核心逻辑：如果数值大于 1e11 (即 100,000,000,000)，通常被认为是毫秒级
+    # 10位时间戳最大到 2286年 (9999999999)
+    if ts > 10000000000:
+        ts = ts / 1000
+
+    return datetime.fromtimestamp(ts, tz=tz).strftime(fmt)

rednote_cli-0.1.0/src/rednote_cli/_runtime/common/config.py

@@ -0,0 +1,83 @@
+import os
+import platform
+from pathlib import Path
+
+
+def _read_bool_env(name: str, default: bool) -> bool:
+    raw = os.getenv(name)
+    if raw is None:
+        return default
+    text = str(raw).strip().lower()
+    if text in {"1", "true", "yes", "on"}:
+        return True
+    if text in {"0", "false", "no", "off"}:
+        return False
+    return default
+
+
+def get_app_data_dir(app_name="OperatorRuntime"):
+    """
+    Get the platform-specific user data directory.
+    """
+    system = platform.system()
+    if system == "Windows":
+        return Path(os.environ.get("APPDATA", Path.home() / "AppData" / "Roaming")) / app_name
+    elif system == "Darwin":
+        return Path.home() / "Library" / "Application Support" / app_name
+    else:
+        # Linux / Unix
+        return Path.home() / ".local" / "share" / app_name
+
+
+# Initialize paths
+APP_DATA_DIR = get_app_data_dir()
+try:
+    APP_DATA_DIR.mkdir(parents=True, exist_ok=True)
+except PermissionError:
+    # Sandbox-friendly fallback for restricted environments (tests/CI).
+    APP_DATA_DIR = Path.cwd() / ".operator_runtime_data"
+    APP_DATA_DIR.mkdir(parents=True, exist_ok=True)
+
+# Database path
+DB_FILE = APP_DATA_DIR / "operator_runtime.db"
+
+# Log path
+LOG_DIR = APP_DATA_DIR / "logs"
+LOG_DIR.mkdir(parents=True, exist_ok=True)
+LOG_FILE = LOG_DIR / "app.log"
+
+# --- 调试配置 ---
+# 默认行为：无头（生产）
+# 开发调试可通过环境变量强制有头：
+# - REDNOTE_CLI_HEADFUL=1
+# - BROWSER_HEADFUL=1
+BROWSER_HEADLESS = _read_bool_env("BROWSER_HEADLESS", True)
+_BROWSER_HEADFUL_FORCED = _read_bool_env("REDNOTE_CLI_HEADFUL", False) or _read_bool_env("BROWSER_HEADFUL", False)
+
+
+def is_browser_headful_forced() -> bool:
+    return _BROWSER_HEADFUL_FORCED
+
+
+def resolve_browser_headless(requested: bool | None = None) -> bool:
+    if _BROWSER_HEADFUL_FORCED:
+        return False
+    if requested is None:
+        return BROWSER_HEADLESS
+    return bool(requested)
+
+
+def resolve_login_mode_headless(mode: str) -> bool:
+    normalized_mode = str(mode or "").strip().lower()
+    if normalized_mode == "local":
+        # Local login is interactive by design.
+        return resolve_browser_headless(False)
+    if normalized_mode == "remote":
+        # Remote login defaults to headless, but follows BROWSER_HEADLESS env.
+        return resolve_browser_headless(None)
+    return resolve_browser_headless()
+
+# --- 浏览器环境配置 ---
+# 建议与账号真实访问地区保持一致，减少环境指纹漂移。
+BROWSER_LOCALE = os.getenv("BROWSER_LOCALE", "zh-CN")
+BROWSER_TIMEZONE = os.getenv("BROWSER_TIMEZONE", "Asia/Shanghai")

rednote_cli-0.1.0/src/rednote_cli/_runtime/common/enums.py

@@ -0,0 +1,17 @@
+from enum import Enum
+
+
+class Platform(Enum):
+    REDNOTE = "Rednote"
+    DOUYIN = "Douyin"
+    TIKTOK = "TikTok"
+
+
+class XsecSource(Enum):
+    PC_FEED = "pc_feed"  # 发现页 → 笔记；发现页 → 达人
+    PC_SEARCH = "pc_search"  # 搜索页 → 笔记；搜索页 → 达人
+    PC_COLLECT = "pc_collect"  # 达人-收藏页 → 笔记；达人-收藏页 → 达人
+    PC_LIKE = "pc_like"  # 达人-点赞页 → 笔记；达人-点赞页 → 达人
+    PC_USER = "pc_user"  # 达人-笔记页 → 笔记
+    PC_NOTE = "pc_note"  # 笔记页 → 达人
+

rednote_cli-0.1.0/src/rednote_cli/_runtime/common/errors.py

@@ -0,0 +1,22 @@
+class PublishNoteException(Exception):
+    """Base exception for publish-note workflow."""
+
+
+class InvalidPublishParameterError(PublishNoteException, ValueError):
+    """Raised when publish-note inputs are invalid."""
+
+
+class UnsupportedPublishTargetError(PublishNoteException):
+    """Raised when publish target is unsupported."""
+
+
+class PublishWorkflowNotReadyError(PublishNoteException):
+    """Raised when target exists but workflow is not implemented yet."""
+
+
+class PublishMediaPreparationError(PublishNoteException):
+    """Raised when media validation/download fails."""
+
+
+class PublishExecutionError(PublishNoteException):
+    """Raised when publish execution fails unexpectedly."""