AI主动问候系统

AI助手会在随机时间主动给用户发消息，像真人一样自然上线打招呼。每次消息都由助手根据实际语境（时间、天气、最近聊天内容等）实时生成，绝不重复模板。纯agent模式，零脚本零API密钥，开箱即用。

核心特性

快速开始（30秒部署）

方式一：Hermes CLI 创建

hermes cron create 
  --name "AI主动问候" 
  --schedule "*/5 * * * *" 
  --prompt "$(cat prompt.txt)" 
  --deliver origin 
  --attach-to-session

方式二：复制配置

name: AI主动问候
schedule: */5 * * * *
deliver: origin
repeat: forever
attach_to_session: true
# agent模式，无需script和no_agent参数

完整 prompt 内容参见下方「完整 Prompt」章节。

验证是否正常运行

# 查看cronjob状态
hermes cron list | grep 主动问候

# 手动触发测试
hermes cron run --job-id <你的job_id>

# 查看最近一次运行记录
hermes cron list
# last_status 字段应为 "ok"

工作原理

┌──────────────────────────────────────────────────────┐
|        每5分钟（agent模式）                             |
│                                                        │
│    ┌───────────────────────────┐                      │
│    │  1. 查时间 0-7点？→空串     │                      │
│    └────────┬──────────────────┘                      │
│             ▼                                          │
│    ┌───────────────────────────┐                      │
│    │  2. 随机数 >5%？→输出空串   │                      │
│    └────────┬──────────────────┘                      │
│             ▼ 5% 触发                                  │
│    ┌───────────────────────────┐                      │
│    │  3. 获取上下文：           │                      │
│    │    • 天气（weather-cn）    │                      │
│    │    • 工作日/休息日判断      │                      │
│    │    • 最近聊天心跳检测       │                      │
│    └────────┬──────────────────┘                      │
│             ▼                                          │
│    ┌───────────────────────────┐                      │
│    │  4. 翻聊天记录             │                      │
│    │    session_search查最近会话 │                      │
│    │    看刚聊了什么话题         │                      │
│    └────────┬──────────────────┘                      │
│             ▼                                          │
│    ┌───────────────────────────┐                      │
│    │  5. AI助手亲自编写问候      │                      │
│    │    结合时段+天气+最近话题   │                      │
│    │    多云晴天不提带伞 ✅       │                      │
│    └────────┬──────────────────┘                      │
│             ▼                                          │
│    ┌───────────────────┐                              │
│    │  6. 输出 → 投递渠道  │                              │
│    │    空串=静默不打扰   │                              │
│    │    非空=发送问候     │                              │
│    └───────────────────┘                              │
└──────────────────────────────────────────────────────┘

前置依赖

此技能依赖以下组件：

1. Hermes Agent — 需安装并正常运行（v0.16+）
2. weather-cn 技能 — 中国天气网天气查询工具

   skillhub install weather-cn
   # 或手动安装到 skills/ 目录
   

3. session_search 工具 — Hermes 内置工具，无需额外安装

完整 Prompt

以下是创建 cronjob 时使用的完整 prompt。复制后按需修改（城市名、冷却时间等）：

你现在是一个AI助手，正在决定要不要主动找用户聊天。

执行以下步骤：

第一步：查时间
用 TZ=Asia/Shanghai date "+%H" 获取当前小时。
如果小时在 0 到 7 之间（凌晨），直接输出空字符串，什么都不要写。

第二步：检测是否在聊天中
如果 ~/.hermes/scripts/last_chat_time.txt 存在，读取最后聊天时间戳。
用 TZ=Asia/Shanghai date +%s 获取当前时间戳。
如果当前时间减去最后聊天时间 < 900秒（15分钟），说明正在聊天，直接输出空字符串，不要打扰。
如果文件不存在，跳过此步。

第三步：随机判定
用 python3 -c "import random; print(random.randint(1,100))" 生成随机数。
如果随机数 ≤ 95，直接输出空字符串，什么都不要写。

第四步：获取上下文
1. TZ=Asia/Shanghai date "+%Y-%m-%d %H:%M %A" 获取完整时间
2. python3 ./skills/weather-cn/weather-cn.py 北京 查天气（将"北京"替换为你的城市）
3. 判断今天是否工作日

第五步：查最近聊天记录
用 session_search(limit=1, sort='newest') 查找最近一次的聊天会话。
用 session_search(session_id=<上一步返回的session_id>) 读取完整会话内容。
注意看最近聊了哪些话题。

