# ClaudeHelper

**Repository Path**: KillBugX/claude-helper

## Basic Information

- **Project Name**: ClaudeHelper
- **Description**: Claude教程
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude CLI 完全教程

一个**无依赖、无构建步骤**的静态多页中文教程网站，系统讲解 Claude Code CLI 的 `/命令`、CLI 完全用法、Rules / Skills 配置、MCP / Hooks 工程化实践。直接用浏览器打开 `index.html` 即可使用（支持 `file://` 协议，无需服务器）。

## 在线访问

> ⚠️ **Gitee Pages 已停服**（2025 年前后下线），无法再通过 `用户名.gitee.io` 访问本仓库。仓库文件已就绪（公开、位于根目录、默认分支 `master`），可托管到任意免费静态平台，**无需改动任何代码**。

## 内容篇章

| 篇章 | 页面 | 内容 |
|---|---|---|
| 🚀 入门篇 | `index.html` | 认识 Claude CLI 与交互界面、12 个高频斜杠命令、6 个经典使用场景 |
| 🗂 命令速查 | `commands.html` | 84 条斜杠命令的分类速查表与快速查询 |
| 🚀 高阶篇 | `advanced.html` | CLI 命令行完全用法、Rules / CLAUDE.md 记忆系统、Skills 技能、8 条进阶工作流 |
| 👑 精通篇 | `mastery.html` | MCP 外部服务、Hooks 自动化、插件与子代理、Settings 权限模型、生产力秘籍 |

每篇末尾附 8 题考核，得分 ≥60% 即通过，计入学习进度。

## 功能特性

- 🎨 **8 套配色 × 深浅两态**：经典橙 / 蓝 / 绿 / 紫 / 玫瑰 / 琥珀 / 石板 / 松绿
- 🔍 **全站搜索**：跨四个页面即时检索章节与命令
- 📊 **学习进度追踪**：按章节完成 + 考核通过累计全站点数
- 👤 **本地账号系统**：注册 / 登录，分账号保存阅读进度、主题与搜索历史（纯前端演示，无后端）
- 🏷 **章节标签与场景标签**：章节、场景、命令均带分类标签

## 本地使用

直接用浏览器打开 `index.html`，无需安装任何依赖或启动服务器。

## 免服务器部署（任选其一）

| 平台 | 说明 | 国内访问 |
|---|---|---|
| 腾讯 **EdgeOne Pages** | 免费、支持关联仓库或直接上传文件 | 快（推荐） |
| 阿里云 **ESA Pages** | 免费、无限制 | 快 |
| **Cloudflare Pages** | 免费、全球节点、支持关联仓库 | 建议绑定自定义域名 |
| **GitHub Pages** | 免费、仍可用 | 不稳定 |

以 EdgeOne Pages 为例：控制台 → Pages → 创建项目 → 关联本仓库（或直接上传四个 `*.html` + `assets/` 目录）→ 选择 `master` 分支 → 发布，得到 `https://<项目名>.edgeone.app`。

## 部署到宝塔（有服务器时）

1. 宝塔「网站」新建**纯静态**站点（无需 PHP/MySQL）。
2. 上传全部文件（四个 `*.html` + `assets/` 目录）到站点根目录。
3. 开启 SSL，通过 `https://你的域名/` 访问。

## 维护命令

- **重建全站搜索索引**（改动了页面内容 / `commands-data.js` / 任一 quiz 后必须执行）：
  ```bash
  node _build_search.js
  ```
- **JS 语法检查**：
  ```bash
  node --check assets/app.js
  node --check assets/commands-data.js
  node --check assets/search-data.js
  ```

## 技术说明

- **纯静态、零依赖**：无 `package.json`、无构建步骤、无测试框架，可运行于 `file://` 协议。
- **数据以 `window.*` 全局注入**：因 `file://` 下 `fetch()` 会被浏览器 CORS 拦截，所有数据（搜索索引、命令、考核题）通过 `<script>` 标签按固定顺序注入。
- **无后端**：账号、进度、主题、搜索历史均存储在浏览器 `localStorage` 中，属前端演示方案。