Skip to content

Latest commit

 

History

History
104 lines (79 loc) · 3.78 KB

README_CN.md

File metadata and controls

104 lines (79 loc) · 3.78 KB

Echospect (Mirror 0.1)

"Life is the sound, Growth is the echo." "生命是声响，成长是回响。"

Echospect 是一款 AI 原生（AI-Native）的“心智代谢”引擎。它捕捉你碎片化的生活信号（消息、想法），过滤噪音，提炼核心洞察，并将它们与你过去的记忆链接起来，从而生成智慧。

🏗 系统架构 (IPO 模型)

Echospect 基于 IPO 循环运作：

  1. Input (输入层): 通过 Telegram 或 飞书 (Feishu/Lark) 捕捉消息。
    • 服务代码: src/services/feishu-bot.js, src/services/telegram-bot.js
  2. Process (处理层):
    • 分类: 使用 Gemini Flash 区分“噪音”与“洞察”。
    • 提炼: 对核心思想进行“拆骨”提炼。
    • 链接: 通过向量搜索（Vector Search）关联过去的记忆，进行对话式检索。
    • 服务代码: message-classifier.js, insight-extractor.js, memory-linker.js
  3. Output (输出层):
    • 微回响 (Mini-Echo): 生成每日哲学总结与启发性提问。
    • 服务代码: mini-echo.js

🛠 技术栈

  • 运行环境: Node.js
  • AI 模型: Google Gemini 2.0 Flash (通过 @google/generative-ai)
  • 记忆存储: Pinecone 向量数据库 (@pinecone-database/pinecone)
  • 集成平台: Telegraf (Telegram), Lark Open Platform SDK (飞书)
  • 服务端: Express.js

🚀 快速开始

1. 前置要求

  • Node.js (v18+)
  • 拥有以下账号: Telegram/飞书, Google AI Studio, Pinecone.

2. 安装

git clone <repo-url>
cd echospect
npm install

3. 配置

复制 .env.example 为 .env 并填入你的密钥：

cp .env.example .env
变量名 描述 获取来源
TELEGRAM_BOT_TOKEN Bot 身份令牌 @BotFather
GEMINI_API_KEY AI 大脑 / 模型 Key Google AI Studio
PINECONE_API_KEY 向量记忆存储 Key Pinecone Console
FEISHU_APP_ID 飞书应用 ID 飞书开放平台
FEISHU_APP_SECRET 飞书应用密钥 飞书开放平台

4. 本地运行

npm run dev

服务器将运行在 http://localhost:3000。

5. 暴露到公网 (用于飞书 Webhook)

由于飞书需要向你的电脑发送事件，你需要一个公网 URL。推荐使用 ngrok：

ngrok http 3000

复制 HTTPS URL (例如 https://abcd.ngrok.io) 并配置到你的飞书应用后台：

  • 事件订阅请求地址: https://abcd.ngrok.io/webhook/feishu

📂 项目结构

├── src
│   ├── index.js                  # 入口文件 (Express + Bots)
│   └── services
│       ├── feishu-bot.js         # 飞书/Lark 适配器
│       ├── telegram-bot.js       # Telegram 适配器
│       ├── message-classifier.js # AI 噪音过滤器
│       ├── insight-extractor.js  # "拆骨" 提炼逻辑
│       ├── memory-linker.js      # 向量记忆链接逻辑
│       ├── vector-store.js       # Pinecone 封装
│       ├── mini-echo.js          # 每日微回响生成器
│       └── content-safety.js     # 基础内容安全过滤
├── .env                          # 密钥配置 (不上传 Git)
└── package.json

📝 使用指南

  1. 聊天: 发送一个想法给 Bot。
    • 示例: “我今天意识到，持续性比高强度更重要。”
  2. AI 响应:
    • 它会分析这是否是一个 洞察 (Insight)。
    • 如果是，它会保存并回复一个“核心回路”提炼。
    • 如果发现过去的相似想法，它会触发 回响 (Echo) (“这让我想起你之前说过...”)。