本文复刻整理自 东南大学 · 境外参会办理清单（原始页面含内嵌 PDF 与时间限制图，建议对照阅读）。本页为个人整理的办事参考，最终以学校最新通知与办理部门答复为准。

先记住这条顺序

1
2

确认资助 → 拿邀请函、定日期 → 研究生院资助审批 → 国际合作处出国境审批
→ 签证与行前准备 → 参会 → 领两份原件 → 线上总结 → 研究生院签章 → 财务报销

本页主线适用于申请研究生院资助的参会研究生。其他经费来源仍须办理因公出国境审批，资助与报销环节按相应项目要求执行。

⚠️ 务必在会前完成审批，提交申请后还要主动跟进到审批通过。

两种情况要分清：

三个系统，分别申请

三套系统独立运行，学生须分别发起申请；一套系统审批通过不会代替另外两套。未出境仅报签证费的情况，按下方专门流程办理。

PHASE 01 / 出发前 · 会前完成资助与出访审批

01 收到录用通知后 · 申请研究生院资助者

确认自己能申请什么资助

身份要求： 东大全日制研究生，申请时处于中国境内学习阶段；通知要求政治素质好、成绩优秀、科研能力强。

论文要求：

• 论文已被境外本学科有重要影响的会议录用；
• 你是第一作者，或你是第二作者且第一作者为导师；
• 第一署名单位、通讯作者单位均须为东南大学。

会议认定： 在资助系统查会议是否属于本学科顶会。顶会的 workshop 按非顶会处理。

评审流程： 经导师、院系审核后，由研究生院择优资助。

资助金额与可报费用

顶会可资助往返国际机票经济舱、注册费、住宿费；住宿执行学校财务出国标准。在上限内据实报销，超出部分受上限限制。

• 原研究生院通知列明非顶会仅资助注册费；本次补充的签证费报销规则见下述说明。
• 顶会与非顶会均不限参会人数、次数；顶会目录按各一级学科认定（原则上每学科不超过 5 个）。
• 具体资助类别以审核为准。

签证费： 按补充办理口径可报销，含拒签产生的签证费；提交签证付费凭证及对应网页截图，报销总额不得超过获批资助上限。签证费计入原资助额度。

📎 依据：研究生院通知

• 已核对作者、单位、会议类别与经费来源

02 提交任何申请前

拿到正式邀请函，核对出入境日期

• 向会议主办方索取邀请函，必须写明你的姓名、邀请起止日期。另备录用通知；录用邮件不能代替邀请函。
• 通常最多在邀请日期前、后各加 1 天；赴日本按邀请函的滞在日程表填报。
• 境外参加一个国际会议不能超过 7 天（基本要求的配图及细则 PDF 均有标注）。有特殊或组合行程，填报前向国际合作处确认。
• 系统填的是离开中国、进入中国的日期。核对返程跨时区和航班到达时间。

例如： 批件为 10 月 1—7 日，就应 10 月 1 日出中国境、10 月 7 日入中国境，共 7 天。

其他出访类型的时间标注： 图中短期学习为 90 天以内（含 90 天），长期学习为 90 天以上；其他类型的上限未在图中写明。本清单按参会流程编排。

📎 依据：基本要求及配图 · 细则 PDF 第 1 页

• 已取得邀请函并核对中国出入境日期

03 开会之前完成 · 申请研究生院资助者

先完成研究生院的资助资格审批

入口： 综合服务大厅 → 研究生国际交流 → 境外参加国际会议（顶会 / 非顶会）

1. 按会议类别选入口，准备邀请函等附件；完整附件清单以系统要求为准。
2. 经费来源选 「研究生院资助」，提交并跟进导师、院系及研究生院审核。
3. 务必在开会日期之前完成申请并审批通过；会后无法补办。
4. 即使最终因签证被卡、被拒或其他原因未出境，报销签证费也必须满足这个节点。获得资助资格后继续办理下一步出国境批件。

📎 依据：研究生院通知。登录系统内的附件清单未在公开页面完整列出。

• 资助审批已通过（其他经费来源可标记不适用）

04 出境前 · 所有因公出国境学生

再提交国际合作处申请，主动跟进审批

入口： 信息服务门户 → 国际合作处 → 学生因公出国（境）；也可从出国境申报系统进入；入口异常时走信息门户。

1. 填写出访信息，提交邀请函和系统要求的材料，核对日期及经费项目号。
2. 提交后在个人页面「操作 → 审批进度」查看流程，提醒导师、学院领导审核，并继续跟进后续审批。
3. 研究生院资助审批、国际合作处审批、财务审批为三套独立系统，须分别申请。正常出境参会时，前两项都要办理。出发前确认流程状态，避免回国后仍未审批结束。

⚠️ 务必会前完成审批，并确保出境前学校已批准。 按补充办理口径，系统无法在会后补办。

2026 年 10 月 1 日以前已完成出访的历史未申报事项，适用专项补报通知；请勿将过渡安排用于新的出访。

📎 依据：研究生院通知 · 基本要求 · 细则 PDF 第 1—2 页

• 因公出国境申请已提交，且审批流程已办结

05 相关审批通过后

按目的地要求办理因私证照、签证和学校证明材料

• 学生持因私护照 / 证照出行，自行办理签证或签注，提前核对目的地材料要求。
• 保存签证付费凭证及对应网页截图。 签证费可以报销，含拒签；总报销金额须在资助上限内。
• 需要派遣函时，到派遣函模板页下载：通常用英文基础模板，韩国用专门的中文模板。通常只改第一段个人信息及日期，按签证要求补充内容，保留底部落款。
• 核对派遣函与签证申请的出入境日期一致，用白色 A4 纸打印，带到四牌楼老图书馆 127 室办理签章。校方可提供专用信纸套印。
• 需要法人证书 / 组织机构代码证明及翻译件时，带领馆材料清单一并申请；只领取签证实际需要的材料。
• 领取签证材料的审批节点： 基本要求写「审批通过后」；PDF 和模板页明确写「学院审批同意后」。如学院已通过、后续仍在流转，先拨 025-83793215 确认可否领取。

📎 依据：基本要求 · 细则；操作细节补充自目录中的派遣函模板页

• 证照与签证材料已处理（未出境者转下方签证费流程）

06 订票、出发前

核对行程与费用要求，完成行前准备

• 核对机票实际出入中国境日期与审批一致；外航购票要求、签证类别或日期变动，提前问国际合作处。顶会资助机票为经济舱，住宿按财务出国标准。
• 阅读行前教育材料，也可到国际合作处四牌楼或九龙湖办公点领取提醒小册子。
• 赴美者另读目录内的赴美注意事项，按自身签证与行程核对最新官方要求。

整理建议： 建一个材料文件夹，收齐邀请函、录用通知、审批记录、行程及票据；提前向财务处核对所需票据，途中持续保存。

📎 依据：研究生院通知 · 申报目录 · 细则 PDF 第 2 页。文件夹为本页整理建议。

• 行程、费用要求与行前材料已核对

SPECIAL CASE / 最终未出境 · 只可报销签证费

判断条件：人是否实际出境。 因任何原因最终未出境均适用，包括签证被卡、签证被拒、行程取消及其他原因。

具体表单、系统入口及额外附件，请向研究生院和财务处核对。

⚠️ 下方 07—12 步是正常出境后的流程，未出境者按本框办理，勿直接套用领批件及参会总结的步骤。

📎 来源：整理者补充的办理口径；已核对的公开通知未载明这组签证费与未出境报销细节。

• 已确认属于未出境情形，并按签证费流程办理

PHASE 02 / 出行期间 · 按批件往返

07 从出境到入境

按批准日期回国，保管证件与材料

• 严格执行批件日期： 批准 6 天，就应第 1 天离开中国、第 6 天进入中国。
• 妥善保管证件和贵重物品；护照丢失时及时联系中国驻当地使领馆办理临时证件，可通过「领事直通车」查询联系方式。
• 建议保存参会证明、支付记录与票据，并记下全部境外经转、停留城市，方便回国填表。

