一句话版本：装一次，之后你只需要用中文跟 AI 说话，AI 就能帮你操作售后宝——查工单、建客户、派任务、管设备，全程不需要碰后台。

​

这东西对你有什么用？ ​

日常工作中你一定经历过这些场景：

SHB-CLI 就是让这一切成为可能的桥梁。 它让 AI 能够直接和售后宝系统对话，你不需要学任何命令，不需要碰终端，只需要说人话。

工作原理（三句话解释） ​

想象你和 AI 是一个群聊，群里其实有三个人：

你 ──说话──▶ AI ──执行命令──▶ 售后宝系统
                                │
              ◀──返回结果────────┘

1. 你发消息 = 告诉 AI 你想做什么
2. AI 执行命令 = AI 自动操作售后宝系统
3. 系统返回结果 = 你直接看到整理好的数据

你只需要配置一次，之后就可以完全忘记 CLI 的存在。

谁适合用？ ​

• AI 工具用户：使用 Claude Code、Cursor、Trae、openClaw 等 AI 工具的人，安装后一句话操作售后宝
• Agent 开发团队：正在构建需要与售后宝集成的 AI 产品，CLI 提供完整的业务域覆盖

安装与授权 ​

方式一：AI Agent 工具自动安装（） ​

将以下信息发送给你的 AI Agent 工具（如WorkBuddy、悟空、Trae、 Cursor、Codex、Claude Code、openClaw等），它会自动完成安装：

帮我安装售后宝 CLI：https://publink.ai/shbcli.md

安装过程中可能会出现权限授权提示，请按照提示进行授权操作。安装完成后，系统会生成一个授权链接，用户需手动复制该链接到浏览器中，按照页面提示完成售后宝账号授权。

AI Agent 工具推荐下载地址： ​

WorkBuddy：https://www.codebuddy.cn/work/

悟空：https://wukong.dingtalk.com/

Trae：https://solo.trae.cn/

小宝Claw：https://xiaobaoai.app/

EasyClaw：https://easyclaw.cn/

Marvis ：https://marvis.qq.com/

Codex：https://www.codex.com/

方式二：手动安装（推荐面向开发者） ​

在终端中输入一行命令完成安装：

npm install -g @publink-ai/cli

登录授权 ​

安装完成后，需要完成一次用户授权，让 AI 可以访问你的信息并以你的名义执行操作。

# 登录认证（浏览器方式）
shb-cli auth login

# 查看当前配置状态
shb-cli config

运行后，按提示打开链接，在售后宝系统登录页面完成登录并确认即可。

提示：如果暂时跳过授权也没关系，之后 AI 在需要访问你的数据或执行操作时，会自动发起授权提示。

验证配置 ​

授权完成后，运行以下命令查看当前配置状态：

shb-cli config

如果输出显示当前用户和租户信息，说明配置成功。

全局参数说明 ​

以下参数可以在所有命令中使用：

快速开始：说第一句话 ​

打开你的 AI Agent 工具（如 WorkBuddy、悟空、Trae、Claude Code、Cursor等），在对话框中输入：

"帮我搜索今天的待处理工单"

AI 收到你的请求后，会自动调用 CLI 查询售后宝系统，把工单列表整理好展示给你。

整个过程你不需要知道背后执行了什么命令——但如果你好奇，它其实是这样做的：

shb-cli task search --keyword "待指派" -o table

典型使用场景 ​

场景 1：工单全流程自动化 ​

以前怎么做：客户来电报修 → 登录售后宝后台 → 手动填写工单表单 → 保存 → 再找到可派工的工程师 → 手动分配。来回切页面，操作 5-10 分钟。

现在怎么做：跟 AI 说一句话。

"帮我给华为客户创建一个空调维修工单，派给张三"

AI 自动完成：搜索客户拿到 ID → 创建工单填入信息 → 按名字查找工程师 → 提交派工。全程不到 30 秒，你只需要最后确认一下。

场景 2：客户信息一键查询 ​

以前怎么做：打开客户列表 → 搜索 → 点进去看详情 → 再切到联系人 Tab → 再切到地址 Tab。信息分散在好几个页面。

现在怎么做：

"帮我查一下华为这个客户的联系人和地址"

AI 自动把客户基本信息、所有联系人、所有服务地址一次性拉出来，整理成表格给你看。一屏搞定。

