南风尘小站

从零开始：让 AI 帮你写自动化脚本 · 傻瓜版教程

Thu, 10 Sep 2026 00:00:00 GMT

写给谁：电脑上没装过 Python、WorkBuddy、Trae Work、TraeCode，完全零代码基础的同事。 看完你能学会：装好全部工具 → 把 4 个成功案例跑起来 → 用”提示词”指挥 AI 把案例改造成你公司/你岗位的专有脚本 → 让结果自动发到钉钉 → 定时自动运行、日常维护。 你不需要：会写代码、懂英文、懂编程概念。全程只做三件事：装软件、改配置、说人话下指令。

目录#

第 0 章先搞懂：这套东西是什么、各工具干什么
第 1 章概念扫盲：提示词、成功案例、配置文件
第 2 章软件安装与环境部署（让 AI 帮你装）
第 3 章认识 4 个成功案例
第 4 章第一次运行成功案例（改配置 → 双击 → 出结果）
第 5 章核心章节：学会写提示词，让 AI 把案例改成你自己的
第 6 章用 TraeCode 调试：看懂报错、把报错喂回给 AI
第 7 章接入钉钉：机器人通知 + AI 表格自动流
第 8 章定时自动运行（Windows 任务计划程序）
第 9 章日常运行与维护
附录 A 提示词速查卡（10 条即抄即用）
附录 B 常见报错对照表
附录 C 安全红线（必读）

第 0 章先搞懂：这套东西是什么、各工具干什么#

用一个比喻：你要开一家”自动化快餐店”，每个工具就是一个岗位。

工具	角色	比喻	你需要学到什么程度
Python	底层脚本语言，所有脚本靠它运行	厨房的燃气和电——没有它灶点不着	只负责”装好”，装完基本不用碰
WorkBuddy	日常 AI 搭建主力，对话式干活	大厨——你说要什么菜，他做	会聊天、会发指令（提示词）
Trae Work	另一个 AI 搭建主力，和 WorkBuddy 二选一或配合用	二厨——擅长盯着项目文件干活	同上
TraeCode	IDE（代码编辑器），用来调试脚本	车间检修台——东西坏了在这里拆开看	会打开文件夹、会运行、会复制报错信息
钉钉 MCP / AI 表格自动流	成果输出平台	出餐口——做好的菜从这里端给客人	会建群机器人、会授权连接

一句话总结工作流：

1
你用"人话"（提示词）指挥 AI（WorkBuddy / Trae Work）
2
        ↓
3
AI 参考成功案例，生成/修改 Python 脚本
4
        ↓
5
你双击 bat 文件运行脚本
6
        ↓
7
结果（报表/消息）自动输出到钉钉

你全程不写一行代码，你只负责：说清楚需求 + 改配置文件里的账号路径 + 把报错复制给 AI。

第 1 章概念扫盲：提示词、成功案例、配置文件#

1.1 什么是”提示词”？#

提示词 = 你发给 AI 的工作指令。 没有任何神秘感，就是”把话说清楚”。

对比一下：

❌ 差的提示词：“帮我做个脚本。“（AI 不知道你要什么，只能瞎猜）

✅ 好的提示词：“参考我发给你的’蓝凌EKP系统登录’成功案例，帮我写一个自动登录我们公司 OA 系统的脚本：每天早上自动登录，把’请假审批’列表里昨天结束的流程全部导出成 Excel，存到（本机路径）文件夹。账号密码放在配置文件里。“（AI 能直接开工）

好提示词的秘诀就一条：把”谁、参考什么、做什么、结果放哪”四件事说全。 第 5 章会给你万能公式和现成模板。

1.2 什么是”成功案例”？#

成功案例就是 4 个已经做完、能正常运行的自动化项目，它们是你学走这套本领的”样板间”。你不需要看懂里面的代码——你只需要知道：

它能干什么（比如：自动登录网站、下载报表、发钉钉通知）；
哪个文件是”遥控器”（配置文件）；
哪个文件双击就能跑（.bat 启动文件）。

AI 改造案例的原理：你把成功案例文件夹交给 AI，说”照着这个样子，改成我公司的场景”。AI 会模仿案例的结构、套路、写法，生成属于你的新脚本。这就是”参考成功案例”的含义——案例是给 AI 看的范本，不是给你看的。

1.3 什么是”配置文件”（.ini）？#

打开任何一个案例文件夹，你都会看到一个 .ini 结尾的文件，长得像这样（已脱敏）：

1
[登录信息]
2
登录账号 = 你的账号
3
登录密码 = 你的密码
4

5
[浏览器配置]
6
无头模式 = false

这就是遥控器：账号密码、网址、保存路径、要不要后台运行……所有”会变的东西”都集中在这一个文件里。

你以后 90% 的”修改工作”就是改这个文件——比如换账号、换下载路径、增删一个下载任务。改法：用记事本或 TraeCode 打开，改等号右边的值，保存。

⚠️ 注意：等号左边的名字不要动，只改等号右边的值；# 或 ; 开头的行是注释说明，可以随便看，删不删都行。

1.4 三个文件后缀，认识就够了#

后缀	是什么	你要干什么
`.py`	Python 脚本（代码本体）	不用打开、不用改，AI 负责写
`.ini`	配置文件（遥控器）	经常改，只改等号右边的值
`.bat`	一键启动器	双击它，脚本就跑起来了

第 2 章软件安装与环境部署（让 AI 帮你装）#

系统要求：Windows 10 / 11。全程约 30～60 分钟（大部分时间在等下载）。

2.1 安装 Python（唯一需要手动点几次鼠标的环节）#

打开浏览器，访问 Python 官网下载页：`http（本机路径）
点击黄色的 Download Python 3.x.x 大按钮，下载安装包。
双击安装包，第一屏最关键：
- ✅ 务必勾选底部的 “Add python.exe to PATH”（把 Python 加入系统路径）——不勾后面全盘卡住；
- 然后点 Install Now，一路等待完成。
验证是否装好：按键盘 Win + R，输入 cmd 回车，打开黑色命令行窗口，输入：

1
python --version

显示 Python 3.12 之类的版本号 = 成功。显示”不是内部或外部命令” = 大概率没勾 Add to PATH，不用慌，看 2.3 让 AI 救你。

2.2 安装 WorkBuddy、Trae Work、TraeCode#

三个都是图形界面软件，和装微信一样：官网下载安装包 → 双击 → 下一步到底。

软件	安装要点
WorkBuddy	官网（workbuddy.cn）下载 Windows 版，安装后用公司账号登录即可对话
Trae Work	Trae 官网下载 “Trae Work” 版本（区别于普通 Trae），安装后登录
TraeCode	同一官网下载 “Trae Code” 版本，它是个编辑器，装完不用登录也能用基本功能

三者的分工回顾：WorkBuddy / Trae Work 负责”聊天干活”，TraeCode 负责”打开项目看文件、跑脚本、看报错”。

2.3 关键姿势：环境部署也交给 AI#

装完软件后，缺什么库、路径不对、环境变量坏了——全都直接问 AI，不要自己百度。把下面这段话复制给 WorkBuddy：

📋 提示词模板 ①：环境体检与部署

1
我是一零基础新手，刚在这台 Windows 电脑上装好了 Python、WorkBuddy。
2
请你帮我完成环境检查和部署：
3
1、检查 Python 是否安装成功、版本是多少；
4
2、帮我安装项目需要的依赖库：playwright、beautifulsoup4、openpyxl、requests；
5
3、检测缺什么就装什么，安装过程和结果用大白话告诉我；
6
4、全部完成后，给我一份"环境体检报告"：哪些已就绪、哪些还有问题、下一步该干什么。
7
注意：所有命令你直接帮我执行，不要让我自己敲命令行。

AI 会自动执行检查、安装依赖、报告结果。遇到任何红色报错，直接截图发给它，说”这一步失败了，帮我解决”。

2.4 验证清单#

全部装完后，对着打勾：

Win+R → cmd → python --version 能显示版本号
WorkBuddy 打开后能正常对话
Trae Work 打开后能正常对话
TraeCode 能打开一个文件夹（随便拖个文件夹进去试试）
把提示词模板①发给 AI，它回复”环境就绪”

全打勾 → 进入第 3 章。

第 3 章认识 4 个成功案例#

把”成功案例”文件夹整体复制到自己电脑（建议放 `（本机路径），路径里尽量不要有中文以外的特殊字符，也不要放桌面）。

4 个案例一览（均已脱敏）：

案例	干什么	一句话理解	双击运行的文件
BI任务模块化	自动登录公司 BI 报表平台，按配置批量下载多张报表，存到共享盘，并发钉钉通知	“报表下载机器人”	`BI任务打包启动.bat`
每日CRM任务	自动登录销售易 CRM，导出销售合同表格，再自动汇总进一张总表，发钉钉通知	“CRM 数据搬运工”	`CRM任务启动程序.bat`
每日运营决策	自动登录运营决策平台，爬取数据导出，配日志通知和钉钉告警	“运营数据采集员”	`运营决策平台导出_主程序打包启动.bat`
蓝凌EKP系统登录	自动登录蓝凌 OA，按”导航指令”批量导出流程单据，还能把网页转成 Excel 报表	“OA 流程导出员”	`启动蓝凌EKP系统主程序.bat`

3.1 所有案例的共同骨架（看懂这个，你就看懂了全部）#

打开任意一个案例文件夹，结构都长一个样：

1
蓝凌EKP系统登录/
2
├── 蓝凌EKP系统登录_主程序.py      ← 代码主程序（不用碰）
3
├── 蓝凌EKP系统登录配置.ini        ← 遥控器（你主要改这个）
4
├── 启动蓝凌EKP系统主程序.bat      ← 双击运行
5
├── 使用说明书.md / 导航说明书.md   ← 案例自带说明书（遇到问题先翻它）
6
└── 模块/                          ← 功能零件（登录、下载、发通知……AI 负责写）

这就是贯穿所有项目的 “1 个主程序 + 1 个配置文件 + 1 个模块文件夹” 架构。你以后让 AI 给你做新脚本，也统一用这个架子，好维护、好替换。

