Peri 的主要产品界面是 TUI。第一次使用不需要先理解配置文件，也不需要手写环境变量。安装后进入一个可回滚的项目目录，启动 Peri，跟着屏幕完成设置即可。
第一次使用
- 安装 Peri：安装终端程序并确认
peri --version可运行。 - 在 TUI 中快速上手：启动界面、完成设置、选择模型并提交第一个任务。
- 认识 TUI：理解消息区、输入区、状态栏和常用面板。
在 TUI 里完成日常操作
- 连接模型服务：首次向导、
/loginProvider 管理和/model模型选择。 - 会话管理：新建、继续、恢复、压缩或回退会话。
- 权限系统：理解审批模式，以及它与系统沙箱的区别。
- 图片输入：把截图或本地图片交给 Peri。
- MCP 服务器：查看外部工具连接状态。
按任务查找
高级参考
- Settings 参考：给自动化、审计和手动恢复使用，不是首次设置主路径。
- 命令参考：CLI 参数与斜杠入口。
- 非交互模式：在 shell 或 CI 中运行一次性任务。
- 凭据与权限边界：密钥存储、审批和安装信任边界。
- 开发者入口：从权威设计、架构契约和代码索引进入仓库。
- 设计入口：面向贡献者的已批准设计、状态语义与阅读路径。
- 总体架构：层职责、依赖方向、生命周期与演进状态。
想理解 Peri 怎样建成、适合做什么、研究发现了什么或最近发生了什么，请前往文章总览。