- 后端 smart_locate_service：语义解析优先路径 + 反向生成 semantic + 模式步骤锚点值作 text + 反向生成经执行期 resolve_step 校验（row_checkbox→row 降级）+ 动态值 CTX 化 + 全候选点击链
- routers/smart_locate：SmartLocateResult 增加 semantic/verify
- keyword_matcher：find_element_by_semantic 兜底 return None, []
- page_url_mapping：注册会议列表 scope
- 前端：batchLocate 回填 semantic/verify
- 单测 37 用例 + E2E 连跑两次 7/7 全绿 + PRD/执行计划文档
Co-Authored-By: Claude <noreply@anthropic.com>

- AssertionEngine 新增 body_not_contains 断言（数据自清理"无残留"校验，expected 空视为失败防假通过）
- _do_api_call 新增 _inject_session_auth：目标为被测系统且未显式指定鉴权头时，
  自动从浏览器 localStorage.meet_token 注入 authorization，复用主流程登录态
- 修复 finally/on_failure 步骤主流程双跑：主循环加守卫推迟到后置块单次执行
- 示范用例 finally 步骤换真实端点 GET /meetingV3/api/message/getMessagePageList
  （5.44 会议列表首屏 HTTP 接口，带 authorization 即可，无需 x-sign）

完整 17 步示范用例（含 finally 自清理）5.60 生产验收通过（exec_a8dbb9c4，
96.1s 全绿、5.44 零残留）。详见 HANDOFF_UI自动化.md 会话 24。
Co-Authored-By: Claude <noreply@anthropic.com>

语义化机制 + 步骤15修复已部署 5.60 生产（37 后端文件 + 前端 dist），
经 5.60 网页连跑两次全绿（107.5s/106.9s）、5.44 零残留，
步骤15「取消会议」修复在生产环境确认有效。
剩余：替换 finally api_call 端点（完整17步示范用例收尾）。
参考 _PRD_复杂用例通用执行机制_语义化用例执行.md
Co-Authored-By: Claude <noreply@anthropic.com>

16 步主流程连跑两次全绿（92s/次）、5.44 零残留会议；
修复 create_meeting url_patterns 与 meeting_detail fingerprint。
参考 _PRD_复杂用例通用执行机制_语义化用例执行.md
Co-Authored-By: Claude <noreply@anthropic.com>

步骤15「点击取消会议」报"选择器不能为空"根因：create_meeting 万能 url_pattern
`meetingV3` 与详情页 `meetingV3.*Detail` 双命中（meetingDetail 含大写 Detail）
→ fingerprint 判存失败（详情页实测 0 个 .room、0 个 .topic_item input）
→ recognize_current_page 返回 None → scope 软更新失败 → 语义解析链中断。

修复（page_url_mapping.json）：
- create_meeting url_patterns: ["meetingV3"] → ["meetingV3.*CreateMeeting", "meetingV3.*createMeeting"]
- meeting_detail fingerprint: .room:has-text('会议') → .detail_top（详情页 1 / 新建页 0，天然区分）

配套：
- semantic_resolver.py: scope 软更新重识别当前页面后与期望 scope 比对
- test_page_url_service.py: 新增 3 条回归测试（详情页识别/新建页不误判/列表页 None）

验证：语义化验证版用例（16步，剔除 finally 清理）真实执行连跑两次全绿
（exec_1ff18a20 / exec_2eb7c625，约 92s/次），5.44 会议列表零残留。
参考 _PRD_复杂用例通用执行机制_语义化用例执行.md
Co-Authored-By: Claude <noreply@anthropic.com>

- 记录语义化机制阶段1-6完成（参考 _PRD_复杂用例通用执行机制_语义化用例执行.md）
- 压缩 13 个冗长会话记录为历史时间线表（2576→174 行）
- 保留当前状态/关键约束/配置/运维/文档索引/有效待办
Co-Authored-By: Claude <noreply@anthropic.com>

参考文档：_PRD_复杂用例通用执行机制_语义化用例执行.md

范式转变：从"记录选择器"到"记录业务意图"。semantic 语义目标 +
执行期现场解析 + 上下文变量 + 状态验证 + 数据自建/自清理。

- 阶段1 数据模型+上下文：StepDefinition 新增 semantic/verify/run_on 顶层
  字段；ExecutionContext + {__CTX:key__} 渲染（复用 TemplateResolver）
- 阶段2 页面注册表：page_url_mapping 升级 url_patterns+fingerprint；
  recognize_current_page 运行时页面身份感知