⚠️ 细则明确写明：超期者不能报销任何费用。 遇到航班变动等影响按期入境的情况，及时联系国际合作处确认处理办法，保留相关证明；本页无法保证例外获批。

📎 依据：细则 PDF 第 2—3 页。材料归集、遇变动联系为办理建议。

• 已按期回国，证件、票据与行程记录已整理

PHASE 03 / 回国后 · 先备齐，再交纸质材料

第 08—10 步可交叉准备；第 11 步提交研究生院前，须完成线上总结并备齐纸质材料。

08 回国后，因公审批流程已结束

去国际合作处领两份报销原件

地点： 四牌楼校区老图书馆 127 室。出门前核对项目号是否变更、是否有境外经转与停留城市。

1. 领取《东南大学出国、赴港澳任务批件》原件。
2. 领取《因公临时出国（境）任务和财务核算审批意见表》原件。
3. 现场填写财务意见表的**「境外经转及停留城市」栏；无经转停留时用斜线划掉，不能空着**。
4. 如项目号等信息变更，领取时告知工作人员，并在变更处加盖审批印章。

📎 依据：基本要求 · 细则 PDF 第 3 页

• 两份原件已领取，城市栏和变更信息已处理

09 交研究生院纸质材料之前 · 研究生院资助者

上传签章后的经费计划表，再提交总结

1. 综合服务大厅 → 研究生国际交流 → 原会议申请记录，下载经费使用计划表。
2. 办好导师、院系签字盖章，再上传提交。
3. 随后按系统要求上传并提交总结材料，检查提交状态，别只留在草稿。
4. 研究生院收到纸质报销材料后，会对系统中的总结材料审核。

📎 依据：研究生院通知

• 签章计划表已上传，总结材料已正式提交

10 交研究生院纸质材料之前 · 研究生院资助者

在财务系统填写因公出国报销单

在财务处入口进入相应财务系统，选择**「因公出国」**板块填写。

项目号可能调整，报销时再核对；通知说明可在报销时修改，不影响此前办理批件。报销单、发票与票据问题向财务处确认。

📎 依据：研究生院通知

• 报销单已填写，项目号已核对

11 完成第 08—10 步后 · 研究生院资助者

把纸质材料交研究生院审核、签字盖章

交给研究生院培养办王悦老师：

• 财务报销单
• 经费使用计划表
• 上述两份出国境原件

收件时间： 每周一、二、四上午。四牌楼办公地点为逸夫建筑馆 205；周四在九龙湖集中处理业务，前往前可电话确认具体地点。

研究生院审核后统一请负责人签章，通常无法当场办好；签章完成后取回。

九龙湖可用材料快递站：

• 地点：纪忠楼 102 大厅沙发旁。按桌面说明自助交件，扫码登记并保存查询二维码；自行查询到「办结且可取」后领取。
• 转送及取回时间不固定；该站提供收取转送服务，其他老师无法代为审核或答疑。
• 材料取回后，由本人继续交财务处。

📎 依据：研究生院通知

• 研究生院审核签章完成，纸质材料已取回

12 研究生院签章完成后

把完整材料交财务处，完成报销

带上签章后的材料、相关票据及财务处要求的其他材料（报销签证费须附付费凭证与对应网页截图），由本人在财务系统单独申请并按要求提交财务处；含签证费的报销总额不得超过资助上限。根据审核反馈补充材料并跟进报销结果。

⚠️ 公开页面没有列全财务票据清单、系统附件要求，也没有给出统一「提前多少天」或回国后报销截止日。请以办理系统、财务处当前要求为准，提前留出审批和签证时间。

📎 依据：研究生院通知 · 细则 PDF 第 3 页

• 财务审核与报销已完成

历史出访补报 · 按专项通知处理

适用条件： 2026 年 10 月 1 日以前已完成出访，且未在新旧系统申报。

新通知允许上述历史事项按下列顺序补办。范围限定为已完成因公出国（境）、且未通过新旧系统办理申报的学生；已申报但未审批办结的情况，须向国际合作处确认处理方式。

1. 本人撰写书面情况说明，如实说明未及时申报原因，并书面承诺今后遵守外事纪律、依规出访。
2. 由所在学院党委副书记签字，并加盖学院公章。
3. 交项目主管部门或经费支持导师所在部门签字盖章；研究生院资助的项目交研究生院办理。
4. 交国际合作处审核签章，办理报销所需文件。
5. 携全套说明文件和报销材料，前往财务处办理报销。

⚠️ 10 月 1 日的含义须分清： 通知按出访事项划分过渡范围，原文未规定「10 月 1 日后不得提交历史补报材料」。补充了「10 月 1 日后无法提交」的执行口径，是否另有受理截止日须向国际合作处确认；如需补报，建议尽快办理。10 月 1 日当日出访也应事前获批，勿依赖过渡安排。

通知对 2026 年 10 月 1 日以后出访要求在出访前完成线上申报审批，未履行事前申报手续的出访费用不予报销。

历史补报安排不豁免研究生院资助资格须在会前获批的要求。

📎 依据：关于进一步加强学生因公出国（境）管理的通知（校国际〔2026〕6 号，2026-09-02 发布）；研究生院会前资助审批限制来自资助通知及补充口径。

• 已确认适用补报范围并按顺序办理

找谁办理

资助 · 总结 · 研究生院签章

研究生院培养办 · 王悦老师

• 电话：025-83795359
• 邮箱：101010799@seu.edu.cn
• 地址：四牌楼逸夫建筑馆 205（周四在九龙湖集中处理业务）
• 报销材料收件：周一、二、四上午

出国境审批 · 签证材料 · 批件

国际合作处

• 电话：025-83793215
• 材料办理：四牌楼老图书馆 127 室
• 日期不符、外航要求、签证类别、经转城市与项目号变更，咨询此处。

财务

报销单、发票、完整票据清单与财务标准：东南大学财务处

原文与版本

本清单依据以下五个公开页面、细则及新增通知的内嵌 PDF，并结合补充办理口径整理。核对日期：2026 年 9 月 16 日。

新增内容包括：签证费、未出境限制、三套独立系统及历史出访补报。阅读顺序经过重排，条件和例外保留在对应步骤中。主流程聚焦境外参会；派遣函页作为操作补充，赴美等专项要求保留入口。

补充口径来源： 整理者提供的签证费（含拒签）报销、付款凭证与网页截图、未出境仅报签证费、未出境无需国际合作处审批、三套系统独立申请及系统会后无法补办等办理要求。公开文件与补充口径不一致的部分已在对应位置列明。

⚠️ 免责声明： 网址中的年份与页面显示日期不同，版本按页面内容核对。学校更新要求后，以最新通知和办理部门答复为准。本页为办事整理，勾选状态不代表校方审批结果。

相关阅读

• Hexo 博客工程化实战：从手动部署到自动化内容工厂 — 把这种长清单做成可维护的博客页面

⚠️ 说明：本文为资料备份与信息收集性质，整理自公开资料与他人笔记（原始出处：mikeah2011 · VPN & 机场笔记）。机场信息时效性极强，跑路风险高，永远不要年付——月付或「不限时小包」最安全。

本文不含任何推广导流链接（原文的邀请码已移除），仅保留判断标准与选购方法论。

永远先看这条

• 不要年付。 月付或不限时小包最安全，机场跑路时损失最小。
• 不要只买一家。 组合推荐：一个月付 + 一个不限时套餐 = 最稳方案。
• 优先选择运营 1 年以上、有工单/Telegram 群、支持 24 小时退款的机场。

一、主流代理协议对比

选择协议是科学上网的第一步。以下是目前最主流的四种协议在加密方式、抗封锁能力、性能、跨平台支持四个维度的对比：

协议趋势

• VLESS + Reality 正在取代 VMess，成为新标准（无自签证书、抗探测强）
• AnyTLS 协议开始出现，部分机场陆续支持
• AI 用途（ChatGPT / Claude）推动了高端专线需求——对 IP 质量要求高

