# Synapse

**Repository Path**: lianghanwu1999/synapse

## Basic Information

- **Project Name**: Synapse
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <h1 align="center">🧠 Synapse</h1>
  <p align="center"><strong>AI 资讯知识管道 · 三条管道 × 一个知识库</strong></p>
  <p align="center">
    <a href="https://gitee.com"><img src="https://img.shields.io/badge/Gitee-红源-orange?logo=gitee"></a>
    <img src="https://img.shields.io/badge/Python-3.11+-blue?logo=python">
    <img src="https://img.shields.io/badge/License-MIT-green">
    <img src="https://img.shields.io/badge/AI-DeepSeek-4B7BF5">
  </p>
</p>

---

## 📖 简介

Synapse 每天自动从三大信息源采集热点，通过 AI 分析筛选后存入结构化知识库。专为 AI 博主和知识工作者设计，一次配置，每日自动更新。

- 📡 **AI 科技** — Reddit / HackerNews / RSS / 开源社区
- 📊 **金融财经** — 华尔街见闻 / 财联社 / 东方财富 / 路透社
- 📺 **政策时政** — CCTV 新闻联播每日要闻

## ✨ 特性

- 🔌 **开箱即用** — 拷贝文件夹 → 填密钥 → 一条命令安装
- 🤖 **AI 驱动** — DeepSeek 自动评分、去重、翻译、摘要
- 🧠 **知识图谱** — 日报自动提炼概念卡片，双向链接可视化
- ⏰ **定时自运行** — 支持 Codex 自动化 / crontab，无需值守
- 📱 **微信推送** — CCTV 要闻自动推送到企业微信群
- 🇨🇳 **国内优化** — 默认清华 PyPI 镜像，DeepSeek 适配

## 💻 平台兼容

| 平台 | 方式 | 命令 |
|---|---|---|
| macOS / Linux | Shell 脚本 | `./setup.sh` → `./run-daily.sh` |
| Windows | Python 启动器 | `python run.py` |
| 任意平台 | Codex 智能体 | 直接调用，零配置 |

> Windows 用户只需安装 Python 3.11+，无需 Git Bash 或 WSL。

## 🚀 快速开始

### 环境要求

