Skip to Content
工作周报2026 年度总结2026年03月16日

2026年03月16日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕services 13 次（设计 5 · 代码 8）｜ web-app 57 次（设计 8 · 代码 49）· 代码 +5.6k/-2.4k ｜ install-app 2 次
    • 〔方法论〕AI 数字员工协同编排（openspec 文档 → 拆解任务 → 逐个执行 → 多轮 AI 审核 → 人工审核 → 改进优化）｜ 设计先行·规格固化（组件 proposal/design/spec 先于代码落地）｜ 多轮联调修复收敛 ｜ 参考既有实现（qt-tools）
    • 3-16 ~ 3-17: GPS 轨迹可视化组件规格设计与基础层落地
      • ✅ GPS 轨迹可视化可复用组件: 规格设计与基础层落地 〔web-app〕
        • 设计 搭建组件 OpenSpec 变更骨架，编写设计文档（proposal/design）；支持多设备轨迹显示与样式自定义，后简化为单设备、改用 mitt 事件通信
        • 设计 补充 spec: 斑马线效果、图层管理、坐标系自动切换、错误处理、性能优化、生命周期管理、坐标转换与国际化支持
        • 设计 将 spec 重构为模块化结构（按 overview/types/nmea-parser 等分模块）；更新注释规范，强调注释应解释原因而非描述操作
        • 实施（AI 辅助） 落地基础层: types、constants、nmea-parser（NMEA 协议解析）、popup-template 工具函数
        • 实施（AI 辅助） 实现 useGpsData、useMapInit、use-fly-to、use-trajectory-full、use-trajectory-playback 等 hook，完成 Phase 2-4
        • 协作 参考 qt-tools 既有 GPS 轨迹实现，补充其开发指南并修复起点图标弹窗（显示末位 GPS 轨迹信息）
    • 3-18: GPS 轨迹可视化组件完成、Demo 页与多轮联调修复
      • ✅ GPS 轨迹可视化可复用组件: 组件完成、Demo 页与多轮联调修复 〔web-app〕
        • 实施（AI 辅助） 完成组件开发，新增 playback-demo 演示页面（用于测试及供同事参考代码、了解调用方式）
        • 排障（AI 辅助） 多轮修复: 地图瓦片显示不全、飞行动画队列错乱、地图类型切换时图片显示不全（reInit 机制）、中心点跟随、终点图标显示与动画流畅度
        • 实施（AI 辅助） 合并“设置轨迹”与“清除轨迹”为单一按钮，低 zoom 级别增大斑马线间隔；优化地图供应商选择业务逻辑与国际化
        • 重构（AI 辅助） 提取 createBaseTrajectoryLine 公共函数消除重复；封装地图 key 机制到组件内部简化使用；优化注释结构；以 useBoolean 简化 demo 页状态管理
        • 审查 对组件完整代码依次进行多轮 AI 审核 → 人工审核 → 改进优化
    • 3-19: 部署脚本、环境配置与项目 Wiki
      • ✅ 部署脚本、环境配置与项目 Wiki 〔install-app / services / web-app〕
        • 实施 引入构建配置 build.conf，归档“构建脚本 shell 兼容性修复”变更；迭代 zxs-cs/zxs 环境部署脚本
        • 实施 更新本地开发环境（.dev.env）与 nacos 配置片段，配合 zxs-cs 服务器迁移联调
        • 实施 新增项目级 Wiki 文档（repo-wiki: README、code-conventions、components 等）
    • 3-20 ~ 3-22: BeanUtils 空校验、账号注销 PRD、AI 工具链与 GPS 联调收尾
      • ✅ BeanUtils 空校验修复: OpenSpec 变更与落地 〔services〕
        • 设计 建立 fix-beanutils-null-check OpenSpec 变更（proposal/design/specs/tasks）
        • 实施（AI 辅助） 为 BeanUtils.copyProperties 调用添加非空校验（跨多个 Service/实体）
        • 审查 修复代码审查发现的缺陷并清理冗余代码
      • ✅ 账号注销: PRD 需求文档起步 〔services〕
        • 设计 编写账号注销（deactivate-account）PRD 需求文档，由 delete-account 重命名为 deactivate-account，迭代多版本 e-prd 演进稿
      • ✅ AI 工具链完善 〔services〕
        • 实施 引入 GitHub Copilot 技能库；重构技能系统，移除过时技能并新增后端开发技能支持
      • ✅ GPS 组件联调收尾与项目规范 〔web-app〕
        • 实施（AI 辅助） 修复地图初始化位置优先级及代码质量问题；重构 demo 页删除冗余语言切换监听、简化 mapViewType 计算逻辑
        • 设计 更新代码审查 agents 配置与流程，完善项目规范文档
      • 🟡 整理后续待开发任务列表（部分完成）

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 16 日
      • ✅ 调优 opencode 及 continue 所用到的模型配置
    • 17 日
      • ✅ 调优 opencode 智能体配置
    • 18 日
      • ✅ 整理最新的 AI 开发资料并分享给同事
    • 19 日
      • ✅ zxs-cs 服务器即将到期，迁移至新购的腾讯云服务器（43.133.186.162）
      • ✅ 新部署的 zxs-cs 与 zxs-ca 服务器联调，调整 nacos 配置
      • ✅ 从深圳带回的一体式采集服务器，安装调试并投入使用
      • ✅ 办公室内两台小主机重装 Linux 系统，部署免费 MCP 服务，为 AI 开发提供便利
    • 20 日
      • ✅ 根据绍工反馈，联调并优化 GPS 轨迹可视化组件及 Demo 页面
        • 解决 UI 异步化问题: 为避免地图未初始化完成就发送轨迹数据导致无法绘制，发送前增加 1 秒延时，确保地图初始化完成
        • 优化 Demo 页面: 地图类型选择改为受配置控制，便于按需显示特定地图类型（部分客户仅需 Google 地图）
        • 解决 getById 接口报错: zxs-ca 会自动同步 zxs-cs 的数据，在 zxs-ca 手动添加数据后 getById 报错，原因是数据已被同步覆盖；需在代码中返回具体业务异常以便定位（已梳理出一百多处待修复点，逐步处理）
      • ✅ 王工测试反馈的问题排查与处理
        • 新部署的 zxs-cs 存在登录闪退，重启服务后恢复，需进一步排查根因
Last updated on
2026年03月09日2026年03月23日