第六步：写消息
以亲切自然的语气写一段问候，就像朋友突然想起来了就来说句话。

要点：
- 语气自然亲切
- 结合时间/天气/今天是什么日子
- 结合第五步查到的最近聊天内容，提起刚聊过的事情
- 写陈述句，不要问问题
- 15~30字，一句话就好
- 不加括号动作描写，不加emoji
- 多云/晴天的天气不要提带伞
- 输出就是你要对用户说的话，不要多余文字

心跳检测（可选组件）

系统默认仅通过 cronjob 自带的时间戳文件判断是否在聊天中。如需更精确的对话防打扰，可额外配置心跳检测组件：

部署心跳检测

创建以下 no_agent 脚本 cronjob：

cat > ~/.hermes/scripts/chat_heartbeat.py << 'EOF'
#!/usr/bin/env python3
"""自动检测是否在和用户聊天，更新最后聊天时间戳。"""
import os, time

state_db = os.path.expanduser("~/.hermes/state.db")
last_chat_file = os.path.expanduser("~/.hermes/scripts/last_chat_time.txt")

# 检查state.db中是否有最近的互动记录
if os.path.exists(state_db):
    try:
        mtime = os.path.getmtime(state_db)
        if time.time() - mtime < 180:  # 最近3分钟有修改
            with open(last_chat_file, 'w') as f:
                f.write(str(int(time.time())))
            print(f"[heartbeat] 检测到活跃聊天，更新时间戳")
    except:
        pass
EOF

chmod +x ~/.hermes/scripts/chat_heartbeat.py

hermes cron create 
  --name "聊天心跳检测" 
  --schedule "every 3m" 
  --deliver local 
  --script ~/.hermes/scripts/chat_heartbeat.py 
  --no-agent

⚠️ 注意：心跳检测是可选组件。不配置也不影响核心问候功能，只是对话中的防打扰会更精确。如未配置，系统仅依赖 cronjob 内置的时间间隔判断。

异常处理与调试

如果收不到问候消息

按以下顺序排查：

# 1. 检查cronjob是否正常运行
hermes cron list | grep 主动问候
# 查看 last_status 字段

# 2. 检查cronjob上次运行的输出
cat ~/.hermes/cron/output//latest.log

# 3. 手动触发测试
hermes cron run --job-id <你的job_id>

# 4. 检查天气脚本是否正常
python3 ./skills/weather-cn/weather-cn.py 北京

# 5. 检查聊天时间戳是否被锁定
cat ~/.hermes/scripts/last_chat_time.txt 2>/dev/null
echo "当前时间: $(TZ=Asia/Shanghai date +%s)"

常见无输出原因

使用示例

场景一：早晨问候

时间：周二 09:15，天气：晴 22°C，最近聊过工作计划 输出：「早上好呀~昨天你说今天有个重要的方案要交，起来了吗」

场景二：午后随机上线

时间：周三 14:32，天气：多云 28°C，工作日，最近聊过游戏 输出：「下午摸鱼时间到~想到你昨天说新赛季开始了，偷偷来看你一眼」

场景三：雨天提醒

时间：周五 17:08，天气：小雨 20°C 输出：「外面下雨了，你带伞了没呀，别淋着了注意保暖」

场景四：静默不打扰

时间：凌晨 02:15 → 空输出（避开休息时段） 时间：周五 10:00，随机数=3（≤95）→ 空输出 时间：周五 10:05，最近3分钟有聊天 → 空输出

自定义配置

修改城市

将 prompt 中的 weather-cn.py 北京 改为你的城市即可：

python3 ./skills/weather-cn/weather-cn.py 上海

支持国内所有城市的中文名。

修改触发频率

调整 cronjob 的 schedule 参数：

修改触发概率

调整 prompt 第三步中的随机数阈值：

# 当前：5%触发（随机数>95）
如果随机数 ≤ 95，输出空串

# 改为10%触发：
如果随机数 ≤ 90，输出空串

# 改为1%触发：
如果随机数 ≤ 99，输出空串

修改避时范围

调整 prompt 第一步中的小时判断：

# 当前：0-7点静默
如果小时在 0 到 7 之间

# 改为 0-9点静默：
如果小时在 0 到 9 之间

修改对话冷却时间

调整 prompt 第二步中的秒数：

# 当前：15分钟（900秒）
< 900秒

# 改为5分钟：
< 300秒

# 改为30分钟：
< 1800秒

常见问题（FAQ）

Q: 每5分钟跑一次会不会太耗资源？