订阅中的符号说明

二、客户端选型

三、macOS 代理配置

方案一：Clash Verge Rev（推荐）

1
2
3
4
5
6

推荐配置：
  - 端口：7890（HTTP）/ 7891（SOCKS5）/ 7892（Mixed）
  - 模式：Rule（规则分流）
  - TUN 模式：开启（可代理终端、Git 等命令行工具）
  - DNS：fake-ip 模式 + 阿里 DoH
  - 规则集：ACL4SSR（国内直连，国外代理）

终端代理配置（配合 TUN 模式或手动设置）：

1
2
3
4
5
6
7
8

# 在 ~/.zshrc 中添加
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7891

# Git 代理配置
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

系统级代理设置：

1
2
3
4
5
6
7
8
9

# 命令行设置 HTTP 代理
networksetup -setwebproxy "Wi-Fi" 127.0.0.1 7890
networksetup -setsecurewebproxy "Wi-Fi" 127.0.0.1 7890
networksetup -setsocksfirewallproxy "Wi-Fi" 127.0.0.1 7891

# 关闭代理
networksetup -setwebproxystate "Wi-Fi" off
networksetup -setsecurewebproxystate "Wi-Fi" off
networksetup -setsocksfirewallproxystate "Wi-Fi" off

💡 如果你使用 Clash Verge Rev 并开了系统代理，以上命令会自动设置，只有排查问题时才需要手动调整。

方案二：Surge（进阶）

Surge 是 macOS/iOS 上功能最强大的网络调试与代理工具，价格较高（$49.99 起），但功能远超 Clash：

• 原生支持 HTTP 抓包和请求重写
• 支持增强模式（Enhanced Mode）代理所有应用
• 低内存占用，稳定性极佳
• 支持 iCloud 同步配置

方案三：Proxifier（仅代理特定应用）

如果你只想让特定应用走代理（如只让浏览器翻墙、其他直连），Proxifier 是最佳选择，支持按进程名、按 IP 段设置不同规则。

方案对比

四、机场选购方法论

4.1 直连 vs 中转 vs 专线

4.2 机场评分维度

选择机场时，建议从以下维度综合评估：

1. 节点覆盖：支持多少个国家/地区？是否有常用节点（日本、新加坡、美国、香港）
2. 协议支持：是否支持 Trojan / VLESS 等新协议？（老旧 SS 可能被封）
3. 流媒体解锁：是否支持 Netflix、Disney+、ChatGPT 等？
4. 倍率说明：部分节点倍率 > 1，实际消耗流量更多，需注意
5. 在线客服：是否有工单系统或 Telegram 群组？
6. 退款政策：是否支持不满意退款？（至少支持 24 小时内退款）
7. 历史口碑：查看是否有跑路风险，选择运营 1 年以上的老机场

4.3 按预算的选购思路

这里不列具体机场清单（时效性太差），只给判断标准：

4.4 避坑清单

• ❌ 年付：跑路事件频发，损失最大的就是年付用户
• ❌ 只看价格：¥1 月付往往意味着超售，晚高峰根本跑不动
• ❌ 只买一家：单点故障时你会完全没有备用方案
• ❌ 忽略倍率：倍率标注混乱，实际消耗可能远超套餐名义流量
• ✅ 先试用：优先选提供 1-2GB 试用流量或 1 天试用的机场

五、故障排查踩坑记录

案例 1：Clash Verge Rev 与 Surge 同时运行冲突

同时运行两个客户端会导致代理端口冲突（默认都是 7890），表现为浏览器无法上网。解决方法：修改其中一个客户端的端口号，或只保留一个运行。

案例 2：公司 / 学校网络封锁代理

部分公司/学校网络会通过 DPI 深度包检测封锁代理流量。表现：机场节点全部超时，但手机 4G 正常。解决方法：选择 Trojan 协议节点，或使用 VLESS + Reality 节点（伪装为正常 HTTPS 流量）。

案例 3：路由器代理后局域网设备无法直连

在路由器层面配置代理后，局域网内的 AirDrop、打印机、智能家居设备可能无法被发现。解决方法：在路由器的代理规则中添加局域网 IP 段 192.168.0.0/16、10.0.0.0/8 为直连规则。

案例 4：Git 推送失败但浏览器正常

浏览器走了系统代理，但 Git 默认不读系统代理。解决方法：给 Git 单独配置代理（见上文 macOS 代理配置），或在代理客户端里开启 TUN 模式，让所有流量（含终端）都被接管。

案例 5：订阅更新后节点全红

多为订阅链接失效或机场更换域名。解决方法：到机场官网（而非邮件里的旧链接）重新复制订阅地址；若官网也打不开，说明机场可能已跑路。

六、自建订阅转换（可选）

机场给的订阅格式五花八门，Clash / Sing-box / Surge 各要各的格式。常见做法是自建一个 subconverter：

1
2
3
4
5
6
7

# 使用 Docker 部署
docker run -d --restart=always \
  -p 25500:25500 \
  --name subconverter \
  tindy2013/subconverter:latest

# 访问 http://localhost:25500/sub?target=clash&url=<URL_ENCODED_SUB_URL>

⚠️ 订阅转换服务会经手你的订阅链接，不要用公共的在线转换站，尽量自建。

七、备份与归档建议

作为一份「资料备份」，建议按下面的方式维护：

1. 订阅链接存本地：存进密码管理器（如 Bitwarden），不要只存在浏览器书签里
2. 每季度复核一次：机场域名、价格、状态都可能变化，过期信息及时标注或删除
3. 保留方法论，弱化清单：具体的机场名随时会失效，判断标准（协议、类型、避坑项）才是长期有价值的部分
4. 记录自己的踩坑：把每次翻车的原因写下来，比记十个机场名有用

相关阅读

• Hexo 博客工程化实战：从手动部署到自动化内容工厂 — 把这类资料笔记做成自动化流水线

📌 免责声明：本文仅供技术学习与资料备份之用，内容整理自公开网络资料。请遵守当地法律法规，自行判断与承担使用风险。文中不含任何推广链接与邀请码，所引用的第三方服务与本站无关。

本文整理自 Michael’s Blog · Hexo 博客工程化实战，并结合本站（Butterfly 主题 + hexo-deployer-git）的实际情况做了适配与补充。

为什么要把博客「工程化」？

写博客这件事，技术人通常的路径是：

1. 本地 hexo new 创建文章
2. Markdown 写内容
3. hexo g && hexo d 手动部署

这条路径在只有几十篇文章时完全够用。但当文章数量突破 400+、你希望保持周更甚至日更节奏时，手动流程就会暴露出几个致命问题：

• 部署依赖本地环境：换台电脑就写不了
• 选题靠灵感驱动：没灵感就断更
• SEO 全靠感觉：标题写得好不好、结构化数据有没有、sitemap 对不对，全凭手感
• 写完就忘：哪篇文章阅读量高、哪些关键词带来流量，完全没有数据反馈

这篇文章记录的是把 Hexo 博客从「手动写作」改造成「自动化内容工厂」的完整过程，涉及四个核心模块：

1. 自动部署：push 即发布
2. AI 辅助选题与写作：选题池 + 多 Worker 并行生产
3. SEO 工程化：结构化数据、自动 sitemap、内链策略
4. 阅读量分析：数据采集 → 看板 → 反哺选题

每个模块都有可直接复用的配置和代码。

一、从 hexo deploy 到 push 即发布

1.1 两条部署路线

Hexo 的部署本质上就是把 public/ 这个目录「搬」到托管平台。常见两条路线：

本站用的是第一条：_config.yml 中配置 hexo-deployer-git，一条命令完成生成和部署。

1
2
3
4
5

# _config.yml
deploy:
  type: git
  repo: https://github.com/<user>/<user>.github.io.git
  branch: main

1
2

# 构建并部署（--generate 表示先 hexo g 再推送）
hexo deploy --generate

