短信转发 Webhook huaxiren6/DSH-SmsWebhook

📲 DSH-SmsWebhook

banner

DeepSeek Harness 短信转发 Webhook 插件

npm version
license
GitHub stars

接收手机短信转发 App 推来的消息，落盘存储，让模型可以读取手机短信（验证码场景开箱即用）。

简介

在电脑上起一个本地 HTTP 服务，手机上的短信转发 App（SMS Forwarder / Tasker / iOS 快捷指令）把新短信 POST 过来，插件落盘存储并暴露给模型查询。

功能特性

- 📨 sms_recent — 最近短信（可选关键词过滤）
- 🔍 sms_search — 全文搜索存储
- 🔑 自动提取 otp 字段（第一个 4–8 位数字），验证码直接可用
- 💾 JSONL 落盘，重启不丢（上限 5000 条自动裁剪）
- 🔎 可选 keywords 白名单，只收含指定词的短信（如 ["验证码", "code"]）

安装

dsh plugin --profile web add dsh-sms-webhook

手机端设置

用任意能「转发短信到 HTTP」的 App，例如：

- SMS Forwarder（安卓，最常用）
- Tasker / MacroDroid 的自定义 HTTP POST
- iOS 的快捷指令（收到短信 → 获取 URL 内容）

转发目标填：

POST http://:8899/
Content-Type: application/json

JSON 格式（字段名兼容常见别名）：

{
"from": "10086",
"body": "您的验证码是 123456，5 分钟内有效。", "receivedAt": 1787180000000, "device": "Pixel 8" }

- from 也可写作 sender / number / phone
- body 也可写作 text / message / content
- 时间戳省略则用服务器当前时间

HTTP 接口

| 方法/路径 | 用途 |
| POST / | 接收短信（200=已存储，202=被关键词过滤） |
| GET /?limit=20&q=验证码 | 查询最近短信（q 可选过滤） |
| GET /health | 存活探针 |

配置

| 键 | 默认 | 含义 |
| host | 0.0.0.0 | 监听地址（局域网转发保持默认） |
| port | 8899 | 监听端口 |
| store | $DSH_HOME/data/dsh-sms-webhook/messages.jsonl | 存储文件 |
| keywords | [] | 非空时只收含这些词的消息（如 ["验证码", "code"]） |

⚠️ 0.0.0.0 意味着局域网内任何人都能 POST——建议在手机 App 里限制来源，或仅在可信网络使用。

License

MIT