weread-socrates

weread-socrates · AI 伴读阅读教练

本地运行的 Web 应用，将微信读书的结构化整书数据（目录+简介+万人划线）与大模型结合，提供"先建全局认知 → 再钻细节 → 对话内化"的深读体验。

前置条件

启动前依次检查：

1. Node.js — 运行 node --version，需 v16+。未安装则提示用户安装。
2. 微信读书 API Key — 检查环境变量 WEREAD_API_KEY。未配置时搜书和划线功能不可用，需提示用户在 ~/.zshrc 或 ~/.bashrc 中添加 export WEREAD_API_KEY=你的key。
3. 大模型 API Key — 应用首次打开后在右上角「⚙️ 设置」中配置，支持智谱 GLM 和 DeepSeek，Key 存浏览器 localStorage。未配置时思维导图和对话功能不可用。

启动流程

1. 定位 Skill 目录：本文件所在目录即为 Skill 根目录。
2. 运行启动脚本：

   bash scripts/start.sh
   

   脚本会自动检查 Node.js、加载 API Key、释放 3456 端口、启动服务并打开浏览器。
3. 验证服务：访问 http://localhost:3456/api/status，应返回 {"ok":true,"weread":true/false}。
4. 浏览器自动打开 http://localhost:3456，若未自动打开则手动访问。

注意：本应用必须在用户本地机器上运行，不能在远程/沙箱环境中启动后让用户访问。如果当前环境不是用户本地，告知用户将 Skill 目录复制到本地后执行 bash scripts/start.sh。

使用路径

路径一：搜书 → 全书导图 → 划线对话

1. 搜索书籍：在输入框输入书名（如《智能》《关键跃升》），点击搜索。
2. 查看全书结构：搜索结果自动生成思维导图（非虚构类生成结构 mindmap，虚构类生成人物关系图 graph）。支持预览、编辑 Mermaid 代码、复制代码、导出 PNG。
3. 多选热门划线：在「热门划线」区域勾选感兴趣的段落（可多选），划线按热度排序。
4. 开始引导对话：点击「💬 开始对话」，AI 以苏格拉底式教练身份发起 5 轮递进提问（理解原文→联系自身→批判分析→实际应用→沉淀收获），用户逐轮回答。
5. 导出笔记：5 轮结束后点击「📥 导出笔记」，下载包含原文选段和完整对话记录的 Markdown 文件。

路径二：仅生成全书思维导图

搜索书籍后，思维导图自动生成在结果上方。可直接编辑、导出，无需进入对话。

核心功能说明

故障排查

停止服务

• 方式一：在运行服务的终端按 Ctrl+C
• 方式二：另开终端运行 bash scripts/stop.sh

扩展参考

• 微信读书 API 接口详情、参数和返回字段：见 references/weread-api.md
• 前端源码：assets/ai-reading-companion.html
• 服务端源码：assets/server.js（端口 3456，代理微信读书 API + 静态文件服务）