1. 意图优先 (Intent First)#

分类不按”技术栈”分（那会过时），按”我当下的动作意图”分（这是永恒的）。

为什么？

• ❌ 技术栈分类：React、Docker、Linux → 5年后过时
• ✅ 意图分类：部署、配置、学习、排查 → 永远有效

2. 上下文快照 (Context Snapshot)#

一篇好文章必须能在6个月后，让我无需查阅Google，直接复现环境。

检验标准：

• ✅ 包含完整的依赖版本
• ✅ 包含环境变量配置
• ✅ 包含验证步骤
• ✅ 包含常见报错和解决方案

3. 最小认知负荷 (Minimal Cognitive Load)#

拒绝废话。多用代码块、多用截图锚点、多用列表。能Copy绝不手打。

执行原则：

• 用代码块代替文字描述
• 用截图标注代替长篇解释
• 用列表代替段落
• 用命令代替步骤说明

🏗️ 部署搭建 (Build & Deploy)#

定义：从0到1，把一个完整的系统跑起来

适用场景：

• 你拿着一个崭新的VPS，想把博客部署上去
• 老板让你搭一个新的监控系统，你一脸懵逼
• 看到GitHub上一个很酷的项目，想在本地跑起来
• 刚买了一台NAS，想搭建自己的私有云
• 需要从零开始配置一个Docker化的开发环境

判断标准：完成后有一个完整的、可以访问的系统

核心要素：

• 环境依赖清单（操作系统、软件版本、端口要求）
• 完整的配置文件（Docker Compose、Nginx Config）
• 详细的部署步骤（一步一步跟着做）
• 验证方法（怎么确认部署成功）
• 常见问题（部署过程可能遇到的坑）

文章举例：

• Firefly博客部署：从Fork到上线完整流程
• Nonebot2 QQ机器人部署实战
• 使用HuggingFace Spaces部署免费API服务

🛠️ 工具配置 (Tools & Config)#

定义：从1到100，让某个工具变得更好用

适用场景：

• 你的终端太丑了，想美化一下
• 每次用Clash都要手动改规则，想自动化
• 看到别人的VSCode配置很炫，想照着配
• 刚装了新电脑，需要快速恢复开发环境
• 想用某个软件但官方文档全是英文看不懂
• 听说某个工具很好用，想快速上手试试

判断标准：完成后某个工具的使用体验显著提升

核心要素：

• 工具介绍（这是什么，解决什么问题）
• 安装方法（一条命令搞定）
• 核心配置（贴出配置文件）
• 使用技巧（最常用的5个功能）
• 注意事项（容易踩的坑）

文章举例：

• Starship终端美化：3分钟配置指南
• 酒馆(SillyTavern)快速配置与使用
• Clash规则自定义：手动添加直连站点

📝 学习笔记 (Study & Notes)#

定义：从不懂到懂，记录知识的内化过程

适用场景：

• 学React Hooks，看官方文档一头雾水，需要自己的理解
• 面试前复习算法，需要整理常见题型和解法
• 读了一本技术书，想记录核心要点和代码示例
• 某个技术的原理很复杂，需要用自己的话解释清楚
• 看了很多文章都讲不清楚，自己研究后总结出来
• 工作中遇到的技术细节，想系统地整理成知识体系

判断标准：侧重理解和记录，而非纯粹的操作步骤

核心要素：

• 概念介绍（用最简单的话解释）
• 原理解析（为什么这么设计）
• 代码示例（可运行的完整代码）
• 个人理解（我是怎么理解的）
• 参考资料（哪些文章讲得好）

文章举例：

• React Hooks深入理解：useEffect的执行时机
• Clash配置文件完全解析：从订阅到规则
• Git Submodule工作机制详解

🚑 避坑排查 (Fix & Debug)#

定义：从-1到0，修复让人抓狂的错误

适用场景：

• Docker容器起不来，报ERR_CONNECTION_REFUSED
• Vercel部署失败，提示Submodule 403 Forbidden
• 代码在本地能跑，推到服务器就报错
• 某个配置改了就炸，但不知道哪里错了
• Google搜了半天都是垃圾答案，自己折腾了3小时终于解决
• 半年后又遇到同样的错误，但完全不记得怎么解决的

判断标准：有明确的报错信息，需要排查和修复

核心要素：

• 问题现象（详细描述，贴报错截图）
• 完整报错信息（原始错误日志）
• 排查过程（尝试了哪些方法）
• 最终解决方案（详细步骤）
• 原因分析（为什么会出错）
• 预防措施（怎么避免再次踩坑）

标题要求：必须包含错误码或错误关键词

文章举例：

• Docker容器无法访问宿主机：ERR_CONNECTION_REFUSED解决
• Vercel部署失败：Submodule 403 Forbidden完全修复
• Nonebot2启动报错：端口被占用问题排查

⚡ 速查脚本 (Snippets & Ops)#

定义：纯记忆片段，不需要理解，复制粘贴就行

适用场景：

• 每次用Git Submodule都要Google命令
• 需要查端口占用但总是记不住命令
• 想用正则匹配但语法老是忘
• 发布博客文章有固定流程，需要一个checklist
• 经常要配置Nginx但每次都要翻文档
• 有些命令很长很复杂，不想每次都手打

判断标准：不需要理解原理，只需要快速查到并使用

核心要素：

• 使用场景（什么时候需要）
• 命令/代码（直接可复制的）
• 参数说明（每个参数是什么意思）
• 示例（真实的使用案例）

文章举例：

• Git Submodule常用命令速查表
• Linux端口占用排查命令集合
• Firefly博客发布文章标准流程
• 常用正则表达式速查手册

核心原则#

分类看动作，标签看属性

