# Sightflow Dev Sightflow Desktop Agent Sightflow Desktop Agent

> SightFlow Agent 控制 Skill

- Skill: `tomevault-io/sightflow-dev-sightflow-desktop-agent-sightflow-desktop-agen` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sightflow-dev-sightflow-desktop-agent-sightflow-desktop-agen`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sightflow-dev-sightflow-desktop-agent-sightflow-desktop-agen/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sightflow-dev-sightflow-desktop-agent-sightflow-desktop-agen

---


# SightFlow Agent 控制 Skill

本 skill 通过本地 HTTP API 控制 SightFlow 桌面智能体。API 仅监听 `127.0.0.1:12680`。

## 前置条件

- SightFlow 桌面客户端必须已经启动并运行
- 已在「设置」中填写视觉接口密钥 (Vision API Key)
- 已安装并配置好聊天 Provider（如火山方舟）

## API 端点

### 查询状态

```bash
curl -s http://127.0.0.1:12680/skill/status
```

**响应：**
- `{ "ok": true, "status": "running" }` — 智能体正在运行
- `{ "ok": true, "status": "stopped" }` — 智能体已停止

### 启动智能体

```bash
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` | 有其他启动 / 暂停操作正在执行 |

### 暂停智能体

```bash
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` | 内部停止流程异常 |

## 使用流程

1. **先查询状态**确认应用是否在线：调用 `GET /skill/status`
2. 根据需要调用 `POST /skill/start` 或 `POST /skill/pause`
3. 操作后再次查询状态确认结果

## 注意事项

- 所有请求都是本地请求（127.0.0.1），无需网络
- 启动 / 暂停操作有并发保护，同一时间只能执行一个操作
- 远程启动 / 暂停后，桌面客户端 UI 会同步切换到对应状态
- 如果返回 `no_vision_key` / `no_provider` / `missing_required_field`，需要用户在桌面客户端「设置」中补全配置
- 端口 12680 如果被占用，应用会 fallback 到 12681

---
> Source: [sightflow-dev/sightflow-desktop-agent](https://github.com/sightflow-dev/sightflow-desktop-agent) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-02 -->