Wiki Notebook

Wiki Notebook

📚 一个连接 **Codex / Claude Code 与 Obsidian** 的读书 Skill。AI 帮你理解书、提炼判断，Obsidian 把笔记连成可持续积累的知识库。

从一本书到一张知识网

• 读书笔记：用“本质、原则、体系、应用”四问法读懂全书。
• 章节证据：重要观点能找到出处，保留反例和阅读范围。
• 概念卡片：一张卡说清一个可复用的判断。
• 主题地图：把多本书连起来，比较观点、发现分歧。
• 输出草稿：把理解转成行动清单、文章与视频选题。

新建笔记库采用中文目录：

笔记库/
├── 原始书籍/
├── 读书笔记/
├── 章节证据/
├── 概念卡片/
├── 主题地图/
└── 输出草稿/

设计来源

四问法总结《金字塔原理》的这张图，是本项目的设计参考之一：从本质到原则，再到体系和应用，让笔记既有结构，也能进入实际行动。

安装与使用

将 `wiki-notebook/` 整个目录放入：

AI 软件	项目内安装位置
Codex	.agents/skills/wiki-notebook/
Claude Code	.claude/skills/wiki-notebook/

转换与下载脚本需要 Python 3.10+：

python -m pip install pypdf requests

用 Obsidian 打开笔记库，再让 AI 在这个目录中执行：

使用 $wiki-notebook，为我提供的 EPUB 制作完整读书笔记，重点关注项目决策。

使用 $wiki-notebook，把现有笔记整理成“判断与决策”主题地图，保留观点分歧和来源。

账号与 API Key 配置

**只处理本地书籍，无需给本 Skill 配 API Key。** 模型登录或 API Key 沿用 Codex / Claude Code 自身配置。

Z-Library：注册账号后配置

1. 打开 Z-Library，进入登录页面，选择注册账号，按页面提示完成邮箱验证。
2. 本项目使用邮箱和密码登录，无需另外申请 API Key。remix_userid 和 remix_userkey 是登录后取得的令牌，由脚本缓存，不必手工提取。

注册完成后配置本地文件：

1. 复制 config.example.json 到用户主目录下的 .config/wiki-notebook/，改名为 config.json。
2. 填写自己的书源邮箱和密码，保存为 UTF-8：

{
  "raw_book_source": {
    "email": "your_email@example.com",
    "password": "your_password_here"
  }
}

登录成功后，脚本可在同一文件缓存 `remix_userid` 和 `remix_userkey`。**不是填进 `settings.json`**；真实配置已由排除规则保护，不随项目提交。

站点域名可能变更：Z-Library 入口不可用时可查 [域名信息](https://en.wikipedia.org/wiki/Z-Library)。目录覆盖、配置优先级和本地检查见 [运行配置](wiki-notebook/references/configuration.md)。