用途
Prime Agent 是一个开源的编码与研究智能体，面向通用任务和长时间运行的工作，尤其适用于研究中的评测场景。它由 Prime Intellect 开发，采用 MIT 许可证发布。
核心抽象
Prime Agent 围绕两个核心抽象设计：
- 递归语言模型（RLM）：把上下文当作变量（prompt-as-a-variable），把工具（如递归子智能体）当作函数调用（programmatic tool / sub-agent calling），全部在持久化的 REPL 中执行。
- 持续化 Harness（Continual Harness）：把补充提示、记忆、技能描述和可复用子智能体规格存储为持久状态，Prime Agent 可以通过小幅、有证据支持的更新来改进它，默认仅作用于当前会话。
主要能力
- 一切皆程序化：持久化的 Python REPL 是内置的模型工具；文件操作、Shell 命令、工具使用、子智能体和上下文管理都通过代码完成。
- 内置子智能体：
rlm.spawn(...)可生成真实的子智能体用于并行或后台工作，并以编程方式返回结果。 - Harness 可自我改进：
/refine会审查当前轨迹，并可对补充的 Harness 状态应用小幅、有证据支持的更新。它不会重写不可变的基础系统提示，且记录的快照支持回滚。 - 技能可执行：技能是可导入的 Python 包，内置的技能创建器可以把重复出现的工作流转化为项目级或个人级技能。
- 会话后台运行：由守护进程支持的智能体在终端断开后仍继续运行，之后可重新连接。
- 智能体直接通信：运行中的智能体可以互相交换消息并相互编排，无需一切都经由用户转发。
- 长任务持续推进：自动压缩、持久目标、心跳、调度、自主模式和保留的子智能体，可在多轮对话和终端会话之间保持进度。
使用方式
使用一条命令安装最新稳定版（安装命令见官方仓库）。在 Windows 上从 PowerShell 安装；Windows 安装程序会下载最新的稳定版 Windows x64 构建并在安装前校验其校验和。
在你希望它工作的仓库或目录中启动 Prime Agent。首次启动时运行 /login 选择订阅或 API 密钥提供商。Prime Agent 在当前目录中工作，可以在其中运行命令和修改文件。建议使用可丢弃的克隆、干净的工作树或其他可检查、可恢复的检查点。
常用命令包括 /refine、/heartbeat、/goal、/autonomous、/settings 等；prime-agent schedule 可设置定时任务。
适用场景
- 编码工作流与长时间自主任务。
- 研究中的评测（evaluations）。
- 需要跨轮次、跨终端会话保持进度的长任务。
- 需要并行或后台子智能体协作的任务。
限制与注意事项
- Prime Agent 以你的用户权限执行模型生成的 Python 和项目命令。其 worker 和内核进程改善的是生命周期隔离与恢复，不是安全沙箱。请审查变更，仅使用可信的仓库、指令和技能；不可信代码或指令应在外部沙箱或受限环境中运行。
- 通过 SSH 和 tmux 使用剪贴板时存在限制：终端请求无法确认本地剪贴板是否已更改，因此 Prime Agent 会将其报告为未确认。嵌套的 tmux 服务器和终端可能仍会阻止传递；外层 tmux 若设置
set-clipboard external可能拒绝内层服务器的 OSC 52，此时可在外部服务器运行tmux set -s set-clipboard on，或使用终端原生选择（多数终端 Shift-拖拽；iTerm2 为 Option-拖拽）后按 Cmd-C。macOS Terminal.app 不支持 OSC 52；iTerm2 需要开启“Applications in terminal may access clipboard”设置。 - 自定义证书颁发机构：HTTPS 请求信任操作系统信任库以及内置的 Mozilla 根证书。对于位于自定义 CA 之后的服务器，可将
NODE_EXTRA_CA_CERTS指向 CA 证书的 PEM 包。每个传输层在首次初始化客户端时读取一次该变量；后台守护进程保留其启动时的环境，因此更改后需运行prime-agent shutdown。 - 自动压缩：
/settings以 5 个百分点为步长暴露全局自动压缩百分比，默认 95%。保存的非整档百分比仍可选择。有效触发还会为保留的历史和摘要预留空间；模型的输入和请求输出上限始终优先。手动压缩预算不变。底层compaction.thresholdPercent设置接受 1–100，包括小数值；项目设置可覆盖全局设置。针对单个模型的提前压缩，可使用models.json中已有的 provider 作用域选项modelOverrides.<id>.contextWindow。
社区与引用
一般问题、缺陷报告和功能请求请从 GitHub Discussion 开始；维护者会把被接受的工作提升为 Issue，pull request 由维护者和受担保贡献者审查。若在研究中使用该代码库，请引用 Prime Agent（arXiv:2608.23552）。
