本地服务 API
本地服务 API 总览
对外 HTTP 接口，面向外部程序接入、调试和联调。
服务定位
- 这是运行在本机的 HTTP 服务，默认地址是
http://127.0.0.1:18081。 - 当前主要面向本机程序、PowerShell、Python、Agent 和外部自动化工具接入。
- 当前明确不做跨请求共享状态，不能指望服务记住上一请求里的当前草稿或当前变量。
启动与地址
最常用启动命令：
python tools\local_service\run\run_local_service.py --host 127.0.0.1 --port 18081启动后先探活：
curl.exe http://127.0.0.1:18081/health开放端点
| 方法 | 路径 | 用途 | 适合场景 |
|---|---|---|---|
| GET | /health | 探活 | 服务是否启动 |
| GET | /actions | 读取动作摘要列表 | 先筛选候选动作 |
| GET | /action-flows | 读取动作流目录清单 | 先看有哪些现成动作流 |
| GET | /actions/info | 读取单个动作完整契约 | 参数不确定时先查详情 |
| GET | /action-flows/info | 读取单个动作流说明 | 执行前先看用途和参数 |
| POST | /actions/run | 执行单个动作指令 | 原子动作、简单调用 |
| POST | /action-flows/run | 执行结构化动作流 | 程序化接入、复杂流程 |
怎么选入口
- 只做一件事：优先
/actions/run。 - 要执行多步结构化内容：改用
/action-flows/run。 - 参数不确定时：先调
/actions/info看完整契约。 - 如果本地服务已经配置了动作流目录，并且想直接复用现成动作流：先调
/action-flows和/action-flows/info，再通过/action-flows/run的script_path模式执行。 - 调用方本身更像程序拼 JSON：优先
/action-flows/run。 - 调用方更像复用现成动作流文件：优先
/action-flows/run的script_path模式。