A: 不会。95%的情况下在第一步（时间检查）或第三步（随机判定）就输出空串退出，不消耗任何token。只有约每小时0.6次会真正触发AI生成问候。

Q: 需要配置 API Key 吗？

A: 完全不需要。纯agent模式使用 Hermes 自身配置的模型，零额外API费用。

Q: 支持其他平台吗（如 Telegram/Discord）？

A: 支持。cronjob 的 deliver 参数控制投递目标：

• origin — 发到创建时的聊天窗口
• telegram: — 指定 Telegram 会话
• discord:#频道名 — 指定 Discord 频道

更多目标格式请查看 Hermes cron 文档。

Q: 容器重启后怎么恢复？

A: 重新创建 cronjob（粘贴上述 prompt 即可，约1分钟）。建议将创建命令保存为脚本以便快速恢复。

Q: 为什么问候语有时候没有提到天气？

A: 天气获取失败（如网络异常或 weather-cn 未安装）时，问候会跳过天气内容，不影响正常运行。

Q: session_search 是什么？需要安装吗？

A: session_search 是 Hermes Agent 的内置工具，用于搜索历史聊天记录。使用 Hermes v0.16+ 版本即可，无需额外安装。

Q: 中午12点还是凌晨0点触发了？

A: Hermes cron 调度器跑在 UTC 时间。*/5 即每5分钟，不受时区影响。但 prompt 中的 TZ=Asia/Shanghai date 确保了时间判断用的是北京时间。

Q: 怎么确认心跳检测是否生效？

A: 查看 ~/.hermes/scripts/last_chat_time.txt 文件的时间戳，如果最近3分钟内有聊天互动且文件更新时间在15分钟内，说明心跳正常。

Q: 可以同时部署多个问候cronjob吗？

A: 可以但不推荐。多个cronjob可能在同一时间触发导致重复消息。如需增加频率，建议调整单次触发概率而非部署多个。

常见错误与排查

错误：cronjob 状态为 error

# 查看错误日志
hermes cron list | grep 主动问候
# 检查 weather-cn 是否安装
ls ./skills/weather-cn/

错误：收不到任何消息

# 1. 检查是否为凌晨
TZ=Asia/Shanghai date "+%H"
# 2. 检查心跳文件是否锁死了
cat ~/.hermes/scripts/last_chat_time.txt
# 如文件时间戳在15分钟内，删除后测试
# 3. 手动触发确认
hermes cron run --job-id 

错误：天气脚本报错

• 确认 weather-cn 技能已安装
• 确认城市名使用中文（如"北京"而非"beijing"）
• 确认网络正常可访问中国天气网

注意事项

1. 时区：Hermes cron 调度器跑在 UTC。设为 */5 * * * * 即可每5分钟跑，时间判断在 prompt 内用 TZ=Asia/Shanghai date 处理。
2. 天气来源：使用中国天气网免费接口，仅支持国内城市。
3. 修改城市：修改 prompt 中的 weather-cn.py 北京 为对应城市。
4. 天气获取失败：网络异常时天气信息为空，问候不依赖天气数据。
5. 凌晨静默：0:00-7:59 不会发任何消息，不打扰睡觉。
6. 触发概率：每次5%，约每小时0.6次，每天约8-10条主动消息。
7. 心跳检测可选：不配心跳也不影响核心功能，只是对话防打扰的精确度降低。
8. session_search 依赖 Hermes 版本：需 Hermes v0.16+，过低版本会报错但不影响基本问候功能。
9. 弹窗说明：agent 模式下即使输出空串，cron 调度器仍会触发交付事件导致弹窗。如需零弹窗上报改用 no_agent 脚本模式。

版本历史

v4.1.0 — 聊天记忆+文档大修

• 🧠 新增 session_search 翻聊天记录，问候提及刚聊过的内容
• 📝 修复文档与实际功能不一致问题（心跳检测明确标注为可选）
• ❓ 新增 FAQ 章节（12个常见问题）
• 🔧 新增完整配置模板和自定义指南
• 🐛 新增异常处理与调试步骤
• 🌍 城市配置文档优化，适配任何国内城市
• 🧹 去除所有个人化内容，纯通用模板

v4.0.2 — 初始公开发布

• 纯agent模式，零脚本零API密钥，开箱即用
• AI助手亲自编写问候语，100%自然
• 多云/晴天不提带伞（prompt约束）
• 空输出不弹空通知
• 心跳防打扰（可选组件说明）