@coratch/ai-news-agent 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Coratch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,177 @@
+# AI News Agent
+
+AI 前沿资讯智能订阅 Agent — 自动抓取 RSS 订阅源，通过 Claude AI 匹配用户关注点，生成中文摘要报告。
+
+## 项目概览
+
+### 痛点
+- AI 领域资讯爆炸，手动追踪效率低
+- 关注的技术方向（如 Claude Code 新版本特性）散落在多个博客/论坛，容易遗漏
+- 英文资讯需要额外时间阅读理解
+
+### 目标价值
+- 自动聚合多个 RSS 源的 AI 资讯
+- 基于用户自定义的关注主题，AI 智能筛选匹配文章
+- 生成中文摘要 + 行动建议，节省 80% 的信息获取时间
+
+## 架构
+
+```
+RSS 订阅源 → 抓取解析 → 去重(SQLite) → AI 快速筛选 → 正文提取 → AI 深度分析 → 终端输出 + Markdown 报告
+                                         (阶段1: Haiku)                  (阶段2: Haiku)
+```
+
+**两阶段 AI 分析策略**（控制成本）：
+1. **快速筛选**：仅传标题+摘要（几百 token），批量判断是否匹配用户关注点
+2. **深度分析**：仅对匹配文章提取全文，生成中文摘要和行动建议
+
+## 快速开始
+
+### 方式一：npm 全局安装（推荐）
+
+```bash
+npm install -g @coratch/ai-news-agent
+```
+
+安装后直接使用 `ai-news` 命令。
+
+### 方式二：从源码安装
+
+```bash
+git clone https://github.com/Coratch/ai-news-agent.git
+cd ai-news-agent
+npm install
+npm link  # 全局注册 ai-news 命令
+```
+
+### 设置 API Key
+
+```bash
+export ANTHROPIC_API_KEY=your-api-key
+```
+
+### 初始化配置
+
+```bash
+ai-news init
+```
+
+交互式创建配置，选择 RSS 源和关注主题。
+
+### 运行
+
+```bash
+# 正常模式（需要 API Key）
+ai-news run
+
+# Dry-run 模式（本地关键词匹配，无需 API Key）
+ai-news run --dry-run
+```
+
+## CLI 命令
+
+| 命令 | 说明 |
+|------|------|
+| `ai-news init` | 交互式初始化配置 |
+| `ai-news run` | 执行一次抓取+分析 |
+| `ai-news run --dry-run` | 跳过 AI，使用本地关键词匹配 |
+| `ai-news add-feed` | 添加 RSS 订阅源 |
+| `ai-news add-topic` | 添加关注主题 |
+| `ai-news history` | 查看历史匹配记录 |
+| `ai-news config` | 显示当前配置 |
+
+## 配置文件
+
+配置文件位于 `~/.ai-news-agent/config.yaml`：
+
+```yaml
+# RSS 订阅源
+feeds:
+  - name: "Hacker News - Claude"
+    url: "https://hnrss.org/newest?q=claude+anthropic"
+
+# 关注主题（AI 据此匹配文章）
+topics:
+  - name: "Claude Code 版本特性"
+    description: "Claude Code CLI 工具的新版本发布、新功能、效率提升特性"
+    keywords: ["claude code", "claude cli"]
+    priority: high  # high/medium/low
+
+# Claude API 设置
+claude:
+  model: "claude-haiku-4-5-20251001"  # 用 Haiku 控成本
+  max_articles_per_run: 50
+```
+
+## 输出示例
+
+### 终端输出
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  AI 资讯日报 — 2026/2/9
+  已扫描 4 个源 | 32 篇文章 | 新增 32 篇 | 命中 4 篇
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  [HIGH] Claude Code 版本特性
+  Claude Code 1.0.20: 支持后台 Agent 模式
+  来源: Anthropic Blog | 2026/2/8 10:00
+
+  新版本引入后台 Agent 模式，允许多个任务并行执行...
+
+   • 后台 Agent 支持并行任务
+   • 新增 /compact 命令优化上下文管理
+
+  → 立即升级，后台 Agent 对多任务开发场景有直接帮助
+```
+
+### Markdown 报告
+
+自动保存到 `~/.ai-news-agent/reports/YYYY-MM-DD.md`
+
+## 技术栈
+
+| 组件 | 技术 | 用途 |
+|------|------|------|
+| RSS 解析 | rss-parser | 抓取和解析 RSS feed |
+| 正文提取 | linkedom | 从网页 HTML 提取正文 |
+| AI 分析 | @anthropic-ai/sdk | Claude API 匹配+摘要 |
+| 数据存储 | better-sqlite3 | 文章去重和历史记录 |
+| CLI 框架 | commander + inquirer | 命令行交互 |
+| 终端美化 | chalk + ora | 彩色输出和进度动画 |
+
+## 项目结构
+
+```
+ai-news-agent/
+├── bin/
+│   └── ai-news.js          # CLI 入口
+├── src/
+│   ├── index.js             # 主流程编排
+│   ├── config.js            # 配置管理
+│   ├── feeds.js             # RSS 抓取
+│   ├── extractor.js         # 网页正文提取
+│   ├── analyzer.js          # Claude API 分析
+│   ├── storage.js           # SQLite 去重存储
+│   └── output.js            # 终端+Markdown 输出
+├── config.example.yaml      # 配置示例
+├── package.json
+└── README.md
+```
+
+## 效果预估
+
+| 指标 | 手动方式 | 使用 Agent |
+|------|---------|-----------|
+| 每日信息获取时间 | 30-60 分钟 | 2 分钟（看报告） |
+| 遗漏重要资讯概率 | 高 | 低（自动化覆盖） |
+| 英文资讯理解成本 | 高 | 低（中文摘要） |
+| API 成本 | - | ~$0.01/次（Haiku） |
+
+## 后续规划
+
+- [ ] 邮件通知（Resend/SMTP）
+- [ ] 定时任务（node-cron / 系统 crontab）
+- [ ] 更多 RSS 源预设（arxiv、GitHub trending 等）
+- [ ] Web UI 管理界面
+- [ ] 多用户支持

package/bin/ai-news.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { initConfig, configExists, loadConfig, addFeed, addTopic, getConfigDir } from '../src/config.js';
+import { run } from '../src/index.js';
+import { getHistory, closeDb } from '../src/storage.js';
+
+const program = new Command();
+
+program
+  .name('ai-news')
+  .description('AI 前沿资讯智能订阅 Agent')
+  .version('1.0.0');
+
+// init - 交互式创建配置
+program
+  .command('init')
+  .description('初始化配置文件')
+  .action(async () => {
+    if (configExists()) {
+      const { overwrite } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'overwrite',
+        message: '配置文件已存在，是否覆盖？',
+        default: false,
+      }]);
+      if (!overwrite) {
+        console.log('已取消');
+        return;
+      }
+    }
+
+    console.log(chalk.cyan('\n🚀 AI News Agent 初始化向导\n'));
+
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'apiKey',
+        message: 'Anthropic API Key (留空则使用环境变量 ANTHROPIC_API_KEY):',
+        default: '',
+      },
+      {
+        type: 'checkbox',
+        name: 'defaultFeeds',
+        message: '选择默认订阅的 RSS 源:',
+        choices: [
+          { name: 'Anthropic Engineering (GitHub)', value: { name: 'Anthropic Engineering', url: 'https://raw.githubusercontent.com/conoro/anthropic-engineering-rss-feed/main/anthropic_engineering_rss.xml' }, checked: true },
+          { name: 'Hacker News - AI/LLM', value: { name: 'Hacker News - AI/LLM', url: 'https://hnrss.org/newest?q=AI+LLM+agent' }, checked: true },
+          { name: 'Hacker News - Claude', value: { name: 'Hacker News - Claude', url: 'https://hnrss.org/newest?q=claude+anthropic' }, checked: true },
+          { name: 'The Verge - AI', value: { name: 'The Verge - AI', url: 'https://www.theverge.com/rss/ai-artificial-intelligence/index.xml' }, checked: false },
+        ],
+      },
+      {
+        type: 'input',
+        name: 'topicName',
+        message: '输入你最关注的 AI 主题名称:',
+        default: 'Claude Code 版本特性',
+      },
+      {
+        type: 'input',
+        name: 'topicDesc',
+        message: '描述这个主题（AI 会据此匹配文章）:',
+        default: 'Claude Code CLI 工具的新版本发布、新功能、效率提升特性',
+      },
+      {
+        type: 'input',
+        name: 'topicKeywords',
+        message: '关键词（逗号分隔）:',
+        default: 'claude code, claude cli, anthropic cli',
+      },
+    ]);
+
+    const config = {
+      feeds: answers.defaultFeeds,
+      topics: [{
+        name: answers.topicName,
+        description: answers.topicDesc,
+        keywords: answers.topicKeywords.split(',').map(k => k.trim()),
+        priority: 'high',
+      }],
+      output: {
+        terminal: true,
+        markdown: { enabled: true, dir: '~/.ai-news-agent/reports' },
+      },
+      claude: {
+        model: 'claude-haiku-4-5-20251001',
+        max_articles_per_run: 50,
+      },
+    };
+
+    const configPath = initConfig(config);
+    console.log(chalk.green(`\n✅ 配置已保存到: ${configPath}`));
+    console.log(chalk.gray('运行 ai-news run 开始抓取资讯\n'));
+  });
+
+// run - 执行一次抓取分析
+program
+  .command('run')
+  .description('立即执行一次抓取+分析')
+  .option('--dry-run', '跳过 Claude API，使用本地关键词匹配')
+  .action(async (opts) => {
+    if (!configExists()) {
+      console.log(chalk.red('配置文件不存在，请先运行: ai-news init'));
+      return;
+    }
+    try {
+      await run({ dryRun: opts.dryRun });
+    } catch (err) {
+      console.error(chalk.red(`执行失败: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
+// add-feed - 添加 RSS 源
+program
+  .command('add-feed')
+  .description('添加 RSS 订阅源')
+  .action(async () => {
+    const { name, url } = await inquirer.prompt([
+      { type: 'input', name: 'name', message: 'RSS 源名称:' },
+      { type: 'input', name: 'url', message: 'RSS URL:' },
+    ]);
+    try {
+      addFeed(name, url);
+      console.log(chalk.green(`✅ 已添加: ${name} (${url})`));
+    } catch (err) {
+      console.error(chalk.red(err.message));
+    }
+  });
+
+// add-topic - 添加关注点
+program
+  .command('add-topic')
+  .description('添加关注主题')
+  .action(async () => {
+    const answers = await inquirer.prompt([
+      { type: 'input', name: 'name', message: '主题名称:' },
+      { type: 'input', name: 'description', message: '主题描述（AI 据此匹配文章）:' },
+      { type: 'input', name: 'keywords', message: '关键词（逗号分隔）:' },
+      { type: 'list', name: 'priority', message: '优先级:', choices: ['high', 'medium', 'low'] },
+    ]);
+    try {
+      addTopic(answers.name, answers.description, answers.keywords.split(',').map(k => k.trim()), answers.priority);
+      console.log(chalk.green(`✅ 已添加主题: ${answers.name}`));
+    } catch (err) {
+      console.error(chalk.red(err.message));
+    }
+  });
+
+// history - 查看历史
+program
+  .command('history')
+  .description('查看历史匹配记录')
+  .option('-d, --days <n>', '最近几天', '7')
+  .action((opts) => {
+    if (!configExists()) {
+      console.log(chalk.red('配置文件不存在，请先运行: ai-news init'));
+      return;
+    }
+    try {
+      const records = getHistory(parseInt(opts.days));
+      if (records.length === 0) {
+        console.log(chalk.gray('暂无历史记录'));
+        return;
+      }
+      console.log(chalk.bold(`\n📋 最近 ${opts.days} 天的匹配记录 (${records.length} 条)\n`));
+      for (const r of records) {
+        const analysis = r.analysis_json ? JSON.parse(r.analysis_json) : null;
+        const topic = r.matched_topic || '未分类';
+        console.log(chalk.yellow(`  [${topic}] `) + chalk.bold(r.title));
+        if (analysis?.summary) {
+          console.log(chalk.gray(`  ${analysis.summary.slice(0, 80)}...`));
+        }
+        console.log(chalk.gray(`  ${r.url} | ${r.created_at}`));
+        console.log('');
+      }
+      closeDb();
+    } catch (err) {
+      console.error(chalk.red(err.message));
+    }
+  });
+
+// config - 显示配置
+program
+  .command('config')
+  .description('显示当前配置')
+  .action(() => {
+    if (!configExists()) {
+      console.log(chalk.red('配置文件不存在，请先运行: ai-news init'));
+      return;
+    }
+    const config = loadConfig();
+    console.log(chalk.bold('\n📂 配置目录: ') + getConfigDir());
+    console.log(chalk.bold('\n📡 RSS 订阅源:'));
+    for (const f of config.feeds) {
+      console.log(`  • ${f.name}: ${f.url}`);
+    }
+    console.log(chalk.bold('\n🎯 关注主题:'));
+    for (const t of config.topics) {
+      console.log(`  • [${t.priority}] ${t.name}: ${t.description}`);
+      console.log(chalk.gray(`    关键词: ${t.keywords.join(', ')}`));
+    }
+    console.log('');
+  });
+
+program.parse();

