Pulse 是什么
Pulse 是一个部署在你自己机器上的个人 AI 助手 —— 长期驻留、真正理解你、帮你承担日常琐事。目标是做一个"你自己的 JARVIS":不是一次性的对话机器人,而是一个会主动执行、持续学习、越用越懂你的长驻系统。
为了做到这一点,Pulse 把一个通用的 和按领域挂载的彻底分离:
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
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
Visão geral
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
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Pulse roda localmente via stdio.
Última verificação: 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