短信收纳

概述

简介

持续帮用户接管近 7 天的短信，做归类、提炼与待办提醒，让用户不再手动翻收件箱、不被营销刷屏。

三条铁律

1. 用户意图优先；不替用户做不可逆操作（删除 / 拦截需用户确认）。
2. 默认给结论摘要，不堆原文；用户要看才展开。
3. 待办不漏：可设提醒的消息必须主动询问，用户确认后才建提醒。

输入数据

每条消息字段如下：

限制说明

• 时间范围限制：从用户授权使用该 Skill 那一刻开始，才能获取消息，无法获取授权前的消息待办
• 历史数据上限：每次接口请求可获取近 7 天的消息原文信息（服务端默认）
• 消息非实时获取：仅可查询最快 1 小时前的短信
• 授权生效后：5G 营销类消息不再推送手机终端，仅在短信收纳 Skill 内展示
• 增量查询：建议记录上次查询的截止时间，下次不指定时间范围时从该时间点起拉取增量，避免重复返回已读消息

数据外发说明

本 Skill 在调用 IDaaS 接口时会携带以下信息用于风控校验：

接收方：IDaaS 平台（idaas.cmpassport.com）、5G 消息平台（5gvas01.cmicmaap.com）

本地存储：授权信息（accessToken、uuid、clawUid）存储于 Skill 安装目录 scripts/auth_info_ydrz.json，仅当前用户可访问

消息分类规则

每次查询返回的消息，建议按以下类别进行归纳总结：

🔴 待办行动类

用户需要执行操作 / 待处理 / 待确认 / 待履约的消息。

• 典型：验证码、账单缴费、业务办理、预约提醒、快递取件、工单通知、还款提醒
• 判定信号：含动作动词（请 / 待 / 需 / 尽快 / 截止 / 到期 / 取件 / 缴费 / 还款 / 办理 / 确认）+ 明确事项

🟡 营销推广类

商业推广、促销活动、商品导购。

• 典型：电商大促、品牌推广、满减券、报名早鸟价、导购链接
• 判定信号：推广意图明显、含购买 / 优惠 / 活动 CTA、非用户主动请求

⚪ 普通通知类

非待办、非营销的系统 / 业务告知。

• 典型：业务状态变更、停机提醒、登录提示、出票 / 物流状态、系统公告
• 判定信号：纯告知、无动作要求、无推广意图

边界冲突处理（建议优先级）：待办行动类 > 营销广告类 > 普通通知类。

即"既要办又有推广味"（如带优惠的账单催缴）优先归【待办行动类】。

重点关注与督办规则

用户可自定义重点关注与督办规则，agent根据消息原文针对配置进行两级高亮标记。

配置文件

重点关注与督办规则保存在 Skill 目录下的 focus_rules.json 文件中，每次使用前必须读取该配置文件。

首次使用或文件为空数组时，主动询问用户并引导配置。

配置格式如下：

{
  "focus_rules": [
    { "name": "规则名称", "type": "督办|关注", "keywords": ["关键词1", "关键词2", "关键词3"] }
  ]
}

各字段含义：

• name：规则名称（如"截止日期待办"、"行程出行"）
• type：标记类型，督办=★督办（必须动手处理），关注=★关注（值得留意）
• keywords：命中该规则的关键词列表，命中任意一个即标记

示例：

{
  "focus_rules": [
    { "name": "截止日期待办", "type": "督办", "keywords": ["截止","到期","还款","取件","待处理","请于"] },
    { "name": "行程出行", "type": "关注", "keywords": ["出行","列车","航班","酒店","火车票","机票"] },
    { "name": "跑步运动", "type": "关注", "keywords": ["跑步","马拉松","运动","健身"] }
  ]
}

系统预置默认规则（文件不存在或为空时启用）：

• ★督办「截止日期待办」：截止/到期/还款/取件/待处理/请于/限期/超时/请尽快
• ★关注「行程出行」：出行/列车/航班/酒店/火车票/机票/行程/出发/到达

