111

.gitignore

@@ -1 +1,2 @@
-.idea/
+.idea/
+node_modules/

CLAUDE.md

@@ -0,0 +1,103 @@
+# CLAUDE.md - Document WordPress Theme
+
+## 项目概述
+
+这是一个 WordPress 博客主题（Document），基于文档类型设计，方便记录和查询学习笔记。
+
+- **类型**: WordPress 主题
+- **版本**: 1.5.1
+- **版本号位置**: `style.css` (第8行) 和 `include/config.php` (`DOCUMENT_VERSION` 常量)，两处必须同步修改
+
+## 项目结构
+
+```
+├── style.css / style.scss       # 主样式（WordPress 主题入口）
+├── functions.php                # 主题初始化，加载所有 include
+├── header.php / footer.php      # 全局头尾模板
+├── index.php / single.php / page.php / 404.php  # 页面模板
+├── include/
+│   ├── config.php               # 主题版本号、后台设置表单定义、所有配置项默认值
+│   ├── themes/
+│   │   ├── load.php             # ★ 前端资源加载（JS/CSS enqueue）核心文件
+│   │   ├── theme.php            # 主题钩子入口，include 所有子模块
+│   │   ├── shortcode.php        # 短标签
+│   │   └── ...
+│   ├── admin/                   # 后台相关（设置页面、编辑器插件）
+│   ├── functions/               # 通用函数、SMTP、初始化
+│   ├── widget/                  # 侧边栏小部件
+│   ├── todo/ clipboard/ snake/ doom/  # 各功能模块的数据库和API
+│   └── ...
+├── common/
+│   ├── main.js                  # 前端主逻辑
+│   ├── inline/                  # 各页面内联脚本（emoji, index, monitor, view 等）
+│   ├── prism/                   # 代码高亮（Prism.js）
+│   ├── viewer/                  # 图片灯箱（Viewer.js）
+│   ├── plugins/                 # TinyMCE 编辑器插件
+│   ├── todo/ clipboard/ snake/ doom/ friend/ swiper/ widget/  # 各功能模块前端
+│   └── admin/                   # 后台前端（Vue + Ant Design）
+├── assets/theme/                # 第三方库（jQuery, Swiper, Vue, Ant Design, Moment, Axios）
+├── template/                    # 模板片段（文章列表、分页、页面模板等）
+├── build.js                     # ★ 前端构建脚本（esbuild 压缩）
+└── package.json                 # Node.js 依赖（仅 esbuild）
+```
+
+## 构建流程
+
+### 重要：修改 JS 或 CSS 后必须重新构建
+
+本主题使用 esbuild 将所有前端 JS/CSS 压缩为 `.min.js` / `.min.css` 文件。WordPress 生产环境加载的是压缩版。
+
+```bash
+# 首次使用需安装依赖
+npm install
+
+# 构建（压缩所有 JS/CSS，约1秒完成）
+node build.js
+```
+
+### 构建机制说明
+
+- `build.js` 读取所有前端 JS/CSS 源文件，用 esbuild 压缩后输出为同目录下的 `.min.js` / `.min.css`
+- `include/themes/load.php` 中的 `nicen_theme_min_path()` 函数自动检测 `.min` 文件是否存在：
+  - 存在 → 加载压缩版（生产环境）
+  - 不存在 → 回退到原版（开发调试）
+- **只修改源文件**（如 `common/main.js`），**不要手动编辑** `.min.js` 文件
+
+### 什么时候需要构建
+
+- 修改了 `common/` 下的任何 `.js` 文件 → 需要 `node build.js`
+- 修改了 `style.css` → 需要 `node build.js`
+- 修改了 `.php` 文件 → **不需要**构建
+- 新增了 JS/CSS 文件 → 需要在 `build.js` 的文件列表中添加该文件，然后构建
+
+## 开发规范
+
+### 文件修改后的完整流程
+
+1. 修改源文件（`.js` / `.css` / `.php`）
+2. 如果改了 JS 或 CSS：运行 `node build.js`
+3. 确认 `.min` 文件已更新
+4. 提交所有文件（包括源文件和 `.min` 文件）
+
+### 版本号更新
+
+需要同时修改两处：
+- `style.css` 头部注释中的 `Version:` 字段
+- `include/config.php` 中的 `DOCUMENT_VERSION` 常量
+
+### 新增页面模板
+
+在 `include/config.php` 的 `PAGES` 常量中添加配置，包括模板文件路径和依赖的样式/脚本。
+
+### 资源加载
+
+- 前端资源加载集中在 `include/themes/load.php`
+- 后台资源加载在 `include/admin/load.php`
+- 页面模板的资源通过 `PAGES` 配置自动加载
+
+### 注意事项
+
+- jQuery 是全局依赖，`window.$ = jQuery` 已在 inline script 中设置
+- 后台使用 Vue 2 + Ant Design，前端不使用
+- 主题配置通过 `nicen_theme_config('key', false)` 读取
+- 主题色等样式变量通过 CSS 变量注入（`include/themes/load.php` 底部的 inline style）

