写作约定¶

这套知识库的价值来自“可检索、可验证、可演进”。建议把网页收藏转化成自己的判断，而不是简单复制。

页面模板¶

# 主题

一句话说明它解决什么问题。

## 核心模型

概念、数据流或公式。

## 何时使用

- 适用条件
- 不适用条件

## 如何验证

命令、指标、实验或排障路径。

## 延伸阅读

- [官方文档](https://example.com)

维护规则¶

• 事实尽量链接官方文档、规范或论文；博客用于补充实践，不作为唯一依据。
• 版本敏感的结论标出版本与验证日期。
• 命令中的域名、账号、token、IP 使用占位符。
• 架构选择写清代价和适用边界，避免“最佳实践”式绝对判断。
• 排障记录使用“现象 → 证据 → 假设 → 验证 → 根因 → 修复”的结构。

常用语法¶

!!! warning "风险"
    不要在仓库提交密钥。

=== "方案 A"
    内容 A

=== "方案 B"
    内容 B

代码行高亮：

```yaml hl_lines="3"
resources:
  limits:
    nvidia.com/gpu: 1
```

发布前检查¶

• scripts\build.ps1 通过。
• 新页面已加入 mkdocs.yml 导航。
• 内部链接可用，外部链接指向可信来源。
• 没有真实 token、邮箱、公司域名、内网地址或客户数据。
• 手机宽度下表格和代码块仍可阅读。