# Windows系统安装和登录
#### 准备工作
如果是个人用户，请使用实名认证的华为账号登录；如果涉及多人使用，建议使用IAM用户登录。
- 华为账号：华为账号是您访问华为各网站的统一身份标识，您只需注册华为账号，即可访问所有华为服务。在登录果办OfficeAce之前，请先[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)，[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。
  如果您已开通华为云并进行实名认证，请忽略此步骤。
  
- IAM用户：由[管理员](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section3)在IAM中创建的用户，是云服务的使用人员，根据账号授予的权限使用资源。[账号与IAM用户](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)为隶属关系，账号拥有全部权限，IAM用户仅拥有被授予的权限。IAM用户登录后可根据权限使用云服务。管理员创建IAM用户的方法请参考[创建IAM用户](https://support.huaweicloud.com/usermanual-iam5/iam_01_1144.html)。
  ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/caution_3.0-zh-cn.png)
  - 首次开通果办OfficeAce需**admin权限**，日常使用无需该权限。
  
  - IAM用户使用果办OfficeAce需管理员授予**signin::authorizeOAuth2Access、** **signin::createOauth2Token、** **agentarts::createAgreement权限** ，详细操作请参见[创建自定义身份策略](https://support.huaweicloud.com/usermanual-iam5/iam_01_0917.html)。
    图1授予IAM用户权限   
    ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456218.png "点击放大") 
    
 
#### 下载果办OfficeAce
1. 访问[华为云果办OfficeAce官方网站](https://www.huaweicloud.com/product/agentarts/officeace.html)。
2. 单击"立即下载"，选择"Windows x64"，在浏览器右上角下载区域，可查看下载进度。 
   下载完成后，安装包文件名格式为**OfficeAce-*x.x.x*-windows-x64-setup** 。
   图2下载客户端   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002730034482.png "点击放大")
   
   
 
#### 安装果办OfficeAce
**系统要求：**Windows 10、Windows 11
1. 下载完成后，双击安装包，启动安装程序。
2. 根据安装向导，单击"下一步"。 
   图3安装向导   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002759554095.png "点击放大")
   
   
3. 选择安装位置。如果无需修改默认安装路径，可直接单击"下一步"；如需自定义安装路径，单击"浏览"选择目标目录后单击"下一步"。 
   图4选择安装位置   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002759633989.png)
   
   
4. 选择快捷方式和启动方式，建议勾选"创建开始菜单快捷方式"和"创建桌面快捷方式"，单击"安装"。 
   图5选择快捷方式和启动方式   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002730194358.png)
   
   
5. 等待果办OfficeAce安装，安装进度条显示"已完成"后，单击"下一步"。 
   图6安装完成   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002730034484.png)
   
   
6. 勾选"立即启动OfficeAce"，单击"完成"结束安装流程。 
   图7完成安装流程   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002759554097.png "点击放大")
   果办OfficeAce客户端将立即启动，界面显示加载中，加载完成后进入登录界面。
   图8登录果办OfficeAce   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002759633991.png "点击放大")
   
   
 
#### 登录
1. 启动客户端，系统将自动跳转至登录界面，请使用华为账号或IAM用户登录。 
   默认无需配置网络代理，如果界面提示网络连接异常，请参见[界面提示网络连接异常，如何处理？]进行解决。
   图9登录界面   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002730194360.png "点击放大")
   
   
2. 账号登录后，页面将跳转至授权界面。请核对信息，并单击"确认授权"。 
   图10登录授权   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002730034486.png "点击放大")
   
   
3. 授权成功后，在弹出的对话框中单击"打开OfficeAce"切换回果办OfficeAce客户端，进入"开通服务"界面。开通服务界面进度条完成后，进入果办OfficeAce界面。 
   图11开通服务   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002759554099.png "点击放大")
   
   
4. 首次登录果办OfficeAce时，界面会弹出"服务声明以及隐私政策"弹框，请阅读后： 
   1. 勾选"我已阅读并同意 《隐私政策声明》、《华为云公测试用服务协议》和《AgentArts服务声明》"。
   
   2. 勾选"我同意将和 OfficeAce 交互的数据用于帮助模型优化和服务改进"。
   
   3. 单击"同意并继续"，进入果办OfficeAce界面。
      ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
      登录成功后，系统支持30天内免登录。在此期间再次打开客户端，将直接进入首页。
      图12果办OfficeAce首页   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002759633993.png "点击放大") 
   
   
   
   
 
#### 常见问题
- **Q：配置网络代理后，无法登录OfficeAce。**
  **A**：通常情况下，个人用户在普通的家庭网络环境下使用OfficeAce，无需手动配置网络代理，直接登录即可使用。
  但在以下场景中，可能需要配置网络代理：
  - 企业受限网络环境（如办公网络通过代理访问外网）
  
  - 使用第三方网络加速工具
  
  - 网络存在特殊访问限制
  
  
  如果出现登录缓慢、模型调用超时或提示"模型未加载成功，无法使用"等问题，可尝试配置代理解决。
  
- **Q：界面提示网络连接异常，如[图13]所示，如何处理？**
  图13网络连接异常   
  ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002754016019.png "点击放大")
  **A** ：请检查网络或配置网络代理，确保网络能够正常访问公网。配置网络代理的操作如下：
  1. 单击"配置网络代理"，进入网络代理配置界面，如[图14]所示。
     图14网络代理   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002724456200.png "点击放大") 
  
  2. 配置网络代理信息，参数说明如[表1]所示。
      表1参数说明 
     | 参数    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 示例                               |
     |:---|:---|:---|
     | 启用代理 | - 开启：模型调用、技能广场等外部请求将经过配置的代理服务器转发。  - 关闭：所有请求直连目标服务器。默认关闭。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 开启                                  |
     | 代理服务器 | 代理服务器主机地址，无需填写协议前缀。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | proxy.huawei.com                    |
     | 端口号  | 代理服务器端口号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 8080                                |
     | 代理鉴权 | 仅当代理需要用户名密码时开启。开启后，下方展示用户名和密码输入区域。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 开启                                 |
     | 用户名  | 开启"代理鉴权"后显示。 代理服务器的认证用户名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | /                                 |
     | 密码     | 开启"代理鉴权"后显示。 代理服务器的认证用户名对应的认证密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | /                                  |
     | 不走代理  | 指定无需经过代理、直接访问的IP或域名列表。匹配该列表的请求将绕过代理服务器直连目标。 以英文逗号分隔的IP或域名，支持通配符，如 \*.example.com。 典型场景示例： - localhost, 127.0.0.1：本地回环地址，无需代理。  - \*.huawei.com：华为内网域名，直接走内网更快。  - 10.\*, 192.168.\*：内网IP段，按需添加。   | 127.0.0.1,localhost,\*.example.com |
        
     
  
  3. 配置完成后单击"保存配置"，设置完成后，单击"立即重启"使设置生效。
    
- **Q：如何切换登录账号？单击登录后会自动登录当前账号，无法切换到其他账号。**
  **A**：请按以下步骤操作：
  1. 关闭当前浏览器。
  
  2. 在OfficeAce客户端左下角，单击用户名称，选择"退出登录"。
  
  3. 在登录界面，单击"使用华为云登录"，在跳转的华为云登录页面中，输入需要切换的新账号凭据完成登录。
  
  
  **说明：** 若关闭浏览器后仍自动登录，请在浏览器设置中清除华为云相关网站的Cookie和缓存后重试。
  
 
