本页要点
- 插件只负责本站的读与写，不向第三方发送数据，也不需要服务器文件权限。
- 安装前先确认 WordPress 5.8+、PHP 8.0+、HTTPS 和固定链接不是「朴素」模式。
- 启用后要看到「观象台」菜单；接进工作台还需要应用密码。
配图占位 · 待补
WordPress 插件安装入口
WordPress 后台「插件 → 安装插件 → 上传插件」界面，或插件启用后左侧出现「观象台」菜单的截图。
- 显示「上传插件」和 zip 选择入口
- 或显示插件已启用、左侧菜单出现观象台
- 遮掉域名、账号等敏感信息
建议文件：docs-plugin-install-01.webp /public/assets/docs/docs-plugin-install-01.webp，再将本占位替换为图片。 01 装插件 上传 zip，启用，看到「观象台」菜单
02 生成密码 见「应用密码」页
03 填工作台 站点地址 + 用户名 + 应用密码
04 接数据 GSC / GA4 只读授权
05 首次同步 拉页面清单，确认已接入
插件没启用时，应用密码也连不上端点；Google 授权可以之后补。
安装前检查
先确认这五项
- WordPress 版本不低于 5.8，PHP 版本不低于 8.0（后台「工具 → 站点健康」可看）。
- 站点已经启用 HTTPS，浏览器地址栏没有「不安全」提示。
- 固定链接不是「朴素」模式（设置 → 固定链接，选「文章名」或自定义结构）。
- 你有管理员账号，能安装插件、生成应用密码。
- REST API 没有被安全插件或主机整体禁用（访问 /wp-json/ 应返回 JSON，而不是 404 或登录页）。
固定链接为「朴素」时 REST 端点会失效
WordPress 的 REST API 依赖 rewrite。固定链接设为「朴素」时，/wp-json/... 可能返回 404。先把固定链接改成「文章名」，保存后再装插件。
安装步骤
-
下载插件 zip
从观象台工作台或服务人员处获取最新插件包，不要解压后上传文件夹，WordPress 需要 zip 包。
-
进入 WordPress 后台
用管理员账号登录
https://你的域名/wp-admin/，左侧菜单点「插件 → 安装插件」。 -
上传并安装
点页面上方的「上传插件」→「选择文件」，选中 zip →「现在安装」。安装成功后点「启用插件」。
-
确认菜单出现
启用后，左侧菜单应出现「观象台」。点进去能看到插件版本、状态和「工作台能看到什么」的说明。
-
做一次站点自检
在「观象台」页面点「扫描」或「体检」，确认插件能读取自己的页面、分类和媒体库。
装上之后
- 左侧能看到「观象台」，插件显示已启用；
- 插件版本与工作台提示的版本接近；
/wp-json/guanxiangtai/v1/probe能返回 JSON（未登录可能 401，正常）；- 工作台里站点显示已接入、能拉到页面清单。
接进工作台需要 WordPress 用户名和应用密码，生成方法见 应用密码，之后再做 GSC 授权 与 GA4 授权。首次同步慢是正常的，不要连续点多次。
升级与断开
升级用「停用旧版 → 上传新 zip → 启用」；不要删除重装，避免丢插件设置。断开时停用插件，并在「用户 → 个人资料 → 应用程序密码」里删掉观象台那一条。具体见 应用密码。
做完检查
- 后台左侧能看到「观象台」，插件显示已启用。
- HTTPS 正常，固定链接不是「朴素」，/wp-json/ 返回 JSON。
- 我知道安装插件和生成应用密码是两步。
- 我知道升级用「停用 → 覆盖 → 启用」，不是删除重装。