chore: 添加 .gitignore,更新 CLAUDE.md,新增网络基础设施科普博客
- 新建 .gitignore:忽略 workspace.json、.superpowers/、OS 文件 - 更新 CLAUDE.md:新增博客发布流程、Halo CLI、Club-Service-Guide 说明 - 新增博客:从输入网址到看见博客——我的网络基础设施全揭秘 - 停止跟踪 .obsidian/workspace.json
This commit is contained in:
@@ -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:` 等
|
||||
|
||||
## 开发命令
|
||||
|
||||
|
||||
Reference in New Issue
Block a user