架构
Loop Now 是一个本地安装：一个 Go 服务端、一个 React 控制台、本地数据目录里的 SQLite 数据库、按 Agent 划分的 Pi 进程，以及一个共享的 Node 插件宿主。下图的组件构成一个完整的工作系统，并不代表可独立扩展的服务。
mermaid
flowchart LR
UI[Web 控制台] <-->|HTTP 与 SSE| Server[Go 服务端]
Server <--> DB[(SQLite)]
Server -->|RPC| Pi[Pi 进程]
Server <-->|stdio| Host[Node 插件宿主]
Host -->|HTTP, 插件令牌| Server
Pi --> CLI[按权限开放的 CLI 工具]
Pi --> Ext[插件扩展与 MCP 服务器]- 数据目录里的 SQLite 保存平台状态、凭证、消息、任务记录和排队；运行与审计日志在旁边的另一个文件里。
- 服务端进程在内存里维护忙闲锁和实时事件流；重启后事件流重新开始。
- 本地文件系统 保存 Agent 工作区、会话和已安装的工具。
- Pi 进程 执行 Agent 的每一轮工作。每个 Agent 在自己的工作目录中运行；服务端负责拉起、回收和限制它们。
- 插件宿主 在一个常驻 Node 进程中运行各插件的平台侧，通过 stdio JSON 行协议与服务端通信，并用按权限签发的插件令牌以 HTTP 回调平台接口。
仓库地图
| 源码 | 用途 |
|---|---|
web/ | React、TypeScript 与 Vite 控制台 |
internal/server/ | Go API、调度、存储与本地执行 |
cmd/loopctl/ | 面向平台 Agent 与外部身份的 JSON CLI |
plugins/ | 插件规范、Node 插件宿主、SDK 与官方插件 |
api/ | 控制台与 Agent 的 OpenAPI 契约 |
MAIN.md | 维护者概览与当前实现状态 |
执行流程
- 你在控制台与一个 Agent（或 Manager）对话。服务端持久化消息并排队工作。
- 服务端为该 Agent 启动或复用一个 Pi 进程，运行在它的工作目录中——常态目录或任务克隆。
- Pi 流式输出回复；工具调用、命令和用量经服务端回到控制台，进入运行时间线。
- Agent 之间通过 Inbox 协作：排队或打断的消息、让节点暂停的提问、可被提前唤醒的 sleep。
- 任务按冻结的流程逐节点执行；产物和记录在执行资源回收后保留。
本版本的边界
- 支持线性、条件分支和有次数限制的回路——不支持并行汇合、多副本部署和弹性伸缩。
- 每个安装运行一个服务端；控制台仅本机回环、无登录。
- 对话历史是持久的，但服务端重启不保证执行不间断、也不自动重放在途工作。建议在 Agent 空闲时升级。