投稿指南

我们要什么样的稿

三个核心标准——满足任何一个都欢迎：

• 信息领先：你比中文社群早，且能讲清楚。比如某新论文出来一周内做精读，或某新工具上线后立刻写实战。
• 有趣的解释：抽象概念配类比、配可视化、配代码——让读者「啊原来是这样」而不是「看不懂」。
• 系统的整合：把分散的知识点连接起来。比如"从感知机到 Transformer 走过了哪些路"这种纵向梳理。

流程

1. 开 Issue 提想法 — 在 GitHub 提一个 issue 描述你想写什么、为什么、大概结构。我们 24 小时内回复。
2. 拉分支起草 — Fork → 新分支 → 在 site/src/content/ 对应目录建 MDX 文件。
3. PR 提交 — 完成后 PR，附 1-2 句你想强调的重点。
4. 评审 + 合并 — 我们会读、给反馈、可能小改。绝大多数稿件 1-3 轮内合并。
5. 署名上线 — 你的名字 + GitHub / Twitter 链接出现在文章上和 编辑团队 页。

风格指南

语气

• 对话感：写给一个聪明但不专业的朋友听。可以用"你""我们"。
• 有观点：不要 wikipedia 式的中立。我们要的是「你怎么看」。
• 不卖弄：术语第一次出现要解释，不要默认读者懂。

结构

• 每篇文章开头 1-2 段说为什么这件事重要（钩子）。
• H2 用「第一站 / 第二站」「为什么 / 怎么做 / 局限」这种递进结构。
• 代码片段要短而能跑；超长代码放 GitHub gist 或仓库链接。
• 结尾的 <Callout> 块写一句最值得记住的话。

排版

• 中英文之间加空格（HelloAI 不用 PangPang 工具自动加，请你自己注意）。
• 数学公式用 $...$ 或 $$...$$，KaTeX 渲染。
• 表格优先用 markdown 表格，复杂的用 HTML。
• 避免过深嵌套列表（最多 2 层）。

Frontmatter 速查

学习路径文章（learn/）

---
title: 'L4-13 RAG 工程实战：从原型到生产'
description: '一段话讲清楚这篇要讲什么（用在卡片预览和 SEO）'
level: 'L4'                  # L0-L7
chapter: 13
readingTime: 12              # 分钟
difficulty: '🐣'             # 🥚=最简单 🐣=中 🐥=进阶
author: '你的名字'
publishDate: 2026-09-01
tags: ['RAG', '工程', 'L4']
related: ['l4-03-rag', 'l4-04-agent']  # 必须是真实存在的 slug
draft: false
---

论文精读（papers/）

---
title: 'Mamba 2: SSM 复兴'
authors: ['Albert Gu', 'Tri Dao']
arxivId: '2405.21060'
venue: 'ICML 2024'
year: 2024
tldr: '一句话讲清楚这篇论文的贡献'
tags: ['Mamba', 'SSM', '必读']
hallOfFame: true
weeklyPick: false
publishDate: 2026-09-01
---

常见问题

稿酬？

目前没有。HelloAI 是非营利站，我们都是用业余时间做。如果未来有捐赠收入或赞助，会按贡献比例分。 但作为投稿者，你的署名 + 链接会跟着文章。

能转载吗？

所有内容采用 CC BY-NC-SA 4.0——可以自由转载，只需： 注明来源（HelloAI + 文章链接）、非商业、相同协议。商业转载请单独 联系。

能用 AI 辅助写吗？

可以——但你必须做事实校对、逻辑梳理、风格调整。 我们的读者一眼能看出"AI 流水账"和"用心写的文章"的差别。AI 辅助 OK，AI 代笔不行。

能加自己的链接吗？

在作者信息区可以放 GitHub / Twitter / 个人博客。文章正文内一般不允许放推广链接，除非和内容直接相关（如「我开源了一个 demo 在这」）。