本库有两个更新环节:自动发现待阅读候选,以及Markdown 修改后自动更新 HTML。自动发现不等于自动确认论文主张。

发现与审阅

收集源配置维护在 05-更新/收集源.json,当前包含 arXiv、工程博客 RSS、研究者博客和 Hacker News。修改地址或主题词即可调整发现范围。

在子库目录运行:

python3 tools/discover_graph_agent_sources.py

脚本保留历史未处理候选,按 URL 去重,并排除来源表已登记的材料。输出 自动发现候选、候选池 JSON 与本次采集状态。直连失败时尝试已确认的 Windows 代理;失败源记录错误,不补造结果。

本轮已实际执行该命令。2026-11-17 的最终收集运行中,四个收集源全部可解析,候选池包含 125 条待阅读材料;首轮失效的两条博客 feed 已改为站点实际公开地址,首次失败记录仍保留。当前为按需执行,没有安装后台定时任务;候选报告显示最近运行时间与失败源。X 暂以原文/项目链出的具体 post ID 扩展,未实现全站持续监控。

纳入正式来源

  1. 检查候选标题、canonical URL、已有条目及版本;一篇论文的作者帖与仓库是关联来源,不重复计算独立实验。
  2. 阅读可访问原文,记录实际深度:元数据/摘要、正文重点阅读、工程文章正文或评论。精确标明日期和后续修订。
  3. 在 研究来源登记 增加来源行,并在论文卡片或来源笔记目录创建 Markdown。使用相同 source_id;ID 不应重用。
  4. 写清问题、机制、图的职责、实验范围/工程条件、局限与关联阅读。没有实际验证的设想明确称为设想。
  5. 新论文若有动机、方法或任务概览图,保留原图、图号和出处;图示文件放在笔记可引用的本地路径。尚未确认的图示不伪装成已补全。
  6. 只有材料确实改变了瓶颈、方法回应或新问题时,才修改交互研究脉络;不要因为每多一篇文章就增加一条人为阶段。

Markdown 与 HTML 的关系

论文笔记位于 02-论文卡片/;博客、文档、项目、社区和 X 笔记位于 03-索引/来源笔记/。两类笔记都通过 frontmatter 的 source_id 接入同一来源详情页。

01-地图/、04-阅读路线/ 和 05-更新/ 顶层的 Markdown 会自动生成导读页。数量、来源分类、正文、关联链接和本地图片从维护文件生成;生成的 HTML 不作为编辑源。

本地站运行时,Markdown、图示和相关生成器修改会触发重建并通知页面刷新。直接双击 HTML 可离线阅读当前快照;离线文件需要重新生成后才包含新内容。

python3 tools/build_graph_agent_site.py

已阅读与评分保存在当前浏览器;它们不等于维护笔记中的 enriched 状态,也不会因重新生成页面而被清空。不同浏览器或 file:// 与 HTTP 入口之间不保证共享这些标记。