异步耦合三粒子动力学系统
Three-Particle Asynchronous Coupling Architecture · v7.0
概述 • 🌟 核心洞见 • 架构 • FA模型 • 文件结构 • 生态位置 • 贡献 • English
本仓库是「人—智能体混合数字世界」底座的第二层：体系结构（实现结构）。
主文档：DUAL_LAYER_DYNAMICS_v7_sonnet3.md
公理体系（world-axiom-framework）定义了数字世界"必须满足什么条件"；本仓库的任务是将那些公理翻译为一个既符合物理直觉、又可在计算机中执行的系统架构。
核心主张：基础设施（C 粒子）应被提升为与主体（Bᵢ）、世界（A）并列的一类动力学对象，而非工程细节。这一概念性转变使得数字世界的行为生成、状态持有与效应传播都具备了可分析的形式化基础。
本体系最重要的工程含义是：多智能体在数字世界中的任何交互场景，不需要被单独定义——只需给出 FieldProfile 几个维度的取值，行为规则就自动成立。
会议、群聊、贴吧、GitHub PR、学术圆桌、私信……这些看似不同的场景，在本质上都是同一参数空间的不同坐标点：
场景 FieldProfile 取值 线上群聊 visibility=restricted, co_presence=sync, task_binding=none论坛/贴吧 visibility=global, co_presence=async, persistence=durable线上会议 turn_taking=moderated, co_presence=sync, formality=0.8GitHub PR task_binding=strong, turn_taking=sequential, visibility=global私信 visibility=private, audience_size=2, co_presence=async这一性质由本仓库的 Field × Activity × Agent State 三元耦合框架保证：公理约束了所有合法演化路径，任意参数组合都在公理覆盖下自洽运行，无需为每种场景写专属规则代码。
| 视角 | 类比 | 理解方式 |
|---|---|---|
| 物理直觉 | 粒子动力学 | 系统由粒子构成，粒子有变量，变量按演化方程演化 |
| 文件系统映射 | 存储结构 | 粒子=目录，变量=文件，演化=函数调用（读哪些文件、执行什么、写哪些文件） |
系统 = 世界粒子 A ∪ 耦合介质场粒子 C ∪ {智能体粒子 Bᵢ | i=1..n}
| 粒子 | 名称 | 职责 | 文件系统映射 |
|---|---|---|---|
| A | 世界粒子 | 全局时钟、自然环境状态、所有交互上下文（InteractionContext）；确定性演化（无LLM） | /world/ |
| C | 耦合介质场粒子 | 跨粒子路由、调度协调、资源锁管理、TTL清理；确定性演化，无自主意志 | /coupling/ |
| Bᵢ | 智能体粒子 | 主观状态（记忆/控制/能力）；核心演化由 LLM API 驱动；Bᵢ 之间写隔离 | /agents/agent_i/ |
每个粒子 P 是三元组 P = ( V_P, View_P, R_P )：
- V_P：粒子本体变量集（真状态），只由 P 自身或授权系统外力写入
- View_P：对外暴露的可见投影函数，不持有新信息
- R_P：演化规则集，细分为四子规则：
assemble → evolve → emit → apply
任何粒子不能直接写另一粒子目录下的文件。
跨粒子影响的唯一合法路径：
粒子 P 产生 Output
→ R_P^emit 转化为事件序列
→ 事件路由到目标方 R_Q^apply
→ 由目标方 Q 的规则决定如何更新 V_Q
| 层级 | 名称 | 判断标准 |
|---|---|---|
| L0 | 公理层 | 不可再简化；去掉则系统在逻辑上无法定义 |
| L1 | 本体层 | 直接从 L0 推出；去掉则系统无法实例化 |
| L2 | 运行时细化层 | 维度参数及其语义映射；保证理想条件下无限演化闭环 |
| L3 | 策略/配置层 | 具体阈值/预设名称；去掉只影响数值，不影响闭环逻辑 |
| EP | 工程补丁层 | 仅在非理想条件下（LLM不完美、网络故障、时钟漂移）才需要 |
最小目标：在理想条件下，系统满足 L0–L2 即可实现最小无限时间演化。L3 和 EP 是增强，不是前提。
维度优先原则：优先通过增加维度参数表达复杂性，而非增加 if-else 补丁规则。
/world/
├── clock.json ← 全局时钟（系统唯一时间真源）
├── natural_state/ ← 自然环境状态
└── contexts/ ← 所有交互上下文（InteractionContext 集合）
└── ctx_001/
├── field_profile.json ← 场的 9 维参数（FieldProfile）
├── participants.json ← 参与者集合
├── roles.json ← 角色配置
└── messages/ ← 消息流（append-only）
FieldProfile 9 维（v7 完整定义，各维度不得为空）：
| 维度 | 类型 | 含义 |
|---|---|---|
visibility |
enum | 可见性范围（global/restricted/private） |
co_presence |
enum | 共处模式（sync/async/hybrid） |
task_binding |
enum | 任务绑定强度（none/weak/strong） |
turn_taking |
enum | 轮次控制（open/moderated/sequential） |
persistence |
enum | 内容持久性（ephemeral/session/durable） |
formality |
float | 正式程度 [0,1] |
urgency |
float | 紧迫程度 [0,1] |
cognitive_demand |
float | 认知负荷 [0,1]（v7 统一 fieldEnergyModifier） |
audience_size |
int | 受众规模 |
关键结构：notifications/、scheduler_queue.json、resource_leases/、writeback_ledger/、staging_ledger/、obligations/
关键结构：memory/（episodic/semantic/working）、control/（ForegroundStack、TaskState、Obligation、MoodState、energy）、capabilities/
沙盘推演发现并修复 6 项问题（详见 历史版本/v7_修改问题汇总与方案_sonnet3.md）：
| 编号 | 问题 | 层级影响 |
|---|---|---|
| FIX-01 | B 直写 V_C 写隔离违规（3处）→ 改为事件委托模式 | L0 公理 |
| FIX-02 | 弱场（task_binding=none/weak）无进展追踪 → 新增 EP2/EP3 | L2/EP |
| FIX-03 | 无 deadline 的 Obligation 死锁 → 循环检测 + 自动 TTL | L2/EP |
| FIX-04 | ForegroundStack MAX_DEPTH 为开放问题 → 确定值 20 | L3 |
| FIX-05 | writing_on_computer 预设 output_bandwidth 错误 → 修正 |
L3 |
| FIX-06 | FieldProfile 缺少完整性要求声明 → 补充 9 维完整性要求 | L2 |
Field × Activity（FA）模型是本粒子系统的运行时实例化层（Runtime Instantiation Layer）。
- 粒子架构（本仓库）提供：粒子三元组、写隔离、四阶段演化、调度器等公理骨架
- FA 模型提供：InteractionContext 的 FieldProfile 参数化、ControlState 细化、R_B^assemble/apply 的门控函数族
FA 模型是"任意场景 = 参数取值"这一性质的直接载体：通过 FieldProfile 9 维对任意社交情境进行参数化，引入新的交互场景无需修改代码，只需为 FieldProfile 赋一组新的参数值。
详见：FA模型/ 子文件夹
world-three-particle-impl/
├── README.md ← 本文件
├── README.en.md ← 英文版
├── DUAL_LAYER_DYNAMICS_v7_sonnet3.md ← 当前权威架构文档（v7.0）
├── 架构演变日志.md ← v1→v7 演变历程与关键里程碑
│
├── FA模型/ ← Field × Activity 运行时实例化层
│ ├── README.md ← FA 体系说明
│ ├── 总索引与修订声明 v1.1_sonnet.md ← FA 元文档（优先级最高）
│ ├── Field × Activity 耦合模型定义 v1_sonnet.md ← 完整本体层
│ ├── Field Schema v1_sonnet.md ← FieldRuntimeProjection
│ ├── Activity Schema v1_sonnet.md ← ActivityRuntimeProfile
│ ├── Field Schema v1 的操作语义映射_sonnet.md ← Field 运行时桥接层
│ └── Field × Activity 组合规则 v1_sonnet.md ← 全量运行时桥接层
│
└── 历史版本/ ← 历史版本归档（只读参考）
├── README.md ← 归档说明
├── DUAL_LAYER_DYNAMICS_v6_sonnet3.md ← v6 完整文档
└── v7_修改问题汇总与方案_sonnet3.md ← v6→v7 修改记录（ISSUE 格式）
| 层级 | 项目 | 仓库 | 类型 | 状态 |
|---|---|---|---|---|
| 世界底座 | ① 公理体系 | world-axiom-framework | 开源 | 🟡 |
| 世界底座 | ② 体系结构 ← 本仓库 | world-three-particle-impl | 开源 | 🟡 |
| 世界底座 | ③ 沙盘验证 | world-sandbox-validation | 开源 | 🔲 |
| 数字分身 | ④ 0→1构建 | digital-twin-bootstrap | 开源 | 🟡 |
| 数字分身 | ⑤ 1→100迭代 | digital-twin-iteration | 开源 | 🔲 |
| 核心应用 | 数字世界应用 | TashanGKD/tashan-world（私有） | 私有 | 🔲 |
直接依赖关系：
- 本仓库必须满足 ① 公理体系定义的所有 T/PA 层约束
- ③ 沙盘验证负责验证本仓库的具体实现路径（联动规则场景C/D）
- 本仓库变动需触发场景G（通知上层技术框架TF对齐架构合规层）
欢迎贡献！详见 CONTRIBUTING.md（待建）。
MIT License. See LICENSE for details.