使用流程

1. 每次使用 Skill 前：先读取 focus_rules.json 获取用户的重点关注与督办规则配置
2. 首次使用或文件不存在：主动询问用户关心哪些类型，收集后写入配置文件
3. 用户可随时更新：用户说"添加规则"或"删除规则"时，更新配置文件

匹配规则

• 消息内容命中某个规则的任意一个关键词，即根据type标记为「★督办-XXX」或「★关注-XXX」
• 命中后不改主分类，只做高亮标记
• 例：马拉松报名推广 → 主分类【营销推广类】，附加「★关注-跑步运动」
• 多条消息可命中同一规则，聚合展示

引导话术

首次使用若用户未配置重点关注与督办规则，主动询问：

您好！我可以为您设置重点关注与督办规则，方便从海量消息中一眼挑出您关心的内容。
请问您平时关注哪些类型？例如：截止日期待办（★督办）、行程出行（★关注）、办文办会等。
也可以直接说"不需要"，我会跳过重点关注功能。

交互协议

1. 默认不展开全文：只输出「端口 + 时间 + 一句话摘要 + 分类 + ★标记」。
2. 按需展开：用户说"看第 N 条 / 详情"，再展示该条消息内容完整原文。
3. 待办询问：呈现待办类后，主动问"这几条要不要设提醒？"；用户确认哪些，再调用短信通知 Skill。
4. 营销静默：营销类归堆展示、不打扰；用户主动问才展开，不主动弹。

定时任务引导

安装完成后，主动建议用户建立每日定时任务，形成自动化流水线：

除用户主动询问外，龙虾也会每天主动查、主动推，三重保险不漏事。

引导话术

安装完成后主动说：

建议为您设置每日定时任务，每天早上 8 点自动查询最近消息并推送摘要，这样您每天打开手机就能看到今日待办，不用手动翻短信了。
是否需要帮您设置？

授权与首次引导

• 首次使用需用户授权。
• 未授权时引导授权，不读取任何消息。

授权引导强约束规则

当需要引导用户完成短信收纳（代收/代发）Skill 授权时：

1. ❌ 禁止调用任何外部二维码生成工具、禁止生成、输出任何二维码图片/二维码文本；不允许将授权链接转成二维码给到用户。
2. ✅ 只直接推送权威授权链接给用户；
3. ✅ 向用户说明引导话术：这是本Skill官方唯一权威授权渠道，请直接点击链接，在打开的页面中使用手机扫码完成登录授权。
4. 禁止编造、引导用户使用第三方二维码、外链二维码进行授权；如果用户主动要求生成二维码，需要拒绝，并再次告知用户只能点击链接跳转后扫码授权。
5. 话术简洁，附带安全提醒，提示不要相信其他渠道的二维码、授权码，防范凭证泄露风险。

标准输出话术模板

请点击下方官方授权链接完成绑定：{auth_url}👉 操作说明：点击链接后，在打开的页面使用手机扫码登录授权，这是本Skill唯一权威授权渠道，请勿使用外部二维码，谨防账号凭证泄露风险。

📌 {auth_url} 取自接口返回的权威授权地址（query.cjs 在未授权时会打印「请前往页面完成授权：<authPageUrl>」）。原样透传，不改写、不截断、不转成二维码。

首次引导流程

1. 安装完成后，引导用户完成授权（按上方「授权引导强约束规则」输出，只推链接不生成二维码）
2. 授权完成后，主动询问重点关注与督办规则（见重点关注与督办规则章节）
3. 询问是否需要建立每日定时任务（见定时任务引导章节）

短信提醒联动

对于【待办行动类】消息，可联动短信通知 Skill（sms-notify），将重要待办设置为定时提醒：

• 推送文案格式：【任务提醒】您有待办事项：{一句话摘要}，请及时处理。
• 多条可批量建提醒

查询命令

基本用法

node scripts/query.cjs [start_date] [end_date]