- Python >= 3.11
- DeepSeek API Key（[获取地址](https://platform.deepseek.com/api_keys)）

### 安装

```bash
# 1. 克隆仓库
git clone https://gitee.com/lianghanwu1999/synapse.git
cd synapse
chmod +x setup.sh run-daily.sh
```

#### 方式一：智能体模式（推荐，无需配置密钥）

在 Codex / Claude Code 等智能体中直接调用，密钥自动继承：

```bash
# Codex 自动化面板添加：
#   每日 8:00 执行: /你的路径/synapse/run-daily.sh

# 或命令行传入：
DEEPSEEK_API_KEY=sk-xxx ./setup.sh    # 安装
DEEPSEEK_API_KEY=sk-xxx ./run-daily.sh # 运行
```

#### 方式二：独立模式（手动 .env）

```bash
cp .env.example .env
nano .env  # 填入 DEEPSEEK_API_KEY=sk-你的密钥
./setup.sh
```

### 运行

```bash
./run-daily.sh                    # 手动运行
./schedule.sh                     # 配置定时任务
```

## 📂 目录结构

```
Synapse/
├── .env                    # 你的密钥（需自行创建，不提交 Git）
├── .env.example            # 密钥模板（可提交）
├── setup.sh                # 一键安装脚本
├── run-daily.sh            # 一键运行全部管道
├── schedule.sh             # 配置定时任务
│
├── pipelines/              # 三条资讯管道
│   ├── horizon/            # AI 科技热点（基于 Horizon）
│   ├── trendradar/         # 金融财经（基于 TrendRadar）
│   └── cctv/               # CCTV 新闻联播（Playwright 采集）
│
├── raw/                    # 📥 原始资料（只读，不可变）
│   └── articles/
│       ├── AI日报/         # horizon-YYYY-MM-DD-zh.md
│       ├── Finance财经/     # finance-YYYY-MM-DD.md
│       └── CCTV新闻联播/    # cctv-YYYY-MM-DD.md
│
├── wiki/                   # 🧠 结构化知识（AI 自动维护）
│   ├── concepts/           # 概念卡片
│   ├── people/             # 人物档案
│   ├── projects/           # 项目 / 工具
│   ├── glossary.md         # 术语表
│   └── graph.md            # 知识图谱
│
├── outputs/                # 📤 按需导出
│   ├── slides/             # 演示文稿
│   ├── reports/            # 分析报告
│   └── daily-summary/      # 每日分类简报
│
├── CLAUDE.md               # AI Agent 行为准则
├── index.md                # 知识库导航
└── log.md                  # 操作审计日志
```

## 🔧 三大管道说明

### 📡 Horizon — AI 科技热点

| 数据源 | 说明 |
|---|---|
| HackerNews | 全球科技头条，评分 ≥ 50 分 |
| Reddit | r/MachineLearning / r/OpenAI / r/LocalLLaMA 等 6 个子版 |
| RSS | OpenAI / DeepMind / HuggingFace / The Verge AI 等 |
| GitHub | AI 开源项目 Releases |
| OSSInsight | AI 趋势关键词分析 |

**处理流程**：抓取 → AI 评分（0-10 分）→ 去重 → 背景富化 → 中英双语摘要

### 📊 TrendRadar — 金融财经

| 数据源 | 说明 |
|---|---|
| 华尔街见闻 | 全球金融市场快讯 |
| 财联社 | A 股 / 宏观政策 |
| 东方财富 | 市场热点排行 |
| 新浪财经 | 财经综合资讯 |
| 路透社 | 国际财经新闻 |

**处理流程**：热榜抓取 → 关键词匹配筛选 → AI 摘要生成

### 📺 CCTV — 新闻联播

| 数据源 | 说明 |
|---|---|
| 央视新闻客户端 | 每日 19:30 新闻联播要闻集锦 |

**处理流程**：Playwright 浏览器采集 → HTML 清洗 → Markdown 结构化 → 可选微信推送

## 🤖 AI Agent 指令

Synapse 内置了 AI Agent 行为准则（`CLAUDE.md`），可配合 Codex / Claude Code 使用：

| 指令 | 说明 |
|---|---|
| `process` | 扫描 raw/ 中的日报，提取新概念写入 wiki/ |
| `query 关键词` | 检索 wiki/ + raw/，返回结构化答案 |
| `link 概念A 概念B` | 在知识图谱中建立双向关联 |
| `export slides 主题` | 从 wiki/ 提取内容，生成演示文稿 |

## ⏰ 定时任务

### 方案一：Codex 自动化面板（推荐，跨平台零配置）

```
每日 8:00 执行: python run.py --run
工作目录: /你的路径/synapse
```

### 方案二：一键配置系统定时任务

```bash
python schedule.py          # 交互式配置（Win/Mac/Linux 通用）
python schedule.py --install # 静默安装

# Windows: schtasks（任务计划程序）
# macOS/Linux: crontab
```

| 平台 | 自动配置 | 查看方式 |
|---|---|---|
| Windows | `schtasks` | `taskschd.msc` |
| macOS | `crontab` | `crontab -l` |
| Linux | `crontab` | `crontab -l` |

> macOS 用户注意：需要在 系统设置 → 隐私 → 完全磁盘访问权限 中添加 `/usr/sbin/cron`

## 🐛 常见问题

<details>
<summary><strong>DeepSeek API 调用失败？</strong></summary>

1. 检查 `.env` 中 `DEEPSEEK_API_KEY` 是否正确
2. 确认账号余额充足
3. 国内网络下 DeepSeek 域名 `api.deepseek.com` 通常可直连，无需代理
</details>

<details>
<summary><strong>PyPI 安装超时？</strong></summary>

脚本默认使用清华镜像源，如仍超时可手动切换：

```bash
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
```
</details>

<details>
<summary><strong>CCTV 采集失败？</strong></summary>

- 新闻联播约 19:30 后发布，建议定时在 20:00 之后
- 如 Playwright 报错，重新运行 `playwright install chromium`
</details>

## 📄 许可

MIT License

## 🙏 致谢

- [Horizon](https://github.com/Thysrael/Horizon) — AI 新闻雷达框架
- [TrendRadar](https://github.com/sansan0/TrendRadar) — 热点新闻聚合器
- [cctv-news-scraper](https://github.com/lisniuse/cctv-news-scraper) — CCTV 新闻采集器