# yyyyy114514/Telnix

Source: https://glimind.com/server/github%2Fyyyyy114514%2Ftelnix
Registry id: `github/yyyyy114514/telnix`
Status: unknown

## Tools (80)

- `agent_end`: 恢复 agent_start 之前保存的状态（规则/专注/断点/忽略列表）。 注意：自动修改规则需要 Telnix 运行才生效，因此系统代理未关闭、Telnix 未退出。 请询问用户是否关闭 Telnix；用户同意后再调 system_quit。
- `agent_start`: 开启 agent 工作区：保存当前状态（规则/专注/断点）→ 禁用规则 → 关闭专注/断点 → 把 agent 进程加入忽略列表。 完成工作后必须调 agent_end 恢复原状。重复 start 会报错（避免覆盖未恢复的备份）。
- `agent_status`: 查看 agent 工作区状态。
- `breakpoint_off`: 关闭断点。 Args: bp_type: 断点类型 request|response
- `breakpoint_on`: 开启断点。 Args: bp_type: 断点类型 request|response timeout_seconds: N 秒未放行自动 release（0=不自动超时）
- `breakpoint_release`: 放行/丢弃断点暂停的流量。 Args: flow_id: 单个流量 ID（与 all_pending 互斥） action: release=放行, drop=丢弃 all_pending: true=批量操作所有 pending 断点
- `breakpoint_status`: 查看断点状态（是否开启、pending 流量列表）。
- `breakpoint_timeout`: 设置断点自动放行超时（N 秒未放行自动 release）。 Args: seconds: 超时秒数（0=禁用自动超时）
- `capture_clear`: 清空当前会话的所有流量记录。
- `capture_pause`: 暂停抓包（会话保留，代理仍跑，区别于 stop）。
- `capture_resume`: 恢复抓包记录。
- `capture_start`: 开始抓包。返回 session_id。 Args: layer: 抓包层 http=仅HTTP代理(默认), tcp=仅TCP/UDP(WinDivert需管理员), all=两者都抓 auto_stop_seconds: N 秒后自动停止抓包（0=不自动停，agent 不用自己 sleep+stop） pid_fil
- `capture_stop`: 停止抓包（会话保留，代理仍运行）。 Args: layer: 停止哪层 http=仅HTTP(默认), all=同时停TCP/UDP
- `cert_install`: 安装 HTTPS 根证书（需要 UAC 提权）。
- `cert_remove`: 移除已安装的 HTTPS 根证书。
- `cert_status`: 查看 HTTPS 证书安装状态。
- `focus_off`: 关闭专注模式。
- `focus_on`: 开启专注模式（只抓指定进程/host 的流量）。 Args: pids: PID 列表，逗号分隔 process_names: 进程名列表，逗号分隔 hosts: host 通配符列表，逗号分隔 include_children: 是否包含子进程
- `focus_status`: 查看专注模式状态。
- `get_status`: 获取 Telnix 后端状态（抓包状态、会话、代理、证书等）。 返回 JSON，包含 capturing/session_id/system_proxy_on/cert_installed 等字段。
- `intercept_add`
- `intercept_del`: 删除拦截规则。 Args: rule_id: 单个规则 ID ids: 批量删除，逗号分隔（优先于 rule_id）
- `intercept_export`: 导出所有规则为 JSON（直接返回内容，不写文件）。
- `intercept_hits`: 查看某规则的命中统计 + 最后命中的流量详情。 Args: rule_id: 规则 ID
- `intercept_import`: 从 JSON 字符串导入规则。 Args: rules_json: JSON 字符串，格式 {"rules": [...]} 或 [...]（直接用 intercept_export 的输出） mode: merge=追加, replace=先清空再导入
- `intercept_list`: 列出所有拦截规则（含命中统计）。
- `intercept_template_apply`: 应用规则模板创建规则。 Args: name: 模板名称 match: 匹配表达式 note: 备注 disabled: true=创建为禁用状态 method_filter: 方法过滤 status_filter: 状态码过滤 pid_filter: PID 过滤 process_filter: 进程名过滤
- `intercept_template_list`: 列出所有内置规则模板。
- `intercept_toggle`: 启用/禁用拦截规则。 Args: rule_id: 规则 ID enabled: true=启用, false=禁用
- `intercept_update`: 修改现有规则（不删除重建）。 Args: rule_id: 规则 ID match: 新的匹配表达式（空=不改） action: 新的动作规范（空=不改） note: 新备注（空=不改） enable: 启用规则 disable: 禁用规则
- `log_clear`: 清空所有日志。
- `log_export`: 导出日志为 JSONL 文本（直接返回内容，不写文件）。 Args: level: 日志级别过滤 category: 日志分类过滤 keyword: 关键词过滤
- `log_tail`: 查看最近日志。 Args: limit: 返回条数 level: 日志级别过滤（DEBUG/INFO/WARN/ERROR） category: 日志分类过滤
- `packets_analyze`: 签名字段自动检测：对比多条同接口请求的 JSON body，找可疑签名/token 字段。 Args: flow_ids: 流量 ID 列表，逗号分隔（至少 2 条；search_all 时至少 1 条作为源） search_all: true=以第一个 ID 为源，从 /flows/all 拉后续流量 limit: 
- `packets_clear`: 清空流量。 Args: all_sessions: true=清空所有会话流量, false=仅当前会话 before_id: 只清 id < N 的流量（0=清全部）
- `packets_delete`: 删除流量。 Args: flow_id: 单个流量 ID ids: 批量删除，逗号分隔的 ID 列表（优先于 flow_id）
- `packets_diff`: 对比两条流量的指定字段，输出 unified diff。 Args: flow_id1: 第一条流量 ID flow_id2: 第二条流量 ID field: 对比字段 response_body|request_body|request_headers|response_headers
- `packets_endpoints`: 唯一 endpoint 提取（path 模板归一化，画 API 地图）。 Args: session: 会话 ID（0=跨会话） limit: 拉取流量上限（0=不限） host: 按主机过滤 keep_query: 保留 query 参数名 sample_strategy: 采样策略 first|last|rando
- `packets_export`: 导出单个流量为指定格式。 Args: flow_id: 流量 ID fmt: 格式 curl|python-requests|postman|json|csv
- `packets_get`: 获取单个流量详情。 Args: flow_id: 流量 ID field: 只取指定字段 request_body|response_body|raw_data（空=全部）
- `packets_list`: 列出当前会话的流量（默认 NDJSON 风格的 JSON 数组）。 Args: session: 会话 ID（0=当前活动会话） limit: 最多返回条数（默认100） since_id: 增量查询，只返回 id > N 的流量（非阻塞轮询） filter_expr: 过滤表达式 'key op value && .
- `packets_list_all`: 列出跨所有会话的流量（全局分析用）。 Args: host: 按主机过滤 process: 按进程名过滤 method: 按方法过滤 status_code: 按状态码过滤 protocol: 协议过滤 http|tcp|udp|ws|dns limit: 最多返回条数 offset: 分页偏移 since_id: 增
- `packets_overview`: 多维聚合统计概览（CoolUI 仪表盘数据源，跨会话全量）。 一次返回所有维度的聚合统计，包括：总数、总字节、入站/出站字节、成功/错误计数、 平均耗时，以及按协议/方法/状态码区间/Host/进程/IP属地 分组的计数列表（各 top 20）。 适用于生成流量监控仪表盘、全局概览报告。不需要会话 ID 参数。
- `packets_search`: 正则搜索流量 body。 Args: body_regex: 正则表达式（搜索 request_body + response_body） binary_hex: 二进制搜索（hex 字符串，与 body_regex 互斥） search_all: true=跨所有会话搜索, false=仅当前会话
- `packets_stats`: 流量统计（按 host/method/status 分组计数）。 Args: session: 会话 ID（0=当前活动会话）
- `packets_tag`: 流量标签管理。 Args: flow_id: 流量 ID（list_all=true 时可省略） add: 添加标签 remove: 移除标签 clear: 清空所有标签 note: 设置备注 clear_note: 清除备注 list_all: 列出全局所有标签及每标签的 flow 数
- `packets_timeline`: 流量时间线（按时间排序，标注大间隔段落）。 Args: session: 会话 ID（0=跨会话） limit: 拉取流量上限 host: 按主机过滤 gap_seconds: 大间隔阈值（秒），超过此值算新段落
- `packets_trace`: 请求依赖链 trace：从指定 flow 的响应提取字符串值，在后续流量的请求里搜索。 Args: flow_id: 源流量 ID min_length: 最小字符串长度（过滤短串减少误报） limit: 拉取后续流量上限 search_all: true=跨会话扫描, false=仅当前会话
- `processes_ignore`: 添加忽略进程（不抓该进程的流量）。 Args: pid: 进程 PID（与 name 二选一或都填） name: 进程名（如 chrome.exe）
- `processes_ignore_host`: 添加忽略 host 通配符（如 *.example.com）。 Args: host: host 通配符
- `processes_ignored_hosts_list`: 列出已忽略的 host。
- `processes_ignored_list`: 列出已忽略的进程。
- `processes_list`: 列出有网络连接的进程。 Args: name: 按名称模糊过滤 with_connections: 包含连接快照 tree: 进程树模式 include_listen: 包含监听端口
- `processes_unignore`: 取消忽略进程。 Args: row_id: 忽略列表中的行 ID
- `processes_unignore_host`: 取消忽略 host。 Args: row_id: 忽略 host 列表中的行 ID
- `proxy_off`: 关闭系统代理。
- `proxy_on`: 开启系统代理（让所有应用流量走 Telnix）。
- `proxy_status`: 查看系统代理状态。
- `raw_capture_install`: 安装 pydivert（TCP/UDP 抓包依赖）。 非 Windows 平台：pydivert 是 Windows 专属包，直接返回"不支持"错误。
- `raw_capture_start`: 启动 TCP/UDP 抓包（需管理员权限 + pydivert）。 Args: pid_filter: 按 PID 过滤，逗号分隔 port_filter: 按端口过滤，逗号分隔 bpf_filter: WinDivert filter 字符串 非 Windows 平台：WinDivert 是 Windows 专属驱动
- `raw_capture_status`: 查看 TCP/UDP 抓包状态。
- `raw_capture_stop`: 停止 TCP/UDP 抓包。
- `replay`: 重放指定流量。可覆盖 body/method/url/headers。 Args: flow_id: 要重放的流量 ID body: 覆盖请求 body（空=用原 body） method: 覆盖 HTTP 方法 url: 覆盖目标 URL host: 覆盖目标 host port: 覆盖目标端口 headers: 覆
- `replay_batch`: 批量时序重放指定会话的全部流量。 Args: session: 会话 ID（必填） filter_expr: 客户端过滤表达式，只重放匹配的流量 parallel: 并发数（1=串行） preserve_timing: true=按原始时间间隔重放（测限流/风控）
- `send_request`: 从零发包（Composer 功能），不依赖已有 flow。 Args: method: HTTP 方法（GET/POST/PUT/DELETE 等） url: 目标 URL（必须以 http:// 或 https:// 开头） headers: 请求头，JSON 字符串 '{"K":"V"}' 或 HTTP 文本 'K
- `sessions_create`: 创建新会话并切换为活动会话。 Args: name: 会话名称（可选）
- `sessions_delete`: 删除会话。 Args: session_id: 会话 ID
- `sessions_list`: 列出所有会话。
- `sessions_show`: 查看会话详情。 Args: session_id: 会话 ID
- `sessions_switch`: 切换到指定会话（后续操作默认在此会话）。 Args: session_id: 会话 ID
- `settings_get`: 读取所有设置或单个 key 的值。 Args: key: 可选。指定时只返回该 key 的值；省略则返回全部设置。 Returns: 全部设置 dict，或 {"key": ..., "value": ...}
- `settings_proxy_engine`: 查看或切换代理引擎（builtin / async / mitmproxy）。 Args: name: 引擎名。省略则仅查看当前引擎，不修改。 - builtin：内置线程代理（默认，零依赖，稳定） - async：asyncio 代理（实验性，高并发无 GIL 瓶颈） - mitmproxy：mitmproxy 引擎
- `settings_set`: 写入单个设置项。value 字符串会自动尝试 JSON 反序列化（bool/数字/list/dict）。 Args: key: 设置项 key（如 "proxy_engine"） value: 设置项 value。传 "true"/"false" 会被解析成 bool， 传 "123" 会被解析成数字，传 "[1,2]
- `system_install_dep`: 触发 pip 安装可选依赖（如 mitmproxy）。 异步任务：本工具返回 status=running 后需轮询 system_install_dep_status 查询进度。 安装完成后需调用 system_restart 让新引擎加载到当前进程。 Args: package: 包名，目前仅支持 "mitmpro
- `system_install_dep_status`: 查询 install_dep 任务状态。 Returns: {"status": "idle|running|success|failed", "package": ..., "log": ..., ...} status=success 且 package=mitmproxy 时额外返回 mitmproxy_avai
- `system_quit`: 退出 Telnix（清系统代理 + 退出）。
- `system_restart`: 重启 Telnix 后端（同进程内 os.execv 重启）。
- `system_restart_as_admin`: 以管理员身份重启 Telnix（UAC 提权，用于 TCP/UDP 抓包）。 会触发 GUI 用户确认流程：后端创建 pending 请求 → 弹原生 Windows 顶层弹窗 → 用户同意 → UAC 提权 → 返回 accepted；用户拒绝 → 返回 rejected。 最多等待 3 分钟（3 次 60s 长轮询
- `system_windivert_warning_ack`: 标记 WinDivert 风险提示为已确认（永久不再提示）。 调用后 settings.json 的 windivert_warning_acknowledged 设为 1， 后续 raw_capture_start / transparent_proxy_start / dns_hijack_start 不再被拦截。
- `system_windivert_warning_status`: 查询 WinDivert 风险提示状态。 返回: needed: 是否需要提示（仅 Windows 平台 + 未确认时为 true） message: 风险说明文本 ack: 当前是否已确认 platform: 当前平台 说明：raw_capture_start / transparent_proxy_start / 

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
