xiaoe-cloud-cli

---
name: xiaoe-cloud-cli
version: "0.1.2"
description: "小鹅通：使用当前登录账号和店铺上下文管理课程、内容资产、章节、直播、订单和素材。"
author: "Xiaoetong"
---

# 小鹅通

本 Skill 配合 WorkBuddy 小鹅通连接器使用。用户完成小鹅账号登录和店铺选择后，WorkBuddy 使用当前会话可用的工具处理业务请求。

## 连接方式

- 使用 WorkBuddy 连接器面板完成连接或重新连接。
- 不要求用户手动填写访问凭证或小鹅云开放平台密钥。
- 如果连接过期或提示未登录，提示用户在 WorkBuddy 连接器面板重新连接。

## 执行原则

1. 每次都以当前会话实际提供的工具和参数 schema 为准，不编造工具名、字段或枚举值。
2. 用户没有给出目标 ID 时，先查询并让用户选择，不猜测课程、内容、章节、直播、订单或素材 ID。
3. 查询操作可以直接执行；写操作必须先展示业务摘要并获得用户明确确认。
4. 当前工具不可用或能力发生变化时，重新获取当前会话可用工具并重新规划，不得自动重试或重放原调用。
5. 不让用户提供 `app_id`、`user_id`、`shop_id`、`current_shop_id`、`xiaoe_account_id`、`request_source` 等身份上下文字段。
6. 不输出或记录登录凭证、密码、短信验证码、滑块票据、临时上传凭证或签名信息。

不同账号、店铺、能力策略和服务版本下，可用工具可能不同。以下工具只有在当前会话实际提供时才可调用。

## 查询工具路由

### 课程、学员和内容

- `course_list`：查询课程列表，用于按名称查找课程或让用户选择目标课程。
- `course_detail`：查看课程详情。
- `course_student_list`：查看课程学员列表。
- `course_resource_list`：查询图文、音频、视频和电子书等内容资产。
- `video_detail`、`audio_detail`、`image_text_detail`、`ebook_detail`：查看对应内容资产详情。
- `course_chapter_list`：查看课程的章节和小节，编辑目录或调整排序前应先调用。

### 订单、素材和直播

- `order_list`：查询订单列表；先用时间、状态等条件缩小范围。
- `order_detail`：查看指定订单详情。
- `material_select`：查找当前店铺已有的图片、音频、视频、电子书或文档素材，优先复用已有素材。
- `live_list`：查询直播列表。
- `live_detail`：查看指定直播详情，编辑直播前应先调用。

## 写入工具路由

以下工具都会改变店铺数据，必须遵守“写操作确认流程”。

### 课程和内容编辑

- `course_create`、`course_update`：创建课程或编辑课程基础信息、售卖信息等字段。
- `video_update`、`audio_update`、`image_text_update`、`ebook_update`：编辑对应内容资产。

### 课程目录和内容创建

- `chapter_create`、`chapter_batch_create`：创建单个或批量章节。
- `chapter_update`、`chapter_sort_update`：编辑章节或调整章节顺序。
- `sub_course_create`：在课程目录中创建子课程。
- `video_create`、`audio_create`、`image_text_create`、`ebook_create`：创建对应类型的内容资产。

### 直播和素材上传

- `live_create`、`live_edit`：创建直播或编辑直播信息、时间和售卖设置。
- `material_upload_prepare`、`material_upload_complete`：上传图片、音频、电子书或文档时使用的两阶段流程。先准备上传，再按返回信息完成文件传输，最后登记上传结果；不要把临时凭证展示给用户。视频上传不走该流程。

## 写操作确认流程

1. 查询并确认目标对象；创建操作则收集工具 schema 要求的必要信息。
2. 向用户展示店铺、目标对象、拟修改字段或待创建内容的业务摘要。
3. 等待用户明确同意；`confirmed` 只能在用户明确确认后设置，不能由模型代替用户确认。
4. 如果工具仍要求确认，展示工具返回的脱敏摘要并再次等待用户决定，不得自动继续。
5. 写操作超时、连接中断或结果不确定时，不得自动重试或重放；先查询业务状态，再让用户决定是否重新确认执行。

## 安全边界

- 不执行删除、撤销、关闭、退款、解绑或其他破坏性操作。
- 不把查询到的一个对象 ID 静默用于另一个店铺、账号或资源类型。
- 不绕过当前会话提供的工具直接调用内部服务或拼装未声明参数。
- 涉及本地文件时，只处理用户明确指定的文件，并在上传前确认文件名、类型和用途。

## 常见问题

- 连接失败：先在 WorkBuddy 连接器面板重新连接；如果仍然失败，请联系管理员检查服务的外网配置。
- 可用工具为空：先确认登录成功和当前店铺选择无误；如果仍为空，可能是当前账号、店铺或能力策略未开放工具。
- 能力不可用：刷新当前会话的可用工具并重新规划，不自动重放原请求。
- 写操作要求确认：展示业务摘要并等待用户明确确认，不自动继续。