从打开窗口到跑通第一个会话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你让AI改完一个文件还得切回终端确认结果。Goose桌面应用把会话、食谱、扩展全部收进一个窗口输入任务它调用工具执行结果直接渲染在聊天流里。本文覆盖环境搭建、会话与Recipe这两项高频操作、三组进阶配置以及安装中容易踩的坑。项目速览Goose是一个可扩展的开源AI代理不只给代码建议还能直接安装依赖、执行命令、编辑文件、跑测试。桌面应用是它的图形外壳用Electron加React构建内部启动打包好的goose CLI二进制通过ACP协议与之通信你无需接触任何命令行。适合已经会用终端AI工具、想换成鼠标操作的用户也适合刚接触AI代理的新手。核心代码在ui/desktop/目录几个关键入口AppLayout.tsx整体布局与侧边栏导航骨架ChatInput.tsx消息输入、文件引用与发送RecipesView.tsx食谱列表、导入与创建入口ExtensionsView.tsx扩展MCP服务器安装与管理面板环境准备与安装运行环境从源码构建对依赖版本有硬性要求先对照一下项目要求操作系统Windows 10/11、macOS、LinuxDebian/Arch/FedoraNode.js^24.10.0见 package.json 的 engines 字段pnpm≥10.30.0Linux额外依赖dpkg、fakeroot磁盘空间预留1GB以上含Rust侧编译产物安装步骤普通用户推荐直接用官方发布页的预构建安装包Windows装.exemacOS拖.appLinux用.deb或.rpm。想从源码跑最简路径如下项目用Hermit管理依赖构建前先激活它git clone https://gitcode.com/GitHub_Trending/goose3/goose cd goose source ./bin/activate-hermit cd ui/desktop pnpm install pnpm run start-guistart-gui会自动构建SDK、编译国际化文案再启动窗口。备选是pnpm run start它走根目录的just run-ui任务需要本机装好just工具。完整构建细节含各平台打包参数在 ui/desktop/README.md。核心能力拆解开始第一个会话并管理多会话解决任务之间互相污染上下文的问题每个会话独立互不串味。打开应用在底部输入框ChatInput组件直接输入任务回车发送点左上角面板按钮展开侧边栏点Chat查看会话列表侧边栏保留最近10个会话点一下就回到那个上下文新开会话用快捷键macOS按CmdNWindows/Linux按CtrlN在当前目录或CtrlO指定目录点窗口底部的目录切换按钮把会话指向另一个工作目录运行Recipe固化重复流程解决每次都要重新写一遍提示词的问题把固定流程存成食谱以后填参数就能跑。侧边栏点Recipes进入食谱库浏览内置模板或导入自己的.yaml文件点目标食谱在参数弹窗RecipeParamsModal里填必填项点Run执行进度显示在会话顶部RecipeHeader.tsx 负责渲染当前跑到哪一步想自己写在食谱库点新建RecipeActivityEditor.tsx 提供活动编辑界面食谱的语法与存放位置见 storing-recipes.md。安装扩展接入外部工具解决AI够不到我的系统的问题通过MCP扩展把GitHub、日历、数据库等接进来。侧边栏点Extensions进入扩展面板搜索并点Install应用会自动配置对应的MCP服务器安装成功后在聊天中直接调用支持UI渲染的工具会把结果画在消息流里而不是干巴巴的文本状态异常时在该面板里重新连接或卸载重装具体排查看 ExtensionsView.tsx 对应的提示进阶配置与调优调整侧边栏样式与位置默认是Tile大图标网格、左侧、Push模式内容被推开。窗口较窄时把Style改成List更省地方习惯传统工具栏的可以把Position改到Top。入口侧边栏Settings→App标签 →Navigation区块详见 desktop-navigation.md。顺带一提List样式下窗口小于700px宽会自动折叠成纯图标。自定义键盘快捷键默认快捷键够用但不一定合手比如全局唤起CtrlAltShiftG偏冷门。进Settings→Keyboard标签逐项改。注意全局类快捷键即时生效应用内类新建聊天、打开设置需要重启应用。配置模型与提供商默认首次会话会引导你配置LLM提供商。进Settings→Providers支持Anthropic、OpenAI、Ollama、OpenRouter等。本地跑选Ollama指向localhost零成本且数据不出机器要更强能力再换云端API。模型在聊天底部控制条随时切换不用重新开会话。常见问题速查问题现象可能原因处理方式窗口白屏或启动报SDK错误pnpm install没触发postinstall构建SDK手动执行pnpm run build-goose-sdk后再启动Linux下pnpm run make打包失败缺dpkg、fakeroot系统依赖Ubuntu执行sudo apt install dpkg fakerootFedora执行sudo dnf install dpkg-dev fakeroot发送消息后卡在设置提供商未配置任何LLM提供商进Settings→Providers填API Key或OAuth登录会话列表看不到旧会话侧边栏只显示最近10个会话用搜索定位或定期清理不用的会话工具在错误目录里执行会话继承了上次的工作目录点底部目录切换按钮重新选择再发一条消息确认写在最后桌面应用把Goose从终端里敲命令变成了窗口里点鼠标会话、食谱、扩展三条主线都藏在这一个布局里装好就能上手日常任务。下一步建议先试跑一个内置Recipe感受自动化流程再翻一翻 guides目录 里的会话管理和上下文工程两篇。官方文档指南documentation/docs/guides/桌面应用源码与构建说明ui/desktop/会话管理详解documentation/docs/guides/sessions/session-management.md侧边栏自定义documentation/docs/guides/desktop-navigation.md【免费下载链接】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），仅供参考 从打开窗口到跑通第一个会话：Goose桌面应用安装与实操上手
从打开窗口到跑通第一个会话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你让AI改完一个文件还得切回终端确认结果。Goose桌面应用把会话、食谱、扩展全部收进一个窗口输入任务它调用工具执行结果直接渲染在聊天流里。本文覆盖环境搭建、会话与Recipe这两项高频操作、三组进阶配置以及安装中容易踩的坑。项目速览Goose是一个可扩展的开源AI代理不只给代码建议还能直接安装依赖、执行命令、编辑文件、跑测试。桌面应用是它的图形外壳用Electron加React构建内部启动打包好的goose CLI二进制通过ACP协议与之通信你无需接触任何命令行。适合已经会用终端AI工具、想换成鼠标操作的用户也适合刚接触AI代理的新手。核心代码在ui/desktop/目录几个关键入口AppLayout.tsx整体布局与侧边栏导航骨架ChatInput.tsx消息输入、文件引用与发送RecipesView.tsx食谱列表、导入与创建入口ExtensionsView.tsx扩展MCP服务器安装与管理面板环境准备与安装运行环境从源码构建对依赖版本有硬性要求先对照一下项目要求操作系统Windows 10/11、macOS、LinuxDebian/Arch/FedoraNode.js^24.10.0见 package.json 的 engines 字段pnpm≥10.30.0Linux额外依赖dpkg、fakeroot磁盘空间预留1GB以上含Rust侧编译产物安装步骤普通用户推荐直接用官方发布页的预构建安装包Windows装.exemacOS拖.appLinux用.deb或.rpm。想从源码跑最简路径如下项目用Hermit管理依赖构建前先激活它git clone https://gitcode.com/GitHub_Trending/goose3/goose cd goose source ./bin/activate-hermit cd ui/desktop pnpm install pnpm run start-guistart-gui会自动构建SDK、编译国际化文案再启动窗口。备选是pnpm run start它走根目录的just run-ui任务需要本机装好just工具。完整构建细节含各平台打包参数在 ui/desktop/README.md。核心能力拆解开始第一个会话并管理多会话解决任务之间互相污染上下文的问题每个会话独立互不串味。打开应用在底部输入框ChatInput组件直接输入任务回车发送点左上角面板按钮展开侧边栏点Chat查看会话列表侧边栏保留最近10个会话点一下就回到那个上下文新开会话用快捷键macOS按CmdNWindows/Linux按CtrlN在当前目录或CtrlO指定目录点窗口底部的目录切换按钮把会话指向另一个工作目录运行Recipe固化重复流程解决每次都要重新写一遍提示词的问题把固定流程存成食谱以后填参数就能跑。侧边栏点Recipes进入食谱库浏览内置模板或导入自己的.yaml文件点目标食谱在参数弹窗RecipeParamsModal里填必填项点Run执行进度显示在会话顶部RecipeHeader.tsx 负责渲染当前跑到哪一步想自己写在食谱库点新建RecipeActivityEditor.tsx 提供活动编辑界面食谱的语法与存放位置见 storing-recipes.md。安装扩展接入外部工具解决AI够不到我的系统的问题通过MCP扩展把GitHub、日历、数据库等接进来。侧边栏点Extensions进入扩展面板搜索并点Install应用会自动配置对应的MCP服务器安装成功后在聊天中直接调用支持UI渲染的工具会把结果画在消息流里而不是干巴巴的文本状态异常时在该面板里重新连接或卸载重装具体排查看 ExtensionsView.tsx 对应的提示进阶配置与调优调整侧边栏样式与位置默认是Tile大图标网格、左侧、Push模式内容被推开。窗口较窄时把Style改成List更省地方习惯传统工具栏的可以把Position改到Top。入口侧边栏Settings→App标签 →Navigation区块详见 desktop-navigation.md。顺带一提List样式下窗口小于700px宽会自动折叠成纯图标。自定义键盘快捷键默认快捷键够用但不一定合手比如全局唤起CtrlAltShiftG偏冷门。进Settings→Keyboard标签逐项改。注意全局类快捷键即时生效应用内类新建聊天、打开设置需要重启应用。配置模型与提供商默认首次会话会引导你配置LLM提供商。进Settings→Providers支持Anthropic、OpenAI、Ollama、OpenRouter等。本地跑选Ollama指向localhost零成本且数据不出机器要更强能力再换云端API。模型在聊天底部控制条随时切换不用重新开会话。常见问题速查问题现象可能原因处理方式窗口白屏或启动报SDK错误pnpm install没触发postinstall构建SDK手动执行pnpm run build-goose-sdk后再启动Linux下pnpm run make打包失败缺dpkg、fakeroot系统依赖Ubuntu执行sudo apt install dpkg fakerootFedora执行sudo dnf install dpkg-dev fakeroot发送消息后卡在设置提供商未配置任何LLM提供商进Settings→Providers填API Key或OAuth登录会话列表看不到旧会话侧边栏只显示最近10个会话用搜索定位或定期清理不用的会话工具在错误目录里执行会话继承了上次的工作目录点底部目录切换按钮重新选择再发一条消息确认写在最后桌面应用把Goose从终端里敲命令变成了窗口里点鼠标会话、食谱、扩展三条主线都藏在这一个布局里装好就能上手日常任务。下一步建议先试跑一个内置Recipe感受自动化流程再翻一翻 guides目录 里的会话管理和上下文工程两篇。官方文档指南documentation/docs/guides/桌面应用源码与构建说明ui/desktop/会话管理详解documentation/docs/guides/sessions/session-management.md侧边栏自定义documentation/docs/guides/desktop-navigation.md【免费下载链接】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），仅供参考