双平面模型
理解桌面端只需要记住一条线:数据归属跟着消费场景走。执行在本机
Agent 循环直接跑在你的电脑上,通过系统级沙盒(macOS Seatbelt)隔离执行。操作本地文件、控制浏览器、录制屏幕都不需要经过云端中转。
资产在云端
技能、专家、记忆的唯一真相源在云端——这保证了你在 Web 端创建的技能,桌面端立刻可用;桌面端沉淀的技能,其他设备同样可见。
双进程架构
桌面应用由两个进程协作构成:- Electron 主进程:负责窗口、浏览器自动化(CDP)、屏幕操作、录制覆盖层等系统能力
- Python Sidecar:运行完整的 Agent 循环,与云端只保留两类通信——会话开始时的权益校验(prepare)和结束时的结算回传(finalize)
本地优先的会话状态
桌面端的会话历史以追加式 JSONL 文件存储在本机~/.profy/ 下,这是会话的唯一真相源:
1
每轮对话即时落盘
对话的每一轮(用户消息、AI 回复、工具调用)同步写入本地 rollout 文件,跨轮上下文由本地历史重建——即使云端抖动,对话上下文也不会断。
2
云端投影异步补偿
会话结束后向云端回传一份「投影」用于 Web 端可见性与计费结算。回传失败不丢弃:进入本地重试队列,指数退避直至最终一致。
3
界面直接读本地
会话列表、历史消息在桌面端直接从本地磁盘读取,离线也能浏览全部历史;云端会话合并显示,同一会话以本地版本优先。
认证:Access + Refresh 双凭证
桌面端的后台进程不使用服务端密钥(服务端密钥永不离开机房),而是采用与业界桌面客户端一致的双凭证模型:- 会话令牌 = refresh 凭证:登录后捕获,服务端可随时撤销,只接触铸造端点
- JWT = access 凭证:无状态、可验签,跑在所有业务调用热路径上
录制 → 技能 → 回放闭环
桌面端独有的能力闭环:1
录制
点击录制后,系统级事件捕获记录你的操作流(点击、输入、导航),录制数据只存本地。
2
沉淀为技能
停止录制自动触发 AI 分析:解析操作流、提炼意图、生成结构化技能并保存到你的云端技能库——此后所有设备可用。
3
回放
新会话中激活该技能,AI 通过浏览器自动化(可信输入事件)与屏幕操作能力复现整个流程,每一步执行后验证结果。

