Skip to content
ETF AGENT / NOTES

OPEN ETF AGENT / A RUNNABLE FIELD GUIDE

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

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

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

01 / READ → RUN → INSPECT

从最近三个模块读起。

全部文章目录 →

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

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

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.14只读既有记忆Memory · current revision · actual request
  2. 0.13采用原普通回复Ordinary response · receipt · same-Run adoption
  3. 0.12固定任务时间Temporal · IANA zone · original task date
查看全部版本 · 14

完整开发历史

  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

GitHub Releases ↗

04 / WHAT TO LOOK FOR

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

读原始来源

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

沿原 Run 继续

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

重新打开交付

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

05 / THE FULL READING MAP

阅读机制,也检查边界。

完整目录 →

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

沿既有模块目录组织,不另造文章索引。回执只证明指定切片;文章讨论的完整机制和后续新增文章,不等于已实现覆盖。

展开完整模块阅读地图 · 32

01L1 · 任务输入与触发

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

03L3 · Agent 决策与运行

04L4 · 工具与领域能力

05L5 · 结果发布与交付

06L6 · 用户界面

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