AutoIncome

AI驱动的被动收入机会聚合器
_{自动追踪 · 语义去重 · LLM智能评分 · 个性推荐}

---

⚠️ 项目现状（先读这一节）

这个项目处于早期开发阶段，远未达到"生产可用"。写在这里是为了不让任何人被下面的 功能列表误导：

事项	真实现状
可下载的安装包	不存在。仓库未创建任何 Release，没有 .msi / .dmg / .AppImage / .apk
线上演示站点	不存在。请不要尝试访问 app.autoincome.dev
桌面端 / 移动端	仅目录脚手架，未构建
实际运行验证	需要 PostgreSQL + Redis + LLM API Key 才能跑起来，作者未提供任何实机验证记录
代码质量	已有真实缺陷被修复（详见 CHANGELOG）；静态检查仍有大量存量风格问题
维护状态	全部提交集中在 2026-05-15 一天内，此后未再更新

它能做什么：提供一套完整的代码骨架——FastAPI 后端、SQLAlchemy 模型、Celery 任务、 Docker/K8s 编排、React 前端、以及接入多家 LLM 的分析流程。 适合作为"如何搭建这类系统"的参考实现来阅读。

它不能做什么：开箱即用。想真正跑起来需要自己补齐数据库、Redis、LLM Key， 并做好踩坑的准备。

---

🎯 什么是 AutoIncome？

AutoIncome 是一个 AI 驱动的副业/被动收入机会聚合平台：自动监控若干公开信息源， 通过大语言模型做内容分析、语义去重和个性化推荐，帮用户从海量信息里筛出值得行动的机会。

不同于简单的信息爬虫，AutoIncome 使用真实的大语言模型（支持 Moonshot/Kimi、OpenRouter、OpenAI 和本地 Ollama）对每一条机会进行深度分析，生成可行性、时效性、可信度、收益比和可复制性五个维度的评分，并结合用户画像做千人千面的智能推荐。

下表中的 ✅ 表示"代码已实现"，不等于"已验证在真实环境可用"。

---

✨ 核心能力

🤖 真正的AI引擎（非规则伪装）

能力	实现方式	状态
LLM内容分析	调用 Moonshot/OpenRouter/OpenAI/Ollama API 对机会文本进行深度分析	✅
智能五维评分	AI评估可行性/时效性/可信度/收益比/可复制性，与规则引擎融合	✅
语义去重	LLM嵌入向量 + 余弦相似度，识别改写、翻译后的重复内容	✅
个性化推荐	基于用户技能、时间预算、风险偏好，LLM生成匹配理由	✅
风险识别	AI自动识别诈骗、传销、资金盘等高风险内容	✅
智能摘要	自动生成中文摘要和核心要点	✅

🔍 全网聚合

平台	数据源	状态
V2EX	/api/topics/show.json 实时API	✅
知乎	热搜 + 高赞回答解析	✅
GitHub	Trending + Sponsors 探索	✅
即刻	圈子内容抓取	✅
RSS	自定义RSS源订阅	✅

🛡️ 安全与合规

• JWT认证 + Token黑名单
• bcrypt密码哈希
• 速率限制 (SlowAPI)
• CORS / CSP / HSTS 安全头
• SQL注入防护 (SQLAlchemy ORM)
• XSS防护 (bleach)
• 请求体大小限制
• 审计日志 + PII 脱敏
• 安全相关代码参照 OWASP Top 10 的思路编写（未做过第三方安全审计，不等于"合规"）

📊 基础设施（均为代码实现，未做压测验证）

组件	技术	说明
Web框架	FastAPI + Uvicorn	异步高性能API
数据库	PostgreSQL 16 + asyncpg	主存储 + 连接池
缓存	Redis 7	结果缓存、分布式限流、Session
任务队列	Celery + Redis	异步爬虫、定时任务
监控	Prometheus + Grafana	HTTP指标、业务指标、告警
日志	structlog + JSON	结构化日志、追踪
前端	React 18 + Vite + Tailwind CSS	现代化SPA管理界面
容器	Docker + Compose	多服务编排
K8s部署	Helm Chart	Chart 已写好，未在任何集群验证
CI/CD	GitHub Actions	阻断项：ruff（真实缺陷规则）+ pytest；mypy/bandit 为非阻断报告

---

🖥️ 客户端形态