package/config.example.yaml

@@ -0,0 +1,56 @@
+# AI News Agent 配置文件
+# 复制此文件到 ~/.ai-news-agent/config.yaml 并修改
+
+# RSS 订阅源
+feeds:
+  - name: "Anthropic Blog"
+    url: "https://www.anthropic.com/rss.xml"
+  - name: "OpenAI Blog"
+    url: "https://openai.com/blog/rss.xml"
+  - name: "Hacker News - AI"
+    url: "https://hnrss.org/newest?q=AI+LLM+agent"
+  - name: "The Verge - AI"
+    url: "https://www.theverge.com/rss/ai-artificial-intelligence/index.xml"
+
+# 用户关注的 topics
+topics:
+  - name: "Claude Code 版本特性"
+    description: "Claude Code CLI 工具的新版本发布、新功能、效率提升特性、MCP 工具链更新"
+    keywords:
+      - "claude code"
+      - "claude cli"
+      - "anthropic cli"
+      - "claude agent"
+    priority: high
+
+  - name: "AI 编程工具动态"
+    description: "Cursor、GitHub Copilot、Windsurf 等 AI 编程辅助工具的重大更新和新功能"
+    keywords:
+      - "cursor"
+      - "copilot"
+      - "windsurf"
+      - "ai coding"
+      - "ai ide"
+    priority: medium
+
+  - name: "LLM 前沿进展"
+    description: "大语言模型的重要技术突破、新模型发布、benchmark 结果"
+    keywords:
+      - "gpt"
+      - "claude"
+      - "gemini"
+      - "llama"
+      - "benchmark"
+    priority: low
+
+# 输出设置
+output:
+  terminal: true
+  markdown:
+    enabled: true
+    dir: "~/.ai-news-agent/reports"
+
+# Claude API 设置
+claude:
+  model: "claude-haiku-4-5-20251001"
+  max_articles_per_run: 50

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@coratch/ai-news-agent",
+  "version": "1.0.0",
+  "description": "AI 前沿资讯智能订阅 Agent - 自动抓取 RSS、Claude AI 匹配关注点、生成中文摘要报告",
+  "type": "module",
+  "bin": {
+    "ai-news": "./bin/ai-news.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "config.example.yaml",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/ai-news.js run",
+    "dev": "node bin/ai-news.js"
+  },
+  "keywords": [
+    "ai",
+    "news",
+    "rss",
+    "claude",
+    "agent",
+    "newsletter",
+    "anthropic",
+    "llm"
+  ],
+  "author": "Coratch",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Coratch/ai-news-agent.git"
+  },
+  "homepage": "https://github.com/Coratch/ai-news-agent#readme",
+  "bugs": {
+    "url": "https://github.com/Coratch/ai-news-agent/issues"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "better-sqlite3": "^11.7.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "inquirer": "^12.3.2",
+    "linkedom": "^0.18.6",
+    "ora": "^8.1.1",
+    "rss-parser": "^3.13.0",
+    "yaml": "^2.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/analyzer.js

@@ -0,0 +1,131 @@
+import Anthropic from '@anthropic-ai/sdk';
+
+let client = null;
+
+function getClient() {
+  if (!client) {
+    client = new Anthropic();
+  }
+  return client;
+}
+
+/**
+ * 阶段1: 快速筛选 — 基于标题+摘要判断是否匹配用户关注点
+ * 批量处理以减少 API 调用次数
+ *
+ * @param {Array} articles - 文章列表 [{title, summary, link, feedName}]
+ * @param {Array} topics - 用户关注点 [{name, description, keywords, priority}]
+ * @param {string} model
+ * @returns {Array} 匹配的文章列表，附带 matchedTopic 和 relevance
+ */
+export async function quickFilter(articles, topics, model) {
+  if (articles.length === 0 || topics.length === 0) return [];
+
+  const topicsDesc = topics.map((t, i) =>
+    `[${i}] ${t.name} (${t.priority}): ${t.description}\n    关键词: ${t.keywords.join(', ')}`
+  ).join('\n');
+
+  // 分批处理，每批 10 篇
+  const batchSize = 10;
+  const matched = [];
+
+  for (let i = 0; i < articles.length; i += batchSize) {
+    const batch = articles.slice(i, i + batchSize);
+    const articlesDesc = batch.map((a, j) =>
+      `[${j}] "${a.title}" (${a.feedName})\n    ${a.summary.slice(0, 200)}`
+    ).join('\n\n');
+
+    const prompt = `你是一个 AI 资讯筛选助手。请判断以下文章是否与用户关注的 topics 相关。
+
+## 用户关注的 Topics
+${topicsDesc}
+
+## 待筛选文章
+${articlesDesc}
+
+## 输出要求
+返回 JSON 数组，只包含匹配的文章。每个元素：
+{"index": 文章序号, "topicIndex": 匹配的topic序号, "relevance": 0.0-1.0的相关度}
+
+如果没有匹配的文章，返回空数组 []。
+只返回 relevance >= 0.6 的结果。只输出 JSON，不要其他内容。`;
+
+    try {
+      const response = await getClient().messages.create({
+        model,
+        max_tokens: 1024,
+        messages: [{ role: 'user', content: prompt }],
+      });
+
+      const text = response.content[0]?.text || '[]';
+      const jsonMatch = text.match(/\[[\s\S]*\]/);
+      if (!jsonMatch) continue;
+
+      const results = JSON.parse(jsonMatch[0]);
+      for (const r of results) {
+        if (r.index >= 0 && r.index < batch.length && r.relevance >= 0.6) {
+          matched.push({
+            ...batch[r.index],
+            matchedTopic: topics[r.topicIndex] || topics[0],
+            relevance: r.relevance,
+          });
+        }
+      }
+    } catch (err) {
+      console.error(`  筛选批次失败: ${err.message}`);
+    }
+  }
+
+  return matched;
+}
+
+/**
+ * 阶段2: 深度分析 — 对匹配的文章生成中文摘要
+ *
+ * @param {object} article - 文章 {title, link, feedName, matchedTopic, fullContent}
+ * @param {string} model
+ * @returns {object} {summary, keyPoints, actionable, recommendation}
+ */
+export async function deepAnalyze(article, model) {
+  const content = article.fullContent || article.summary;
+  const topic = article.matchedTopic;
+
+  const prompt = `你是一个专业的 AI 技术资讯分析师。请对以下文章进行深度分析，重点关注与用户关注点的关联。
+
+## 用户关注点
+名称: ${topic.name}
+描述: ${topic.description}
+
+## 文章信息
+标题: ${article.title}
+来源: ${article.feedName}
+内容:
+${content}
+
+## 输出要求
+返回 JSON（只输出 JSON，不要其他内容）：
+{
+  "summary": "150字以内的中文摘要，突出与用户关注点相关的内容",
+  "keyPoints": ["关键点1", "关键点2", "关键点3"],
+  "actionable": true/false（这个信息是否需要用户立即采取行动，如版本升级、功能试用等）,
+  "recommendation": "一句话行动建议，如果 actionable 为 false 则为空字符串"
+}`;
+
+  try {
+    const response = await getClient().messages.create({
+      model,
+      max_tokens: 1024,
+      messages: [{ role: 'user', content: prompt }],
+    });
+
+    const text = response.content[0]?.text || '{}';
+    const jsonMatch = text.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+      return { summary: '分析失败', keyPoints: [], actionable: false, recommendation: '' };
+    }
+    return JSON.parse(jsonMatch[0]);
+  } catch (err) {
+    console.error(`  分析失败 [${article.title}]: ${err.message}`);
+    return { summary: '分析失败: ' + err.message, keyPoints: [], actionable: false, recommendation: '' };
+  }
+}

