# math-learn

**Repository Path**: osheyx/math-learn

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# math-learn · 每日数学家研究

一个每日自动运行的工作流,自动检索并整理**历史上著名数学家**的研究笔记,写入 Obsidian 仓库。

## 它做什么

- **每天 08:17**(本地时间)自动触发
- 选定一位未覆盖的数学家(按时代系统遍历:古希腊 → 中世纪 → 文艺复兴 → 17-18世纪 → 19世纪 → 20世纪初 → 20世纪中后期 → 当代)
- **并行 fan-out 5+ 条独立检索路径**(deep-research + Wikipedia + MacTutor + MathWorld + arXiv/WebSearch,失败时降级到 kimi-webbridge)
- 合成 3-5KB 深度笔记(中文叙述 + 英文术语,含 LaTeX 公式、证明思路、第一证明人)
- 写入 `/Users/hyx/Documents/Obsidian Vault/Mathematicians/<姓名>.md`
- 维护 vault 内的 MOC 索引 `_index.md` 和每日简报 `Mathematicians-Journal.md`

## 仓库布局

```
math-learn/
├── README.md                # 本文件
├── CLAUDE.md                # 给未来 Claude 看的项目指引
├── MEMORY.md                # 进度索引入口
├── data/
│   ├── era-queue.json       # 时代→数学家候选名单(游标)
│   ├── covered.json         # 已覆盖名单 + 元数据
│   └── history.log          # 每日运行日志(追加)
├── templates/
│   └── mathematician.md     # Obsidian 笔记模板
├── prompts/
│   └── daily-run.md         # 每日运行 prompt(由 cron 调用)
├── scripts/                 # 一键工作流
│   └── deploy.sh            # site/dist → 宝塔 ECS 一键部署
├── site/                    # Vite 3D 数学原理可视化站(可独立部署)
│   └── dist/                # build 产物(deploy.sh 上传的目标)
└── raw/                     # 每日原始检索材料(按日期归档,gitignored)
```

## 关联的 Obsidian 端文件

- `~/Documents/Obsidian Vault/Mathematicians/<姓名>.md` — 每日产出
- `~/Documents/Obsidian Vault/Mathematicians/_index.md` — MOC(按时代分组)
- `~/Documents/Obsidian Vault/Mathematicians-Journal.md` — 每日简报
- 仓库根的 `著名数学家及其定理.md` — 用户已有的综合参考文档(不覆盖)

## 手动触发一次

```bash
# 在 Claude Code 中输入:
"读取 /Users/hyx/workspace/math-learn/prompts/daily-run.md 并按其执行一次手动运行(选 古希腊·泰勒斯 作为种子)"
```

## 部署 site/ 到阿里云 ECS

```bash
# 1) 首次:先在 site/ 跑一次构建
cd site && bunx vite build && cd -

# 2) 一键部署(SSH_ALIAS=sshali,DOMAIN=math.hamr.store,都内置默认值)
bash scripts/deploy.sh
```

部署流程自动完成:探测 ssh → 检查/创建 DNS A 记录(aliyun alidns) → 备份旧 vhost →
`tar | ssh` 同步 dist → 写入 SPA 静态 vhost → `nginx -t && reload` → 探活 + SPA 路由探活。

可调环境变量:`SSH_HOST`、`SSH_PORT`、`DOMAIN`、`ECS_IP`(自动从远端查)。

## 调整调度

查看 cron 列表:`/tasks` 面板或 `CronList` 工具。
修改时间:用 `CronDelete` 删旧任务,再用 `CronCreate` 建新任务。

## 相关 skill

- `deep-research` — 核心生产者(检索第 1 路径)
- `kimi-webbridge` — 真实浏览器降级(检索第 7 路径)
- `graphify --update --obsidian` — 每周一次手动跑,把整个 `Mathematicians/` 重建成关系图