注意：hexo-deployer-git 使用 .deploy_git/ 作为中转仓库，它会把 public/ 里的内容强制推送过去，所以 Pages 仓库里不需要（也不应该）保留源文件。

1.2 GitHub Actions 自动部署

当你希望「写完 Markdown，git push 就完事」时，把构建搬到 CI。在仓库根目录创建 .github/workflows/deploy.yml：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

name: Deploy Hexo Blog

on:
  push:
    branches:
      - main

# 防止同时触发多次部署，排队执行
concurrency:
  group: deploy-${{ github.ref }}
  cancel-in-progress: false

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 需要完整历史用于 git log 生成文章列表

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Build
        run: npx hexo generate
        env:
          NODE_ENV: production

      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}

### 1.3 进阶：多环境部署

如果你有多个目标（比如 GitHub Pages + 自建服务器），可以用 `needs` 串起来：

```yaml
  deploy-to-server:
    needs: build-and-deploy
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - name: Checkout built files
        uses: actions/checkout@v4
        with:
          ref: gh-pages
          path: public

      - name: Deploy via rsync
        uses: burnett01/rsync-deployments@7.0.1
        with:
          switches: -avzr --delete
          path: public/
          remote_path: /var/www/blog/
          remote_host: ${{ secrets.SERVER_HOST }}
          remote_user: ${{ secrets.SERVER_USER }}
          remote_key: ${{ secrets.SSH_PRIVATE_KEY }}

1.4 构建缓存优化

文章一多，构建时间就成了问题。加入缓存后构建时间可以从 90s 降到 25s：

1
2
3
4
5
6
7
8
9

- name: Cache Hexo
  uses: actions/cache@v4
  with:
    path: |
      node_modules
      .deploy_git
    key: hexo-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
    restore-keys: |
      hexo-${{ runner.os }}-

1.5 自动化预检

部署前加一道 lint 和死链检查，防止发布有问题的内容：

1
2
3
4
5
6
7
8

- name: Check broken links
  run: |
    npx hexo generate
    npx broken-link-checker http://localhost:4000 --recursive --ordered --filter-level 3 || true

- name: Validate HTML
  run: |
    npx html-validate public/**/*.html || true

二、AI 辅助选题与写作

这是整个工程化改造中投入产出比最高的部分。

2.1 选题池设计

在仓库根目录维护一个 .writing-backlog.md，格式简单到极致：

1
2
3
4
5
6

# Writing Backlog

- [ ] Laravel 事件溯源实战：Event Sourcing + EventStore 落地踩坑
- [ ] Go 并发模式：Channel、Context、errgroup 组合实战
- [ ] Redis 7.0 Function 替代 Lua 脚本：迁移指南与性能对比
- [ ] Kubernetes HPA 自定义指标：基于 Laravel 队列深度的自动扩缩容

- [ ] 表示待写，- [x] 表示已完成。Worker 领取任务时立刻用 sed 把 [ ] 改成 [x] 锁定选题，防止多个 Worker 重复写作。

2.2 AI Worker 流水线

用 cron 配置多个定时 Worker，每个 Worker 独立运行：

1
2
3
4
5
6
7
8
9
10

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Worker 1   │     │  Worker 2   │     │  Worker 3   │
│  每2小时执行 │     │  每3小时执行 │     │  每4小时执行 │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       ▼                   ▼                   ▼
┌──────────────────────────────────────────────────┐
│              .writing-backlog.md                  │
│  grep → 锁定 → 写文章 → 保存 → 更新选题池        │
└──────────────────────────────────────────────────┘

每个 Worker 的核心逻辑：

1
2
3
4
5
6
7
8
9
10

# 1. 领取选题
TOPIC=$(grep -m1 '^- \[ \]' .writing-backlog.md)

# 2. 立刻锁定（防止其他 Worker 重复领取）
FIRST30=$(echo "$TOPIC" | cut -c1-35)
sed -i '' "s/^- \[ \] ${FIRST30}/- [x] ${FIRST30}/" .writing-backlog.md

# 3. AI 生成文章（交给 AI agent 处理）
# 4. 保存到 source/_posts/<分类>/<文件名>.md
# 5. 更新选题池，追加文件路径

2.3 选题质量控制

不是所有选题都值得写。在选题池里加上质量评估维度：

1
2
3
4
5

# Writing Backlog - 格式说明
# - [ ] 选题标题 | 预估搜索量(高/中/低) | 竞争度(高/中/低) | 优先级(P0/P1/P2)

- [ ] Laravel 事件溯源实战 | 搜索量:中 | 竞争度:低 | 优先级:P0
- [ ] Go 并发模式 | 搜索量:高 | 竞争度:高 | 优先级:P1

选题原则：

• P0：搜索量中/低 + 竞争度低 = 蓝海词，优先写
• P1：搜索量高 + 竞争度高 = 需要有差异化角度
• P2：搜索量低 + 竞争度高 = 不值得写，除非是个人笔记

2.4 自动 Git 提交

Worker 写完文章后自动 commit 并 push：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

git add source/_posts/
git commit -m "post: $(date +%Y-%m-%d) 新文章标题"

---

## 三、SEO 工程化

SEO 不是「写完文章再想」的事，而应该内建到写作流程里。

### 3.1 Frontmatter 规范

每篇文章的 frontmatter 都是 SEO 的一部分：

```yaml
---
title: 主关键词在前，长尾描述在后
description: 用于 meta description，直接影响搜索结果摘要
tags: [关键词1, 关键词2, 关键词3]
categories: [唯一分类]
date: 2026-01-01 10:00:00
updated: 2026-01-02
---

要点：

• title：主关键词在前，长尾描述在后
• description：用于 <meta name="description">，直接影响搜索结果摘要
• tags：3-5 个，覆盖文章核心概念
• categories：唯一，用于面包屑导航和站点结构

3.2 结构化数据（JSON-LD）

在生成阶段往 <head> 注入 Article 类型的结构化数据：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

// scripts/structured-data.js
hexo.extend.filter.register('after_render', function(html, data) {
  if (data.layout !== 'post') return html;

  const jsonLD = {
    "@context": "https://schema.org",
    "@type": "BlogPosting",
    "headline": data.title,
    "description": data.description || data.title,
    "datePublished": data.date.toISOString(),
    "dateModified": (data.updated || data.date).toISOString(),
    "author": {
      "@type": "Person",
      "name": "Biko",
      "url": "https://biko-duckyo.github.io"
    },
    "publisher": {
      "@type": "Organization",
      "name": "Biko的个人小站"
    },
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://biko-duckyo.github.io" + data.path
    }
  };

  const script = '<script type="application/ld+json">' + JSON.stringify(jsonLD, null, 2) + '</script>';
  return html.replace('</head>', script + '\n</head>');
});

Hexo 会自动 require scripts/ 目录下的所有文件，所以把这段放进 scripts/ 即可生效，不需要改主题源码。

3.3 Sitemap 自动生成

hexo-generator-sitemap 已经够用，但需要正确配置：

1
2
3
4
5
6

# _config.yml
sitemap:
  path: sitemap.xml
  rel: true
  tags: true
  categories: true

提交到 Google Search Console 后，确认 robots.txt 包含：

1

Sitemap: https://<your-site>/sitemap.xml

3.4 内链策略

文章之间的内链是 SEO 的重要信号。可以在写作流水线里加一步「相关阅读」注入：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# scripts/inject_internal_links.py
import re
import os

def find_related_posts(current_tags, posts_dir):
    """根据 tags 相似度找到相关文章"""
    related = []
    for filename in os.listdir(posts_dir):
        if not filename.endswith('.md'):
            continue
        filepath = os.path.join(posts_dir, filename)
        with open(filepath, 'r', encoding='utf-8') as f:
            content = f.read()
            tags_match = re.search(r'tags:\s*\n((?:\s+-?\s*.+\n)*)', content)
            if tags_match:
                post_tags = set(re.findall(r'-\s+(.+)', tags_match.group(1)))
                overlap = len(current_tags & post_tags)
                if overlap >= 2:
                    title_match = re.search(r'title:\s*(.+)', content)
                    if title_match:
                        related.append((overlap, title_match.group(1).strip(), filename))
    related.sort(reverse=True)
    return related[:5]

