79 lines
4.9 KiB
Markdown
79 lines
4.9 KiB
Markdown
# H5配对和真实海诺对话 · 2026-10-26增量
|
||
|
||
## 已有环境无需重做
|
||
|
||
- ECS:10.77.76.13:443,目录 `/home/cnooc/hainuo-offline-arm64/hainuo-relay`。
|
||
- PC已绑定 `ou_test_tianzeyuan`,证书目录 `D:\HainuoRelayDevice`。
|
||
- 实际海诺安装位置 `%LOCALAPPDATA%\Hainuo`,不是示例D:\Hainuo1065。
|
||
- 本机原生API:127.0.0.1:8643,纯文本模式;ECS→桥接端→真实模型已经返回42。
|
||
|
||
本次新增:网页配对、Secure/HttpOnly浏览器会话、设备在线状态、纯文本聊天、离线提示、请求去重、退出登录及绑定变更失效。暂不依赖海能Work OAuth配置。
|
||
|
||
## 1. 更新ECS
|
||
|
||
将 `hainuo-relay-h5-update-20261026.tar.gz`上传到 `/home/cnooc`,执行:
|
||
|
||
```bash
|
||
tar -xzf /home/cnooc/hainuo-relay-h5-update-20261026.tar.gz \
|
||
-C /home/cnooc/hainuo-offline-arm64
|
||
cd /home/cnooc/hainuo-offline-arm64/hainuo-relay
|
||
sudo bash scripts/update-h5.sh
|
||
```
|
||
|
||
增量包只包含源码、网页资源、更新脚本、Dockerfile和说明,不包含.env、runtime、证书、CA或数据库。更新先保留旧镜像标签,使用原wheelhouse离线构建,只重建连接器;其他组件不重装。连接器重启时在途请求可能中断,等当前任务完成后再更新。
|
||
|
||
不要运行旧的install.sh重新初始化,不要重新解压整包覆盖更新后的源码。后续recreate使用compose.h5.yaml,以保留180秒模型等待时间。
|
||
|
||
## 2. Windows生成网页配对码
|
||
|
||
本机项目已更新 `web-pair`命令,原生API与桥接端保持运行。Windows PowerShell执行:
|
||
|
||
```powershell
|
||
cd "C:\Users\huawei\Desktop\海能h5连接海诺客户端\hainuo-relay"
|
||
& "..\.venv\Scripts\python.exe" -m relay.cli web-pair `
|
||
--directory D:\HainuoRelayDevice `
|
||
--url https://10.77.76.13 `
|
||
--tls-ca D:\HainuoRelayDevice\server.pem
|
||
```
|
||
|
||
输出网页地址和一次性配对码。有效期120秒;不要发到群里、工单或聊天截图。生成失败HTTP404表示ECS仍是旧版,先完成步骤1。
|
||
|
||
## 3. 浏览器配对和聊天
|
||
|
||
打开 `https://10.77.76.13/h5`,必要时Ctrl+F5刷新。页面应出现“输入电脑上的配对码”和“连接我的电脑”,不再只有原OAuth按钮。
|
||
|
||
粘贴配对码后点击连接。网页显示“你的电脑已在线”后,发送:
|
||
|
||
```text
|
||
请计算17加25,只回复计算结果。
|
||
```
|
||
|
||
预期回复42。普通文本自动加 `/助手`转给本机真实海诺API;`/主机名`和`/回显 内容`保留用于核对目标设备。
|
||
|
||
每个消息有独立请求ID;同一ID不会重复执行。网络失败不自动重发;出现状态未知时先核查,不要重复提交有副作用的任务。当前所有原生模型调用禁止工具,不能执行删除等指令。
|
||
|
||
## 会话和安全边界
|
||
|
||
- 网页登录依靠本机设备私钥签名申请的高熵一次性码,不接受网页自报owner/host作为身份。
|
||
- 配对码120秒一次消费、会话30分钟固定过期。服务端只保存配对/会话凭据的SHA256索引;浏览器凭据只放Secure、HttpOnly、SameSite=Strict Cookie,不放URL或localStorage。
|
||
- 网页POST必须Origin与HN_PUBLIC_URL一致;ECS当前应为 `https://10.77.76.13`。不开放任意Origin,不用管理员密钥给网页登录。
|
||
- 请求主体由浏览器会话确定;切换用户、解绑、吊销或绑定代次变化会失效。另一用户不能通过提交open_id调用你的电脑。
|
||
- 这是**试点中继网页模式**:浏览器HTTPS在入口终止,B1在内存中处理网页正文,再应用层加密发到PC;B2只见密文。中继不保存聊天正文,网页关闭或退出后当前页面历史不保留。
|
||
- 这与领导原方案“浏览器TLS直接终止在PC、中心看不到网页正文”不同。不能将本模式称作浏览器到PC端到端加密或正式生产安全验收通过。
|
||
- 海能Work授权入口仍保留;只有配置真实平台OAuth后才能使用。后续可独立切换平台身份来源。
|
||
- 本地原生API+桥接端目前是后台进程,电脑重启后需要按原生接入手册恢复启动;尚未实现Windows服务自启动。
|
||
|
||
## 验收
|
||
|
||
1. 未配对网页不可派发任务,直接访问/web/chat应401。
|
||
2. 配对后收到42,/主机名与Windows hostname一致。
|
||
3. 同一配对码第二个浏览器使用失败。
|
||
4. 退出网页登录后,原Cookie立即无效。
|
||
5. PC停止桥接端时网页显示离线,新问题返回离线提示;重连后恢复。
|
||
6. 两个设备不同账号分别配对,消息不串机。
|
||
7. 跨站Origin不能兑换配对码或派发任务。
|
||
|
||
本地自动化用真实HTTP/WebSocket与模拟平台/模型检验链路;真实ECS H5页面更新后的配对与对话,仍需按上述步骤执行验收。
|
||
|
||
本轮回归结果:48项通过、1项真实PostgreSQL用例因本地环境缺失跳过。新增9项包含H5会话与原生HTTP组合链路,覆盖一次配对码、并发消费、跨站拒绝、两账号隔离、去重、退出与过期、绑定变更失效。
|