前言¶

微信读书里积累了书架、读完记录和划线笔记，但这些数据分散在 App 里，很难一次性看清自己的阅读倾向。手工整理成「我是什么类型的读者」既费时，又缺少统一口径。社区 Skill「微信读书阅读人格分析」把数据拉取、六维人格判定和 HTML 报告生成串成一条链路：先通过微信读书相关能力拿到 JSON 数据，再在本 Skill 内跑分析脚本，得到可本地打开的网页报告。

这是什么¶

「微信读书阅读人格分析」是 SkillHub 上的社区 Skill，坐标为 @user_2d8804af/gzh-skill-wxread-persona，当前版本 1.0.3，分类为 data-analysis，由发布者 user_2d8804af 维护。官方简介说明：通过微信读书 Skill 获取阅读数据，结合阅读人格分析框架，产出微信读书阅读人格分析报告 HTML。SkillHub 页面标注标签 requires_api_key=true，使用前需要配置微信读书侧 API Key。

核心功能¶

根据 Skill 包内 SKILL.md 与脚本说明，已核实的能力包括：

1. 数据侧：依赖微信读书 Skill（文档中写作 weread-skills），可获取书架、已读完列表、笔记导出等，供后续分析使用。
2. 人格判定：基于六维模型（认知深度、情感卷入、实用导向、系统跨度、完成强度、探索倾向），映射到六种阅读人格类型（思辨成长型、情绪治愈型、务实功利型、文艺理想型、猎奇娱乐型、理性建构型）。
3. 报告生成：使用 scripts/generate-report.js 与 templates/report-template.html，输出 HTML 可视化报告，涵盖人格类型、阅读分布、核心洞察、代表性书单等板块。
4. 框架文档：SKILL.md 内附带判定矩阵、指标阈值与命令参数说明，便于在 Agent 对话中按同一套方法论执行。

技术依赖写明：Node.js >= 16，且微信读书 Skill 已安装并配置 API Key；数据经微信读书 Agent API Gateway（https://i.weread.qq.com/api/agent/gateway，Bearer Token 认证）。

安装与启用¶

通过 SkillHub CLI 安装¶

先确认本机是否已有 skillhub（未安装时可按 SkillHub 安装文档 执行官方安装脚本）。安装本 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

在 Cursor 中，skills 目录一般为 ~/.cursor/skills/。安装命令示例：

skillhub install gzh-skill-wxread-persona --namespace user_2d8804af --dir ~/.cursor/skills/

SkillHub 页面也提供等价提示：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2d8804af/gzh-skill-wxread-persona。

配置 API Key¶

在微信读书 Skill 页面申请 Key（文档链接：https://weread.qq.com/r/weread-skills），并在环境中导出：

export WEREAD_API_KEY=wrk-your-api-key

请将 wrk-your-api-key 替换为你在该页面获取的真实密钥。

与微信读书 Skill 的配合¶

本 Skill 不负责替代微信读书数据接口。文档要求先安装并配置微信读书 Skill，再导出书架与笔记 JSON。若你使用文档中的 lark-cli 集成，可先执行微信读书侧命令拉数；在 Cursor 等仅加载 Skill 目录的场景下，等价做法是：用已配置的微信读书 Skill 导出 shelf.json、notes.json，再调用本包内生成脚本（见下一节）。

典型用法¶

1. 获取个人阅读数据¶

文档示例（需已配置 WEREAD_API_KEY 且具备 lark-cli 与对应 Skill 插件时）：

# 获取已读完的书籍列表
lark-cli +weread-skills shelf --finished

# 获取笔记数据
lark-cli +weread-skills notes --export

将导出的 JSON 放到工作目录，例如 data/shelf.json、data/notes.json。文档强调必须使用你自己的微信读书数据，勿共用他人数据文件。

2. 生成 HTML 报告¶

在 Skill 安装目录下（或把路径换成你本机安装位置），用 Node 运行生成器：

node scripts/generate-report.js --shelf data/shelf.json --notes data/notes.json

generate-report.js 支持 --output 指定输出路径；未指定时，文档说明默认输出到桌面。仅书架、无笔记时，可省略 --notes。

若环境已集成 lark-cli 的 +weread-persona 命令，也可使用文档中的简化入口：

lark-cli +weread-persona analyze --shelf shelf.json --notes notes.json --output ./report.html

3. 在 Agent 对话中使用¶

安装到 Cursor skills 目录并重启或刷新 Agent 后，可直接用自然语言描述需求，例如：根据我导出的微信读书书架和笔记 JSON，按本 Skill 的六维框架生成阅读人格分析 HTML。Agent 会读取 SKILL.md 中的判定规则与报告结构，并调用 generate-report.js 完成产出。

适用场景与注意¶

适合谁

• 希望把微信读书里的读完记录、笔记密度、领域分布，整理成一份可分享的 HTML 阅读画像。
• 需要在团队或内容创作场景下，用统一六维框架描述「阅读人格」，而不是每次手写总结。

限制与注意

• API Key 与隐私：标签 requires_api_key=true；数据来自个人账号，生成前应确认 JSON 路径正确且不对外泄露。
• 前置 Skill：必须能通过微信读书 Skill 拿到合法数据；仅有本 Skill 而无 Key 或数据源时无法分析。
• 运行环境：报告生成依赖 Node.js 16+；在沙箱或离线环境需自行保证能读取本地 JSON 并写入输出路径。
• 版本与统计：以 SkillHub 登记为准，当前 v1.0.3；页面统计为评分 100000、下载 2238（统计会随时间变化，写作时以 SkillHub 页面为准）。

结尾¶

「微信读书阅读人格分析」把微信读书数据、六维人格框架和 HTML 模板固定成可复用 Skill：配置 Key、导出 JSON、运行 generate-report.js（或由 Agent 代跑），即可得到结构化阅读人格报告。官方 SkillHub 页面：https://www.skillhub.cn/skills/user_2d8804af/gzh-skill-wxread-persona ；API 登记地址：https://api.skillhub.cn/user_2d8804af/gzh-skill-wxread-persona 。