Neo-ZQYY/_DEL/miniprogram-dev/README.md

小程序前端页面开发与原型迁移指南

操作文档已迁移至 Kiro Power miniprogram-h5-conversion，通过关键词自动激活。 本目录仅保留实时更新的仓库驻留文件（进度、经验、页面结构等）。

---

Power 使用方式

操作文档（调度手册、子代理手册、转换规则、WXSS 规范、CSS 风险清单、Power 集成指南）已打包为 Kiro Power：

• Power 名称：miniprogram-h5-conversion
• 激活方式：对话中提及"小程序页面"、"H5转换"、"wxml"、"wxss"、"rpx"等关键词时自动激活
• 手动激活：kiroPowers action="activate" powerName="miniprogram-h5-conversion"
• 查看 steering 列表：激活后在返回的 steeringFiles 中选择需要的文件

Power 包含 12 个 steering 文件，按职能分三层：

层	文件	说明
调度层	batch-auto.md	89 单元批量编排
调度层	user-guided.md	半自动模式
调度层	new-page.md	新页面开发
行动层	screenshot.md	截图代理手册
行动层	audit.md	审计代理手册
行动层	fix.md	修正代理手册
行动层	verify.md	验证代理手册
行动层	page-dev.md	页面开发代理手册
参考层	conversion-rules.md	核心转换规则
参考层	wxss-rules.md	WXSS 标准值速查
参考层	css-risk.md	CSS 风险特性清单
参考层	power-integration.md	Power 调用规范

---

仓库驻留文件（实时更新，不在 Power 内）

docs/miniprogram-dev/
├── README.md                          ← 你在这里
├── 03-reference/
│   ├── page-structure-map.md          # 各页面特殊结构速查（新增页面时更新）
│   └── benchmark-history.md           # 基准测试历史记录
├── 04-audit/
│   ├── PROGRESS.md                    # 89 单元迁移进度（每次会话必读）
│   └── CHANGELOG.md                   # 文档体系版本变更
└── 05-lessons/
    ├── pitfalls.md                    # 踩坑速查（实战经验，持续更新）
    └── convergence-patterns.md        # 收敛模式 + 不可消除差异白名单

---

Power 依赖清单

Power	用途
wechat-miniprogram	小程序开发规范（WXML/WXSS/API/TDesign）
pixel-audit	像素间距测量 + rpx 换算
playwright	H5 端截图
weixin-devtools	MP 端截图 + 页面操作

---

关联资源

资源	路径
H5 原型页面	docs/h5_ui/pages/*.html
设计 Token	docs/h5_ui/design-tokens.json
图标映射表	docs/h5_ui/icon-mapping.md
截图产物	docs/h5_ui/compare/<page>/
小程序源码	apps/miniprogram/miniprogram/pages/
辅助脚本	scripts/ops/measure_gaps.py、scripts/ops/anchor_compare.py