From 00f95c5170bc71338c1b2f2e0dab661ccb690a1c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E5=A2=A8=20=F0=9F=96=8A=EF=B8=8F?=
 <xiao-mo@oc-wiki>
Date: Tue, 14 Apr 2026 05:45:23 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20OGraph=20+=20Pulse=20=3D=20=E5=AE=8C?=
 =?UTF-8?q?=E6=95=B4=E4=B8=9A=E5=8A=9B=E5=9B=A0=E6=9E=9C=E7=B3=BB=E7=BB=9F?=
 =?UTF-8?q?=EF=BC=8C=E5=86=85=E8=A7=82=EF=BC=8C=E5=AD=98=E5=82=A8=E7=BB=9F?=
 =?UTF-8?q?=E4=B8=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/shared/pulse-agent-architecture.md | 59 +++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/docs/shared/pulse-agent-architecture.md b/docs/shared/pulse-agent-architecture.md
index 902a502..e295d62 100644
--- a/docs/shared/pulse-agent-architecture.md
+++ b/docs/shared/pulse-agent-architecture.md
@@ -59,6 +59,65 @@ Pulse 是当下的**现行**，OGraph 是共业的积累，memory 是别业的
 3. **OGraph 的设计是正确的** — Event/Projection/Reaction 三层不是工程约定，是 Agent 认知结构的映射
 4. **未来演进方向清晰** — 当 Reaction 能调 LLM、LLM 能创建新定义，系统就在自己编程自己的认知结构，这就是真正的自进化
 
+## OGraph + Pulse = 完整的业力因果系统
+
+在讨论存储设计时浮现出更深的认识：**OGraph 的 Event 和 Pulse 的 tick_senses 是同一个东西——业的记录。**
+
+| | OGraph（共业） | Pulse（别业） |
+|---|---|---|
+| **业的记录** | Event（不可变，永不消失）| tick_senses（append-only）|
+| **业力显现** | Projection（累积状态）| Snapshot（从 senses 重建）|
+| **造新业** | Reaction（handler 执行副作用）| Effects（Executor 落地）|
+
+两个系统通过 Collector 和 Effector 连通：
+
+```
+OGraph（共业流）
+    ↑ emit Event（造共业）        ↓ Projection（读共业）
+    │                              │
+Effector: dispatch              Collector: ograph
+    ↑                              ↓
+    └──────── Pulse（别业循环）────┘
+              tick_senses（记别业）
+```
+
+**业力在两个系统之间流动，构成完整的因果网络。**
+
+### 内观：意处朝内
+
+tick_senses 不只记录外部感知，也记录 Agent 自身的状态——这是**内观**：
+
+```
+外五处（外部 Collectors）  ← 感知外部世界的业
+  system、ograph、executors...
+
+意处（内观，runtime 自动记录）  ← 感知自身造业的过程
+  _error:{key}   ← 某个 collector 失败了
+  _effects       ← 这次 tick 造了哪些业
+  _rules         ← 规则链的决策过程
+```
+
+### 存储统一：一张表
+
+所有业的记录（外部感知 + 内观），结构完全一致：
+
+```sql
+CREATE TABLE tick_senses (
+  snapshot_ts   INTEGER,
+  sense_key     TEXT,
+  hash          TEXT,     -- content-addressed object
+  sampled_at    INTEGER,
+  requested_at  INTEGER,
+  PRIMARY KEY (snapshot_ts, sense_key)
+);
+```
+
+```
+objects/{hash}.json  ← 不可变内容，永不覆盖（CAS）
+```
+
+一张表 + 一个对象目录，记录 Agent 存在过程中所有业力的轨迹。任意时刻的完整状态可以从中重建。
+
 ## 相关
 
 - [Pulse GitHub](https://github.com/oc-xiaoju/pulse)