Reado

下载 · 网站 · Discord · 参与贡献

_{如果 Reado 值得你支持，可以点个星标，让这个小型开源项目被更多人发现。 前 50 位发送反馈的测试者可免费使用 Reado Pro 12 个月。}

_{在真实分支上进行完整的引导式审查——未经剪辑，实时呈现。Agent 提议，你来决定，Agent 负责修复。}

大多数 IDE 都是为编写代码而打造的。Reado 则是为阅读代码而打造的。

如今，Agent 编写的代码比你更多。剩下的工作就是阅读并作出判断——这值得拥有专门的工具。在 Reado 中，你可以阅读代码，并在关键行上留下评论；你的 Agent（Claude Code、 Codex、Copilot、Gemini、OpenCode 或 Cursor）会解决这些问题，然后你再审查修改内容。

**反向代码审查：**你是审查者，AI 是提交者。

与 AI 搭档一起进行引导式审查

选择要审查的内容——当前工作区的更改、分支或拉取请求——以及关注重点：Bug 风险、安全性、性能、测试覆盖率。Agent 会规划审查路径，逐个文件审查更改，并提出建议；只有经你批准后，结果才会最终确定。

1 · 指定要审查的更改。 比较分支，选择关注重点——Bug 风险、安全性、性能。	2 · Agent 规划审查路径。 它会在终端中读取差异，并按风险从高到低排列文件。	3 · 它会提出建议，绝不直接定案。 发现会作为建议显示在对应代码行上。你的代码暂时不会有任何改动。
4 · 你也可以参与审查。 选择任意代码行并留下自己的评论——Reado 首先是一款阅读工具。	5 · 征求第二意见。 Agent 会质疑自己此前的审查结果；你可以批准经得起检验的内容。	6 · 交给它处理。 发送已批准的任务；修复完成后，相关评论会自动解决。

评论会留在你指定的位置

Reado 评论不是便签。它锚定在一段代码行上，带有类型（Bug、重构、性能、问题、备注），支持串联讨论，并且可以作为交给 Agent 的任务，也可以作为留给下一位读者的备注。评论以纯 Markdown 文件的形式存放在 .reado/ 中，与你的代码并存，即使代码经过编辑也能保留：代码移动时，评论会随之重新锚定；如果对应代码消失，评论会变成孤立评论，而不会悄悄指向错误的代码行。

Agent 负责完成工作——你可以实时查看进展

发送审查会将未完成的任务交给在 Reado 终端中运行的 Agent。它通过 reado CLI 和 MCP 服务处理任务——读取你的评论、查阅项目文档和规范，并逐一解决任务；Reado 会实时显示每个步骤：推理过程、涉及的文件以及任务关闭情况。完成后，文件树上的 Δ 会直接带你查看自上次阅读以来发生的更改。

像读书一样使用 IDE

• 专为阅读而设计： 平静易读的 CodeMirror 6 查看器，提供舒适的行宽、固定的作用域标题、大纲、转到定义和代码智能功能。
• 阅读覆盖情况： Reado 知道你实际读过哪些内容，也知道你阅读期间哪些内容发生了变化。
• 项目导览： 将 tour.json 随仓库一同发布，任何人在 Reado 中打开仓库，都可以按你向新手讲解代码的方式逐步浏览，精确高亮对应代码行并逐步说明。格式是开放的——任何工具都可以读取和写入。
• 随着阅读不断扩展的知识库： 在同一处搜索项目文档、规范（OpenSpec、Spec Kit）和你的备注，另有一个关联评论、文件、规范和文档的图谱。
• Agent 可以操控的浏览器： 在 Reado 中预览应用，直接在页面上发表评论，并让 Agent 检查 DOM、控制台和网络。
• Reado Anywhere： 配对手机以跟进审查、通过手机发表评论，并在 Agent 完成后收到通知。
• 四种基于研究设计的主题——深色、浅色、高对比度、棕褐色；界面支持英语、意大利语、西班牙语、法语和德语。

本地优先，开源

Reado 采用 MIT 许可证，可在 macOS、Linux 和 Windows 上运行。你的代码和评论会以纯文件形式保留在本机；账号可选，使用应用不受账号限制。

下载

从 Releases 下载最新的签名版本 — macOS （.dmg，已签名并经过公证）、Linux（.AppImage / .deb / .rpm）和 Windows （.exe / .msi）。之后 Reado 会通过签名版本自行更新。

AI 工作循环

Reado 的核心工作循环是 阅读 → 注释 → AI 解决：

1. 阅读代码并留下评论。标记为 任务 的评论会列入工作清单；备注 不会妨碍 Agent。
2. 打开终端（Cmd/Ctrl+J），启动 Claude、Codex 或 Copilot， 然后点击 发送审查。Reado 会注入提示词，指引 Agent 处理未完成的任务。
3. Agent 通过 reado://tasks 和 reado://comments MCP 资源，或 reado task list，读取任务和评论 — 完成修改后，使用 reado task done <id> 标记每项任务已完成（或使用 reado task fail <id> "<reason>" 标记失败）。Reado 的监视器会实时反映结果，已解决的评论则会移至历史记录。

reado 二进制文件是稳定的接口契约 — 磁盘上的格式可以演进，而不会影响 Agent。它同时提供 MCP 服务（reado mcp，打开项目时会自动写入各 Agent 的配置）和 Agent 调用的 CLI，因此必须位于 Agent 的 PATH 中，AI 工作循环才能正常运行。打包的应用内置了该文件：在 设置 → 命令行工具 中安装（采用 VS Code 的方式，将 reado 链接到 ~/.local/bin）。MCP 服务也已在官方 MCP Registry 中列出，名称为 io.github.WatermelonBros/reado，并提供 macOS、Linux 和 Windows 的二进制文件包。从源码检出目录中，可直接构建并链接：

scripts/install-cli.sh           # builds release + links into ~/.local/bin
reado --help

操作（CLI）：reado task list|show|done|fail|link、 reado comment add|reply|search 和 reado kb list|show|search（解决任务前可用于查阅文档和规范）。上下文（MCP）：reado://tasks、 reado://comments、reado://reading-progress 和 reado://bookmarks 资源， 以及用于应用内预览的 browser_* 工具。Agent 身份由 $READO_AGENT 提供（Reado 在启动 Agent 时会设置此变量）。

plugin/ 中的 Agent 插件会向 Claude Code（以及通过 AGENTS.md 向 Codex）介绍此接口契约，确保 Agent 正确解决任务。请参阅 plugin/README.md 了解安装方法。其他 Agent（例如 Copilot） 仍可从 Reado 注入的 发送审查 提示词中获取此接口契约，前提是已安装 reado CLI。

键盘快捷键

快捷键	操作
Cmd/Ctrl + P	转到文件（模糊搜索）
Cmd/Ctrl + K	命令面板
Cmd/Ctrl + Shift+F	在项目中搜索和替换
Cmd/Ctrl + ,	设置

参与贡献

Reado 致力于打造一个友好的开源项目，欢迎大家贡献。构建、测试和提交更改所需的一切内容 — 前置条件、开发流程、CI 运行的检查和规范 — 都在 CONTRIBUTING.md 中。请阅读我们的行为准则；安全问题请通过 SECURITY.md 反馈。

许可证

MIT © Reado 贡献者