chore: 添加 .gitignore,更新 CLAUDE.md,新增网络基础设施科普博客

- 新建 .gitignore:忽略 workspace.json、.superpowers/、OS 文件
- 更新 CLAUDE.md:新增博客发布流程、Halo CLI、Club-Service-Guide 说明
- 新增博客:从输入网址到看见博客——我的网络基础设施全揭秘
- 停止跟踪 .obsidian/workspace.json
This commit is contained in:
2026-07-23 22:01:05 +08:00
parent 04d899ca89
commit ffa6cbe4d1
4 changed files with 379 additions and 279 deletions
+83 -1
View File
@@ -4,7 +4,89 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## 项目概述
这是一个 Obsidian vault核心项目是 `obsidian-halo` —— 一个将 Obsidian 笔记发布到 [Halo](https://github.com/halo-dev/halo) 博客平台的社区插件。vault 根目录同时包含 `博客/` 目录存放博客文章草稿。
这是一个 Obsidian vault包含两个主要项目:
- **obsidian-halo** — 将 Obsidian 笔记发布到 [Halo](https://github.com/halo-dev/halo) 博客平台的社区插件
- **Club-Service-Guide** — 河南理工大学人工智能协会内部知识库(独立 Git 仓库,托管于协会 Gitea)
vault 根目录的 `博客/` 目录存放博客文章草稿,通过 Halo CLI 发布到 `blog.liuhangyv.top`
### 博客目录结构
```text
博客/
├── covers/ # 博客封面图片(.png)
├── AI与大模型/ # AI 与大模型相关文章
├── 学术与效率/ # 学术研究与效率工具
├── 数据分析与报告/ # 数据分析与报告相关
├── 机器学习/ # 机器学习理论与应用
├── 编程与工具/ # 编程技巧与工具链
└── 其他/ # 未分类文章
```
## 博客发布
### 发布方式
两种方式均可发布博客文章,优先使用 Halo CLI:
1. **Halo CLI**(推荐)— 从 Markdown 文件直接发布
```bash
# 导入并发布文章(导入后默认为草稿,需手动 publish)
npx halo post import-markdown --file "博客/编程与工具/文章名.md"
# 更新分类、slug 并发布
npx halo post update <post-name> --categories "<category-name>" --slug "slug-name" --publish true
```
2. **obsidian-halo 插件** — 在 Obsidian 编辑器内通过命令面板发布
### Halo CLI 配置文件
当前激活的 profile 是 `aliyun`,指向生产环境 `https://blog.liuhangyv.top`。NAS 本地有 Halo 备份实例(`http://192.168.5.8:8090`profile `local`),用于测试。
```bash
npx halo post list --page 1 --size 20 # 查看文章列表
npx halo post get <name-or-id> # 查看文章详情
npx halo post create --title "标题" --content "内容" --publish true
npx halo post update <name> --categories "..." --tags "..." --publish true
npx halo post tag list # 列出所有标签
npx halo post category list # 列出所有分类
```
### 博客分类与标签(硬约束)
**发布时必须只使用现有分类和标签,禁止创建新的。** 现有 8 个分类和 11 个标签(具体列表见 memory `halo-blog-tags`)。
常用组合:
- 技术教程/工具文章 → 分类 `技术思考`,标签 `技术深潜`+ `零基础入门` 如面向新手)
- 协会活动/通知 → 分类 `协会进行时`,标签 `协会动态`
- AI 科普/入门 → 分类 `成长实验室`,标签 `零基础入门, AI智能体`
### 博客文章 Frontmatter 格式
```yaml
---
title: 文章标题
date: 2026-07-23
author: liuhangyv
category: 技术思考 # 必须从现有 8 个分类中选
tags:
- 技术深潜 # 必须从现有 11 个标签中选
- 零基础入门
excerpt: 文章摘要
---
```
## Club-Service-Guide
`Club-Service-Guide/` 是河南理工大学人工智能协会的内部知识库项目,有独立的 Git 仓库和 CLAUDE.md。
- **Git 远程**: `git@gitea.liuhangyv.top:Serendipity/Club-Service-Guide.git`
- **访问方式**: Obsidian 打开 `Club-Service-Guide/` 目录作为独立 vault
- **链接规范**: 使用标准 Markdown 相对路径(`[文本](路径.md)`),禁用 `[[wiki-link]]`Gitea Web 不渲染)
- **提交格式**: 约定式提交 `docs:` / `feat:`
## 开发命令