- 阶段3 语义解析器：semantic_resolver 解析链（lookup_by_key→模式选择器
  →关键词规则→Claude仲裁），wire 进 execute_step；debug 只读接口
  /api/debug/resolve
- 阶段4 状态验证+api_call+finally：verify 断言防假通过、finally/on_failure
  清理步骤、api_call 数据自清理
- 阶段5 映射表v2显式字典：lookup_by_key 纯字典查找、USE_FUZZY_MAPPING
  默认关停、migrate_mapping_v2 迁移脚本
- 阶段6 前端+示范：CaseStepEditor 语义目标编辑、stepParser 语义推断、
  语义化重写「新建会议」示范用例（create_semantic_meeting_case.py）
- 修复参数持久化 bug：case_service.create + _case_to_response 补 parameters
- 新增映射别名 创建会议-查看详情（lookup_by_key 原 MISS，不回归旧路径）
Co-Authored-By: Claude <noreply@anthropic.com>

阶段 6 交付工作流：PRD → 执行计划 → 代码 → 验证 → HANDOFF，文档先行可追溯。
- _PRD_复杂用例通用执行机制_语义化用例执行.md
- _执行计划_复杂用例通用执行机制_语义化用例执行.md
Co-Authored-By: Claude <noreply@anthropic.com>

【会话18】被测系统URL配置功能
- config.py 新增 TARGET_URL，Settings.vue 可配置，持久化到 dingtalk_configs.target_url
- 22 个消费方（routers/services/executors/utils/frontend）统一读取，selector_mapper/page_url_service 运行时替换 base URL

【会话14/17/20】元素映射修复（21步会议用例）
- 步骤11 会议室选择：映射表补"创建会议-会议室选择"条目
- 步骤12 预定会议：新增 .time_btn>div:last-child .btns 映射 + 时间切换规范化
- 步骤14/16 编辑/完成按钮：.room .delimg img:nth-of-type(2) + .room .user_list button:has-text("完成")
- 步骤15 参会人勾选：行级 .el-table__row:has-text("admin@xty12") .el-checkbox
- element_mapping_service 编辑/完成按钮加分逻辑

【执行引擎】
- playwright_executor：checkbox 注入顺序修复（原选择器优先）+ strategy5 表格行勾选回退
- 单元测试扩充（test_element_mapping_service.py）

【文档】HANDOFF_UI自动化 会话20 记录 + HANDOFF/V2部署/性能测试同步
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 ApiTestExecutor（HttpClient 复用 + 模板变量 + 4类型断言引擎）
- 新增 ApiTestService（用例查询/执行创建/异步执行/结果保存）
- 新增 /api/api-test 路由（7个端点：用例 CRUD + 执行管理 + 结果查询）
- 新增 ApiCaseList.vue（支持 HTTP 配置 + Headers/Body/断言规则编辑器）
- 新增 apiTest.ts 前端 API 封装
- 复用通用 Execution.vue（api 类型分支）和 Reports.vue（api 类型标签）
- 复用 test_cases 表（case_type='api'），API 配置存 steps 字段
Co-Authored-By: Claude <noreply@anthropic.com>

- 功能测试报告 HANDOFF：更新模板优化（T1-T5）状态、部署记录、待办
- 安全测试 HANDOFF：更新 task-preview 接口实测通过状态
- V2 部署升级 HANDOFF：新增离线部署包验证（5.69 KylinOS）与实施记录
- 功能测试报告路由：新增 FileResponse/HTMLResponse 导入
- 性能测试文档迁移：从 Docs/PRD/需求文档/性能测试/ 迁移至 Docs/PRD/性能测试/
- 新增功能测试报告模板优化 + Excel 适配 PRD 文档（4 份）
Co-Authored-By: Claude <noreply@anthropic.com>

- 执行器点击策略重排序：表格行/复选框策略提前至force点击前，
  force点击checkbox增加前后状态校验，避免隐藏复选框假成功
- 性能测试：template_resolver时间占位符升级为秒精度（修复A0027），
  body_template放宽为Any以兼容list请求体，报告面板图表加载顺序修复
- 功能测试报告模板：模型/路由/schema新增描述字段，Word/Markdown/Excel生成器适配
- 系统设置：新增钉钉对接与文档管理配置项
- 设备模拟：路由/schema/service及前端五个模拟页面增强，元素映射更新
- 杂项：安全用例脚本支持MySQL DATABASE_URL，deploy_execution.script_id改为nullable
- 同步各模块HANDOFF交接文档
Co-Authored-By: Claude <noreply@anthropic.com>