DOOM_DESIGN.md

@@ -0,0 +1,201 @@
+# Doom-Style FPS Game (Raycasting)
+
+## Context
+Add a Doom/Wolfenstein-style first-person shooter to the blog as a "My Corner" game. Built entirely with Canvas 2D raycasting — no WebGL, no external libraries. One map, 3 weapons, level-based (find exit to win). Flat color walls with distance shading. Leaderboard reuses the same pattern as Snake Game.
+
+## Game Design
+
+### Gameplay
+- **Objective**: Navigate a maze, kill all enemies, find the exit door
+- **Perspective**: First-person, Wolfenstein 3D / Doom style
+- **Map**: 1 hand-crafted map (grid-based, ~24x24), walls are solid colors with distance-based shading
+- **Win condition**: Reach exit door (all enemies killed or exit found)
+- **Score**: Kills × 100 + health remaining × 10 + time bonus (faster = more points)
+
+### Weapons
+| # | Weapon | Damage | Fire Rate | Ammo | Notes |
+|---|--------|--------|-----------|------|-------|
+| 1 | Pistol | 25 | Medium | Unlimited | Starting weapon |
+| 2 | Shotgun | 80 (spread) | Slow | 20 | Pickup in map, wide spread |
+| 3 | Machine Gun | 15 | Fast | 100 | Pickup in map, rapid fire |
+
+Weapon switching: keys 1/2/3 or scroll wheel. Weapon sprite drawn at bottom-center of screen (simple geometric shapes, not image assets).
+
+### Enemies
+- **Type 1: Guard** — walks a patrol route, detects player by line-of-sight, shoots when in range (hitscan), low HP (50)
+- **Type 2: Soldier** — faster, more HP (100), chases aggressively once alerted
+- Enemies rendered as colored billboard sprites (circles/rectangles, not images), scaled by distance
+- Basic state machine: IDLE → ALERT (heard gunshot / saw player) → CHASE → ATTACK → DEAD
+- Collision: enemies block player movement
+
+### Player
+- HP: 100, displayed as health bar in HUD
+- Movement: WASD (forward/back/strafe), mouse or arrow keys to rotate
+- Interaction: approach exit door to trigger win
+
+### HUD
+- Health bar (bottom-left)
+- Ammo count (bottom-right)
+- Current weapon indicator
+- Minimap (top-right corner, toggleable with M key) — shows walls, player position/direction, enemy dots
+- Crosshair at screen center
+- Kill count
+
+## Technical Architecture
+
+### Raycasting Engine
+- Cast one ray per screen column (e.g., 640 rays for 640px wide canvas)
+- DDA algorithm (Digital Differential Analyzer) for fast grid-based wall intersection
+- Wall height = `screenHeight / perpDistance` (fish-eye corrected)
+- Wall color based on wall type value in map grid, darkened by distance (`color * (1 - distance/maxDist)`)
+- North/South walls slightly darker than East/West for depth perception
+- Floor/ceiling: solid colors (no texture mapping needed)
+
+### Sprite Rendering
+- After walls are drawn, render sprites (enemies, pickups, exit door)
+- Sort sprites by distance (far to near), draw back-to-front
+- Each column checks against the wall depth buffer — only draw sprite pixels closer than the wall
+- Sprites scale with distance: `spriteHeight = screenHeight / distance`
+
+### Map Format
+```javascript
+// 0 = empty, 1-4 = wall types (different colors), 9 = exit door
+const MAP = [
+  [1,1,1,1,1,1,...],
+  [1,0,0,0,0,1,...],
+  [1,0,2,0,0,1,...],
+  ...
+];
+// Separate arrays for entity placement
+const ENTITIES = [
+  { type: 'guard', x: 3.5, y: 5.5 },
+  { type: 'soldier', x: 10.5, y: 8.5 },
+  { type: 'shotgun', x: 7.5, y: 3.5 },
+  { type: 'machinegun', x: 15.5, y: 12.5 },
+  { type: 'health', x: 12.5, y: 6.5 },
+];
+```
+
+### Game Loop
+```
+requestAnimationFrame loop:
+  1. Process input (movement, rotation, shooting)
+  2. Update entities (enemy AI, projectiles, animations)
+  3. Cast rays → build wall depth buffer
+  4. Draw ceiling + floor
+  5. Draw walls (column by column)
+  6. Draw sprites (sorted by distance)
+  7. Draw weapon sprite (bottom of screen)
+  8. Draw HUD (health, ammo, minimap, crosshair)
+  9. Check win/lose conditions
+```
+
+### Controls
+| Input | Action |
+|-------|--------|
+| W / ArrowUp | Move forward |
+| S / ArrowDown | Move backward |
+| A | Strafe left |
+| D | Strafe right |
+| ArrowLeft | Rotate left |
+| ArrowRight | Rotate right |
+| Mouse move (pointer lock) | Rotate view |
+| Left click / Space | Shoot |
+| 1, 2, 3 | Switch weapon |
+| Scroll wheel | Cycle weapon |
+| M | Toggle minimap |
+
+Mobile: virtual joystick (left side) + virtual buttons (right side: shoot, weapon switch).
+
+## Files to Create
+
+### Frontend
+1. **`common/doom/doom.js`** (~800-1200 lines) — Complete game engine:
+   - Raycasting renderer
+   - Player movement + collision
+   - Enemy AI + sprite rendering
+   - Weapon system
+   - HUD rendering
+   - Map data
+   - Game state management (MENU → PLAYING → WIN → GAMEOVER)
+   - Score submission + leaderboard display
+   - Built-in md5 for anti-cheat token
+
+2. **`common/doom/doom.css`** — Page layout, canvas styling, leaderboard panel, responsive
+
+### Page Template
+3. **`template/page/doom.php`** — WordPress page template "Doom FPS"
+   - Canvas element (640×480 or responsive)
+   - Start overlay (enter name + start)
+   - Win/GameOver overlay (score, rank, play again)
+   - Leaderboard panel (reuse snake's layout pattern)
+
+### Backend
+4. **`include/doom/install.php`** — DB table `wp_document_doom_scores`
+   ```sql
+   id BIGINT AUTO_INCREMENT PRIMARY KEY
+   player_name VARCHAR(50) NOT NULL
+   score INT NOT NULL DEFAULT 0
+   kills INT NOT NULL DEFAULT 0
+   duration INT NOT NULL DEFAULT 0
+   created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+   INDEX idx_score (score DESC)
+   INDEX idx_created (created_at)
+   ```
+
+5. **`include/doom/api.php`** — AJAX endpoints
+   - `doom_submit` — submit score with anti-cheat token, rate limit
+   - `doom_leaderboard` — alltime (top 20) / weekly (top 10)
+   - Cleanup: top 20 retained, 3-week expiry (same as snake)
+
+## Files to Modify
+
+1. **`include/config.php`** — Add "Doom FPS" to PAGES array:
+   ```php
+   'Doom FPS' => [
+       'template'  => 'template/page/doom.php',
+       'dependent' => [
+           'styles'  => ['/common/doom/doom.css'],
+           'scripts' => ['/common/doom/doom.js'],
+       ]
+   ]
+   ```
+
+2. **`include/themes/theme.php`** — Add includes:
+   ```php
+   include_once $root . '/include/doom/install.php';
+   include_once $root . '/include/doom/api.php';
+   ```
+
+3. **`include/themes/load.php`** — Add inline var injection for Doom:
+   ```php
+   if ( $key === 'Doom FPS' ) {
+       $doom_salt = md5('doom_' . date('Y-m-d') . '_' . wp_salt('auth'));
+       wp_add_inline_script($key, 'window.DOOM_DAY_SALT="'.$doom_salt.'";window.DOOM_AJAX="'.admin_url('admin-ajax.php').'";', 'before');
+   }
+   ```
+
+4. **`README.md`** — Add Doom FPS entry to changelog
+
+## Implementation Order
+
+1. **Raycasting engine** — walls rendering, player movement, collision detection
+2. **Map design** — create the 24x24 map layout
+3. **Weapon system** — 3 weapons, shooting, ammo
+4. **Enemy system** — sprites, AI state machine, combat
+5. **HUD** — health, ammo, minimap, crosshair
+6. **Game states** — menu, playing, win, gameover overlays
+7. **Backend** — DB, API, leaderboard (copy-paste from snake, adjust fields)
+8. **Integration** — config.php, theme.php, load.php, template
+9. **Mobile controls** — virtual joystick + buttons
+10. **Polish** — sound effects (optional), README update
+
+## Verification
+1. Create WP page with "Doom FPS" template → visit as guest → game loads
+2. Enter name → start → WASD movement works, walls render correctly
+3. Find and pick up weapons → ammo shows in HUD
+4. Enemies patrol, detect player, combat works
+5. Kill enemies → find exit → win screen → score submitted → appears in leaderboard
+6. Test alltime/weekly leaderboard tabs
+7. Test mouse pointer lock for smooth rotation
+8. Verify on mobile with virtual controls