各端的源码都在本仓库内，但暂无发布任何可执行安装包（仓库尚未创建任何 Release）。 下表如实标注每一端当前的可运行程度，请勿把"代码存在"理解为"可以直接下载使用"。

端	技术	目录	当前状态
Web 管理后台	React 18 + Vite + Tailwind	frontend/	可运行：源码启动后本地访问
Windows / macOS / Linux 桌面端	Tauri (Rust + Web)	clients/desktop/	仅有脚手架，未构建、未发布安装包
Android / iOS	React Native	clients/mobile/	仅有页面脚手架，未构建、未发布
官网	Next.js	website/	可运行：源码启动
浏览器插件	—	—	未开始

本仓库没有线上演示站点，也没有可下载的 .msi / .dmg / .AppImage / .apk。 需要体验请按下方"方式三：源码运行"在本地启动。

---

🚀 快速开始

方式一：Docker Compose

前提：本机已装 Docker，且你需要先准备一个 LLM API Key，否则 AI 功能不可用。

git clone https://github.com/dfhhvc/auto92811.git
cd auto92811

# 复制环境配置
cp .env.example .env
# 编辑 .env 填入数据库密码和 LLM API Key

# 启动全部服务（后端 + 前端 + DB + Redis + Grafana）
docker-compose up -d

# 查看状态
docker-compose ps

# 查看日志
docker-compose logs -f app

启动后访问：

• 🌐 Web管理后台: http://localhost:3000
• 📡 API 文档: http://localhost:8080/api/docs
• 📈 Grafana 监控: http://localhost:3001
• 🔥 Prometheus: http://localhost:9090

方式二：Kubernetes + Helm（生产环境）

Helm Chart 源码在 k8s/autoincome/，未发布到任何 Helm 仓库， 因此请直接从本地路径安装（不要使用 helm repo add）：

# 从本地 Chart 目录安装
helm install autoincome ./k8s/autoincome \
  --set config.secretKey=$(openssl rand -hex 32) \
  --set llm.moonshot.enabled=true \
  --set llm.moonshot.apiKey=$MOONSHOT_API_KEY

# 查看 Pod 状态
kubectl get pods -l app.kubernetes.io/name=autoincome

注意：Chart 中的 ingress 默认域名与 CORS 白名单指向 autoincome.dev， 该域名并非本项目所有，部署前请务必在 values.yaml 中改成你自己的域名。

方式三：源码运行（开发）

# 1. 后端
cd autoincome
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env
alembic upgrade head
uvicorn autoincome.api.main:app --reload --port 8080

# 2. 前端（另一个终端）
cd frontend
npm install
npm run dev

# 3. Celery Worker（再一个终端）
celery -A autoincome.core.tasks worker -l info

---

🔌 AI 配置

AutoIncome 的AI功能需要配置至少一个LLM提供商。支持以下方式（按优先级自动回退）：

# 方式1：Moonshot (Kimi) — 推荐
AUTOINCOME_MOONSHOT_API_KEY=sk-xxxxxxxx
AUTOINCOME_MOONSHOT_MODEL=moonshot-v1-8k

# 方式2：OpenRouter
AUTOINCOME_OPENROUTER_API_KEY=sk-or-xxxxxxxx

# 方式3：OpenAI
OPENAI_API_KEY=sk-xxxxxxxx

# 方式4：本地 Ollama（无需API Key）
OLLAMA_HOST=http://localhost:11434/v1
OLLAMA_MODEL=qwen2.5:7b

配置后通过 /api/v1/health 验证AI引擎状态。

---

🧪 测试与质量

# 运行全部测试
pytest

# 覆盖率报告
pytest --cov=autoincome --cov-report=html

# 代码检查
ruff check src tests
mypy src
bandit -r src
safety check

# 前端检查
cd frontend && npm run lint

---

📡 API 参考

端点	方法	说明
/api/v1/health	GET	健康检查（含DB/Redis/AI状态）
/api/v1/opportunities	GET	列表 + 筛选
/api/v1/opportunities/{id}	GET	详情
/api/v1/opportunities/scan	POST	AI智能扫描
/api/v1/opportunities	POST	创建（带AI分析）
/api/v1/auth/login	POST	JWT登录
/api/v1/auth/register	POST	注册
/api/v1/income	GET/POST	收益追踪
/api/v1/community/vote	POST	社区验证投票
/api/v1/admin/stats	GET	管理统计
/metrics	GET	Prometheus指标

