yxyl-cli

译心跨境原生 CLI 启动器。通过 npx -y 下载并缓存当前平台的一组原生二进制，然后按 skill flag 把参数转发给对应二进制。

使用

npx -y yxyl-cli@latest --help
npx -y yxyl-cli@latest --ads --period last-week
npx -y yxyl-cli@latest --shop
npx -y yxyl-cli@latest --new-product-cold-start
npx -y yxyl-cli@beta --inquiry-followup-reminder check-secrets
npx -y yxyl-cli@beta --inquiry-followup-reminder update-config --webhook "https://..." --secret "SEC..."
npx -y yxyl-cli@beta --inquiry-followup-reminder run --dry-run --print-report
npx -y yxyl-cli@beta --deal-assistant --sender "Les saveurs de Maya Rafel"
npx -y yxyl-cli@beta --deal-assistant --inquiry-no 13847058678
npx -y yxyl-cli@beta --coffee-prospector --mode setup-accounts
npx -y yxyl-cli@beta --coffee-prospector --mode list-browser-profiles
npx -y yxyl-cli@beta --coffee-prospector --mode open-account-window --account aireach --chrome-profile "Default"
npx -y yxyl-cli@beta --coffee-prospector --mode open-account-window --account crm --chrome-profile "Profile 1"
npx -y yxyl-cli@beta --coffee-prospector --mode bind-account --account aireach
npx -y yxyl-cli@beta --coffee-prospector --mode bind-account --account crm
npx -y yxyl-cli@beta --coffee-prospector --mode list --country 美国
npx -y yxyl-cli@beta --coffee-prospector --mode fetch-batch --country 美国 --companies '[{"name":"Roaster","website":"https://example.com"}]'
npx -y yxyl-cli@beta --coffee-prospector --mode send --name "Roaster" --website "https://example.com" --to [email protected] --subject "A thought on your coffee bags" --body "..."

也可以全局安装后使用 yixin 快捷命令：

npm i -g yxyl-cli
yixin --help
yixin --ads --period last-week
yixin --deal-assistant --query "Mike"
yixin --coffee-prospector --mode fetch --name "Roaster" --website "https://example.com" --country 美国

首次运行会优先从阿里云 OSS 下载二进制到 ~/.yixin/bin；OSS 不可用时自动回退到公开 GitHub Release。

macOS 下下载完成后会自动处理每个二进制：

• 清除 com.apple.quarantine
• 设置可执行权限

API Key、兼容手机号和 token 缓存由各原生 skill 通过共享 yixin-auth 完成。设备限制使用本机 machineId；如果设备信息采集失败，CLI 会提示用户重试或联系管理员。浏览器控制通过发布包内的 browser-bridge-* 完成。

Skill 说明

• --ads 启动 alibaba-cli，负责广告后台登录检测、广告数据抓取、HTML 报告生成和报告自动打开。
• --shop、--showcase-efficiency、--zombie-cleanup、--zero-inquiry-high-exposure、--new-product-cold-start 启动各自独立 Rust skill，复用同一套授权和浏览器桥接。
• --inquiry-followup-reminder 启动询盘提醒跟进 skill，只复用授权层，不使用浏览器；读取 PostgreSQL/Supabase 待跟进视图，生成报告并可推送钉钉。
• --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。
• --deal-assistant 启动谈单助手 skill，支持按发件人或询价单号读取询价单、客户详情、CRM 客户阶段、订单记录、官网/社媒和采购产品线索。

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 会阻止重复目标。

环境变量

YIXIN_API_KEY    API Key（首次运行会自动提示，之后无需配置）。
YIXIN_PHONE      手机号（兼容旧方式，将停用）。
YIXIN_AUTH_URL   可选。授权服务地址，默认已内置。
YIXIN_RELEASE_REPO       可选。GitHub 备用源仓库，默认 areter/yxyl-cli-releases。
YIXIN_RELEASE_BASE_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_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，优先于绑定文件。

FOLLOWUP_DB_DSN       询盘提醒跟进可选。PostgreSQL/Supabase DSN，优先建议写入 ~/.yixin/inquiry-followup-reminder.toml。
DINGTALK_WEBHOOK      询盘提醒跟进可选。钉钉群机器人 webhook。
DINGTALK_SECRET       询盘提醒跟进可选。钉钉群机器人加签密钥。
DINGTALK_APP_KEY      询盘提醒跟进可选。钉钉企业内部应用 AppKey。
DINGTALK_APP_SECRET   询盘提醒跟进可选。钉钉企业内部应用 AppSecret。
DINGTALK_AGENT_ID     询盘提醒跟进可选。钉钉企业内部应用 AgentId。
DINGTALK_TEST_USERID  询盘提醒跟进可选。单人工作通知测试 userid。

二进制发布包

默认优先从杭州 OSS 下载与 npm 包版本一致的 release asset：

https://yxyl-cli-releases.oss-cn-hangzhou.aliyuncs.com/releases/v{version}/{archive}

OSS 下载失败后自动回退：

https://github.com/areter/yxyl-cli-releases/releases/download/v{version}/{archive}

平台压缩包：

• darwin-arm64 -> yixin-mac-arm64.tar.gz
• win32-x64 -> yixin-win32-x64.zip