def inject_links(content, related_posts):
    """在文章末尾注入相关阅读"""
    if not related_posts:
        return content
    links = "\n".join([
        "- [" + title + "](/" + filename.replace('.md', '') + "/)"
        for _, title, filename in related_posts
    ])
    return content + "\n\n## 相关阅读\n\n" + links + "\n"

3.5 自动化 SEO 审计

在 CI 里加一段 frontmatter 完整性检查：

1
2
3
4
5
6
7
8
9
10
11
12
13

- name: SEO Audit
  run: |
    for file in source/_posts/**/*.md; do
      if ! grep -q "description:" "$file"; then
        echo "⚠️ Missing description: $file"
      fi
      if ! grep -q "categories:" "$file"; then
        echo "⚠️ Missing categories: $file"
      fi
    done

    # 检查是否有重复的 title
    grep -r "^title:" source/_posts/ | sort | uniq -d

四、阅读量分析

写完就忘是内容创作最大的浪费。把数据采集回来，才能形成「写作 → 反馈 → 选题」的正循环。

4.1 数据采集

方案有三档，按投入从低到高：

本站当前用的是不蒜子，配置在 Butterfly 的 busuanzi 开关里，零成本但粒度粗。想要按文章、按来源分析，就得换 Umami 这类自托管方案。

4.2 看板

数据落到 SQLite / Postgres 后，用 Metabase 或 Grafana 做一个最简单的看板，关注四个指标：

• 单篇 PV/UV 排行：哪些文章真的有人看
• 流量来源：搜索 / 直链 / 社交，各占多少
• 搜索关键词：哪些词带来了流量（Search Console）
• 跳出率与停留：内容是否真的被读完

4.3 反哺选题

看板的最终目的是回写进选题池：

1
2
3
4

# Writing Backlog

- [x] Hexo 博客工程化实战 | 已完成，PV 排名 #3
- [ ] Hexo 博客工程化实战（续）：阅读量看板搭建 | 承接高 PV 文章 | 优先级:P0

经验： 一篇文章 PV 高，就写它的「续集 / 进阶 / 姊妹篇」——这是最省力的选题来源，因为需求已经被验证过了。

五、本站的落地清单

结合本站（Butterfly + GitHub Pages）现状，按投入产出比排序的改造顺序：

1. 短期：在 scripts/ 里加 JSON-LD 结构化数据；补全每篇文章的 description
2. 中期：把部署迁移到 GitHub Actions（换台电脑也能写）；接入自托管 Umami
3. 长期：建选题池 + AI Worker 流水线；每周复盘一次看板，把高 PV 主题做成系列

一句话总结：手动部署解决「能不能发」，工程化解决「能不能持续发」。 文章数过了 100 篇，后者才是真正的瓶颈。

git push origin main

1
2
3

push 触发 CI 自动部署，形成闭环：

选题 → AI 写作 → git push → CI 构建 → 部署上线

1
2
3
4

publish_dir: ./public
publish_branch: gh-pages
commit_message: "deploy: ${{ github.event.head_commit.message }}"

这里发布到 gh-pages 分支。如果站点仓库本身就是 <user>.github.io（例如本站），对应分支要改成 main。

原文链接：https://zfe.space/post/56348.html
作者：小冰博客（しゅふがく）

序言

效果展示

3.0 模拟时钟小部件主要包含：

• 日期（年、月、日、星期）
• 天气（天气图标、温度）
• 湿度（百分比）
• 空气质量（US AQI）
• 时间（当地时间、AM/PM）
• 地理位置（IP 地址地理位置）
• 每日访问上限：约 500 次
• 每月访问上限：10000 次

预览地址：https://zfe.space

调用过猛可能会导致超出访问限制而不显示。

相比 1.0 版本，加快了访问速度并优化了加载效果。
相比 2.0 版本，通过 Vue 替换 jQuery 的 DOM 操作提升了性能。
解决了 date class 会导致相关文章的时间样式出错的 BUG。

资源包地址

• 基础 3.0 版本：https://github.com/Zfour/Butterfly-clock/releases/tag/3.01
• 内测 3.1 版本：https://github.com/Zfour/Butterfly-clock/

内测 3.1 版本

3.1 内测版主要包含：

• 日期（年、月、日、星期）
• 天气（天气图标、温度）
• 时间（当地时间、AM/PM）
• 地理位置（相比 3.0 优化了 IP 信息定位不准确问题）
• IP 信息（替代了空气质量信息）
• 每日访问上限：无限次
• 相比 3.0 优化了加载动画和信息显示效果

步骤 1：申请 API Key

基础 3.0 版本

这里介绍如何申请 AirVisual API Key。

1. 打开网站注册账号：https://www.iqair.com/auth/login
2. 登录后访问：https://www.iqair.com/dashboard/api
3. 点击 “+ NEW KEY” 按钮，选择 “Community” 得到对应的 Key

内测 3.1 版本

1. 打开网站注册账号：https://openweathermap.org，验证邮箱
2. 打开 https://home.openweathermap.org/api_keys 得到对应的 Key

步骤 2：添加小部件 PUG

1. 将资源包中 pug 文件夹的 card_clock.pug 文件放入 themes/butterfly/layout/includes/widget 目录下
2. 将资源包中 pug 文件夹的 index.pug 文件放入同目录替换（适用于 Butterfly 3.3 以上版本）

若你的版本较低或存在侧边栏魔改，请打开 themes/butterfly/layout/includes/widget/index.pug，将以下代码添加至 card_author 代码块后：

1
2

if theme.aside.card_clock.enable
  !=partial('includes/widget/card_clock', {}, {cache: theme.fragment_cache})

添加后的完整示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

#aside_content.aside_content
  if theme.aside.card_author.enable
    !=partial('includes/widget/card_author', {}, {cache: theme.fragment_cache})

  if theme.aside.card_announcement.enable
    !=partial('includes/widget/card_announcement', {}, {cache: theme.fragment_cache})

  if theme.aside.card_clock.enable
    !=partial('includes/widget/card_clock', {}, {cache: theme.fragment_cache})

  .sticky_layout
    if is_post()
      if showToc
        include ./card_post_toc.pug
    if theme.aside.card_recent_post.enable
      !=partial('includes/widget/card_recent_post', {}, {cache: theme.fragment_cache})
    if theme.ad && theme.ad.aside
      !=partial('includes/widget/card_ad', {}, {cache: theme.fragment_cache})
    else
      if theme.aside.card_recent_post.enable
        !=partial('includes/widget/card_recent_post', {}, {cache: theme.fragment_cache})
      if theme.ad && theme.ad.aside
        !=partial('includes/widget/card_ad', {}, {cache: theme.fragment_cache})
    if theme.newest_comments.enable
      !=partial('includes/widget/card_newest_comment', {}, {cache: theme.fragment_cache})
    if theme.aside.card_categories.enable
      !=partial('includes/widget/card_categories', {}, {cache: theme.fragment_cache})
    if theme.aside.card_tags.enable
      !=partial('includes/widget/card_tags', {}, {cache: theme.fragment_cache})
    if theme.aside.card_archives.enable
      !=partial('includes/widget/card_archives', {}, {cache: theme.fragment_cache})
    if theme.aside.card_webinfo.enable
      !=partial('includes/widget/card_webinfo', {}, {cache: theme.fragment_cache})

打开 themes/butterfly/_config.yml，搜索 aside: 设置处，添加 clock 开关：

1
2
3

aside:
  card_clock:
    enable: true

步骤 3：导入 CSS、JS、图片等资源文件

将下载包中的 clock 文件夹放入博客根目录的 source 文件夹下。

注意：如果报错，请将文件夹中的 pug 文件夹删除！

基础 3.0 版本

打开 clock/clock.js，找到这行：

1

