单人版执行方案（v0）¶

目标：让单人开发在 4-6 周内交付“研究导航器”的最小可用版本，满足三件交付物：本周热点清单、可复用研究路径、方法迁移扩散回放。

0. 单人版边界与默认假设¶

数据源：只做 arXiv + OpenReview（Primary），OpenAlex/Crossref 作为可选补全（Secondary）。
图谱范围：只做 Paper/Method/Task 三类节点；Model/Dataset 延后。
证据类型：仅启用 citation、same_venue_revision、shared_dataset、semantic_similarity 四类；shared_metric 后置。
导出格式：仅支持 Markdown、CSV；BibTeX/Zotero 延后。
协作：单人版只有个人工作台；团队空间、评论、权限不做。
交付形态：纯 Web 静态页面，无数据库、无后端 API。

1. URL 路由与页面清单（单人版）¶

/ Today Radar
/explore 图谱探索
/topic/:cluster_id 主题页
/paper/:paper_id 论文详情
/path 路径构建
/trends 趋势回放
/workspace 工作台
/subscriptions 订阅与提醒（轻量版）
/compare 对比页（可选）
/quality 数据质量（可选）

MVP 必做：Today Radar / Explore / Paper / Path / Trends / Workspace / Subscriptions（轻量）

2. 数据结构（核心 JSON 结构）¶

2.1 节点（Node）¶

{
  "id": "paper:arxiv:2401.12345",
  "type": "Paper",
  "title": "...",
  "year": 2024,
  "venue": "arXiv",
  "identifiers": {
    "doi": "10.1234/abcd",
    "arxiv_id": "2401.12345",
    "openreview_id": "..."
  },
  "authority": {
    "publisher": "Crossref",
    "preprint": "arXiv",
    "review": "OpenReview"
  },
  "timestamps": {
    "published_at": "2024-01-18",
    "updated_at": "2024-01-20"
  },
  "summary": {
    "one_liner": "...",
    "method_points": ["...", "...", "..."],
    "limitations": "..."
  }
}

2.2 边（Edge）¶

{
  "id": "edge:paper:paper:123",
  "type": "CITES",
  "from": "paper:arxiv:2401.12345",
  "to": "paper:doi:10.1234/abcd",
  "evidence": {
    "type": "citation",
    "payload": {
      "doi": "10.1234/abcd",
      "source": "Crossref"
    }
  },
  "first_seen_at": "2024-01-20"
}

2.3 Cluster（主题）¶

{
  "id": "cluster:method:retrieval-augmented-generation",
  "label": "Retrieval-Augmented Generation",
  "keywords": ["RAG", "retrieval", "indexing"],
  "representatives": {
    "papers": ["paper:...", "paper:..."],
    "methods": ["method:..."],
    "tasks": ["task:..."]
  }
}

2.4 路径（Path）¶

{
  "id": "path:2026-01-24-001",
  "start": "method:...",
  "end": "task:...",
  "papers": ["paper:1", "paper:2", "paper:3"],
  "edges": ["edge:1", "edge:2"],
  "length": 7,
  "created_by": "user:me",
  "created_at": "2026-01-24"
}

3. 排序公式口径（可解释可复算）¶

3.1 热点榜单分数¶

score = w1 * normalized(new_papers_7d + new_edges_7d)
      + w2 * normalized(time_weighted_pagerank)
      + w3 * normalized(bridge_ratio)

bridge_ratio = cross_cluster_edges_7d / total_edges_7d
time_weighted_pagerank 采用 30 天衰减窗口

3.2 迁移雷达分数（方法 → 任务）¶

transfer_score = normalized(new_task_coverage_7d) + normalized(first_seen_recentness)

new_task_coverage_7d = new_tasks_7d / total_tasks_history

4. 静态数据文件合同（单人版）¶

所有数据以静态 JSON 文件发布，前端通过 fetch 读取。每个数据文件包含 version 与 generated_at 字段，便于复核与缓存。

