> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 发布项目到 WorkBuddy

> 将 superun 项目发布到 WorkBuddy，让用户通过对话查询项目数据、使用已有业务功能。

将你在 superun 创建的项目发布到 WorkBuddy，让用户通过对话查询项目数据、使用已有业务功能。

项目在 WorkBuddy 中以「专家」的形式提供。你需要先在 superun 导出专家包，再上传到 WorkBuddy 并提交审核。

需要将网站部署上线时，使用[应用发布技能](https://docs.superun.com/superun/third-party-apps/workbuddy/skills/app-publish.md)。本页介绍如何将项目的业务能力提供给 WorkBuddy 用户。

## 先在 superun 下载专家包

1. 打开要发布的项目，进入 **运营 → Agent 友好**。
2. 如果还没有完成接入，先点击 **开始接入**，等待项目接入能力准备完成。
3. 在 **发布到 AI 平台 → WorkBuddy 专家** 中，点击 **导出专家包**。
4. 填写 **唯一标识**、**版本**、**作者姓名**、**作者邮箱**、**职位**和**专家花名**，选择 **WorkBuddy 专家分类**并上传 **头像**。
5. 核对或修改 **能力介绍**、**擅长领域**和 **试试这样问我**，并查看右侧卡片预览。
6. 点击 **生成并下载**，保存以 `-workbuddy-版本号.zip` 结尾的文件，例如 `xixi-crm-workbuddy-1.0.0.zip`。

![WorkBuddy 专家包导出设置：唯一标识、版本、作者信息、职位、专家花名、分类、头像，以及更多设置中的能力介绍、擅长领域和推荐提问](https://mintcdn.com/uxarts-dc22e128/xyzpz6JCGXc6Zvn5/images/workbuddy-project-expert/export-settings.png?fit=max\&auto=format\&n=xyzpz6JCGXc6Zvn5\&q=85\&s=65bc74d5496ad6d266b9e86a6674c7cc)

导出专家包：填写发布信息、选择分类和头像，核对能力介绍与卡片预览

下载后可以点击成功提示中的 **查看上传教程**，继续下面的操作。专家包绑定的是导出时的当前项目，发布其他项目时，请进入对应项目重新导出。

## 上传到 WorkBuddy 开放平台

**1. 上传专家 ZIP 包**

打开 [WorkBuddy 专家管理](https://open.workbuddy.cn/expert/all)，登录后进入专家上传流程。

在 **配置专家** 页面上传刚下载的 ZIP，直接上传原文件，无需解压或重新压缩。平台解析完成后，会展示文件名、类型 **专家** 和生成的专家 ID。

核对文件无误后，点击 **继续**。

![WorkBuddy 配置专家页面：ZIP 已上传，显示专家类型、专家 ID 和继续按钮](https://mintcdn.com/uxarts-dc22e128/J0Kv3RCL9HEoHpMV/images/workbuddy-project-expert/upload.png?fit=max\&auto=format\&n=J0Kv3RCL9HEoHpMV\&q=85\&s=5a4ea999528e0bbd7b9e29e59418f9a1)

配置专家：上传 ZIP，解析成功后继续

**2. 确认信息并补充分类**

在 **确认信息** 页面，核对从包中解析出的专家职称、花名、头像、能力介绍等信息，并查看右侧预览。

补齐带星号的必填项：

* **市场展示分类**：确认或选择适合项目的分类。截图示例为「数据智能」。
* **服务类目**：至少选择 1 个，最多添加 5 个。以查询项目数据为主的专家，可按实际用途选择「工具 - 信息查询」。

灰色不可编辑的信息来自专家包。如果职称、花名或其他包内信息有误，返回 superun 修改导出信息，重新生成 ZIP，再回到上一步上传。

确认信息和预览无误后，点击 **继续**。

![WorkBuddy 确认信息页面：市场展示分类和服务类目为必填项，右侧展示专家预览](https://mintcdn.com/uxarts-dc22e128/J0Kv3RCL9HEoHpMV/images/workbuddy-project-expert/confirm.png?fit=max\&auto=format\&n=J0Kv3RCL9HEoHpMV\&q=85\&s=e40bc1adb3f046281ed40c4a91a328fa)

确认信息：补充市场展示分类和服务类目，核对专家预览

**3. 核对内容并提交审核**

在 **提交审核** 页面，检查专家 ID、职称、花名、市场展示分类、版本号、头像、类目、介绍和推荐提问。

需要修改时点击 **上一步**；确认无误后点击 **提交**。

![WorkBuddy 提交审核页面：展示专家完整信息和提交按钮](https://mintcdn.com/uxarts-dc22e128/J0Kv3RCL9HEoHpMV/images/workbuddy-project-expert/review.png?fit=max\&auto=format\&n=J0Kv3RCL9HEoHpMV\&q=85\&s=79c4a1a3415a13a4798e5c30ab377174)

提交审核前，再次核对完整信息

**4. 等待审核结果**

出现 **已提交审核** 后，说明提交成功，尚不代表审核通过或已经上架。点击 **返回资产列表** 查看后续状态，并留意平台通知。

截图中的平台提示为「预计 7 个工作日内出结果」，具体时间和结果以 WorkBuddy 当前页面及通知为准。

![WorkBuddy 已提交审核提示：预计 7 个工作日内出结果，可返回资产列表](https://mintcdn.com/uxarts-dc22e128/J0Kv3RCL9HEoHpMV/images/workbuddy-project-expert/submitted.png?fit=max\&auto=format\&n=J0Kv3RCL9HEoHpMV\&q=85\&s=aad9e567409a446ee0e26396b4a75db0)

提交成功后，返回资产列表关注审核结果

## 专家首次使用

使用者安装专家后，首次接入时按专家指引检查本地运行环境、安装 superun CLI，并在浏览器中登录自己的项目账号完成授权。目标应用需要支持本地命令和 Node.js 20 或更高版本。

专家使用该账号的权限访问绑定项目；发布专家不会把作者的登录授权交给安装者。完成一次真实的只读数据查询后，才能确认接入成功。修改数据或执行业务功能前，按专家提示确认具体操作和参数。

## 常见问题

> [accordion] 提示专家名称已被占用怎么办？
>
> 返回 superun 的导出表单，修改 **唯一标识**，重新生成 ZIP 后上传。只修改 ZIP 文件名不会改变包内唯一名称，也不能解决名称占用。

> [accordion] 为什么导出时选了专家分类，上传后还要核对分类？
>
> 导出时可在 superun 选择 **WorkBuddy 专家分类**。上架时仍需在 WorkBuddy 的确认信息页面核对 **市场展示分类**，并补充 **服务类目**，以平台当前要求为准。

> [accordion] 下载成功后会自动上传或上架吗？
>
> 不会。下载只会生成专家 ZIP；你需要自行上传 WorkBuddy 开放平台并提交审核，之后查看审核结果和上架状态。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.