Linux 基金会托管的开源 Agent「goose」上手：桌面端 + CLI + API 三位一体，不锁模型

桌面版适合可视化操作，CLI 适合塞进脚本和 CI。两者共用同一份配置，装哪个都行。

【桌面版】
访问 goose-docs.ai 的安装页，下载对应平台的包：
· macOS      → Silicon / Intel 两个 zip，解压直接运行
· Windows    → zip 解压后运行可执行文件
· Linux      → DEB（Ubuntu/Debian）/ RPM（RHEL/Fedora）/ Flatpak

Debian 系示例：
sudo dpkg -i goose_*.deb

【命令行版】macOS / Linux 一条命令：
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash

验证安装：
goose --version

goose 不自带模型，第一次运行要告诉它「用谁家的脑子」。执行配置命令后会进入交互式菜单：

goose configure

菜单会依次问你：
1. Configure Providers（配置供应商）
2. 从列表里选一家：
   Anthropic / OpenAI / Google / Ollama /
   OpenRouter / Azure / Bedrock / ...（15+ 家）
3. 粘贴 API Key
4. 选择具体模型

之后想换供应商：
goose configure --provider

goose session

进入交互界面后，直接用自然语言连续下指令：

> 帮我写一个读取 CSV 并输出统计摘要的 Python 脚本
> 给它加上 argparse，让文件路径能从命令行传入
> 执行看看，用 sample.csv 测试

goose 会自动规划 → 写文件 → 执行 → 把结果回报给你。
常用命令：
goose session          # 启动交互式会话
goose run              # 直接运行一个 Recipe
goose configure        # 重新配置

这是 goose 最被低估的能力：它能和 Ollama 无缝集成，让整条链路完全本地化，代码和数据一个字节都不上传云端。

# 1. 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 2. 拉一个支持工具调用的模型（关键！）
ollama pull qwen2.5:7b-instruct

# 3. 启动服务，把上下文开大一点
OLLAMA_CONTEXT_LENGTH=32768 ollama serve

# 4. 让 goose 指向本地
export GOOSE_PROVIDER=ollama
export GOOSE_MODEL=qwen2.5:7b-instruct
export OLLAMA_HOST=http://localhost:11434

goose

goose 是 MCP（Model Context Protocol）生态集成最深的项目之一，官方与社区已有 70+ 文档化扩展：文件系统、数据库查询、API 调用、Git 操作等。自己写一个也很简单：

# my_tools_server.py —— 一个最小的 Python MCP 服务器
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-tools")

@mcp.tool()
def query_database(sql: str) -> dict:
    """执行 SQL 查询"""
    return {"result": [...]}

if __name__ == "__main__":
    mcp.run()

写完注册进去即可：

goose extension add ./my_tools_server.py

如果某个任务你每周都要跑一遍（比如「拉最新数据 → 清洗 → 出周报」），别每次都重新打一遍提示词。goose 的 Recipe 就是把这套流程存成可复用的配方：

# 运行一个 Recipe
goose run --recipe weekly-report.yaml

# 仓库里的 workflow_recipes/ 目录有官方示例可以抄
# Recipe 里通常包含：
#   - 任务目标描述
#   - 需要挂载的扩展
#   - 参数占位符
#   - 期望的产出格式

goose 支持 ACP（Agent Client Protocol）——一个与编程 Agent 通信的标准。这带来两个方向的能力：

方向一：goose 作为 ACP server 被 IDE 连接
  Zed / JetBrains / VS Code → 连上 goose
  在编辑器里直接调用 goose 的能力

方向二：goose 把别的 Agent 当成 provider
  Claude Code、Codex 等 ACP agent
  → 挂到 goose 底下作为执行后端