docs: 更新 CLAUDE.md, draft, audio

Author: NightVoyager

CLAUDE.md

@@ -1,69 +1,77 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+本文件为 Claude Code (claude.ai/code) 在此仓库中工作提供指导。
 
-## Project Overview
+**重要说明：本项目的所有文档、注释和生成内容都应使用中文。**
 
-This is a Hugo-based personal blog (夜航星 / Night Voyager) using the FixIt theme. The site is in Chinese (zh-CN) and covers topics like cognitive psychology, learning methods, data analysis, and programming.
+## 项目概述
 
-- **Base URL:** https://austinxt.github.io (Custom domain: blog.nightvoyager.top)
-- **Theme:** FixIt (installed as git submodule in `themes/FixIt/`)
+这是一个基于 Hugo 的个人博客（夜航星 / Night Voyager），使用 FixIt 主题。网站语言为中文（zh-CN），内容涵盖认知心理学、学习方法、数据分析和编程等主题。
 
-## Common Commands
+- **基础 URL：** https://austinxt.github.io（自定义域名：blog.nightvoyager.top）
+- **主题：** FixIt（作为 git 子模块安装在 `themes/FixIt/` 目录）
+- **Hugo 版本：** 0.154.5 extended（在 `.github/workflows/hugo.yml` 中指定）
+
+## 常用命令
 
 ```bash
-# Development server with live reload
+# 开发服务器（支持热重载）
 hugo server
 
-# Development with full rebuild on changes (use when editing layouts)
+# 开发服务器（编辑布局文件时使用，完整重建）
 hugo server --disableFastRender
 
-# Production build (outputs to public/)
+# 生产环境构建（输出到 public/ 目录）
 hugo
 
-# Create new post
+# 创建新文章
 hugo new posts/YYYY-MM-DD-title.md
 
-# Create new talk/note
+# 创建新笔记/讨论
 hugo new talks/YYYY-MM-DD-title.md
 ```
 
-## Architecture
+## 项目架构
 
-### Content Organization
-- `content/posts/` - Published articles (~70 posts)
-- `content/talks/` - Discussion notes and quick thoughts (~43 entries)
-- `content/draft/` - Draft articles (not published)
+### 内容组织
+- `content/posts/` - 已发布文章（约 70 篇）
+- `content/talks/` - 讨论笔记和随想（约 43 篇）
+- `content/draft/` - 草稿文章（未发布）
 
-### Configuration
-- `config.toml` - Main Hugo configuration including SEO verification codes, menu structure, theme settings, and markup options
+### 配置文件
+- `config.toml` - Hugo 主配置文件，包含 SEO 验证码、菜单结构、主题设置、Giscus 评论、Fuse 搜索和标记选项
 
-### Custom Layouts
-- `layouts/_partials/head/seo.html` - Enhanced SEO metadata template with JSON-LD schema, AI-friendly tags, and search engine verification codes
+### 自定义布局
+- `layouts/_partials/head/seo.html` - 增强的 SEO 元数据模板，包含 JSON-LD schema、AI 友好标签和搜索引擎验证码
+- `layouts/partials/head/custom.html` - 自定义 head 内容
+- `layouts/partials/audio-player.html` - 音频播放器组件（在 `params.customPartials.postContentBefore` 中配置）
 
-### Static Assets
-- `static/robots.txt` - SEO crawler rules including explicit AI crawler permissions (GPTBot, Claude-Web, etc.)
-- `static/ai.txt` - AI usage policy declaration (CC-BY-NC-4.0 license)
-- `static/CNAME` - GitHub Pages custom domain configuration
+### 静态资源
+- `static/robots.txt` - SEO 爬虫规则，包含对 AI 爬虫的明确授权（GPTBot、Claude-Web 等）
+- `static/ai.txt` - AI 使用政策声明（CC-BY-NC-4.0 许可证）
+- `static/CNAME` - GitHub Pages 自定义域名配置
 
