架构与进阶
看懂进程边界，玩转 JSON/RPC 与自定义提供商，最后用 FAQ 收尾。
1进程架构：一图看懂
终端呈现、进程协调、代理执行、模型侧 Python、持久化状态五层分离。
- 客户端只管渲染、键盘输入与本地 UI 偏好，不拥有执行；交互 TUI 和无头客户端（print / JSON / RPC）走同一条 daemon 协议；
- daemon 调度器负责发现、路由、附件、worker 健康与跨代理消息投递；
- 每个 worker 拥有一棵根会话树：运行时、调度器、根会话、Python 内核与全部子代理；
- AgentSession 拥有提供商调用、队列、工具、压缩、目标、子代理生命周期与 transcript 写入。
从会话队列往后，无论提示来自心跳、定时、目标延续、自主模式还是另一个代理，走的是同一条执行与持久化路径。
2无头模式与扩展点
除了交互 TUI，还有三个进阶入口值得知道。
| 入口 | 用法 | 适合场景 |
|---|---|---|
| JSON 模式 | --mode json | 所有事件以 JSON 行输出，便于程序消费 |
| RPC 模式 | --mode rpc | 基于 stdin/stdout 的进程集成 |
| 扩展 | -e <source>（路径 / npm / git，可重复） | 自定义工具、提供商 OAuth 流程等 |
| 包管理 | prime-agent package install|remove|list|update | 安装共享的扩展、技能、提示与主题 |
模型侧也开放：models.json 可接入 Ollama、LM Studio、vLLM 或任何讲 OpenAI Completions / OpenAI Responses / Anthropic Messages / Google Generative AI 协议的自定义提供商；云提供商 Azure OpenAI、Amazon Bedrock、Google Vertex AI 各有专属环境变量配置（见官方 providers 文档）。
3安全清单：用得放心的前提
把官方反复强调的三件事变成肌肉记忆。
- 它不是沙箱：以你的用户权限执行模型生成的 Python 与项目命令，worker / kernel 的进程隔离只为生命周期与故障恢复服务；
- 圈好工作面：用一次性克隆、干净 worktree 或可检查可恢复的 checkpoint；Prime Agent 就在当前目录里读写；
- 只喂可信内容：仓库、指令、技能、扩展都要过一遍审查——技能可以指挥模型执行任意动作。
想跑不可信代码或指令？放进外部沙箱或受限环境，别指望代理自身的进程隔离兜底。
4新手 FAQ
六个最高频的问题，先在这里对答案。
Windows 能用吗？
原生安装脚本面向 macOS 与 Linux（Windows 原生不在支持列表）。官方文档另附 Windows 平台说明页（windows.md），按其指引（如 WSL 方案）处理。
模型账号怎么选最省事？
有 Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot 或 xAI Grok 订阅，直接
/login 最省事；否则配一家 API Key（OpenRouter 一个 Key 可聚合多家；国内可直连的有 DeepSeek、Kimi、MiniMax、小米 MiMo 等）。会话数据都存在哪？
会话是
~/.prime/agent/sessions/ 下的扁平 JSONL 文件，头部记录工作目录；凭据在 ~/.prime/agent/auth.json（0600）；内核 venv 默认在 ~/.prime/agent/kernel-venv；全局指令是 ~/.prime/agent/AGENTS.md。关掉终端后任务还在跑吗？
在。持久会话由 daemon 支撑的 worker 进程承载，关 TUI 只是脱离。用
prime-agent agents 找到它，prime-agent attach <agent> 重新接入；确认都不要了再 prime-agent shutdown。/refine 会不会把系统提示改坏？
不会。它只对「补充的外壳状态」（提示、记忆、技能描述、子代理规格）做小幅、有证据的更新，从不重写不可变的基础系统提示，且每次精炼都有记录、支持回滚。
内核用的是哪个 Python？会和我机器上的冲突吗？
默认由安装器引导装一套独立的 uv + Python 3.11 运行时，与你系统 Python 互不干扰。设
PRIME_AGENT_KERNEL_PYTHON 可改用现有解释器（需已装 prime-agent-runtime），此时 Prime Agent 不再往该环境装包。5官方资源入口
教程到此结束，深入阅读认准这几个地址。
学完做什么
找个真实项目建一次性克隆 → 装好登录 → 让它并行审查三个模块（rlm.spawn）→ 把常用流程沉淀成技能 → 挂上心跳当看护。走完这五步，你就把它用成自己的了。