使用指南
从下载到用顺手,四步。前两步装好就能开始读和写;后两步可选,装上之后收资料、找资料会快很多。
01下载与安装
深读是桌面应用,不用注册账号。下载对应系统的安装包,装好直接打开。
macOS
- 打开下载的
.dmg,把 ReadingWiki(深读)拖进「应用程序」文件夹。 - 第一次打开时,如果提示「无法验证开发者」或「已损坏」:打开 系统设置 → 隐私与安全性,在页面底部点 仍要打开。
- 还是打不开的话,在「终端」里执行
xattr -cr /Applications/ReadingWiki.app,再打开一次。
Windows
- 双击下载的
.exe安装。 - 如果出现「Windows 已保护你的电脑」:点 更多信息 → 仍要运行。
- 安装时会自动装上微软的 WebView2 运行库,已经装过的会跳过。
为什么会有这些提示?现在是测试版,安装包还没做苹果公证和微软签名,系统会多问一句。应用本身不联网上传你的任何内容。之后的新版本,app 会自己提示你更新。
02填 API key
深读不带 AI 账号,AI 功能用你自己的 API key,费用直接付给模型服务商。第一次打开时会引导你填;之后随时可以在 设置 → API 设置 里改。key 只存在本机的系统钥匙串里。
- DeepSeek(必填):对话、翻译、wiki 提炼都靠它。
- 硅基流动(必填):检索与精排,让「找资料」更准。
- 阿里云百炼(可选):播客、视频这类音频内容的转写。
- Tavily / 博查(可选):网页搜索;博查的中文结果更好。
每一项旁边都有 去获取 链接,点过去在服务商后台新建一个 key,复制回来粘贴保存就行。
03浏览器插件:一键收藏网页
在浏览器里看到好文章,点一下工具栏上的深读图标,正文就存进深读。支持 Chrome、Edge、Arc 等 Chromium 内核的浏览器。插件只和你本机的深读通信,不连任何外部服务。
安装
- 把下载的
.zip解压,放在一个不会被误删的地方(比如「文稿」里)。插件就从这个文件夹加载,删了插件就失效。 - 在浏览器地址栏打开
chrome://extensions(Edge 是edge://extensions),打开右上角的 开发者模式。 - 点 加载已解压的扩展程序,选中刚才解压出来的文件夹。
- 点浏览器右上角的拼图图标,把深读插件钉到工具栏上。
连上深读
- 打开深读,进 设置 → API 设置,找到「浏览器插件 · 连接信息」,点 复制。
- 在浏览器里右键插件图标 → 选项,粘贴进去,点保存。
- 点 测试连接,显示「连上了」就好了。
之后在任意文章页点插件图标,图标上出现绿色的 ✓ 就是已经存进深读了。同一个网址再存一次会更新原来那条,不会重复。
为什么要开开发者模式?插件还没上架 Chrome 应用商店,暂时用这种方式安装。上架之后这里会换成一键安装。
04接进 Claude
连上之后,Claude 就能读你在深读里收的东西:翻主题、搜资料、读原文,也能帮你收链接、写总结、每天整理订阅速递。Claude 的请求经深读的中转服务转给你电脑上正在运行的深读,中转只负责转发,不存储你的内容。网页版、桌面版、手机上的 Claude 都能用,在任意一端连上,其他端也能用。
三步连上
- 打开深读,进 设置 → API 设置,找到「连接 Claude」,那里有一个 6 位配对码。
- 在 Claude 里打开 设置 → 连接器,添加自定义连接器,地址填
https://mcp.readingwiki.com/mcp。 - Claude 会弹出一个页面要配对码,把第 1 步的码填进去,完成。
一次配对,长期有效。配对码 10 分钟内有效,过期了在深读里点 重新生成 就行。深读那边的状态点显示「已连接」,说明一切正常。
用 Claude Code?
在终端里执行下面这行,第一次用到时浏览器会弹出配对页,填深读里的配对码即可:
claude mcp add --transport http reading https://mcp.readingwiki.com/mcp
试一试
保持深读开着,在 Claude 里新开一段对话,问问看:
- 我的库里有哪些主题?
- 我读过的关于注意力机制的资料,都怎么说?
- 把这个链接收进「产品设计」主题:https://…
- 看看我的订阅今天有什么值得读的
会不会乱改我的数据?查东西不会动你的数据。收资料、改页面、关注订阅这类会写入的操作,Claude 每次都会先请你允许;删除前还会在对话里再确认一次。
?常见问题
插件提示「连不上深读」,或 Claude 说「深读没有运行」
深读没开,或者刚开还没准备好。打开深读等几秒,再试一次。浏览器插件和 Claude 都要深读开着才能用。
插件提示连接码(token)不对
回深读的 设置 → API 设置,在「浏览器插件」那一块重新复制一次连接码,粘贴进插件选项里。复制时别多带空格。
插件点了之后提示「没抽出正文」
可能不是文章页,或者页面还没加载完。等页面加载完再点;实在不行,把链接复制到深读里直接导入。
macOS 提示「已损坏,无法打开」
这是没有公证的应用常见的提示,不是真的坏了。按第一步里的方法,在「隐私与安全性」点「仍要打开」,或者在终端执行 xattr -cr /Applications/ReadingWiki.app。
我的数据存在哪里?怎么备份?
全部在你自己的电脑上,没有云端副本。wiki 是普通的 Markdown 文件,直接复制文件夹就是备份。