# csdn_skill

**Repository Path**: bingjunzhang/csdn_skill

## Basic Information

- **Project Name**: csdn_skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-25
- **Last Updated**: 2026-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# csdn_skill

CSDN 博客自动化技能：让 AI 编码代理（Claude Code / OpenCode 等）直接完成 CSDN 文章的登录、发布、配图全流程，无需手动复制粘贴 Cookie。

## 功能

| 功能 | 状态 | 说明 |
|------|------|------|
| 自动登录 | ✅ | 独立浏览器配置目录 + DevTools 协议自动抓取 Cookie，无需手动粘贴 |
| 文章列表 | ✅ | 拉取自己博客的文章（ID、标题、阅读量、时间） |
| 发布/更新文章 | ✅ | Markdown 自动转 HTML，走 bizapi 签名接口，支持草稿/公开 |
| 封面图 | ✅ | 本地图片自动上传 CSDN 图床并设置为文章封面 |
| 图床 | ✅ | 任意本地图片上传为 `i-blog.csdnimg.cn` 外链 |
| 删除文章 | ❌ | CSDN 改版后删除接口未公开，暂需手动到 [mp.csdn.net](https://mp.csdn.net) 操作 |

## 目录结构

```text
G:\aiBlog\
├── .claude\skills\csdn\          # Claude Code 项目级技能
│   ├── SKILL.md                  # 技能说明（触发词、流程、约束）
│   └── scripts\
│       ├── login.ps1             # 登录 + Cookie 自动抓取
│       ├── cdp-cookie.mjs        # CDP 抓取 Cookie 的 Node 辅助
│       ├── blog.ps1              # list / publish 子命令
│       ├── upload-image.ps1      # 图床上传（PowerShell 版）
│       └── upload_image.py       # 图床上传（Python 版，更稳）
├── articles\                     # 文章源文件与封面
├── docs\csdn-skill.md            # 技能文档
├── progress.md                   # 进度日志
└── csdcn.env                     # 登录 Cookie（已 gitignore，严禁提交）
```

## 快速开始

```powershell
# 1. 登录（弹出浏览器，登录后自动保存 Cookie）
powershell -ExecutionPolicy Bypass -File ".claude\skills\csdn\scripts\login.ps1"

# 2. 查看文章列表
powershell -ExecutionPolicy Bypass -File ".claude\skills\csdn\scripts\blog.ps1" list

# 3. 发布文章（-Draft 存草稿；-CoverImage 设置封面；-ArticleId 更新已有文章）
powershell -ExecutionPolicy Bypass -File ".claude\skills\csdn\scripts\blog.ps1" publish `
  -File "articles\my-article.md" -Title "文章标题" -Tags "docker,rag" `
  -CoverImage "https://i-blog.csdnimg.cn/direct/xxx.png"

# 4. 上传图片到 CSDN 图床
py .claude\skills\csdn\scripts\upload_image.py .\cover.png
```

在 Claude Code / OpenCode 中使用：项目内直接说「发布文章到 CSDN」「查看我的 CSDN 文章列表」即可触发技能。

## 技术要点

- CSDN 无公开 API。发布走 `bizapi.csdn.net/blog-console-api/v3/mdeditor/saveArticle`，需阿里云网关风格的 `x-ca-*` HMAC-SHA256 签名（key/secret 为编辑器前端内置值）。
- Cookie 以结构化 JSON 存储（含 domain），请求时按目标域名精确匹配组装，避免跨子域重名 Cookie 干扰鉴权。
- PowerShell 5.1 的 `Invoke-RestMethod` 会丢弃手动 Cookie 头，发布请求使用 `curl.exe` 发送。
- 正文 `content` 字段必须是渲染后的 HTML，由 Python `markdown` 库转换（`py -m pip install markdown`）。

## 环境要求

- Windows + PowerShell 5.1
- Node.js（CDP 抓取 Cookie）
- Python 3（`markdown` 库）
- Chrome 或 Edge

## 安全提醒

`csdcn.env` 保存的是你的 CSDN 登录凭据，已被 `.gitignore` 排除，请勿提交或外传。

## 相关文章

- [自托管 AI 知识库与联网搜索全套方案：SearXNG + Infinity + R2R + pgvector](https://blog.csdn.net/qq_34929111/article/details/164063632)