把微信公众号链接变成按原文顺序排列的正文、图片文字和AI画面描述，再让Muse或其他Agent解读。
仅限个人非商业自用。 版权由小柴（GitHub: duevan07）保留；商用、收费代部署、再分发或向他人提供转换服务须另行取得书面授权。详见 完整许可。
把这个项目地址发给你的 AI，再说一句：“我不懂技术，请带我一步一步装好。” 不需要先学会下面的术语。
请带我安装 https://github.com/duevan07/wechat-reader-skill 。我完全不懂技术，请先读 README 里的「Agent 安装引导」。能代办的请直接做；需要我操作时，先打开对应页面，每次只教一步，我完成后检查再继续。复用已有登录和服务，不开通付费，不让我把密码或口令发进聊天。最后读一篇公众号文章，确认实际能用。
给接手的 Agent： 用户要求安装、配置或开始使用时，先读 Agent 安装引导，再按需要查 部署细节。打开当前步骤的页面、核实真实状态、接着完成；不要仅把一整篇教程交还给用户。用户只想了解项目时，先介绍用途，不擅自部署。
你只需要知道两件事：GitHub 是拿到这套工具的地方，Cloudflare 是运行你自己的阅读器的地方。 有浏览器控制能力的 Agent 会帮你打开页面、找到入口、检查安装；没有这项能力的 Agent 会给你当前步骤的直达链接和点按说明，不能假装已经替你打开。
每个人使用自己的 Cloudflare 账户与额度。无需购买域名或维护服务器。你仍需在必要时亲自注册、验证身份、确认授权和填写口令；不是免注册或无限免费服务。登录尚有效时可以复用，不必为每个 AI 对话重新注册或重新部署。
只有手机、使用 Muse？ 从 手机用户安装提示词与流程 开始。Muse 的 GitHub 连接器、Cloudflare 账户登录和 Wechat Reader 凭据是不同的步骤，不能用一个“已连接”代替全部安装验收。
部署入口实测提醒（2026-10-04）： 本项目的 Cloudflare 部署表单出现了 “Browser Rendering … only available on Workers Paid” 提示；同期 Browser Run 官方计费文档 又列出 Free 额度。差异原因尚未查明，也未确认表单是否会阻止部署。新账号的全程免费点击式安装尚未验收。看到 Paid / Upgrade / 绑卡要求就停下，不按本教程开通付费，也不要移除浏览器功能来假装安装完成。
- 登录 GitHub 和 Cloudflare。 在Cloudflare确认Workers套餐显示 Free。已是Paid的账户可能收费，不要直接启用。
- 点上面的部署按钮。 选自己的GitHub与Cloudflare账户。
ACCESS_TOKEN填密码管理器生成的至少24字符随机口令，保存好；确认Free后将READING_ENABLED从false改为true，再部署。无需Cloudflare API Key。 - 打开你自己的站点
/setup.html。 页面检查配置，并提供“复制接入提示词”。如果部署表单没有口令/开关字段，按页内步骤到Worker设置中补齐。 - 把提示词发给 Muse。 Agent安装技能、创建安全凭据入口，你亲自填入同一枚访问口令。之后只发公众号链接，检查实际读取结果。
初次使用可能需要授权Cloudflare连接GitHub，以及启用AI/浏览器产品。详细操作见 跟着点击自建。这些账户授权不能由技能跳过。
- 程序直接提取文章正文，按原文位置插入图片OCR、独立AI描述和失败占位。
- 网页显示处理进度，一键复制带来源与缺项的材料；同一API供Agent使用。
- 原图仅内存处理，不保存文章历史。本文工具不会自动将文章写入Agent长期记忆。
- 验证、登录、付费或拒绝访问时停止，不操作验证码，不轮换身份或IP。
在Cloudflare Free计划内运行；浏览器和AI免费额度用完会失败，恢复后再用。项目默认锁定读取，不会替用户开通或升级付费套餐。请以自己账户与官方计费页为准；软件开关无法检测你的账单，也不是付费账户的消费上限。
源站HTTP读取可能被拦，普通云浏览器也不保证所有文章都可读。整篇多图通常需要几十秒到更久，不承诺毫秒级。原实现的真实样例正文约13–15秒，19图约64–73秒；不同轮次17或18张返回结果，其余明确失败。这是完成数，不是OCR准确率。视频、动图不转录，每次最多处理20张静态图，更多图片保留缺项。
宿主需要能安装/读取技能、发HTTP请求，并安全管理凭据。Muse已在原实现上验证；用户回传的Claude侧测试也成功调用了原实现，原始结果已核对，但该次使用临时包装脚本，正式安装后的自动选技尚未验证。技能本身不会新增宿主工具或强制域名路由。
Muse、Codex、Claude Code 可以共用同一个自建服务，分别完成技能安装和安全凭据配置即可。见 三种Agent接入指南及实测范围。
skill/SKILL.md 是通用技能。服务地址使用 WECHAT_READER_ENDPOINT，或在技能目录保存不含口令的 config.json：{"endpoint":"https://你自己的站点/api/convert"}。口令由安全凭据工具注入 WECHAT_READER_TOKEN；Muse可直接用Vault代理。
Python客户端接受 --image-limit 1 至 --image-limit 20（默认20），并支持 --text-only 仅提取正文。旧版服务的health缺少新版配置字段时，状态应标记未知，不能据此判定部署故障；鉴权和读取以实际转换响应为准。
Node.js 22.18+，开发验证还需Python3。npm ci → npm test → npm run dry-run。本地凭据仅放已忽略的 .dev.vars，部署secret用Cloudflare控制台或Wrangler，不提交Git。
GET /api/health：配置状态；不执行文章读取，不验证口令。POST /api/convert：Bearer鉴权；{"url":"公开公众号URL","images":true,"image_limit":20}。- JSON结果包含
article、markdown、coverage、elapsed_ms、source_method；status=partial须保留缺项。 - 网页采用NDJSON流；HTTP200仅表示流已建立，须读
complete或error。 - 固定真实User-Agent：
WechatCloudReader/1.1 (+https://github.com/duevan07/wechat-reader-skill)；不使用默认Python-urllib标识或冒充浏览器。
首次配置页的随机口令只在浏览器内存产生。部署表单读取 .dev.vars.example 提示填写Secret，示例没有共享默认口令。未设有效口令或未启用读取时不发起文章/AI/浏览器调用。
只处理你有权访问与使用的公开文章。本项目许可不授予第三方文章、图片或商标的再发布权；本项目与腾讯、Meta和Cloudflare无隶属关系。
本项目采用 个人非商业自用许可，属于源码可见项目，不是 MIT 或 OSI 定义的开源项目。允许个人在自己的账户内复制、修改和部署，供本人使用的 Agent 调用；为此所需的 GitHub Fork、部署副本及技能安装副本须保留完整许可。不得擅自改名出售、收费托管、用于商业业务或提供给他人使用。第三方依赖保留各自许可。