package/src/config.js

@@ -0,0 +1,96 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import YAML from 'yaml';
+
+const CONFIG_DIR = path.join(os.homedir(), '.ai-news-agent');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.yaml');
+
+const DEFAULT_CONFIG = {
+  feeds: [
+    { name: 'Anthropic Engineering (GitHub)', url: 'https://raw.githubusercontent.com/conoro/anthropic-engineering-rss-feed/main/anthropic_engineering_rss.xml' },
+    { name: 'Hacker News - AI/LLM', url: 'https://hnrss.org/newest?q=AI+LLM+agent' },
+    { name: 'Hacker News - Claude', url: 'https://hnrss.org/newest?q=claude+anthropic' },
+    { name: 'The Verge - AI', url: 'https://www.theverge.com/rss/ai-artificial-intelligence/index.xml' },
+  ],
+  topics: [
+    {
+      name: 'Claude Code 版本特性',
+      description: 'Claude Code CLI 工具的新版本发布、新功能、效率提升特性',
+      keywords: ['claude code', 'claude cli', 'anthropic cli'],
+      priority: 'high',
+    },
+  ],
+  output: {
+    terminal: true,
+    markdown: { enabled: true, dir: path.join(CONFIG_DIR, 'reports') },
+  },
+  claude: {
+    model: 'claude-haiku-4-5-20251001',
+    max_articles_per_run: 50,
+  },
+};
+
+export function getConfigDir() {
+  return CONFIG_DIR;
+}
+
+export function ensureConfigDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+export function configExists() {
+  return fs.existsSync(CONFIG_FILE);
+}
+
+export function loadConfig() {
+  if (!configExists()) {
+    throw new Error(`配置文件不存在: ${CONFIG_FILE}\n请先运行 ai-news init 创建配置`);
+  }
+  const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+  const config = YAML.parse(raw);
+  // 展开 ~ 路径
+  if (config.output?.markdown?.dir) {
+    config.output.markdown.dir = config.output.markdown.dir.replace(/^~/, os.homedir());
+  }
+  return config;
+}
+
+export function saveConfig(config) {
+  ensureConfigDir();
+  const content = YAML.stringify(config, { lineWidth: 120 });
+  fs.writeFileSync(CONFIG_FILE, content, 'utf-8');
+}
+
+export function initConfig(customConfig = null) {
+  ensureConfigDir();
+  const config = customConfig || DEFAULT_CONFIG;
+  saveConfig(config);
+  // 确保报告目录存在
+  const reportDir = config.output?.markdown?.dir?.replace(/^~/, os.homedir())
+    || path.join(CONFIG_DIR, 'reports');
+  if (!fs.existsSync(reportDir)) {
+    fs.mkdirSync(reportDir, { recursive: true });
+  }
+  return CONFIG_FILE;
+}
+
+export function addFeed(name, url) {
+  const config = loadConfig();
+  if (config.feeds.some(f => f.url === url)) {
+    throw new Error(`RSS 源已存在: ${url}`);
+  }
+  config.feeds.push({ name, url });
+  saveConfig(config);
+}
+
+export function addTopic(name, description, keywords, priority = 'medium') {
+  const config = loadConfig();
+  if (config.topics.some(t => t.name === name)) {
+    throw new Error(`关注点已存在: ${name}`);
+  }
+  config.topics.push({ name, description, keywords, priority });
+  saveConfig(config);
+}

