@yixinkj/cli 1.0.15-beta.1 → 1.0.15-beta.10

package/README.md

@@ -1,12 +1,23 @@
 # @yixinkj/cli
 
-译心跨境原生 CLI 启动器。通过 `npx -y` 下载并缓存当前平台的原生二进制，然后把参数直接转发给 `alibaba-cli`。
+译心跨境原生 CLI 启动器。通过 `npx -y` 下载并缓存当前平台的一组原生二进制，然后按 skill flag 把参数转发给对应二进制。
 
 ## 使用
 
 ```bash
 npx -y @yixinkj/cli@latest --help
 npx -y @yixinkj/cli@latest --ads --period last-week
+npx -y @yixinkj/cli@latest --shop
+npx -y @yixinkj/cli@latest --new-product-cold-start
+npx -y @yixinkj/cli@beta --coffee-prospector --mode setup-accounts
+npx -y @yixinkj/cli@beta --coffee-prospector --mode list-browser-profiles
+npx -y @yixinkj/cli@beta --coffee-prospector --mode open-account-window --account aireach --chrome-profile "Default"
+npx -y @yixinkj/cli@beta --coffee-prospector --mode open-account-window --account crm --chrome-profile "Profile 1"
+npx -y @yixinkj/cli@beta --coffee-prospector --mode bind-account --account aireach
+npx -y @yixinkj/cli@beta --coffee-prospector --mode bind-account --account crm
+npx -y @yixinkj/cli@beta --coffee-prospector --mode list --country 美国
+npx -y @yixinkj/cli@beta --coffee-prospector --mode fetch-batch --country 美国 --companies '[{"name":"Roaster","website":"https://example.com"}]'
+npx -y @yixinkj/cli@beta --coffee-prospector --mode send --name "Roaster" --website "https://example.com" --to target@example.com --subject "A thought on your coffee bags" --body "..."
 ```
 
 也可以全局安装后使用 `yixin` 快捷命令：
@@ -15,6 +26,7 @@ npx -y @yixinkj/cli@latest --ads --period last-week
 npm i -g @yixinkj/cli
 yixin --help
 yixin --ads --period last-week
