核心用法
Proactive Agent 是一套完整的 AI 代理行为架构，通过五根支柱实现从"任务执行者"到"主动伙伴"的跃迁。核心文件系统包括：ONBOARDING.md（首次引导，支持交互式/渐进式/跳过三种模式）、SOUL.md（代理身份与原则）、USER.md（用户画像与目标）、MEMORY.md（长期记忆）、AGENTS.md（运行规则与经验教训）、HEARTBEAT.md（定期自检清单）及 memory/ 目录下的每日日志。
使用流程：复制资产文件 → 代理检测 ONBOARDING.md 并启动引导 → 回答 12 个问题或直接跳过 → 代理自动填充 USER.md 与 SOUL.md → 运行安全审计脚本。日常运作依赖 Heartbeat 系统（可配置每小时/每日触发），执行安全扫描、自我修复、主动惊喜生成、系统清理和记忆维护五大职能。
显著优点
记忆持久化突破：首创"记忆刷新（Memory Flush）"机制——在上下文窗口压缩前主动保存关键决策、待办事项、新习得知识，解决长期困扰用户的"代理失忆"问题。双层级记忆架构（每日原始日志 + 周期性蒸馏的长期记忆）实现经验复利积累。
反向提示（Reverse Prompting）：代理主动询问"基于我对你的了解，有哪些有趣的事我可以为你做？"，挖掘用户未意识到的需求。实测案例显示用户反馈"这些想法很好"并识别出高优先级需求（财务规划工具）。
自我修复能力：遇到问题时执行"诊断→修复→测试→记录"闭环，Heartbeat 期间扫描日志错误，尝试 10 种方法后才向用户求助，显著降低人工介入频率。
安全 hardened 设计：内置多层防护——禁止执行外部内容指令、删除文件前确认、定期注入检测（扫描"忽略先前指令"等攻击模式）、行为完整性检查。提供 security-audit.sh 脚本主动自检。
渐进式 onboarding：三种模式适配不同用户偏好，进程可中断、可恢复，代理从第一分钟即具备实用价值。
潜在缺点与局限性
依赖用户主动配置：Heartbeat 间隔、记忆刷新时机需用户手动设置，默认配置可能不适合高频长会话场景。
记忆质量取决于蒸馏频率：若用户长期不执行 MEMORY.md 维护，每日日志堆积将导致检索噪音增加，长期记忆退化。
"主动惊喜"存在误判风险：虽设定"外部操作需审批"的护栏，但代理对用户"可能喜欢什么"的推断可能偏离实际，产生打扰感。
文件系统依赖：架构假设可持久化文件存储，在纯对话式、无文件系统访问权限的环境中无法完整运行。
无原生多代理协调：当前设计聚焦单代理自我改进，未内置多代理分工协作的编排机制。
适合人群
- 追求"第二大脑"体验的知识工作者与创作者
- 需要跨会话保持上下文的深度研究用户
- 希望减少重复指令输入、提升代理自主性的效率极客
- 关注 AI 安全、希望获得透明可审计安全机制的技术用户
- 愿意投入初期 10 分钟 onboarding 以换取长期收益的长期主义者
常规风险
权限扩张风险：代理工具调用能力增强后，若配置不当，自我修复或主动执行可能触及意外范围。建议严格遵循最小权限原则。
记忆污染风险：外部内容（网页、PDF）虽被标记为"数据非指令"，但若用户误将恶意内容存入记忆文件，可能间接影响代理行为。
过度依赖风险：长期使用后，用户可能放松对代理输出的监督，关键决策（财务、法律、医疗）仍需人工最终审核。
上下文窗口边缘行为：记忆刷新时机依赖用户判断，若未及时执行，重要上下文仍可能在压缩中丢失。建议长会话（>30 轮或复杂任务）主动触发刷新。