# AI Usecases Explorer — Skills 指南

本项目提供两个 Claude Code Skill，可在 Claude Code 中通过 `/命令` 调用，也可在终端直接运行 CLI 命令。

---

## 目录

- [/deep-dive — 深度知识探索与事实核查](#deep-dive)
- [/ai-scout — 每日 AI 应用场景雷达](#ai-scout)
- [CLI 命令速查](#cli-速查)
- [配置说明](#配置说明)

---

## `/deep-dive` — 深度知识探索与事实核查 {#deep-dive}

对任意文章或 URL 进行四步深度分析：提取论证结构 → Exa.ai 多角度检索 → Claude 综合评估 → 生成中文报告存入 Obsidian。

### 使用方式

**在 Claude Code 中：**
```
/deep-dive --url https://example.com/article
/deep-dive --text "粘贴文章内容..."
/deep-dive --file /path/to/article.txt
/deep-dive --url https://example.com/article --dry-run
```

**在终端直接运行：**
```bash
ai-deep-dive --url https://example.com/article
ai-deep-dive --text "粘贴文章内容..."
ai-deep-dive --file /path/to/article.txt
ai-deep-dive --url https://... --dry-run   # 预览，不写文件
```

### 参数说明

| 参数 | 说明 |
|------|------|
| `--url URL` | 抓取指定 URL 的文章内容（支持 Cloudflare 保护的网站，自动通过 Exa.ai 兜底） |
| `--text "..."` | 直接传入文章文本（适合无法公开访问的内容） |
| `--file PATH` | 从本地文本文件读取文章内容 |
| `--dry-run` | 运行完整分析但不写入 Obsidian，报告直接打印到终端 |

### 分析管道

```
输入（URL / 文本 / 文件）
  ↓ Step 1: StructuralAnalyzer（Claude）
    → 核心主张、支撑论点、论证方式、关键实体、可核实事实、检索词
  ↓ Step 2: WebResearcher（Exa.ai）
    → 支持性来源、反对性来源、权威观点、事实核查
  ↓ Step 3: MultiPerspectiveEvaluator（Claude）
    → 正方论点、反方论点、中性背景、偏见评估、可信度评分、总体结论
  ↓ Step 4: DeepDiveReporter
    → Obsidian Markdown 报告
```

### 输出

- **报告位置**：`/root/vault/obsidian_vault/obsidian/Documents/obsidian/auto_report/deep-dive/YYYY-MM-DD-HHMM-[标题slug].md`
- **终端输出**：报告路径 + 可信度评分 + 总体结论一句话
- **报告内容**（全中文）：核心主张、论证结构、多维检索来源、事实核查表、正/反/中性论点、综合评估表、延伸探索建议

### 所需配置

```env
ANTHROPIC_API_KEY=...       # 必须
EXA_API_KEY=...             # 必须（用于网络检索和抓取受保护网页）
DEEP_DIVE_MODEL=claude-sonnet-4-6  # 可选，默认 claude-sonnet-4-6
DEEP_DIVE_REPORT_DIR=/path/to/obsidian/deep-dive  # 可选
```

---

## `/ai-scout` — 每日 AI 应用场景雷达 {#ai-scout}

从 HackerNews、Reddit（Exa.ai）、GitHub 三个平台收集 AI 应用案例，经过价值过滤 → 场景分类 → 去重三步 LLM 处理，生成 Obsidian 日报。

### 使用方式

**在 Claude Code 中：**
```
/ai-scout
/ai-scout --dry-run
/ai-scout --date 2026-02-28
```

**在终端直接运行：**
```bash
ai-scout
ai-scout --dry-run             # 预览，不写数据库和文件
ai-scout --date 2026-02-28    # 指定日期（默认今天）
```

### 参数说明

| 参数 | 说明 |
|------|------|
| `--dry-run` | 运行完整扫描但不写入数据库和 Obsidian 文件 |
| `--date YYYY-MM-DD` | 指定报告日期（默认使用当天日期） |

### 处理流程

```
数据采集
  ├── HackerNews（Algolia API，12 个关键词，最低点赞数过滤）
  ├── Reddit（Exa.ai，4 个目标 subreddit）
  └── GitHub（Search API，8 个主题，最低 star 数过滤）
  ↓ 轮询交错（round-robin）确保来源均衡，限制最多 80 条
  ↓ Step 1: ValueFilter（Claude）— 过滤无实际价值内容
  ↓ Step 2: Classifier（Claude）— 分类场景类型 + 提取工具 + 评分
  ↓ Step 3: Deduplicator（Claude）— 与历史记录去重
  ↓ ObsidianReporter — 生成 Markdown 日报
```

### 输出

- **报告位置**：`auto_report/YYYY-MM-DD.md`
- **日报内容**：🆕 新场景（含摘要和工具）、♻️ 已知场景新案例（按类分组）、🚫 过滤日志
- **数据库**：SQLite，记录所有已处理条目用于去重

### 场景分类

`代码生成`、`数据分析`、`文档写作`、`工作流自动化`、`研究助手`、`UI/UX设计`、`客服支持`、`内容创作`、`教育培训`、`其他`

### 所需配置

```env
ANTHROPIC_API_KEY=...          # 必须
EXA_API_KEY=...                # 必须（Reddit 采集）
GITHUB_TOKEN=...               # 可选（提升 API 限额：60→5000 次/小时）
CLAUDE_MODEL=claude-haiku-4-5-20251001  # 可选，默认 Haiku
HN_MIN_POINTS=10               # 可选，HN 最低点赞数
GITHUB_MIN_STARS=5             # 可选，GitHub 最低 star 数
MAX_ITEMS_PER_RUN=80           # 可选，单次最多处理条数
OBSIDIAN_REPORT_DIR=/path/to/obsidian/auto_report  # 可选
```

### 定时运行（Cron）

```bash
# 每天早上 7 点自动执行
0 7 * * * /root/projects/ai_usecases_explorer/venv/bin/python -m ai_usecases_explorer.main >> /var/log/ai_usecases_scout.log 2>&1
```

---

## CLI 速查 {#cli-速查}

两个命令均已注册为系统级命令（`/usr/local/bin/`），无需激活 venv：

```bash
# 深度分析一篇文章
ai-deep-dive --url https://...

# 运行今日场景雷达
ai-scout

# 查看帮助
ai-deep-dive --help
ai-scout --help
```

venv 内等价命令：
```bash
source venv/bin/activate
python -m ai_usecases_explorer.deep_dive.cli --url https://...
python -m ai_usecases_explorer.main
```

---

## 配置说明 {#配置说明}

所有配置通过项目根目录 `.env` 文件管理：

```env
# === 必须 ===
ANTHROPIC_API_KEY=sk-ant-...
EXA_API_KEY=...

# === 可选：API 代理 ===
ANTHROPIC_BASE_URL=https://your-proxy.com

# === 可选：模型选择 ===
CLAUDE_MODEL=claude-haiku-4-5-20251001     # ai-scout 使用
DEEP_DIVE_MODEL=claude-sonnet-4-6          # ai-deep-dive 使用（推荐 Sonnet）

# === 可选：输出路径 ===
OBSIDIAN_REPORT_DIR=/root/vault/obsidian_vault/obsidian/Documents/obsidian/auto_report
DEEP_DIVE_REPORT_DIR=/root/vault/obsidian_vault/obsidian/Documents/obsidian/auto_report/deep-dive

# === 可选：采集参数 ===
GITHUB_TOKEN=ghp_...
HN_MIN_POINTS=10
GITHUB_MIN_STARS=5
MAX_ITEMS_PER_RUN=80
```

默认 Obsidian 路径：`/root/vault/obsidian_vault/obsidian/Documents/obsidian/auto_report/`

---

*Skills 由 Claude Code + Exa.ai + Anthropic Claude 驱动 · 项目：ai_usecases_explorer*