|
| 1 | +# wxa-skills-validate 校验报告 |
| 2 | + |
| 3 | +**项目**:Senparc.Weixin.WxOpen.AppDemo |
| 4 | +**校验时间**:2026-06-09(第 2 次重跑) |
| 5 | +**Skill 分包**:`skills/senparc-login-ws` |
| 6 | +**AppID**:`wx12b4f63276b14d4c` |
| 7 | + |
| 8 | +--- |
| 9 | + |
| 10 | +## 阶段 1 — 静态校验 + 编译校验 |
| 11 | + |
| 12 | +| 项 | 结果 | |
| 13 | +|---|---| |
| 14 | +| 静态规则 (V001~V016) | ✅ **通过** — 141/141,0 errors,0 warnings | |
| 15 | +| 编译校验 (cli preview) | ❌ **失败** — IDE 服务端口未开启 | |
| 16 | + |
| 17 | +### 静态规则明细 |
| 18 | + |
| 19 | +``` |
| 20 | +V001:36 V002:4 V003:16 V005:40 V006:24 V007:1 V008:1 |
| 21 | +V009:4 V011:4 V012:4 V013:1 V014:1 V015:4 V016:1 |
| 22 | +``` |
| 23 | + |
| 24 | +报告文件:`cli-agent-run/validate-report.json` |
| 25 | + |
| 26 | +### 编译失败原因 |
| 27 | + |
| 28 | +``` |
| 29 | +IDE service port disabled. |
| 30 | +工具的服务端口已关闭。要使用命令行调用工具,请手动打开工具 -> 设置 -> 安全设置,将服务端口开启。 |
| 31 | +``` |
| 32 | + |
| 33 | +**本机配置确认**(微信开发者工具 `WeappLocalData`): |
| 34 | + |
| 35 | +```json |
| 36 | +"security": { "enableServicePort": false, "port": null } |
| 37 | +``` |
| 38 | + |
| 39 | +服务端口仍为关闭状态,CLI 所有命令(`islogin` / `preview` / `agent`)均无法初始化。 |
| 40 | + |
| 41 | +--- |
| 42 | + |
| 43 | +## 阶段 2 — CLI 准备 |
| 44 | + |
| 45 | +| 项 | 结果 | |
| 46 | +|---|---| |
| 47 | +| CLI 可执行 | ✅ `/Applications/wechatwebdevtools.app/Contents/MacOS/cli -h` 正常 | |
| 48 | +| 服务端口 | ❌ 未开启,阻塞后续所有 CLI 调用 | |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +## 阶段 3 — 执行计划 |
| 53 | + |
| 54 | +按依赖顺序排列的原子接口: |
| 55 | + |
| 56 | +| 顺序 | 接口 | 组件 | 入参来源 | |
| 57 | +|------|------|------|---------| |
| 58 | +| 1 | `performLogin` | login-status-card | 无参 | |
| 59 | +| 2 | `connectWebSocket` | connection-status-card | 可选 `hubPath` | |
| 60 | +| 3 | `sendWebSocketMessage` | send-result-card | `message`(必填) | |
| 61 | +| 4 | `getWebSocketMessages` | message-list-card | 可选 `limit` | |
| 62 | + |
| 63 | +--- |
| 64 | + |
| 65 | +## 阶段 4 — execute / render |
| 66 | + |
| 67 | +| 接口 | execute | render | 备注 | |
| 68 | +|------|---------|--------|------| |
| 69 | +| performLogin | ⏸ 阻塞 | ⏸ 阻塞 | CLI 服务端口未开启 | |
| 70 | +| connectWebSocket | ⏸ 阻塞 | ⏸ 阻塞 | 同上 | |
| 71 | +| sendWebSocketMessage | ⏸ 阻塞 | ⏸ 阻塞 | 同上 | |
| 72 | +| getWebSocketMessages | ⏸ 阻塞 | ⏸ 阻塞 | 同上 | |
| 73 | + |
| 74 | +--- |
| 75 | + |
| 76 | +## 阶段 5 — 交付 |
| 77 | + |
| 78 | +❌ **未完成** — 真机闭环未执行,无法生成 `DELIVERY.md`。 |
| 79 | + |
| 80 | +--- |
| 81 | + |
| 82 | +## 解除阻塞后重跑命令 |
| 83 | + |
| 84 | +### 1. 开启服务端口 |
| 85 | + |
| 86 | +打开微信开发者工具 → **设置** → **安全设置** → 开启 **服务端口**。 |
| 87 | + |
| 88 | +### 2. 重新校验 |
| 89 | + |
| 90 | +```bash |
| 91 | +cd /Volumes/DevelopAndData/SenparcProjects/WeiXinMPSDK/src/Senparc.Weixin.WxOpen/src/Senparc.Weixin.WxOpen.AppDemo |
| 92 | + |
| 93 | +# 静态 + 编译 |
| 94 | +node .cursor/skills/wxa-skills-validate/scripts/validate.mjs . |
| 95 | + |
| 96 | +# 逐个 execute |
| 97 | +node .cursor/skills/wxa-skills-validate/scripts/execute.mjs \ |
| 98 | + --project . --name performLogin \ |
| 99 | + --output ./cli-agent-run/execute-result.performLogin.json |
| 100 | + |
| 101 | +node .cursor/skills/wxa-skills-validate/scripts/execute.mjs \ |
| 102 | + --project . --name connectWebSocket \ |
| 103 | + --output ./cli-agent-run/execute-result.connectWebSocket.json |
| 104 | + |
| 105 | +node .cursor/skills/wxa-skills-validate/scripts/execute.mjs \ |
| 106 | + --project . --name sendWebSocketMessage \ |
| 107 | + --args '{"message":"TEST"}' \ |
| 108 | + --output ./cli-agent-run/execute-result.sendWebSocketMessage.json |
| 109 | + |
| 110 | +node .cursor/skills/wxa-skills-validate/scripts/execute.mjs \ |
| 111 | + --project . --name getWebSocketMessages \ |
| 112 | + --args '{"limit":10}' \ |
| 113 | + --output ./cli-agent-run/execute-result.getWebSocketMessages.json |
| 114 | + |
| 115 | +# 逐个 render(从 execute 产物继承) |
| 116 | +node .cursor/skills/wxa-skills-validate/scripts/render.mjs \ |
| 117 | + --project . \ |
| 118 | + --from-execute ./cli-agent-run/execute-result.performLogin.json \ |
| 119 | + --output ./cli-agent-run/render-result.performLogin.json |
| 120 | +# ... 对其余 3 个接口重复 |
| 121 | +``` |
| 122 | + |
| 123 | +--- |
| 124 | + |
| 125 | +## 总结 |
| 126 | + |
| 127 | +- **代码静态质量**:✅ 全部通过,skill 产物结构合规 |
| 128 | +- **编译与真机**:❌ 被环境阻塞(微信开发者工具服务端口未开启) |
| 129 | +- **建议**:在开发者工具中开启服务端口后,重新执行 `@wxa-skills-validate 校验 ./skills 目录` |
0 commit comments