2026年08月31日

内容截止日: 2026年09月06日

本周工作计划与执行完成进度

中心服务平台 - 功能完善

• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 以往已完成的工作不再重复，详情请查看上周及上月报告
  • 〔工作量〕es-center-server-services 109 次（设计 46 · 代码 63）· 代码 +19.9k/-2.9k ｜ es-center-server-web-app 41 次（设计 23 · 代码 18）· 代码 +3.7k/-0.6k ｜ es-center-server-install-app 6 次 · 代码 +0.1k/-0.1k
  • 〔方法论〕盲评先行、按失败终态停止 ｜ 数据最小化与失败关闭 ｜ 规范最短充分路径与因果门禁 ｜ 契约先行、受保护演练与端到端重演 ｜ 深模块提纯、原子化封装与静态防回归
  • 8-31: Agent 隔离评测裁决
    • ✅ 首批 A/B 尝试出现 P0，接受 no-go 并停止后续确认轮次 〔es-center-server-services〕
      • 测试 完成首批 16 次隔离 A/B 尝试并保留评分修复轨迹。出现 P0 与不可评分情况后，停止其余 32 次 confirmation（复核确认轮次），不追加样本来稀释失败。
      • 评审 接受 no-go（评测不通过、不投产）：现有 Router（Agent 查找工程规范的路由器）保留，confirmation 不启动。退役 Router 与更新外部规范两个条件项继续为 wontfix，本次裁决未实施它们。
      • 实施 固定嵌套 Codex 的自动审批参数。它替代人工审批，sandbox、网络及写路径权限边界保持原样。
      • 设计 将未来评测通过后才适用的治理边界写定，归档冻结输入、筛选分母、停止点与最终裁决；结果出现后的共识不回改已运行会话的输入。
    • ✅ 上下文治理候选按证据来源分层 〔es-center-server-services〕
      • 评审 区分 OpenAI 官方直接建议与项目 A/B 筛选推论，按证据层整理候选方案的保留、降级、删除与新增项；保留外部重构、知识入库及人工裁决的边界。
  • 8-31: 对讲房间音量事件
    • ✅ PTT 房间建房请求启用音量事件 〔es-center-server-services〕
      • 实施 PTT（按键对讲）的 AudioBridge（音频会议插件）建房请求启用音量事件，固定活跃包与平均音量阈值；销毁请求合同不变，精确载荷测试锁定协议边界。
  • 9-01 ~ 9-02: 规范入口与候选验证
    • ✅ 后端改用静态动作索引，规范按最短充分路径读取 〔es-center-server-services〕
      • 设计 先建立候选静态入口，再替换活跃 Router 指令；Router 实现暂作 dormant（休眠、不再承担规范路由）恢复产物保留。稳定规范提升到根入口零跳（直接承载）或一跳（一次引用可达），动态 ADR 最多两跳。
      • 设计 按实际动作拆分代码、Controller（接口控制层）、BMC（采集工作站相关协议）、数据库与 runbook（操作手册）分支，保持正文唯一；统一新建或迁移 ADR 的状态日期与后继关系规则。
      • 审查 以活跃规范清单、链接、跳数分布和代表任务读取量验收结构；补齐认证与外部集成失败时必须停止的入口，保留旧审计作为历史基线。
    • ✅ 八个高风险场景完成隔离验证，候选质量门保持失败 〔es-center-server-services〕
      • 测试 开跑前固定认证、租户、消息 wire（传输字段合同）、生成代码和数据库等场景的自然语言任务、评分口径、必要验证及失败停止边界。
      • 测试 保留隔离会话、工作树、验证输出和评分证据。正式失败与缺失验证不以补跑、局部通过或事后改评分抵消，完整重放后质量门仍为失败。
      • 审查 校正环境、实施与验证失败的归因，补证据导航、脱敏与时间线；这些修正不改变冻结的失败结论。数据库场景首次认证失败之后的测试只作诊断材料，不能替代停止点处缺失的正式验证。
      • 评审 维护者确认所有必要验证齐全才可通过，并禁止在原范围内再次修正、重放。后续推进须另建 successor（后继）范围。
  • 9-01 ~ 9-02: Router 退役与前端规范整理
    • ✅ 另立因果退役边界后，删除休眠 Router 的运行产物 〔es-center-server-services〕
      • 评审 successor ADR 另行核对：Router 已休眠，对多数失败场景没有能改变结果的强制指引。因此退役不再被无因果关系的执行失败永久阻塞；前面的 no-go 与候选质量门失败原样保留。
      • 实施 删除不再承担规范路由的运行产物，保留历史 ADR、原始失败证据与 Git 恢复路径。Java、数据库、API 及其它生产行为零改动。
      • 设计 统一完成索引、ADR 状态日期和批次入口；工作日志继续指向原评分事实，不把 wontfix 或失败写成通过。
    • ✅ 前端规范入口完成整理，失真的架构巡检退役 〔es-center-server-web-app〕
      • 设计 将稳定规范设为根入口零跳或一跳可达，增长的 ADR 集合最多两跳；建立长期规范归档、单源与迁移合同，再按顶层任务和改码动作激活静态索引。
      • 审查 核对规范清单、链接、跳数及代表路径读取量，补齐自动导入、生成代码、格式命名和收尾评审入口。结构验收只证明规范可达，不外推任务质量。
      • 评审 退役已失真的 L2 架构巡检，保留 pre-commit 等 L1 确定性门禁；工程规范、Dashboard（数据看板）指标与对讲请求发送合同同步校准。
      • 实施 执行器改为只接受显式 go，回车、超时、空输入、退出及中断均不误启动；恢复并保留已完成批次的历史记录。
  • 9-01 ~ 9-02: 对讲现场反馈与离线出席
    • ✅ 按记录仪现场反馈回退建房参数 〔es-center-server-services〕
      • 排障 记录仪接入后反馈明显声音延时。从 AudioBridge 建房请求移除显式 RNNoise、音量检测及相关参数，改用 Janus 默认值，并收紧请求载荷合同；销毁与回环行为保持不变。
    • ✅ MQTT 明确离线时过滤 Janus 残留出席 〔es-center-server-web-app〕
      • 设计 定下单向规则：仅 MQTT 明确离线才过滤 Janus 的残留出席；未知、在线与离线三态继续区分，持续查询和单轮四次回返边界保留。
      • 实施 用真实 MQTT entry 的显式离线状态过滤绑定与临时设备；原始 participant（参与者）仍参与查询需求汇总，保留在线恢复所需输入。
      • 重构 将离线判断抽成命名函数，再派生有效参与者集合供两段 roster（成员花名册）投影复用；清理测试重复，查询节奏与消息信封（消息外层字段约定）不变。
  • 9-02: 知识快照与会话复盘
    • ✅ 后端纳入带版本的 Zread 浏览快照 〔es-center-server-services〕
      • 设计 Zread 是可滞后的人类浏览副本，不承担 Agent 正本、手工修补或强制同步职责；后续统一刷新留给维护者。
      • 实施 原样保存中文生成页、索引、内容哈希与 current 指针，覆盖工程架构、核心领域、横切能力和 Agent 协作治理。
    • ✅ 前端纳入首版中文知识快照 〔es-center-server-web-app〕
      • 实施 带版本与 current 指针的 Zread 快照进入仓库；检查清单和敏感信息边界，保持浏览副本的定位。
    • ✅ 后端登记显式调用的会话复盘技能 〔es-center-server-services〕
      • 实施 登记 retro 技能版本与内容身份，将环境安装副本继续交给既有忽略规则管理。
    • ✅ 前端登记同一复盘工作流 〔es-center-server-web-app〕
      • 实施 Agent 与 Claude 两套镜像登记 retro，内容保持一致；复盘从导航、自动检查、规范、工具经济性和信息访问提出环境改进候选。
  • 9-01 ~ 9-03: default → PCM 迁移准备
    • ✅ 库存职责与迁移边界定稿，运行时不再初始化 default 设备库存 〔es-center-server-services〕
      • 设计 default 是顶层默认租户，PCM 承担设备库存；明确跨租户同号合法、同租户活动设备唯一、软删除历史可重复，以及 sync_log、设备归属转移和个人空间投影的语义。生产迁移继续由人工执行，现有 App 合同保留。
      • 实施 统一 tenant fan-out（按租户扇出下发）层排除 default 的设备领域初始化，避免迁移后重建库存；全局 default 配置与合法租户顺序保持。
      • 测试 用 listener（事件监听器）、App 查询、库存同步与重复校验合同覆盖运行时边界。
      • 重构 提取重复测试常量，生产行为与断言不变。
    • ✅ 离线发现与受保护演练工具链建立 〔es-center-server-services〕
      • 设计 schema discovery（发现数据库结构）与 rehearsal（迁移演练）先约定 allowlist（允许操作的表清单）、快照 provenance（来源与出处记录）、脱敏证据和失败关闭边界。测试数据库演练与 snapshot trigger 集成测试隔离，生产数据保持零 AI 接触。
      • 实施 根据结构清单生成只读导出与演练计划；校验快照后，原子输出 dry-run manifest（仅预演、不执行的计划清单），不读取凭据、不连接生产数据库。
      • 实施 对可证明的活动设备碰撞，生成含 preimage（变更前原始行内容）、逐行指纹、影响行数及 sync_log 边界的修复计划。复杂碰撞或输入漂移继续阻断后续 mapping（编号映射）。
  • 9-03 ~ 9-04: 归属转移与迁移资格
    • ✅ 设备归属转移收进同一事务，随后收窄个人空间清退范围 〔es-center-server-services〕
      • 实施 direct bind（直接拥有绑定）的旧投影与活动分享清退共用事务和显式退场时间；权威 direct 缺失或多条时失败关闭。受影响行数与新设备持久化校验阻止半转换。
      • 重构 按「绑定只服务个人空间租户」，运行期清退由 7 目标收窄为 3 目标：设备投影、分享记录、采流路由。ADR-0066 取代旧决策，关联票面与背景勘误同步校准；该范围与迁移表清单分开。
    • ✅ 活动设备号建立唯一约束，隔离库资格重演全链通过 〔es-center-server-services〕
      • 实施 基础 DDL（数据库结构定义）与去重包建立活动设备号部分唯一约束，数据库结构目录 catalog 覆盖逻辑父表与全部继承 child（子表）；数据修复只走逻辑父表。
      • 测试 生产派生 4484 行离线修复计划在隔离库完成应用、校验、漂移与回滚终验。随后完成「恢复 → 去重 → 新鲜导出 → 转换 → 切换 → 回滚 → 再应用」资格重演，44 文件交接登记为后续唯一行级输入。
      • 测试 一轮资格演练因目录行数没有确定排序被判作废，按生成器身份规则冻结新一轮。
      • 排障 pgpool 中断引起清理阻塞，服务重启后复核清理闭合，过程如实记录。
      • 实施 PCM 迁移目录作为固定批次输入，显式选择 agent 流程并保留连续日志。
  • 9-03 ~ 9-04: 转换、切换与回滚
    • ✅ 转换包按单元格转换，切换与回滚均有完整校验 〔es-center-server-services〕
      • 实施 对 23 张表全列数据逐单元格转换；canonical（唯一权威）编号规则与运行时初始化器一致，阻断双编号。后置条件检查主键、活动自然键与零 default 残留。
      • 实施 切换 SQL 放进单个可串行化事务：锁同步日志并记录边界，用 preimage 指纹防错配，按反向删除 → 正向插入 → 批量更新执行，再核对逐表多重集与全部后置条件。三轮真实 PostgreSQL 排演通过，迁移本体跨轮字节相同。
      • 实施 回滚 SQL 先证明已成功迁移，再逐行逆更新；恢复后核对行数、指纹与整行身份。输入漂移或源码变化时，在生成任何 SQL 前失败关闭。
  • 9-03 ~ 9-04: 端到端演练与操作交付
    • ✅ 端到端资格演练通过，结论限于进入生产维护窗口 〔es-center-server-services〕
      • 测试 从原始种子全链重放，独立对账确认切换后与转换包一致、回滚后与快照一致；启动二次核数零变化，App 冒烟覆盖认证链与库存增删改查。
      • 测试 App 正向绑定族仍因 PCM 库存 HTTP 创建通道结构性缺失而保留边界。演练发现实际子表同步触发器形态与 fixture（测试预设样本）不同，按 catalog 修正同步日志预期，旧轮证据标为被取代后再跑资格轮；可上线表示取得维护窗口资格，不表示生产已经执行。
      • 审查 逐行深审 11 张票、33 个提交的生产代码，抽查工具关键路径，结论无阻断项。3 项应修分别是结果类包位置、目标签义与正则窄耦合，当场修正，并用顺序合同测试约束先退场、后新建。
      • 测试 工具修正后旧生成器资格报告按合同作废；新一轮 4486 行种子登记，按新生成器身份完整重演通过。过程实录中，手抄变量缺 2 字符被绑定断言当场拒绝。
    • ✅ 十二阶段操作手册与执行卡交付，生产操作保持人工执行 〔es-center-server-services〕
      • 设计 发布十二阶段生产切换 runbook，写明硬性边界、停止条件与回滚策略；教学导读补 SQL 人工审查导览、操作员极简清单，并明确「生成归 AI、生产执行归操作员」。
      • 实施 新增操作员执行卡脚本，变量运行时从 manifest 提取，口令不经脚本，回滚需显式确认；脚本替代变量手抄，保留每步日志与成功判据。
  • 9-03 ~ 9-04: 国内测试环境与凭证轮换
    • ✅ 开发与集成测试入口整组切到国内测试服务器 〔es-center-server-services〕
      • 测试 Nacos、PostgreSQL、Meilisearch、EMQX 与 Coturn 入口统一迁移，规格、票据和集成测试默认连接同步调整。
      • 实施 Nacos 管理凭证变量显式改名并轮换密码，与只读凭证区分；Zread 浏览快照同步国内环境地址。
      • 测试 刷新并行验证工作流的机器产物证据，使其与当前代码状态对齐；原有评测结论不因证据刷新改变。
  • 9-03 ~ 9-04: 持久位置缓存
    • ✅ 位置查询收成三个接口，持久记录保持七天硬期限 〔es-center-server-web-app〕
      • 设计 八轮 grilling（逐条追问的设计评审）定稿为 deep module（接口简单、复杂度留在实现内的深模块）合同。42 条用户故事覆盖地图、GPS 与维护者三类角色；三个名字明确的接口负责国家查询、反向地址与 IP 定位，七天硬性 TTL（缓存有效期）不续期，只存正向结果。
      • 设计 空间索引快照持久化；反向地址有唯一持久真源，IP 定位采用同步投影。恢复、串行写入、容量淘汰与存储熔断（存储异常后在本页停止重复访问）收进模块内部，调用方使用查询接口。
      • 实施 国家查询持久缓存先行，36 例契约测试全过。
      • 实施 反向地址按语言环境选择服务方，处理自然键（用位置与语言唯一识别记录）、容量和熔断；首次未命中保持非阻塞，45 例契约测试全过。
      • 实施 IP 定位同步投影成为唯一同步持久真源；旧形态、损坏与越界记录精确删除后重载，27 例契约测试加 3 例地图中心行为全过。
    • ✅ 清除假接缝与旧依赖，修复内存缓存过期缺陷 〔es-center-server-web-app〕
      • 重构 删除从未生效的 localforage 伪接缝，不保留兼容空壳；三条静态防回归规则检查伪接缝标识符禁回流、消费点收口到明确清单，以及位置缓存禁止全清。
      • 重构 淘汰 memoizee，改用统一内存缓存组件，显式编码全部自然键；先复现「越过过期时刻仍命中」的失败，再修复为过期不命中。
      • 重构 将缓存适配层提炼为单一原子件（可独立组合的缓存适配函数），「先原子化封装、再组合」写入 ADR。第二轮审查零新缺陷，四处微冗余当场清理。
      • 审查 保留两轮审查链，逐项实测核验四个依赖库的行为假设，结果全部吻合。
  • 9-03 ~ 9-04: 固件文件校验入口
    • ✅ 固件头 intake 收成单函数，新增与编辑页共用文件校验 〔es-center-server-web-app〕
      • 评审 公共库深化候选经两轮 grilling 裁决，选择 intake（统一接收文件对象的入口）深模块；扩展名、大小、读取、解析和校验收进函数，业务拒绝由返回值携带未翻译键。
      • 设计 30 条用户故事定稿并拆为单票；约定单一异步函数、判别联合返回，收回旧三导出，接口测试作为唯一测试面。
      • 重构 固件包新增、编辑两页各用一次调用加三分支，替换约 22 行复制校验编排；同时消除两处未处理拒绝。先复现失败再修复转绿，新增 22 例接口测试，全量测试全绿。
  • 9-06: 客户端鉴权与发布物
    • ✅ Nacos 客户端鉴权取消，发布物同步 09-06 轮次 〔es-center-server-install-app〕
      • 实施 微服务客户端连接 Nacos（配置中心）不再使用账号密码鉴权，账号密码鉴权仅用于管理控制台；安装配置和模板环境删除客户端凭证项，客户端连接地址保留。
      • 实施 三个业务镜像升级到 09-06 轮次，新装与升级部署拉取同轮镜像；同步构建、上传、部署脚本与文档包版本示例，构建过程记录一起更新。
      • 实施 测试服部署脚本的对讲网关重启命令补权限前缀，非 root 会话不再在该段因 Docker 权限失败。

其它工作

• 目标: 记录日常杂项工作、协作沟通等事务
• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
  • 31 日
    • ✅ 协作 git → svn 源代码同步
    • ✅ 设计 对讲界面中实时显示谁在说话的技术可行性: 已通过修改后端建房参数, 使 janus 信令中包含实时的”谁在讲话”的事件, 后又微调参数, 使 2 秒才能判断出来, 改为 0.5 秒就能有事件推送消息, 后续需要改进前端界面, 用界面动效明确显示”谁在讲话”
  • 03 日
    • ✅ 实施 将最新版本部署到 zxs-cs, zxs-test 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕
  • 06 日
    • ✅ 实施 将最新版本部署到 zxs-cs, zxs-test 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