2026 年度总结
年度定调:2026 年,我端到端承担中心服务平台的交付:从需求与架构,到审查、测试、联调和发布。AI 协作的方法也随项目演进,从先写规格、先看原型,发展到先约定接口与边界,再按步骤实施、审查和验证。集群对讲是这条变化线上的集中实践。
本篇按「全年 → 各季 → 每月 → 成就与成长」四层展开。Q3 已闭合、Q4 进行中(截至 2026-10-31),内容截止日统一为 2026-10-31;周报明细见左侧导航中的各月子页。
数据覆盖固定九仓库,以提交次数为主,设计与代码分别计量。分类按提交前缀,无规范前缀时采用已验收素材的标注;代码行数仅作参考,来自 git numstat(逐文件统计增删行数的命令),并排除
.md/.txt等非代码文件。下文的全栈只指后端与 Web 前端的代码实施,完整职责用「端到端承担」表述。
一、全年概况
三条主线
三条主线分别回答:交付基础怎样补强、产品能力怎样扩展、AI 协作怎样组织。表中先看变化,季度与月度再展开依据。
| 主线 | 工作怎样展开 | 对应实践 |
|---|---|---|
| 🏗️ 基础设施加固 | 从跨境数据同步、配置集中化与国际化性能,推进到部署脚本体系及租户、缓存和响应计时的统一约定 | 1 月全量/增量数据同步实现闭环;2 月国际化性能优化;9 月缓存租户治理、客户端 IP 链路与 MQTT/HTTP 分段响应计时;10 月查询索引与历史快照整改、业务唯一索引收敛 |
| 🚀 功能完善 | 从固件、报表与 dashboard(数据看板),走到集群对讲交付,再深化组织管理与接口文档 | 5 月固件链路;6 月报表九大模块与 dashboard;7-8 月集群对讲;9 月组织模块、机构/零售 App 接口文档;10 月直播首帧显式起播、麦克风惰性采集与跨租户管理前端 |
| 🧭 AI 方法论 | 规格驱动 → 原型驱动 → 契约先行 → 自治闭环:先把需求、界面和接口边界写清,再约定实施顺序与验证条件 | 1 月 OpenSpec 规格驱动;5 月 pen2code 原型驱动;6 月 BUSINESS.md 与接口契约;8 月 Loop 按序执行;9 月决策地图、ADR 与实施批次;10 月 ADR 批量立法、先实施规格后按域批量落地并以组合验收收口 |
全年数据(截至 2026-10-31)
| 仓库 | 提交次数 | 设计 / 代码 | 季度分布(Q1 / Q2 / Q3 / Q4) |
|---|---|---|---|
es-center-server-services | 2,406 | 953 / 1,453 | 431 / 136 / 1,380 / 459 |
es-center-server-web-app | 2,577 | 1,248 / 1,329 | 152 / 854 / 1,041 / 530 |
es-center-server-install-app | 218 | 32 / 186 | 65 / 26 / 124 / 3 |
es-ext-doc-website | 122 | 61 / 61 | 2 / 0 / 119 / 1 |
es-center-server-build | 38 | 2 / 36 | 18 / 4 / 15 / 1 |
es-center-server-agent | 4 | 2 / 2 | 0 / 0 / 3 / 1 |
es-server-deploy | 29 | 2 / 27 | 18 / 7 / 3 / 1 |
es-qt-tools-map | 5 | 3 / 2 | 2 / 0 / 2 / 1 |
es-bodycam-web-ui-1 | 4 | 2 / 2 | 0 / 0 / 3 / 1 |
| 固定九仓库合计 | 5,403 | 2,305 / 3,098 | 688 / 1,027 / 2,690 / 998 |
8 月为全年高峰(固定九仓库 1,040 次,其中
es-center-server-services591 次、es-center-server-web-app401 次),10 月 998 次居次,9 月 959 次居第三;7 月仍是集群对讲攻坚高峰。代码行数仅作参考(重构会放大),不作为工作量依据。
一个判断
让 AI 可靠产出,已经成为一套贯穿交付过程的工作。 Q1 用规格与多轮审查交代任务、核对结果;Q2 加入原型和业务文档;Q3 继续约定接口边界、执行顺序与对抗复核。设计、审查纠偏和测试贯穿其中,而代码实施只是承担面的一部分。
「从用 AI 到造体系」具体落在这些做法上。集群对讲的交付与方法论的四阶段演进,分别在第四层 · 成就与成长展开。
二、各季概况
Q1(1-3 月)· 基础设施加固与方法论奠基
业务:先补强数据同步、配置与运行基础。
- 跨境数据同步完成全量/增量主线,并在 79 表上验证;从节点补上固件文件同步。
- Nacos 配置集中化,将密钥迁入统一配置。
- 国际化性能优化组合使用内存队列去重、流式查询与布隆过滤器(省内存的“是否见过”判断器)。同时补强 IP 限流、GPS 轨迹可视化组件与设备/固件健壮性。
方法论:先反复审查,再把做法写成规范。
- 以 qoder → opencode → claude code 的多工具、多轮代码审查逐轮筛查缺陷。
- 启动 OpenSpec 规格驱动开发,建立 AGENTS.md 分层知识库;3 月在深圳举办「AI 培训周」,现场普及规范驱动开发。
数据:688 次提交(设计 242 · 代码 446)。
Q2(4-6 月)· 功能完善与方法论成型
业务:完善既有功能,并开始设计集群对讲。
- 数据权限控制细化、账号注销全栈、SpiritCam/PonyCam 固件管理链路与多租户划分(scm/pcm)逐项落地。
- 交付报表九大模块后端 API、以 pen2code 原型驱动的 dashboard 框架,以及用户头像上传。
- 季度末设计集群对讲落地方案:Janus AudioBridge 承担音频会议,MQTT 传递 PTT(按键发言)配置;同步完成 Janus Gateway 1.4.1 升级集成。
方法论:让界面原型、业务文档与审查结果进入实施流程。
- 建立 pen2code 原型驱动:先确认 .pen 设计稿,再还原为 React 代码。
- 以 BUSINESS.md 驱动开发,保持三层文档同步;PDCA 多轮审查按“审一轮、修一轮”的方式收敛,达到 P0=0 / P1 清零。
- SQL 查询使用 LATERAL LIMIT 1 提速,即在关联查询中每组只取一行。
数据:1,027 次提交(设计 722 · 代码 305)。
Q3(7-9 月,✅ 已闭合)· 集群对讲攻坚与自治闭环
业务:7-8 月交付集群对讲,9 月转向架构治理与功能深化。
- 集群对讲后端:完成对讲群组增删改查(CRUD)、设备成员关系、PTT 配置刷新、Janus 房间生命周期与补偿、AudioBridge、MQTT 缓存键统一,以及执行器虚拟线程迁移。
- 集群对讲前端与收尾:完成工作台、设备分页绑定、真实接口对接与 AudioBridge 集成,同步提升品牌竞争力;随后完成 PTT 接口衔接约定、确定性恢复、集成验收与可用性打磨。月末继续完成 Janus client 接线、i18n(国际化)错误呈现边界与 PTT 音量事件。
- 架构与审查:统一 i18n 翻译发布器,完成架构渐进式改造分析、冻结终点代码审查(49 张工单)与英文版文档镜像交付。冻结审查以固定代码版本为基准,逐项复核问题。
- 9 月服务端治理(
es-center-server-services):完成跨租户组织管理试点与封装、缓存租户合同三批工作及租户 scope(作用域)归属治理(ADR-0084);完成架构深化 17 票裁决,发布 24 张实施票。分区前缀身份族五线统一,覆盖租户编号/邮箱/手机号/第三方账号/用户名,并建立设备号全局唯一守卫。月末限定设备号 HTTP 入口的跨租户投影例外(ADR-0097),完成 MQTT/HTTP 分段响应计时合同(ADR-0098~0102)。 - 9 月前端深化(
es-center-server-web-app):完成全站 i18n 呈现基线、远程选择器统一封装、组织模块深化 14 票决策与实施批次;提炼 useInfiniteList,保留重复点击导航时的直播状态,完成全仓图标语义专项。 - 文档与发布:
es-ext-doc-website交付机构/零售 App 接口文档、重构开发手册并补全 MQTT 契约。es-center-server-install-app推进 20260913/20260921/20260923/20260929,es-center-server-build推进 20260913/20260928 发布制品并同步 20260929 镜像票面,跨仓并集为 5 个日期;es-center-server-agent录得九月首条提交。
方法论:从约定接口,发展到约定探索、实施与验证的完整顺序。
- 契约先行与诊断:接口先冻结,再分别实现;房间掉线先诊断根因,再编排确定性恢复动作。
- 执行与复核:建立 Loop Engineering 执行体系,让多代理按序推进复杂探索;以冻结基线规模化审查进行对抗复核,配置 Matt Pocock skills。模型自治方案使用隔离 A/B canary 筛选,结论为
no-go时保留既有 Router。 - 9 月治理:决策地图 → ADR 立法 → 决策票裁决 → 实施票批次推进。这里的 ADR 是架构决定记录;9 月新增十余份,用它记录已裁决的边界,再按票推进实施。
- 边界与验证方法:持续落实缓存租户双态合同、连接状态有界家族快照、代次隔离(新旧两代实现隔离过渡、互不干扰);采用红绿先行,先用测试复现失败,再修复转绿。
数据:2,690 次提交(设计 1028 · 代码 1662)。其中本季集群对讲 529 次;该项目跨 6-8 月的 575 次总量见成就部分。
Q4(10-12 月,🟡 进行中,截至 2026-10-31)· 索引整改与直播深耕
业务:10 月服务端以查询索引与历史快照整改为主线;前端深耕直播链路与构建现代化。
- 10 月服务端索引整改(
es-center-server-services):全量导出改原子发布、全量导入失败边界修复结票;查询索引整改按「存量预检演练 → 决策收口 → 实施规格与历史/快照规范发布 → 按域批量落地」推进,覆盖厂家、目录、投影、关系、历史、审计、身份、授权、配置等域;群组文件与消息订单索引收口,型号索引合并重启并完成组合验收;单列主键恢复、租户活动唯一索引与审计留痕一并交付。月末连续交付:绑定唯一键验收、分表迁移与用户名前缀退役批量落地(ADR-0130 分表定案)、datasync 第 10 票收官与快照恢复验证、角色预设配置化清退与 MQTTother/#授权(ADR-0133/0134),业务唯一索引收敛各域批量交付并完成最终组合验收(附件 HOT 例外收窄,ADR-0136 补正票回填)。 - 10 月前端直播、构建链与跨租户管理(
es-center-server-web-app):修复 videoroom 控制面短断并完成真实验收与性能对照;直播首帧显式起播批次(ADR-0056 决策落档后七票实施);交付播放信息双视图与起播历史;对讲/直播麦克风惰性采集批次实施与核证移交;构建链切 Vite 原生路径解析并收口 Oxc 压缩。月末 i18n 治理三批连发(维护批次十票收口、五语默认译文交付、底稿主动合并与收录覆盖加固),跨租户传统管理前端逐票交付(角色只读、Role 写入与批删、组织角色分配、响应式加载、业务 DTO 树适配与个人租户过滤、厂家跨租户管理、角色配置权限只读与权限呈现一致性)。 - 发布与协作:10-19 将最新版本部署到
192.168.1.53/zxs-cs/zxs-ca服务器,多轮复现 BUG 定位根因并处理(登录密码提示、采集服务器绑定设备 API、对讲新表主从同步);每周 git → svn 源代码同步。 - 其余仓库:
es-center-server-install-app3 条、其余六仓各 1 条零星提交(批次执行模板、部署脚本与工单归档类)。
方法论:治理闭环延续 9 月形态——先决策收口、再发布实施规格、后按域批量落地;组合验收以真实数据核证;ADR-0056 起播决策先行、再批次实施。月末 ADR 批量立法延续(ADR-0125~0136),索引收敛以「各域批量交付 → 最终组合验收 → 补正票回填」收口;i18n 三批与跨租户前端按「规格 → 决策票 → 实施批次」推进。
数据:998 次提交(设计 313 · 代码 685)。
三、每月概况
1 月 · 数据同步与配置集中
- 🟦 es-center-server-services:
- 跨境数据同步从设计推进到全量/增量同步功能实现,按任务清单逐项推进。
- Nacos 配置集中化(密钥迁移)落地。
- 多轮代码质量审查逐项处理缺陷。
- 从节点固件文件同步补齐。
- 🟩 es-center-server-web-app:
- 前端配置精简。
- v2 APK 下载页与法律协议文档交付。
- 地图缩放改为按类型分级。
- 🟨 es-center-server-install-app:部署脚本完成多服务器体系化,覆盖 zxs/zxs-cs/zxs-ca/hs。
- 🧭 方法论:
- 多工具多轮代码审查奠基。
- OpenSpec 规格驱动启动。
- AGENTS.md 知识库奠基(把工作规范与领域术语写成 AI 可读取的上下文)。
- 技能库与提示词模板引入。
计量:固定九仓库合计 355 次(设计 126 · 代码 229)。
逐仓:
es-center-server-services265 次、es-center-server-web-app33 次、es-center-server-install-app41 次、es-ext-doc-website2 次、es-center-server-build10 次、es-server-deploy4 次。
2 月 · 同步验证与国际化性能
- 🟦 es-center-server-services:
- 跨境数据同步进入测试,主线流程在 79 表上完成全量/增量验证。
- 国际化模块性能优化(内存队列去重 + 流式查询 + 布隆过滤器)。
- IP 限流实现、公网 IP 检测增强。
- 🟩 es-center-server-web-app:
- v2 APK 下载页优化。
- 法律协议文档完善。
- to-C 路由调整。
- 🟨 es-center-server-install-app:构建部署脚本成体系(build.sh、多环境 .env)。
- 🧭 方法论:
- 测试驱动缺陷收敛(用测试把缺陷一个个逼出来修掉)。
- 模块内聚化与工具类精简。
- 构建工程化起步(Spotless 代码格式化插件)。
计量:固定九仓库合计 139 次(设计 50 · 代码 89)。
逐仓:
es-center-server-services104 次、es-center-server-web-app16 次、es-center-server-install-app14 次、es-center-server-build4 次、es-server-deploy1 次。
3 月 · 培训周与规范环境奠基
- 🟦 es-center-server-services:
- 设备/固件健壮性补强——空值加防护、唯一性缺陷修复。
- 从节点固件文件同步。
- 建立供 AI 按规范实施的工作环境。
- IP 限流迭代简化。
- log 模块迁移至 Meilisearch(搜索引擎)。
- 🟩 es-center-server-web-app:
- GPS 轨迹可视化沉淀为可复用组件(设计先行、明确规格)。
- 搭建前端 AI 规范开发基础。
- 数据采集设备/服务器导入导出字段扩展。
- 🧭 方法论:
- **AI 培训周(03-04 深圳现场)**把规范驱动开发带到一线。
- openspec/superpower 生态建设。
- 技能库系统化引入(ahooks、shadcn-ui、vercel-react)。
- OpenSpec 变更驱动开发。
计量:固定九仓库合计 194 次(设计 66 · 代码 128)。
逐仓:
es-center-server-services62 次、es-center-server-web-app103 次、es-center-server-install-app10 次、es-center-server-build4 次、es-server-deploy13 次、es-qt-tools-map2 次。
4 月 · 权限细化与注销全栈
- 🟦 es-center-server-services:
- 数据权限控制细化——先做差距分析、再逐项修复。
- BeanUtils 空校验(OpenSpec 变更驱动)。
- 账号注销功能打通全栈。
- 采集服务器外网 IP 配置与 IoT 同步通知。
- 固件上传加格式限制。
- 🟩 es-center-server-web-app:
- 业务数据报表设计梳理。
- dashboard 原型设计(Pencil 设计工具)。
- 设备详情查询接口。
- 🧭 方法论:
- 完善 OpenSpec 变更驱动流程(提案→规格→实施→归档)。
- 设计先行、明确规格。
- 前后端契约对齐(接口先对好、再各自开发)。
计量:固定九仓库合计 543 次(设计 518 · 代码 25)。
逐仓:
es-center-server-services13 次、es-center-server-web-app524 次、es-center-server-install-app1 次、es-center-server-build1 次、es-server-deploy4 次。
5 月 · 固件链路与原型驱动
- 🟦 es-center-server-services:
- 设备详情查询交付。
- SpiritCam 固件管理链路(查询/上传/流式处理,带租户删除保护)。
- PonyCam API(分享限制校验、错误响应国际化)。
- init-tenant-map 把租户初始化统一到一处。
- scm/pcm 多租户划分。
- 🟩 es-center-server-web-app:
- dashboard 框架搭建(pen2code 原型驱动,设计稿直接还原成代码)。
- 用户头像上传链路。
- 分页统一迁移到 ahooks usePagination。
- Sentence Case 命名规则确立。
- 组件库升级。
- 🧭 方法论:pen2code 原型驱动建立、提炼-验证-遗忘工具循环、PDCA 多轮审查收敛。
计量:固定九仓库合计 243 次(设计 82 · 代码 161)。
逐仓:
es-center-server-services40 次、es-center-server-web-app196 次、es-center-server-install-app5 次、es-center-server-build2 次。
6 月 · 报表 API 与集群对讲立项
- 🟦 es-center-server-services:
- 报表九大模块后端 API 交付(设备/服务器/在线/电池/存储/上传/仪表盘 KPI)。
- 设备绑定分页用 LATERAL LIMIT 1 提速。
- default→pcm 租户数据迁移。
- 集群对讲服务落地方案设计(Janus AudioBridge + MQTT PTT),在本月立项。
- 🟩 es-center-server-web-app:
- dashboard 后端 API。
- BUSINESS.md 文档驱动开发(先写业务文档、再按文档实现)。
- 三层文档同步(BUSINESS v4.x / API v1.x / README v3.x)。
- 多轮审查清零(P0=0 / P1 清零)。
- i18n 流程标准化。
- 🟨 es-center-server-install-app:升级程序(离线镜像集成)、Janus Gateway 1.4.1 升级集成、Nginx 代理配置。
- 🧭 方法论:文档先行(BUSINESS 驱动)、SQL 性能提速、多轮审查清零。
计量:固定九仓库合计 241 次(设计 122 · 代码 119)。
逐仓:
es-center-server-services83 次、es-center-server-web-app134 次、es-center-server-install-app20 次、es-center-server-build1 次、es-server-deploy3 次。
7 月 · 集群对讲主线攻坚
- 🟦 es-center-server-services:
- 集群对讲后端主线:对讲群组 CRUD、设备成员关系、PTT 配置刷新、Janus 服务器管理、房间生命周期与补偿、AudioBridge、MQTT 缓存键统一、查询限流统一逐项落地。
- 性能方面完成设备列表缓存分阶段优化与在线状态批量查询。
- Function 执行器迁移到虚拟线程。
- 🟩 es-center-server-web-app:集群对讲前端:Janus 运维页、工作台与群组编辑、设备分页绑定、真实接口对接、在线状态走 MQTT、房间生命周期控制、AudioBridge 集成(浏览器 offer 协商、session 保活)、防重提交逐项交付。
- 🧭 方法论:
- 契约锁定先行(MQTT 缓存键/路由契约,接口先冻结、再各自实现)。
- 性能优化(缓存/并发/弱网)。
- 执行器并发迁移。
计量:固定九仓库合计 691 次(设计 207 · 代码 484)。
逐仓:
es-center-server-services376 次、es-center-server-web-app311 次、es-center-server-install-app2 次、es-center-server-build2 次。集群对讲攻坚高峰。
8 月 · 收尾与自治体系
- 🟦 es-center-server-services:
- 完成集群对讲后端收尾:固定 PTT 配置的衔接约定,补齐关系变更后 PTT 刷新、原子删除链路与统一入房权限。
- 完成 Meilisearch 队列限流、ICE/PTT 配置获取契约、i18n 翻译视图发布、缺失翻译批量摄取与 JMS 任务分离;PTT 房间启用 AudioBridge 音量事件。
- 建立**冻结终点代码审查(49 工单)**与 Loop Engineering 执行体系。
- 加固租户写边界,完成类型化消息信封全链、JMS 通道契约统一归档与 MyLog 双壳治理(两服务各一层薄壳、共享同一实现)。
- 完成确定性规范路由与模型自治 A/B canary;首批 screening(隔离筛选)结论为
no-go,保留 Router。
- 🟩 es-center-server-web-app:
- 冻结 AudioBridge 房间合同,抽取状态所有权与确定性恢复逻辑,补齐成员花名册。
- 完成品牌竞争力提升(在线状态统一/响应基线/状态语言/房间控制)与可用性打磨(渐进披露·卡片密度·中央入口)。
- 对 MQTT 请求通道、远程选择器、XLSX 表格 IO 与分区日志检索做深模块提纯:把接口收简,将复杂度留在实现内。
- 完成设备实时页六原子组合、Janus client 模块与房间接线、i18n 错误呈现边界及 UI 依赖升级。
- MD5 换芯(替换底层实现、对外合同不变)在月末仅完成规格与排程,尚未实施。
- 🟨 es-center-server-install-app:调整 nginx chunked(分块传输)配置、服务启动延迟与版本号;同步 08-24 服务镜像与安装包版本。
- 🟪 es-ext-doc-website:交付 2.0.1 版本文档(更新日志/安装手册);英文版文档镜像按产品域推进 9 张票。
- 🧩 多仓治理:落实九仓提交消息条款与分层信任取材;将「规格 → 拆票 → 实施」的串行交付管线确立为默认流程。
- 🧭 方法论:
- 先诊断根因、再编排动作;以冻结基线规模化审查进行对抗复核,以 Loop 顺序优先执行契约约定执行次序。
- 采用成熟库优先的简化原则(稳定性 > 安全 > 性能),持续实践行为保持重构、深模块提纯与契约先行。
- 明确规范读取路由、Agent 上下文治理依据;隔离评测失败时停止切换。
计量:固定九仓库合计 1,040 次(设计 495 · 代码 545)。
逐仓:
es-center-server-services591 次、es-center-server-web-app401 次、es-center-server-install-app15 次、es-ext-doc-website18 次、es-center-server-build5 次、es-center-server-agent2 次、es-server-deploy3 次、es-qt-tools-map2 次、es-bodycam-web-ui-13 次。
9 月(截至 2026-09-30)· 架构深化与治理闭环
- 🟦 es-center-server-services:
- 跨租户组织管理试点先形成决策地图,再完成九票实施;统一写准入、服务端 NanoID 与有效角色合同一并定型。
- 优化设备高频读取,完成缓存租户合同三批工作,把租户 scope 归属治理写入 ADR-0084。
- 架构深化按全流程推进:决策图 15 候选 → 17 票裁决(ADR-0085~0092)→ 24 张实施票发布。
- 统一分区前缀身份族五线:租户编号/邮箱/手机号/第三方账号/用户名,trigger 只消费 Java 前缀;为设备号建立全局唯一守卫。
- 完成 MQTT/Janus 修复与认证兼容、PTT 默认群组退场、Janus 转发规则合并;设备详情改用 JOIN 查询,完成分页元数据 24 票全仓迁移核销,并归档缓存合规审计。
- 月末明确设备号 HTTP 入口的跨租户投影窄例外(ADR-0097,按投影数确定索引归属);落实 MQTT/HTTP 分段响应计时合同(ADR-0098~0102),以响应时间字段替代应用慢执行日志。
- 🟩 es-center-server-web-app:
- 归档全站 i18n 呈现基线,清扫冗余,保留设备/基础列表的语言弹层。
- 远程选择器先完成三项前置修复,再以三票统一封装,随后将共享层用于全站。
- 跨租户组织与组织管理员深化走完寻路地图、grilling 候选、14 张决策票闭合与九票实施批次;完成 Excel 业务表头与归属信息导出,统一 Org 术语记录及读取合同。
- 针对性能痛点先建图取证,再完成三项隔离实施;交付初始设备巡览。useInfiniteList 提炼为通用能力,admin-1 完成首迁。
- 重复点击导航时恢复直播设备列表:采用可认领事件,保留单/多直播子路由的播放状态。
- 月末完成全仓图标语义专项:修正实体/配置/动作/状态图标,补齐图标控件本地化名称与未知电量呈现,归档全仓图标清单与审查快照。
- 🟨 es-center-server-install-app:
- 移除微服务客户端 Nacos 账号密码鉴权,推进 20260913/20260921/20260923/20260929 发布制品。
- nginx 客户端 IP 链路批次完成六票:先明确术语与规格,再由边缘清洗 X-Forwarded-For 转发头、内层原样传递客户端 IP,补齐静态回归断言与内网部署验收。
- 重构构建链路检查结论:默认本地构建,备份上传使用显式参数,凭据外置;完成 2c8g 资源预算容器优化八票实施。
- 🟪 es-ext-doc-website:
- 交付机构 App 接口文档,依次完成规划、公共基础、三域正本、独立语义复核、整合与发布门;交付零售 App 接口文档。
- 重构开发手册:决策拆票后,完成清单层/business/runtime、场景层四批迁移与接入视角两章。
- 补全 MQTT 契约(7→17),将门禁纳入常驻工具并完成全站脱敏;更新日志至 2.0.1-20260913,重写 net-body-camera api 域,完成 en 末批镜像。
- 🧩 多仓治理:
es-center-server-build完成 20260913/20260928 发布准备与上传通道调整(zxs-test 通道、main-service 收窄),月末推进 20260929 制品。es-center-server-services构建改用共享 Gradle 缓存的发行版专用副本;es-center-server-web-app基础镜像升级至 node 26.10.0 / nginx 1.30.5。es-center-server-agent录得九月首条提交,调整构建与联调路径以适配 /mnt/wsl 工作区。
- 🧭 方法论:
- 形成决策地图 → ADR 立法 → 决策票裁决 → 实施票批次的治理闭环。9 月新增 ADR 十余份,覆盖组织统一与角色合同、缓存租户合同、租户 scope 归属、架构深化裁决、openspec 目录退役,以及设备号投影窄例外与分段响应计时(ADR-0097~0102)。
- 持续落实缓存租户双态合同、连接状态有界家族快照、代次隔离、红绿先行与勘注回填(勘误注释回填进正本);批次 runner 与执行代理切换进入常态。
计量:固定九仓库合计 959 次(设计 326 · 代码 633)。
逐仓:
es-center-server-services413 次、es-center-server-web-app329 次、es-center-server-install-app107 次、es-ext-doc-website101 次、es-center-server-build8 次、es-center-server-agent1 次。
10 月(截至 2026-10-31)· 索引整改与直播深耕
- 🟦 es-center-server-services:
- 全量导出改原子发布,全量导入失败边界修复结票;导入先落主键结构前提。
- 查询索引整改全流程:存量预检演练 → 决策收口 → 实施规格与历史/快照规范发布 → 按域批量落地(厂家、目录、投影、关系、历史、审计、身份、授权、配置)。
- 群组文件与消息订单索引收口;型号索引合并重启并完成组合验收。
- 单列主键恢复、租户活动唯一索引与审计留痕交付。
- 月末批量交付:绑定唯一键验收、分表迁移与用户名前缀退役批量落地(ADR-0130 分表定案、ADR-0131/0132 DTO/ORM 规范)、datasync 第 10 票收官与快照恢复验证、角色预设配置化清退、MQTT
other/#授权(ADR-0133/0134)。 - 业务唯一索引收敛各域批量交付并完成最终组合验收(附件 HOT 例外收窄),ADR-0136 旧树地址统一补正票交付回填。
- 🟩 es-center-server-web-app:
- 修复 videoroom 控制面短断,完成真实验收与性能对照收尾。
- 直播首帧显式起播批次:ADR-0056 决策落档后七票实施并验收。
- 交付播放信息双视图与起播历史;wayfinder 寻路裁决收口。
- 对讲/直播麦克风惰性采集批次实施与核证移交。
- 构建链切 Vite 原生路径解析并收口 Oxc 压缩;刷新首屏性能构建统计产物基线。
- i18n 治理三批:维护批次十票收口、五语默认译文逐项交付、底稿主动合并批次落票、收录覆盖加固实施收口(直书形态抽取器与两层前缀规范落 §10/ADR 0061)。
- 跨租户传统管理前端逐票交付:角色只读、Role 写入与批删、组织角色分配、响应式加载、业务 DTO 树适配与个人租户过滤、厂家跨租户管理、角色配置权限只读与权限呈现一致性。
- 🟨 es-center-server-install-app:批次执行模板与升级程序维护(3 条提交)。
- 🧩 多仓:
es-center-server-build、es-center-server-agent、es-server-deploy、es-qt-tools-map、es-ext-doc-website、es-bodycam-web-ui-1各 1 条零星提交(批次执行模板、部署脚本与工单归档类);每周 git → svn 同步,10-19 完成一轮完整发布部署与多轮 BUG 根因处理。 - 🧭 方法论:
- 治理闭环延续:先决策收口、再发布实施规格、后按域批量落地;组合验收以真实数据核证。
- ADR-0056 起播决策先行、再批次实施;构建链现代化(Vite 原生路径解析 + Oxc 压缩)以归档批次收口。
- ADR 批量立法延续(ADR-0125~0136);索引收敛以「各域批量交付 → 最终组合验收 → 补正票回填」收口;i18n 三批与跨租户前端按「规格 → 决策票 → 实施批次」推进。
计量:固定九仓库合计 998 次(设计 313 · 代码 685)。
逐仓:
es-center-server-web-app530 次、es-center-server-services459 次、es-center-server-install-app3 次、es-ext-doc-website、es-center-server-build、es-center-server-agent、es-server-deploy、es-qt-tools-map、es-bodycam-web-ui-1各 1 次。
四、成就与成长
4.1 成就
旗舰 · 集群对讲: 1 人 + AI,49 天全栈交付
集群对讲把实时语音、按键发言、群组权限与房间恢复串在一起。本次由 1 人端到端承担、借助 AI 协作,完成后端与 Web 前端的全栈交付。
硬数据(已验收素材与 Git author date 核查):
| 维度 | 数据 |
|---|---|
| 开发跨度 | 2026-06-25 → 08-12,49 天(7 周) |
| 提交量 | 575 次(后端 289 + 前端 286) |
| 高峰 | 7 月单月 395 次(日均约 12.7 次) |
| 承担角色 | 1 人端到端承担:架构、审查纠偏与测试,连同需求、UI 设计及后端/前端实施 |
实现涉及的层次:
- 媒体层:由 Janus AudioBridge 音频会议插件 与 WebRTC 承载实时双向语音。
- 信令层:PTT 配置经 MQTT 下发(
device/{no}/ptt/deliver|retrieve/v1),配合 JMS 事件驱动。 - 控制层:半双工 floor control,即同一时刻只允许一人讲话,PTT 按键互斥。
- 容错层:房间生命周期三轮补偿(5 / 10 / 15 分钟),配合确定性恢复。
- 业务层:TalkGroup CRUD、设备成员关系、跨租户隔离与在线状态管理。
行业对标:通天星 CMSV9 官方产品页 列出同类的集群对讲能力,2020 年行业报道 也记录了该能力及稳定研发团队。两份资料支持“这项产品能力至少跨多年存在”的判断,无法据此确定该单项功能投入了多少人、多少时间。
通天星官网披露的 600W+ 终端连接 是公司平台总口径,并非 CMSV9 单产品数据。本次由 1 人借助 AI 协作,49 天达到可用交付;「1 人 + AI ≈ 一个团队半年」及“传统团队需半年以上”均为经验估算,不是可核查事实。
为何能这么快 · AI 四象限
我用「AI 四象限」解释集群对讲 49 天交付中的协作方式:先判断每个子任务中人知道什么、AI 知道什么,再选择加速、补充知识、审查补盲或共同探索。它使用 {人, AI} × {知, 不知} 认知矩阵:
| 象限 | 含义 | 调用策略 | 集群对讲中的实例 |
|---|---|---|---|
| ✅ 已知的已知 人会 + AI 会 | 熟练重复劳动 | AI 加速器: 批量产出 | 报表式 CRUD、群组分页、导入导出字段扩展 |
| 📋 已知的未知 人会 + AI 不会 | 人懂业务、AI 缺上下文 | 人喂知识: 顶层设计 / 规范 / 契约文档先行 | PTT 接缝契约、MQTT 缓存键规范、BUSINESS.md 业务规则、入房权限模型 |
| 🔍 未知的已知 人不会 + AI 会 | 人的盲区、AI 能补 | AI 补盲: 审查 / 能力延伸 | Janus AudioBridge 边界行为、WebRTC offer 协商、冻结审查形成的 49 张工单 |
| 🧪 未知的未知 人不会 + AI 不会 | 双方都要摸索 | 协作探索: loop / 对抗式探查 | 半双工 floor 补偿策略、房间掉房的确定性恢复路径 |
人的判断贯穿其中:在「已知的未知」里,把隐性业务知识写成契约与文档;在「未知的未知」里,决定探索方向,并为 AI 的产出兜底。判断任务属于哪个象限,也由人承担。
其他重大交付
- 跨境数据同步(1-2 月): 全量/增量同步实现闭环、79 表验证
- 报表九大模块(6 月): 设备/服务器/在线/电池/存储/上传/仪表盘 KPI 全套后端 API
- 固件管理链路(5 月): SpiritCam/PonyCam 查询/上传/流式处理/租户删除保护
- PostgreSQL 高可用: 主从复制(repmgr)+ pgpool 负载均衡
- dashboard 框架(5 月): pen2code 原型驱动建立
- 英文版文档镜像(8-9 月): 8 月 9 张票按产品域推进,9 月 net-body-camera api 域重写与 en 末批镜像收尾
- 接口文档与开发手册(9 月): 机构/零售 App 接口文档交付、开发手册重构(清单层/business/runtime、场景层四批)、MQTT 契约补全(7→17)
4.2 成长 · 方法论四阶段演进
AI 四象限解释如何针对任务选择协作策略,下面的四阶段则记录工作方法如何逐步形成。每个阶段都留下了工具载体、要解决的问题与对应实践。
阶段一 · 规格驱动(Q1)—— 把「人知的」结构化喂给 AI
- 工具载体: OpenSpec、AGENTS.md、CONTEXT.md
- 解决的问题(对应「已知的未知」): AI 缺业务上下文 → 人用规格文档把「我知道但 AI 不知道」的部分固化成可消化的契约
- 实践: 跨境数据同步以任务清单组织规格驱动实施、分层 AGENTS.md 知识库、3 月 AI 培训周普及
阶段二 · 原型驱动(Q2)—— 设计先行,代码可还原
- 工具载体: pen2code(.pen 设计稿 → React)、PDCA 多轮审查
- 解决的问题: 把「要做成什么样」从模糊脑图变成 AI 可还原的设计稿,再用多轮审查收敛缺陷
- 实践: dashboard 框架原型驱动、固件链路、多轮审查清零(P0=0)
阶段三 · 契约先行(Q2-Q3)—— 前后端靠契约锁定,而非靠口头沟通
- 工具载体: BUSINESS.md 文档先行、MQTT 缓存键/路由契约
- 解决的问题: 分布式协作中最大的不确定是「接口会变」→ 先冻结契约,再各自实现
- 实践: 三层文档同步(BUSINESS/API/README)、PTT 接缝契约固化、ICE/PTT 配置获取契约
阶段四 · 自治闭环(Q3)—— 多代理自治 + 对抗门禁
- 工具载体: Loop Engineering、冻结基线规模化审查、Matt Pocock skills、Harness
- 解决的问题(对应「未知的未知」+「未知的已知」): 复杂探索用 loop 多代理顺序推进;产出质量用对抗式冻结审查兜底
- 实践: 49 张工单的冻结审查、Loop 顺序优先执行契约、诊断驱动编排(掉房→确定性恢复);9 月延伸出「决策地图 → ADR 立法 → 决策票裁决 → 实施票批次」的规模化治理闭环
四阶段留下的共同做法是:把知识交代清楚,按任务选择协作策略,再核对结果。工具与方法的名字(OpenSpec/Superpowers/Matt Pocock/Harness/Loop)会变化,「识别象限 → 调用策略 → 兜底验证」则贯穿这些实践。
附录 · 术语表(Glossary)
| 术语 | 定义 |
|---|---|
| AI 四象限 | {人, AI} × {知, 不知} 认知矩阵。已知的已知(人会+AI 会,AI 加速)/ 已知的未知(人会+AI 不会,人喂知识)/ 未知的已知(人不会+AI 会,AI 补盲)/ 未知的未知(都不会,协作探索)。 |
| OpenSpec | 规格驱动开发工具链: 提案 → 规格 → 实施 → 归档,把人的业务意图固化成 AI 可执行的变更规格。2026-01 引入。 |
| AGENTS.md / CONTEXT.md | 分层知识库: AGENTS.md 给 agent 工作规范,当时的 CONTEXT.md 记录领域术语表(glossary),让 AI 携带正确上下文。 |
| pen2code | 原型驱动开发: Pencil 设计稿(.pen)→ React 代码的还原流程,让「设计」先于「编码」固化。2026-05 建立。 |
| Superpowers | 一套经验证的 AI 辅助开发技能集(brainstorming、test-driven-development、systematic-debugging、verification-before-completion 等)。2026-03 引入。 |
| Harness | 任务执行前的强制门禁检查(5 项): 读 README+技能 / 读 PROGRESS / 执行门禁 / 范围保护 / 局部验证+写回。确保每次执行不跑偏。 |
| Loop Engineering | 多代理协作的「顺序优先执行契约」: 复杂探索任务拆给多个代理按序推进,用执行契约约束顺序与交接。2026-08 建立。 |
| 冻结基线规模化审查 | 功能冻结后,用多轮对抗式复核对终点代码做规模化审查(集群对讲收尾审查 49 张工单),作为发布前门禁。 |
| Matt Pocock skills | Matt Pocock 的开发技能集,在项目内按仓库配置(per-repo)。2026-08 配置。 |
| RAG | 检索增强生成: 结合 Obsidian 等知识库检索,为 AI 提供项目特定的上下文,减少幻觉。 |
本页基于已验收的月度素材与多仓库 Git 记录,按真实提交日期重算;早期讨论与勘误留档仅保留当时背景。Q3 已闭合、Q4 进行中(截至 2026-10-31)。