mcpField
P
proxyman-debugging-tools

proxyman-debugging-tools

github.com/proxymanapp开发22212 次安装10 周前更新
代码仓库

关于 proxyman-debugging-tools

proxyman-debugging-tools 是以文档为先的技能，用于规划 Proxyman 调试工作流。它引导查阅最新官方文档，区分 GUI、MCP 和 CLI 路径，并强调验证与回滚。

主要功能

  1. 01获取最新官方文档
  2. 02按症状匹配文档页面
  3. 03区分 GUI、MCP 和 CLI 路径
  4. 04提供验证与回滚指引
  5. 05针对敏感流量的安全指引

适用场景

  1. 01规划 Proxyman 流量调试工作流
  2. 02查找功能的最新设置步骤
  3. 03判断任务是否支持 MCP 或 CLI
  4. 04记录安全变更与验证方法

MCP 相关

该技能区分 MCP 操作与文档查询；需要执行操作时，会引导使用相关 Proxyman MCP 工具。内置 MCP 文档搜索覆盖设置和故障排查，不包括完整的公开文档目录。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/proxymanapp/proxyman-skill.md --skill proxyman-debugging-tools

安装后在 Claude Code 中输入/proxyman-debugging-tools确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
debugging-tool-index.md
protocol-decoding-and-key-logging.md
replay-and-routing.md
request-response-modification.md

详细介绍

Proxyman 调试工具与文档

使用 Proxyman 官方文档来讲解或规划调试工作流。本技能以文档为先：不假定存在名称相似的 MCP 或 CLI 操作。

当主要任务是立即操作 MCP 时，使用 proxyman-traffic-debugging。审查 Settings 选项卡或更改偏好设置时，使用 proxyman-app-settings；管理本地根证书／自定义证书生命周期，或使用 Help 菜单中的 Debug Mode／Factory Reset 时，使用 proxyman-certificates-recovery；配置设备／运行时流量捕获时，使用 proxyman-https-capture；执行 Shell 自动化时，使用 proxyman-cli；管理许可证时，使用 proxyman-license-management。

获取最新文档

对于所有涉及当前行为的任务：

  1. 获取 https://docs.proxyman.com/llms.txt。
  2. 将用户提到的功能或症状与一个或多个官方 .md 条目匹配。
  3. 直接获取选中的 .md 页面。索引已提供页面路径时，不要凭记忆拼接路径。
  4. 通过仅删除所获取 URL 最末尾的 .md，引用公开 HTML URL。
  5. 如果页面链接到会实质影响操作步骤的前置条件或故障排除页面，也要获取该页面。

将 Proxyman 官方域名 docs.proxyman.com、docs.proxyman.io、proxyman.com、proxyman.io 以及 Proxyman MCP 实时服务器作为权威来源。最新获取的官方页面可能会链接到外部目标，但除非用户要求第三方指导，否则只将该目标视为其自身产品或服务的权威来源。

如果无法访问互联网，请说明无法核实最新页面。可以将随附的调试工具索引用作导航备用方案，但必须标明它是快照。

了解内置 MCP 文档

search_docs、answer_setup_question、docs://search/{query} 和静态 MCP 资源搜索的是 Proxyman 随附的设置与故障排除知识库。它们与版本匹配，适用于流量捕获诊断，但不代表 docs.proxyman.com 的完整目录。

对于涉及整个产品功能的问题，即使 search_docs 返回了结果，也要获取公开索引。对于准确的 MCP 输入，以 tools/list 为准，而非公开 MCP 页面或本技能。

编写答案或指南

  1. 确定用户目标、目标流量、平台，以及用户需要的是说明、GUI 步骤、MCP 执行还是 CLI 自动化。
  2. 阅读最新官方页面，并提取前置条件、支持的平台、限制和验证行为。
  3. 查看调试工具索引，了解如何通过各接口使用相关功能。
  4. 仅提供受支持的操作路径：
    • **GUI：**根据最新页面提供菜单／屏幕位置和有序的操作步骤。
    • **MCP：**提供当前工具名称、发现要求、状态读取、修改和验证步骤。
    • **CLI：**引导至 proxyman-cli；给出准确参数前，先查明已安装版本的帮助信息。
  5. 提供具体的验证方法：预期流量、规则清单、状态字段、响应变化或导出的文件。
  6. 对持久规则、代理更改、证书信任或流量捕获自动化提供回滚方法。

如果文档说明某项功能仅支持 GUI，请明确说明。不要臆造 MCP／CLI 功能对等性。

指南结构

使用以下精简结构：

Goal
Prerequisites
GUI steps
MCP steps (if exposed)
CLI steps (if exposed)
How to verify
How to undo
Limits / platform notes
Official docs

跳过没有内容的接口部分，不要为了填充答案而添加内容。

安全

  • 从只读发现和流量检查开始。
  • 更改代理路由、信任存储、全局工具状态、外部代理凭据或其他应用前，先征求确认。
  • 删除、清除会话、卸载证书、执行破坏性导入或进行不可逆的门户操作前，立即征求确认。
  • 保持启用 MCP 脱敏。提醒用户，导出的原始流量不会经过 MCP 预览脱敏。
  • 除非用户明确要求且了解暴露风险，否则不要将许可证密钥、TLS 会话密钥日志、令牌、密码、Cookie 或捕获的机密粘贴到指南或工具输入中。
  • 除非在本任务中获取过页面，否则不要声称页面是最新的。

覆盖范围

该参考资料涵盖捕获／查看／筛选工具、Repeat／Compose、Breakpoint、Map Local／Remote、Block／Allow List、Scripting、No Caching、External／Reverse／SOCKS proxy、SSL Proxying、证书、WebSocket、Protobuf／GraphQL、Network Conditions、DNS Spoofing、导出、代码生成、diff、OpenAPI、TLS Key Logging 以及相关的 GUI 工具。

如果当前索引新增了调试页面，即使快照中没有，也要使用该页面，然后说明当前产品提供了哪些界面。

评论

支持 Markdown