3.9 KiB
生产与测试统一诊断工具安装（2026-10-08）
授权与规则
使用者明确批准：在既有测试机安装 tshark 并确保 tcpdump 具备；修改环境安装脚本，生产和测试均预装，不按环境跳过。安装不代表启用抓包，仍需显式 --debug/-D 和既有操作者权限；没有更改一般用户抓包权限、用户组或 sudo 规则。
本次仅在登记测试机执行安装，没有操作其他生产主机；没有真实外呼、AI 调用或现场抓包，没有更新业务制品或重启服务。
安装脚本
新增 deploys/cell/install-diagnostics.sh：root-only、无生产/测试切换或跳过参数，非交互使用系统 apt 安装 tcpdump/tshark。包索引、安装、版本检查和 SIP/RTP dissector 校验任何一步失败都明确退出，不降级。
- Go 部署包包含此 helper，由
deploys/install.sh完成既有包/平台/发布授权校验后无条件调用。 - 原生 Asterisk 包包含 helper 和独立 SHA-256；用户安装器完成原有平台/制品/不覆盖检查后，通过现有
sudo -n执行 helper，再改变用户安装目录。 - 没有放松 Debian/架构限制或生产发布门禁，
--nonprod仍只属于原生平台核验，不影响工具预装。 - helper SHA-256：
59325fb184e4b117a50c29614cf680c8808e63c0589026bd1b9fd767864dd41f。
测试机事实
SSH 指纹按登记值严格核对后，将相同 helper 私密暂存、核对 hash，再执行安装。
- Debian 13；tcpdump 4.99.5、TShark 4.4.19。
- apt 操作：0 个已有软件包升级，19 个新包安装；没有执行系统升级或业务服务操作。
- 真实 tshark 协议能力检查通过；sip-call 所需 17 个 SIP/SDP/RTP/网络字段全部存在。
- Asterisk 保持 active，MainPID 777461 未改变；活动通道 0。
pjsip.conf仍为c319476e7e4962008899a11ae0461db282eed3d63871b2d8adcd143812408cf8，没有修改线路。- 抓包权限未改动，未开启实际抓包。主机缺少 getcap，因此没有据工具存在推断 tcpdump 的一般用户抓包权限。
私密安装日志及核验在本机 .local/diagnostics-install-20261008-VqOqz7/；现场补充记录为 ~/sip-call/diagnostics-verification-20261008.json（0600）。原工具 verification.json 保留初始部署时间点的历史事实，不覆盖；现场 README 已同步当前工具状态。
本地验证与边界
scripts/check-install-diagnostics.sh 在 network-none 的 root 容器内用隔离包命令验证：production/development/test 都调用相同安装命令；拒绝环境切换和非 root；索引/安装/工具执行/缺 RTP 协议的失败均不吞；两个安装入口及两种包均包含 helper。已加入本地验收。
验证期间主工作区被另一条合同迁移工作切换并改动，当前合同目录/测试出现不一致；本任务没有覆盖、撤销或修补这些无关变动，也不声称该并行工作区已整体通过。
本任务使用独立 worktree 31466bd + 已提交 0f5efc6031d230eec475b6f08caed339bd268f84 中仅七个安装/验收脚本的变更进行稳定核验：
- Shell 语法、安装专项、格式和原有 Proto/合同校验通过。
- 全仓
go test -race ./... -count=1 -timeout=120s、go vet -x ./...、覆盖率测试通过。 - 排除生成代码的业务单元覆盖率 70.6%。
- 两个制品构建和本地发布门禁通过；真实隔离 RabbitMQ/HTTPS/mTLS Mock 端到端通过。
- 完整 make 汇总曾超时；初次主工作区还有一次既有 ASR fixture 的 2 秒 deadline 超时，专项连续五次复核通过，未改 AI 源码或放宽时限。上述独立步骤逐项核验，不能把超时汇总当成成功记录。
这只证明安装逻辑、工具能力和隔离验证；不证明真实线路、现场逐通抓证或生产发布签收。实际 -D 仍须在每次执行时通过工具与抓包权限/就绪检查。