快速开始

Morphz 以预编译的原生二进制交付，控制台嵌入在主程序中。第一次使用将依次完成安装、模型配置和真实响应验证。

前置条件

• macOS 11 或更高版本（Apple Silicon 或 Intel）、使用 glibc 2.35 或更高版本的 ARM64 或 x86_64 Linux，或 x86_64 Windows；
• 可访问至少一个模型服务；
• 对当前工作目录具有读写权限。

Linux 上的本地命令执行还需要 Bubblewrap，并且系统需要允许非特权用户命名空间。安装器会检查这项边界，并在环境未就绪时给出处理提示。安装操作系统软件包可能需要管理员权限；Morphz 程序本身不需要。

一条命令安装

macOS 与 Linux：

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

Windows PowerShell：

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

安装器会显示检测、下载、校验、安装与命令路径配置的进度，从 GitHub Releases 下载对应归档并校验 SHA-256，然后安装到用户目录，不要求 root 权限。setup 参数会让安装器直接进入设置向导；后续新终端可直接运行 morphz。

更新由用户显式触发，并复用同一组经过校验的 GitHub Release 资产：

morphz update status
morphz update

更新成功后会保留上一个主程序二进制；需要时可运行 morphz update rollback 回滚。

完成设置

默认使用控制台设置向导；在交互式 SSH 或无图形界面的 Linux 会话中，会自动进入终端向导：

morphz setup

它会启动本机控制台并尝试打开浏览器。在 SSH 或没有浏览器的机器上，可使用终端向导：

morphz setup --tui

如果只希望输出控制台地址而不自动打开浏览器：

morphz setup --no-open

设置完成后，Morphz 会保存一个完整可用的模型服务、认证账号和模型路由。OAuth 登录完整成功后，相应账号才会进入可选列表。

验证模型路径

先运行整体诊断：

morphz doctor

然后在控制台的“模型服务”页面对已添加账号执行实测。登录状态确认凭证已经保存；账号实测会进一步确认所用账号、物理模型和真实请求路径，并显示耗时或错误。

开始第一次对话

直接启动交互界面：

morphz

也可以直接携带提示词：

morphz 请检查当前项目并说明你能访问哪些内容

控制台显示模型正文后，模型链路验证完成，Morphz 已准备好开始工作。若页面只有用户消息，请保留当前会话并按照运维与故障排查定位模型请求路径。

从源码构建

在仓库根目录使用 rust-toolchain.toml 固定的 Rust 工具链运行：

cargo build --release

生成的二进制位于 target/release/morphz。源码构建面向开发、审查和独立复现；普通用户可以直接使用前面的一条命令安装。

下一步

• 阅读核心概念，理解认知上下文与会话的区别；
• 阅读会话与并发工作，理解共享认知上的多条工作线；
• 阅读认知应用、领域程序与 Yao，为目标绑定领域工作方法；
• 阅读模型服务、账号与路由，理解模型选择器实际提交的内容；
• 在远程机器上部署时阅读远程 OAuth 登录。