@epoint-testtech/ep-stage-skill 0.0.9 → 0.5.0-alpha.2

package/codex-skill/ep-stage/glue-run-test/references/playwright-cli-odav.md

@@ -1,166 +1,127 @@
-# playwright-cli O-D-A-V
-
-本文件用于 `/glue-run-test` 中的 Agent Runtime 推理阶段。`playwright-cli` 是 Playwright 官方为 coding agent 设计的一次性子命令 + 后台 daemon 工具（`https://playwright.dev/agent-cli/introduction`，v0.1.15+）。Agent 每次跑单个子命令，浏览器状态由后台 daemon 跨命令保持；不是 REPL、不需要长驻 stdin 通道，与 Claude Code 无头 Bash 单次调用模型天然对齐。
-
-`playwright-cli` 不是推理引擎；Agent 读取 `ai-runtime-trace.json5.tasks[]` 后，用它观察和操作真实页面，然后按 dev-rules.md 把原料改写为 `test()` snippet 写入 `ai-snippets.json5`。
-
-## 前置
-
-- 本机全局安装 `playwright-cli`：`which playwright-cli` 有输出。
-- 目标业务系统网络可达（`credentials.json5.loginUrl` / `contract.base.navigation.directUrl`）。
-- 已有 `credentials.json5`，至少一条完整业务角色凭据（`url / username / password` 非空）。
-
-## 输入
-
-- `<caseDir>/.ep-stage/ai-runtime-trace.json5`：CLI `prepare-tasks` 产出的任务包（tasks[]）。
-- `<caseDir>/testcase.json5`：`testAccess.requiredRoles[0]` = primary role，`contract.base.navigation.directUrl` = 列表页直达链接。
-- `<caseDir>/credentials.json5`：按 primary role 取 `loginUrl / username / password`。
-- `docs/00-memory/dev-rules.md`：snippet 代码规范，必须先读。
-- `<caseDir>/crud.spec.ts`：glue 骨架 spec，参考已就位的 `crudSlots / exportSlots / directListUrl / credentialsPath / primaryRole` 常量。
-
-## Session 生命周期
-
-每次 AI runtime 用一个 daemon session 名，建议 `<moduleId>-<timestamp>`（如 `zwplace-20260703011800`）。**所有子命令都必须传 `-s=<name>`**，daemon 会在浏览器进程里保持登录状态 / cookies / localStorage：
-
-- 开始：`playwright-cli -s=<name> open <loginUrl> --headed`。**必须传 `--headed`**：AI runtime 钻探期间要求人工旁观真实浏览器，验证 O-D-A-V 步骤符合业务意图；不允许 headless 默认，避免"看不见的黑盒操作"导致 snippet 幻觉进入 spec。
-- 全程：命名不变，Agent 每步传 `-s=<name>`。
-- 结束：`playwright-cli -s=<name> close`；异常兜底 `playwright-cli kill-all`。
-- 清理：`playwright-cli -s=<name> delete-data` 清 session 存储。
-- 枚举：`playwright-cli list` 查现存 session。
-
-## 执行剧本
-
-### Step 1 — 登录
-
-```bash
-SESSION="<moduleId>-$(date +%Y%m%d%H%M%S)"
-playwright-cli -s="$SESSION" open <loginUrl> --headed  # 强制有头：AI runtime 钻探必须可视化，禁止无头
-playwright-cli -s="$SESSION" snapshot                 # 输出 .playwright-cli/page-*.yml，含 accessibility tree + refs
-# 读 snapshot yml 找账号 / 密码 / 登录按钮的 ref（形如 e12, e13, e15）
-playwright-cli -s="$SESSION" fill e12 "<username>"
-playwright-cli -s="$SESSION" fill e13 "<password>"
-playwright-cli -s="$SESSION" click e15
-playwright-cli -s="$SESSION" snapshot                 # 验证登录成功（URL 或首页 DOM 特征）
-playwright-cli -s="$SESSION" state-save <caseDir>/.ep-stage/auth.json   # 可选：状态保存
-```
-
-### Step 2 — 直达列表页
-
-```bash
-playwright-cli -s="$SESSION" goto <directUrl>
-playwright-cli -s="$SESSION" snapshot                 # 观察列表页 iframe / 表格 / 按钮 refs
-```
-
-### Step 3 — 对每条 AI task 做 O-D-A-V
-
-| 阶段 | Agent 行为 | playwright-cli 原子命令 |
-|---|---|---|
-| Observe | 观察当前页面 / iframe / 控件 / 弹窗 / 列表结构，读 accessibility tree yml 拿 refs | `snapshot` |
-| Decide | 对照 task.businessIntent / assertionExpectation 决定下一动作 + 期望断言 | Agent 推理（不调 CLI） |
-| Act | 在真实页面试操作 | `click <ref>` / `fill <ref> <text>` / `select <ref> <val>` / `check <ref>` / `hover <ref>` / `press <key>` / `drag <src> <dst>` / `upload <ref> <file>` |
-| Verify | 二次 snapshot 或抽取具体值形成断言 | `snapshot` / `eval "<js>"` / `console` / `network` |
-
-关键点：
-
-- **每一步 Act 之后必须 snapshot / eval 验证动作生效**，才能进入下一步 Act。`click` / `fill` / `select` 等 CLI 命令 exit=0 只代表 shell 调用无异常，**不代表页面 state 真的变了**：hover-only 展开的下拉、异步加载的 iframe、表单前置校验拦截、遮罩层拦截都可能让浏览器静默无响应而 CLI 依然 pass。发现动作无生效 → 先补前置动作（`hover` 触发展开、`snapshot` 等待重挂载、`press Tab` 触发 blur）再 snapshot 二次确认，**不要**在假设动作已生效的前提下径直进入下一步 Act，否则会产生"silent no-op"假通过污染 snippet。
-- **refs 每次 snapshot 后重新编号**，不要跨 snapshot 缓存 ref。每次动作前先 snapshot 拿新 ref。
-- `eval "<js>"` 用于抽取具体 DOM 内容作为断言值（如 `document.querySelector('#toast').innerText`）；只用于验证不用于动作。
-- 弹窗遮罩 / iframe 变化 → 必须 snapshot 重新拿 refs。
-- 每条 task 探索完，把当前 snapshot yml 路径记入 result.evidence，支撑可观测性 gate（"无来源不入契约"）。
-
-### Step 3b — 表单填充策略（新增弹框 / 编辑弹框）
-
-弹窗表单在子 iframe 内，**playwright-cli 的 `click <ref>` / `fill <ref>` 够不着 iframe 元素**（snapshot refs 只覆盖主 frame）。iframe 内操作一律走 `run-code` + `page.frames()` 定位：
-
-```bash
-playwright-cli -s=$SESSION run-code "async page => { const f = page.frames().find(fr => fr.url().includes('<addIframeSrcKeyword>')); ... }"
-```
-
-1. **优先策略 — 一键填充（clickIfExist 语义）**：
-   - 读取 `crud.spec.ts` 中 `crudSlots.locators.addAutofillTrigger`（典型值为 `xpath=//*[@title="默认填充"]`）。
-   - 用 run-code 在弹窗 frame 内探测该按钮，**找到才点，找不到（约 2 秒）直接跳过**——与骨架 `clickIfExist({ timeout: 2_000 })` 行为一致；部分页面本来就没有此按钮，不算失败。
-   - 点击后验证字段已自动填入。一键填充能正确触发 MiniUI 组件验证、正确选择下拉 option value。
-
-2. **兜底策略 — run-code + Playwright locator API**（一键填充不存在时使用）：
-   - **文本字段**：`f.locator('xpath=//div[@label="场所名称"]//input[contains(@class,"mini-textbox-input")]').fill(value)`。Playwright `fill` 会触发完整事件链（focus → input → change），MiniUI 验证状态正常。
-   - **下拉框（listbox / combobox）**：`f.locator('//div[@label="场所分类"]//span[@name="trigger"]').filter({ visible: true }).click()` 展开 → 选项定位**必须加 `.filter({ visible: true })`**：`f.locator('//table[contains(@class,"mini-listbox-items")]').filter({ visible: true }).locator('xpath=.//td[...]').first()`。MiniUI 的选项表在 DOM 中有**常驻隐藏副本**，不加 visible 过滤会拿到隐藏副本导致 waitFor 超时（与骨架 `listbox-component.ts` 行为一致）。
-   - **禁止**用 `eval` 直接赋值 `input.value = "xxx"`——这会绕过 MiniUI 内部验证状态，保存时字段被识别为空（实测踩坑：值在 input 里可见，但保存报"不能为空"）。
-   - **禁止**直接填 option text 到 hidden value（如下拉隐藏域 `placecategory$value`）——显示文本与值会脱节。
-   - 所有填写动作后必须验证字段值已生效（run-code 读回或补扫 elementMap），再进入下一步。
-
-### Step 3c — 弹窗与 iframe 操作要点
-
-1. **点击触发按钮（新增/修改/查看）后必须等弹窗 iframe 注册**：`page.waitForTimeout(1500~2000)` 或轮询 `page.frames().find(fr => fr.url().includes('<keyword>'))`。**找不到 frame 不要立即重点触发按钮**——弹窗可能正在打开，重复点击会被遮罩层拦截，造成假超时假象。
-2. **弹窗 frame 定位优先用 contract 关键字**：`crudSlots.frames.addIframeSrcKeyword / editIframeSrcKeyword`（如 `gxhzwplaceadd` / `gxhzwplaceedit`；详情页形如 `gxhzwplace<module>detail`）。不要临时发明泛指关键字（如 `frameUrlSecretParam`）——会同时匹配新增/编辑/详情多个弹窗 frame，定位失真。
-3. **run-code 沙箱能力边界**：沙箱内只有 Playwright API（`page` 及入参），**无 Node 内置模块**——`require` 未定义、dynamic `import()` 报 `ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`。需要 fs 能力时（如验证下载文件大小）：run-code 内只取 `download.path()` / `download.suggestedFilename()` 返回，文件大小在 bash 侧 `ls -la` 验证。
-4. **弹窗关闭判断**：`!page.frames().some(fr => fr.url().includes('<keyword>'))` 为 true 即弹窗已关。「保存」类按钮业务语义是不关弹窗（草稿继续编辑），「保存并关闭」才关——不要用错预期。
-
-### Step 4 — Snippet 改写
-
-按 `dev-rules.md` 把 playwright-cli 观察 / 动作原料转成 `test()` snippet：
-
-- 不直接照搬 playwright-cli 里的 ref 编号（`e12`）到 spec；spec 里用 Playwright locator API（`page.getByRole` / `page.getByLabel` / `page.locator('xpath=...')`），从 snapshot 里读元素的 role/name/text 语义信息生成稳定 locator。
-- 元素定义变量统一 `repo` 前缀：`repoBtn同步` / `repoInput场所名称` / `repoTable列表`。
-- 用锚点作用域缩小定位范围（列表行、弹框内），避免全页裸定位。
-- 保留 caseId 注释 + 标题前缀：`// caseId: TC01011` 注释与 test 标题 `TC01011 用例标题` 并存，便于 trace 对齐与报告按标题回显用例 ID。
-- 复用 `crud.spec.ts` 已声明的 `directListUrl / credentialsPath / primaryRole / crudSlots / exportSlots` 常量，不重复声明。
-
-## 输出
-
-写 `<caseDir>/.ep-stage/ai-snippets.json5`：
-
-```json5
-{
-  schemaVersion: 'ep-stage-ai-snippets/v1',
-  testcasePath: '<testcase.json5绝对路径>',
-  generatedAt: '<ISO时间>',
-  results: [
-    {
-      caseId: '<task.caseId>',
-      status: 'resolved',
-      observation: { summary: '<观察摘要>' },
-      decision: { action: '<动作决策>' },
-      actionFlow: ['<已验证动作>'],
-      verification: { assertionExpectation: '<断言依据>' },
-      specSnippet: "test('...', async ({ page }) => {\\n  ...\\n});",
-      evidence: [{ source: 'playwright-cli', note: '<证据说明，含 snapshot yml 路径>' }],
-    },
-  ],
-}
-```
-
-> **specSnippet 必须是合法 JSON5 字符串**（单/双引号 + 转义），禁止用反引号模板字符串书写整个值——JSON5 不支持 `` ` ``，`run` 子命令解析 ai-snippets.json5 时会直接抛 `JSON5: invalid character '`'` 崩溃。snippet 代码内部含模板字符串（`` `...${...}...` ``）没问题，它只是字符串内容；建议用脚本 `JSON.stringify` 生成文件而非手写。
-
-无法访问 `playwright-cli`、目标系统网络不通、页面信息不足或断言无法确认时，不强造 snippet：
-
-```json5
-{
-  caseId: '<task.caseId>',
-  status: 'needs_review',
-  observation: { summary: '<无法继续的原因>' },
-  evidence: [{ source: 'agent-runtime', note: '<需要人审补充的信息>' }],
-}
-```
-
-## 附录 A — MiniUI 常见控件定位模式
-
-O-D-A-V 中反复用到的稳定模式，优先于临时推导：
-
-- **行勾选**：`#datagrid tr[<行条件>]//td[contains(@class,'checkcolumn')]//span`。**禁止**用 `td:first-child` / `td.first()`——首列未必是勾选列，点击不落 checkbox 时后续删除按钮静默无反应。勾选生效信号：行 `class` 含 `mini-grid-row-selected`。
-- **下拉弹层**：选项表在 DOM 中有常驻隐藏副本，必须 `.filter({ visible: true })` 锁定展开的那个（见 Step 3b）。
-- **列索引（td nth）**：行结构 = 前导列（勾选列 + 图标列，通常 2 个）+ `grid.columns` 业务列 + 操作列。写 snippet 前查 `elementmap.json` 里 grid 条目的 `columns` 数组做字段→列号映射：`nth = columns.indexOf(字段名) + 前导列数`，并对一行已知值实测验证（本模块实测：nth(3)=场所名称、nth(4)=场所分类、nth(6)=统一对外服务时间、nth(9)=状态、nth(10)=版本号）。不要凭肉眼从 snapshot 数格子。
-- **行内操作按钮**：`#datagrid tr[.//div[text()='<唯一值>']]//i[@data-tooltip='修改'|'查看']`（contract `listEditActionLocatorTemplate` 的 `{{value}}` 替换）。
-- **弹窗按钮**：`xpath=//a[contains(@class,'mini-button')][normalize-space()='保存'|'保存并关闭'|'关闭']` + `.filter({ visible: true })`；确认弹窗按钮 `text=确定`。
-
-## 常用官方命令速查
-
-- Session：`-s=<name>` 前缀 / `list` / `close-all` / `kill-all` / `delete-data`
-- 页面：`open <url>` / `goto <url>` / `close` / `go-back` / `go-forward` / `reload`
-- 观察：`snapshot` / `screenshot` / `console` / `network` / `run-code`
-- 动作：`click / dblclick / hover <ref>` / `fill <ref> <text>` / `type <text>` / `select <ref> <val>` / `check / uncheck <ref>` / `press <key>` / `drag <src> <dst>` / `upload <ref> <file>`
-- 状态：`state-save [file]` / `state-load <file>` / `cookie-*` / `localstorage-*` / `sessionstorage-*`
-- 求值：`eval "<js表达式>"`（仅单行单表达式；CLI 会包成 `() => (参数)`，含顶层 `;` / 多语句 / 函数声明直接报 `Passed function is not well-serializable!`）/ `run-code "page => expr"`（Node 侧函数，参数收到 Playwright `page` 对象；多语句用 `async page => { ... }` 块体，页面内 JS 走 `page.evaluate(() => { ... })`，iframe 走 `page.frames()`）
-- 标签：`tab-list` / `tab-new` / `tab-select` / `tab-close`
-- 对话框：`dialog-accept` / `dialog-dismiss`
-
-如需最新完整命令列表，跑 `playwright-cli --help` 或访问 `https://playwright.dev/agent-cli/introduction`。
+# playwright-cli O-D-A-V
+
+本文件用于 `/glue-run-test` 中的 Agent Runtime 推理阶段。`playwright-cli` 是 Playwright 官方为 coding agent 设计的一次性子命令 + 后台 daemon 工具（`https://playwright.dev/agent-cli/introduction`，v0.1.15+）。Agent 每次跑单个子命令，浏览器状态由后台 daemon 跨命令保持；不是 REPL、不需要长驻 stdin 通道，与 Claude Code 无头 Bash 单次调用模型天然对齐。
+
+`playwright-cli` 不是推理引擎；Agent 读取 `ai-runtime-trace.json5.tasks[]` 后，用它观察和操作真实页面，然后按 dev-rules.md 把原料改写为 `test()` snippet 写入 `ai-snippets.json5`。
+
+## 前置
+
+- 本机全局安装 `playwright-cli`：`which playwright-cli` 有输出。
+- 目标业务系统网络可达（`credentials.json5.loginUrl` / `contract.base.navigation.directUrl`）。
+- 已有 `credentials.json5`，至少一条完整业务角色凭据（`url / username / password` 非空）。
+
+## 输入
+
+- `<caseDir>/.ep-stage/ai-runtime-trace.json5`：CLI `prepare-tasks` 产出的任务包（tasks[]）。
+- `<caseDir>/testcase.json5`：`testAccess.requiredRoles[0]` = primary role，`contract.base.navigation.directUrl` = 列表页直达链接。
+- `<caseDir>/credentials.json5`：按 primary role 取 `loginUrl / username / password`。
+- `docs/00-memory/dev-rules.md`：snippet 代码规范，必须先读。
+- `<caseDir>/crud.spec.ts`：glue 骨架 spec，参考已就位的 `crudSlots / exportSlots / directListUrl / credentialsPath / primaryRole` 常量。
+
+## Session 生命周期
+
+每次 AI runtime 用一个 daemon session 名，建议 `<moduleId>-<timestamp>`（如 `zwplace-20260703011800`）。**所有子命令都必须传 `-s=<name>`**，daemon 会在浏览器进程里保持登录状态 / cookies / localStorage：
+
+- 开始：`playwright-cli -s=<name> open <loginUrl> --headed`。**必须传 `--headed`**：AI runtime 钻探期间要求人工旁观真实浏览器，验证 O-D-A-V 步骤符合业务意图；不允许 headless 默认，避免"看不见的黑盒操作"导致 snippet 幻觉进入 spec。
+- 全程：命名不变，Agent 每步传 `-s=<name>`。
+- 结束：`playwright-cli -s=<name> close`；异常兜底 `playwright-cli kill-all`。
+- 清理：`playwright-cli -s=<name> delete-data` 清 session 存储。
+- 枚举：`playwright-cli list` 查现存 session。
+
+## 执行剧本
+
+### Step 1 — 登录
+
+```bash
+SESSION="<moduleId>-$(date +%Y%m%d%H%M%S)"
+playwright-cli -s="$SESSION" open <loginUrl> --headed  # 强制有头：AI runtime 钻探必须可视化，禁止无头
+playwright-cli -s="$SESSION" snapshot                 # 输出 .playwright-cli/page-*.yml，含 accessibility tree + refs
+# 读 snapshot yml 找账号 / 密码 / 登录按钮的 ref（形如 e12, e13, e15）
+playwright-cli -s="$SESSION" fill e12 "<username>"
+playwright-cli -s="$SESSION" fill e13 "<password>"
+playwright-cli -s="$SESSION" click e15
+playwright-cli -s="$SESSION" snapshot                 # 验证登录成功（URL 或首页 DOM 特征）
+playwright-cli -s="$SESSION" state-save <caseDir>/.ep-stage/auth.json   # 可选：状态保存
+```
+
+### Step 2 — 直达列表页
+
+```bash
+playwright-cli -s="$SESSION" goto <directUrl>
+playwright-cli -s="$SESSION" snapshot                 # 观察列表页 iframe / 表格 / 按钮 refs
+```
+
+### Step 3 — 对每条 AI task 做 O-D-A-V
+
+| 阶段 | Agent 行为 | playwright-cli 原子命令 |
+|---|---|---|
+| Observe | 观察当前页面 / iframe / 控件 / 弹窗 / 列表结构，读 accessibility tree yml 拿 refs | `snapshot` |
+| Decide | 对照 task.businessIntent / assertionExpectation 决定下一动作 + 期望断言 | Agent 推理（不调 CLI） |
+| Act | 在真实页面试操作 | `click <ref>` / `fill <ref> <text>` / `select <ref> <val>` / `check <ref>` / `hover <ref>` / `press <key>` / `drag <src> <dst>` / `upload <ref> <file>` |
+| Verify | 二次 snapshot 或抽取具体值形成断言 | `snapshot` / `eval "<js>"` / `console` / `network` |
+
+关键点：
+
+- **每一步 Act 之后必须 snapshot / eval 验证动作生效**，才能进入下一步 Act。`click` / `fill` / `select` 等 CLI 命令 exit=0 只代表 shell 调用无异常，**不代表页面 state 真的变了**：hover-only 展开的下拉、异步加载的 iframe、表单前置校验拦截、遮罩层拦截都可能让浏览器静默无响应而 CLI 依然 pass。发现动作无生效 → 先补前置动作（`hover` 触发展开、`snapshot` 等待重挂载、`press Tab` 触发 blur）再 snapshot 二次确认，**不要**在假设动作已生效的前提下径直进入下一步 Act，否则会产生"silent no-op"假通过污染 snippet。
+- **refs 每次 snapshot 后重新编号**，不要跨 snapshot 缓存 ref。每次动作前先 snapshot 拿新 ref。
+- `eval "<js>"` 用于抽取具体 DOM 内容作为断言值（如 `document.querySelector('#toast').innerText`）；只用于验证不用于动作。
+- 弹窗遮罩 / iframe 变化 → 必须 snapshot 重新拿 refs。
+- 每条 task 探索完，把当前 snapshot yml 路径记入 result.evidence，支撑可观测性 gate（"无来源不入契约"）。
+
+### Step 4 — Snippet 改写
+
+按 `dev-rules.md` 把 playwright-cli 观察 / 动作原料转成 `test()` snippet：
+
+- 不直接照搬 playwright-cli 里的 ref 编号（`e12`）到 spec；spec 里用 Playwright locator API（`page.getByRole` / `page.getByLabel` / `page.locator('xpath=...')`），从 snapshot 里读元素的 role/name/text 语义信息生成稳定 locator。
+- 元素定义变量统一 `repo` 前缀：`repoBtn同步` / `repoInput场所名称` / `repoTable列表`。
+- 用锚点作用域缩小定位范围（列表行、弹框内），避免全页裸定位。
+- 保留 caseId 注释：`// caseId: TC01011`，便于 trace 对齐。
+- 复用 `crud.spec.ts` 已声明的 `directListUrl / credentialsPath / primaryRole / crudSlots / exportSlots` 常量，不重复声明。
+
+## 输出
+
+写 `<caseDir>/.ep-stage/ai-snippets.json5`：
+
+```json5
+{
+  schemaVersion: 'ep-stage-ai-snippets/v1',
+  testcasePath: '<testcase.json5绝对路径>',
+  generatedAt: '<ISO时间>',
+  results: [
+    {
+      caseId: '<task.caseId>',
+      status: 'resolved',
+      observation: { summary: '<观察摘要>' },
+      decision: { action: '<动作决策>' },
+      actionFlow: ['<已验证动作>'],
+      verification: { assertionExpectation: '<断言依据>' },
+      specSnippet: "test('...', async ({ page }) => {\\n  ...\\n});",
+      evidence: [{ source: 'playwright-cli', note: '<证据说明，含 snapshot yml 路径>' }],
+    },
+  ],
+}
+```
+
+无法访问 `playwright-cli`、目标系统网络不通、页面信息不足或断言无法确认时，不强造 snippet：
+
+```json5
+{
+  caseId: '<task.caseId>',
+  status: 'needs_review',
+  observation: { summary: '<无法继续的原因>' },
+  evidence: [{ source: 'agent-runtime', note: '<需要人审补充的信息>' }],
+}
+```
+
+## 常用官方命令速查
+
+- Session：`-s=<name>` 前缀 / `list` / `close-all` / `kill-all` / `delete-data`
+- 页面：`open <url>` / `goto <url>` / `close` / `go-back` / `go-forward` / `reload`
+- 观察：`snapshot` / `screenshot` / `console` / `network` / `run-code`
+- 动作：`click / dblclick / hover <ref>` / `fill <ref> <text>` / `type <text>` / `select <ref> <val>` / `check / uncheck <ref>` / `press <key>` / `drag <src> <dst>` / `upload <ref> <file>`
+- 状态：`state-save [file]` / `state-load <file>` / `cookie-*` / `localstorage-*` / `sessionstorage-*`
+- 求值：`eval "<js表达式>"` / `run-code "<js多语句>"`
+- 标签：`tab-list` / `tab-new` / `tab-select` / `tab-close`
+- 对话框：`dialog-accept` / `dialog-dismiss`
+
+如需最新完整命令列表，跑 `playwright-cli --help` 或访问 `https://playwright.dev/agent-cli/introduction`。

