# URL 规范

Summary: URL 是 AI 站点的主键。规范的目标是稳定映射、低歧义和长期可引用。

Last updated: 2026-03-12  
Version: v1.0.0  
Docs URL: https://pingfanfan.github.io/OpenWebsite/docs/url-conventions/  
API URL: https://pingfanfan.github.io/OpenWebsite/api/pages/url-conventions.json

## 路径模式

- HTML: `/docs/<slug>/`
- Markdown: `/raw/<slug>.md`
- JSON: `/api/pages/<slug>.json`

同一主题必须在三种格式下使用同一 slug。

## Slug 规则

- 使用小写英文和连字符。
- 表达主题而不是宣传语。
- 一个主题只保留一个 slug。
- 标题可改，但 slug 尽量不改。

## 锚点规则

- 使用语义化 id，例如 `#anchor-rules`。
- 不使用随机 hash。
- 锚点遵循 kebab-case。
- 调整 section 顺序时不应修改锚点 id。

## 生命周期策略

- 非破坏更新沿用原路径。
- 主题拆分时保留旧路径并指向新页面。
- 版本信息优先放在元数据字段中。