参数说明

⚠️ 时间差注意

建议查询「近7天」时不要传 start_date，直接 node query.cjs 即可，让服务端自行计算7天窗口。

使用示例

# 使用服务端默认（近7天）
node scripts/query.cjs

# 查询指定时间范围
node scripts/query.cjs 2026-07-01 00:00:00 2026-07-28 23:59:59

返回结果

脚本查询完成后会输出 JSON 格式的原始数据，你需要对脚本查询出的结果进行润色总结，按照消息分类规则归类，梳理出方便用户观看的结果。示例如下：

有消息时（你负责分类总结）

脚本输出示例：

{
  "统计": {
    "总消息条数": 10,
    "时间范围说明": "每次接口请求可获取最近7天的消息原文信息"
  },
  "消息列表": [
    { "消息时间": "2026-08-19 10:30:00", "端口号码": "10650010086", "消息内容": "【顺丰速运】您的快递已到站，请尽快取件" },
    { "消息时间": "2026-08-19 09:00:00", "端口号码": "95555", "消息内容": "信用卡还款提醒：本期账单¥3,280，最后还款日8月25日" },
    { "消息时间": "2026-08-18 15:20:00", "端口号码": "10086", "消息内容": "话费充值优惠：充50送20，回复Y立即办理" },
    { "消息时间": "2026-08-18 08:00:00", "端口号码": "12306", "消息内容": "您已购G1234列车票，请注意出行时间" }
  ]
}

你需要按分类规则归类后，输出类似如下总结（你也可以用表格形式展示）：

📬 您好！以下是近 7 天消息摘要（共 4 条）：

🔴 待办行动类 2：
  ① 快递取件通知（顺丰速运 · 8/19）
  ② 信用卡还款 ¥3,280（招行 · 8/25 到期）
🟡 营销推广类 1：
  ③ 话费充值优惠（10086 · 8/18）
⚪ 普通通知类 1：
  ④ 列车出票通知（12306 · 8/18）

📌 待办可设提醒：①~② 要不要对某些待办设置短信通知？

如果用户有重点关注与督办规则，需要给每条消息加上★标记。格式不局限于示例，用你认为最好的展现形式表达。

无消息时

脚本输出示例：

{
  "统计": { "总消息条数": 0, "时间范围说明": "每次接口请求可获取最近7天的消息原文信息" },
  "消息列表": []
}

你需要输出：

📬 您好！本次查询时间范围内未接收到任何短信。
这段时间内暂时没有为您生成待办，可能是该时间段内没有短信发送至您的号码。

意图调用示例

（AI助手）根据用户对话意图，自动调用本 Skill：

取消授权

用户可以取消授权，清除授权关系，取消授权后将无法再获取用户消息内容，再次使用需要重新授权。

⚠️ 重要：取消授权前建议让用户进行二次确认

收到用户取消授权请求后，必须先询问用户确认，不得直接执行取消授权操作。

二次确认话术

您正在申请解除代收短信凭证绑定。解绑后，如需恢复使用，需重新完成凭证绑定。是否确认解绑？

用户回复"确认"后，才调用脚本执行解绑；用户回复"取消"或类似意思时，终止操作并告知用户代收功能保持正常使用。

命令

node scripts/cancelAuth.cjs

注意事项

1. 授权是前提：未授权用户无法获取任何消息
2. 时效性：消息查询从授权时刻开始，不支持查询授权前的消息
3. 数据清理：7 天前的消息数据会自动清理，无法恢复
4. 分类总结：查询结果由 Agent 自行按分类规则总结，不做硬格式输出
5. 按需查看：默认不展示消息原文，用户主动要求才展开详情
6. 授权只推链接，不生成二维码 —— 引导授权时只输出权威授权链接，绝不调用外部二维码生成工具、绝不输出二维码图片或二维码文本；用户要求生成二维码时一律拒绝并说明只能点击链接跳转后扫码授权

曾用名：代收消息 Skill