元火内容管理工具

元火动漫社官网的数据导入脚本与清单，独立公开仓库（方便社团后人参考导入流程）。

🏷️ 本仓库通过 Git submodule 挂在主仓库的 tools/ 目录下。
蜘蛛工具也通过 submodule 挂在本仓库的 spider/ 目录下 → PKUOriginalFire/wechat-spider

使用方式

配置

cp config.example.json config.json   # 编辑填入地址与凭据

Spider GUI（推荐，图形化爬文+导入）

cd spider
npm install
npm run dev

左侧菜单「文章导入」→ 选目标服务器 → 检测 → 导入。

CLI 脚本（批量操作，流程化）

任务	命令
刷新本地 API Token	node _get-local-token.mjs --update-config
导入原火文章 (output1,30篇)	node _seed-yuanhuo.mjs --target local|server [--dry]
导入原火文章 (output2,60篇)	node _seed-yuanhuo.mjs --target local|server --manifest ./_yuanhuo2-manifest.mjs
导入商品	node _seed-products.mjs --target local|server [--dry]
关联文章系列链接	node _link-related.mjs --target local|server [--dry]
导入执委	node _seed-executives.mjs --target local|server
导入活动	node _seed-events.mjs --target local|server
导入晚会	SEED_TOKEN=<token> node _seed-gala.mjs --target local|server
导入群聊	node _update-groups.mjs
增量导入新闻	node cli.mjs update --target local|server [--from-year 2025]
修复 gala 节目图片	node _gala-fix-images.mjs [--dry]
诊断 gala 数据	node _gala-diag.mjs

⚠️ --target server 需要 config.json 里填写生产服务器的 API Token。
Token 刷新方法：_get-local-token.mjs --update-config（一次 admin login，防 Strapi 429 限流）。

文件清单

类别	文件	说明
导入脚本	_seed-*.mjs	各类内容的幂等导入（文章/商品/活动/执委/晚会/群聊）
	cli.mjs / importer.mjs	新闻增量导入
	_link-related.mjs / _link-covers.mjs	文章关系/封面链接
晚会工具	_seed-gala.mjs / _gala-fix-images.mjs / _gala-diag.mjs / _gala-list-files.mjs	晚会数据管理
清单	_yuanhuo-manifest.mjs / _yuanhuo2-manifest.mjs	原火文章清单（slug/标题/栏目/日期）
生成器	_gen-*-manifest.mjs	从目录自动生成清单
工具	strapi-client.mjs / _get-local-token.mjs / _validate-relations.mjs	Token 管理 / 关系校验
蜘蛛(子仓库)	spider/	微信文章爬虫 → PKUOriginalFire/wechat-spider

凭据安全

config.json 和 spider/config.json 不会上传 Git（.gitignore 已屏蔽）。
参照 config.example.json 和 spider/config.example.json 模板填入凭据。