-### Theme
-The FixIt theme is a git submodule. Do not modify files inside `themes/FixIt/` directly. Use `layouts/` directory for customizations that override theme templates.
+### 主题
+FixIt 主题作为 git 子模块安装。请勿直接修改 `themes/FixIt/` 目录下的文件。如需自定义，请在 `layouts/` 目录中创建覆盖模板。
 
-## Front Matter Template
+## Front Matter 模板
 
-Posts use YAML front matter with these key fields:
+文章使用 YAML 格式的 front matter，主要字段如下：
 ```yaml
-title: Post title
-subtitle: Subtitle
+title: 文章标题
+subtitle: 副标题
 date: YYYY-MM-DD
-description: SEO description
-tags: [tag1, tag2]
-categories: [category]
+description: SEO 描述
+tags: [标签1, 标签2]
+categories: [分类]
 featuredImage: /images/image.jpg
 lightgallery: true
-mathjax: false  # Enable per-post for math content
 ```
 
-## Deployment
+## 部署
+
+网站使用 GitHub Actions 自动部署。推送到 `main` 分支会触发：
+1. 使用 `--gc --minify` 参数构建 Hugo
+2. 上传到 GitHub Pages
 
-The site deploys to GitHub Pages. After running `hugo`, commit the `public/` directory and push to trigger deployment.
+详见 `.github/workflows/hugo.yml` 工作流配置。无需手动部署。

content/draft/2025-01-13-audio-test-1.md

@@ -0,0 +1,42 @@
+---
+title: 音频播放器测试文章一
+subtitle: 测试 TTS 音频播放功能
+date: 2024-01-13
+slug: audio-test-1
+categories: [测试]
+tags: [音频测试]
+ttsAudio: /audio/test-audio-1.mp3
+---
+
+这是第一篇音频播放器测试文章。
+
+## 测试目的
+
+本文用于测试博客的 TTS 音频播放器功能，包括：
+
+1. 音频播放器的显示
+2. 播放/暂停控制
+3. 进度条拖动
+4. 播放速度调节
+5. 自动播放下一篇功能
+
+## 功能说明
+
+音频播放器支持以下功能：
+
+- **播放/暂停**：点击播放按钮控制音频
+- **快进/快退**：前进或后退 10 秒
+- **进度控制**：拖动进度条跳转到指定位置
+- **播放速度**：支持 0.5x 到 2x 速度调节
+- **迷你播放器**：滚动页面时显示悬浮播放器
+- **连续播放**：支持自动播放下一篇文章的音频
+
+## 测试内容
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris.
+
+这是一段测试文字，用于测试音频播放器在文章页面中的显示效果。
+
+## ChangeLog
+
+- 2025-01-13 创建测试文章

content/draft/2025-01-13-audio-test-2.md

@@ -0,0 +1,48 @@
+---
+title: 音频播放器测试文章二
+subtitle: 测试连续播放功能
+date: 2024-01-14
+slug: audio-test-2
+categories: [测试]
+tags: [音频测试]
+ttsAudio: /audio/test-audio-2.mp3
+---
+
+这是第二篇音频播放器测试文章。
+
+## 连续播放测试
+
+本文与第一篇测试文章配合，用于测试音频播放器的连续播放功能：
+
+1. 从第一篇文章播放完毕后自动跳转
+2. 上一篇/下一篇导航按钮
+3. 跨文章的播放状态保持
+
+## 迷你播放器测试
+
+当用户向下滚动页面，主播放器离开视口时，应该显示悬浮的迷你播放器：
+
+- 显示当前播放进度
+- 提供播放/暂停按钮
+- 点击展开按钮回到主播放器位置
+
+## 更多测试内容
+
+这里是更多的测试内容，用于增加页面高度，以便测试迷你播放器的显示效果。
+
+Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
+
+## 技术实现
+
+音频播放器使用以下技术实现：
+
+- HTML5 `<audio>` 元素
+- 原生 JavaScript 控制
+- CSS 自定义样式
+- Font Awesome 图标
+
+## ChangeLog
+
+- 2025-01-13 创建测试文章