# CLAUDE.md — notebook 维护说明

## ⚠️ 最重要：敏感信息

知识库内容会被部署到公网，**禁止包含任何敏感信息**，包括但不限于：
- 公网 IP 地址
- 密码、API Key、Token
- 加密密钥（私钥、公钥、UUID、ShortID 等）
- SSH 密钥路径或内容
- VPN/代理服务的连接凭据（如 Shadowrocket 配置）
- 路由器/设备管理密码
- 任何可用于攻击服务器或网络的信息

技术文档只保留：**架构、方法、命令模板、已知问题、解决思路**。具体 IP/密钥/密码用占位符（如 `<VPS IP>`）代替或直接删除。

## 维护方式

- **用户**：kurihada，主要口述内容，由 Claude 完成写作
- **Claude**：负责写作、排版、组织文件结构、更新导航
- **语言**：简体中文

## 技术栈

- MkDocs Material 构建
- 源文件：`docs/` 下的 Markdown
- 构建输出：`site/`（已在 .gitignore 中忽略）
- 配置：`mkdocs.yml`

## 文件组织

- 每个分类一个目录，index.md 作为分类概览
- 具体主题拆成独立 `.md` 文件，放在对应分类目录下
- `assets/` 放图片等附件
- 新增文件后需同步更新 `mkdocs.yml` 的 `nav:` 部分

## 每次编辑后

```bash
cd ~/notebook && mkdocs build   # 重新构建 site/
git add -A && git commit -m "描述改动"
```