let clockurl = "https://api.airvisual.com/v2/nearest_city?key=88888888-8888-8888-8888-888888888888";

将 key 值改为你在 AirVisual 官网申请的 Key。

内测 3.1 版本

打开 clock/clock.js，找到这行：

1

const mykey = { weather: "888888888888888888888" };

将 key 值改为你在 openweathermap.org 官网申请的 Key。

步骤 4：接入 CSS 与 JS

打开 themes/butterfly/_config.yml，搜索 inject: 设置处，添加：

1
2
3
4
5
6

inject:
  head:
    - <link rel="stylesheet" href="/clock/css/clock.css" />
  bottom:
    - <script src="https://cdn.jsdelivr.net/npm/vue@2.6.11"></script>
    - <script src="/clock/js/clock.js"></script>

Butterfly 3.4 以上版本请引入 jQuery：

1
2
3
4
5
6
7

inject:
  head:
    - <link rel="stylesheet" href="/clock/css/clock.css" />
  bottom:
    - <script src="https://cdn.jsdelivr.net/npm/vue@2.6.11"></script>
    - <script src="https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js"></script>
    - <script src="/clock/js/clock.js"></script>

总结

在本地进行开发时，基础版建议关闭 card_clock: enable: true 选项，以免多次调用超出访问上限。
3.1 内测版无访问次数限制。

相关评论常见问题

Q: 开启 Pjax 后控制台报错 Identifier 'mykey' has already been declared

原因：const 声明的变量会重复声明。

解决方法：

1. 在另外的 JS 中单独使用 const 声明 mykey 且不添加 data-pjax
2. 将 const 改成 let 或 var

Q: 开启 Pjax 不能加载，只有强制刷新才能显示

原因：Pjax 切换页面后脚本没有重新执行。

解决方法：给 script 标签加上 data-pjax 属性。

原文链接：https://akilar.top/posts/8e1264d1/
作者：Akilar

简介

本项目是对冰卡诺老师「基于 Butterfly 主题的轮播手动置顶文章」进行重构：

• 精简了部分样式
• 适配 Pjax
• 依赖项改为 CDN 链接
• 去 jQuery

插件安装（推荐）

在博客根目录下运行：

1

npm install hexo-butterfly-swiper --save

配置

在站点配置文件 _config.yml 或主题配置文件 _config.butterfly.yml 中添加：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# hexo-butterfly-swiper
# see https://akilar.top/posts/8e1264d1/
swiper:
  enable: true
  priority: 5
  enable_page: all
  timemode: date
  layout:
    type: id
    name: recent-posts
    index: 0
  default_descr: 再怎么看我也不知道怎么描述它的啦！
  swiper_css: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiper.min.css
  swiper_js: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiper.min.js
  custom_css: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiperstyle.css
  custom_js: https://npm.elemecdn.com/hexo-butterfly-swiper/lib/swiper_init.js

参数说明

使用方法

在文章的 Front Matter 中添加 swiper_index 配置项：

1
2
3
4
5
6
7
8

---
title: 文章标题
date: 创建日期
updated: 更新日期
cover: 文章封面
description: 文章描述
swiper_index: 1  # 置顶轮播图顺序，非负整数，数字越大越靠前
---

效果

• 首页文章列表上方显示轮播卡片
• 左侧封面图 + 右侧标题/描述/日期
• 右侧小圆点指示器（当前位置长条高亮）
• 每 3 秒自动切换
• 鼠标悬停暂停

原文链接：https://akilar.top/posts/a9131002/
作者：Akilar

简介

本项目是对冰卡诺老师「分类磁贴 2.0 版」进行重构：

• 去除所有 JS 依赖，纯 CSS 实现
• 完美支持 Pjax
• 自动获取分类和文章数
• 自定义配置行数（3 列或 4 列）
• 磁贴只显示一级分类
• 自定义磁贴封面及描述

插件安装（推荐）

在博客根目录下运行：

1

npm install hexo-butterfly-categories-card --save

配置

在站点配置文件 _config.yml 或主题配置文件 _config.butterfly.yml 中添加：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# hexo-butterfly-categories-card
# see https://akilar.top/posts/a9131002/
categoryBar:
  enable: true
  priority: 5
  enable_page: /
  layout:
    type: id
    name: recent-posts
    index: 0
  column: odd  # odd：3列 | even：4列
  row: 1  # 显示行数，超过自动切换为滚动显示
  message:
    - descr: Ubuntu指南
      cover: https://npm.elemecdn.com/akilar-candyassets/image/cover1.webp
    - descr: 玩转Win10
      cover: https://npm.elemecdn.com/akilar-candyassets/image/cover2.webp
    - descr: 长篇小说连载
      cover: https://npm.elemecdn.com/akilar-candyassets/image/cover3.webp
    - descr: 个人日记
      cover: https://npm.elemecdn.com/akilar-candyassets/image/cover4.webp
    - descr: 诗词歌赋
      cover: https://npm.elemecdn.com/akilar-candyassets/image/cover5.webp
    - descr: 杂谈教程
      cover: https://npm.elemecdn.com/akilar-candyassets/image/cover6.webp
  custom_css: https://npm.elemecdn.com/hexo-butterfly-categories-card@1.0.0/lib/categorybar.css

参数说明

效果

• 首页显示大圆角分类磁贴卡片
• 每个磁贴有封面背景图
• 显示分类名 + 文章数量
• hover 时背景放大 + 变暗效果
• 超过设定行数自动滚动隐藏

原文链接：https://zfe.space/post/hexo-butterfly-article-double-row.html
作者：小冰博客（しゅふがく）

效果

首页文章列表从单栏变成双栏卡片布局：

• 文章卡片左右两列排列
• 卡片圆角 + 阴影
• 封面图在左，标题/摘要在右
• 宽屏屏幕下更紧凑美观

NPM 插件安装

在博客根目录下打开终端，运行：

1
2
3
4

npm i hexo-butterfly-article-double-row --save

# 或者
cnpm i hexo-butterfly-article-double-row --save

注意：一定要加 --save，不然本地预览时可能不会显示！

配置

在博客根目录 _config.yml 中添加：

1
2

butterfly_article_double_row:
  enable: true

运行

执行 hexo 三连：

1

hexo clean && hexo g && hexo s

即可看到首页文章列表变成双栏布局。

展示效果优化（本站实践）

原插件注入的 cardlistpost.min.css 存在三处问题，本站新增
source/css/double_row.css 在其之后加载并覆盖：

另外补充：卡片悬停上浮、封面图片缓慢放大、标题最多两行省略、
≤900px 自动回退单列，以及保证 swiper 轮播与分类磁贴不被 flex 双栏挤压。

修改的文件：source/css/double_row.css（新增），
并在 _config.butterfly.yml 的 inject.head 中引入该样式。

原文链接：https://zfe.space/post/18661.html
作者：小冰博客（しゅふがく）

效果展示

• Github Pages Demo：https://zfour.github.io/APlayer-Meting-JustAddMusic/
• 个人主页 Demo：https://zfe.space
• Butterfly 主题 Demo：https://zfe.space

依赖

• APlayer
• MetingJS
• JustAddMusic

一步安装到 Hexo（Butterfly 主题为例）

1. 从 https://github.com/Zfour/APlayer-Meting-JustAddMusic 克隆项目：

   1	git clone https://github.com/Zfour/APlayer-Meting-JustAddMusic.git

2. 将项目存放于博客根目录的 source 文件夹下

3. 将 Hexo page 文件夹里的 music 文件夹复制后，粘贴到 source 文件夹下

大功告成！

注意事项

• 如果你开启了主题的 APlayer 插件，请关掉或在本页面禁用
• 本项目仍处于测试阶段，请使用能够正常播放（非 VIP 歌曲）的 playlist 播放
• 歌曲封面旋转、歌词滚动、频谱可视化等效果会自动生效

页面结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

