Twitter Web Exporter 使用教程

1. 项目的目录结构及介绍

twitter-web-exporter/
├── src/
│   ├── content.ts
│   ├── export.ts
│   ├── main.ts
│   ├── options.ts
│   ├── utils.ts
│   └── index.ts
├── dist/
│   ├── content.js
│   ├── export.js
│   ├── main.js
│   ├── options.js
│   ├── utils.js
│   └── index.js
├── config/
│   ├── default.json
│   └── custom.json
├── package.json
├── tsconfig.json
└── README.md

• src/: 源代码目录，包含所有TypeScript文件。
  • content.ts: 处理页面内容。
  • export.ts: 导出功能。
  • main.ts: 主入口文件。
  • options.ts: 配置选项。
  • utils.ts: 工具函数。
  • index.ts: 入口文件。
• dist/: 编译后的JavaScript文件目录。
• config/: 配置文件目录。
  • default.json: 默认配置文件。
  • custom.json: 自定义配置文件。
• package.json: 项目依赖和脚本配置。
• tsconfig.json: TypeScript编译配置。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件是 src/index.ts，它作为整个项目的入口点，负责初始化项目并加载其他模块。

// src/index.ts
import { init } from './main';

init();

init 函数定义在 src/main.ts 中，负责初始化配置和启动导出功能。

// src/main.ts
import { loadConfig } from './utils';
import { startExport } from './export';

export function init() {
  const config = loadConfig();
  startExport(config);
}

3. 项目的配置文件介绍

项目的配置文件位于 config/ 目录下，包含 default.json 和 custom.json。

• default.json: 默认配置文件，包含项目的默认设置。

{
  "exportFormat": "JSON",
  "maxTweets": 3200,
  "includeMedia": true
}

• custom.json: 自定义配置文件，用户可以根据需要修改配置。

{
  "exportFormat": "CSV",
  "maxTweets": 1000,
  "includeMedia": false
}

配置文件通过 src/utils.ts 中的 loadConfig 函数加载。

// src/utils.ts
import * as fs from 'fs';
import * as path from 'path';

export function loadConfig() {
  const defaultConfigPath = path.join(__dirname, '../config/default.json');
  const customConfigPath = path.join(__dirname, '../config/custom.json');
  
  const defaultConfig = JSON.parse(fs.readFileSync(defaultConfigPath, 'utf-8'));
  const customConfig = JSON.parse(fs.readFileSync(customConfigPath, 'utf-8'));

  return { ...defaultConfig, ...customConfig };
}

通过以上配置文件，用户可以自定义导出格式、最大推文数量和是否包含媒体文件等设置。