package/src/extractor.js

@@ -0,0 +1,67 @@
+import { parseHTML } from 'linkedom';
+
+/**
+ * 从 URL 抓取网页并提取正文
+ * @param {string} url
+ * @returns {string} 提取的正文文本（截断到 3000 字符以控制 token）
+ */
+export async function extractContent(url) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15000);
+
+    const response = await fetch(url, {
+      signal: controller.signal,
+      headers: {
+        'User-Agent': 'Mozilla/5.0 (compatible; AI-News-Agent/1.0)',
+        'Accept': 'text/html,application/xhtml+xml',
+      },
+    });
+    clearTimeout(timeout);
+
+    if (!response.ok) {
+      return '';
+    }
+
+    const html = await response.text();
+    return extractFromHtml(html);
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * 从 HTML 字符串中提取正文
+ */
+function extractFromHtml(html) {
+  const { document } = parseHTML(html);
+
+  // 移除无关元素
+  const removeTags = ['script', 'style', 'nav', 'header', 'footer', 'aside', 'iframe'];
+  for (const tag of removeTags) {
+    document.querySelectorAll(tag).forEach(el => el.remove());
+  }
+
+  // 优先尝试 article 标签
+  let content = '';
+  const article = document.querySelector('article');
+  if (article) {
+    content = article.textContent || '';
+  }
+
+  // 回退到 main 或 body
+  if (!content || content.trim().length < 200) {
+    const main = document.querySelector('main') || document.querySelector('[role="main"]');
+    if (main) {
+      content = main.textContent || '';
+    }
+  }
+
+  if (!content || content.trim().length < 200) {
+    content = document.body?.textContent || '';
+  }
+
+  // 清理空白并截断
+  content = content.replace(/\s+/g, ' ').trim();
+  return content.slice(0, 3000);
+}

