使用 Ferret
项目与 URL
项目就是一个文件夹（通常是仓库的根目录）。每个项目都保存自己的 URL，因此本地、开发和生产环境只需一次点击即可切换。
#添加项目
- 使用 文件 → 打开项目文件夹…（⌘O / CtrlO）、侧边栏中的 添加项目，或标题栏项目菜单中的 添加项目…。
- 选择项目的来源：
- 在这台电脑上：选择一个文件夹。
- 从 GitHub / GitLab 克隆：从你的仓库中选择一个（通过你的
gh或glab登录列出），或粘贴 URL，再选择父文件夹，Ferret 会克隆并打开它。 - 通过 SSH 打开：从
~/.ssh/config中选择一个主机。终端和 Agent 在远程机器上运行；审查保存在这台电脑上。
名称默认是文件夹名。添加一个已登记的文件夹时，会直接打开它（在 macOS 和 Windows 上，路径比较不区分大小写）。在侧边栏菜单中可以对项目执行 重命名 或 从列表中移除。移除绝不会删除文件夹。
终端在项目文件夹中打开，审查保存在 <project>/.ferret/ 下。
#保存 URL
- 在内置浏览器中打开页面。
- 点击浏览器工具栏中的 +（保存当前 URL）。当前 URL 会预先填好。
- 输入 名称，然后点击 保存。
只接受 http:// 和 https:// URL。如果保留建议的名称，它会根据主机推断：
| 主机 | 名称 |
|---|---|
localhost、127.*、::1、0.0.0.0、*.localhost | local |
包含 dev、develop、development | dev |
包含 stg、stage、staging | stg |
| 其他任何主机 | prd |
#审查对象面板
在反馈模式下，右侧的 审查对象 面板会列出当前项目中所有可以审查的内容。切换对象不会停止录制。可以用 显示 → 显示 / 隐藏审查对象（⌘⇧K / CtrlShiftK）或 隐藏面板 来切换面板。
- 目标：项目中保存的 URL。每个 URL 下方是你在该站点访问过的页面树。访问过但未保存的站点会作为单独的分组显示。
- 文件：项目文件夹。文件以预览方式打开（渲染 Markdown 和 Mermaid，其他文本为只读），因此也可以审查文档。铅笔图标（在编辑器中打开）会在编辑器中打开它。
筛选对象 会同时筛选目标、页面和文件，模糊匹配方式与 转到文件… 相同。在列表中，按 ↑ ↓ Enter 或 1–9 切换对象。打开 URL… 用于临时打开一个 URL，保存到项目 URL 会把它保存下来。
目标来自 settings.json 中的 projects[].urls（参见示例）。每个条目需要一个 url、一个 launchCommand（在终端中运行，例如用来启动桌面应用）或一个 windowMatch（要录制的窗口）。选择窗口类目标会把它设为录制来源，因此录制过程中无法这样做。访问过的页面按项目记住，仅保存在这台机器上（最多 200 个）。
#打开和切换环境
点击保存的 URL 即可打开。如果当前页面位于另一个已保存的 URL 下，Ferret 会保留路径、查询参数和哈希，只替换源（origin）。例如在 http://localhost:3000/pricing?plan=pro 上点击 prd，会打开 https://example.com/pricing?plan=pro。
与当前页面匹配（最长前缀）的标签会高亮显示。右键点击标签或使用其铅笔图标，可以编辑或 删除 它。项目打开时如果没有上次的 URL，会载入它的第一个已保存 URL。