From 56fd1e11cf73f476330ae4436b79d1ca46f3093f Mon Sep 17 00:00:00 2001 From: Rogee Date: Sat, 10 Oct 2026 00:41:26 +0800 Subject: [PATCH] docs: record final diagnostic and privacy deployment --- AGENTS.md | 2 ++ ...tcher-agent-logrus-debug-deployment-20261009.md | 14 +++++++++++++- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 39ca952..b886339 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -81,6 +81,8 @@ - **当前日志与抓包规则**：Dispatcher、Agent 的 `--debug/-D` 仅开启 Logrus 详细收发日志；普通模式记录自身关键工作流程、方向、身份、结果、耗时及错误。HTTP/MQ/RPC 正文只在 Debug 中记录安全副本，禁止密钥、Token、签名 URL、完整提示词/对话/音频及原始 SIP；不截断其余可读业务 JSON，不修改发送数据、不吞错误。Agent 原 `--debug` 抓包含义移除，逐通外部抓包凭证检查改为独立 `--capture`，不足时仍失败关闭。独立 `sip-call` 的 Debug 抓包参数不变。详细规则见 [`docs/logging.md`](docs/logging.md)。 +- **2026-10-10 00:37 Logrus 最终固定版本**：源码 `fd37a67` 已推送并安装；在完整阶段/原失败原因日志之外，补齐损坏结果 JSON 和文件 stat 的具体原因、私钥/Pem 与签名 WS/WSS 排除。新增断言先失败后通过，最终完整检查/发布检查、Python 21 测试通过，业务覆盖率 71.7%。两实际制品 SHA-256 `7b606adf83147fdf966d455b6a2d3543955adcedca608b306f438dcbfcc424ad`，Agent PID 2901612、Dispatcher 2901624，enabled+active/零重启、真实 `--debug` 无 `--capture`；Asterisk 777461 不变。14 次 HTTP/两端各 8 条 Debug RPC 正文、敏感字段/签名 URL 检查复核通过；现场无 MQ/呼叫/真实恢复故障，不代签这些事项。停止 D 关准入后复核零通话/未知执行再部署，未 reset/迁移或额外投递。隔离 main `.local/logging-isolated` 为最终源码基线，根工作区并行修改保留。证据见 [`docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md`](docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md)。 + - **2026-10-09 23:57 Logrus 最终排障日志部署**：独立审查指出初版拒绝/等待及逐条恢复原因不足，已在 `592c2fe` 全面补齐已有关联身份、实际原因、各节点阶段、尝试/下次重试、未知及到期保留；失败原因不只记录类型，嵌入错误的 JSON 对象/数组也做结构化排除。新增断言先失败后通过，最终完整检查/发布检查与 Python 21 测试通过，业务覆盖率 71.7%。固定提交已推送、重部署，两业务服务 PID 2900896/2900908、enabled+active/零重启、真实 `--debug` 无抓包，制品 SHA-256 为 `e3aa61d75768e6aca2b3567864890da4ba5bf3ebd53fba678cca242ae030a2b4`。14 次 HTTP/两端 RPC 正文复核及敏感检查通过，仍无现场 MQ/呼叫/真实恢复故障，不以本地断言冒充；未清数据、改重试/数据规则或重启 Asterisk，PID 777461 不变。根工作区并行改动保留，权威源码在 `.local/logging-isolated` main。完整证据见 [`docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md`](docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md)。 - **2026-10-09 23:16 Logrus 日志部署现场**：日志源码 `669f3a5` 已推送并安装到登记测试机，两固定业务服务均 enabled+active、进程稳定且零重启，实际启用 `--debug`、不启用 `--capture`。现场确认 14 次 SaaS HTTP 请求/响应及两端实际 RPC 的详细日志，已观测正文敏感字段/签名 URL 检查零泄露；无实际 MQ 业务收发，须标记现场未验证。部署前先关 Dispatcher 准入再核对零通话/未确认执行；未清数据、重启 Asterisk、抓包、独立拨号或额外调用 AI/OSS。Asterisk PID 777461 不变。部署工具仍给出旧独立探测的 saas_pending/business_ready=false，不伪造成功，不以本次日志验证代签真实通话或生产。完整测试与发布检查通过、业务覆盖率 71.4%，原并行改动未覆盖或纳入日志提交。证据见 [`docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md`](docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md)。 diff --git a/docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md b/docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md index 0c5a768..455500f 100644 --- a/docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md +++ b/docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md @@ -1,6 +1,18 @@ # Dispatcher / Agent Logrus Debug 实现与固定环境部署 -## 最新完成版本：592c2fe（23:57 CST 现场） +## 最终已安装版本：fd37a67（2026-10-10 00:37 CST 现场） + +最终源码 `fd37a67ef888c6ca7b49cc43e473e3b54e5781fb` 已提交并推送 main，远端核对一致，制品来自干净固定提交。包含下述完整诊断修复，并额外保留文件 stat/JSON decode 的原失败原因；私钥/Pem 及签名 WS/WSS 地址在普通/Debug 模式均隐藏，相关新断言先失败后通过。 + +最终重新执行 `make check`、全包 race/vet/build、当前合同/Proto、实际隔离 RabbitMQ/HTTPS/mTLS、`make release-check-local` 和 Python 21 项测试，均通过；业务覆盖率 **71.7%**。最后版本的检查日志为隔离工作区 `.local/privacy-{final-check,coverage,release-check}.log`。 + +2026-10-10 00:37 CST 实际两进程 SHA-256 均为 `7b606adf83147fdf966d455b6a2d3543955adcedca608b306f438dcbfcc424ad`；Agent PID `2901451`、Dispatcher PID `2901463`，两者 enabled+active/running、零重启、真实 `--debug`、无 `--capture`。Asterisk PID `777461` 不变；零活动通道、零 tcpdump。部署前先关 D 准入再检查零未知执行/恢复状态，未 reset/迁移、未额外投递或调用 AI/OSS。 + +本次再次观测 14 次 HTTP 请求/响应（200）、两端各 8 条 Debug RPC 正文；所有业务进程日志为 Logrus JSON，无 error/redaction_error，已观测敏感字段/签名 URL 泄露 0、隐藏标记 13。**MQ 收发、真实呼叫执行和真实恢复故障未发生，保持现场未验证**，本地失败路径断言不代替真机故障事实。部署器独立探测仍 `saas_pending/business_ready=false`，不伪改、不代签生产。 + +最终私密现场摘要为本机 `.local/logging-deployment/accepted-{preflight,deploy,field-summary}.json`（0600）；源码与本文均以隔离工作区 `/home/rogee/Workspace/sip-go-agent/.local/logging-isolated` 的 main 为准，根工作区并行改动未覆盖。 + +## 诊断完整性修复记录：592c2fe（23:57 CST 历史现场） 初版完成请求经独立审查发现拒绝、等待和逐条恢复失败日志不足，因此初版不能作为最终完成。已按以下项目修复，并重新完整验证、推送及部署：