之前写过一篇《搭建个人网页版 Codex》,介绍如何把 Codex 放进一个随时能打开的网页工作站。随着使用和迭代,PP Agent 逐渐连接了服务器、不同电脑、语音输入、长期会话、定时任务、个人知识,以及文章和文件的交付。
这篇把这些能力放在一起,介绍 PP Agent 作为一个个人 Agent Harness的完整形态:在手机上提出目标,让任务在合适的机器上执行;换到另一台设备继续跟进;把过程、知识和成果保留下来,下次接着用。
本文按 2026 年 10 月 14 日核实的私人生产版功能整理。公开衍生项目 Codex Web 的范围和版本节奏有所不同,文末附入口。
快速跳转:定位与架构 · 多节点 · 跨端与语音 · 上下文 · 个人知识 · 定时任务 · 账号与额度 · 文章交付 · 冷存储
1. Agent Harness:围绕模型,把工作接起来
可以把 Harness 理解为让 Agent 真正工作的运行框架。一次实际任务需要的东西很多:目标、上下文、工具、文件、执行环境、进度、失败后的处理,以及最终结果。模型负责理解和判断,周围这套系统负责让判断变成可执行、可追踪、可继续的工作。
OpenAI 对 Codex Harness 的介绍,也把会话状态、工具调用、流式事件和执行边界列为核心能力,并通过 app-server 向上层应用开放。PP Agent 的分工建立在这一基础上:Codex 承担底层 Agent 执行循环,PP Agent 组织网页入口、节点、任务、资料和成果的生命周期。参见 OpenAI 对 Codex 开放 Harness 的说明。
因此,称 PP Agent 为个人 Agent Harness,侧重的是整套工作环境。它使用 Codex 的能力,并把这些能力接入自己的项目、机器和日常工作。当前主要执行引擎仍是 Codex;语音识别等辅助环节可以使用其他模型服务。

