camofox-cli

1. 概述

本文档介绍经过全面验证的 CamoFox CLI 功能（50 条命令），并按类别分组。

• 使用 --format json 获取机器可读的输出
• 大多数命令在省略 [tabId] 时会自动解析当前活动标签页
• 在整个工作流中保持 --user <user> 不变，以确保会话状态一致

2. 核心命令（5）

camofox open <url> [--user <user>] [--viewport <WxH>] [--geo <preset>]
camofox close [tabId] [--user <user>]
camofox snapshot [tabId] [--user <user>]
camofox click <ref> [tabId] [--user <user>]
camofox type <ref> <text> [tabId] [--user <user>]

3. 导航命令（4）

camofox navigate <url> [tabId] [--user <user>]
camofox screenshot [tabId] [--path <file>] [--output <file>] [--full-page] [--user <user>]
camofox go-back [tabId] [--user <user>]
camofox go-forward [tabId] [--user <user>]

4. 内容命令（7）

camofox get-text [tabId] [--selector <selector>] [--user <user>]
camofox get-url [tabId] [--user <user>]
camofox get-links [tabId] [--user <user>]
camofox get-tabs [--user <user>]
camofox eval <expression> [tabId] [--user <user>]
camofox wait <condition> [tabId] [--timeout <ms>] [--user <user>]
camofox search <query> [tabId] [--engine <engine>] [--user <user>]

搜索引擎：google、youtube、amazon、bing、reddit、duckduckgo、github、stackoverflow。

5. 交互命令（6）

camofox fill '<assignments>' [tabId] [--user <user>]
camofox scroll [direction] [tabId] [--amount <N>] [--user <user>]
camofox select <ref> <value> [tabId] [--user <user>]
camofox hover <ref> [tabId] [--user <user>]
camofox press <key> [tabId] [--user <user>]
camofox drag <fromRef> <toRef> [tabId] [--user <user>]

fill 的赋值格式：

[e1]="value1" [e2]="value2"

6. 控制台与错误捕获（2）

camofox console [tabId] [--user <user>] [--type <type>] [--limit <N>] [--clear]
camofox errors [tabId] [--user <user>] [--limit <N>] [--clear]

7. 跟踪命令（5）

camofox trace start [--user <user>] [--screenshots] [--snapshots]
camofox trace stop [--user <user>] [--output <file>]
camofox trace chunk-start [--user <user>]
camofox trace chunk-stop [--user <user>] [--output <file>]
camofox trace status [--user <user>]

8. 会话命令（4）

camofox session save <name> [tabId] [--user <user>]
camofox session load <name> [tabId] [--user <user>]
camofox session list [--format <format>]
camofox session delete <name> [--force]

9. 下载/ Cookie 命令（4）

camofox cookie export [tabId] [--path <file>] [--user <user>]
camofox cookie import <file> [tabId] [--user <user>]
camofox download [url] [--path <dir>] [--user <user>]
camofox downloads [--user <user>] [--format <format>]

10. 身份验证命令（5）

camofox auth save <profile-name> [--url <url>] [--notes <notes>]
camofox auth load <profile-name> [--inject [tabId]] [--username-ref <ref>] [--password-ref <ref>] [--user <user>]
camofox auth list [--format <format>]
camofox auth delete <profile-name>
camofox auth change-password <profile-name>

11. 服务命令（3）

camofox server start [--port <port>] [--background] [--idle-timeout <minutes>]
camofox server stop
camofox server status [--format <format>]

12. 高级命令（4）

camofox annotate [tabId] [--user <user>] [--output <file>] [--format <format>]
camofox health [--format <format>]
camofox version [--format <format>]
camofox info [--format <format>]

13. 流水线命令（1）

camofox run <script-file> [--continue-on-error]

run 会执行顺序运行的 CLI 命令脚本（文件路径或表示标准输入的 -）。它不会执行 JavaScript/TypeScript 源文件。

14. 全局选项

--user <user>
--port <port>
--format <format>    # json|text|plain
--local              # reserved for v2
-V, --version
-h, --help

15. 完整命令索引（50）

1. open
2. close
3. snapshot
4. click
5. type
6. navigate
7. screenshot
8. go-back
9. go-forward
10. get-text
11. get-url
12. get-links
13. get-tabs
14. eval
15. wait
16. search
17. fill
18. scroll
19. select
20. hover
21. press
22. drag
23. console
24. errors
25. trace start
26. trace stop
27. trace chunk-start
28. trace chunk-stop
29. trace status
30. session save
31. session load
32. session list
33. session delete
34. cookie export
35. cookie import
36. download
37. downloads
38. auth save
39. auth load
40. auth list
41. auth delete
42. auth change-password
43. server start
44. server stop
45. server status
46. annotate
47. health
48. version
49. info
50. run