# Native Agent

可选本地伴随进程，用于扩展沙箱做不到的能力：

- `fs.read` / `fs.write` / `fs.list`
- `fs.stat` / `fs.search` / `fs.copy` / `fs.move` / `fs.delete`
- `shell.exec`，默认只允许 `pwd, ls, date, git, node, python3, npm, npx, pnpm`
- `project.generate`，一次性生成多文件前端项目
- `cloudflare.pages.deploy`，把 HTML 交付物通过 Wrangler 发布到 Cloudflare Pages
- `skill.list` / `skill.read` / `skill.write` / `skill.validate` / `skill.evaluate` / `skill.benchmark` / `skill.scaffold`
- `checkpoint.create` / `checkpoint.list` / `checkpoint.read` / `checkpoint.restore`，为本地文件改动创建和恢复回滚点
- `clipboard.read` / `clipboard.write`
- `notify.send`

## macOS 安装

1. 在 Chrome 扩展管理页加载本项目为“已解压的扩展程序”。
2. 复制扩展 ID。
3. 运行：

```bash
cd native_agent
./install_macos.sh <chrome-extension-id>
```

如需调整 shell 白名单，启动 Chrome 前设置：

```bash
export AI_PM_AGENT_SHELL_ALLOWLIST="pwd,ls,date,git,node,python3"
```

生成前端工程并希望自动安装或构建时，需要把 npm / pnpm 放进白名单：

```bash
export AI_PM_AGENT_SHELL_ALLOWLIST="pwd,ls,date,git,node,python3,npm,npx,pnpm"
```

发布到 Cloudflare Pages 前，需要先完成一次 Cloudflare 登录或配置 Token：

```bash
npx wrangler login
# 或
export CLOUDFLARE_API_TOKEN="..."
export CLOUDFLARE_ACCOUNT_ID="..."
```