source/
├── APlayer-Meting-JustAddMusic/
│   ├── css/
│   │   ├── APlayer.min.css
│   │   ├── font-awesome.min.css
│   │   └── justaddmusic.css
│   ├── js/
│   │   ├── APlayer.min.jam.js
│   │   ├── JustAddMusic.js
│   │   ├── Meting.min.js
│   │   ├── jamsetting.js
│   │   ├── jquary.js
│   │   ├── visualchanger.js
│   │   └── visualupper.js
│   └── fonts/
└── music/
    └── index.md

自定义配置

编辑 music/index.md，修改 {% meting %} 标签中的歌单 ID：

1

{% meting "你的歌单ID" "netease" "playlist" "order:random" %}

参数说明：

• 第一个参数：歌单 ID
• 第二个参数：音乐源（netease / tencent / kugou / xiami / baidu）
• 第三个参数：类型（playlist / song / album / search）
• 第四个参数：排序方式

原文链接：https://zfe.space/post/42391.html
作者：小冰博客（しゅふがく）

序言

做这个小部件的目的是学习 AJAX 跨域访问 API，但实际上很难弄。
最终采用本地读取 JSON 的方法，制作了这个小部件。

相比单独写一个页面，侧边栏小部件更具有观赏性。

JSON 使用的是原生百度百科 API 下载的 JSON，自带百度百科链接。

API 地址

1

https://baike.baidu.com/cms/home/eventsOnHistory/09.json

后面的数字代表月份（01-12）。

步骤 1：编写小部件 PUG

在 themes/butterfly/layout/includes/widget 文件夹下复制某个 PUG 文件，重命名为 card_history.pug，删除原有代码，粘贴以下代码（注意 PUG 的空格敏感）：

1
2

if theme.aside.card_history.enable
  !=partial('includes/widget/card_history', {}, {cache: theme.fragment_cache})

步骤 2：将小部件植入侧边栏

打开 themes/butterfly/layout/includes/widget/index.pug，将 card_history 代码添加至 card_author 代码块后：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

#aside_content.aside_content
  if page.aside !== false
    #aside_content.aside_content
      if theme.aside.card_author.enable
        !=partial('includes/widget/card_author', {}, {cache: theme.fragment_cache})

      if theme.aside.card_history.enable
        !=partial('includes/widget/card_history', {}, {cache: theme.fragment_cache})

      if theme.aside.card_announcement.enable
        !=partial('includes/widget/card_announcement', {}, {cache: theme.fragment_cache})

      if theme.aside.card_recent_post.enable
        !=partial('includes/widget/card_recent_post', {}, {cache: theme.fragment_cache})

      if theme.ad && theme.ad.aside
        !=partial('includes/widget/card_ad', {}, {cache: theme.fragment_cache})

      if theme.aside.card_categories.enable
        !=partial('includes/widget/card_categories', {}, {cache: theme.fragment_cache})

      if theme.aside.card_tags.enable
        !=partial('includes/widget/card_tags', {}, {cache: theme.fragment_cache})

      if theme.aside.card_archives.enable
        !=partial('includes/widget/card_archives', {}, {cache: theme.fragment_cache})

      if theme.aside.card_webinfo.enable
        !=partial('includes/widget/card_webinfo', {}, {cache: theme.fragment_cache})

打开 themes/butterfly/_config.yml，搜索 aside: 设置处，添加 history 开关：

1
2
3

aside:
  card_history:
    enable: true

步骤 3：本地 JSON 配置

1. 下载 JSON 文件：https://zfe.space/post/42391.html（页面内有下载链接）
2. 在博客根目录 source 文件夹下新建 history 文件夹
3. 在 source/history 路径下解压 JSON.zip

注意：此 JSON 为修改过的版本，删除了一层数组外壳，对日期键值加入了 “S” 使其非数字化。

步骤 4：编写 JS

在 source 文件夹下新建 js 文件夹，新建 history.js：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

var myDate = new Date();
var myMonth = myDate.getMonth() + 1;
if (myMonth < 10) {
  getMonth = "0" + String(myMonth);
} else {
  getMonth = String(myMonth);
}
var getDate = String(myDate.getDate());
if (getDate < 10) {
  getDate = "0" + String(getDate);
} else {
  getDate = String(getDate);
}
var getMonthDate = "S" + getMonth + getDate;
var geturl = "/history/json/" + getMonth + ".json";

$(function () {
  $.ajax({
    type: "GET",
    url: geturl,
    dataType: "json",
    success: function (data) {
      var str = '<ul style="list-style: none;padding-inline-start: 0px;">';
      $.each(data[getMonthDate], function (i, n) {
        str += '<li style="list-style: none;height:100px;">';
        str +=
          '<p style="color: #858585;Font-style:italic;font-weight:lighter;float:left;width:100%;font-size: 14px;margin:0px; padding:0px;display:inline-block">';
        str += "<i>A.D.</i>" + n.year + "</p>";
        str +=
          '<p style="width:100%;float:left;margin:0px; padding:0px;display:inline-block" >';
        str += n.title + '<i style="Font-style:normal;">。</i>';
        str += "</p>" + "</li>";
      });
      str += "</ul>";
      $("#history-card").append(str);
    },
  });
});

在 source/js 文件夹新建 historyroll.js（自动滚动效果）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

$(function () {
  var $this = $("#history-news");
  var scrollTimer;
  $this
    .hover(
      function () {
        clearInterval(scrollTimer);
      },
      function () {
        scrollTimer = setInterval(function () {
          scrollNews($this);
        }, 4000);
      }
    )
    .trigger("mouseleave");

  function scrollNews(obj) {
    var $self = obj.find("ul");
    var lineHeight = $self.find("li:first").height();
    $self.animate(
      { marginTop: -lineHeight + "px" },
      200,
      function () {
        $self
          .css({ marginTop: 10 })
          .find("li:first")
          .appendTo($self);
      }
    );
  }
});

步骤 5：接入 JS

打开 themes/butterfly/_config.yml，搜索 inject: 设置处，添加：

1
2
3
4

inject:
  bottom:
    - <script src="/js/history.js"></script>
    - <script src="/js/historyroll.js"></script>

效果

• 侧边栏显示当天日期对应的历史事件
• 每条显示年份 + 事件标题
• 每 4 秒自动滚动一条
• 鼠标悬停暂停滚动

原文链接：https://zfe.space/post/hexo-electric-clock.html
作者：小冰博客（しゅふがく）

前言

基于 npm 插件方式部署的侧边栏电子时钟，自动挂载到侧边栏。

效果

• LED 数码管字体显示时间
• 天气图标 + 温度
• 湿度
• IP 地址 + 地理位置
• AM/PM 标识

NPM 插件安装

在博客根目录下打开终端，运行：

1
2
3
4

npm i hexo-electric-clock --save

# 或者
cnpm i hexo-electric-clock --save

注意：一定要加 --save，不然本地预览时可能不会显示！

配置项

在博客根目录 _config.yml（不是主题配置文件）中添加：

1
2
3
4
5
6
7
8
9

electric_clock:
  priority: 5
  enable: true
  enable_page: all
  layout:
    type: class
    name: sticky_layout
    index: 0
  temple_html: '<div class="card-widget card-clock"><div class="card-glass"><div class="card-background"><div class="card-content"><div id="hexo_electric_clock"><img id="card-clock-loading" src="https://cdn.jsdelivr.net/gh/Zfour/Butterfly-clock/clock/images/weather/loading.gif" style="height: 120px; width: 100%;" data-ll-status="loading" class="entered loading"></div></div></div></div></div>'

参数说明

运行

执行 hexo 三连：

1

hexo clean && hexo g && hexo s

即可看到侧边栏电子时钟效果。

Note 提示块

基本用法

1
2
3

{% note [颜色] [图标] [样式] %}
内容
{% endnote %}

三种样式对比

1
2
3
4
5
6

{% note simple %}默认提示{% endnote %}
{% note primary simple %}主要提示{% endnote %}
{% note success simple %}成功提示{% endnote %}
{% note info simple %}信息提示{% endnote %}
{% note warning simple %}警告提示{% endnote %}
{% note danger simple %}危险提示{% endnote %}

