安装 Yenpo，打开第一个仓库

不连接模型也能用 Yenpo 读代码：浏览文件、搜索和语言服务导航都在本地完成。等你想就代码向 AI Reader 提问时，再配置模型服务商。

确认 Mac 是否支持

当前早期预览版同时支持 Apple silicon 和 Intel 芯片的 Mac，系统需要 macOS 14 或更新版本，两种 Mac 下载同一个安装包即可。系统版本可以在“关于本机”里查看。

每个预览版安装包都有固定的到期日期，显示在下载按钮旁边。日期在打包时就定了，晚点下载或重新安装都不会延后。请在到期前换成新版本。

安装

1. 从首页下载 .dmg 文件。
2. 打开磁盘映像，把 Yenpo 拖进“应用程序”文件夹。
3. 从“应用程序”启动 Yenpo，然后推出磁盘映像。

核对安装的版本

在菜单栏选择 Yenpo → 关于 Yenpo，把版本号与下载按钮旁边的版本对照。这个窗口也会显示当前安装包的 EAP 到期时间，按 Mac 的本地时区显示；网站上的日期使用 UTC。

如果刚更新完，看到的却还是旧版本，先退出 Yenpo，再从“应用程序”打开。替换步骤见在预览版到期前更新。

打开项目

打开要读的项目文件夹，最好选仓库根目录，也就是放着 README、构建文件和 .git 的那一层。只打开某个子目录的话，仓库里其他位置的测试和配置就不在项目里了。

按 Command-P（找文件…），输入文件名或路径的一部分，打开一个你认识的文件。README 或相关测试可以开在另一个标签页里。要读另一个项目，就在新窗口里打开它。

确定存在的文件却找不到？先确认它在你打开的文件夹里，再看看是不是隐藏文件或被 Git 忽略的文件没有显示。详见查找文件、跟随符号。

先做一个小任务

挑一个结果容易核对的任务，比如找到某个配置项在哪里被读取：

1. 用全文搜索查找完整的配置名，或一段有辨识度的输出文字。
2. 打开匹配的函数，看它从哪里拿到输入。
3. 有语言服务器时，用跳到定义或查找引用；没有的话，直接按文本搜索这个符号。
4. 读一读提供输入的调用方或测试。

做到这里就够了：一个入口、一个要追的值，还有一处能说明它怎么用的调用方或测试。不用先把整个架构弄懂。

问问 AI Reader（可选）

按连接模型服务商配置好服务商，然后打开 AI Reader，就刚才读的代码提问。可以把文件、文件夹或选区加进去作为起点，也可以直接描述现象，让它在项目里找相关代码。

例如：

从默认值开始，追踪这个配置怎么传到请求处理函数。哪些地方能覆盖它？告诉我需要核对的分支。

点击回答里的源码引用，会在快速查看里显示对应代码；点打开文件可以把它留在标签页里。先核对一个结论，再问更大的问题。

AI Reader 默认只读，可以按轮允许它修改文件。具体怎么授权、哪些内容会发给模型，见数据去向与编辑权限。

在预览版到期前更新

1. 查看首页下载按钮旁边的版本和到期日期。有新版本时，再下载新的 .dmg。
2. 保存尚未保存的文件，然后退出 Yenpo。打开新磁盘映像，把 Yenpo 拖进“应用程序”；Finder 询问时，替换原来的应用。
3. 从“应用程序”启动，再到 Yenpo → 关于 Yenpo 核对版本，最后推出磁盘映像。

重新下载或安装同一版本不会延长有效期。如果手上的版本已到期，而首页仍提供同一版本，请等待新版发布。

遇到问题时

现象	先检查
找不到文件	项目根目录、文件路径、隐藏文件和 Git 忽略文件设置
跳转到定义没反应	语言服务器是否安装，能否理解这个项目
AI Reader 答不出来	当前服务商、API 类型、端点、模型 ID、API Key
看到的代码和预期不同	标签页里是 Git 历史版本，还是当前文件

记录问题时，保留 Yenpo 和 macOS 版本、预期结果、实际结果和复现步骤。公开分享前去掉私有代码和 API Key。

接下来做什么

继续阅读查找文件、跟随符号与核对源码引用。先从文件搜索开始，有对应语言服务器时再使用符号导航。也可以比较提交和分支，这些都不需要模型账号。

想就代码向 AI Reader 提问时，再连接模型服务商。发送问题前，先了解哪些代码会发给服务商，以及服务商的收费方式。