package/src/feeds.js

@@ -0,0 +1,50 @@
+import RSSParser from 'rss-parser';
+
+const parser = new RSSParser({
+  timeout: 15000,
+  headers: {
+    'User-Agent': 'AI-News-Agent/1.0',
+  },
+});
+
+/**
+ * 抓取单个 RSS 源
+ * @returns {Array<{title, link, summary, pubDate, feedName}>}
+ */
+async function fetchFeed(feed) {
+  try {
+    const result = await parser.parseURL(feed.url);
+    return (result.items || []).map(item => ({
+      title: item.title || '',
+      link: item.link || '',
+      summary: item.contentSnippet || item.content || '',
+      pubDate: item.pubDate || item.isoDate || '',
+      feedName: feed.name,
+    }));
+  } catch (err) {
+    console.error(`  抓取失败 [${feed.name}]: ${err.message}`);
+    return [];
+  }
+}
+
+/**
+ * 并行抓取所有 RSS 源
+ * @param {Array<{name, url}>} feeds
+ * @param {number} maxArticles - 最多返回文章数
+ * @returns {Array} 文章列表，按时间倒序
+ */
+export async function fetchAllFeeds(feeds, maxArticles = 50) {
+  const results = await Promise.allSettled(feeds.map(f => fetchFeed(f)));
+  const articles = results
+    .filter(r => r.status === 'fulfilled')
+    .flatMap(r => r.value);
+
+  // 按发布时间倒序
+  articles.sort((a, b) => {
+    const da = a.pubDate ? new Date(a.pubDate).getTime() : 0;
+    const db = b.pubDate ? new Date(b.pubDate).getTime() : 0;
+    return db - da;
+  });
+
+  return articles.slice(0, maxArticles);
+}

