# 📲 DSH-SmsWebhook
**DeepSeek Harness 短信转发 Webhook 插件**
[](https://www.npmjs.com/package/dsh-sms-webhook)
[](https://github.com/huaxiren6/DSH-SmsWebhook/blob/main/LICENSE)
[](https://github.com/huaxiren6/DSH-SmsWebhook)
接收手机短信转发 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://<电脑IP>:8899/
Content-Type: application/jsonJSON 格式（字段名兼容常见别名）：
{
"from": "10086",
"body": "您的验证码是 123456，5 分钟内有效。",
"receivedAt": 1787180000000,
"device": "Pixel 8"
}from也可写作sender/number/phonebody也可写作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 里限制来源，或仅在可信网络使用。