# python-notes

**Repository Path**: coderlee123/python-notes

## Basic Information

- **Project Name**: python-notes
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-01
- **Last Updated**: 2026-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🐚 拾贝

**捡拾知识之贝，串成自己的星空**

[![GitHub](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.8+-3776AB)](https://python.org)

</div>

---

## 📖 简介

拾贝是一个极简的**个人学习笔记网站**。所有笔记以 Markdown 格式存储，浏览器直接加载渲染，无需后端、无需构建工具。

目前收录了 **Python 基础**（7 节）和 **Hermes Agent**（12 节）课程，并预留了 AI、网络、爬虫、数据分析、渗透测试等模块的扩展位置。

---

## 🌟 特性

- **Markdown 即笔记** — 用 `.md` 写笔记，刷新浏览器即生效
- **按需加载** — 只看当前课程，不一次下载全部
- **多主题切换** — 深色/护眼/日间/高对比 四种阅读模式
- **模块化目录** — 动态从 `index.json` 读取，加课不加代码
- **纯前端** — 一个 HTTP 服务器就够了，零后端依赖
- **自适应** — 桌面 / 移动端均可浏览

---

## 🚀 快速开始

```bash
# 1. 克隆
git clone https://gitee.com/coderlee123/python-notes.git
cd python-notes

# 2. 启动（任一方式）
python3 -m http.server 8080
# 或
npx serve .
# 或
php -S localhost:8080

# 3. 打开浏览器
open http://localhost:8080
```

> 不需要安装任何 Python 包，`http.server` 是 Python 标准库。

---

## 📂 目录结构

```
python-notes/
├── index.html             # 网站骨架（7KB）
├── data/
│   └── index.json         # 课程目录配置
├── js/
│   ├── app.js             # 核心逻辑
│   ├── parser.js          # Markdown → HTML 渲染器
│   └── particles.js       # 粒子动画
└── notes/                 # 所有笔记（.md）
    ├── python/            # Python 基础（7节）
    ├── hermes/            # Hermes Agent（12节）
    ├── ai/                # 待扩展
    ├── network/           # 待扩展
    ├── scraper/           # 待扩展
    ├── data-science/      # 待扩展
    └── pentest/           # 待扩展
```

---

## ✍️ 添加新课程

```bash
# 1. 写笔记
vim notes/python/08-文件操作.md

# 2. 在 data/index.json 中注册
```

```json
{
  "id": 8,
  "title": "文件操作",
  "subtitle": "Python 零基础入门 · 第八节",
  "file": "notes/python/08-文件操作.md",
  "tags": ["基础", "文件", "IO"]
}
```

```bash
# 3. 刷新浏览器，新课程自动出现在侧边栏
```

---

## 🎨 阅读模式

点击右下角 🎨 按钮切换：

| 模式 | 适用场景 |
|------|---------|
| 🌙 默认深色 | 夜间/暗光环境 |
| 👁️ 护眼模式 | 长时间阅读 |
| ☀️ 日间模式 | 强光环境 |
| 🔲 高对比 | 追求清晰度 |

选择自动保存在浏览器中，下次打开自动恢复。

---

## 🧩 添加新模块

想新增一个模块（如"Go 语言"）：

```json
{
  "modules": {
    "go": {
      "name": "Go 笔记",
      "icon": "🔵",
      "logo": "Go",
      "accent": "#00add8",
      "accent2": "#00add8",
      "subtitle": "Go 语言学习笔记",
      "sections": [
        {
          "title": "基础篇",
          "lessons": [
            {"id": 1, "title": "Go 简介", "file": "notes/go/01-intro.md", "tags": ["入门"]}
          ]
        }
      ]
    }
  }
}
```

然后在 `notes/` 下创建 `go/` 目录，放笔记文件即可。

---

## 🛠️ 技术栈

| 层 | 技术 |
|----|------|
| 前端 | 原生 HTML / CSS / JS |
| 数据 | JSON（目录结构）+ Markdown（内容） |
| 渲染 | 自写 Markdown 解析器 |
| 服务 | Python `http.server` |
| 动画 | Canvas 粒子系统 |
| 存储 | `localStorage`（主题偏好） |

---

## 📜 许可

MIT License

---

<div align="center">
  
**拾贝** · 用笔记丈量知识的广度

</div>