• 分类（Category）：回答”我在做什么？”

  • 我在部署一个系统 → 部署搭建
  • 我在配置一个工具 → 工具配置
  • 我在学习一个技术 → 学习笔记

• 标签（Tags）：回答”内容是什么性质？”

  • 这是免费的 → 免费、白嫖
  • 这很复杂 → 进阶
  • 这很基础 → 新手友好

关键修正：白嫖/免费是标签，不是分类#

错误示范：

1
title: HuggingFace免费部署API全流程
2
category: 白嫖攻略  # ❌ "白嫖"是属性，不是动作

正确示范：

1
title: HuggingFace Spaces部署API服务
2
category: 部署搭建  # ✅ 动作：我在部署
3
tags: ['API', 'HuggingFace', '免费', '部署']  # ✅ 属性：这是免费的

标签分类#

4类标签：

1. 技术栈：Docker、React、Python、Linux
2. 平台工具：Vercel、Cloudflare、HuggingFace、GitHub
3. 内容属性：免费、白嫖、进阶、新手友好、付费
4. 核心对象：博客、机器人、API、网盘、终端

标签数量：最少3个，最多6个，平均4-5个

标签示例：

1
# 部署搭建 + 免费资源
2
tags: ['API', 'HuggingFace', '免费', '部署', '白嫖']
3

4
# 工具配置 + 终端美化
5
tags: ['Starship', '终端', '美化', '效率工具', '新手友好']
6

7
# 学习笔记 + 进阶内容
8
tags: ['React', 'Hooks', '前端', '学习', '进阶']
9

10
# 避坑排查
11
tags: ['Docker', '网络', '排查', '错误修复']
12

13
# 速查脚本
14
tags: ['Git', 'Submodule', '命令', '速查']

标题设计#

基本原则：

• 说清楚”干什么”，不要模糊
• 避坑类必须包含错误码
• 去掉”白嫖”、“免费”等词（用标签标注）

标题模板：

1. 部署搭建类

   • [技术/项目] + 部署/搭建 + [关键特性]
   • 示例：Firefly博客部署：Git Submodule方案

2. 工具配置类

   • [工具名] + 配置/美化/使用 + [核心功能]
   • 示例：Starship终端美化：10分钟配置指南

3. 学习笔记类

   • [技术] + 学习笔记/深入理解/完全解析
   • 示例：React Hooks深入理解：useEffect执行时机

4. 避坑排查类

   • [场景描述] + : + [错误码/错误关键词] + 解决/修复
   • 示例：Docker容器无法访问宿主机：ERR_CONNECTION_REFUSED解决

5. 速查脚本类

   • [技术/工具] + 常用命令/速查表/操作手册
   • 示例：Git Submodule常用命令速查表

语言风格#

✅ 推荐：

• 说人话：这样做会报错 > 此操作可能导致异常
• 用”我”：我遇到这个问题时... > 笔者在实践中发现...
• 口语化：搞定 > 完成配置
• 承认不足：我也不知道为什么，但这样能解决

❌ 避免：

• AI式夸张：震撼登场、深度解析、全网最全
• 过度铺垁：在当今的技术环境中...
• 假装客观：通过本文的学习，相信读者能够...
• 长篇废话：直接上代码和截图

视觉要求#

必须有：

• 关键步骤的清晰截图（用红框标注重点）
• 代码块标注语言类型
• 重要提示用引用块
• 命令可一键复制

可选：

• emoji标注（💡提示 / ⚠️注意 / ✅成功 / ❌错误）
• 表格对比（多方案选择时）
• 流程图（复杂流程时）

禁止：

• 纯文字长篇大论
• 模糊不清的截图
• 无关的装饰性图片
• 没有语法高亮的代码块

基础模板#

1
---
2
title: 具体的标题，说清楚干什么
3
published: YYYY-MM-DD
4
description: 一句话说清楚这篇文章解决什么问题（不超过80字）
5
image: "./FILES/文章目录/封面图.png"
6
tags: ['标签1', '标签2', '标签3', '标签4']
7
category: 分类名称
8
draft: false
9
---

分类值（5个）#

1
category: 部署搭建    # 🏗️ Build & Deploy
2
category: 工具配置    # 🛠️ Tools & Config
3
category: 学习笔记    # 📝 Study & Notes
4
category: 避坑排查    # 🚑 Fix & Debug
5
category: 速查脚本    # ⚡ Snippets & Ops

完整示例#

示例1：免费部署（白嫖作为标签）

1
---
2
title: HuggingFace Spaces部署API服务
3
published: 2025-03-24
4
description: 使用HuggingFace Spaces免费部署API服务的完整流程，包含配置和验证
5
image: "./FILES/HF-API-Deploy/cover.png"
6
tags: ['API', 'HuggingFace', '免费', '部署', '白嫖']
7
category: 部署搭建
8
draft: false
9
---

示例2：避坑排查（包含错误码）

1
---
2
title: Docker容器无法访问宿主机：ERR_CONNECTION_REFUSED解决
3
published: 2025-01-08
4
description: Docker容器访问宿主机服务报ERR_CONNECTION_REFUSED的完整排查和解决方案
5
image: "./FILES/Docker-Network-Error/cover.png"
6
tags: ['Docker', '网络', '排查', '错误修复']
7
category: 避坑排查
8
draft: false
9
---

示例3：工具配置（资源获取）

1
---
2
title: PikPak会员获取与配置
3
published: 2025-04-03
4
description: PikPak会员获取方案及客户端配置使用教程
5
image: "./FILES/PikPak-Setup/cover.png"
6
tags: ['PikPak', '会员', '免费', '网盘', '白嫖']
7
category: 工具配置
8
draft: false
9
---