Import ECS deployed relay source and historical patches (2026-10-27)
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
# 田泽远测试清单
|
||||
|
||||
每次保留:日期、操作者、组件版本、ECS架构/页大小、设备host_id、测试turn_id、预期、实际、通过/失败/未执行。日志不保留code/token/应用密钥或业务文档正文。
|
||||
|
||||
## 第一组:服务启动
|
||||
|
||||
1. `docker compose ps`显示基础组件与B1/B2正常;`verify_deployment.sh`通过。
|
||||
2. 只从业务网络访问443;Redis、PostgreSQL及18081不应从公网可达。
|
||||
3. 公网 `/admin/devices`与`/internal/events`返回404;内部管理请求缺少凭据返回401。
|
||||
4. TLS链可信且域名匹配;不能用关闭校验代替通过。
|
||||
|
||||
## 第二组:两人两机
|
||||
|
||||
| 用例 | 动作 | 通过标准 |
|
||||
|---|---|---|
|
||||
| A-01 | 各自生成设备私钥、登记、绑定不同账号 | host_id不同、owner不同;私钥不上传 |
|
||||
| A-02 | A发送 `/主机名`,B发送同样命令 | 各自得到本机名,设备journal只出现自己的任务ID |
|
||||
| A-03 | 分别 `/回显 A唯一标记`、`/回显 B唯一标记` | 回复不串人 |
|
||||
| A-04 | A读取自己的测试目录UTF-8文本 | 内容正确;路径和大小限制生效 |
|
||||
| A-05 | A尝试 `../`或绝对路径越出测试目录 | 明确拒绝;不能读到目录外内容 |
|
||||
| A-06 | 相同turn_id发送两次 | 第二次duplicate,不执行第二次 |
|
||||
| A-07 | 停止A桥接端,保留B在线 | A提示离线,B仍可用;不误投 |
|
||||
| A-08 | 恢复A网络 | 自动重连后新请求成功 |
|
||||
| A-09 | 重启B1后重发已完成turn_id | 持久去重仍生效 |
|
||||
| A-10 | 管理员吊销A | A断连、不能重连、后续请求拒绝;B不受影响 |
|
||||
|
||||
## 第三组:平台事件
|
||||
|
||||
配置真实平台后执行:私聊绑定→主机名→回显→解绑。确认机器人回复到原消息。
|
||||
|
||||
- 群聊消息不派发到PC。
|
||||
- 错误应用ID、Token或签名不执行;过期签名拒绝。
|
||||
- 同一平台message_id重投只执行一次。
|
||||
- websocket/平台重连后不使用公共云错误域名。
|
||||
- 记录平台实际限流码与阈值,不能套用微信机器人的50条/分钟限制。
|
||||
- 断平台网络后检查失败状态和恢复;“HTTP200已接收”不代表PC已经执行。
|
||||
|
||||
## 第四组:OAuth与代理
|
||||
|
||||
- start返回随机state与独立claim_secret;URL中无claim_secret。
|
||||
- unknown state回调拒绝;相同state的并发回调只换一次。
|
||||
- **先错claim_secret再对claim_secret**:错的404,正确的仍能领取;再次领取404。
|
||||
- 600秒过期、限流429、内存容量503。
|
||||
- 令牌有效期采用响应原值;日志和数据库不含token/code。
|
||||
- 并发刷新旧refresh_token只有一个上游尝试;失败后重新授权,不能循环重试旧token。
|
||||
- 如开启数据代理:本人能读的资源可读;另一个用户对明确未共享资源被拒。拒绝访问token接口、任意外部URL及路径穿越。
|
||||
|
||||
## 第五组:H5与后续集成
|
||||
|
||||
当前可验:入口页适配、OAuth授权、本人设备查询、离线提示、静态目标域名、无令牌URL。
|
||||
|
||||
**本版不能直接验收通过**:PC网页TLS透传、设备SSO、真实1.065Agent接口、附件端到端、安卓/iOS/鸿蒙海能Work内完整对话。这些项目需要客户端与网络环境集成,不能将入口页面可打开记录成通过。
|
||||
|
||||
## 发布门槛
|
||||
|
||||
本版可用于受控开发联调;不能直接宣告领导P0九关全关。还需实际完成Windows私钥保护、读取权限模型、终端准入、证书生命周期、应急停服及目标环境测试。领导允许调整方案,不等于这些验收证据已经存在。
|
||||
@@ -0,0 +1,34 @@
|
||||
# 相对领导方案的调整
|
||||
|
||||
本次保留目标:一个海能Work机器人按人路由到本人的PC,中心不承担AI推理,B2不解密正文,PC离线不排队,逐步增加网页/H5入口。
|
||||
|
||||
| 原方案/材料 | 本次处理 | 原因与影响 |
|
||||
|---|---|---|
|
||||
| 先部署六台虚机 | 当前单机独立容器,主备后置 | 按田泽远最新要求先跑通链路;不再启动同机重复主备冒充高可用 |
|
||||
| P0使用六台、汇总12C/24G/240G | 不将错误汇总固化到代码 | 原逐台表实为14C/24G/260G;联调暂以4C8G参考起步,容量另测 |
|
||||
| B1/B2职责分离 | 保留两个独立进程与网络接口 | 拆机不需要重写协议;数据库与总线均可改为远程地址 |
|
||||
| 注册表保存公钥/后改为指纹 | B1持久保存证书与指纹,握手时独立核验证书和签名 | 不信任路由器任意替换的在线目录;B2被改目录时应拒绝而非静默错投 |
|
||||
| 注册token由本机UI签发并换密钥 | PC本机生成私钥、公钥申请由离线CA签发、管理员登记证书 | 明确可信签发源;持有本地UI不能自行让中心信任任意设备。当前为人工签发,未满足50台自动签发门槛 |
|
||||
| TLS到PC、A不持TLS私钥 | 当前A为HTTPS/WSS反代,持入口TLS私钥;另做B1↔PC应用层加密 | 便于单机部署标准代理。A可见握手证书与密文流量,但不能解密指令正文;不声称已实现浏览器到PC的TLS透传 |
|
||||
| turn_id在PC收到消息后生成 | 平台message_id派生稳定turn_id,B1与PC执行前均持久去重 | 防止平台重复投递时每次生成新ID导致重复执行 |
|
||||
| 所有流程不落盘 | 仅正文/token不落盘,身份绑定、吊销、去重与审计元数据持久化 | 重启不能清除绑定、吊销或已执行请求记录 |
|
||||
| token永不落盘,却要求临时文件rename | B1待领token仅在内存;刷新结果直接返回,客户端自行安全保存 | 消除中继落盘矛盾;本版桥接端不保存平台user/refresh token |
|
||||
| user token按7200秒处理 | 使用平台实际返回有效期 | 兼容材料提到的6900/7200差异 |
|
||||
| 错误claim示例有waiting/404两种 | 对错误密钥统一404,不消费;正确密钥待完成返回202 | 避免状态探测与破坏别人的待领结果 |
|
||||
| H5识别用户后302即完成入口 | H5查本人绑定且提示设备仍需独立登录,不携带user token到设备URL | 找到域名不等于获得设备访问权;缺少PC登录协议时不做假免登 |
|
||||
| tenant权限全空 | 机器人消息权限与用户数据权限分开核对 | 机器人需要平台允许的应用消息权限;用户文件代理仍使用本人user token |
|
||||
| 任意自然语言交给SYSTEM Agent | 默认普通用户、三项只读诊断;可显式接入固定回环Agent适配器 | 没有1.065真实本机接口,不能猜测接口后开放任意执行;Agent侧权限仍须实际实现 |
|
||||
| 5分钟批量吊销并停服 | 实现吊销、断连、阻止重连和拒绝派发 | 不冒充已停止Windows海诺服务;操作系统停服需客户端受信管理接口 |
|
||||
| 50人/1000人/10万人已给规格 | 本版不宣称容量与高可用达标 | 未做目标环境压测、故障域演练与生产验收 |
|
||||
| Redis7.4镜像 | 改为官方Redis8.2,选择AGPLv3开源许可 | 满足用户要求的官方开源;保留协议接口,目标环境仍需运行验收 |
|
||||
| 需要联网拉基础镜像与pip依赖 | 增加官方ARM64镜像、离线wheelhouse、禁联网构建及禁止拉取的Compose配置 | 可在预装Docker/Compose的新服务器上离线安装,不再依赖镜像仓库连通性 |
|
||||
|
||||
## 本版仍需后续交付的功能
|
||||
|
||||
- 1.065/后续海诺客户端的真实协议适配或本机只读Agent接口实现。
|
||||
- 浏览器到PC的TLS透传隧道、设备网页身份认证、文件上传下载。
|
||||
- 私有化海能Work JSAPI免登与移动WebView实际验证。
|
||||
- Windows DPAPI/TPM不可导出私钥、设备证书自动续期、根/连接器密钥轮换。
|
||||
- B1主备、入口VIP、数据库灾备、监控告警与实际容量验证。
|
||||
|
||||
这些项目没有通过修改文档被标记成“已完成”。领导文档的冻结与审批记录作为历史背景保存;本次实现差异在这里独立登记,不篡改原始文件。
|
||||
@@ -0,0 +1,211 @@
|
||||
# Linux ARM64单机部署操作手册
|
||||
|
||||
## 1. 环境要求和目录
|
||||
|
||||
- Linux `aarch64/arm64`,推荐4核8GB、40GB可用盘起步做两人两机联调;不是50人容量保证。
|
||||
- Docker Engine及Compose v2;能拉取镜像、访问Python依赖源。使用原生ARM64镜像,不强制amd64模拟。
|
||||
- 默认容器基础是Debian bookworm/glibc。已下载核验Python3.12 ARM64 wheels;麒麟等宿主机仍须实际运行验证,尤其64KiB页内核。
|
||||
- 安全组只开放业务需要的443;SSH限制管理来源。18081仅绑定服务器127.0.0.1,不开放到公网。
|
||||
- PC能够出站访问ECS的443;平台事件源或ECS到平台的网络按所选接入方式打通。
|
||||
|
||||
将源码包解压到 `/opt/hainuo-relay`。以下命令均在该目录执行。
|
||||
|
||||
```bash
|
||||
uname -m
|
||||
getconf PAGESIZE
|
||||
docker version
|
||||
docker compose version
|
||||
```
|
||||
|
||||
## 2. 初始化
|
||||
|
||||
```bash
|
||||
bash scripts/bootstrap.sh relay.company.example
|
||||
```
|
||||
|
||||
替换域名为你们实际提供的入口。脚本构建镜像并生成:
|
||||
|
||||
- `.env`:随机管理员凭据、内部调用凭据、Redis和PostgreSQL密码;不会回显。
|
||||
- `runtime/connector/connector.key`:B1签名私钥,只挂载给B1。
|
||||
- `runtime/trust/ca.pem`、`connector.pub`:设备CA与连接器信任公钥。
|
||||
- `runtime/tls/server.pem`、`server.key`:30天测试自签TLS证书。
|
||||
- `operator/ca.key`:设备CA私钥,仅供签发工作站使用,不挂载容器。初始化后移至离线签发工作站,并保留该工作站需要的ca.pem和connector.pub;不要放在公网业务目录或普通备份中。
|
||||
|
||||
初始化拒绝覆盖已有文件和密钥;失败后不要直接再次初始化覆盖半成品,先检查已生成内容。
|
||||
|
||||
配置前建议 `chmod 600 .env`。不要把 `.env` 或CA私钥发群聊。
|
||||
|
||||
## 3. TLS和域名
|
||||
|
||||
将入口DNS指向ECS实际可达地址,使用公司认可的服务器证书替换:
|
||||
|
||||
```text
|
||||
runtime/tls/server.pem # 服务器证书及中间链
|
||||
runtime/tls/server.key # 对应私钥
|
||||
```
|
||||
|
||||
测试自签证书时,必须在PC上显式信任该测试证书或通过CLI的 `--tls-ca server.pem` 指定;不要禁用证书校验。
|
||||
|
||||
设备CA是设备身份用途,与浏览器HTTPS信任不是同一件事。不要以“PC设备证书已签发”代替“手机信任网页证书”。
|
||||
|
||||
## 4. 启动与检查
|
||||
|
||||
```bash
|
||||
bash scripts/start.sh
|
||||
bash scripts/verify_deployment.sh
|
||||
docker compose ps
|
||||
```
|
||||
|
||||
默认启动五个容器:edge、connector、router、postgres、redis。官方SDK长连接作为可选第六个容器。
|
||||
|
||||
```bash
|
||||
# 不显示密钥,直接在B1容器内查看设备元数据。
|
||||
docker compose exec connector python -m relay.cli status --url http://127.0.0.1:8000
|
||||
```
|
||||
|
||||
`/health`证明进程活着;`/ready`还检查依赖和回复订阅线程。二者都不代表海能Work联调通过。
|
||||
|
||||
本机环境没有Docker,交付前只完成Compose结构检查与shell语法检查;目标ECS必须实际执行上面步骤。PostgreSQL适配器的真实验证命令:
|
||||
|
||||
```bash
|
||||
docker compose -f compose.yaml -f compose.acceptance.yaml run --rm acceptance
|
||||
```
|
||||
|
||||
该用例只在数据库中新建随机 `hn_test_*` schema,结束时删除该测试schema,不操作已有业务表。
|
||||
|
||||
## 5. 第一次不接平台,先接两台PC
|
||||
|
||||
PC安装Python3.12及本项目依赖,执行后续命令。每台PC必须生成自己的设备目录,禁止复制别人设备的私钥。
|
||||
|
||||
### 5.1 PC生成公钥申请
|
||||
|
||||
```powershell
|
||||
python -m relay.cli device-request --directory D:\HainuoRelayDevice
|
||||
```
|
||||
|
||||
得到 `device.key` 和 `request.json`。只将request.json交给签发工作站。
|
||||
|
||||
### 5.2 签发工作站签证书
|
||||
|
||||
签发工作站的项目目录需要保存 `operator/ca.key`、`runtime/trust/ca.pem`、`runtime/trust/connector.pub`。
|
||||
|
||||
```bash
|
||||
python -m relay.cli issue-device --root . --request request.json --output issued-device-a
|
||||
```
|
||||
|
||||
将输出的 `device.pem`、`ca.pem`、`connector.pub`、`device.json`交回原PC设备目录。设备私钥不经过服务器。
|
||||
|
||||
### 5.3 ECS登记证书
|
||||
|
||||
将 `registration.json`临时放到ECS,例如 `runtime/connector/registration-a.json`,然后:
|
||||
|
||||
```bash
|
||||
docker compose exec connector python -m relay.cli register \
|
||||
--registration /data/registration-a.json --url http://127.0.0.1:8000
|
||||
```
|
||||
|
||||
该文件只有证书和设备ID,没有私钥。登记成功后可移出服务数据目录保管。
|
||||
|
||||
### 5.4 生成模拟账号绑定码
|
||||
|
||||
```bash
|
||||
docker compose exec connector python -m relay.cli binding-code \
|
||||
--owner ou_test_a --url http://127.0.0.1:8000
|
||||
```
|
||||
|
||||
绑定码在受控管理终端显示,五分钟有效,一次使用。这是development/test专用;production环境不开放。
|
||||
|
||||
PC执行并在隐藏输入框输入绑定码:
|
||||
|
||||
```powershell
|
||||
python -m relay.cli bind --directory D:\HainuoRelayDevice --url https://relay.company.example
|
||||
# 若仍使用测试自签证书,上面命令额外加 --tls-ca D:\certs\server.pem。
|
||||
```
|
||||
|
||||
### 5.5 启动桥接端
|
||||
|
||||
```powershell
|
||||
python -m relay.cli device --directory D:\HainuoRelayDevice --url wss://relay.company.example/device/ws --test-root D:\HainuoRelayTestFiles
|
||||
```
|
||||
|
||||
测试目录由你自己创建,先放一个无敏感内容的UTF-8文本文件。桥接端以当前普通用户运行;不要使用SYSTEM或管理员账号扩展文件权限。
|
||||
|
||||
另一台PC重复上述步骤,绑定 `ou_test_b`。
|
||||
|
||||
### 5.6 从ECS发起测试
|
||||
|
||||
```bash
|
||||
docker compose exec connector python -m relay.cli dispatch \
|
||||
--owner ou_test_a --text '/回显 A机链路通过' --turn-id test-a-001 --url http://127.0.0.1:8000
|
||||
docker compose exec connector python -m relay.cli dispatch \
|
||||
--owner ou_test_b --text '/主机名' --turn-id test-b-001 --url http://127.0.0.1:8000
|
||||
```
|
||||
|
||||
重复同一turn-id应返回duplicate;断开PC应返回offline;超时返回unknown,表示结果不确定,不自动重新执行。
|
||||
|
||||
## 6. 接海能Work
|
||||
|
||||
编辑 `.env`:
|
||||
|
||||
```dotenv
|
||||
HN_FEISHU_ENABLED=true
|
||||
HN_FEISHU_API_BASE=https://实际私有化开放平台域名
|
||||
HN_FEISHU_AUTHORIZE_URL=https://实际授权页完整路径
|
||||
HN_FEISHU_APP_ID=实际应用ID
|
||||
HN_FEISHU_APP_SECRET=单独渠道取得的密钥
|
||||
HN_FEISHU_ENCRYPT_KEY=实际事件加密密钥
|
||||
HN_FEISHU_VERIFICATION_TOKEN=实际校验Token
|
||||
```
|
||||
|
||||
本版默认适配材料中的legacy OIDC接口:`auth/v3/app_access_token/internal`、`authen/v1/oidc/access_token`、`authen/v1/oidc/refresh_access_token`、`authen/v1/user_info`。机器人回复使用单独缓存的tenant_access_token,不把OAuth的app_access_token混用于消息API。实际私有化版本若不同,在 `relay/platform.py`中集中适配;不要直接改为公有云地址试错。
|
||||
|
||||
平台侧:
|
||||
|
||||
1. 创建/选择机器人应用,开通私聊消息接收和回复所需权限,发布版本并限制试点可见范围。
|
||||
2. 用户文档授权权限与机器人权限分开核对;不能把“tenant权限全空”直接套到需要应用身份回复消息的机器人。
|
||||
3. OAuth重定向地址配置为 `https://入口域名/oauth/cb`。
|
||||
4. 在以下事件源中选择一个,不要同时启用后再依赖去重掩盖配置错误。
|
||||
|
||||
### 方式A:长连接(领导方案过渡态)
|
||||
|
||||
后台选择长连接,订阅 `im.message.receive_v1`:
|
||||
|
||||
```bash
|
||||
docker compose up -d --force-recreate connector
|
||||
docker compose --profile longconn up -d longconn
|
||||
```
|
||||
|
||||
使用官方lark-oapi SDK支持的 `domain`参数,明确指向私有化平台;SDK日志关闭以防打印连接URL或正文。单Redis租约防止重复消费者。SDK实际建立连接、私有化平台消息格式和频控必须实测。
|
||||
|
||||
### 方式B:webhook
|
||||
|
||||
配置回调为 `https://入口域名/feishu/event`,要求请求签名、时间戳、校验Token及配置的加密参数一致。支持加密事件;校验失败拒绝,不开放绕过开关。
|
||||
|
||||
用户分别私聊机器人 `/绑定`,在自己PC输入绑定码,再发送 `/主机名`、`/回显 内容`。
|
||||
|
||||
## 7. 本地海诺Agent对接
|
||||
|
||||
默认桥接端不猜测1.065接口。若本地海诺适配层实现了[协议](PROTOCOL.md)中的只读HTTP接口,启动时增加:
|
||||
|
||||
```powershell
|
||||
python -m relay.cli device --directory D:\HainuoRelayDevice --url wss://relay.company.example/device/ws --agent-url http://127.0.0.1:8765/relay/read-only
|
||||
```
|
||||
|
||||
此时 `/助手 整理测试文件`才调用固定回环地址。Agent侧必须真实限制工具与文件权限;`read_only:true`字段本身不能阻止一个拥有写权限的Agent写文件。
|
||||
|
||||
## 8. 维护、备份、停用
|
||||
|
||||
```bash
|
||||
docker compose logs --tail 100 connector router
|
||||
# 不开access log/debug,不采集请求体、令牌或SDK明文事件。
|
||||
docker compose exec connector python -m relay.cli revoke --host-id 实际32位host_id --url http://127.0.0.1:8000
|
||||
docker compose exec -T postgres pg_dump -U hainuo -d hainuo -Fc > metadata-backup.dump
|
||||
# 恢复演练使用独立测试数据库,核对设备数、绑定与吊销状态;不要覆盖现有数据库。
|
||||
docker compose restart connector
|
||||
```
|
||||
|
||||
Redis不落盘;重启后在线状态重建,B1从持久库恢复准入/吊销数据。若需要手动同步,运行 `reconcile`子命令。
|
||||
|
||||
B1密钥、数据库和CA分别制定备份策略;不能把整个runtime打包当普通日志发出。不能只用 `docker compose down`冒充备份;不要执行 `down -v`删除元数据卷。
|
||||
|
||||
切换 `HN_ENVIRONMENT=production`会禁用模拟绑定码和模拟派发API。切换前必须替换测试TLS证书、配置真实平台并完成两人两机验收;该开关不代表项目自动满足P0九关。
|
||||
@@ -0,0 +1,77 @@
|
||||
# 海能Work私有化平台接入 · 长连接增量
|
||||
|
||||
## 已确认与未确认
|
||||
|
||||
用户提供App ID及App Secret,Secret未写入本项目源码或交付包。本文App ID可公开配置,Secret必须在ECS交互输入,不作为命令参数传入。
|
||||
|
||||
2026-10-26从本机**未携带任何密钥**验证:
|
||||
|
||||
| 请求 | 结果 | 判断 |
|
||||
|---|---|---|
|
||||
| GET https://open.w.cnooc.com.cn/app/ | HTTP200、HTML | 开发者后台页面,不是API根路径 |
|
||||
| POST https://open.w.cnooc.com.cn/open-apis/auth/v3/app_access_token/internal,空JSON | HTTP200、JSON code10003 | API路由存在;未验证凭据 |
|
||||
| POST https://open.w.cnooc.com.cn/open-apis/auth/v3/tenant_access_token/internal,空JSON | HTTP200、JSON code10003 | API路由存在;未验证凭据 |
|
||||
|
||||
所以API基址应为 `https://open.w.cnooc.com.cn`,不加 `/app/`。长连接配置的WSS目标由平台接口返回,不猜测地址或固定使用公有云。
|
||||
|
||||
## ECS更新与配置
|
||||
|
||||
将 `hainuo-relay-feishu-update-20261026.tar.gz`上传到/home/cnooc:
|
||||
|
||||
```bash
|
||||
tar -xzf /home/cnooc/hainuo-relay-feishu-update-20261026.tar.gz \
|
||||
-C /home/cnooc/hainuo-offline-arm64
|
||||
cd /home/cnooc/hainuo-offline-arm64/hainuo-relay
|
||||
sudo bash scripts/start-feishu-longconn.sh
|
||||
```
|
||||
|
||||
脚本离线构建已含官方SDK的服务镜像,不下载新依赖。提示 `App Secret (hidden input):`时,在服务器终端输入实际密钥,不回显,也不发到聊天。
|
||||
|
||||
配置工具依次验证app token、tenant token和 `/callback/ws/endpoint`(只获取连接配置,不发送平台消息);成功后才备份并原子写入.env。任何一步失败不会提交新配置。输出只显示成功状态、业务错误码或WSS主机名,不显示密钥、令牌、完整WSS URL或上游响应正文。
|
||||
|
||||
长连接不需要Webhook的Encrypt Key/Verification Token,已修正原配置校验;Webhook缺少鉴权参数时继续拒绝请求。OAuth保持关闭,避免在未核验IP回调白名单前把H5授权当成可用;当前PC配对H5不受影响。
|
||||
|
||||
脚本保留旧镜像标签、已有数据库、设备证书、绑定和H5,重建B1并启动独立longconn。继续使用compose.work.yaml及已有edge/H5覆盖文件。PC无需重注册。
|
||||
|
||||
检查:
|
||||
|
||||
```bash
|
||||
sudo docker compose logs --tail 30 longconn
|
||||
sudo docker compose ps connector longconn
|
||||
```
|
||||
|
||||
`platform_connected`证明SDK建立了平台连接;`platform_event_accepted`证明事件已转交B1,不等同已执行或平台回复成功。
|
||||
|
||||
## 平台后台仍必须配置
|
||||
|
||||
在https://open.w.cnooc.com.cn/app/选择对应应用:
|
||||
|
||||
1. 启用机器人,事件订阅选择长连接;不要同时配置另一个公网Webhook消费同一流。
|
||||
2. 订阅 `im.message.receive_v1`。
|
||||
3. 开通该私有化版本要求的私聊接收、机器人消息回复权限。精确scope以平台实际权限列表为准,不猜公有云名称。
|
||||
4. 发布应用,先只对两名测试人员可见。
|
||||
5. 用户在海能Work私聊机器人,发送 `/回显 海能Work消息已通`。此时尚未绑定真实open_id,若未绑定诊断会提示设备不可用;先发送 `/绑定`验证能收到绑定码。
|
||||
|
||||
当前机器人接入阶段只开放 /绑定、/解绑、/主机名、/回显。尚未将本机Profile全工具权限开放给IM,符合领导方案先做身份与归属验证的顺序;H5现有受控工具试验不因此关闭。
|
||||
|
||||
## 测试身份迁移到真实open_id
|
||||
|
||||
**先确认机器人能收消息并回复绑定码,再做迁移;不要在平台未通时先解绑。**
|
||||
|
||||
1. 停止PC桥接端,完成当前所有任务。
|
||||
2. ECS执行管理员解绑,只移除模拟owner,不吊销设备证书:
|
||||
|
||||
```bash
|
||||
sudo docker compose exec -T connector python -m relay.cli unbind \
|
||||
--host-id 79cb2127dd554a1fb592101945df5230 --url http://127.0.0.1:8000
|
||||
```
|
||||
|
||||
旧H5会话与配对码失效,模拟账号不再能调用。设备私钥、host_id和证书保留。
|
||||
|
||||
3. 本人在海能Work私聊 `/绑定`,取得新的5分钟绑定码。
|
||||
4. Windows运行原 `relay.cli bind --directory D:\HainuoRelayDevice --url https://10.77.76.13 --tls-ca D:\HainuoRelayDevice\server.pem`,输入新码。
|
||||
5. 重启使用hainuo-config的PC桥接端,海能Work发 `/主机名`,应返回LAPTOP-4N7G74MO。
|
||||
6. ECS status应显示真实平台open_id,而非ou_test_tianzeyuan。两人两机各自重复,验证不串机。
|
||||
7. 需要继续H5时,在PC重新生成网页配对码,不复用旧会话。
|
||||
|
||||
现有Secret曾出现在聊天中,正式试点前应在平台重置,使用本工具在ECS隐藏输入新值;不把新Secret发到聊天或打进镜像。
|
||||
@@ -0,0 +1,78 @@
|
||||
# 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组合链路,覆盖一次配对码、并发消费、跨站拒绝、两账号隔离、去重、退出与过期、绑定变更失效。
|
||||
@@ -0,0 +1,53 @@
|
||||
# 官方开源镜像与完全离线安装
|
||||
|
||||
本次补充的是Linux ARM64镜像,不是AMD64镜像。独立离线包目录包含 `images/`、源码项目、ARM64 wheelhouse、SHA256校验和及安装脚本。
|
||||
|
||||
## 镜像来源与许可证
|
||||
|
||||
| 镜像标签 | 官方发布来源 | 核心项目许可证 |
|
||||
|---|---|---|
|
||||
| python:3.12-slim-bookworm | Docker Official Images / Python | PSF License及其许可历史 |
|
||||
| postgres:17-alpine | Docker Official Images / PostgreSQL | PostgreSQL License |
|
||||
| redis:8.2-alpine | Docker Official Images / Redis | 本次选择AGPLv3,而非RSAL/SSPL |
|
||||
| caddy:2-alpine | Docker Official Images / Caddy | Apache-2.0 |
|
||||
|
||||
Docker Hub直连在当前网络超时,本次从Docker Official Images在Amazon ECR Public的公共发布仓库 `public.ecr.aws/docker/library/*`获取。不是第三方重新构建的同名镜像。保留原始镜像config和layer;导出Docker-load格式时逐项验证registry SHA256及解压rootfs diff_id。
|
||||
|
||||
`IMAGE_MANIFEST.json`记录index、ARM64 manifest、config与layers摘要及实际下载来源。`VERIFICATION.json`记录校验结果和镜像内版本环境变量。标签可能继续更新,本包具体内容以这些摘要为准;离线安装使用本包内容并禁止重新拉取。
|
||||
|
||||
Redis原7.4配置采用RSAL/SSPL,不能笼统称为OSI开源。因此调整到Redis8.2并选择其AGPLv3许可路径。应用使用的AUTH、GETDEL、租约、Pub/Sub等协议在8.2仍提供;本地自动化测试使用FakeRedis,真实Redis8.2运行仍须在目标Docker环境验收。
|
||||
|
||||
官方许可来源:
|
||||
|
||||
- https://redis.io/legal/licenses/
|
||||
- https://www.postgresql.org/about/licence/
|
||||
- https://docs.python.org/3/license.html
|
||||
- https://github.com/caddyserver/caddy/blob/master/LICENSE
|
||||
- https://gallery.ecr.aws/docker/library/python
|
||||
|
||||
基础发行版和各依赖另有许可证;本表不替代完整SBOM、漏洞扫描或企业开源准入。Redis官方源码和许可链接随离线包提供,使用与再分发遵守所选许可。
|
||||
|
||||
## 上传后的操作
|
||||
|
||||
服务器已有Docker Engine和Compose v2时:
|
||||
|
||||
```bash
|
||||
tar -xzf hainuo-relay-offline-arm64-0.1.0.tar.gz
|
||||
cd hainuo-offline-arm64
|
||||
bash install.sh relay.your-company-domain
|
||||
```
|
||||
|
||||
安装脚本会校验文件、导入四个官方镜像,使用已导入Python基础镜像与本地41项wheel构建服务,然后初始化和启动。构建使用 `--network none --pull=false`,启动使用 `--no-build --pull never`。
|
||||
|
||||
海诺服务镜像是本项目源码构建的 `hainuo-relay:0.1.0`,不是冒充某个官方已有服务镜像。本次不包含Docker Engine/Compose宿主软件、不包含业务数据,也不消除配置真实域名、TLS、海能Work凭据及客户端适配的必要性。
|
||||
|
||||
配置修改后离线重启:
|
||||
|
||||
```bash
|
||||
cd hainuo-relay
|
||||
docker compose -f compose.yaml -f compose.offline.yaml up -d --no-build --pull never
|
||||
# 若选择官方SDK长连接,在配置平台信息后:
|
||||
docker compose -f compose.yaml -f compose.offline.yaml --profile longconn up -d --no-build --pull never
|
||||
```
|
||||
|
||||
现有普通源码ZIP仍可用于联网构建;完全离线部署请使用新增的整包,而非只传旧源码ZIP。
|
||||
@@ -0,0 +1,117 @@
|
||||
# 中继协议 v1
|
||||
|
||||
## 服务接口
|
||||
|
||||
| 端点 | 身份/约束 | 用途 |
|
||||
|---|---|---|
|
||||
| GET /health | 无 | 存活 |
|
||||
| GET /ready | 内部网络 | 依赖就绪 |
|
||||
| POST /admin/devices | X-Admin-Secret | 登记CA签发的设备证书 |
|
||||
| GET /admin/devices | 同上 | 设备、绑定和在线状态 |
|
||||
| POST /admin/devices/{host}/revoke | 同上 | 持久吊销并断连 |
|
||||
| POST /admin/reconcile | 同上 | 从持久库恢复路由准入数据 |
|
||||
| POST /admin/test/binding-code | 同上,非production | 生成模拟账号绑定码 |
|
||||
| POST /admin/test/dispatch | 同上,非production | 同步等待模拟指令结果 |
|
||||
| POST /device/bind | 设备签名+一次性绑定码 | 本机完成绑定 |
|
||||
| WS /device/ws | B2:CA证书+挑战签名 | PC出站隧道 |
|
||||
| POST /feishu/event | 平台签名、Token、时窗 | webhook接入 |
|
||||
| POST /internal/events | X-Internal-Secret | 官方SDK进程转入事件 |
|
||||
| POST /oauth/start | 限流、容量限制 | 创建授权事务 |
|
||||
| GET /oauth/cb | 服务端state | 收码后立即换token |
|
||||
| GET /oauth/claim | state+X-OAuth-Claim-Secret | 一次领取token |
|
||||
| GET /oauth/pending | 同上 | 查询状态,无token |
|
||||
| POST /oauth/refresh | refresh_token,防并发重复 | 刷新、返回新token |
|
||||
| GET /proxy | 本人Bearer+X-Relay-Target | 默认关闭的只读数据代理 |
|
||||
| GET /api/whoami | 本人Bearer,经平台验证 | 查询本人设备URL |
|
||||
| GET /h5 | 无,页面内发起OAuth | 入口壳 |
|
||||
|
||||
管理接口和internal/events不通过公网反代。不要在nginx/Caddy上额外放开这些路径。
|
||||
|
||||
## 设备注册与绑定
|
||||
|
||||
1. PC生成Ed25519私钥和随机32位hex host_id,只发送公钥申请。
|
||||
2. 离线签发工作站签发带 `clientAuth`、SAN URI `urn:hainuo:host:{host_id}`的设备证书。
|
||||
3. 管理员将证书登记到B1。B1持久保存证书指纹,并把准入指纹同步到Redis。
|
||||
4. 本人私聊机器人 `/绑定`。绑定码具有96位随机熵、TTL300秒;Redis只保存码的SHA256索引和owner。
|
||||
5. PC向 `/device/bind`发送:
|
||||
|
||||
```json
|
||||
{"host_id":"32位hex", "proof":{"host_id":"同一host_id","code":"绑定码","ts":1793000000,"signature":"base64url签名"}}
|
||||
```
|
||||
|
||||
签名覆盖去掉signature后的规范JSON。B1先校验证书、签名、时间和注册状态,再原子消费绑定码,持久绑定owner↔host。返回连接器签名的绑定回执;PC使用预置信任公钥验证回执并保存owner。
|
||||
|
||||
本版一人一台、一台一人;解绑后必须在PC重新绑定。本版不提供远端任意指定owner的公开接口。
|
||||
|
||||
## 隧道握手
|
||||
|
||||
1. B2发送 `{type:"challenge",challenge:随机值}`。
|
||||
2. PC每次连接生成临时X25519密钥和session_id,提交证书与签名proof:
|
||||
|
||||
```json
|
||||
{"host_id":"...","cert":"PEM证书","proof":{"host_id":"...","session_id":"...","challenge":"...","kx":"X25519公钥base64url","ts":1793000000,"signature":"..."}}
|
||||
```
|
||||
|
||||
3. B2验证CA、证书有效期、用途、host_id、挑战、时间、注册指纹和吊销状态。通过后设置30秒在线租约,8秒续约;第二连接被拒绝。
|
||||
4. B1发送前独立核对持久库指纹、设备证书、握手签名,不能信任B2下发一个新公钥。
|
||||
|
||||
## 加密信封
|
||||
|
||||
```json
|
||||
{"v":1,"host_id":"...","session_id":"...","ts":1793000000,"nonce":"12随机字节base64url","ephemeral":"消息发送方临时X25519公钥","ciphertext":"AESGCM密文和tag","signature":"Ed25519签名"}
|
||||
```
|
||||
|
||||
- JSON规范化:UTF-8、键排序、无多余空白、非ASCII不转义。
|
||||
- ECDH:每消息临时发送密钥 ↔ 当前连接的临时接收密钥。
|
||||
- HKDF-SHA256:32字节,salt=session_id UTF-8,info=`hainuo-relay-envelope-v1`。
|
||||
- AEAD:AES-256-GCM;AAD是除ciphertext和signature以外的信封字段。
|
||||
- 签名:覆盖除signature外所有字段;验证后再解密。
|
||||
- 接收方验证host、session和90秒时间窗。真正执行去重使用稳定turn_id,PC侧持久记录,不依赖nonce缓存。
|
||||
- B1每次请求生成独立临时回复密钥,公钥放在加密的请求体中;私钥只在等待结果期间持有。
|
||||
|
||||
长期Ed25519身份密钥不参与内容ECDH。已销毁临时密钥的历史流量不能仅凭长期签名私钥解密。本版未接受独立密码协议审计,不将该设计等同已通过企业密码评估。
|
||||
|
||||
请求明文只在B1与对应PC内:
|
||||
|
||||
```json
|
||||
{"type":"instruction","turn_id":"稳定请求ID","owner":"ou_xxx","text":"/主机名","read_only":true,"channel":"im","reply_key":"B1临时回复公钥"}
|
||||
```
|
||||
|
||||
PC必须再次核对owner;签名有效不代表可以执行任意系统操作。
|
||||
|
||||
回复:
|
||||
|
||||
```json
|
||||
{"type":"reply","turn_id":"同一ID","envelope":{"...":"加密信封"}}
|
||||
```
|
||||
|
||||
解密后为 `{type:"result",turn_id:"同一ID",result:"结果"}`。B2检查存在该host、session、turn的在途记录,B1再检查签名、加密和请求归属。PC不能指定其他聊天收件人。
|
||||
|
||||
## 去重和失败语义
|
||||
|
||||
- 平台事件以message_id派生稳定turn_id;消息重投不会重新生成随机执行ID。
|
||||
- B1在发布前写持久去重台账,PC执行前写本机journal。两端均采取“宁可状态未知,不自动重复执行”。
|
||||
- Redis使用Pub/Sub,不缓存正文,不离线排队。主机离线即返回offline。
|
||||
- 超时/重启丢失在途结果返回unknown或等待超时,不能当成未执行。重新生成新ID有可能再次执行,应由用户核查。
|
||||
- 同一ID重复提交只返回duplicate,不缓存/重放原结果正文。
|
||||
- B1后台处理失败写元数据状态,当前版本没有可靠消息发件箱;已执行但回平台失败时不会自动再次执行。
|
||||
|
||||
## 本地Agent适配接口(需客户端开发实现)
|
||||
|
||||
固定回环地址,例如 `POST http://127.0.0.1:8765/relay/read-only`:
|
||||
|
||||
```json
|
||||
{"text":"整理测试目录内的文档","open_id":"ou_xxx","turn_id":"...","channel":"im","read_only":true}
|
||||
```
|
||||
|
||||
成功返回HTTP200:`{"result":"助手结果"}`。桥接端只接受文本结果、限制大小,不跟随重定向。可通过桥接端环境变量 `HN_LOCAL_AGENT_TOKEN`提供本地Bearer凭据。
|
||||
|
||||
该接口不是从1.065中发现的真实接口,而是本次新增适配契约。Agent服务需要实现按turn_id去重、主体与文件权限校验、只读工具白名单;不能只把read_only字段拼进提示词。未提供适配接口时,诊断命令仍能正常工作。
|
||||
|
||||
## OAuth与代理
|
||||
|
||||
沿用原手册v1.2响应字段;使用平台实际返回的expires_in/expire,不写死7200。待取token只存在B1内存,600秒过期,领取即删除。错误claim_secret返回404且不消费;同一code并发回调只换一次。
|
||||
|
||||
刷新用refresh_token摘要作为分布式一次尝试标记,保留30天。网络故障可能导致平台已轮换但客户端未拿到结果,因此不重试旧token,要求重新授权。
|
||||
|
||||
代理固定走配置的平台域名,只支持明确白名单的GET接口;永不使用应用token代替用户token,不代理换token接口,不跟随重定向,不持久保存响应正文。token每次由平台user_info验证,本版不缓存token验证结果。
|
||||
@@ -0,0 +1,46 @@
|
||||
# 从单机迁移到六台
|
||||
|
||||
## 服务归属
|
||||
|
||||
| 主机 | 部署内容 | 关键配置 |
|
||||
|---|---|---|
|
||||
| A1 | 入口代理 | 指向B1活动节点与B2;入口TLS证书 |
|
||||
| A2 | 同上 | VIP/负载均衡、健康探测 |
|
||||
| B1-1 | connector+longconn(如使用) | 平台凭据、连接器私钥、PostgreSQL/Redis地址 |
|
||||
| B1-2 | connector备用+longconn备用 | 相同身份信任与公共数据库;按主备策略切换 |
|
||||
| B2-1 | router | 设备CA公钥、Redis地址;不分配平台密钥/管理员凭据 |
|
||||
| P1 | PostgreSQL+Redis+外部监控 | 仅允许相应服务网段访问;备份、权限、时钟 |
|
||||
|
||||
CA私钥留离线签发工作站,**不因拆六台而复制到P1**。
|
||||
|
||||
## 网络矩阵
|
||||
|
||||
| 来源 | 目标 | 端口/用途 |
|
||||
|---|---|---|
|
||||
| PC、平台webhook、H5 | A的VIP/域名 | TCP443 |
|
||||
| A | B1 | 本版服务HTTP8000;跨主机应经受信TLS/mTLS代理 |
|
||||
| A | B2 | 本版WS8000;跨主机应经受信TLS/mTLS代理 |
|
||||
| B1 | 私有化开放平台 | TCP443,含SDK长连接目的域名 |
|
||||
| B1、B2、longconn | Redis | TLS端口按实际Redis配置,禁止公网 |
|
||||
| B1 | PostgreSQL | TCP5432,跨主机启用TLS验证 |
|
||||
| 管理堡垒机 | B1管理入口 | 经SSH隧道/受控内网,不直接公网开放 |
|
||||
|
||||
不要把单机Docker桥接网络里的明文连接原样暴露到公网。修改Redis地址为`rediss://`及PostgreSQL连接的`sslmode=verify-full`等参数,并配置CA校验。Redis角色ACL细分与跨机mTLS不由现有Compose自动完成。
|
||||
|
||||
## 迁移步骤
|
||||
|
||||
1. 维护窗口暂停新任务,等待在途任务结束;向用户说明连接会短暂中断。
|
||||
2. 备份PostgreSQL,保存B1签名密钥和信任公钥的受控副本。保持设备CA、host_id、owner及签名身份不变。
|
||||
3. 将PostgreSQL/Redis迁至P1,恢复数据库并验证设备绑定、吊销和去重数据。Redis在线状态可重建,不迁移正文。
|
||||
4. 部署B2,更新网络地址;部署B1并等待ready;然后更新A的上游。
|
||||
5. 保留原域名与443,PC无需换host_id或重新配对。若入口域名改变,更新桥接端连接地址。
|
||||
6. 两人两机重新验收后,再部署A2和B1-2,实施VIP/主备与故障演练。
|
||||
|
||||
## 并非只开端口就自动高可用
|
||||
|
||||
- 协议和业务代码可复用,但主备切换、DNS/VIP、证书和数据库恢复属于实际迁移工作。
|
||||
- B1使用公共PostgreSQL,不能让两个实例各自写不同SQLite。SQLite只用于本地测试,不用于跨主机主备。
|
||||
- OAuth待领令牌和等待结果仅在某个B1内存;活动节点故障时事务会丢失,客户端重新授权,已执行任务不能盲目重发。
|
||||
- 官方SDK事件源有Redis租约防重复消费者;入口仍需把OAuth事务固定到活动B1。暂不提供跨B1内存状态复制。
|
||||
- B2可按设备在线租约分布到多个节点,Redis频道把数据送到持有该设备隧道的节点;同一设备只能建立一条有效连接。
|
||||
- 六台中的B2与P仍是单点,不承诺全系统无中断;若六台共用一台物理宿主机,也未隔离宿主机故障。
|
||||
@@ -0,0 +1,50 @@
|
||||
# 本次交付验证记录
|
||||
|
||||
日期:2026-10-26。执行环境:Windows x64、Python3.12.10;本机未提供Docker Engine或PostgreSQL服务。
|
||||
|
||||
## 自动化结果
|
||||
|
||||
执行 `python -m pytest -q --junitxml=docs/test-results.xml`:**26项通过、1项真实PostgreSQL用例因缺少环境跳过**。逐项耗时以同目录JUnit XML为准。
|
||||
|
||||
测试使用:真实本地HTTP端口、真实WebSocket连接、两台独立设备目录及独立密钥、真实签名/加密/解密、SQLite持久台账;Redis使用FakeRedis,海能Work使用平台桩及HTTP MockTransport。
|
||||
|
||||
覆盖:
|
||||
|
||||
- 两设备并发独立回传;重复turn_id拒绝;设备持久journal重启后仍拒绝重复。
|
||||
- 错误CA、错误host、信封篡改、错误临时解密密钥拒绝。
|
||||
- 替换B2在线目录中的设备证书时,B1独立指纹检查拒绝。
|
||||
- 离线回执、吊销断连和持久吊销;同一设备第二连接被拒。
|
||||
- 只读测试目录读取、越界拒绝、未知系统命令不执行。
|
||||
- 超时返回unknown、不重执行;回复订阅退出时ready失败。
|
||||
- OAuth错误密钥不销毁、正确领取一次、并发callback/claim、过期、容量、限流。
|
||||
- refresh_token并发只有一次上游尝试;响应有效期使用6900等平台原值。
|
||||
- 明文/加密webhook签名验证、过期拒绝、重复平台消息只执行一次、群聊忽略。
|
||||
- H5资源、CSP、本人设备URL、拒绝任意跳转目标。
|
||||
- 只读数据代理拒绝任意上游、鉴权接口、路径穿越。
|
||||
- 本地Agent适配契约、回环限制、拒绝重定向。
|
||||
- 平台接口使用配置的私有化域名、原消息回复;上游异常不回显敏感内容。
|
||||
- 请求校验错误不返回包含token的原始输入。
|
||||
|
||||
## 其他已执行检查
|
||||
|
||||
- Python源码compileall、H5 JavaScript语法、部署shell脚本语法通过。
|
||||
- Compose YAML可解析;数据库/Redis不发布端口,管理端口只绑定回环;公网只发布443。
|
||||
- 官方SDK `lark-oapi==1.5.3`确实支持 `ws.Client(domain=...)`,已在本地检查参数签名,未连接平台。
|
||||
- requirements.lock中的41项依赖全部成功解析并下载Linux ARM64/Python3.12兼容wheel;原生扩展包括cryptography、cffi、psycopg-binary、pydantic-core和websockets。
|
||||
- 本轮补充:四个官方镜像从Docker Official Images的ECR Public发布仓库下载成功,校验所有config、压缩blob、解压rootfs摘要及linux/arm64架构;提供Docker-load格式tar。没有实际Docker daemon导入/运行验证。
|
||||
|
||||
## 未执行 / 受环境限制
|
||||
|
||||
| 项目 | 当前状态 | 目标环境执行方式 |
|
||||
|---|---|---|
|
||||
| 真实PostgreSQL元数据用例 | 本地跳过 | Compose acceptance测试容器,或设置HN_TEST_DATABASE_URL |
|
||||
| Docker镜像构建与Compose启动 | 未执行,本机无Docker | ECS执行bootstrap/start/verify脚本 |
|
||||
| ARM64原生运行/64KiB内核 | 未执行;已核验依赖wheel可得 | ECS检查uname、PAGESIZE后实际启动 |
|
||||
| Docker Hub直连 | auth.docker.io连接超时;本轮已通过ECR Public官方发布仓库取得四个镜像 | 使用离线包,无需目标机联网拉镜像 |
|
||||
| Redis8.2真实服务和网络故障恢复 | 镜像已下载,运行未执行,测试用FakeRedis | ECS断线/恢复用例 |
|
||||
| 海能Work长连接、权限、频控、OAuth | 未执行 | 实际私有化应用联合测试 |
|
||||
| 1.065桥接、真实本机Agent | 未执行,协议尚未提供 | 按PROTOCOL.md接入后验收 |
|
||||
| H5到PC完整链路与文件回传 | 未实现完整链路 | 后续PC网页隧道与设备登录集成 |
|
||||
| 六台主备与容量 | 未执行 | 拆分说明与放量压测 |
|
||||
|
||||
Windows测试结果不能被表述为“ECS部署通过”或“海能Work业务验收通过”。原领导材料中的公网自测属于此前开发侧陈述,不是本次代码的执行证据。
|
||||
Reference in New Issue
Block a user