持续交付 · 终端工程 Agent 工作台

一个住在终端里的 Java Agent IDE

ForgePilot 是一款基于 Java 的开源命令行智能体，为工程团队提供可控的终端工作流。 从 ReAct 循环出发，覆盖 Plan、Team、Memory、MCP、浏览器自动化与多模型协作， 为工程团队提供可审阅、可回滚、可审计的终端工作流。

↓ 快速安装 GitHub
23 已交付期数
8 模型客户端
17 内置工具
v16.1.0 最新版本
ForgePilot — zsh
$ java -jar target/paicli-16.1.0.jar
╔══════════════════════════════════╗
║ ██████╗ █████╗ ██╗ ██████╗██╗ ║
║ ██╔══██╗██╔══██╗██║██╔════╝██║ ║
║ ██████╔╝███████║██║██║ ██║ ║
║ ██╔═══╝ ██╔══██║██║██║ ██║ ║
║ ██║ ██║ ██║██║╚██████╗██║ ║
╚══════════════════════════════════╝
✅ API Key 已加载
🔄 使用 ReAct 模式
👤 你: ▊
// 关于

什么是 ForgePilot？

🎯

可控的工程工作台

把 ReAct、Plan、Team、Memory、MCP 与审计能力收进 Java 生态的终端工作流，持续演进为完整的 Agent 产品形态。

☕

纯 Java 实现

基于 Java 17 + Maven 构建，零外部运行时依赖。OkHttp 做 HTTP 通信，Jackson 序列化，JLine3 做终端交互，SQLite 持久化。

🧠

多模型支持

支持多个模型 provider，使用 /model 命令在运行时热切换。

🛡️

安全可审计

HITL 人工审批 + 路径围栏 + 命令黑名单 + 操作审计。不是沙箱，但提供生产可用的安全模型。

// 能力

核心特性

覆盖 ReAct、Plan、Team、Memory、MCP 与浏览器自动化

01

ReAct 循环

思考 → 行动 → 观察，支持流式推理展示、工具调用、对话历史管理、长上下文自动压缩。

流式输出工具调用上下文压缩
02

Plan & Execute

复杂任务先规划再执行，DAG 依赖拓扑排序，并行批次推进，支持用户审阅与补充。

DAG并行执行人工审阅
03

Multi-Agent 协作

规划者 + 执行者 + 检查者，主从架构编排，审查不过自动重试，Worker 并发执行。

编排器角色分工质量审查
04

Memory 系统

Agent 对话历史 + 长期记忆 + 双路径摘要压缩。跨会话复用稳定知识，长任务保持上下文可控。

长期记忆Session Memory摘要回退
05

RAG 检索

代码向量化 + SQLite 向量存储 + 语义检索 + AST 关系图谱。自然语言搜代码，理解代码结构。

Embedding语义搜索代码图谱
06

HITL 审批

危险操作（写文件 / 执行命令 / 创建项目）人工审批。单字符交互：批准 / 放行 / 拒绝 / 跳过 / 改参。

安全审批路径围栏操作审计
07

MCP 协议

支持 stdio 子进程 + Streamable HTTP 双传输。自动注册 MCP 工具，支持 resources 双轨与 @-mention。

stdioStreamable HTTPresources
08

Chrome DevTools

集成 chrome-devtools-mcp，支持导航 / 快照 / 点击 / 填表 / 脚本执行。CDP 会话复用，登录态访问。

浏览器自动化登录态复用SPA 渲染
09

联网能力

web_search（智谱 / SerpAPI / SearXNG）+ web_fetch（readability 提取 → Markdown）。安全策略内置。

联网搜索网页抓取安全策略
10

TUI 产品化

三种 Renderer：inline 流式（默认）/ lanterna 全屏 / plain 兜底。行内折叠、diff、状态栏。

inline TUIlanterna行内 diff
11

Skill 系统

从硬编码提示词中抽出可复用单元。SKILL.md 决策手册 + references 资料库 + 内置 web-access skill。

可复用三层加载站点经验
12

长上下文工程

预算和压缩阈值按模型窗口连续派生，自适应 MCP 索引注入，支持 1M token window。

1M context自适应prompt cache
// 演进

