Morphz

English · 简体中文

从聊天补全走向结构化上下文求值。

观看宣传片 · 1:17 →

Morphz 是一台面向持久 Agent 的 S 表达式认知机（S-Expression Cognitive Machine）。 它让结构化 Context，而不是不断增长的聊天记录，成为大语言模型直接求值的对象。模型负责 非确定性语义处理；确定性事务内核负责事实、权限、状态、执行与恢复。

Morphz 由新变元创建并维护。

Developer Preview

Morphz 0.1 是一次以源码为先的 Developer Preview。核心机制已经可以复现，公开接口、 多进程运行和部分跨平台验证仍在演进，后续可能发生不兼容变更；当前版本也不承诺生产级 多租户云服务能力。

Morphz 已经拥有 macOS、Linux 和 Windows 的原生沙箱实现。Morphz 0.1 支持 macOS 11 或更高 版本的 Apple Silicon 与 Intel Mac、使用 glibc 2.35 或更高版本的 ARM64 与 x86_64 Linux， 以及 x86_64 Windows。 Linux 的 workspace-write 模式依赖 Bubblewrap；Windows 的安全声明依赖包含完整辅助程序的 Morphz Windows bundle。

已经实现、完成验证、仍属实验以及尚在规划的能力边界，以 当前核心实现状态为准。

Runtime 0.1.3 将 Session IO v1 转为默认可用的 正式功能，无需实验编译或启动参数；数据库写入隔离及基于备份的降级仍是显式运维操作。

Morphz 改变了什么

• Context 是持久状态。 Agent 拥有带版本的认知 Frames，不依附于某一个 Session 或聊天记录。
• 求值是状态变换。 模型提出语义判断与行动；确定性内核验证并提交获得授权的变化。
• 并发具有因果结构。 Objectives、Threads、Activations、依赖关系和版本化事务让并行工作 可以被检查和恢复。
• 认知实践可以编程。 Harness 包和 Yao 程序可以定义求值循环，而不替换 Agent 身份。
• 经验可以成为可移植证据。 Agent Trajectory 与 Mind Frame Exchange 规范定义了跨实现的 可审计记录与选择性认知交换。

安装与运行

前置条件

• 使用上述支持矩阵中的操作系统；
• 可以访问至少一个受支持的模型服务；
• 对交给 Agent 的工作目录具有读写权限。

Linux 上的本地命令执行需要 Bubblewrap，并且系统需要允许非特权用户命名空间。安装器会在 下载前检查这项边界，并在宿主环境未就绪时给出提示。

在 macOS 或 Linux 上安装预编译版本：

curl -fsSL https://morphz.ai/install.sh | sh -s -- setup

Windows PowerShell：

irm https://morphz.ai/install.ps1 | iex

安装器会显示各安装阶段，选择对应的 GitHub Release 原生制品、校验 SHA-256，并为后续 终端配置用户级命令路径。setup 参数会让安装器直接启动设置；打开新终端后可继续：

morphz doctor
morphz

setup 默认打开内嵌的控制台向导；在交互式 SSH 或无图形界面的 Linux 会话中，会自动选择 终端向导。也可以用 setup --tui 显式选择；只需要输出控制台地址而不打开浏览器时，使用 setup --no-open。

Morphz 的启动目录可能成为 Agent 的工作目录；必要时用显式的 --cwd 启动，不要无意中 把源码 checkout 的写权限交给实验中的 Agent。开发者仍可使用 rust-toolchain.toml 固定的工具链从源码构建。

完整首次运行流程见快速开始。

文档与研究

• 项目主站
• 产品文档
• 技术文章：从聊天补全到结构化上下文求值
• 中文预印本 · English preprint
• Morphz 技术标准
• 核心实现状态

标准工作区包括 Structured Context、Agent Trajectory、Cognitive Application 与 Harness、 Yao，以及 Mind Frame Exchange。Draft 标准描述的是评审目标，并不自动证明每一项要求都已经实现。

仓库结构

• morphz/：核心实现、Application API、CLI 与 Server 适配器；
• yao/：确定性求值程序使用的类型化语言；
• morphz-evals/：评测框架与测试夹具；
• extensions/：默认核心之外的可选能力；
• application/：共享工作空间应用、Desktop、Web 与应用集成测试；
• dashboard/：内嵌的 Web 控制面与 Inspector；
• website/：Morphz 技术主站；
• docs/standards/：公开规范与一致性工作；
• docs/：架构、研究、验证与路线文档。

开发

运行 Rust 质量门禁：

cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace --all-targets
cargo build --release --workspace

单独验证 Dashboard：

cd dashboard
npm ci
npm run lint
npm run test
npm run build

提交变更前请阅读 CONTRIBUTING.md，项目与标准治理方式见 GOVERNANCE.md。

面向用户的应用已并入本仓库，与 Runtime 和 Dashboard 分别构建。安装 Node.js 24.13 或更新版本后，在仓库根目录运行：

npm ci --prefix application
npm --prefix application run build
npm --prefix application test
npm --prefix application run desktop

以上是全新本机环境的启动方式。已有安装继续打开原应用；切换源码时保留启动器记录的 数据目录、profile 和配置文件引用，不用不带参数的启动命令覆盖原配置。

Web 宿主、Runtime 联测、既有配置切换和平台边界见应用说明 与仓库整合记录。Mobile 仍待开发；源码合并 不代表移动版已发布，也不会自动同步本地数据库。

安全

Morphz 对文件、Shell、本机执行和远程执行能力使用统一的权限配置。workspace-write 模式由 操作系统原生沙箱强制执行；缺少所需后端时会 fail closed。full_access 会主动移除这些边界， 只应在已经信任的环境中使用。

安全模型仍属于 Developer Preview。向不可信工作区或远程用户开放 Morphz 之前，请阅读 统一沙箱与审批架构。

许可证

原创源码、测试、开发工具、技术文档、规范文本和公开一致性测试夹具通常采用 Apache License 2.0。论文、专利文件、网站编辑内容、品牌素材和第三方材料可能适用 独立条款。完整边界见许可证适用范围、 专利政策、商标政策与 第三方声明。