CSDN Publisher v3.0 — 最简成功路径

✅ 已验证的成功路径

1. python scripts/csdn_publish.py <markdown文件> [--title "标题"]
2. 未登录 → 自动生成微信二维码 → 扫码后自动保存 storage_state
3. 登录后 → 打开编辑器 → 注入内容 → 点发布
4. 操作 modal 弹窗（设置原创/摘要/AI声明）→ 发布成功

🎯 一键发布

cd ~/.hermes/skills/csdn-publisher
python scripts/csdn_publish.py /tmp/article.md --title "文章标题"

效果： 首次扫码登录，之后直接复用 storage_state，无需再次登录。

🔑 关键技术突破

📋 核心流程

1. 登录（仅首次）

# 微信扫码 → passport 处理 → 保存 storage_state
ctx = browser.new_context(...)
page.goto(WX_URL)
# 扫码后等待 passport 页面完成登录
for i in range(30):
    page.wait_for_timeout(1000)
    ck = {c["name"]: c["value"] for c in ctx.cookies()}
    if "UserName" in ck and "UserNick" in ck:
        ctx.storage_state(path=STORAGE_STATE)
        break

2. 发布（复用 storage_state）

ctx = browser.new_context(storage_state=STORAGE_STATE)

# 拦截 quality-score
import re
def intercept(route):
    if 'get-quality-score' in route.request.url:
        route.fulfill(status=200, content_type='application/json;charset=UTF-8',
            body=json.dumps({"code": 200, "data": {"qualityScore": 92, "pass": True, "recommendPublish": True}}))
    else:
        route.continue_()
ctx.route(re.compile(r'get-quality-score'), intercept)

# 打开编辑器
page.goto("https://editor.csdn.net/md/")
page.evaluate("() => { document.querySelectorAll('[class*=\"passport\"]').forEach(el => el.remove()); }")

# 注入 title + content
page.evaluate(f"() => {{ const inp = document.querySelector('input[placeholder*=\"标题\"]'); ... }}")
page.evaluate(f"() => {{ const el = document.querySelector('pre.editor__inner'); ... }}")

# 点发布 → 操作 modal
page.evaluate("() => { document.querySelector('.btn-publish').click(); }")
page.wait_for_timeout(3000)

# modal 操作（关键！）
page.evaluate("""() => {
  const modal = document.querySelector('.modal');
  // 设原创
  modal.querySelector('input[value="original"]').click();
  // 填摘要
  const ta = modal.querySelector('textarea');
  Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value').set.call(ta, '摘要内容');
  ta.dispatchEvent(new Event('input', {bubbles: true}));
}

# 添加标签（新！关键！）
# 1. 点按钮打开面板
modal.querySelector('button.tag__btn-tag').click();
await page.wait_for_timeout(1500)
# 2. 点 el-tag 芯片（不是左侧分类tab！）
page.evaluate("""() => {
  const tags = document.querySelector('.mark_selection_box .el-tag');
  tags.click();  // 点第一个可见标签
}""")
# 3. 关闭面板（否则覆盖发布按钮）
page.evaluate("() => { document.querySelector('.mark_selection_box').style.display = 'none'; }")
await page.wait_for_timeout(500)

# 点发布
page.evaluate("""() => {
  const btns = document.querySelector('.modal').querySelectorAll('button');
  for (const b of btns) {
    if (b.textContent.trim() === '发布文章') { b.click(); break; }
  }
}""")

📁 脚本

scripts/csdn_publish.py    # 🏆 一键发布脚本（带自动登录 + 图片上传）
scripts/csdn_delete.py     # 一键删除文章
scripts/csdn_wechat_login.py  # 仅登录
scripts/inject-content.js  # 内容注入 JS

编辑已有文章

python scripts/csdn_publish.py article.md --title "标题" --article-id 160913376

⚡ 配置

pip install playwright -i https://pypi.org/simple/
playwright install chromium

🚨 常见问题

🖼 图片处理 — 自动上传 CSDN 图床

> 核心原则：所有图片必须上传到 CSDN 图床（i-blog.csdnimg.cn），不允许直接引用外部 URL。

>

> 发布脚本已内置自动处理：扫描 Markdown → 下载网络图片 → 上传 CSDN 图床 → 替换 URL。

> 全程自动化，无需手动操作。

自动流程（无需手动）

# 直接运行，脚本会自动处理所有图片
python scripts/csdn_publish.py article.md --title "标题"

脚本自动完成：

1. 扫描 !alt 提取所有图片
2. 过滤掉已经是 CSDN 图床的 URL（不重复上传）
3. 自动下载网络图片到 /tmp/csdn_images/
4. 通过编辑器 modal 逐个上传到 CSDN（选文件 → 自动上传 → 捕获图床 URL）
5. 替换文章内容中的旧 URL → 注入最终内容 → 发布

图片上传参数

图片上传技术细节

# 核心操作（Playwright）
page.locator('.uploadPicture input[type="file"]').set_input_files(str(local_path))
# 上传后 CSDN 自动插入 → ![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/<hash>.png#pic_center)

🗑 删除文章

# 已就绪 ✅
python scripts/csdn_delete.py --article-id 160926527

📐 文章格式规范

关联技能

• zhihu-publisher — 知乎发布
• hot-topic-research — 热点调研
• content-planner — 选题决策
• publish-orchestrator — 编排调度