content/posts/ CLAUDE.md

文章 Front Matter 格式

使用 TOML 格式（+++ 分隔），不要用 YAML（---）格式。项目中大部分文章已统一为 TOML。

+++
date = '2026-04-20T10:00:00+08:00'
draft = false
title = '文章标题'
tags = ['标签1', '标签2']
categories = ['分类名']
hidden = true   # 可选，私密文章
+++

字段说明

字段必填说明
date是ISO 8601 格式，带时区 +08:00。影响文章排序
draft是true=草稿（仅 hugo serve -D 可见），false=正式发布
title是文章标题，会显示在列表页和 <title>
tags是标签数组，用于 /tags/ 页面聚合
categories是分类数组，用于 /categories/ 页面聚合
hidden否true 时文章被隐藏，需在导航栏输入密码（hugo.toml 中 secretPassword）后才能查看

已有的分类/标签约定

categories（选一个）：

  • 图形渲染
  • 性能优化
  • 博客

tags（按需选多个）：

  • 移动端, GPU, 剔除, TBDR, NVIDIA, Nsight, UE, RenderDoc, Shader Debug, 文档

新建文章时优先复用已有标签和分类，保持聚合页一致。

正文规范

  • 正文标题用 ## ### 逐级递减，不要跳级
  • 可在正文 # 标题 开头（与 front matter title 独立），也可以不写正文标题直接从 ## 开始
  • 代码块标注语言：```cpp ```ini ```bash 等
  • 表格用 GFM 语法
  • 图片放到 static/ 目录，用 /filename.png 引用
  • 中文与英文/数字之间加空格（排版惯例）
  • 所有 ## 标题会自动被 JS 渲染为可折叠区块（details/summary），因此：
    • 不要在 ## 前后添加额外的 <details> 或折叠 HTML，会冲突
    • ### 及以下标题不会被自动折叠，正常书写即可
    • 折叠状态默认展开，用户可手动折叠并持久化到 sessionStorage

研究类文章规范

  • 涉及技术细节、硬件规格、架构原理等非通用知识时，必须上网搜索验证，不可凭记忆编写
  • 每个关键论据、数据、引用必须标注来源，格式如：
    • 正文内：据 [Qualcomm 官方文档](URL) 描述……
    • 章节末尾：用 ### 参考 或 ### 官方文档 列出所有来源链接
  • 严禁幻觉：不确定的信息不写，查不到权威来源的标注"待验证"
  • 优先引用：官方文档 > 官方博客 > 论文/专利 > 知名技术博客 > 社区讨论
  • 引用网址必须验证可访问：每个外链写入文章前必须 curl 或浏览器确认返回 200，404/超时的链接不使用，替换为可用的替代来源

文件命名

  • 用中文或英文均可，已有示例：移动端GPU可见性剔除机制.md、NVIDIA_GPU_Performance_Counters_Complete_zh.md
  • 文件名不影响 URL，URL 由 hugo.toml 的 defaultContentLanguage 和文件名自动生成

新建文章流程

推荐用项目根目录的 new-post.py 或 new-post_新建文章.bat，会自动生成带 front matter 的模板。