3.2 每个案例都有的三类”可变东西”#

不管哪个案例，配置文件里无非三类内容：

身份：账号、密码（改成你自己的）；
目标：网址、报表导航路径、要下载什么（改成你公司的系统）；
去处：文件存哪、钉钉机器人地址发到哪个群（改成你的路径和群）。

改造一个案例 = 把这三类东西换成你自己的。 里面具体怎么改，第 4、5 章手把手教。

第 4 章第一次运行成功案例（改配置 → 双击 → 出结果）#

目标：拿”蓝凌EKP系统登录”练手（它自带最详细的《使用说明书.md》），完整走一遍”配置→运行→出结果”。

4.1 第一步：让 AI 帮你读懂案例#

把案例文件夹拖进 WorkBuddy 对话框（或在 Trae Work 里打开该文件夹），发：

📋 提示词模板 ②：案例导读

1
这是公司的一个成功案例项目，我是零基础新手。请你：
2
1、用大白话讲清楚这个项目是干什么的、运行起来会发生什么；
3
2、告诉我哪些文件我可以动（配置、说明），哪些绝对不能动（代码）；
4
3、把配置文件里每一项的含义列成表格，标注"必改 / 可不改 / 别动"；
5
4、告诉我第一次运行前必须改哪几项才能跑起来。
6
不要给我讲代码，只讲使用方法。

AI 会给你一份导读报告。这份报告就是你的作业清单。

4.2 第二步：按清单改配置#

以蓝凌案例为例，需要改的一般是：

1
[登录信息]
2
登录账号 = 改成你的OA账号
3
登录密码 = 改成你的OA密码
4

5
[浏览器配置]
6
浏览器路径 = 改成本机Chrome的路径，例如 （本机路径） Files\Google\Chrome\Application\chrome.exe

改文件的三种方式（任选）：

方式 A（推荐新手）：直接在 WorkBuddy 里说”帮我把配置文件里的登录账号改成 xxx、密码改成 xxx”，让 AI 替你改；
方式 B：右键 .ini 文件 → 打开方式 → 记事本 → 改完 Ctrl+S 保存；
方式 C：用 TraeCode 打开项目，双击 .ini 文件编辑保存（顺便熟悉 TraeCode）。

💡 不知道自己电脑的 Chrome 路径？问 AI：“帮我查一下我电脑上 Chrome 浏览器的安装路径，并帮我写进配置文件。”

4.3 第三步：双击运行#

双击 启动蓝凌EKP系统主程序.bat，会弹出黑色窗口，随后自动打开浏览器自动登录、自动操作。期间不要动鼠标键盘去抢浏览器的控制权。

跑完看两个地方：

黑窗口里的文字：出现 [OK]、成功 字样即正常；
案例文件夹里的 输出结果/ 目录：导出的文件在里面。

4.4 第四步：跑不起来？把报错喂给 AI#

双击后黑窗口一闪而过，或出现大片红字 = 出错了。这是新手最需要学会的一招：

用”截图 + 复制文字”把黑窗口里的报错信息完整保留（窗口关太快就问 AI：“帮我让 bat 运行完不自动关闭”）；
发给 WorkBuddy，附一句话：

📋 提示词模板 ③：报错求救

1
我运行成功案例"蓝凌EKP系统登录"时报错了，报错信息如下（见截图/如下文字）。
2
请你：1、用大白话告诉我错在哪；2、直接帮我修好；3、告诉我怎么验证修好了。
3
我看不懂代码，修复过程你全权负责，改完哪个文件告诉我就行。

记住这个循环：运行 → 报错 → 贴给 AI → AI 修 → 再运行。 所有的学习都发生在这个循环里，你永远不需要独自面对报错。

第 5 章核心章节：学会写提示词，让 AI 把案例改成你自己的#

前面都是”用现成的”，这一章教你”造自己的”。这是整本教程的核心——学写提示词，不是学写代码。

5.1 万能提示词公式#

一个好提示词 = 下面六块积木，按顺序搭：

积木	说明	示例
① 角色	告诉 AI 以什么身份干活	“你是经验丰富的办公自动化工程师”
② 背景	我是谁、电脑环境、我的水平	“我零代码基础，Windows 11，已装好 Python”
③ 素材	参考什么案例、有什么资料	“参考附件’每日CRM任务’成功案例”
④ 任务	具体要做什么，一步步列清楚	“登录××系统，导出××报表，存到××”
⑤ 要求	架构、习惯、禁区	“用’1主程序+1配置+模块文件夹’架构，配置用中文命名，不要改案例原有代码”
⑥ 输出	做完交付什么	“完成后写一份使用说明书，并教我怎么运行”

黄金法则：把 AI 当成一个很能干但对你公司一无所知的外包工程师。 它不知道你们系统网址、不知道报表叫什么、不知道存哪——这些你不说，它就只能瞎编。所以④”任务”要写得像给新员工的交接文档：几步、点什么、看到什么算成功。

5.2 实战一：仿”蓝凌EKP”做一个你们公司 OA 的导出脚本#

场景：你们公司也用蓝凌 OA（或类似系统），你想每天自动导出”请假流程”并转 Excel。

操作：把案例文件夹和下面提示词一起发给 WorkBuddy：

📋 提示词模板 ④：改造案例（完整范例，可直接抄改）

1
【角色】你是经验丰富的办公自动化工程师。
2
【背景】我零代码基础，Windows 11，Python 环境已就绪。
3
【素材】附件是公司的成功案例"蓝凌EKP系统登录"，它已能自动登录蓝凌OA、
4
按导航编码批量导出流程、并把HTML转成Excel。请完整参考它的架构和写法。
5
【任务】帮我在案例旁边新建一个同样架构的项目"请假流程导出"，实现：
6
1、自动登录我们公司OA（网址：htt（本机路径））；
7
2、进入"流程中心-请假审批"列表；
8
3、筛选"结束时间 = 前天到今天"的流程；
9
4、逐条打开详情，导出打印模板HTML；
10
5、自动转换成Excel（每个流程一个工作表，再合并一张总表）；
11
6、保存到 （本机路径）。
12
【要求】
13
1、严格沿用成功案例的"1主程序+1配置ini+模块文件夹"架构；
14
2、账号密码、网址、路径全部放进ini配置，代码里不写死；
15
3、变量和文件名用中文命名，关键逻辑加中文注释；
16
4、参考案例的"组件编码"导航写法（ACC/CARD/FLT那些）。
17
【输出】
18
1、生成完整项目文件夹；
19
2、附一份《使用说明书.md》，包含：怎么配置、怎么双击运行、常见问题；
20
3、最后教我第一步先改哪个配置项。

展开收起

要点解析（为什么这么写）：

“参考它的架构和写法” → AI 会照着成熟套路来，成功率远高于从零写；
任务写成 1、2、3、4 步骤 → 每一步都可验证，AI 不容易跑偏；
“账号密码放 ini 不写死” → 以后换账号你改配置就行，不用再求 AI；
“附使用说明书” → 逼 AI 留下文档，一个月后你自己都还记得怎么用。

5.3 实战二：仿”每日CRM任务”做自家业务系统导出#

CRM 案例的精髓是”任务步骤文档”：当初开发者就是写了一份《CRM任务步骤.txt》，把”点哪、看到什么算加载完、下载到哪”用大白话+网页元素代码写清楚，AI 照此生成脚本。

你也能照做，三步：

第 1 步：写你自己的”任务步骤”文档（打开目标网页，人肉走一遍流程，边走边记录）：

1
任务：导出我们系统的"客户订单"列表
2
1、打开登录页：http（本机路径），输入账号密码登录；
3
2、登录成功的标志：页面右上角出现"工作台"三个字；
4
3、点击左侧菜单"订单管理"→"全部订单"；
5
4、列表加载完成的标志：表头出现"订单编号"；
6
5、点击右上角"导出"按钮，等待下载完成；
7
6、文件保存到 （本机路径）。

第 2 步：顺手抓”网页元素”给 AI（进阶但极其有效）：在网页上按 F12 → 点左上角小箭头图标 → 点一下你要操作的按钮 → 下方高亮的那行代码右键 → Copy → Copy element，粘贴进步骤文档。案例里那些 <a id="export">导出</a> 就是这么来的。元素给得越准，AI 写的脚本越稳。

第 3 步：发提示词：

📋 提示词模板 ⑤：按任务步骤生成脚本

1
【素材1】成功案例"每日CRM任务"（附件），请参考其架构：
2
1主程序 + N任务模块 + 1个ini配置，登录逻辑、等待元素、静默下载的写法都可复用。
3
【素材2】我的任务步骤文档：（把上面第1步写的内容粘贴在这里）
4
【任务】按步骤文档，为我生成一个同架构的新项目"订单导出"。
5
【要求】
6
1、页面元素的定位优先用我文档里提供的元素，没提供的由你给出合理方案；
7
2、"加载完成的标志"必须做成验证步骤，验证不过就重试并报错，不要瞎点；
8
3、下载用静默下载（不弹保存对话框），路径读ini配置；
9
4、跑完把结果（成功几条/失败原因）推送到钉钉群机器人（机器人地址我之后填）。
10
【输出】完整项目 + 使用说明书 + 首次运行检查清单。

5.4 实战三：仿”BI任务模块化”增删报表下载任务#

BI 案例最好改造，因为加一个下载任务只需改配置、不用改代码。它的配置长这样（脱敏）：

1
[任务-2]
2
名称 = 库存下载
3
导航路径 = 我的分析|协作给我的|Ⅺ-库存|K1-库存数|库存明细
4
导出格式 = Excel
5
目标文件夹 = （本机路径）
6
目标文件名 = 库存明细.xlsx
7
启用 = True

你要做的就是在 BI 平台里人肉点一遍你要的报表，把”依次点过的菜单名”用 | 串起来填进 导航路径。

配套提示词（跑通前让 AI 把关）：

📋 提示词模板 ⑥：新增/修改下载任务

