一只会在互联网上"游荡"的自动化信息猎犬，有自己的小脾气和行动逻辑。

赛博街溜子是一个侧重于工具调用 (Tool Use) 和自主规划的 Agent 项目。它打破了传统 AI"你不问它就不动"的死板模式——它有自己的"饥饿值"和"无聊值"，会在后台自主运行，从互联网上搜罗各种有趣的内容推送到你的设备。

• 郦署一个一直在后台运行的 Agent
• Agent 有初始的"饥饿值"或"无聊值"
• 当感到无聊时，它会自主调用搜索引擎
• 机发现奇奇怪怪的新闻、梗图、或你关注领域的最新动态
• 用特定的语气（海盗腔、脱口秀风格等）把内容推送到你的设备

┌─────────────────────────────────────────────────────┐
│                   Cyber Stray Agent                 │
├─────────────┬─────────────┬─────────────┬──────────┤
│  State Mgr  │   Planner   │   Tools     │ Notifier │
│  (饥饿/无聊) │  (自主规划)  │  (搜索/爬取) │ (消息推送)│
└─────────────┴─────────────┴─────────────┴──────────┘
         │                │                │
    ┌────▼────┐     ┌─────▼─────┐    ┌─────▼─────┐
    │ Bun     │     │ Search    │    │ Telegram  │
    │ Cron    │     │ APIs      │    │ Feishu    │
    └─────────┘     └───────────┘    └───────────┘

• 无聊值: 随时间增长，触发自主搜索行为
• 饥饿值: 搜索后"进食"内容，降低饥饿感
• 心情: 影响推送语气和内容选择偏好

• 基于当前状态决定行动
• 选择搜索领域（新闻、梗图、游戏、技术等）
• 生成搜索关键词和策略

• 搜索工具: DuckDuckGo / Tavily API
• 爬取工具: 网页内容提取
• 过滤工具: 内容去重、相关性评分

• Telegram Bot API
• 飞书机器人

cyber-stray/
├── src/
│   ├── agent.ts          # Agent 核心逻辑
│   ├── planner.ts        # 自主规划模块
│   ├── tools/
│   │   ├── search.ts     # 搜索封装
│   │   ├── fetch.ts      # 网页抓取
│   │   └── filter.ts     # 内容过滤
│   ├── state.ts          # 状态管理 (饥饿/无聊值)
│   ├── notifier/
│   │   ├── telegram.ts
│   │   └── feishu.ts
│   ├── prompts.ts        # 语气模板
│   └── index.ts          # 入口文件
├── config/
│   └── config.ts         # 配置
├── tests/
├── package.json
├── tsconfig.json
└── README.md

git clone https://github.com/your-username/cyber-stray.git
cd cyber-stray
bun install

1. 创建 config/config.ts，填写必要的 API Keys:

• 搜索 API (Tavily / DuckDuckGo)
• 推送渠道 (Telegram Bot Token / 飞书 App Credentials)
• LLM API (用于语气转换和内容筛选)

# 单次运行
bun run src/index.ts --once

# 持续运行 (内嵌 cron 调度)
bun run src/index.ts

也可以用外部 cron 定期唤醒：

# 每小时唤醒一次
0 * * * * cd /path/to/cyber-stray && bun run src/index.ts --once

啊哈！俺在赛博七海发现了个宝贝！
📰 "独立游戏《星露谷物语》开发商宣布新作"
这帮旱鸭子游戏开发者又整活儿了！快去看看吧，陆地人！

各位观众朋友们，你们绝对不会相信我今天挖到了什么...
📰 "科学家发现猫其实能听懂自己的名字，只是假装听不见"
这解释了太多事情了！我家猫听完都笑了，然后继续装聋。

• 消息推送：Agent 通过 LarkChannel 将内容推送到飞书会话
• 用户反馈：用户通过表情（👍/👎）对推送内容进行快速反馈
• 双向通信：支持接收用户反馈并更新 Agent 状态

1. 访问 飞书开放平台
2. 点击「创建应用」→「创建企业自建应用」
3. 填写应用名称和描述，创建应用
4. 获取 App ID 和 App Secret

在应用详情页进入「权限管理」，开通以下权限：

1. 进入「事件与回调」→「订阅方式」
2. 选择「长连接模式（WebSocket）」
3. 添加事件：moments.reaction.created_v1（表情互动）
4. 保存并发布

将应用安装到需要接收消息的飞书组织/团队。

在 .env 文件中添加：

# 飞书应用配置
LARK_APP_ID=cli_xxxxxxxxxxxxxx
LARK_APP_SECRET=your_app_secret_here

在 data/agent-config.json 中配置：

{
  "feishu": {
    "pushMode": "lark_channel",
    "receiveMode": "reaction",
    "chatId": "oc_xxxxxxxxxxxxxxxx"
  }
}

参数说明：

获取 chatId：

• 在飞书中与机器人开启一个会话
• 会话 URL 中会包含 ID，格式：oc_xxxxxxxxxxxxxxxx

1. Agent 推送消息到飞书
2. 用户对消息添加 👍（喜欢）或 👎（不喜欢）
3. Agent 自动读取反馈并调整推送策略

• 基础框架搭建
• 状态管理模块
• 搜索工具集成
• Telegram / 飞书推送
• 语气模板系统
• Web Dashboard (查看历史推送)
• 多 Agent 协作 (多只"赛博宠物")
• 用户兴趣学习

• 运行时: Bun
• 语言: TypeScript
• LLM: Vercel AI SDK (OpenAI / DeepSeek / Claude)
• 搜索: Tavily API / DuckDuckGo
• 推送: Telegram Bot API / 飞书
• 调度: Bun 内置 cron 或外部 cron
• 存储: JSON 文件 / SQLite (better-sqlite3)

MIT

让 AI 也有自己的生活 🐕