开源项目情报分析与微信公众号推文自动生产系统
GitHub Insight Agent 是一款专为技术博主、开源布道师和开发者设计的“人机协同型”内容生产助手。系统支持自动发现/手动导入 GitHub 开源项目，通过智能评分规则筛选高潜力项目，调用 Google Gemini 大模型进行硬核架构剖析，并自动撰写排版精美的微信技术推文。
- 📊 今日推荐看板 (Dashboard)
- 自动爬取 GitHub Trending 热门榜单，利用结合 Stars、Forks、活跃度与技术主题的客观评分引擎进行指数级打分推荐。
- Premium 暗黑科技风格 UI 界面，重要卡片带有发光微动画和评分进度环状可视化。
- 🤖 多 Agent 协同工作流 (LangGraph)
- 引入由“提取 -> 分析 -> 生成 -> 审核”组成的 4 个协同 Agent 流程，通过 LangGraph 串联循环修正机制，实现公众号推文的自主多轮精编。
- 内建实时命令控制台 (Terminal Console)，实时呈现实时带光标闪烁的步骤日志，支持断点重连，展示完整的人机协作全景。
- 🎨 个性化写作文风管理器 (RAG)
- 文风克隆：上传历史推文建立个人知识库，通过 RAG 自动抽取向量特征，在撰写时语义匹配并召回相似片段，指导 AI 自动仿写博主惯用的口吻与 Emoji 频率。
- 热点兴趣雷达：解析历史推文的技术偏好（如 RAG, Vue, MCP 等），自动作为今日推荐看板的加分维度（客观分 +5），定制专属项目墙。
- 🔌 项目库管理与一键导入
- 支持直接输入任意 GitHub 仓库链接一键导入，系统自动拉取项目元数据、README 内容并自动去噪生成 ASCII 目录树拓扑。
- 🧠 Gemini AI 深度技术剖析
- 利用 Gemini API 的
JSON Schema强约束解析特性，100% 结构化输出技术画像（包含核心痛点、系统架构设计、核心技术点与源码路线图）。
- 利用 Gemini API 的
- ✍️ 微信公众号文章工作室
- 智能生成多套备选标题；左侧 Markdown 实时编辑源码，右侧模拟微信手机端版面动态预览。
- 一键富文本复制：优化粘贴通道，点击即可将精美渲染排版直接复制到系统剪贴板，在公众号后台
Ctrl + V完美还原代码块、彩底标题和引用框。
| 模块 | 关键技术 |
|---|---|
| 后端 (Backend) | FastAPI, SQLAlchemy, SQLite, LangGraph, LangChain-core, Pydantic, BeautifulSoup4, google-generativeai SDK |
| 前端 (Frontend) | Vue 3 (Composition API), Vite, Pinia, Axios, Vue Router, HSL 科技色彩体系 |
| 配置与文档 | Markdown 文档、Git 版本控制与安全过滤规范 |
GitHub-Insight-Agent/
├── backend/ # 后端 FastAPI 项目
│ ├── app/ # 核心业务逻辑 (API 路由、模型、数据服务等)
│ ├── requirements.txt# Python 依赖清单
│ └── .env.example # 环境变量与 API Key 配置模板
├── frontend/ # 前端 Vue 3 + Vite 项目
│ ├── src/ # 页面组件与样式 (包含 ArticleEditor, Dashboard 等视图)
│ └── package.json # Node.js 依赖与运行脚本
└── docs/ # 项目详细文档
├── development_progress.md # 开发进度与未来路标 (Roadmap)
├── github_publish_guide.md # 仓库发布与防泄密安全指南 (重要)
└── user_guide.md # 系统完整运行与使用指南
- 进入后端目录：
cd backend - 创建并激活虚拟环境：
python -m venv venv # Windows PowerShell .\venv\Scripts\Activate.ps1 # macOS/Linux source venv/bin/activate
- 安装依赖包：
pip install -r requirements.txt
- 复制配置文件并修改：
打开
copy .env.example .env
.env文件，填入您的GEMINI_API_KEY与可选的GITHUB_TOKEN。 - 启动开发服务器：
启动后后端运行在
python -m app.main
http://127.0.0.1:8000，本地 SQLite 数据库会自动初始化。
- 新开终端，进入前端目录：
cd frontend - 安装依赖项：
npm install
- 启动开发服务：
npm run dev
- 在浏览器中打开：
http://localhost:5173/。
由于本项目使用了个人敏感凭证（如 GEMINI_API_KEY、GITHUB_TOKEN），为防止泄露到公共网络：
- 我们已配置全局
.gitignore，任何情况下都不会将.env文件和本地运行产生的 SQLite 数据库提交至 Git。 - 项目内置了 Mock 数据机制，在未配置 Key 的情况下仍能正常体验系统核心逻辑。
- 在向 GitHub 发布仓库前，请务必阅读 docs/github_publish_guide.md 以确保没有安全漏洞。
我们正致力于规划以下更高阶的持续迭代特性：
- V1 (单机基础架构)：🟢 已完成。提供客观评分、Gemini 结构化分析、微信文章双栏编辑与一键富文本复制。
- V2 (多 Agent 工作流)：🟢 已完成。结合 LangGraph 引入“发现、分析、撰写、审校” 4 个协同 Agent 自主纠错机制。
- V3 (RAG 写作风格自适应)：🟢 已完成。基于本地向量余弦相似度召回历史相似语录自适应文风模仿，并进行兴趣热点评分加成。
- V4 (多渠道分发与反馈进化环路)：⚪ 规划中。支持一键同步知乎、掘金等技术社区，整合点击量与阅读量反馈自动优化 RAG 权重。
关于详细开发进度，请查看 docs/development_progress.md。