Neo
2a7a5d68aa
主线 1: rns1-customer-coach-api + 04-miniapp-core-business 后端实施
- 新增 GET /xcx/coaches/{id}/banner 轻量接口
- performance/records 加 coach_id 参数 + view_board_coach 权限分流
- coach/customer/performance/board/task 服务层重构
- fdw_queries 结算单粒度聚合 + consumption_summary 视图统一
- task_generator 回访宽限 72h + UPSERT 替代策略 + Step 5 保底清理
- recall_detector settle_type=3 双重限制 + 门店级 resolved
主线 2: 小程序权限分流 + 新增 coach-service-records 管理者视角业绩明细页
- perf-progress 共享模块去重 task-list/coach-detail 动画逻辑
- isScattered 散客标记端到端
- foodDetail/phoneFull/creator* 字段透传
主线 3: P19 指数回测框架 Phase 1+2
- 3 个指数表 stat_date 日快照模式
- 新增 DWS_INDEX_BACKFILL / DWS_TASK_SIMULATION 工具任务
- task_engine 升级 HTTP 实时 + 推演回测双模式
主线 4: Core 维度层启用
- 新增 CORE_DIM_SYNC 任务（DWD → core 4 维度表）
- 修复 app 视图空查询问题
主线 5: member_project_tag 改为 LAST_30_VISITS 消费次数窗口
主线 6: 2 个迁移 SQL 已执行（stat_date + member_project_tag 新窗口）
- schema 基线与 DDL 快照同步
主线 7: 开发机路径迁移 C:\NeoZQYY → C:\Project\NeoZQYY（约 95% 改动量）
附带: 新建运维脚本（churned_customer_report / simulate_historical_tasks /
backfill_index_snapshots）+ tools/task-analysis/ 任务分析工具
合计 157 文件。未包含中间产物（tmp/ .playwright-mcp/ inspect-* excel/sheet 分析 txt）。
审计记录见下一个 commit。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
74 lines
2.2 KiB
Markdown
74 lines
2.2 KiB
Markdown
# 微信开发者工具 MCP 连接指南
|
||
|
||
## 概述
|
||
|
||
`weixin-devtools-mcp` 用于通过 MCP 协议控制微信开发者工具，支持页面导航、截图、元素操作、JS 执行等自动化功能。
|
||
|
||
## 环境信息
|
||
|
||
| 项目 | 值 |
|
||
|------|-----|
|
||
| 开发者工具路径 | `C:\dev\WechatDevtools\微信开发者工具.exe` |
|
||
| CLI 路径 | `C:\dev\WechatDevtools\cli.bat` |
|
||
| 小程序项目路径 | `C:\Project\NeoZQYY\apps\miniprogram` |
|
||
| 自动化端口 | `9420`（固定） |
|
||
| AppID | `wx7c07793d82732921` |
|
||
|
||
## 连接步骤（必须按顺序执行）
|
||
|
||
### 第 1 步：确保开发者工具已登录
|
||
|
||
打开微信开发者工具，确认已扫码登录。未登录会报 `Error: 需要重新登录 (code 10)`。
|
||
|
||
### 第 2 步：在终端启动自动化端口
|
||
|
||
```powershell
|
||
& "C:\dev\WechatDevtools\cli.bat" auto --project "C:\Project\NeoZQYY\apps\miniprogram" --auto-port 9420
|
||
```
|
||
|
||
成功输出：
|
||
```
|
||
√ IDE server has started, listening on http://127.0.0.1:XXXXX
|
||
√ Using AppID: wx7c07793d82732921
|
||
√ auto
|
||
```
|
||
|
||
### 第 3 步：MCP 连接
|
||
|
||
使用 `connect_devtools` 工具，策略必须为 `wsEndpoint`：
|
||
|
||
```
|
||
strategy: wsEndpoint
|
||
wsEndpoint: ws://127.0.0.1:9420
|
||
projectPath: C:\Project\NeoZQYY\apps\miniprogram
|
||
healthCheck: true
|
||
```
|
||
|
||
## 踩坑记录
|
||
|
||
### 禁止使用 `connect` / `discover` / `auto` 策略
|
||
|
||
这些策略会内部 spawn CLI 进程，导致微信开发者工具被重启。只能用 `wsEndpoint` 策略连接已有的自动化端口。
|
||
|
||
### `spawn EINVAL` 错误
|
||
|
||
原因：MCP 内部 spawn 子进程时路径无效（中文路径 + 非标准安装位置）。解决方案就是不让 MCP spawn，改用手动启动 + wsEndpoint 连接。
|
||
|
||
### MCP 配置中的环境变量
|
||
|
||
`mcp.json` 中已配置 `WECHAT_DEVTOOLS_CLI` 和 `WECHAT_DEVTOOLS_PROJECT` 环境变量，但这些仅供 MCP server 内部参考，不能替代手动启动自动化端口。
|
||
|
||
## MCP 配置参考
|
||
|
||
```jsonc
|
||
// .kiro/settings/mcp.json
|
||
"weixin-devtools-mcp": {
|
||
"command": "npx",
|
||
"args": ["-y", "weixin-devtools-mcp", "--tools-profile=full", "--ws-endpoint=ws://127.0.0.1:9420"],
|
||
"env": {
|
||
"WECHAT_DEVTOOLS_CLI": "C:\\dev\\WechatDevtools\\cli.bat",
|
||
"WECHAT_DEVTOOLS_PROJECT": "C:\\Project\\NeoZQYY\\apps\\miniprogram"
|
||
}
|
||
}
|
||
```
|