Pulse 是什么
Pulse 是一个部署在你自己机器上的个人 AI 助手 —— 长期驻留、真正理解你、帮你承担日常琐事。目标是做一个"你自己的 JARVIS":不是一次性的对话机器人,而是一个会主动执行、持续学习、越用越懂你的长驻系统。
为了做到这一点,Pulse 把一个通用的 和按领域挂载的彻底分离:
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Pulse 是一个部署在你自己机器上的个人 AI 助手 —— 长期驻留、真正理解你、帮你承担日常琐事。目标是做一个"你自己的 JARVIS":不是一次性的对话机器人,而是一个会主动执行、持续学习、越用越懂你的长驻系统。
为了做到这一点,Pulse 把一个通用的 和按领域挂载的彻底分离:
Self-hosted personal AI Agent OS / 长驻个人 AI 助手 (JARVIS-style). Kernel + pluggable skill packs (job, game, mail, life…). AgentRuntime · Layer×Scope memory · ReAct · Tool Use Contract (anti-hallucination) · SafetyPlane HITL · MCP server & client. Inspired by Letta/MemGPT, Claude Code, OpenClaw. LangChain/LangGraph/AutoGen alternative
core/)领域无关 —— 长程调度、五层记忆、契约化工具调用、事件审计、人格进化一体;modules/)按领域组目录,新增场景只加目录不改框架;这只是开端。每一个值得被自动化的生活场景都是 Pulse 的下一站 —— 代理游戏日常签到、端到端生成旅行攻略、财务周报、联动智能家居,甚至自动生成新技能、沉淀出属于你个人的使用习惯与偏好。一个内核,承载无限技能包。
现在的 Agent 项目大概分三类,都有明显痛点:
Pulse 想做的是"把 Agent 从对话窗口中解耦出来,成为一个长期服务于你的助手":
┌────────────────────────────────────────────────────────────────────────────┐
│ Pulse 主 Python 进程 (FastAPI / uvicorn · 单进程 + asyncio + 后台线程) │
│ │
│ ┌──────────────────────── 接入层 ──────────────────────────┐ │
│ │ HTTP API │ SSE │ CLI │ 企业微信/飞书 Adapter │ MCP Server │ │
│ └───────────────────────────┬──────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────── Agent OS 内核 ───────────────────────┐ │
│ │ AgentRuntime ──→ 调度 / active hours / 熔断 │ │
│ │ Task Runtime (Brain) ──→ ReAct 推理 + ToolUseContract │ │
│ │ Memory Runtime ──→ Layer × Scope 五层记忆 │ │
│ │ Observability Plane ──→ EventBus + JSONL + InMemStore │ │
│ │ SafetyPlane ──→ Service 闸门 + Suspend-Ask- │ │
│ │ Resume-Reexecute 四步 HITL 原语 │ │
│ └───────────────────────────┬──────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────── 三环能力模型 (Brain 的 tool list) ───────────┐ │
│ │ Ring 1 Tool 轻量级内置函数 (alarm/weather/web…) │ │
│ │ Ring 2 Module 业务技能包 (job/intel/email/system) │ │
│ │ Ring 3 External MCP 任意外部 MCP Server(跨进程调用) │ │
│ │ Meta SkillGen 自然语言 → 新工具热加载 │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────── Capability Layer (领域无关) ─────────────────┐ │
│ │ LLM Router · Browser Pool · Storage · Notify · Scheduler│ │
│ │ Channel · Policy · EventBus · Cost · Config │ │
│ └──────────────────────────────────────────────────────────┘ │
└───────────┬─────────────────────┬──────────────────────┬──────────────────┘
│ stdio / subprocess │ CDP (WebSocket) │ TCP/Unix socket
▼ ▼ ▼
┌────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐
│ 外部 MCP Server│ │ Chromium OS 子进程 │ │ PostgreSQL │
│ (各自独立进程) │ │ (Patchright 派生, │ │ 业务数据 · 记忆 │
│ GitHub/Notion..│ │ 处理 BOSS / 网页) │ │ 审计(JSONL 落盘) │
└────────────────┘ └──────────────────────┘ └──────────────────────┘
Python 主体单进程内运行(asyncio + 一个调度线程),Chromium 与外部 MCP Server 是被派生的独立子进程。
LLM 最常见的 bug 不是工具坏了,而是"嘴上说调用了但实际没调":回复"已为你记录偏好",但本轮根本没发出工具调用。纯 prompt 约束在多轮对话里必然失守。
Pulse 用三条正交契约兜底,任一层失守由下一层接住:
不变式:语义判断归 LLM,结构判断归 Python;不允许用关键词正则去强制调工具。
详见 ADR-001。
主流 Agent 记忆是"Core + 向量检索"两层,所有东西塞同一个袋子。Pulse 把记忆按两个独立维度拆开:
Workspace × workspace 是接入点:业务域(job / mail / 未来的 game / health)挂自己的领域记忆 facade,内核只提供通用读写,不感知业务语义。新增技能包不需要改内核。
当前不使用向量库:在个人单用户规模下,LLM 生成关键词 + SQL 关键词检索的命中率与延迟优于向量召回,且依赖更轻。判断依据与未来切换阈值见 MemoryRuntime 设计。
cron + while True 不是长驻 Agent,只是定时器。AgentRuntime 把以下能力做成内核能力:
详见 AgentRuntime 设计。
当 Agent 接入真实外部账号(求职、邮箱、消息平台)后,每一条发出去的消息、每一次点击都会到达真人。这一层要回答两个问题:什么动作可以直接做、什么动作必须人确认后才能做。
常见的三步 Ask(Suspend / Ask / Resume)在产品里会走到"假成功":Ask 挂起后,下一轮巡检以为已经处理过、不会再拾起;Agent 侧标记"已发送",外部连接器实际从未调用。把闸门放在 Brain 层,又会漏掉所有由后台巡检触发的副作用。
Pulse 的做法:
第四步的 Reexecute 是关键不变式:用户确认不是把状态改成"成功",而是真的把动作重新执行一次,确认流程与真实执行不脱节。
详见 ADR-006。
┌─────────────────────────────────────────────────────────────────┐
│ 每轮 ReAct 推理前: │
│ 加载 Core (SOUL + USER + PREFS + CONTEXT) │
│ + Recall 最近 N 轮摘要 + Archival 相关事实 │
│ + Workspace × workspace 的 DomainMemory facts │
│ → 拼成 system prompt 注入 LLM │
│ │
│ 推理结束后: │
│ Recall 追加对话 + 工具调用 │
│ Operational 清理 turn 级 scratchpad │
│ Workspace/Archival/Core 按 Promotion Pipeline 晋升 │
│ 事件同步进 EventBus → InMemStore + JsonlSink │
│ │
│ 用户纠正 ("以后别推游戏公司"): │
│ → 偏好学习 Track A:纠正检测 → 规则提取 → PREFS 更新 │
│ → 治理门控 (Autonomous/Supervised/Gated) 决定是否立即生效 │
│ → 变更写审计日志,可回滚、可版本对比 │
└─────────────────────────────────────────────────────────────────┘
人格分级:SOUL 里每条信念带标签
values:
- "[CORE] 用户利益优先,不做损害用户的事"
- "[CORE] 诚实,不确定的事明确说不确定"
- "[MUTABLE] 优先推荐远程工作机会"
[CORE] 信念永不被反思 Pipeline 修改,[MUTABLE] 可通过反馈与反思进化 —— 越用越懂你,同时兜住底线。
Pulse 当前的业务技能包聚焦求职场景,但底层内核已经是通用的,新增领域只加目录。
modules/job/modules/intel/单一 Module + 主题 YAML 装配,新增主题(秋招、面经、大模型前沿等)只加配置文件不改代码。
modules/email/tracker/IMAP 只读接入 → 邮件分类(面试邀请 / 拒信 / 补材料)→ 日程结构化抽取 → 状态同步 + IM 提醒。
modules/system/git clone https://github.com/<your-org>/pulse.git
cd pulse
cp .env.example .env
# 编辑 .env 填入 OPENAI_API_KEY 或 DASHSCOPE_API_KEY, 以及 DATABASE_URL
pip install -e .[dev]
./scripts/start.sh all
API 文档: http://localhost:8010/docs 健康探针: http://localhost:8010/health 实时事件流(SSE): http://localhost:8010/api/agent/events
docker compose up --build
# 首次登录 BOSS(浏览器扫码,Cookie 自动持久化到 ~/.pulse/boss_browser_profile)
./scripts/boss_login.sh
# 长驻调度开启后, 通过对话或运行时接口启停 patrol
AGENT_RUNTIME_ENABLED=true
PULSE_SAFETY_PLANE=enforce
curl -X POST http://localhost:8010/api/runtime/patrols/job_greet.patrol/enable
curl -X POST http://localhost:8010/api/runtime/patrols/job_chat.patrol/enable
Pulse 内部工具自动注册为 MCP Tool,对外可用。连接配置示例(Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"pulse": {
"command": "pulse",
"args": ["mcp", "serve"]
}
}
}
连上后,Claude / Cursor 里可以直接调用 job.greet.scan、memory.search 等 Pulse 工具。
src/pulse/
core/ # AgentRuntime / Brain / Memory / Safety / MCP / EventBus
modules/ # job / intel / email / system 等技能包
tools/ # 轻量内置工具
docs/ # 设计文档与 ADR
tests/pulse/ # 单元、集成、合同测试
Python 3.11 · FastAPI · PostgreSQL · asyncio · Patchright · MCP · OpenAI / Qwen3-Max / DeepSeek · Docker Compose
Pulse 的第一站是求职,但架构预留的舞台远比求职大。下面是未来可插拔的技能包方向,每一条都是独立的 Module 目录,每一条都欢迎 PR。
让 Pulse 变成托管 SLG / MMO / 卡牌手游日常的数字肝工。Patchright + DOM 脚手架已经在求职域跑通反爬链路,下一步把这套能力泛化给游戏场景。
modules/game/<game_name>/,PR 合并即上架。《原神》《明日方舟》《崩坏:星穹铁道》《FGO》《碧蓝档案》等任意 adapter 都在等人来写不是"问一句答一句"的 chatbot,而是从一句意图到完整方案的闭环。
这部分不做时间承诺,是 Pulse 愿意为之持续投入研究的方向:
[MUTABLE] 信念真正随时间推移、与用户共生演化,保留 [CORE] 兜底前沿探索并非空泛愿景。Pulse 的 SOUL 进化、五层记忆、EventBus 审计、治理门控等底座已实装于当前代码库,上述前沿方向是在这些底座之上增量演进,而非重新设计。
Pulse 正处于 v0 阶段,早期贡献者有机会参与到项目核心架构的塑造中。
不同背景的贡献者在 Pulse 中都能找到发力点:
modules/game/<game_name>/ 下提交游戏技能包,将签到 / 日常 / 抽卡自动化。Patchright 反爬脚手架已在求职域验证,可直接复用提交 PR 前请阅读 docs/code-review-checklist.md —— 工程宪法:编码与可维护性、测试、注释、系统可配/可观测/可关机;仓库级落地项另见 docs/engineering/pulse-conventions.md。标准较高,适合重视代码质量的贡献者。
架构类改动请先开 RFC issue 讨论,ADR 机制见 docs/adr/。
设计过程中吸收了以下项目的经验:
Self-hosted personal AI Agent OS / 长驻个人 AI 助手 (JARVIS-style). Kernel + pluggable skill packs (job, game, mail, life…). AgentRuntime · Layer×Scope memory · ReAct · Tool Use Contract (anti-hallucination
總覽
Self-hosted personal AI Agent OS / 长驻个人 AI 助手 (JARVIS-style). Kernel + pluggable skill packs (job, game, mail, life…). AgentRuntime · Layer×Scope memory · ReAct · Tool Use Contract (anti-hallucination) · SafetyPlane HITL · MCP server & client. Inspired by Letta/MemGPT, Claude Code, OpenClaw. LangChain/LangGraph/AutoGen alternative
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Pulse 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 Self-hosted personal AI Agent OS / 长驻个人 AI 助手 (JARVIS-style). Kernel + pluggable skill packs (job, game, mail, life…). AgentRuntime · Layer×Scope memory · ReAct · Tool Use Contract (anti-hallucination) · SafetyPlane HITL · MCP server & client. Inspired by Letta/MemGPT, Claude Code, OpenClaw. LangChain/LangGraph/AutoGen alternative