<div align="center">
📲 dsh-sms-webhook
DeepSeek Harness 短信转发 Webhook 插件
  
接收手机短信转发 App 推来的消息,落盘存储,让模型可以读取手机短信(验证码场景开箱即用)。
</div>
---
简介
在电脑上起一个本地 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 里限制来源,或仅在可信网络使用。
License
[MIT](LICENSE)