Files
ecs-relay-service/deployment-source/docs/H5_PAIR_CHAT.md
T

4.9 KiB
Raw Blame History

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,执行:

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执行:

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按钮。

粘贴配对码后点击连接。网页显示“你的电脑已在线”后,发送:

请计算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组合链路,覆盖一次配对码、并发消费、跨站拒绝、两账号隔离、去重、退出与过期、绑定变更失效。