AhaKnow 博客 Slug 命名规范 v1.0
这套规则的目标是:
中文标题负责表达,英文 slug 负责长期归档、传播和国际化。
1. 总原则
中文文章不用中文 slug
不要这样:
/AI编程最大的坑看不懂但点了继续/
分享后容易变成乱码编码,不美观,也不利于长期传播。
不用拼音 slug
不要这样:
/ai-biancheng-zuidakde-keng-kanbudong-dianle-jixu/
拼音对中文用户不够直观,对英文用户没有语义,对搜索和归档都不够友好。
统一使用英文语义 slug
推荐这样:
/ai-coding-dont-click-continue/
标题可以是中文:
AI 编程最大的坑:看不懂,但点了继续
slug 用英文概括核心意思:
ai-coding-dont-click-continue
2. 标准格式
所有 slug 统一使用:
领域关键词-核心问题-核心判断
或者:
领域关键词-核心动作-核心结果
例如:
ai-coding-dont-click-continue
ai-coding-control-loss
ai-coding-engineering-judgment
ai-3d-product-opportunities
indie-builder-content-system
personal-branding-for-builders
3. 基础书写规则
只使用小写英文
正确:
ai-coding-control-loss
错误:
AI-Coding-Control-Loss
单词之间用短横线 -
正确:
ai-coding-review-before-execute
错误:
ai_coding_review_before_execute
aiCodingReviewBeforeExecute
不使用特殊符号
不要出现:
?
!
:
,
。
/
&
+
%
错误示例:
ai-coding:control-loss
ai+3d-opportunity
ai/coding/risk
正确示例:
ai-coding-control-loss
ai-3d-opportunity
尽量控制在 3 到 6 个英文词
最好:
ai-coding-control-loss
也可以:
ai-coding-dont-click-continue
太长就不好:
why-ai-coding-is-dangerous-when-you-dont-understand-but-still-click-continue
slug 不是论文标题,不需要把所有意思都写进去。
4. slug 的核心结构
推荐你长期使用这 5 种结构。
结构一:领域 + 观点
适合观点类文章。
ai-coding-control-loss
ai-coding-judgment-matters
ai-3d-is-still-early
indie-builder-needs-distribution
对应中文标题:
AI 编程正在让一些人失去控制权
AI 编程时代,判断力比写代码更重要
AI + 3D 还很早,机会没有结束
独立开发者不能只会做产品,还要会分发
结构二:领域 + 不要做什么
适合警示类文章。
ai-coding-dont-click-continue
ai-coding-dont-blindly-refactor
dont-outsource-judgment-to-ai
dont-build-before-positioning
对应中文标题:
AI 编程最大的坑:看不懂,但点了继续
别让 AI 盲目重构你的项目
不要把判断力外包给 AI
别急着做产品,先想清楚定位
结构三:领域 + 核心能力
适合方法论类文章。
ai-coding-engineering-judgment
ai-coding-system-boundary
ai-native-product-thinking
builder-content-system
对应中文标题:
AI 编程时代,最稀缺的是工程判断
真正会用 AI 的人,能看懂系统边界
AI Native 产品思维到底是什么
独立开发者需要自己的内容系统
结构四:从 A 到 B
适合转型、成长、路径类文章。
engineer-to-product-builder
idea-to-product
content-to-asset
video-to-blog-system
对应中文标题:
从工程师到产品型创造者
如何把一个想法做成产品
内容不是发完就结束,而是要变成资产
从视频到博客:我的内容沉淀系统
结构五:问题式 slug
适合探索类、思考类文章。
why-ai-3d-matters
why-build-in-public
why-engineers-need-branding
why-small-tools-matter
对应中文标题:
AI + 3D 到底还有没有机会?
为什么我开始公开构建?
为什么工程师也需要个人品牌?
为什么小工具值得做?
5. 你的固定分类前缀
你现在的内容体系,可以先固定这些领域词。
AI 编程类
统一使用:
ai-coding
示例:
ai-coding-dont-click-continue
ai-coding-control-loss
ai-coding-engineering-judgment
ai-coding-review-before-execute
ai-coding-system-boundary
ai-coding-human-in-the-loop
ai-coding-responsibility
ai-coding-debugging-mindset
AI × 3D 类
统一使用:
ai-3d
示例:
ai-3d-product-opportunities
ai-3d-is-still-early
ai-3d-viewer-tools
ai-3d-and-3dgs
ai-3d-builder-roadmap
ai-3d-market-gap
3DGS / 三维重建类
统一使用:
3dgs
或者更通用:
3d-reconstruction
示例:
3dgs-viewer-product
3dgs-rendering-notes
3dgs-memory-optimization
3dgs-from-research-to-product
3d-reconstruction-depth-alignment
3d-reconstruction-camera-poses
独立开发类
统一使用:
indie-builder
示例:
indie-builder-content-system
indie-builder-product-loop
indie-builder-small-tools
indie-builder-distribution
indie-builder-app-store-lessons
indie-builder-from-idea-to-launch
个人品牌 / 对外表达类
统一使用:
personal-branding
或者更偏创造者:
builder-branding
示例:
personal-branding-for-engineers
builder-branding-starting-point
personal-branding-content-system
builder-branding-from-work-to-voice
我更建议你用:
builder-branding
因为它更符合你“创造者 / builder”的方向。
产品思考类
统一使用:
product-thinking
示例:
product-thinking-before-building
product-thinking-user-problem
product-thinking-small-tools
product-thinking-positioning
product-thinking-from-feature-to-value
个体成长 / 思考类
统一使用:
personal-growth
或者更有你自己的味道:
self-evolution
示例:
self-evolution-through-building
self-evolution-and-expression
personal-growth-inner-anchor
personal-growth-against-comparison
如果文章更偏哲学和成长,用:
self-evolution
如果文章更偏通用表达,用:
personal-growth
6. 中文概念到英文 slug 的固定翻译表
你以后可以直接查这个表。
| 中文概念 | 推荐英文 |
|---|---|
| AI 编程 | ai-coding |
| AI 原生 | ai-native |
| 工程判断 | engineering-judgment |
| 控制权 | control |
| 控制权丧失 | control-loss |
| 系统边界 | system-boundary |
| 责任 | responsibility |
| 责任稀释 | responsibility-drift |
| 盲目重构 | blind-refactor |
| 继续执行 | click-continue |
| 看不懂 | without-understanding |
| 审核 | review |
| 执行前审核 | review-before-execute |
| 回滚 | rollback |
| 验证 | validation |
| 防御性编程 | defensive-programming |
| fallback | fallback |
| 架构复杂度 | architecture-complexity |
| 技术债 | technical-debt |
| 独立开发 | indie-building / indie-builder |
| 产品型工程师 | product-minded-engineer |
| 创造者 | builder |
| 内容资产 | content-asset |
| 内容系统 | content-system |
| 对外表达 | public-expression |
| 个人品牌 | personal-branding |
| 公开构建 | build-in-public |
| 小工具 | small-tools |
| 闭环 | product-loop |
| 从想法到产品 | idea-to-product |
| AI + 3D | ai-3d |
| 三维重建 | 3d-reconstruction |
| 3DGS | 3dgs |
7. slug 生成流程
每次写完一篇文章,按照这 5 步生成 slug。
第一步:判断文章领域
先问:
这篇文章属于哪个长期栏目?
例如:
AI 编程
AI × 3D
独立开发
个人品牌
产品思考
个体成长
第二步:提炼核心观点
不要翻译标题,而是提炼核心意思。
比如中文标题是:
AI 编程最大的坑:看不懂,但点了继续
核心观点不是:
biggest pit of ai programming
而是:
不要在没理解时让 AI 继续执行
所以 slug 应该是:
ai-coding-dont-click-continue
第三步:删掉无意义词
英文里很多词可以省略。
少用:
the
a
an
of
for
to
and
is
are
除非它们能让意思更清楚。
不好:
the-risk-of-ai-coding
更好:
ai-coding-risk
不好:
why-the-ai-coding-is-dangerous
更好:
why-ai-coding-is-risky
第四步:控制长度
优先 3 到 6 个词。
好:
ai-coding-control-loss
可以接受:
ai-coding-dont-click-continue
太长:
ai-coding-control-loss-when-you-dont-understand-the-code
第五步:确认未来可复用
最后问一句:
半年后我看到这个 slug,还能知道这篇文章大概讲什么吗?
如果能,就合格。
8. 文件路径规则
如果你用 Hugo,建议文件路径这样组织:
content/posts/ai-coding/ai-coding-dont-click-continue.md
content/posts/ai-3d/ai-3d-product-opportunities.md
content/posts/indie-builder/indie-builder-content-system.md
content/posts/builder-branding/builder-branding-starting-point.md
content/posts/product-thinking/product-thinking-before-building.md
content/posts/self-evolution/self-evolution-through-building.md
这样你的博客不是一堆散文,而是一个知识系统。
9. URL 规则
推荐 URL 保持简单:
/posts/ai-coding-dont-click-continue/
也可以带分类:
/posts/ai-coding/ai-coding-dont-click-continue/
我更推荐第二种:
/posts/ai-coding/ai-coding-dont-click-continue/
原因是更适合你长期做知识体系。
10. Front Matter 模板
以后每篇文章可以这样写:
---
title: "AI 编程最大的坑:看不懂,但点了继续"
slug: "ai-coding-dont-click-continue"
date: 2026-05-16
categories:
- AI 编程
tags:
- AI Coding
- 工程判断
- 控制权
- 独立开发
series:
- AI 时代的工程判断
description: "AI 编程真正危险的地方,不是 AI 会犯错,而是人在没有理解的情况下不断点击继续,慢慢失去对项目的控制权。"
---
11. 什么时候修改 slug?
文章刚发布前,可以改
发布前,slug 可以反复优化。
文章发布后,尽量不要改
因为一旦链接被分享、被搜索引擎收录、被公众号引用,改 slug 会破坏链接。
必须修改时,旧链接要做重定向
例如旧地址:
/posts/ai-coding-risk/
新地址:
/posts/ai-coding-dont-click-continue/
要让旧地址自动跳到新地址。
12. slug 和标题的关系
标题可以更情绪化,slug 要更稳定。
例如:
标题:AI 编程最大的坑:看不懂,但点了继续
slug:ai-coding-dont-click-continue
标题:AI 正在让一些工程师失去方向盘
slug:ai-coding-control-loss
标题:别急着让 AI 重构你的项目
slug:ai-coding-dont-blindly-refactor
标题负责吸引人。
slug 负责归档和识别。
13. 你的长期栏目建议
我建议你博客先固定 6 个主栏目:
1. AI Coding
2. AI × 3D
3. Indie Builder
4. Product Thinking
5. Builder Branding
6. Self Evolution
对应中文:
1. AI 编程
2. AI × 3D
3. 独立开发
4. 产品思考
5. 创造者品牌
6. 个体成长
对应目录:
ai-coding
ai-3d
indie-builder
product-thinking
builder-branding
self-evolution
14. 示例库
AI 编程
ai-coding-dont-click-continue
ai-coding-control-loss
ai-coding-engineering-judgment
ai-coding-review-before-execute
ai-coding-dont-blindly-refactor
ai-coding-system-boundary
ai-coding-responsibility
ai-coding-validation
ai-coding-human-in-the-loop
ai-coding-technical-debt
AI × 3D
ai-3d-product-opportunities
ai-3d-is-still-early
ai-3d-viewer-tools
ai-3d-and-3dgs
ai-3d-from-research-to-product
ai-3d-market-gap
ai-3d-builder-roadmap
ai-3d-web-platform
独立开发
indie-builder-content-system
indie-builder-product-loop
indie-builder-small-tools
indie-builder-distribution
indie-builder-app-store-lessons
indie-builder-from-idea-to-launch
indie-builder-public-proof
indie-builder-build-ship-learn
产品思考
product-thinking-before-building
product-thinking-user-problem
product-thinking-small-tools
product-thinking-positioning
product-thinking-feature-to-value
product-thinking-mvp-scope
product-thinking-distribution-first
创造者品牌
builder-branding-starting-point
builder-branding-public-expression
builder-branding-from-work-to-voice
builder-branding-content-system
builder-branding-for-engineers
builder-branding-personal-narrative
个体成长
self-evolution-through-building
self-evolution-inner-anchor
self-evolution-against-comparison
self-evolution-expression-practice
self-evolution-from-anxiety-to-action
self-evolution-build-your-own-loop
15. 最终一句规则
你可以把这句话当成总规则:
中文标题表达情绪和观点,英文 slug 表达主题和资产位置。不要翻译标题,要翻译文章的核心判断。
这篇文章最终就用:
ai-coding-dont-click-continue
它短、准、有记忆点,也适合以后作为你 AI 编程系列的第一篇。