- 最近提交更新为 236b3f3b
- 菜单升级/ERP配置/ERP上传/ERP任务创建改为「已提交」标记
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 ERP 配置管理页面（ErpConfig.vue），支持查看/修改 ERP 连接参数
- 新增安全报告 ERP 上传流程：支持上传到 ERP 测试单、项目资料、协作文档
- 新增安全报告 ERP 任务创建：预览+创建，含报告解析、紧急程度计算、关联需求搜索
- 前端 Reports.vue 安全报告弹窗新增 ERP 上传/创建任务按钮及对话框
- 新增 4 份需求文档与计划执行文档
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 ReportTemplate 模型（name/is_default/config JSON字段）
- 新增模板 CRUD API（/api/functional-report/templates）
- 新增前端 TemplateConfig.vue 模板配置管理页面
- 新增模板选择下拉框（FunctionalReport.vue 生成报告时可选模板）
- 改造 word_generator/chart_generator/markdown_generator 支持 template_config 参数
- 修复 MySQL 下 config 字段 dict→JSON 序列化问题（json.dumps）
- 注册路由到 main.py，导入模型到 models/__init__.py
Co-Authored-By: Claude <noreply@anthropic.com>

- 后端: ApiPreset 数据模型/CRUD路由服务/预设继承逻辑
- 前端: 预设管理列表页+编辑弹窗+任务表单预设下拉自动填充
- 数据库: 迁移补齐 performance_tasks.capture_rules/preset_id
- 路由: 注册 api_preset/performance_output 子路由
Co-Authored-By: Claude <noreply@anthropic.com>

- 安全测试从自动化测试子菜单拆出，升级为独立一级菜单（Lock图标）
- 安全用例管理页面隐藏智能定位按钮（v-if caseType筛选）
- security_executor.py: 新增header_contains/cors_allow_wildcard断言
- create_security_cases.py: 新增26个用例（JWT伪造/CORS/XSS/回归/红线等，总计68个）
- 修复报告列表接口返回case_type字段，前端报告类型标签正确显示'安全测试'
Co-Authored-By: Claude <noreply@anthropic.com>

- playwright_executor: 登录检测改为多信号（.block/.home_nav_left/登录表单消失），Phase 4 URL直达增加跳过列表兜底，登录点击后同步检测登录态
- 设备模拟: 新增按设备类型批量启动/停止（start_all_by_device_type/stop_all_by_device_type），含路由/schema/API封装/前端联动
- 前端: 安全测试提升为独立一级菜单
Co-Authored-By: Claude <noreply@anthropic.com>

- 监控面板和报告面板空状态增加任务下拉选择器
- 无 taskId 参数时自动加载可选任务列表供选择
- 选中任务后通过路由跳转携带 taskId 加载数据
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 ErpConfig 数据库模型（erp_configs 单行表，5个配置字段）
- config 端点改为 DB 读写：GET 优先读 DB（空字段回退环境变量），PUT upsert 到 DB
- 功能测试报告改为父菜单（el-sub-menu），含"生成报告"和"ERP 配置"两个子项
- 路由改造：/reports/functional → 父路由 + generate/erp-config 子路由
- 新增容器组件 index.vue 和 ERP 配置页面 ErpConfig.vue（5字段表单，自动填充默认值）
- 更新 HANDOFF_功能测试报告.md 文档
Co-Authored-By: Claude <noreply@anthropic.com>

- 性能测试页面重构为父容器 + 子路由（任务管理/执行监控/报告查看）
- 移除旧版 el-tabs 传参逻辑，监控/报告面板改为从路由 query 读取 taskId
- 任务列表监控/报告按钮改为路由跳转携带 taskId
- App.vue 菜单改为子菜单结构，补充性能测试页标题映射
Co-Authored-By: Claude <noreply@anthropic.com>

- App.vue: 菜单重构（自动化测试整合 /auto 父菜单，性能测试、功能测试报告独立一级菜单，部署/设备模拟/系统管理重新排序）
- Cases.vue: 移除 deploy/performance/functional 用例类型选项
- Reports.vue: 报告类型标签映射（ui/api/security/functional）
- TaskList.vue: 编辑弹窗改用 getTask 获取完整详情，修复 stepConcurrency 数组处理
Co-Authored-By: Claude <noreply@anthropic.com>

