Anon Tweet

不用登录就能浏览 Twitter/X 推文和 Instagram 帖子，支持 AI 翻译与卡片导出。

线上实例：https://anon-tweet.chilfish.top

功能

推文

• 单条推文、评论线程、引用推文
• List 时间线、关键词搜索（支持 from:、since: 等 X 高级语法）

Instagram

• Post / Reel / Story
• 图片与视频直链下载

AI 翻译

• Google Gemini、DeepSeek、OpenRouter（Vercel AI SDK）
• 双语对照，可在双语 / 原文 / 仅译文之间切换
• 逐条手动编辑，手动结果与 AI 结果并存，互不覆盖
• 送模型前用占位符保护 URL、@、话题标签，避免被改写

导出

• 卡片截图（PNG / JPEG）
• Markdown、纯文本复制
• 媒体下载

其他

• 三层缓存：内存 LRU → 本地文件 → PostgreSQL（可选）
• PWA：可安装到桌面，支持从系统分享菜单直接发到本站
• 机器可读接口：/openapi.json、/llms.txt

技术栈

• 框架：React Router v8（SSR + CSR）
• 运行时：Bun 1.4、TypeScript、Cloudflare Workers（workerd）
• 数据源：Twitter/X 接口（内置 rettiwt-api 逆向适配）、Instagram（@chilfish/gallery-dl-instagram）
• AI：Vercel AI SDK（Gemini / DeepSeek / OpenRouter）
• UI：Tailwind CSS v4、shadcn/ui、coss、Lucide
• 状态：Zustand（客户端）、SWR（服务端数据）
• 持久化：Drizzle ORM + PostgreSQL（Neon），可选
• 测试：Vitest（unit / integration / acceptance 三层）、Storybook

快速开始

环境要求：Bun 1.4 以上（仓库的 packageManager 为 bun@1.4.2）。

git clone https://github.com/Chilfish/anonTweet.git
cd anonTweet
bun install

配置

把 .dev.vars.example 复制成 .dev.vars，按需修改。这是本地唯一的环境文件，wrangler / react-router dev / 构建与部署脚本都读它。

cp .dev.vars.example .dev.vars

ENVIRONMENT=development
HOSTNAME=http://localhost:9080     # 截图回调用的绝对地址；线上留空时回退到请求 origin

TWEET_KEYS=        # 不填也能用，但会被上游限流；多个 Key 用逗号分隔
INS_COOKIES=       # Instagram cookies；不填时 /api/ig/get 返回空数组

ENABLE_AI_TRANSLATION=true
GEMINI_API_KEY=
GEMINI_MODEL=models/gemini-3-flash-preview
# DEEPSEEK_API_KEY=

ENABLE_LOCAL_CACHE=true   # Workers 运行时自动回退内存 LRU
ENABLE_DB_CACHE=false
# DB_URL=postgres://...

ENABLE_TIMELINE=false      # 用户时间线接口，默认关闭（固定 429 防滥用）

Workers 线上用 wrangler 的 vars / secrets，不读 .dev.vars；旧的 .env 不再使用。

TWEET_KEYS 怎么获取

内置的 rettiwt-api 走 Twitter 用户凭证抓取，配置多个 Key 可以轮换，降低被限流的概率。

1. 安装浏览器扩展：Chrome 用 X Auth Helper，Firefox 用 Rettiwt Auth Helper
2. 建议在无痕窗口里登录 X 账号
3. 打开扩展，点 Get Key，复制生成的字符串
4. 填入 .dev.vars 的 TWEET_KEYS，多个用逗号分隔

这个字符串是账号 Cookies 的 Base64 编码，权限等同于账号密码，不要外传。获取后不要手动点登出，直接关掉浏览器窗口，否则服务端会话会失效。

其余变量的含义见 docs/features/deploy/deployment.md。

数据库（可选）

只有配置了 DB_URL 且 ENABLE_DB_CACHE=true 时才需要初始化。

bun run db:push       # 推送 schema，适合原型阶段
bun run db:generate   # 或生成迁移文件
bun run db:migrate

启动

bun run dev

默认运行在 http://localhost:9080。

部署

Cloudflare Workers

bun run deploy -- --no-deploy   # 只构建并校验
bun run deploy                  # 构建 + wrangler deploy
bun run preview                 # build + vite preview（workerd）

首次部署前用 bunx wrangler secret put 设置 TWEET_KEYS、INS_COOKIES、DB_URL、GEMINI_API_KEY、DEEPSEEK_API_KEY；非敏感开关在 wrangler.jsonc 的 vars 里。Workers 需要 Paid 套餐（免费版 CPU 10ms 不够 SSR），并且 ENABLE_LOCAL_CACHE 必须关闭、缓存走 DB。

CI/CD：在本地 .env 配好 CLOUDFLARE_API_TOKEN / CLOUDFLARE_ACCOUNT_ID，执行 bun run secrets:sync 写入 GitHub Actions Secrets。之后 push 到 main 的非纯文档变更会自动触发 Deploy workflow（也可在 Actions 里手动触发）。

本地开发只用 bun run dev（workerd）；bun run preview 用于验证生产构建。公开部署时还可以设 ENABLE_AI_BASE_URL_WHITELIST=true，配合 ALLOWED_AI_BASE_URL_HOSTS 限制 AI 请求的 baseUrl 目标。完整部署与排障见 docs/features/deploy/deployment.md。

接口

BFF 接口都在 /api 下，覆盖 tweet / ig / user / ai / proxy 几组，完整 schema 见线上的 /openapi.json；/llms.txt 是给 AI 爬虫和 agent 看的站点索引。

仓库同时维护了一个 agent skill（.agents/skills/anon-tweet/），可以用 npx skills add Chilfish/anonTweet 安装，之后直接调本站接口搜索推文、读取 IG 帖子。

用于截图的纯路由是 /plain-tweet/:id 和 /plain-ins/:id。

常用命令

bun run dev                              # 开发服务器（workerd）
bun run build                            # 生产构建
bun run preview                          # workerd 预览生产构建
bun run deploy                           # 构建并部署到 Cloudflare Workers
bun run typecheck                        # 类型检查（typegen + tsc）
bun run lint                             # ESLint（含自动修复）
bun run test                             # 单元 + 验收测试
bun run test:integration                 # 集成测试
bun run verify/index.ts --exit-on-fail   # 离线验证套件，CI 模式
bun run storybook                        # 组件用例，http://localhost:6006

项目结构

app/
├── components/   # UI 组件（tweet / ins / ui）
├── lib/          # 缓存、翻译、数据访问层、逆向 API 客户端
├── routes/       # 页面路由与 api/* BFF 路由
└── stores/       # Zustand stores
verify/           # 验收标准（AC）与验证套件
test/             # Vitest 三层测试
docs/             # 文档入口，见 docs/INDEX.md

贡献

见 CONTRIBUTING.md。提交前请确保 bun run typecheck && bun run lint && bun run test 全部通过。

License

MIT