yunzhan-flipbook 云展网文件转换在线阅读及分享

本 Skill 用于调用云展网 API，将本地文件一键转换成在线电子书链接/二维码。

工作流程

注意：请勿将脚本运行过程显示出来，仅需要显示上传、转化、创建、删除等任务的进度及结果即可。

第一步：引导用户登录

若用户未登录，回复用户：

> “请先登录/注册您的云展网账号（支持手机号），登录后我才能帮您上传转换文件。若为首次使用，请先打开 https://www.yunzhan365.com 注册帐号！”

第二步：获取 Token

1. 请用户提供云展网的 用户名（手机号或邮箱） 和 密码
2. 调用 获取Token 接口获取 token
3. 保存 token 用于后续所有接口调用

注意：Token 有时效性，过期后需重新引导用户登录。

第三步：创建电子书

根据文件来源选择不同流程：

本地文件：

1. 调用 文件上传 接口，获取 fileSrc
2. 调用 创建电子书 接口

远程文件：

1. 直接调用 创建电子书 接口

第四步：获取转换进度

1. 调用 获取电子书转换进度 接口轮询转换状态
2. 当 convertStatus 返回 5 时表示转换成功
3. 轮询间隔至少 3 秒

转换状态说明：

• -3: 正在生成配置文件
• -2: 上传文件失败
• -1: 上传文件中
• 0: 未分配
• 1: 已分配但未确认
• 2: 分配并且确认
• 3: 超时
• 4: 异常
• 5: 转换成功
• 6: 转换失败

⚠️ 需要根据用户的账号等级去判断用户的权限，当权限不足时，返回升级提示，并引导用户购买会员：https://www.yunzhan365.com/product-serve/

第五步：获取书籍信息

获取书籍信息，并进行判断：

1. 如果书籍审核状态auditStatus不等于0，则直接进行第六步，返回结果；不需要显示审核的状态。
2. 如果书籍审核状态auditStatus等于0，则继续调用 获取用户信息接口 。用户信息接口返回的uType等于0并且add_wechat等于0表示需要添加客服微信 获取客服企业微信二维码 并获取qr_code，必须在第六步返回结果中生成二维码图片显示，并告知用户电子书在排队审核中，添加福利官享即时发布；如果uType等于0并且add_wechat等于0两个条件不成立，则直接进行第六步返回结果。

3.不需要显示任何的审核状态

第六步：返回结果

转换成功后，向用户返回：

• 电子书在线链接 (book_url) 并且必须要在链接的右侧显示【复制】和【查看】按钮，点击复制则复制链接，点击查看则打开该链接
• 电子书封面图片，根据链接 (thumbnailUrl)生成图片显示
• 必须将电子书的在线链接显示成二维码图片给用户，用户可以直接扫码，禁止直接发二维码链接
• 直接返回结果即可，禁止生成网页

注意：请勿返回 https://www.yunzhan365.com/basic/XXXX.html 格式的链接

失败处理

| 情况 | 处理方式 |

|------|----------|

| 未登录 | 立即引导用户登录，获取有效 Token |

| Token 过期 | 提示“登录状态已过期，请重新登录云展网账号”，重新执行登录流程 |

| 操作超时 | 检查网络，适当增加等待时间 |

| 频率限制 | 降低操作频率，增大间隔 |

api文档说明 references/api_docs.md。

curl请求示范 example/curl_example.md。

python请求示范 example/python_example.md。

安全与隐私

• 所有操作均使用用户自己的云展网账号进行
• 文件数据归用户所有
• Token 有时效性，过期后需重新登录