发布形态
猫爪 / maoclaw 当前公开发布线以 v0.1.13 为最新正式版本，定位仍然是本地优先的 Rust AI 智能体运行时、框架层与产品表面。猫爪 / maoclaw
主平台
macOSpi
当前重点
v0.1.13 是当前最新正式公开版本，重点是原生桌面安全控制面与公开下载面对齐公开仓库、安装脚本与版本标识已经统一到 `miounet11/maoclaw`
运行表面
交互模式 / Print / JSON 模式 / 基础 RPC 模式Rust SDK 嵌入 / macOS Desktop Packaging
启动
从最短成功路径进入
- 先通过 `miounet11/maoclaw` 的安装脚本完成安装。
- 确认 `pi --version` 与 `maoclaw --version` 都可正常运行。
- 先配置一个 provider key，再执行 `pi doctor`。
- 进入本地仓库后运行 `pi`，或直接用 `pi -p` 完成第一次单次调用。
- 如果需要结构化自动化或外部接入，再进入 `pi --mode json` 或 `pi --mode rpc`。
- 第一次跑通后，用 `pi --continue` 进入持续工作流。
场景
先演示已经稳定的表面
这是最快感知 `maoclaw` 终端主路径价值的入口。
pi "请总结这个仓库的结构、核心模块和最重要的入口文件"适合把同一套运行时接入脚本、流水线和自动化包装层。
pi --mode json -p "请返回这个仓库的结构化摘要"直接展示 `maoclaw` 不只是聊天壳，而是可接入的运行时。
pi --mode rpc文档中心
先给用户一套按需求组织的说明
从“我想做什么”出发，再决定用 CLI、桌面、JSON 还是 RPC。
仓库理解、连续编码、桌面入口、JSON 自动化、RPC 集成各走自己的路径。
用户不需要先读完整仓库和内部规划文档。
版本与升级
把正式发布和当前构建升级分开讲清楚
changelog 负责正式版本，upgrade log 负责当前构建升级线。
当前正式版本线以 `v0.1.13` 为最新点。
当前构建升级线聚焦原生控制面、文档和网站同步。
支持范围
当前支持承诺
- 模式：交互模式 / Print / JSON 模式 / 基础 RPC 模式 / Rust SDK 嵌入 / macOS Desktop Packaging
- Provider：Anthropic / OpenAI / Gemini / Azure OpenAI
- 内置工具：read / write / edit / bash / grep / find / ls
- 次级验证平台：Linux / Windows
边界
必须明确写出的边界
- v0.1.13 是当前最新正式公开版本，但更广泛的平台与生态认证仍在继续收敛。
- JSON/RPC 在更多客户端形态下的稳定性仍在继续收敛。
- SDK contract 在更多嵌入场景下仍在继续稳定。
- 第三方扩展生态兼容仍处于逐步验证阶段。
- Linux 与 Windows 当前仍是次级验证平台。