# 灵感收集器 (Inspiration Collector)

手机随手记灵感 → 永久卡片化 → AI 自动整理 → Gitea 交付

## 核心理念

**原始素材与加工成果并行保留。**

- 每条 Memos 灵感 → 独立 `cards/` 卡片文件（可检索、可引用）
- AI 分析 → `ai-insights/` 每日摘要（加工成果）
- 两条线互不覆盖，失真可追溯

## 数据流向

```
手机 Memos App / Web
       │
       ▼
服务器 Memos 实例 (memo.xybkwd.top)
       │
       ├──→ cards/ 目录（每条灵感独立 .md 卡片）
       │     └── git push → Gitea 永久保存
       │
       └──→ Python 脚本 + DeepSeek API
             └──→ ai-insights/daily/ 每日摘要
                   └── git push → Gitea
```

## 卡片系统（v2.0 新增）

每条 Memos 自动转换为一张独立卡片：

```markdown
---
title: "这是我的第一条灵感"       ← 第一句话自动成为标题
date: 2026-06-12T21:35:33+08:00
id: 20260612213533               ← 唯一 ID（时间戳）
source: memos
tags: [交易, 策略]                ← 从内容中提取的 #标签
---

这是我的第一条灵感，来自自己部署的服务...

可以通过 [[卡片标题]] 或 [[ID]] 实现双向链接。
```

- 现有 19 条 memos 已全部回填
- 每日 22:00 自动同步当天新 memos
- 文件名格式：`{ID}_{标题前30字}.md`

## 目录结构

```
inspiration-collector/
│
├── cards/               # 📇 原始灵感卡片（每 memos 一条）
│   ├── 20260612213533_这是我的第一条灵感.md
│   ├── 20260612222144_总是匆匆总是倒计时.md
│   └── ...              # 所有历史灵感
│
├── ai-insights/         # 🧠 AI 加工成果
│   ├── daily/           # 每日灵感摘要（含待办提取）
│   │   ├── YYYY-MM-DD_digest_HHMMSS.md
│   │   └── 01_课程分析.md（课程笔记分析）
│   └── weekly/          # 每周灵感趋势
│
├── tools/               # 核心工具模块
│   ├── llm.py           # DeepSeek API 客户端
│   ├── memos_client.py  # Memos 数据读取
│   ├── config.py        # 配置加载
│   ├── formatter.py     # Markdown 输出格式化
│   └── deepseek_balance.py  # 余额查询
│
├── analyzers/           # 分析逻辑
│   ├── daily_digest.py  # 每日分析（22:00 cron）
│   └── weekly_trend.py  # 每周分析
│
├── scripts/             # 自动化脚本
│   ├── run_daily_digest.sh      # cron 入口
│   ├── run_weekly_trend.sh      # cron 入口
│   ├── backfill_cards.py        # memos→卡片回填
│   │
│   │   # 关联系统（以下脚本已迁移至独立仓库）
│   ├── todo_server.py       → 见 fxy/todo-system
│   ├── extract_todos.py     → 见 fxy/todo-system
│   ├── fetch_news.py        → 见 fxy/daily-brief
│   ├── summarize_news.py    → 见 fxy/daily-brief
│   └── deepseek_balance.py
│
├── secrets/             # 密钥（不入库，chmod 600）
├── CHANGELOG.md
└── README.md
```

## 部署步骤

### 服务器上

```bash
# 克隆仓库
git clone http://localhost:3000/fxy/inspiration-collector.git

# 配置密钥
cp secrets/secrets.json.template secrets/secrets.json
vim secrets/secrets.json   # 填入 DeepSeek API Key 和 Memos Token
chmod 600 secrets/secrets.json

# 测试运行
python3 analyzers/daily_digest.py

# 设置 cron
crontab -e
# 每日 22:00 北京时间 - 每日分析
0 14 * * * cd ~/inspiration-collector && python3 analyzers/daily_digest.py && bash scripts/sync_cards.sh
# 每周日 16:00 北京时间 - 每周趋势
0 8 * * 0 cd ~/inspiration-collector && python3 analyzers/weekly_trend.py
```

## 阅读方式

| 渠道 | 说明 |
|:---|:---|
| **Gitea Web** | `gitea.xybkwd.top/fxy/inspiration-collector` |
| **导航页** | `nav.xybkwd.top` → 每日要闻 / 待办事项 |
| **AI 对话** | `chat.xybkwd.top` → 问："查memos" |
| **本地 Obsidian** | `git clone` 后打开 Obisidian，支持 Graph View 双链 |

## 关联仓库

| 仓库 | 功能 |
|:---|:---|
| `fxy/inspiration-collector` | 本仓库 — 灵感卡片 + AI 分析 |
| `fxy/todo-system` | 待办系统 |
| `fxy/daily-brief` | 每日要闻（新闻聚合） |
| `fxy/nav-page` | 导航页 |

## 依赖

- Python 3.10+
- `requests` / `feedparser`
- DeepSeek API Key
- 自托管 Memos 实例（memo.xybkwd.top）

## 版本历史

| 版本 | 日期 | 要点 |
|:---|:---|:---|
| **v2.0** | 2026-06-14 | 卡片系统：原始素材永久保留，AI加工并行不悖 |
| v1.9 | 2026-06-14 | 课程分析模板固化 |
| v1.8 | 2026-06-14 | 仓库拆分：todo/brief/nav 独立 |
| v1.7 | 2026-06-14 | 全量备份 + Caddy 安全加固 |
| v1.6 | 2026-06-14 | 新闻源扩展至 7 个，精选 90+ 条 |
| v1.5 | 2026-06-14 | 待办系统：CRUD + 分类 + 自动提取 |
| v1.4 | 2026-06-14 | 每日要闻：RSS + AI 摘要 |
| v1.3 | 2026-06-13 | AI 对话 chat.xybkwd.top |
| v1.2 | 2026-06-13 | 课程分析模板 + 浙江三日记录 |
| v1.1 | 2026-06-12 | 每日分析迭代（北京时区 / 多天对比） |
| v1.0 | 2026-06-11 | 初始版本：Memos → AI → Gitea |

完整变更记录见 [CHANGELOG.md](./CHANGELOG.md)。