2026年05月04日

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

中心服务平台 - 功能完善

进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已测试
- 以往已完成的工作不再重复，详情请查看上周及上月报告
- 〔工作量〕services 3 次（设计 1 · 代码 2）· 代码 +0.2k ｜ web-app 67 次（设计 15 · 代码 52）· 代码 +4.3k/-2.6k ｜ install-app 0 次
- 〔方法论〕原型设计驱动（.pen 设计稿 → 前端代码）｜提炼-验证-遗忘工具循环｜提示词由固定步骤式改目标驱动式｜编排脚本状态跟踪与选择跳转
- 5-04 ~ 5-05：dashboard 优化方法论重塑与首个仪表盘品质打磨
  - 🟡 dashboard 优化方法论与提示词体系〔web-app〕
    - 设计 将 pen 优化提示词由固定步骤式重构为目标驱动式；持续沉淀 dashboard optimization skill 文档与设计文件
    - 设计 围绕「同屏统览、因果并呈、结论速达、快捷处置」的业务聚焦，下钻报表首页及子页面原型设计
  - ✅ dashboard-1 仪表盘品质打磨〔web-app〕
    - 实施（AI 辅助）优化 dashboard-1 仪表盘品质：修复 donut 饼图错位、消除斑马纹、沉淀设计规则
    - 排障（AI 辅助） rebase 后重新修复 donutFg x 坐标归零（6 处被远端覆盖）
    - 设计 记录 Donut 定位诊断结论：layout/positioning 不可通过代码修复
- 5-06 ~ 5-07：pen→code 工具链搭建与 dashboard 设计验证
  - ✅ pen→code 工具链与 skill 〔web-app〕
    - 实施（AI 辅助）创建 pen_toolkit.py 工具库，从 39 个归档脚本提炼通用操作
    - 设计 建立「提炼-验证-遗忘」循环机制并写入 README
    - 设计 初始化 pen2code skill（.pen → React 代码映射规则、页面规则、JOURNAL）
    - 设计 编写 Dashboard .pen 转 React 代码设计文档
  - 🟡 dashboard 设计验证与设计稿迭代〔web-app〕
    - 设计 资源排名、服务器详情、告警详情页设计验证与优化修复
    - 设计 dashboard 系列设计稿迭代（dashboard-1-server-1、warning-2 等）并清理旧截图
    - 实施（AI 辅助）精简 pen 截图导出 prompt；新增截图与 AI 工具缓存
  - ✅ 任务编排脚本 run.sh 重构〔web-app〕
    - 重构（AI 辅助） run.sh 增加步骤回退、步骤状态跟踪与选择跳转，并简化交互菜单
- 5-08 ~ 5-09：agent skills 与 mock 数据收尾 · PonyCam API
  - ✅ agent skills 与 mock 数据〔web-app〕
    - 实施（AI 辅助）批量更新 agent skills 及 AI 文档；补 dashboard 设计文档与 mock 数据
  - ✅ PonyCam API：设备分享校验与错误响应国际化〔services〕
    - 实施（AI 辅助）设备分享数量限制校验（可配置，暂定 10）及 targetUsername 自动识别邮箱/手机号
    - 实施（AI 辅助） API 错误响应国际化（i18n localizedError）
    - 设计 添加 AI prompt 文档

其它工作

目标: 记录日常杂项工作、协作沟通等事务
进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已测试
- 📌 以往已完成工作不再重复，详情请查看上周及上月报告
- 06 日
  - ✅ git → svn 源代码同步
- 08 日
  - ✅ 接口改进测试通过后，先制作新版本升级程序，同步上传至 zxs-cs 与 zxs 服务器；在 zxs-cs 环境验证升级程序运行正常后，通知王工完成 zxs 服务器的升级操作。
- 09 日
  - 郭工反馈问题处理
    - ✅ PonyCam api 需求：排查分享失败的问题——18173039499 guodi1991、我设备共享的时候 13265528013 提示用户不存在，但用户名 aednzw 又可以，看下什么情况呢：手机端做了传参简化处理，仅传递目标用户名参数。API 需先判断目标用户名的格式，识别其为手机号还是邮箱，随后将用户名字段置空，根据识别结果给对应属性字段赋值手机号或邮箱内容。该处理逻辑会在原有判断流程之前执行。
    - ✅ PonyCam api 需求：分享限制暂定 10 个（非固定值，可配置化），API 分享接口需增加校验逻辑。
    - ✅ PonyCam api 需求：获取某些设备最新固件信息时，系统返回 “No firmware package is maintained”。经排查确认：未给设备配置设备型号。
    - ✅ PonyCam api 需求：所有 API 接口需实现国际化适配——当客户端请求参数中指定了对应国际化国家/地区时，接口返回结果中将新增独立字段返回对应语种的错误提示内容。原有错误码、默认错误信息字段完全保留，避免影响历史版本程序的业务逻辑。

备忘

郭工反馈的：
- PonyCam api 需求：微信登录，接入微信官方接口，提供授权信息标识
- PonyCam api 需求：用户头像上传接口开发，头像地址应包含在当前用户信息和被分享者信息中
- SpiritCam api 需求：开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息。本接口关联固件维护类需求，例如前端上传界面开发、上传功能开发等。
- SpiritCam api 需求：加两个协议网页