多平台统一发布 Skill

发布流程

1. 检查凭证

检查 .env 是否存在且包含目标平台的配置项，如有缺失则引导用户配置。

ls -la .env
grep "CSDN_COOKIES=" .env
grep "51CTO_COOKIES=" .env
grep "CNBLOGS_COOKIES=" .env
grep "JUEJIN_COOKIES=" .env

各平台凭证获取方式见 references/<平台>.md。

2. 明确需求

(a) 选择发帖模板

模板文件位于 templates/ 目录，提供以下模板供用户选择：

引导用户说出文章的大致主题和受众，推荐合适的模板。

(b) 确认信息

与用户确认以下内容：

• 标题
• 标签
• 正文内容（基于选定的模板填充）
• 目标平台（全部四个，或指定子集）

3. 写入临时文件

将正文以 Markdown 格式 写入临时文件：

mkdir -p temp
cat > ./temp/publish.md << 'EOF'
<Markdown 正文>
EOF

4. 按序发布

按以下顺序逐个发布，失败不中断。每个平台执行后记录状态。

所有命令在 skill 根目录下执行。

CSDN

内容格式：Markdown（加 --format markdown 让脚本自动转 HTML）

python scripts/csdn_poster.py post \
  --title "<标题>" \
  --file ./temp/publish.md \
  --format markdown \
  --tags "标签1,标签2" \
  --categories "分类名" \
  --publish

可选参数：

• --desc "摘要" — 自定义摘要

• --type original|reprint|translated — 文章类型

• --read-type public|private|fans — 阅读权限

• 不加 --publish 则存为草稿

• 成功标志：返回 发布成功！ + 链接: https://blog.csdn.net/...

• 失败：查看 references/csdn.md

51CTO

内容格式：Markdown（脚本自动转 HTML）

python scripts/51cto_poster.py post \
  --title "<标题>" \
  --file ./temp/publish.md \
  --tags "标签1,标签2"

可选参数：

• --type original|reprint|translated — 默认 original

• --draft — 存草稿

• 成功标志：返回 发布成功！ + 链接: https://blog.51cto.com/...

• 失败：查看 references/51cto.md

博客园

内容格式：原生 Markdown（博客园 isMarkdown=true，不需要转 HTML）

python scripts/cnblogs_poster.py post \
  --title "<标题>" \
  --file ./temp/publish.md \
  --tags "标签1,标签2"

可选参数：

• --category "分类ID" — 多个用逗号分隔

• --draft — 存草稿

• 成功标志：返回 发布成功！ + 链接: https://www.cnblogs.com/...

• 失败：查看 references/cnblogs.md

掘金

内容格式：原生 Markdown（掘金的 mark_content 字段原生支持 Markdown） 鉴权方式：仅需 Cookie（无需 CSRF 请求头，只需在 .env 中配置 JUEJIN_COOKIES 即可）

python scripts/juejin_poster.py post \
  --title "<标题>" \
  --file ./temp/publish.md \
  --brief "摘要（50-100 字）"

可选参数：

• --tags 标签名1 标签名2 — 传入标签名称（脚本支持常见标签自动映射）
• --draft-only — 仅存草稿，不发布
• --category <分类ID> — 分类 ID（默认 0）

常用标签（名称自动映射）：

常用分类 ID：

非常用标签/分类请查阅 references/juejin.md。

• 成功标志：返回 发布成功！ + 链接: https://juejin.cn/post/...
• 失败：查看 references/juejin.md

5. 汇总结果

所有平台执行完毕后，按此格式汇总给用户：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  多平台发布结果汇总
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ✅ CSDN     发布成功  https://blog.csdn.net/...
  ✅ 51CTO    发布成功  https://blog.51cto.com/...
  ❌ 博客园   失败     错误信息摘要
  ✅ 掘金     发布成功  https://juejin.cn/post/...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

失败的平台引导用户查看对应的 references/<平台>.md 了解原因和解决方法。

注意事项

1. 失败不中断：一个平台失败不影响其他平台继续发布
2. 临时文件：发布完成后不自动删除 ./temp/publish.md，保留供用户复查
3. Cookie 过期：各平台 Cookie 过期时间不同，发布失败时优先检查 .env 中的凭证
4. CSDN 审核：部分内容可能触发人工审核，发布后不保证即时可见
5. 掘金频率限制：发布过于频繁会返回 err_no: 1002，需等待 30 秒以上重试
6. 凭证配对：掘金的 Cookie 和 CSRF Token 必须来自同一次浏览器会话，不可混用