📢 说明: 本文同步自 GitHub 项目 csdn-publisher
🚀 CSDN 自动发布神器 – AI 时代的内容创作加速器
用自动化释放创造力,让内容传播更高效
[ 
快速开始 • 核心功能 • 使用场景 • API 文档 • 故障排除 • 更新日志
👨💻 作者简介
翁勇刚 WENG YONGGANG
🎓 Universiti Teknologi Malaysia(马来西亚理工大学)
🧠 NeuroConscious Transformer (NCT) 意识解码神经网络框架发明人
📖 项目简介
还在手动复制粘贴发布博客?Out 了!
CSDN Publisher 是一款基于 Playwright 的浏览器自动化发布工具,专为技术博主、内容创作者和开发者打造。它能将你的 Markdown 文章、代码文档、AI 生成内容一键自动发布到 CSDN 博客平台,让内容创作效率提升 10 倍!
💡 为什么需要这个工具?
- ✍️ 技术博主: 批量发布系列文章,不再重复劳动
-
- 🤖 AI 创作者: 直接发布 AI 生成的技术文档,无缝衔接
-
- 📝 开源作者: 从代码自动生成 API 文档并发布
-
- ⚡ 效率达人: 定时发布、批量操作,解放双手
✨ 核心功能
🎯 强大的内容处理能力
| Markdown 解析 | 完美支持标准 Markdown 语法 | ✅ |
| 代码高亮 | 自动识别编程语言并应用高亮 | ✅ |
| 图片上传 | 提取本地图片并自动上传到 CSDN | ✅ |
| AI 内容生成 | 根据大纲智能创作完整文章 | ✅ |
| 代码文档化 | 从 Python 代码生成 API 文档 | ✅ |
🤖 浏览器自动化黑魔法
- 🔐 Cookie 持久登录: 一次设置,永久免登录,彻底规避验证码
-
- 🎭 真实用户模拟: 精确模拟人类操作行为,避免被检测为机器人
-
- 🔄 智能错误恢复: 网络异常、页面超时自动重试,鲁棒性极强
-
- 🎨 富文本编辑: 自动处理 CSDN 编辑器,支持复杂格式排版
🛡️ 企业级可靠性
# 内置智能重试机制
@retry(
stop=stop_after_attempt(3), # 最多重试 3 次
wait=wait_exponential(multiplier=1, min=2, max=10), # 指数退避
retry=retry_if_exception_type(CSDNPublishError) # 只重试特定错误
)
async def publish_with_retry(...):
...
```
–––
## 🔥 快速开始
### 1️⃣ 安装依赖(30 秒搞定)
```bash
# 克隆项目
git clone https://github.com/wyg5208/csdn–publisher.git
cd csdn–publisher
# 安装 Python 依赖
pip install –r requirements.txt
# 安装 Playwright 浏览器
playwright install chromium
# 完成!就这么简单
2️⃣ 首次设置:保存 Cookie(关键步骤)
这是避免验证码的核心技巧! 只需执行一次,后续都能自动登录。
from csdn_publisher import CSDNPublisher
import asyncio
async def setup_cookies():
"""首次运行时保存登录 Cookie"""
publisher = CSDNPublisher(headless=False) # 显示浏览器窗口
try:
await publisher.initialize()
print("👉 请在打开的浏览器中登录 CSDN 账号…")
# 跳转到 CSDN 并等待登录
await publisher.page.goto('https://i.csdn.net/')
# 60 秒内等待登录成功
await publisher.page.wait_for_url('https://www.csdn.net/*', timeout=60000)
# 保存 Cookie 到本地
await publisher._save_cookies('csdn_cookies.json')
print("✅ Cookie 已保存!下次运行无需再登录!")
except Exception as e:
print(f"❌ 设置失败:{e}")
finally:
await publisher.close()
# 执行设置
asyncio.run(setup_cookies())
运行后会:
3️⃣ 发布第一篇文章(见证奇迹的时刻)
方式 A:直接发布 Markdown 内容
import asyncio
from csdn_publisher import CSDNPublisher
async def main():
# 创建发布器实例(headless=True 表示后台运行,不显示浏览器)
publisher = CSDNPublisher(headless=True)
try:
await publisher.initialize()
# 使用保存的 Cookie 自动登录
await publisher.login(cookie_path='csdn_cookies.json')
# 发布文章
article_url = await publisher.publish_article(
title="🔥 Python 自动化神器:10 分钟搞定 CSDN 批量发文",
content="""
# 引言
你是否曾经为了发布系列博客而头疼?…
## 核心技术点
### 1. Playwright 浏览器自动化
```python
from playwright.async_api import async_playwright
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
await page.goto('https://blog.csdn.net')
```
### 2. Cookie 持久化登录
通过保存登录后的 Cookie,可以…!
> **金句**: 自动化不是偷懒,而是把时间花在更有价值的地方

## 总结
掌握这个工具,让你的内容创作效率起飞!
""",
category="人工智能", # CSDN 分类
tags=["Python", "自动化", "效率工具", "AI"], # 标签
is_original=True, # 标记原创
description="介绍如何使用 Python 和 Playwright 实现 CSDN 自动发布" # 简短描述
)
print(f"🎉 发布成功!文章链接:{article_url}")
except Exception as e:
print(f"❌ 发布失败:{e}")
finally:
await publisher.close()
# 开始发布
asyncio.run(main())
方式 B:从本地 Markdown 文件读取
# 假设你有一个写好的 Markdown 文件
url = await publisher.publish_from_file(
file_path="docs/python_automation_guide.md",
category="编程开发",
tags=["Python", "自动化测试", "最佳实践"],
is_original=True
)
print(f"文章已发布:{url}")
```
#### 方式 C:从代码生成文档并发布
```python
from csdn_publisher import extract_code_docs, generate_blog_post
# 提取 Python 模块的文档
docs = extract_code_docs("src/my_awesome_module.py")
# 生成博客文章格式
content = generate_blog_post(docs, include_examples=True)
# 发布
url = await publisher.publish_article(
title="MyAwesomeModule: 超好用的 Python 工具库",
content=content,
category="开源项目",
tags=["Python", "开源", "API 文档"]
)
```
–––
## 🎨 使用场景实战
### 场景 1️⃣:批量发布系列技术文章
你有 10 篇 AI 技术教程要发布,手动搞?太 low 了!
```python
from pathlib import Path
import asyncio
from csdn_publisher import CSDNPublisher
async def batch_publish_series():
publisher = CSDNPublisher(headless=True)
await publisher.initialize()
await publisher.login('csdn_cookies.json')
# 批量发布整个系列
article_files = sorted(Path("docs/ai_series").glob("*.md"))
for index, md_file in enumerate(article_files, 1):
print(f"📝 正在发布第 {index}/{len(article_files)} 篇…")
try:
url = await publisher.publish_from_file(
file_path=str(md_file),
category="人工智能",
tags=["AI 教程", "深度学习", f"第{index}讲"],
is_original=True
)
print(f"✅ 第 {index} 篇发布成功:{url}")
except Exception as e:
print(f"❌ 第 {index} 篇失败:{e}")
continue
# 智能延迟,避免触发反爬机制
await asyncio.sleep(8)
await publisher.close()
print("🎊 全部发布完成!")
asyncio.run(batch_publish_series())
场景 2️⃣:定时自动发布(每天晚 8 点准时更新)
import schedule
import asyncio
from datetime import datetime
async def daily_publish_task():
"""每日自动发布任务"""
publisher = CSDNPublisher(headless=True)
await publisher.initialize()
await publisher.login('csdn_cookies.json')
# 获取今日要发布的文章
today = datetime.now().strftime("%Y-%m-%d")
article_file = f"docs/daily/{today}.md"
if Path(article_file).exists():
url = await publisher.publish_from_file(
file_path=article_file,
category="技术分享",
tags=["每日更新", "技术随笔"]
)
print(f"📅 今日文章已发布:{url}")
else:
print("ℹ️ 今日暂无文章")
await publisher.close()
# 设置每天 20:00 自动执行
schedule.every().day.at("20:00").do(
lambda: asyncio.run(daily_publish_task())
)
print("⏰ 定时发布任务已启动,按 Ctrl+C 退出…")
while True:
schedule.run_pending()
asyncio.sleep(60)
```
### 场景 3️⃣:AI 辅助创作 + 自动发布
结合 ChatGPT/通义千问等 AI,实现内容创作流水线!
```python
from openai import OpenAI
async def ai_powered_publishing(topic):
"""AI 驱动的智能发布流程"""
client = OpenAI(api_key="your-api-key")
publisher = CSDNPublisher(headless=True)
await publisher.initialize()
await publisher.login('csdn_cookies.json')
# Step 1: AI 生成文章大纲
outline_response = client.chat.completions.create(
model="gpt-4",
messages=[{
"role": "user",
"content": f"请为'{topic}'主题生成一篇技术博客的详细大纲,包含引言、核心技术点、实战案例、总结"
}]
)
outline = outline_response.choices[0].message.content
# Step 2: AI 根据大纲撰写全文
article_response = client.chat.completions.create(
model="gpt-4",
messages=[{
"role": "system",
"content": "你是一位资深技术博主,擅长写深入浅出的高质量技术文章"
}, {
"role": "user",
"content": f"请根据以下大纲撰写完整的技术博客:\\n\\n{outline}"
}]
)
article_content = article_response.choices[0].message.content
# Step 3: 自动发布到 CSDN
url = await publisher.publish_article(
title=f"🤖 AI 深度解析:{topic}",
content=article_content,
category="人工智能",
tags=["AI", "AIGC", topic],
is_original=True
)
print(f"✨ AI 创作并发布成功:{url}")
await publisher.close()
# 使用示例
asyncio.run(ai_powered_publishing("Transformer 架构详解"))
场景 4️⃣:从 GitHub README 同步到 CSDN
import requests
async def sync_github_to_csdn(repo_url):
"""将 GitHub 项目 README 同步到 CSDN"""
# 提取 GitHub 用户名和仓库名
parts = repo_url.strip('/').split('/')
owner, repo = parts[–2], parts[–1]
# 获取 README 内容
readme_url = f"https://raw.githubusercontent.com/{owner}/{repo}/main/README.md"
response = requests.get(readme_url)
readme_content = response.text
publisher = CSDNPublisher(headless=True)
await publisher.initialize()
await publisher.login('csdn_cookies.json')
# 发布
url = await publisher.publish_article(
title=f"🚀 开源项目推荐:{repo}",
content=f"> 本文同步自 GitHub: {repo_url}\\n\\n" + readme_content,
category="开源项目",
tags=["GitHub", "开源", "项目推荐"],
is_original=False # 注明非原创
)
print(f"📦 项目同步完成:{url}")
await publisher.close()
asyncio.run(sync_github_to_csdn("https://github.com/wyg5208/csdn-publisher"))
📚 API 参考
CSDNPublisher 类
初始化参数
publisher = CSDNPublisher(
headless=True, # 是否后台运行(不显示浏览器)
timeout=60, # 操作超时时间(秒)
proxy=None # 代理配置(可选)
)
```
#### 核心方法
| 方法 | 参数 | 返回值 | 描述 |
|––––––|––––––|––––––––|––––––|
| `initialize()` | 无 | None | 初始化浏览器实例 |
| `login(cookie_path)` | cookie_path: str | None | 使用 Cookie 登录 |
| `publish_article(...)` | 见下方 | str | 发布文章,返回 URL |
| `publish_from_file(...)` | file_path: str | str | 从文件发布 |
| `close()` | 无 | None | 关闭浏览器 |
#### publish_article 详细参数
```python
async def publish_article(
title: str, # 文章标题(必填)
content: str, # Markdown 内容(必填)
category: str = "未分类", # 文章分类
tags: List[str] = [], # 标签列表
is_original: bool = True, # 是否原创
description: str = "", # 简短描述
cover_image_path: str = None # 封面图片路径
) –> str: # 返回发布后的文章 URL
```
### 工具函数
```python
# 从 Python 代码提取文档
def extract_code_docs(file_path: str) –> dict:
"""提取 Python 文件的类、函数、文档字符串"""
...
# 生成博客文章格式
def generate_blog_post(
docs: dict,
include_examples: bool = True
) –> str:
"""将代码文档转换为博客文章"""
...
# 处理 Markdown 图片
def extract_markdown_images(content: str) –> List[Tuple[str, str]]:
"""提取 Markdown 中的图片信息"""
...
```
–––
## 🔧 高级配置
### 环境变量(.env 文件)
在项目根目录创建 `.env` 文件:
```bash
# Cookie 文件路径(推荐)
CSDN_COOKIE_PATH=csdn_cookies.json
# 浏览器配置
CSDN_HEADLESS=true # 后台运行
BROWSER_TIMEOUT=60 # 超时时间(秒)
# 代理配置(如需要)
# HTTP_PROXY=http://proxy.example.com:8080
# HTTPS_PROXY=http://proxy.example.com:8080
# 发布配置
DEFAULT_CATEGORY="技术分享" # 默认分类
DEFAULT_TAGS=["原创", "技术"] # 默认标签
MAX_RETRY_ATTEMPTS=3 # 最大重试次数
自定义重试策略
from tenacity import (
retry,
stop_after_attempt,
wait_exponential,
retry_if_exception_type
)
# 定义自定义重试装饰器
def auto_retry(func):
return retry(
stop=stop_after_attempt(5), # 重试 5 次
wait=wait_exponential(multiplier=2, min=4, max=30), # 等待时间递增
retry=retry_if_exception_type((ConnectionError, TimeoutError))
)(func)
# 使用
@auto_retry
async def robust_publish(publisher, **kwargs):
return await publisher.publish_article(**kwargs)
```
–––
## 🐛 故障排除
### 问题 1:遇到验证码怎么办?
**症状**: 登录时提示需要滑块验证或手机验证
**解决方案**:
```bash
# 确保已正确保存 Cookie
cat csdn_cookies.json # 检查文件是否存在且不为空
# 重新执行 Cookie 设置流程
python scripts/setup_cookies.py
预防: 始终使用 Cookie 方式登录,避免频繁使用账号密码登录触发风控。
问题 2:找不到页面元素(选择器失效)
症状: TimeoutError: Timeout 60000ms exceeded. 或 Element not found
原因: CSDN 更新了网页结构,原有 CSS 选择器失效
解决方案:
旧的选择器
新的选择器(根据实际页面调整)
TITLE_INPUT = ‘input.el-input__inner’ # 或其他有效选择器
3. **使用开发者工具定位**:
4. – F12 打开开发者工具
5. – 使用选择器工具点击目标元素
6. – 复制 CSS Selector 或 XPath
### 问题 3:发布失败但无明确错误
**可能原因及解决**:
| 原因 | 检查方法 | 解决方案 |
|——|———-|———-|
| 内容含敏感词 | 手动复制到 CSDN 测试 | 修改措辞,避免政治、广告等敏感内容 |
| 分类不存在 | 检查 category 参数 | 使用 CSDN 现有分类(如"人工智能"、"编程开发") |
| 标签数量超限 | 检查 tags 列表长度 | 控制在 5 个以内 |
| Cookie 过期 | 检查 Cookie 文件时间戳 | 重新运行 `setup_cookies.py` |
| 网络问题 | 查看异常堆栈 | 检查网络连接,配置代理 |
### 问题 4:图片上传失败
**症状**: 文章内容发布成功,但图片显示裂开
**解决方案**:
```python
# 方法 1: 使用在线图片床
markdown_content = """

"""
# 方法 2: 确保本地图片路径正确
markdown_content = """

"""
# 工具会自动提取并上传
# 方法 3: 手动上传后替换 URL
# 先在 CSDN 上传图片,复制 URL 后替换 Markdown 中的链接
💡 最佳实践
1. 内容质量优先
# ❌ 避免:低质量批量灌水
for i in range(100):
await publisher.publish_article(title=f"垃圾文章{i}", content="…")
# ✅ 推荐:精心打磨每篇文章
articles = [
{"title": "深入理解 Transformer", "quality": "high"},
{"title": "Python 异步编程指南", "quality": "high"},
]
for article in articles:
await publisher.publish_article(...)
await asyncio.sleep(30) # 充分间隔
```
### 2. 发布时间策略
```python
# 黄金时间段(流量高峰)
BEST_PUBLISH_TIMES = [
"08:00", # 早高峰
"12:00", # 午休
"20:00", # 晚高峰
"22:00" # 睡前
]
# 使用 schedule 库定时发布
for time in BEST_PUBLISH_TIMES:
schedule.every().day.at(time).do(publish_task)
```
### 3. SEO 优化技巧
```python
await publisher.publish_article(
title="🔥 2024 最新 Python 异步编程完全指南", # 吸引眼球 + 关键词
content=content,
category="Python",
tags=["Python", "异步编程", "asyncio", "实战教程"], # 精准标签
description="本文系统讲解 Python 异步编程的核心概念、async/await 语法、aiohttp 实战…" # SEO 描述
)
```
### 4. 安全与合规
– ⚠️ **不要发布**: 涉政、涉黄、暴力、广告营销等违规内容
– – ⚠️ **控制频率**: 单账号每天发布不超过 20 篇,间隔至少 3 分钟
– – ⚠️ **原创优先**: 尽量发布原创或获授权内容,避免版权纠纷
– – ⚠️ **保管凭证**: Cookie 文件等同于账号密码,切勿泄露
–––
## 📊 性能对比
| 发布方式 | 单篇耗时 | 10 篇总耗时 | 错误率 |
|––––––––––|––––––––––|–––––––––––––|––––––––|
| **人工手动** | ~5 分钟 | ~50 分钟 | 0% |
| **本工具(单线程)** | ~30 秒 | ~5 分钟 | <2% |
| **本工具(批量)** | ~30 秒 | ~5 分钟 | <2% |
**效率提升**: **10 倍+** 🚀
–––
## 🗺️ 项目结构
csdn-publisher/ ├── 📄 README.md # 你正在看的文档 ├── 📄 QUICKSTART.md # 5 分钟极简上手指南 ├── 📄 requirements.txt # Python 依赖清单 ├── 🐍 csdn_publisher.py # 核心发布引擎(35KB) ├── 🐍 csdn_cover_generator.py # 封面图生成器(可选) ├── 📁 scripts/ # 实用脚本工具集 │ ├── setup_cookies.py # Cookie 设置助手 │ └── batch_publish.py # 批量发布脚本 ├── 📁 examples/ # 示例代码(v1.1.0 新增) │ ├── README.md # 示例使用指南 │ ├── demo_examples.py # 综合演示 │ ├── 01_basic_publish.py # 基础发布 │ ├── 02_publish_from_file.py # 从文件发布 │ ├── 03_publish_from_code.py # 从代码生成文档 │ ├── scenario_01_batch_publish.py # 批量发布 │ ├── scenario_02_scheduled_publish.py # 定时发布 │ ├── scenario_03_ai_powered_publish.py # AI 创作 │ └── scenario_04_github_sync.py # GitHub 同步 ├── 📁 tests/ # 测试用例(开发用) ├── 📁 docs/ # 文档资料库 │ ├── AI_Agent内容创作工作坊 18 篇/ │ ├── 博客图片库/ │ └── temp/ # 临时文件 └── 📁 .qoder/ # IDE 配置(可忽略)
—
## 🤝 贡献指南
欢迎提交 Issue 和 Pull Request!
### 如何贡献
1. Fork 本仓库
2. 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 5. 开启 Pull Request
### 报告 Bug
发现 Bug?请按以下格式提交 Issue:
```markdown
**问题描述**
简明扼要描述问题
**复现步骤**
1. 执行 '…'
2. 2. 点击 '…'
3. 3. 看到错误 '…'
**期望行为**
应该发生什么
**截图**
如有,附上截图
**环境信息**
– Python 版本:3.x
– – 操作系统:Windows/Mac/Linux
– – Playwright 版本:x.x.x
– ```
—
## 📜 许可证
本项目采用 MIT 许可证 – 详见 [LICENSE](LICENSE) 文件
**简单来说**: 你可以自由地使用、修改、分发这个软件,只要保留原作者的版权声明即可。
—
## 📝 更新日志
### v1.1.0 (2026-03-14) – 🎉 示例代码工程化升级
#### ✨ 新增功能
**完整的示例代码集**:
– ✅ **基础示例** (`01_basic_publish.py`) – 直接发布 Markdown 内容的完整演示
– – ✅ **文件发布** (`02_publish_from_file.py`) – 从 Markdown 文件读取并发布
– – ✅ **代码文档化** (`03_publish_from_code.py`) – 从 Python 代码生成 API 文档并发布
– – ✅ **批量发布** (`scenario_01_batch_publish.py`) – 系列文章批量发布实战
– – ✅ **定时发布** (`scenario_02_scheduled_publish.py`) – 每天自动发布任务
– – ✅ **AI 辅助创作** (`scenario_03_ai_powered_publish.py`) – 结合 GPT-4 智能写作
– – ✅ **GitHub 同步** (`scenario_04_github_sync.py`) – README 多平台分发
**配套文档**:
– ✅ `examples/README.md` – 完整的示例使用指南
– – ✅ 每个脚本都包含详细的注释和使用说明
– – ✅ 所有示例通过语法检查,确保可运行
**依赖库更新**:
– ✅ 新增 `schedule>=1.2.0` – 定时任务支持
– – ✅ 新增 `requests>=2.31.0` – HTTP 请求(GitHub 同步)
– – ✅ 新增 `openai>=1.0.0` – OpenAI API 集成
#### 🔧 优化改进
– 📖 **README 专业化升级**:添加技术栈图标、作者简介、性能对比表
– – 🎯 **示例与文档一一对应**:README 中所有代码示例都有对应的独立脚本
– – 📦 **工程化组织**:examples 目录结构清晰,分类明确
– – 🛡️ **错误处理完善**:所有示例都包含完整的异常处理和日志输出
#### 📊 数据统计
新增文件:9 个 新增代码量:~1,719 行 覆盖场景:100% README 提到的所有用例 示例总数:8 个独立脚本 + 1 个综合演示
#### 🎯 使用建议
**新手入门路径**:
1. `python examples/demo_examples.py` – 了解基本功能
2. 2. `python examples/01_basic_publish.py` – 体验完整流程
3. 3. 根据需求选择对应的场景脚本
4. 4. 修改示例内容,发布自己的文章
—
### v1.0.0 (首次发布) – 🚀 CSDN 自动发布工具
#### 🎯 核心功能
– ✅ 基于 Playwright 的浏览器自动化
– – ✅ Cookie 持久登录,避免验证码
– – ✅ Markdown 文章发布
– – ✅ 图片自动上传
– – ✅ 智能重试机制
– – ✅ 批量发布支持
– – ✅ 代码文档提取
—
## 🙏 致谢
感谢以下开源项目:
– [Playwright](https://playwright.dev/) – 强大的浏览器自动化工具
– – [Tenacity](https://tenacity.readthedocs.io/) – 优雅的重试机制
– – [Python](https://www.python.org/) – 最好的编程语言
—
## 📬 联系方式
– **作者**: wyg5208
– – **GitHub**: [@wyg5208](https://github.com/wyg5208)
– – **项目地址**: https://github.com/wyg5208/csdn-publisher
– – **Issue 反馈**: https://github.com/wyg5208/csdn-publisher/issues
—
<div align="center">
**如果这个项目对你有帮助,请给一个 ⭐ Star 支持一下!**
你的支持是我持续优化的动力 💪
Made with ❤️ by wyg5208
</div>
—
**原文链接**: https://github.com/wyg5208/csdn-publisher
**作者**: wyg5208
**许可证**: MIT (或其他开源协议)



