aiconductor-cli 1.5.1 → 1.7.0

package/README.md

@@ -1,419 +1,565 @@
-# AIConductor CLI
-
-AIConductor 平台命令行工具箱，提供内容选题简报、网页发布、搜索、抖音数据和小红书工具。
-
-## 安装
-
-```bash
-npm install -g aiconductor-cli
-```
-
-**Node.js >= 18.0.0** 环境。
-
-## 配置 API Key
-
-前往 [https://dev.aiconductor.fun/register](https://dev.aiconductor.fun/register) 注册获取 API Key，然后配置环境变量：
-
-**macOS / Linux：**
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-**Windows PowerShell：**
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-> 也可在项目目录创建 `.env` 文件写入 `AICONDUCTOR_API_KEY=your-api-key`。
-
-## 命令
-
-### 发布 HTML 网页
-
-```bash
-aiconductor-cli html publish <HTML代码或文件路径> [选项]
-```
-
-| 选项 | 说明 |
-|------|------|
-| `-t, --title` | 文档标题，用作文件名基础 |
-| `-k, --api-key` | API Key（可选，默认读取环境变量） |
-| `-f, --format` | 输出格式：`json`（默认）或 `text` |
-
-示例：
-```bash
-aiconductor-cli html publish index.html -t my-page
-aiconductor-cli html publish "<h1>Hello</h1>" -t hello-page -f text
-```
-
-### 发布 Markdown/HTML 网页（推荐）
-
-`webpage publish` 是统一的网页发布命令，自动识别 Markdown 和 HTML 并发布为在线网页。
-
-```bash
-aiconductor-cli webpage publish <Markdown/HTML代码或文件路径> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-t, --title` | 文件名（不含 .html 后缀） | 自动生成 |
-| `-k, --api-key` | API Key（可选） | 环境变量 |
-| `--type` | 强制指定类型：`md` 或 `html` | 自动识别 |
-| `--copy-button` | 为代码块添加复制按钮（仅 Markdown） | 关闭 |
-| `-f, --format` | 输出格式：`json` 或 `text` | json |
-
-示例：
-```bash
-# 发布 Markdown 文件
-aiconductor-cli webpage publish README.md -t docs
-
-# 发布 Markdown 并添加代码复制按钮
-aiconductor-cli webpage publish article.md -t article --copy-button
-
-# 发布 HTML 文件
-aiconductor-cli webpage publish index.html -t my-page
-
-# 直接传入内容字符串
-aiconductor-cli webpage publish "# Hello\n\nThis is **markdown**" -t hello
-```
-
-### 管理已发布网页
-
-查询当前 API Key 所属用户的网页发布记录：
-
-```bash
-aiconductor-cli webpage list [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--page` | 页码，最小为 1 | 1 |
-| `--page-size` | 每页条数，范围为 1 到 100 | 20 |
-| `-k, --api-key` | API Key（可选） | 环境变量 |
-| `-f, --format` | 输出格式：`json` 或 `text` | json |
-
-删除指定的已发布网页及其公开 HTML 对象：
-
-```bash
-aiconductor-cli webpage delete <webpage_id> [选项]
-```
-
-示例：
-```bash
-# 查看第 2 页，每页 50 条
-aiconductor-cli webpage list --page 2 --page-size 50 -f text
-
-# 删除 ID 为 123 的网页
-aiconductor-cli webpage delete 123
-```
-
-### 网页搜索
-
-```bash
-aiconductor-cli search web <关键词> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-n, --count` | 返回条数（最多50） | 10 |
-| `--time-range` | 时间范围：预设 `OneDay`/`OneWeek`/`OneMonth`/`OneYear`，或自定义 `YYYY-MM-DD..YYYY-MM-DD` | 无 |
-| `--need-content` | 仅返回包含正文的结果 | 关闭 |
-| `--need-url` | 仅返回带原文链接的结果 | 关闭 |
-| `--sites` | 限定搜索站点，完整域名以 `\|` 分隔，最多20个 | 无 |
-| `--block-hosts` | 屏蔽站点，完整域名以 `\|` 分隔，最多5个 | 无 |
-| `--auth-info-level` | 权威度过滤：0=不限制，1=仅非常权威内容 | 0 |
-| `--auth-level` | `--auth-info-level` 的兼容别名 | 无 |
-| `--content-format` | 正文格式：`text` 或 `markdown` | text |
-| `--industry` | 行业搜索：`finance`、`game` 或 `gov` | 无 |
-| `--query-rewrite` | 开启 Query 改写 | 关闭 |
-| `-f, --format` | 输出格式：`json` 或 `text` | json |
-
-示例：
-```bash
-aiconductor-cli search web "北京今日天气" -n 3 --auth-info-level 1 --need-url
-aiconductor-cli search web "AI 最新进展" --time-range OneWeek --content-format markdown --need-content
-aiconductor-cli search web "技术文章" --time-range 2025-01-01..2025-06-30 -n 10
-```
-
-### 图片搜索
-
-```bash
-aiconductor-cli search image <关键词> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-n, --count` | 返回条数（最多5） | 5 |
-| `--image-width-min` | 图片最小宽度 | 无 |
-| `--image-width-max` | 图片最大宽度 | 无 |
-| `--image-height-min` | 图片最小高度 | 无 |
-| `--image-height-max` | 图片最大高度 | 无 |
-| `--image-shapes` | 图片形状，以 `\|` 分隔：`横长方形`、`竖长方形`、`方形` | 无 |
-| `--query-rewrite` | 开启 Query 改写 | 关闭 |
-| `-f, --format` | 输出格式：`json` 或 `text` | json |
-
-示例：
-```bash
-aiconductor-cli search image "长城风景" -n 3 --image-width-min 1200 --image-shapes "横长方形|方形" -f text
-```
-
-### 热点选题简报
-
-聚合多个平台热点与小红书实时热榜，为内容选题提供带来源链接的原料。默认查询知乎、微博、抖音和 AIHOT，每个来源返回 30 条，并额外请求一次小红书热榜。
-
-```bash
-aiconductor-cli content briefing [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--sources <ids>` | 来源 ID，逗号分隔；例如 `zhihu,weibo,aihot` | `zhihu,weibo,douyin,aihot` |
-| `--limit <n>` | 每个来源返回条数，范围 1 到 30 | 30 |
-| `-k, --api-key <key>` | API Key（可选） | 环境变量 |
-| `-f, --format <format>` | 输出格式：`json` 或 `text` | json |
-
-示例：
-```bash
-# 默认综合热点简报
-aiconductor-cli content briefing -f text
-
-# 只查看技术与产品来源
-aiconductor-cli content briefing --sources aihot,hackernews,producthunt,juejin --limit 15 -f text
-```
-
-默认 JSON 输出保留以下字段，便于后续选题处理：
-
-- `data.data.sources`：成功的综合热榜来源，兼容旧版本。
-- `data.data.failed_sources`：综合热榜中失败的平台来源。
-- `data.data.xhs_hot_list`：小红书热榜结果，包含日期与话题条目；小红书热榜接口失败时为 `null`。
-- `data.data.failed_services`：综合热榜或小红书热榜接口级失败信息。
-
-任一服务成功时命令仍会返回可用数据；只有两个服务都失败时才退出失败。成功来源和成功的小红书热榜调用均按平台现有规则计费。
-
-### 抖音数据工具箱
-
-```bash
-aiconductor-cli douyin <子命令> [参数] [选项]
-```
-
-#### 获取作品详情
-
-```bash
-aiconductor-cli douyin video-info <分享链接> [选项]
-```
-
-示例：
-```bash
-aiconductor-cli douyin video-info "https://v.douyin.com/xxxxx/"
-```
-
-#### 获取作品评论
-
-```bash
-aiconductor-cli douyin video-comments <视频URL> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-count` | 获取评论数量 | 50 |
-| `-f, --format` | 输出格式 | json |
-
-示例：
-```bash
-aiconductor-cli douyin video-comments "https://www.douyin.com/video/xxxxx" --max-count 100
-```
-
-#### 获取用户视频列表
-
-```bash
-aiconductor-cli douyin user-videos <用户主页URL> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages` | 最大页数 | 1 |
-| `--max-seconds` | 最长运行时间（秒），最大 180 | 50 |
-| `-f, --format` | 输出格式 | json |
-
-示例：
-```bash
-aiconductor-cli douyin user-videos "https://www.douyin.com/user/xxxxx" --max-pages 3
-```
-
-#### 获取用户详情
-
-```bash
-aiconductor-cli douyin user-detail <用户主页URL> [选项]
-```
-
-示例：
-```bash
-aiconductor-cli douyin user-detail "https://www.douyin.com/user/xxxxx"
-```
-
-#### 搜索用户
-
-```bash
-aiconductor-cli douyin user-search <关键词> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages` | 最大页数，0=不限制 | 1 |
-| `--max-seconds` | 最长运行时间（秒），最大 180 | 50 |
-| `--fans-range` | 粉丝数筛选：`0_1k`/`1k_1w`/`1w_10w`/`10w_100w`/`100w_` | 无 |
-| `--user-type` | 用户类型：`common_user`/`enterprise_user`/`personal_user` | 无 |
-| `-f, --format` | 输出格式 | json |
-
-示例：
-```bash
-aiconductor-cli douyin user-search "美食博主" --fans-range 10w_100w --user-type personal_user
-```
-
-#### 搜索视频
-
-```bash
-aiconductor-cli douyin video-search <关键词> [选项]
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages` | 最大页数，0=不限制 | 1 |
-| `--max-seconds` | 最长运行时间（秒），最大 50 | 50 |
-| `--sort-type` | 排序：0=综合，1=最多点赞，2=最新发布 | 0 |
-| `--publish-time` | 发布时间：0=不限，1=一天，7=一周，180=半年 | 0 |
-| `--filter-duration` | 时长：0=不限，0-1=1分钟内，1-5=1-5分钟，5-10000=5分钟以上 | 0 |
-| `--content-type` | 内容类型：0=不限，1=视频，2=图片，3=文章 | 0 |
-| `-f, --format` | 输出格式 | json |
-
-示例：
-```bash
-aiconductor-cli douyin video-search "编程教程" --sort-type 2 --publish-time 7 --content-type 1
-```
-
-#### 视频链接转文字
-
-```bash
-aiconductor-cli douyin link-to-text <视频URL> [选项]
-```
-
-示例：
-```bash
-aiconductor-cli douyin link-to-text "https://www.douyin.com/video/xxxxx"
-```
-
-### 小红书数据工具
-
-获取小红书实时热榜：
-
-```bash
-aiconductor-cli xhs hot-list [选项]
-```
-
-示例：
-```bash
-aiconductor-cli xhs hot-list -f text
-```
-
-### 小红书扫码发布
-
-生成图文或视频笔记的 H5 发布页与二维码。素材支持公网 URL、本地文件、Base64/data URL，以及包含 Base64 内容的文本文件。
-
-```bash
-# 图文：URL 与本地图片混用
-aiconductor-cli xhs note-publish normal \
-  --title "笔记标题" \
-  --images "https://example.com/photo1.jpg" \
-  --image-file "./photo2.jpg" \
-  --image-file "./photo3.png"
-
-# 图文：较大 Base64 写入文本文件后使用 @路径
-aiconductor-cli xhs note-publish normal \
-  --image-base64 "@./photo-base64.txt"
-
-# 视频：本地视频与本地封面
-aiconductor-cli xhs note-publish video \
-  --title "视频标题" \
-  --video-file "./video.mp4" \
-  --cover-file "./cover.jpg"
-```
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--images <urls>` | 图片 URL 列表，逗号分隔 | 无 |
-| `--image-file <path>` | 本地图片路径，可重复使用 | 无 |
-| `--image-base64 <data>` | 图片 Base64、data URL 或 `@文本文件`，可重复使用 | 无 |
-| `--video <url>` | 视频 URL | 无 |
-| `--video-file <path>` | 本地视频路径 | 无 |
-| `--video-base64 <data>` | 视频 Base64、data URL 或 `@文本文件` | 无 |
-| `--cover <url>` | 视频封面 URL | 无 |
-| `--cover-file <path>` | 本地视频封面路径 | 无 |
-| `--cover-base64 <data>` | 封面 Base64、data URL 或 `@文本文件` | 无 |
-| `--upload-valid-days <days>` | 本地/Base64 素材临时链接有效期：1 或 7 天 | 7 |
-
-本地文件会在 CLI 内转换成 data URL，与 Base64 素材统一通过 JSON 接口免费上传为临时公开 URL，不使用 multipart。图片合计最多 18 张、单张最多 32MB；本地/Base64 视频受上传接口限制为 100MB，URL 视频上限为 200MB。
-
-### 微信公众号数据工具
-
-两个子命令：取单篇文章的互动数据、取公众号历史文章列表。
-
-```bash
-# 单篇文章互动数据（阅读 / 点赞 / 在看 等）
-aiconductor-cli wx article-data "https://mp.weixin.qq.com/s?__biz=xxxx&mid=xxxx&idx=1&sn=xxxx"
-
-# 公众号历史文章列表：用公众号名称或任意一篇文章链接定位
-aiconductor-cli wx history --name "人民日报" --max-pages 3 --max-seconds 50
-aiconductor-cli wx history "https://mp.weixin.qq.com/s?__biz=xxxx" -f text
-```
-
-| 选项 | 适用命令 | 说明 | 默认值 |
-|------|----------|------|--------|
-| `--name <name>` | `history` | 公众号名称或微信 ID（与 `url` 至少提供一个） | 无 |
-| `--max-pages <n>` | `history` | 最大翻页数量 | 1 |
-| `--max-seconds <n>` | `history` | 最长运行时间（秒），上限 170 | 50 |
-
-返回路径：`article-data` 的互动数据在 `data.data`（`read` / `zan` / `looking` / `share_num` / `collect_num` / `comment_count`，text 模式渲染成阅读/点赞/在看/分享/收藏/评论，未知字段原样输出）；`history` 的文章在 `data.data.data[]`（标题 `title`、时间 `post_time_str`、阅读 `read`、点赞 `zan`、链接 `url`）。
-
-`history` 另带 `data.data.code`（上游返回码）：`0` 才表示成功；非 0（如 `107` 名称/链接对不上、`20001` 平台侧上游故障）时 CLI 以退出码 1 报 `api_error`，不会用空列表冒充成功。
-
-### 通用选项
-
-所有命令支持：
-- `-k, --api-key <key>` — API Key（优先级：参数 > 环境变量 > .env 文件）
-- `-f, --format <json|text>` — 输出格式，默认 JSON
-
-## 计费
-
-| 功能 | 价格 |
-|------|------|
-| HTML 发布 | 0.01 元/次 |
-| Markdown/HTML 网页发布 | 0.01 元/次 |
-| 豆包网页/图片搜索 | 0.02 元/次 |
-| 抖音作品详情 | 0.01 元/次 |
-| 抖音作品评论 | 0.01 元/次 |
-| 抖音用户视频列表 | 0.03 元/页 |
-| 抖音用户详情 | 0.03 元/次 |
-| 抖音用户搜索 | 0.15 元/页 |
-| 抖音视频搜索 | 0.15 元/页 |
-| 抖音链接转文字 | 0.01 元/次 + 0.0003 元/秒 |
-| 小红书热榜 | 以平台服务配置为准 |
-| 小红书扫码发布 | 0.05 元/次 |
-| 公众号文章互动数据 | 以平台服务配置为准（按次） |
-| 公众号历史文章列表 | 以平台服务配置为准（按成功翻页数） |
-
-> 搜索/调用失败不扣费，仅成功时计费。
-
-## 开发
-
-```bash
-git clone https://github.com/huyi9531/aiconductor-cli.git
-cd aiconductor-cli
-npm install
-node bin/aiconductor-cli.js --help    # 本地运行
-```
-
-贡献前请阅读 [AGENTS.md](./AGENTS.md) 了解项目结构、编码风格与提交流程。
-
-## License
-
-MIT
+# AIConductor CLI
+
+AIConductor 平台命令行工具箱，提供内容选题简报、网页发布、搜索、抖音数据和小红书工具。
+
+## 安装
+
+```bash
+npm install -g aiconductor-cli
+```
+
+**Node.js >= 18.0.0** 环境。
+
+## 配置 API Key
+
+前往 [https://dev.aiconductor.fun/register](https://dev.aiconductor.fun/register) 注册获取 API Key，然后配置环境变量：
+
+**macOS / Linux：**
+```bash
+echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
+```
+
+**Windows PowerShell：**
+```powershell
+[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
+```
+
+> 也可在项目目录创建 `.env` 文件写入 `AICONDUCTOR_API_KEY=your-api-key`。
+
+## 命令
+
+### 发布 HTML 网页
+
+```bash
+aiconductor-cli html publish <HTML代码或文件路径> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-t, --title` | 文档标题，用作文件名基础 |
+| `-k, --api-key` | API Key（可选，默认读取环境变量） |
+| `-f, --format` | 输出格式：`json`（默认）或 `text` |
+
+示例：
+```bash
+aiconductor-cli html publish index.html -t my-page
+aiconductor-cli html publish "<h1>Hello</h1>" -t hello-page -f text
+```
+
+### 发布 Markdown/HTML 网页（推荐）
+
+`webpage publish` 是统一的网页发布命令，自动识别 Markdown 和 HTML 并发布为在线网页。
+
+```bash
+aiconductor-cli webpage publish <Markdown/HTML代码或文件路径> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-t, --title` | 文件名（不含 .html 后缀） | 自动生成 |
+| `-k, --api-key` | API Key（可选） | 环境变量 |
+| `--type` | 强制指定类型：`md` 或 `html` | 自动识别 |
+| `--copy-button` | 为代码块添加复制按钮（仅 Markdown） | 关闭 |
+| `-f, --format` | 输出格式：`json` 或 `text` | json |
+
+示例：
+```bash
+# 发布 Markdown 文件
+aiconductor-cli webpage publish README.md -t docs
+
+# 发布 Markdown 并添加代码复制按钮
+aiconductor-cli webpage publish article.md -t article --copy-button
+
+# 发布 HTML 文件
+aiconductor-cli webpage publish index.html -t my-page
+
+# 直接传入内容字符串
+aiconductor-cli webpage publish "# Hello\n\nThis is **markdown**" -t hello
+```
+
+### 管理已发布网页
+
+查询当前 API Key 所属用户的网页发布记录：
+
+```bash
+aiconductor-cli webpage list [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--page` | 页码，最小为 1 | 1 |
+| `--page-size` | 每页条数，范围为 1 到 100 | 20 |
+| `-k, --api-key` | API Key（可选） | 环境变量 |
+| `-f, --format` | 输出格式：`json` 或 `text` | json |
+
+删除指定的已发布网页及其公开 HTML 对象：
+
+```bash
+aiconductor-cli webpage delete <webpage_id> [选项]
+```
+
+示例：
+```bash
+# 查看第 2 页，每页 50 条
+aiconductor-cli webpage list --page 2 --page-size 50 -f text
+
+# 删除 ID 为 123 的网页
+aiconductor-cli webpage delete 123
+```
+
+### 网页搜索
+
+```bash
+aiconductor-cli search web <关键词> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-n, --count` | 返回条数（最多50） | 10 |
+| `--time-range` | 时间范围：预设 `OneDay`/`OneWeek`/`OneMonth`/`OneYear`，或自定义 `YYYY-MM-DD..YYYY-MM-DD` | 无 |
+| `--need-content` | 仅返回包含正文的结果 | 关闭 |
+| `--need-url` | 仅返回带原文链接的结果 | 关闭 |
+| `--sites` | 限定搜索站点，完整域名以 `\|` 分隔，最多20个 | 无 |
+| `--block-hosts` | 屏蔽站点，完整域名以 `\|` 分隔，最多5个 | 无 |
+| `--auth-info-level` | 权威度过滤：0=不限制，1=仅非常权威内容 | 0 |
+| `--auth-level` | `--auth-info-level` 的兼容别名 | 无 |
+| `--content-format` | 正文格式：`text` 或 `markdown` | text |
+| `--industry` | 行业搜索：`finance`、`game` 或 `gov` | 无 |
+| `--query-rewrite` | 开启 Query 改写 | 关闭 |
+| `-f, --format` | 输出格式：`json` 或 `text` | json |
+
+示例：
+```bash
+aiconductor-cli search web "北京今日天气" -n 3 --auth-info-level 1 --need-url
+aiconductor-cli search web "AI 最新进展" --time-range OneWeek --content-format markdown --need-content
+aiconductor-cli search web "技术文章" --time-range 2025-01-01..2025-06-30 -n 10
+```
+
+### 图片搜索
+
+```bash
+aiconductor-cli search image <关键词> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-n, --count` | 返回条数（最多5） | 5 |
+| `--image-width-min` | 图片最小宽度 | 无 |
+| `--image-width-max` | 图片最大宽度 | 无 |
+| `--image-height-min` | 图片最小高度 | 无 |
+| `--image-height-max` | 图片最大高度 | 无 |
+| `--image-shapes` | 图片形状，以 `\|` 分隔：`横长方形`、`竖长方形`、`方形` | 无 |
+| `--query-rewrite` | 开启 Query 改写 | 关闭 |
+| `-f, --format` | 输出格式：`json` 或 `text` | json |
+
+示例：
+```bash
+aiconductor-cli search image "长城风景" -n 3 --image-width-min 1200 --image-shapes "横长方形|方形" -f text
+```
+
+### 热点选题简报
+
+聚合多个平台热点与小红书实时热榜，为内容选题提供带来源链接的原料。默认查询知乎、微博、抖音和 AIHOT，每个来源返回 30 条，并额外请求一次小红书热榜。
+
+```bash
+aiconductor-cli content briefing [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--sources <ids>` | 来源 ID，逗号分隔；例如 `zhihu,weibo,aihot` | `zhihu,weibo,douyin,aihot` |
+| `--limit <n>` | 每个来源返回条数，范围 1 到 30 | 30 |
+| `-k, --api-key <key>` | API Key（可选） | 环境变量 |
+| `-f, --format <format>` | 输出格式：`json` 或 `text` | json |
+
+示例：
+```bash
+# 默认综合热点简报
+aiconductor-cli content briefing -f text
+
+# 只查看技术与产品来源
+aiconductor-cli content briefing --sources aihot,hackernews,producthunt,juejin --limit 15 -f text
+```
+
+默认 JSON 输出保留以下字段，便于后续选题处理：
+
+- `data.data.sources`：成功的综合热榜来源，兼容旧版本。
+- `data.data.failed_sources`：综合热榜中失败的平台来源。
+- `data.data.xhs_hot_list`：小红书热榜结果，包含日期与话题条目；小红书热榜接口失败时为 `null`。
+- `data.data.failed_services`：综合热榜或小红书热榜接口级失败信息。
+
+任一服务成功时命令仍会返回可用数据；只有两个服务都失败时才退出失败。成功来源和成功的小红书热榜调用均按平台现有规则计费。
+
+### 抖音数据工具箱
+
+```bash
+aiconductor-cli douyin <子命令> [参数] [选项]
+```
+
+#### 获取作品详情
+
+```bash
+aiconductor-cli douyin video-info <分享链接> [选项]
+```
+
+示例：
+```bash
+aiconductor-cli douyin video-info "https://v.douyin.com/xxxxx/"
+```
+
+#### 获取作品评论
+
+```bash
+aiconductor-cli douyin video-comments <视频URL> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--max-count` | 获取评论数量 | 50 |
+| `-f, --format` | 输出格式 | json |
+
+示例：
+```bash
+aiconductor-cli douyin video-comments "https://www.douyin.com/video/xxxxx" --max-count 100
+```
+
+#### 获取用户视频列表
+
+```bash
+aiconductor-cli douyin user-videos <用户主页URL> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--max-pages` | 最大页数 | 1 |
+| `--max-seconds` | 最长运行时间（秒），最大 180 | 50 |
+| `-f, --format` | 输出格式 | json |
+
+示例：
+```bash
+aiconductor-cli douyin user-videos "https://www.douyin.com/user/xxxxx" --max-pages 3
+```
+
+#### 获取用户详情
+
+```bash
+aiconductor-cli douyin user-detail <用户主页URL> [选项]
+```
+
+示例：
+```bash
+aiconductor-cli douyin user-detail "https://www.douyin.com/user/xxxxx"
+```
+
+#### 搜索用户
+
+```bash
+aiconductor-cli douyin user-search <关键词> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--max-pages` | 最大页数，0=不限制 | 1 |
+| `--max-seconds` | 最长运行时间（秒），最大 180 | 50 |
+| `--fans-range` | 粉丝数筛选：`0_1k`/`1k_1w`/`1w_10w`/`10w_100w`/`100w_` | 无 |
+| `--user-type` | 用户类型：`common_user`/`enterprise_user`/`personal_user` | 无 |
+| `-f, --format` | 输出格式 | json |
+
+示例：
+```bash
+aiconductor-cli douyin user-search "美食博主" --fans-range 10w_100w --user-type personal_user
+```
+
+#### 搜索视频
+
+```bash
+aiconductor-cli douyin video-search <关键词> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--max-pages` | 最大页数，0=不限制 | 1 |
+| `--max-seconds` | 最长运行时间（秒），最大 50 | 50 |
+| `--sort-type` | 排序：0=综合，1=最多点赞，2=最新发布 | 0 |
+| `--publish-time` | 发布时间：0=不限，1=一天，7=一周，180=半年 | 0 |
+| `--filter-duration` | 时长：0=不限，0-1=1分钟内，1-5=1-5分钟，5-10000=5分钟以上 | 0 |
+| `--content-type` | 内容类型：0=不限，1=视频，2=图片，3=文章 | 0 |
+| `-f, --format` | 输出格式 | json |
+
+示例：
+```bash
+aiconductor-cli douyin video-search "编程教程" --sort-type 2 --publish-time 7 --content-type 1
+```
+
+#### 视频链接转文字
+
+```bash
+aiconductor-cli douyin link-to-text <视频URL> [选项]
+```
+
+示例：
+```bash
+aiconductor-cli douyin link-to-text "https://www.douyin.com/video/xxxxx"
+```
+
+#### 原画下载
+
+```bash
+aiconductor-cli douyin video-original <视频URL|分享文案|作品ID> [选项]
+```
+
+拿最高画质（原画）直链与文件大小，和普通清晰度的 `Get_Download_Url` 是两个档位。
+
+```bash
+aiconductor-cli douyin video-original "https://www.douyin.com/video/7669664934044795354" -f text
+aiconductor-cli douyin video-original "https://v.douyin.com/xxxxx/"
+```
+
+返回路径：`data.data.url`（直链）/ `file_size` / `file_size_mb` / `content_type` / `video_id`。
+
+> **直链有时效**（带签名的 CDN 地址，过期返回 403），拿到就下，不要当永久地址存。实测一条作品的原画是 219 MB，下载侧请自行限流。
+
+#### 选题雷达
+
+```bash
+aiconductor-cli douyin topic-radar [选项]
+```
+
+并行调用 `douyin_hot_words`（热词榜）、`douyin_hot_topics`（当前热点 + 飙升话题）、`douyin_rising_topics`（飙升热点）三个原子接口并在本地合并——**任一段失败仍照常输出其余两段**，失败段写在 `data.failed_sources`。
+
+```bash
+aiconductor-cli douyin topic-radar -f text
+aiconductor-cli douyin topic-radar --limit 5
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-n, --limit <n>` | 飙升榜条数（1~20） | 10 |
+
+返回路径：`data.data.hot_words`（`keyword` / `hot_index` / `trend_label`）、`data.data.hot_topics` 与 `data.data.rocketing_topics`（`topic_name` / `category` / `vv` / `content_cnt`）、`data.data.rising`（`sentence` / `hot_score` / `trend[]`）、`data.data.failed_sources`。
+
+计费：三个原子接口各自按次计费（全成功合计 ¥0.15），CLI 不额外收费、也不打折。
+
+### 小红书数据工具
+
+获取小红书实时热榜：
+
+```bash
+aiconductor-cli xhs hot-list [选项]
+```
+
+示例：
+```bash
+aiconductor-cli xhs hot-list -f text
+```
+
+#### 笔记详情 `xhs note`
+
+```bash
+aiconductor-cli xhs note <ref> [选项]
+```
+
+`ref` 支持笔记链接、`xhslink.cn`/`xhslink.com` 短链、完整分享口令，或 24 位 `note_id`。
+
+```bash
+aiconductor-cli xhs note "https://www.xiaohongshu.com/discovery/item/6ae972260000000015020d84" -f text
+aiconductor-cli xhs note "标题 https://xhslink.cn/o/85lbqBJtO94 复制内容，然后进入【小红书】查看相关笔记。"
+```
+
+#### 笔记评论 `xhs comments`
+
+```bash
+aiconductor-cli xhs comments <ref> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--max-pages <n>` | 最大翻页数，范围 1~5 | 1 |
+| `--max-seconds <n>` | 最长运行时间（秒），上限 170 | 50 |
+
+返回一级评论，并带上上游可见的楼内回复（`sub_comments`）。`data.data.comments[]` 里 `like_count`、`sub_comment_count` 是**字符串**，评论的 `user` 对象用 `userid`/`original_name`（与笔记的 `user_id`/`nickname` 不同）。
+
+#### 笔记搜索 `xhs search`
+
+```bash
+aiconductor-cli xhs search <keyword> [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--sort <sort>` | `general` / `time_descending` / `popularity_descending` / `comment_descending` / `collect_descending` | 不限 |
+| `--note-time <range>` | `day` / `week` / `halfyear` | 不限 |
+| `--note-type <type>` | `video` / `note` | 不限 |
+| `--max-pages <n>` | 最大翻页数，范围 1~5 | 1 |
+
+示例：
+```bash
+aiconductor-cli xhs search "AI编程" --note-time week --sort popularity_descending --max-pages 2 -f text
+```
+
+结果在 `data.data.items[].noteInfo` 与 `.userInfo`。注意 `noteInfo.readNum` 与 `userInfo.fansNum` 实测恒为 0，不要当真实阅读量/粉丝数用。
+
+#### 用户详情 `xhs user` / 用户笔记 `xhs user-notes`
+
+```bash
+aiconductor-cli xhs user <ref> [选项]
+aiconductor-cli xhs user-notes <ref> [选项]      # 支持 --max-pages，范围 1~5
+```
+
+`ref` 支持主页链接 `/user/profile/<id>` 或 24 位 `user_id`。
+
+```bash
+aiconductor-cli xhs user "https://www.xiaohongshu.com/user/profile/53cd3bbbb4c4d64f93463018" -f text
+aiconductor-cli xhs user-notes 53cd3bbbb4c4d64f93463018 --max-pages 2 -f text
+```
+
+用户详情在 `user_info`（`basic_info` + 5 项中文 `interactions` + `tags`）；用户笔记在 `data.data.notes[]`。
+
+> 时间口径：小红书所有 `time` 都是 **UTC 时间戳**（笔记详情为秒、用户笔记为毫秒），`-f text` 已自动换算成北京时间；**不要**再额外加 8 小时。上游的 `time_desc`（如 `10-28`）是 UTC-8 口径，文本模式不使用它。
+
+### 小红书达人报告（蒲公英）
+
+一次调用拿到达人的基础资料、粉丝画像与笔记性价比，并本地打分。内部是 **3 个原子接口并行调用**（`xhs_pgy_blogger` / `xhs_pgy_audience` / `xhs_pgy_performance`），至少两段成功才输出报告。
+
+```bash
+aiconductor-cli xhs daren-report <user_id 或 主页链接> [-f json|text]
+```
+
+示例：
+
+```bash
+aiconductor-cli xhs daren-report 5c5f8f4c000000001801612c -f text
+aiconductor-cli xhs daren-report "https://www.xiaohongshu.com/user/profile/5c5f8f4c000000001801612c"
+```
+
+返回路径：`data.data.profile`（`name` / `red_id` / `fans_count` / `like_collect_count` / `business_note_count`）、`data.data.audience`（`gender` / `ages` / `interests`，**占比是 0~1 小数**）、`data.data.performance`（`hundred_like_percent` / `imp_median` / `interaction_rate` 等，**已是百分数**）、`data.data.score`（`value` / `tier` / `basis`）、`data.data.failed_sources`。
+
+**打分公式**（纯规则，可自行复算）：粉丝 40 分（≥10万=40、≥5万=34、≥1万=26、≥5千=18、≥1千=10、其余=4）+ 互动率 30 分（≥20%=30、≥10%=24、≥5%=16、≥2%=8）+ 百赞率 30 分（≥50=30、≥20=24、≥10=16、≥5=8）；`≥80` 头部、`≥55` 腰部、其余尾部。任一段取数失败时按已拿到维度的满分之和归一，并标 `partial: true`。
+
+计费：三个原子接口各自按次计费（全成功合计 ¥0.90），CLI 不额外收费。
+
+### 小红书扫码发布
+
+生成图文或视频笔记的 H5 发布页与二维码。素材支持公网 URL、本地文件、Base64/data URL，以及包含 Base64 内容的文本文件。
+
+```bash
+# 图文：URL 与本地图片混用
+aiconductor-cli xhs note-publish normal \
+  --title "笔记标题" \
+  --images "https://example.com/photo1.jpg" \
+  --image-file "./photo2.jpg" \
+  --image-file "./photo3.png"
+
+# 图文：较大 Base64 写入文本文件后使用 @路径
+aiconductor-cli xhs note-publish normal \
+  --image-base64 "@./photo-base64.txt"
+
+# 视频：本地视频与本地封面
+aiconductor-cli xhs note-publish video \
+  --title "视频标题" \
+  --video-file "./video.mp4" \
+  --cover-file "./cover.jpg"
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--images <urls>` | 图片 URL 列表，逗号分隔 | 无 |
+| `--image-file <path>` | 本地图片路径，可重复使用 | 无 |
+| `--image-base64 <data>` | 图片 Base64、data URL 或 `@文本文件`，可重复使用 | 无 |
+| `--video <url>` | 视频 URL | 无 |
+| `--video-file <path>` | 本地视频路径 | 无 |
+| `--video-base64 <data>` | 视频 Base64、data URL 或 `@文本文件` | 无 |
+| `--cover <url>` | 视频封面 URL | 无 |
+| `--cover-file <path>` | 本地视频封面路径 | 无 |
+| `--cover-base64 <data>` | 封面 Base64、data URL 或 `@文本文件` | 无 |
+| `--upload-valid-days <days>` | 本地/Base64 素材临时链接有效期：1 或 7 天 | 7 |
+
+本地文件会在 CLI 内转换成 data URL，与 Base64 素材统一通过 JSON 接口免费上传为临时公开 URL，不使用 multipart。图片合计最多 18 张、单张最多 32MB；本地/Base64 视频受上传接口限制为 100MB，URL 视频上限为 200MB。
+
+### 微信公众号数据工具
+
+两个子命令：取单篇文章的互动数据、取公众号历史文章列表。
+
+```bash
+# 单篇文章互动数据（阅读 / 点赞 / 在看 等）
+aiconductor-cli wx article-data "https://mp.weixin.qq.com/s?__biz=xxxx&mid=xxxx&idx=1&sn=xxxx"
+
+# 公众号历史文章列表：用公众号名称或任意一篇文章链接定位
+aiconductor-cli wx history --name "人民日报" --max-pages 3 --max-seconds 50
+aiconductor-cli wx history "https://mp.weixin.qq.com/s?__biz=xxxx" -f text
+```
+
+| 选项 | 适用命令 | 说明 | 默认值 |
+|------|----------|------|--------|
+| `--name <name>` | `history` | 公众号名称或微信 ID（与 `url` 至少提供一个） | 无 |
+| `--max-pages <n>` | `history` | 最大翻页数量 | 1 |
+| `--max-seconds <n>` | `history` | 最长运行时间（秒），上限 170 | 50 |
+
+返回路径：`article-data` 的互动数据在 `data.data`（`read` / `zan` / `looking` / `share_num` / `collect_num` / `comment_count`，text 模式渲染成阅读/点赞/在看/分享/收藏/评论，未知字段原样输出）；`history` 的文章在 `data.data.data[]`（标题 `title`、时间 `post_time_str`、阅读 `read`、点赞 `zan`、链接 `url`）。
+
+`history` 另带 `data.data.code`（上游返回码）：`0` 才表示成功；非 0（如 `107` 名称/链接对不上、`20001` 平台侧上游故障）时 CLI 以退出码 1 报 `api_error`，不会用空列表冒充成功。
+
+### 网页转 Markdown
+
+把任意网页（包括微信公众号文章）转成干净的 Markdown，拿去给模型读、存档或二次排版。
+
+```bash
+# 公众号文章正文（链接请保留 chksm 参数，否则微信只返回页面框架）
+aiconductor-cli web to-md "https://mp.weixin.qq.com/s?__biz=xxxx&mid=xxxx&idx=1&sn=xxxx&chksm=xxxx" -f text
+
+# 普通网页（-t 可调超时，默认 30 秒）
+aiconductor-cli web to-md "https://example.com/article" --timeout 45
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-t, --timeout <seconds>` | 请求下游的超时秒数 | 30 |
+
+返回路径：`data.markdown`（**在顶层，不在 `data.data` 下**）。结果开头带 frontmatter（`title` / `author` / `site` / `source` / `domain` / `word_count`）——**有 `title` 与 `word_count` 才是真取到正文**；公众号链接若被裁掉 `chksm`，只能抓到“赞 / 在看 / 小程序”这类壳文字，text 模式会直接给出提示。
+
+### 通用选项
+
+所有命令支持：
+- `-k, --api-key <key>` — API Key（优先级：参数 > 环境变量 > .env 文件）
+- `-f, --format <json|text>` — 输出格式，默认 JSON
+
+## 计费
+
+| 功能 | 价格 |
+|------|------|
+| HTML 发布 | 0.01 元/次 |
+| Markdown/HTML 网页发布 | 0.01 元/次 |
+| 豆包网页/图片搜索 | 0.02 元/次 |
+| 抖音作品详情 | 0.01 元/次 |
+| 抖音作品评论 | 0.01 元/次 |
+| 抖音用户视频列表 | 0.03 元/页 |
+| 抖音用户详情 | 0.03 元/次 |
+| 抖音用户搜索 | 0.15 元/页 |
+| 抖音视频搜索 | 0.15 元/页 |
+| 抖音链接转文字 | 0.01 元/次 + 0.0003 元/秒 |
+| 小红书热榜 | 以平台服务配置为准 |
+| 小红书笔记详情 | 以平台服务配置为准（按次） |
+| 小红书笔记评论 | 以平台服务配置为准（按成功翻页数） |
+| 小红书笔记搜索 | 以平台服务配置为准（按成功翻页数） |
+| 小红书用户详情 | 以平台服务配置为准（按次） |
+| 小红书用户笔记列表 | 以平台服务配置为准（按成功翻页数） |
+| 小红书扫码发布 | 0.05 元/次 |
+| 公众号文章互动数据 | 以平台服务配置为准（按次） |
+| 公众号历史文章列表 | 以平台服务配置为准（按成功翻页数） |
+
+> 搜索/调用失败不扣费，仅成功时计费。
+
+## 开发
+
+```bash
+git clone https://github.com/huyi9531/aiconductor-cli.git
+cd aiconductor-cli
+npm install
+node bin/aiconductor-cli.js --help    # 本地运行
+```
+
+贡献前请阅读 [AGENTS.md](./AGENTS.md) 了解项目结构、编码风格与提交流程。
+
+## License
+
+MIT