75 lines
2.9 KiB
Markdown
75 lines
2.9 KiB
Markdown
# 小程序前端页面开发与原型迁移指南
|
||
|
||
> 操作文档已迁移至 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` |
|