Argent 安装使用指南
FULL 货件自动化，跟着步骤走，一次配好长期生效
从基础环境到设置页 ML 配置，再到表格验证，按本指南操作即可完成美客多 FULL 货件自动化的部署。 全程约 30 分钟，无需技术背景。
OVERVIEW
Argent + FULL 货件自动化
Argent 是问述科技推出的桌面 AI 助手。安装时选择「美客多卖家」角色后， 在飞书表格填好 SKU、勾选就绪，Argent 自动完成 FULL 货件的创建、预约、标签下载与箱唛打印， 结果和文件自动回写表格，全程无需打开店铺后台。每 5 分钟自动轮询，7×24 小时运行。
本指南对应「美客多卖家」角色的部署流程。角色能力与自动化效果说明见 美客多卖家角色指南。
安装前，请先准备好以下 5 项
安装 Argent（免费版）
一条命令安装免费版：curl -fsSL https://whyshu.com/dl/install-argent.mjs | node --input-type=module -（详见首页安装指南；需 Node.js ≥ 20）。
企业版订阅
「美客多 FULL/发票」角色需企业版订阅——商务开通：service@whyshu.com；订阅生效后角色自动解锁（无需装包）。
紫鸟浏览器
下载并登录紫鸟浏览器，创建美客多店铺环境并保持窗口打开（自动化驱动店铺后台用）。
STEPS
安装步骤
共 5 步：第 0–2 步准备环境，第 3 步一键配置，第 4 步验证。按顺序完成即可。
安装 Argent + 企业版解锁 FULL/发票角色
安装免费版
一条命令安装免费版（general + core/skin）；安装完成打开 dsh web（浏览器访问 http://127.0.0.1:3080）。
企业版解锁角色
角色随安装内置：企业版订阅生效后，「美客多 FULL/发票」在「Argent 角色」区自动从 🔒 变为可用，无需装包、也无需重装。
💡 角色与技能随安装内置，订阅解锁即时生效（升级/降级都不用重装）。
登录问述账号
一键登录
设置 → Argent → 「✦ 一键登录问述科技账号」，浏览器授权后用手机号或微信登录（新用户注册即送积分）。
设置页 ML 配置区完成配置
飞书表格 URL
填写飞书多维表格 URL（留空自动代建；或粘贴已有表格/沿用），FULL 自动化的数据入口。
紫鸟 API Key
在紫鸟开放平台申请，填入设置页 ML 配置区——用于识别与驱动紫鸟环境。
店铺映射
自动同步紫鸟环境名为表格下拉选项，无需手动录入。
💡 以上全部在设置页 UI 完成，无需命令行。
飞书 Bot 对话（可选）
独立 Bot（可选）
角色可绑定独立飞书 Bot（属 Pro 版及以上能力）；配置 Bot 凭据（App ID/Secret，见权限清单）后可直接在飞书 @ 对话。不配也能跑，主 Bot 兜底。
日常使用：填表即走
填写 SKU
在飞书表格登记货件记录（SKU、数量等）。
勾选就绪
把状态改为 Pending 并勾选「就绪」。
自动完成
≤5 分钟内自动完成货件创建、预约、标签下载、箱唛打印等 8 步，结果与文件自动回写表格。
飞书通知
完成/失败均有飞书通知；失败原因标记在表格「当前步骤」列，修正后重新勾选即可续传。
PARAMETERS
参数说明
FULL 自动化涉及的全部参数分为两类：机器独立参数与问述侧参数。
机器独立参数
每台机器各自独立，全部来自客户自己的账号与环境。
- ✓
飞书账号与多维表格
客户自己的飞书账号与表格，登记货件、接收结果。
- ✓
紫鸟账号与店铺环境
客户自己的紫鸟账号与美客多店铺环境窗口。
- ✓
店铺名称
来自紫鸟环境名，由向导自动同步为表格下拉选项。
- ✓
紫鸟开放平台 apiKey
客户在紫鸟开放平台自行申请。
- ✓
推送目标
接收飞书通知的个人或群，客户自己指定。
- ✓
Argent 角色
角色随安装内置，按订阅解锁：企业版解锁「美客多 FULL/发票」，Pro 版解锁轻量日报与办公助手；未解锁时在「Argent 角色」区显示 🔒。
问述侧参数
与问述科技服务相关的两项参数。
- ◆
问述账号
登录授权用，Argent 产品服务与订阅的归属账号。
- ◆
错误上报
执行失败时自动上报诊断数据，用于定位与修复问题。
除问述账号与错误上报外， 全部参数均为客户自己的：飞书、紫鸟、店铺、apiKey、推送目标都来自客户自己的账号与环境， 问述科技不接触也不保存这些账号的密码。
STORE NAME
店铺名称单选说明
填表时店铺名称怎么选？答案：只能选紫鸟里真实存在的环境。
向导自动同步
环境配置向导会把表格「店铺名称」列自动设为下拉选项，选项来自你紫鸟中的环境名，无需手动录入。
只能选存在的环境
运营只能选择紫鸟中真实存在的环境，无法手输不存在的店铺，避免货件发往错误账号。
环境增减后重跑向导
紫鸟中新增或删除了店铺环境，重跑环境配置向导即可同步表格里的店铺名称选项。
FAQ
常见问题
紫鸟窗口要保持打开吗？
需要。Argent 通过紫鸟浏览器驱动店铺后台，店铺环境窗口必须保持打开并处于登录状态。窗口关闭时，自动化会等待窗口恢复后继续执行。建议为紫鸟客户端开启开机自启，并关闭系统的自动休眠。
预约日期是怎么定的？
FULL 货件创建时，系统自动选择 30 天后的预约日期，并选择 Vehículo particular（私家车辆）配送方式，无需手动干预。如需调整，可在货件创建完成后到美客多后台手动修改预约。
执行失败怎么办？
失败时飞书会收到失败通知，表格「当前步骤」列标记失败原因。修正问题后，把状态改回 Pending 并重新勾选「就绪」，下一个轮询周期（≤5 分钟）自动重跑；已有货件号的任务会从失败步骤续传，无需重新创建。
诊断上报会泄露隐私吗？
仅在执行失败时上报诊断信息（产品版本、店铺、SKU、错误日志与页面摘要），成功执行不上报；数据仅用于定位和修复问题，90 天自动清理。免费版默认不上报，Pro / 企业版按服务条款约定执行。
怎么安装美客多角色？
角色随安装内置、按订阅解锁：Pro 版解锁轻量日报（工作台内查看）与办公助手；企业版解锁「美客多日报自动推送」与「美客多 FULL/发票」。未解锁时在「Argent 角色」区显示 🔒，订阅生效后自动可用，无需装包或重装。独立飞书 Bot 属 Pro 版及以上（可选，不配则主 Bot 兜底）。
如何更新 Argent 到最新版本？
打开 dsh web → 设置 → Argent → 版本与更新 → 点「检查更新」，完成后重启 dsh web。你的配置（店铺映射、飞书凭据、apiKey 等）不会因更新被覆盖。