一次任务可以这样理解:网页收下需求,中心保存任务与状态,根据项目绑定把工作交给执行节点;节点上的 Codex 读取对应环境、调用工具并处理文件,进度与成果再回到网页。浏览器是操作入口,计算发生在服务器或接入的电脑上。
2. 多节点统一管理:同一个网页,不同的工作现场
一台服务器适合常驻服务和持续任务;办公电脑保存着本地项目与软件;家里的电脑又有另一套文件和环境。PP Agent 通过 Remote Worker 把这些执行节点接进同一工作站。项目对应明确的执行位置,进入项目后,任务就在相应机器的工作目录中运行。
这让“用哪台设备操作”和“在哪台机器执行”分开了。可以拿手机给办公电脑上的项目发任务,也可以在笔记本上检查服务器任务的进展。节点需要在线、已经登记,并具备相应权限、工具和登录状态。网页能够访问,并不代表任何一台关机的电脑都能立刻工作。
串行、并发与跨节点衔接
同一会话中的后续指令可以排队执行,避免多个回合同时争用同一条执行线程。不同会话、不同节点可以在容量与资源允许时并发工作。运行中的任务也有进度入口,可以继续补充要求、引导或停止。并发任务若要修改同一项目文件,仍需安排好分工,不能只靠“开多个任务”避免冲突。
跨节点工作则需要明确步骤。例如,先在办公电脑生成一份资料包,确认完成后传给服务器,再由服务器整理成报告。这条链能够通过任务指令、状态检查和文件传输串起来;当前不宜把它描述为一个会自动分析任意依赖、随意迁移运行中任务的通用分布式调度器。
节点文件互传由 PP Agent 服务端协调,保存传输状态,优先尝试直连,必要时使用加密内存中继,并校验接收结果。它适合把明确的文件从一个节点交给另一个节点;持续文件夹同步、把所有电脑拼成共享磁盘,属于不同的问题。当前这一管理能力面向管理员开放。
实时同步到什么程度
从 PP Agent 发起的任务,其运行状态、阶段反馈和结果会回到网页。对于已经登记项目中的桌面 Codex 会话,Remote Worker 还可以观察关键行为,把用户消息、最终回复、命令完成和文件修改等事件同步到中心,形成可以远程查看的“第二屏”。
桌面观察链路按关键事件同步,不保证逐字复刻所有正在生成的内容,也不会把远端整个目录、全部文件正文和所有命令输出持续上传。会话状态同步、文件传输和文件夹同步,需要分别理解。
3. 跨设备与语音:随时表达需求,换个屏幕继续
PP Agent 以浏览器为统一入口。在支持的手机、平板和电脑浏览器里,登录同一账号,就可以查看自己的项目、会话、任务与交付物。已保存的文字草稿、引用和附件也能跨设备恢复,适合在手机上开个头,再回电脑补充资料。
语音输入降低了发起复杂任务的成本。很多需求说起来很自然:先描述背景,再补充限制,最后说明希望得到什么。PP Agent 把录音转成文本,再交给 Agent 执行;术语管理帮助它更稳定地识别经常出现的项目名和专业词。当前支持最长十分钟录音。
“帮我整理这个项目最近的变化,先检查已有资料,把已经完成和还没完成的部分分开,最后写成一篇适合分享的介绍。”
最新的语音发送链路在服务器确认收齐录音后就释放输入框,后续云端识别和任务执行可以继续。切换会话时,各自保留自己的输入、录音和附件状态,便于同时处理几件事。失败录音也有保留与重试路径。
这里的分界点是服务器已经确认接收。音频还没传完就关闭浏览器,上传仍可能中断;手机麦克风权限、后台限制和网络情况,也会影响体验。语音转写后如有关键名词或数字错误,可以继续纠正。
4. 上下文管理:让长任务能继续,也能适时换新
长期使用 Agent,很快会遇到几种看起来相似、实际不同的“历史”:网页里的聊天记录、模型这一轮使用的上下文,以及磁盘上保存的执行记录。PP Agent 把这些内容关联起来,同时保留各自的职责。
| 内容 | 主要作用 |
|---|---|
| 网页会话与运行记录 | 供人回顾需求、过程、结果和文件。 |
| Codex 线程与上下文 | 供 Agent 在后续回合接着工作;由 Codex 负责恢复和原生压缩。 |
| Rollout 持久记录 | 记录会话执行历史,支持恢复;文件体积不等于每轮发送给模型的输入量。 |
| 交接摘要 | 把目标、决定、已完成工作和剩余事项带到一个新会话。 |
在同一会话继续输入时,PP Agent 恢复对应的 Codex 线程,发送本轮输入与附件信息。它不会把网页数据库里的全部聊天记录每次重新拼一遍。界面也能查看最近上报的上下文使用情况、会话记录大小和套餐额度,帮助判断当前任务的状态;这三个指标不能互相替代。
当一个会话积累太多历史,或者工作已经进入新的阶段,可以先生成结构化交接摘要,检查后再带着摘要开启新会话。摘要会保留目标、关键决定、修改与验证结果、尚未完成事项和重要约束,原会话继续保留。新会话先核对现场,再继续工作。
这种接力给了用户一个明确的整理点。摘要必然有取舍,需要精确复核的细节仍应回看原始资料;当前也不能把上下文管理理解为无限记忆,或自动跨机器无损搬迁正在运行的线程。
5. 个人知识与技能:把反复解释的背景沉淀下来
项目知识回答“这个工程怎么工作”,个人知识回答“这个账号的使用者通常怎样工作”。PP Agent 按账号组织个人资料、偏好、稳定知识和当前关注点,并支持从历史交流中增量提炼候选。运行时按预算选取相关背景,不把全部历史塞进每个任务。
个人设置中的“个人知识”提供查看和管理入口:可以检查条目与来源,接受、拒绝、纠正或遗忘,也可以编辑基础资料。较新的明确纠正应当覆盖旧判断,低置信推断不能冒充用户已经确认的事实。个人背景只用于辅助理解,本轮要求和现场事实仍然优先。
这套资料以账号为边界。由 PP Agent 发起的服务器任务和远端 Worker 任务,都可以获得同账号的有界背景,因此跨项目、跨节点时不必从头解释所有习惯。直接在桌面独立启动的 Codex 会话,并不会自动拥有同样的中央个人知识;它与 PP Agent 派发的任务有不同的接入路径。
技能则负责沉淀可复用的工作方法。例如,如何做一份报告、如何处理表格、如何核实一次文件传输。个人知识保存背景,技能保存步骤和工具约定,项目规则保存当前工程的约束,三者一起减少重复交代。网页已经可以管理受支持的本地项目技能,远端项目的网页技能管理仍有范围限制。
6. 定时续跑与周期任务:把时间纳入工作流
有些工作需要现在开始,有些适合过几个小时再做,还有些应该每周重复。PP Agent 提供两类不同的安排。
| 安排方式 | 适合的任务 |
|---|---|
| 一次性定时或事件续跑 | 五小时后写文章;等外部操作完成后检查结果,或到截止时间处理。可选择继续原会话或新建会话。 |
| 项目周期任务 | 每天检查一次、每周汇总、每月整理。计划属于项目,每次触发创建独立会话。 |
一次性等待把计划保存在服务端,等待期间不需要让模型或浏览器一直开着。到了时间,再把任务放入执行队列;事件等待还可以结合完成回执和截止时间,让后续步骤有明确触发条件。本文就是一次具体用法:先提出写作要求,指定五小时后执行,再补充“发布到博客”,到点后继续研究、写作和发布。
项目周期任务可以设置固定间隔、每天、每周多日或每月日期,选择时区、模型、思考深度和执行次数,并查看最近记录。停止某一轮会话,不会顺带删除之后的日程;暂停计划则只阻止未来触发,已经开始的任务需要单独处理。
周期执行也有防堆积规则:上一轮还在排队、运行或等待时,跳过重叠时间点;停机恢复只补一次,不把错过的每一轮都挤进队列。一次性到期任务若因节点离线而无法派发,可以保留等待节点恢复;已经执行到一半后断线,则需要核对实际进度,不能假定整轮重放就一定安全。
7. 多个 Codex 账号:按机器管理登录、额度与重置卡
这里有两层账号:PP Agent 账号决定你能看到哪些项目、会话和个人资料;Codex 账号提供执行节点使用的模型访问身份与套餐额度。切换 Codex 账号不会把另一个 PP Agent 用户的知识或会话合并进来。
管理员可以在网页中按执行机器查看和管理多个 Codex 账号,包括新增登录、查看当前活动账号、切换和删除保存的账号。服务器与每台远端电脑各自管理本机账号,凭据留在所属机器,不通过前端展示。普通使用者并不默认拥有这套管理入口。
额度信息同样按执行位置和账号区分。界面显示上游报告的剩余额度、重置时间,以及可用重置卡次数和最早到期信息。有些值来自最近一次快照;上游没有返回数据时,应显示未知或需要更新,不能把未知当成零。这里的套餐额度也不等于当前对话的上下文窗口。
“重置”具体指什么
“使用重置卡”针对的是符合条件账号的 Codex 使用额度。操作时明确目标账号,读取可用卡信息,优先选择最早到期的有效卡,并在完成后刷新该账号额度。单纯打开面板或刷新数据不会消耗卡,也不需要为了查询而切换当前活动账号。其上游接口可参见 Codex App Server 的额度重置协议。
它不是重设密码、清空会话,也不能凭空创造额外额度。是否有卡、是否允许重置、重置结果是什么,都取决于上游账号状态和协议支持。PP Agent 为重试保存同一次操作的标识,处理响应丢失等情况,降低重复消费的风险。当前功能与测试链路已上线;本文核实没有实际消耗重置卡,不把测试覆盖写成所有账号均已成功兑卡。
远端账号切换还有一个实际边界:目前会影响该系统用户默认 Codex 环境中的活动登录状态,可能与桌面 Codex 的登录相互影响。它并不是一套与桌面彻底独立的第二份账号环境。
8. 从回答到成品:文章、文件、阅读与分享链接
PP Agent 可以把任务落实为实际文件:文章、HTML 报告、表格、图片、文档,或者项目中的代码和修改结果。具体能生成什么,取决于执行节点安装的工具、已接入的能力及任务授权。交付物会登记回会话,用户可以预览、下载,并围绕同一份成果继续修改。
长文章和分析材料可以做成带目录、表格或图表的 HTML;Markdown 支持阅读和公式展示,PDF、EPUB 也有内置阅读入口。阅读时可以选取一段内容向 Agent 追问,保留引用关系,把“生成一份资料”和“继续理解、完善资料”接在一起。
HTML 和 Markdown 成品支持主动开启公开分享,获得可直接打开的链接,并管理相应配图访问。当前默认有效期为三十天,可以续期或关闭;关闭或到期后,原文档及其受控配图停止公开访问。有效分享中的文件会受到本地保留保护,避免被冷存储流程直接移走。
发布到自己的博客,是另一条交付路径:在已有站点管理权限和明确授权下,Agent 可以把内容写入 WordPress,完成排版、发布,再检查实际文章页面。本篇采用的就是这条路径。PP Agent 的临时分享链接与博客文章链接有各自的生命周期,博客文章不会因为 PP Agent 分享到期而自动下线。
9. 冷存储:历史继续保留,常用磁盘保持轻量
任务用得久了,累积的不只有聊天文字,还有上传资料、生成文件、录音,以及 Codex 的运行记录。PP Agent 对符合条件的本机会话提供冷存储,把不常访问的大体积文件转移到加密云端归档,消息和元数据继续留在中心,便于查找。
当前规则下,普通会话超过十五天没有真实活跃动作,会成为候选;主动归档的会话可以在下一轮进入候选。系统还要检查运行任务、排队输入、草稿、等待计划、共享引用等条件,通过后才处理。归档流程会上传密文并回下载核验,再把本地原件放进隔离区,保留七天宽限后才清理隔离副本。
重新打开冷存储会话时,界面显示恢复状态,后台下载、解密、校验并还原文件,成功后再继续访问。运行记录的父子关联也纳入相应归档与恢复流程。恢复失败会留下错误状态,不应该悄悄创建一个没有历史的新线程。
这让“暂时不用”与“彻底删除”有了不同的处理方式。不过,当前会话冷存储主要覆盖本机范围,不会替远端电脑自动扫描和清理全部历史。冷存储也只是存储分层的一部分;整站灾难恢复还依赖数据库、配置、密钥和经过验证的恢复流程。云端有一个加密包,并不自动等于整个工作站随时可以完整重建。
10. 把这些能力连起来,会怎样使用
从一个想法到一篇文章
手机语音描述选题,上传参考材料,指定稍后开始;Agent 在服务器核实资料,生成初稿。用户换到电脑查看文章,选中一段继续追问或修改。确认发布目标后,Agent 把文章写入博客,检查公开链接,再把结果带回会话。任务、资料、修改过程和最终文章保持关联。
在不同机器之间交接工作
把依赖办公软件的处理留在办公电脑,把常驻服务上的核查留在服务器。先确认前一步完成,再通过受管传输交付文件,让后一步读取已校验的结果。网页负责集中查看状态,执行节点保留各自真实环境;出问题时能够定位是哪一步、哪台机器需要继续处理。
把重复事务变成长期安排
将稳定的检查方法写成技能,把执行频率放进项目周期计划,每轮产生独立会话和结果。需要长期保留的结论进入项目知识或个人知识;不再频繁访问的会话进入归档和冷存储。下次工作从已有材料开始,仍然核对现场变化。
这些场景共同依赖清楚的授权和范围:谁可以使用哪个节点、任务在哪个项目运行、哪些资料属于哪个账号、哪些结果允许公开。PP Agent 保留普通账号与管理能力的区别;真正的执行权限还受到节点环境和工具策略约束。运行记录便于复核,不能代替对结果本身的验证。
11. 继续了解与自行部署
想了解早期搭建思路,可以读《搭建个人网页版 Codex》;对聊天工具入口感兴趣,可以读《用飞书机器人远程控制 Codex》。本文进一步介绍的是多节点、持续任务、知识和成果管理组合起来之后的使用方式。
公开衍生项目在 GitHub:Raytto/codex-web,提供自托管网页工作站的代码与部署说明。它是独立社区项目;私人生产版中的管理权限、账号配置和部分集成不应直接视为公开版的默认能力,部署前以仓库当前说明为准。
PP Agent 希望让一项工作从提出想法开始,经过执行、等待、检查和修改,最终留下能使用、能分享、下次还能接着用的成果。模型能力持续进步,围绕它建立的工作环境,也可以逐渐成为日常工作的固定入口。
核实说明:本文结合 PP Agent 当前生产功能、实现与已有验收记录整理;概念和上游协议参考文中 OpenAI 官方资料。场景段落说明组合用法,不代表所有场景都在本次重新实测。本文由 PP Agent 辅助整理并发布。