知档

本地归档你的知乎回答和文章

「知档」即知乎作者归档。一个安全、开源的内容导出工具,方便作者把知乎上自己的内容归档导出为 Markdown、JSON 和本地图片。

拿不准选哪个?看下面两个版本的区别 · 在 GitHub 查看源码

版本与更新记录见 GitHub Releases · 仅 macOS Apple Silicon · 已通过 Apple 签名与公证,下载后可直接打开(图文教程

从一个很具体的问题开始

作者在内容平台上长期创作之后,如何把自己的作品完整、安全地保存下来,并继续由自己控制。

知档的回答是:把作者自己的知乎创作,转换成开放、可读、可迁移、由作者自己保管的本地归档。

知档不是爬虫,是用户授权的归档工具

知档不抓取知乎,也不采集别人的内容——它只在你本人登录之后,把你自己账号下的回答和文章搬到你自己的电脑上。没有你的登录、没有你的操作,知档什么也拿不到。这是理解下面所有设计和边界的前提。拿大规模采集工具做对比,一眼就能看清楚:

问题大规模采集工具现在的知档
抓别人发布的内容可能大量采集不支持——只导出当前登录账号本人的回答和文章
聚合整个平台的数据常见否——每次只处理你自己这一个账号
获取评论者、粉丝、关注关系等他人资料可能明确不获取
把抓到的数据公开重新提供给别人可能否——导出结果只留在你自己电脑上
替代平台本身的浏览服务可能否——只做备份,不做内容消费产品
用户授权方式可能使用集中式凭证或自动化账号本人在登录窗口正常登录
遇到验证码可能尝试自动处理交给你本人完成,不绕过
代理池 / 账号池可能使用不使用
数据是否经过开发者的服务器可能不经过——本地直连知乎,本地写文件
保存位置可能进入第三方数据库你自己电脑上的文件夹

一句话总结:知档只做"帮你把自己的账号搬到自己的硬盘"这一件事,任何会让它变成内容聚合服务、大规模采集工具或访问控制绕过工具的能力,都不属于知档的产品范围。

这是独立开发的非官方项目,与知乎不存在隶属、合作、授权或认可关系。

目前只在 macOS(Apple Silicon)上完整测试,已通过 Apple Developer ID 签名与公证。详见 免责声明 · 可接受使用。开发计划见 ROADMAP.md

两个版本,选一个就够

归档格式和隐私原则完全一致,区别只在验证身份的方式。拿不准就下载登录版——这是默认、经过更长时间验证的路径。

  登录版图标登录版 密钥版图标密钥版
登录方式内嵌知乎登录窗口,正常账号登录粘贴知乎开放平台生成的 Access Secret,无需登录窗口
每日次数限制知乎官方额度:100 次/天(未实名 10 次),一篇内容对应一次,用完自动停止、次日续传
欢迎语 / 文件夹命名真实知乎昵称官方接口不返回昵称——可选贴一次主页链接代替,不贴则显示当日剩余额度
精确重复检测有(同一篇内容以回答和文章形式重复发布时会提示)暂不支持(官方列表接口不含全文,去重前不能先把内容都拉一遍)
数据来源知乎网页版接口知乎官方数据开放平台

两版怎么选、代码里怎么实现,见 开发者文档

你会得到什么

导出结果是一个普通的本地文件夹,可以直接读、备份、迁移到自有网站。index.json 和 Markdown 被当作长期数据格式来维护。

Markdown 正文 index.json 索引 export-report.json 报告 本地化图片
导出目录/
├── answers/           # 每条回答一个 Markdown 文件
├── articles/          # 每篇文章一个 Markdown 文件
├── images/            # 正文里的图片,全部下载到本地
├── index.json         # 全部内容的结构化索引(公开 schema)
├── export-report.json # 总数 / 分页 / 去重 / 失败的完整报告
└── README.md          # 这份导出的说明

每个条目保留原文链接、创建与更新时间、问题 ID、点赞与评论数、封面等元数据。接口报告总数、分页实际返回数、去重后的唯一数会被分别记录;无法解释的差异会给出完整性警告,而不是静默生成错误数据。

怎么用

独立桌面应用,不需要安装 Node.js、Chrome 或任何开发工具。

知档主界面,未登录状态,右上角「开始登录」按钮
1

下载并打开

从 GitHub Releases 下载 .dmg,拖进「应用程序」打开。打开后直接是导出设置界面。

知档内嵌的知乎登录窗口
2

登录知乎

点「开始登录」,在弹出的独立窗口里正常登录(扫码、验证码或密码)。登录信息只留在本机。

导出完成,显示回答与文章数量、去重条数
3

选目录,导出

确认保存位置,点「开始导出」。每一项的进度都能看到,可以随时暂停、跳过某一项;完成后显示汇总,并可一键在访达中打开结果。

设计原则

正因为知档的定位是「用户授权的归档工具」,无论它发展到什么程度,都保持以下原则。

平台独立

知乎是当前的内容来源,但数据模型不永远绑定于某个平台的页面结构。

本地优先

作者应能取得自己的完整数据,并能在没有任何云服务的情况下继续使用。

安全隐私

登录信息、Cookie 和导出内容默认只保存在本机,不自动上传;不加入遥测、远程日志或用户内容上传。

开放格式

内容和元数据优先采用公开、可迁移的格式,不制造新的平台锁定。

隐私

这是知档最在意的一层,也是它和「一键搬运」类工具的根本区别。

  • 应用在你自己的电脑上运行,本地服务只监听 127.0.0.1
  • 在应用内置的登录窗口里直接登录知乎,不需要在表单、终端或配置文件里填密码或 Cookie。
  • 登录会话由系统自带的 WebView 管理(macOS 上是 WKWebView),本应用的后端服务不接触、不读取。
  • 回答、文章和图片只写入你指定的本地目录。
  • 不包含遥测、分析、广告、远程日志或开发者服务器上传。
  • 点「退出登录」即可清除会话;删除导出目录即可清除导出内容。

详见 隐私说明

路线图

记录方向和优先级,不代表功能已完成,也不构成发布时间承诺。

已完成

导出体验重构:list-first 流程、每项进度可见、精确内容哈希检测重复(只读提示)、暂停/继续、单项跳过、断点续传。1.1 已正式发布。

已完成

密钥版:Access Secret 鉴权,不需要登录窗口,为将来上架 App Store 打下基础。1.2 已正式发布,两版本区别见上方。

已完成

Apple 签名 + 公证:两个版本都已用 Developer ID 证书签名并通过公证,下载后可直接打开,不再有 Gatekeeper 警告。

规划中

提交 Mac App Store(密钥版):需要 App Sandbox 改造和 entitlements 配置。

规划中

Windows 打包与分发:WebView2 登录、安装包、代码签名消除 SmartScreen 警告。

完整路线图见 ROADMAP.md