1
这是"BI任务模块化"项目的配置文件。我想新增一个下载任务：
2
报表位置：我依次点击了「分析 → 协作给我的 → 3-销售 → 每日销售达成」；
3
导出 Excel，保存到 （本机路径），文件名叫"每日销售达成.xlsx"。
4
请你：1、帮我把新任务写进配置文件；2、检查我的导航路径写法是否符合
5
该项目的格式要求；3、告诉我改完后怎么验证任务跑通了。

5.5 提示词的迭代心法：一次只改一件事#

AI 第一次生成的脚本很少一次完美，高手和新手的区别不在第一句提示词，而在后续怎么”追问”。心法三条：

小步快跑：一次只提一个改动。“把下载路径改成 E 盘” ✅；“顺便把下载、汇总、通知、定时全改了” ❌——改动越多，AI 越容易顾此失彼。
拿事实说话：不说”跑得不对”，要说”我双击运行后，浏览器打开登录页就没动了，黑窗口最后一行显示：等待元素超时（附截图）“。现象+报错原文，比任何形容词都有用。
改完就测：AI 说改好了，你立刻双击跑一遍验证，别攒一堆改动再测——出了问题分不清是哪次改坏的。

5.6 改造时的边界与禁忌#

✅ 可以让 AI 参考案例的结构、写法、套路；
❌ 不要让 AI 直接在成功案例文件夹里大改（先复制一份再改，原案例留底）；
❌ 账号密码不要出现在提示词正文和给 AI 的截图里，让 AI”留空位”，你自己填进 ini；
❌ 不要一开始就挑战最复杂的场景。正确路径：先跑通登录 → 再跑通一个下载 → 再加筛选条件 → 最后加钉钉通知。每通一步，让 AI 确认一步。

第 6 章用 TraeCode 调试：看懂报错、把报错喂回给 AI#

TraeCode 是你的”检修台”。你依然不写代码，但要会用它的四个基本功能。

6.1 四个基本动作#

打开项目：TraeCode → 文件 → 打开文件夹 → 选案例文件夹。左侧出现文件树。
看文件：双击任何文件打开。.ini、.md、.txt 都能直接看；.py 看不懂没关系，要用的是下一步。
改文件：直接编辑保存（改 ini 主要用这个）。
运行：菜单”终端”→“新建终端”，输入 python 主程序文件名.py 回车；或直接在文件管理器双击 .bat。报错信息会显示在下方终端里，不会一闪而过——这是 TraeCode 比双击 bat 好用的地方。

6.2 报错三看（不用懂代码也能定位问题）#

终端里一片红字时，只看三处：

看什么	例子	通常意味着
最后一行	`TimeoutError: 等待元素超时`	问题的一句话结论
文件名+行号	`文件 "模块_登录.py"，第 45 行`	在哪个零件出的事
关键词	`No such file`（找不到文件）/ `Connection`（网络）/ `Permission`（权限）	大方向

然后把这三样原封不动复制给 AI（提示词模板③），加一句”请直接帮我修好”。 你的任务只是”搬运工”，诊断和修理是 AI 的事。

6.3 新手常见的三个”假故障”#

现象	真相	解决
双击 bat 黑窗口一闪就没了	程序可能秒退（配置错了），报错没看清	改用 TraeCode 终端运行，或问 AI”让窗口停住”
提示 `python 不是内部或外部命令`	装 Python 没勾 Add to PATH	让 AI 帮你修环境变量（模板①照发）
改了 ini 不生效	文件保存成了别的编码/后缀（如 ini.txt）	问 AI：“帮我检查配置文件编码和后缀”，用 TraeCode 改别用记事本另存

第 7 章接入钉钉：机器人通知 + AI 表格自动流#

钉钉是成果输出平台：脚本跑完没跑成、报表在哪，自动推到群里，同事直接看。所有成功案例都内置了钉钉通知能力，你只需要”喂给它一个机器人地址”。

7.1 第一步：建群机器人，拿到 Webhook 地址#

打开你要接收通知的钉钉群 → 群设置 → 机器人 → 添加机器人 → 选 自定义（通过 Webhook 接入）；
名字随便取（如”报表小助手”），安全设置建议勾”自定义关键词”，填一个词如 报表；
完成后会给你一个 Webhook 地址（`http（本机路径）长这样）——复制保存，这就是机器人的”门牌号”。

7.2 第二步：把地址填进项目配置#

所有案例的 ini 里都有这一段：

1
[机器人配置]
2
报送机器人 = http（本机路径）
3
信息格式 = JSON

把 Webhook 粘贴进去保存即可。注意：若你的机器人设了关键词，让 AI 确保通知文案里包含该关键词（比如都带”报表”二字），否则消息会被钉钉拒收。改完可以让 AI 发条测试消息验证：

📋 提示词模板 ⑦：测试钉钉通知

1
我已把钉钉机器人的 Webhook 地址填进配置文件（关键词是"报表"）。
2
请帮我：1、检查配置格式对不对；2、发送一条测试消息到这个机器人；
3
3、如果群里没收到，帮我按"关键词/网络/地址"三个方向排查。

7.3 第三步：WorkBuddy 连接钉钉（MCP 连接器）#

这一步让 WorkBuddy 本身能直接操作钉钉（发消息、读写 AI 表格、查审批……），是”AI 表格自动流”的基础：

WorkBuddy → 设置/连接器 → 找到钉钉 → 点击连接；
弹出钉钉授权页面 → 用公司账号登录 → 点同意授权；
回到 WorkBuddy 显示”已连接”即可。

连上之后你就可以说人话直接指挥，例如：

“帮我把（本机路径）里的数据整理成摘要，发到’运营数据群’。” “把今天三个下载任务的结果汇总成一张表，写进钉钉 AI 表格《每日报数看板》。”

7.4 AI 表格自动流：让结果沉淀成看板#

思路：脚本负责”产出文件”，WorkBuddy+钉钉 AI 表格负责”汇总展示”。典型玩法：

在钉钉里建一张 AI 表格（如《每日报数看板》），列头设好：日期、任务名、状态、文件链接；
让 WorkBuddy 记住这套格式，之后每次跑完脚本说一句”按老规矩把今天的运行结果写进看板”。

配套提示词：

📋 提示词模板 ⑧：结果自动入表

1
我有一个"BI任务模块化"项目，每天自动下载多张报表到共享盘，
2
并在ini里留有运行日志。请你帮我建立一条固定流程：
3
每次我发送"今日汇总"四个字时，你自动：
4
1、读取今天的运行日志和下载结果；
5
2、整理成四列：日期、任务名称、成功/失败、文件位置；
6
3、通过钉钉连接器写进 AI 表格《每日报数看板》；
7
4、有失败任务时，在群里额外@我并附报错摘要。

第 8 章定时自动运行（Windows 任务计划程序）#

傻瓜版三步，让脚本每天自己跑，你只负责看钉钉汇报。

准备：先把脚本里的 无头模式 改为 true（后台运行不弹浏览器窗口，各案例的 ini 里都有这项）。

操作：

Win 键搜”任务计划程序”打开 → 右侧点”创建基本任务”；
向导里依次填：
- 名称：如”每天下载库存报表”；
- 触发器：每天 → 设时间（如 08<30>）；
- 操作：启动程序 → 浏览选中案例的 .bat 文件；
完成后在任务列表里右键 → 运行，试跑一次，去输出目录和钉钉群确认成功。

偷懒替代方案：直接对 WorkBuddy 说”帮我创建一个自动化任务：每个工作日早上 8 点半运行（本机路径），并把结果发到钉钉”，用 WorkBuddy 自带的定时自动化能力托管，连任务计划程序都不用碰。

第 9 章日常运行与维护#

9.1 每天的动作#

时点	你做什么	花多久
早上	看钉钉群通知：昨日任务全部 ✅ → 收工；有 ❌ → 进入排障	1 分钟
要改需求	改 ini 配置（换路径/加任务/换账号），或找 AI 改脚本	视情况
每周	瞄一眼输出文件夹，确认文件在正常新增	1 分钟

9.2 出问题时的标准排障流程#

1
看钉钉通知/启动错误日志.txt 里的报错
2
    ↓ 原封不动复制报错
3
发给 AI（提示词模板③）："帮我修好，修完告诉我怎么验证"
4
    ↓ AI 修复
5
双击 bat / TraeCode 运行验证
6
    ↓ 成功
7
结束（把这次的报错和修法记下来，下次秒懂）

原则：报错不过夜、修复必验证、现象说清楚。

9.3 改配置的四条军规#

改前先备份：复制一份 ini 改名为 配置_备份_日期.ini，改砸了好回滚；
只改等号右边，左边字段名和 [中括号] 节名不要动；
用 TraeCode 或 VS Code 改，别用 Word/WPS（会破坏格式）；保存编码选 UTF-8；
一次只改一处，改完立刻试跑。

9.4 让 AI 改脚本后的验证流程#

AI 说改好 → 问它”这次改动会影响哪些功能？”；
双击运行一次完整流程；
核对三样：输出文件新增了没？文件内容对不对？钉钉通知到了没？
三样都 OK，这次改动才算落地。

附录 A：提示词速查卡（10 条即抄即用）#

#	场景	提示词（直接复制改内容）
1	环境部署	见正文模板①
2	案例导读	见正文模板②
3	报错求救	见正文模板③
4	改造新项目	见正文模板④
5	按步骤生成	见正文模板⑤
6	加下载任务	见正文模板⑥
7	测钉钉	见正文模板⑦
8	结果入表	见正文模板⑧
9	换账号/换路径	“帮我把XX项目的配置文件里登录账号改为××、密码改为××、保存路径改为××，改完告诉我怎么验证。”
10	加新功能	“在不动现有功能的前提下，给XX项目加一个功能：××。请先告诉我你的改动方案，我确认后再动手。”

两条通用技巧：① 让 AI”先给方案、确认再动手”，可以避免它大改一通；② 每做完一个新项目，让 AI 补一份《使用说明书.md》放进项目文件夹——文档就是未来的你最好的同事。

附录 B：常见报错对照表#

报错关键词（看最后一行）	大白话解释	你该做什么
`python 不是内部或外部命令`	Python 没装好或没加路径	发模板①让 AI 修
`No module named 'xxx'`	缺依赖库	发给 AI：“帮我安装缺失的库”
`浏览器可执行文件不存在`	ini 里的 Chrome 路径不对	查本机 Chrome 路径填进 ini
`Timeout 等待元素超时`	网页没出现该出现的按钮（网址变了/网络慢/元素失效）	截图+报错发 AI 排查
`登录失败`	账号密码错 / 需要验证码	先手动登录一次确认能登，再发 AI
`Permission denied`	没权限（目标文件夹只读/被占用）	关掉占用程序（如正开着的 Excel），重跑
`errcode:310000`（钉钉）	机器人拒收（关键词不符/地址失效）	核对通知文案含关键词、Webhook 是否最新
文件名乱码	ini 被存成错误编码	用 TraeCode 以 UTF-8 重新保存

附录 C：安全红线（必读）#

账号密码只放 ini，绝不写进提示词、截图、聊天记录；给 AI 看配置前先打码；
ini 文件绝不能外发（发同事前删掉账号密码段），更不能传到网上；
先在测试环境试：新脚本先拿测试账号/测试数据跑通，再上正式环境；
钉钉机器人 Webhook 等同于”谁有地址谁就能往群里发消息”，泄露了就去群里删掉机器人重建；
自动操作的是真实系统：定时任务上生产前，先用”启用=False / 执行任务留空”的方式试运行，确认行为符合预期再放开；
重要输出目录建议定期备份（报表文件虽可再生，共享盘路径变了要记得同步改 ini）。

教程完 · 遇到本教程没覆盖的问题，记住万能第一句：“我是零基础新手，请你用大白话帮我解决，并直接动手操作。”

Firefly 代码块示例

Sat, 12 Sep 2026 00:00:00 GMT

在这里，我们将探索如何使用 Expressive Code 展示代码块。提供的示例基于官方文档，您可以参考以获取更多详细信息。

表达性代码#

语法高亮#

语法高亮

常规语法高亮#

1
console.log('此代码有语法高亮!')

渲染 ANSI 转义序列#

Terminal window展开收起

1
Standard ANSI colors:
2
- Dimmed:      Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
3
- Foreground:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
4
- Background:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
5
- Reversed:    Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
6

7
8-bit colors (showing colors 160-171 as an example):
8
- Dimmed:      160  161  162  163  164  165  166  167  168  169  170  171 
9
- Foreground:  160  161  162  163  164  165  166  167  168  169  170  171 
10
- Background:  160  161  162  163  164  165  166  167  168  169  170  171 
11
- Reversed:    160  161  162  163  164  165  166  167  168  169  170  171 
12

13
24-bit colors (full RGB):
14
- Dimmed:      ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
15
- Foreground:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
16
- Background:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
17
- Reversed:    ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
18

19
Font styles:
20
- Default
21
- Bold
22
- Dimmed
23
- Italic
24
- Underline
25
- Reversed
26
- Strikethrough

展开收起

编辑器和终端框架#

编辑器和终端框架

代码编辑器框架#

my-test-file.js

1
console.log('标题属性示例')

src/content/index.html

1
<div>文件名注释示例</div>

终端框架#

Terminal window

1
echo "此终端框架没有标题"

PowerShell 终端示例

1
Write-Output "这个有标题!"

覆盖框架类型#

1
echo "看，没有框架!"

PowerShell Profile.ps1

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

标记整行和行范围#

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

选择行标记类型 (mark, ins, del)#

line-markers.js

1
function demo() {
2
  console.log('此行标记为已删除')
3
  // 此行和下一行标记为已插入
4
  console.log('这是第二个插入行')
5

6
  return '此行使用中性默认标记类型'
7
}

为行标记添加标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === 'string' ? <span>{children}</span> : children)}
12
</button>

在单独行上添加长标签#

labeled-line-markers.jsx展开收起

1
<button
2
  role="button"
3
  {...props}
4

5
  value={value}
6
  className={buttonClassName}
7

8
  disabled={disabled}
9
  active={active}
10
>
11

12
  {children &&
13
    !active &&
14
    (typeof children === 'string' ? <span>{children}</span> : children)}
15
</button>

展开收起

使用类似 diff 的语法#

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

结合语法高亮和类似 diff 的语法#

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

标记行内的单独文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

正则表达式#

1
console.log('单词 yes 和 yep 将被标记。')

转义正斜杠#

Terminal window

1
echo "Test" > /home/test.txt

选择内联标记类型 (mark, ins, del)#

1
function demo() {
2
  console.log('这些是插入和删除的标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

为每个块配置自动换行#

1
// 启用换行的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

配置换行的缩进#

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 直到块末尾的所有代码将再次被折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

展开收起

行号#

行号

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候!')
3
console.log('我在第3行')

// 此块禁用行号
console.log('你好?')
console.log('抱歉，你知道我在第几行吗?')

更改起始行号#

5
console.log('来自第5行的问候!')
6
console.log('我在第6行')

Tab 代码块#

由 rehype-code-group 提供，语法与 VitePress 代码组一致：用 ::: code-group labels=[...] 包裹多个代码块，即可合并成一组标签页。

Note

labels=[...] 中的标签按顺序对应组内的代码块，用英文逗号分隔；::: 与 code-group 之间的空格不能省略。

基本用法#

1
::: code-group labels=[code.js, code.py, code.html]
2

3
```js
4
export function greet(name) {
5
  return `Hello, ${name}!`;
6
}
7
```
8

9
```py
10
def greet(name):
11
    return f"Hello, {name}!"
