一个简洁优雅的 X 时间线聚合器

快速开始

本地开发

# 克隆仓库
git clone https://github.com/xwartz/x-line.git
cd x-line

# 安装依赖
pnpm install

# 构建关注者配置
pnpm run build-followers

# 启动开发服务器
pnpm dev

访问 http://localhost:3000 查看效果。

项目结构

x-line/
├── src/                    # 源代码
│   ├── components/         # React 组件
│   ├── config/             # 配置文件
│   ├── hooks/              # React Hooks
│   └── types.ts            # 类型定义
├── scripts/                # 脚本
│   ├── fetch-tweets.mjs    # 推文抓取
│   ├── build-followers.mjs # 构建关注者配置
│   └── manage-followers.mjs # 管理关注者
├── data/                   # 数据文件
│   ├── followers.txt       # 关注者列表（文本）
│   ├── followers.json      # 关注者列表（JSON，自动生成）
│   └── tweets.json         # 推文数据
├── .github/workflows/      # GitHub Actions
└── docs/                   # 文档

技术栈

• 构建工具: Vite
• 框架: React
• 语言: TypeScript
• 样式: Tailwind CSS
• 数据源: Nitter
• 自动化: GitHub Actions

脚本命令

# 开发
pnpm dev              # 启动开发服务器

# 构建
pnpm build            # 构建生产版本

# 数据管理
pnpm run build-followers      # 构建关注者配置
pnpm run validate-followers   # 验证关注者配置
pnpm run manage-followers     # 管理关注者（add/remove）
pnpm run fetch-tweets         # 抓取推文

自动化工作流

• CI: 在推送和 PR 时执行 lint/build。
• 依赖更新: 每周自动更新依赖并创建 PR。
• 自动合并: 当 CI 通过后自动合并符合条件的 PR（依赖更新标签或指定机器人账号）。

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License

致谢

• Nitter - 提供推文数据源
• x-gpt.bwequation.com - 功能灵感来源

---

Made with ❤️ by xwartz