能力演进

从 ReAct 到完整 Agent 产品，每一期都是质的飞跃

01

ReAct Agent CLI

单轮对话驱动的 ReAct 循环，支持文件操作、Shell 命令、项目创建。基础工具集建立。

02

Plan-and-Execute + DAG

复杂任务规划能力。先拆解、再按依赖顺序执行，支持计划确认与补充。

03

Memory + 上下文工程

Agent 对话历史、长期记忆、双路径摘要压缩与 Token 预算管理。跨会话知识复用。

04

RAG 检索 + 代码库理解

代码向量化、SQLite 向量存储、语义检索、AST 关系图谱。自然语言搜代码。

05

Multi-Agent 协作

规划者 + 执行者 + 检查者，主从编排。审查未通过自动重试，Worker 并发。

06

HITL 人工审批

危险操作审批流。路径围栏、命令黑名单、操作审计。三级危险等级。

07

异步执行 + 并行工具

同一轮多工具并行执行。Plan / Team 按依赖批次并发。统一超时与取消。

08

多模型适配

支持多个模型 provider，使用 /model 在运行时热切换。

09

联网能力

web_search（三 provider）+ web_fetch（readability 提取）。内置安全策略。

10

MCP 协议核心

stdio + Streamable HTTP 双传输。自动注册工具，schema 清洗。

11

MCP 高级能力

resources 双轨、prompts 查看、@-mention、被动通知、运行中取消。

12

长上下文工程

动态预算、prompt cache 可见化与长上下文压缩。

13

Chrome DevTools MCP

集成 chrome-devtools-mcp。浏览器导航、快照、点击、填表。SPA / 防爬墙覆盖。

14

CDP 会话复用

登录态访问、敏感页面策略、/browser 命令组。复用日常 Chrome。

15

Skill 系统

SKILL.md 决策手册 + references 资料库。内置 web-access skill，站点经验可积累。

16

TUI 产品化

Renderer 接口 + 三种实现（inline / lanterna / plain）。行内折叠、diff、状态栏。

+

持续产品化

LSP 诊断、Side-Git 快照、Prompt 分层、Runtime API、图片输入与微信文本通道已纳入当前工程能力。

// 开始

快速安装

Java 17 + Maven，三分钟跑起来

1

配置 API Key

terminal
cp .env.example .env
# 编辑 .env，填入 API Key
GLM_API_KEY=your_api_key_here
DEEPSEEK_API_KEY=your_deepseek_key_here
STEP_API_KEY=your_step_key_here
2

编译运行

terminal
# 编译打包
mvn clean package

# 启动 ForgePilot
java -jar target/paicli-16.1.0.jar

# 或直接运行（无需先 package）
mvn clean compile exec:java \
  -Dexec.mainClass="com.paicli.cli.Main"
3

开始使用

ForgePilot session
╔══════════════════════════════════╗
║   ForgePilot  ·  Java 17          ║
╚══════════════════════════════════╝

✅ API Key 已加载
🔄 使用 ReAct 模式

👤 你: 创建一个 Java 项目叫 myapp

🤖 回复:
已成功创建 Java 项目 "myapp"，
包含完整的 Maven 结构。

可选：配置 MCP server（默认自动创建 chrome-devtools 配置）

~/.paicli/mcp.json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}
// 架构

技术架构

清晰的分层设计，每个模块职责明确

CLI · TUI
→
Agent 核心
Plan
Tool
Memory
RAG
Skill
HITL
MCP
Web
LLM
Context
Policy
Browser

技术栈

Java 17MavenOkHttpJackson JLine3SQLiteJavaParserOllama 多模型MCPBrowser
// 命令

CLI 命令速查

/plan Plan-and-Execute 模式
/team Multi-Agent 协作
/cancel 取消当前任务
/model 切换 LLM 模型
/hitl on|off 审批开关
/mcp MCP server 管理
/memory 记忆系统状态
/save <事实> 保存长期记忆
/index 索引代码库
/search 语义检索代码
/browser 浏览器会话管理
/skill Skill 管理
/policy 安全策略状态
/audit 操作审计日志
/clear 清空对话历史
/exit 退出程序