打开 Copilot 的方法 — Web · 主屏幕应用 · Windows 应用
Copilot 画面由安装现场的 Copilot 服务器提供。打开的途径有三种，无论用哪种打开，都是相同的画面、相同的账号、相同的权限。
| 打开途径 | 适用场景 | 需另外安装的东西 |
|---|---|---|
| Web 浏览器 | 在办公室 PC · 笔记本上直接打开时 | 无 |
| 主屏幕应用（PWA） | 在现场手机 · 平板上像应用一样打开并接收推送通知时 | 浏览器的«添加到主屏幕» |
| Windows 桌面应用（筹备中） | 不以浏览器标签页、而以任务栏中的一个窗口来使用时 | 一个安装文件 |
地址由管理员提供 — 例如：https://copilot.<회사>.local。必须是 HTTPS 地址，麦克风（语音提问）和推送通知才能启用。
Web 浏览器
在最新版 Chrome · Edge · Safari · Firefox 中打开地址。登录后首屏是提问画面 → Copilot 画面导览。
- 首次打开时画面语言跟随浏览器的语言设置（韩语 · 英语）。可在登录画面下方的«한국어 · English»切换。
- 在未登录状态下打开邮件 · 通知中的链接，会先显示登录画面，登录后会跳转到该链接对应的画面。
- 标签页长时间打开期间，若服务器升级到新版本，画面下方会出现「有新版本」通知 — 与下方«主屏幕应用»相同。
主屏幕应用（PWA）
将通过浏览器打开的 Copilot 像应用一样添加到手机 · 平板的主屏幕上。打开时没有地址栏，并可接收推送通知。
| 设备 | 添加方法 |
|---|---|
| Android（Chrome） | 打开地址，点菜单 ⋮ → 添加到主屏幕（或安装应用） |
| iPhone · iPad（Safari） | 打开地址，点共享 → 添加到主屏幕 |
| PC（Chrome · Edge） | 地址栏右侧的安装图标 |
Copilot 画面内并没有单独的安装按钮 — 如上所述，通过浏览器的菜单添加。
- 应用名称和图标遵循安装时的品牌设置（产品名称 · 图标或 Logo）。打开已添加的应用后，会从提问首屏开始。
- 添加后，在设置 › 通知中打开«手机·浏览器通知»。iPhone · iPad 只有已添加到主屏幕的应用中才能接收推送。
- 只能从 HTTPS 地址添加。设备必须信任服务器的证书 — 如果是内部证书颁发机构（CA）签发的证书，需要先在设备上注册该 CA。 用不受信任的证书打开时画面可以显示，但推送通知和下方«断网时»的行为无法生效。
新版本通知 — 服务器升级到新版本时，画面下方会出现**「有新版本」提示与刷新**按钮。点击后会切换到新画面 — 不需要重新安装。
- 为保留正在编写的内容，**不会自行刷新。**通知在点击之前也不会消失 — 请在完成当前输入后再点击。
- 应用（标签页）重新切回时以及打开期间每隔 30 分钟会检查是否有新版本。
断网时 — 使用中网络中断时，画面上方会出现「网络连接已断开。连接恢复后可重新发送」的提示条。 断网状态下打开应用时，内容区域会显示「网络连接已断开……」或「无法连接到服务器。请检查网络后重试」，或「无法连接」加重试按钮。 工厂数据 · 回答 · 列表不会存储在设备上，因此必须联网后才能看到内容。
Windows 桌面应用
Windows 桌面应用尚未公开发布。以下内容是以公开发布版本为基准的说明，下载地址将在发布时一同开放。在此之前，请使用 Web 浏览器或主屏幕应用。
这是一个打开安装现场 Copilot 服务器地址的轻量窗口。画面并非内置在应用中，而是原样显示服务器提供的画面 — 因此 即便服务器升级到新版本，应用也无需重新安装。应用自身仅拥有两个画面：服务器地址画面和无法连接画面。
| 项目 | 值 |
|---|---|
| 支持系统 | Windows 10 · 11，x64 |
| 安装方式 | 按用户安装 — **不需要管理员权限。**可以选择安装位置 |
| 大小 | 约 106 MB |
| 自动更新 | 无（考虑到隔离网络安装场景）。新版本需重新执行安装文件进行覆盖安装 |
| 代码签名 | 无 — 安装时会出现 Windows 警告（见下方第 2 步） |
下载
| 版本 | 地址 |
|---|---|
| 最新版 | https://product.kopens.io/plantpulse-ai/desktop/latest/PlantPulse-Copilot-Setup-x64.exe |
| 按版本区分 | https://product.kopens.io/plantpulse-ai/desktop/<YYYY.MM>/PlantPulse-Copilot-Setup-<version>-x64.exe |
两个地址中，安装文件旁都有同名的 .sha256 文件（版本区分文件夹中还有该签名的 .sha256.sig）。可用 PowerShell 对照下载文件是否正确。
Get-FileHash .\PlantPulse-Copilot-Setup-2026.10.0-x64.exe -Algorithm SHA256
# 출력의 Hash 값이 .sha256 파일의 값과 같아야 합니다
如果现场无法连接互联网，请在能上网的 PC 上下载后拷贝到内网。应用本身在安装后只会连接到 Copilot 服务器。
如果«最新版»地址似乎返回了旧文件，可在地址后加上任意数字如 ?v=1 再重新下载。
代码签名 — 在内部无警告地分发
**当前版本的安装文件没有代码签名。**签名方式尚未确定 — 在此之前，请按下方«安装»步骤 2 跳过警告，或由 IT 将文件哈希加入允许列表。 签名版本发布后，可在 PC 上注册该签名的根证书，即可免«PC 保护»警告安装。
| 注册位置 | 添加到的存储区 |
|---|---|
| 组策略（GPO） — 计算机配置 › 策略 › Windows 设置 › 安全设置 › 公钥策略 | 受信任的根证书颁发机构 + 受信任的发布者 |
| Intune — 设备配置文件«受信任的证书» | 相同的两个存储区 |
证书文件地址和指纹将记录在应用签名生效版本的发行说明中。
安装
- 运行
PlantPulse-Copilot-Setup-<version>-x64.exe。 - 出现「Windows 已保护你的电脑」窗口时，点击更多信息 → 仍要运行。此警告是因为安装文件没有代码签名而出现。 若是在内部批量分发，可由 IT 通过组策略 · Intune 将该文件的哈希加入允许列表，即可免警告安装。
- 安装范围选择仅当前用户（默认）。桌面和开始菜单会出现 PlantPulse Copilot 快捷方式。
卸载通过 Windows 设置 › 应用 › PlantPulse Copilot › 卸载完成。服务器地址等用户设置会保留（见下方«用户数据»）。
输入服务器地址
首次运行会出现服务器地址画面。输入管理员提供的地址后点击连接。此后再次启动会直接进入该服务器的登录画面。
- 只接受
https://地址。http://地址会被拒绝并提示「只能使用安全连接（https）地址」 — 若因证书不匹配而打不开，不要降级为http，请按下方«导入内部 CA 证书»解决。 若输入时省略了https://，会自动补上https://。 - 带路径的地址也可以 — 例如：
https://host/copilot。地址后面的?…·#…会被去除。 - 地址中不能包含
계정:비밀번호@（因为会原样留在配置文件中）。登录请在画面中进行。
要更换服务器，可点击菜单文件 › 更换服务器…，或在«无法连接»画面中点击更换服务器。
无法连接
当服务器关闭或网络中断时，会出现无法连接画面。可点击重试重新连接，或点击更换服务器修改地址。
导入内部 CA 证书
若服务器使用内部证书颁发机构（CA）签发的证书，首次连接时会出现«无法连接 — 证书错误»。
- 点击更换服务器 → 导入 CA 证书，选择 CA 证书文件（
.pem·.crt·.cer，PEM 格式）。 需要的不是服务器证书，而是签发该证书的 CA 证书 — 例如安装主机上的/etc/kopens/ca/root.crt。 - 画面会显示 CA 名称 · 到期日期 · SHA-256 指纹。请与管理员提供的指纹进行比对。
- 导入 CA 后，应用会自动重启 — 因为需要重启才能用新 CA 重新判定刚才被拒绝的服务器。 若已提前输入服务器地址，重启后会直接打开该服务器。删除已导入的 CA 时应用同样会重启。
导入的 CA 仅对所设定的服务器生效。不会影响其他站点的证书判定，也不会关闭证书验证 — 主机名 · 有效期 · 签名仍会照常验证。不接受 DER（二进制）格式文件，请转换为 PEM 格式后再导入。
certutil -encode root.der root.pem
快捷键
| 按键 | 动作 |
|---|---|
Ctrl + +（或 =） | 放大 |
Ctrl + - | 缩小 |
Ctrl + 0 | 恢复原始大小 |
F5 | 刷新 |
F11 | 全屏 |
该应用一次只能打开一个实例 — 已经打开时再次运行，会将该窗口切换到前台。
用户数据
服务器地址 · 窗口大小和位置（settings.json）、导入的 CA（ca.pem）、登录 Cookie 会保存在 %APPDATA%\PlantPulse Copilot\ 中。
删除此文件夹即可恢复到首次运行状态。
面向 IT 负责人的行为范围
| 项目 | 行为 |
|---|---|
| 窗口内跳转 | 仅限于设定的**服务器地址（origin）**范围内。其他网址会用默认浏览器打开，而像 file: 这样的其他类型地址则不会打开 |
| 浏览器权限 | 仅允许服务器画面使用麦克风（聊天语音提问，仅音频）· 剪贴板写入（复制按钮）· 全屏。摄像头 · 位置 · 通知 · USB · 串口等均被拒绝 — 因此推送通知不是通过 Windows 应用，而是通过 Web 浏览器 · 主屏幕应用接收 |
| TLS | 不关闭证书验证。内部 CA 只能通过上述«导入 CA 证书»方式添加 |
| 运行隔离 | 启用 Chromium 沙箱 · 上下文隔离，画面中无法使用 Node.js。没有开发者工具菜单 |
| 网络 | 应用不会自行对外连接 — 不检查更新 · 不发送使用统计，拼写检查（需从外部获取词典）功能也已关闭 |