Repository navigation
Releases
v0.2.0
Stable js-test-mapper release. The trigger surface now clearly requires an authorized test environment and read-only analysis, with no business-state changes, no active business API calls, and no credential storage. The Skill continues to use the host agent's existing browser and code-observation capabilities; no independent Runtime or executor is included.
js-test-mapper v0.1.1-rc.7
Installer self-repair candidate. Runtime reused unchanged from rc.6.
js-test-mapper v0.1.1-rc.6
Release candidate for fresh-host acceptance. Includes Chrome-first browser selection and automatic safe read-only navigation.
js-test-mapper v0.1.1-rc.5
Fresh-host acceptance candidate for the ASCII-only Windows installer UI. Runtime bytes are unchanged from v0.1.1-rc.2.
js-test-mapper v0.1.1-rc.4
仅修复 Windows CMD installer 的 CRLF 分发保护;Runtime 复用 v0.1.1-rc.2 已验证字节。
js-test-mapper v0.1.1-rc.3
仅修复 js-test-mapper 安装窗口 UI 与日志展示。Skill 与 Runtime 能力保持不变;Runtime 资产复用 v0.1.1-rc.2 已验证字节。
js-test-mapper v0.1.1-rc.2|标准 Skill 安装架构候选版
js-test-mapper v0.1.1-rc.2 是标准 Skill 安装架构候选版,用于 fresh host 真机验收,不是正式 v0.1.1。
普通用户只需下载并双击 install-js-test-mapper.cmd。安装器使用锁定的 Skills CLI 1.5.23,从 immutable v0.1.1-rc.2 tag 安装标准 Skill,然后由 Skill 内本地 runtime-bootstrap.mjs 校验并准备固定 SHA 的 Runtime TGZ。
公开 CMD 不下载或执行远程脚本,不使用 PowerShell Bypass。内部 Runtime、Playwright Library、AST、Source Map、Route/API/call chain、Stable ID、lineage、evidence、cognition、Business API Guard 和 Word/Excel 能力保持。
Runtime SHA-256: 61f097e13f1f37c546f160336892ab87c881a0e2f18fe0989b6cbc7f501390c2
Installer SHA-256: a0014a4068cf344a794ed6a12f74815c5d3a8d90518947aab8c1d688187723bf
js-test-mapper v0.1.1-rc.1|安装体验修复候选版
这是 js-test-mapper v0.1.1-rc.1 安装体验修复候选版,用于 fresh host 真实验收,不是正式 v0.1.1。
推荐安装流程:
- 只下载 install-js-test-mapper.cmd。
- 双击运行,安装器会自动安装 Skill 与 Runtime。
- 安装完成后重启 CC Switch / Codex。
- 使用自然语言直接调用 js-test-mapper。
本候选版只调整公开安装与仓库发布接线,未修改 Stage 2/3/4/5、cognition、traceability、Stable ID、Guard、Word/Excel 等分析能力。
校验值:
- Release ZIP SHA-256: 949c0c32b40843b9053da4acee2a426bd61e54563289701fa80056065439b1f6
- Runtime TGZ SHA-256: 2023ba964a201a3615d40b6776b7f9c885eaf669df7325282170c407d5a545a8
js-test-mapper v0.1.0|无需求-Web JS逆向测试建图
js-test-mapper v0.1.0|无需求-Web JS逆向测试建图
只有一个 Web Test URL,也能先把陌生系统看懂
js-test-mapper 是一个面向测试工程师的 Web 只读逆向分析执行型 Skill。
它解决的不是“帮我把一份需求文档改写成报告”,而是一个更常见、也更麻烦的问题:
刚接手一个陌生 Web 系统,需求不完整,接口文档可能也不全,甚至手里只有一个测试环境 URL——我该从哪里开始看、开始测?
你给它一个 Web Test URL,它会在明确的安全边界内真正执行一轮只读技术勘查:
- 启动浏览器并观察应用实际加载的 JS / Chunk;
- 发现 Route、Source Map 和技术资产;
- 解析 JS 结构与调用关系;
- 恢复代表性的调用链;
- 识别 API 引用、权限和状态线索;
- 登录场景下,可在同一 Browser / Context / Run 中继续观察登录后 lazy chunk;
- 再由 AI 基于已经形成的技术证据,整理成测试人员看得懂的系统认知。
最终得到的不是一堆压缩 JS,而是一份面向测试的:
- 系统功能与路由地图;
- JS 调用链与接口引用;
- 权限、状态与生命周期线索;
- 测试关注点、风险与待确认项;
- Word 过程小结;
- Excel JS 逆向测试资产表;
- 可追溯的 evidence。
用一个更通俗的比喻
假设你第一天接手一家大型商场。
没人给你完整设计图,也没人把每一层、每个房间、每条员工通道都讲清楚,只给你一把钥匙,说:
“你先负责测试一下。”
传统方式往往是自己一层一层逛、问产品、问开发、记入口、记权限、记哪些按钮可能连到哪些后台能力。
js-test-mapper 更像先派一支侦察队进去。
它会记录:
- 这里有哪些“楼层和入口”;
- 哪些区域互相连接;
- 哪些门有权限限制;
- 哪些动作背后引用了什么接口;
- 哪些路径和状态值得测试重点关注。
然后再由一个分析员把这些侦察事实整理成测试人员能看懂的地图。
所以可以把整个结构理解成:
Runtime / Playwright / Parser
= 侦察队:负责采集事实
AI cognition
= 分析员:只基于证据整理测试认知
Word / Excel / evidence
= 最终地图与侦察报告
最重要的是:
看不清的地方就明确标记“待确认”,而不是让 AI 自己补一个听起来合理但没有证据的业务解释。
它是“执行型 Skill”,但不是“业务测试执行器”
js-test-mapper 会真实执行:
URL
→ 浏览器只读勘查
→ JS / Chunk 采集
→ 程序分析
→ Evidence
→ AI cognition
→ Word / Excel
所以它不是一个单纯的“文档生成 Skill”。
但它也不会:
- 主动调用业务接口做探测;
- 主动发送 POST / PATCH / DELETE 等业务写请求;
- 点击保存、提交、删除、审核、启停、发布、支付、上传等状态变更动作;
- 替代测试工程师执行正式测试用例;
- 把“静态发现”包装成“已经测试通过”。
当前正式安全边界:
active_business_api_calls = 0
适合谁
测试工程师
刚接手陌生后台时,先得到模块、Route、调用链、接口引用、权限状态和后续测试重点,不用从零在 JS 和页面里摸索。
测试负责人
用于降低陌生系统和新人接手时的系统认知成本,先形成有证据来源的测试地图,再决定范围、风险和优先级。
产品经理
当需求资料与当前测试环境存在信息缺口时,可以看到哪些规则已经有技术证据、哪些业务含义仍需要产品明确。
开发工程师
它不是安全漏洞扫描器,也不是完整代码 Review,而是把前端实际暴露的 Route、调用关系、API reference、权限/状态线索转换成测试人员可消费的系统地图。
输入
最低只需要:
给我这个 Test 后台做 JS 逆向测试建图:
https://test.example.com
可选提供:
- 测试账号 / 已有登录会话;
- 前端源码;
- HAR;
- Source Map;
- 补充的系统背景。
没有源码也可以工作。
输出
默认生成:
<系统名>_JS逆向测试分析/
├── 过程小结.docx
├── JS逆向测试资产表.xlsx
└── evidence/
Excel 包含:
- 扫描批次与范围
- 系统功能与路由地图
- JS 调用链与接口引用
- 权限状态与生命周期
- 测试关注点与风险待确认
证据优先,而不是“AI 猜业务”
比如程序只能确认:
if (order.status === 2) {
...
}却没有任何证据说明 2 在这个公司的业务里叫“待支付”“审核中”还是别的状态。
js-test-mapper 不会擅自补成一个确定业务结论。
它会保留:
status=2 的业务含义待确认
这不是能力缺陷,而是本 Skill 的证据边界:
程序负责事实,AI负责认知;证据不足就保留未知。
v0.1.0
这是 js-test-mapper 的首个正式版本。
当前重点能力已经覆盖:
- Web Test URL 入口;
- Playwright 运行时资产采集;
- JS / Chunk / Source Map 技术分析;
- L1 → L2 → L3 渐进式分析;
- Route / API / Permission / State 关系恢复;
- 代表性 JS 调用链;
- Stable ID 与增量 B01 / B02 lineage;
- evidence traceability;
- AI cognition grounding;
- Word / Excel 正式交付;
- interactive login;
- public installer / repair / clean-room distribution;
- Business API Guard。
已知边界
v0.1.0 的目标是:
帮助测试快速建立陌生 Web 系统的可信认知地图。
它不是:
- 安全漏洞扫描器;
- 完整源码审计器;
- API 自动化执行器;
- UI 自动化测试执行器;
- 自动替代测试工程师完成整套测试的 Agent。
对于强动态 dispatch、自研前端 Runtime、极度混淆代码、未被当前账号访问到的 lazy 页面等场景,系统会按证据范围降级或保留“待确认”,而不是伪造完整结果。
安装与使用
请下载本 Release 中的:
js-test-mapper-0.1.0.zip
Windows 用户可使用包内 standalone installer。
环境要求:
Node.js >= 20
首次安装会准备匹配版本的 Playwright Chromium。
正式 Runtime 和 Release Artifact 均提供 SHA-256,可使用 release-manifest.json 与 checksum 文件核验完整性。
一句话总结
只有一个 Web 地址时,先让 js-test-mapper 帮测试把这个陌生系统“看懂”,再决定后面应该怎么测。
Reverse Test Workbench v0.1.0
First public Windows launcher for reverse-test-workbench. The launcher installs the host-neutral Skill through the repository's public installer entry.