360 Secure SkillHub
360 安全技能中心

Weread Reading Recommender

本地优先技能：用本地 Cookie 通过 Python 脚本导出微信读书原始记录并归一化为 JSON，分析高互动、近期与未读完书目，结合学习目标或历史偏好给出稳妥与探索型推荐；Cookie 仅限本地使用。Lint 提示指令存在矛盾。

cengsin
cengsin
热度 80.80
最近更新 2026-05-11 17:33:49
分类：知识依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：推荐 / 数据处理 / 研究 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add weread-reading-recommender
Metadata
name
weread-reading-recommender
description
Use this skill when the user wants to export local WeRead records, normalize WeRead data, analyze reading preferences from WeRead history, or get book recommendations grounded in WeRead reading behavior and a current learning goal.

WeRead Reading Recommender

Overview

This is a local-first skill for exporting 微信读书 (WeRead) records from a cookie stored on the user's machine, normalizing those records into a recommendation-friendly JSON file, and using that data to analyze reading preferences or recommend what to read next.

Use this skill when the user wants to:

  • 根据微信读书记录推荐书
  • 分析自己的阅读偏好或阅读画像
  • 结合“最近想学的主题”与微信读书历史一起做推荐
  • 导出、刷新、归一化本地微信读书数据

Trigger Cases

Activate this skill for requests like:

  • “根据我的微信读书记录推荐书”
  • “分析我的阅读偏好”
  • “我最近想系统学 AI Agent，结合微信读书记录推荐 5 本书”
  • “帮我导出 / 刷新 / 归一化微信读书数据”
  • “基于我的阅读历史，推荐下一本最适合现在读的书”
  • “分析我的阅读偏好，并给我 3 本稳妥推荐 + 2 本探索推荐”

Workflow

Follow this sequence:

  1. Check whether a normalized JSON file already exists.
  2. If normalized data is missing, or the user explicitly wants fresh data, check whether a local WeRead cookie is already available.
  3. Look for a local cookie source in this order:
    • a cookie file path explicitly provided by the user
    • WEREAD_COOKIE
    • another env var name passed through --env-var
  4. If no local cookie source exists, ask the user to set one locally and stop there. Do not tell the user to edit SKILL.md.
  5. If a local cookie source exists, run the export script.
  6. Run the normalize script on the raw export.
  7. Read the normalized JSON and identify strong signals:
    • high-engagement books
    • recent books
    • unfinished books with momentum
    • repeated categories or lists
  8. If the user provides a current goal, weight goal fit first.
  9. If the user does not provide a goal, produce a reading-profile summary plus safe and exploratory recommendations.

Recommendation Guidance

When the user provides a current goal, weight approximately:

  • 60% goal fit
  • 40% history fit

When the user provides no goal, weight approximately:

  • 70% history fit
  • 20% recency
  • 10% exploration/diversity

For each recommendation, explain:

  • why it fits the user's current goal or history
  • which past books it resembles
  • what gap it fills
  • whether it is a safe pick or an exploration pick
  • whether it is a good fit right now

Suggested response structure:

  • 阅读画像 / Reading profile
  • 推荐结果 / Recommendations
  • 为什么适合现在 / Why now
  • 暂缓推荐 / Skip for now (optional)

Local Data Workflow

1. Check local cookie availability first

Before asking the user to set anything, first check whether a local cookie is already available through:

  • a cookie file path the user provided
  • WEREAD_COOKIE
  • another env var name passed through --env-var

If none of these exist, ask the user to set the cookie locally, then continue.

2. Export raw WeRead data

If a local cookie is already available, export directly:

python3 scripts/export_weread.py --out data/weread-raw.json

Optional variants:

python3 scripts/export_weread.py --cookie-file ~/.config/weread.cookie --out data/weread-raw.json
python3 scripts/export_weread.py --env-var WEREAD_COOKIE --include-book-info --detail-limit 50 --out data/weread-raw.json

If the user does need to set one manually, keep it local. For example:

export WEREAD_COOKIE='wr_skey=...; wr_vid=...; ...'

3. Normalize the raw export

python3 scripts/normalize_weread.py --input data/weread-raw.json --output data/weread-normalized.json

4. Use the normalized file for recommendation turns

After normalization, this skill should reason primarily from the normalized JSON, not from a live cookie session, unless the user explicitly asks for a refresh.

Security Boundary

This skill is local-first. Enforce these rules:

  • Cookie is for local use only.
  • Never write the cookie into SKILL.md, scripts, assets, logs, or exported JSON.
  • Never echo the cookie back in responses.
  • Prefer checking existing local cookie sources before asking the user to set one again.
  • Do not rely on CookieCloud or any third-party cookie sync service by default.
  • Do not suggest remote cookie hosting as the normal path.
  • Recommendation work should use the normalized JSON whenever possible.

Files

Use these project files as the main references:

  • scripts/export_weread.py
  • scripts/normalize_weread.py
  • references/data-schema.md
  • references/privacy-model.md
  • references/recommendation-rubric.md
  • assets/sample-weread-raw.json
  • assets/sample-weread-normalized.json

Example Requests

  • 结合我的微信读书记录，我最近想系统学 AI Agent，推荐 5 本书
  • 基于我的阅读历史，推荐下一本最适合现在读的书
  • 分析我的阅读偏好，并给我 3 本稳妥推荐 + 2 本探索推荐
  • 帮我刷新微信读书数据，然后按最近在读主题推荐下一批书