文件访问与管理

作为一个自治 agent，goose 会按照你给出的指令去执行任务。这通常意味着它既要找到正确的本地文件，也要安全地对这些文件进行修改。

本指南介绍如何在 goose 中高效访问和引用文件，也总结了安全文件操作的关键最佳实践，例如监控变更、必要时回滚修改，以及如何尽量保持代码库稳定。

文件访问

goose Desktop 内置了模糊文件搜索能力，你可以直接在聊天界面中引用文件，而不必手动打开文件系统选择器。这样能更快地把相关文件加入消息，提供给 goose 作为上下文。

在聊天输入框中输入 @，打开文件搜索框
继续输入内容，以大小写不敏感的模糊匹配方式筛选文件（例如 @readme、@config.js、@src/main）

浏览结果：
- 用方向键（↑/↓）在结果间切换
- 点击某个结果，或按 Enter，把该文件路径插入到消息中
完成后，直接发送消息给 goose 即可

info

如果你想关闭搜索框而不选择文件，可以按 Esc，或者直接点击聊天输入框。

智能特性：

模糊匹配：支持部分文本智能匹配，并优先命中单词边界附近的结果
高亮结果：会在搜索结果中高亮命中的字符
性能优化：默认只扫描最多 5 层目录，并带有智能过滤
自动过滤：自动忽略 .git、node_modules、__pycache__、target、dist、build 等常见目录
隐藏目录支持：会包含 .github、.vscode、.idea、.config 等重要配置目录，以及其他 CI/CD 目录（如 .circleci、.gitlab、.azure、.jenkins）
跨平台支持：在 macOS 上从 /Users、Windows 上从 C:\Users、Linux 上从 /home 开始搜索
视觉区分：会用清晰图标区分文件与目录

始终使用 Git 这类版本控制系统来跟踪代码库改动。这可以避免误覆盖，也能让你随时回退到之前状态。建议在让 goose 操作代码库之前先提交当前改动，并通过分支把实验性改动与主线分开。

在 goose 修改文件前后都加入验证和测试步骤。运行单元测试，确认 goose 的改动没有破坏行为；必要时使用 staging 环境确认改动能够与整个系统协同工作。

无论是手工 review 还是自动化 code review，都应该用于检查 goose 生成的代码和变更质量。结合 diff 工具查看差异，并把团队 review 或 CI/CD 流程纳入这一步。

把代码库拆分成边界清晰的模块或子目录，会更利于 goose 高效工作。模块化结构可以帮助你把 goose 的访问范围限定在必要区域内，也方便你显式指定哪些目录或文件才是本次任务的处理对象。