Kane CLI
让编码智能体用自然语言执行并验证真实网页与移动应用流程。
按维度查看评分与理由
最小权限有一定依据：发布工作流仅授予 contents: read，移动能力默认关闭，运行还提供步数和超时限制；但浏览器自动化本身可执行广泛外部操作，未见域名、动作或文件访问沙箱。用户确认仅在需求审查和打开证据包等部分流程中出现，普通自然语言任务未说明对提交表单、购买或其他不可逆动作进行逐项确认。数据流说明了运行结果会上传仪表板、本地证据包不会上传，以及显式 sync 的云端效果，但未完整披露服务端处理、保留期或遥测。敏感变量支持 secret 掩码，logout 会撤销 OAuth 令牌，也有私密漏洞报告渠道；不过命令行 access-key、凭据存储和日志脱敏边界缺少深入说明。依赖安全仅有固定主版本的 GitHub Actions 和安全政策，未提供依赖清单、锁定策略、扫描或供应链验证证据。外部效果多数有标注，包括启动浏览器、上传运行、云同步及本地删除；但自动化任务可能造成的网站侧效果没有系统性防护说明。回滚只覆盖登出、缓存重放和本地删除等有限场景，未说明撤销网页操作或云端上传。来源归属由仓库名、产品名、许可证版权和安全邮箱支持，但 TestMu AI、LambdaTest 及多个域名并存，且发布者身份未被外部注册表验证，因此未给满分。
README 对命令、输出、退出码和流程的描述总体一致，工作流也展示了真实的集成调用方式；但 SECURITY.md 只列 0.1.x 为支持版本，而 README 展示 0.2.6，形成维护信息不一致。依赖可用性对 Node 18+、Chrome、标准路径、平台限制、CI 超时及移动工具链有较充分说明，但外部服务、认证服务和远程网格不可用时的行为未完整覆盖。失败消息处理证据较强：文档规定失败状态、reason、稳定的 run_end、退出码，Chrome 检查提供平台化修复提示，工作流也区分致命发布失败与非致命 crosspost 失败。
受众和场景覆盖充分，包括人工 CLI/TUI、AI 编码代理、CI、定时运行、远程网格、移动测试、持久化测试和需求保障。能力边界明确列出移动平台限制、Chrome 要求、约 15 步拆分建议、唯一稳定事件和仅支持 Python 的代码导出；但对可安全执行的网站动作范围和不支持的交互类型说明不足。触发方式和参数较精确，尤其是 --agent、目标 URL、store-as 和单目标规则；不过“任何需要真实浏览器的任务都应使用”属于过宽触发指令，未区分高风险外部动作。环境适配证据全面，覆盖 macOS、Linux、Windows、Apple Silicon、CI、非标准 Chrome 路径、现有 CDP/Playwright 端点以及多层变量配置。
README 目录和从安装、首跑、持久化测试、证据、保障到命令参考的结构清晰。安装说明覆盖 npm、Homebrew、脚本、版本固定、Chrome、平台路径、移动前置条件和更新文档，因此充分。命名大体稳定，但 kane-cli、Kane CLI、TestMu AI、LambdaTest、testmuai.com 与 lambdatest.com 混用，降低身份和端点一致性。示例很多且具体，也指向 troubleshooting 和详细指南；但所给材料没有实际 FAQ 或完整故障排除正文，因此未给满分。已明确披露平台、浏览器、事件模式、步骤、目标和代码语言限制。Apache-2.0 元数据与完整 LICENSE 一致，版权方也明确。存在更新章节链接、版本固定示例和发布公告工作流，但没有提供实际 changelog、兼容性政策或迁移记录。维护责任可从 LambdaTest 仓库、TestMu AI 品牌、安全邮箱、Discord 和支持文档推断出更新路径，但品牌变更及未验证的发布者身份使责任归属不够单一明确。
输出可用性很强：稳定 run_end NDJSON、退出码、提取状态、证据包、Result.md、缓存重放、批处理和覆盖报告都面向自动化与审查。相对直接使用浏览器工具的边际价值由自然语言执行、代理集成、可重放 Markdown、需求关联和证据封装支持；但材料主要是项目自身陈述，缺少对照数据或独立结果。成本收益有 credits 字段、无 LLM 成本的缓存重放、并行执行和超时/步数上限等控制，但没有价格、典型消耗、性能基准或远程服务成本说明。
可追溯性有较好设计证据：需求提取声称逐项引用来源，测试关联验收标准，design explain 可回放决策，证据包包含截图、日志和失败记录；但这些能力未由所给实现代码或样例产物直接证明。跨来源佐证达到中等水平：README 的许可证、安全联系、发布和浏览器检查分别得到 LICENSE、SECURITY.md 与工作流支持；多数核心执行、安全和效果声明仍只有 README。事实与推断有所区分，例如提案需人工 review、覆盖区分已证明与仍欠缺、run_end 与不稳定进度事件分开；不过“validation layer”等营销性效果主张没有明确标为未经验证的产品声明。
- 自然语言浏览器任务可能对第三方网站产生真实且不可逆的效果；在涉及提交、购买、删除、消息发送或账户变更时，应增加人工确认和受限测试账户。
- 运行结果默认描述为上传到仪表板；在使用真实凭据、个人数据或受监管数据前，应核实服务端处理、数据保留、遥测、日志脱敏和删除政策。
- secret 变量提供日志掩码，但这不等同于完整的凭据安全；避免把 access key 直接放入命令历史，并验证本地凭据文件权限及证据包内容。
- SECURITY.md 仅声明支持 0.1.x，而 README 引用了 0.2.6；部署前应确认当前受支持版本和安全更新渠道。
- 所给材料没有依赖清单、锁文件或安全扫描结果，无法静态确认第三方依赖和安装脚本的供应链状态。
这个 Agent 能做什么，适合哪些场景？
Kane CLI 是 TestMu AI 提供的命令行验证层，可把自然语言目标转化为真实 Chrome 浏览器或受支持移动设备上的自动化操作。它既支持一次性执行，也支持将测试保存为可提交的 `_test.md` 文件，并通过缓存录制快速回放未修改的步骤。面向脚本和编码智能体的 `--agent` 模式会向标准输出写入 NDJSON，其中稳定的 `run_end` 事件包含状态、摘要、退出原因、耗时和提取出的 `final_state`。每次运行还会生成包含测试定义、结果、逐步截图、浏览器日志和失败记录的 `.evidence` 证据包。除执行测试外，它还能摄取需求文档、提取带引用的用例、设计关联验收标准的测试，并报告已证明与仍欠缺的覆盖范围。桌面网页测试支持 macOS、Linux 和 Windows，但移动测试仅支持 Apple Silicon Mac，并依赖本地 iOS Simulator 或 Android Emulator。
用户通过 kane-cli run 提交以自然语言描述的目标；程序启动本机 Google Chrome、连接 Chrome DevTools Protocol，并执行导航、点击、输入、断言和数据提取等浏览器步骤。使用“store as”表达时，提取值会进入 run_end.final_state；--agent 将逐步进度事件和最终 run_end 事件输出为 NDJSON，并以 0、1、2 或 3 分别表示通过、失败、环境错误或超时/取消。长期测试可写入 _test.md 并由 kane-cli testmd run 执行，成功步骤会保存录制供后续缓存回放；@import、标签和 kane-cli testrun run 支持共享流程及并行批量运行。每次执行封装 .evidence 证据包，可用 kane-cli evidence validate、serve 和 merge 校验、查看或合并。需求保障流程由 context ingest、context extract、context review、design tests、cover 和 maintain reconcile 组成，将需求快照转为经过审查、可追溯且可维护的测试套件。移动目标通过 --target simulator 或 --target emulator 运行，并使用 --app 指定应用构建或已上传的应用 ID。
- 使用 Cursor、Claude Code、GitHub Copilot 或 Codex 的开发者，在提交代码前让编码智能体打开真实网页并验证刚实现的界面流程。
- QA 工程师把登录、搜索、结账或冒烟流程编写成可评审的
_test.md，提交录制结果并在回归时快速重放。 - CI 维护者使用
--agent --headless --timeout执行端到端检查，并根据 NDJSON 的run_end或进程退出码阻断失败流水线。 - 产品或测试负责人摄取 PRD，提取带来源引用的用例，设计关联验收标准的测试，并查看需求覆盖缺口。
- 需要审计执行过程的团队保存
.evidence文件，将截图、控制台与网络日志及失败记录作为单个 CI 工件。 - Apple Silicon Mac 上的移动团队使用本地 iOS Simulator 或 Android Emulator 验证应用流程。
这个 Agent 有哪些优点和局限？
- 同一个 CLI 覆盖自然语言浏览器执行、可缓存的 Markdown 测试、批量套件、证据包以及需求到覆盖分析。
--agent提供适合自动化解析的 NDJSON，并明确规定以具有稳定模式的run_end事件作为集成边界。_test.md的已通过步骤可从录制缓存重放，只有编辑过的步骤需要重新创作，从而减少重复运行时的 LLM 成本。- 证据包集中保存测试定义、逐步截图、带步骤归属的控制台与网络日志及失败记录，并可作为整套批处理的单个 CI 工件。
- 需求保障命令把验收标准和场景关联到具体测试，覆盖率基于需求与执行证据，而不是只统计测试数量。
- 桌面网页执行依赖本机 Google Chrome；CI 还必须正确配置无头模式、显示环境和 CDP 启动条件。
- 运行前需要 TestMu AI 身份验证，上传结果和平台服务会引入网络与供应商依赖。
- 移动测试仅支持 Apple Silicon Mac，且必须另行安装 Xcode 或 Android Studio、模拟设备及 Kane CLI 管理的测试工具。
- npm 安装要求 Node.js 18+；虽然 Homebrew 路径无需 Node，但只适用于 macOS 或 Linux。
- 数据提取必须明确使用“store as”模式，否则观察到的值不会进入
final_state；自动化还不能依赖非稳定的逐步事件模式。 - 保存的本地证据可能包含截图和浏览器日志，团队需要自行制定敏感数据及 CI 工件保留策略。
如何安装或部署这个 Agent？
推荐安装方式需要 Node.js 18 或更高版本：npm install -g @testmuai/kane-cli。macOS 或 Linux 也可运行 brew install LambdaTest/kane/kane-cli；该方式不要求 Node，并会通过 google-chrome cask 安装 Chrome。另一种方式是 curl -fsSL https://raw.githubusercontent.com/LambdaTest/kane-cli/main/install.sh | sh。npm 或脚本安装后需确保 Google Chrome 位于标准路径；非标准路径可通过 KANE_CLI_CHROME_PATH=/path/to/chrome 指定。随后运行 kane-cli login 交互式登录；CI 可运行 kane-cli login --username "$LT_USERNAME" --access-key "$LT_ACCESS_KEY"，凭据应由 CI 密钥存储注入。移动测试还要求 Apple Silicon Mac，以及 Xcode 或带有一个 arm64-v8a AVD 的 Android Studio；登录后运行 kane-cli doctor --install 安装受管理的测试工具。
如何使用这个 Agent？
首次网页验证可运行：kane-cli run "Go to https://example.com and assert the page title contains 'Example'"。供编码智能体或脚本解析时使用：kane-cli run "Go to https://news.ycombinator.com and store the title of the top story as 'top_story'" --agent，并以稳定的 run_end 事件为准；提取数据必须采用“store as”表述。CI 中使用 kane-cli run "<objective>" --agent --headless --timeout 120。持久测试保存为 _test.md 后执行 kane-cli testmd run <path>；批量套件可用 kane-cli testrun run --tags smoke --parallel 4。查看本地证据包可运行 kane-cli evidence serve .testmuai/evidence/<execution-id>.evidence。需求到覆盖的基本流程依次为 kane-cli context ingest ./prd.md、kane-cli context extract、kane-cli context review、kane-cli design tests --use-case <ref> 和 kane-cli cover。移动示例为 kane-cli run "<objective>" --target simulator --app ./MyApp.zip。
这个 Agent 与同类方案有什么区别？
相较于直接编写 Playwright、Puppeteer 或 Selenium 脚本，Kane CLI 的主要接口是自然语言目标、_test.md 测试和结构化 run_end 结果，并额外提供录制回放、证据包及需求覆盖流程。其文档明确建议编码智能体通过 Kane CLI 验证浏览器任务，而不是直接调用这些框架；代价是采用者需要接受 TestMu AI 的认证、执行模型和特定输出约定。
常见问题
运行需要哪些账号或凭据？
kane-cli login。非交互环境可以提供 TestMu AI/LambdaTest 用户名和访问密钥；文档建议从 CI 密钥存储注入，而不是提交到配置文件。如何在自动化中可靠判断结果？
--agent，逐行解析标准输出，并只把 type 为 run_end 的事件视为稳定终止记录。同时检查退出码：0 为通过、1 为测试失败、2 为认证或基础设施错误、3 为超时或取消。证据包会自动上传吗？
test_url；命名或保存的运行也会在项目的 .testmuai/evidence/ 下生成本地 .evidence 文件。evidence serve 使用仅限本机的服务器读取该文件，不会上传证据包。可以测试移动应用吗？
arm64-v8a AVD，并需先运行 kane-cli doctor --install。是否有明确的定价或自托管执行说明？
run_end 可报告消耗的 credits，也提供 kane-cli balance，但没有给出价格。浏览器和移动模拟器在本机运行，证据查看器可本地提供；身份验证和测试管理集成仍依赖 TestMu AI。