文章链接提取工具

⚠️ 使用规则（必须遵守）

1. 只通过 CLI 命令调用 — 运行 python3 {baseDir}/scripts/article_link.py <command>，不要自己写脚本，不要用 curl/requests 直接调 API
2. 先读 config.json — 执行任何命令前，先读取 {baseDir}/config.json 检查 import_token 是否已配置
3. 注意每日次数限制 — 基础模式 50 次/天，深度解析 5 次/天，提交前可先用 quota 查看剩余次数
4. 深度解析必须确认 — 使用 --deep 时脚本会自动拦截并返回配额信息，必须将配额告知用户并获得明确确认后，才能加 --yes 执行

第一步：检查配置

每次使用前先读取 {baseDir}/config.json：

{
    "api_base": "https://pick-read.vip/api",
    "import_token": "imp-xxx..."
}

• 如果 import_token 为空 → 告知用户：请到 pick-read.vip 账户页生成导入令牌并填入 config.json
• 如果 import_token 已填写 → 直接执行命令，无需再传 --token 参数

工作流 A：查看支持的媒体来源

python3 {baseDir}/scripts/article_link.py media

返回示例：

{
  "type": "media_list",
  "total": 15,
  "media": [
    {"domain": "ft.com", "name": "Financial Times"},
    {"domain": "wsj.com", "name": "Wall Street Journal"},
    {"domain": "nytimes.com", "name": "New York Times"}
  ]
}

工作流 B：查看今日配额

python3 {baseDir}/scripts/article_link.py quota

返回示例：

{
  "type": "quota",
  "basic_used": 3,
  "basic_limit": 50,
  "deep_used": 0,
  "deep_limit": 5
}

工作流 C：提交文章链接

python3 {baseDir}/scripts/article_link.py submit "https://www.wsj.com/articles/some-article"

返回示例（已匹配 — 直接返回英文全文，无需额外命令）：

{
  "type": "submit_matched",
  "job_id": "abc123",
  "origin_url": "https://www.wsj.com/articles/some-article",
  "source_media": "Wall Street Journal",
  "mode": "basic",
  "status": "matched",
  "matched_article_id": "def456",
  "title": "Article Title in English",
  "content_html": "<p>Full article text in English...</p>",
  "original_publish_time": "2026-04-10T08:00:00",
  "next_action": "done — 将 title + content_html 英文全文展示给用户"
}

→ type=submit_matched 表示已拿到全文，直接展示 title + content_html 给用户即可

返回示例（未匹配，排队提取）：

{
  "type": "submit_pending",
  "job_id": "abc123",
  "origin_url": "https://www.wsj.com/articles/some-article",
  "source_media": "Wall Street Journal",
  "mode": "basic",
  "status": "pending_extract",
  "next_action": "poll — 用 status \"abc123\" 轮询任务状态"
}

→ 按 next_action 指引操作，无需自行判断

可选参数：

• --deep — 深度解析模式，跳过已有匹配，直接重新提取
• --yes — 确认执行深度解析（必须在用户确认后才能使用）

深度解析确认流程（强制）

当用户要求深度解析时，必须分两步执行：

步骤 1: 触发确认提示

python3 {baseDir}/scripts/article_link.py submit "https://..." --deep

返回示例：

{
  "type": "deep_confirm_required",
  "message": "深度解析每日仅 5 次，今日已用 1 次，剩余 4 次。请确认后使用 --yes 执行。",
  "deep_used": 1,
  "deep_limit": 5,
  "deep_remaining": 4,
  "confirm_command": "submit \"https://...\" --deep --yes"
}

→ 将 message 展示给用户，询问是否确认执行

步骤 2: 用户确认后执行

python3 {baseDir}/scripts/article_link.py submit "https://..." --deep --yes

⚠️ 禁止跳过步骤 1 直接使用 --deep --yes，必须先让用户看到配额并确认

status 字段含义：

• matched — 已匹配，脚本已自动获取英文全文，直接展示
• pending_extract — 未匹配，已排队等待提取，按 next_action 轮询
• processing — 提取进行中，继续轮询
• ready — 提取完成，脚本已自动获取全文
• failed — 提取失败，告知用户