﻿杰公文助手安装说明（Word/WPS 双平台）

安装前准备：
1. 支持 Windows 桌面版 Microsoft Word 2010 及以上，或 WPS 文字桌面版；两者同时安装也可以。WPS 电脑同时获得“杰表格助手”表格插件。
2. 不需要预先安装 .NET 或 VSTO。安装器先检测环境，只补装实际缺少的组件。
3. WPS 不依赖 VSTO；电脑只有 WPS 时不会安装 VSTO Runtime。
4. 安装、升级、修复或卸载前需要关闭 Word 和 WPS：检测到正在运行时会弹出提示窗口，全部关闭后自动继续，无需重新运行安装程序。
5. Windows 7 必须安装 SP1；离线包已带所需的 KB4490628、KB4474419 及 x86/x64 组件。
6. 安装后 WPS 里没有“杰公文助手”选项卡时：先彻底退出 WPS（包括右下角后台，或重启电脑）再打开文档；仍不显示就双击安装包里的“修复工具.bat”，按提示操作后看桌面生成的修复报告。
6. 离线包带仿宋_GB2312、楷体_GB2312和方正小标宋简体；安装器先做 SHA-256 校验，只请求管理员权限安装本机缺少的字体，已安装字体不会重复覆盖。
7. 电脑装有 360、火绒、腾讯电脑管家等杀毒/安全软件时，安装可能明显变慢（安全软件会对插件文件反复实时扫描；本产品只读写下面这个目录，不改动其他内容）。安装前把该目录加入安全软件的“信任区/白名单”，再运行 setup.exe，安装通常可缩短到半分钟内：
   C:\Users\<你的用户名>\AppData\Local\OfficialDocWordAddin
   也可把安装包解压目录和 setup.exe 一并加入信任；已安装过且感觉慢的电脑，加白后重新运行一次安装即可。

安装步骤：
1. 把 ZIP 完整解压到任意目录，不能只复制 setup.exe。
2. 双击 setup.exe，核对检测到的 Word/WPS 和缺少组件，点“继续安装”。
3. 安装过程会显示进度窗口：当前步骤（前置组件→公文字体→Word 加载项→WPS 加载项→完成）和进度条；期间请勿关闭该窗口或打开 Word/WPS。
4. 安装完成后会弹出确认对话框；装了 WPS 的电脑，对话框同时附 WPS 首次启用指引。
5. 检查但不修改：setup.exe /check；修复：setup.exe /repair；升级：setup.exe /upgrade；卸载：setup.exe /uninstall。
6. 安装完成后重新打开 Word 或 WPS 文字，顶部出现“杰公文助手”选项卡即可使用；打开 WPS 表格出现“杰表格助手”选项卡。

安装器处理规则：
1. 只有 Word：安装 Word VSTO 加载项，只在缺少时安装 .NET、VSTO 和 Win7 补丁。
2. 只有 WPS：安装 WPS COM 加载项（文字＋表格），只在缺少时安装 .NET 和 Win7 补丁，不安装 VSTO。
3. Word 与 WPS 都有：全部加载项同时安装，共用排版模板、会员账号和更新设置。
4. 两者都没有：明确提示未检测到受支持的办公软件，不继续安装。
5. 字体安装失败时会显示错误代码，并将具体原因写入 %TEMP%\OfficialDocWordAddinFonts.log；卸载插件时不删除系统字体，以免影响其他文档和软件。
6. 1.62 起安装时自动把本产品发布者证书写入当前用户“受信任的发布者”存储（免管理员、无弹窗，卸载时移除），使 WPS 认可加载项签名。

插件未显示：
1. 1.62 起新电脑安装后一般无需任何设置：打开 WPS 文字或表格即可使用，文字和表格两端都有后台自动连接（OfficialDocWpsAddinLoader.exe）。
2. 若功能区仍未出现：确认 Word/WPS 已完全退出后运行 setup.exe /repair。
3. Word：文件→选项→加载项→管理“COM 加载项”→转到，确认 OfficialDocWordAddin 已启用。
4. WPS 文字：开发工具→COM 加载项，确认“杰公文助手（WPS）”已启用；WPS 表格同理确认 OfficialDocWordAddin.Spreadsheet。1.34 起修复安装会自动移除本插件自身的旧崩溃/禁用记录并重新验证登记。
5. 任务管理器中应有 OfficialDocWpsAddinLoader.exe；没有时运行 setup.exe /repair。它同时值守 WPS 文字和表格：打开对应文档/工作簿后自动接通菜单；断开 45 秒才显示一次启用操作提示，WPS 首页不提示，也不会打开或修改文档。
6. 个别新版 WPS 仍可能对未完成 WPS 开发者认证的第三方 COM 加载项弹黄色提示条；按提示启用一次即可，或运行 setup.exe /repair。面向多台电脑发布前，建议按 WPS 官方“COM 加载项开发者申请认证社区指南”完成认证。
7. 若重装后仍不能用，请提供 Windows 和 WPS 版本、是否出现“杰公文助手”选项卡，以及下面的 WPS 自动加载和 COM 菜单日志。

自动更新：
1. 配置正式服务器后，程序每天后台检查更新；有新版本时自动下载，关闭 Word/WPS 后自动安装，之后按需弹出更新说明。
2. 服务器设置“最低版本”后，低于该版本的客户端会提示必须更新，更新完成前排版功能暂停。
3. 更新安装完成后首次打开 WPS 文档时，如功能区未出现会弹一次“如何启用”说明。

安装日志：
1. 主日志：%TEMP%\OfficialDocWordAddinSetup.log
2. WPS 注册日志：%TEMP%\OfficialDocWpsAddinSetup.log
3. Windows 7 补丁日志：%TEMP%\OfficialDocWordAddinWin7.log
4. 前置组件日志：%TEMP%\OfficialDocWordAddinBootstrapper.log
5. 网络服务日志：%LocalAppData%\OfficialDocWordAddin\online-service.log
6. WPS 自动加载日志：%TEMP%\OfficialDocWpsAddinLoader.log
7. WPS COM 菜单日志：%TEMP%\OfficialDocWpsComAddin.log

注意：
- 本程序是 Word/WPS 加载项，不是独立文字处理软件。
- 第一次在新型号 WPS 上安装后应先用测试文档验收，再处理正式文件。
- 当前离线包默认使用安全占位服务器，不会自动联网或强制收费；配置正式 HTTPS 服务器后重新打包才会启用登录、收费和更新。
- 正式跨单位销售前必须更换为受信任的商业代码签名证书。
