---
title: "凭据与权限边界"
description: "理解 Peri 的明文 settings、审批模式、安装脚本和 Web 监听边界，并为高风险任务增加外层隔离。"
---

> Documentation Index
> Fetch the complete documentation index at: https://konghayao.github.io/peri-cool/llms.txt
> Use this file to discover all available pages before exploring further.

# 凭据与权限边界

Peri 可以读写文件、执行 shell、访问网络和调用扩展工具。审批模式影响“是否在执行前询问”，不提供操作系统级隔离。

## 默认权限行为

交互 TUI 没有显式权限参数时使用 Bypass。要进入 Default 审批模式：

```bash
peri --permission-mode default
```

也可以显式指定：

```bash
peri --permission-mode default
```

未知权限模式会回退到 Bypass。启动后检查状态栏显示，不要只根据启动命令推断最终模式。

非交互 `-p` 默认也是 Bypass，并会自动回应工具权限请求。当前 `--allowed-tools` 与 `--disallowed-tools` 在 print 路径没有应用，不能作为 CI 安全控制。

## 审批不是沙箱

即使使用 Default 或 AcceptEdit，工具最终仍以 Peri 进程的 OS 用户权限运行。高风险任务应同时使用：

- 临时容器或受限用户。
- 只挂载任务需要的目录。
- 最小网络访问。
- 外部 secret 注入和短期凭据。
- 可丢弃的 Git worktree 或明确快照。

## Settings 中的凭据

`apiKey` 与 `config.env` 以明文 JSON 保存。配置写入使用临时文件加 rename，但没有显式设置文件权限；权限依赖现有文件、umask 和平台。

类 Unix 系统可检查：

```bash
chmod 700 ~/.peri
chmod 600 ~/.peri/settings.json
```

工作区 `.peri/settings.json` 不应进入版本控制。公开日志、issue 或截图前删除 key、token、内网 endpoint 和真实路径。

## 安装信任边界

官方安装示例通过网络直接执行 `main` 分支脚本。发布工作流会生成 checksum，但当前 shell 与 PowerShell 安装器没有校验下载制品 checksum。

需要更严格审计时，先下载脚本和制品，检查内容与发布来源，再在隔离环境执行。安装成功不代表制品已经由本地 checksum 验证。

## Extensions

Hooks、MCP server、Skills 和 Plugins 会扩大可执行代码与数据访问面：

- 安装前查看来源与权限需求。
- MCP 配置更改后重启，再检查 `/mcp` 状态。
- Hook 中不要把完整工具输入发送到未知 HTTP endpoint。
- 第三方 skill 是给 Agent 的指令，不应自动获得超出当前任务的授权。

相关文档：[权限系统](/peri-cool/docs/features/permissions/) · [Settings 参考](/peri-cool/docs/reference/settings/) · [安装](/peri-cool/docs/get-started/installation/) · [非交互模式](/peri-cool/docs/guides/non-interactive/) · [MCP](/peri-cool/docs/features/mcp/)

Source: https://konghayao.github.io/peri-cool/docs/security/secrets-and-permissions/index.mdx