前言¶
DeepSeek Harness (DSH) 的核心能力之一是通过插件扩展生态。对于知识管理场景，将阅读笔记和进度接入 DSH 是常见需求。微信读书的数据通常分散在客户端，通过常规爬虫或 Cookie 方式获取不稳定且存在风控风险。
下面介绍的 weread-export 插件，通过调用微信读书官方 Skills Agent Gateway (i.weread.qq.com/api/agent/gateway)，提供了稳定的数据读取与导出能力。
插件简介¶
插件名称：weread-export
维护者：zhengjy01
类别：联网工具
许可证：MIT
这是一个集成到 DeepSeek Harness 的微信读书插件。它使用官方 API Key（wrk- 开头）而非 Cookie 抓取方案，可以读取书架、划线/想法、阅读统计，并支持一键导出到 flomo、本地 Markdown 或 Notion。
安装与启用¶
在终端执行以下命令安装插件：
dsh plugin --profile web add github:zhengjy01/weread-export
安装完成后，重启 DSH GUI 即可生效。
配置¶
插件需要配置 API Key 和可选的 flomo 凭据。
- 打开微信读书 Skills 配置页 https://weread.qq.com/r/weread-skills，用微信读书账号登录。
- 点击「创建 Key」，复制以
wrk-开头的 Key。 - 在 DSH Web 设置页的「微信读书」面板中填入 Key，或在对话中调用
weread_config进行配置。 - （可选）若需导出到 flomo，在「Flomo」面板配置 API URL / API Key。
配置信息会保存在 ~/.dsh/weread-export.json（权限 0600），同步快照保存在 ~/.dsh/weread-export-cache.json。
工具与用法¶
插件提供了多个 Agent 工具，以下为常用命令：
- weread_config
配置或清除 API Key、默认 flomo 标签、导出条数（0=全部）、默认导出目标、本地目录、Notion Token/目标页等。添加test: true可测试连接。 - weread_search
搜索书城，支持书名、作者、评分、在读人数、bookId 或链接。 - weread_book
查看书籍详情、阅读进度及章节目录概览。 - weread_shelf
查看书架，显示书名、进度、最近阅读时间及是否读完（支持实时或缓存模式）。 - weread_notes
不传 bookId 查看笔记本概览；传入 bookId 查看该书划线与想法。 - weread_readdata
查看阅读统计（周/月/年/总计）。 - weread_sync
拉取书架 + 笔记本概览到本地缓存。 - weread_flomo
快捷导出划线到 flomo。标签可自定义，默认按配置导出条数（0=全部），超长内容自动拆分。flomo 凭据复用 dsh-flomo。 - weread_export
多目标导出。默认dest=flomo，支持local（需指定localDir）或notion（独立 Token）。可配合limit控制条数或使用 LLM 模板整理。
注意事项¶
- 微信读书偶尔会要求客户端升级 skill 版本，插件运行时会提示升级信息，需等待插件更新。
- flomo 未配置时，调用
weread_flomo会提示先配置凭据。 - Key 存储在用户目录下，请注意权限安全。
总结¶
该插件通过官方 API 接入了微信读书的核心数据流，解决了数据获取与归档的痛点。适合希望将阅读数据沉淀到 flomo 或本地笔记系统中的 DSH 用户。
