本地自动化 API
在侧栏打开“自动化 API”，点击“启动本地 API”。Prism 会显示 API 地址（127.0.0.1 上的随机端口）和本次访问令牌；令牌只显示一次，停止 API 后作废。
| 请求 | 作用 |
|---|---|
| GET /v1/status | 服务状态 |
| GET /v1/profiles | 列出环境：编号、名称、分组、标签、状态、最近打开时间 |
| GET /v1/profiles/{id}/status | 查询单个环境状态 |
| POST /v1/profiles/{id}/start | 启动环境，与界面相同的代理预检与并发限制 |
| POST /v1/profiles/{id}/close | 关闭环境 |
| POST /v1/profiles | 创建一个环境，可设置名称、分组、代理和指纹（0.3.22 起） |
| POST /v1/profiles/batch | 一次创建 1–50 个环境，全部校验通过才保存（0.3.22 起） |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- 只接受来自本机的请求：Host 必须与 API 地址一致，带浏览器 Origin 头或查询参数的请求会被拒绝（只有创建接口接受 JSON 请求体），网页无法直接调用。
- 每分钟最多 120 个请求（与 MCP 本地桥共用）。
- API 可以创建、查询、启动和关闭环境，不能修改或删除环境，也不能读取浏览器数据；API 本身不提供 Puppeteer / Playwright 调试端点（Windows 版为内部控制在 127.0.0.1 上开启随机调试端口，这不是公开接口）。
- “紧急停止”会关闭由 API 启动的环境；调用记录写入本机审计日志。
请求规则、返回字段、错误码和 Python / Node.js 示例见本地 API 文档。
本地计划任务
| 设置 | 可选值 |
|---|---|
| 执行动作 | 启动环境 / 关闭环境 |
| 重复方式 | 仅一次 / 每天 / 每周（可多选周日至周六） |
| 执行时间 | 本机时间与时区 |
| 错过任务 | 24 小时内补执行一次 / 跳过本次 |
| 失败重试 | 0–3 次，重试间隔 1–60 分钟 |
- 计划任务只在 Prism 运行时执行，没有后台常驻进程；每 15 秒检查一次到期任务，最多同时执行 2 个。
- 可以“立即运行”测试任务；被计划任务引用的环境需要先解除任务才能删除。
- Pro 授权失效时暂停调度，任务保留，可继续停用或删除。
组合使用示例
上班自动开好工作环境
每天 09:00 启动常用环境，下班前关闭，减少手动操作和误开。
脚本批量启停
在自己的脚本里先调用 GET /v1/profiles 找到环境 ID，再按顺序启动，启动逻辑与界面一致。
交给 AI 继续
环境启动后，由 MCP 在你授权的环境里读取页面、完成后续步骤。
常见问题
- 可以运行自定义脚本或 RPA 流程吗？
- 计划任务只支持启动和关闭环境，API 也不执行脚本。需要页面级操作时，可使用 Pro 的 MCP 或自行在环境中安装扩展。
- 兼容其他指纹浏览器的 API 吗？
- 不兼容。Prism 使用自己的本地接口，路径见上表。
- 关闭 Prism 后计划任务还会执行吗？
- 不会。计划任务依赖 Prism 运行；错过的任务可按设置在 24 小时内补执行一次。