用途:自动探索 Hexagone Web 的功能空间,遍历菜单页面并截图,输出面向产品负责人(PO)的 Markdown 功能说明文档,文档内嵌截图。
主要能力:通过 Playwright 无头 Chromium 登录 Hexagone Web;展开侧边栏、列出全部菜单页;逐页访问并截图(page.screenshot() 直接存盘,无需中转);识别页面内的内部标签(如 Saisie/Consultation)并分别截图;提取表格、表单、操作等元数据,生成含功能描述、关键能力、业务价值和截图的 Markdown。
必要用法:前置需 Node.js 与 Playwright(npm install playwright;npx playwright install chromium),并能访问 Hexagone Web 服务器(默认 https://ws004202.dedalus.lan:8065/hexagone-01/vue/login)。需提供目标空间名称,登录 URL、用户名、密码可选(有默认值)。运行流程分六步:安装并启动浏览器、登录、导航到目标空间、发现菜单页、逐页探索截图、生成文档。生成文档用 node scripts/generate-md.js --input features.json --output /path/to/output.md --screenshots /path/to/screenshots,输入 features.json 需含 space 与 features 数组,每项含 title、description 等字段。结果校验可用 grep -c '^## [0-9]' output.md。
限制与要点:所有 Vue.js 交互必须用 page.mouse.click(),不能用 page.evaluate() 中的 el.click();每次点击菜单前需重新展开侧边栏并重新获取坐标;侧边栏元素用 [class*="cursor:pointer"] 而非 a.hexa,并需剥离图标文本;标签选择用 [role="tab"] 或 .v-tab;需排除排序按钮等非页面项;若发现零项应停止并截图调试。默认视口 1920x1080 及各超时、坐标参数适用于标准布局,布局不同需调整。自签名证书由 ignoreHTTPSErrors 处理。默认凭据等细节见资料,具体环境宜按实际情况提供。