- ERP自动上传：功能报告生成后自动上传到测试单/项目资料/协作文档
- 登录压测签名：支持X-RANDOM/X-TIMESTAMP/X-SIGN签名头与验证码UUID
- 执行器导航优化：新增策略5/6（表格行点击），登录后自动跳转目标页
- 部署服务重构：encrypt_password/decrypt_password 改为模块级函数
- 新增元素定位器基础服务与页面URL映射服务
- 新增PRD文档：元素映射定位方案、设备模拟、智能定位优化等
- 更新HANDOFF文档与settings.local.json权限配置
Co-Authored-By: Claude <noreply@anthropic.com>

新增自动化部署测试模块（SSH远程执行+交互式应答+WebSocket实时日志）
新增性能测试模块（系统指标监控+图表展示）
新增功能测试报告模块（Excel解析→数据分析→图表→Word/MD报告→ERP上传）
修复执行引擎死锁（Playwright线程+uvloop兼容+headless默认值）
修复元素映射表服务（v1.2扩展至220元素）
新增ERP配置项、性能监控模型、数据库注册
前端：部署/性能/功能测试报告三套页面+菜单+路由
文档：PRD+计划执行+Handoff完整文档
Co-Authored-By: Claude <noreply@anthropic.com>

- elements_mapping.json v1.1→v1.2：新增登录页14元素、会议预约子页面101元素(创建会议/会议模板/个人日程/会议室/会议列表)，共220元素
- element_mapping_service.py：新增页面前缀匹配(如"登录页-*")和动作-元素类型匹配(输入→输入框、勾选→复选)，修复"登录页密码"误配Tab问题
Co-Authored-By: Claude <noreply@anthropic.com>

Phase 1: 生成元素映射表 JSON (105个元素, 覆盖首页/功能中心/筛选器)
Phase 2: 实现 ElementMappingService (3级匹配: 精确/模糊/上下文)
Phase 3: 集成到 PlaywrightExecutor (最高优先级选择器来源)
Phase 4: 本地验证通过 (9/9单测 + 13/13集成测试)
Phase 5: 部署到服务器 192.168.5.60 (SCP + Docker restart)

同步修复:
- keyword_matcher: 父容器检测 + 组合选择器 + 评分归一化
- smart_locate_service: 执行级联(前置步骤失败跳过后续)
- base_simulator: 设备模拟优化
- HANDOFF_UI自动化.md: 更新完成状态
Co-Authored-By: Claude <noreply@anthropic.com>

Phase 3 - Playwright语义定位器：
- 新增role:/text:/placeholder:/label:/testid:格式
- 执行器_do_click/_do_fill支持语义API优先

Phase 4 - 组合选择器生成：
- 弹窗/抽屉/表格行/Tab/表单内元素自动生成组合选择器
- 统一选择器优先级体系

Phase 5 - Claude语义增强优化：
- 单候选也调用Claude验证，返回confirmed字段
- Prompt增加页面URL/路由/前后步骤上下文
- 候选信息保留完整属性

Phase 6 - iframe/微前端选择器穿透：
- 关键词匹配记录元素frame来源
- 选择器格式: iframe[src*="xxx"] >> element_selector
- 执行器支持frame路径选择器解析和点击/填充
Co-Authored-By: Claude <noreply@anthropic.com>

Phase 1 - 关键词提取优化：
- 引入jieba分词替代暴力替换，解决语义丢失问题
- 精简修饰词列表，添加项目词汇白名单
- extract_value支持中文值提取

Phase 2 - 评分体系归一化：
- 精确匹配(1.0)高于包含匹配(0.3)
- click对INPUT减分更激进(0.1)，fill优先匹配INPUT
- 归一化评分到[0,1]区间

新增测试脚本验证改动
Co-Authored-By: Claude <noreply@anthropic.com>

- _PRD_智能定位Claude语义增强.md：分析纯关键词匹配局限，规划 Claude CLI 语义增强方案
- _执行计划_智能定位Claude语义增强.md：三阶段实施计划（CLI集成/服务改造/测试验证）
- _分析报告_元素定位方案对比.md：录制器/智能定位/手动编写三种方案准确率对比
- _调研报告_AI自动化测试智能定位技术对比.md：大厂 AI+自动化测试方案对比与改进建议
- CreateCMD/_run_claude.bat：去除文件末尾多余换行符
Co-Authored-By: Claude <noreply@anthropic.com>