12
```
13

14
```html
15
<p>Hello, world!</p>
16
```
17

18
:::

展开收起

渲染效果：

code.jscode.pycode.html

1
export function greet(name) {
2
  return `Hello, ${name}!`;
3
}

1
def greet(name):
2
    return f"Hello, {name}!"

1
<p>Hello, world!</p>

标签中使用 Emoji#

标签支持 emoji 短代码，构建时会自动转换成 emoji：

1
::: code-group labels=[:package: npm, :package: pnpm, :yarn: yarn]

📦 npm📦 pnpm🧶 yarn

Terminal window

1
npm create astro@latest

Terminal window

1
pnpm create astro@latest

Terminal window

1
yarn create astro

与其他代码块特性组合#

组内仍是普通的 Expressive Code 代码块，标题、行号、行标记、折叠、终端框架等特性都可以照常使用。

配置文件终端折叠

astro.config.mjs

1
export default {
2
  theme: "firefly",
3
  codeGroup: true,
4
};

部署

1
pnpm build && pnpm preview


3 collapsed lines
1
// 这三行默认折叠
2
import { a } from "a";
3
import { b } from "b";
4

5
console.log(a, b);

不止是代码块#

标签页内可以放任意内容，例如文字、列表或图片：

说明列表

这是一段普通的段落内容。

列表项一
列表项二

Tip

标签栏在构建期生成，默认展开第一项；支持鼠标点击与键盘 ← / → / Home / End 切换。

在提醒框内使用（MDX 组件）#

::: code-group 和 ::: tip 等 Docusaurus 风格提醒框都使用 ::: 容器语法，而 micromark-directive 规定父子容器的冒号数必须不同，因此 ::: code-group 无法嵌套在 ::: tip 等提醒框内（整块会失效）。

这种情况改用 MDX 组件 TabGroup：MDX 组件不经过 ::: 指令解析，在提醒框内外都能正常使用，也方便日后扩展更多 UI 组件。把文章后缀改为 .mdx，从统一入口 @/components/firefly-mdx 引入（可一次引入多个组件）：

1
import { TabGroup } from "@/components/firefly-mdx";
2

3
:::tip
4

5
<TabGroup labels={["test.js", "test.py"]} client:load>
6
  ```js
7
  console.log(1)
8
  ```
9

10
  ```py
11
  print("hello world")
