将 X/Twitter 推文（含 Thread 和 Article）转换为自包含 HTML 页面的 Cloudflare Worker。
此外，本Worker也支持任意http(s)链接的视频代理、图片代理、通用资源代理。
https://<your-worker-domain>/{username}/status/{tweet_id}- 支持推文和 Thread（串推）的完整渲染
- 支持 Twitter Article（长文章，含标题、引用、列表、代码块、粗体/斜体等）
- 自动展开推文中的链接
- 支持图片画廊和视频渲染，带横屏检测、视频懒缓冲
- 支持引用推文（Quote Tweet）及其文章预览
- 可选翻译目标语言
- 内置媒体代理：图片/视频经 Worker 服务端回源流式转发，无需任何外部代理即可在无法直连 Twitter 的地区使用
https://<your-worker-domain>/vid/<视频URL>- 通过 Worker 代理视频流，绕过大多数视频站的防盗链与跨域限制
- 完整透传 Range 请求头，支持拖拽播放
- 通过 CDN 缓存 1 年，加速二次加载
- 直连模式：
https://<your-worker-domain>/vid/d/<视频URL>（不经代理）
https://<your-worker-domain>/img/<图片URL>- 剥离
Content-Disposition: attachment，强制以内联方式展示 - 自适应缩放 +
object-fit: contain，在固定比例预览窗格内完整查看 - CDN 缓存 1 年
- 直连模式：
https://<your-worker-domain>/img/d/<图片URL>
https://<your-worker-domain>/proxy/<URL>直接透传任意 http(s):// 资源，附带 CORS 和 1 年缓存。
https://<your-worker-domain>/html/<URL>抓取任意网页并以 HTML 返回，解决第三方平台（如飞书）直连被目标服务器拒绝的问题。
- 可自定义
UA绕过微信公众号等对 UA 的白名单限制 - 图片/视频等媒体经 Worker 代理加载，绕过防盗链
- 页面内
<a>链接改写为/html/<url>，导航不脱离代理体系 - 智能处理 JS/CSS：绝对地址的 CDN 资源走代理，相对路径的资源直连原始域名 （避免 Vite 等构建工具的 chunk 导入在代理后解析错位）
- 非 HTML 资源原样透传
https://<your-worker-domain>/wechat/<URL>与 /html/ 共享抓取 + 改写能力，专为微信公众号文章定制：文章标题包裹 <a> 链接回原文，用户在飞书等嵌入环境里点击标题即可跳转阅读。
https://<your-worker-domain>/github/<user>/<repo> # 默认 README
https://<your-worker-domain>/github/<user>/<repo>/<path> # 指定文件或目录通过 GitHub Contents API 拉取仓库 README 或 任意文件的预渲染 HTML（markdown → HTML + 语法高亮已由 GitHub 完成），图片/视频等媒体经 Worker 内部 /proxy/ 代理加载，避免直连 GitHub
的跨域/防盗链问题。
/github/<user>/<repo>— 展示仓库默认 README（自动识别 README.md / readme.md / README / README.rst 等格式）/github/<user>/<repo>/<path>— 展示指定文件；若路径指向目录，则列出目录下的文件与子目录（可点击进入）- 顶部 header 显示仓库头像、蓝色路径（
user/repo或user/repo/path）以及 Watch / Star / Fork 统计 - 仓库不存在或没有 README 时返回友好错误页
- 可选配置
GITHUB_TOKEN（PAT）提升 API 限流配额（未配置时受未认证 60次/h 限制，仅公共仓库）
示例：
https://<your-worker-domain>/github/iOfficeAI/OfficeCLI— 默认 READMEhttps://<your-worker-domain>/github/iOfficeAI/OfficeCLI/README_zh.md— 指定文件https://<your-worker-domain>/github/iOfficeAI/OfficeCLI/npm/package.json— 嵌套文件https://<your-worker-domain>/github/iOfficeAI/OfficeCLI/npm— 目录列表
/github/ 路由只读公共仓库的 README， 不需要任何数据读取权限。
GitHub 的限流额度绑定的是 token 代表的用户身份（authenticated = 5000次/h），与 token 本身配置了哪些权限无关。
所以申请 token 时权限保持空即可，这样即使 token 泄露也读不到任何私有数据，同时仍享受 5000次/h 配额。
步骤：
- 打开 https://github.com/settings/personal-access-tokens/new（Fine-grained token，推荐）
- 填写 Token name（如
x-page-worker），设置过期时间 - Account Permissions / Repository Permissions 全部留空，不要勾选任何一项
- 生成 token，复制保存
- 写入 Worker Secret：
npx wrangler secret put GITHUB_TOKEN
# 交互式粘贴 token（或 echo "gp_xxx" | npx wrangler secret put GITHUB_TOKEN）不要直接把 token 明文写进
wrangler.toml的[vars]——那会随代码入库。Secret 加密存于 Cloudflare，运行时仍通过env.GITHUB_TOKEN读取。
提示：URL 里有
?、#、空格、中文等特殊字符时，需要先
URL编码。可使用 URL Decoder/Encoder 在线工具进行编/解码。
- Node.js + Wrangler CLI
- Cloudflare 账号与 API Token
| 变量 | 默认值 | 说明 |
|---|---|---|
TIMEZONE |
Asia/Shanghai |
时区，用于推文时间显示 |
TRANSLATE_TO |
zh-cn |
推文翻译目标语言（BCP-47），留空则返回原文 |
UA |
iOS 微信内置浏览器 UA | /html/ 路由抓取时的 User-Agent，用于绕过微信公众号白名单限制 |
GITHUB_TOKEN |
（空） | 可选，GitHub Personal Access Token（权限留空即可，详见上方说明）。以 Worker Secret 形式存储（wrangler secret put），不写入本文件。提升 /github/ 路由的 API 限流配额（60次/h → 5000次/h） |
# 1. 拉取并压缩 CSS
curl -fsSL https://cdn.jsdelivr.net/npm/water.css@2/out/water.min.css -o water.css
npx esbuild *.css --minify --legal-comments=none --drop:console --drop:debugger --outdir=. --allow-overwrite
# 2. 拉取 artplayer.js 并包装为 ES module
curl -fsSL https://cdn.jsdelivr.net/npm/artplayer/dist/artplayer.js -o artplayer.js
node -e '
const fs = require("fs");
const src = fs.readFileSync("artplayer.js", "utf8");
fs.writeFileSync("artplayer.mjs", "export default " + JSON.stringify(src) + ";\n");
'
# 3. 本地开发
npx wrangler dev为什么不直接用
esbuild artplayer.js --minify？ 因为压缩后的源码里包含反引号`和占位符${，直接内联进模板字面量会被 JS 引擎错误解析。 先把整段源码JSON.stringify成一个字符串字面量再作为 ESM 默认导出导入，即可安全地作为字符串值内联。
推送以下文件的变更至 main 分支时，GitHub Actions 会自动拉取依赖、包装资产、压缩 CSS 并部署：
worker.jsroutes/lib/twitter.csswrangler.toml.github/workflows/deploy.yaml
也可手动在 Actions 页面触发 workflow_dispatch。