Coco 插件安装部署

每种宿主只需执行一次对应安装命令,即可同时安装 Coco Word 与 Coco Excel。WPS 和 Microsoft Office 走远端入口;ONLYOFFICE Docker 支持远端 pluginsData 或容器本地 sdkjs-plugins;ONLYOFFICE Desktop 写入两套独立插件入口,再从当前发布地址加载 UI 资源。

远端资源 轻量入口 支持多宿主
通道:stable

WPS

一次更新 WPS 的 publish.xml,同时注册 Writer 与 Spreadsheets 两个 Coco 插件入口。

$script = Join-Path $env:TEMP "coco-wps-install.ps1"
Invoke-WebRequest __BASE_URL__/install/wps-install.ps1 -OutFile $script
powershell -ExecutionPolicy Bypass -File $script -BaseUrl "__BASE_URL__"
set "SCRIPT=%TEMP%\coco-wps-install.cmd"
curl -L -f -o "%SCRIPT%" "__BASE_URL__/install/wps-install.cmd" || certutil -urlcache -split -f "__BASE_URL__/install/wps-install.cmd" "%SCRIPT%"
call "%SCRIPT%" "__BASE_URL__"
curl -fsSL __BASE_URL__/install/wps-install.sh -o wps-install.sh
chmod +x ./wps-install.sh
COCO_RELEASE_BASE_URL="__BASE_URL__" ./wps-install.sh
执行后需要完全退出并重启 WPS Writer 与 WPS Spreadsheets。

ONLYOFFICE Desktop

Desktop Editors 需要本地插件入口。脚本会同时安装 Word 与 Spreadsheet 两套独立 GUID/config,入口壳内的 UI/脚本资源仍从当前发布地址加载。

$script = Join-Path $env:TEMP "coco-onlyoffice-desktop-install.ps1"
Invoke-WebRequest __DESKTOP_BASE_URL__/install/onlyoffice-desktop-install.ps1 -OutFile $script
powershell -ExecutionPolicy Bypass -File $script -BaseUrl "__DESKTOP_BASE_URL__"__DESKTOP_API_ARG_PS__
set "SCRIPT=%TEMP%\coco-onlyoffice-desktop-install.cmd"
curl -L -f -o "%SCRIPT%" "__DESKTOP_BASE_URL__/install/onlyoffice-desktop-install.cmd" || certutil -urlcache -split -f "__DESKTOP_BASE_URL__/install/onlyoffice-desktop-install.cmd" "%SCRIPT%"
call "%SCRIPT%" "__DESKTOP_BASE_URL__"__DESKTOP_API_ARG_CMD__
curl -fsSL __DESKTOP_BASE_URL__/install/onlyoffice-desktop-install.sh -o onlyoffice-desktop-install.sh
chmod +x ./onlyoffice-desktop-install.sh
COCO_RELEASE_BASE_URL="__DESKTOP_BASE_URL__" __DESKTOP_API_ENV__./onlyoffice-desktop-install.sh
安装后完全退出并重启 ONLYOFFICE Desktop Editors。Desktop 版不要把 config.json.url 直接改成远端地址,实测会打开空白面板。

ONLYOFFICE Docker

支持两种合并安装方式:在 DocsAPI.DocEditor 配置中同时注入 Word 与 Spreadsheet 的 pluginsData,或用脚本一次写入容器中的两套 sdkjs-plugins。

editorConfig: {
  plugins: {
    pluginsData: [
      "__BASE_URL__/onlyoffice/config.json",
      "__BASE_URL__/onlyoffice/config.excel.json"
    ],
    autostart: [
      "asc.{8D9B5A2C-1F3E-4C7A-9B0D-2E6F1A4C8B30}",
      "asc.{A9551FA7-1158-4A6E-9DE0-9A36684B7934}"
    ]
  }
}
Word:  __BASE_URL__/onlyoffice/config.json
Excel: __BASE_URL__/onlyoffice/config.excel.json
curl -fsSL __BASE_URL__/install/onlyoffice-docker-install.sh -o onlyoffice-docker-install.sh
COCO_DOCKER_APPLY=1 COCO_RELEASE_BASE_URL="__BASE_URL__" bash onlyoffice-docker-install.sh onlyoffice-documentserver
$script = Join-Path $env:TEMP "coco-onlyoffice-docker-install.ps1"
Invoke-WebRequest __BASE_URL__/install/onlyoffice-docker-install.ps1 -OutFile $script
powershell -ExecutionPolicy Bypass -File $script -Container onlyoffice-documentserver -BaseUrl "__BASE_URL__" -Apply
set "SCRIPT=%TEMP%\coco-onlyoffice-docker-install.cmd"
curl -L -f -o "%SCRIPT%" "__BASE_URL__/install/onlyoffice-docker-install.cmd" || certutil -urlcache -split -f "__BASE_URL__/install/onlyoffice-docker-install.cmd" "%SCRIPT%"
call "%SCRIPT%" onlyoffice-documentserver "__BASE_URL__" apply
远端模式不需要改 Document Server 容器,但要求接入方能修改 DocEditor 初始化配置;本地模式会把插件入口壳复制到容器的 sdkjs-plugins,适合无法修改业务系统配置的场景。

Microsoft Office

一次下载并登记 Word 与 Excel 两份 manifest。Windows 可使用脚本侧载;企业环境建议通过 M365 管理中心分别上传两份 manifest。

$script = Join-Path $env:TEMP "coco-microsoft-install.ps1"
Invoke-WebRequest __DESKTOP_BASE_URL__/install/microsoft-install.ps1 -OutFile $script
powershell -ExecutionPolicy Bypass -File $script -BaseUrl "__DESKTOP_BASE_URL__"
set "SCRIPT=%TEMP%\coco-microsoft-install.cmd"
curl -L -f -o "%SCRIPT%" "__DESKTOP_BASE_URL__/install/microsoft-install.cmd" || certutil -urlcache -split -f "__DESKTOP_BASE_URL__/install/microsoft-install.cmd" "%SCRIPT%"
call "%SCRIPT%" "__DESKTOP_BASE_URL__"
Word:  __DESKTOP_BASE_URL__/microsoft/manifest.xml
Excel: __DESKTOP_BASE_URL__/microsoft/manifest-excel.xml
Admin Center: Integrated apps -> Upload custom apps
Windows 脚本会下载并登记两份 manifest。完成后分别在 Word 与 Excel 的「插入 → 我的加载项 → 共享文件夹」中添加 Coco;如果看不到入口,先刷新加载项列表。

验证方式

WPS:分别重启 Writer 与 Spreadsheets,确认两边都出现对应的 Coco 入口。
ONLYOFFICE:分别打开文档与电子表格,确认 Coco Word 与 Coco Excel 都能打开各自侧边栏。
Microsoft Office:分别重启 Word 与 Excel,在共享文件夹中添加对应 Coco 加载项并验证面板。