File contents 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_fieldProvider 必填配置缺失（如 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
Source: sightflow-dev/sightflow-desktop-agent — distributed by TomeVault .
1 --- 2 name: sightflow-dev-sightflow-desktop-agent-sightflow-desktop-agen 3 description: SightFlow Agent 控制 Skill 4 --- 5 6 # SightFlow Agent 控制 Skill 7 8 本 skill 通过本地 HTTP API 控制 SightFlow 桌面智能体。API 仅监听 `127.0.0.1:12680`。 9 10 ## 前置条件 11 12 - SightFlow 桌面客户端必须已经启动并运行 13 - 已在「设置」中填写视觉接口密钥 (Vision API Key) 14 - 已安装并配置好聊天 Provider（如火山方舟） 15 16 ## API 端点 17 18 ### 查询状态 19 20 ```bash 21 curl -s http://127.0.0.1:12680/skill/status 22 ``` 23 24 **响应：** 25 - `{ "ok": true, "status": "running" }` — 智能体正在运行 26 - `{ "ok": true, "status": "stopped" }` — 智能体已停止 27 28 ### 启动智能体 29 30 ```bash 31 curl -s -X POST http://127.0.0.1:12680/skill/start 32 ``` 33 34 **响应：** 35 - `{ "ok": true }` — 启动成功 36 - `{ "ok": false, "error": "<error_code>", "message": "<details>" }` — 启动失败 37 38 **错误码：** 39 | error_code | 含义 | 40 |---|---| 41 | `no_vision_key` | 未配置视觉接口密钥，请先在设置中填写 | 42 | `no_provider` | 未安装聊天 Provider，请先安装 | 43 | `missing_required_field` | Provider 必填配置缺失（如 apiKey） | 44 | `engine_failed` | 引擎启动失败 | 45 | `already_running` | 智能体已在运行中 | 46 | `operation_in_progress` | 有其他启动 / 暂停操作正在执行 | 47 48 ### 暂停智能体 49 50 ```bash 51 curl -s -X POST http://127.0.0.1:12680/skill/pause 52 ``` 53 54 **响应：** 55 - `{ "ok": true }` — 暂停成功 56 - `{ "ok": false, "error": "<error_code>", "message": "<details>" }` — 暂停失败 57 58 **错误码：** 59 | error_code | 含义 | 60 |---|---| 61 | `not_running` | 智能体未在运行 | 62 | `operation_in_progress` | 有其他启动 / 暂停操作正在执行 | 63 | `pause_failed` | 内部停止流程异常 | 64 65 ## 使用流程 66 67 1. **先查询状态**确认应用是否在线：调用 `GET /skill/status` 68 2. 根据需要调用 `POST /skill/start` 或 `POST /skill/pause` 69 3. 操作后再次查询状态确认结果 70 71 ## 注意事项 72 73 - 所有请求都是本地请求（127.0.0.1），无需网络 74 - 启动 / 暂停操作有并发保护，同一时间只能执行一个操作 75 - 远程启动 / 暂停后，桌面客户端 UI 会同步切换到对应状态 76 - 如果返回 `no_vision_key` / `no_provider` / `missing_required_field`，需要用户在桌面客户端「设置」中补全配置 77 - 端口 12680 如果被占用，应用会 fallback 到 12681 78 79 --- 80 > Source: [sightflow-dev/sightflow-desktop-agent](https://github.com/sightflow-dev/sightflow-desktop-agent) — distributed by [TomeVault](https://tomevault.io). 81 <!-- tomevault:4.0:skill_md:2026-07-02 -->
commit 1f8b985af2
Frequently asked questions How do I install the Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent skill? Run npx skillmds@latest add tomevault-io/sightflow-dev-sightflow-desktop-agent-sightflow-desktop-agen in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent skill do? SightFlow Agent 控制 Skill It is listed under AI & ML on SkillMD.
Is Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent? tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io