使用指南

从下载到用顺手,四步。前两步装好就能开始读和写;后两步可选,装上之后收资料、找资料会快很多。

01下载与安装

深读是桌面应用,不用注册账号。下载对应系统的安装包,装好直接打开。

macOS

  1. 打开下载的 .dmg,把 ReadingWiki(深读)拖进「应用程序」文件夹。
  2. 第一次打开时,如果提示「无法验证开发者」或「已损坏」:打开 系统设置 → 隐私与安全性,在页面底部点 仍要打开。
  3. 还是打不开的话,在「终端」里执行 xattr -cr /Applications/ReadingWiki.app,再打开一次。

Windows

  1. 双击下载的 .exe 安装。
  2. 如果出现「Windows 已保护你的电脑」:点 更多信息 → 仍要运行。
  3. 安装时会自动装上微软的 WebView2 运行库,已经装过的会跳过。

为什么会有这些提示?现在是测试版,安装包还没做苹果公证和微软签名,系统会多问一句。应用本身不联网上传你的任何内容。之后的新版本,app 会自己提示你更新。

02填 API key

深读不带 AI 账号,AI 功能用你自己的 API key,费用直接付给模型服务商。第一次打开时会引导你填;之后随时可以在 设置 → API 设置 里改。key 只存在本机的系统钥匙串里。

  1. DeepSeek(必填):对话、翻译、wiki 提炼都靠它。
  2. 硅基流动(必填):检索与精排,让「找资料」更准。
  3. 阿里云百炼(可选):播客、视频这类音频内容的转写。
  4. Tavily / 博查(可选):网页搜索;博查的中文结果更好。

每一项旁边都有 去获取 链接,点过去在服务商后台新建一个 key,复制回来粘贴保存就行。

截图:设置 → API 设置

03浏览器插件:一键收藏网页

在浏览器里看到好文章,点一下工具栏上的深读图标,正文就存进深读。支持 Chrome、Edge、Arc 等 Chromium 内核的浏览器。插件只和你本机的深读通信,不连任何外部服务。

插件下载即将提供

安装

  1. 把下载的 .zip 解压,放在一个不会被误删的地方(比如「文稿」里)。插件就从这个文件夹加载,删了插件就失效。
  2. 在浏览器地址栏打开 chrome://extensions(Edge 是 edge://extensions),打开右上角的 开发者模式。
  3. 点 加载已解压的扩展程序,选中刚才解压出来的文件夹。
  4. 点浏览器右上角的拼图图标,把深读插件钉到工具栏上。

连上深读

  1. 打开深读,进 设置 → API 设置,找到「浏览器插件 · 连接信息」,点 复制。
  2. 在浏览器里右键插件图标 → 选项,粘贴进去,点保存。
  3. 点 测试连接,显示「连上了」就好了。

之后在任意文章页点插件图标,图标上出现绿色的 ✓ 就是已经存进深读了。同一个网址再存一次会更新原来那条,不会重复。

截图:在浏览器里点插件收藏一篇文章

为什么要开开发者模式?插件还没上架 Chrome 应用商店,暂时用这种方式安装。上架之后这里会换成一键安装。

04接进 Claude

连上之后,Claude 就能读你在深读里收的东西:翻主题、搜资料、读原文,也能帮你收链接、写总结、每天整理订阅速递。Claude 的请求经深读的中转服务转给你电脑上正在运行的深读,中转只负责转发,不存储你的内容。网页版、桌面版、手机上的 Claude 都能用,在任意一端连上,其他端也能用。

三步连上

  1. 打开深读,进 设置 → API 设置,找到「连接 Claude」,那里有一个 6 位配对码。
  2. 在 Claude 里打开 设置 → 连接器,添加自定义连接器,地址填 https://mcp.readingwiki.com/mcp。
  3. Claude 会弹出一个页面要配对码,把第 1 步的码填进去,完成。

一次配对,长期有效。配对码 10 分钟内有效,过期了在深读里点 重新生成 就行。深读那边的状态点显示「已连接」,说明一切正常。

用 Claude Code?

在终端里执行下面这行,第一次用到时浏览器会弹出配对页,填深读里的配对码即可:

claude mcp add --transport http reading https://mcp.readingwiki.com/mcp

试一试

保持深读开着,在 Claude 里新开一段对话,问问看:

  • 我的库里有哪些主题?
  • 我读过的关于注意力机制的资料,都怎么说?
  • 把这个链接收进「产品设计」主题:https://…
  • 看看我的订阅今天有什么值得读的
截图:在 Claude 里查自己的主题

会不会乱改我的数据?查东西不会动你的数据。收资料、改页面、关注订阅这类会写入的操作,Claude 每次都会先请你允许;删除前还会在对话里再确认一次。

?常见问题

插件提示「连不上深读」,或 Claude 说「深读没有运行」

深读没开,或者刚开还没准备好。打开深读等几秒,再试一次。浏览器插件和 Claude 都要深读开着才能用。

插件提示连接码(token)不对

回深读的 设置 → API 设置,在「浏览器插件」那一块重新复制一次连接码,粘贴进插件选项里。复制时别多带空格。

插件点了之后提示「没抽出正文」

可能不是文章页,或者页面还没加载完。等页面加载完再点;实在不行,把链接复制到深读里直接导入。

macOS 提示「已损坏,无法打开」

这是没有公证的应用常见的提示,不是真的坏了。按第一步里的方法,在「隐私与安全性」点「仍要打开」,或者在终端执行 xattr -cr /Applications/ReadingWiki.app。

我的数据存在哪里?怎么备份?

全部在你自己的电脑上,没有云端副本。wiki 是普通的 Markdown 文件,直接复制文件夹就是备份。