feat(设备模拟): 多类型主题上报支持 + 前端设备列表增强

- 新增元素定位方案对比分析文档（录制器/智能定位/手动编写）
- 设备模拟：central_simulator多类型主题上报、topic_templates扩展
- 设备模拟：前端DeviceList组件增强、新增deviceSim API和类型定义
- 更新HANDOFF_设备模拟交接文档
Co-Authored-By: Claude <noreply@anthropic.com>

Co-Authored-By: Claude <noreply@anthropic.com>

- 智能定位时如果步骤已有选择器，直接使用不再重新定位
- 已有选择器验证失败时仍保留原选择器（避免覆盖用户手动配置）
- 前端智能定位超时从3分钟增加到10分钟（适配Claude调用耗时）
- 测试通过：系统设置用例6/6步骤定位成功，耗时32秒
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增3种调用方式（按优先级）：本地CLI > SSH宿主机 > 容器内CLI
- 新增_call_claude_via_ssh方法：通过SSH调用宿主机Claude CLI
- 新增_call_claude_via_paramiko方法：paramiko回退方案
- 支持环境变量配置SSH连接参数（CLAUDE_SSH_HOST/PORT/USER/PASS）
- 已部署到192.168.5.60验证通过
Co-Authored-By: Claude <noreply@anthropic.com>

- 新增 claude_service.py：Claude CLI 语义增强服务，含 Prompt 模板、调用、解析、容错
- 改造 keyword_matcher.py：返回候选列表而非单一元素，新增 get_candidate_details()
- 改造 smart_locate_service.py：集成 Claude 语义增强，use_claude 参数控制
- 改造 smart_locate.py 路由：新增 use_claude 参数和 claude_enhanced/confidence/reason 响应字段
- 新增 config.py 配置项：CLAUDE_ENABLED/TIMEOUT/MODEL/MAX_CANDIDATES
- 新增集成测试脚本和 PRD/执行计划/技术调研文档

预期效果：定位准确率 60% -> 85%+，解决关键词撞车问题
Co-Authored-By: Claude <noreply@anthropic.com>

记录本次会话完成的全部工作：
1. 用例串行执行机制
2. 菜单选择器修正
3. 模块选择器搜索功能
4. 智能定位优化（关键词/元素范围/模式预处理）
5. Docker headless 环境问题待排查
Co-Authored-By: Claude <noreply@anthropic.com>

改进：
1. 放宽修饰词移除规则 - 移除"添加"/"新增"/"完成"等按钮名称词
2. 扩展元素查询范围 - 添加 .el-button .el-checkbox .el-tabs__item 等
3. 放宽文本匹配条件 - 支持 div/span/i/label/li 文本匹配
4. 扩展文本提取范围 - 支持更多标签类型
5. 增强语义回退策略 - 添加图标/复选框/Element Plus 按钮的查找
6. 新增步骤模式预处理器：
   - "xxx选择：yyy" → 列表内复选框
   - "xxx切换为：yyy" → Tab 切换

效果：
- 步骤10(列表复选框) ✅ 模式匹配成功
- 步骤11(Tab切换) ✅ 模式匹配成功
- 其他按钮类步骤需要在导航到对应页面后才能验证

已部署到 192.168.5.60
Co-Authored-By: Claude <noreply@anthropic.com>

- 步骤10不是下拉选择，是右侧会议室列表的复选框
- 新增列表内复选框定位策略
- 新增 Tab 切换按钮定位策略
- 更新执行计划
Co-Authored-By: Claude <noreply@anthropic.com>

问题：会议管理-新建会议用例 20 个步骤中 7 个缺少选择器（35%）
根因：关键词提取不完善、点击操作匹配优先级低、下拉选择未处理、位置限定词缺失
Co-Authored-By: Claude <noreply@anthropic.com>

改进：
1. 模块选择器添加 filterable 属性，支持输入关键字快速检索
2. 添加 clearable 属性，支持清除选择
3. 更新 placeholder 提示文字
4. 模块层级调整：会议管理、数据分析、运维管理、管理看板调整为一级模块

部署：
- 前端已部署到 192.168.5.60
- 后端模块 parentId 已通过 API 清除
Co-Authored-By: Claude <noreply@anthropic.com>

- docker-compose.yml 在 deploy/ 子目录
- 服务器上无 git 仓库，改用 SFTP 上传文件
- 支持参数控制只重启后端/前端
Co-Authored-By: Claude <noreply@anthropic.com>