Skip to content
文章目录
GitHub Star
ETF AGENT / NOTES

OPEN ETF AGENT / A RUNNABLE FIELD GUIDE

读懂一个机制。
跑出一份可回读的报告。

不止阅读 Agent 架构文章:运行对应实现,打开产出的报告,再追查代码、原始来源与执行证据。

开源教学实现 · 合成示例 · 默认演示无需模型密钥

按模块与能力阅读六层地图 ​

点击图内卡片进入对应文章;可全屏展开、缩放和滚动。图中是 Open 的有界公开实现,不代表专文所述全部能力已开源或通过验收。

当前范围: v0.33.0 · 固定导航源 · 代码与验证边界

全景图 · 点击模块阅读专文

在独立页面打开图

逐模块文章入口(与图内链接一致)

L1 · 任务输入与触发 ​

L2 · 身份、会话与上下文 ​

L3 · Agent 决策与运行 ​

L4 · 工具与领域能力 ​

L5 · 结果发布与交付 ​

L6 · 用户界面 ​

虚线卡片是同一 Owner 的调用位置,不另算独立模块。文章链接属于阅读导航,不改变已有文章覆盖资格与历史验收记录。GitHub README 中的图仅作预览,图内交互在本页提供。

01 / READ → RUN → INSPECT

从最近三个模块读起。

全部文章目录 →

按模块演进顺序排列,不代表文章发表日期。文章讲清完整机制,也标出公开实现的有限切片。

第一次来?先读系统总览 →

准备接入自己的资料?进入 v0.20 练手篇 →

02 / TRY IT LOCALLY

第一份报告,就在你的磁盘上。

需要 Node.js 26.8.1–26.x 与 npm。安装依赖需要访问 npm;安装后的默认示例离线运行,无需模型密钥。

CLI 会打印 runs/ 下新建的目录。打开 report.md 阅读报告;manifest.json 与 run.jsonl 保留交付和执行记录。这是合成示例,不是实时基金研究。

安装说明与更多示例 ↗
终端
git clone https://github.com/hpoenixf/open-etf-agent.git
cd open-etf-agent
npm ci --ignore-scripts --no-audit --no-fund
npm run build
npm run demo -- --case document-compare

03 / THE BUILD LOG

一次增量,系统更清晰一点。

源码谱系 ↗

固定开发快照,不是 Release 注册表。打开任一阶段检查原始代码;每一阶段只有一个独立交付重点。

v0.14 只读 Memory:固定源码与运行示例 ↗

  1. 0.33项目资料版本管理Text/PDF · frozen task sources · bounded recovery
  2. 0.32查询动态本地知识Local E5 · atomic budgets · no-replay recovery
  3. 0.31查询本地知识Selected text · BM25 · original source readback
查看全部版本 · 33

完整开发历史

  1. 0.1第一份可回读报告Runtime · Gateway · Tool Host
  2. 0.2方法接入工具链Skill · MCP · SSE
  3. 0.3有边界地协作Child · Hook · shared budget
  4. 0.4保留原始事实Result · Context · Retrieval
  5. 0.5便笺不是原始事实Compaction · explicit Memory
  6. 0.6按身份交付与读取Artifact · Revision · Reader
  7. 0.7可信扩展与恢复Plugin · SQLite · lease / fence
  8. 0.8独立提交回答正文Publication · revision CAS
  9. 0.9沿同一个 Run 继续Submit · Worker · readback
  10. 0.10一个结果,真实消费Result / Reference · report · CSV
  11. 0.11读取原始 PDFLocal text layer · physical page · original bytes
  12. 0.12固定任务时间Temporal · IANA zone · original task date
  13. 0.13采用原普通回复Ordinary response · receipt · same-Run adoption
  14. 0.14只读既有记忆Memory · current revision · actual request
  15. 0.15核对来源再交接Specialist Child · exact evidence · Main
  16. 0.16读取时重核资格Revocable source · Publication · Reader
  17. 0.17共享准入容量Shared Admission · original request
  18. 0.18唤醒一次已确认的时间机会Schedule · explicit wake · same Run
  19. 0.19组合既有契约Original owners · explicit inputs · bounded summary
  20. 0.20运行自己的研究项目Local sources · same-Run recovery · layered evidence
  21. 0.21让回答回到原任务Sequential questions · durable receipt · explicit adoption
  22. 0.22有界委派只读研究Serial Child · scoped sources · original Main
  23. 0.23检索已准入原文Knowledge · lexical retrieval · original source
  24. 0.24修订之间保留项目容量Endpoint identity · original tickets · project-local scope
  25. 0.25确认并执行一次定时任务Once schedule · explicit due work · original lifecycle
  26. 0.26获取有界 Web 证据Public static pages · originals · source-backed readback
  27. 0.27冻结项目专家方法Exact revisions · ordered presets · original Child
  28. 0.28复核冻结的报告Advisory findings · original sources · cold readback
  29. 0.29显式对话与任务接续Message identity · fresh grants · bounded historical context
  30. 0.30独立控制原 Child 生命周期Spawn · inspect · cancel · immutable observations · cold recovery
  31. 0.31查询本地知识Selected text · BM25 · original source readback
  32. 0.32查询动态本地知识Local E5 · atomic budgets · no-replay recovery
  33. 0.33项目资料版本管理Text/PDF · frozen task sources · bounded recovery

GitHub Releases ↗

04 / WHAT TO LOOK FOR

沿着结果走,不只看架构图。

读原始来源

把来源身份与摘要、工作便笺区分开。

沿原 Run 继续

检查显式检查点与有限恢复,不假定重试天然安全。

重新打开交付

从报告文件、产物版本追溯到对应执行记录。

05 / THE FULL READING MAP

阅读机制,也检查边界。

完整目录 →

从这里开始:v0.10 系统总览 →
再回看 v0.1 的起点:第一份可回读报告 →

模块专文沿既有目录组织,关联专题保留各自主类,不重复计入模块篇数。回执只证明指定切片;文章讨论的完整机制和后续新增文章,不等于已实现覆盖。

展开模块与关联阅读地图 · 50

01L1 · 任务输入与触发

02L2 · 身份、会话与上下文

03L3 · Agent 决策与运行

04L4 · 工具与领域能力

05L5 · 结果发布与交付

06L6 · 用户界面

07关联阅读 · 架构设计与系统思考 / 深度持续研究

08关联阅读 · 架构设计与系统思考 / Subagent 与专家

09关联阅读 · 架构设计与系统思考 / 系统边界与演进

010关联阅读 · AI Agent 研发工程实践 / 真实验证与任务收敛

与个人博客并行:这里按问题连续阅读,博客保留时间线。 · 联系邮箱:hpoenixf@foxmail.com · 微信:hpoenixf0510