4.0 构建入口（静态数据包）¶

python3 tools/paper_graph_time/build_static_data.py \
  --source docs/assets/paper-graph-time/source \
  --output docs/assets/paper-graph-time/data

4.1 Today Radar¶

/assets/paper-graph-time/data/radar-7d.json
/assets/paper-graph-time/data/radar-30d.json

{
  "version": "2026-01-24",
  "generated_at": "2026-01-24T08:00:00Z",
  "clusters": [{
    "cluster_id": "cluster:method:rag",
    "label": "RAG",
    "new_papers_7d": 18,
    "new_edges_7d": 42,
    "key_papers": ["paper:1", "paper:2", "paper:3"],
    "growth_curve": [{"date": "2026-01-18", "papers": 3, "edges": 8}],
    "score": 0.82,
    "evidence_ref": ["edge:...", "edge:..."]
  }],
  "method_radar": [{
    "method_id": "method:rag",
    "new_tasks": ["task:qa", "task:search"],
    "first_seen": "2026-01-20",
    "score": 0.71
  }]
}

4.2 Explore 图谱¶

/assets/paper-graph-time/data/graph-lite.json（近 90 天子图）
/assets/paper-graph-time/data/graph-index.json（搜索索引：title/author/keyword）

子图查询与路径搜索在前端完成（限制 2 跳、TopN 边）。

4.3 Topic 主题页¶

/assets/paper-graph-time/data/clusters.json
/assets/paper-graph-time/data/cluster/{id}.json

4.4 Paper 论文详情¶

/assets/paper-graph-time/data/paper/{id}.json
/assets/paper-graph-time/data/paper/{id}-edges.json

4.5 Path Builder¶

/assets/paper-graph-time/data/paths/recommended.json
/assets/paper-graph-time/data/paths/{id}.json

单人版默认提供“推荐路径”，路径搜索使用前端 BFS/最短路在 graph-lite.json 上完成。

4.6 Trends¶

/assets/paper-graph-time/data/trends/{cluster_id}.json
/assets/paper-graph-time/data/trends/compare.json

4.7 Subscriptions（轻量）¶

/assets/paper-graph-time/data/updates-7d.json

订阅清单存本地（localStorage），更新提醒通过前端对比新旧 version。

4.8 Workspace¶

本地存储：localStorage + 导出 JSON/Markdown

5. 事件埋点（单人版必埋）¶

radar_view：window
cluster_open：cluster_id, source
method_open：method_id
paper_open：paper_id
path_generate：start, end, length
path_export：format, path_id
subscription_create：target_type, target_id
workspace_save：item_type, item_id
evidence_open：edge_id, evidence_type

单人版埋点可写入 localStorage，并提供“导出埋点 JSON”按钮用于复盘。

6. 数据摄取与归一（单人版）¶

6.1 摄取频率¶

arXiv：OAI nightly
OpenReview：按 venue 每日变更

6.2 去重规则¶

主键优先级：DOI > arXiv id > OpenReview forum id > venue-local id
冲突显示：页面展示来源与时间戳

6.3 抽取策略（单人版）¶

Method / Task：先用规则 + 关键词表 + 论文标题/摘要提取
semantic_similarity：仅在 TopN 相似论文对上生成边并展示相似段落

7. MVP 删减清单（单人版）¶

不做团队空间、评论、权限
不做 BibTeX/Zotero 导出
Compare/Quality 页面可延后
只做 2 跳子图、不开全图
只做 arXiv + OpenReview 两源
不做后端 API 与数据库

8. 交付节奏（单人版 4-6 周）¶

第 1-2 周：摄取 + 去重 + Paper/CITES
第 3 周：Method/Task 抽取 + 子图查询
第 4 周：Today Radar + Path Builder
第 5-6 周：Trends + Workspace + Subscriptions（轻量）