SuperAPI AI 工具集

yao-weread-skill

写作与研究

查看项目

更新于 10-16 09:35

技能介绍

用途:从微信读书账号数据生成精排中文HTML阅读报告,默认范围为截至今天的最近24个月,用于分析阅读历史、读书报告、阅读统计可视化,以及笔记、书架、词云、热力图、雷达图展示,也支持创建AI创业者示例阅读报告。不用于通用图书推荐,也不做不生成报告的原始API查询。

主要能力与输出:流程生成 weread-report.html(交互式HTML报告)、weread-report-data.json(聚合图表数据)、weread-raw-summary.json(不含密钥的API结构与计数摘要)。报告含读者画像模块,包括顶部诗性总结、1条画像金句,以及从近两年划线中筛选的最多20条高价值句子。

使用方式:需设置环境变量 WEREAD_API_KEY;可选 --years、--start、--end 控制范围,--max-note-books 控制笔记深度(省略或0处理全部笔记书籍),以及输出目录。示例模式用 --sample-ai-founder --sample-scale 5,无需 API key。常用命令为 python3 scripts/generate_weread_report.py --output reports/generated,可加 --years 2 --max-note-books 0。运行前需阅读微信读书 skill 文档(shelf.md、readdata.md、notes.md、book.md)。生成后需检查HTML至少包含20个图表面板、无占位文本或内嵌API key,并检查高密度图表布局与读者画像。

限制与边界:真实账号模式不编造不存在的阅读事件、笔记文本、评分或分类;不导出书籍全文,仅用用户自己的划线/想法及可访问元数据;不存储或打印 WEREAD_API_KEY;无法获得精确滚动日期边界时须标注月度或年度近似口径;报告产物除非用户明确要求分享或发布,否则视为私有内容。视觉验证可用浏览器检查桌面、平板和窄屏宽度。报告设计与图表规范分别遵循 references/report-design.md 与 references/chart-catalog.md,数据语义遵循 references/data-contract.md。