rednote-cli 0.1.1__tar.gz → 0.1.3__tar.gz

rednote-cli-0.1.3/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.1
+Name: rednote-cli
+Version: 0.1.3
+Summary: Rednote platform CLI
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# rednote-cli
+
+Rednote 平台专用 CLI（独立安装、独立升级、独立发布）。
+
+## 系统要求
+
+- Python `3.12.x`
+- `pipx`
+
+## 安装
+
+```bash
+brew update
+brew upgrade python@3.12 pipx
+python3.12 --version
+pipx --version
+pipx ensurepath
+exec zsh
+
+pipx install --python python3.12 rednote-cli
+```
+
+## 升级
+
+```bash
+pipx upgrade --python python3.12 rednote-cli
+```
+
+如果历史环境用了其他 Python（例如 3.14），先重建：
+
+```bash
+pipx reinstall --python python3.12 rednote-cli
+```
+
+## 卸载
+
+```bash
+pipx uninstall 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 search note --keyword 旅行 --size 10 --sort-by latest --note-type image_text --format json
+```
+
+## 常用命令
+
+```bash
+rednote-cli search note --keyword <kw> [--size N] [--sort-by <comprehensive|latest|most_liked|most_commented|most_favorited>] [--note-type <all|video|image_text>] [--publish-time <all|day|week|half_year>] [--search-scope <all|viewed|unviewed|following>] [--location <all|local|nearby>] [--account <user_id>] [--input <file|->]
+
+rednote-cli note --note-id <id> [--xsec-token t] [--xsec-source src] [--comment-size N] [--sub-comment-size N] [--account <user_id>] [--input <file|->]
+
+rednote-cli search user --keyword <kw> [--size N] [--account <user_id>] [--input <file|->]
+
+rednote-cli user --user-id <id> [--xsec-token t] [--xsec-source src] [--account <user_id>] [--input <file|->]
+
+rednote-cli user self --account <user_id>
+
+rednote-cli publish --target image --account <account_uid> [--image-list csv] [--title t] [--content c] [--tags csv] [--schedule-at rfc3339] [--input <file|->]
+rednote-cli publish --target video --account <account_uid> [--video <path-or-url>] [--title t] [--content c] [--tags csv] [--schedule-at rfc3339] [--input <file|->]
+```
+
+## JSON 输入模式（`--input`）
+
+参数优先级固定：
+- 显式 CLI 参数 > `--input` JSON > 默认值
+
+支持 `--input` 的命令：
+- `search note`
+- `search user`
+- `note`
+- `user`
+- `publish`
+
+不支持 `--input` 的命令：
+- `init runtime`
+- `doctor run`
+- `account login|status|list|activate|deactivate|delete`
+- `user self`
+
+推荐 Agent 调用模板：
+
+```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
+```
+
+## 输出与退出码
+
+- 建议自动化调用统一使用 `--format json` + `--trace-id`
+- 退出码：`0` 成功，`2` 参数错误，`3` 认证错误，`4` 风控/限流，`5` 内部错误，`6` 超时，`7` 依赖缺失/未实现
+
+## 工作区文档
+
+- Workspace 总览：`../../README.md`

rednote-cli-0.1.3/README.md