场景 3：在系统里新建客户 ​

以前怎么做：打开客户管理页 → 点新建 → 逐项填写名称、联系人、电话、客户编号、自定义字段等 → 保存。

现在怎么做：

"帮我在系统里新建一个客户，公司名叫'北京某某科技有限公司'，联系人是李经理，电话 138-0000-0001，客户编号 CU-2024-008"

AI 先查字段定义确认有哪些自定义字段，再创建客户。如果客户编号已存在会提示你更换。

场景 4：产品资产管理 ​

以前怎么做：安装完设备后回到办公室，打开系统录入产品信息，手动填表。

现在怎么做：

"给客户华为新增一台中央空调产品，序列号 AC-2024-001"

AI 帮你在系统里创建产品记录，关联到对应客户。

想查某个客户名下有哪些设备？一句话就行：

"帮我看看华为客户有哪些产品"

场景 5：批量数据操作 ​

以前怎么做：在后台一页页翻工单列表，手动统计或者导出 Excel。

现在怎么做：

"帮我导出本月所有已完成的工单"

AI 自动帮你翻完所有分页，汇总成一份完整的数据文件。

shb-cli task search --state "completed" --all -o json > tasks.json

加上 --all 参数后，CLI 会自动翻页把所有数据拉回来，不需要你一页页去点。

演示效果 ​

1、安装登录授权教程 ​

2、使用操作演示 ​

命令参考 ​

以下按模块列出所有可用命令及参数说明。你可以直接参考此表告诉 AI 要做什么，也可以了解 AI 背后执行的命令细节。

工单管理（Task） ​

工单是售后宝的核心业务对象——客户报修、设备巡检、上门服务，都是通过工单来流转的。

命令列表 ​

task search 常用参数 ​

task create submit 常用参数 ​

task alloc submit 常用参数 ​

客户管理（Customer） ​

客户是所有业务的起点——你得先知道是哪个客户的事，才能创建工单、查设备。

命令列表 ​

customer list 常用参数 ​

customer linkman search 常用参数 ​

customer address list 常用参数 ​

customer create 常用参数 ​

产品管理（Product） ​

产品就是你给客户安装或维护的设备——空调、电梯、打印机等等。

命令列表 ​

product search 常用参数 ​

product create 常用参数 ​

常见问题 ​

我完全不懂命令行，能用吗？ ​

完全可以。 你不需要记住任何命令，也不需要打开终端（安装和登录那一次除外）。全程跟 AI 用中文对话，AI 会自己判断该执行什么操作。命令行只是 AI 和售后宝之间的"通信协议"——就像你不需要懂 HTTP 协议也能正常上网一样。

AI 会不会误操作？比如不小心创建了错误的工单？ ​

不会。 CLI 设计了多层安全机制：

• AI 在执行写入操作前通常会先跟你确认
• 所有操作都有日志可追溯
• 你可以随时跟 AI 说"等一下"来暂停操作

--search-user 是什么意思？为什么派工不直接用 ID？ ​

因为你通常只知道工程师叫什么名字，不知道他在系统里的 ID。--search-user "张三" 会先去系统搜索叫"张三"的用户，如果有多个结果会列出来让你（或 AI）选择。这是为了让 AI 更容易帮你完成派工——它只需要知道人名就够了。

--format-data 是做什么的？ ​

售后宝的工单有很多自定义字段，原始数据里存的是编码（比如字段 ID 和选项 ID）。加上 --format-data 后，CLI 会自动把编码翻译成人能看懂的标签。比如把 "field_001": "opt_003" 变成 "服务类型": "紧急维修"。这样 AI 汇报结果时你能直接看懂。

数据量很大时 --all 会不会卡住？ ​

不会。--all 内部做了优化：每次请求 50 条、自动间隔 500ms 避免压垮服务器。几百条数据通常几秒完成。如果数据量特别大（几千条），可能需要等十几秒，但不会卡住或超时。

多租户场景怎么切换？ ​

如果你的账号关联了多个租户，可以通过 --profile 参数切换。正常情况下 AI 会自动处理，不需要你操心。

总结 ​

SHB-CLI 让 AI 能够直接操作售后宝系统，覆盖日常业务的核心场景：

一句话总结：安装一次，让 AI 替你操作售后宝。你只管说话，它替你干活。