{"id":"8dbeb085-a708-4aa0-acc4-7b54fcc8f599","entityType":"agent","slug":"clawhub-yamyeed-weread-ai-brain","name":"weread-ai-brain","canonicalUrl":"https://www.xpersona.co/agent/clawhub-yamyeed-weread-ai-brain","canonicalPath":"/agent/clawhub-yamyeed-weread-ai-brain","generatedAt":"2026-10-11T11:27:02.687Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T08:53:54.904Z","emptyReason":null},"description":"微信读书/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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17fq0eznz5phgyqsyf9fv3qg1844sq9:weread-ai-brain","sourceUrl":"https://clawhub.ai/yamyeed/weread-ai-brain","homepage":"https://clawhub.ai/yamyeed/skills/weread-ai-brain","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/yamyeed/weread-ai-brain","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/yamyeed/skills/weread-ai-brain","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:53:54.904Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:53:54.904Z","emptyReason":null},"stars":null,"forks":null,"downloads":1107,"packageName":null,"latestVersion":"1.0.9","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:53:54.889Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T08:53:54.904Z","lastCrawledAt":"2026-10-11T08:53:54.889Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T08:53:54.889Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.9","createdAt":"2026-09-20T08:38:59.544Z","changelog":"Use a locale-neutral system font stack so the dashboard language is determined only by the user's selected language data.","fileCount":7,"zipByteSize":29957},{"version":"1.0.8","createdAt":"2026-09-20T08:35:13.328Z","changelog":"Eliminate dashboard HTML injection by using one HTML-escaped JSON data block and textContent-only rendering, add a restrictive CSP, and make locale plus weekday labels explicitly user-selected.","fileCount":7,"zipByteSize":29963},{"version":"1.0.7","createdAt":"2026-09-20T08:21:47.565Z","changelog":"Declare the helper's network and environment capabilities explicitly so SkillSpector can verify least privilege while preserving the fixed WeRead gateway and user-consent gate.","fileCount":7,"zipByteSize":29299},{"version":"1.0.6","createdAt":"2026-09-20T08:11:22.522Z","changelog":"Address SkillSpector findings: replace shell/curl networking with a scoped Python helper, declare minimum tool and runtime requirements, remove hidden HTML comments, and localize dashboard language and UI text.","fileCount":7,"zipByteSize":29112},{"version":"1.0.5","createdAt":"2026-07-26T21:14:38.363Z","changelog":"Declare OpenClaw runtime requirements, enforce HTTPS/TLS fail-closed gateway access, and eliminate permissive or duplicate requests.","fileCount":8,"zipByteSize":40141},{"version":"1.0.4","createdAt":"2026-07-26T20:57:22.975Z","changelog":"Close the remaining audit findings: remove shell-based file opening and remote font requests, add a per-request private-data confirmation gate to the helper script, and fix 375px dashboard overflow.","fileCount":8,"zipByteSize":39292},{"version":"1.0.3","createdAt":"2026-07-26T20:42:40.453Z","changelog":"Align audit-safe skill with the canonical repository; document explicit WeRead triggers, consent before private context access, and confirmation before file writes or opening.","fileCount":8,"zipByteSize":38265},{"version":"1.0.2","createdAt":"2026-07-09T11:30:35.944Z","changelog":"audit safe","fileCount":3,"zipByteSize":11653}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17fq0eznz5phgyqsyf9fv3qg1844sq9:weread-ai-brain","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T11:27:02.683Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yamyeed-weread-ai-brain/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T08:53:54.904Z","emptyReason":null},"readme":"Skill: weread-ai-brain\n\nOwner: yamyeed\n\nSummary: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\n\nTags: latest:1.0.9\n\nVersion history:\n\nv1.0.9 | 2026-09-20T08:38:59.544Z | user\n\nUse a locale-neutral system font stack so the dashboard language is determined only by the user's selected language data.\n\nv1.0.8 | 2026-09-20T08:35:13.328Z | user\n\nEliminate dashboard HTML injection by using one HTML-escaped JSON data block and textContent-only rendering, add a restrictive CSP, and make locale plus weekday labels explicitly user-selected.\n\nv1.0.7 | 2026-09-20T08:21:47.565Z | user\n\nDeclare the helper's network and environment capabilities explicitly so SkillSpector can verify least privilege while preserving the fixed WeRead gateway and user-consent gate.\n\nv1.0.6 | 2026-09-20T08:11:22.522Z | user\n\nAddress SkillSpector findings: replace shell/curl networking with a scoped Python helper, declare minimum tool and runtime requirements, remove hidden HTML comments, and localize dashboard language and UI text.\n\nv1.0.5 | 2026-07-26T21:14:38.363Z | user\n\nDeclare OpenClaw runtime requirements, enforce HTTPS/TLS fail-closed gateway access, and eliminate permissive or duplicate requests.\n\nv1.0.4 | 2026-07-26T20:57:22.975Z | user\n\nClose the remaining audit findings: remove shell-based file opening and remote font requests, add a per-request private-data confirmation gate to the helper script, and fix 375px dashboard overflow.\n\nv1.0.3 | 2026-07-26T20:42:40.453Z | user\n\nAlign audit-safe skill with the canonical repository; document explicit WeRead triggers, consent before private context access, and confirmation before file writes or opening.\n\nv1.0.2 | 2026-07-09T11:30:35.944Z | user\n\naudit safe\n\nv1.0.0 | 2026-07-02T07:44:59.804Z | auto\n\nweread-ai-brain 2.0.0 introduces a powerful overhaul transforming your WeRead data into comprehensive AI-driven insights and visual dashboards.\n\n- 全面升级三大能力：可视化看板、AI 深度分析、知识重构导出\n- 新增支持 Markdown 和精美 HTML 看板（深色/亮色，响应式与主题切换）\n- 六大可视化模块：核心指标、12周绿墙热力图、24小时脑波图、知识品类光谱+AI认知盲区、MBTI 灵魂卡片、AI 分析卡片\n- 全面接入微信读书官方Skill API（POST统一网关，专属API Key流程指引）\n- 明确模板规范、CSS设计、数据占位符、条件渲染等前后端要求\n- 详细规范触发词、模块内容与算法规则，支持结构化导出与后续扩展\n\nArchive index:\n\nArchive v1.0.9: 7 files, 29957 bytes\n\nFiles: LICENSE (1085b), README.md (10837b), skill-card.md (2333b), SKILL.md (26529b), templates/dashboard.html (39029b), tools/fetch_weread.py (5180b), _meta.json (134b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\nallowed-tools: Bash(python3 ./tools/fetch_weread.py:*)\npermissions:\n  - network\n  - env\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - WEREAD_API_KEY\n      bins:\n        - python3\n    primaryEnv: WEREAD_API_KEY\n    envVars:\n      - name: WEREAD_API_KEY\n        required: true\n    homepage: https://github.com/yamyeed/weread-ai-brain\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.py` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\npython3 ./tools/fetch_weread.py --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。仅使用操作系统自带的无衬线与等宽字体栈，不加载远程字体或其他第三方资源。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用系统等宽字体大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果以纯文本展示并保留换行和 Markdown 标记，不把外部内容转换为可执行 HTML。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**安全数据注入**：模板只有 `{{DASHBOARD_DATA_JSON_ESCAPED_FOR_HTML}}` 一个数据占位符。先把完整数据对象序列化为 JSON，再将 `<`、`>`、`&`、U+2028、U+2029 分别替换为 `\\\\u003c`、`\\\\u003e`、`\\\\u0026`、`\\\\u2028`、`\\\\u2029`，最后替换该占位符。不要直接替换其他 HTML 或 JavaScript 片段。模板只用 `textContent` 和受限 DOM API 渲染外部字段。\n\n**语言选择**：数据对象中的 `lang` 与 `ui` 必须按用户明确选择的语言生成；用户未指定时，沿用当前对话语言。`ui.weekdays` 也必须本地化。模板初始使用中性的 `lang=\"und\"`，加载数据后才设置用户选择的 BCP 47 标签，不固定任何语言或地区。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `analysis.bookTitle` 为空，则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板只使用一个安全数据占位符：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{DASHBOARD_DATA_JSON_ESCAPED_FOR_HTML}}` | 经上述 HTML 安全转义后的完整 JSON 对象；不得放入原始 JSON、HTML 或脚本 |\n\n数据对象包含：\n\n- `lang`：用户选择或当前对话语言对应的 BCP 47 标签。\n- `ui`：本地化界面标签，包含 `weekdays` 七项数组、`weekPrefix`、`bookUnit` 和所有标题、指标、区块、图例文案。\n- `userName`、`date`、`metrics`：用户昵称、日期与四项核心指标。\n- `wall`、`brainwave`、`spectrum`：绿墙二维数组、24 小时数组与 `[{name, pct, count}]`。\n- `diagnosisText`、`recommendedBooks`：诊断与推荐书单文本。\n- `mbti`：`code`、`personaName`、`personaQuote`、`recentBook`、`dimensions`。\n- `analysis`：`bookTitle`、`bookAuthor`、`templateType`、`templateKind`（`concept` / `pm` / `legal`）、`excerpt`、`result`、`context`（`[{chapter, text, thought}]`）。\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。保存完成后只报告路径，不要执行系统命令打开文件。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\n三种专业视角，让同一本书产生不同层次的洞察：\n\n#### 📖 概念通解\n\n```\n你是一位博学且通俗易懂的学术导师。请帮我深入剖析下面这段话的核心概念，并用日常通俗的类比解释它：\n```\n\n适用场景：遇到陌生概念、抽象理论、技术术语时，快速建立直觉理解。\n\n#### 📋 PM 拆解\n\n```\n你是一位资深产品总监。请以产品经理的视角分析这段话包含的【业务逻辑/用户痛点/产品功能点】，并给出你可以想到的2个改进建议或竞品思路：\n```\n\n适用场景：读商业书、产品书、案例分析时，提取可落地的方法论和产品洞察。\n\n#### ⚖️ 法务排雷\n\n```\n你是一位专业的互联网合规律师。请分析这段内容中潜在的【法务合规风险/数据隐私隐患/违约漏洞】，并用大白话指出需要避开的坑：\n```\n\n适用场景：读合同、条款、商业案例时，识别法律风险和合规盲点。\n\n### 上下文联动\n\n分析时默认只使用用户提供的文本和指定书籍的必要信息。只有在用户明确同意“结合这本书的历史划线/想法”时，才拉取该书的历史划线和想法作为上下文。\n\n**流程**：\n1. 确定目标书籍（用户指定书名 → 搜索获取 bookId；或未指定 → 询问用户要分析哪本书）\n2. 说明即将读取该书划线和个人想法，并取得用户确认\n3. 调用 `/book/bookmarklist` 获取该书划线\n4. 调用 `/review/list/mine` 获取该书想法\n5. 只选取与当前分析最相关的上下文（最多 8 条）拼入分析 prompt，标注来源章节\n\n**上下文注入格式**：\n\n```\n【该书历史划线/想法上下文】\n\n1. 第{N}章 {章节名}\n   > {划线文本}\n   💭 {想法内容}\n\n2. ...\n\n请结合以上上下文进行分析。若上下文不相关，请明确说明，不要编造。\n```\n\n### 跨书关联\n\n明确触发词：「微信读书跨书关联」/「WeRead 跨书关联」/「微信读书关联分析」\n\n当用户想看多个主题之间的关联时，拉取多本相关书籍的笔记进行交叉分析：\n\n1. 根据用户指定的主题或关键词，从书架中找到相关书籍（2-5 本）\n2. 向用户列出将读取的书名和数据范围，取得确认\n3. 分别获取每本书的划线和想法\n4. 找出跨书的概念关联、矛盾观点、递进关系\n5. 输出关联图谱和分析\n\n**输出格式**：\n\n```\n🔗 跨书关联分析：{主题}\n\n📖 关联书籍：\n  1. 《{书A}》— {与主题的关联}\n  2. 《{书B}》— {与主题的关联}\n\n🎯 核心关联发现：\n  {跨书概念映射}\n\n⚡ 观点碰撞：\n  《{书A}》认为 {...}，而《{书B}》认为 {...}\n\n📈 递进关系：\n  从《{书A}》的{概念} → 到《{书B}》的{概念}，体现了 {...}\n```\n\n---\n\n## 能力三：知识重构与导出\n\n### 语义笔记聚类\n\n明确触发词：「微信读书导出笔记」/「WeRead 语义笔记」/「微信读书语义聚类」\n\n跨书按核心概念聚合划线，输出 Obsidian 友好的 Markdown。执行前必须说明将聚合哪些书、包含哪些划线/想法摘要、保存到哪个路径，并取得用户确认。\n\n```markdown\n---\nsource: weread-ai-brain\ntype: semantic-cluster\nconcept: {核心概念}\nbooks:\n  - {书名1}\n  - {书名2}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# {核心概念}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n---\n\n**AI 洞察**：{跨书综合分析}\n```\n\n### 单书分析导出\n\n分析完成后，可在用户明确要求时导出为 Markdown 文件。导出前说明文件包含原文摘录、AI 分析和上下文摘要，并询问保存路径；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。\n\n```markdown\n---\nsource: weread-ai-brain\nbook: {书名}\ntemplate: {概念通解/PM拆解/法务排雷}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# 📖 {书名} — {分析模板名}\n\n## 原文摘录\n> {用户划线文本}\n\n## AI 深度分析\n{分析结果}\n\n## 上下文关联\n- 第{N}章 {章节名}：{关联划线摘要}\n```\n\n---\n\n## 完整触发词表\n\n| 触发词 | 能力 | 模块 |\n|:--|:--|:--|\n| \"微信读书生成看板\" / \"WeRead 生成看板\" / \"微信读书 dashboard\" | Markdown 完整看板（5 模块） | 可视化 |\n| \"微信读书生成 HTML 看板\" / \"WeRead HTML 看板\" / \"微信读书卡片版\" | HTML 卡片看板，保存前确认 | 可视化 |\n| \"微信读书阅读打卡\" / \"WeRead 绿墙\" | 12 周打卡绿墙 | 可视化 |\n| \"微信读书习惯分析\" / \"WeRead 黄金时段\" | 24h 脑波频段图 | 可视化 |\n| \"微信读书盲区分析\" / \"WeRead 偏科分析\" | 知识光谱 + 认知盲区诊断 | 可视化 |\n| \"微信读书阅读人格\" / \"WeRead MBTI\" | WeRead-MBTI 灵魂卡片 | 可视化 |\n| \"微信读书分析《书名》\" / \"WeRead 概念通解《书名》\" | 用概念通解模板分析指定书或片段 | AI 分析 |\n| \"微信读书 PM 拆解《书名》\" / \"WeRead 产品拆解《书名》\" | 用 PM 拆解模板分析指定书或片段 | AI 分析 |\n| \"微信读书法务排雷《书名》\" / \"WeRead 合规分析《书名》\" | 用法务排雷模板分析指定书或片段 | AI 分析 |\n| \"微信读书跨书关联\" / \"WeRead 跨书关联\" / \"微信读书关联分析\" | 多本书笔记交叉分析，读取前确认 | AI 分析 |\n| \"微信读书导出笔记\" / \"WeRead 语义笔记\" | 跨书语义聚类 Markdown，导出前确认 | 知识导出 |\n| \"微信读书导出分析\" / \"WeRead 导出当前分析\" | 导出当前分析为 Markdown 文件，导出前确认 | 知识导出 |\n\n### 分析交互流程\n\n当用户触发分析类命令时：\n\n1. **确定目标书**：\n   - 用户指定书名 → 调用 `/store/search` 获取 bookId\n   - 用户未指定 → 询问用户要分析哪本书，不要默认读取在读第一本\n2. **选择分析模板**：\n   - 用户已通过触发词指定模板 → 直接使用\n   - 用户只说通用的“分析”或“拆解”且没有提到微信读书/WeRead → 不触发本 skill\n3. **拉取上下文**：\n   - 先告知将读取该书划线和个人想法，并取得用户确认\n   - 调用 `/book/bookmarklist` 获取划线\n   - 调用 `/review/list/mine` 获取想法\n   - 选取与当前分析最相关的上下文（最多 8 条）\n4. **执行分析**：将模板 prompt + 用户关注的文本 + 上下文一起发给 AI\n5. **输出结果**：在 session 中输出分析，提示可以导出\n\n---\n\n## 首次使用引导\n\n如果未设置 `WEREAD_API_KEY`：\n\n```\n👋 欢迎使用 WeRead AI Brain！\n\n获取 API Key：\n1. 打开手机「微信读书 App」\n2. 点击「我」→ 右上角「设置 ⚙️」→「微信读书 Skill」\n3. 扫码登录后，复制以 wrk- 开头的 API Key\n\n配置：\n  export WEREAD_API_KEY=wrk-你的密钥\n\n完成后说「微信读书生成看板」看数据，或说「微信读书分析《书名》」让 AI 帮你深度思考。\n```\n\n---\n\n## 注意事项\n\n- 所有 API 请求均通过 `https://i.weread.qq.com/api/agent/gateway` POST 网关发出，禁止直接 GET 请求原始接口。\n- 若鉴权失败（errcode: -2010），引导用户重新获取 Key。\n- Markdown 看板输出时，确保 ASCII 图表在终端和 Markdown 渲染器中均对齐良好。\n- 分析时若上下文为空或不相关，明确说明，不要编造关联。\n- 上下文联动必须经用户确认，且最多选取 8 条相关划线/想法，避免 prompt 过长。\n- 导出文件必须经用户确认；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录，文件名格式 `weread-{类型}-{日期}.md`。\n- 不要执行系统命令打开浏览器或本地文件；保存完成后只报告路径。\n\nFile v1.0.9:README.md\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- Skill 元数据显式声明只允许调用本地 `tools/fetch_weread.py`，只读取 `WEREAD_API_KEY`，且网络请求仅可 POST 到 `i.weread.qq.com`。\n- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。\n- 保存 HTML、Markdown 等本地文件前，会说明内容与路径并等待确认；默认建议保存到当前工作区的 `outputs/` 或 `weread-exports/`。\n- 生成的文件不会通过系统命令自动打开；HTML 模板仅使用系统字体，不加载 Google Fonts 等第三方资源。\n\n辅助脚本也有独立隐私闸门：联网命令必须显式传入 `--confirm-private-data`，且会在请求前显示微信读书官方网关地址和本次数据范围。只有用户已经确认该次读取后才能传入此参数。\n\n---\n\n## 🚀 快速开始\n\n1. 获取 API Key：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码\n2. 配置：`export WEREAD_API_KEY=wrk-你的密钥`\n3. 开始使用：\n   - 「微信读书生成看板」— 查看完整数据看板\n   - 「微信读书分析《启示录》」— AI 深度分析指定书籍\n   - 「WeRead PM 拆解《启示录》」— 产品经理视角拆解指定书籍\n   - 「微信读书跨书关联」— 多本书交叉分析，读取前确认\n   - 「微信读书导出笔记」— 语义聚类导出，写入前确认\n\n---\n\n## 📋 完整触发词\n\n| 触发词 | 能力 |\n|:--|:--|\n| 微信读书生成看板 / WeRead 生成看板 / 微信读书 dashboard | Markdown 完整看板 |\n| 微信读书生成 HTML 看板 / WeRead HTML 看板 / 微信读书卡片版 | HTML 卡片看板，保存前确认 |\n| 微信读书阅读打卡 / WeRead 绿墙 | 12 周打卡绿墙 |\n| 微信读书习惯分析 / WeRead 黄金时段 | 24h 脑波频段 |\n| 微信读书盲区分析 / WeRead 偏科分析 | 认知盲区诊断 + 推荐书单 |\n| 微信读书阅读人格 / WeRead MBTI | 阅读灵魂卡片 |\n| 微信读书分析《书名》 / WeRead 概念通解《书名》 | 概念通解模板分析 |\n| 微信读书 PM 拆解《书名》 / WeRead 产品拆解《书名》 | PM 拆解模板分析 |\n| 微信读书法务排雷《书名》 / WeRead 合规分析《书名》 | 法务排雷模板分析 |\n| 微信读书跨书关联 / WeRead 跨书关联 | 多书交叉分析，读取前确认 |\n| 微信读书导出笔记 / WeRead 语义笔记 | 语义聚类导出，写入前确认 |\n| 微信读书导出分析 / WeRead 导出当前分析 | 单书分析导出，写入前确认 |\n\n---\n\n## 🆕 版本历史\n\n- **ClawHub 1.0.9** — 使用中性系统字体栈，移除模板中的地区特定字体优先级\n- **ClawHub 1.0.8** — 使用单一安全 JSON 数据块与 `textContent` 渲染，修复本地看板注入风险；语言和星期标签由用户选择的数据对象提供\n- **ClawHub 1.0.7** — 为 Python 辅助脚本显式声明最小 `network` 与 `env` 能力，关闭 SkillSpector LP1\n- **ClawHub 1.0.6** — 修复 SkillSpector 告警；补齐最小权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.4** — 补齐最小工具与网络权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.3** — 补齐 ClawHub/OpenClaw 运行时元数据；官方网关请求改为 HTTPS/TLS 严格失败关闭并移除宽松重试\n- **2.0.2** — 移除系统打开命令与远程字体依赖；辅助脚本增加逐次隐私告知、显式确认和最小范围读取闸门\n- **2.0.1** — 收紧 Skill 触发范围；读取历史/跨书笔记和导出文件前增加明确告知与确认；默认导出到工作区\n- **2.0.0** — 新增 AI 深度分析（概念通解、PM 拆解、法务排雷、上下文联动、跨书关联）、知识导出、HTML 卡片看板 AI 分析卡片\n- **1.0.0** — 首版，数据可视化看板（绿墙、脑波、光谱、MBTI）\n\n---\n\n## 💡 适合谁用？\n\n- **重度微信读书用户** — 划了几百条线却从没复盘过的人\n- **知识管理爱好者** — 用 Obsidian/Notion 做笔记，想把微信读书数据接进来的人\n- **产品经理/创业者** — 想从商业书里提取可落地方法论的人\n- **跨领域学习者** — 想知道自己知识盲区在哪、该补什么的人\n- **阅读习惯优化者** — 想找到黄金阅读时段、建立打卡节奏的人\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1789893539544\n}\n\nFile v1.0.9:skill-card.md\n\n## Description:\n\nWeRead 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.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yamyeed](https://clawhub.ai/user/yamyeed)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can access private WeRead shelf data, reading statistics, highlights, personal thoughts, and a WeRead API key.\n\nMitigation: 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.\n\nRisk: Markdown or HTML exports may contain private reading notes, highlights, or analysis derived from those notes.\n\nMitigation: Confirm the export content and path before writing files, and avoid exporting unless the user explicitly requests it.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)\n- [Project homepage](https://github.com/yamyeed/weread-ai-brain)\n- [WeRead API gateway](https://i.weread.qq.com/api/agent/gateway)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown responses, optional Markdown files, optional single-file HTML dashboards, and JSON API data used for analysis]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May require WEREAD_API_KEY and explicit confirmation before fetching private WeRead data or writing exports.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v1.0.9:LICENSE\n\nMIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.8: 7 files, 29963 bytes\n\nFiles: LICENSE (1085b), README.md (10737b), skill-card.md (2280b), SKILL.md (26529b), templates/dashboard.html (39083b), tools/fetch_weread.py (5180b), _meta.json (134b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\nallowed-tools: Bash(python3 ./tools/fetch_weread.py:*)\npermissions:\n  - network\n  - env\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - WEREAD_API_KEY\n      bins:\n        - python3\n    primaryEnv: WEREAD_API_KEY\n    envVars:\n      - name: WEREAD_API_KEY\n        required: true\n    homepage: https://github.com/yamyeed/weread-ai-brain\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.py` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\npython3 ./tools/fetch_weread.py --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。仅使用操作系统自带的无衬线与等宽字体栈，不加载远程字体或其他第三方资源。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用系统等宽字体大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果以纯文本展示并保留换行和 Markdown 标记，不把外部内容转换为可执行 HTML。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**安全数据注入**：模板只有 `{{DASHBOARD_DATA_JSON_ESCAPED_FOR_HTML}}` 一个数据占位符。先把完整数据对象序列化为 JSON，再将 `<`、`>`、`&`、U+2028、U+2029 分别替换为 `\\\\u003c`、`\\\\u003e`、`\\\\u0026`、`\\\\u2028`、`\\\\u2029`，最后替换该占位符。不要直接替换其他 HTML 或 JavaScript 片段。模板只用 `textContent` 和受限 DOM API 渲染外部字段。\n\n**语言选择**：数据对象中的 `lang` 与 `ui` 必须按用户明确选择的语言生成；用户未指定时，沿用当前对话语言。`ui.weekdays` 也必须本地化。模板初始使用中性的 `lang=\"und\"`，加载数据后才设置用户选择的 BCP 47 标签，不固定任何语言或地区。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `analysis.bookTitle` 为空，则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板只使用一个安全数据占位符：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{DASHBOARD_DATA_JSON_ESCAPED_FOR_HTML}}` | 经上述 HTML 安全转义后的完整 JSON 对象；不得放入原始 JSON、HTML 或脚本 |\n\n数据对象包含：\n\n- `lang`：用户选择或当前对话语言对应的 BCP 47 标签。\n- `ui`：本地化界面标签，包含 `weekdays` 七项数组、`weekPrefix`、`bookUnit` 和所有标题、指标、区块、图例文案。\n- `userName`、`date`、`metrics`：用户昵称、日期与四项核心指标。\n- `wall`、`brainwave`、`spectrum`：绿墙二维数组、24 小时数组与 `[{name, pct, count}]`。\n- `diagnosisText`、`recommendedBooks`：诊断与推荐书单文本。\n- `mbti`：`code`、`personaName`、`personaQuote`、`recentBook`、`dimensions`。\n- `analysis`：`bookTitle`、`bookAuthor`、`templateType`、`templateKind`（`concept` / `pm` / `legal`）、`excerpt`、`result`、`context`（`[{chapter, text, thought}]`）。\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。保存完成后只报告路径，不要执行系统命令打开文件。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\n三种专业视角，让同一本书产生不同层次的洞察：\n\n#### 📖 概念通解\n\n```\n你是一位博学且通俗易懂的学术导师。请帮我深入剖析下面这段话的核心概念，并用日常通俗的类比解释它：\n```\n\n适用场景：遇到陌生概念、抽象理论、技术术语时，快速建立直觉理解。\n\n#### 📋 PM 拆解\n\n```\n你是一位资深产品总监。请以产品经理的视角分析这段话包含的【业务逻辑/用户痛点/产品功能点】，并给出你可以想到的2个改进建议或竞品思路：\n```\n\n适用场景：读商业书、产品书、案例分析时，提取可落地的方法论和产品洞察。\n\n#### ⚖️ 法务排雷\n\n```\n你是一位专业的互联网合规律师。请分析这段内容中潜在的【法务合规风险/数据隐私隐患/违约漏洞】，并用大白话指出需要避开的坑：\n```\n\n适用场景：读合同、条款、商业案例时，识别法律风险和合规盲点。\n\n### 上下文联动\n\n分析时默认只使用用户提供的文本和指定书籍的必要信息。只有在用户明确同意“结合这本书的历史划线/想法”时，才拉取该书的历史划线和想法作为上下文。\n\n**流程**：\n1. 确定目标书籍（用户指定书名 → 搜索获取 bookId；或未指定 → 询问用户要分析哪本书）\n2. 说明即将读取该书划线和个人想法，并取得用户确认\n3. 调用 `/book/bookmarklist` 获取该书划线\n4. 调用 `/review/list/mine` 获取该书想法\n5. 只选取与当前分析最相关的上下文（最多 8 条）拼入分析 prompt，标注来源章节\n\n**上下文注入格式**：\n\n```\n【该书历史划线/想法上下文】\n\n1. 第{N}章 {章节名}\n   > {划线文本}\n   💭 {想法内容}\n\n2. ...\n\n请结合以上上下文进行分析。若上下文不相关，请明确说明，不要编造。\n```\n\n### 跨书关联\n\n明确触发词：「微信读书跨书关联」/「WeRead 跨书关联」/「微信读书关联分析」\n\n当用户想看多个主题之间的关联时，拉取多本相关书籍的笔记进行交叉分析：\n\n1. 根据用户指定的主题或关键词，从书架中找到相关书籍（2-5 本）\n2. 向用户列出将读取的书名和数据范围，取得确认\n3. 分别获取每本书的划线和想法\n4. 找出跨书的概念关联、矛盾观点、递进关系\n5. 输出关联图谱和分析\n\n**输出格式**：\n\n```\n🔗 跨书关联分析：{主题}\n\n📖 关联书籍：\n  1. 《{书A}》— {与主题的关联}\n  2. 《{书B}》— {与主题的关联}\n\n🎯 核心关联发现：\n  {跨书概念映射}\n\n⚡ 观点碰撞：\n  《{书A}》认为 {...}，而《{书B}》认为 {...}\n\n📈 递进关系：\n  从《{书A}》的{概念} → 到《{书B}》的{概念}，体现了 {...}\n```\n\n---\n\n## 能力三：知识重构与导出\n\n### 语义笔记聚类\n\n明确触发词：「微信读书导出笔记」/「WeRead 语义笔记」/「微信读书语义聚类」\n\n跨书按核心概念聚合划线，输出 Obsidian 友好的 Markdown。执行前必须说明将聚合哪些书、包含哪些划线/想法摘要、保存到哪个路径，并取得用户确认。\n\n```markdown\n---\nsource: weread-ai-brain\ntype: semantic-cluster\nconcept: {核心概念}\nbooks:\n  - {书名1}\n  - {书名2}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# {核心概念}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n---\n\n**AI 洞察**：{跨书综合分析}\n```\n\n### 单书分析导出\n\n分析完成后，可在用户明确要求时导出为 Markdown 文件。导出前说明文件包含原文摘录、AI 分析和上下文摘要，并询问保存路径；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。\n\n```markdown\n---\nsource: weread-ai-brain\nbook: {书名}\ntemplate: {概念通解/PM拆解/法务排雷}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# 📖 {书名} — {分析模板名}\n\n## 原文摘录\n> {用户划线文本}\n\n## AI 深度分析\n{分析结果}\n\n## 上下文关联\n- 第{N}章 {章节名}：{关联划线摘要}\n```\n\n---\n\n## 完整触发词表\n\n| 触发词 | 能力 | 模块 |\n|:--|:--|:--|\n| \"微信读书生成看板\" / \"WeRead 生成看板\" / \"微信读书 dashboard\" | Markdown 完整看板（5 模块） | 可视化 |\n| \"微信读书生成 HTML 看板\" / \"WeRead HTML 看板\" / \"微信读书卡片版\" | HTML 卡片看板，保存前确认 | 可视化 |\n| \"微信读书阅读打卡\" / \"WeRead 绿墙\" | 12 周打卡绿墙 | 可视化 |\n| \"微信读书习惯分析\" / \"WeRead 黄金时段\" | 24h 脑波频段图 | 可视化 |\n| \"微信读书盲区分析\" / \"WeRead 偏科分析\" | 知识光谱 + 认知盲区诊断 | 可视化 |\n| \"微信读书阅读人格\" / \"WeRead MBTI\" | WeRead-MBTI 灵魂卡片 | 可视化 |\n| \"微信读书分析《书名》\" / \"WeRead 概念通解《书名》\" | 用概念通解模板分析指定书或片段 | AI 分析 |\n| \"微信读书 PM 拆解《书名》\" / \"WeRead 产品拆解《书名》\" | 用 PM 拆解模板分析指定书或片段 | AI 分析 |\n| \"微信读书法务排雷《书名》\" / \"WeRead 合规分析《书名》\" | 用法务排雷模板分析指定书或片段 | AI 分析 |\n| \"微信读书跨书关联\" / \"WeRead 跨书关联\" / \"微信读书关联分析\" | 多本书笔记交叉分析，读取前确认 | AI 分析 |\n| \"微信读书导出笔记\" / \"WeRead 语义笔记\" | 跨书语义聚类 Markdown，导出前确认 | 知识导出 |\n| \"微信读书导出分析\" / \"WeRead 导出当前分析\" | 导出当前分析为 Markdown 文件，导出前确认 | 知识导出 |\n\n### 分析交互流程\n\n当用户触发分析类命令时：\n\n1. **确定目标书**：\n   - 用户指定书名 → 调用 `/store/search` 获取 bookId\n   - 用户未指定 → 询问用户要分析哪本书，不要默认读取在读第一本\n2. **选择分析模板**：\n   - 用户已通过触发词指定模板 → 直接使用\n   - 用户只说通用的“分析”或“拆解”且没有提到微信读书/WeRead → 不触发本 skill\n3. **拉取上下文**：\n   - 先告知将读取该书划线和个人想法，并取得用户确认\n   - 调用 `/book/bookmarklist` 获取划线\n   - 调用 `/review/list/mine` 获取想法\n   - 选取与当前分析最相关的上下文（最多 8 条）\n4. **执行分析**：将模板 prompt + 用户关注的文本 + 上下文一起发给 AI\n5. **输出结果**：在 session 中输出分析，提示可以导出\n\n---\n\n## 首次使用引导\n\n如果未设置 `WEREAD_API_KEY`：\n\n```\n👋 欢迎使用 WeRead AI Brain！\n\n获取 API Key：\n1. 打开手机「微信读书 App」\n2. 点击「我」→ 右上角「设置 ⚙️」→「微信读书 Skill」\n3. 扫码登录后，复制以 wrk- 开头的 API Key\n\n配置：\n  export WEREAD_API_KEY=wrk-你的密钥\n\n完成后说「微信读书生成看板」看数据，或说「微信读书分析《书名》」让 AI 帮你深度思考。\n```\n\n---\n\n## 注意事项\n\n- 所有 API 请求均通过 `https://i.weread.qq.com/api/agent/gateway` POST 网关发出，禁止直接 GET 请求原始接口。\n- 若鉴权失败（errcode: -2010），引导用户重新获取 Key。\n- Markdown 看板输出时，确保 ASCII 图表在终端和 Markdown 渲染器中均对齐良好。\n- 分析时若上下文为空或不相关，明确说明，不要编造关联。\n- 上下文联动必须经用户确认，且最多选取 8 条相关划线/想法，避免 prompt 过长。\n- 导出文件必须经用户确认；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录，文件名格式 `weread-{类型}-{日期}.md`。\n- 不要执行系统命令打开浏览器或本地文件；保存完成后只报告路径。\n\nFile v1.0.8:README.md\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- Skill 元数据显式声明只允许调用本地 `tools/fetch_weread.py`，只读取 `WEREAD_API_KEY`，且网络请求仅可 POST 到 `i.weread.qq.com`。\n- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。\n- 保存 HTML、Markdown 等本地文件前，会说明内容与路径并等待确认；默认建议保存到当前工作区的 `outputs/` 或 `weread-exports/`。\n- 生成的文件不会通过系统命令自动打开；HTML 模板仅使用系统字体，不加载 Google Fonts 等第三方资源。\n\n辅助脚本也有独立隐私闸门：联网命令必须显式传入 `--confirm-private-data`，且会在请求前显示微信读书官方网关地址和本次数据范围。只有用户已经确认该次读取后才能传入此参数。\n\n---\n\n## 🚀 快速开始\n\n1. 获取 API Key：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码\n2. 配置：`export WEREAD_API_KEY=wrk-你的密钥`\n3. 开始使用：\n   - 「微信读书生成看板」— 查看完整数据看板\n   - 「微信读书分析《启示录》」— AI 深度分析指定书籍\n   - 「WeRead PM 拆解《启示录》」— 产品经理视角拆解指定书籍\n   - 「微信读书跨书关联」— 多本书交叉分析，读取前确认\n   - 「微信读书导出笔记」— 语义聚类导出，写入前确认\n\n---\n\n## 📋 完整触发词\n\n| 触发词 | 能力 |\n|:--|:--|\n| 微信读书生成看板 / WeRead 生成看板 / 微信读书 dashboard | Markdown 完整看板 |\n| 微信读书生成 HTML 看板 / WeRead HTML 看板 / 微信读书卡片版 | HTML 卡片看板，保存前确认 |\n| 微信读书阅读打卡 / WeRead 绿墙 | 12 周打卡绿墙 |\n| 微信读书习惯分析 / WeRead 黄金时段 | 24h 脑波频段 |\n| 微信读书盲区分析 / WeRead 偏科分析 | 认知盲区诊断 + 推荐书单 |\n| 微信读书阅读人格 / WeRead MBTI | 阅读灵魂卡片 |\n| 微信读书分析《书名》 / WeRead 概念通解《书名》 | 概念通解模板分析 |\n| 微信读书 PM 拆解《书名》 / WeRead 产品拆解《书名》 | PM 拆解模板分析 |\n| 微信读书法务排雷《书名》 / WeRead 合规分析《书名》 | 法务排雷模板分析 |\n| 微信读书跨书关联 / WeRead 跨书关联 | 多书交叉分析，读取前确认 |\n| 微信读书导出笔记 / WeRead 语义笔记 | 语义聚类导出，写入前确认 |\n| 微信读书导出分析 / WeRead 导出当前分析 | 单书分析导出，写入前确认 |\n\n---\n\n## 🆕 版本历史\n\n- **ClawHub 1.0.8** — 使用单一安全 JSON 数据块与 `textContent` 渲染，修复本地看板注入风险；语言和星期标签由用户选择的数据对象提供\n- **ClawHub 1.0.7** — 为 Python 辅助脚本显式声明最小 `network` 与 `env` 能力，关闭 SkillSpector LP1\n- **ClawHub 1.0.6** — 修复 SkillSpector 告警；补齐最小权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.4** — 补齐最小工具与网络权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.3** — 补齐 ClawHub/OpenClaw 运行时元数据；官方网关请求改为 HTTPS/TLS 严格失败关闭并移除宽松重试\n- **2.0.2** — 移除系统打开命令与远程字体依赖；辅助脚本增加逐次隐私告知、显式确认和最小范围读取闸门\n- **2.0.1** — 收紧 Skill 触发范围；读取历史/跨书笔记和导出文件前增加明确告知与确认；默认导出到工作区\n- **2.0.0** — 新增 AI 深度分析（概念通解、PM 拆解、法务排雷、上下文联动、跨书关联）、知识导出、HTML 卡片看板 AI 分析卡片\n- **1.0.0** — 首版，数据可视化看板（绿墙、脑波、光谱、MBTI）\n\n---\n\n## 💡 适合谁用？\n\n- **重度微信读书用户** — 划了几百条线却从没复盘过的人\n- **知识管理爱好者** — 用 Obsidian/Notion 做笔记，想把微信读书数据接进来的人\n- **产品经理/创业者** — 想从商业书里提取可落地方法论的人\n- **跨领域学习者** — 想知道自己知识盲区在哪、该补什么的人\n- **阅读习惯优化者** — 想找到黄金阅读时段、建立打卡节奏的人\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1789893313328\n}\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nWeRead AI Brain analyzes WeRead shelves, reading statistics, highlights, and personal notes to produce reading dashboards, book analyses, cross-book connections, and exportable notes after user confirmation.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yamyeed](https://clawhub.ai/user/yamyeed)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal WeRead users and knowledge workers use this skill to turn their reading activity, highlights, and personal thoughts into Markdown or HTML dashboards, focused book analysis, cross-book synthesis, and local Markdown exports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill accesses a WeRead API key plus private reading metadata, highlights, and personal thoughts.\n\nMitigation: Use it only for explicit WeRead tasks, keep the API key in the local environment, and review each confirmation prompt before allowing data fetches.\n\nRisk: Generated dashboard or export files can contain private reading notes and analysis.\n\nMitigation: Choose local export paths deliberately, confirm the file contents before export, and avoid sharing generated files unless the private reading data is intended to be shared.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)\n- [Project homepage](https://github.com/yamyeed/weread-ai-brain)\n- [WeRead API gateway](https://i.weread.qq.com/api/agent/gateway)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown reports, optional single-file HTML dashboards, JSON-backed API fetch results, local Markdown exports, and inline shell commands.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires WEREAD_API_KEY and python3 for live WeRead data fetches; network requests are confirmation-gated and scoped to the official WeRead gateway.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v1.0.8:LICENSE\n\nMIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.7: 7 files, 29299 bytes\n\nFiles: LICENSE (1085b), README.md (10562b), skill-card.md (2460b), SKILL.md (26832b), templates/dashboard.html (35892b), tools/fetch_weread.py (5180b), _meta.json (134b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\nallowed-tools: Bash(python3 ./tools/fetch_weread.py:*)\npermissions:\n  - network\n  - env\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - WEREAD_API_KEY\n      bins:\n        - python3\n    primaryEnv: WEREAD_API_KEY\n    envVars:\n      - name: WEREAD_API_KEY\n        required: true\n    homepage: https://github.com/yamyeed/weread-ai-brain\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.py` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\npython3 ./tools/fetch_weread.py --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。仅使用操作系统自带的无衬线与等宽字体栈，不加载远程字体或其他第三方资源。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用系统等宽字体大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果支持 markdown→HTML 转换（`**粗体**`、`- 列表`、`1. 编号`）。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**占位符替换**：HTML 中使用 `{{PLACEHOLDER}}` 格式，生成时替换为实际数据。占位符映射见下方「HTML 看板占位符映射」表。JS 中数据占位符（如 `{{WALL_DATA_JSON}}`）替换为 JSON 字面量，文本占位符替换为转义后的字符串。\n\n**语言选择**：`{{HTML_LANG}}` 和所有 `{{UI_*}}` 文案必须按用户明确指定的语言生成；用户未指定时，沿用当前对话语言。不得固定为某个语言或地区，也不得据此改变可用功能。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `{{ANALYSIS_BOOK_TITLE}}` 未被替换（仍为原始占位符字符串），则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板中使用的占位符及其含义：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{HTML_LANG}}` | 用户选择或当前对话语言对应的 BCP 47 标签 |\n| `{{UI_*}}` | 与 `HTML_LANG` 一致的界面标签；包括标题、指标、区块、图例与单位，不得硬编码地区语言 |\n| `{{USER_NAME}}` | 用户昵称 |\n| `{{DATE}}` | 当前日期 YYYY-MM-DD |\n| `{{BOOK_COUNT}}` / `{{READING_HOURS}}` / `{{NOTE_COUNT}}` / `{{STREAK_DAYS}}` | 四项核心指标 |\n| `{{WALL_DATA_JSON}}` | 二维数组 `[7行][12列]`，值 0-4 |\n| `{{BRAINWAVE_DATA_JSON}}` | 长度 24 的数组，每小时活跃度 |\n| `{{SPECTRUM_DATA_JSON}}` | `[{name, pct, count}, ...]` |\n| `{{DIAGNOSIS_TEXT}}` / `{{RECOMMENDED_BOOKS}}` | AI 认知盲区诊断文字 |\n| `{{MBTI_1}}`~`{{MBTI_4}}` | 4 个字母 |\n| `{{PERSONA_NAME}}` / `{{PERSONA_QUOTE}}` / `{{RECENT_BOOK}}` | 人格信息 |\n| `{{DIM_B_PCT}}`~`{{DIM_S_PCT}}` | 各维度百分比 |\n| `{{ANALYSIS_BOOK_TITLE}}` | 分析书籍名称 |\n| `{{ANALYSIS_BOOK_AUTHOR}}` | 分析书籍作者 |\n| `{{ANALYSIS_TEMPLATE_TYPE}}` | 分析模板：概念通解 / PM拆解 / 法务排雷 |\n| `{{ANALYSIS_TEMPLATE_KIND}}` | 仅用于样式映射的稳定代码：`concept` / `pm` / `legal` |\n| `{{ANALYSIS_EXCERPT}}` | 用户划线原文 |\n| `{{ANALYSIS_RESULT}}` | AI 分析结果（支持 markdown 格式：\\*\\*粗体\\*\\*、- 列表、1. 编号） |\n| `{{ANALYSIS_CONTEXT_JSON}}` | 上下文关联 JSON：`[{chapter, text, thought}, ...]` |\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。保存完成后只报告路径，不要执行系统命令打开文件。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\n三种专业视角，让同一本书产生不同层次的洞察：\n\n#### 📖 概念通解\n\n```\n你是一位博学且通俗易懂的学术导师。请帮我深入剖析下面这段话的核心概念，并用日常通俗的类比解释它：\n```\n\n适用场景：遇到陌生概念、抽象理论、技术术语时，快速建立直觉理解。\n\n#### 📋 PM 拆解\n\n```\n你是一位资深产品总监。请以产品经理的视角分析这段话包含的【业务逻辑/用户痛点/产品功能点】，并给出你可以想到的2个改进建议或竞品思路：\n```\n\n适用场景：读商业书、产品书、案例分析时，提取可落地的方法论和产品洞察。\n\n#### ⚖️ 法务排雷\n\n```\n你是一位专业的互联网合规律师。请分析这段内容中潜在的【法务合规风险/数据隐私隐患/违约漏洞】，并用大白话指出需要避开的坑：\n```\n\n适用场景：读合同、条款、商业案例时，识别法律风险和合规盲点。\n\n### 上下文联动\n\n分析时默认只使用用户提供的文本和指定书籍的必要信息。只有在用户明确同意“结合这本书的历史划线/想法”时，才拉取该书的历史划线和想法作为上下文。\n\n**流程**：\n1. 确定目标书籍（用户指定书名 → 搜索获取 bookId；或未指定 → 询问用户要分析哪本书）\n2. 说明即将读取该书划线和个人想法，并取得用户确认\n3. 调用 `/book/bookmarklist` 获取该书划线\n4. 调用 `/review/list/mine` 获取该书想法\n5. 只选取与当前分析最相关的上下文（最多 8 条）拼入分析 prompt，标注来源章节\n\n**上下文注入格式**：\n\n```\n【该书历史划线/想法上下文】\n\n1. 第{N}章 {章节名}\n   > {划线文本}\n   💭 {想法内容}\n\n2. ...\n\n请结合以上上下文进行分析。若上下文不相关，请明确说明，不要编造。\n```\n\n### 跨书关联\n\n明确触发词：「微信读书跨书关联」/「WeRead 跨书关联」/「微信读书关联分析」\n\n当用户想看多个主题之间的关联时，拉取多本相关书籍的笔记进行交叉分析：\n\n1. 根据用户指定的主题或关键词，从书架中找到相关书籍（2-5 本）\n2. 向用户列出将读取的书名和数据范围，取得确认\n3. 分别获取每本书的划线和想法\n4. 找出跨书的概念关联、矛盾观点、递进关系\n5. 输出关联图谱和分析\n\n**输出格式**：\n\n```\n🔗 跨书关联分析：{主题}\n\n📖 关联书籍：\n  1. 《{书A}》— {与主题的关联}\n  2. 《{书B}》— {与主题的关联}\n\n🎯 核心关联发现：\n  {跨书概念映射}\n\n⚡ 观点碰撞：\n  《{书A}》认为 {...}，而《{书B}》认为 {...}\n\n📈 递进关系：\n  从《{书A}》的{概念} → 到《{书B}》的{概念}，体现了 {...}\n```\n\n---\n\n## 能力三：知识重构与导出\n\n### 语义笔记聚类\n\n明确触发词：「微信读书导出笔记」/「WeRead 语义笔记」/「微信读书语义聚类」\n\n跨书按核心概念聚合划线，输出 Obsidian 友好的 Markdown。执行前必须说明将聚合哪些书、包含哪些划线/想法摘要、保存到哪个路径，并取得用户确认。\n\n```markdown\n---\nsource: weread-ai-brain\ntype: semantic-cluster\nconcept: {核心概念}\nbooks:\n  - {书名1}\n  - {书名2}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# {核心概念}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n---\n\n**AI 洞察**：{跨书综合分析}\n```\n\n### 单书分析导出\n\n分析完成后，可在用户明确要求时导出为 Markdown 文件。导出前说明文件包含原文摘录、AI 分析和上下文摘要，并询问保存路径；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。\n\n```markdown\n---\nsource: weread-ai-brain\nbook: {书名}\ntemplate: {概念通解/PM拆解/法务排雷}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# 📖 {书名} — {分析模板名}\n\n## 原文摘录\n> {用户划线文本}\n\n## AI 深度分析\n{分析结果}\n\n## 上下文关联\n- 第{N}章 {章节名}：{关联划线摘要}\n```\n\n---\n\n## 完整触发词表\n\n| 触发词 | 能力 | 模块 |\n|:--|:--|:--|\n| \"微信读书生成看板\" / \"WeRead 生成看板\" / \"微信读书 dashboard\" | Markdown 完整看板（5 模块） | 可视化 |\n| \"微信读书生成 HTML 看板\" / \"WeRead HTML 看板\" / \"微信读书卡片版\" | HTML 卡片看板，保存前确认 | 可视化 |\n| \"微信读书阅读打卡\" / \"WeRead 绿墙\" | 12 周打卡绿墙 | 可视化 |\n| \"微信读书习惯分析\" / \"WeRead 黄金时段\" | 24h 脑波频段图 | 可视化 |\n| \"微信读书盲区分析\" / \"WeRead 偏科分析\" | 知识光谱 + 认知盲区诊断 | 可视化 |\n| \"微信读书阅读人格\" / \"WeRead MBTI\" | WeRead-MBTI 灵魂卡片 | 可视化 |\n| \"微信读书分析《书名》\" / \"WeRead 概念通解《书名》\" | 用概念通解模板分析指定书或片段 | AI 分析 |\n| \"微信读书 PM 拆解《书名》\" / \"WeRead 产品拆解《书名》\" | 用 PM 拆解模板分析指定书或片段 | AI 分析 |\n| \"微信读书法务排雷《书名》\" / \"WeRead 合规分析《书名》\" | 用法务排雷模板分析指定书或片段 | AI 分析 |\n| \"微信读书跨书关联\" / \"WeRead 跨书关联\" / \"微信读书关联分析\" | 多本书笔记交叉分析，读取前确认 | AI 分析 |\n| \"微信读书导出笔记\" / \"WeRead 语义笔记\" | 跨书语义聚类 Markdown，导出前确认 | 知识导出 |\n| \"微信读书导出分析\" / \"WeRead 导出当前分析\" | 导出当前分析为 Markdown 文件，导出前确认 | 知识导出 |\n\n### 分析交互流程\n\n当用户触发分析类命令时：\n\n1. **确定目标书**：\n   - 用户指定书名 → 调用 `/store/search` 获取 bookId\n   - 用户未指定 → 询问用户要分析哪本书，不要默认读取在读第一本\n2. **选择分析模板**：\n   - 用户已通过触发词指定模板 → 直接使用\n   - 用户只说通用的“分析”或“拆解”且没有提到微信读书/WeRead → 不触发本 skill\n3. **拉取上下文**：\n   - 先告知将读取该书划线和个人想法，并取得用户确认\n   - 调用 `/book/bookmarklist` 获取划线\n   - 调用 `/review/list/mine` 获取想法\n   - 选取与当前分析最相关的上下文（最多 8 条）\n4. **执行分析**：将模板 prompt + 用户关注的文本 + 上下文一起发给 AI\n5. **输出结果**：在 session 中输出分析，提示可以导出\n\n---\n\n## 首次使用引导\n\n如果未设置 `WEREAD_API_KEY`：\n\n```\n👋 欢迎使用 WeRead AI Brain！\n\n获取 API Key：\n1. 打开手机「微信读书 App」\n2. 点击「我」→ 右上角「设置 ⚙️」→「微信读书 Skill」\n3. 扫码登录后，复制以 wrk- 开头的 API Key\n\n配置：\n  export WEREAD_API_KEY=wrk-你的密钥\n\n完成后说「微信读书生成看板」看数据，或说「微信读书分析《书名》」让 AI 帮你深度思考。\n```\n\n---\n\n## 注意事项\n\n- 所有 API 请求均通过 `https://i.weread.qq.com/api/agent/gateway` POST 网关发出，禁止直接 GET 请求原始接口。\n- 若鉴权失败（errcode: -2010），引导用户重新获取 Key。\n- Markdown 看板输出时，确保 ASCII 图表在终端和 Markdown 渲染器中均对齐良好。\n- 分析时若上下文为空或不相关，明确说明，不要编造关联。\n- 上下文联动必须经用户确认，且最多选取 8 条相关划线/想法，避免 prompt 过长。\n- 导出文件必须经用户确认；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录，文件名格式 `weread-{类型}-{日期}.md`。\n- 不要执行系统命令打开浏览器或本地文件；保存完成后只报告路径。\n\nFile v1.0.7:README.md\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- Skill 元数据显式声明只允许调用本地 `tools/fetch_weread.py`，只读取 `WEREAD_API_KEY`，且网络请求仅可 POST 到 `i.weread.qq.com`。\n- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。\n- 保存 HTML、Markdown 等本地文件前，会说明内容与路径并等待确认；默认建议保存到当前工作区的 `outputs/` 或 `weread-exports/`。\n- 生成的文件不会通过系统命令自动打开；HTML 模板仅使用系统字体，不加载 Google Fonts 等第三方资源。\n\n辅助脚本也有独立隐私闸门：联网命令必须显式传入 `--confirm-private-data`，且会在请求前显示微信读书官方网关地址和本次数据范围。只有用户已经确认该次读取后才能传入此参数。\n\n---\n\n## 🚀 快速开始\n\n1. 获取 API Key：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码\n2. 配置：`export WEREAD_API_KEY=wrk-你的密钥`\n3. 开始使用：\n   - 「微信读书生成看板」— 查看完整数据看板\n   - 「微信读书分析《启示录》」— AI 深度分析指定书籍\n   - 「WeRead PM 拆解《启示录》」— 产品经理视角拆解指定书籍\n   - 「微信读书跨书关联」— 多本书交叉分析，读取前确认\n   - 「微信读书导出笔记」— 语义聚类导出，写入前确认\n\n---\n\n## 📋 完整触发词\n\n| 触发词 | 能力 |\n|:--|:--|\n| 微信读书生成看板 / WeRead 生成看板 / 微信读书 dashboard | Markdown 完整看板 |\n| 微信读书生成 HTML 看板 / WeRead HTML 看板 / 微信读书卡片版 | HTML 卡片看板，保存前确认 |\n| 微信读书阅读打卡 / WeRead 绿墙 | 12 周打卡绿墙 |\n| 微信读书习惯分析 / WeRead 黄金时段 | 24h 脑波频段 |\n| 微信读书盲区分析 / WeRead 偏科分析 | 认知盲区诊断 + 推荐书单 |\n| 微信读书阅读人格 / WeRead MBTI | 阅读灵魂卡片 |\n| 微信读书分析《书名》 / WeRead 概念通解《书名》 | 概念通解模板分析 |\n| 微信读书 PM 拆解《书名》 / WeRead 产品拆解《书名》 | PM 拆解模板分析 |\n| 微信读书法务排雷《书名》 / WeRead 合规分析《书名》 | 法务排雷模板分析 |\n| 微信读书跨书关联 / WeRead 跨书关联 | 多书交叉分析，读取前确认 |\n| 微信读书导出笔记 / WeRead 语义笔记 | 语义聚类导出，写入前确认 |\n| 微信读书导出分析 / WeRead 导出当前分析 | 单书分析导出，写入前确认 |\n\n---\n\n## 🆕 版本历史\n\n- **ClawHub 1.0.7** — 为 Python 辅助脚本显式声明最小 `network` 与 `env` 能力，关闭 SkillSpector LP1\n- **ClawHub 1.0.6** — 修复 SkillSpector 告警；补齐最小权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.4** — 补齐最小工具与网络权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.3** — 补齐 ClawHub/OpenClaw 运行时元数据；官方网关请求改为 HTTPS/TLS 严格失败关闭并移除宽松重试\n- **2.0.2** — 移除系统打开命令与远程字体依赖；辅助脚本增加逐次隐私告知、显式确认和最小范围读取闸门\n- **2.0.1** — 收紧 Skill 触发范围；读取历史/跨书笔记和导出文件前增加明确告知与确认；默认导出到工作区\n- **2.0.0** — 新增 AI 深度分析（概念通解、PM 拆解、法务排雷、上下文联动、跨书关联）、知识导出、HTML 卡片看板 AI 分析卡片\n- **1.0.0** — 首版，数据可视化看板（绿墙、脑波、光谱、MBTI）\n\n---\n\n## 💡 适合谁用？\n\n- **重度微信读书用户** — 划了几百条线却从没复盘过的人\n- **知识管理爱好者** — 用 Obsidian/Notion 做笔记，想把微信读书数据接进来的人\n- **产品经理/创业者** — 想从商业书里提取可落地方法论的人\n- **跨领域学习者** — 想知道自己知识盲区在哪、该补什么的人\n- **阅读习惯优化者** — 想找到黄金阅读时段、建立打卡节奏的人\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789892507565\n}\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nWeRead AI Brain analyzes WeRead reading data and notes, using a user-provided API key to fetch bookshelf, reading statistics, highlights, and personal thoughts only after explicit WeRead-related requests and confirmations.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yamyeed](https://clawhub.ai/user/yamyeed)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users and developers use this skill to turn WeRead reading activity, highlights, and thoughts into Markdown dashboards, optional HTML dashboards, book-level analysis, cross-book connections, and exportable notes. It is intended for WeRead-specific requests where the user understands that private reading data will be read through the official gateway.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can read private WeRead reading history, highlights, and personal thoughts when the user provides a WEREAD_API_KEY.\n\nMitigation: Use it only for explicit WeRead requests, provide the API key only when comfortable, and confirm each private data-read prompt before access.\n\nRisk: Cross-book analysis and note exports can aggregate or write sensitive reading notes and personal thoughts into local files.\n\nMitigation: Review the described data scope, file type, and save path before approving exports, and avoid broad cross-book reads unless they are needed for the task.\n\n## Reference(s):\n\n- [Project homepage](https://github.com/yamyeed/weread-ai-brain)\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)\n- [WeRead official API gateway](https://i.weread.qq.com/api/agent/gateway)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance, Files]\n\n**Output Format:** [Markdown reports, optional single-file HTML dashboards, JSON helper output, shell command snippets, and configuration guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May require WEREAD_API_KEY and explicit user confirmation before reading private WeRead data or writing local exports.]\n\n## Skill Version(s):\n\n1.0.7 (source: ClawHub release evidence, created 2026-09-20)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v1.0.7:LICENSE\n\nMIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.6: 7 files, 29112 bytes\n\nFiles: LICENSE (1085b), README.md (10443b), skill-card.md (2214b), SKILL.md (26799b), templates/dashboard.html (35892b), tools/fetch_weread.py (5180b), _meta.json (134b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\nallowed-tools: Bash(python3 ./tools/fetch_weread.py:*)\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - WEREAD_API_KEY\n      bins:\n        - python3\n    primaryEnv: WEREAD_API_KEY\n    envVars:\n      - name: WEREAD_API_KEY\n        required: true\n    homepage: https://github.com/yamyeed/weread-ai-brain\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.py` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\npython3 ./tools/fetch_weread.py --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。仅使用操作系统自带的无衬线与等宽字体栈，不加载远程字体或其他第三方资源。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用系统等宽字体大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果支持 markdown→HTML 转换（`**粗体**`、`- 列表`、`1. 编号`）。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**占位符替换**：HTML 中使用 `{{PLACEHOLDER}}` 格式，生成时替换为实际数据。占位符映射见下方「HTML 看板占位符映射」表。JS 中数据占位符（如 `{{WALL_DATA_JSON}}`）替换为 JSON 字面量，文本占位符替换为转义后的字符串。\n\n**语言选择**：`{{HTML_LANG}}` 和所有 `{{UI_*}}` 文案必须按用户明确指定的语言生成；用户未指定时，沿用当前对话语言。不得固定为某个语言或地区，也不得据此改变可用功能。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `{{ANALYSIS_BOOK_TITLE}}` 未被替换（仍为原始占位符字符串），则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板中使用的占位符及其含义：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{HTML_LANG}}` | 用户选择或当前对话语言对应的 BCP 47 标签 |\n| `{{UI_*}}` | 与 `HTML_LANG` 一致的界面标签；包括标题、指标、区块、图例与单位，不得硬编码地区语言 |\n| `{{USER_NAME}}` | 用户昵称 |\n| `{{DATE}}` | 当前日期 YYYY-MM-DD |\n| `{{BOOK_COUNT}}` / `{{READING_HOURS}}` / `{{NOTE_COUNT}}` / `{{STREAK_DAYS}}` | 四项核心指标 |\n| `{{WALL_DATA_JSON}}` | 二维数组 `[7行][12列]`，值 0-4 |\n| `{{BRAINWAVE_DATA_JSON}}` | 长度 24 的数组，每小时活跃度 |\n| `{{SPECTRUM_DATA_JSON}}` | `[{name, pct, count}, ...]` |\n| `{{DIAGNOSIS_TEXT}}` / `{{RECOMMENDED_BOOKS}}` | AI 认知盲区诊断文字 |\n| `{{MBTI_1}}`~`{{MBTI_4}}` | 4 个字母 |\n| `{{PERSONA_NAME}}` / `{{PERSONA_QUOTE}}` / `{{RECENT_BOOK}}` | 人格信息 |\n| `{{DIM_B_PCT}}`~`{{DIM_S_PCT}}` | 各维度百分比 |\n| `{{ANALYSIS_BOOK_TITLE}}` | 分析书籍名称 |\n| `{{ANALYSIS_BOOK_AUTHOR}}` | 分析书籍作者 |\n| `{{ANALYSIS_TEMPLATE_TYPE}}` | 分析模板：概念通解 / PM拆解 / 法务排雷 |\n| `{{ANALYSIS_TEMPLATE_KIND}}` | 仅用于样式映射的稳定代码：`concept` / `pm` / `legal` |\n| `{{ANALYSIS_EXCERPT}}` | 用户划线原文 |\n| `{{ANALYSIS_RESULT}}` | AI 分析结果（支持 markdown 格式：\\*\\*粗体\\*\\*、- 列表、1. 编号） |\n| `{{ANALYSIS_CONTEXT_JSON}}` | 上下文关联 JSON：`[{chapter, text, thought}, ...]` |\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。保存完成后只报告路径，不要执行系统命令打开文件。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\n三种专业视角，让同一本书产生不同层次的洞察：\n\n#### 📖 概念通解\n\n```\n你是一位博学且通俗易懂的学术导师。请帮我深入剖析下面这段话的核心概念，并用日常通俗的类比解释它：\n```\n\n适用场景：遇到陌生概念、抽象理论、技术术语时，快速建立直觉理解。\n\n#### 📋 PM 拆解\n\n```\n你是一位资深产品总监。请以产品经理的视角分析这段话包含的【业务逻辑/用户痛点/产品功能点】，并给出你可以想到的2个改进建议或竞品思路：\n```\n\n适用场景：读商业书、产品书、案例分析时，提取可落地的方法论和产品洞察。\n\n#### ⚖️ 法务排雷\n\n```\n你是一位专业的互联网合规律师。请分析这段内容中潜在的【法务合规风险/数据隐私隐患/违约漏洞】，并用大白话指出需要避开的坑：\n```\n\n适用场景：读合同、条款、商业案例时，识别法律风险和合规盲点。\n\n### 上下文联动\n\n分析时默认只使用用户提供的文本和指定书籍的必要信息。只有在用户明确同意“结合这本书的历史划线/想法”时，才拉取该书的历史划线和想法作为上下文。\n\n**流程**：\n1. 确定目标书籍（用户指定书名 → 搜索获取 bookId；或未指定 → 询问用户要分析哪本书）\n2. 说明即将读取该书划线和个人想法，并取得用户确认\n3. 调用 `/book/bookmarklist` 获取该书划线\n4. 调用 `/review/list/mine` 获取该书想法\n5. 只选取与当前分析最相关的上下文（最多 8 条）拼入分析 prompt，标注来源章节\n\n**上下文注入格式**：\n\n```\n【该书历史划线/想法上下文】\n\n1. 第{N}章 {章节名}\n   > {划线文本}\n   💭 {想法内容}\n\n2. ...\n\n请结合以上上下文进行分析。若上下文不相关，请明确说明，不要编造。\n```\n\n### 跨书关联\n\n明确触发词：「微信读书跨书关联」/「WeRead 跨书关联」/「微信读书关联分析」\n\n当用户想看多个主题之间的关联时，拉取多本相关书籍的笔记进行交叉分析：\n\n1. 根据用户指定的主题或关键词，从书架中找到相关书籍（2-5 本）\n2. 向用户列出将读取的书名和数据范围，取得确认\n3. 分别获取每本书的划线和想法\n4. 找出跨书的概念关联、矛盾观点、递进关系\n5. 输出关联图谱和分析\n\n**输出格式**：\n\n```\n🔗 跨书关联分析：{主题}\n\n📖 关联书籍：\n  1. 《{书A}》— {与主题的关联}\n  2. 《{书B}》— {与主题的关联}\n\n🎯 核心关联发现：\n  {跨书概念映射}\n\n⚡ 观点碰撞：\n  《{书A}》认为 {...}，而《{书B}》认为 {...}\n\n📈 递进关系：\n  从《{书A}》的{概念} → 到《{书B}》的{概念}，体现了 {...}\n```\n\n---\n\n## 能力三：知识重构与导出\n\n### 语义笔记聚类\n\n明确触发词：「微信读书导出笔记」/「WeRead 语义笔记」/「微信读书语义聚类」\n\n跨书按核心概念聚合划线，输出 Obsidian 友好的 Markdown。执行前必须说明将聚合哪些书、包含哪些划线/想法摘要、保存到哪个路径，并取得用户确认。\n\n```markdown\n---\nsource: weread-ai-brain\ntype: semantic-cluster\nconcept: {核心概念}\nbooks:\n  - {书名1}\n  - {书名2}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# {核心概念}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n---\n\n**AI 洞察**：{跨书综合分析}\n```\n\n### 单书分析导出\n\n分析完成后，可在用户明确要求时导出为 Markdown 文件。导出前说明文件包含原文摘录、AI 分析和上下文摘要，并询问保存路径；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。\n\n```markdown\n---\nsource: weread-ai-brain\nbook: {书名}\ntemplate: {概念通解/PM拆解/法务排雷}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# 📖 {书名} — {分析模板名}\n\n## 原文摘录\n> {用户划线文本}\n\n## AI 深度分析\n{分析结果}\n\n## 上下文关联\n- 第{N}章 {章节名}：{关联划线摘要}\n```\n\n---\n\n## 完整触发词表\n\n| 触发词 | 能力 | 模块 |\n|:--|:--|:--|\n| \"微信读书生成看板\" / \"WeRead 生成看板\" / \"微信读书 dashboard\" | Markdown 完整看板（5 模块） | 可视化 |\n| \"微信读书生成 HTML 看板\" / \"WeRead HTML 看板\" / \"微信读书卡片版\" | HTML 卡片看板，保存前确认 | 可视化 |\n| \"微信读书阅读打卡\" / \"WeRead 绿墙\" | 12 周打卡绿墙 | 可视化 |\n| \"微信读书习惯分析\" / \"WeRead 黄金时段\" | 24h 脑波频段图 | 可视化 |\n| \"微信读书盲区分析\" / \"WeRead 偏科分析\" | 知识光谱 + 认知盲区诊断 | 可视化 |\n| \"微信读书阅读人格\" / \"WeRead MBTI\" | WeRead-MBTI 灵魂卡片 | 可视化 |\n| \"微信读书分析《书名》\" / \"WeRead 概念通解《书名》\" | 用概念通解模板分析指定书或片段 | AI 分析 |\n| \"微信读书 PM 拆解《书名》\" / \"WeRead 产品拆解《书名》\" | 用 PM 拆解模板分析指定书或片段 | AI 分析 |\n| \"微信读书法务排雷《书名》\" / \"WeRead 合规分析《书名》\" | 用法务排雷模板分析指定书或片段 | AI 分析 |\n| \"微信读书跨书关联\" / \"WeRead 跨书关联\" / \"微信读书关联分析\" | 多本书笔记交叉分析，读取前确认 | AI 分析 |\n| \"微信读书导出笔记\" / \"WeRead 语义笔记\" | 跨书语义聚类 Markdown，导出前确认 | 知识导出 |\n| \"微信读书导出分析\" / \"WeRead 导出当前分析\" | 导出当前分析为 Markdown 文件，导出前确认 | 知识导出 |\n\n### 分析交互流程\n\n当用户触发分析类命令时：\n\n1. **确定目标书**：\n   - 用户指定书名 → 调用 `/store/search` 获取 bookId\n   - 用户未指定 → 询问用户要分析哪本书，不要默认读取在读第一本\n2. **选择分析模板**：\n   - 用户已通过触发词指定模板 → 直接使用\n   - 用户只说通用的“分析”或“拆解”且没有提到微信读书/WeRead → 不触发本 skill\n3. **拉取上下文**：\n   - 先告知将读取该书划线和个人想法，并取得用户确认\n   - 调用 `/book/bookmarklist` 获取划线\n   - 调用 `/review/list/mine` 获取想法\n   - 选取与当前分析最相关的上下文（最多 8 条）\n4. **执行分析**：将模板 prompt + 用户关注的文本 + 上下文一起发给 AI\n5. **输出结果**：在 session 中输出分析，提示可以导出\n\n---\n\n## 首次使用引导\n\n如果未设置 `WEREAD_API_KEY`：\n\n```\n👋 欢迎使用 WeRead AI Brain！\n\n获取 API Key：\n1. 打开手机「微信读书 App」\n2. 点击「我」→ 右上角「设置 ⚙️」→「微信读书 Skill」\n3. 扫码登录后，复制以 wrk- 开头的 API Key\n\n配置：\n  export WEREAD_API_KEY=wrk-你的密钥\n\n完成后说「微信读书生成看板」看数据，或说「微信读书分析《书名》」让 AI 帮你深度思考。\n```\n\n---\n\n## 注意事项\n\n- 所有 API 请求均通过 `https://i.weread.qq.com/api/agent/gateway` POST 网关发出，禁止直接 GET 请求原始接口。\n- 若鉴权失败（errcode: -2010），引导用户重新获取 Key。\n- Markdown 看板输出时，确保 ASCII 图表在终端和 Markdown 渲染器中均对齐良好。\n- 分析时若上下文为空或不相关，明确说明，不要编造关联。\n- 上下文联动必须经用户确认，且最多选取 8 条相关划线/想法，避免 prompt 过长。\n- 导出文件必须经用户确认；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录，文件名格式 `weread-{类型}-{日期}.md`。\n- 不要执行系统命令打开浏览器或本地文件；保存完成后只报告路径。\n\nFile v1.0.6:README.md\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- Skill 元数据显式声明只允许调用本地 `tools/fetch_weread.py`，只读取 `WEREAD_API_KEY`，且网络请求仅可 POST 到 `i.weread.qq.com`。\n- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。\n- 保存 HTML、Markdown 等本地文件前，会说明内容与路径并等待确认；默认建议保存到当前工作区的 `outputs/` 或 `weread-exports/`。\n- 生成的文件不会通过系统命令自动打开；HTML 模板仅使用系统字体，不加载 Google Fonts 等第三方资源。\n\n辅助脚本也有独立隐私闸门：联网命令必须显式传入 `--confirm-private-data`，且会在请求前显示微信读书官方网关地址和本次数据范围。只有用户已经确认该次读取后才能传入此参数。\n\n---\n\n## 🚀 快速开始\n\n1. 获取 API Key：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码\n2. 配置：`export WEREAD_API_KEY=wrk-你的密钥`\n3. 开始使用：\n   - 「微信读书生成看板」— 查看完整数据看板\n   - 「微信读书分析《启示录》」— AI 深度分析指定书籍\n   - 「WeRead PM 拆解《启示录》」— 产品经理视角拆解指定书籍\n   - 「微信读书跨书关联」— 多本书交叉分析，读取前确认\n   - 「微信读书导出笔记」— 语义聚类导出，写入前确认\n\n---\n\n## 📋 完整触发词\n\n| 触发词 | 能力 |\n|:--|:--|\n| 微信读书生成看板 / WeRead 生成看板 / 微信读书 dashboard | Markdown 完整看板 |\n| 微信读书生成 HTML 看板 / WeRead HTML 看板 / 微信读书卡片版 | HTML 卡片看板，保存前确认 |\n| 微信读书阅读打卡 / WeRead 绿墙 | 12 周打卡绿墙 |\n| 微信读书习惯分析 / WeRead 黄金时段 | 24h 脑波频段 |\n| 微信读书盲区分析 / WeRead 偏科分析 | 认知盲区诊断 + 推荐书单 |\n| 微信读书阅读人格 / WeRead MBTI | 阅读灵魂卡片 |\n| 微信读书分析《书名》 / WeRead 概念通解《书名》 | 概念通解模板分析 |\n| 微信读书 PM 拆解《书名》 / WeRead 产品拆解《书名》 | PM 拆解模板分析 |\n| 微信读书法务排雷《书名》 / WeRead 合规分析《书名》 | 法务排雷模板分析 |\n| 微信读书跨书关联 / WeRead 跨书关联 | 多书交叉分析，读取前确认 |\n| 微信读书导出笔记 / WeRead 语义笔记 | 语义聚类导出，写入前确认 |\n| 微信读书导出分析 / WeRead 导出当前分析 | 单书分析导出，写入前确认 |\n\n---\n\n## 🆕 版本历史\n\n- **ClawHub 1.0.6** — 修复 SkillSpector 告警；补齐最小权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.4** — 补齐最小工具与网络权限；移除 shell/curl 请求实现；HTML 语言和界面文案改为按用户语言生成\n- **2.0.3** — 补齐 ClawHub/OpenClaw 运行时元数据；官方网关请求改为 HTTPS/TLS 严格失败关闭并移除宽松重试\n- **2.0.2** — 移除系统打开命令与远程字体依赖；辅助脚本增加逐次隐私告知、显式确认和最小范围读取闸门\n- **2.0.1** — 收紧 Skill 触发范围；读取历史/跨书笔记和导出文件前增加明确告知与确认；默认导出到工作区\n- **2.0.0** — 新增 AI 深度分析（概念通解、PM 拆解、法务排雷、上下文联动、跨书关联）、知识导出、HTML 卡片看板 AI 分析卡片\n- **1.0.0** — 首版，数据可视化看板（绿墙、脑波、光谱、MBTI）\n\n---\n\n## 💡 适合谁用？\n\n- **重度微信读书用户** — 划了几百条线却从没复盘过的人\n- **知识管理爱好者** — 用 Obsidian/Notion 做笔记，想把微信读书数据接进来的人\n- **产品经理/创业者** — 想从商业书里提取可落地方法论的人\n- **跨领域学习者** — 想知道自己知识盲区在哪、该补什么的人\n- **阅读习惯优化者** — 想找到黄金阅读时段、建立打卡节奏的人\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1789891882522\n}\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nWeRead AI Brain analyzes WeRead shelves, reading stats, highlights, and personal notes to produce reading dashboards, book analysis, cross-book connections, and exportable Markdown or HTML outputs after user confirmation.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yamyeed](https://clawhub.ai/user/yamyeed)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal WeRead users and knowledge-management practitioners use this skill to turn personal WeRead reading data into dashboards, book-level analysis, cross-book insights, and exportable notes.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a user-provided WeRead API key and sends requests to WeRead's official gateway.\n\nMitigation: Install only if that data flow is acceptable; keep WEREAD_API_KEY local and confirm each private-data fetch before use.\n\nRisk: Generated HTML or Markdown exports can contain private reading history, highlights, and personal thoughts.\n\nMitigation: Review the export contents and destination path before confirming, and share exported files only after removing sensitive information.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)\n- [Publisher profile](https://clawhub.ai/user/yamyeed)\n- [Project homepage from ClawHub metadata](https://github.com/yamyeed/weread-ai-brain)\n- [WeRead official API gateway](https://i.weread.qq.com/api/agent/gateway)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown reports, single-file HTML, JSON API responses, and shell commands for the WeRead helper script]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires WEREAD_API_KEY; private-data fetches and local exports require explicit user confirmation.]\n\n## Skill Version(s):\n\n1.0.6 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v1.0.6:LICENSE\n\nMIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.5: 8 files, 40141 bytes\n\nFiles: LICENSE (1085b), README.md (10073b), skill-card.md (2726b), SKILL.md (26331b), templates/dashboard.html (36065b), templates/preview.html (37873b), tools/fetch_weread.sh (7465b), _meta.json (134b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - WEREAD_API_KEY\n      bins:\n        - curl\n        - python3\n    primaryEnv: WEREAD_API_KEY\n    envVars:\n      - name: WEREAD_API_KEY\n        required: true\n        description: 微信读书官方 API Key；仅作为 Bearer Token 发送到 https://i.weread.qq.com/api/agent/gateway。\n    homepage: https://github.com/yamyeed/weread-ai-brain\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.sh` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\n./tools/fetch_weread.sh --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。仅使用操作系统自带的无衬线与等宽字体栈，不加载远程字体或其他第三方资源。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用系统等宽字体大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果支持 markdown→HTML 转换（`**粗体**`、`- 列表`、`1. 编号`）。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**占位符替换**：HTML 中使用 `{{PLACEHOLDER}}` 格式，生成时替换为实际数据。占位符映射见下方「HTML 看板占位符映射」表。JS 中数据占位符（如 `{{WALL_DATA_JSON}}`）替换为 JSON 字面量，文本占位符替换为转义后的字符串。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `{{ANALYSIS_BOOK_TITLE}}` 未被替换（仍为原始占位符字符串），则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板中使用的占位符及其含义：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{USER_NAME}}` | 用户昵称 |\n| `{{DATE}}` | 当前日期 YYYY-MM-DD |\n| `{{BOOK_COUNT}}` / `{{READING_HOURS}}` / `{{NOTE_COUNT}}` / `{{STREAK_DAYS}}` | 四项核心指标 |\n| `{{WALL_DATA_JSON}}` | 二维数组 `[7行][12列]`，值 0-4 |\n| `{{BRAINWAVE_DATA_JSON}}` | 长度 24 的数组，每小时活跃度 |\n| `{{SPECTRUM_DATA_JSON}}` | `[{name, pct, count}, ...]` |\n| `{{DIAGNOSIS_TEXT}}` / `{{RECOMMENDED_BOOKS}}` | AI 认知盲区诊断文字 |\n| `{{MBTI_1}}`~`{{MBTI_4}}` | 4 个字母 |\n| `{{PERSONA_NAME}}` / `{{PERSONA_QUOTE}}` / `{{RECENT_BOOK}}` | 人格信息 |\n| `{{DIM_B_PCT}}`~`{{DIM_S_PCT}}` | 各维度百分比 |\n| `{{ANALYSIS_BOOK_TITLE}}` | 分析书籍名称 |\n| `{{ANALYSIS_BOOK_AUTHOR}}` | 分析书籍作者 |\n| `{{ANALYSIS_TEMPLATE_TYPE}}` | 分析模板：概念通解 / PM拆解 / 法务排雷 |\n| `{{ANALYSIS_EXCERPT}}` | 用户划线原文 |\n| `{{ANALYSIS_RESULT}}` | AI 分析结果（支持 markdown 格式：\\*\\*粗体\\*\\*、- 列表、1. 编号） |\n| `{{ANALYSIS_CONTEXT_JSON}}` | 上下文关联 JSON：`[{chapter, text, thought}, ...]` |\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。保存完成后只报告路径，不要执行系统命令打开文件。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\n三种专业视角，让同一本书产生不同层次的洞察：\n\n#### 📖 概念通解\n\n```\n你是一位博学且通俗易懂的学术导师。请帮我深入剖析下面这段话的核心概念，并用日常通俗的类比解释它：\n```\n\n适用场景：遇到陌生概念、抽象理论、技术术语时，快速建立直觉理解。\n\n#### 📋 PM 拆解\n\n```\n你是一位资深产品总监。请以产品经理的视角分析这段话包含的【业务逻辑/用户痛点/产品功能点】，并给出你可以想到的2个改进建议或竞品思路：\n```\n\n适用场景：读商业书、产品书、案例分析时，提取可落地的方法论和产品洞察。\n\n#### ⚖️ 法务排雷\n\n```\n你是一位专业的互联网合规律师。请分析这段内容中潜在的【法务合规风险/数据隐私隐患/违约漏洞】，并用大白话指出需要避开的坑：\n```\n\n适用场景：读合同、条款、商业案例时，识别法律风险和合规盲点。\n\n### 上下文联动\n\n分析时默认只使用用户提供的文本和指定书籍的必要信息。只有在用户明确同意“结合这本书的历史划线/想法”时，才拉取该书的历史划线和想法作为上下文。\n\n**流程**：\n1. 确定目标书籍（用户指定书名 → 搜索获取 bookId；或未指定 → 询问用户要分析哪本书）\n2. 说明即将读取该书划线和个人想法，并取得用户确认\n3. 调用 `/book/bookmarklist` 获取该书划线\n4. 调用 `/review/list/mine` 获取该书想法\n5. 只选取与当前分析最相关的上下文（最多 8 条）拼入分析 prompt，标注来源章节\n\n**上下文注入格式**：\n\n```\n【该书历史划线/想法上下文】\n\n1. 第{N}章 {章节名}\n   > {划线文本}\n   💭 {想法内容}\n\n2. ...\n\n请结合以上上下文进行分析。若上下文不相关，请明确说明，不要编造。\n```\n\n### 跨书关联\n\n明确触发词：「微信读书跨书关联」/「WeRead 跨书关联」/「微信读书关联分析」\n\n当用户想看多个主题之间的关联时，拉取多本相关书籍的笔记进行交叉分析：\n\n1. 根据用户指定的主题或关键词，从书架中找到相关书籍（2-5 本）\n2. 向用户列出将读取的书名和数据范围，取得确认\n3. 分别获取每本书的划线和想法\n4. 找出跨书的概念关联、矛盾观点、递进关系\n5. 输出关联图谱和分析\n\n**输出格式**：\n\n```\n🔗 跨书关联分析：{主题}\n\n📖 关联书籍：\n  1. 《{书A}》— {与主题的关联}\n  2. 《{书B}》— {与主题的关联}\n\n🎯 核心关联发现：\n  {跨书概念映射}\n\n⚡ 观点碰撞：\n  《{书A}》认为 {...}，而《{书B}》认为 {...}\n\n📈 递进关系：\n  从《{书A}》的{概念} → 到《{书B}》的{概念}，体现了 {...}\n```\n\n---\n\n## 能力三：知识重构与导出\n\n### 语义笔记聚类\n\n明确触发词：「微信读书导出笔记」/「WeRead 语义笔记」/「微信读书语义聚类」\n\n跨书按核心概念聚合划线，输出 Obsidian 友好的 Markdown。执行前必须说明将聚合哪些书、包含哪些划线/想法摘要、保存到哪个路径，并取得用户确认。\n\n```markdown\n---\nsource: weread-ai-brain\ntype: semantic-cluster\nconcept: {核心概念}\nbooks:\n  - {书名1}\n  - {书名2}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# {核心概念}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n---\n\n**AI 洞察**：{跨书综合分析}\n```\n\n### 单书分析导出\n\n分析完成后，可在用户明确要求时导出为 Markdown 文件。导出前说明文件包含原文摘录、AI 分析和上下文摘要，并询问保存路径；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。\n\n```markdown\n---\nsource: weread-ai-brain\nbook: {书名}\ntemplate: {概念通解/PM拆解/法务排雷}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# 📖 {书名} — {分析模板名}\n\n## 原文摘录\n> {用户划线文本}\n\n## AI 深度分析\n{分析结果}\n\n## 上下文关联\n- 第{N}章 {章节名}：{关联划线摘要}\n```\n\n---\n\n## 完整触发词表\n\n| 触发词 | 能力 | 模块 |\n|:--|:--|:--|\n| \"微信读书生成看板\" / \"WeRead 生成看板\" / \"微信读书 dashboard\" | Markdown 完整看板（5 模块） | 可视化 |\n| \"微信读书生成 HTML 看板\" / \"WeRead HTML 看板\" / \"微信读书卡片版\" | HTML 卡片看板，保存前确认 | 可视化 |\n| \"微信读书阅读打卡\" / \"WeRead 绿墙\" | 12 周打卡绿墙 | 可视化 |\n| \"微信读书习惯分析\" / \"WeRead 黄金时段\" | 24h 脑波频段图 | 可视化 |\n| \"微信读书盲区分析\" / \"WeRead 偏科分析\" | 知识光谱 + 认知盲区诊断 | 可视化 |\n| \"微信读书阅读人格\" / \"WeRead MBTI\" | WeRead-MBTI 灵魂卡片 | 可视化 |\n| \"微信读书分析《书名》\" / \"WeRead 概念通解《书名》\" | 用概念通解模板分析指定书或片段 | AI 分析 |\n| \"微信读书 PM 拆解《书名》\" / \"WeRead 产品拆解《书名》\" | 用 PM 拆解模板分析指定书或片段 | AI 分析 |\n| \"微信读书法务排雷《书名》\" / \"WeRead 合规分析《书名》\" | 用法务排雷模板分析指定书或片段 | AI 分析 |\n| \"微信读书跨书关联\" / \"WeRead 跨书关联\" / \"微信读书关联分析\" | 多本书笔记交叉分析，读取前确认 | AI 分析 |\n| \"微信读书导出笔记\" / \"WeRead 语义笔记\" | 跨书语义聚类 Markdown，导出前确认 | 知识导出 |\n| \"微信读书导出分析\" / \"WeRead 导出当前分析\" | 导出当前分析为 Markdown 文件，导出前确认 | 知识导出 |\n\n### 分析交互流程\n\n当用户触发分析类命令时：\n\n1. **确定目标书**：\n   - 用户指定书名 → 调用 `/store/search` 获取 bookId\n   - 用户未指定 → 询问用户要分析哪本书，不要默认读取在读第一本\n2. **选择分析模板**：\n   - 用户已通过触发词指定模板 → 直接使用\n   - 用户只说通用的“分析”或“拆解”且没有提到微信读书/WeRead → 不触发本 skill\n3. **拉取上下文**：\n   - 先告知将读取该书划线和个人想法，并取得用户确认\n   - 调用 `/book/bookmarklist` 获取划线\n   - 调用 `/review/list/mine` 获取想法\n   - 选取与当前分析最相关的上下文（最多 8 条）\n4. **执行分析**：将模板 prompt + 用户关注的文本 + 上下文一起发给 AI\n5. **输出结果**：在 session 中输出分析，提示可以导出\n\n---\n\n## 首次使用引导\n\n如果未设置 `WEREAD_API_KEY`：\n\n```\n👋 欢迎使用 WeRead AI Brain！\n\n获取 API Key：\n1. 打开手机「微信读书 App」\n2. 点击「我」→ 右上角「设置 ⚙️」→「微信读书 Skill」\n3. 扫码登录后，复制以 wrk- 开头的 API Key\n\n配置：\n  export WEREAD_API_KEY=wrk-你的密钥\n\n完成后说「微信读书生成看板」看数据，或说「微信读书分析《书名》」让 AI 帮你深度思考。\n```\n\n---\n\n## 注意事项\n\n- 所有 API 请求均通过 `https://i.weread.qq.com/api/agent/gateway` POST 网关发出，禁止直接 GET 请求原始接口。\n- 若鉴权失败（errcode: -2010），引导用户重新获取 Key。\n- Markdown 看板输出时，确保 ASCII 图表在终端和 Markdown 渲染器中均对齐良好。\n- 分析时若上下文为空或不相关，明确说明，不要编造关联。\n- 上下文联动必须经用户确认，且最多选取 8 条相关划线/想法，避免 prompt 过长。\n- 导出文件必须经用户确认；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录，文件名格式 `weread-{类型}-{日期}.md`。\n- 不要执行系统命令打开浏览器或本地文件；保存完成后只报告路径。\n\nFile v1.0.5:README.md\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- Skill 元数据显式声明运行所需的 `WEREAD_API_KEY`、`curl` 和 `python3`。\n- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。\n- 保存 HTML、Markdown 等本地文件前，会说明内容与路径并等待确认；默认建议保存到当前工作区的 `outputs/` 或 `weread-exports/`。\n- 生成的文件不会通过系统命令自动打开；HTML 模板仅使用系统字体，不加载 Google Fonts 等第三方资源。\n\n辅助脚本也有独立隐私闸门：联网命令必须显式传入 `--confirm-private-data`，且会在请求前显示微信读书官方网关地址和本次数据范围。只有用户已经确认该次读取后才能传入此参数。\n\n---\n\n## 🚀 快速开始\n\n1. 获取 API Key：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码\n2. 配置：`export WEREAD_API_KEY=wrk-你的密钥`\n3. 开始使用：\n   - 「微信读书生成看板」— 查看完整数据看板\n   - 「微信读书分析《启示录》」— AI 深度分析指定书籍\n   - 「WeRead PM 拆解《启示录》」— 产品经理视角拆解指定书籍\n   - 「微信读书跨书关联」— 多本书交叉分析，读取前确认\n   - 「微信读书导出笔记」— 语义聚类导出，写入前确认\n\n---\n\n## 📋 完整触发词\n\n| 触发词 | 能力 |\n|:--|:--|\n| 微信读书生成看板 / WeRead 生成看板 / 微信读书 dashboard | Markdown 完整看板 |\n| 微信读书生成 HTML 看板 / WeRead HTML 看板 / 微信读书卡片版 | HTML 卡片看板，保存前确认 |\n| 微信读书阅读打卡 / WeRead 绿墙 | 12 周打卡绿墙 |\n| 微信读书习惯分析 / WeRead 黄金时段 | 24h 脑波频段 |\n| 微信读书盲区分析 / WeRead 偏科分析 | 认知盲区诊断 + 推荐书单 |\n| 微信读书阅读人格 / WeRead MBTI | 阅读灵魂卡片 |\n| 微信读书分析《书名》 / WeRead 概念通解《书名》 | 概念通解模板分析 |\n| 微信读书 PM 拆解《书名》 / WeRead 产品拆解《书名》 | PM 拆解模板分析 |\n| 微信读书法务排雷《书名》 / WeRead 合规分析《书名》 | 法务排雷模板分析 |\n| 微信读书跨书关联 / WeRead 跨书关联 | 多书交叉分析，读取前确认 |\n| 微信读书导出笔记 / WeRead 语义笔记 | 语义聚类导出，写入前确认 |\n| 微信读书导出分析 / WeRead 导出当前分析 | 单书分析导出，写入前确认 |\n\n---\n\n## 🆕 版本历史\n\n- **2.0.3** — 补齐 ClawHub/OpenClaw 运行时元数据；官方网关请求改为 HTTPS/TLS 严格失败关闭并移除宽松重试\n- **2.0.2** — 移除系统打开命令与远程字体依赖；辅助脚本增加逐次隐私告知、显式确认和最小范围读取闸门\n- **2.0.1** — 收紧 Skill 触发范围；读取历史/跨书笔记和导出文件前增加明确告知与确认；默认导出到工作区\n- **2.0.0** — 新增 AI 深度分析（概念通解、PM 拆解、法务排雷、上下文联动、跨书关联）、知识导出、HTML 卡片看板 AI 分析卡片\n- **1.0.0** — 首版，数据可视化看板（绿墙、脑波、光谱、MBTI）\n\n---\n\n## 💡 适合谁用？\n\n- **重度微信读书用户** — 划了几百条线却从没复盘过的人\n- **知识管理爱好者** — 用 Obsidian/Notion 做笔记，想把微信读书数据接进来的人\n- **产品经理/创业者** — 想从商业书里提取可落地方法论的人\n- **跨领域学习者** — 想知道自己知识盲区在哪、该补什么的人\n- **阅读习惯优化者** — 想找到黄金阅读时段、建立打卡节奏的人\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1785100478363\n}\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\n微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yamyeed](https://clawhub.ai/user/yamyeed)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal WeRead users and developers use this skill to turn WeRead reading statistics, bookshelves, highlights, and personal thoughts into Markdown reports, optional HTML dashboards, book analysis, cross-book connections, and exportable notes. It is suited for users who want reading analytics and knowledge management workflows from their own WeRead account data.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a WeRead API key and can access private reading data including bookshelves, reading statistics, highlights, and personal thoughts.\n\nMitigation: Use the skill only when comfortable granting that access, keep the key local, and require explicit confirmation before each private data read.\n\nRisk: Generated HTML dashboards may unsafe-render private reading data, book metadata, highlights, thoughts, or AI output in the browser.\n\nMitigation: Prefer Markdown output for sensitive content, treat generated HTML as private, and avoid opening or hosting dashboards with untrusted content until sanitization or browser containment is added.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)\n- [Project homepage](https://github.com/yamyeed/weread-ai-brain)\n- [WeRead official API gateway](https://i.weread.qq.com/api/agent/gateway)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown reports, optional single-file HTML dashboards, shell commands, and configuration guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires WEREAD_API_KEY and explicit user confirmation before reading private WeRead data or saving exports.]\n\n## Skill Version(s):\n\n1.0.5 (source: ClawHub release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v1.0.5:LICENSE\n\nMIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.4: 8 files, 39292 bytes\n\nFiles: LICENSE (1085b), README.md (9715b), skill-card.md (2335b), SKILL.md (26025b), templates/dashboard.html (36065b), templates/preview.html (37873b), tools/fetch_weread.sh (7299b), _meta.json (134b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.sh` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\n./tools/fetch_weread.sh --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n```bash\n# 示例\ncurl -X POST \"https://i.weread.qq.com/api/agent/gateway\" \\\n  -H \"Authorization: Bearer $WEREAD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"api_name\": \"/shelf/sync\", \"skill_version\": \"2.0.0\"}'\n```\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。仅使用操作系统自带的无衬线与等宽字体栈，不加载远程字体或其他第三方资源。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用系统等宽字体大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果支持 markdown→HTML 转换（`**粗体**`、`- 列表`、`1. 编号`）。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**占位符替换**：HTML 中使用 `{{PLACEHOLDER}}` 格式，生成时替换为实际数据。占位符映射见下方「HTML 看板占位符映射」表。JS 中数据占位符（如 `{{WALL_DATA_JSON}}`）替换为 JSON 字面量，文本占位符替换为转义后的字符串。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `{{ANALYSIS_BOOK_TITLE}}` 未被替换（仍为原始占位符字符串），则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板中使用的占位符及其含义：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{USER_NAME}}` | 用户昵称 |\n| `{{DATE}}` | 当前日期 YYYY-MM-DD |\n| `{{BOOK_COUNT}}` / `{{READING_HOURS}}` / `{{NOTE_COUNT}}` / `{{STREAK_DAYS}}` | 四项核心指标 |\n| `{{WALL_DATA_JSON}}` | 二维数组 `[7行][12列]`，值 0-4 |\n| `{{BRAINWAVE_DATA_JSON}}` | 长度 24 的数组，每小时活跃度 |\n| `{{SPECTRUM_DATA_JSON}}` | `[{name, pct, count}, ...]` |\n| `{{DIAGNOSIS_TEXT}}` / `{{RECOMMENDED_BOOKS}}` | AI 认知盲区诊断文字 |\n| `{{MBTI_1}}`~`{{MBTI_4}}` | 4 个字母 |\n| `{{PERSONA_NAME}}` / `{{PERSONA_QUOTE}}` / `{{RECENT_BOOK}}` | 人格信息 |\n| `{{DIM_B_PCT}}`~`{{DIM_S_PCT}}` | 各维度百分比 |\n| `{{ANALYSIS_BOOK_TITLE}}` | 分析书籍名称 |\n| `{{ANALYSIS_BOOK_AUTHOR}}` | 分析书籍作者 |\n| `{{ANALYSIS_TEMPLATE_TYPE}}` | 分析模板：概念通解 / PM拆解 / 法务排雷 |\n| `{{ANALYSIS_EXCERPT}}` | 用户划线原文 |\n| `{{ANALYSIS_RESULT}}` | AI 分析结果（支持 markdown 格式：\\*\\*粗体\\*\\*、- 列表、1. 编号） |\n| `{{ANALYSIS_CONTEXT_JSON}}` | 上下文关联 JSON：`[{chapter, text, thought}, ...]` |\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。保存完成后只报告路径，不要执行系统命令打开文件。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\n三种专业视角，让同一本书产生不同层次的洞察：\n\n#### 📖 概念通解\n\n```\n你是一位博学且通俗易懂的学术导师。请帮我深入剖析下面这段话的核心概念，并用日常通俗的类比解释它：\n```\n\n适用场景：遇到陌生概念、抽象理论、技术术语时，快速建立直觉理解。\n\n#### 📋 PM 拆解\n\n```\n你是一位资深产品总监。请以产品经理的视角分析这段话包含的【业务逻辑/用户痛点/产品功能点】，并给出你可以想到的2个改进建议或竞品思路：\n```\n\n适用场景：读商业书、产品书、案例分析时，提取可落地的方法论和产品洞察。\n\n#### ⚖️ 法务排雷\n\n```\n你是一位专业的互联网合规律师。请分析这段内容中潜在的【法务合规风险/数据隐私隐患/违约漏洞】，并用大白话指出需要避开的坑：\n```\n\n适用场景：读合同、条款、商业案例时，识别法律风险和合规盲点。\n\n### 上下文联动\n\n分析时默认只使用用户提供的文本和指定书籍的必要信息。只有在用户明确同意“结合这本书的历史划线/想法”时，才拉取该书的历史划线和想法作为上下文。\n\n**流程**：\n1. 确定目标书籍（用户指定书名 → 搜索获取 bookId；或未指定 → 询问用户要分析哪本书）\n2. 说明即将读取该书划线和个人想法，并取得用户确认\n3. 调用 `/book/bookmarklist` 获取该书划线\n4. 调用 `/review/list/mine` 获取该书想法\n5. 只选取与当前分析最相关的上下文（最多 8 条）拼入分析 prompt，标注来源章节\n\n**上下文注入格式**：\n\n```\n【该书历史划线/想法上下文】\n\n1. 第{N}章 {章节名}\n   > {划线文本}\n   💭 {想法内容}\n\n2. ...\n\n请结合以上上下文进行分析。若上下文不相关，请明确说明，不要编造。\n```\n\n### 跨书关联\n\n明确触发词：「微信读书跨书关联」/「WeRead 跨书关联」/「微信读书关联分析」\n\n当用户想看多个主题之间的关联时，拉取多本相关书籍的笔记进行交叉分析：\n\n1. 根据用户指定的主题或关键词，从书架中找到相关书籍（2-5 本）\n2. 向用户列出将读取的书名和数据范围，取得确认\n3. 分别获取每本书的划线和想法\n4. 找出跨书的概念关联、矛盾观点、递进关系\n5. 输出关联图谱和分析\n\n**输出格式**：\n\n```\n🔗 跨书关联分析：{主题}\n\n📖 关联书籍：\n  1. 《{书A}》— {与主题的关联}\n  2. 《{书B}》— {与主题的关联}\n\n🎯 核心关联发现：\n  {跨书概念映射}\n\n⚡ 观点碰撞：\n  《{书A}》认为 {...}，而《{书B}》认为 {...}\n\n📈 递进关系：\n  从《{书A}》的{概念} → 到《{书B}》的{概念}，体现了 {...}\n```\n\n---\n\n## 能力三：知识重构与导出\n\n### 语义笔记聚类\n\n明确触发词：「微信读书导出笔记」/「WeRead 语义笔记」/「微信读书语义聚类」\n\n跨书按核心概念聚合划线，输出 Obsidian 友好的 Markdown。执行前必须说明将聚合哪些书、包含哪些划线/想法摘要、保存到哪个路径，并取得用户确认。\n\n```markdown\n---\nsource: weread-ai-brain\ntype: semantic-cluster\nconcept: {核心概念}\nbooks:\n  - {书名1}\n  - {书名2}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# {核心概念}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n## 来自《{书名}》\n> {划线文本}\n💭 {想法}\n\n---\n\n**AI 洞察**：{跨书综合分析}\n```\n\n### 单书分析导出\n\n分析完成后，可在用户明确要求时导出为 Markdown 文件。导出前说明文件包含原文摘录、AI 分析和上下文摘要，并询问保存路径；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。\n\n```markdown\n---\nsource: weread-ai-brain\nbook: {书名}\ntemplate: {概念通解/PM拆解/法务排雷}\ncreated: {date}\ntags:\n  - weread\n  - ai-analysis\n---\n\n# 📖 {书名} — {分析模板名}\n\n## 原文摘录\n> {用户划线文本}\n\n## AI 深度分析\n{分析结果}\n\n## 上下文关联\n- 第{N}章 {章节名}：{关联划线摘要}\n```\n\n---\n\n## 完整触发词表\n\n| 触发词 | 能力 | 模块 |\n|:--|:--|:--|\n| \"微信读书生成看板\" / \"WeRead 生成看板\" / \"微信读书 dashboard\" | Markdown 完整看板（5 模块） | 可视化 |\n| \"微信读书生成 HTML 看板\" / \"WeRead HTML 看板\" / \"微信读书卡片版\" | HTML 卡片看板，保存前确认 | 可视化 |\n| \"微信读书阅读打卡\" / \"WeRead 绿墙\" | 12 周打卡绿墙 | 可视化 |\n| \"微信读书习惯分析\" / \"WeRead 黄金时段\" | 24h 脑波频段图 | 可视化 |\n| \"微信读书盲区分析\" / \"WeRead 偏科分析\" | 知识光谱 + 认知盲区诊断 | 可视化 |\n| \"微信读书阅读人格\" / \"WeRead MBTI\" | WeRead-MBTI 灵魂卡片 | 可视化 |\n| \"微信读书分析《书名》\" / \"WeRead 概念通解《书名》\" | 用概念通解模板分析指定书或片段 | AI 分析 |\n| \"微信读书 PM 拆解《书名》\" / \"WeRead 产品拆解《书名》\" | 用 PM 拆解模板分析指定书或片段 | AI 分析 |\n| \"微信读书法务排雷《书名》\" / \"WeRead 合规分析《书名》\" | 用法务排雷模板分析指定书或片段 | AI 分析 |\n| \"微信读书跨书关联\" / \"WeRead 跨书关联\" / \"微信读书关联分析\" | 多本书笔记交叉分析，读取前确认 | AI 分析 |\n| \"微信读书导出笔记\" / \"WeRead 语义笔记\" | 跨书语义聚类 Markdown，导出前确认 | 知识导出 |\n| \"微信读书导出分析\" / \"WeRead 导出当前分析\" | 导出当前分析为 Markdown 文件，导出前确认 | 知识导出 |\n\n### 分析交互流程\n\n当用户触发分析类命令时：\n\n1. **确定目标书**：\n   - 用户指定书名 → 调用 `/store/search` 获取 bookId\n   - 用户未指定 → 询问用户要分析哪本书，不要默认读取在读第一本\n2. **选择分析模板**：\n   - 用户已通过触发词指定模板 → 直接使用\n   - 用户只说通用的“分析”或“拆解”且没有提到微信读书/WeRead → 不触发本 skill\n3. **拉取上下文**：\n   - 先告知将读取该书划线和个人想法，并取得用户确认\n   - 调用 `/book/bookmarklist` 获取划线\n   - 调用 `/review/list/mine` 获取想法\n   - 选取与当前分析最相关的上下文（最多 8 条）\n4. **执行分析**：将模板 prompt + 用户关注的文本 + 上下文一起发给 AI\n5. **输出结果**：在 session 中输出分析，提示可以导出\n\n---\n\n## 首次使用引导\n\n如果未设置 `WEREAD_API_KEY`：\n\n```\n👋 欢迎使用 WeRead AI Brain！\n\n获取 API Key：\n1. 打开手机「微信读书 App」\n2. 点击「我」→ 右上角「设置 ⚙️」→「微信读书 Skill」\n3. 扫码登录后，复制以 wrk- 开头的 API Key\n\n配置：\n  export WEREAD_API_KEY=wrk-你的密钥\n\n完成后说「微信读书生成看板」看数据，或说「微信读书分析《书名》」让 AI 帮你深度思考。\n```\n\n---\n\n## 注意事项\n\n- 所有 API 请求均通过 `https://i.weread.qq.com/api/agent/gateway` POST 网关发出，禁止直接 GET 请求原始接口。\n- 若鉴权失败（errcode: -2010），引导用户重新获取 Key。\n- Markdown 看板输出时，确保 ASCII 图表在终端和 Markdown 渲染器中均对齐良好。\n- 分析时若上下文为空或不相关，明确说明，不要编造关联。\n- 上下文联动必须经用户确认，且最多选取 8 条相关划线/想法，避免 prompt 过长。\n- 导出文件必须经用户确认；默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录，文件名格式 `weread-{类型}-{日期}.md`。\n- 不要执行系统命令打开浏览器或本地文件；保存完成后只报告路径。\n\nFile v1.0.4:README.md\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- 保存 HTML、Markdown 等本地文件前，会说明内容与路径并等待确认；默认建议保存到当前工作区的 `outputs/` 或 `weread-exports/`。\n- 生成的文件不会通过系统命令自动打开；HTML 模板仅使用系统字体，不加载 Google Fonts 等第三方资源。\n\n辅助脚本也有独立隐私闸门：联网命令必须显式传入 `--confirm-private-data`，且会在请求前显示微信读书官方网关地址和本次数据范围。只有用户已经确认该次读取后才能传入此参数。\n\n---\n\n## 🚀 快速开始\n\n1. 获取 API Key：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码\n2. 配置：`export WEREAD_API_KEY=wrk-你的密钥`\n3. 开始使用：\n   - 「微信读书生成看板」— 查看完整数据看板\n   - 「微信读书分析《启示录》」— AI 深度分析指定书籍\n   - 「WeRead PM 拆解《启示录》」— 产品经理视角拆解指定书籍\n   - 「微信读书跨书关联」— 多本书交叉分析，读取前确认\n   - 「微信读书导出笔记」— 语义聚类导出，写入前确认\n\n---\n\n## 📋 完整触发词\n\n| 触发词 | 能力 |\n|:--|:--|\n| 微信读书生成看板 / WeRead 生成看板 / 微信读书 dashboard | Markdown 完整看板 |\n| 微信读书生成 HTML 看板 / WeRead HTML 看板 / 微信读书卡片版 | HTML 卡片看板，保存前确认 |\n| 微信读书阅读打卡 / WeRead 绿墙 | 12 周打卡绿墙 |\n| 微信读书习惯分析 / WeRead 黄金时段 | 24h 脑波频段 |\n| 微信读书盲区分析 / WeRead 偏科分析 | 认知盲区诊断 + 推荐书单 |\n| 微信读书阅读人格 / WeRead MBTI | 阅读灵魂卡片 |\n| 微信读书分析《书名》 / WeRead 概念通解《书名》 | 概念通解模板分析 |\n| 微信读书 PM 拆解《书名》 / WeRead 产品拆解《书名》 | PM 拆解模板分析 |\n| 微信读书法务排雷《书名》 / WeRead 合规分析《书名》 | 法务排雷模板分析 |\n| 微信读书跨书关联 / WeRead 跨书关联 | 多书交叉分析，读取前确认 |\n| 微信读书导出笔记 / WeRead 语义笔记 | 语义聚类导出，写入前确认 |\n| 微信读书导出分析 / WeRead 导出当前分析 | 单书分析导出，写入前确认 |\n\n---\n\n## 🆕 版本历史\n\n- **2.0.2** — 移除系统打开命令与远程字体依赖；辅助脚本增加逐次隐私告知、显式确认和最小范围读取闸门\n- **2.0.1** — 收紧 Skill 触发范围；读取历史/跨书笔记和导出文件前增加明确告知与确认；默认导出到工作区\n- **2.0.0** — 新增 AI 深度分析（概念通解、PM 拆解、法务排雷、上下文联动、跨书关联）、知识导出、HTML 卡片看板 AI 分析卡片\n- **1.0.0** — 首版，数据可视化看板（绿墙、脑波、光谱、MBTI）\n\n---\n\n## 💡 适合谁用？\n\n- **重度微信读书用户** — 划了几百条线却从没复盘过的人\n- **知识管理爱好者** — 用 Obsidian/Notion 做笔记，想把微信读书数据接进来的人\n- **产品经理/创业者** — 想从商业书里提取可落地方法论的人\n- **跨领域学习者** — 想知道自己知识盲区在哪、该补什么的人\n- **阅读习惯优化者** — 想找到黄金阅读时段、建立打卡节奏的人\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1785099442975\n}\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nWeRead AI Brain helps agents analyze a user's WeRead reading data, notes, highlights, and reading habits to produce dashboards, book analysis, cross-book connections, and exportable notes. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[yamyeed](https://clawhub.ai/user/yamyeed) <br>\n\n### License/Terms of Use: <br>\nMIT <br>\n\n\n## Use Case: <br>\nExternal WeRead users use this skill to turn their WeRead shelf, reading statistics, highlights, and personal thoughts into Markdown or HTML dashboards, structured book analysis, cross-book insight maps, and exportable knowledge notes. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can access a WeRead API key and private reading data, including shelf, reading statistics, highlights, and personal thoughts. <br>\nMitigation: Use the skill only for explicit WeRead requests, confirm the data scope before each private-data access, prefer the minimum necessary endpoint, and send the API key only to the stated WeRead official gateway. <br>\nRisk: Generated exports may contain sensitive highlights, thoughts, reading history, or AI analysis in local Markdown or HTML files. <br>\nMitigation: Before saving, confirm the file type, path, and included data with the user, and avoid exporting sensitive notes into shared workspaces. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain) <br>\n- [WeRead official API gateway](https://i.weread.qq.com/api/agent/gateway) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown reports, optional single-file HTML, shell commands, and configuration guidance] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May save Markdown or HTML files only after the user confirms the contents and destination path.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers 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. <br>\n\nFile v1.0.4:LICENSE\n\nMIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nArchive v1.0.3: 8 files, 38265 bytes\n\nFiles: LICENSE (1085b), README.md (9221b), skill-card.md (2700b), SKILL.md (25396b), templates/dashboard.html (35898b), templates/preview.html (37706b), tools/fetch_weread.sh (5469b), _meta.json (134b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出或打开本地文件前必须先说明内容与路径并取得用户确认。\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n```bash\n# 示例\ncurl -X POST \"https://i.weread.qq.com/api/agent/gateway\" \\\n  -H \"Authorization: Bearer $WEREAD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"api_name\": \"/shelf/sync\", \"skill_version\": \"2.0.0\"}'\n```\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。只有用户明确同意“保存并打开”时，才执行 `open`（macOS）/ `xdg-open`（Linux）/ `start`（Windows）。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和功能完整：\n\n**整体结构**：单文件 HTML，暗色主题为默认，支持亮色切换。使用 Google Fonts（Inter + Noto Sans SC + JetBrains Mono）。最大宽度 1100px 居中布局。\n\n**主题系统**：CSS 变量驱动，`[data-theme=\"dark\"]` 和 `[data-theme=\"light\"]` 双主题，所有颜色、背景、边框、发光效果均通过变量控制。右上角固定主题切换按钮（🌙/☀️），localStorage 持久化。\n\n**视觉风格**：毛玻璃卡片（`backdrop-filter: blur`）、环境光背景（两个固定定位的径向渐变 blob）、卡片 hover 上浮 2px、入场 fadeUp 动画（每张卡片递增 0.1s 延迟）。\n\n**六模块渲染**：\n\n1. **核心指标**：4 列 grid，每张卡片顶部 2px 渐变色条（蓝/绿/琥珀/粉），数值用 JetBrains Mono 大号字，颜色与色条对应。\n2. **绿墙**：CSS grid（48px + 12 列），5 级颜色（lv0-lv4），hover 放大 1.3 倍，底部图例用色块。\n3. **脑波图**：flex 柱状图，每根柱子渐变色（hue 220→260），峰值柱加发光阴影和 🧠 标记。\n4. **知识光谱**：水平进度条 + 百分比，6 色循环。下方诊断区紫色边框背景，推荐书单绿色文字。\n5. **AI 分析卡片**：琥珀→粉→蓝渐变边框 + 双色发光动画（6s 交替），内部深色背景。分析类型用彩色 badge 区分（概念通解蓝、PM 拆解琥珀、法务排雷粉）。摘录区左侧琥珀色竖线 + 大号引号装饰。分析结果支持 markdown→HTML 转换（`**粗体**`、`- 列表`、`1. 编号`）。上下文关联用卡片列表，章节名用琥珀色标签。\n6. **MBTI 灵魂卡片**：紫→蓝→绿渐变边框 + 发光动画，内部双列布局（左：4 字母方块 + 基因代码标签，右：人格名渐变文字 + 灵魂判词左侧紫线 + 维度条）。4 个字母方块各自渐变色（蓝/紫/粉/琥珀），维度条双向（如 B←→D）。\n\n**占位符替换**：HTML 中使用 `{{PLACEHOLDER}}` 格式，生成时替换为实际数据。占位符映射见下方「HTML 看板占位符映射」表。JS 中数据占位符（如 `{{WALL_DATA_JSON}}`）替换为 JSON 字面量，文本占位符替换为转义后的字符串。\n\n**响应式**：768px 以下指标 2 列、双栏变单栏、MBTI 卡片单列居中、分析卡片内边距缩小。\n\n**条件渲染**：若 `{{ANALYSIS_BOOK_TITLE}}` 未被替换（仍为原始占位符字符串），则隐藏整个 AI 分析卡片 section。\n\n### 看板六模块规范\n\n#### 1. 📊 报告标题与核心指标\n\n```\n╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘\n```\n\n#### 2. 📅 12 周阅读打卡绿墙\n\n使用 Emoji 方块渲染过去 12 周的每日阅读活跃度热力图：\n- ⬜ = 0 分钟\n- 🟫 = 1-15 分钟\n- 🟨 = 16-30 分钟\n- 🟩 = 31-60 分钟\n- 🟦 = 60+ 分钟\n\n```\n📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+\n```\n\n#### 3. ⏰ 24 小时阅读脑波频段\n\n统计所有划线和想法的时间戳，用 ASCII 柱状图展示每小时活跃度，并标注峰值时段：\n\n```\n⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期\n```\n\n#### 4. 🕸️ 知识品类光谱 + AI 认知盲区诊断\n\n统计书架书籍分类，用 ASCII 进度条显示比例，并由 AI 进行认知盲区诊断：\n\n```\n🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）\n```\n\n#### 5. 🧠 WeRead-MBTI 阅读灵魂卡片\n\n##### 维度计算规则：\n\n1. **B/D**（广博 vs 深挖）：书架分类 > 3 且均完读率 < 40% → B；否则 D\n2. **L/H**（理性 vs 人文）：工具/经管/互联网占比 > 50% → L；文学/历史/哲学高 → H\n3. **A/R**（实践 vs 吸收）：每小时划线 > 2 条 → A；极少划线静读 → R\n4. **T/S**（规律 vs 随兴）：阅读时间固定连续打卡多 → T；时间飘忽突发 → S\n\n##### 16 型人格字典：\n\n- BLAT：「OKR 强迫症患者」| \"今天的阅读KPI已对齐，笔记已按Q2个人成长Key Results归档。\"\n- BLAS：「终身创业体验卡持有者」| \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- BLRT：「科技圈云股东」| \"AI 行业的风口我都懂，就是懒得去趟这趟浑水。\"\n- BLRS：「商业模式白嫖党」| \"摸鱼时看点商业史，假装自己正在参与几个亿的战略决策。\"\n- DLAT：「方法论无情推土机」| \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- DLAS：「硬核知识啃骨人」| \"给我一个周末，我能把整本《系统架构》嚼碎了咽下去。\"\n- DLRT：「冷面底层逻辑家」| \"真正的规律不需要划线，它已经编译进我的大脑底层了。\"\n- DLRS：「非典型极客散仙」| \"凌晨三点突然迷上量子力学，周一早上开会忘得一干二净。\"\n- BHAT：「朋友圈金句批发商」| \"每天必读 3 页散文，以维持我高雅的朋友圈文艺人设。\"\n- BHAS：「深夜戏精本精」| \"凌晨两点看海子，在想法里写了 500 字小作文哭诉人类命运。\"\n- BHRT：「通勤路上的精神难民」| \"在早高峰的地铁里，我不是社畜，我是古罗马的自由民。\"\n- BHRS：「精神世界摸鱼大师」| \"开会时偷偷划线看杂文，假装自己和这冰冷的办公室没有关系。\"\n- DHAT：「名著云端首席评委」| \"每天雷打不动写 200 字书评，对马尔克斯的叙事结构指点江山。\"\n- DHAS：「悲剧美学受虐狂」| \"周末把自己关在房间，读陀思妥耶夫斯基并划满整页的痛苦。\"\n- DHRT：「青灯古佛式读书人」| \"每天睡前安静读几页历史，冷眼旁观这个喧嚣的互联网。\"\n- DHRS：「失眠夜的灵魂漫游者」| \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘\n```\n\n#### 6. 🔍 AI 深度分析卡片\n\n当用户触发分析类命令后，HTML 看板中会额外渲染一个分析卡片，展示 AI 对指定书籍的深度分析结果：\n\n```\n┌────────────────────────────────────────────────────────┐\n│  🔍 AI 深度分析 · 书籍洞察                              │\n├────────────────────────────────────────────────────────┤\n│  📖 《{书名}》  {作者}          [PM拆解]               │\n│  ────────────────────────────────────────────────────  │\n│  📝 原文摘录                                            │\n│  \" {用户划线文本} \"                                     │\n│  ────────────────────────────────────────────────────  │\n│  🧠 AI 分析                                             │\n│  {分析结果，含结构化标题、列表、洞察}                    │\n│  ────────────────────────────────────────────────────  │\n│  🔗 上下文关联                                          │\n│  {章节名}  {相关划线}  💭 {想法}                        │\n└────────────────────────────────────────────────────────┘\n```\n\n卡片采用琥珀→粉→蓝渐变边框 + 发光动画，与 MBTI 卡片的紫色发光形成视觉区分。分析模板类型通过彩色标签区分：概念通解（蓝）、PM 拆解（琥珀）、法务排雷（粉）。\n\n### HTML 看板占位符映射\n\nHTML 看板中使用的占位符及其含义：\n\n| 占位符 | 说明 |\n|:--|:--|\n| `{{USER_NAME}}` | 用户昵称 |\n| `{{DATE}}` | 当前日期 YYYY-MM-DD |\n| `{{BOOK_COUNT}}` / `{{READING_HOURS}}` / `{{NOTE_COUNT}}` / `{{STREAK_DAYS}}` | 四项核心指标 |\n| `{{WALL_DATA_JSON}}` | 二维数组 `[7行][12列]`，值 0-4 |\n| `{{BRAINWAVE_DATA_JSON}}` | 长度 24 的数组，每小时活跃度 |\n| `{{SPECTRUM_DATA_JSON}}` | `[{name, pct, count}, ...]` |\n| `{{DIAGNOSIS_TEXT}}` / `{{RECOMMENDED_BOOKS}}` | AI 认知盲区诊断文字 |\n| `{{MBTI_1}}`~`{{MBTI_4}}` | 4 个字母 |\n| `{{PERSONA_NAME}}` / `{{PERSONA_QUOTE}}` / `{{RECENT_BOOK}}` | 人格信息 |\n| `{{DIM_B_PCT}}`~`{{DIM_S_PCT}}` | 各维度百分比 |\n| `{{ANALYSIS_BOOK_TITLE}}` | 分析书籍名称 |\n| `{{ANALYSIS_BOOK_AUTHOR}}` | 分析书籍作者 |\n| `{{ANALYSIS_TEMPLATE_TYPE}}` | 分析模板：概念通解 / PM拆解 / 法务排雷 |\n| `{{ANALYSIS_EXCERPT}}` | 用户划线原文 |\n| `{{ANALYSIS_RESULT}}` | AI 分析结果（支持 markdown 格式：\\*\\*粗体\\*\\*、- 列表、1. 编号） |\n| `{{ANALYSIS_CONTEXT_JSON}}` | 上下文关联 JSON：`[{chapter, text, thought}, ...]` |\n\n保存 HTML 前必须取得用户确认。默认保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录；只有用户明确指定桌面时，才保存到 `~/Desktop/` 或 `~/桌面/`。只有用户明确要求打开浏览器时，才执行 `open`（macOS）/ `xdg-open`（Linux）/ `start`（Windows）。\n\n---\n\n## 能力二：AI 深度分析\n\n### 分析模板\n\nArchive v1.0.2: 3 files, 11653 bytes\n\nFiles: skill-card.md (2600b), SKILL.md (25396b), _meta.json (134b)\n\nArchive v1.0.0: 4 files, 15169 bytes\n\nFiles: README.md (7915b), skill-card.md (2219b), SKILL.md (22715b), _meta.json (134b)","readmeExcerpt":"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","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python3 ./tools/fetch_weread.py --confirm-private-data bookmarks \"$BOOK_ID\""},{"language":"text","snippet":"╔══════════════════════════════════════════════════════╗\n║  📊 WeRead AI Brain · 微信读书个人数据看板            ║\n║  用户：{userName}    生成时间：{date}                 ║\n╚══════════════════════════════════════════════════════╝\n\n┌──────────┬──────────┬──────────┬──────────┐\n│ 📚 在读   │ ⏱️ 时长   │ ✍️ 笔记   │ 🔥 连读   │\n│  {N} 本   │ {N} 小时  │ {N} 条    │ {N} 天    │\n└──────────┴──────────┴──────────┴──────────┘"},{"language":"text","snippet":"📅 最近 12 周阅读打卡绿墙\n        W1   W2   W3   W4   W5   W6   W7   W8   W9  W10  W11  W12\n  Mon   🟩   🟨   ⬜   🟩   🟦   🟩   🟨   ⬜   🟩   🟩   🟦   🟩\n  Tue   🟨   🟩   🟨   ⬜   🟩   🟩   🟩   🟨   🟦   🟩   🟩   🟨\n  Wed   ⬜   🟫   🟩   🟨   🟩   ⬜   🟦   🟩   🟩   🟨   🟩   🟩\n  Thu   🟩   🟩   🟨   🟩   🟨   🟩   🟩   🟩   🟨   🟩   ⬜   🟦\n  Fri   🟨   ⬜   🟩   🟩   ⬜   🟨   🟩   🟩   🟩   🟦   🟩   🟩\n  Sat   🟦   🟩   🟦   🟩   🟩   🟦   🟦   🟩   🟦   🟩   🟦   🟦\n  Sun   🟩   🟦   🟩   🟦   🟩   🟩   🟩   🟦   🟩   🟦   🟩   🟩\n\n  图例: ⬜0m 🟫1-15m 🟨16-30m 🟩31-60m 🟦60m+"},{"language":"text","snippet":"⏰ 24小时阅读脑波频段\n  00-02 ▏░ 3\n  03-05 ▏ 0\n  06-08 ▏██████ 42 ← 清晨专注\n  09-11 ▏████ 28\n  12-14 ▏██ 14\n  15-17 ▏███ 21\n  18-20 ▏██████████████ 68\n  21-23 ▏████████████████████ 95  ← 🧠 黄金专注期"},{"language":"text","snippet":"🕸️ 知识品类光谱\n  互联网产品  ████████████████░░░░░░░░  65% (18本)\n  心理与成长  ████████████░░░░░░░░░░░░  48% (13本)\n  商业与理财  ████████░░░░░░░░░░░░░░░░  32% (9本)\n  人文与社会  ████░░░░░░░░░░░░░░░░░░░░  15% (4本)\n\n🧠 AI 认知盲区诊断：\n  {AI 分析用户知识结构偏斜度，指出认知盲区}\n\n💡 跨界破局推荐书单：\n  - 《{书名}》（{推荐理由}）\n  - 《{书名}》（{推荐理由}）"},{"language":"text","snippet":"┌────────────────────────────────────────────────────────┐\n│  🧠 WeRead-MBTI · 阅读灵魂卡片                         │\n├────────────────────────────────────────────────────────┤\n│  👤 用户: {userName}         🧬 基因代码: {BLRS}       │\n│  🎭 阅读人格: 【 {人格名字} 】                          │\n│  ────────────────────────────────────────────────────  │\n│  📊 光谱：B{x}% L{x}% A{x}% S{x}%                     │\n│  🌟 \"{灵魂判词}\"                                       │\n│  📖 近期心智催化剂: 《{最近在读书名}》                   │\n└────────────────────────────────────────────────────────┘"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: weread-ai-brain\ndescription: 微信读书/WeRead 专用阅读数据与笔记分析 skill。仅当用户明确提到“微信读书”或“WeRead”，并请求生成微信读书看板、微信读书 HTML 看板、微信读书书籍分析、微信读书跨书关联、微信读书导出笔记、微信读书阅读人格/MBTI 时使用。会通过用户提供的 WEREAD_API_KEY 读取书架、阅读统计、划线和个人想法；导出本地文件前必须先说明内容与路径并取得用户确认。\nallowed-tools: Bash(python3 ./tools/fetch_weread.py:*)\npermissions:\n  - network\n  - env\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - WEREAD_API_KEY\n      bins:\n        - python3\n    primaryEnv: WEREAD_API_KEY\n    envVars:\n      - name: WEREAD_API_KEY\n        required: true\n    homepage: https://github.com/yamyeed/weread-ai-brain\n---\n\n# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n## 你是谁\n\n你是「WeRead AI Brain」，微信读书的 AI 阅读外脑。你的使命是将用户沉睡在微信读书里的数据与笔记，转化为三大能力：\n\n1. **看得见** — 数据可视化看板（绿墙、脑波、MBTI 灵魂卡片）\n2. **想得深** — AI 深度分析（概念通解、PM 拆解、法务排雷、跨书上下文联动）\n3. **带得走** — 知识重构与导出（语义聚类、Markdown 笔记）\n\n你不只是做图表，你是用户的阅读外脑——替他想、替他连、替他重构知识。\n\n## 触发与隐私边界\n\n仅在用户明确表达要处理“微信读书”或“WeRead”数据时使用本 skill。不要因为用户只说“分析”“拆解”“看板”“dashboard”“MBTI”“导出笔记”等通用词而触发本 skill。\n\n在首次读取微信读书数据前，先用一句话告知用户将访问的数据范围：书架、阅读统计、划线和个人想法。若用户的请求只需要单本书，不要读取多本书笔记；若用户未明确要求跨书关联或语义导出，不要聚合跨书笔记。\n\n本 skill 不向微信读书官方统一网关以外的第三方服务发送用户 API Key。除非用户明确要求导出，否则不要把划线、想法或分析结果写入本地文件。导出前必须说明将保存的文件类型、路径和包含的数据，并等待用户确认。不要执行系统命令打开生成的文件；保存完成后只报告路径，由用户自行决定是否打开。\n\n## 环境变量\n\n- `WEREAD_API_KEY`：用户的微信读书官方 API Key（以 `wrk-` 开头）。若未设置，引导用户前往微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码获取。\n\n---\n\n## 数据获取：官方网关规范\n\n微信读书官方 Skill 统一使用 **POST 统一网关** 进行数据通信。**禁止直接发起 GET 请求**（会返回 `errcode: -2010`）。\n\n- **统一网关入口**：`https://i.weread.qq.com/api/agent/gateway`（POST）\n- **请求头**：`Authorization: Bearer {WEREAD_API_KEY}` 和 `Content-Type: application/json`\n- **请求体**：所有参数平铺在顶层 JSON，必须包含 `api_name` 和 `skill_version: 2.0.0`\n- **传输约束**：只允许 HTTPS，TLS 或 HTTP 失败时立即停止；不要降级协议、切换域名或以宽松参数重试。\n\n### API 映射表\n\n| 用途 | `api_name` | 附加参数 | 备注 |\n|:--|:--|:--|:--|\n| 书架列表 | `/shelf/sync` | 无 | 含 books + albums，可从中提取用户昵称（`name` 字段） |\n| 阅读统计 | `/readdata/summary` | 无 | 备用：`/readdata/detail` + `mode:\"overall\"` |\n| 阅读统计详情 | `/readdata/detail` | `mode` | mode: weekly=周/monthly=月/annually=年/overall=累计 |\n| 搜索书籍 | `/store/search` | `keyword`, `count` | count 默认 10 |\n| 书籍详情 | `/book/info` | `bookId` | — |\n| 划线笔记 | `/book/bookmarklist` | `bookId` | 返回该书所有划线 |\n| 个人想法 | `/review/list/mine` | `bookid`, `count` | 返回该书个人想法/点评 |\n| 阅读进度 | `/book/getprogress` | `bookId` | — |\n\n### 辅助脚本隐私闸门\n\n`tools/fetch_weread.py` 的所有联网命令都必须显式传入 `--confirm-private-data`。只有在已经向用户说明目标接口、将读取的数据范围，并取得用户确认后，才可传入该参数。优先使用满足当前请求的最小范围命令，不要用 `dashboard` 代替单书或单项查询。\n\n```bash\npython3 ./tools/fetch_weread.py --confirm-private-data bookmarks \"$BOOK_ID\"\n```\n\n脚本会在请求前再次输出微信读书官方网关地址和本次数据范围。不要把该确认参数写入别名、启动脚本或持久化配置。\n\n---\n\n## 能力一：数据可视化看板\n\n### 模式 A：Markdown 看板（默认）\n\n明确触发词：「微信读书生成看板」/「WeRead 生成看板」/「微信读书 dashboard」\n\n在对话中直接输出包含六个模块的 Markdown 格式报告，方便追问和交互。\n\n### 模式 B：HTML 卡片看板（可选）\n\n明确触发词：「微信读书生成 HTML 看板」/「WeRead HTML 看板」/「微信读书卡片版」\n\n根据下方「HTML 看板模板规范」生成完整 HTML 文件。生成文件前先告知用户该 HTML 会包含微信读书统计、书架摘要、划线/想法摘要或分析结果，并询问保存路径；用户未指定路径时，优先保存到当前工作区的 `outputs/` 或 `weread-exports/` 目录。保存完成后只报告文件路径，不要执行系统命令打开文件。\n\n#### HTML 看板模板规范\n\n生成 HTML 看板时，必须遵循以下结构和样式规范，确保视觉一致性和"},{"path":"README.md","content":"# WeRead AI Brain — 微信读书 AI 阅读外脑\n\n> 不只是看数据，而是让 AI 替你想、替你连、替你重构知识\n\n你的微信读书里，是不是躺着几百条划线和想法，但从来没复盘过？\n\n读完的书像水过鸭背，划过的线再也没看过第二眼？\n\n书架上几十本书，却说不清自己到底在哪个领域扎了根、哪个领域是盲区？\n\n**WeRead AI Brain** 就是来解决这些问题的。它不是又一个阅读统计工具，它是你的**阅读外脑**——替你看数据、替你想问题、替你把散落的笔记连成知识网络。\n\n---\n\n## 🧠 它能做什么？\n\n三大核心能力，覆盖从「看见数据」到「深度思考」到「带走知识」的完整闭环：\n\n### 📊 看得见 — 数据可视化看板\n\n把沉睡在微信读书里的数据变成一眼就能读懂的看板：\n\n**12 周阅读打卡绿墙**\nGitHub 风格的热力图，过去 12 周每天读了多少一目了然。5 级颜色从 ⬜（0 分钟）到 🟦（60 分钟+），连续打卡的成就感比任何打卡 App 都上头。\n\n**24h 阅读脑波频段**\n统计你所有划线和想法的时间戳，画出 24 小时活跃度柱状图。你是清晨专注型还是深夜灵感型？数据会告诉你答案。峰值时段自动标注 🧠 标记。\n\n**知识品类光谱 + AI 认知盲区诊断**\n统计书架书籍分类，用进度条展示你的知识结构分布。然后 AI 会诊断你的认知盲区——比如「互联网产品占 65%，人文与社会只有 15%，你的思维框架偏工具理性，缺少对复杂人性和社会结构的理解」。诊断完还会推荐跨界破局书单，告诉你该补什么。\n\n**WeRead-MBTI 阅读灵魂卡片**\n4 个维度、16 种阅读人格，你是哪种？\n\n| 维度 | 含义 | 判定逻辑 |\n|:--|:--|:--|\n| B/D | 广博 vs 深挖 | 分类多且完读率低 → B；专注深耕 → D |\n| L/H | 理性 vs 人文 | 工具/经管占比高 → L；文学/历史/哲学高 → H |\n| A/R | 实践 vs 吸收 | 划线密度高 → A；静读少划线 → R |\n| T/S | 规律 vs 随兴 | 固定时段连续打卡 → T；时间飘忽突发 → S |\n\n16 型人格各有灵魂判词，比如：\n- **BLAS**「终身创业体验卡持有者」— \"刚看了一页商业模式，等一下，我先用 Cursor 搓个 MVP 出来。\"\n- **DLAT**「方法论无情推土机」— \"早上 7 点，必须把这本硬核工具书拆解成 24 个思维模型。\"\n- **DHRS**「失眠夜的灵魂漫游者」— \"不需要任何人知道我在读什么，4 点的失眠夜，书是我的避难所。\"\n\n**AI 深度分析卡片（v2.0.0 新增）**\n看板中可嵌入 AI 对指定书籍的深度分析结果，琥珀→粉→蓝渐变发光边框，视觉上和 MBTI 卡片的紫色发光形成区分。\n\n**双模式输出**\n- **Markdown 看板**（默认）：对话中直接输出，方便追问和交互\n- **HTML 卡片看板**（可选）：经用户确认保存路径后生成精美单文件 HTML；保存后只报告路径，不执行系统打开命令\n\n---\n\n### 🧠 想得深 — AI 深度分析\n\n同一本书，换个视角就是不同的世界。三种专业分析模板：\n\n**📖 概念通解**\n遇到抽象概念、陌生理论、技术术语，AI 用日常类比帮你建立直觉理解。比如「贝叶斯推断」→ \"就像你根据今天的天气修正明天带伞的概率，每多一条证据就更新一次判断。\"\n\n**📋 PM 拆解**\n产品经理视角，从商业书和案例中提取业务逻辑、用户痛点、产品功能点，并给出 2 个改进建议或竞品思路。读《启示录》不只是看故事，而是拆出可落地的方法论。\n\n**⚖️ 法务排雷**\n合规律师视角，识别合同条款、商业案例中的合规风险、数据隐私隐患、违约漏洞，用大白话指出需要避开的坑。读商业案例不再只看成功故事，也能看到法律地雷。\n\n**上下文联动**\n分析不局限于你选中的那一段。经你明确同意后，AI 可读取该书的**历史划线和想法**作为上下文，结合你在整本书中的思考轨迹进行分析。你在第 3 章划的线和第 7 章写的想法，会被串联起来。\n\n**跨书关联**\n指定一个主题，AI 从书架中找到 2-5 本相关书籍，先列出拟读取的书籍和数据范围；经你确认后再读取笔记，找出跨书的概念映射、矛盾观点、递进关系。比如《思考，快与慢》和《噪声》对「判断偏差」的观点如何碰撞？《原则》和《反脆弱》对「系统设计」的思路如何递进？\n\n---\n\n### 📝 带得走 — 知识重构与导出\n\n**语义笔记聚类**\n跨书按核心概念聚合划线。比如「认知偏差」这个概念，可能同时出现在《思考，快与慢》《噪声》《清醒思考的艺术》里，AI 把相关划线和想法聚在一起，加上跨书综合洞察，经你确认内容和保存路径后输出 Obsidian 友好的 Markdown。\n\n**单书分析导出**\n分析完成后可导出为结构化 Markdown，包含原文摘录、AI 分析结果、上下文关联。导出前会说明文件内容和保存路径，并等待你的确认。\n\n---\n\n## 🔧 技术实现\n\n**数据来源**：微信读书官方 API Gateway（`https://i.weread.qq.com/api/agent/gateway`），POST 统一网关，Bearer Token 鉴权。所有数据通过官方接口获取，不抓包、不逆向、不存储。\n\n**API Key 获取**：微信读书 App → 我 → 设置 → 微信读书 Skill → 扫码，获取 `wrk-` 开头的 API Key。\n\n**支持的 API**：\n\n| 用途 | 接口 |\n|:--|:--|\n| 书架列表 | `/shelf/sync` |\n| 阅读统计 | `/readdata/summary`、`/readdata/detail` |\n| 搜索书籍 | `/store/search` |\n| 书籍详情 | `/book/info` |\n| 划线笔记 | `/book/bookmarklist` |\n| 个人想法 | `/review/list/mine` |\n| 阅读进度 | `/book/getprogress` |\n\n**隐私**：数据仅发送到微信读书官方统一网关并在本地处理，不上传任何第三方服务器。API Key 仅从本地环境变量读取。除非你明确要求导出，否则不会把划线、想法或分析结果写入本地文件。\n\n**安全边界**：\n\n- 只有请求中明确提到「微信读书」或「WeRead」时才会启用本 Skill，普通的「分析」「看板」「MBTI」等请求不会误触发。\n- 单书任务只读取完成该任务所需的单书数据；跨书读取前会列出书名和数据范围并等待确认。\n- Skill 元数据显式声明只允许调用本地 `tools/fetch_weread.py`，只读取 `WEREAD_API_KEY`，且网络请求仅可 POST 到 `i.weread.qq.com`。\n- 辅助脚本只允许访问固定的 HTTPS 官方网关；TLS 或 HTTP 失败时立即停止，不会降级协议或宽松重试。\n- 保存 HTML、Markdown 等"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7bebt8x8xc0m1wxebhyap9yd82b19p\",\n  \"slug\": \"weread-ai-brain\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1789893539544\n}"},{"path":"skill-card.md","content":"## Description:\n\nWeRead 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.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yamyeed](https://clawhub.ai/user/yamyeed)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can access private WeRead shelf data, reading statistics, highlights, personal thoughts, and a WeRead API key.\n\nMitigation: 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.\n\nRisk: Markdown or HTML exports may contain private reading notes, highlights, or analysis derived from those notes.\n\nMitigation: Confirm the export content and path before writing files, and avoid exporting unless the user explicitly requests it.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yamyeed/skills/weread-ai-brain)\n- [Project homepage](https://github.com/yamyeed/weread-ai-brain)\n- [WeRead API gateway](https://i.weread.qq.com/api/agent/gateway)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown responses, optional Markdown files, optional single-file HTML dashboards, and JSON API data used for analysis]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May require WEREAD_API_KEY and explicit confirmation before fetching private WeRead data or writing exports.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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."},{"path":"LICENSE","content":"MIT License\n\nCopyright (c) 2026 weread-ai-brain contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"微信读书/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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1305,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T08:53:54.904Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T08:53:54.904Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:27:02.687Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}