Office AI 插件故障排查 / Office AI Add-in Troubleshooting
这份文档用于处理公开页面中最常见的安装、功能区入口和下载问题。每个结论都应结合当前版本、Windows 版本和 Office 应用实际验证。
This document covers common installation, ribbon-entry, and download problems. Every conclusion should be checked against the current release, Windows version, and Office host.
安装后功能区没有 Office AI / Office AI is missing from the ribbon after installation
- 确认安装包来自当前版本页或升级清单，不要使用来源不明的旧包。
- 关闭正在运行的 Word、Excel 和 PowerPoint。
- 重新运行当前安装包，完成安装或覆盖升级。
- 重新打开 Office，检查功能区和加载项状态。
- 如果仍然没有入口，重启 Windows 后再次检查加载项是否被禁用。
- 在社区“安装升级”分类发帖，提供 Office 应用和版本、Windows 版本、插件版本、错误提示和复现步骤。
- Confirm that the installer comes from the current release page or upgrade manifest; do not use an unknown old package.
- Close Word, Excel, and PowerPoint.
- Run the current installer again to install or update in place.
- Reopen Office and check the ribbon and add-in status.
- If the entry is still missing, restart Windows and check whether the add-in is disabled.
- Post in the Installation and updates community category with the Office app and version, Windows version, add-in version, error message, and reproduction steps.
下载入口显示暂未开放 / The download entry says the package is pending
下载按钮依赖当前升级清单和公开安装包地址。清单没有 PackageUrl 时，页面可能只显示版本状态或升级清单，而不会提供安装包。
The download button depends on the current upgrade manifest and public installer URL. When PackageUrl is absent, the page may show release status or the manifest instead of an installer.
检查顺序 / Check in this order:
- 查看
/releases的当前版本和发布日期。 - 查看
/officeaddin/upgrade.ini或页面显示的升级清单地址。 - 如果包已发布，比较页面中的版本、下载地址和校验值。
- 如果包未发布，不要把升级清单当成安装包，也不要重复下载未知地址。
- Check the current version and release date on
/releases. - Check
/officeaddin/upgrade.inior the manifest URL shown by the page. - If a package is published, compare the version, download URL, and checksum shown by the page.
- If the package is not published, do not describe the manifest as an installer or repeatedly download an unknown URL.
自动化结果与文档状态 / Automation results and document state
- 执行重要文档操作前先备份，并在原始文件之外验证结果 / Back up important documents and verify results outside the original file.
- Office 版本、权限、受保护文档和文档状态可能影响自动化结果 / Office version, permissions, protected documents, and document state can affect automation results.
- 不要从一个普通文档示例推断所有加密或受保护文档都受支持 / Do not infer universal support for encrypted or protected documents from an ordinary document example.
- AI 输出、脚本和自动化结果需要用户复核，不替代业务审批 / AI output, scripts, and automation results require user review and do not replace business approval.
发帖所需信息 / Information required for a useful report
| 信息 / Information | 示例或说明 / Example or explanation |
|---|---|
| Office 应用 / Office app | Word、Excel 或 PowerPoint |
| Office 版本 / Office version | Microsoft 365、Office 2016 等；请提供实际版本 |
| Windows 版本 / Windows version | Windows 10 或 Windows 11，并提供必要的版本号 |
| 插件版本 / Add-in version | 版本页或客户端显示的版本 |
| 现象 / Observed behavior | 功能区入口消失、安装失败、运行报错等 |
| 复现步骤 / Reproduction steps | 从打开文档到出现问题的最短步骤 |
| 错误信息 / Error message | 完整错误文本或脱敏后的截图 |
不要提交 token、密钥、真实业务文件或未脱敏的个人信息。不要把临时聊天猜测写成已验证结论。
Do not submit tokens, keys, real business files, or unredacted personal information. Do not turn a temporary chat guess into a verified conclusion.
官方入口 / Official paths
- 安装指南 / Installation guide:
/install - 常见问题 / FAQ:
/faq - 版本更新 / Releases:
/releases - 产品事实 / Product facts:
/docs/product.md - 兼容性矩阵 / Compatibility matrix:
/docs/product.md - 社区 / Community:
/community