Obsidian Zhihu Sync Master 🚀

这是一个专为知乎创作者和深度读者打造的 Obsidian 内容备份工具。它可以将你的知乎回答快速转化为结构化的本地 Markdown 笔记，实现知识的永久存档。

✨ 核心特性

• ⚡ 一键全量同步：只需填入 People ID，点击侧边栏图标，即可自动抓取你发布的最新回答（默认前 20 条），无需繁琐的复制粘贴。

• 📊 深度元数据抓取：自动生成 YAML 属性（Properties），包含标题、URL、作者、话题、点赞数、评论数、回答日期及更新日期。

• 🖼️ 智能图片本地化：自动抓取回答中的图片并保存至本地 attachments 文件夹。

• ♻️ 物理去重逻辑：通过图片 ID 识别，确保同一张图在附件文件夹中仅存储一份，避免冗余占用空间。

• 📝 完美的 Markdown 转换：针对知乎 HTML 结构深度优化，保留排版细节，支持 Obsidian 原生图片语法 ![[...]]。

• 自动化目录结构：插件会自动维护以下目录：

  • answers/: 存放抓取的回答 MD 文件。
  • attachments/: 存放本地化的图片资源。
  • recommend/: 存放每日抓取的推荐问题日报。

• 📥 全量同步：一键同步个人所有回答，支持图片本地化，解决防盗链困扰。

• ⚡ 增量更新：自动对比本地文件修改时间，仅同步有更新的内容，保护硬盘寿命。

• 🎯 灵活联动：支持在同步回答时自动触发“创作者推荐”或“好物推荐”抓取。

• 📦 2.0 创作增强：

  • 好物推荐抓取：对接知乎 MCN 级接口，自动抓取高价值问题，生成含浏览量、回答数的 MD 表格。
  • 定向存储：自动维护 Goods/ 文件夹，按日期生成好物日报。

---

🚀 安装与配置

1. 安装：将编译后的 main.js、manifest.json 放入 Obsidian 插件目录。
2. 填写 Cookie：在插件设置页填入你的知乎 Cookie（获取推荐功能必填）。
3. 填写 ID：填入知乎个人主页 URL 中 people/ 后面的唯一 ID。
4. 自定义路径：可自定义根目录名称（默认为 Zhihu_Imports）。

🚀 使用指南

• 同步我的回答 (一键模式)：点击侧边栏的 用户图标 (User Icon) 或 循环图标，插件将自动连接 API，把你主页的回答逐一搬运回本地。

• 手动导入 (单篇模式)：点击侧边栏的 链接图标 (Link Icon)，粘贴特定的回答链接进行针对性抓取。

• 获取推荐：

  1. 打开 Obsidian 插件设置 -> Zhihu Loader。
  2. 点击最下方的 "开始抓取" 按钮。
  3. 插件会自动在 recommand 目录生成 创作者推荐_YYYY-MM-DD.md。

---

📅 版本记录 (Changelog)

v2.0.1 (2026-04-02) —— 2.0 终极整合版 🌟

• [重大修复] 攻克好物推荐 404 报错，成功对接知乎最新 mcn/recommend/question 接口。
• [功能升级] 强化文件夹递归创建逻辑，确保 Goods 与 recommand 目录在任何环境下均能稳定生成。
• [体验优化] 模拟真实浏览器环境（Referer/UA），大幅提升抓取成功率。

v1.1.0 (2026-03-31) —— 联动进化

• [新增] “联动同步”逻辑，同步回答后自动触发推荐抓取。
• [优化] 命令面板集成，支持独立运行推荐抓取命令。

v1.0.0 (2026-02) —— 核心诞生

• [核心] 实现增量同步与图片本地化存储。

---

🛠️ 本地开发

# 安装依赖
npm install

# 开发模式（实时编译）
npm run dev

---

📂 数据结构

插件会为每一篇回答生成规范的 Properties 区域：

---
标题: "你的回答标题"
url: https://www.zhihu.com/...
作者: 你的名字
点赞数: 1024
评论数: 56
回答日期: 2024-01-01
最后更新: 2024-03-20
---

---

💡 进阶：数据可视化

利用 Obsidian 的 Dataview 插件，你可以轻松创建一个“知乎创作仪表盘”：

TABLE 点赞数, 评论数, 回答日期
FROM "Zhihu_Imports"
WHERE 作者 = "你的名字"
SORT 点赞数 DESC

---

🛡️ 免责声明

本工具仅用于个人知识管理与备份。请尊重原平台版权及社区规范，切勿用于商业用途或非法爬取。