Sightflow Agent
Apps & Automationsightflow_agentSightflow Agent is an Agent Skill for apps & automation published in the sightflow-dev/sightflow-desktop-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
控制 SightFlow 桌面智能体的启动、暂停和状态查询。 当用户需要启动 / 暂停 SightFlow 消息自动回复智能体,或查询其运行状态时使用此 skill。 智能体应用需要提前启动并保持运行。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sightflow-dev/sightflow-desktop-agent/blob/HEAD/skills/sightflow-agent/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/sightflow-agent, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
SightFlow Agent 控制 Skill
本 skill 通过本地 HTTP API 控制 SightFlow 桌面智能体。API 仅监听 127.0.0.1:12680。
前置条件
- SightFlow 桌面客户端必须已经启动并运行
- 已在「设置」中填写视觉接口密钥 (Vision API Key)
- 已安装并配置好聊天 Provider(如火山方舟)
API 端点
查询状态
curl -s http://127.0.0.1:12680/skill/status
响应:
{ "ok": true, "status": "running" }— 智能体正在运行{ "ok": true, "status": "stopped" }— 智能体已停止
启动智能体
curl -s -X POST http://127.0.0.1:12680/skill/start
响应:
{ "ok": true }— 启动成功{ "ok": false, "error": "<error_code>", "message": "<details>" }— 启动失败
错误码:
| error_code | 含义 |
|---|---|
no_vision_key | 未配置视觉接口密钥,请先在设置中填写 |
no_provider | 未安装聊天 Provider,请先安装 |
missing_required_field | Provider 必填配置缺失(如 apiKey) |
engine_failed | 引擎启动失败 |
already_running | 智能体已在运行中 |
operation_in_progress | 有其他启动 / 暂停操作正在执行 |
暂停智能体
curl -s -X POST http://127.0.0.1:12680/skill/pause
响应:
{ "ok": true }— 暂停成功{ "ok": false, "error": "<error_code>", "message": "<details>" }— 暂停失败
错误码:
| error_code | 含义 |
|---|---|
not_running | 智能体未在运行 |
operation_in_progress | 有其他启动 / 暂停操作正在执行 |
pause_failed | 内部停止流程异常 |
使用流程
- 先查询状态确认应用是否在线:调用
GET /skill/status - 根据需要调用
POST /skill/start或POST /skill/pause - 操作后再次查询状态确认结果
注意事项
- 所有请求都是本地请求(127.0.0.1),无需网络
- 启动 / 暂停操作有并发保护,同一时间只能执行一个操作
- 远程启动 / 暂停后,桌面客户端 UI 会同步切换到对应状态
- 如果返回
no_vision_key/no_provider/missing_required_field,需要用户在桌面客户端「设置」中补全配置 - 端口 12680 如果被占用,应用会 fallback 到 12681