SuperAPI AI 工具集

desktop-api

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:该技能让测试通过 Hive Desktop 暴露的环回 MCP 服务器(而非直接读 desktop-pipeline.db)观测通知流水线,并触发重轮询,从而在受支持的表面上做断言。常与 devserver 技能配合:devserver 负责动作(改写 GitHub、推送 webhook),本技能负责观测与重载。

主要能力:同一环回 HTTP 端口同时提供 webhook 推送(/hooks/…)、MCP 服务器(/mcp)和存活探测(/api/status)。工具包括 list_profiles、get_flow、list_inbox、list_feeds、list_inbox_item_events、list_item_sessions、refresh_sources、execute_flow、list_actions 等。其中 get_flow 是节点 id 的来源;execute_flow 可在不部署、不提交的情况下用给定输入试跑流程,返回各节点输入输出、console 与错误;list_actions/list_profiles 回读配置加载状态,valid 表示编辑被接受。

使用方式:端口写在 worktree 的 launch.env 中,可 grep HIVE_DESKTOP_HTTP_PORT 得到。存活探测为 GET /api/status 与 /api/version。MCP 端点为 http://$API/mcp,Streamable HTTP、无认证(环回绑定)。推荐用真实 MCP 客户端,如 claude mcp add --transport http hive-desktop "http://$API/mcp";也可用单条 curl 调用 tools/list 与 tools/call。典型循环为 refresh_sources → 读取 → 重试,因为服务端不等待,refresh_sources 返回后流引擎稍后才提交。webhook 推送直接追加,无需 refresh。list_inbox 默认 detail: "summary",payload 需显式请求 full,应先按 feed、externalId 或 limit 收窄再取 full。execute_flow 支持 flowId、nodeId、messages、flowYaml/flow 及 kv 种子,detail 可用 emitted(默认)、counts、full 控制响应大小。

适用场景与限制:适用于对通知流水线做断言、调试流程节点、验证配置是否加载、免部署试跑流程。限制:需要 HTTP 服务器开启(默认开启,http.enabled: false 时不可用);refresh_sources 只重轮询 sources.github,对 webhook feed 无效,mock 模式返回 unavailable;工具仅提供读取、重载与安全变更,不含会话控制(启动会话属命令执行,位于 /api/terminal/);失败工具以结果而非错误返回,需检查 .result.isError 与 content[].text 中的 kind;external_id 与 repo#num 不同,应按 payload 过滤;缺失对象返回 not_found;dry run 不覆盖真实提交的两项行为——为新 key 创建 inbox 行、删除快照不再列出的 feed 行,需在真实 refresh 后通过 inbox 断言。