proxyman-cli

Proxyman CLI

使用用户当前 Proxyman 版本随附的 CLI。切勿假定命令层级或标志与静态文档一致。

发现与版本匹配的语法

如果已连接 Proxyman MCP：

1. 使用空命令路径调用 get_proxyman_cli_help，获取顶层帮助。
2. 再次调用该工具，仅提供命令名称，例如 export-log 或 rules map-local create。
3. 切勿在 command_path 中包含标志、值、管道、重定向或 Shell 语法。
4. 使用返回的语法，然后通过 Agent 宿主的 Shell 执行已获授权的操作命令。MCP 辅助工具不会执行该命令。如果某命令唯一受支持的机密输入方式是作为参数传入，例如经过审核的 activate 命令，则提供带占位符的命令供用户运行。

如果 MCP 不可用：

1. 在不更改 Shell 配置文件的情况下找到实际可执行文件。
2. 使用该可执行文件运行 --help。
3. 逐级运行嵌套的 --help，直到了解所有必需参数和选项。
4. 如果 CLI 不存在，则转到应用安装／更新或 GUI；不要使用猜测的语法代替。

官方命令行页面可供了解背景信息，但精确语法以已安装版本的帮助信息为准。阅读命令目录以选择命令层级，然后实时查询。

执行前制定计划

1. 将用户意图转换为一个命令层级。
2. 尽可能通过 MCP、CLI 的 list/get 命令或 GUI 检查当前状态。
3. 对命令分类：
   • 只读：帮助、list、get、status；
   • 文件系统写入：export 和 export-log；指定明确的目标路径，并在覆盖现有文件前确认；
   • 可撤销的更改：on/off、enable/disable、create/update；
   • 破坏性／敏感操作：unlink、delete/remove、clear、覆盖导入、根证书／自定义证书更改、涉及凭据的操作。
4. 展示用占位符替换机密信息后的命令形式。
5. 对破坏性操作，或用户新提出的系统／信任／代理更改，获取确认。
6. 执行一次，记录退出状态、标准输出和标准错误，并对机密信息脱敏。
7. 使用单独的 status/list/get 操作验证状态。

安全规则

• 切勿编造标志，也不要在未经检查已安装版本帮助信息的情况下依赖命令示例。
• 切勿在输出中泄露许可证密钥、证书密码、代理凭据、Cookie、令牌或捕获到的机密信息。
• 优先通过 GUI 输入许可证。经过审核的 activate 命令只接受通过参数传入密钥，这可能导致密钥暴露在 Shell 历史记录、进程列表和 Agent 工具调用中。
• 切勿通过 Agent 宿主执行带有真实密钥的位置参数形式 activate。提供与当前版本匹配、带有 <LICENSE_KEY> 的命令形式，让用户在自己的终端中替换并直接运行。
• 避免将证书密码写入已提交的脚本或可重复使用的 Shell 历史记录。使用当前帮助信息所支持的最安全输入方式。
• 根据实际影响处理 activate、unlink、clear-session、规则 delete/remove、带覆盖选项的配置导入、自定义／根证书更改和代理路由更改。
• 不要仅因为 MCP 返回了帮助信息就运行生成的 Shell 命令。执行仍须由用户请求和确认决定。
• 使用明确的文件路径。导出前验证输出路径，导入／证书操作前验证输入路径。
• 除非用户明确要求，否则不要修改 Shell 配置文件来让可执行文件变得可用。

主要命令类别

已安装的版本可能提供：

• 许可证：activate、unlink；
• 应用状态：proxy、proxy-host、mcp、clear-session；
• 配置：export、import；
• 日志：export-log；
• 证书：custom-cert、install-root-cert；
• 调试工具：Breakpoint、Map Local、Map Remote、Scripting、Block List、Allow List、Reverse Proxy、Network Condition、No Caching、DNS Spoofing、External Proxy；
• 在 rules 下统一管理规则操作。

请将此处视为路由说明，而非语法说明。有关规则工作流，请阅读 规则自动化。

重要工作流

MCP 服务状态

如果用户希望持久启用或禁用 Proxyman 的 MCP 服务（包括应用关闭时），请使用与版本匹配的 mcp on/mcp off 层级命令。启用后请重新加载 MCP 客户端，并在期待工具正常运行前启动 Proxyman。

激活许可证

查看 activate --help，但不要向用户索要密钥，也不要通过 Agent 宿主执行已审查的定位参数形式。请提供带有 <LICENSE_KEY> 的命令格式，让用户自行运行。成功激活后，请让用户重启 Proxyman，再验证许可证状态；未经明确授权，不要退出应用。

导出日志或配置

1. 查看输出格式、筛选条件、流边界选项和路径规则。
2. 明确目标位置，除非用户要求，否则避免覆盖文件。
3. 提醒用户，捕获的日志可能包含未脱敏的机密信息。
4. 确认生成的文件存在，并报告其路径和大小，不要泄露其中的机密内容。

导入配置

1. 验证源路径，并查看合并/覆盖规则。
2. 说明现有配置会保留还是被替换。
3. 覆盖或替换前必须征求确认。
4. 验证最终的规则清单。

证书

请区分默认的 Proxyman CA 与导入自定义根证书或服务器/客户端证书。查看相关子命令、证书类型、密码处理方式和信任选项。更改任何信任存储前必须征求确认。

结果格式

报告：

Executable/version:
Command hierarchy:
Action:
Exit status:
Sanitized output:
Verification:
Rollback or next step:

如果未获授权或无法执行，请提供带占位符且已验证的命令格式，并准确说明用户还需完成哪些操作。