PRO-LONG
为长任务编码代理提供持久记忆:所有事件写入一个本地追加式日志,代理用代码按需检索,而不是塞进提示词。
- Star 数
- ★ 465
- 最近更新
- 18 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 60/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 用 Claude Code 或 Codex 做跨越压缩或多天会话的大型重构,需要代理记住早期决策
- 不适合
- 不允许在本地保留含敏感信息的会话记录的团队
- 只使用未列出的编码客户端、且不愿自行适配的开发者
- 期望一个已被直接验证过的编码基准、而非研究结果的采购者
- 维护状态
- 近 30 天有提交最近提交 2026-11-02
- 源码审查
- 60/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
PRO-LONG(GitHub: alexisfox7/PRO-LONG,MIT 许可)为 Codex、Claude Code、OpenCode 和 pi 等编码 CLI 提供可编程的长期记忆。长任务往往超出上下文窗口,压缩或新开会话后,代理可能丢失早期决策、重复失败的工作。PRO-LONG 通过项目本地适配器把提示词、工具活动、助手交接和会话边界追加到 .prolong/log.jsonl 中,并提供一个 agent skill 教代理用 rg、jq 或 Python 等普通工具检索日志。它不注入完整日志、不包装你的 CLI,也没有服务器或数据库;读取日志的内容不会被再次记录,避免记忆自我复制。该项目源于长时程代理研究,在 ARC-AGI-3 全公开游戏集上以 Fable 5 达到 97.4% best@2,比匹配基线平均提升 18 个百分点,但作者明确说明这尚未直接验证编码工具 MVP。
运行 prolong init 后,它检测 PATH 上的受支持客户端并安装:.prolong/runtime.mjs(零依赖事件写入器)、.prolong/log.jsonl(追加式日志)、.prolong/install.(安装清单)、.agents/skills/prolong/SKILL.md(检索 skill)、AGENTS.md 指针、.gitignore 中的 .prolong/ 条目,以及各客户端集成(Codex 的 .codex/hooks.json、Claude Code 的 .claude/settings.json 生命周期钩子、OpenCode 的 .opencode/plugins/prolong.ts、pi 的 .pi/extensions/prolong.ts)。适配器把生命周期事件追加到日志;当先前工作相关时,skill 指导代理用 rg、jq 或 Python 搜索日志并只读相关条目。CLI 共三条命令:prolong init(可用 --client codex,claude-code,opencode,pi 显式选择)、prolong status(支持 --)、prolong uninstall(保留日志,--purge 连历史一起删除)。
- 用 Claude Code 或 Codex 做跨越压缩或多天会话的大型重构,需要代理记住早期决策
- 调试长任务时,希望代理能检索之前失败的工具调用和结果,避免重复踩坑
- 在同一项目里频繁新开会话、希望每次都能找回相关历史的开发者
- 使用 OpenCode 或 pi、想要无服务器无数据库的本地记忆方案的用户
- 重视隐私、要求记忆留在项目内并默认被 gitignore 的团队
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install && npm run build && npm link
如何安装或部署这个 Agent?
需要 Node.js/npm 环境和 PATH 上已安装的受支持编码客户端。克隆并构建:
bash
git clone https://github.com/alexisfox7/PRO-LONG.git && cd PRO-LONG
npm install && npm run build && npm link然后在你的项目目录中初始化:
bash
cd /path/to/your/project
prolong init如需显式指定客户端:
bash
prolong init --client codex,claude-code,opencode,pi如何使用这个 Agent?
初始化后正常使用你的编码代理即可——PRO-LONG 在后台记录,代理在任务跨压缩或会话时通过 prolong skill 检索相关历史。可用以下命令检查状态或卸载:
bash
prolong status
prolong status --
prolong uninstall
prolong uninstall --purge注意:钩子与扩展以你的用户权限运行,首次使用前应审查生成的集成文件并接受客户端的项目/钩子信任提示。
这个 Agent 有哪些优点和局限?
- 日志不注入每次提示词,且日志读取不被记录,避免上下文膨胀和记忆递归复制
- 零依赖的本地 runtime.mjs,无服务器、无数据库,日志留在项目内并默认 gitignore
- 一条命令同时集成四个主流编码 CLI(Codex、Claude Code、OpenCode、pi),且保留你原有工作流
- 有 ARC-AGI-3 研究背书(97.4% best@2、平均提升 18 个百分点)并附复现代码与论文
- 日志会包含提示词、工具输入输出及其中出现的任何密钥,敏感项目需评估本地政策
- 97.4% 的结果来自研究 harness(Fable 5),作者自认还不是编码工具 MVP 的直接基准
- 仅内置支持四个客户端,其他 CLI 需自行适配钩子/插件
- 记忆质量依赖代理遵循 SKILL.md 主动检索,无检索则无收益
这个 Agent 与同类方案有什么区别?
README 未点名具体竞品,但定位隐含了与'把完整转录/记忆注入提示词'或'外置记忆服务器/数据库'类方案的区别:PRO-LONG 选择本地追加式日志加代码检索,不引入包装器或服务。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PRO-LONG 当前 | 60 · 存在缺口 | 命令行工具免费 | ★ 465 | 18 天前 | Python | Codex · Claude Code |
| MonoCode | 71 · 存在缺口 | 桌面应用免费 | ★ 4.1k | 9 天前 | Rust | Codex · Claude Code |
| HumanLayer | 54 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 13k | 5 天前 | TypeScript | Codex · Claude Code |
| MemoSync | 50 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 396 | 6 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
代码安装项目级 hooks/插件,明确说明其以用户权限运行,并要求用户接受客户端信任提示;事件写入本地且默认 gitignore,卸载默认保留日志,purge 才删除,体现了权限与恢复考虑。README也明确提示日志可能含提示、工具输入输出和秘密。扣分在于没有证据显示细粒度采集控制、敏感字段过滤或依赖安全审查;作者署名只到“PRO-LONG authors”,发布者身份未验证。
README、技能和命令对本地 JSONL 记忆、检索及客户端集成的描述基本一致;支持 Node.js 20+,依赖范围可见,CLI错误会输出信息并返回非零状态。生命周期测试样例展示重复初始化、配置保留和卸载行为。扣分在于样例不覆盖所有故障路径,且本次静态审查不能验证运行结果。
面向使用 Codex、Claude Code、OpenCode 或 pi 的长期编码任务,给出触发场景、检索步骤及窄范围搜索示例;要求核对旧观察与当前工作区,并将日志视为不可信数据。扣分在于适用边界主要围绕编码代理,环境要求集中在 Node.js 20+,没有证据证明更广泛的场景或平台支持。
README提供快速安装、命令表、客户端支持、隐私说明和研究入口;SKILL.md有清晰检索步骤和示例,MIT许可证文本完整,包名和命令名一致。扣分在于给出的材料没有变更日志或明确维护责任人,FAQ及已知限制说明较简略。
工具输出有 status、JSON 状态、安装结果和卸载警告;项目将外部持久日志与按需检索结合,提供了长任务恢复历史的明确用途。扣分在于记录可能包含敏感会话内容,且需要本地存储与检索操作;效益数字主要是README中的研究声明,日常编码收益和成本未在材料中量化。
README给出论文、研究结果和成本/评分口径入口,代码包与测试样例支持部分安装生命周期描述;技能明确要求核实历史观察,并区分不可信日志与当前指令。扣分在于性能数字在所给材料中没有独立结果文件或交叉验证,且发布者身份未知;本结论只依据所提供的静态材料。
- 日志会保存提示、工具输入和输出,并可能包含秘密;仅在能够保护本地历史记录的项目中启用。
- 97.4%及其他性能数字来自README中的研究声明;本次静态材料不足以独立核验。
常见问题
收费吗?需要 API 密钥吗?
我的会话数据会离开机器吗?
如何彻底删除记忆?
支持哪些客户端?不支持的怎么办?
ARC-AGI-3 的 97.4% 结果对编码使用意味着什么?
PRO-LONG 开源吗?
PRO-LONG 安全吗?
PRO-LONG 还在维护吗?
PRO-LONG 是谁开发的?
谢谢反馈,我们会据此改进页面。