Skip to content

Shawn-TKD/echo

Repository files navigation

Echo — AI Social Agent

你的声音,在社交网络中回响。 Echo 是一个基于 StepFun AI 的 Chrome 扩展,帮你自动撰写高质量社交回复和图文帖子,支持 X、微博、小红书、Instagram、LinkedIn。

Tag License Platform StepFun


✨ 核心特性

功能 说明
🤖 AI 代笔 一键生成贴合人设的回复与帖子,不再为写什么发愁
🎭 人格设定 注入你的背景、立场、语言风格,让 AI 说话像你自己
🧠 记忆系统 记录互动历史,避免重复,越用越懂你的受众
🖼️ AI 图文创作 文字 + AI 配图,一次性生成完整帖子并发到平台
🌐 多平台支持 X / Twitter、微博、小红书、Instagram、LinkedIn
👁️ 视觉理解 有图片时自动切换 vision 模型,看懂图再回复
🔒 本地运行 无后端,API key 仅存本地 chrome.storage.local
🎨 品牌封面生成 一键生成项目宣传海报(像素风 / 极简风)

🚀 快速开始

1. 克隆仓库并构建

git clone https://github.com/Shawn-TKD/echo.git
cd echo
npm install
npm run build

2. 加载到 Chrome

  1. 打开 chrome://extensions/
  2. 打开 开发者模式
  3. 点击 加载已解压的扩展程序
  4. 选择 echo/dist/ 目录
  5. 点击扩展图标,侧边栏打开

3. 配置 API

  1. 打开 StepFun 平台 获取 API Key
  2. 在 Echo 侧边栏 → Settings → 粘贴 API Key
  3. 点击 Test connection 验证
  4. 打开 Echo enabled 开关

💡 使用方式

场景 A:智能回复

  1. 打开 X、微博、小红书等平台
  2. 在 Echo 侧边栏点击 Scan current tab
  3. 选中一条感兴趣的帖子 → Draft reply
  4. Queue 标签审阅草稿 → Send
  5. 发送的同时自动完成点赞 + 关注(可在 Settings 关闭)

场景 B:一键发帖

  1. Feed 标签的 New post 区域
  2. 输入主题(例如:聊聊 AI 对独立开发者的影响
  3. 选择平台,勾选 Include image(可选)
  4. 点击 Draft post
  5. Queue 里审阅 → 发送

场景 C:人格设定

Settings → Your voice → Personality 中写入你的人设:

我是一个做 AI 产品的独立开发者,说话直接,有干货不废话,
偶尔会自嘲。不聊政治,不评论不懂的领域。

所有 AI 生成内容都会带上这个人格。


🏗️ 技术架构

┌──────────────┐        ┌───────────────┐        ┌──────────────────┐
│  Side Panel  │ ─msg─▶ │  Background   │ ─msg─▶ │ Content Script   │
│  (React UI)  │ ◀───── │ Service Worker│ ◀───── │ (Platform Adapter)│
└──────────────┘        └───────┬───────┘        └──────────────────┘
                                │
                                ▼
                        ┌───────────────┐
                        │  StepFun API  │
                        │  ─ step-3.5-flash (text)
                        │  ─ step-1o-vision-32k (vision)
                        │  ─ step-1x-medium (image gen)
                        └───────────────┘

项目结构

echo/
├── manifest.json                 # Chrome MV3 配置
├── src/
│   ├── shared/
│   │   ├── types.ts              # 全局类型 + 消息协议
│   │   └── prompts.ts            # AI system prompt 构建器
│   ├── stepfun/
│   │   └── client.ts             # StepFun API 直连
│   ├── background/
│   │   ├── index.ts              # 消息路由 + 服务初始化
│   │   ├── handlers.ts           # 核心业务逻辑
│   │   └── storage.ts            # chrome.storage 封装
│   ├── agent/
│   │   └── reply.ts              # 回复生成 pipeline
│   ├── content/
│   │   ├── index.ts              # Content script 入口
│   │   └── adapters/             # 各平台 DOM 适配器
│   │       ├── base.ts
│   │       ├── x.ts
│   │       ├── weibo.ts
│   │       ├── xhs.ts
│   │       ├── ig.ts
│   │       └── linkedin.ts
│   ├── sidepanel/                # React 侧边栏 UI
│   │   ├── App.tsx
│   │   ├── index.tsx
│   │   ├── index.html
│   │   └── index.css
│   └── bridge/                   # 本地 agent HTTP 桥接(可选)
│       ├── index.ts
│       └── commands.ts
├── echo-bridge-server/           # 本地 agent 桥接服务器
├── icons/                        # 扩展图标
├── scripts/post-build.mjs        # 构建后处理(复制 manifest/icons)
└── vite.config.ts                # Vite 构建配置

使用的 StepFun 模型

场景 模型 说明
文字回复/发帖 step-3.5-flash 默认,快速且经济
图片理解回复 step-1o-vision-32k 贴文带图时自动启用
AI 配图生成 step-1x-medium 发帖时的配套图片
可选其他模型 step-3, step-2-16k, step-2-mini 可在 Settings 切换

🧪 开发

# 热重载开发
npm run dev

# 类型检查
npm run typecheck

# 生产构建
npm run build

⚠️ 已知限制

  • 平台 DOM 选择器会随 X / 微博 / 小红书改版失效,适配器需要持续维护
  • 小红书评论受平台限制(需要 App 鉴权),暂不支持自动发送
  • 点赞 / 关注是 best-effort 点击,不保证服务端状态确实改变
  • Bridge 轮询受 chrome.alarms 限制,最小间隔 30 秒

🎯 愿景:Echo Eternity

Echo 的长期愿景是将每个人的知识、性格、表达方式持续训练成可交互的数字分身—— 当你不在线时,你的 Echo 仍在回答粉丝、分享观点、指导后辈。

不是复活,是延续。 让专家的智慧,超越生命的期限。


📄 License

MIT © 2026 Shawn-TKD


🏆 致谢

本项目参与 Flux 南客松 S2,感谢主办方提供的创作机会。

特别感谢 StepFun 提供优秀的多模态 AI 能力。

About

Echo — AI social agent powered by StepFun. Multi-platform Chrome extension for X, Weibo, Xiaohongshu, Instagram, LinkedIn. Flux 南客松 S2.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors