Skip to content

EasonZhu1997/Eason-Agent-Skills / skills/csdn-article-publisher

csdn-article-publisher

Verified

Upload or update Word, TXT and Markdown articles in CSDN, preserving text, formatting and image positions; repair failed images and verify publishing states. When explicitly requested, use CSDN's official sync assistant to send the article to Juejin and Zhihu drafts, then verify each target. Not for general copywriting or unrelated standalone platform tasks.

references/richtext.md

View on GitHub
# 将定稿转为 CSDN 富文本

CSDN 当前页面可能是 Markdown 或富文本编辑器。**本参考用于富文本路线**,不能假设把 Markdown 源码粘贴进富文本正文就能得到标题、代码块和图片。Markdown 路线适用于图片已由 CSDN 原生上传,并用 `finalize_images.py` 回填完地址之后的稿件。若当前确实是 Markdown 源码编辑器,可以直接转入最终 Markdown,再核对预览,不必为了转入而先转 HTML。未回填稿中的占位符不可发布。普通 TXT 则使用下方专门的纯文本路线,不经过 Markdown 解释。

## 离线生成

该脚本的 Markdown 路线需要 `markdown-it-py 3.0.0`,普通 TXT 路线只需 Python 3.9+ 标准库;其他前处理脚本的依赖见各自说明。Markdown 路线选择允许安装依赖的环境,建议独立虚拟环境,不修改用户全局环境:

```bash
python3 -m venv /绝对路径/新的虚拟环境
/绝对路径/新的虚拟环境/bin/python -m pip install -r requirements-render.txt
/绝对路径/新的虚拟环境/bin/python scripts/render_richtext.py \
  --article /绝对路径/finalized.md \
  --output /绝对路径/新的富文本输出目录
```

安装依赖需要访问包源;转换脚本本身不联网、不打开浏览器、不上传文件、不执行正文或代码。输出目录必须新建或为空,输入、输出及已有父路径不能是符号链接。macOS 临时目录使用真实路径 `/private/tmp`。源文件不会被改写,已有输出不会被覆盖。

### 普通 TXT:保留原文字面与空白

```bash
python3 scripts/render_richtext.py \
  --literal-txt /绝对路径/原文章.txt \
  --output /绝对路径/新的纯文本输出目录
```

`--literal-txt` 与 `--article` 互斥,必须传原 TXT,不传已经转义的准备稿。默认严格 UTF-8,自动处理 UTF-8 BOM、UTF-16 BOM;确认是 GB18030 时加 `--encoding gb18030`。不猜测错误编码,不以替换字符继续。按准备脚本相同约定,把 CRLF/CR 规范为 LF 后建立文本基线。

纯文本整体放入一个语义 `<pre>` 块,不添加 `<code>` 子标签,也不指定编程语言。所有空格、制表符、起始和末尾空行保留;HTML 的首个 `<pre>` 换行规则已在生成时补偿,不靠预览 CSS 维持空白,也不把 ASCII 空格替换为 NBSP。`#`、反引号、看似图片或链接的字符、HTML 和注释全是原文字面,不会执行、上传或被解析成排版。

清单使用 `source_format: txt`、原字节 `source_sha256`、编码和 `literal_text_sha256` 等基线,不伪装成 Markdown。此路线没有实际图片与超链接;若用户确认 TXT 实际采用 Markdown 语法,才走 `prepare_text.py --txt-as-markdown`、图片回填和 `--article` 路线。CSDN可能清理或改变 `<pre>`;粘贴后仍须核对空格、空行与字面文字,不能只凭本地预览宣称已保真。

生成三个文件:

- `article.fragment.html`:仅含文章语义 HTML,供支持 `text/html` 剪贴板的宿主工具使用。
- `preview.html`:简约的本地检查页,不声称与CSDN排版完全一致。无脚本;在浏览器打开时,图片标签可能向已上传的CSDN CDN 请求图片。
- `manifest.json`:原稿及输出哈希、图片出现顺序与 alt、标题层级、代码内容与哈希、链接和列表起始编号基线。它含用户文章内容及图片完整签名链接,属于私有工作输出,不应一起分享技能包。

脚本输出 `ready_for_reviewed_ui_transfer_not_published` 只表示已生成待人工核对的本地 HTML,不代表已经粘贴、保存、发表或通过审核。

## 保真与限制

基于 CommonMark,另开启 Markdown 表格和删除线。保留原文标题层级,包括正文首个一级标题;不推测删除“重复标题”,不新增图注或外层文章标题。保留图片位置、alt、title,列表起始编号和引用结构。代码不执行、不格式化,按 CommonMark 的换行规范保留内容;CRLF 会规范化为 LF,围栏代码的末尾换行依标准解析规则处理。需逐字验证代码时,使用清单中的内容及哈希,并在CSDN编辑器中再次核对。

不运行扩展插件,不自动美化标点或链接。原始 HTML 被转义为可见文字而不是执行;预处理阶段已要求人工规范原始 HTML,不应靠这个步骤把它悄悄删除。例外是代码之外的 HTML 注释:它可能包含原本隐藏的内部备注,脚本会明确阻断,要求先在工作副本中人工检查、移除或改写,不能把注释变成公开正文。围栏代码、缩进代码和行内代码中的字面注释示例照常保留。检测时额外解析 HTML 语法只是为了辨认注释,不会渲染或执行 HTML。

相对链接、`file:`、活动协议、协议相对链接等明确阻断,需先在工作副本中人工改为合适的绝对地址或段内锚点。普通链接只接受 `http:`、`https:`、`mailto:` 和 `#锚点`。图片默认仅接受 HTTPS 的精确主机 `i-blog.csdnimg.cn`、`img-blog.csdnimg.cn` 地址;地址必须来自实际CSDN原生上传,域名符合不等于已经证明上传来源。若当前CSDN原生上传确实返回其他主机,核实后与 `finalize_images.py` 一致地传入 `--allow-host 精确小写主机名`,可重复传多个。不得包含协议、路径、端口或通配符,不会自动允许该主机的子域。预览页 CSP 同时只增加这些精确主机。这个参数不能用来放行未经上传的外链。脚本拒绝残留的 `CS_IMAGE` / `RK_IMAGE` / `ZH_IMAGE` / `JJ_IMAGE` 占位。

链接校验针对真正进入输出的链接和图片。图片已转为托管行内图后,原 Markdown 可能保留未再使用的本地引用定义;这种定义不产生链接或图片,不会因此误阻断。被正文实际引用的本地或危险地址仍会在生成 HTML 之前阻断。

解析选项依据 [markdown-it-py 官方使用说明](https://markdown-it-py.readthedocs.io/en/latest/using.html):显式禁用 HTML 输出,仅按需开启表格和删除线规则。本技能的图片域名、注释阻断和转入验收要求属于工作流约束,不是CSDN官方 API 承诺。

不支持的公式、脚注、复杂扩展、富文本嵌入应在转入前发现,并与用户确认处理方式,不把“能解析”当作语义完整。文内 `#锚点` 地址保留,但CSDN是否生成对应锚点仍需实际验证。

## 通过原生编辑器转入

1. 先观察当前CSDN编辑器及工具能力,确认账号、稿件和目标编辑区。调用能力中明确提供 HTML 剪贴板时,把 `article.fragment.html` 作为 `text/html` 写入,再用原生粘贴;不要仅把 HTML 字符串当作纯文本粘贴。
2. 没有这种剪贴板能力,但工具支持打开本地文件和浏览器原生复制时,可以打开 `preview.html`,只选中 `<article>` 对应的正文区域进行原生复制,再粘贴到CSDN。不能把预览页顶端的提示条也贴进正文。选区和复制操作须使用当前工具已支持的浏览器/原生 API。
3. 两种方式都不可用时,观察CSDN当前是否真的提供 Markdown 导入入口;有则按该入口导入并验证。没有则通过原生编辑器逐块重建标题、列表、引用、代码、表格,并在原位置插入上传图片。若工具无法可靠完成,停在本地稿并说明缺失的能力,不能声称已发布。
4. 不使用页面 `evaluate` 修改 DOM、编辑器内部状态、私有接口、Cookie/Token 或臆造的上传 API 来替代可见编辑器操作。不要靠手工写 `innerHTML` 来“证明”页面保存成功。
5. 粘贴后滚动查看全部正文:核对标题数和层级、图片顺序及对应图注、代码空格与换行、表格结构、引用、列表编号和链接。CSDN可能清理 CSS 或改变 HTML 结构,语义结果才是验收依据。必要时用工具允许的只读 DOM 检查配合截图确认。
6. 发布授权、保存与审核状态判断,继续遵守技能主文件和浏览器验收说明。已经生成本地 HTML 或预览完整,不构成发布成功证据。

测试只使用合成素材:

```bash
/绝对路径/虚拟环境/bin/python -B -m unittest discover -s scripts -p 'test_render_richtext.py' -v
```

没有安装 Markdown 解析依赖时相应渲染测试会跳过。测试中的 HTML5 `<pre>` 首换行与字符保真检查另需可选测试依赖 `html5lib==1.1`;它不属于发布脚本运行依赖,也未装入分享包。未装时只跳过这两项 HTML5 检查,不能把“跳过”汇报成实际解析测试通过。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall