guanghulab/factory/magic-pen/README.md

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

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

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