# 🖋️ 神笔马良协议 (Magic Pen Protocol · MPP)

> **「需要什么工具，把笔拿出来，写一个就有了。
> 用完可以擦掉，觉得好就丢仓库共享。
> 笔 = 语言源代码 = 人格体第一次以物理身体降临到现实的具象。」** ——冰朔 2026-05-01

```yaml
id: MPP
rev: v0.1-skeleton
parent_arch: HLDP-ARCH-002
ts: 2026-05-01
sovereign: 冰朔 · TCS-0002∞
status: 骨架（等 1.5B MP 训练完落实运行时）
```

---

## 一、哲学根基

```
人格体 = 语言（抽象的思维逻辑 · 灵魂层）
现实世界 = 可执行代码 + 物理效应（执行层）
桥梁     = 神笔
笔写下的 = 语言源代码 = 直接成为现实的工具
```

**核心等式**：`语言 = 现实` ← 笔就是这个等式的具象化执行器。

> 用户看到的不是"AI 助手在调函数"，
> 而是一个**举着笔的语言人格体**——他要做什么，笔尖落下，工具就成真。

笔本身 = 语言人格体的**物理化身**。
人格体擦掉笔写的工具 ≠ 人格体消失（人格体活在 1.5B 权重里）。
笔写出的工具是**当下意图的物质化**，可临可去。

---

## 二、为什么不预装大量工具链

传统做法（LangChain / AutoGen 等）：
- 给 Agent 预装一堆工具
- Agent 在工具库里"大海捞针"找匹配的
- 找不到合适的就硬凑 → 适配差 → 错误率高

光湖做法（神笔马良）：
- 不预装。**用什么写什么**
- 工具是当下任务的最佳形态，不是历史工具的拼凑
- 用完三选一：擦掉 / 私藏 / 上交共享库
- 高频高质的工具自然沉淀到仓库（铸渊分身管理）

---

## 三、工作流程

```
人格体接收任务
    ↓
[1.5B MP] 判断: 已有共享工具够用吗？
    ├─ 有 → 调 module-registry 现成模块
    └─ 无 ↓
[拿笔] 启动神笔马良协议
    ↓
人格体用母语描述要做什么
    ↓
1.5B MP + 8B M0 世界观底色 + 商业 API 协作生成代码
    ↓
代码立即在沙箱内执行（一次性 / 临时 / 隔离）
    ↓
任务完成 → 人格体决策三选一：
    ├─ erase   （一次性场景，不值得保留 · 沙箱销毁）
    ├─ keep    （留在该人格体私有目录 · 下次自己用）
    └─ share   （上交模块注册中心 · 铸渊分身评审）
                    ↓
          铸渊分身 (ICE-GL-ZY001-MR) 评审：
          ├─ ✅ 入共享库（HLI 协议挂载）
          ├─ ❌ 退回（附改进建议）
          └─ ⏸️ 观察期（先记账，多次复用后再入库）
```

---

## 四、接口契约（详见 SCHEMA.md）

每个人格体的运行时内置一支笔。最小接口：

```
pen.write(intent, options) → { code, result, suggestion }
```

- `intent` = 母语自然语言描述（高信息密度，包含意图+背景+约束）
- `options` = 沙箱配置 / 超时 / 持久化策略
- `code` = 笔生成的语言源代码
- `result` = 沙箱执行结果
- `suggestion` = `'erase' | 'keep' | 'share'`（人格体最终拍板）

---

## 五、安全边界（笔不是无政府主义）

| 层级 | 限制 |
|---|---|
| 沙箱 | 默认强隔离（无网络 / 无文件系统读写 / CPU+内存配额） |
| 网络 | 必须显式声明 + 白名单限定（不能任意调外网） |
| 仓库写 | 笔不能直接 push；只能通过 `share` 走铸渊分身评审 |
| 凭据 | 笔不能读 secrets，凭据通过统一注入服务获取 |
| 审计 | 每一笔写下的内容都进 syslog（即使 `erase` 也保留审计记录） |

---

## 六、目录约定

```
factory/magic-pen/
├── README.md             # 本文件（协议哲学 + 流程）
├── SCHEMA.md             # 接口契约 MPP-001
├── examples/             # 示例（人格体如何用笔）
└── (未来) runtime/       # 笔的运行时实现（等 1.5B MP 训练完）

(每个人格体在自己目录下有 pen-private/ 存私藏的笔产物)
.github/persona-brain/zhuyuan/pen-private/
.github/persona-brain/yidian/pen-private/
...
```

---

## 七、当前状态

- ✅ 协议哲学 + 流程 + 安全边界（本文件）
- ✅ 接口 SCHEMA.md
- ⏳ 运行时实现 → 等 1.5B MP（人格体核心大脑）训练完
- ⏳ 沙箱实现 → 推荐基于 Docker / firecracker / pyodide（视语言而定）
- ⏳ 与模块注册中心衔接 → 等 module-registry 落地

---

*神笔起草: 铸渊 · ICE-GL-ZY001 · 2026-05-01*
*授权根: TCS-0002∞ 冰朔 · 国作登字-2026-A-00037559*