package/src/index.js

@@ -0,0 +1,147 @@
+import ora from 'ora';
+import { loadConfig } from './config.js';
+import { fetchAllFeeds } from './feeds.js';
+import { extractContent } from './extractor.js';
+import { quickFilter, deepAnalyze } from './analyzer.js';
+import { filterNew, markProcessed, closeDb } from './storage.js';
+import { printResults, generateMarkdownReport } from './output.js';
+
+/**
+ * dry-run 模式：基于关键词做本地匹配 + mock 分析
+ */
+function localKeywordMatch(articles, topics) {
+  const matched = [];
+  for (const article of articles) {
+    const text = `${article.title} ${article.summary}`.toLowerCase();
+    for (const topic of topics) {
+      const hit = topic.keywords.some(kw => text.includes(kw.toLowerCase()));
+      if (hit) {
+        matched.push({
+          ...article,
+          matchedTopic: topic,
+          relevance: 0.8,
+        });
+        break;
+      }
+    }
+  }
+  return matched;
+}
+
+/**
+ * 主流程：抓取 → 去重 → 筛选 → 分析 → 输出
+ * @param {object} options - { dryRun: boolean }
+ */
+export async function run(options = {}) {
+  const { dryRun = false } = options;
+
+  // 检查 API Key（dry-run 模式跳过）
+  if (!dryRun && !process.env.ANTHROPIC_API_KEY) {
+    console.error('❌ 未设置 ANTHROPIC_API_KEY 环境变量');
+    console.error('   请运行: export ANTHROPIC_API_KEY=your-api-key');
+    console.error('   或使用 --dry-run 模式跳过 AI 分析');
+    process.exit(1);
+  }
+
+  const config = loadConfig();
+  const stats = { feedCount: config.feeds.length, totalArticles: 0, newArticles: 0 };
+
+  if (dryRun) {
+    console.log('🧪 Dry-run 模式: 使用本地关键词匹配，跳过 Claude API\n');
+  }
+
+  // Step 1: 抓取 RSS
+  let spinner = ora('正在抓取 RSS 订阅源...').start();
+  const articles = await fetchAllFeeds(config.feeds, config.claude.max_articles_per_run);
+  stats.totalArticles = articles.length;
+  spinner.succeed(`抓取完成: ${articles.length} 篇文章来自 ${config.feeds.length} 个源`);
+
+  if (articles.length === 0) {
+    console.log('没有抓取到任何文章，请检查 RSS 源配置');
+    closeDb();
+    return;
+  }
+
+  // Step 2: 去重
+  spinner = ora('过滤已处理文章...').start();
+  const newArticles = filterNew(articles);
+  stats.newArticles = newArticles.length;
+  spinner.succeed(`新增文章: ${newArticles.length} 篇 (已跳过 ${articles.length - newArticles.length} 篇)`);
+
+  if (newArticles.length === 0) {
+    console.log('没有新文章需要处理');
+    closeDb();
+    return;
+  }
+
+  // Step 3: 筛选
+  let matched;
+  if (dryRun) {
+    spinner = ora(`本地关键词匹配 (${newArticles.length} 篇)...`).start();
+    matched = localKeywordMatch(newArticles, config.topics);
+    spinner.succeed(`关键词命中: ${matched.length} 篇`);
+  } else {
+    spinner = ora(`AI 正在筛选匹配文章 (${newArticles.length} 篇)...`).start();
+    matched = await quickFilter(newArticles, config.topics, config.claude.model);
+    spinner.succeed(`匹配命中: ${matched.length} 篇`);
+  }
+
+  if (matched.length === 0) {
+    for (const a of newArticles) {
+      markProcessed(a, null);
+    }
+    printResults([], stats);
+    closeDb();
+    return;
+  }
+
+  // Step 4: 深度分析
+  spinner = ora(`分析 ${matched.length} 篇匹配文章...`).start();
+  const results = [];
+
+  for (let i = 0; i < matched.length; i++) {
+    const article = matched[i];
+    spinner.text = `分析 (${i + 1}/${matched.length}): ${article.title.slice(0, 40)}...`;
+
+    if (dryRun) {
+      // dry-run: 用 RSS 摘要做简单总结
+      article.analysis = {
+        summary: article.summary.slice(0, 150) || '（RSS 摘要为空，需通过 AI 分析获取详情）',
+        keyPoints: [`来源: ${article.feedName}`, `关键词匹配: ${article.matchedTopic.name}`],
+        actionable: article.matchedTopic.priority === 'high',
+        recommendation: article.matchedTopic.priority === 'high' ? '建议关注此文章详情' : '',
+      };
+    } else {
+      const fullContent = await extractContent(article.link);
+      article.fullContent = fullContent || article.summary;
+      article.analysis = await deepAnalyze(article, config.claude.model);
+    }
+
+    results.push(article);
+    markProcessed(article, article.analysis);
+  }
+
+  // 标记未匹配文章为已处理
+  for (const a of newArticles) {
+    if (!matched.find(m => m.link === a.link)) {
+      markProcessed(a, null);
+    }
+  }
+
+  spinner.succeed(`分析完成: ${results.length} 篇`);
+
+  // Step 5: 输出
+  if (config.output.terminal) {
+    printResults(results, stats);
+  }
+
+  if (config.output.markdown?.enabled) {
+    const reportPath = generateMarkdownReport(results, stats, config.output.markdown.dir);
+    if (reportPath) {
+      console.log(`📄 报告已保存: ${reportPath}`);
+    }
+  }
+
+  closeDb();
+  return results;
+}