@@ -0,0 +1,100 @@
+# rednote-cli
+
+Rednote 平台专用 CLI（独立安装、独立升级、独立发布）。
+
+## 系统要求
+
+- Python `3.12.x`
+- `pipx`
+
+## 安装
+
+```bash
+brew update
+brew upgrade python@3.12 pipx
+python3.12 --version
+pipx --version
+pipx ensurepath
+exec zsh
+
+pipx install --python python3.12 rednote-cli
+```
+
+## 升级
+
+```bash
+pipx upgrade --python python3.12 rednote-cli
+```
+
+如果历史环境用了其他 Python（例如 3.14），先重建：
+
+```bash
+pipx reinstall --python python3.12 rednote-cli
+```
+
+## 卸载
+
+```bash
+pipx uninstall 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 search note --keyword 旅行 --size 10 --sort-by latest --note-type image_text --format json
+```
+
+## 常用命令
+
+```bash
+rednote-cli search note --keyword <kw> [--size N] [--sort-by <comprehensive|latest|most_liked|most_commented|most_favorited>] [--note-type <all|video|image_text>] [--publish-time <all|day|week|half_year>] [--search-scope <all|viewed|unviewed|following>] [--location <all|local|nearby>] [--account <user_id>] [--input <file|->]
+
+rednote-cli note --note-id <id> [--xsec-token t] [--xsec-source src] [--comment-size N] [--sub-comment-size N] [--account <user_id>] [--input <file|->]
+
+rednote-cli search user --keyword <kw> [--size N] [--account <user_id>] [--input <file|->]
+
+rednote-cli user --user-id <id> [--xsec-token t] [--xsec-source src] [--account <user_id>] [--input <file|->]
+
+rednote-cli user self --account <user_id>
+
+rednote-cli publish --target image --account <account_uid> [--image-list csv] [--title t] [--content c] [--tags csv] [--schedule-at rfc3339] [--input <file|->]
+rednote-cli publish --target video --account <account_uid> [--video <path-or-url>] [--title t] [--content c] [--tags csv] [--schedule-at rfc3339] [--input <file|->]
+```
+
+## JSON 输入模式（`--input`）
+
+参数优先级固定：
+- 显式 CLI 参数 > `--input` JSON > 默认值
+
+支持 `--input` 的命令：
+- `search note`
+- `search user`
+- `note`
+- `user`
+- `publish`
+
+不支持 `--input` 的命令：
+- `init runtime`
+- `doctor run`
+- `account login|status|list|activate|deactivate|delete`
+- `user self`
+
+推荐 Agent 调用模板：
+
+```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
+```
+
+## 输出与退出码
+
+- 建议自动化调用统一使用 `--format json` + `--trace-id`
+- 退出码：`0` 成功，`2` 参数错误，`3` 认证错误，`4` 风控/限流，`5` 内部错误，`6` 超时，`7` 依赖缺失/未实现
+
+## 工作区文档
+
+- Workspace 总览：`../../README.md`

{rednote-cli-0.1.1 → rednote-cli-0.1.3}/pyproject.toml

@@ -7,10 +7,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rednote-cli"
-version = "0.1.1"
+version = "0.1.3"
 description = "Rednote platform CLI"
 readme = "README.md"
