Argent 安装使用指南
FULL 货件自动化，跟着步骤走，一次配好长期生效
从基础环境到 argent setup 一键配置，再到表格验证，按本指南操作即可完成美客多 FULL 货件自动化的部署。 全程约 30 分钟，无需技术背景。
OVERVIEW
Argent + FULL 货件自动化
Argent 是问述科技推出的桌面 AI 助手。安装时选择「美客多卖家」角色后， 在飞书表格填好 SKU、勾选就绪，Argent 自动完成 FULL 货件的创建、预约、标签下载与箱唛打印， 结果和文件自动回写表格，全程无需打开店铺后台。每 5 分钟自动轮询，7×24 小时运行。
本指南对应「美客多卖家」角色的部署流程。角色能力与自动化效果说明见 美客多卖家角色指南。
安装前，请先准备好以下 5 项
紫鸟账号
已注册并登录紫鸟浏览器，用于打开店铺环境窗口。
紫鸟环境
创建你的美客多店铺环境，并完成店铺账号登录。
飞书账号
用于创建多维表格，并接收自动化推送通知。
飞书多维表格
登记货件记录的工作台，FULL 自动化的数据入口。
紫鸟开放平台 apiKey
在紫鸟开放平台申请，用于识别与驱动紫鸟环境。
STEPS
安装步骤
共 5 步：第 0–2 步准备环境，第 3 步一键配置，第 4 步验证。按顺序完成即可。
前置确认
系统
Mac（推荐，本指南以 macOS 为例）或 Windows（推荐 WSL）。
网络
可正常访问 whyshu.com 与紫鸟官网，npm 可安装全局包。
账号
紫鸟账号与美客多店铺环境已就绪，飞书账号已注册。
💡 安装前逐项确认，缺一不可；后续步骤都依赖这三项就绪。
基础环境
安装 Node.js
在终端运行以下命令，安装完成后可用 node -v 验证版本：
安装 ziniao-cli 与 lark-cli
全局安装两个命令行工具，分别用于紫鸟环境识别与飞书消息推送：
brew install nodenpm install -g ziniao-cli lark-cli安装 Argent
运行安装命令，选择「美客多卖家」
复制下面命令运行，安装脚本会弹出角色菜单（美客多卖家 / 通用助手 / HR / 行政，可多选），选择「美客多卖家」即可：
curl -fsSL https://whyshu.com/dl/install-cn.sh | bash💡 安装脚本自动完成 Hermes、Argent 引擎与所选角色 profile 的全部安装。美客多卖家角色内置 14 个 ML 技能与 FULL 货件自动化，安装后 profile 为 argent-ml-seller。
argent setup
登录问述账号
运行 argent setup，浏览器自动打开，用手机号或微信扫码登录问述科技账号。登录按角色独立——切换到未登录的角色时，运行 argent setup 补登录即可。
确认角色（安装时已选定，自动确认）
v0.6.0 起角色在安装时已选定，setup 自动确认，不再询问角色或行业。本指南以「美客多卖家」为例，启用 FULL 货件自动化能力。
按引导运行环境配置向导（init-ml.sh）
向导依次完成：紫鸟环境确认 → 填入紫鸟开放平台 apiKey → 配置飞书多维表格（新建或粘贴已有表格 URL）→ 同步店铺名称选项 → 完成 CDP 连接与定时任务注册（每 5 分钟自动轮询）。
配置飞书对话（可选）
配置飞书 bot 对接后，可直接在飞书对话中向 Argent 提问，例如查询积分余额（account_balance）等账号信息。
argent setup💡 店铺名称选项由向导从紫鸟环境中自动同步，详见下方「店铺名称说明」。
验证自动化
添加测试记录
在飞书表格新增一行：填好 SKU、品名、数量、箱数，店铺名称选择你的紫鸟环境，然后勾选「就绪」。
5 分钟内自动执行
轮询任务发现待处理记录，Argent 自动开始执行 FULL 货件流程，表格「当前步骤」实时更新。
完成 / 失败消息
执行完成，飞书收到「FULL 货件完成」通知，产品标签与箱唛自动上传到表格；如失败，收到失败通知并在表格标记原因。
💡 验证通过即部署完成，日常只需在表格登记货件，其余全部自动。
PARAMETERS
参数说明
FULL 自动化涉及的全部参数分为两类：机器独立参数与问述侧参数。
机器独立参数
每台机器各自独立，全部来自客户自己的账号与环境。
- ✓
飞书账号与多维表格
客户自己的飞书账号与表格，登记货件、接收结果。
- ✓
紫鸟账号与店铺环境
客户自己的紫鸟账号与美客多店铺环境窗口。
- ✓
店铺名称
来自紫鸟环境名，由向导自动同步为表格下拉选项。
- ✓
紫鸟开放平台 apiKey
客户在紫鸟开放平台自行申请。
- ✓
推送目标
接收飞书通知的个人或群，客户自己指定。
- ✓
Argent 角色（profile）
安装时交互选择的角色：美客多卖家、通用助手、HR、行政，各自独立 profile；更新方式见 FAQ。
问述侧参数
与问述科技服务相关的两项参数。
- ◆
问述账号
登录授权用，Argent 产品服务与订阅的归属账号。
- ◆
错误上报
执行失败时自动上报诊断数据，用于定位与修复问题。
除问述账号与错误上报外， 全部参数均为客户自己的：飞书、紫鸟、店铺、apiKey、推送目标都来自客户自己的账号与环境， 问述科技不接触也不保存这些账号的密码。
STORE NAME
店铺名称单选说明
填表时店铺名称怎么选？答案：只能选紫鸟里真实存在的环境。
向导自动同步
环境配置向导会把表格「店铺名称」列自动设为下拉选项，选项来自你紫鸟中的环境名，无需手动录入。
只能选存在的环境
运营只能选择紫鸟中真实存在的环境，无法手输不存在的店铺，避免货件发往错误账号。
环境增减后重跑向导
紫鸟中新增或删除了店铺环境，重跑环境配置向导即可同步表格里的店铺名称选项。
FAQ
常见问题
紫鸟窗口要保持打开吗？
需要。Argent 通过紫鸟浏览器驱动店铺后台，店铺环境窗口必须保持打开并处于登录状态。窗口关闭时，自动化会等待窗口恢复后继续执行。建议为紫鸟客户端开启开机自启，并关闭系统的自动休眠。
预约日期是怎么定的？
FULL 货件创建时，系统自动选择 30 天后的预约日期，并选择 Vehículo particular（私家车辆）配送方式，无需手动干预。如需调整，可在货件创建完成后到美客多后台手动修改预约。
执行失败怎么办？
失败时飞书会收到失败通知，表格「当前步骤」列标记失败原因。修正问题后，把状态改回 Pending 并重新勾选「就绪」，下一个轮询周期（≤5 分钟）自动重跑；已有货件号的任务会从失败步骤续传，无需重新创建。
诊断上报会泄露隐私吗？
仅在执行失败时上报诊断信息（产品版本、店铺、SKU、错误日志与页面摘要），成功执行不上报；数据仅用于定位和修复问题，90 天自动清理。免费版默认不上报，Pro / 企业版按服务条款约定执行。
安装时怎么选角色？
运行安装命令后会弹出角色菜单：美客多卖家、通用助手、HR、行政，可多选。美客多卖家面向美客多（Mercado Libre）卖家，内置 14 个 ML 技能与 FULL 货件自动化能力；通用助手面向 HR、行政等通用办公场景。之后想增加角色，重跑安装命令选择即可。
如何更新 Argent 到最新版本？
运行 argent update 一键全量更新：CLI、技能插件与当前角色 profile 都会更新到最新版本。你的配置（店铺映射、飞书凭据、apiKey 等）保存在 ~/.hermes/scripts/，更新不会覆盖。