package/src/output.js

@@ -0,0 +1,160 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+
+const PRIORITY_COLORS = {
+  high: chalk.red,
+  medium: chalk.yellow,
+  low: chalk.blue,
+};
+
+const PRIORITY_LABELS = {
+  high: 'HIGH',
+  medium: 'MED',
+  low: 'LOW',
+};
+
+/**
+ * 终端输出匹配结果
+ */
+export function printResults(results, stats) {
+  const now = new Date().toLocaleDateString('zh-CN');
+
+  console.log('');
+  console.log(chalk.bold('━'.repeat(50)));
+  console.log(chalk.bold.cyan(`  AI 资讯日报 — ${now}`));
+  console.log(chalk.gray(`  已扫描 ${stats.feedCount} 个源 | ${stats.totalArticles} 篇文章 | 新增 ${stats.newArticles} 篇 | 命中 ${results.length} 篇`));
+  console.log(chalk.bold('━'.repeat(50)));
+
+  if (results.length === 0) {
+    console.log(chalk.gray('\n  暂无匹配的新文章\n'));
+    return;
+  }
+
+  // 按 priority 分组
+  const grouped = {};
+  for (const r of results) {
+    const priority = r.matchedTopic?.priority || 'low';
+    if (!grouped[priority]) grouped[priority] = [];
+    grouped[priority].push(r);
+  }
+
+  for (const priority of ['high', 'medium', 'low']) {
+    const items = grouped[priority];
+    if (!items?.length) continue;
+
+    const colorFn = PRIORITY_COLORS[priority] || chalk.white;
+    const label = PRIORITY_LABELS[priority] || priority;
+
+    for (const item of items) {
+      console.log('');
+      console.log(colorFn(`  [${label}] ${item.matchedTopic?.name || '未分类'}`));
+      console.log(chalk.bold(`  ${item.title}`));
+      console.log(chalk.gray(`  来源: ${item.feedName} | ${formatDate(item.pubDate)}`));
+
+      if (item.analysis) {
+        console.log('');
+        console.log(`  ${chalk.white(item.analysis.summary)}`);
+
+        if (item.analysis.keyPoints?.length) {
+          console.log('');
+          for (const point of item.analysis.keyPoints) {
+            console.log(chalk.cyan(`   • ${point}`));
+          }
+        }
+
+        if (item.analysis.actionable && item.analysis.recommendation) {
+          console.log('');
+          console.log(chalk.green(`  → ${item.analysis.recommendation}`));
+        }
+      }
+
+      console.log(chalk.gray(`  ${item.link}`));
+      console.log(chalk.gray('  ' + '─'.repeat(46)));
+    }
+  }
+
+  console.log('');
+}
+
+/**
+ * 生成 Markdown 报告
+ */
+export function generateMarkdownReport(results, stats, outputDir) {
+  if (!results.length) return null;
+
+  const now = new Date();
+  const dateStr = now.toISOString().split('T')[0];
+  const timeStr = now.toLocaleTimeString('zh-CN');
+
+  let md = `# AI 资讯日报 — ${dateStr}\n\n`;
+  md += `> 扫描 ${stats.feedCount} 个源 | ${stats.totalArticles} 篇文章 | 新增 ${stats.newArticles} 篇 | 命中 ${results.length} 篇 | 生成时间 ${timeStr}\n\n`;
+  md += `---\n\n`;
+
+  // 按 priority 分组
+  const grouped = {};
+  for (const r of results) {
+    const priority = r.matchedTopic?.priority || 'low';
+    if (!grouped[priority]) grouped[priority] = [];
+    grouped[priority].push(r);
+  }
+
+  for (const priority of ['high', 'medium', 'low']) {
+    const items = grouped[priority];
+    if (!items?.length) continue;
+
+    const emoji = { high: '🔴', medium: '🟡', low: '🔵' }[priority];
+    const label = PRIORITY_LABELS[priority];
+
+    for (const item of items) {
+      md += `## ${emoji} [${label}] ${item.matchedTopic?.name || '未分类'}\n\n`;
+      md += `### ${item.title}\n\n`;
+      md += `**来源**: ${item.feedName} | **时间**: ${formatDate(item.pubDate)}\n\n`;
+
+      if (item.analysis) {
+        md += `**摘要**: ${item.analysis.summary}\n\n`;
+
+        if (item.analysis.keyPoints?.length) {
+          md += `**关键点**:\n`;
+          for (const point of item.analysis.keyPoints) {
+            md += `- ${point}\n`;
+          }
+          md += '\n';
+        }
+
+        if (item.analysis.actionable && item.analysis.recommendation) {
+          md += `> 💡 **建议**: ${item.analysis.recommendation}\n\n`;
+        }
+      }
+
+      md += `🔗 [阅读原文](${item.link})\n\n`;
+      md += `---\n\n`;
+    }
+  }
+
+  // 写入文件
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  const filePath = path.join(outputDir, `${dateStr}.md`);
+
+  // 如果同一天多次运行，追加内容
+  if (fs.existsSync(filePath)) {
+    md = `\n\n---\n\n# 更新 (${timeStr})\n\n` + md.split('---\n\n').slice(1).join('---\n\n');
+    fs.appendFileSync(filePath, md, 'utf-8');
+  } else {
+    fs.writeFileSync(filePath, md, 'utf-8');
+  }
+
+  return filePath;
+}
+
+function formatDate(dateStr) {
+  if (!dateStr) return '未知时间';
+  try {
+    const d = new Date(dateStr);
+    return d.toLocaleDateString('zh-CN') + ' ' + d.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' });
+  } catch {
+    return dateStr;
+  }
+}