-requires-python = "==3.12"
+requires-python = ">=3.12"
 dependencies = [
   "playwright==1.58.0",
   "playwright-stealth==2.0.2",

{rednote-cli-0.1.1 → rednote-cli-0.1.3}/src/rednote_cli/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.0"
+__version__ = "0.1.3"

{rednote-cli-0.1.1 → rednote-cli-0.1.3}/src/rednote_cli/cli/main.py

@@ -7,6 +7,7 @@ from loguru import logger
 
 from rednote_cli._runtime.common.config import is_browser_headful_forced
 from rednote_cli._runtime.core.database.manager import init_db
+from rednote_cli import __version__
 from rednote_cli.adapters.platform.rednote.runtime_registration import register_rednote_runtime
 from rednote_cli.cli.commands import account, doctor, init, note, publish, search, user
 from rednote_cli.cli.options import CliContext
@@ -47,12 +48,21 @@ app.add_typer(search.app, name="search")
 app.add_typer(publish.app, name="publish")
 
 
+def _version_callback(value: bool) -> None:
+    if not value:
+        return
+
+    typer.echo(__version__)
+    raise typer.Exit(code=0)
+
+
 @app.callback()
 def main(
     ctx: typer.Context,
     format: str = typer.Option("table", "--format", help="输出格式：json(推荐给 Agent) | jsonl(流式) | table(人工查看)"),
     out: str | None = typer.Option(None, "--out", help="将最终输出写入文件；stderr 日志不受影响"),
     quiet: bool = typer.Option(False, "--quiet", help="静默日志，仅输出结果"),
+    version: bool = typer.Option(False, "--version", callback=_version_callback, is_eager=True, help="显示 rednote-cli 版本并退出"),
     trace_id: str | None = typer.Option(None, "--trace-id", help="请求链路 ID，方便排查和关联日志/结果；建议外部系统全程透传"),
     timeout: int = typer.Option(120, "--timeout", help="命令超时（秒）"),
 ):
@@ -90,7 +100,7 @@ def _normalize_global_options_position() -> None:
 
     command_names = {"init", "doctor", "account", "note", "user", "search", "publish"}
     value_options = {"--format", "--out", "--trace-id", "--timeout"}
-    flag_options = {"--quiet"}
+    flag_options = {"--quiet", "--version"}
     all_options = value_options | flag_options
 
     raw_args = sys.argv[1:]

rednote-cli-0.1.3/src/rednote_cli.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.1
+Name: rednote-cli
+Version: 0.1.3
+Summary: Rednote platform CLI
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# rednote-cli
+
+Rednote 平台专用 CLI（独立安装、独立升级、独立发布）。
+
+## 系统要求
+
+- Python `3.12.x`
+- `pipx`
+
+## 安装
+
+```bash
+brew update
+brew upgrade python@3.12 pipx
+python3.12 --version
+pipx --version
+pipx ensurepath
+exec zsh
+
+pipx install --python python3.12 rednote-cli
+```
+
+## 升级
+
+```bash
+pipx upgrade --python python3.12 rednote-cli
+```
+
+如果历史环境用了其他 Python（例如 3.14），先重建：
+
+```bash
+pipx reinstall --python python3.12 rednote-cli
+```
+
+## 卸载
+
+```bash
+pipx uninstall 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 search note --keyword 旅行 --size 10 --sort-by latest --note-type image_text --format json
+```
+
+## 常用命令
+
+```bash
+rednote-cli search note --keyword <kw> [--size N] [--sort-by <comprehensive|latest|most_liked|most_commented|most_favorited>] [--note-type <all|video|image_text>] [--publish-time <all|day|week|half_year>] [--search-scope <all|viewed|unviewed|following>] [--location <all|local|nearby>] [--account <user_id>] [--input <file|->]
+
+rednote-cli note --note-id <id> [--xsec-token t] [--xsec-source src] [--comment-size N] [--sub-comment-size N] [--account <user_id>] [--input <file|->]
+
+rednote-cli search user --keyword <kw> [--size N] [--account <user_id>] [--input <file|->]
+
+rednote-cli user --user-id <id> [--xsec-token t] [--xsec-source src] [--account <user_id>] [--input <file|->]
+
+rednote-cli user self --account <user_id>
+
+rednote-cli publish --target image --account <account_uid> [--image-list csv] [--title t] [--content c] [--tags csv] [--schedule-at rfc3339] [--input <file|->]
+rednote-cli publish --target video --account <account_uid> [--video <path-or-url>] [--title t] [--content c] [--tags csv] [--schedule-at rfc3339] [--input <file|->]
+```
+
+## JSON 输入模式（`--input`）
+
+参数优先级固定：
+- 显式 CLI 参数 > `--input` JSON > 默认值
+
+支持 `--input` 的命令：
+- `search note`
+- `search user`
+- `note`
+- `user`
+- `publish`
+
+不支持 `--input` 的命令：
+- `init runtime`
+- `doctor run`
+- `account login|status|list|activate|deactivate|delete`
+- `user self`
+
+推荐 Agent 调用模板：
+
+```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
+```
+
+## 输出与退出码
+
+- 建议自动化调用统一使用 `--format json` + `--trace-id`
+- 退出码：`0` 成功，`2` 参数错误，`3` 认证错误，`4` 风控/限流，`5` 内部错误，`6` 超时，`7` 依赖缺失/未实现
+
+## 工作区文档
+
+- Workspace 总览：`../../README.md`

rednote-cli-0.1.1/PKG-INFO

@@ -1,76 +0,0 @@
-Metadata-Version: 2.1
-Name: rednote-cli
-Version: 0.1.1
-Summary: Rednote platform CLI
-Requires-Python: ==3.12
-Description-Content-Type: text/markdown
-
-# rednote-cli
-
-Rednote 平台专用 CLI 包（独立安装、独立升级）。
-
-## 安装
-
-```bash
-brew install pipx
-pipx ensurepath
-exec zsh
-
-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.1/README.md

@@ -1,69 +0,0 @@
-# rednote-cli
-
-Rednote 平台专用 CLI 包（独立安装、独立升级）。
-
-## 安装
-
-```bash
-brew install pipx
-pipx ensurepath
-exec zsh
-
-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.1/src/rednote_cli.egg-info/PKG-INFO

@@ -1,76 +0,0 @@
-Metadata-Version: 2.1
-Name: rednote-cli
-Version: 0.1.1
-Summary: Rednote platform CLI
-Requires-Python: ==3.12
-Description-Content-Type: text/markdown
-
-# rednote-cli
-
-Rednote 平台专用 CLI 包（独立安装、独立升级）。
-
-## 安装
-
-```bash
-brew install pipx
-pipx ensurepath
-exec zsh
-
-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`