+yixin --coffee-prospector --mode fetch --name "Roaster" --website "https://example.com" --country 美国
 ```
 
 首次运行会从公开 GitHub Release 下载二进制到 `~/.yixin/bin`。
@@ -24,7 +36,17 @@ macOS 下下载完成后会自动处理每个二进制：
 - 清除 `com.apple.quarantine`
 - 设置可执行权限
 
-授权、手机号保存、token 缓存、广告后台登录检测、广告数据抓取、HTML 报告生成和报告自动打开均由原生 `alibaba-cli` 内置完成。默认检测到未登录会输出 `LOGIN_REQUIRED=true` 并退出，方便 Agent 提示用户登录后重试；人工手动运行需要等待登录时可追加 `--wait-login`。报告生成后，CLI 会自动关闭本次抓取数据时打开的广告后台页面。
+授权、手机号保存和 token 缓存由各原生 skill 通过共享 `yixin-auth` 完成。浏览器控制通过发布包内的 `browser-bridge-*` 完成。
+
+## Skill 说明
+
+- `--ads` 启动 `alibaba-cli`，负责广告后台登录检测、广告数据抓取、HTML 报告生成和报告自动打开。
+- `--shop`、`--showcase-efficiency`、`--zombie-cleanup`、`--zero-inquiry-high-exposure`、`--new-product-cold-start` 启动各自独立 Rust skill，复用同一套授权和浏览器桥接。
+- `--coffee-prospector` 启动 `coffee-prospector`，支持 `--mode setup-accounts`、`--mode list-browser-profiles`、`--mode open-account-window`、`--mode check-account`、`--mode bind-account`、`--mode list`、`--mode fetch`、`--mode fetch-batch`、`--mode send`。
+
+`coffee-prospector` 不会读取、保存或自动填写小满账号密码。检测到 AI Reach 或 CRM 未登录时输出 `LOGIN_REQUIRED=true`，由用户在已打开页面手动登录后重试。`list-browser-profiles` 会列出本机已有 Chrome 窗口；`open-account-window` 会启动用户选定的已有 Chrome 窗口作为“获客窗口”或“发信窗口”，不会新建临时 profile；`bind-account` 检测通过后只保存窗口标签和 Chrome 目录名等路由信息，不保存 cookie、验证码或密码。
+
+`coffee-prospector` 的 `list` / `fetch` / `fetch-batch` 自动使用获客账号，`send` 自动使用发信账号。CRM 显示 401、应用到期或无权限时返回 `CRM_PERMISSION_REQUIRED`，不会继续发送。`fetch-batch` 通过 `--companies` 接收 `{name, website}` 数组，一次打开 AI Reach 后连续抓取多个客户。`fetch` / `fetch-batch` 使用 AI Reach 官网链接调用 Tavily 发现相关 URL，然后只打开 Tavily 返回的 URL 抓取 Markdown，并返回 `sent_status`。`send` 默认点击发送，追加 `--draft` 时保存草稿。真实发送成功后会写入 `~/.yixin/coffee-prospector-sent.json`，后续 `list` 会过滤已发送公司/官网，`send` 会阻止重复目标。
 
 ## 环境变量
 
@@ -34,6 +56,15 @@ YIXIN_AUTH_URL    可选。授权服务地址，默认已内置。
 YIXIN_RELEASE_REPO       可选。默认 yixinkj/cli-releases。
 YIXIN_RELEASE_BASE_URL   可选。覆盖二进制下载基础 URL。
 YIXIN_GITHUB_TOKEN       可选。下载私有 Release 时使用；正式公开分发通常不需要。
+TAVILY_API_KEY           coffee-prospector fetch 可选。用于官网相关链接搜索。
+TAVILY_SEARCH_URL        coffee-prospector fetch 可选。覆盖 Tavily 兼容搜索接口地址。
+COFFEE_PROSPECTOR_MAX_RELATED_PAGES  可选。fetch 最多打开的 Tavily 相关页面数，默认 8，范围 0-20。
+COFFEE_PROSPECTOR_PARALLEL_PAGES     可选。fetch 并发打开页面数，默认 4，范围 1-6。
+COFFEE_PROSPECTOR_BROWSER_CAPTURE_TIMEOUT_SECS  可选。浏览器页面抓取超时秒数，默认 8，范围 3-45。
+COFFEE_PROSPECTOR_SENT_LEDGER        可选。覆盖 coffee-prospector 已发送名单路径；默认 ~/.yixin/coffee-prospector-sent.json。
+COFFEE_PROSPECTOR_ACCOUNTS_PATH      可选。覆盖 coffee-prospector 账号窗口绑定路径；默认 ~/.yixin/coffee-prospector-accounts.json。
+COFFEE_PROSPECTOR_AIREACH_PROFILE    可选。直接指定获客账号窗口标签或 profile_id，优先于绑定文件。
+COFFEE_PROSPECTOR_CRM_PROFILE        可选。直接指定发信账号窗口标签或 profile_id，优先于绑定文件。
 ```
 
 ## 二进制发布包

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yixinkj/cli",
-  "version": "1.0.15-beta.1",
+  "version": "1.0.15-beta.10",
   "description": "Yixin native CLI launcher.",
   "type": "module",
   "bin": {

package/skills.json

@@ -6,6 +6,12 @@
   "bridge": "browser-bridge",
   "skills": [
     { "name": "阿里国际站直通车广告分析", "flag": "--ads", "bin": "alibaba-cli" },
-    { "name": "阿里国际站店铺数据参谋", "flag": "--shop", "bin": "shop-cli" }
+    { "name": "阿里国际站店铺数据参谋", "flag": "--shop", "bin": "shop-cli" },
+    { "name": "阿里国际站橱窗位效率", "flag": "--showcase-efficiency", "bin": "showcase-efficiency-cli" },
+    { "name": "阿里国际站僵尸滞销商品清理", "flag": "--zombie-cleanup", "bin": "zombie-cleanup-cli" },
+    { "name": "阿里国际站零询盘高曝光预警", "flag": "--zero-inquiry-high-exposure", "bin": "zero-inquiry-high-exposure-cli" },
+    { "name": "阿里国际站新品首周冷启动检查", "flag": "--new-product-cold-start", "bin": "new-product-cold-start-cli" },
+    { "name": "阿里国际站店铺星级体检", "flag": "--store-star-rating-check", "bin": "store-star-rating-check-cli" },
+    { "name": "咖啡包装B2B自动化拓客助手", "flag": "--coffee-prospector", "bin": "coffee-prospector" }
   ]
 }