CSDN Publisher

通过浏览器自动化发布文章到 CSDN。支持扫码登录，二维码可通过 Telegram 发送。

v2.0 新增：集成 blog-writer 写作方法论，自动产出高质量、有个人风格的技术文章。

🎯 核心工作流（v2.0）

CODEBLOCK0

✍️ 内容创作阶段（核心）

触发条件

当用户请求写文章时，必须先完成内容创作，再进行发布。

触发词：

• - "帮我写篇文章"
• "发布到 CSDN"
• "写一篇关于 XXX 的博客"
• 提供主题、素材、链接等

写作流程

Step 1: 收集信息

向用户确认：

• - 主题：写什么？
• 角度：从什么视角切入？（教程、踩坑记录、观点输出、技术分析）
• 素材：有没有参考链接、笔记、代码片段？
• 长度：简短（500-800字）/ 标准（800-1500字）/ 深度（1500-3000字）

Step 2: 阅读风格指南

必须阅读 style-guide-cn.md 校准写作风格。

核心原则：

• - 直接、有观点、不装腔作势
• 口语化表达，像跟朋友聊天
• 第一人称叙述个人经历
• 短段落（2-4句话）
• 多用小标题分隔内容

Step 3: 参考示例文章

阅读 examples/ 目录中的示例文章，感受目标风格。

Step 4: 撰写初稿

按照风格指南撰写，完成后展示给用户确认。

Step 5: 迭代修改

根据用户反馈修改，直到用户满意。

📝 写作风格指南（中文版）

详见 style-guide-cn.md，核心要点：

开头模式

用强有力的观点或个人经历开场：

✅ 好的开头：

• - "搞了两个小时，终于把这个坑填上了。"
• "说实话，我一开始是拒绝用 XXX 的。"
• "作为一个写了 5 年代码的人，我可以负责任地说：这玩意儿真的有用。"

❌ 避免的开头：

• - "随着人工智能的快速发展..."
• "在当今数字化时代..."
• "众所周知..."

结构模式

CODEBLOCK1

语言风格

用这些：

• - "说实话"、"坦白讲"
• "踩了个坑"、"折腾了半天"
• "真香"、"血泪教训"
• 第一人称："我发现"、"我的做法是"

避免这些：

• - "首先...其次...最后..."
• "值得注意的是"
• "综上所述"
• "不难发现"

新闻资讯类文章特别要求

写新闻汇总、行业日报等资讯类文章时：

• - 必须附带原文链接：每条新闻都要有跳转链接，方便读者查看原文
• 链接格式：[新闻标题](原文URL) 或在新闻末尾标注 INLINECODE4
• 如果原文链接不可用，标注来源名称（如"来源：36氪"）

段落长度

• - 每段 2-4 句话
• 单句成段用于强调
• 每 150-250 字一个小标题

🔍 新闻去重（v2.3 新增）

发布新闻汇总类文章时，必须先去重，避免同一条新闻反复出现。

去重流程

1. 1. 获取已有新闻：运行 scripts/notion-query-recent.sh 14 获取最近 14 天的 Notion 数据库记录
2. 逐条比对：对每条搜索到的新闻，检查是否与已有记录重复：

1. 3. 只保留新新闻：去重后无新闻则跳过写文章和发布

语义重复判断示例

以下算同一条新闻：

• - "宇树人形机器人日常训练视频爆火B站，播放量超376万" ≈ "宇树人形机器人日常训练视频爆火：播放量超375万"
• "小鹏Iron人形机器人深圳首秀摔倒" ≈ "小鹏Iron机器人深圳商场演示翻车"
• "Apptronik融资9.35亿美元" ≈ "Apptronik获5.2亿美元融资"（同一轮融资的不同报道）

脚本说明

⚠️ 脚本中的 Notion API Key 和 Database ID 需要根据实际环境配置。

🔧 技术发布流程

前置条件

1. 安装 Chrome

CODEBLOCK2

2. 安装 Python 依赖

CODEBLOCK3

3. 配置 OpenClaw 浏览器

需要 headless + noSandbox 模式（服务器无显示器）：

CODEBLOCK4

扫码登录流程 ✨

完整流程（推荐）

1. 1. 启动登录脚本

1. 2. 等待二维码生成（约 10-15 秒）

1. 3. 通过 Telegram 发送二维码

1. 4. 用户扫码后，脚本自动保存 Cookie

检查 Cookie 有效性

CODEBLOCK9

发布文章流程（browser 工具）

Step 1: 启动浏览器并检查登录状态

CODEBLOCK10

检查 snapshot 结果：

