Maoclaw V0.1 Faq

# 猫爪 v0.1 FAQ

Status: Draft  
Audience: Trial users, partners, internal team  
Companions: [maoclaw-v0.1-quick-start.md](maoclaw-v0.1-quick-start.md), [maoclaw-v0.1-support-scope.md](maoclaw-v0.1-support-scope.md), [maoclaw-v0.1-known-limitations.md](maoclaw-v0.1-known-limitations.md)

## 1. 猫爪是什么？

猫爪是一个终端优先的 AI coding agent 产品。

你可以把它理解为：

- 一个能在本地代码仓库里工作的问题分析助手
- 一个能调用文件、搜索、shell 等工具的终端型 AI 工作流产品
- 一个强调速度、低资源占用和可扩展性的试用版产品

## 2. 为什么命令还是 `pi`？

猫爪是当前对外产品品牌，但首版保留 `pi` 命令以保持兼容和降低迁移成本。

这是有意设计，不是安装错误。

## 3. 猫爪和 GitHub 仓库、命令是什么关系？

可以理解为：

- 对外公开仓库、安装脚本和文档统一使用 `maoclaw`
- 兼容命令继续保留 `pi`
- 在支持双命令入口的环境中，也可以直接使用 `maoclaw`

这样做是为了让品牌、安装入口和用户认知保持统一，同时不打断已有命令习惯。

## 4. 它已经是正式版了吗？

不是。

猫爪 v0.1 是**小范围试用版**。

它适合：

- 早期开发者试用
- 设计伙伴客户试用
- 小范围真实工作流验证

它暂时不适合被描述为“正式商用稳定版”。

## 5. 它是不是已经覆盖所有历史工作流？

不能这样承诺。

当前版本优先保证猫爪自己的安装、首轮试用和核心 AI coding workflow，暂时不把所有历史自动化和深层集成场景都列为 v0.1 默认承诺。

## 6. 首版最适合哪些人？

最适合：

- 经常在终端里工作的人
- 希望快速理解代码仓库的人
- 愿意尝试新工具并反馈问题的人
- 需要 AI 辅助搜索、解释、修改代码的人

## 7. 首版最推荐哪些使用方式？

优先推荐：

- 交互式使用
- 单次 print 模式
- 代码理解、搜索、解释、轻量修改
- 会话继续和恢复

## 8. 目前最推荐哪些 provider？

首版优先推荐：

- Anthropic
- OpenAI
- Gemini
- Azure OpenAI

## 9. 它支持哪些工具？

当前支持 7 个内置工具：

- `read`
- `write`
- `edit`
- `bash`
- `grep`
- `find`
- `ls`

## 10. 它支持 IDE / 自动化接入吗？

支持基础 RPC 模式，但首版不承诺完整 JSON/RPC 兼容。

如果你要做深度 IDE 接入或自动化编排，建议把它视为试验性能力，而不是正式稳定接口。

## 11. 它支持 SDK 嵌入吗？

当前不建议把 SDK 嵌入作为首版主卖点。

如果你的场景强依赖 SDK contract parity，建议先列为评估项目，而不是直接上线。

## 12. 它支持扩展吗？

支持基础扩展运行时、skills、prompt templates 和 themes。

但首版不承诺：

- 所有第三方扩展都可直接复用
- 所有扩展 hook 行为都完全一致
- 所有历史插件生态都自动兼容

## 13. 它支持 macOS 以外的平台吗？

项目本身具备跨平台基础，但首版优先支持 macOS。

Linux / Windows 可验证，但不是首版对外重点承诺平台。

## 14. 为什么有些地方还会同时看到猫爪和 `pi`？

因为当前品牌与兼容命令是分层设计。

- 猫爪 / maoclaw：公开品牌、仓库、安装入口与文档主名称
- `pi`：兼容命令与迁移缓冲层

只要用户可见路径统一、安装可用、兼容命令解释清楚，这种分层就是可控设计，而不是品牌错误。

## 15. 我第一次试用应该做什么？

建议按这个顺序：

1. 安装
2. 配置一个 provider
3. 在本地仓库里启动 `pi`
4. 先让它总结仓库结构
5. 再让它做搜索、解释和轻量修改

## 16. 如果安装时发现机器上已经有旧版 `pi` 怎么办？

这是正常情况。

安装器会尝试提供迁移、保留旧版或并存的路径。首版文档会明确说明推荐做法。

## 17. 首版最容易出问题的地方是什么？

通常是：

- provider 配置
- 旧版 `pi` 迁移
- 个别终端环境差异
- 深度 RPC / SDK / 扩展接入

## 18. 出现问题时应该提供什么信息？

建议反馈以下内容：

- 你执行的命令
- 当前系统和终端环境
- 使用的 provider
- 错误输出或截图
- 是否可以稳定复现

## 19. 这个版本最重要的价值是什么？

对试用用户来说，首版最重要的价值不是“完美兼容”，而是：

- 快速启动
- 快速理解代码
- 稳定完成常见 AI coding 工作流
- 让团队验证产品方向是否正确

## 20. 下一版会重点补什么？

按当前计划，后续更可能重点补：

- 更稳的发布与试用流程
- 更完整的兼容性闭环
- 更深的 RPC / SDK / 扩展能力
- 更成熟的产品化包装