12
  ```
13
</TabGroup>
14

15
:::

展开收起

Tip

labels 数组给每个代码块声明标签，顺序一一对应
组件用 client:load 激活标签切换

Firefly 文章加密

Sat, 12 Sep 2026 00:00:00 GMT

这是一篇密码保护的示例文章，用于演示文章加密功能。

Firefly 布局系统详解

Sat, 12 Sep 2026 00:00:00 GMT

📖 概述#

Firefly 提供了灵活的布局系统，允许您根据内容需求和个人喜好自定义博客的视觉呈现方式。布局系统主要包括侧边栏布局和文章列表布局两个维度，它们相互配合，共同决定了页面的整体结构。

本文将详细介绍 Firefly 的各种布局模式、它们的特点、使用场景，以及不同布局组合的效果。

左侧边栏+列表布局

右侧边栏+网格布局

左侧边栏+三列网格布局

双侧边栏+列表布局

双侧边栏+网格布局

双侧边栏+网格瀑布流布局

一、侧边栏布局系统#

侧边栏是博客页面的重要组成部分，用于展示导航、分类、标签、统计信息等辅助内容。Firefly 支持两种侧边栏布局模式。

1.1 单侧边栏模式#

左侧边栏 (position: “left”)#

左侧边栏布局

右侧边栏 (position: “right”)#

右侧边栏布局

特点#

侧边栏固定在页面其中一侧
文章阅读区域体验更佳，更宽敞
更加简约，没有那么紧凑

适用场景#

传统博客风格
强调导航和分类的博客
需要突出用户资料的个人博客
内容为主，辅助信息次之的场景

Tip

文章详情页显示哪几侧，由**各组件的 showOnPostPage（以及 hideOnNonPostPage）**决定：某一侧在当前页型下没有任何可见组件时，该列会自动收起，把空间让给内容栏。

如果想在文章页同时显示双侧边栏，把 position 设为 "both"，并给两侧组件配好 showOnPostPage 即可。

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
};

1.2 双侧边栏模式 (position: “both”)#

特点#

左右两侧同时存在侧边栏
主内容区域位于中间
最大化利用屏幕空间
可以展示更多辅助信息
适合宽屏显示器

布局结构#

双侧边栏+列表布局

双侧边栏+网格布局

适用场景#

宽屏桌面端浏览
信息密集型博客
需要展示大量辅助内容
专业性强的技术博客

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

二、文章列表布局系统#

文章列表是博客首页和归档页的核心内容，Firefly 提供两种展示方式，并支持多种网格配置。

2.1 列表模式 (defaultMode: “list”)#

特点#

单列纵向排列
显示文章封面图，可配置在左侧或右侧
展示更多文章摘要
适合深度阅读

列表布局结构#

列表模式布局

封面位置#

列表模式的封面图默认在卡片右侧，可以通过 coverPosition 改到左侧。改到左侧后，标题前的主题色竖线会自动隐藏（它是贴着卡片左边缘的设计），腾出的间距留给正文。

网格模式的封面固定在卡片顶部，不受这项配置影响。

优点#

✅ 视觉冲击力强，封面图吸引眼球
✅ 可以展示更多文章信息（摘要、标签等）
✅ 适合图片内容丰富的博客
✅ 移动端友好，单列更易阅读
✅ 兼容所有侧边栏配置（单侧、双侧）

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list",    // 列表模式
4
    coverPosition: "right", // 封面图位置："right" 右侧，"left" 左侧
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

特点#

自适应列数，根据浏览器宽度自动调整
紧凑布局，信息密度高
适合快速浏览

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

网格布局

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    grid: {
5
      masonry: true,      // 开启瀑布流
6
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
7
    },
8
  },
9
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

瀑布流布局

智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

三、布局组合指南#

Firefly 允许您自由组合侧边栏和文章列表布局。以下是各种组合的效果说明。

侧边栏模式	文章列表模式	推荐度	适用场景
单侧边栏	列表模式	⭐⭐⭐⭐⭐	摄影、设计、生活类博客，强调图片和沉浸感
单侧边栏	网格模式	⭐⭐⭐⭐⭐	技术、笔记类博客，平衡阅读与检索效率
双侧边栏	列表模式	⭐⭐⭐⭐⭐	需要展示大量侧边栏信息的站点
双侧边栏	网格模式	⭐⭐⭐⭐⭐	极客风格，追求最高信息密度

四、响应式布局行为#

Firefly 的布局系统具有智能的响应式设计，会根据屏幕尺寸自动调整。

为了保证最佳阅读体验，系统会在屏幕变窄时自动调整布局：

网格列数自动减少：网格模式的列数由 columnWidth 和容器宽度自动决定，屏幕越窄列数越少。
列表模式 -> 网格模式：当屏幕宽度小于 380px（超小屏设备）时，列表模式会自动切换为网格模式，以保证卡片内容的可读性。
双侧边栏 -> 单侧边栏：当屏幕宽度小于 1280px 时，会根据tabletSidebar配置显示单侧边栏，隐藏其中一个侧边栏，文章目录导航会切换成浮动目录导航。

五、常见问题#

Q1: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

六、总结#

Firefly 的布局系统给予了您更大的自由度，您都可以通过简单的配置实现。

我们建议您根据自己的内容类型和目标读者的设备偏好，尝试不同的组合，找到最适合您的博客形态。

Firefly Wiki Link 内部链接示例

Sat, 12 Sep 2026 00:00:00 GMT

Firefly 支持在 Markdown、MDX 文章中使用 Obsidian 风格的 Wiki Link 内部链接。链接目标填写文章的 slug 或文件路径，都不需要包含扩展名，具体匹配规则见下文「链接目标的三种写法」。

文章链接卡片#

[[slug]] 单独成段时，会自动读取目标文章的标题、描述、发布时间、分类、标签和封面，渲染为链接卡片：

1
[[firefly]]
2

3
[[guide/index]]
4

5
[[markdown-extended]]

Firefly 一款清新美观的 Astro 博客主题模板

Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。

2026-09-12博客指南#Markdown#Firefly#博客#主题#模板

Firefly 简单使用指南

如何使用 Firefly 博客模板。

2026-09-12博客指南#Firefly#博客#Markdown#指南

Markdown 扩展功能

了解 Firefly 中的 Markdown 功能

2026-09-12博客指南#演示#示例#Markdown#Firefly

行内链接#

[[slug]] 出现在正文中间时，渲染为普通链接，链接文字自动使用目标文章的标题

1
请参阅 [[firefly]] 了解主题特性。

请参阅 Firefly 一款清新美观的 Astro 博客主题模板了解主题特性。

自定义显示标题#

在 | 后填写链接的显示文字。行内链接会用它替换文章标题；单独成段时依然渲染为卡片，卡片标题使用自定义文字，描述、时间、分类、标签和封面仍然读取目标文章：

1
请参阅 [[firefly|主题介绍]] 了解主题特性。
2

3
[[firefly|Firefly 主题介绍]]

请参阅主题介绍了解主题特性。

Firefly 主题介绍

2026-09-12博客指南#Markdown#Firefly#博客#主题#模板

一个例外：如果 | 后的文字只是把链接目标又抄了一遍（[[guide/index|index]]），会被当作无效别名忽略，仍然显示文章标题。Obsidian 在插入的链接时会自动补上这样的别名，避免笔记里显示一长串路径，这个例外就是为它准备的。

链接目标的三种写法#

用 Obsidian 管理文章时，把 src/content/posts 目录本身作为 Obsidian 仓库（vault）打开。下文提到的「仓库根目录」都指这个目录，它正好也是 Firefly 解析链接路径的起点。

链接目标按以下顺序匹配：

写法	示例	在 Obsidian 中
frontmatter 的 `slug`	`[[firefly-wiki-link]]`	✗ 不支持
文件路径（相对仓库根目录）	`[[guide/firefly-layout-system]]`	✓ 需改设置（推荐）
裸文件名（仓库内唯一时）	`[[firefly-layout-system]]`	✓ 默认即是

第一种：slug#

slug 写法在 Obsidian 中不支持，slug 是 Firefly 自己的概念，Obsidian 不读取 frontmatter 里的 slug，所以按 slug 写的链接在 Obsidian 里既不会自动补全，也点不动，只有构建出的站点上能正常跳转。如果你主要在 Obsidian 里写作，用下面两种写法。

第二种：文件路径（推荐）#

文件路径写法需要改 Obsidian 设置，在 设置 → 文件与链接 → 链接 → 内部链接类型 中选择基于仓库根目录的绝对路径，Obsidian 插入的链接才会带上目录：

1
[[guide/firefly-layout-system|firefly-layout-system]]

Firefly 布局系统详解

深入了解 Firefly 的布局系统，包括侧边栏布局（左侧/双侧）和文章列表布局（列表/网格），以及自适应网格列数。

2026-09-12博客指南#Firefly#布局#博客#指南

因为仓库根目录就是 src/content/posts，Obsidian 写出的这个路径和 Firefly 需要的路径完全一致，不需要任何额外转换。

上面这行末尾的 |firefly-layout-system 是 Obsidian 自动补的别名，Firefly 会忽略它，卡片标题仍然取文章的 title，除非你把它修改和文件名不一致，才会变成你修改后的别名。

内部链接类型下拉框里的基于当前笔记的相对路径只在同目录内可用：它给同目录文章生成的是裸文件名，能正常匹配；但跨目录时会生成 ../ 前缀，Firefly 无法解析，链接会按原文显示。

第三种：裸文件名#

「内部链接类型」的默认值就是尽可能简短的形式：只要文件名在整个仓库里唯一，Obsidian 插入的链接就只有文件名，不带目录。这种写法不需要改任何设置，效果和写完整路径完全一致：

1
[[firefly-layout-system]]

Firefly 布局系统详解

深入了解 Firefly 的布局系统，包括侧边栏布局（左侧/双侧）和文章列表布局（列表/网格），以及自适应网格列数。

2026-09-12博客指南#Firefly#布局#博客#指南

文件名重名时这种写法会失效，构建日志里会给出提示，改用完整文件路径即可，所以推荐直接修改 Obsidian 内部链接类型设置为基于仓库根目录的绝对路径，使用第二种文件路径写法，一劳永逸

链接到其他文章的标题#

在文章 slug 后添加 #标题。带标题锚点的链接始终渲染为普通链接：

查看代码块语法高亮

Firefly 布局系统详解#相关链接

1
[[code-examples#语法高亮|查看代码块语法高亮]]
2

3
[[guide/firefly-layout-system#相关链接|firefly-layout-system]]

标题锚点使用与页面标题相同的 slug 规则，因此中文、空格和大小写都会按页面实际生成的 ID 处理。

链接到本页标题#

省略文章 slug，只填写标题即可链接到当前文章：

跳转到本页目标

1
[[#本页目标|跳转到本页目标]]

本页目标#

这是本页 Wiki Link 指向的标题。

不支持附件嵌入#

附件嵌入语法目前不会被转换，会按原文显示：

![[image.png]]

行内代码和代码块中的 [[firefly]] 也不会被转换。

KaTeX 数学公式示例

Sat, 12 Sep 2026 00:00:00 GMT

本文展示了 Firefly 主题对 KaTeX 数学公式的渲染支持。

行内公式 (Inline)#

行内公式使用单个 $ 符号包裹。

例如：欧拉公式 eiπ+1=0e^{i\pi} + 1 = 0eiπ+1=0 是数学中最优美的公式之一。

质能方程 E=mc2E = mc^2E=mc2 也是家喻户晓。

块级公式 (Block)#

块级公式使用两个 $$ 符号包裹，会居中显示。

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=πx=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}x=2a−b±b2−4ac

复杂示例#

矩阵 (Matrices)#

(abcd)(αβγδ)=(aα+bγaβ+bδcα+dγcβ+dδ)\begin{pmatrix} a & b \\ c & d \end{pmatrix} \begin{pmatrix} \alpha & \beta \\ \gamma & \delta \end{pmatrix} = \begin{pmatrix} a\alpha + b\gamma & a\beta + b\delta \\ c\alpha + d\gamma & c\beta + d\delta \end{pmatrix}(acbd)(αγβδ)=(aα+bγcα+dγaβ+bδcβ+dδ)

极限与求和 (Limits and Sums)#

∑n=1∞1n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}n=1∑∞n21=6π2lim⁡x→0sin⁡xx=1\lim_{x \to 0} \frac{\sin x}{x} = 1x→0limxsinx=1

麦克斯韦方程组 (Maxwell’s Equations)#

∇⋅E=ρε0∇⋅B=0∇×E=−∂B∂t∇×B=μ0J+μ0ε0∂E∂t\begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \\ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\ \nabla \times \mathbf{B} &= \mu_0\mathbf{J} + \mu_0\varepsilon_0\frac{\partial \mathbf{E}}{\partial t} \end{aligned}∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E

化学方程式 (Chemical Equations)#

\ceCH4+2O2−>CO2+2H2O\ce{CH4 + 2O2 -> CO2 + 2H2O}\ceCH4+2O2−>CO2+2H2O

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

Markdown 扩展功能

Sat, 12 Sep 2026 00:00:00 GMT

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，在页面加载时，仓库信息会从 GitHub API 获取。

CuteLeaf

Firefly

🍀Firefly, fresh and aesthetic Astro blog theme template.

—

MIT

Astro

使用代码 ::github{repo="CuteLeaf/Firefly"} 创建 GitHub 仓库卡片。

1
::github{repo="CuteLeaf/Firefly"}

提醒框(Admonitions)配置#

Firefly 采用了 rehype-callouts 插件，支持了四种风格的提醒框主题：GitHub、Obsidian、VitePress 和 Docusaurus。您可以在 src/config/siteConfig.ts 中进行配置：

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // 选项: "github" | "obsidian" | "vitepress" | "docusaurus"
5
    theme: "github",
6
  },
7
  // ...
8
};

注意：更改配置后需要重启开发服务器才能生效。

以下是各个主题支持的类型列表，每个主题风格和语法不同，可根据喜好选择。

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

GitHub

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

展开收起

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

点击展开 Obsidian 语法列表

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。

展开收起

Obsidian

3. VitePress 主题风格#

VitePress 风格提供了一套现代化的、扁平的默认样式。目前仅包含与 GitHub 一致的 5 种 基础类型。

点击展开 VitePress 语法列表

1
> [!NOTE] NOTE
2
> 对应 GitHub 的 Note。
3

4
> [!TIP] TIP
5
> 对应 GitHub 的 Tip。
6

7
> [!IMPORTANT] IMPORTANT
8
> 对应 GitHub 的 Important。
9

10
> [!WARNING] WARNING
11
> 对应 GitHub 的 Warning。
12

13
> [!CAUTION] CAUTION
14
> 对应 GitHub 的 Caution。
15

16
> [!TIP] 自定义标题
17
> VitePress 风格同样支持自定义标题。

展开收起

VitePress

4. Docusaurus 主题风格#

Docusaurus 风格提供了一套现代化的提醒框样式，支持 5 种类型。

点击展开 Docusaurus 语法列表

支持以下类型的提醒框：note tip info warning danger

1
:::note
2
突出显示用户应该考虑的信息，即使在快速浏览时也是如此。
3
:::
4

5
:::tip
6
可选信息，帮助用户更成功。
7
:::
8

9
:::info
10
一般信息。
11
:::
12

13
:::warning
14
由于潜在风险需要用户立即注意的关键内容。
15
:::
16

17
:::danger
18
行动的负面潜在后果。
19
:::
20

21
:::tip[自定义标题]
22
可选信息，帮助用户更成功。
23
:::

展开收起

Docusaurus

剧透#

您可以为文本添加剧透。文本也支持 Markdown 语法。

内容被隐藏了哈哈！

1
内容 :spoiler[被隐藏了 **哈哈**]！

图片画廊网格 (Image Grid)#

您可以使用 [grid] 和 [/grid] 标签将多张图片纵向并排展示。这对于展示照片画廊或对比图非常有用。系统会自动根据包裹在其中的图片数量（最多支持并排展示4张）以响应式网格进行布局。

自动补齐图片高度： 同一排中如果有高度、大小或者比例不一的图片，会像「九宫格画廊相册」一样自动撑满。较短或不协调的图片会自动使用 object-cover 进行完美中心裁剪补充视野。图片边框水平彻底对齐无缝隙，但被裁剪后，只有点击图片通过灯箱才能查看完整图片，所以建议尽量避免使用长宽比例不一致的图片在同一排中。

图注恒定底端对齐： 不论上面的图片长宽如何变化，在同一行的所有图像解释文字（图注）都会对标到一条完美的水平基线上了。

示例图片一

示例图片二

基本语法

1
[grid]
2
![示例图片一](./images/firefly1.avif)
3
![示例图片二](./images/firefly2.avif)
4
![示例图片二](./images/firefly3.avif)
5
[/grid]

Markdown Mermaid 图表

Sat, 12 Sep 2026 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、ER 图、类图、状态图、XY 图、甘特图、思维导图等。

Mermaid 图表由 Merman 实现。Firefly 在 Astro 构建阶段生成亮色和深色两套静态 SVG，无需在浏览器中加载 Mermaid 渲染运行时。可以前往 Merman Playground 实时编辑语法并预览渲染结果。

流程图示例#

流程图非常适合表示流程或算法步骤。

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

时序图示例#

时序图显示对象之间随时间的交互。

数据库服务器网页应用用户数据库服务器网页应用用户alt[认证成功][认证失败]提交登录请求发送认证请求查询用户凭据返回用户数据返回认证结果显示欢迎页面请求用户数据获取用户偏好返回偏好设置返回用户数据加载个性化界面显示错误消息提示重新输入

ER 图示例#

ER 图（实体关系图）非常适合表示数据库结构。

writes

posts

has

belongs to

USER

int

string

username

string

datetime

created_at

ARTICLE

int

string

title

text

content

datetime

published

int

author_id

COMMENT

int

text

content

datetime

created_at

int

user_id

int

article_id

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

写作

发表

拥有

属于

User

+String username

+String password

+String email

+Boolean active

+login()

+logout()

+updateProfile()

Article

+String title

+String content

+Date publishDate

+Boolean published

+publish()

+edit()

+delete()

Comment

+String content

+Date commentDate

+addComment()

+deleteComment()

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

XY 图示例#

XY 图表非常适合展示趋势和对比数据。

月度访问量趋势1月2月3月4月5月6月5000450040003500300025002000150010005000访问量

饼图示例#

饼图适合直观展示各部分在整体中的占比。

45%30%15%10%内容类型占比技术文章 [45]项目记录 [30]生活随笔 [15]其他 [10]

甘特图示例#

甘特图可以按时间轴展示项目阶段、任务依赖和当前进度。

07/0107/0307/0507/0707/0907/1107/1307/1507/17需求整理视觉设计功能实现内容迁移构建检查正式上线准备开发发布博客版本发布计划

思维导图示例#

思维导图适合梳理主题层级和知识结构。

Firefly

内容

技术文章

生活记录

体验

搜索

深色模式

图表

工程

Astro

Svelte

Merman

Firefly

内容

技术文章

生活记录

体验

搜索

深色模式

图表

工程

Astro

Svelte

Merman

时间线示例#

时间线用于按年份或阶段呈现项目的重要事件。

2024建立博客完成基础主题2025加入搜索与图库完善内容系统2026升级 Astro 7使用 Merman 渲染图表Firefly 演进时间线

用户旅程图示例#

用户旅程图能够描述用户在不同阶段的行为和体验评分。

读者

发现内容

发现内容读者

打开首页

打开首页读者

搜索主题

阅读文章

阅读文章读者

浏览正文

浏览正文读者

查看图表

继续探索

继续探索读者

查看相关文章

查看相关文章读者

分享文章

分享文章读者浏览文章的旅程

读者

发现内容

发现内容读者

打开首页

打开首页读者

搜索主题

阅读文章

阅读文章读者

浏览正文

浏览正文读者

查看图表

继续探索

继续探索读者

查看相关文章

查看相关文章读者

分享文章

分享文章读者浏览文章的旅程

Git 图示例#

Git 图可以清晰展示分支、提交和合并历史。

mainfeatureinitadd-diagramspolish-themesmerge-featurerelease

看板示例#

看板适合展示任务在不同工作阶段之间的分布。

待办

进行中

已完成

整理需求

准备示例

接入 Merman

服务端渲染

亮暗主题

待办

进行中

已完成

整理需求

准备示例

接入 Merman

服务端渲染

亮暗主题

Sankey 图示例#

Sankey 图通过连线宽度展示流量在不同节点之间的流向。

Home 1650Post list 1200Search 450Post detail 1220Related posts 260External shares 180

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了流程图、时序图、ER 图、类图、状态图、XY 图、饼图、甘特图、思维导图、时间线、用户旅程图、Git 图、看板和 Sankey 图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。图表会在构建时自动渲染为 SVG，无需客户端 JavaScript 加载。

可以前往 Merman Playground 尝试更多语法，再将图表代码粘贴到文章中。

Markdown PlantUML 图表

Sat, 12 Sep 2026 00:00:00 GMT

Markdown 中 PlantUML 图表指南#

PlantUML 是一种使用纯文本描述图表的工具。你只需要写一段结构化语法，就可以生成时序图、类图、用例图、活动图等常见工程图。

它特别适合写在技术博客和项目文档里：

图表和正文一起版本管理，便于协作与审阅
修改图只需要改文本，适合频繁迭代
能和 Markdown 无缝结合，保持文档统一

在 Firefly 中，plantuml 代码块会在构建阶段编码并生成服务器 SVG 地址，页面端再根据亮暗主题自动切换图源，并支持缩放、拖拽和全屏交互。

如果你想快速上手，可以记住这个最小模板：

活动图示例#

状态图示例#

用例图示例#

组件图示例#

部署图示例#

ER 图示例#

时序图示例（登录与刷新令牌）#

C4 风格容器图示例#

Markdown 教程

Sat, 12 Sep 2026 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

MDX 格式博客指南

Sat, 12 Sep 2026 00:00:00 GMT

Tip

Firefly 支持 MDX 和 Markdown 两种类型的文章，你可以在文章中混合使用两种格式，如果没有特别复杂内容和需求，推荐使用 Markdown 格式就够了。

Markdown 和 MDX 的区别#

Markdown (MD) 是一种轻量级标记语言，允许用户使用纯文本格式编写文档，然后将其转换为格式化的HTML。它因其简洁易用的语法而广受欢迎，特别适合编写文档和博客文章。
MDX 是一种扩展了 Markdown 语法的格式，允许在 Markdown 文档中无缝地插入 JSX 代码。通过 MDX，用户可以在文档中嵌入 React 组件，从而实现更丰富的交互性和动态性。

特性	Markdown	MDX
基础语法	支持 (CommonMark)	支持 (CommonMark)
HTML 标签	支持	支持 (作为 JSX)
组件导入	不支持	支持 (import)
动态数据	不支持	支持 (JS 表达式)
样式定制	有限 (class/style)	灵活 (className/CSS-in-JS)

Firefly 内置的专属 MDX UI 组件#

这里列出 Firefly 内置的 MDX UI 组件，方便在 MDX 文章中直接使用。

Tab分组：`TabGroup`#

用于创建可切换的标签页，方便在文章中展示不同语言或不同版本的代码等等。

1
<TabGroup labels={["test.js", "test.py"]} client:load>
2
  ```js
