# Motebit
**一个拥有主权的 Agent 运行时。** 持久身份、累积记忆、赢得信任、受治理的委托 —— 封装在一个会呼吸的玻璃液滴中。
如今的每个 AI agent 都只是一个会话。没有持久的身份。没有可复合的记忆。没有累积的信任。没有关于它所做所为的证明。Motebit 是缺失的那一层：一个完整的 runtime，其中智能是可插拔的，但身份是核心资产。
39 个包。14.4 万行 TypeScript。3000 多个测试。[26 天构建的基础。](https://docs.motebit.com/docs/how-we-built-this)
| | 如今的 Agents | Motebit |
| -------------- | -------------- | ----------------------------------------------------------------- |
| **身份** | 会话 Token | Ed25519 密钥对 —— 跨设备、提供商、时间持久存在 |
| **记忆** | 上下文窗口 | 语义图 —— 复合、衰减、巩固 |
| **信任** | 无 | 签名收据 —— 赢得、代数化、可审计 |
| **治理** | 无 | 策略网关 —— 失败即关闭、敏感度感知、由操作员控制 |
| **证明** | 无 | 可验证凭证 —— W3C VC 2.0，加密签名 |
## 它是什么
Motebit 是一颗处于表面张力之下的智慧液滴。
**身份** —— Ed25519 密钥对、`did:key` URI、签名身份文件。Agent 可以向任何服务、任何中继、任何其他 Agent 证明它是谁。这不是会话 Token —— 这是一个跨越时间和设备存在的加密实体。密钥通过签名继承记录进行轮换 —— 旧密钥和新密钥共同签署转换，`motebit_id` 保持不变，任何人都可以在不信任中介的情况下验证该链。
**记忆** —— 一个随使用而增长的语义图。记忆在对话中形成，随时间自然衰减，从情景记忆巩固为语义记忆。运行时间越长，它知道得越多。好奇心目标从图中涌现。
**信任** —— Agent 通过经过验证的交互赢得信任。签名执行收据创建不可变的审计跟踪。随着协作的成败，信任等级发生转变。半环代数 通过 Agent 网络中最受信任的路径路由任务。
**治理** —— 策略网关控制跨越边界的内容。工具批准、预算限制、敏感度感知隐私、删除证书。默认失败即关闭。操作员决定 Agent 可以自主执行的操作、需要批准的操作以及始终拒绝的操作。
**委托** —— Agent 通过 MCP 将任务委托给其他 Agent。每次委托都会生成一个可自我验证的签名收据 —— 签名者的公钥被嵌入其中，因此任何系统都可以在不联系中继的情况下验证收据。SHA-256 哈希的提示/结果、用于监管链的嵌套委托收据、基于已验证收据的预算分配和结算。
**具象化** —— 使用 Three.js 渲染的玻璃液滴。身体是被动的；内部是主动的。状态确定性地驱动行为：好奇心使眼睛扩张，情绪弯曲微笑，处理过程点亮光芒。没有舞台指示 —— 只有物理规则。
**联邦** —— 中继通过相互认证进行对等互连。Agent 可跨中继发现。跨中继路由使用信任半环来寻找最优路径。结算链 处理跨中继支付。
## 试用
```
# 认识这个生物 —— 零安装，零注册
open https://motebit.com
# 或 scaffold 一个已签名的 agent 身份（30秒）
npm create motebit@latest my-agent
cd my-agent && node verify.js
# 安装 operator console
npm install -g motebit
# 启动 interactive session
motebit
# 或作为 daemon 运行并启用 goal scheduling
motebit run --identity ./motebit.md
```
## 五种界面
| 界面 | 用途 | 入口点 |
| ----------- | ---------------------------------------- | ------------------------------------------------------- |
| **Web** | 零阻力初次接触 | [motebit.com](https://motebit.com) |
| **CLI** | 开发者控制台，操作员模式，守护进程 | `npm install -g motebit` |
| **桌面** | Tauri 应用 —— 玻璃生物伴侣 | [Releases](https://github.com/motebit/motebit/releases) |
| **移动端** | React Native —— 随你而行 | Expo 构建 |
| **空间** | AR/VR —— 身体相对轨道力学 | WebXR 原型 |
每种界面都最大化利用其平台提供的功能。Web 通过 HTTP MCP 连接。CLI 用于操作。桌面用于陪伴。移动端用于出行。空间用于具象化。反模式是强行实现平台不支持的功能。
## 架构
```
apps/
web/ Browser — IndexedDB identity, CORS proxy, glass creature
cli/ Node.js — REPL, daemon, goal scheduling, operator console
desktop/ Tauri — OS keyring, stdio MCP, full operator mode
mobile/ React Native — Expo, secure keychain, triple providers
admin/ React — 13-tab real-time monitoring dashboard
spatial/ WebXR — 6DOF anchoring, spatial audio reactivity
packages/
sdk/ Core types — zero deps, MIT licensed
verify/ Signature verifier — zero deps, MIT licensed
create-motebit/ Scaffolder — MIT licensed
runtime/ Orchestrator — wires all engines, streaming AI loop
ai-core/ Pluggable providers: Claude, Ollama, Hybrid fallback
crypto/ Ed25519, AES-256-GCM, PBKDF2, W3C VC 2.0 credentials, signed succession
memory-graph/ Semantic memory, cosine similarity, half-life decay
event-log/ Append-only event sourcing, version clocks, compaction
state-vector/ 9-field interior state, EMA smoothing, hysteresis
behavior-engine/ State → BehaviorCues, deterministic, species-constrained
policy/ PolicyGate, MemoryGovernor, injection defense, audit
privacy-layer/ Sensitivity levels, retention rules, deletion certificates
planner/ PlanEngine: goal decomposition, reflection, adjustment
sync-engine/ Multi-device sync, HTTP/WebSocket, conflict detection
market/ Budget allocation, settlement, reputation, graph routing
semiring/ Trust algebra — generic semirings for network routing
mcp-server/ Expose motebit as MCP server, bearer auth, synthetic tools
mcp-client/ MCP client, tool discovery, manifest pinning
render-engine/ Glass droplet: MeshPhysicalMaterial, breathing, sag, glow
... 39 packages total
services/
api/ Sync relay — device auth, receipt verification, budget settlement,
credential issuance, federation, 5-tier rate limiting
spec/
identity-v1.md motebit/identity@1.0
execution-ledger-v1.md motebit/execution-ledger@1.0
relay-federation-v1.md motebit/relay-federation@1.0
```
## SDK
```
import { verify } from "@motebit/verify";
// Verify any artifact — identity file, receipt, credential, or presentation
const result = await verify(artifact);
if (result.type === "identity" && result.valid) {
console.log(result.did); // did:key:z6Mk...
console.log(result.succession); // key rotation chain
}
if (result.type === "receipt" && result.valid) {
console.log(result.signer); // did:key of executing agent
console.log(result.delegations); // nested delegation chain
}
```
```
import type { ExecutionReceipt, MotebitState, AgentTrustRecord } from "@motebit/sdk";
```
四个 npm 包，均无 monorepo 依赖：
| 包 | 描述 | 许可证 |
| ------------------------------------------------------------------ | ------------------------------------------------- | ------- |
| [`create-motebit`](https://www.npmjs.com/package/create-motebit) | `npm create motebit` —— 脚手架生成签名身份 | MIT |
| [`motebit`](https://www.npmjs.com/package/motebit) | CLI —— REPL、守护进程、操作员控制台 | BSL-1.1 |
| [`@motebit/verify`](https://www.npmjs.com/package/@motebit/verify) | 签名验证 —— 零依赖 | MIT |
| [`@motebit/sdk`](https://www.npmjs.com/package/@motebit/sdk) | 协议类型 —— 零依赖 | MIT |
## 规范
`motebit.md` 声明了身份（Ed25519 公钥、Agent ID、`did:key`）、治理（信任模式、风险阈值）、隐私（敏感度级别、保留规则）、记忆（衰减参数）、已注册设备以及密钥继承历史（§3.8）。
## 开发
```
pnpm install # Node >= 20, pnpm 9.15
pnpm run build # Build all 39 packages
pnpm run test # 3,000+ tests across 139 files
pnpm run typecheck # Type-check all packages
pnpm run lint # Lint all packages
```
## 许可证
**协议层** 采用 MIT 许可 —— 免费使用、在此基础上构建、以任何语言实现规范：
- [`spec/`](spec/) —— 身份规范
- [`packages/verify/`](packages/verify/) —— 验证库
- [`packages/create-motebit/`](packages/create-motebit/) —— CLI 脚手架工具
- [`packages/sdk/`](packages/sdk/) —— 核心协议类型
**平台实现** 采用 [BSL 1.1](LICENSE) —— 免费使用、源码可用，每个版本发布四年后转换为 MIT 许可。
"Motebit" 是 Daniel Hakim 的商标。参见 [TRADEMARK.md](TRADEMARK.md)。
## 链接
- [motebit.com](https://motebit.com) —— 认识这个生物
- [文档](https://docs.motebit.com) —— 指南、架构、API 参考
- [规范](spec/identity-v1.md) —— motebit/identity@1.0
- [npm](https://www.npmjs.com/org/motebit) —— 已发布的包
- [讨论](https://github.com/motebit/motebit/discussions) —— 问题、想法、展示与分享
- [Bug 报告](https://github.com/motebit/motebit/issues/new?template=bug_report.yml) —— 发现损坏的东西？告诉我们
- [贡献](CONTRIBUTING.md) —— 如何为 motebit 做贡献