Buzz 本地转录指南：三步把语音变文字，离线生成字幕
2026/9/7 7:30:38
8分钟跑通goose：从零到第一次会话的完整路径
【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose
你刚敲完终端里的安装命令，现在要让 goose 这个开源 AI agent 在 8 分钟内跑通第一次会话。它在你本机写代码、执行测试、还能自己开浏览器，接 15+ LLM 提供商，挂 70+ MCP 扩展。全文只要 3 条命令：装、配、开会话。
读完你能做到：
- 在 macOS / Linux / Windows 装好 goose CLI
- 用 1 把密钥接通 15+ 提供商，或本地 Ollama
- 1 个会话写出一个能下的五子棋
- 用
goose configure挂上 Computer Controller 扩展 - 让 goose 自己打开浏览器玩它写的游戏
清单在手，下面先花 1 分钟核对环境。
📋 预检清单：装前核对这 5 项
| 检查项 | 你的状态 | 不满足时 |
|---|---|---|
| 系统 | macOS / Linux / Windows | Windows 选 Git Bash，见主路径提示 |
| 下载工具 | curl + tar（Windows Git Bash 自带） | sudo apt install -y curl tar |
| 网络 | 能下载 release 包 | 挂代理或换网络 |
| 模型凭证 | 提供商 API 密钥 / Ollama 本地，任一即可 | 先申请密钥，或本地装 Ollama |
| 全部满足 | → 跳过本节，直接进主路径 |
都打勾了，进主路径装 CLI。
🔧 主路径：三步装通 goose 并跑通会话
第一步 装好 CLI
输入：无，打开终端即可。
执行：
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash # 下载最新稳定版，装到 ~/.local/bin，自动进入配置界面确认：看到goose-configure交互菜单，再跑两条验证：
goose --version # 打印版本号，如 v1.2.3 which goose # 输出 ~/.local/bin/goose两条都有输出，装通。以后更新跑goose update一条命令。
⚠️ Windows：Git Bash（Git for Windows 自带）里直接跑上面同一条 curl 命令。偏好 PowerShell 就从仓库根目录取 download_cli.ps1 本地执行。
⚠️ CI 脚本不想被交互卡住，安装命令末尾加
CONFIGURE=false跳过配置。
备选路径一句话带过：Desktop 版与 CLI 共享同一份配置，macOS 跑brew install --cask block-goose，Linux 跑sudo dpkg -i goose-desktop_*.deb，Windows 解压 zip 双击goose.exe。
装好了，配置界面已经自动弹出——下一步就是配通密钥。
第二步 配通 API 密钥
输入：菜单路径Configure Providers → 选提供商 → 粘密钥 → 选模型。
执行（安装后自动进入，或手动补跑）：
goose configure # 进入 goose-configure 交互菜单确认：看到Configuration saved successfully即配通。
没有 API 密钥的情况，按这张图选分支：
环境变量方式效果等价：export OPENAI_API_KEY=你的密钥。全部提供商列表见提供商配置。
密钥配通，会话就能开了——第三步进空目录开工。
第三步 开第一个会话
输入：一个空的工作目录。
执行：
mkdir goose-demo && cd goose-demo goose session # 进入会话界面，出现对话输入框确认：输入"介绍一下你自己"，goose 给出完整回复，会话成立。
会话是一段与 goose 的持续对话。装没装好先过一遍体检，再上真任务。
🩺 体检：对照这张表排除安装故障
卡住了别慌，按症状对表开方：
| 症状 | 病因 | 处方 |
|---|---|---|
goose: command not found | ~/.local/bin不在 PATH | echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc |
下载时报bzip2: (unknown member) | 缺 bzip2 解压工具 | sudo apt update && sudo apt install -y bzip2，再重跑安装命令 |
| Windows 存密钥报 keyring 错误 | 系统钥匙串不可用 | 配置时选"不存入 keyring"，改用export OPENAI_API_KEY=密钥 |
| macOS 桌面版点开没窗口 | ~/.config无读写权限 | 给~/.config读写权限，参考已知问题 |
| 无异常 | 安装配置全部正常 | 无需操作 |
四项都过了，直接去写第一个真东西。
🎮 第一个真实任务：让 goose 写一个五子棋
进goose-demo目录，goose session开会话，像跟同事派活一样输入：
写一个能在浏览器玩的五子棋，单文件 HTML，我跟电脑对战它会先给一份计划，然后自己写文件。做对了的样子：goose-demo里多出 HTML 与 JS 两个文件，浏览器打开 HTML，人机对战直接能下。
想让 goose 替你开浏览器？goose configure→Add Extension→Built-in Extension→Computer Controller，装完goose session -r恢复会话，对它说"在浏览器里打开五子棋"，它会自己打开。70+ 外部工具走同一套 MCP 协议接入，完整清单去使用扩展翻一遍。
🚀 下一步三选
- 管理会话与上下文：CLI 命令参考
- 接入外部工具：使用扩展
- 读提供商实现：goose-providers 源码
【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考