Support XHS news card collections

README.en.md

@@ -196,7 +196,8 @@ Key fields:
 - `xhs.publish.headless`: default browser headless mode for `publish-xhs`, `--publish-xhs`, and `--prepare-xhs`
 - `xhs.publish.browser_path`: default browser executable path for `publish-xhs`, `--publish-xhs`, and `--prepare-xhs`; CLI `--chrome` can override it for one run
 - `xhs.publish.profile_dir`: default browser profile directory for `publish-xhs`, `--publish-xhs`, and `--prepare-xhs`
-- `xhs.publish.mode`: default publish mode for `publish-xhs`, `--publish-xhs`, and `--prepare-xhs`, supporting `only-self` and `schedule`; main render commands can override it for one run with `--xhs-mode`
+- `xhs.publish.mode`: publish timing/flow, not page visibility; supports `immediate` (normal immediate publish flow) and `schedule` (scheduled publish flow); main render commands can override it for one run with `--xhs-mode`
+- `xhs.publish.visibility`: Xiaohongshu page visibility, not publish timing; supports `public` and `only-self`
 - `xhs.publish.schedule_at`: default scheduled publish time for `mode: schedule`, using `YYYY-MM-DD HH:MM:SS` and parsed in Asia/Shanghai; main render commands can override it for one run with `--xhs-schedule-at`
 - `xhs.publish.topic_generation.enabled`: whether `--publish-xhs` / `--prepare-xhs` calls AI to generate 3-6 Xiaohongshu topics when `--xhs-tags` is omitted, on by default
 - `xhs.publish.title_generation.enabled`: whether `--publish-xhs` / `--prepare-xhs` calls AI to rewrite titles that exceed `max_runes`, on by default
@@ -357,8 +358,8 @@ Rules:
 
 Current behavior:
 
-- standard publish mode currently submits as only-self-visible
-- schedule mode still submits as scheduled publish
+- `immediate` mode uses the normal publish flow; page visibility is controlled separately by `visibility`
+- `schedule` mode submits a scheduled publish
 - media source is exclusive: use `--images` for standard image posts or `--live-report` for the Live pipeline
 
 ### Usage
@@ -379,7 +380,7 @@ mark2note publish-xhs --help
 - `--content <text>`: inline content text; exactly one of `--content` / `--content-file` is required
 - `--content-file <file>`: content file path
 - `--tags <csv>`: comma-separated tags
-- `--mode <name>`: publish mode, supporting `only-self` and `schedule`; when omitted it falls back to `xhs.publish.mode`, otherwise defaults to `only-self`
+- `--mode <name>`: publish timing/flow, supporting `immediate` and `schedule`; when omitted it falls back to `xhs.publish.mode`, otherwise defaults to `immediate`
 - `--schedule-at <time>`: scheduled publish time in `YYYY-MM-DD HH:MM:SS`, parsed in Asia/Shanghai; when omitted it can fall back to `xhs.publish.schedule_at`
 - `--images <csv>`: comma-separated image paths for standard image posts
 - `--live-report <file>`: Live delivery report path used to resolve publishable Live assets
@@ -420,7 +421,10 @@ xhs:
     headless: false
     browser_path: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
     profile_dir: ~/.config/mark2note/xhs/profiles/walker
-    mode: only-self
+    # mode controls publish timing/flow; values: immediate = normal immediate flow, schedule = scheduled flow.
+    mode: immediate
+    # visibility controls page visibility; values: public = public, only-self = visible only to yourself.
+    visibility: public
     schedule_at: ""
 ```
 

README.zh-CN.md

@@ -196,7 +196,8 @@ posters:
 - `xhs.publish.headless`：`publish-xhs`、`--publish-xhs` 和 `--prepare-xhs` 默认是否无头运行浏览器
 - `xhs.publish.browser_path`：`publish-xhs`、`--publish-xhs` 和 `--prepare-xhs` 默认浏览器可执行文件路径；命令行 `--chrome` 可单次覆盖
 - `xhs.publish.profile_dir`：`publish-xhs`、`--publish-xhs` 和 `--prepare-xhs` 默认浏览器 profile 目录
-- `xhs.publish.mode`：`publish-xhs`、`--publish-xhs` 和 `--prepare-xhs` 默认发布模式，支持 `only-self`、`schedule`；主渲染命令可用 `--xhs-mode` 单次覆盖
+- `xhs.publish.mode`：发布时机/流程，不控制页面可见性；支持 `immediate`（普通立即发布流程）和 `schedule`（定时发布流程）；主渲染命令可用 `--xhs-mode` 单次覆盖
+- `xhs.publish.visibility`：小红书页面可见性，不控制发布时机；支持 `public`（公开可见）和 `only-self`（仅自己可见）
 - `xhs.publish.schedule_at`：`mode: schedule` 时的默认定时发布时间，格式 `YYYY-MM-DD HH:MM:SS`，按 Asia/Shanghai 解析；主渲染命令可用 `--xhs-schedule-at` 单次覆盖
 - `xhs.publish.topic_generation.enabled`：`--publish-xhs` / `--prepare-xhs` 未传 `--xhs-tags` 时是否调用 AI 生成 3-6 个小红书话题，默认开启
 - `xhs.publish.title_generation.enabled`：`--publish-xhs` / `--prepare-xhs` 标题超过 `max_runes` 时是否调用 AI 改写标题，默认开启
@@ -380,7 +381,7 @@ mark2note publish-xhs --help
 - `--content <text>`：直接传正文；与 `--content-file` 二选一；如果提供了 `--tags`，正文可以省略
 - `--content-file <file>`：从文件读取正文；与 `--content` 二选一
 - `--tags <csv>`：逗号分隔标签列表
-- `--mode <name>`：发布模式，支持 `only-self`、`schedule`；未显式传入时，回退到 `xhs.publish.mode`，否则默认 `only-self`
+- `--mode <name>`：发布时机/流程，支持 `immediate`、`schedule`；未显式传入时，回退到 `xhs.publish.mode`，否则默认 `immediate`
 - `--schedule-at <time>`：定时发布时间，格式 `YYYY-MM-DD HH:MM:SS`，按 Asia/Shanghai 解析；未显式传入时可回退到 `xhs.publish.schedule_at`
 - `--images <csv>`：逗号分隔图片路径列表，用于普通图文发布
 - `--live-report <file>`：Live 交付报告路径，用于从 Live 导出结果里提取可发布素材
@@ -421,7 +422,10 @@ xhs:
     headless: false
     browser_path: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
     profile_dir: ~/.config/mark2note/xhs/profiles/walker
-    mode: only-self
+    # mode 控制发布时机/流程；可选值：immediate = 普通立即发布流程，schedule = 定时发布流程。
+    mode: immediate
+    # visibility 控制页面可见性；可选值：public = 公开可见，only-self = 仅自己可见。
+    visibility: public
     schedule_at: ""
 ```