1
2
3

{% note modern %}默认提示{% endnote %}
{% note success modern %}成功提示{% endnote %}
{% note warning modern %}警告提示{% endnote %}

1
2
3

{% note flat %}默认提示{% endnote %}
{% note success flat %}成功提示{% endnote %}
{% note warning flat %}警告提示{% endnote %}

自定义图标

1
2
3

{% note blue 'fas fa-bullhorn' %}📢 通知内容{% endnote %}
{% note pink 'fas fa-car-crash' %}⚠️ 小心安全{% endnote %}
{% note green 'fab fa-github' %}GitHub 仓库{% endnote %}

可选颜色：default / blue / pink / red / purple / orange / green

图标用 FontAwesome 类名。

Tabs 标签切换

1
2
3
4
5
6
7
8
9

{% tabs 唯一名称, 默认激活序号 %}
<!-- tab 选项1 -->
内容1
<!-- endtab -->

<!-- tab 选项2 -->
内容2
<!-- endtab -->
{% endtabs %}

名称不能重复，每篇文章里只能用一次同名 tabs。

Gallery 相册

相册组

1
2
3
4

<div class="gallery-group-main">
{% galleryGroup 名称 描述 链接 封面图 %}
{% galleryGroup 名称 描述 链接 封面图 %}
</div>

单相册

1
2
3
4

{% gallery %}
![图1](/img/1.jpg)
![图2](/img/2.jpg)
{% endgallery %}

按钮

1

{% btn https://github.com, 访问 GitHub, fab fa-github %}

复选框

1
2

{% check 完成的任务 %}
{% check 未完成的任务 %}

文字样式

1
2
3
4
5
6

{% bold 加粗文字 %}
{% underline 下划线文字 %}
{% delete 删除线文字 %}
{% sup 上标 %}
{% sub 下标 %}
{% inlinebug 标签 %}

行内代码高亮

1

{% kb Ctrl %} + {% kb C %}

显示为 Ctrl + C 键盘按键样式。

常用速查表

1

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

1
2

cd themes/butterfly
git pull

1

npm i hexo-theme-butterfly

1

npm update hexo-theme-butterfly

1

git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

应用主题

修改根目录 _config.yml：

1

theme: butterfly

安装渲染器

1

npm install hexo-renderer-pug hexo-renderer-stylus --save

配置文件分离（重要）

在根目录创建 _config.butterfly.yml，把主题目录的 _config.yml 内容复制进去。

好处：升级主题时不会覆盖你的配置。

固定文章链接（abbrlink）

中文标题会导致 URL 乱码，改标题后链接失效。

1

npm install hexo-abbrlink --save

修改 _config.yml：

1
2
3
4
5

permalink: post/:abbrlink.html

abbrlink:
  alg: crc32   # 算法：crc16 / crc32
  rep: hex     # 进制：dec / hex

效果：链接变成 https://xxx/post/abc123.html，简洁稳定。

代码块配置

1
2
3

highlight_theme: mac
highlight_copy: true       # 代码复制按钮
highlight_height_limit: 300 # 代码高度限制(px)

顶部图配置

1
2

index_img: /img/banner.jpg
default_top_img: /img/default-bg.jpg

单篇文章单独设置（front-matter）：

1
2
3
4

---
title: 文章标题
top_img: /img/post-special.jpg
---

页脚背景

1

footer_bg: true   # 页脚显示图片背景

打字粒子特效

鼠标点击时的粒子爆炸效果：

1
2
3
4
5

activate_power_mode:
  enable: true
  colorful: true    # 彩色粒子
  shake: true       # 抖动效果
  mobile: false     # 手机端关闭

背景特效

1
2
3
4
5
6
7

canvas_ribbon:
  enable: false
  size: 150
  alpha: 0.6
  zIndex: -1
  click_to_change: false
  mobile: false

1
2
3

canvas_fluttering_ribbon:
  enable: true
  mobile: true

1
2
3
4
5
6
7

canvas_nest:
  enable: false
  onmobile: true
  color: '0,0,255'
  opacity: 0.7
  zIndex: -1
  count: 99

提示：特效越多加载越慢，手机端建议只开一个或全关。

Node.js

1
2
3
4
5

# 下载 nvs
git clone https://github.com/jasongin/nvs.git
cd nvs
./nvs.sh add lts
nvs use lts

1
2
3
4
5
6

# 使用 Homebrew
brew install node

# 验证
node -v
npm -v

1
2
3
4
5
6

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# Fedora
sudo dnf install nodejs

Git

1

brew install git

1
2
3
4
5

# Ubuntu/Debian
sudo apt install git

# Fedora
sudo dnf install git

安装 Hexo

1
2
3
4
5
6
7
8

# 替换 npm 源为国内镜像
npm config set registry https://registry.npmmirror.com

# 全局安装 hexo-cli
npm install hexo-cli -g

# 验证
hexo -v

初始化博客

1
2
3
4
5
6
7
8
9
10
11
12

# 新建博客文件夹（建议非系统盘）
mkdir D:/blog/superBrain
cd D:/blog/superBrain

# 初始化
hexo init

# 安装依赖
npm install

# 本地预览
hexo s

浏览器打开 http://localhost:4000 看到默认主题即成功。

部署到 GitHub

1. 新建仓库

仓库名必须是 用户名.github.io，例如 QINchao998314.github.io。

2. 配置 SSH 密钥

1
2
3
4
5

# 生成密钥
ssh-keygen -t ed25519 -C "你的邮箱"

# 查看公钥
cat ~/.ssh/id_ed25519.pub

复制公钥 → GitHub → Settings → SSH and GPG keys → New SSH key。

测试连接：

1

ssh -T git@github.com

3. 配置 Git 用户

1
2

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

4. 安装部署插件

1

npm install hexo-deployer-git --save

5. 修改 _config.yml

1
2
3
4

deploy:
  type: git
  repository: git@github.com:用户名/用户名.github.io.git
  branch: main

6. 部署命令

1
2
3

hexo clean    # 清理缓存
hexo g        # 生成静态文件
hexo d        # 部署到 GitHub

访问 https://用户名.github.io 即可。

常用命令速查

常见问题

Q: 4000 端口被占用？

1

hexo s -p 4001

Q: 部署后样式丢失？
检查 _config.yml 的 url 和 root 配置。

Q: 文章中文标题 URL 乱码？
安装 hexo-abbrlink 生成唯一链接，见 Butterfly 配置篇。

1

搭建博客 → GitHub Actions → 第三方托管 → 静态资源优化 → CDN 加速

博客搭建

GitHub Actions 自动部署

把本地的 hexo g -d 放到线上自动跑。

好处：

• 本地只写文章，git push 就自动部署
• 源码版本管理，出错随时回滚
• 增量提交，速度快

需要在 GitHub 仓库新建 .github/workflows/deploy.yml。

托管平台对比

多线部署

通过 DNS 按线路分流：

• 境外访问 → GitHub Pages
• 电信用户 → Vercel
• 移动用户 → Netlify

注意：不同平台 SSL 证书不通用，不要强制 HTTPS。

静态资源优化

注意：jsdelivr 国内速度已变差，慎用。

PWA / pjax / Gulp

这三个并称”bug 御三家”：

• PWA：功能非刚需，bug 多，难卸载
• pjax：页面无刷新，但容易出兼容问题
• Gulp：配置繁琐，提升有限

非刚需别硬上。

全站 CDN

国内 CDN 必须备案，这是硬性要求。

备案流程：

1. 国内注册域名（阿里云/腾讯云）
2. 域名服务商提交备案
3. 客服初审材料
4. 管局审核（3天~1个月）

没有备案号用不了国内 CDN。

Quick Start

Create a new post

1

$ hexo new "My New Post"

More info: Writing

Run server

1

$ hexo server

More info: Server

Generate static files

1

$ hexo generate

More info: Generating

Deploy to remote sites

1

$ hexo deploy

More info: Deployment