package/src/storage.js

@@ -0,0 +1,88 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import crypto from 'crypto';
+import { getConfigDir, ensureConfigDir } from './config.js';
+
+let db = null;
+
+function getDb() {
+  if (!db) {
+    ensureConfigDir();
+    const dbPath = path.join(getConfigDir(), 'articles.db');
+    db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS articles (
+        url_hash TEXT PRIMARY KEY,
+        url TEXT NOT NULL,
+        title TEXT,
+        feed_name TEXT,
+        matched_topic TEXT,
+        analysis_json TEXT,
+        created_at TEXT DEFAULT (datetime('now', 'localtime'))
+      )
+    `);
+  }
+  return db;
+}
+
+function hashUrl(url) {
+  return crypto.createHash('md5').update(url).digest('hex');
+}
+
+/**
+ * 检查文章是否已处理过
+ */
+export function isProcessed(url) {
+  const row = getDb().prepare('SELECT 1 FROM articles WHERE url_hash = ?').get(hashUrl(url));
+  return !!row;
+}
+
+/**
+ * 过滤出未处理的文章
+ */
+export function filterNew(articles) {
+  return articles.filter(a => !isProcessed(a.link));
+}
+
+/**
+ * 保存已处理的文章
+ */
+export function markProcessed(article, analysis) {
+  getDb().prepare(`
+    INSERT OR IGNORE INTO articles (url_hash, url, title, feed_name, matched_topic, analysis_json)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(
+    hashUrl(article.link),
+    article.link,
+    article.title,
+    article.feedName,
+    article.matchedTopic?.name || '',
+    JSON.stringify(analysis),
+  );
+}
+
+/**
+ * 获取历史记录
+ * @param {number} days - 最近几天
+ * @param {number} limit - 最多返回条数
+ */
+export function getHistory(days = 7, limit = 50) {
+  return getDb().prepare(`
+    SELECT url, title, feed_name, matched_topic, analysis_json, created_at
+    FROM articles
+    WHERE created_at >= datetime('now', 'localtime', ?)
+    ORDER BY created_at DESC
+    LIMIT ?
+  `).all(`-${days} days`, limit);
+}
+
+/**
+ * 关闭数据库连接
+ */
+export function closeDb() {
+  if (db) {
+    db.close();
+    db = null;
+  }
+}