package/codex-skill/ep-stage/glue-run-test/scripts/generate-crud-spec.mjs

@@ -1,149 +1,149 @@
-#!/usr/bin/env node
-import { existsSync, mkdirSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillRoot = path.resolve(__dirname, '..');
-const packageRoot = path.resolve(skillRoot, '../..');
-const repoRoot = path.resolve(packageRoot, '../..');
-
-function help() {
-  console.log(`Usage:
-  node scripts/generate-crud-spec.mjs \\
-    --module-id <module-id> \\
-    --docs <docs-dir> \\
-    --code-list <code-list-md> \\
-    --webapp <html-dir> \\
-    --java-actions <java-action-dir> \\
-    --hints <module-hints-json> \\
-    --contract-out <package-output-json> \\
-    --spec-out <glue-project-spec-ts> \\
-    --menu <menu-path>
-
-Notes:
-  - Relative upstream paths are resolved from the repository root.
-  - The contract path is passed to @epoint-testtech/ep-stage-skill relative to its package root.
-  - The script fails when unresolvedSlots is non-empty.
-`);
-}
-
-function parseArgs(argv) {
-  const args = {};
-  for (let index = 0; index < argv.length; index += 2) {
-    const key = argv[index];
-    const value = argv[index + 1];
-    if (key === '--help' || key === '-h') {
-      help();
-      process.exit(0);
-    }
-    if (!key?.startsWith('--') || !value) {
-      throw new Error(`Invalid argument near ${key ?? '<empty>'}`);
-    }
-    args[key.slice(2)] = value;
-  }
-  return args;
-}
-
-function resolveFromRepo(value) {
-  return path.isAbsolute(value) ? value : path.resolve(repoRoot, value);
-}
-
-function requirePath(label, value) {
-  if (!value) throw new Error(`Missing --${label}`);
-  const resolved = resolveFromRepo(value);
-  if (!existsSync(resolved)) throw new Error(`Path for --${label} does not exist: ${resolved}`);
-  return resolved;
-}
-
-function run(commandArgs) {
-  const result = spawnSync('pnpm', commandArgs, {
-    cwd: repoRoot,
-    stdio: 'inherit',
-    shell: false
-  });
-  if (result.status !== 0) {
-    process.exit(result.status ?? 1);
-  }
-}
-
-const args = parseArgs(process.argv.slice(2));
-const moduleId = args['module-id'];
-if (!moduleId) throw new Error('Missing --module-id');
-const docs = requirePath('docs', args.docs);
-const codeList = requirePath('code-list', args['code-list']);
-const webapp = requirePath('webapp', args.webapp);
-const javaActions = requirePath('java-actions', args['java-actions']);
-const hints = requirePath('hints', args.hints);
-const contractOut = args['contract-out'] ?? `packages/ep-stage-skill/output/${moduleId}.crud.contract.json`;
-const specOut = args['spec-out'];
-const menu = args.menu;
-if (!specOut) throw new Error('Missing --spec-out');
-if (!menu) throw new Error('Missing --menu');
-
-const contractAbs = resolveFromRepo(contractOut);
-const contractForPackage = path.relative(packageRoot, contractAbs);
-mkdirSync(path.dirname(contractAbs), { recursive: true });
-
-run([
-  '--filter',
-  '@epoint-testtech/ep-stage-skill',
-  'generate:crud-contract',
-  '--',
-  '--module-id',
-  moduleId,
-  '--docs',
-  docs,
-  '--code-list',
-  codeList,
-  '--webapp',
-  webapp,
-  '--java-actions',
-  javaActions,
-  '--hints',
-  hints,
-  '--out',
-  contractForPackage
-]);
-
-const contract = JSON.parse(readFileSync(contractAbs, 'utf8'));
-if (contract.unresolvedSlots?.length) {
-  console.error(JSON.stringify({
-    error: 'Contract has unresolvedSlots; update ModuleHints before generating a final spec.',
-    unresolvedSlots: contract.unresolvedSlots.map(({ slotId, reason, suggestedFormat }) => ({
-      slotId,
-      reason,
-      suggestedFormat
-    }))
-  }, null, 2));
-  process.exit(2);
-}
-
-const specAbs = resolveFromRepo(specOut);
-mkdirSync(path.dirname(specAbs), { recursive: true });
-
-run([
-  '--filter',
-  '@epoint-testtech/ep-stage-skill',
-  'generate:playwright-tests',
-  '--',
-  '--contract',
-  contractForPackage,
-  '--out',
-  specAbs,
-  '--menu',
-  menu
-]);
-
-console.log(JSON.stringify({
-  module: contract.module,
-  searchConditions: contract.searchConditions?.map(({ field, label, component, value }) => ({
-    field,
-    label,
-    component,
-    value
-  })),
-  contract: contractAbs,
-  spec: specAbs
-}, null, 2));
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const skillRoot = path.resolve(__dirname, '..');
+const packageRoot = path.resolve(skillRoot, '../..');
+const repoRoot = path.resolve(packageRoot, '../..');
+
+function help() {
+  console.log(`Usage:
+  node scripts/generate-crud-spec.mjs \\
+    --module-id <module-id> \\
+    --docs <docs-dir> \\
+    --code-list <code-list-md> \\
+    --webapp <html-dir> \\
+    --java-actions <java-action-dir> \\
+    --hints <module-hints-json> \\
+    --contract-out <package-output-json> \\
+    --spec-out <glue-project-spec-ts> \\
+    --menu <menu-path>
+
+Notes:
+  - Relative upstream paths are resolved from the repository root.
+  - The contract path is passed to @epoint-testtech/ep-stage-skill relative to its package root.
+  - The script fails when unresolvedSlots is non-empty.
+`);
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (let index = 0; index < argv.length; index += 2) {
+    const key = argv[index];
+    const value = argv[index + 1];
+    if (key === '--help' || key === '-h') {
+      help();
+      process.exit(0);
+    }
+    if (!key?.startsWith('--') || !value) {
+      throw new Error(`Invalid argument near ${key ?? '<empty>'}`);
+    }
+    args[key.slice(2)] = value;
+  }
+  return args;
+}
+
+function resolveFromRepo(value) {
+  return path.isAbsolute(value) ? value : path.resolve(repoRoot, value);
+}
+
+function requirePath(label, value) {
+  if (!value) throw new Error(`Missing --${label}`);
+  const resolved = resolveFromRepo(value);
+  if (!existsSync(resolved)) throw new Error(`Path for --${label} does not exist: ${resolved}`);
+  return resolved;
+}
+
+function run(commandArgs) {
+  const result = spawnSync('pnpm', commandArgs, {
+    cwd: repoRoot,
+    stdio: 'inherit',
+    shell: false
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+const args = parseArgs(process.argv.slice(2));
+const moduleId = args['module-id'];
+if (!moduleId) throw new Error('Missing --module-id');
+const docs = requirePath('docs', args.docs);
+const codeList = requirePath('code-list', args['code-list']);
+const webapp = requirePath('webapp', args.webapp);
+const javaActions = requirePath('java-actions', args['java-actions']);
+const hints = requirePath('hints', args.hints);
+const contractOut = args['contract-out'] ?? `packages/ep-stage-skill/output/${moduleId}.crud.contract.json`;
+const specOut = args['spec-out'];
+const menu = args.menu;
+if (!specOut) throw new Error('Missing --spec-out');
+if (!menu) throw new Error('Missing --menu');
+
+const contractAbs = resolveFromRepo(contractOut);
+const contractForPackage = path.relative(packageRoot, contractAbs);
+mkdirSync(path.dirname(contractAbs), { recursive: true });
+
+run([
+  '--filter',
+  '@epoint-testtech/ep-stage-skill',
+  'generate:crud-contract',
+  '--',
+  '--module-id',
+  moduleId,
+  '--docs',
+  docs,
+  '--code-list',
+  codeList,
+  '--webapp',
+  webapp,
+  '--java-actions',
+  javaActions,
+  '--hints',
+  hints,
+  '--out',
+  contractForPackage
+]);
+
+const contract = JSON.parse(readFileSync(contractAbs, 'utf8'));
+if (contract.unresolvedSlots?.length) {
+  console.error(JSON.stringify({
+    error: 'Contract has unresolvedSlots; update ModuleHints before generating a final spec.',
+    unresolvedSlots: contract.unresolvedSlots.map(({ slotId, reason, suggestedFormat }) => ({
+      slotId,
+      reason,
+      suggestedFormat
+    }))
+  }, null, 2));
+  process.exit(2);
+}
+
+const specAbs = resolveFromRepo(specOut);
+mkdirSync(path.dirname(specAbs), { recursive: true });
+
+run([
+  '--filter',
+  '@epoint-testtech/ep-stage-skill',
+  'generate:playwright-tests',
+  '--',
+  '--contract',
+  contractForPackage,
+  '--out',
+  specAbs,
+  '--menu',
+  menu
+]);
+
+console.log(JSON.stringify({
+  module: contract.module,
+  searchConditions: contract.searchConditions?.map(({ field, label, component, value }) => ({
+    field,
+    label,
+    component,
+    value
+  })),
+  contract: contractAbs,
+  spec: specAbs
+}, null, 2));