Guide

AI 助手、图片传输与 Webhook

AI 辅助、图片上传到远程服务器,以及 Webhook 自动化

AI 助手、图片传输与 Webhook

MTerm 不仅仅是基础的终端模拟器,还内置了 AI 辅助、无缝的图片传输到远程服务器功能,以及基于 Webhook 的推送通知。这些功能专为使用 AI 编程工具并需要保持工作流连接的开发者设计。


AI 助手

AI 助手是一个覆盖在终端上的浮动面板,让你无需离开工作区即可即时获取 AI 辅助。

工作原理

点击软键盘栏上的 AI 按钮(或使用命令面板)打开浮动助手面板。AI 可以看到你的终端输出并将其作为回复的上下文。

主要功能

  • 终端上下文感知 — 助手可以读取终端中正在发生的事情,因此你可以直接问”这个错误是什么意思?“或”如何修复这个问题?“而无需粘贴任何内容
  • 文本选择集成 — 在终端中选择文本,然后直接发送给 AI 进行分析、解释或故障排除
  • 命令建议与安全警告 — 当 AI 建议命令时,它会标记潜在的危险操作(如 rm -rfDROP TABLE),让你做出知情决定
  • SSE 流式传输 — 响应实时逐词流式传输,无需等待完整响应即可开始阅读
  • 多语言支持 — AI 以匹配你设备语言环境的语言回复

Claude Code 模式

MTerm 包含专为 Claude Code 设计的输入模式:

  • 浮动输入面板 — 专用的文本输入区域,优化用于编写较长的提示词
  • 图片和文件附件 — 附加照片、截图或文件与提示词一起发送。这对于向 Claude Code 分享 UI 原型、错误截图或设计参考特别有用
  • iPad 全部输入功能 — 使用完整的 iPad 键盘、听写和剪贴板功能来舒适地编写提示词

AI 助手需要 Pro 套餐 + Subscribe


图片传输

通过 SFTP 将 iPad 或 iPhone 上的图片直接上传到远程服务器。这专为需要快速将图片放到服务器上的工作流设计 — 为错误报告附加截图、上传 Web 项目资源,或与 AI 工具分享参考图片。

工作原理

  1. Cmd + I 或点击图片传输按钮
  2. 从设备相册中选择照片
  3. 选择远程服务器上的目标目录
  4. 配置压缩和命名选项
  5. 上传

配置选项

选项说明
压缩质量调整 JPEG 压缩以平衡文件大小和图片质量
最大尺寸设置上传图片的最大尺寸(宽/高)
文件命名选择基于时间戳的名称、UUID 或顺序编号
目标目录选择服务器上的目标文件夹。如果不存在,MTerm 会自动创建

智能功能

  • 自动插入路径 — 上传完成后,远程文件路径会自动插入到终端中。这意味着你可以立即在命令中引用上传的文件,无需手动输入路径。
  • 并行上传 — 多张图片同时上传,即使在较慢的连接上批量上传也很快。

图片传输需要 Pro 套餐


Webhook 通知

Webhook 通知让你在远程服务器上的事件触发时,在设备上接收推送通知。这个功能让你在长时间运行的任务进行中,可以安心离开 MTerm 去做其他事情。

常见用例

场景工作原理
Claude Code 任务完成设置一个 Webhook,当 Claude Code 完成代码生成时触发。你会收到推送通知,可以返回查看输出。
CI/CD 流水线警报在构建完成、测试通过或失败、或部署完成时接收通知。
服务器监控在服务器宕机、磁盘空间不足或检测到错误激增时收到警报。
自定义自动化任何能发出 HTTP 请求的系统都可以触发你设备上的推送通知。

工作原理

MTerm 为你创建的每个 Webhook 提供一个 REST API 端点。任何能发出 HTTP POST 请求的系统都可以触发推送通知。API 接受包含通知标题和正文的 JSON 负载。

Webhook 配置

  • 自定义 Webhook — 创建带有自定义名称和描述的 Webhook
  • 发送历史 — 查看所有已接收 Webhook 事件的日志
  • 每日配额 — Webhook 使用量有限制以防止滥用

Webhook 限制

套餐每日 Webhook 数
免费10
Pro100
Subscribe无限制

集成示例

要在长时间运行的脚本完成时触发通知:

# 添加到脚本末尾
curl -X POST https://api.mterm.app/webhook/YOUR_WEBHOOK_ID \
  -H "Content-Type: application/json" \
  -d '{"title": "Build Complete", "body": "Your project finished building successfully."}'

你可以将类似的调用添加到 CI/CD 流水线、cron 任务、监控脚本或任何其他自动化流程中。

Webhook 通知需要 Subscribe