docs: record final shared scalar and named control privacy deployment

2026-10-10 01:41:49 +08:00
parent 02e6ab9380
commit 8f3026e459
3 changed files with 20 additions and 2 deletions
@@ -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 01:39 Logrus 对话字段统一保护最终现场**：第三次审查的 textarea 与普通错误多行messages缺口已在 `02e6ab9` 根因修复：共享 cleanString 对 message/error/detail统一保护；敏感name的非void控件保护value及内容，void input不吞后续普通节点；仅对话字段保护续行，认证/凭据不隐藏其后正常诊断。新增断言先失败后通过。最终完整检查/发布检查/Python21通过、业务覆盖率72.0%；两个实际制品SHA256 `296223c111a15dc48200c26548c4ffb7ec206736dbe389b6c107ef69c59181cd`，Agent2901955/D2901966 enabled+active/running、0重启、Debug无Capture，Asterisk777461不变、零通道/tcpdump。真实HTTP/RPC安全正文再次验证，无MQ/呼叫/真实恢复/非JSON现场事件，未签收这些事实或生产；未reset/迁移/外呼投递/额外AI OSS。源码与最终证据仍隔离main `.local/logging-isolated`，根并行修改保留。完整证据见 [`docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md`](docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md)。
+
 - **2026-10-10 01:19 Logrus 自由文本最终修复现场**：第二次审查指出 Basic/无标签 PEM 及非 JSON 正文缺口，已在 `6ee95e4` 修复并重验安装。自由文本认证头（Basic/Digest/Proxy）、无标签私钥 PEM 块均排除；Debug 保留可读 text/XML/form 原正文的安全副本，二进制仅类型长度，原收发 bytes 不改、不截断。新断言先失败后通过（长 text/plain、Markup/form、多行提示词、JSON 错误中认证不隐藏后续业务原因）。最终完整检查/发布检查/Python21通过，业务覆盖率72.0%。两实际 SHA-256为 `38a1e553312ea7ffbff6e11ad9ececc99cb73b6dedb3339f03f55a71568f72b1`，Agent2901719/Dispatcher2901731 enabled+active、0重启、Debug无Capture，Asterisk777461不变，零通道/tcpdump。14HTTP/两端RPC正文与敏感检查再验证通过；现场没有非JSON正文/MQ/通话/真实恢复故障，不伪造验证。仍固定nonprod-real，未reset/迁移/额外投递。最终源码为 `.local/logging-isolated` main，根并行改动保留；证据顶部最终版本见 [`docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.md`](docs/evidence/dispatcher-agent-logrus-debug-deployment-20261009.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)。
@@ -1,6 +1,22 @@
 # Dispatcher / Agent Logrus Debug 实现与固定环境部署

-## 最终已安装版本：6ee95e4（2026-10-10 01:19 CST 现场）
+## 最终已安装版本：02e6ab9（2026-10-10 01:39 CST 现场）
+
+第三次独立审查复现 named textarea 内提示词与普通错误消息中的多行 messages；已根因修复，不以旧 6ee95e4 记录作最终完成：
+
+- `cleanString` 共享入口应用 Markup/对话行保护，普通与 Debug 的 message/error/其他标量一致，不再只给 HTTP TextBody 作保护。
+- Markup 按字段归属保护：敏感 `name` 的非 void 控件（textarea/select/custom）同时隐藏 value 与包裹内容；void input 只隐藏自身值，不吞后面的普通业务节点。不是针对某个文本或单个 textarea 的特判。
+- 对话字段才拥有后续对话行；认证/凭据只拥有其本行，保留之后的普通失败原因。新增两模式 message/error/detail、named textarea/select/custom 与 input 前后普通节点回归断言，先失败后通过。
+
+最终源码 `02e6ab938061fae360c6e9925d940fc4db27a914` 已推送并从干净 main 构建安装；最终 make check/release-check-local（fmt/合同Proto/vet/全包race/build/实际隔离RabbitMQ HTTPS mTLS/现有验收对照）、Python21全部通过，业务覆盖率 **72.0%**。记录 `.local/scalar-final-check.log`、`.local/scalar-coverage.log`、`.local/scalar-release-check.log`。
+
+2026-10-10 01:39 CST 现场：Agent `2901955`/Dispatcher `2901966` 两个实际制品 SHA-256 `296223c111a15dc48200c26548c4ffb7ec206736dbe389b6c107ef69c59181cd`，enabled+active/running、0重启、真实Debug且无Capture；Asterisk `777461` 不变，活动通道/tcpdump=0。先关 D 准入并只读确认零活动/未知执行/恢复状态后部署，无 reset/迁移/Asterisk重启/抓包/独立拨号/外呼投递/额外AI OSS。
+
+实际14 HTTP请求/响应200、两端各8 Debug RPC正文、仅Logrus JSON，0 error/redaction_error/敏感字段泄漏/签名URL泄漏，13隐藏标记。**现场仍无非JSON正文、MQ业务收发、呼叫、真实恢复故障**，这些只本地断言，未伪造真机发生或业务/生产签收；独立probe仍saas_pending/business_ready=false。
+
+私密现场原摘要：根本机 `.local/logging-deployment/scalar-{preflight,deploy,field-summary}.json`（文件0600、目录0700）；权威源码/文档仍 `.local/logging-isolated` main，根并行改动保留。
+
+## 上一版部署记录：6ee95e4（2026-10-10 01:19 CST 历史）

 第二次独立审查发现自由文本 Basic 认证/无标签 PEM 及非 JSON 可读正文仍有缺口；下述旧 fd37a67 记录是历史，不作为最终完成。现已实际修复：

@@ -25,7 +25,7 @@ Agent 的抓包开关独立为 `--capture`：只在显式开启时要求 `AGENT_

 ## 正文边界

-密钥、Token、认证信息、完整 prompt/messages/transcript/text/content/结束语、原始 SIP 内容及音频不输出。敏感字段按键名隐藏，重复键逐个处理；其他 JSON 的空白、重复键和数字写法保留，原业务字节与对象不修改。纯文本以 UTF-8 安全副本记录；敏感键值/多行提示词、Markup 的敏感标签/输入值、表单敏感字段排除，其他可读正文保留。HTTP 二进制和升级后的 WebSocket 流不进入正文日志。
+密钥、Token、认证信息、完整 prompt/messages/transcript/text/content/结束语、原始 SIP 内容及音频不输出。敏感字段按键名隐藏，重复键逐个处理；其他 JSON 的空白、重复键和数字写法保留，原业务字节与对象不修改。所有普通/Debug 日志的 message、error 和其他标量共用字段/对话保护；named 敏感非 void 控件保护其包裹内容，void input 不影响后续普通节点。纯文本以 UTF-8 安全副本记录；敏感键值/多行提示词、Markup 的敏感标签/输入值、表单敏感字段排除，其他可读正文保留。HTTP 二进制和升级后的 WebSocket 流不进入正文日志。

 自由文本里的 Authorization/Proxy-Authorization（包括 Basic/Digest）、Cookie、无字段名的私钥 PEM 块，以及错误里嵌入的 JSON 对象/数组和 quoted API key/Token，同样排除；已隐藏的 JSON 认证字段不删掉后面的非敏感业务原因。实际错误仍返回，原原因保留。非法 JSON、无法安全展开的嵌套数据或部分读取不能退回打印未经处理的正文：输出 `redaction_error`、字节数及 SHA-256。HTTP `body_complete=false` 只表示已观测部分，不能把它当作完整网络正文；原读取/关闭错误继续返回，不因日志改变重试、确认或业务结果。