数据更新教程(写给想自己动手的你)

全站内容都是 Markdown 文本文件——更新数据 = 改文件 + 推送到 GitHub,不需要碰任何代码逻辑。本页覆盖五个最常见的更新场景,照抄即可。

准备:一次性的环境

安装 Node.js 20+ 与 VS Code
克隆仓库(只需一次):

bash

git clone https://github.com/LVSUGARS/tiexiaowei-site
cd tiexiaowei-site
pnpm install

日常开工:pnpm dev → 浏览器打开 http://localhost:5173 —— 改文件会实时热更新,所见即所得

五个最常见的更新场景

场景一:新增一场活动

复制 docs/activity/sample-shooting-task.md,改名为新活动(英文/拼音,如 2026-sports-meeting.md),填好 frontmatter 与正文
不需要手工维护时间轴或列表:构建时会扫描 docs/activity/*.md 的 frontmatter,时间轴与"历史上的今天"自动生效
单篇活动不登记到侧栏;时间轴顶部的年份索引也由活动数据自动生成,不需要改 config.mts

场景二:收录一篇公众号文章

打开 data/article-catalog.template.csv,追加一行(标题 / 日期 / 原文链接 / 平台 / 分类 / 作者 / 状态 / calendar_key),保存为 UTF-8 编码。普通文章的 calendar_key 留空;只有确实对应节日或节气的文章才填写稳定键。完整字段说明见收录规范。

场景三:新增一个资料条目

参照条目示例,在 docs/resources/ 下新建 md 文件,照模板填 frontmatter
图片与文件放同目录,网盘链接写进正文;注意权限分级——仅成员级的资料不写真实链接

场景四:改"数据型"内容(只改数据文件,不碰页面)

想改什么	改哪个文件
维护者名单	`data/maintainers.js`
招新横幅(开关与文案)	`data/siteBanner.js`
首页"精选内容"卡片	`data/homeNav.js`
系统入口链接(成员端/报名)	`appLinks.ts`

场景五:更新部门年册 / 职能页

直接编辑 docs/department/2026.md(负责人、变更记录)或对应职能页。历史年册只增不改。

改完之后:三步提交

bash

pnpm audit                                # 自检:死链 + 目录表格式
pnpm build                                # 确认构建通过
git add -A && git commit -m "更新:xxx" && git push

push 后内容即同步到 GitHub 仓库;部署平台接好后,push 即上线。

搞砸了怎么办

只想撤销某个文件的改动:git checkout -- 文件路径
已经 commit 还没 push:git reset --soft HEAD~1
大问题不用慌:GitHub 上有完整提交历史,任何版本都能恢复;实在不行把报错丢给 AI 助手(协作约定见 AGENTS.md)

页面历史

最后编辑于 6 天前

查看完整历史

数据更新教程(写给想自己动手的你) ​

准备:一次性的环境 ​

五个最常见的更新场景 ​

场景一:新增一场活动 ​

场景二:收录一篇公众号文章 ​

场景三:新增一个资料条目 ​

场景四:改"数据型"内容(只改数据文件,不碰页面) ​

场景五:更新部门年册 / 职能页 ​

改完之后:三步提交 ​

搞砸了怎么办 ​

更多文档 ​