Skip to content

Commit 499cc7d

Browse files
committed
docs: add curated ai reading section
1 parent 4f1ea06 commit 499cc7d

17 files changed

Lines changed: 860 additions & 0 deletions
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
name: Collect reading candidates
2+
3+
on:
4+
schedule:
5+
- cron: "30 1 * * *"
6+
workflow_dispatch:
7+
8+
permissions:
9+
contents: read
10+
issues: write
11+
12+
jobs:
13+
collect:
14+
runs-on: ubuntu-latest
15+
steps:
16+
- name: Checkout
17+
uses: actions/checkout@v4
18+
19+
- name: Setup Python
20+
uses: actions/setup-python@v5
21+
with:
22+
python-version: "3.11"
23+
24+
- name: Collect candidates
25+
run: |
26+
python3 tools/collect_reading_candidates.py \
27+
--sources reading/sources.json \
28+
--since-days 3 \
29+
--max-items 12 \
30+
--output reading-candidates.md
31+
32+
- name: Check if candidates exist
33+
id: candidates
34+
run: |
35+
if grep -q "No matching candidates found." reading-candidates.md; then
36+
echo "has_candidates=false" >> "$GITHUB_OUTPUT"
37+
else
38+
echo "has_candidates=true" >> "$GITHUB_OUTPUT"
39+
fi
40+
41+
- name: Create daily candidate issue
42+
if: steps.candidates.outputs.has_candidates == 'true'
43+
env:
44+
GH_TOKEN: ${{ github.token }}
45+
run: |
46+
title="Reading candidates $(date -u +%F)"
47+
existing="$(gh issue list --state open --search "in:title \"$title\"" --json number --jq '.[0].number // empty')"
48+
if [ -n "$existing" ]; then
49+
echo "Issue already exists: #$existing"
50+
exit 0
51+
fi
52+
gh issue create \
53+
--title "$title" \
54+
--body-file reading-candidates.md

CONTRIBUTING.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66

77
- 修复错别字、失效链接、错误代码。
88
- 给 LLM、RAG、Agent 章节补充最小示例。
9+
- 给热门 AI 技术文章阅读板块补充高质量文章摘要。
910
- 增加“什么时候不用某技术”的边界说明。
1011
- 补充评估方法、失败案例和排错经验。
1112
- 将旧章节更新到当前主流写法。
@@ -40,6 +41,8 @@ python3 tools/check_local_links.py
4041

4142
如果修改了代码示例,请尽量运行对应脚本或 notebook 的关键单元。
4243

44+
如果补充 [热门 AI 技术文章阅读](reading/README.md),请使用 [阅读条目模板](reading/template.md),并确保文章来自一手资料、官方博客、论文、工程复盘或成熟开源项目。
45+
4346
## Issue 建议
4447

4548
提 Issue 时请说明:

README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ AI 工具普及后,学习方式应该从“先补完所有理论”变成“
2727
| 转向 LLM 工程 | [LLM 工程师路线](#llm-工程师路线) | 能构建 Prompt、Embedding、RAG、评估和微调流程 |
2828
| 学 Agent | [Agent 工程路线](#agent-工程路线) | 理解工具调用、工作流、记忆、guardrails 和上线风险 |
2929
| 补经典深度学习 | [经典深度学习补课路线](#经典深度学习补课路线) | 补齐 CNN、RNN、优化、正则化和训练策略 |
30+
| 跟进近期技术文章 | [热门 AI 技术文章阅读](reading/README.md) | 把近期好文章接到本仓库学习路径上 |
3031

3132
## 30 天新人路线
3233

@@ -116,6 +117,18 @@ Agent 学习的重点不是“让模型自己想办法”,而是把任务边
116117
- 能设计评估指标。
117118
- 能定位错误并提出改进方案。
118119

120+
## 热门 AI 技术文章阅读
121+
122+
如果你想跟进近期高质量技术文章,可以看 [热门 AI 技术文章阅读](reading/README.md)
123+
124+
这个板块不做新闻搬运,而是把文章映射到本仓库的学习主题:
125+
126+
- Agent、Coding Agent、Harness、Loop、MCP 和生产化。
127+
- RAG、Embedding、评估和上下文工程。
128+
- 多模态、模型推理、部署和安全。
129+
130+
每条文章都会附上推荐阅读前置、推荐理由、中文摘要和读完应该带走的判断。自动化只负责收集候选链接,最终精选仍由人工筛选。
131+
119132
## 目录结构
120133

121134
### 数学基础
@@ -177,6 +190,17 @@ Agent 学习的重点不是“让模型自己想办法”,而是把任务边
177190
- [Loop Engineering](llm/loop-engineering.md)
178191
- [Agent 生产化](llm/agent-production.md)
179192

193+
### 热门技术文章阅读
194+
195+
- [阅读总览](reading/README.md)
196+
- [2026 年 6 月精选](reading/2026/06.md)
197+
- [Agent 阅读索引](reading/topics/agent.md)
198+
- [Coding Agents 阅读索引](reading/topics/coding-agents.md)
199+
- [LLM 应用工程阅读索引](reading/topics/llm-engineering.md)
200+
- [RAG 阅读索引](reading/topics/rag.md)
201+
- [多模态阅读索引](reading/topics/multimodal.md)
202+
- [模型推理与基础设施阅读索引](reading/topics/infra.md)
203+
180204
### 多模态
181205

182206
- [多模态总览](multimodal/README.md)
@@ -207,6 +231,7 @@ Agent 学习的重点不是“让模型自己想办法”,而是把任务边
207231

208232
- 修正文档错误和失效链接。
209233
- 给 LLM/RAG/Agent 章节补充可验证的最小示例。
234+
-[热门 AI 技术文章阅读](reading/README.md) 补充高质量文章摘要。
210235
- 补充评估方法、失败案例和排错经验。
211236
- 改善中文表达和学习路径衔接。
212237

ROADMAP.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,15 @@
4949
- LoRA 微调小项目。
5050
- 多模态检索项目。
5151

52+
### 阶段 4:热门技术文章阅读
53+
54+
- [x] 增加热门 AI 技术文章阅读入口。
55+
- [x] 增加月度精选模板和 2026 年 6 月首期精选。
56+
- [x] 增加 Agent、Coding Agent、RAG、多模态、基础设施等主题索引。
57+
- [x] 增加 RSS 候选收集脚本和每日 GitHub Actions。
58+
- [ ] 建立每周人工筛选节奏,把候选 issue 沉淀为精选文章。
59+
- [ ] 后续增加“本月最值得读的 3 篇”摘要。
60+
5261
## 内容标准
5362

5463
新增章节建议包含:
@@ -63,6 +72,7 @@
6372
## 不做什么
6473

6574
- 不做每日新闻汇总。
75+
- 不让自动化未经人工审核直接把热门文章写入主分支。
6676
- 不维护模型能力排行榜。
6777
- 不收集无法验证的传闻。
6878
- 不把复杂框架当成学习前置条件。

_layouts/default.html

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@
1414
<nav class="site-nav" aria-label="主导航">
1515
<a href="{{ '/' | relative_url }}">首页</a>
1616
<a href="{{ '/llm/' | relative_url }}">LLM 与 Agent</a>
17+
<a href="{{ '/reading/' | relative_url }}">技术文章</a>
1718
<a href="{{ '/deep-learning/' | relative_url }}">深度学习</a>
1819
<a href="{{ '/machine-learning/' | relative_url }}">机器学习</a>
1920
<a href="https://github.com/{{ site.repository }}">GitHub</a>
@@ -37,6 +38,14 @@
3738
<a href="{{ '/llm/coding-agents.html' | relative_url }}">AI 编程智能体</a>
3839
<a href="{{ '/llm/harness-engineering.html' | relative_url }}">Harness Engineering</a>
3940
<a href="{{ '/llm/loop-engineering.html' | relative_url }}">Loop Engineering</a>
41+
42+
<p class="sidebar__title">技术文章阅读</p>
43+
<a href="{{ '/reading/' | relative_url }}">阅读总览</a>
44+
<a href="{{ '/reading/2026/06.html' | relative_url }}">2026 年 6 月精选</a>
45+
<a href="{{ '/reading/topics/agent.html' | relative_url }}">Agent</a>
46+
<a href="{{ '/reading/topics/coding-agents.html' | relative_url }}">Coding Agents</a>
47+
<a href="{{ '/reading/topics/llm-engineering.html' | relative_url }}">LLM 应用工程</a>
48+
<a href="{{ '/reading/topics/rag.html' | relative_url }}">RAG</a>
4049
</nav>
4150
</aside>
4251

reading/2026/06.md

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
# 2026 年 6 月精选
2+
3+
本页记录 2026 年 6 月值得加入学习路径的 AI 技术文章。重点不是追热点,而是帮助读者理解 Agent、RAG、Coding Agent、Harness、Loop、评估和生产化。
4+
5+
## 2026-06-20 首期精选
6+
7+
### Securing the future of AI agents
8+
9+
- 链接:<https://deepmind.google/blog/securing-the-future-of-ai-agents/>
10+
- 来源:Google DeepMind
11+
- 日期:2026-06-18
12+
- 主题:Agent Security / Agent Production
13+
- 难度:高级
14+
- 推荐阅读前置:[Agent 生产化](../../llm/agent-production.md)[Loop Engineering](../../llm/loop-engineering.md)
15+
- 推荐理由:这篇文章把 Agent 安全从“模型对齐”扩展到“系统级控制”,非常适合理解高权限 Agent 上线后的监控、阻断和响应机制。
16+
- 摘要:文章提出 AI Control Roadmap,把越来越自主的 Agent 当作需要分层防御的系统来管理。核心思路是用监控、预防和响应机制配合模型能力分级,并用安全领域的威胁建模方法分析 Agent 可能出现的异常行为。文中还提到通过大量 coding agent 轨迹数据来改进实时监控。
17+
- 读完应该带走什么:Agent 安全不是只靠 prompt 或 refusal,而是权限、沙箱、行为监控、审计、响应策略共同构成的系统工程。
18+
19+
### The Art of Loop Engineering
20+
21+
- 链接:<https://www.langchain.com/blog/the-art-of-loop-engineering>
22+
- 来源:LangChain
23+
- 日期:2026-06-16
24+
- 主题:Loop Engineering / Agent Harness
25+
- 难度:中级
26+
- 推荐阅读前置:[Loop Engineering](../../llm/loop-engineering.md)[Harness Engineering](../../llm/harness-engineering.md)
27+
- 推荐理由:这篇文章和本仓库新增的 Loop Engineering 章节高度对应,适合作为“为什么 loop 是 Agent 工程核心”的外部补充。
28+
- 摘要:文章强调,可靠 Agent 不只是强模型加工具,而是要设计适合任务的 harness 和循环。Loop 决定 Agent 如何行动、如何获得反馈、如何修正、什么时候停止。对于编码、研究、数据分析等任务,loop 的结构往往比单次提示词更能决定系统稳定性。
29+
- 读完应该带走什么:设计 Agent 时,要把“反馈从哪里来、如何验证、何时停止”写成显式工程结构,而不是指望模型自然收敛。
30+
31+
### How to Build a Custom Agent Harness
32+
33+
- 链接:<https://www.langchain.com/blog/how-to-build-a-custom-agent-harness>
34+
- 来源:LangChain
35+
- 日期:2026-06-03
36+
- 主题:Harness Engineering / Agent Architecture
37+
- 难度:中级
38+
- 推荐阅读前置:[Harness Engineering](../../llm/harness-engineering.md)[Agent 工具调用](../../llm/agent-tools.md)
39+
- 推荐理由:文章用“agent = model + harness”的视角解释为什么上下文、工具、内存、沙箱和中间件会决定 Agent 的实际能力。
40+
- 摘要:文章把 harness 定义为连接模型和真实世界的脚手架。一个有效 harness 要在每一步为模型提供合适上下文,并通过 middleware 处理业务逻辑、工具生命周期、上下文管理、guardrails 等问题。它提醒读者不要只关注模型选择,而要关注模型外部的运行环境。
41+
- 读完应该带走什么:Agent 的可用性来自模型和外部工程系统的配合;工具、状态、权限、上下文和错误处理都属于 harness 设计。
42+
43+
### Fault Tolerance in LangGraph: Retries, Timeouts, and Error Handlers
44+
45+
- 链接:<https://www.langchain.com/blog/fault-tolerance-in-langgraph>
46+
- 来源:LangChain
47+
- 日期:2026-06-04
48+
- 主题:Agent Reliability / Workflow
49+
- 难度:中级
50+
- 推荐阅读前置:[Agent 工作流模式](../../llm/agent-workflows.md)[Agent 生产化](../../llm/agent-production.md)
51+
- 推荐理由:很多 Agent demo 忽略真实环境中的网络失败、工具错误、限流和超时;这篇文章把容错设计放到节点级别讨论。
52+
- 摘要:文章介绍 retries、timeouts、error handlers 三类基础容错机制,并强调这些配置应该和节点逻辑放在一起。对于多步骤 Agent 来说,失败不可避免,关键是让系统知道哪些错误可以重试、哪些错误应该终止、哪些错误需要进入补救路径。
53+
- 读完应该带走什么:生产级 Agent 必须把失败路径当作一等公民;没有重试、超时和错误处理的 workflow 只是 demo。
54+
55+
### Scaling Managed Agents: Decoupling the brain from the hands
56+
57+
- 链接:<https://www.anthropic.com/engineering/managed-agents>
58+
- 来源:Anthropic Engineering
59+
- 日期:2026-04-08
60+
- 主题:Long-running Agents / Agent Runtime
61+
- 难度:高级
62+
- 推荐阅读前置:[AI 编程智能体](../../llm/coding-agents.md)[Harness Engineering](../../llm/harness-engineering.md)
63+
- 推荐理由:文章讨论长周期 Agent 的运行时抽象,对理解“模型能力变化后,harness 也必须演进”很有价值。
64+
- 摘要:文章认为 harness 会编码关于模型能力的假设,而这些假设会随模型进步而过期。Anthropic 的 Managed Agents 把 session、harness、sandbox 等 Agent 组件抽象出来,让实现细节可以替换,而外部接口保持稳定。这是从单次对话工具走向长期任务系统的重要设计思路。
65+
- 读完应该带走什么:长期 Agent 的关键不是把一个进程跑很久,而是设计稳定接口、可恢复状态和可替换运行环境。
66+
67+
### Harness design for long-running application development
68+
69+
- 链接:<https://www.anthropic.com/engineering/harness-design-long-running-apps>
70+
- 来源:Anthropic Engineering
71+
- 日期:2026-03-24
72+
- 主题:Coding Agent / Harness / Evaluation
73+
- 难度:高级
74+
- 推荐阅读前置:[AI 编程智能体](../../llm/coding-agents.md)[Loop Engineering](../../llm/loop-engineering.md)
75+
- 推荐理由:这是理解长时间自主编码 Agent 的重要工程复盘,尤其适合对 Codex、Claude Code 等工具感兴趣的读者。
76+
- 摘要:文章围绕前端设计和长周期应用开发,讨论为什么 naive agent 容易在复杂任务中失控,并提出通过任务分解、上下文重置、结构化 handoff、planner-generator-evaluator 等方式提升长任务表现。它把“让 Agent 自己写应用”拆成可管理的循环和交接机制。
77+
- 读完应该带走什么:长周期 Coding Agent 需要拆解、交接、评估和重启机制;上下文管理和 evaluator 设计不亚于模型能力本身。
78+
79+
### How we built our multi-agent research system
80+
81+
- 链接:<https://www.anthropic.com/engineering/multi-agent-research-system>
82+
- 来源:Anthropic Engineering
83+
- 日期:2025-06-13
84+
- 主题:Multi-agent / Research Agent
85+
- 难度:高级
86+
- 推荐阅读前置:[Agent 工作流模式](../../llm/agent-workflows.md)[Agent 记忆与上下文](../../llm/agent-memory-context.md)
87+
- 推荐理由:这篇文章是多 Agent 系统从 prototype 到 production 的一手复盘,适合学习并行子任务、压缩、协调和评估。
88+
- 摘要:文章解释 Claude Research 如何由一个 lead agent 规划研究流程,并创建多个并行 subagents 搜索不同方向的信息。它强调多 Agent 适合开放式研究任务,因为研究过程需要根据中间发现不断调整;同时也带来协调、评估和可靠性挑战。
89+
- 读完应该带走什么:多 Agent 的价值通常来自并行探索和上下文隔离,但代价是协调成本、评估复杂度和更高资源消耗。
90+
91+
### A practical guide to building agents
92+
93+
- 链接:<https://openai.com/business/guides-and-resources/a-practical-guide-to-building-ai-agents/>
94+
- 来源:OpenAI
95+
- 日期:页面未标注
96+
- 主题:Agent Design / Guardrails
97+
- 难度:入门到中级
98+
- 推荐阅读前置:[AI Agent](../../llm/agent.md)[Agent 工具调用](../../llm/agent-tools.md)
99+
- 推荐理由:这是一篇适合初学者建立 Agent 全局框架的长文,覆盖 use case 判断、模型、工具、指令、编排和 guardrails。
100+
- 摘要:文章把 Agent 定义为能代表用户独立完成任务的系统,并强调 Agent 适合传统规则系统难以覆盖的复杂判断、非结构化数据和多步骤流程。它将 Agent 设计拆成模型、工具、指令和编排,并把 guardrails 作为上线前的重要部分。
101+
- 读完应该带走什么:不是所有 LLM 应用都应该做成 Agent;只有当任务需要动态决策、工具操作和多步骤恢复时,Agent 的复杂度才有收益。
102+
103+
### Building effective agents
104+
105+
- 链接:<https://www.anthropic.com/engineering/building-effective-agents>
106+
- 来源:Anthropic Engineering
107+
- 日期:2024-12-19
108+
- 主题:Agent Patterns / Workflows
109+
- 难度:入门到中级
110+
- 推荐阅读前置:[AI Agent](../../llm/agent.md)[Agent 工作流模式](../../llm/agent-workflows.md)
111+
- 推荐理由:虽然不是最新文章,但它是理解 Agent 与 workflow 区别、避免过度复杂化的基础读物。
112+
- 摘要:文章区分 workflows 和 agents:前者由预设代码路径编排,后者由模型动态决定流程和工具使用。它总结了 prompt chaining、routing、parallelization、orchestrator-workers、evaluator-optimizer 等常见模式,并反复强调从简单方案开始,只在评估证明必要时增加复杂度。
113+
- 读完应该带走什么:Agent 工程的第一原则不是追求自主性,而是用最简单、最透明、最可评估的结构解决问题。

reading/README.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# 热门 AI 技术文章阅读
2+
3+
这个板块不是 AI 新闻列表,而是把近期值得读的技术文章接到本仓库的学习路径上。
4+
5+
筛选文章时优先回答三个问题:
6+
7+
1. 这篇文章补充了仓库里的哪个主题。
8+
2. 读者读完后能带走什么工程判断。
9+
3. 这篇文章是否仍然值得在几个月后回看。
10+
11+
## 推荐阅读方式
12+
13+
如果你正在系统学习,建议先读对应的仓库章节,再读外部文章:
14+
15+
| 学习方向 | 仓库章节 | 阅读索引 |
16+
| --- | --- | --- |
17+
| Agent 基础 | [AI Agent](../llm/agent.md) | [Agent](topics/agent.md) |
18+
| 编程智能体 | [AI 编程智能体](../llm/coding-agents.md) | [Coding Agents](topics/coding-agents.md) |
19+
| Harness / Loop | [Harness Engineering](../llm/harness-engineering.md)[Loop Engineering](../llm/loop-engineering.md) | [LLM 应用工程](topics/llm-engineering.md) |
20+
| RAG | [RAG](../llm/rag.md)[RAG 评估](../llm/rag-evaluation.md) | [RAG](topics/rag.md) |
21+
| 多模态 | [多模态总览](../multimodal/README.md) | [多模态](topics/multimodal.md) |
22+
| 推理与部署 | [API 与模型选型](../llm/api-and-models.md) | [模型推理与基础设施](topics/infra.md) |
23+
24+
## 最新精选
25+
26+
- [2026 年 6 月精选](2026/06.md)
27+
28+
## 选文标准
29+
30+
优先收录:
31+
32+
- 官方技术博客、论文、工程复盘、开源项目设计文档。
33+
- 能对应到本仓库学习路径的文章,例如 Agent、RAG、评估、MCP、推理部署、多模态。
34+
- 有清晰工程细节的文章,例如架构、失败模式、评估方法、上线经验。
35+
- 观点可验证、可复盘、不是纯营销发布的内容。
36+
37+
暂不收录:
38+
39+
- 单纯模型发布新闻。
40+
- 只比较排行榜、没有方法论的文章。
41+
- 没有一手信息来源的二次转述。
42+
- 无法长期帮助学习者建立判断的热点争议。
43+
44+
## 条目格式
45+
46+
每条文章控制在 150-250 字中文摘要,格式见 [template.md](template.md)
47+
48+
必须包含:
49+
50+
- 链接、来源、日期。
51+
- 主题和难度。
52+
- 推荐阅读前置章节。
53+
- 推荐理由。
54+
- 摘要。
55+
- 读完应该带走什么。
56+
57+
## 更新节奏
58+
59+
建议采用两段式流程:
60+
61+
1. 每天由 GitHub Actions 抓取可信 RSS,生成候选 issue。
62+
2. 人工筛选后,把 3-5 篇真正值得读的文章写入月度精选。
63+
64+
不要让自动化直接提交文章摘要到 `master`。自动化适合做候选收集,最终摘要和推荐理由仍然需要人工判断。
65+
66+
## GitHub Actions 还是 Codex Automations
67+
68+
当前建议:
69+
70+
- GitHub Actions:负责公开、可审计、可复现的候选链接收集。
71+
- Codex Automations:适合做个人提醒、辅助阅读、草拟摘要、定期提示维护者处理候选 issue。
72+
73+
更具体地说:
74+
75+
| 方案 | 适合做 | 不适合做 |
76+
| --- | --- | --- |
77+
| GitHub Actions | 定时抓 RSS、生成候选 issue、跑链接检查、保证流程在仓库内可见 | 自动判断文章质量、直接写入主分支 |
78+
| Codex Automations | 每天提醒维护者筛选、帮忙总结候选文章、把 issue 草拟成 PR 内容 | 作为唯一公开记录、替代仓库内 CI 流程 |
79+
80+
因此本仓库先采用 GitHub Actions 收集候选,再由人或 Codex 辅助筛选后提交。
81+
82+
## 可信来源
83+
84+
来源列表见 [sources.md](sources.md)。自动收集的 RSS 源配置见 [sources.json](sources.json)

0 commit comments

Comments
 (0)