客户安装手册
FULL 货件自动化，全程部署人员陪同，您只需按手册配合操作
本手册面向美客多（Mercado Libre）卖家朋友。Argent ML 是问述科技自主研发的桌面 AI 助手，安装过程全程有部署人员陪同，您只需要按本手册配合操作即可，不用懂任何技术。
本安装手册仅适用于 macOS，Windows 暂不支持。
OVERVIEW
概览
先认识一下 Argent ML：它是什么，装好之后能帮您干什么。
1.1 Argent ML 是什么？
Argent ML 是问述科技自主研发、专为美客多（Mercado Libre）卖家打造的一款桌面 AI 助手。
装上它之后，您店铺的 FULL 货件（也就是需要整箱整批发往美客多仓库的货件）从预约到发货的全流程，都可以交给它自动处理：自动预约发货、自动下载面单标签、自动生成箱唛，并把结果通知回您的飞书。
1.2 安装后能干什么？
一句话版：您在飞书表格里填好发货信息，AI 自动帮您预约、出标签、出箱唛，完成后回飞书通知您。
客户配好平台账号
部署人员装好环境
运营在飞书表格填发货信息
AI 自动完成：预约发货 → 下载标签 → 生成箱唛
结果通知到飞书
安装完成后，日常工作中真正需要动手的只有「在飞书表格里填发货信息」这一件事，其余环节全部自动跑。
MANUAL STEPS
人工操作清单
这部分是您本人需要亲自完成的操作，全部在浏览器里点一点就行，步骤下面一一说明。
紫鸟开放平台
第一步 · 登录
- ① 用浏览器打开网址 https://open.ziniao.com
- ② 用您自己的紫鸟账号登录。
第二步 · 创建 CLI 应用、拿 apiKey
- ③ 登录后进入「用户应用管理」，创建一个 CLI 应用。
- ④ 创建完成后会拿到一串
apiKey，请立刻复制并保存好。
第三步 · 把本机终端识别码加入白名单
- ⑤ 还是在「用户应用管理」页面里，找到「终端管理」。
- ⑥ 把安装这台电脑的「终端识别码」添加进去（识别码由部署人员现场帮您查看）。
💡 小提示：如果 Key 是从「应用管理」菜单里拿的，后面使用时会报「API Key 认证失败」，遇到这个报错直接回来按第二步重新拿一次 Key 就行。
飞书开放平台
第一步 · 登录并创建应用
- ① 用浏览器打开网址 https://open.feishu.cn
- ② 用您自己的飞书账号登录。
- ③ 创建一个「企业自建应用」，并给应用添加「机器人」能力。
第二步 · 开启权限（共 6 个必开 + 1 个可选）
④ 进入「权限管理」，逐一把下面 6 个权限开启：
im:messageim:message:send_as_botim:resourcebitable:appdrive:drivebase:app:create⑤ 可选权限（用来清理测试时留下的文档，不开也不影响正常使用）：
space:document:delete第三步 · 创建版本并发布（非常重要，别漏！）
- ⑥ 权限开完后，必须点「创建版本并发布」，发布时「可用性」选择「全员」。
99991672 错误——这不是故障，就是版本没发布。第四步 · 保存 App ID 和 App Secret
- ⑦ 发布完成后，回到应用信息页，把您自己的 App ID 和 App Secret复制下来保存好（同样是交给部署人员时要用）。
安装过程中的飞书授权
安装过程中，部署人员会给您一个飞书授权链接：
- ① 链接 10 分钟内有效，请收到后尽快打开。
- ② 必须用您自己的飞书账号打开（不要用别人的账号）。
- ③ 在页面上点击「授权」即可，之后剩下的交给部署人员。
AUTOMATION
自动化部分说明
以下环节由部署人员代为操作，您不需要自己动手，了解即可。
| 环节 | 说明 |
|---|---|
| 环境安装 | 帮您装好 AI 运行环境、紫鸟客户端、飞书命令行工具 |
| 紫鸟店铺连接 | 验证您的 apiKey 是否有效，并检测紫鸟客户端是否正常 |
| 自动建表 | 自动在飞书创建「FULL任务」表格：包含 12 个字段 + 3 个视图（表格 / 待处理 / 运营填写） |
| 店铺映射 | 把紫鸟里的美客多店铺和自动化流程一一关联起来 |
| 定时任务 | 设置每 5 分钟自动检查一次，发现有新的待处理货件就自动开始干活 |
整个过程中，您只需要在旁边配合三件事：输入您自己的 apiKey、App ID、App Secret（就是第 2 节里保存好的那三样），其余全部由部署人员完成。
FAQ
常见问题对照表
遇到下面这些提示不用慌，按「解决办法」一列操作即可。
| 现象 | 原因 | 解决办法 |
|---|---|---|
报错 99991672（app_scope_not_applied） | 权限没开全，或者开完权限没发布版本 | 回飞书开放平台补上缺的权限，然后「创建版本并发布」，可用性选「全员」 |
| 店铺列表提示「API Key 认证失败」 | apiKey 是从「应用管理」菜单拿的（拿错菜单了） | 去「用户应用管理」重新创建 CLI 应用拿 apiKey |
报错 40004 拒绝访问 | 终端识别码没加入白名单（或成员模式未启用） | 进入用户应用管理 → 终端管理，把本机终端识别码加入白名单 |
| 授权页提示「没有使用权限」 | 应用没发布，或发布时可用性不含您的账号 | 回到飞书开放平台创建版本并发布，可用性选「全员」 |
| 提示授权链接过期 | 链接超过 10 分钟没点 | 联系部署人员重新生成链接，收到后 10 分钟内点掉 |
DAILY USE
安装后日常
安装完成后，日常操作非常简单，记住一句话：在「运营填写」视图里填 5 个字段，勾一下「就绪」，完事。
5.1 三个视图各自干嘛
| 视图 | 用途 |
|---|---|
| 表格 | 看全部记录、查历史，所有货件的完整信息都在这里 |
| 待处理 | AI 马上要处理的货件清单，看看有没有漏掉的 |
| 运营填写 | 您日常填写用的页面，只显示需要填的字段，不容易填错 |
5.2 运营每天只做这几步
打开飞书里的「FULL任务」表格，切到「运营填写」视图。
只填这 5 个字段：店铺名称、SKU、品名、数量、箱数。
填好后勾选「就绪」。
剩下的全交给 AI：它会自动预约发货、下载标签、打印箱唛。
全部完成后，飞书会收到通知，您看一眼确认即可。
就这么简单，祝发货顺利！