aaaaqwq/juejin-smart-publish

掘金智能发布

平台入口

• 新建文章: https://juejin.cn/editor/drafts/new
• 草稿箱: https://juejin.cn/editor/drafts
• 登录方式: 手机号验证码 / GitHub OAuth / 微信扫码

排版规则

文章规范

| 项 | 规则 | |----|------| | 编辑器 | Markdown（完整 GFM 支持） | | 标题 | 15-35字最佳，≤50字，含核心关键词 | | 正文 | 1,500-5,000字（技术深度文章） | | 代码块 | 必须指定语言标识 (```python) | | 图片 | 拖拽/URL/剪贴板，建议≥800px | | 表格 | GFM 表格语法 | | 分割线 | --- 分隔大章节 | | 目录 | 长文章自动生成 |

分类（必选1个）

后端 / 前端 / Android / iOS / 人工智能 / 开发工具 / 代码人生 / 阅读

标签

| 项 | 规则 | |----|------| | 数量 | 1-5个（建议2-4个） | | 来源 | 搜索已有 或 输入新标签按Enter | | 策略 | 1-2热门标签(流量) + 1-2精准标签(匹配) |

封面 & 摘要

| 项 | 规则 | |----|------| | 封面 | 可选，推荐宽屏 JPG/PNG/GIF ≤5MB | | 摘要 | 50-150字，不填则取正文前N字 | | 摘要策略 | 含关键词，突出文章价值 |

内容适配模板

技术文章标准结构：

# {标题：动词开头或数字开头}

> {一句话摘要/导言}

## 背景 / 为什么

{痛点描述，1-2段}

## 方案 / 怎么做

{核心内容，代码+图+表}

### Step 1: ...
### Step 2: ...

## 效果 / 结果

{数据对比，before/after}

## 总结

{关键收获，1-3个要点}

---

**参考链接**:
- [link1](url)
- [link2](url)

标题公式：

• 数字型：「5个让你写出优雅代码的Python技巧」
• 实战型：「从0到1搭建AI Agent系统——完整指南」
• 问题型：「为什么你的SQL查询这么慢？」
• 经验型：「踩了3个月的坑，我总结出这套CI/CD方案」

发布流程

Playwright 自动化

1. 打开 juejin.cn/editor/drafts/new（检查登录态）
2. 填写标题 → input[placeholder*="标题"]
3. 在 Markdown 编辑区写入正文
4. 点击「发布」按钮打开设置面板
5. 选择分类（必选）
6. 搜索+添加标签（1-5个）
7. 上传封面（可选）
8. 填写摘要（可选）
9. 点击「确认并发布」或「保存草稿」

API 通道（需认证Token）

# 保存草稿
POST /content_api/v1/article/draft/create
# Body: { title, markdown_content, category_id, tag_ids[], cover_image }

# 发布文章
POST /content_api/v1/article/publish
# Body: { draft_id }

# 上传图片
POST /content_api/v1/upload_pic

脚本用法

# Markdown 文件发布（草稿模式）
python scripts/publish.py \
  --title "文章标题" \
  --content-file article.md \
  --category "人工智能" \
  --tags "AI,Agent,OpenClaw" \
  --mode draft

# 带封面和摘要
python scripts/publish.py \
  --title "标题" \
  --content-file article.md \
  --category "前端" \
  --tags "React,TypeScript" \
  --cover cover.png \
  --abstract "50-150字摘要" \
  --mode draft

# API模式（需cookie-file）
python scripts/publish.py \
  --title "标题" \
  --content-file article.md \
  --category "后端" \
  --tags "Python,FastAPI" \
  --mode draft \
  --api --cookie-file cookies.json

UI 选择器参考（Vue.js SPA，类名含hash）

| 元素 | 定位策略 | 说明 | |------|----------|------| | 标题输入 | input[placeholder*="标题"] | 标题框 | | 编辑区 | [class*="editor"] [contenteditable] / .CodeMirror | Markdown编辑器 | | 预览区 | [class*="preview"] | 右侧实时预览 | | 发布按钮 | button:has-text("发布") | 打开发布面板 | | 分类下拉 | [class*="category"] | 分类选择 | | 标签输入 | [class*="tag"] input | 标签搜索 | | 封面上传 | [class*="cover"] input[type="file"] | 封面图 | | 摘要输入 | [class*="abstract"] textarea | 摘要 | | 确认发布 | button:has-text("确认并发布") | 最终发布 | | 保存草稿 | button:has-text("保存草稿") / 自动保存 | 草稿 |

注意：掘金编辑器有自动保存草稿功能，内容输入后几秒即存。

Markdown 快捷键

| 快捷键 | 功能 | |--------|------| | Ctrl/Cmd + B | 加粗 | | Ctrl/Cmd + H | 标题 | | Ctrl/Cmd + K | 链接 | | Ctrl/Cmd + Shift + C | 代码块 | | Ctrl/Cmd + Shift + I | 图片 | | Ctrl/Cmd + Z | 撤销 |

发布时间建议

| 时段 | 推荐度 | 说明 | |------|--------|------| | 8:00-9:00 | ⭐⭐⭐ | 早通勤阅读 | | 12:00-13:00 | ⭐⭐⭐⭐ | 午休学习 | | 20:00-22:00 | ⭐⭐⭐⭐⭐ | 晚间深度阅读黄金档 | | 周末 | ⭐⭐⭐ | 长文适合周末 |

错误处理

| 错误 | 处理 | |------|------| | 登录过期 | 提示手动登录，--headless false | | 分类未选 | 自动选择"后端"（默认） | | 标签搜索无结果 | 输入后按Enter创建新标签 | | 图片上传失败 | 重试3次，回退到URL引用 | | Markdown渲染异常 | 检查语法，移除不支持的扩展 | | 发布频率限制 | 建议每天≤3篇，间隔≥30分钟 |

SEO 优化要点

• 标题含核心关键词（前15字最重要）
• 正文前100字包含关键词
• 标签选择热门+精准组合
• 摘要包含核心关键词
• 内链自己的其他文章
• 参与官方活动增加曝光权重

发布前检查清单

• [ ] 标题 15-35字，含关键词
• [ ] 分类已选（必选项）
• [ ] 标签 2-4个，热门+精准
• [ ] 代码块均有语言标识
• [ ] 图片清晰 ≥800px
• [ ] 正文无错别字/格式错误
• [ ] 摘要 50-150字（不填会自动截取）
• [ ] 非搬运内容，声明原创

文件结构

juejin-smart-publish/
├── SKILL.md
├── scripts/
│   └── publish.py          # Playwright + API 双通道发布
├── references/
│   └── api-spec.md         # 掘金 API 文档
└── templates/
    ├── tech-tutorial.md     # 技术教程模板
    ├── project-showcase.md  # 开源项目展示模板
    └── experience-share.md  # 经验分享模板