想贡献一篇文章？先读完这一页
写作三步
1. 挑一个未占用的 URL 与模板
从 全站归档 里挑一个没被占用的选题方向。模板有 8 种（见下表）：
| 模板 | 适用场景 | 结构骨架 |
|---|---|---|
| A | Step by Step 教程型 | TL;DR → 前置条件 → 步骤 1..N → 验证 → FAQ → 参考 |
| B | 问题-原因-方案 排障型 | 症状 → 5 分钟定位 → 常见原因 → 兜底 |
| C | 是什么-为什么-怎么做 概念型 | 定义 → 为什么需要 → 最小示例 → 进阶 |
| D | A vs B 对比型 | TL;DR 决策表 → 场景 A → 场景 B → 边界 |
| E | Top N 清单型 | 引言 → Top 1..N → 最容易忽略 3 条 |
| F | Cheat Sheet 速查型 | 快速定位表 → 完整参数表 → 常见坑 |
| G | Roadmap 路线图型 | 起点评估 → 阶段 1..4 → 每阶段产出物 |
| H | Case Study 案例型 | 时间线 → 现象 → 定位 → 根因 → 修复 → 加固 |
轮换规则：禁连续 3 篇同模板；每专栏至少覆盖 A/B/D/E/F。
2. 跑查重 SOP
见下方 查重 SOP 章节。
3. 从模板复制 frontmatter 骨架
---
title: 文章标题（≤ 30 字，含主词）
description: 60-80 字，主词 + 具体利益点
answer: |
3 行内核心结论（≤ 100 字，GEO 关键）
tags: [主-tag, 长尾-tag-1, 长尾-tag-2]
lang: zh
date: 2026-10-15
faq:
- q: 问答对 1
a: 答案 1
- q: 问答对 2
a: 答案 2
---
frontmatter 必填字段
| 字段 | 必填 | 说明 |
|---|---|---|
title |
✅ | ≤ 30 字，含 SEO 主词 |
description |
✅ | 60-80 字，主词 + 具体利益点 |
answer |
✅ | 3 行内核心结论（Answer Block） |
tags |
✅ | 2-5 个，全小写英文，连字符分隔 |
lang |
✅ | zh 或 en |
date |
✅ | YYYY-MM-DD |
faq |
⚪ | 有问答结构时才加，3-5 条 |
tags 命名规范
- 全部小写英文，单词间用连字符
-（reverse-proxy✅、反向代理❌） - 每篇 2-5 个（1 主 tag + 2-4 长尾 tag）
- 中英站共享同一套 tag
- 专栏 tag（
network/monitor/homeassistant）可选，仅跨栏聚合时加
查重 SOP
发文前必须走的 6 步查重流程：
Step 1 · 提取查重种子（3-5 个）
从 title + H1 + answer + 前 3 个 H2 中挑最短可辨识度关键词组合。
示例（nginx-proxy.md）：
- Nginx 502 upstream prematurely closed 排查
- nginx 502 vs 504 区别
- nginx reverse proxy 502 troubleshooting
Step 2 · Google 搜索
观察 3 个信号： 1. SERP 前 10 结果标题相似度 2. AI Overview 是否已给出答案 3. 同一短语在 ≥ 3 篇里以完全相同措辞出现 = 高危
Step 3 · Bing 搜索
同上，Bing 结果偏向中文站点和长尾教程。
Step 4 · AI 引擎交叉验证
在 ChatGPT / Perplexity / DeepSeek 分别输入关键词，观察引用来源。
Step 5 · 留证
把每个种子的搜索结果截图，附在 PR 描述里。
Step 6 · 通过则提交 PR
未通过任一查重：改写法或换角度重写，禁止抄袭。
本地构建验证
pip install -r requirements.txt
python scripts/gen_llms.py
mkdocs build --strict
mkdocs serve --dev-addr 127.0.0.1:8000
CI 会检查什么
- URL 是否已在 全站归档 列出
- frontmatter 是否完整（含
answer） - Answer Block 是否存在且 ≤ 100 字
- 段落是否 ≤ 4 句
- 是否有 ≥ 3 个站内链接
- tags 是否全小写英文
- 是否有
mkdocs build --strict警告
提交前 checklist
- frontmatter 完整（title / description / answer / tags / lang / date）
- 走了 6 步查重 SOP 且留证
-
mkdocs build --strict通过（无警告） - 至少 3 个站内链接
- 至少 1 个白名单外站链接（若涉及）
- 官方文档引用 ≤ 200 字且标注出处
- H2 ≥ 3 个
- 段落 ≤ 4 句
提交流程
- 通过邮件联系作者（ops@jiunotes.top）
- 从
main拉分支：git checkout -b article/<col>/<slug> - 写文章（放在
docs/<lang>/<col>/<slug>.md） - 本地跑
mkdocs build --strict - 提 PR 到
main，附查重截图
CI 通过后合并，作者 1 个工作日内上线。