• - 看到 textbox "请输入文章标题" → 已登录 ✅
• 看到 登录 或 扫码 → 需要扫码登录

Step 2: 扫码登录（仅首次或 Cookie 过期时）

CODEBLOCK11

Step 3: 注入标题

使用 browser 工具的 type 操作：

CODEBLOCK12

Step 4: 注入内容（⚠️ 关键步骤）

CSDN 使用 cledit 编辑器（contentEditable），不能用以下方法：

• - ❌ browser evaluate 嵌入长字符串 → 参数长度限制
• ❌ document.execCommand('insertText') → 换行符不被 cledit 识别
• ❌ navigator.clipboard → headless Chrome 无权限
• ❌ HTTP server + fetch → CORS/混合内容拦截

✅ 正确方案：使用 scripts/inject-content.js 通过 CDP 注入

CODEBLOCK13

脚本原理：

1. 1. 通过 CDP /json 找到 CSDN 编辑器 tab
2. 用 Runtime.evaluate + JSON.stringify(content) 将内容存入 window 变量（绕过长度限制）
3. 用 editor.textContent = content + dispatchEvent('input') 注入（cledit 兼容）
4. 自动验证注入结果（字数、行数）

注意： 运行脚本前必须先用 browser 工具打开 CSDN 编辑器页面。

Step 5: 发布

CODEBLOCK14

🛡️ 容错与重试策略（v2.1 新增）

浏览器自动化容易因网络、服务中断等原因失败。以下策略确保内容不丢失、发布可重试。

原则：先存内容，再发布

内容创作是昂贵的（搜索+写作），发布是廉价的（浏览器操作）。必须先把内容落盘，再尝试发布。

Step 1: 内容落盘（发布前必做）

在尝试浏览器发布之前，必须将文章保存到本地文件：

CODEBLOCK15

文件格式：
CODEBLOCK16

这样即使发布失败，文章内容也不会丢失，可以随时重试。

Step 2: 浏览器健康检查（发布前必做）

在打开 CSDN 编辑器之前，先确认浏览器服务可用：

CODEBLOCK17

如果 start 或 snapshot 返回错误：

• - 不要继续发布流程
• 跳到 Step 4（兜底通知）

Step 3: 失败后自动重试（最多 1 次）

如果发布过程中浏览器操作失败：

CODEBLOCK18

注意：只重试发布步骤，不重跑内容创作。 从本地文件 /tmp/csdn-article-YYYY-MM-DD.md 读取已保存的内容。

Step 4: 兜底通知

如果重试后仍然失败：

1. 1. 更新本地文件的 INLINECODE28
2. 向用户发送通知，包含：

完整发布流程（含容错）

CODEBLOCK19

📁 目录结构

CODEBLOCK20

📚 示例文章管理

保存终稿

当用户确认文章为终稿时，保存到 examples/ 目录：

CODEBLOCK21

例如：INLINECODE31

示例库维护

• - 保持 10-20 篇示例文章
• 超过 20 篇时，询问用户是否删除最旧的 5 篇
• 示例文章用于校准写作风格

🔗 依赖技能

本技能依赖 blog-writer 的写作方法论：

CODEBLOCK22

在撰写文章时，可参考 blog-writer 的：

• - 结构模式
• 开头/结尾技巧
• 个人经历融入方式

踩坑记录

Cookie 存储

CODEBLOCK23

登录状态说明 🔑

browser 工具使用 Chrome 的 user-data 目录，登录状态是持久化的：

• - 首次使用需要扫码登录
• 登录后状态自动保存到 INLINECODE37
• 下次启动 browser 工具会自动加载登录状态
• Cookie 过期后（通常几天到几周）需要重新扫码

自动通知配置 🔔

配置 Telegram 通知

CODEBLOCK24

启动带通知的登录

CODEBLOCK25

Changelog

• - v2.3.0: 新增新闻去重功能（notion-query-recent.sh + notion-check-duplicate.sh），支持 URL 精确匹配和语义重复判断
• v2.2.0: 固化 CDP 内容注入方案（scripts/inject-content.js），替换不可靠的 browser evaluate 方法
• v2.1.0: 添加容错与重试策略（内容落盘、健康检查、自动重试、兜底通知）
• v2.0.0: 集成 blog-writer 写作方法论，添加中文风格指南，重构工作流
• v1.3.0: 添加登录成功自动 Telegram 通知功能
• v1.2.0: 完善 Telegram 二维码发送流程，添加完整工作流示例
• v1.1.0: 添加扫码登录脚本 INLINECODE38
• v1.0.0: 初始版本，手动 Cookie 注入