ForgePilot · 返回统一入口
← → 翻页 · B 静态 · ESC 索引
ForgePilot · 2026
Vol. 01
写给想学 Agent 的你 · An Invitation

ForgePilot

亲手写一个 ForgePilot

一个用 Java 从零长大的 Agent CLI。从 ReAct 循环到完整的终端产品,持续交付可审阅、可回滚的工程能力。

Hank·项目作者
一场关于 Agent · 代码 · 成长的邀请
— 2026 —
序 · Prologue
02 / 14
序 · 一层毛玻璃

你用过 Agent,
没见过它的心跳。

它替你读文件、改代码、跑命令。可屏幕那头,它每一步到底在想什么——你和它之间,始终隔着一层毛玻璃。

"擦掉毛玻璃的最好办法,
是亲手造一个。"
— ForgePilot 的起点
ForgePilot — java
$ java -jar target/paicli-16.1.0.jar

   ████████    ForgePilot
     ██  ██    Multi-model provider
     ██  ██    MCP · Skills · ReAct
     ██  ██    ReAct · Plan · MCP · Browser
     ██  ██

Tips for getting started:
1. Type / for commands and Tab completion
2. Ask coding questions or run commands
3. Attach context with @path or @image:

* _
Page 02 · 毛玻璃
Prologue
序 · Prologue
03 / 14
为什么动手 · Why Build
"看十篇原理文章, 不如让一个循环 在自己手里跑起来。"

概念是别人的。跑通的那一刻,才是你的。

— Hank·ForgePilot 作者
Page 03 · 起点
— · —
第一幕 · 它长什么样
Act I · 04 / 14
Act I

它长什么样

先看它跑起来,再聊它是怎么长大的。

第一幕引子
— · —
Act I · Anatomy
05 / 14
一个 jar 里的世界

不是玩具,是产品

从一个循环出发,一期一期打磨出来的。

Evolution
23 期
从一个循环到一个产品
Model Providers
8 家
多模型 provider,运行时可切换
Tools
17
内置工具 + MCP 动态注册
Agent Modes
3 种
ReAct · Plan · Multi-Agent
Renderers
3 态
inline 流式 · 全屏 TUI · plain
Safety
4 层
HITL · 路径 · 命令 · 审计
项目 · ForgePilot | Java 17 + Maven
Act I · Numbers
Act I · Anatomy
06 / 14
心跳 · ReAct

终端是冷的,
思考是热的。

敲下回车,它先想,再做,再看结果。思考、行动、观察——一拍一拍,像心跳。

"第一期只写了一个循环。
但 Agent 的一切,都从这个循环开始。"
— Phase 01 · ReAct
ForgePilot — react
* 这个项目的测试为什么挂了?

Thinking… 先跑一次快速回归拿到报错,
再读相关文件,定位真正原因。

⏺ execute_command  mvn test -Pquick
  └ 1 failed · MemoryManagerTest

⏺ Read 2 files (ctrl+o to expand)

· 找到了:第 42 行断言期望值写反了。
  要我直接修掉吗? [y/n/a/s/m]
Page 06 · 思考 — 行动 — 观察
ReAct Loop
Act I · Anatomy
07 / 14
演进 · Evolution

从一个循环,长成一个产品

大脑侧 · How It Thinks
01
ReAct
思考-行动-观察的循环
02
Plan
DAG 拆解复杂任务
03
Memory
短期对话 + 长期记忆
04
RAG
向量检索读懂代码库
05
Team
规划者 · 执行者 · 检查者
手脚侧 · How It Acts
06
HITL
危险操作人工审批
07
MCP
接上外部工具生态
08
Browser
操作真实浏览器
09
Skills
给 Agent 的专家手册
10
TUI
长成 ForgePilot 的工作台
Page 07 · 关键能力
Evolution
第二幕 · 课程表
Act II · 08 / 14
Act II

把它拆开

持续演进,就是一份摊开的 Agent 课程表。

第二幕引子
— · —
Act II · Curriculum
09 / 14
Learning · 两种学法

隔着玻璃看,不如拆开引擎学

Before · 在外面看

收藏了一打教程

  • 名词背了一堆,一动手就卡壳
  • ReAct、MCP、RAG 都是 PPT 上的方框
  • 面试时,只能复述别人的定义
After · 拆开学

跑通了一个 Agent

  • 每个概念,都对应一个能 debug 的 Java 类
  • git log 就是教学大纲,一期一个里程碑
  • 面试时,聊的是自己踩过的坑和做过的取舍
Page 09 · 两种学法
Before / After
Act II · Curriculum
10 / 14
Syllabus · 摘几页课程表

每一期,都是一课

ReAct 循环
Agent 的心跳——思考、行动、观察,一拍一拍
Phase 01
记忆系统
短期对话、长期记忆,让它记住你说过的话
Phase 03
Multi-Agent
规划者、执行者、检查者,三个角色开会干活
Phase 05
MCP 协议
一份配置文件,接上整个外部工具生态
Phase 10
Skill 系统
把"怎么思考"沉淀成可复用的专家手册
Phase 15
TUI 产品化
流式输出、可折叠工具块,长成 ForgePilot 的工作台
Phase 16

…… 以及另外十五期,都在 git log 里等你

Page 10 · 课程表节选
Syllabus
Act II · Curriculum
11 / 14
Why Java · 为什么是它

用最熟的语言,做最新的事

不用先去换语言,也不用啃框架源码——从课程设计那套技术栈,直接走进 Agent 的世界。

零迁移成本
Java 17 + Maven。写课程设计用的那套东西,刚好就是入场券。
零框架黑盒
不依赖 LangChain。OkHttp + Jackson 手写每一次调用,没有看不懂的魔法。
一份有故事的简历
"我从零写过一个 Agent CLI"——在 27 届的秋招桌上,是稀缺的开场白。
Page 11 · Why Java
— · —
第三幕 · 邀请
Act III · 12 / 14
Act III

轮到你了

不需要先成为高手——只需要一个今晚就能跑起来的开始。

第三幕引子
— · —
Act III · Invitation
13 / 14
The Takeaway · 一句话
"Agent 并不神秘, 它只是一个愿意 一步步想的循环。"

而你,刚好会写循环。

— 写在 ForgePilot 的第一行代码之后
Page 13 · 金句
— · —
今晚 · Tonight
14 / 14
Tonight · 只要三行命令

你的第一个 Agent, 今晚就能醒来。

克隆下来,跑起来,然后翻开第一期的代码——故事,从一个循环开始。

git clone·mvn clean package·java -jar target/paicli-16.1.0.jar
ForgePilot · Terminal-First Agent
— 等你 —