3
  console.log(1)
4
  ```
5

6
  ```py
7
  print("hello world")
8
  ```
9
</TabGroup>

test.jstest.py

1
console.log(1)

1
print("hello world")

时间线：`Timeline` / `TimelineItem`#

属性	必填	说明
`date`	否	时间标签，如 “2024-03-10”
`title`	否	条目标题
`type`	否	节点颜色，default 为主题色，其余对应提示框色板（tip / note / important / warning / caution）
`icon`	否	内置图标名，显示在圆点内：star / rocket / git / flag / book / heart / zap / bug / tag / calendar / code / edit
正文	否	`<TimelineItem>` 标签内的内容，支持 Markdown

1
<Timeline>
2
  <TimelineItem date="2026-08-16" title="新版本发布" icon="rocket">
3
    发布了全新版本，带来以下更新：
4

5
    - 新增时间线组件
6
    - 改进暗色主题
7

8
    正文里支持 **Markdown** 内容。
9
  </TimelineItem>
10
  <TimelineItem date="2025-11-02" title="站点上线" type="tip" icon="flag">
11
    欢迎来到我的博客。
12
  </TimelineItem>
13
  <TimelineItem date="2025-06-15" title="项目立项" type="note">
14
    开始规划 Firefly 主题。
15
  </TimelineItem>
16
</Timeline>

展开收起

2026-08-16
新版本发布
发布了全新版本，带来以下更新：
- 新增时间线组件
- 改进暗色主题
正文里支持 Markdown 内容。
2025-11-02
站点上线
欢迎来到我的博客。
2025-06-15
项目立项
开始规划 Firefly 主题。

步骤条：`Steps` / `StepItem`#

编号步骤条，适合教程、部署流程。编号自动生成，无需手动传序号。

属性	必填	说明
`title`	否	步骤标题
`type`	否	编号圆颜色，default 为主题色，其余对应提示框色板（tip / note / important / warning / caution）
`icon`	否	内置图标名，有图标时显示图标而非数字（star / rocket / git / flag / book / heart / zap / bug / tag / calendar / code / edit）
正文	否	`<StepItem>` 标签内的内容，支持 Markdown

1
<Steps>
2
  <StepItem title="安装依赖">
3
    运行 `pnpm install`。
4
  </StepItem>
5
  <StepItem title="启动开发服务器" type="tip" icon="rocket">
6
    运行 `pnpm dev`，打开 `localhost:4321`。
7
  </StepItem>
8
  <StepItem title="编写文章">
9
    在 `src/content/posts/` 新建 `.mdx` 文章。
10
  </StepItem>
11
</Steps>

安装依赖
运行 pnpm install。
启动开发服务器
运行 pnpm dev，打开 localhost:4321。
编写文章
在 src/content/posts/ 新建 .mdx 文章。

徽章：`Badge`#

内联彩色小徽章，可嵌在段落或标题里。

属性	必填	说明
`type`	否	default 为主题色，其余对应提示框色板（tip / note / important / warning / caution）

1
<Badge type="tip">提示</Badge> <Badge type="warning">注意</Badge>

新功能提示笔记重要注意危险

更多信息，请查看 MDX 文档

在文章中嵌入视频

Sat, 12 Sep 2026 00:00:00 GMT

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

1
---
2
title: 在文章中嵌入视频
3
published: 2023-10-19
4
// ...
5
---
6

7
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

YouTube#

Bilibili#

钉钉 × 本地电脑：一句话指令的自动执行方案

Fri, 11 Sep 2026 00:00:00 GMT

上一篇《AI 协同钉钉办公：本地脚本 + 群机器人的自动化实践》讲了具体落地案例；这一篇是它的续作，把整套「钉钉下指令、电脑自动干活、结果送回钉钉」的联动方案完整讲清楚——写给非技术同事也能看懂。

参与系统

15+

专业任务程序

53 秒

首棒响应窗口

30 分钟

结果留底备查

01 一页看懂：一句话指令的完整旅程#

整个体系分三块，中间靠一条加密消息热线连起来——指令向右流动，结果向左送回：

本地

云端

钉钉侧

加密热线下发指令

MQTT · TLS 加密

结果回传

MQTT · TLS 加密

钉钉自动流
定时触发 / 手动一句话

结果推回钉钉
通知用户

云端对接程序
传令兵 + 站岗哨兵
首棒等 53 秒 · 换岗接力

本地调度中心
大管家

任务程序群
15+ 个专业任务

本地

云端

钉钉侧

加密热线下发指令

MQTT · TLS 加密

结果回传

MQTT · TLS 加密

钉钉自动流
定时触发 / 手动一句话

结果推回钉钉
通知用户

云端对接程序
传令兵 + 站岗哨兵
首棒等 53 秒 · 换岗接力

本地调度中心
大管家

任务程序群
15+ 个专业任务

02 为什么要做：解决三个麻烦#

现在的麻烦	方案带来的改变
时间被绑住：报表要在固定时间跑，人不在电脑前，任务就停摆	定时自动执行：钉钉自动流到点触发，无需任何人值守
操作重复繁琐：登录系统、下载、导出、汇总，一套动作天天重复	一句话指挥：记住几个关键词，就能调度整套流程，多步连跑
人不在公司：系统和数据都在公司内网，人在家里够不着	远程可达：人在哪里，钉钉就在哪里

本质就一句话：把「人必须到电脑前操作」变成「钉钉下指令，电脑自己干」。

03 角色分工：谁负责什么#

一次完整联动里，四个环节各司其职，本地调度中心居中统筹——它是唯一「什么都懂」的角色：

🛰️发令者

钉钉自动流

定时触发到点自动下指令；手动触发就是在钉钉里发一句话。人在哪里，指令就从哪里出发。

📡传令兵 + 哨兵

云端对接程序

首棒送指令、原地等 53 秒回音；长任务由接力棒换岗接着等，保证结果必达。

🤖干活的工人

任务程序群

15+ 个专业任务各干各的；组合任务把多道工序连成流水线，一条指令全搞定。

🧭大管家 · 关键枢纽

本地调度中心

翻译指令、安排节奏、看护全程——唯一「什么都懂」的角色，整个方案的心脏。

四者的协作关系（指令与结果的完整闭环）：

指令

MQTT 热线

安排干活

结果

本地调度中心
翻译指令 · 排队调度 · 超时看护

钉钉自动流

云端对接程序

任务程序群

指令

MQTT 热线

安排干活

结果

本地调度中心
翻译指令 · 排队调度 · 超时看护

钉钉自动流

云端对接程序

任务程序群

04 怎么运行：六步走完一次完整执行#

任务程序调度中心云端程序钉钉自动流任务程序调度中心云端程序钉钉自动流到点触发 / 手动一句话1加密热线送出指令（原地站岗监听）2回复「收到」3找到对应任务程序4下载 / 导出 / 跑机器人（多步排队连跑）5结果回传6结果送回（长任务换岗接力）7结果推回钉钉，通知用户8

六步的文字版速览：

1
触发
钉钉自动流到点自动触发，或手动在钉钉里发一句话。
2
下发
云端程序通过加密热线把指令送到本地，原地站岗监听。
3
确认
调度中心回复「收到」——指令被成功接住。
4
执行
调度中心找到对应任务程序安排干活，多步任务排队连跑。
5
回传
任务结果送回调度中心，由它统一回传云端。
6
闭环
结果推回钉钉，通知用户——全程无需任何人守在电脑前。

05 关键点：调度中心是整个方案的心脏#

云端只管传话，任务程序只管干活——中间所有的秩序，都由这位「大管家」维持：

翻译官：把「关键词」翻译成「电脑动作」。收到 AQ001 → 启动 BI 月计划下载程序。新增任务只需在配置表加一行，不用改代码——指令词、程序路径、开关全在一张配置表里
大管家：安排干活节奏。组合任务按顺序逐个执行（排队调度）；单个任务最多 900 秒，到点即报（超时看护）；每份结果保留 30 分钟备查
保安：防重复、防冲突，正在执行的任务绝不被打断

06 指挥手册：一句话能指挥哪些活#

以下为常用任务节选，每条指令对应配置表里的一行设置：

指令关键词	任务名	它帮你干什么	需要解锁屏幕
AQ001	BI 月计划下载	自动登录 BI 系统，下载月度营销计划表	否
AQ002	运营决策平台导出	自动导出运营决策平台的数据报表	否
AQ003	CRM 销售合同导出	从 CRM 系统导出销售合同清单	否
AQ_BATCH1	月度数据全量更新	AQ001→002→003 三步连跑，一条指令全搞定	否
ZHSAPXL	SAP 销量导出	调度 RPA 机器人登录 SAP，导出销量数据	是
AQ101	每日自动签到打卡	WorkBuddy 每日签到	否
配置更新	远程改配置	不到电脑前，远程更新任务配置	—

07 关键要点 ①：接力棒突破「60 秒魔咒」#

硬约束：钉钉规定云端程序单次最多运行 60 秒，而本地任务（比如 RPA 导 SAP 数据）常常一跑几分钟——哨兵还没等到结果就被迫下岗，结果悬在半空。

解法：像接力赛一样换岗。

钉钉接力棒 N本地电脑首棒哨兵钉钉接力棒 N本地电脑首棒哨兵接力棒 1 → 2 → N 无限传直到结果到手才收工送出指令，原地等 53 秒到点交接判断换岗（带同一张工单号）重新上线，接着等 50 秒任务完成，结果送达结果推回用户，闭环完成

换岗那几秒会不会漏掉结果？不会。 本地把每份已推送的结果留底 30 分钟，换岗空窗期由「补问重发」机制兜底。

08 关键要点 ②：三重保险 + 一条安全底线#

🎟️不串台

唯一工单号

每条指令自带唯一工单号，云端哨兵只认工单号完全一致的消息——多人同时下指令，各收各的结果，像取快递必须核对取件码。

💾不丢失

留底 30 分钟

结果在本地留底 30 分钟，换岗空窗期由「补问重发」兜底——哨兵晚了一步也照样拿到结果，长任务的回报不落空。

🚫不打断

单实例保护

调度中心能识别「管家正在干活」，新启动的实例自动让位退出——正在执行的任务绝不被强杀中断。

安全底线：消息全程 TLS 加密传输；云端与本地各用独立账号；指令、结果双通道分离。

09 总结：记住这五件事#

一句话指挥：在钉钉里发关键词，办公室电脑自动干活，结果自动推回钉钉
调度中心是心脏：翻译指令、排队调度、超时看护、防重复——所有秩序都靠它维持
两条加密专线：指令走 004_A、结果走 004_B，经公共消息热线中转，全程加密不落地
接力棒破 60 秒：云端哨兵一棒接一棒无限换岗，长任务也能稳稳等到结果
三重保险：工单号防串台、留底防丢失、单实例防打断，全程自动生效

人只负责两件事：下指令、看结果。其余的一切，交给这套自动体系。

附：本文配套演示文稿#

📂

钉钉本地联动方案.pptx

PPTX · 71 KB · 原版演示文稿，可下载留存

下载 ⤓

AI 协同钉钉办公：本地脚本 + 群机器人的自动化实践

Thu, 10 Sep 2026 00:00:00 GMT

全景：这套自动化长什么样#

三个报表脚本 + 一个调度程序 + 钉钉群机器人，串成一条完整的自动化链路：

下发指令

Webhook 推送

钉钉自动流
定时 / 手动触发

本地调度程序

CRM 报表导出

BI 报表导出

运营决策导出

运行日志 + 导出文件

钉钉群机器人
结果回传到群

下发指令

Webhook 推送

钉钉自动流
定时 / 手动触发

本地调度程序

CRM 报表导出

BI 报表导出

运营决策导出

运行日志 + 导出文件

钉钉群机器人
结果回传到群

报表任务全自动

调度程序统筹

24h

全天候在线

人工干预

一、自动化导出报表#

三个系统共用同一套脚本骨架，只是”进哪个门、导哪张表”不同：

启动脚本

到点自动运行

打开浏览器

定位目标系统

登录账号

凭证脚本托管

进入页面

筛选条件已预设

执行导出

文件落盘 + 日志推送

1. CRM 自动导出销售合同#

脚本步骤：打开浏览器 → 打开 CRM 登录链接 → 登录账号 → 打开销售合同 → 导出
前置条件：销售合同页面设置默认筛选条件「实际生效日期时间范围」

2. BI 自动导出报表#

脚本步骤：打开浏览器 → 打开 BI 登录链接 → 登录账号 → 打开对应项目 → 导出
前置条件：BI 项目的筛选日期、条件设置好，每日滚动

3. 运营决策导出报表#

脚本步骤：打开浏览器 → 打开 BI 登录链接 → 登录账号 → 打开对应项目 → 导出
前置条件：设置好常用调出组合，比如「选择公司」

二、钉钉群机器人自动化搭建#

1. 本地脚本运行日志推送#

钉钉自动流通过 Webhook 接收数据，机器人把消息回传到群里——这是一切自动化日志的基础：脚本跑到哪一步、成功还是失败，群里一目了然。

2. 定时启动任务搭建#

钉钉自动流使用定时触发组件，将指令发送至本地脚本，实现全自动化——到点自动跑，无人值守。

3. 指令控制面板#

利用 AI 表格搭建，通过按钮组件触发自动流，实现远程发送任务指令——人在外面，手机点一下按钮，办公室电脑就开始干活。

三、进阶：日报生成并推送至钉钉#

前置条件与路径：

搭建 Excel 数据分析表，把复杂计算放在表格里，减少 Python 代码难度
使用 AI 办公软件（如 Trae、WorkBuddy）跑一次完整任务，让 AI 把任务固化成 Python 脚本
接入 AI 大模型 API 做结果分析（前期可用各平台免费模型）

四、总结：三块拼图#

💻拼图 ①

本地准备

接听任务并启动任务的调度程序 + 各任务的 Python 脚本——用 Trae、WorkBuddy 等 AI 办公软件，自然语言描述即可生成。

🔔拼图 ②

钉钉准备

利用群机器人自动化 + AI 表格自动化，搭建定时 / 手动两种触发方式的指令通道，远程下指令、回收结果。

🧩拼图 ③

系统准备

需要自动化的系统，筛选组件尽可能预设好——降低脚本开发难度，让脚本只做「点击和导出」。

搭建要点#

Python 脚本贯穿所有场景，必不可缺，能解决很多平台无法实现的任务
Excel 模板尽可能做到「粘贴数据、刷新即出结果」，可用网页版免费 DeepSeek 辅助生成 WPS JS 宏
写清执行步骤：需要搭建的任务，步骤要写得条理清晰，不要让 AI 猜下一步

上述自动化案例均为每日必做、执行动作基本不变、操作简单的任务——把重复性工作交给脚本，将时间聚焦在真正需要动脑的工作上。

附：本文配套演示文稿#

📂

AI协同钉钉办公_案例展示.pptx

PPTX · 5.4 MB · 原版演示文稿，可下载留存

下载 ⤓

南风尘小站

从零开始：让 AI 帮你写自动化脚本 · 傻瓜版教程

目录#

第 0 章 先搞懂：这套东西是什么、各工具干什么#

第 1 章 概念扫盲：提示词、成功案例、配置文件#

1.1 什么是”提示词”？#

1.2 什么是”成功案例”？#

1.3 什么是”配置文件”（.ini）？#

1.4 三个文件后缀，认识就够了#

第 2 章 软件安装与环境部署（让 AI 帮你装）#

2.1 安装 Python（唯一需要手动点几次鼠标的环节）#

2.2 安装 WorkBuddy、Trae Work、TraeCode#

2.3 关键姿势：环境部署也交给 AI#

2.4 验证清单#

第 3 章 认识 4 个成功案例#

3.1 所有案例的共同骨架（看懂这个，你就看懂了全部）#

3.2 每个案例都有的三类”可变东西”#

第 4 章 第一次运行成功案例（改配置 → 双击 → 出结果）#

4.1 第一步：让 AI 帮你读懂案例#

4.2 第二步：按清单改配置#

4.3 第三步：双击运行#

4.4 第四步：跑不起来？把报错喂给 AI#

第 5 章 核心章节：学会写提示词，让 AI 把案例改成你自己的#

5.1 万能提示词公式#

5.2 实战一：仿”蓝凌EKP”做一个你们公司 OA 的导出脚本#

5.3 实战二：仿”每日CRM任务”做自家业务系统导出#

5.4 实战三：仿”BI任务模块化”增删报表下载任务#

5.5 提示词的迭代心法：一次只改一件事#

5.6 改造时的边界与禁忌#

第 6 章 用 TraeCode 调试：看懂报错、把报错喂回给 AI#

6.1 四个基本动作#

6.2 报错三看（不用懂代码也能定位问题）#

6.3 新手常见的三个”假故障”#

第 7 章 接入钉钉：机器人通知 + AI 表格自动流#

7.1 第一步：建群机器人，拿到 Webhook 地址#

7.2 第二步：把地址填进项目配置#

7.3 第三步：WorkBuddy 连接钉钉（MCP 连接器）#

7.4 AI 表格自动流：让结果沉淀成看板#

第 8 章 定时自动运行（Windows 任务计划程序）#

第 9 章 日常运行与维护#

9.1 每天的动作#

9.2 出问题时的标准排障流程#

9.3 改配置的四条军规#

9.4 让 AI 改脚本后的验证流程#

附录 A：提示词速查卡（10 条即抄即用）#

附录 B：常见报错对照表#

附录 C：安全红线（必读）#

Firefly 代码块示例

表达性代码#

语法高亮#

常规语法高亮#

渲染 ANSI 转义序列#

编辑器和终端框架#

代码编辑器框架#

终端框架#

覆盖框架类型#

文本和行标记#

标记整行和行范围#

选择行标记类型 (mark, ins, del)#

为行标记添加标签#

在单独行上添加长标签#

使用类似 diff 的语法#

结合语法高亮和类似 diff 的语法#

标记行内的单独文本#

正则表达式#

转义正斜杠#

选择内联标记类型 (mark, ins, del)#

自动换行#

为每个块配置自动换行#

配置换行的缩进#

可折叠部分#

行号#

为每个块显示行号#

更改起始行号#

Tab 代码块#

基本用法#

标签中使用 Emoji#

与其他代码块特性组合#

不止是代码块#

在提醒框内使用（MDX 组件）#

第 0 章先搞懂：这套东西是什么、各工具干什么#

第 1 章概念扫盲：提示词、成功案例、配置文件#

第 2 章软件安装与环境部署（让 AI 帮你装）#

第 3 章认识 4 个成功案例#

第 4 章第一次运行成功案例（改配置 → 双击 → 出结果）#

第 5 章核心章节：学会写提示词，让 AI 把案例改成你自己的#

第 6 章用 TraeCode 调试：看懂报错、把报错喂回给 AI#

第 7 章接入钉钉：机器人通知 + AI 表格自动流#

第 8 章定时自动运行（Windows 任务计划程序）#

第 9 章日常运行与维护#