gspark-agent

面向 AI Agent 的 G-spark / HUB 接入工具：CLI + MCP，共用同一套 /v1 客户端。

安装（仅首次）

pipx install "gspark-agent[mcp]"
gspark setup          # 【必做】向用户索取 sk_，写入 ~/.gspark/credentials.env
# 可选：gspark agent-guide   # 读一次说明书即可；站点最新版用 --pull

开发（本仓库）：

pip install "./packages/gspark-agent[mcp]"

给 Agent：默认直接跑业务命令；缺 gspark 时 优先在终端自装一次，已装禁止重装；Skill「复制给 Agent」以 skills show 为主；勿每个任务重复 pipx install / 搜源码 / 重跑 agent-guide。

配置

推荐：

gspark setup
# 或非交互：
gspark setup --api-key sk_xxxx --base-url https://www.g-spark.cn

也可手动环境变量：

export GSPARK_API_KEY=sk_xxxx
export GSPARK_BASE_URL=https://www.g-spark.cn   # 兼容 api.g-spark.cn；或其他节点如 https://api.hqszh.com

兼容别名：HUB_API_KEY、HUB_BASE_URL。CLI 还会自动读取 ~/.gspark/credentials.env 与当前目录 .env。

CLI

# 日常
gspark apps list --json
gspark apps show video_01 --json
gspark skills show <skill_code> --json
gspark tasks estimate --app video_01 --input prompt="hello" --json
gspark tasks run --app video_01 --input prompt="hello" --wait --json
gspark tasks get <task_id> --json
gspark chat models --json
gspark chat ask -m gpt-5-mini "你好" --json
# Python / MCP 可传 tools、tool_choice、多模态 messages（见 docs/LLM-GATEWAY.md）
gspark account balance --json
gspark account ledger --page 1 --size 20 --json

# 仅首次 / 排障
gspark setup
gspark agent-guide
gspark agent-guide --pull

• --json：紧凑单行 JSON（便于 Agent / 管道）
• 默认：缩进 JSON；account ledger 默认为表格

--input 支持 JSON 数组/对象，例如：--input tags='["a","b"]'、--input meta='{"k":1}'。

MCP（Cursor）

见 agent_pack/mcp-config.example.json；控制台「Agent专属」页可下载完整接入包。

gspark-mcp