2027 年日历 · 新手教程 · 核对日期 2026-10-12
把自己的微信读书划线带进《讀歷》
先在支持 Skill 的工具中取得 JSON 文件，再打开《讀歷》选择文件、校对和打印。网站不会接收 API Key，也不会替你登录微信读书。
1. 找到腾讯官方 Skill
打开 Tencent/WeChatReading 官方仓库，检查地址中的发布者是 Tencent。也可以从 微信读书官方 Skill 页面进入。不要下载陌生人发来的“免授权导出器”。
这里的 Skill 是给具备执行能力的 AI 工具看的操作说明，不是《讀歷》的网页插件。先问你所用工具：
你能安装并读取 Tencent/WeChatReading Skill，实际执行 HTTPS 请求，并生成我可以下载的 JSON 文件吗？请说明你的实际能力；不能执行时不要声称已安装或已导出。
如果回答只是“我可以指导你”，却无法执行命令或提供文件，请先换用具备这些能力的工具，或请熟悉电脑的人协助。不要在不支持的聊天页面里反复粘贴 Key。
2. 获取自己的 API Key
- 在自己的浏览器打开 微信读书官方 Skill 页面。
- 登录自己的微信读书账户，找到“获取 API Key / 复制 Key”。具体登录界面以官方页面为准。
- Key 相当于账户访问凭证，只给你选择并信任的工具使用。不要发到聊天记录、客服、截图、群聊或《讀歷》页面，也不要放进 JSON。
如果 Key 意外泄露，在官方页面重置它。别人自己的 Key 只能访问别人的账户，不能拿来导出你的划线。
3. 安装或使用 Skill，并安全配置凭证
官方安装命令是：
npx skills add Tencent/WeChatReading -g
如果你的工具确实支持执行终端和安装 Skill，可以让它执行，并查看实际安装结果。否则需要你或协助者在终端执行，事先安装 Node.js/npm；Mac 是“终端”，Windows 是 PowerShell 等命令行工具。遇到“找不到 npx”说明环境未准备好，不能仅靠复制文字解决。
安装命令本身不包含 Key。首次可能需要联网下载；不要关闭系统安全检查或运行来源不明的替代命令。
官方 Skill 从运行环境的 WEREAD_API_KEY 读取 Key。请根据所用工具的文档，使用它的专用隐藏凭证入口，或由本机终端安全输入并传给工具进程。先确认工具确实能读取这个变量；已经打开的桌面应用不会因为另一个终端设置变量就自动得到它。
4. 让 AI 导出兼容文件
准备好 Skill 与安全凭证后，复制下面的提示词交给该工具。先指定一个不敏感的账户标识，例如“我的阅读账户一”，以后同一账户沿用这个名称，用于识别重复划线。
下载提示词文本正在加载提示词… 如果加载失败，请下载上面的文本文件。
提示词要求逐页取得个人划线、核验数量、保留真实来源 ID 和原文，遇到缺失、限流、升级提示时说明问题。它不会保证不支持执行的 AI 突然具备联网能力。
5. 确认拿到了 JSON 文件
应该得到一个名为 read-calendar-weread.json 的实际文件，以及书籍数、划线数、是否完整的核验说明。只有聊天中的一段说明、截图、书架列表或接口原始回包不够；把 .txt 改成 .json 也不会自动转换内容。
《讀歷》的推荐格式为 read-calendar.weread.v1，这是本项目的转换格式，不是腾讯原始回包格式：
{
"format": "read-calendar.weread.v1",
"accountNamespace": "我的阅读账户一",
"pagination": {"complete": true},
"books": [{
"sourceBookId": "fictional-book-1",
"book": "虚构示例书",
"author": "虚构作者",
"highlights": [{
"sourceHighlightId": "fictional-highlight-1",
"original": "这是一条格式演示，不是用户真实划线。",
"thought": "",
"sourceHighlightedAt": null
}]
}]
}
上面仅演示结构。真实文件必须使用官方 bookId、bookmarkId 和划线原文，不能编造 ID 或混入这条示例。缺作者或书名可以是 null，导入后再校对；缺来源 ID 或正文的记录不会导入。
pagination.complete 只是导出工具的声明，网站不会重新请求 API 核验。只有导出范围完整、数量一致时才标为 true；如果只选部分书籍，核验说明必须写清范围。不要为了消除提醒随便修改这个字段。
6. 上传文件，预览后再确认
- 打开《讀歷》，在“书摘库 → 本地资料与备份”选择“导入本地 JSON”；日历预览里的“本地 JSON 导入／完整备份”也能进入同一区域。
- 选择文件后，先检查总数、可新增条数、新增书籍数、重复、失败及缺失字段。此时还没有写入数据。
- 数字和核验摘要一致再点击“确认导入”。如果有失败，只会合并可成功的记录，失败记录不会补写。
- 查看书摘库、搜索书名或作者，确认正文和换行正确。需要时修改展示书名、作者和片段；原始资料会保留。
文件在浏览器中读取，不上传《讀歷》服务器；网站不需要购买者安装 Python/Node 或运行本机服务。选择文件不会自动安排365天，也不会覆盖已有日期、锁定或修订。重复导入相同来源 ID 会跳过；如果改变账户标识或伪造 ID，去重就不可靠。
7. 校对365天，保存和下载 A5 PDF
- 从书摘库选择书摘并安排日期；也可使用现有“生成2027年初稿”预览，确认后再应用。现有安排和锁定日期保留。
- 逐页查看年度审核，处理未安排、排版溢出、重复提示和需要确认的页面。长原文可选适合打印的展示片段。若首次看到虚构示例，它们只是演示，最终请手动替换成自己的选择；导入不会自动替换示例日期。
- 点击“保存本轮修改”，然后“下载完整备份”。数据属于当前浏览器和网站地址；换浏览器、换设备或清理浏览器数据前，务必保留备份。
- 在“印刷规格”下载全年 A5 PDF。等待生成，必要时使用备用下载链接。当前版本针对2027年365天；缺少安排或存在排版/缺字问题时会说明原因。
JSON 是书摘资料，PDF 是打印文件，“完整备份”还包含日期安排、锁定、展示修订及设置。换设备继续编辑时应“还原完整备份”；还原会替换当前内容，只有预览并确认后才执行，不要把它与追加书摘的导入混淆。
常见失败怎么处理
| 看到什么 | 怎么处理 |
|---|---|
| AI 不支持 Skill 或没有生成文件 | 先确认工具有执行和文件能力；换工具或请协助者操作。不能把聊天中的“完成了”当导出成功。 |
| npx 找不到、安装失败 | 导出阶段需要 Node.js/npm、终端和可访问官方仓库的网络。按工具官方说明处理，不关闭安全校验。 |
| Key 授权失败或读取不到 | 在官方页面确认账户和 Key；检查工具进程的专用配置，不把 Key 发给客服。配置变量的终端与工具是否同一启动环境很关键。 |
| 升级、限流、分页或数量不一致 | 停止；依官方最新文档升级或稍后重试。让 AI 报告不完整，不猜测接口或补写书摘。 |
| 不是有效 JSON | 让 AI 输出 UTF-8 的纯 JSON 文件，不带代码围栏、注释、说明文字。不要改后缀冒充格式转换。 |
| 上传的是接口原始回包 | 使用本页完整提示词转换为 read-calendar.weread.v1；不要只把 updated/data 等原始字段另存为 JSON。 |
| 包含凭证字段 | 文件已被拒绝；重新导出仅含书籍与划线的资料。如已泄露 Key，请在官方页面重置。 |
| 没有书摘或没有新增 | 确认账户确有划线，导出不是书架列表；重复来源 ID 会跳过，零新增不等于丢失。 |
| 缺字段或部分失败 | 缺书名显示“书名未提供”，作者/时间可留空；缺 ID 或正文会失败。不要伪造补齐。书名最多160字符、作者80、原文50000，超长信息请核对后处理。 |
| 文件过大／超过容量 | 单个导入文件最多30 MiB，当前书摘库总容量2000条。按书籍选取范围或分批导出，分批不能绕过总容量上限；确认失败计数，不把部分导入当全量。 |
| PDF 暂时不能导出 | 先保存，再处理年度审核中的缺日期、溢出或缺字；不要通过重新安排所有日期来“修复”数据。 |
已验证与待验证
已验证：部署构建包含本教程和提示词；虚构数据在独立浏览器中上传、预览、确认、重复导入、刷新保留；JSON 格式、缺失字段和凭证字段提示；现有导入规则与浏览器 PDF 回归。全程未使用真实 Key 或个人数据。
仍需真人验证：为第一版选定一种具体 AI 工具；在干净 Mac 和 Windows 上按其官方说明安装 Skill、安全配置 Key、实际取回划线并生成文件；由新手独立完成上传、365天校对、备份和最终打印下载。实际 Cloudflare 线上环境也尚未部署验收。本教程不保证任意工具通用，不保证免费工具能完成全部操作。
导出工具可能按自身政策处理数据，请先阅读它的隐私说明。个人书摘用于自己的日历；工具使用许可与书摘内容的分发授权不同。不要把个人书摘或 Key 附在商品示例中。
官方依据：Skill 调用规范、划线与分页说明、书籍信息说明。操作方式可能更新，请以官方最新资料为准。