What makes weread-ai-brain notable?

1.1K downloads. Trust evidence available

How should weread-ai-brain be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

weread-ai-brain

微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。 Skill: weread-ai-brain Owner: yamyeed Summary: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-09-20T08:38:59.544Z | user Use a locale-neutral system font stack so the dashboard language is determined only by the user's select

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.0.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.9release · observed Sep 20, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17fq0eznz5phgyqsyf9fv3qg1844sq9:weread-ai-brain

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/snapshot"

Documentation

CLAWHUB

144,877 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: weread-ai-brain
description: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。
allowed-tools: Bash(python3 ./tools/fetch_weread.py:*)
permissions:
  - network
  - env
metadata:
  openclaw:
    requires:
      env:
        - WEREAD_API_KEY
      bins:
        - python3
    primaryEnv: WEREAD_API_KEY
    envVars:
      - name: WEREAD_API_KEY
        required: true
    homepage: https://github.com/yamyeed/weread-ai-brain
---

# WeRead AI Brain — 微信读书 AI 阅读外脑

## 你是谁

你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：

1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）
2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）
3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）

你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。

## 触发与隐私边界

仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。

在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。

本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。

## 环境变量

- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。

---

## 数据获取：官方网关规范

微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。

- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）
- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`
- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`
- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。

### API 映射表

| 用途 | `api_name` | 附加参数 | 备注 |
|:--|:--|:--|:--|
| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |
| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:"overall"` |
| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |
| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |
| 书籍详情 | `/book/info` | `bookId` | — |
| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |
| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |
| 阅读进度 | `/book/getprogress` | `bookId` | — |

### 辅助脚本隐私闸门

`tools/fetch_weread.py` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。

```bash
python3 ./tools/fetch_weread.py --confirm-private-data bookmarks "$BOOK_ID"
```

脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。

---

## 能力一：数据可视化看板

### 模式 A：Markdown 看板（默认）

明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」

在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。

### 模式 B：HTML 卡片看板（可选）

明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」

根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。

#### HTML 看板模板规范

生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和

README.md

# WeRead AI Brain — 微信读书 AI 阅读外脑

> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识

你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？

读完的书像水过鸭背，划过的线再也没看过第二眼？

书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？

**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。

---

## 🧠 它能做什么？

三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：

### 📊 看得见 — 数据可视化看板

把沉睡在微信读书里的数据变成一眼就能读懂的看板：

**12 周阅读打卡绿墙**
GitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。

**24h 阅读脑波频段**
统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。

**知识品类光谱 + AI 认知盲区诊断**
统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。

**WeRead-MBTI 阅读灵魂卡片**
4 个维度、16 种阅读人格，你是哪种？

| 维度 | 含义 | 判定逻辑 |
|:--|:--|:--|
| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |
| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |
| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |
| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |

16 型人格各有灵魂判词，比如：
- **BLAS**「终身创业体验卡持有者」— "刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。"
- **DLAT**「方法论无情推土机」— "早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。"
- **DHRS**「失眠夜的灵魂漫游者」— "不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。"

**AI 深度分析卡片（v2.0.0 新增）**
看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。

**双模式输出**
- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互
- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令

---

### 🧠 想得深 — AI 深度分析

同一本书，换个视角就是不同的世界。三种专业分析模板：

**📖 概念通解**
遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ "就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。"

**📋 PM 拆解**
产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。

**⚖️ 法务排雷**
合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。

**上下文联动**
分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。

**跨书关联**
指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？

---

### 📝 带得走 — 知识重构与导出

**语义笔记聚类**
跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。

**单书分析导出**
分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。

---

## 🔧 技术实现

**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。

**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。

**支持的 API**：

| 用途 | 接口 |
|:--|:--|
| 书架列表 | `/shelf/sync` |
| 阅读统计 | `/readdata/summary`、`/readdata/detail` |
| 搜索书籍 | `/store/search` |
| 书籍详情 | `/book/info` |
| 划线笔记 | `/book/bookmarklist` |
| 个人想法 | `/review/list/mine` |
| 阅读进度 | `/book/getprogress` |

**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。

**安全边界**：

- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。
- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。
- Skill 元数据显式声明只允许调用本地 `tools/fetch_weread.py`，只读取 `WEREAD_API_KEY`，且网络请求仅可 POST 到 `i.weread.qq.com`。
- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。
- 保存 HTML、Markdown 等

_meta.json

{
  "ownerId": "kn7bebt8x8xc0m1wxebhyap9yd82b19p",
  "slug": "weread-ai-brain",
  "version": "1.0.9",
  "publishedAt": 1789893539544
}

skill-card.md

## Description:

WeRead AI Brain analyzes a user's WeRead shelf, reading statistics, highlights, and personal thoughts to produce reading dashboards, book analyses, cross-book connections, and optional Markdown or HTML exports after user confirmation.

This skill is ready for commercial/non-commercial use.

## Publisher:

[yamyeed](https://clawhub.ai/user/yamyeed)

### License/Terms of Use:

MIT

## Use Case:

External users and developers use this skill to turn WeRead activity, highlights, and personal notes into readable dashboards, focused book analysis, cross-book synthesis, and portable note exports. The skill is intended for user-approved WeRead workflows that may require a WeRead API key and access to private reading data.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can access private WeRead shelf data, reading statistics, highlights, personal thoughts, and a WeRead API key.

Mitigation: Use the skill only after the user confirms the data scope; keep the API key in WEREAD_API_KEY and send it only to the WeRead official HTTPS gateway.

Risk: Markdown or HTML exports may contain private reading notes, highlights, or analysis derived from those notes.

Mitigation: Confirm the export content and path before writing files, and avoid exporting unless the user explicitly requests it.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)
- [Project homepage](https://github.com/yamyeed/weread-ai-brain)
- [WeRead API gateway](https://i.weread.qq.com/api/agent/gateway)

## Skill Output:

**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]

**Output Format:** [Markdown responses, optional Markdown files, optional single-file HTML dashboards, and JSON API data used for analysis]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May require WEREAD_API_KEY and explicit confirmation before fetching private WeRead data or writing exports.]

## Skill Version(s):

1.0.9 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

LICENSE

MIT License

Copyright (c) 2026 weread-ai-brain contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.