Skip to Content
工作周报2026 年度总结2026年05月11日

2026年05月11日

内容截止日: 2026年05月17日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 11 次（设计 3 · 代码 8）· 代码 +0.6k ｜ es-center-server-web-app 41 次 · 代码 +21.5k/-15.2k ｜ es-center-server-install-app 2 次 · 代码 +0.1k/-0.1k ｜ es-center-server-build 1 次
    • 〔方法论〕原型驱动·pen2code 代码还原 ｜ 组件抽取与设计令牌统一 ｜ 固件二进制头解析与流式上传
    • 5-11 ~ 5-12: 报表首页与公共组件
      • ✅ 报表首页和布局路由建立，公共组件开始复用 〔es-center-server-web-app〕
        • 实施 dashboard 布局（layout）路由搭好，apple-app-site-association（Apple 通用链接校验文件）的路径随之迁移；filter-bar 筛选条组件新增，路径偏差一并修正
        • 实施 dashboard 首页（_index）落地：KPI 卡片（关键指标）加 InsightBar 洞察栏撑起主视图，trend-chart 趋势图、alert-ranking 告警排名、resource-ranking 资源排名组件一并新增
        • 实施 KPI 卡片排序对齐 .pen（Pencil 原型设计稿）设计，单卡详情文案补齐；排序调整暴露出 buildDetailText 取错卡片索引的问题，已修正
        • 重构 kpi-card 的 COLOR_CONFIG 抽成独立 cva（样式变体方案）变体；dashboard 共享组件统一改用 cva+cn（样式变体与样式组合工具），CSS 缩进修正
        • 实施 _shared 公共类型与组件（freshness-bar / section-header / color-utils / constants）提取成公共层，子页面直接复用；子页面 mock（模拟）数据完成
        • 实施 spirit-cam 法律页面（terms 使用条款 / privacy 隐私政策）新增
        • 审查 pen2code 流程增加找 BUG 自查环节。
        • 测试 补充 Step 06 重跑验证记录；首页各状态截图随调整保存。
    • 5-13 ~ 5-14: 设备详情与样式整理
      • ✅ 设备详情页新增，首页交互与样式完成调整 〔es-center-server-web-app〕
        • 实施 dashboard 组件逐项改进——shadcn（React 组件库）预设优先、filter-bar 重构、数据映射修复，细节同步打磨
        • 设计 隐私政策内容同步更新
        • 实施 device detail 设备详情页补上；pen2code skill 同步打磨
        • 实施 shadow-card-hover 卡片悬停效果加上，鼠标移入卡片有阴影反馈
        • 实施 filter-bar 卡片间距丢失的问题修复——ToggleGroup 重构时把 gap 弄丢了，补了回来
        • 重构 cva 改为 Record 键值映射，kpi-card / insight-bar / section-header 三处各减一层样式抽象
        • 重构 dashboard 的 hooks 改用 ahooks（React 常用钩子库）重写；trend-chart 的 Y 轴加宽；deviceCounts 指标换成 uploadVolume（上传量）
        • 重构 FreshnessBar 提取为公共组件，TrendChart 布局与导航单位精修；resource-ranking 的 ButtonGroup 换成 ToggleGroup
    • 5-15 ~ 5-17: 报表子页面与设计令牌
      • ✅ 在线 / 资源 / 告警页面新增，共享结构和样式统一 〔es-center-server-web-app〕
        • 实施 online 在线页面（server / device 两类）、server 服务器页面与 resource / warning 资源 / 告警页面相继新增，online 路由同步重构；设备分页问题修复
        • 实施 dashboard 表格卡片间距、summaryRow 内边距与图标细节逐项修正
        • 重构 TimeRangePicker（时间范围选择器）与 online-utils 提取为公共组件，常量合并；设备 insight 索引错误修复；固定列宽改用 whitespace-nowrap（不换行）
        • 重构 TabShell 组件提取出来，dashboard 各 tab 页路由借它简化
        • 重构 Tailwind 任意值统一换成标准设计令牌（统一的颜色、间距规范值）；KpiCardChart 类型收紧
        • 重构 样式收尾清理：constants.ts 的 import 统一置顶、无用代码（dead code）清掉、Download 图标尺寸统一
    • 5-11 ~ 5-15: 固件管理与接口说明
      • ✅ SpiritCam 固件管理主体完成，查询和上传方式调整 〔es-center-server-services〕
        • 设计 固件（设备内置程序）查询与设备型号 ID 跨租户同步值不值得做，分析给出结论：同一设备在各租户的投影共享型号后可改善固件查询；同时记录部分更新置空、字符串版本排序、跨租户首条命中顺序三项风险
        • 设计 V1 数据采集设备 API 文档写好
        • 设计 API 国际化错误响应文档（i18n localizedError）补上
        • 实施 SpiritCam 固件管理功能主体落地——FirmwarePackage 实体 / Mapper / Service、固件二进制头解析一应俱全，租户删除保护一并加上；固件头按 152 字节 little-endian 格式解析，管理上传校验 bin/img、保存头信息并按版本查询
        • 实施 固件查询函数 GetFirmwareFunction 调整为遍历同设备号的全部租户投影，跳过无型号记录，继续寻找维护了固件包的租户
        • 实施 翻译缺失键自动入队回填：缺失发生时先返回 key 兜底，客户端不再看到空白文案
        • 实施 设备消息监听器现在会同步更新 deviceModelId（设备型号）字段
        • 重构 固件上传改为流式处理（边读边写，不整包载入内存），大固件上传的内存峰值随之降下来
        • 重构 设备分享状态的魔法字符串提取为常量 DeviceShareService.STATE_CONFIRM_SHARE，计数限制与状态流转共用同一个值
        • 实施 admin 用户拿到 spirit-cam-manage 租户权限；default 租户类型修正为 system
        • 实施 修复 gradle wrapper（构建工具版本锁定配置）：下载源切换为可用镜像，依赖恢复正常拉取
    • 5-11 ~ 5-13: 安装包与通用链接发布
      • ✅ 升级程序配置与本周发布物同步 〔es-center-server-install-app〕
        • 实施 升级程序打包脚本与配置（build_package.sh / .env.upgrade / INIT.md / BUILD_README.md）就位；主服务、设备服务、Web App 镜像和全部目标安装/升级入口同步 05-11 与 05-13 发布物。
        • 实施 Nginx 增加 Apple App Site Association 直出规则，关闭资源压缩与缓存并绕过前端路由。
      • ✅ Universal Links（App 通用链接）发布检查与静态产物复制补齐 〔es-center-server-build〕
        • 实施 同步 Web/后端发布物，增加容器检查、HTTP 探测、.well-known 目录复制和 Nginx 重启步骤；Web Dockerfile 使用目录尾斜杠复制静态产物，保留隐藏目录重命名实验入口。
    • 5-16 ~ 5-17: 原型工具实验记录
      • ✅ Evolver / GEP（Agent 自动演化试验及其基因、胶囊资产）随报表工作更新与清理 〔es-center-server-web-app〕
        • 实施 保存进化记忆和候选基因运行产物，随后清理部分记录；技能、mock 和生成引用文件随页面调整同步。
        • 设计 提示词随页面调整同步。

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
    • 11 日
      • ✅ git → svn 源代码同步
      • 郭工反馈:
        • ✅ SpiritCam api 需求: 新增两个协议网页
        • ✅ PonyCam api 需求: 配置 .well-known/apple-app-site-association
    • 12 日
      • ✅ 制作新版本升级程序，同步上传至 zxs-cs 与 zxs 服务器；在 zxs-cs 环境验证升级程序运行正常后，通知王工完成 zxs 服务器的升级操作
      • 郭工反馈:
        • 🟡 SpiritCam api 需求（10%）: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息；本接口关联固件维护类需求（如前端上传界面、上传功能开发等）
    • 13 日
      • 郭工反馈:
        • ✅ PonyCam api 需求: MQTT 接口获取某些设备最新固件信息时，系统返回 “No firmware package is maintained”——又复现了，需从根源上解决
        • ✅ SpiritCam api 需求: 协议内容排版——主标题加粗居中、更新日期与生效日期改为当天、段落换行处理、所有段落开头空两个汉字
        • 🟡 SpiritCam api 需求（15%）: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息；本接口关联固件维护类需求（如前端上传界面、上传功能开发等）
      • ✅ 制作新版本升级程序，同步上传至 zxs-cs 与 zxs 服务器；在 zxs-cs 环境验证升级程序运行正常后，通知王工完成 zxs 服务器的升级操作
    • 14 日
      • 🟡 SpiritCam api 需求（25%）: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息；本接口关联固件维护类需求（如前端上传界面、上传功能开发等）
      • ✅ 制作新版本升级程序，同步上传至 zxs-cs 与 zxs 服务器；在 zxs-cs 环境验证升级程序运行正常后，通知王工完成 zxs 服务器的升级操作
    • 15 日
      • 🟡 SpiritCam api 需求（30%）: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息；本接口关联固件维护类需求（如前端上传界面、上传功能开发等）
      • ✅ 制作新版本升级程序，同步上传至 zxs-cs 与 zxs 服务器；在 zxs-cs 环境验证升级程序运行正常后，通知王工完成 zxs 服务器的升级操作

备忘

  • 升级程序部署（通知王工）: zxs 服务器已上传 /tmp/es-center-server-upgrade-app-2.0.1-cn-1-202605121005.tar.gz；zxs-cs 已完成部署
  • apple-app-site-association 验证: curl https://zxs-cs.netbodycamera.com/.well-known/apple-app-site-association，返回 appID 9G88G5LM72.com.szest.ponycam、paths ["/wechat/*"]
  • SpiritCam 协议页面（zxs-cs）: 使用条款 / 隐私政策（en、zh-CN），经 v2/markdown-view.html?url=... 渲染
  • 设计推演（与 AI 协作）:
    • 指标用百分比呈现比数字更直观，免去心算
    • 直接扫描目录下数字开头的文件取代读取文件名列表，更省事；扫描动作不止开头执行，过程中也要执行（后续可能追加文件）
    • 现有实现按多个场景推演是否有 bug，并考虑能否简化
    • preview 不必打印文件内容，文件名命名有意义即可直观了解，可简化
Last updated on
2026年05月04日2026年05月18日