Weread Create · 赛道 A：网文写作者的读书→素材库
一句话定位
你划线，AI 把微信读书里零散的划线和想法，变成可检索、可复用、可跨书聚合的写作零件库，并安全存进你的知识库。
它解决什么（写作者视角）
- 微信读书是写作者最稳定、最高质的素材源，但划线散落、难管理、写完就吃灰。
- 本技能做下游加工：抽取 → 多维标签 → 跨书聚合 → 入库（IMA/飞书），让素材真正"用得起来"。
- 只读、本地优先、二次确认、可撤回——安全可控；记住你"在写什么题材"——个性方便。
前置条件
WEREAD_API_KEY（格式wrk-xxxx）：微信读书 App「我 → 设置 → 微信读书 skill」扫码获取。
未配置时引导用户（PowerShell）：
[System.Environment]::SetEnvironmentVariable('WEREAD_API_KEY','wrk-你的key','User')- 依赖官方 Agent Gateway（
POST https://i.weread.qq.com/api/agent/gateway，Bearer 鉴权）。 - 入库 IMA 需要 ima-skill 已装且凭证就绪（见
references/sync_ima.md）。 - 飞书：当前飞书连接器未连接，先导出本地多维表/文档，连上后可推（见
references/sync_feishu.md）。
数据流
【数据源 A：微信读书（自动）】
fetch_weread.py → 本地 JSON（划线+想法+热门划线，可选题材书单）
【数据源 B：番茄/七猫/任意来源（粘贴导入，合规）】
import_clippings.py → 把 App「笔记书摘」复制出的文本整理成 fetch 兼容 JSON
（番茄/七猫无开放划线接口，故用"复制→粘贴"半自动；纸质书 OCR、网页摘录同理通用）
↓ 两者殊途同归
extract_material.py → 7 类素材 + 多维标签（按 weread_profile.json 算适配度）
↓
build_hooks.py → 钩子库（蒸馏开场钩子，标 品类·钩子类型·来源·改写方向）
↓
build_index.py → 全局标签索引（跨书聚合 / 按维度检索，含钩子）
↓
本地预览（MD/JSON）→ 确认后 sync_ima.py 入 IMA / export_feishu.py 出飞书
触发与意图分流
- 「把《XXX》的划线整理成素材」→ 微信读书拉单本 → 抽取。
- 「把番茄/七猫里《XXX》的笔记整理成素材」→ 用户复制 App「笔记书摘」文本 →
import_clippings.py→ 抽取。 - 「攒一波仙侠世界观/人物卡/钩段」→ 拉单本或多本 → 抽取 → 按类型/标签过滤。
- 「汇总我读过的书做个素材库」→ 拉全量 → 抽取 → 建索引。
- 「写仙侠该读什么书 / 给我个书单」→
--recommend 仙侠题材书单（仅微信读书数据源）。 - 「把素材提炼成钩子 / 建个钩子库」→
build_hooks.py：蒸馏出每条标【品类·钩子类型·来源】的开场钩子。 - 「给我所有仙侠·利益类钩子」→
build_index.py --by hook_type或--q 利益（跨书检索钩子）。 - 「存进知识库 / 导入飞书」→ 预览确认后 sync/export（素材库 + 钩子库一并处理）。
通用工作流（必须遵守）
- 先确认 key：
WEREAD_API_KEY未设置 → 引导配置，绝不猜测/编造。 - 读 profile：若不存在，问用户"你主要在写什么题材？"（仙侠/都市/悬疑/历史/科幻/言情/无限流/诡异…），写入
./weread_profile.json（my_genres数组）。用于适配度高亮。 - 拉取 / 导入：
- 微信读书：运行fetch_weread.py，输出 JSON 到本地（默认./weread_data/）。
- 番茄小说 / 七猫小说 / 任意来源：App 内「笔记书摘」复制文本 → 存笔记_书名.txt
→ 运行import_clippings.py --in 笔记_书名.txt，自动规整并抽取。
（这两家无开放划线接口，粘贴导入是合规且稳定的方案；不依赖 Cookie/抓包。） - 抽取：
extract_material.py，生成写作素材_<书名>.md+.json（含标签）。 - 钩子库（推荐）：
build_hooks.py把高杠杆素材蒸馏成开场钩子，每条标【品类·钩子类型·来源·改写方向】。
- 钩子类型 5 类：痛点 / 反常识 / 利益 / 视觉冲击 / 情感冲击（读者心理轴，与内容类型轴正交）。
- 来源必带书名+章节+划线/想法——合规红线：他人钩子只可改写，不可照抄，须可溯源。
- 让 LLM 按"改写方向"公式产出最终钩子文案（脚本只做结构化初判）。 - 聚合（可选）：多本时用
build_index.py建全局索引，支持"所有书的复仇桥段""所有仙侠·利益钩子"这类跨书检索（--by hook_type/--q）。 - 本地预览：先展示 MD，确认无误。
- 入库（需二次确认）：展示将写入的条目数/标题，用户确认后
sync_ima.py/export_feishu.py（素材库与钩子库一并处理）。
7 类素材（默认分类）
人物卡 · 金句库 · 观点洞察 · 桥段爽点 · 世界观设定 · 对话语料 · 描景心理
（分类为启发式初稿，写作时请二次筛选与改写，避免照搬原文。）
钩子库（开场钩子 · 提炼与改写）
素材解决"写什么"，钩子解决"怎么开场抓人"。钩子是最高杠杆复用单元（驱动加书架/点下一章），
用读者心理轴分类，与内容类型轴正交，故独立成库。每条钩子标注：
| 字段 | 含义 | 取值 |
|---|---|---|
| 品类 | 来源书题材，便于按当前在写书匹配 | 仙侠/都市/悬疑/… |
| 钩子类型 | 读者心理触发点 | 痛点 / 反常识 / 利益 / 视觉冲击 / 情感冲击 |
| 来源 | 书名+章节+划线/想法 | 《书名》·第X章·划线 |
| 改写方向 | 该类钩子的产出公式 | 见下 |
| 适配度 | 复用优先级 | ⭐直用 / 🔁可改写 / 💡灵感 |
5 类钩子 + 改写公式（LLM 据此产出最终文案）：
- 痛点：放大一个具体痛点，再给反常出口。『你有没有过〔X〕？——〔出路〕』
- 反常识：先立常识，再推翻。『都说〔常识〕，其实〔反直觉真相〕』
- 利益：收益写成可感知结果（带数字/画面）。『只要〔动作〕，就能〔具体好处〕』
- 视觉冲击：删铺垫，首句砸画面/动作，省略主语更狠。『〔强意象/动作〕＋〔后果〕』
- 情感冲击：从失去/守护/背叛瞬间切入，短句补刀。『〔情绪钩子〕，〔补一刀〕』
> 来源字段是合规红线：他人的钩子只可"受其启发、自行改写"，绝不照抄原文。详见 references/hook_library.md。
多维标签体系（详见 references/tag_taxonomy.md）
- 题材适配（genre_fit）：仙侠/玄幻/都市/悬疑/历史/科幻/言情/无限流/诡异/武侠…
- 功能（function）：钩子/爽点/反转/打脸/铺垫/升华/收尾/转折/虐点/甜点
- 情绪（emotion）：爽/燃/虐/甜/悬疑/致郁/治愈/热血
- 可复用场景（scene）：开局/退婚/复仇/秘境探宝/表白/诀别/觉醒/装逼打脸/团队组建
- 素材类型（type）：即上面 7 类（自动）
Gateway 调用规范（细节见 references/weread_api.md）
- 入口
POST https://i.weread.qq.com/api/agent/gateway；HeaderAuthorization: Bearer $WEREAD_API_KEY。 - Body 必带
skill_version（当前1.0.4），业务参数平铺顶层。 - 回包
upgrade_info出现 → 立即暂停，按message升级后再继续。 - 书名→bookId：先
/store/search取 bookId，再查笔记/划线。 - 热门划线
/book/bestbookmarks可抓"被广泛共鸣的句子"（社会情绪点）。
安全可控（强制）
- 只读：不写回微信读书；产出落本地/IMA/飞书。
- 本地优先：先存本地并预览，确认后再入库。
- 二次确认：push 前展示条目数/标题，须用户确认。
- 凭证不泄漏：key/IMA 凭证只在请求头发官方域名，不写文件、不打印、不进日志。
- 可撤回：入库后返回
note_id/media_id，告知用户在 App 内可删。 - 默认私有：仅入私人知识库/笔记，不外发。
- 不静默降级：缺 key/网络错/缺凭证 → 明确提示 + 引导，不编造数据。
边界
- 本技能只做赛道 A（网文写作素材）。非遗/亲子另见独立技能。
- 依赖官方 Gateway 版本，须跟进
skill_version升级（留意upgrade_info）。 - Key 绑定用户身份，换人需换 key。
