接入前必读

服务地址

客户端启动时会在 9000~30000 之间选择一个可用端口监听，不是固定 9000。请以客户端界面显示的实际端口为准。

监听地址为 0.0.0.0，同一局域网内的其他机器也可以访问。

下文所有示例中的 http://localhost:9000 仅为示意，请替换为实际端口。

所有接口都必须在请求头携带 api-key：

api-key: 你的密钥

api-key 是客户端首次启动时生成并持久化的 32 位随机字符串，可在客户端设置中查看。它相当于本机 API 的访问口令，请勿写入代码仓库或公开文档。

服务端会做两层校验：

层级	校验内容	失败返回
1	请求头 `api-key` 必须与客户端生成的一致	401 `{"success":false,"error":"Unauthorized: Invalid API key"}`
2	VIP 能力租约（`local_api`）必须有效	403 `{"success":false,"error":"VIP capability lease is missing or expired"}`

涉及环境数据（cookie、账号、缓存、数据目录）的接口，请先关闭环境，否则文件被占用会返回 500。

写操作有并发队列，批量创建/更新时请控制并发，遇到 429 加重试退避。

环境 ID 是唯一稳定标识；用 name / remark 定位时要求全局唯一，匹配到多个会返回 400。