完整文档启动后访问 /api/docs（Swagger UI）。

---

🏗️ 系统架构

┌─────────────────────────────────────────────────────────────────┐
│                         客户端层                                 │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────────────┐   │
│  │ Web SPA │  │ Desktop │  │ Mobile  │  │  浏览器插件      │   │
│  │ React   │  │ Tauri   │  │ RN      │  │  (计划)         │   │
│  └────┬────┘  └────┬────┘  └────┬────┘  └─────────────────┘   │
│       └─────────────┴─────────────┘                              │
│                         │                                        │
│                    Nginx / Ingress                               │
└─────────────────────────┬───────────────────────────────────────┘
                          │
┌─────────────────────────┼───────────────────────────────────────┐
│                         ▼                                        │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │              AutoIncome API (FastAPI + Uvicorn)          │    │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │    │
│  │  │ 机会CRUD     │  │ AI分析引擎   │  │ 认证/安全中间件  │  │    │
│  │  │ 爬虫调度     │  │ LLM Client  │  │ 限速/审计/CSP   │  │    │
│  │  │ 去重/评分    │  │ 语义去重     │  │ JWT/黑名单      │  │    │
│  │  └─────────────┘  └─────────────┘  └─────────────────┘  │    │
│  └─────────────────────────────────────────────────────────┘    │
│                         │                                        │
│  ┌────────────┐  ┌─────┴─────┐  ┌─────────────┐  ┌─────────┐   │
│  │PostgreSQL  │  │  Redis    │  │ Celery      │  │Prometheus│   │
  │  │ 主存储      │  │ 缓存/队列  │  │ 异步Worker  │  │ 指标收集  │   │
│  └────────────┘  └───────────┘  └─────────────┘  └─────────┘   │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

---

🔒 安全

• ✅ 所有密码 bcrypt 哈希存储
• ✅ JWT Token 黑名单注销机制
• ✅ SlowAPI 速率限制（可配置）
• ✅ 安全响应头（CSP / HSTS / X-Frame-Options）
• ✅ SQL注入防护（ORM参数化查询）
• ✅ XSS防护（bleach输出过滤）
• ✅ 请求体大小限制
• ✅ PII自动脱敏日志
• ✅ 审计日志全链路追踪
• ✅ 容器非root运行
• ✅ 只读根文件系统

---

📦 项目结构

autoincome/
├── src/autoincome/           # Python后端
│   ├── api/                  # FastAPI路由
│   │   ├── routers/          # 各模块API
│   │   └── schemas/          # Pydantic模型
│   ├── core/                 # 核心引擎
│   │   ├── ai/               # 🆕 AI模块（LLM/语义去重/推荐）
│   │   ├── spiders/          # 平台爬虫
│   │   ├── analyzer/         # 评分与推荐
│   │   ├── aggregator/       # 去重引擎
│   │   ├── captcha/          # 🆕 验证码处理
│   │   ├── notifier/         # 通知推送
│   │   ├── tasks/            # Celery任务
│   │   ├── database.py       # 数据库模型
│   │   ├── cache.py          # Redis缓存
│   │   ├── security.py       # 安全工具
│   │   └── metrics.py        # Prometheus指标
│   └── web/                  # 静态入口
├── frontend/                 # 🆕 React管理界面
│   ├── src/
│   │   ├── components/       # 可复用组件
│   │   ├── pages/            # 页面
│   │   ├── hooks/            # 自定义Hooks
│   │   ├── utils/            # API工具
│   │   └── types/            # TypeScript类型
│   └── package.json
├── k8s/autoincome/           # 🆕 Helm Chart
│   ├── templates/            # K8s资源模板
│   ├── values.yaml           # 默认配置
│   └── Chart.yaml
├── clients/                  # 🆕 多平台客户端
│   ├── desktop/              # Tauri桌面端
│   └── mobile/               # React Native移动端
├── website/                  # 🆕 官网
├── docker/                   # Docker构建文件
├── docker-compose.yml        # 一键启动
├── pyproject.toml            # Python依赖
└── README.md

---

🤝 贡献

欢迎提交 Issue 和 PR！请先阅读 CONTRIBUTING.md。

# 本地开发流程
git clone https://github.com/dfhhvc/auto92811.git
cd auto92811
pre-commit install
pytest

---

📄 许可证

MIT License — 详见 LICENSE

---

_{Built with ❤️ by AutoIncome Team}