Readout · macOS Markdown 阅读器

读 Agent 写的文档

实时跟随写入。标出改动。始终只读。

macOS 26+MIT2026年10月12日Quick Look

Readout 的阅读视图,显示一份中英混排的 Agent 实现计划(来自 zkywsg/Daily-LLM)。可以看到标题、引用说明、Goal 等段落、任务复选框和代码块。
Readout 的阅读视图,由它自己的测试在 WebKit 中渲染,未包含窗口外框。

Mac 用深色,它也用深色

页面跟随系统外观切换,Mermaid 图表也一样。

深色模式下 Readout 的阅读视图:一份中文功能设计文档(来自 zhukunpenglinyutong/jetbrains-cc-gui),有标题、段落、编号列表和项目符号列表。
由 Readout 的测试在 WebKit 中渲染,未包含窗口外框。

Agent 边写,你边读

跟随写入

按段落增量更新,你正在读的段落不会跳动。

标出变更

新增和修改的段落旁有一条细线,点开看改了哪些词。

记得读过哪里

读过后标记自动消退,重启后仍然保留。

带进度的大纲

侧边栏列出标题,以及每节任务的完成数。

完整 GFM

表格、提示块、脚注、代码高亮、KaTeX 公式和 Mermaid 图表。

一键打开最新文件

按 ⌥⌘R 打开 Agent 文件夹里最新的 Markdown。

数据的去向

  • 渲染文档时不发出任何网络请求:远程图片只显示为注明来源的占位按钮。
  • 点击后 Readout 才下载图片,不携带 cookie,也不会从本机或局域网下载。
  • 唯一的自动联网是每周一次的 GitHub Releases 更新检查,可在设置中关闭。

v3.1.02026年10月12日发布说明 ›

常见问题

怎样安装?

从 GitHub Releases 下载 Readout-x.y.z.dmg,打开后把 Readout 拖进“应用程序”。之后可用“Readout → 检查更新…”查找新版本。

为什么首次打开被 macOS 拦下?

构建是 ad-hoc 签名、未经公证。打开“系统设置 → 隐私与安全性”,找到关于 Readout 的提示,点击“仍要打开”。

能从终端或 Claude Code 打开文件吗?

选择 Readout → 安装命令行工具…,即可使用 readout。readout plan.md 打开文件并切换到 Readout;readout -b plan.md 打开但不切换应用。配合 Claude Code 时,在 ~/.claude/settings.json 中加入 PostToolUse hook。matcher 设为 Write|Edit|MultiEdit,命令为 readout --hook。只有写入的是 Markdown 文件时,它才在后台打开。

⌥⌘R 会在哪些文件夹里找?

在设置里添加的“Agent 文件夹”;首次启动时,如果 Claude Code 的 ~/.claude/plans 存在,会自动加入。全局快捷键也可以在那里更换或关闭。

支持 Quick Look 吗?

支持。在访达中选中 Markdown 文件,按空格即可预览。Quick Look 从不加载远程图片,只显示占位按钮。

代码引用能在编辑器中打开吗?

能。src/app/main.swift:42 这样的引用会在设置里选定的编辑器中打开。可选默认应用、Visual Studio Code、Cursor、Zed、Xcode 或 Sublime Text。

Readout